fix: finalize aiox-pro alignment and update flow [Story 123.2]

rafaelscosta · rafaelscosta · commit ee29cc017740 · 2026-04-11T14:41:03.000-03:00
diff --git a/.aiox-core/cli/commands/pro/index.js b/.aiox-core/cli/commands/pro/index.js
@@ -9,7 +9,7 @@
  *   aiox pro deactivate               Deactivate the current license
  *   aiox pro features                 List all pro features
  *   aiox pro validate                 Force online revalidation
- *   aiox pro setup                    Configure GitHub Packages access (AC-12)
+ *   aiox pro setup                    Install or verify the AIOX Pro package
  *
  * @module cli/commands/pro
  * @version 1.1.0
@@ -110,7 +110,8 @@ function loadLicenseModules() {
     };
   } catch (error) {
     console.error('AIOX Pro license module not available.');
-    console.error('Install AIOX Pro: npm install @aios-fullstack/pro');
+    console.error('Install AIOX Pro: aiox pro setup');
+    console.error('Or via wrapper: npx aiox-pro install');
     process.exit(1);
   }
 }
@@ -622,13 +623,15 @@ async function setupAction(options) {
         console.log('❌ AIOX Pro is not installed');
         console.log('');
         console.log('Install with:');
-        console.log('  npm install @aios-fullstack/pro');
+        console.log('  aiox pro setup');
+        console.log('  # or npx aiox-pro install');
       }
     } catch {
       console.log('❌ AIOX Pro is not installed');
       console.log('');
       console.log('Install with:');
-      console.log('  npm install @aios-fullstack/pro');
+      console.log('  aiox pro setup');
+      console.log('  # or npx aiox-pro install');
     }
     return;
   }
@@ -686,7 +689,8 @@ async function setupAction(options) {
   if (!installedPackage) {
     console.error('\n❌ Installation failed.');
     console.log('\nTry manually:');
-    console.log('  npm install @aios-fullstack/pro');
+    console.log('  aiox pro setup');
+    console.log('  # or npx aiox-pro install');
     process.exit(1);
   }
 
diff --git a/.aiox-core/install-manifest.yaml b/.aiox-core/install-manifest.yaml
@@ -8,7 +8,7 @@
 # - File types for categorization
 #
 version: 5.0.3
-generated_at: "2026-04-11T00:48:43.533Z"
+generated_at: "2026-04-11T17:41:04.600Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1091
 files:
@@ -101,9 +101,9 @@ files:
     type: cli
     size: 12326
   - path: cli/commands/pro/index.js
-    hash: sha256:75e4746ecb188072c51fc5fa8f24a0512701f54c20ece228163486e0895eed21
+    hash: sha256:25542535498df95f0d5b853ef20dcae8299fadcee19dcf407b7d4d2615697315
     type: cli
-    size: 25765
+    size: 25904
   - path: cli/commands/qa/index.js
     hash: sha256:3a9e30419a66e56781f9b5dcddc8f4dd0ed24dabf8fe8c3005cd26f5cb02558f
     type: cli
@@ -1225,9 +1225,9 @@ files:
     type: data
     size: 9575
   - path: data/entity-registry.yaml
-    hash: sha256:cc1bf74d3ef4e90b7a396d5b77259e540b2f9bd4a5b4b1da4977fe49ae83525d
+    hash: sha256:0ae9e2e1a0c2b0bf4a6c5bb194af978a0de3e1ad6611b204ec40d77b0743ac51
     type: data
-    size: 521869
+    size: 523255
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
diff --git a/.github/workflows/pro-integration.yml b/.github/workflows/pro-integration.yml
@@ -4,7 +4,7 @@
 # aiox-core CI runs standalone (ADR-PRO-001). This workflow validates
 # the integration boundary between core and pro.
 #
-# Requires PRO_SUBMODULE_TOKEN secret (PAT with repo scope for SynkraAI/aios-pro).
+# Requires PRO_SUBMODULE_TOKEN secret (PAT with repo scope for SynkraAI/aiox-pro).
 #
 # Tests covered:
 #   - tests/pro/**          (integration tests in aiox-core)
diff --git a/.github/workflows/publish-pro.yml b/.github/workflows/publish-pro.yml
@@ -1,4 +1,4 @@
-# GitHub Actions workflow for publishing @aios-fullstack/pro to npm
+# GitHub Actions workflow for publishing @aiox-fullstack/pro to npm
 #
 # This workflow publishes the AIOX Pro package to the public npm registry.
 # Features are license-gated (activation required), not install-gated.
@@ -117,7 +117,7 @@ jobs:
             ### Installation
 
             \`\`\`bash
-            npm install @aios-fullstack/pro
+            npx aiox-pro install
             aiox pro activate --key PRO-XXXX-XXXX-XXXX-XXXX
             \`\`\`
 
@@ -153,11 +153,11 @@ jobs:
           node-version: '20'
 
       - name: Verify package is accessible
-        run: npm view @aios-fullstack/pro
+        run: npm view @aiox-fullstack/pro
 
       - name: Test installation
         run: |
           mkdir test-install && cd test-install
           npm init -y
-          npm install @aios-fullstack/pro
+          npm install @aiox-fullstack/pro
           echo "✅ Package installed successfully"
diff --git a/.github/workflows/sync-pro-submodule.yml b/.github/workflows/sync-pro-submodule.yml
@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       target_sha:
-        description: 'Optional aios-pro commit SHA to sync into the pro submodule'
+        description: 'Optional aiox-pro commit SHA to sync into the pro submodule'
         required: false
         type: string
   schedule:
@@ -20,7 +20,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     env:
-      PRO_REMOTE_FALLBACK_URL: https://github.com/SynkraAI/aios-pro.git
+      PRO_REMOTE_FALLBACK_URL: https://github.com/SynkraAI/aiox-pro.git
       SYNC_BRANCH: bot/sync-pro-submodule
     steps:
       - name: Checkout aiox-core
@@ -136,7 +136,7 @@ jobs:
           - Target SHA: \`$TARGET_SHA\`
           - Trigger: \`${GITHUB_WORKFLOW}\`
 
-          This PR reconciles the \`pro\` submodule with the latest upstream state from \`SynkraAI/aios-pro\`.
+          This PR reconciles the \`pro\` submodule with the latest upstream state from \`SynkraAI/aiox-pro\`.
           EOF
           )
 
diff --git a/.gitmodules b/.gitmodules
@@ -1,5 +1,5 @@
 [submodule "pro"]
 	path = pro
-	url = https://github.com/SynkraAI/aios-pro.git
+	url = https://github.com/SynkraAI/aiox-pro.git
 	branch = main
 	ignore = dirty
diff --git a/README.en.md b/README.en.md
@@ -602,14 +602,14 @@ Squads are modular AI agent teams. See the [Squads Overview](docs/guides/squads-
 
 ## AIOX Pro
 
-**AIOX Pro** (`@aiox-fullstack/pro`) is the premium module of AIOX, offering advanced features for teams and larger-scale projects.
+**AIOX Pro** is the premium module of AIOX, offering advanced features for teams and larger-scale projects.
 
 > **Restricted availability:** AIOX Pro is available exclusively to members of the **AIOX Cohort Advanced**. [Learn more about the program](https://aioxsquad.ai).
 
 ### Installation
 
 ```bash
-npm install @aiox-fullstack/pro
+npx aiox-pro install
 ```
 
 ### Premium Features
diff --git a/README.md b/README.md
@@ -604,14 +604,14 @@ Squads são equipes modulares de agentes IA. Veja a [Visão Geral de Squads](doc
 
 ## AIOX Pro
 
-O **AIOX Pro** (`@aiox-fullstack/pro`) é o módulo premium do AIOX, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.
+O **AIOX Pro** é o módulo premium do AIOX, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.
 
 > **Disponibilidade restrita:** O AIOX Pro está disponível exclusivamente para membros do **AIOX Cohort Advanced**. [Saiba mais sobre o programa](https://aioxsquad.ai).
 
 ### Instalação
 
 ```bash
-npm install @aiox-fullstack/pro
+npx aiox-pro install
 ```
 
 ### Features Premium
diff --git a/docs/guides/pro/install-gate-setup.md b/docs/guides/pro/install-gate-setup.md
@@ -19,14 +19,14 @@ Comprar Licenca → Instalar → Ativar → Usar Features Pro
 | Pacote | Tipo | Proposito |
 |--------|------|-----------|
 | `aiox-pro` | CLI (1.8 KB) | Comandos de instalacao e gerenciamento |
-| `@aiox-fullstack/pro` | Core (10 MB) | Features premium (squads, memory, metrics, integrations) |
+| `@aiox-fullstack/pro` | Core (10 MB) | Nome canônico do pacote premium (com fallback legado durante a transição) |
 
 ---
 
 ## Instalacao Rapida
 
 ```bash
-# Instalar AIOX Pro (instala @aiox-fullstack/pro automaticamente)
+# Instalar AIOX Pro (instala o pacote Pro compatível automaticamente)
 npx aiox-pro install
 
 # Ativar sua licenca
@@ -51,12 +51,12 @@ npx aiox-pro status
 npx aiox-pro install
 ```
 
-Isso executa `npm install @aiox-fullstack/pro` no seu projeto.
+Isso instala o pacote Pro compatível no seu projeto, priorizando o nome canônico e caindo para o legado quando necessário.
 
 **Alternativa** (instalacao manual):
 
 ```bash
-npm install @aiox-fullstack/pro
+npx aiox-pro install
 ```
 
 ### Passo 2: Ativar Licenca
@@ -88,7 +88,7 @@ npx aiox-pro features
 
 | Comando | Descricao |
 |---------|-----------|
-| `npx aiox-pro install` | Instala `@aiox-fullstack/pro` no projeto |
+| `npx aiox-pro install` | Instala o pacote AIOX Pro compatível no projeto |
 | `npx aiox-pro activate --key KEY` | Ativa uma chave de licenca |
 | `npx aiox-pro status` | Mostra status da licenca atual |
 | `npx aiox-pro features` | Lista todas as features pro e disponibilidade |
diff --git a/docs/stories/epic-123/STORY-123.1-pro-sync-automation.md b/docs/stories/epic-123/STORY-123.1-pro-sync-automation.md
@@ -1,4 +1,4 @@
-# Story 123.1: Automação de sync do Pro entre `aios-pro` e `aiox-core`
+# Story 123.1: Automação de sync do Pro entre `aiox-pro` e `aiox-core`
 
 ## Status
 
@@ -8,42 +8,42 @@
 
 ## Contexto
 
-O fluxo atual permite que novos squads entrem no repositório `aios-pro` sem serem propagados com previsibilidade para o bundle `pro/` consumido pelo `aiox-core`. O resultado é drift silencioso: o conteúdo existe no GitHub, mas não necessariamente chega ao instalador guiado do Pro.
+O fluxo atual permite que novos squads entrem no repositório `aiox-pro` sem serem propagados com previsibilidade para o bundle `pro/` consumido pelo `aiox-core`. O resultado é drift silencioso: o conteúdo existe no GitHub, mas não necessariamente chega ao instalador guiado do Pro.
 
 ## Objetivo
 
-Estabelecer um fluxo de sync por fonte única, com `aios-pro` como origem dos squads Pro e `aiox-core/pro` como espelho controlado por PR automática.
+Estabelecer um fluxo de sync por fonte única, com `aiox-pro` como origem dos squads Pro e `aiox-core/pro` como espelho controlado por PR automática.
 
 ## Acceptance Criteria
 
-- [x] AC1. O `aios-pro` valida automaticamente que todo squad top-level publicado está presente em `package.json` e em `squads/README.md`.
-- [x] AC2. Mudanças compatíveis em `aios-pro` abrem ou atualizam automaticamente uma PR no `aiox-core` avançando o submódulo `pro`.
+- [x] AC1. O `aiox-pro` valida automaticamente que todo squad top-level publicado está presente em `package.json` e em `squads/README.md`.
+- [x] AC2. Mudanças compatíveis em `aiox-pro` abrem ou atualizam automaticamente uma PR no `aiox-core` avançando o submódulo `pro`.
 - [x] AC3. O `aiox-core` possui um workflow manual/agendado de fallback para reconciliar drift do submódulo `pro`.
 - [x] AC4. O plano operacional documenta segredos necessários, branch de sync, e lista dos arquivos alterados.
 
 ## Tasks
 
-- [x] Criar validação de publish surface no `aios-pro`
-- [x] Atualizar README/package surface do `aios-pro`
-- [x] Adicionar workflow de sync `aios-pro` -> `aiox-core`
+- [x] Criar validação de publish surface no `aiox-pro`
+- [x] Atualizar README/package surface do `aiox-pro`
+- [x] Adicionar workflow de sync `aiox-pro` -> `aiox-core`
 - [x] Adicionar fallback workflow no `aiox-core`
 - [x] Executar validações locais
 
 ## Notas de Implementação
 
-- Fonte de verdade: `SynkraAI/aios-pro`
+- Fonte de verdade: `SynkraAI/aiox-pro`
 - Espelho controlado: submódulo `pro` em `SynkraAI/aiox-core`
 - Branch de sync: `bot/sync-pro-submodule`
-- Segredo esperado no `aios-pro`: `AIOX_CORE_SYNC_TOKEN`
+- Segredo esperado no `aiox-pro`: `AIOX_CORE_SYNC_TOKEN`
 - Segredo opcional no `aiox-core`: `PRO_SUBMODULE_TOKEN` (necessário se o remoto `pro` for privado)
 
 ## File List
 
 - [docs/stories/epic-123/STORY-123.1-pro-sync-automation.md](./STORY-123.1-pro-sync-automation.md)
 - [.github/workflows/sync-pro-submodule.yml](../../../.github/workflows/sync-pro-submodule.yml)
-- `package.json` (`aios-pro`)
-- `squads/README.md` (`aios-pro`)
-- `scripts/validate-publish-surface.js` (`aios-pro`)
-- `.github/workflows/ci.yml` (`aios-pro`)
-- `.github/workflows/publish.yml` (`aios-pro`)
-- `.github/workflows/sync-aiox-core.yml` (`aios-pro`)
+- `package.json` (`aiox-pro`)
+- `squads/README.md` (`aiox-pro`)
+- `scripts/validate-publish-surface.js` (`aiox-pro`)
+- `.github/workflows/ci.yml` (`aiox-pro`)
+- `.github/workflows/publish.yml` (`aiox-pro`)
+- `.github/workflows/sync-aiox-core.yml` (`aiox-pro`)
diff --git a/docs/stories/epic-123/STORY-123.2-aiox-pro-alignment-and-update-flow.md b/docs/stories/epic-123/STORY-123.2-aiox-pro-alignment-and-update-flow.md
@@ -0,0 +1,70 @@
+# Story 123.2: Alinhamento definitivo de `aiox-pro` e fluxo explícito de atualização
+
+## Status
+
+- [x] Rascunho
+- [x] Em revisão
+- [ ] Concluída
+
+## Contexto
+
+Após o rename do repositório Pro para `aiox-pro`, ainda existe drift entre:
+
+- URL do submódulo e workflows de sync
+- nome do pacote npm (`@aios-fullstack/pro` publicado vs `@aiox-fullstack/pro` desejado)
+- comandos de instalação e atualização do Pro
+- documentação e referências internas
+
+Sem um caminho explícito de atualização, o reinstall do `aiox-core` pode reaplicar o bundle embutido sem buscar a versão Pro mais recente publicada.
+
+## Objetivo
+
+Padronizar a superfície do Pro em torno de `aiox-pro`, manter compatibilidade transitória com o pacote legado `@aios-fullstack/pro`, e oferecer um comando explícito para atualizar o Pro via npm com re-scaffold dos assets.
+
+## Acceptance Criteria
+
+- [x] AC1. `aiox-core` e `aiox-pro` referenciam o repositório `SynkraAI/aiox-pro` em workflows, metadados e documentação operacional.
+- [x] AC2. O carregamento, instalação e verificação do Pro aceitam `@aiox-fullstack/pro` como nome canônico e `@aios-fullstack/pro` como fallback de compatibilidade.
+- [x] AC3. Existe um comando explícito de atualização do Pro que instala a versão mais recente disponível no npm e re-scaffolda os assets sem exigir reinstall do `aiox-core`.
+- [x] AC4. A story documenta os arquivos alterados e o estado de transição entre o pacote legado e o canônico.
+
+## Tasks
+
+- [x] Integrar a implementação existente de `aiox pro update` no `aiox-core`
+- [x] Ajustar workflows e referências de repo para `aiox-pro`
+- [x] Padronizar o pacote e a documentação do repositório Pro renomeado
+- [x] Validar instalação, update e sync localmente
+
+## Notas de Implementação
+
+- Repositório canônico: `SynkraAI/aiox-pro`
+- Pacote canônico desejado: `@aiox-fullstack/pro`
+- Pacote legado ainda publicado: `@aios-fullstack/pro`
+- Estratégia de migração: canônico + fallback, sem quebrar installs existentes
+- Estado do npm em 2026-04-11: a conta local `rafaelscosta` tem administração no org `@aios-fullstack`, mas não possui acesso ao org `@aiox-fullstack`. O código já aceita o nome canônico; a publicação do pacote canônico depende da permissão correta no npm.
+
+## File List
+
+- [.aiox-core/cli/commands/pro/index.js](../../../.aiox-core/cli/commands/pro/index.js)
+- [.aiox-core/core/pro/pro-updater.js](../../../.aiox-core/core/pro/pro-updater.js)
+- [.github/workflows/pro-integration.yml](../../../.github/workflows/pro-integration.yml)
+- [.github/workflows/publish-pro.yml](../../../.github/workflows/publish-pro.yml)
+- [.github/workflows/sync-pro-submodule.yml](../../../.github/workflows/sync-pro-submodule.yml)
+- [.gitmodules](../../../.gitmodules)
+- [README.md](../../../README.md)
+- [README.en.md](../../../README.en.md)
+- [bin/utils/pro-detector.js](../../../bin/utils/pro-detector.js)
+- [docs/guides/pro/install-gate-setup.md](../../../docs/guides/pro/install-gate-setup.md)
+- [docs/stories/epic-123/STORY-123.1-pro-sync-automation.md](./STORY-123.1-pro-sync-automation.md)
+- [docs/stories/epic-123/STORY-123.2-aiox-pro-alignment-and-update-flow.md](./STORY-123.2-aiox-pro-alignment-and-update-flow.md)
+- [packages/aiox-pro-cli/bin/aiox-pro.js](../../../packages/aiox-pro-cli/bin/aiox-pro.js)
+- [packages/installer/src/pro/pro-scaffolder.js](../../../packages/installer/src/pro/pro-scaffolder.js)
+- [packages/installer/src/wizard/i18n.js](../../../packages/installer/src/wizard/i18n.js)
+- [packages/installer/src/wizard/pro-setup.js](../../../packages/installer/src/wizard/pro-setup.js)
+- [pro](../../../pro)
+- [tests/pro/pro-detector.test.js](../../../tests/pro/pro-detector.test.js)
+- [tests/pro/pro-updater.test.js](../../../tests/pro/pro-updater.test.js)
+
+## Evidências Externas
+
+- PR mergeada do repositório Pro renomeado: `SynkraAI/aiox-pro#7`
diff --git a/packages/aiox-pro-cli/bin/aiox-pro.js b/packages/aiox-pro-cli/bin/aiox-pro.js
@@ -8,6 +8,7 @@
  *
  * Commands:
  *   install             Install AIOX Pro in the current project
+ *   update              Update AIOX Pro and re-sync assets
  *   activate --key X    Activate a license key
  *   deactivate          Deactivate the current license
  *   status              Show license status
@@ -139,6 +140,7 @@ Usage:
 
 Commands:
   install              Install AIOX Pro in the current project
+  update               Update AIOX Pro and re-sync assets
   install --wizard     Install and run the setup wizard
   setup, wizard        Run Pro setup wizard (license gate + scaffold + verify)
   activate --key KEY   Activate a license key
@@ -152,6 +154,7 @@ Commands:
 
 Examples:
   npx aiox-pro install
+  npx aiox-pro update
   npx aiox-pro setup
   npx aiox-pro wizard --key PRO-XXXX-XXXX-XXXX-XXXX
   npx aiox-pro activate --key PRO-XXXX-XXXX-XXXX-XXXX
@@ -234,6 +237,7 @@ switch (command) {
   case 'status':
   case 'features':
   case 'validate':
+  case 'update':
     if (!isProInstalled()) {
       console.error('AIOX Pro is not installed.');
       console.error('Run first: npx aiox-pro install\n');
diff --git a/packages/installer/src/pro/pro-scaffolder.js b/packages/installer/src/pro/pro-scaffolder.js
diff --git a/packages/installer/src/wizard/i18n.js b/packages/installer/src/wizard/i18n.js
diff --git a/pro b/pro

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`# aiox-core CI runs standalone (ADR-PRO-001). This workflow validates`
`5`	`5`	`# the integration boundary between core and pro.`
`6`	`6`	`#`
`7`		`-# Requires PRO_SUBMODULE_TOKEN secret (PAT with repo scope for SynkraAI/aios-pro).`
	`7`	`+# Requires PRO_SUBMODULE_TOKEN secret (PAT with repo scope for SynkraAI/aiox-pro).`
`8`	`8`	`#`
`9`	`9`	`# Tests covered:`
`10`	`10`	`# - tests/pro/** (integration tests in aiox-core)`