Skip to content

fix: repair Pro installer npx commands - #726

Merged
rafaelscosta merged 4 commits into
mainfrom
fix/pro-installer-npx-commands
May 12, 2026
Merged

fix: repair Pro installer npx commands#726
rafaelscosta merged 4 commits into
mainfrom
fix/pro-installer-npx-commands

Conversation

@rafaelscosta

@rafaelscosta rafaelscosta commented May 12, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • replace invalid unscoped npx aiox-pro recovery/setup hints with published scoped commands
  • bump standalone Pro CLI/installer package versions for a patch publish
  • update Pro install docs and regression tests

Validation

  • npm run lint PASS
  • npm run typecheck PASS
  • npm run validate:publish PASS
  • npm test -- --runInBand tests/pro-wizard.test.js tests/installer/pro-setup-auth.test.js tests/pro-recover.test.js tests/installer/pro-scaffolder.test.js PASS
  • npm pack --workspace @aiox-squads/aiox-pro-cli --dry-run --json PASS
  • npm pack --workspace @aiox-squads/installer --dry-run --json PASS
  • full npm test -- --runInBand had 2 transient failures outside this patch; both failed suites passed when rerun directly: tests/unit/squad/squad-generator-blueprint.test.js and tests/integration/hooks/precompact-flow.integration.test.js

Notes

  • Does not include the pre-existing local pro submodule pointer change.
  • Partner backend compatibility patch is already pushed to aios-license-server@856dee5.

Summary by CodeRabbit

  • Documentation
    • Updated AIOX Pro installation, setup, troubleshooting and workflow guides and README to use the new scoped CLI invocation and aligned examples across languages.
  • Chores
    • Bumped Pro CLI and installer package versions.
    • Updated installer/wizard help and error messages to reference the new setup commands.
  • CI
    • Hardened Pro integration workflow: checkout/auth flow updated and a conditional step added to initialize the private Pro submodule during automated runs.

Review Change Stack

@vercel

vercel Bot commented May 12, 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 12, 2026 5:55pm

Request Review

@github-actions github-actions Bot added type: test Test coverage and quality area: installer Installer and setup (packages/installer/) area: cli CLI tools (bin/, packages/aios-pro-cli/) area: docs Documentation (docs/) labels May 12, 2026
@github-actions

github-actions Bot commented May 12, 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 commented May 12, 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: edc8d4b9-dd66-4886-9b1f-c305dc5de0a6

📥 Commits

Reviewing files that changed from the base of the PR and between eb35565 and 144ea9e.

📒 Files selected for processing (2)
  • .github/workflows/pro-integration.yml
  • docs/stories/epic-pro-13/STORY-PRO-13.5-PRIVATE-PRO-DISTRIBUTION-HARDENING.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/stories/epic-pro-13/STORY-PRO-13.5-PRIVATE-PRO-DISTRIBUTION-HARDENING.md

Walkthrough

The PR transitions the AIOX Pro CLI invocation pattern from legacy npx aiox-pro commands to scoped npx -y -p @aiox-squads/core@latest aiox pro pattern, with recovery commands using npx -y @aiox-squads/aiox-pro-cli@latest recover. Changes span CLI help text, installer error messages, three-language internationalization strings, user documentation, tests, workflow, and epic tracking.

Changes

AIOX Pro CLI Command Invocation Migration

