sinapse-ai 1.25.0 → 1.25.1

package/.claude/settings.json

@@ -0,0 +1,170 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/synapse-wrapper.cjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/precompact-wrapper.cjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-permission-mode.cjs\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-git-push-authority.sh\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-framework-boundary.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-architecture-first.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/write-path-validation.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-story-gate.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/doc-first-gate.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-nsn-guard.cjs\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/code-intel-pretool.cjs\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/enforce-delegation.cjs\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/verify-packages.cjs\"",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/sql-governance.py\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/read-protection.py\"",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/slug-validation.py\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "python3 \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/mind-clone-governance.py\"",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/secret-scanning.cjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/telemetry-post-tool.cjs\"",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR:-.}/.claude/hooks/telemetry-stop.cjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/.codex/catalog.json

@@ -3,7 +3,7 @@
   "catalogMode": "expanded",
   "canonicalAgentsDir": ".sinapse-ai/development/agents",
   "codexAgentsDir": ".codex/agents",
-  "skillsDir": ".codex/skills",
+  "skillsDir": ".agents/skills",
   "expectedSkillIds": [
     "sinapse-agent",
     "sinapse-analyst",

package/.codex/scripts/sinapse-codex.js

@@ -82,10 +82,6 @@ function buildDoctorReport(projectRoot = PROJECT_ROOT) {
       projectRoot,
       `.agents/skills/${skillId}/SKILL.md`,
     ),
-    legacy: relativeFileExists(
-      projectRoot,
-      `.codex/skills/${skillId}/SKILL.md`,
-    ),
   }));
   const delegationEquivalent =
     JSON.stringify(delegationMatrix) === JSON.stringify(delegationParity);
@@ -97,7 +93,6 @@ function buildDoctorReport(projectRoot = PROJECT_ROOT) {
     delegationEquivalent,
     nativeAgentParity: agentSurfaces.markdown === agentSurfaces.toml,
     nativeWorkflowSkills: skills.every((skill) => skill.native),
-    legacyWorkflowSkills: skills.every((skill) => skill.legacy),
     workflowResolver: relativeFileExists(
       projectRoot,
       '.codex/scripts/resolve-codex-workflow.js',

package/.codex/scripts/sync-codex-native.js

@@ -3,8 +3,8 @@
 
 /**
  * Generate native Codex custom-agent adapters from the existing Markdown
- * pointers and restore authoritative native workflow skills after the legacy
- * Codex sync. Canonical agent definitions remain in `.sinapse-ai/` and
+ * pointers and maintain the authoritative native skill catalog. Canonical
+ * agent definitions remain in `.sinapse-ai/` and
  * `squads/`; generated files only teach Codex how to activate them.
  */
 
@@ -15,7 +15,6 @@ const { PROJECT_ROOT, loadCodexAgentIndex } = require('./resolve-codex-agent');
 
 const CODEX_AGENTS_DIR = '.codex/agents';
 const NATIVE_SKILLS_DIR = '.agents/skills';
-const COMPATIBILITY_SKILLS_DIR = '.codex/skills';
 const NATIVE_WORKFLOW_SKILLS = Object.freeze([
   'sinapse-orqx',
   'sinapse-spec-driven',
@@ -438,12 +437,7 @@ function collectCodexActivationSkills(projectRoot = PROJECT_ROOT, options = {})
       continue;
     }
 
-    const relativePath = `${COMPATIBILITY_SKILLS_DIR}/${skillId}/SKILL.md`;
-    const sourcePath = path.resolve(root, relativePath);
-    if (!isPathInside(root, sourcePath) || !fs.existsSync(sourcePath)) {
-      throw new Error(`Missing catalog activation skill: ${relativePath}`);
-    }
-    skills.push({ skillId, relativePath, content: fs.readFileSync(sourcePath, 'utf8') });
+    throw new Error(`Missing native catalog activation skill: ${nativeRelativePath}`);
   }
 
   for (const skillId of catalog.publicAliasSkillIds) {
@@ -483,7 +477,7 @@ function syncNativeActivationSkills(projectRoot, skills = collectCodexActivation
     created: 0,
     updated: 0,
     unchanged: 0,
-    sourceDir: COMPATIBILITY_SKILLS_DIR,
+    sourceDir: NATIVE_SKILLS_DIR,
     outputDir: normalizePath(path.relative(projectRoot, outputDir)),
   };
 
@@ -516,33 +510,9 @@ function collectNativeWorkflowSkills(projectRoot = PROJECT_ROOT) {
   });
 }
 
-function syncCodexWorkflowSkills(projectRoot, skills = collectNativeWorkflowSkills(projectRoot)) {
-  const outputDir = path.join(projectRoot, COMPATIBILITY_SKILLS_DIR);
-  const summary = {
-    total: skills.length,
-    created: 0,
-    updated: 0,
-    unchanged: 0,
-    sourceDir: NATIVE_SKILLS_DIR,
-    outputDir: normalizePath(path.relative(projectRoot, outputDir)),
-  };
-
-  for (const skill of skills) {
-    const skillDir = path.join(outputDir, skill.skillId);
-    fs.mkdirSync(skillDir, { recursive: true });
-    const status = writeFileIfChanged(path.join(skillDir, 'SKILL.md'), skill.content);
-    summary[status] += 1;
-  }
-
-  return summary;
-}
-
 function syncCodexNativeAgents(projectRoot = PROJECT_ROOT, options = {}) {
   const definitions = collectNativeAgentDefinitions(projectRoot);
   const activationSkills = collectCodexActivationSkills(projectRoot, options);
-  const compatibilitySkills = options.expandedSkills === true
-    ? collectCodexActivationSkills(projectRoot)
-    : activationSkills;
   const outputDir = path.join(projectRoot, CODEX_AGENTS_DIR);
   fs.mkdirSync(outputDir, { recursive: true });
 
@@ -562,7 +532,6 @@ function syncCodexNativeAgents(projectRoot = PROJECT_ROOT, options = {}) {
 
   summary.nativeSkills = syncNativeActivationSkills(projectRoot, activationSkills);
   summary.activationMode = options.expandedSkills === true ? 'expanded' : 'tiered';
-  summary.skills = syncCodexWorkflowSkills(projectRoot, compatibilitySkills);
 
   return summary;
 }
@@ -585,7 +554,6 @@ if (require.main === module) {
 module.exports = {
   CODEX_AGENTS_DIR,
   NATIVE_SKILLS_DIR,
-  COMPATIBILITY_SKILLS_DIR,
   NATIVE_WORKFLOW_SKILLS,
   CODEX_CATALOG_PATH,
   SUPREME_ORCHESTRATOR_ID,
@@ -609,6 +577,5 @@ module.exports = {
   renderExpandedAgentSkill,
   collectCodexActivationSkills,
   syncNativeActivationSkills,
-  syncCodexWorkflowSkills,
   syncCodexNativeAgents,
 };

package/.codex/scripts/validate-codex-native.js

@@ -133,7 +133,6 @@ function validateNativeCodex(projectRoot = PROJECT_ROOT) {
   const metrics = {
     markdownAgents: 0,
     nativeAgents: 0,
-    compatibilitySkills: 0,
     nativeSkills: 0,
     commands: 0,
   };
@@ -195,33 +194,24 @@ function validateNativeCodex(projectRoot = PROJECT_ROOT) {
   }
   check(nativeNames.has('sinapse-orqx'), 'Native supreme orchestrator must be named sinapse-orqx');
 
-  const skillIdsByRoot = {};
-  for (const [label, relativeRoot] of [['Compatibility skill', '.codex/skills'], ['Native skill', '.agents/skills']]) {
-    const files = collectSkillFiles(path.join(projectRoot, relativeRoot));
-    skillIdsByRoot[relativeRoot] = new Set(files.map((file) => path.basename(path.dirname(file))));
-    if (label === 'Compatibility skill') metrics.compatibilitySkills = files.length;
-    else metrics.nativeSkills = files.length;
-    for (const file of files) capture(`${label} ${path.relative(projectRoot, file)}`, () => {
-      const metadata = parseSkillFrontmatter(file);
-      check(metadata.name === path.basename(path.dirname(file)),
-        `${path.relative(projectRoot, file)} frontmatter name must match its directory`);
-      return metadata;
-    });
-  }
+  const nativeSkillRoot = '.agents/skills';
+  const nativeSkillFiles = collectSkillFiles(path.join(projectRoot, nativeSkillRoot));
+  const nativeSkillIds = new Set(nativeSkillFiles.map((file) => path.basename(path.dirname(file))));
+  metrics.nativeSkills = nativeSkillFiles.length;
+  for (const file of nativeSkillFiles) capture(`Native skill ${path.relative(projectRoot, file)}`, () => {
+    const metadata = parseSkillFrontmatter(file);
+    check(metadata.name === path.basename(path.dirname(file)),
+      `${path.relative(projectRoot, file)} frontmatter name must match its directory`);
+    return metadata;
+  });
   const catalog = capture('Codex activation catalog', () => readCodexCatalog(projectRoot));
   if (catalog) {
     const managedSkillIds = getManagedActivationSkillIds(catalog);
     for (const skillId of managedSkillIds) {
-      check(skillIdsByRoot['.agents/skills'].has(skillId),
+      check(nativeSkillIds.has(skillId),
         `Missing native activation skill .agents/skills/${skillId}/SKILL.md`);
-      check(skillIdsByRoot['.codex/skills'].has(skillId),
-        `Missing compatibility activation skill .codex/skills/${skillId}/SKILL.md`);
-      const nativePath = path.join(projectRoot, '.agents', 'skills', skillId, 'SKILL.md');
-      const compatibilityPath = path.join(projectRoot, '.codex', 'skills', skillId, 'SKILL.md');
-      if (fs.existsSync(nativePath) && fs.existsSync(compatibilityPath)) {
-        check(fs.readFileSync(nativePath, 'utf8') === fs.readFileSync(compatibilityPath, 'utf8'),
-          `Native and compatibility activation skill differ: ${skillId}`);
-      }
+      check(!fs.existsSync(path.join(projectRoot, '.codex', 'skills', skillId, 'SKILL.md')),
+        `Duplicate managed Codex skill surface: ${skillId} exists in both .agents/skills and .codex/skills`);
     }
   }
 

package/.codex/tasks/onboard-sinapse-codex.md

@@ -15,7 +15,7 @@ Guide the user through the real Codex operating surface for SINAPSE in this repo
    - `/skills` -> `sinapse-<agent>`
    - `@agent` aliases from `AGENTS.md`
 3. Explain the two Codex layers:
-   - `.codex/skills` for activation
+   - `.agents/skills` for activation
    - `.codex/agents` for expanded catalog and specialist context
 4. Explain the validated operator commands:
    - `npm run sync:ide:codex`

package/.sinapse-ai/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-07-15T03:11:31.074Z'
-  entityCount: 816
+  lastUpdated: '2026-07-15T08:35:27.084Z'
+  entityCount: 817
   checksumAlgorithm: sha256
   resolutionRate: 100
 entities:
@@ -41,8 +41,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:f66f076d3c8bead4fa1193fe027582c0487019e363bd37012db6a6cc1d90ab6d
-      lastVerified: '2026-07-02T22:41:00.485Z'
+      checksum: sha256:cbde468c6a5d8c09667d54ba512489023d422a1e843a3256c2e722f29ab26bc8
+      lastVerified: '2026-07-15T04:47:59.892Z'
     agents:
       path: bin/commands/agents.js
       layer: L1
@@ -106,8 +106,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:af615f80ca758541b8ede2af086aead94b99f194336459529ab3876186462a3d
-      lastVerified: '2026-07-02T22:41:00.486Z'
+      checksum: sha256:eacc95a711bcbbd840a0a52b11bc1724b9a13282af3f914f938c9a55b2797a72
+      lastVerified: '2026-07-15T04:28:12.370Z'
     ideate:
       path: bin/commands/ideate.js
       layer: L1
@@ -154,6 +154,7 @@ entities:
         - status
         - command-generator
         - global-provider-adapters
+        - provider-parity
         - install-transaction
         - install-errors
         - chrome-brain-installer
@@ -165,8 +166,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:d410cc6498c4906818d29c86c4ee7c6a28d76283bd2071be218088540a879b0f
-      lastVerified: '2026-07-15T02:37:43.454Z'
+      checksum: sha256:1f385982ca84a8232f3f6b1fce4257ca3971a5fd24830b5389477f9a5a8e943a
+      lastVerified: '2026-07-15T08:12:47.676Z'
     local:
       path: bin/commands/local.js
       layer: L1
@@ -204,6 +205,7 @@ entities:
         - constants
         - header
         - squads
+        - uninstall
         - observability-panel
       externalDeps: []
       plannedDeps:
@@ -213,8 +215,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:82ec537932c7b6c7e46c294ac4396c988bea43583a1f1f7a1886d2b13518dd55
-      lastVerified: '2026-06-21T05:24:05.621Z'
+      checksum: sha256:9f1b50e9b2669eb854a49b338498c79826212ef001fa38ced894dfecc4d949de
+      lastVerified: '2026-07-15T07:51:17.101Z'
     uninstall:
       path: bin/commands/uninstall.js
       layer: L1
@@ -226,6 +228,7 @@ entities:
         - cli
         - install
         - sinapse
+        - status
         - update
       dependencies:
         - constants
@@ -235,14 +238,15 @@ entities:
         - spawn-safe
       externalDeps: []
       plannedDeps:
+        - legacy-claude-agent-command-hashes
         - logger
       lifecycle: production
       adaptability:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:1116a6ee85257c1ad26c9d7de4b24b681c1045c19d09f0572be57e77b3053b77
-      lastVerified: '2026-07-15T02:37:43.455Z'
+      checksum: sha256:a97ad181e34f7cc3af15be278826a32400c59faeb6d8bd914dfdaea7dc0f00c6
+      lastVerified: '2026-07-15T08:35:26.856Z'
     update:
       path: bin/commands/update.js
       layer: L1
@@ -263,6 +267,7 @@ entities:
         - uninstall
         - command-generator
         - global-provider-adapters
+        - provider-parity
       externalDeps: []
       plannedDeps:
         - logger
@@ -271,8 +276,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:1cc8b0622d9d0137feb4c7e1f93c7303a98d7e5b696b8c995495d75dff815a09
-      lastVerified: '2026-07-15T02:37:43.455Z'
+      checksum: sha256:b51998a172a91e134330847185c078d317ed9be2da6746de3af18d209b7e08d9
+      lastVerified: '2026-07-15T08:12:47.677Z'
     command-generator:
       path: bin/lib/command-generator.js
       layer: L1
@@ -416,8 +421,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:289930cccfb6aca324bf6f460f9cfe2ebda6fcc6ee1f54d7ee3cfcfbbe86e5c1
-      lastVerified: '2026-07-15T03:11:30.770Z'
+      checksum: sha256:d28b19935a9c75408df9da7430fc3ca9568bdea0cfc1ae3c01d0025ad19fc2a3
+      lastVerified: '2026-07-15T07:09:56.286Z'
     header:
       path: bin/lib/header.js
       layer: L1
@@ -470,6 +475,27 @@ entities:
         extensionPoints: []
       checksum: sha256:dc7cc1109f2bbdb7b3c5927df0de2418925842bdacdc0ba82815bfa2783d0b42
       lastVerified: '2026-06-22T02:41:18.152Z'
+    provider-parity:
+      path: bin/lib/provider-parity.js
+      layer: L1
+      type: script
+      purpose: Entity at bin\lib\provider-parity.js
+      keywords:
+        - provider
+        - parity
+      usedBy:
+        - install
+        - update
+      dependencies: []
+      externalDeps: []
+      plannedDeps: []
+      lifecycle: production
+      adaptability:
+        score: 0.7
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:592206326a2a3c5a3d89068d9ef065d698562aef40e6096d971fb793cea11c97
+      lastVerified: '2026-07-15T08:35:26.859Z'
     setup-statusline:
       path: bin/lib/setup-statusline.js
       layer: L1
@@ -594,8 +620,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:7d7af407aecf1704b20d248edc724fa9482cff291743543bf3f6e57336fa9a55
-      lastVerified: '2026-07-03T06:55:48.457Z'
+      checksum: sha256:4d180833ee2ac17bd378755e27a79dca0f559783a99aad830c14d3071c14f754
+      lastVerified: '2026-07-15T07:51:17.104Z'
     sinapse-delegate:
       path: bin/sinapse-delegate.js
       layer: L1

package/.sinapse-ai/install-manifest.yaml

@@ -7,7 +7,7 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.25.0
+version: 1.25.1
 generator: scripts/generate-install-manifest.js
 file_count: 1156
 files:
@@ -1368,9 +1368,9 @@ files:
     type: data
     size: 9671
   - path: data/entity-registry.yaml
-    hash: sha256:67f0f15427e7a10e10dc4a535fa3b46f3cb3628d1104d029e8ec49daf8f84113
+    hash: sha256:ed0919b2bc3479beb4e46d3ccfbbbda66e46161c7eebc9018b9f0c8e5278d7f1
     type: data
-    size: 559287
+    size: 559991
   - path: data/learned-patterns.yaml
     hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
     type: data

package/CHANGELOG.md

@@ -1,22 +1,14 @@
-## [1.25.0](https://github.com/caioimori/sinapse-ai/compare/1.24.0...1.25.0) (2026-07-15)
-
-### Features
-
-* **cli:** ship native Claude and Codex parity [Story cross-provider-cli-quality] ([191a525](https://github.com/caioimori/sinapse-ai/commit/191a525027178cd46aaf7aa24a0dd445a60634cb))
+## [1.25.1](https://github.com/caioimori/sinapse-ai/compare/1.25.0...1.25.1) (2026-07-15)
 
 ### Bug Fixes
 
-* **badges:** decodifica emoji double-escaped no gerador + regenera selos pos-renames [Story badges-emoji-decode] ([#375](https://github.com/caioimori/sinapse-ai/issues/375)) ([39a97f9](https://github.com/caioimori/sinapse-ai/commit/39a97f9cc992d36f50ac8b544b2dd7f07a4bf2fd)), closes [#332](https://github.com/caioimori/sinapse-ai/issues/332)
-* **ci:** use supported macOS Intel runner [Story cross-provider-cli-quality] ([1d1ca4f](https://github.com/caioimori/sinapse-ai/commit/1d1ca4f61adf9cb9425f25ba5683bf32bea03eaf))
-* **docs:** sync canonical task metrics [Story cross-provider-cli-quality] ([a6031de](https://github.com/caioimori/sinapse-ai/commit/a6031deb0e98e9897af8ae302962b36e08dc8883))
-* **release:** harden cross-provider package gates [Story cross-provider-cli-quality] ([57dff2d](https://github.com/caioimori/sinapse-ai/commit/57dff2d166e1011c14a359140a00a974526e3976))
-
-### Maintenance
-
-* **manifest:** sync registry package hash [Story cross-provider-cli-quality] ([357905f](https://github.com/caioimori/sinapse-ai/commit/357905f21cb6a34e266e25e6eb81c7545245bf20))
-* **registry:** sync provider adapter checksum [Story cross-provider-cli-quality] ([ef65ce8](https://github.com/caioimori/sinapse-ai/commit/ef65ce881354ae95f09512c1ffe5d49e4134eb92))
-* **release:** sync da main pos-release 1.24.0 ([#374](https://github.com/caioimori/sinapse-ai/issues/374)) ([d1fee0a](https://github.com/caioimori/sinapse-ai/commit/d1fee0a36e780ddc1eb4abc33af1649810bc0c97))
-* **repo:** remove landing estatica da vitrine [Story cleanup-landing-coderabbit] ([5391bfa](https://github.com/caioimori/sinapse-ai/commit/5391bfa6e69f5cb289b4eabcc1ea0822852a5462))
+* **ci:** derive Codex skill count from payload [Story sinapse-only-catalog-cleanup] ([e371a0d](https://github.com/caioimori/sinapse-ai/commit/e371a0ddf9daf944ca803a75dac9807b89d8e257))
+* **installer:** enforce conservative provider ownership [Story sinapse-only-catalog-cleanup] ([1b4f896](https://github.com/caioimori/sinapse-ai/commit/1b4f896d520a02124dc3107c604106f8ba8c8fae))
+* **installer:** harden ownership and hook validation [Story sinapse-only-catalog-cleanup] ([4575a84](https://github.com/caioimori/sinapse-ai/commit/4575a84d6062feb8198e9480f15365e6218b7e61))
+* **installer:** preserve provider-owned state [Story sinapse-only-catalog-cleanup] ([df67e88](https://github.com/caioimori/sinapse-ai/commit/df67e8836e4f2f42a2cb075d6063a01e0b8ad4c6))
+* **installer:** reconcile provider-native catalogs [Story sinapse-only-catalog-cleanup] ([830b36c](https://github.com/caioimori/sinapse-ai/commit/830b36c8108610de2067d09426bfd7e13d315672))
+* **security:** harden managed file reconciliation [Story sinapse-only-catalog-cleanup] ([3899921](https://github.com/caioimori/sinapse-ai/commit/3899921579851a6490e4866e7284ed88afe67c92))
+* **test:** resolve Bash paths across Windows runtimes [Story sinapse-only-catalog-cleanup] ([a788b04](https://github.com/caioimori/sinapse-ai/commit/a788b0434f9718eb74c1caa6dc0ae091ea4dac65))
 
 # Changelog
 

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`);