Skip to content

fix: add legacy aiox-core wrapper - #730

Merged
rafaelscosta merged 3 commits into
mainfrom
fix/legacy-aiox-core-alias
May 13, 2026
Merged

fix: add legacy aiox-core wrapper#730
rafaelscosta merged 3 commits into
mainfrom
fix/legacy-aiox-core-alias

Conversation

@rafaelscosta

@rafaelscosta rafaelscosta commented May 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • add a minimal legacy aiox-core npm wrapper that delegates to @aiox-squads/core@5.2.2
  • wire npm publish workflow to publish the legacy package separately with legacy npm token fallback
  • add Story 124.8 for the compatibility fix

Validation

  • npm pack --dry-run --json for compat/aiox-core
  • local tarball install smoke: aiox-core --version -> 5.2.2; aiox-core pro setup --help
  • npm_config_ignore_scripts=true npm run validate:publish
  • workflow dispatch success: https://github.com/SynkraAI/aiox-core/actions/runs/25802137210
  • npm verified: aiox-core@latest -> 5.2.2, depends on @aiox-squads/core@5.2.2

Summary by CodeRabbit

  • New Features

    • Added a legacy compatibility wrapper so npx aiox-core@latest and legacy binary names delegate to the canonical package.
    • Release pipeline now supports selecting and publishing the legacy wrapper, verifies publish success, and reports legacy publish status in release output.
  • Documentation

    • Added user-facing docs describing the legacy wrapper, recommended new command, and migration guidance.

Review Change Stack

@vercel

vercel Bot commented May 13, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
aiox-core Ready Ready Preview, Comment May 13, 2026 2:28pm

Request Review

@coderabbitai

coderabbitai Bot commented May 13, 2026

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 390d3dc5-5700-4d6c-899c-9b1dde0bd5b0

📥 Commits

Reviewing files that changed from the base of the PR and between 6bf7c0f and 88b20f1.

📒 Files selected for processing (1)
  • .github/workflows/npm-publish.yml
🚧 Files skipped from review as they are similar to previous changes (1)
  • .github/workflows/npm-publish.yml

Walkthrough

This PR implements a legacy aiox-core npm package wrapper that delegates to the scoped @aiox-squads/core canonical package while preserving backward compatibility. It updates the npm-publish workflow to detect, publish, and report the legacy package alongside existing published packages with improved job-gating accuracy.

Changes

Legacy aiox-core Wrapper and Publishing Integration

Layer / File(s) Summary
Legacy wrapper package structure
compat/aiox-core/package.json, compat/aiox-core/bin/aiox-core.js, compat/aiox-core/README.md
New compatibility package aiox-core@5.2.2 depending on @aiox-squads/core@5.2.2; single forwarder CLI bin/aiox-core.js exposed as aiox, aiox-core, aiox-minimal, aiox-graph, aiox-delegate; README documents the shim and recommends the scoped command.
Workflow package selection logic
.github/workflows/npm-publish.yml (lines 30, 103–105, 151, 237)
Adds aiox-core to workflow_dispatch package choices and the default "all" set; tightens job if conditions to exact comma-delimited matches to avoid substring matches when deciding which publish jobs run.
Legacy publish job and pipeline integration
.github/workflows/npm-publish.yml (lines 356–471, 490–511)
Adds publish_legacy_aiox_core job that reads compat package metadata, determines dist-tag from publish_mode/event, checks registry for exact version, publishes using token fallback (NPM_TOKEN_AIOX_SQUADS then NPM_TOKEN), polls for propagation, runs npx smoke test, and integrates outcome with notify and create-release-notes.
Story documentation
docs/stories/epic-124-aiox-squads-scope-migration/STORY-124.8-legacy-aiox-core-wrapper.md
New story documenting acceptance criteria, tasks, and the file inventory for the legacy wrapper migration; notes keeping the compat package outside the root workspace.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

  • SynkraAI/aiox-core#727: Bumps @aiox-squads/core to 5.2.2, the same version pinned by this PR's legacy wrapper dependency.
  • SynkraAI/aiox-core#707: Adjusts GitHub Actions npm authentication to use NPM_TOKEN_AIOX_SQUADS, related to the token fallback strategy added here.

Suggested reviewers

  • Pedrovaleriolopez
  • oalanicolas
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'fix: add legacy aiox-core wrapper' directly and accurately summarizes the main change—adding a compatibility wrapper for the legacy aiox-core package.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/legacy-aiox-core-alias

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions github-actions Bot added area: docs Documentation (docs/) area: devops CI/CD, GitHub Actions (.github/) labels May 13, 2026
@github-actions

github-actions Bot commented May 13, 2026

Copy link
Copy Markdown
Contributor

📊 Coverage Report

Coverage report not available

📈 Full coverage report available in Codecov


Generated by PR Automation (Story 6.1)

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/npm-publish.yml:
- Around line 418-423: The current loop captures the exit code after the entire
if compound so `$?` yields the `if` result rather than the `npm publish` exit
code; update the loop around the `if npm publish --tag ${{
steps.publish-tag.outputs.tag }} --access public; then` block to move the
publish-status capture into an `else` branch so that `publish_status` is set to
the immediate `$?` of the failed `npm publish` command (keep using the existing
`publish_status` variable and the same tag reference
`steps.publish-tag.outputs.tag`) and only break/set `publish_status=0` inside
the `then` branch when publish succeeds.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5f7dfc4f-343f-4997-9210-718a989780a3

📥 Commits

Reviewing files that changed from the base of the PR and between c252802 and 1bba631.

📒 Files selected for processing (5)
  • .github/workflows/npm-publish.yml
  • compat/aiox-core/README.md
  • compat/aiox-core/bin/aiox-core.js
  • compat/aiox-core/package.json
  • docs/stories/epic-124-aiox-squads-scope-migration/STORY-124.8-legacy-aiox-core-wrapper.md

Comment thread .github/workflows/npm-publish.yml

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/npm-publish.yml:
- Around line 488-494: The summary appends "aiox-core legacy wrapper" whenever
the dependent job finished successfully, even if it skipped publishing; update
the condition to only append when the publish actually occurred by checking the
publish job's output (e.g. needs.publish_legacy_aiox_core.outputs.should_publish
== 'true' or a similar output flag) instead of just
needs.publish_legacy_aiox_core.result; modify the block that references
PUBLISHED_PACKAGES and needs.publish_legacy_aiox_core.result so it uses the job
output that indicates a real publish before adding "aiox-core legacy wrapper" to
PUBLISHED_PACKAGES.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 4f816251-cc7d-4b00-b168-4d069734dfd2

📥 Commits

Reviewing files that changed from the base of the PR and between 1bba631 and 6bf7c0f.

📒 Files selected for processing (1)
  • .github/workflows/npm-publish.yml

Comment thread .github/workflows/npm-publish.yml Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: devops CI/CD, GitHub Actions (.github/) area: docs Documentation (docs/)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant