sinapse-ai 1.25.0 → 1.25.2

package/README.en.md

@@ -19,9 +19,9 @@
 
 ## What is SINAPSE?
 
-SINAPSE is an open-source meta-framework that organizes **172 AI agents into 17 specialized squads**, operating directly in the terminal via Claude Code or Codex CLI. Each agent has a defined role, each squad masters a discipline, and the entire system is governed by a **Constitution with real enforcement** -- 17 active hooks that block violations at runtime.
+SINAPSE is an open-source meta-framework that organizes **172 AI agents into 17 specialized squads**, operating directly in the terminal via Claude Code or Codex CLI. Each agent has a defined role, each squad masters a discipline, and the entire system is governed by a **Constitution with real enforcement** -- 20 registered Claude Code hooks and 9 Codex lifecycle events through the compatibility bridge.
 
-The core concept is simple: instead of a single AI assistant trying to do everything, SINAPSE structures work into specialized teams. A branding squad handles visual identity. A cybersecurity squad handles compliance and pentesting. A copywriting squad handles persuasion and conversion. Each with its own knowledge base, workflows, and tasks -- totaling **1,200 executable tasks** ready to use.
+The core concept is simple: instead of a single AI assistant trying to do everything, SINAPSE structures work into specialized teams. A branding squad handles visual identity. A cybersecurity squad handles compliance and pentesting. A copywriting squad handles persuasion and conversion. The runtime measures **1,412 task files**: **1,201 squad tasks** and **211 development tasks**. Of those files, **1,348 pointers are resolvable** by real agents.
 
 Unlike tools that just chat with AI, SINAPSE enforces discipline. The **Documentation-First** pipeline requires a story to be created and validated before any code is written. Quality gates run automatically before merge. Unauthorized agents are blocked from pushing. All via hooks that intercept operations in real time -- not after the fact.
 
@@ -33,7 +33,7 @@ Generative AI has a known problem: the more you ask of it, the worse it gets. A
 
 SINAPSE solves this the way human teams solve it: **coordinated specialization**. Instead of one tired generalist, you have 172 agents in 17 squads, each with a defined role, its own knowledge base, and executable tasks. An orchestrator routes your request to whoever actually knows how to solve it -- automatically, without you needing to memorize agent names or commands.
 
-The differential isn't just the quantity of agents. It's **real governance**: 17 active hooks intercept operations at runtime, a Constitution with 11 articles governs the framework, and 7 of those articles are NON-NEGOTIABLE -- violations are blocked before execution, not detected afterwards. **Speed with rigor, without choosing between the two.**
+The differential isn't just the quantity of agents. It's **real governance**: 20 Claude Code hook registrations and 9 Codex lifecycle events intercept operations at runtime, a Constitution with 11 articles governs the framework, and 7 of those articles are NON-NEGOTIABLE -- violations are blocked before execution, not detected afterwards. **Speed with rigor, without choosing between the two.**
 
 ---
 
@@ -55,9 +55,18 @@ npx sinapse-ai doctor
 
 ### 3. Activate your first agent
 
+Claude Code:
+
+```text
+@developer
+*help
 ```
-@developer          # Activate the development agent
-*help               # List available commands
+
+Codex:
+
+```text
+$snps
+$sinapse-agent developer
 ```
 
 Done. You have 17 squads operating in your terminal.
@@ -174,7 +183,7 @@ Deny rules in `.claude/settings.json` enforce this deterministically. **Framewor
 
 ### Constitution
 
-SINAPSE is governed by a formal Constitution with 11 articles and 17 enforcement hooks:
+SINAPSE is governed by a formal Constitution with 11 articles and provider-specific enforcement surfaces: 20 Claude Code hook registrations and 9 Codex lifecycle events.
 
 | Article | Principle | Severity |
 |---------|-----------|----------|
@@ -213,7 +222,7 @@ SINAPSE includes 12 core agents covering the complete development cycle:
 | `devops` | **Pipeline** | CI/CD, git push (exclusive), releases |
 | `squad-creator` | **Loom** | New squad creation |
 
-Activate any agent with `@agent-name` and use `*help` to see its commands.
+In Claude Code, activate an agent with `@agent-name` and use `*help` to see its commands. In Codex, start with `$snps` for routing or use `$sinapse-agent agent-id` for direct activation.
 
 ### Development Workflow
 
@@ -263,15 +272,19 @@ Each squad is an autonomous team with its own orchestrator, specialist agents, k
 | **squad-growth** | Analytics, CRO, SEO, growth hacking | 7 |
 | **squad-finance** | Budget, pricing, profitability analysis | 8 |
 
-**Total: 17 squads, 172 specialized agents, 1,201 tasks**
+**Total: 17 squads, 172 specialized agents, and 1,412 task files** (**1,201 squad tasks + 211 development tasks; 1,348 resolvable pointers**)
 
-Activate any squad via its orchestrator:
+Activate any squad via its orchestrator using the provider-native syntax:
 
-```
+```text
+# Claude Code
 @brand-orqx         # Brand squad
 @copy-orqx          # Copy squad
-@cyber-orqx         # Cybersecurity squad
-@research-orqx      # Research squad
+
+# Codex
+$sinapse-agent brand-orqx
+$sinapse-agent copy-orqx
+$snps               # Route through the primary orchestrator
 ```
 
 The orchestrator receives your request and automatically delegates to the right specialist within the squad.
@@ -285,27 +298,22 @@ SINAPSE supports two IDEs with deep integrations:
 | IDE | Activation | Highlights |
 |-----|------------|------------|
 | **Claude Code** | `@agent-name` | Hooks, contextual rules, deny/allow, Chrome Brain |
-| **Codex CLI** | `/skills` or `$skill-name` | Native skills, multi-model, `codex exec` for CI/CD |
+| **Codex CLI** | `$snps` or `$sinapse-agent agent-id` | Native skills, multi-model, `codex exec` for CI/CD |
 
 Both IDEs have access to all 17 squads, 172 agents, workflows, and knowledge bases. The installer detects and configures automatically.
 
 ### Parity Table
 
-| Feature | Claude Code | Codex CLI |
-|---------|:-----------:|:---------:|
-| Agent activation (@agent) | Full | Full |
-| Constitutional hooks (20) | Full | Partial (5) |
-| Story-driven development | Full | Full |
-| Quality gates | Full | Full |
-| Delegation enforcement | Full | Partial |
-| Secret scanning | Full | Manual |
-| CodeRabbit integration | Full | N/A |
-| Skills system | Full | Commands |
-| MCP servers | Full | N/A |
-| Terminal Bus | Full | N/A |
-
-**Claude Code** for the most integrated and automated experience.
-**Codex CLI** for model flexibility and CI/CD automation.
+| Measured surface | Claude Code | Codex CLI |
+|------------------|:-----------:|:---------:|
+| Native agents | 172 | 172 |
+| Direct activation | `@agent-name` | `$sinapse-agent agent-id` |
+| Primary routing | `@sinapse-orqx` | `$snps` |
+| Installed skills | 36 | 37 |
+| Registered hooks | 20 native registrations | 9 lifecycle events through the bridge |
+| Validation source | `npm run validate:providers` | `npm run validate:codex-native` |
+
+Both providers resolve the same agents, tasks, workflows, and knowledge bases. Their activation and hook surfaces are different native adapters validated independently by the parity gate.
 
 ---
 
@@ -335,7 +343,7 @@ If you identify with the first group, you're in the right place.
 
 ### Constitutional Enforcement
 
-SINAPSE doesn't just document rules -- it enforces them with **17 active hooks**:
+SINAPSE doesn't just document rules -- Claude Code uses **20 registered hooks**, while Codex exposes **9 lifecycle events** through the compatibility bridge:
 
 - `enforce-git-push-authority.sh` -- blocks push by unauthorized agents
 - `enforce-story-gate.cjs` -- blocks code without a validated story
@@ -400,7 +408,7 @@ npx sinapse-ai doctor --dry-run  # Show what `--fix` would do without applying
 npx sinapse-ai chrome-brain install   # Install browser automation
 ```
 
-All commands are safe to re-run. To list active agents after installing, open Claude Code or Codex CLI and type `@` to autocomplete.
+All commands are safe to re-run. After installing, use `@agent-name` in Claude Code or `$snps` / `$sinapse-agent agent-id` in Codex.
 
 ---
 

package/README.md

@@ -23,7 +23,7 @@
 
 SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 20 hooks registrados que bloqueiam violações em tempo de execução.
 
-O conceito central é simples: em vez de um único assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasão e conversão. Cada um com sua própria knowledge base, workflows e tasks — totalizando **1.201 tasks executáveis** prontas para uso, distribuídas pelos 17 squads.
+O conceito central é simples: em vez de um único assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasão e conversão. Cada um com sua própria knowledge base, workflows e tasks. O runtime mede **1.412 task files**: **1.201 squad tasks** nos 17 squads e **211 development tasks**. Desses arquivos, **1.348 são resolvíveis** pelos ponteiros reais dos agentes.
 
 Diferente de ferramentas que apenas conversam com IA, o SINAPSE impõe disciplina. O pipeline **Documentation-First** exige que uma story seja criada e validada antes de qualquer linha de código. Quality gates rodam automaticamente antes de merge. Agentes não autorizados são bloqueados de fazer push. Tudo isso via hooks que interceptam operações em tempo real — não depois.
 
@@ -63,9 +63,18 @@ Se algo estiver fora do lugar, `doctor --fix` corrige automaticamente.
 
 ### 3. Ative seu primeiro agente
 
+Claude Code:
+
+```text
+@developer
+*help
 ```
-@developer          # Ativa o agente de desenvolvimento
-*help               # Lista comandos disponíveis
+
+Codex:
+
+```text
+$snps
+$sinapse-agent developer
 ```
 
 Pronto. Você tem 17 squads operando no seu terminal.
@@ -235,7 +244,7 @@ O SINAPSE inclui 12 agentes core que cobrem o ciclo completo de desenvolvimento:
 | `devops` | **Pipeline** | CI/CD, git push (exclusivo), releases |
 | `squad-creator` | **Loom** | Criação de novos squads |
 
-Ative qualquer agente com `@agent-name` e use `*help` para ver seus comandos.
+No Claude Code, ative um agente com `@agent-name` e use `*help` para ver seus comandos. No Codex, comece com `$snps` para roteamento ou use `$sinapse-agent agent-id` para ativação direta.
 
 ### Workflow de Desenvolvimento
 
@@ -285,15 +294,19 @@ Cada squad é uma equipe autônoma com orquestrador, agentes especialistas, know
 | **squad-growth** | Analytics, CRO, SEO, growth hacking | 7 |
 | **squad-finance** | Budget, pricing, profitability analysis | 8 |
 
-**Total: 17 squads, 172 agentes especializados, 1.201 tasks**
+**Total: 17 squads, 172 agentes especializados e 1.412 task files** (**1.201 squad tasks + 211 development tasks; 1.348 ponteiros resolvíveis**)
 
-Cada squad é ativado via seu orquestrador:
+Cada squad é ativado via seu orquestrador, com a sintaxe nativa do provedor:
 
-```
+```text
+# Claude Code
 @brand-orqx         # Squad de brand
 @copy-orqx          # Squad de copy
-@cyber-orqx         # Squad de cybersecurity
-@research-orqx      # Squad de research
+
+# Codex
+$sinapse-agent brand-orqx
+$sinapse-agent copy-orqx
+$snps               # Roteamento pelo orquestrador principal
 ```
 
 O orquestrador recebe seu pedido e delega automaticamente ao especialista correto dentro do squad.
@@ -306,28 +319,23 @@ O SINAPSE suporta duas IDEs com integrações profundas:
 
 | IDE | Ativação | Destaques |
 |-----|----------|-----------|
-| **Claude Code** | `@agent-name` ou `/skill-name` | Subagentes e skills nativos, hooks e rules contextuais |
+| **Claude Code** | `@agent-name` | Subagentes e skills nativos, hooks e rules contextuais |
 | **Codex CLI** | `$snps` ou `$sinapse-agent agent-id` | Agentes TOML, skills nativas e `codex exec` para CI/CD |
 
 Ambas as IDEs têm acesso a todos os 17 squads, 172 agentes, workflows e knowledge bases. O installer detecta e configura automaticamente.
 
 ### Tabela de Paridade
 
-| Funcionalidade | Claude Code | Codex CLI |
-|---------------|:-----------:|:---------:|
-| Ativação dos 172 agentes | `@agent-name` | `$sinapse-agent agent-id` |
-| Hooks constitucionais (20) | Completo | Parcial (5) |
-| Story-driven development | Completo | Completo |
-| Quality gates | Completo | Completo |
-| Enforcement de delegação | Completo | Parcial |
-| Secret scanning | Completo | Manual |
-| Integração CodeRabbit | Completo | N/A |
-| Sistema de skills | Completo | Comandos |
-| MCP servers | Completo | N/A |
-| Terminal Bus | Completo | N/A |
-
-**Claude Code** para a experiência mais integrada e automatizada.
-**Codex CLI** para flexibilidade de modelo e automação CI/CD.
+| Superfície medida | Claude Code | Codex CLI |
+|-------------------|:-----------:|:---------:|
+| Agentes nativos | 172 | 172 |
+| Ativação direta | `@agent-name` | `$sinapse-agent agent-id` |
+| Roteamento principal | `@sinapse-orqx` | `$snps` |
+| Skills instaladas | 36 | 37 |
+| Hooks registrados | 20 registros nativos | 9 eventos de lifecycle via bridge |
+| Fonte de validação | `npm run validate:providers` | `npm run validate:codex-native` |
+
+Os dois providers resolvem os mesmos agents, tasks, workflows e knowledge bases. As superfícies de ativação e hooks são adapters nativos diferentes e são validadas separadamente pelo gate de paridade.
 
 ---
 

package/bin/cli.js

@@ -96,6 +96,10 @@ if (require.main === module) {
 
 function runRouter() {
   const args = process.argv.slice(2);
+  if (args[0] === 'install' && (args.includes('--help') || args.includes('-h'))) {
+    cmdHelp();
+    return;
+  }
   // Story 10.46 — empty invocation on a fresh machine routes to a first-run
   // hint instead of the bare help screen, so new users discover `install`.
   let command = args[0];
@@ -105,9 +109,12 @@ function runRouter() {
   const isLocal = args.includes('--local');
   const isForce = args.includes('--force');
   const isReconfigure = args.includes('--reconfigure');
+  const isGlobalOnly = args.includes('--global-only');
+  const llmFlag = args.find((arg) => arg.startsWith('--llm='));
+  const requestedLlm = llmFlag ? llmFlag.slice('--llm='.length) : null;
 
   switch (command) {
-    case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal({ force: isForce, reconfigure: isReconfigure }).catch(e => { const { formatErrorMessage } = require('./utils/install-errors'); logger.error(formatErrorMessage(e)); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); }); break;
+    case 'install':  isLocal ? cmdInstallLocal() : cmdInstallGlobal({ force: isForce, reconfigure: isReconfigure, globalOnly: isGlobalOnly, llm: requestedLlm }).catch(e => { const { formatErrorMessage } = require('./utils/install-errors'); logger.error(formatErrorMessage(e)); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); }); break;
     case 'update':   isLocal ? cmdUpdateLocal()  : cmdUpdateGlobal().catch(e => { logger.error(`${RED}Erro ao atualizar:${NC} ${e.message}`); logger.error(`Tente: ${CYAN}npx sinapse-ai doctor${NC}`); process.exit(1); });  break;
     case 'uninstall': {
       const isYes = args.includes('--yes') || args.includes('-y');

package/bin/commands/help.js

@@ -13,6 +13,7 @@ function cmdHelp() {
   logger.always(`  ${CYAN}npx sinapse-ai install${NC}               Instala SINAPSE (idempotente — re-runs são upserts)`);
   logger.always(`  ${CYAN}npx sinapse-ai install --force${NC}       Reinstala do zero, mesmo se já instalado`);
   logger.always(`  ${CYAN}npx sinapse-ai install --reconfigure${NC} Re-pergunta idioma/LLM sem apagar instalação`);
+  logger.always(`  ${CYAN}npx sinapse-ai install --llm=both --global-only${NC} Instala Claude + Codex sem alterar o projeto atual`);
   logger.always(`  ${CYAN}npx sinapse-ai update${NC}           Atualiza SINAPSE para a última versão`);
   logger.always(`  ${CYAN}npx sinapse-ai uninstall${NC}        Remove SINAPSE globalmente (pede confirmação)`);
   logger.always(`  ${CYAN}npx sinapse-ai uninstall --yes${NC}  Remove SINAPSE globalmente (sem prompt — exigido em CI)`);
@@ -36,8 +37,8 @@ function cmdHelp() {
   logger.always(`  ${CYAN}sinapse --continue${NC}           Continua última sessão`);
   logger.always('');
   logger.always(`${BOLD}Agents:${NC}\n`);
-  logger.always(`  Invocação canônica:  ${CYAN}/SINAPSE:agents:{agent-id}${NC}`);
-  logger.always(`  Exemplo:             ${CYAN}/SINAPSE:agents:brand-orqx${NC}`);
+  logger.always(`  Invocação canônica:  ${CYAN}$sinapse-agent <agent-id>${NC}`);
+  logger.always(`  Exemplo:             ${CYAN}$sinapse-agent brand-orqx${NC}`);
   logger.always(`  Master orchestrator: ${CYAN}@sinapse-orqx${NC} (alias: ${DIM}@snps-orqx${NC})`);
   logger.always('');
   logger.always(`${BOLD}Ajuda extra:${NC}\n`);

package/bin/commands/install.js

@@ -49,6 +49,7 @@ const {
   regenerateAgentCommands,
 } = require('../lib/command-generator');
 const { deliverGlobalProviderAdapters, getGlobalCommandStagingDir } = require('../lib/global-provider-adapters');
+const { assertProviderAdapterParity } = require('../lib/provider-parity');
 // Follow-up #13 — wire the transactional backup/rollback engine into the
 // installer so an in-place UPGRADE (upsert) that fails mid-flight is restored
 // to its previous state instead of leaving ~/.sinapse half-updated.
@@ -64,6 +65,11 @@ async function cmdInstallGlobal(opts = {}) {
   // Story 10.20 — Upsert detection
   const force = Boolean(opts.force);
   const reconfigure = Boolean(opts.reconfigure);
+  const globalOnly = Boolean(opts.globalOnly);
+  const requestedLlm = opts.llm || null;
+  if (requestedLlm && !['claude-code', 'codex', 'both'].includes(requestedLlm)) {
+    throw new Error(`Invalid --llm value: ${requestedLlm}. Use claude-code, codex, or both.`);
+  }
   const existing = force ? { upsert: false } : detectExistingInstall();
   const isUpsert = existing.upsert;
 
@@ -126,7 +132,9 @@ async function cmdInstallGlobal(opts = {}) {
   // Story 10.35: --reconfigure forces prompt even in upsert mode
   let llmChoice;
   let llmWasReused = false;
-  if (isUpsert && !reconfigure && existing.llm) {
+  if (requestedLlm) {
+    llmChoice = requestedLlm;
+  } else if (isUpsert && !reconfigure && existing.llm) {
     llmChoice = existing.llm;
     llmWasReused = true;
     const ideLabel = Array.isArray(llmChoice) ? llmChoice.join(', ') : String(llmChoice);
@@ -222,7 +230,7 @@ async function cmdInstallGlobal(opts = {}) {
   // project-wizard WARN must NOT revert an otherwise-good global install.
   const tx = createInstallTransaction();
   const txPaths = buildTransactionPaths(llmChoice);
-  const { writtenAgents, totalAgents, totalDelta, squadsRefreshed, squadsAdded, meta } =
+  const { activeAgentCount, totalDelta, squadsRefreshed, squadsAdded, meta } =
     await runFatalPhasesTransactional({
       tx,
       isUpsert,
@@ -269,7 +277,10 @@ async function cmdInstallGlobal(opts = {}) {
 
   // Phase 8: Install project-local files (.sinapse-ai/, .claude/, .env)
   logger.always(`\n${CYAN}Phase 8:${NC} Installing project files in current directory`);
-  try {
+  const skipProjectInstall = globalOnly || path.resolve(process.cwd()) === path.resolve(ROOT);
+  if (skipProjectInstall) {
+    logger.always(`  ${YELLOW}SKIP${NC} Project files (${globalOnly ? '--global-only' : 'source checkout detected'})`);
+  } else try {
     const wizardPath = path.join(ROOT, 'packages', 'installer', 'src', 'wizard', 'index.js');
     if (fs.existsSync(wizardPath)) {
       const { runWizard: executeWizard } = require(wizardPath);
@@ -348,7 +359,7 @@ async function cmdInstallGlobal(opts = {}) {
     logger.always(`${YELLOW}══════════════════════════════════════════════════════════════${NC}`);
   }
   logger.always('');
-  logger.always(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${totalAgents} agents${NC} | ${BOLD}${writtenAgents.size} command files${NC}`);
+  logger.always(`  ${BOLD}${squads.length} squads${NC} | ${BOLD}${activeAgentCount} agents${NC} | ${BOLD}${activeAgentCount} native adapters${NC}`);
   logger.always(`  ${startCmd}`);
   logger.always('');
   logger.always(`  ${BOLD}Try an agent:${NC}`);
@@ -402,6 +413,9 @@ function buildTransactionPaths(llmChoice) {
     CLAUDE_COMMANDS_DIR,   // Phase 2 — generated /SINAPSE:agents:* command files
   ];
   if (llmChoice === 'claude-code' || llmChoice === 'both') dirs.push(path.join(HOME, '.claude', 'agents'));
+  // A Claude-only provider switch removes stale Codex aliases during the fatal
+  // phases, so that cleanup must be covered by the same upgrade rollback.
+  if (llmChoice === 'claude-code') dirs.push(path.join(HOME, '.agents', 'skills'));
   if (llmChoice === 'codex' || llmChoice === 'both') {
     dirs.push(path.join(HOME, '.codex', 'agents'));
     dirs.push(path.join(HOME, '.agents', 'skills'));
@@ -478,7 +492,7 @@ async function runFatalPhasesTransactional({ tx, isUpsert, paths, runPhases, onR
  * @param {string} ctx.llmChoice
  * @param {Object} ctx.existing  - detectExistingInstall() result
  * @param {Object} ctx.logger
- * @returns {{ writtenAgents: Set, totalAgents: number, totalDelta: Object, squadsRefreshed: number, squadsAdded: number, meta: Object }}
+ * @returns {{ writtenAgents: Set, activeAgentCount: number, totalDelta: Object, squadsRefreshed: number, squadsAdded: number, meta: Object }}
  */
 function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing, logger }) {
   // Phase 1: Copy squads to ~/.sinapse/
@@ -486,7 +500,6 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
   fs.mkdirSync(SINAPSE_HOME, { recursive: true });
 
   const squadsSrcBase = fs.existsSync(squadsDir) ? squadsDir : ROOT;
-  let totalAgents = 0;
   const totalDelta = { added: 0, updated: 0, unchanged: 0, removed: 0 };
   let squadsRefreshed = 0;
   let squadsAdded = 0;
@@ -507,7 +520,6 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
       copyDirSync(src, dest);
       logger.always(`  ${GREEN}OK${NC} ${squad.name} (${squad.agents} agents)`);
     }
-    totalAgents += squad.agents;
   }
 
   // Copy sinapse/ orqx squad
@@ -525,7 +537,6 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
       copyDirSync(sinapseMasterSrc, sinapseMasterDest);
     }
     const masterAgents = getAgentFiles(sinapseMasterDest).length;
-    totalAgents += masterAgents;
     logger.always(`  ${GREEN}OK${NC} sinapse (master, ${masterAgents} agents)`);
   }
 
@@ -543,14 +554,13 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
       copyDirSync(coreDevelopmentSrc, coreDevelopmentDest);
     }
     const coreAgents = getAgentFiles(coreDevelopmentDest).length;
-    totalAgents += coreAgents;
     logger.always(`  ${GREEN}OK${NC} core development (${coreAgents} agents)`);
   }
 
   // Phase 2: Generate agent commands (shared with `update` via command-generator).
   logger.always(`\n${CYAN}Phase 2:${NC} Generating agent commands`);
   const commandStagingDir = getGlobalCommandStagingDir({ llmChoice, sinapseHome: SINAPSE_HOME, claudeCommandsDir: CLAUDE_COMMANDS_DIR });
-  const { writtenAgents } = regenerateAgentCommands({
+  const { writtenAgents, totalAgents } = regenerateAgentCommands({
     sinapseHome: SINAPSE_HOME,
     commandsDir: commandStagingDir,
     squads,
@@ -561,6 +571,7 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
 
   // Phase 2b: Install global agents based on LLM choice
   const globalAdapters = deliverGlobalProviderAdapters({ llmChoice, home: HOME, commandsDir: commandStagingDir });
+  const activeAgentCount = assertProviderAdapterParity(llmChoice, globalAdapters, totalAgents);
   const installedAgentFilenames = new Set([...globalAdapters.claude, ...globalAdapters.codex]);
   const installedIdes = [];
   if (globalAdapters.claude.length) installedIdes.push('claude-code');
@@ -571,7 +582,7 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
   // Audit 1 P0 (UN-1) — record manifest so uninstall can remove every file
   // we wrote (not just `*-orqx.md`). Idempotent: re-install overwrites.
   reconcileInstalledAgents(HOME, installedAgentFilenames);
-  if (llmChoice === 'claude-code') removeManagedGlobalSkills(HOME);
+  if (llmChoice === 'claude-code') removeManagedGlobalSkills(HOME, { providers: ['codex'] });
   recordInstalledAgents(installedAgentFilenames, installedIdes);
 
   // Phase 3: Generate squad-awareness.md
@@ -595,8 +606,8 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
       ? existing.prevMeta.installedAt
       : nowIso,
     squads: squads.length,
-    agents: totalAgents,
-    commands: writtenAgents.size,
+    agents: activeAgentCount,
+    commands: activeAgentCount,
     llm: llmChoice,
     platform: process.platform,
   };
@@ -605,7 +616,7 @@ function installFatalPhases({ squads, squadsDir, isUpsert, llmChoice, existing,
   }
   atomicWriteFileSync(path.join(SINAPSE_HOME, 'metadata.json'), JSON.stringify(meta, null, 2));
 
-  return { writtenAgents, totalAgents, totalDelta, squadsRefreshed, squadsAdded, meta };
+  return { writtenAgents, activeAgentCount, totalDelta, squadsRefreshed, squadsAdded, meta };
 }
 
 function generateSquadAwareness(sinapseDir, squads) {

package/bin/commands/status.js

@@ -5,9 +5,9 @@ const fs = require('fs');
 const path = require('path');
 const { getLogger } = require('../../.sinapse-ai/core/logger');
 const {
+  HOME,
   ROOT,
   SINAPSE_HOME,
-  CLAUDE_COMMANDS_DIR,
   BIN_DIR,
   CYAN,
   GREEN,
@@ -18,12 +18,13 @@ const {
 } = require('../lib/constants');
 const { header } = require('../lib/header');
 const { getSquads } = require('../lib/squads');
+const { hasManagedInstalledAgents } = require('./uninstall');
 
 function verifyInstall() {
   const logger = getLogger();
   const checks = [
     [fs.existsSync(SINAPSE_HOME), `${getSquads(SINAPSE_HOME).length} squads in ~/.sinapse/`],
-    [fs.existsSync(CLAUDE_COMMANDS_DIR), 'Commands in ~/.claude/commands/SINAPSE/agents/'],
+    [hasManagedInstalledAgents(HOME), 'Native provider agents installed'],
     [fs.existsSync(path.join(BIN_DIR, 'sinapse')), 'Launcher at ~/bin/sinapse'],
     [fs.existsSync(path.join(SINAPSE_HOME, '.claude', 'rules', 'squad-awareness.md')), 'squad-awareness.md'],
   ];
@@ -52,7 +53,7 @@ function cmdList() {
 
   logger.always('');
   logger.always(`  ${BOLD}Total: ${GREEN}${totalAgents} agents${NC} | ${YELLOW}${totalTasks} tasks${NC}`);
-  logger.always(`  ${BOLD}Invoke: ${CYAN}/SINAPSE:agents:{agent-id}${NC}`);
+  logger.always(`  ${BOLD}Invoke: ${CYAN}$sinapse-agent <agent-id>${NC}`);
   logger.always('');
 }