Layer / File(s) Summary
CLI package interface and versioning
packages/aiox-pro-cli/bin/aiox-pro.js, packages/aiox-pro-cli/package.json
Top-level help text, usage line, and Examples updated to advertise npx -y @aiox-squads/aiox-pro-cli@latest; package version bumped to 0.2.1 and installer dependency bumped to ^3.3.2.
Installer scaffolder and setup error messages
packages/installer/src/pro/pro-scaffolder.js, packages/installer/src/wizard/pro-setup.js, packages/installer/package.json
Scaffolder and pro-setup guidance updated to instruct npx -y -p @aiox-squads/core@latest aiox pro setup; installer package version bumped to 3.3.2.
Internationalization strings
packages/installer/src/wizard/i18n.js
EN/PT/ES wizard strings updated for proModuleNotAvailable, proScaffolderNotAvailable, proNeedHelp, and proNpmInstallFailed to reference the scoped commands.
User-facing installation and troubleshooting guides
README.md, docs/guides/aiox-pro-access.md, docs/guides/pro/install-gate-setup.md, docs/guides/workflows/pro-developer-workflow.md
Installation, activation, verification, CI/CD examples, troubleshooting, offline operation, and architecture labels updated to use npx -y -p @aiox-squads/core@latest aiox pro ... and npx -y @aiox-squads/aiox-pro-cli@latest recover.
Test assertions for command patterns
tests/pro-recover.test.js, tests/pro-wizard.test.js
Recover test enhanced to verify scoped recover command presence and legacy command absence; new wizard tests validate i18n command hints across EN/PT/ES.
GitHub Actions Pro submodule initialization
.github/workflows/pro-integration.yml
Checkout step disables recursive submodule checkout; a conditional step initializes the credentialized Pro submodule using PRO_SUBMODULE_TOKEN, rewrites SynkraAI URLs, runs git submodule sync --recursive and git submodule update --init --recursive, and cleans up.
Epic story documentation and validation evidence
docs/stories/epic-pro-13/STORY-PRO-13.5-PRIVATE-PRO-DISTRIBUTION-HARDENING.md
Story updated with expanded touchpoints, recorded package version bumps, CI token handling notes, submodule URL injection approach, and an augmented validation checklist (pack dry-runs, node checks, yaml-lint, eslint).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

area: workflows, area: pro

Suggested reviewers

  • oalanicolas
  • Pedrovaleriolopez
🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 66.67% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'fix: repair Pro installer npx commands' directly describes the main change: correcting invalid unscoped npx command invocations to use proper scoped CLI commands across documentation, tests, and configuration files.
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/pro-installer-npx-commands

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 the area: devops CI/CD, GitHub Actions (.github/) label May 12, 2026

@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: 2

🤖 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/pro-integration.yml:
- Around line 89-94: The workflow currently sets a global credentialized URL
with git config using the PRO_SUBMODULE_TOKEN and relies on the final git config
--unset-all cleanup line to run, but that line can be skipped if git submodule
sync/update fails; update the run block so the credentialized config is written
to repo-local scope (use git config --local insteadOf) or wrap the sequence in a
shell trap/finally to always execute the cleanup unset (referencing the existing
git config
url."https://x-access-token:${PRO_SUBMODULE_TOKEN}@github.com/SynkraAI/".insteadOf,
the git submodule sync/update commands, and the git config --unset-all cleanup)
so the tokenized URL is removed even on failure.

In `@tests/pro-wizard.test.js`:
- Line 57: Replace the relative require in tests/pro-wizard.test.js that assigns
wizardI18n from '../packages/installer/src/wizard/i18n' with the project’s
absolute import pattern; locate the line where const wizardI18n =
require('../packages/installer/src/wizard/i18n') is declared and change it to
use the repository's absolute module path (preserving the symbol wizardI18n) so
it complies with the /*.{js,jsx,ts,tsx} absolute import guideline.
🪄 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: a39d1080-40d6-4a47-a33b-7f8085111c84

📥 Commits

Reviewing files that changed from the base of the PR and between 4ff4c32 and 0f16447.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (14)
  • .github/workflows/pro-integration.yml
  • README.md
  • docs/guides/aiox-pro-access.md
  • docs/guides/pro/install-gate-setup.md
  • docs/guides/workflows/pro-developer-workflow.md
  • docs/stories/epic-pro-13/STORY-PRO-13.5-PRIVATE-PRO-DISTRIBUTION-HARDENING.md
  • packages/aiox-pro-cli/bin/aiox-pro.js
  • packages/aiox-pro-cli/package.json
  • packages/installer/package.json
  • packages/installer/src/pro/pro-scaffolder.js
  • packages/installer/src/wizard/i18n.js
  • packages/installer/src/wizard/pro-setup.js
  • tests/pro-recover.test.js
  • tests/pro-wizard.test.js

Comment thread .github/workflows/pro-integration.yml Outdated
Comment thread tests/pro-wizard.test.js Outdated
coderabbitai[bot]
coderabbitai Bot previously approved these changes May 12, 2026
@rafaelscosta
rafaelscosta merged commit fa0600a into main May 12, 2026
41 checks passed
@rafaelscosta
rafaelscosta deleted the fix/pro-installer-npx-commands branch May 12, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: cli CLI tools (bin/, packages/aios-pro-cli/) area: devops CI/CD, GitHub Actions (.github/) area: docs Documentation (docs/) area: installer Installer and setup (packages/installer/) type: test Test coverage and quality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant