sinapse-ai 1.25.0 → 1.25.1

package/packages/installer/src/migrations/legacy-claude-agent-command-hashes.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 1,
+  "algorithm": "sha256",
+  "files": {
+    "analyst.md": ["795b9209e7bc5bd31a736bb67ee5c0eeb1a95590afd47fb630c81de0dd87c126"],
+    "animations-orqx.md": ["f3cce5c6d75a6a872171593dba8bafeae657488950fad63c89f17e7e193e92e0"],
+    "architect.md": ["d2e8a9b7b4c7582870f08561f482fa6c51a0b347fdcc066bd88bda5575a2052f"],
+    "brand-orqx.md": ["a4afdbd9dc8fd118939be2e07377967a86748310b89c7f59b14818d84fbb10ad"],
+    "cloning-orqx.md": ["134d10224635b9898469d7bb3992f636ecdba375272e3ad1c24eb0215c1a85c0"],
+    "commercial-orqx.md": ["170288942d7c85c28fece5eef0256101eee0699a76a8f28b3e7ec5878d2f0b79"],
+    "content-orqx.md": ["f93bf397c8da352d10b884600ae339979a0c6c5190fb3b21daa1de6d3e7a2e45"],
+    "copy-orqx.md": ["86f70db676af7475d13face6468da78ee05e5c257b506fe484b62c0d1ca9439c"],
+    "council-orqx.md": ["d2ab7fcd71e71677d6fd15ae1565c35fb241e4b9558e79da0e030fc70a81efe4"],
+    "courses-orqx.md": ["236e69533c0155a42dfc762f563455244b71f127ae6459b70ffabad8ba081654"],
+    "cyber-orqx.md": ["8efff68f6e1441df8719b3d743dc27f9e6d0ce6d9f6e7128284a144d5c74ac63"],
+    "data-engineer.md": ["9c9faba56ad0bb8816e76117e0392e0727d8f4aba46413fa053c97d5aaf086bf"],
+    "design-orqx.md": ["e3b10fb943a64916826a11d13e0e57f61cc5e27e8966ea15924cae4e055aad64"],
+    "developer.md": ["b996b501f752b4f049367182d0c2c5a99019fddeab343c840a7da2f8ca1d70a4"],
+    "devops.md": ["18354e8a0e8b39786d48a5d9f8a7e532698e6fe49a65f3243be6a96eb6c73c42"],
+    "finance-orqx.md": ["f4ebeb70b7a0890c491608a00feedd31b9b4a9b872ed02d489b39a99fa01c537"],
+    "growth-orqx.md": ["b0f74d98f40fe384c81a22ab705007e4e40ab9f82bc6c23d2282a05aed17cbdf"],
+    "paidmedia-orqx.md": ["b68b91bc647fa6290c9109d621d98f6567b28967acb9e474cbf399442711c530"],
+    "product-lead.md": ["a62d2f6079b7deabe22d24cd66943375e82fbe9ea389e23bf9a7a9ea2fa55e08"],
+    "product-orqx.md": ["5df3d89096efdc1cabdcfaaf82b14571689d258a495981520ae0a0ea8fa04a92"],
+    "project-lead.md": ["0dd16d04f28c7614c025dadb557aa4b3eeb56c96fda8874afec40b8044db6e2b"],
+    "quality-gate.md": ["ed735180b28c51df2803933009f9b9bc6f5f497ac2b528919a4eed83e0ba1682"],
+    "research-orqx.md": ["9cf3c189b670ee4565329abec1a2c7d208a3013a9dba695208cbe617b4b0984b"],
+    "sinapse-orqx.md": ["36e704406c594a72cbf72eac52bb9ce22a636965a8c86a45c6560e4cc4fb67d6"],
+    "snps-orqx.md": ["0452d5291fd27239c0e6f79064d214c9755234e444daabbcea7cdd5e0f5a544d"],
+    "sprint-lead.md": ["3abfcccefb0e15765549cc54fabb8e398de135532c76f9ef8b16a57220dcac69"],
+    "squad-creator.md": ["1a92aeabebee66782dd906a75844451d3cb0fc0af59f7df266ab4106026ef657"],
+    "storytelling-orqx.md": ["45889421752caaecaff3ccc92d22e333235d675f65710f435b3b7224bbc0e022"],
+    "swarm-orqx.md": ["9eb519069dc7b9a10fd2ca677f4dfbed9ad3f966d0d65b2a73daf67b000b81c0"],
+    "ux-design-expert.md": ["f26f6935b95bd3c5d051a0b0a70394571f47fb1992e26ad17b25033b04f81048"]
+  }
+}

package/packages/installer/src/migrations/legacy-codex-native-skill-hashes.json

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": 1,
+  "algorithm": "sha256",
+  "files": {
+    ".agents/skills/sinapse-agent/SKILL.md": ["122ddfefe2fc23579c54513953f2f8cb7e872708c3c2078aac1a72a5e8a55959"],
+    ".agents/skills/sinapse-analyst/SKILL.md": ["3ff8b42481e23e847ebac3c255ff4437b984c715046e16fb61d0605fa1a5b677"],
+    ".agents/skills/sinapse-animations/SKILL.md": ["78666bb951ea083f1df13d9960ed7cecaef304024cea4392b2fc3022251fdab5"],
+    ".agents/skills/sinapse-architect/SKILL.md": ["05bbbaf7d493918cf4856feddd611b8f2e1f88924e7bba0f6ab9ce83ab7b6718"],
+    ".agents/skills/sinapse-brand/SKILL.md": ["bfbdebaa0e3c9e2668025af01df88841646ea450e4b1e6cb5008ca02258206db"],
+    ".agents/skills/sinapse-claude/SKILL.md": ["85f25d07838fa259cf48338ab526eeb6391c47ddbf10dba44aa6cc35421a90bf"],
+    ".agents/skills/sinapse-cloning/SKILL.md": ["b9e6d9e6c87cb79f261c46b6f6e83fc1d10506bcb920ece4012b07020334dc2a"],
+    ".agents/skills/sinapse-commercial/SKILL.md": ["b26cb18661293ffee078bd555677b7fa201718f1cdedf859dd358ae33b901e1e"],
+    ".agents/skills/sinapse-content/SKILL.md": ["61f4cbb9b9a5de4dde5fbf7b3027898be20fb127a287b19d5955e34a832b3ba3"],
+    ".agents/skills/sinapse-copy/SKILL.md": ["dddf3da31fe8807eb60450ad0dcdd73288ba32470b142d4d1c994277282dd1a2"],
+    ".agents/skills/sinapse-council/SKILL.md": ["6692021c2578524513a5462b7271aa7eda7335961cea5d9d015f7b75f3dfd2a1"],
+    ".agents/skills/sinapse-courses/SKILL.md": ["653a21c66dd78904b53b8924601778f1682db8b879ab5d50320d06452236687d"],
+    ".agents/skills/sinapse-cyber/SKILL.md": ["55c12f9a6f35970b3bf0d6d6ab8208b6348a9390040df1d8d01df108a369b429"],
+    ".agents/skills/sinapse-data-engineer/SKILL.md": ["5c8e31f9cba46f89fffbb5c83fe831725d951f75275b085b51ea48beab0291fa"],
+    ".agents/skills/sinapse-design/SKILL.md": ["3c35efa3e905d636352f5f046d494665ebf9e33f4c896fddcfa112103877a00d"],
+    ".agents/skills/sinapse-dev/SKILL.md": ["a2ff86c33e61efb1085e9388c8f1f6a58389b9dc8b74ecbe83c096b920f114db"],
+    ".agents/skills/sinapse-devops/SKILL.md": ["9cf5ef12999568e292f4e5d302bd61831872a783d6ed9caaca7a1ac247c63c01"],
+    ".agents/skills/sinapse-finance/SKILL.md": ["4b596578bbb950e8513eb96ea62200880c9184989bdfc91c7ecd1370f47b07ab"],
+    ".agents/skills/sinapse-growth/SKILL.md": ["53d32adb439098528925425d4ff86458e8fb2efb3c8fd6b62e8c42de4f06873c"],
+    ".agents/skills/sinapse-loop/SKILL.md": ["e5a33f9235c66e554e67d7668ac5e3255e1b6f9ed026f7bf3be666c169bf396a"],
+    ".agents/skills/sinapse-orqx/SKILL.md": ["b522b867768f4f6cf9151978734611b1482ec6f35cbe8552e9e324c4bb16de50"],
+    ".agents/skills/sinapse-paidmedia/SKILL.md": ["81ae19dae135dcd001703446131989ac51da1a299d8fab59ddc21596b1d462e2"],
+    ".agents/skills/sinapse-pm/SKILL.md": ["ecf406f3a94c48defff97c9ef55410cdf82cfa445b3d1244df0c6dd66543b910"],
+    ".agents/skills/sinapse-po/SKILL.md": ["56693d11a13cf51eb600883d26f232adfb6c0275015a1dfa0fd467387700667f"],
+    ".agents/skills/sinapse-product/SKILL.md": ["50bae9a40dca95287b864a873fe578953b5f361239a3e6c2b70ae2cd38197eb7"],
+    ".agents/skills/sinapse-qa/SKILL.md": ["54ac75619ae2cd28fa820e224abc5fc82163198652ce200d0706aa0734e98509"],
+    ".agents/skills/sinapse-research/SKILL.md": ["ac98bc465c1c975d95d93ffc6a665c41ab679e1885882ab7a91c86501a34d181"],
+    ".agents/skills/sinapse-sm/SKILL.md": ["408556e7cff08d5b84c724e55a3d35e7624e155984edfe697c7a9fe61e60a72f"],
+    ".agents/skills/sinapse-spec-driven/SKILL.md": ["5216b2f651f88263323a07cabec78259036bb4ec23689d312c770cef216b26a1"],
+    ".agents/skills/sinapse-squad-creator/SKILL.md": ["779a93754fb121d8f405667f2d3852faeb8945302129aec74c0d1f6b51f62ed3"],
+    ".agents/skills/sinapse-storytelling/SKILL.md": ["65e2d8719eee6d0221bcfe758144c24575cf00c0aa988b785f98c69fc4982025"],
+    ".agents/skills/sinapse-swarm/SKILL.md": ["8c98e9b1da2cb279ef7fa10ca4e81cb0a230ecdbfda4f890b0b94f1604626f00"],
+    ".agents/skills/sinapse-ux-design-expert/SKILL.md": ["5a1c747c030113b50d98a431bfffc4418e38355cae72f7e5a088ee5bee8bc530"],
+    ".agents/skills/sinapse/SKILL.md": ["fe017c091d1308eb937762ffe25f83518f778a266303cc3f028d0f468df0747f"],
+    ".agents/skills/snps-orqx/SKILL.md": ["24f66470a5721fc086a52eca9907958d091d68c2de0a0b56a42e07e83fe00342"],
+    ".agents/skills/snps/SKILL.md": ["9f9a0972a184a07234948f4e5dd8f7032835be3283608a00c8cbf8bbf68064a3"]
+  }
+}

package/packages/installer/src/updater/index.js

@@ -26,6 +26,24 @@ const { PostInstallValidator, formatReport: formatValidationReport } = require('
 const { _testing: { installGlobalAgents } } = require('../wizard/index');
 const { installSinapseCore } = require('../installer/sinapse-ai-installer');
 
+function detectInstalledProviders(projectRoot, recordedProviders = []) {
+  if (recordedProviders.length > 0) {
+    return {
+      includeClaude: recordedProviders.includes('claude-code'),
+      includeCodex: recordedProviders.includes('codex'),
+    };
+  }
+  const includeClaude = fs.existsSync(path.join(projectRoot, '.claude', 'skill-manifest.json'));
+  const hasCodexCatalog = fs.existsSync(path.join(projectRoot, '.codex', 'catalog.json'));
+  const hasNativeActivator = fs.existsSync(
+    path.join(projectRoot, '.agents', 'skills', 'sinapse-agent', 'SKILL.md'),
+  );
+  const hasLegacyActivator = fs.existsSync(
+    path.join(projectRoot, '.codex', 'skills', 'sinapse-agent', 'SKILL.md'),
+  );
+  return { includeClaude, includeCodex: hasCodexCatalog && (hasNativeActivator || hasLegacyActivator) };
+}
+
 /**
  * Update status types
  * @enum {string}
@@ -614,13 +632,10 @@ class SINAPSEUpdater {
       const recordedProviders = Array.isArray(this.versionInfo?.providers)
         ? this.versionInfo.providers
         : [];
-      const includeClaude = recordedProviders.length > 0
-        ? recordedProviders.includes('claude-code')
-        : fs.existsSync(path.join(this.projectRoot, '.claude', 'skill-manifest.json'));
-      const includeCodex = recordedProviders.length > 0
-        ? recordedProviders.includes('codex')
-        : fs.existsSync(path.join(this.projectRoot, '.codex', 'catalog.json'))
-          && fs.existsSync(path.join(this.projectRoot, '.agents', 'skills', 'sinapse-agent', 'SKILL.md'));
+      const { includeClaude, includeCodex } = detectInstalledProviders(
+        this.projectRoot,
+        recordedProviders,
+      );
       const delivery = await installSinapseCore({
         targetDir: this.projectRoot,
         includeClaude,
@@ -631,6 +646,7 @@ class SINAPSEUpdater {
 
       result.success = true;
       result.filesUpdated = 1 + delivery.installedFiles.length;
+      result.codexLegacySkillReconciliation = delivery.codexLegacySkillReconciliation || null;
 
       return result;
     } catch (error) {
@@ -942,4 +958,5 @@ module.exports = {
   formatCheckResult,
   formatUpdateResult,
   sanitizeLogText,
+  detectInstalledProviders,
 };

package/packages/installer/src/wizard/ide-config-generator.js

@@ -18,6 +18,7 @@ const crossSpawn = require('cross-spawn');
 const { getIDEConfig } = require('../config/ide-configs');
 const { validateProjectName } = require('./validators');
 const { getMergeStrategy, hasMergeStrategy } = require('../merger/index.js');
+const { reconcileLegacyClaudeAgentCommands } = require('../installer/sinapse-ai-installer');
 
 /**
  * Render template with variables
@@ -373,6 +374,9 @@ async function generateIDEConfigs(selectedIDEs, wizardState, options = {}) {
 
         // Copy agent files to IDE-specific agent folder
         if (ide.agentFolder) {
+          if (ideKey === 'claude-code') {
+            await reconcileLegacyClaudeAgentCommands(projectRoot);
+          }
           spinner.start(`Copying agents to ${ide.agentFolder}...`);
           const agentFiles = await copyAgentFiles(projectRoot, ide.agentFolder, ide);
           createdFiles.push(...agentFiles);

package/packages/installer/src/wizard/index.js

@@ -536,6 +536,10 @@ async function runWizard(options = {}) {
         const installed = pillars.filter(p => sinapseCoreResult.installedFolders.includes(p));
         const aux = sinapseCoreResult.installedFolders.filter(f => !pillars.includes(f));
         console.log(`✅ SINAPSE core: ${sinapseCoreResult.installedFiles.length} files (${installed.length} pillars, ${aux.length} modules)`);
+        const cleanup = sinapseCoreResult.codexLegacySkillReconciliation;
+        if (cleanup && (cleanup.removed || cleanup.migrated || cleanup.quarantined || cleanup.ambiguous.length)) {
+          console.log(`SINAPSE Codex skill cleanup: ${cleanup.removed} removed, ${cleanup.migrated} migrated, ${cleanup.quarantined} quarantined, ${cleanup.ambiguous.length} ambiguous`);
+        }
       }
       answers.sinapseCoreInstalled = true;
       answers.sinapseCoreResult = sinapseCoreResult;
@@ -806,7 +810,7 @@ async function runWizard(options = {}) {
     }
 
     // Codex local-first sync: the ide-sync above drives claude-code only now,
-    // so .codex/agents + .codex/skills are regenerated here from the canonical
+    // so .codex/agents + .agents/skills are regenerated here from the canonical
     // source (the static .codex payload — scripts/tasks/JSONs — was already
     // copied by installSinapseCore when Codex was selected). Codex installs only.
     if (shouldConfigureCodex(selectedLLM)) {
@@ -822,7 +826,7 @@ async function runWizard(options = {}) {
           : { total: 0 };
         answers.codexSyncStatus = codexResult.ok ? 'synced' : 'failed';
         const m = codexResult.metrics || {};
-        console.log(`✅ Codex sync: ${codexResult.ok ? 'synced' : 'issues'} (${m.codexAgents || 0} adapters, ${nativeResult.total || 0} native agents, ${m.codexSkills || 0} compatibility skills)`);
+        console.log(`✅ Codex sync: ${codexResult.ok ? 'synced' : 'issues'} (${m.codexAgents || 0} adapters, ${nativeResult.total || 0} native agents, ${m.codexSkills || 0} native skills)`);
       } catch (codexErr) {
         console.warn(`⚠️  Codex sync failed: ${codexErr.message} — run 'npm run sync:ide:codex' post-install`);
         answers.codexSyncStatus = 'failed';

package/scripts/validate-codex-command-registry.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const legacy = require('../.sinapse-ai/infrastructure/scripts/validate-codex-command-registry');
+
+function resolveRegistryPath(projectRoot, declaredPath) {
+  if (typeof declaredPath !== 'string' || !declaredPath.trim() || path.isAbsolute(declaredPath)) return null;
+  const resolved = path.resolve(projectRoot, declaredPath);
+  const relative = path.relative(path.resolve(projectRoot), resolved);
+  if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) return null;
+  return resolved;
+}
+
+function validateCodexCommandRegistry(options = {}) {
+  const projectRoot = options.projectRoot || process.cwd();
+  const { registryPath, registry, error } = legacy.loadRegistry(projectRoot);
+  const errors = [];
+  const requiredCoverage = options.requiredCoverage === false
+    ? null
+    : options.requiredCoverage || legacy.REQUIRED_COMMAND_COVERAGE;
+
+  if (error) return { ok: false, errors: [error], warnings: [], metrics: { agents: 0, commands: 0 } };
+
+  let commandCount = 0;
+  const seenAgentAliases = new Map();
+  for (const [agentId, agentSpec] of Object.entries(registry.agents || {})) {
+    const skillPath = path.join(projectRoot, '.agents', 'skills', agentSpec.skillId || agentId, 'SKILL.md');
+    if (!fs.existsSync(skillPath)) {
+      errors.push(`${agentId}: missing skill file ${path.relative(projectRoot, skillPath)}`);
+    }
+
+    const sourceOfTruth = resolveRegistryPath(projectRoot, agentSpec.sourceOfTruth);
+    if (!sourceOfTruth) {
+      errors.push(`${agentId}: invalid or missing source of truth`);
+    } else if (!fs.existsSync(sourceOfTruth)) {
+      errors.push(`${agentId}: missing source of truth ${path.relative(projectRoot, sourceOfTruth)}`);
+    }
+
+    for (const alias of legacy.collectAgentAliases(agentId, agentSpec)) {
+      const owner = seenAgentAliases.get(alias);
+      if (owner && owner !== agentId) errors.push(`duplicate agent alias "${alias}" claimed by ${owner} and ${agentId}`);
+      else seenAgentAliases.set(alias, agentId);
+    }
+
+    const seenCommandAliases = new Map();
+    for (const [commandId, commandSpec] of Object.entries(agentSpec.commands || {})) {
+      commandCount += 1;
+      const targetPath = resolveRegistryPath(projectRoot, commandSpec.target);
+      if (!targetPath) {
+        errors.push(`${agentId}.${commandId}: invalid or missing target`);
+      } else if (!fs.existsSync(targetPath)) {
+        errors.push(`${agentId}.${commandId}: missing target ${path.relative(projectRoot, targetPath)}`);
+      }
+      for (const resource of commandSpec.resources || []) {
+        const resourcePath = resolveRegistryPath(projectRoot, resource);
+        if (!resourcePath) {
+          errors.push(`${agentId}.${commandId}: invalid or missing resource`);
+        } else if (!fs.existsSync(resourcePath)) {
+          errors.push(`${agentId}.${commandId}: missing resource ${path.relative(projectRoot, resourcePath)}`);
+        }
+      }
+      for (const alias of legacy.collectCommandAliases(commandId, commandSpec)) {
+        const owner = seenCommandAliases.get(alias);
+        if (owner && owner !== commandId) errors.push(`duplicate command alias "${alias}" claimed by ${owner} and ${commandId}`);
+        else seenCommandAliases.set(alias, commandId);
+      }
+    }
+  }
+
+  legacy.validateRequiredCoverage(registry, requiredCoverage, errors);
+  return {
+    ok: errors.length === 0,
+    errors,
+    warnings: [],
+    metrics: {
+      agents: Object.keys(registry.agents || {}).length,
+      commands: commandCount,
+      registryPath: path.relative(projectRoot, registryPath),
+    },
+  };
+}
+
+function main() {
+  const args = legacy.parseArgs();
+  const result = validateCodexCommandRegistry(args);
+  if (!args.quiet) {
+    console.log(args.json ? JSON.stringify(result, null, 2) : legacy.formatHumanReport(result));
+  }
+  if (!result.ok) process.exitCode = 1;
+}
+
+if (require.main === module) main();
+
+module.exports = {
+  ...legacy,
+  resolveRegistryPath,
+  validateCodexCommandRegistry,
+};

package/scripts/validate-provider-adapters.js

@@ -3,7 +3,9 @@
 
 const fs = require('fs');
 const path = require('path');
+const crypto = require('crypto');
 const yaml = require('js-yaml');
+const legacyClaudeCommandHashes = require('../packages/installer/src/migrations/legacy-claude-agent-command-hashes.json');
 
 const { validateNativeCodex } = require('../.codex/scripts/validate-codex-native');
 
@@ -17,8 +19,103 @@ function parseFrontmatter(content) {
   return metadata;
 }
 
+const REQUIRED_CLAUDE_HOOKS = [
+  { event: 'PreToolUse', matcher: 'Write|Edit', filename: 'doc-first-gate.cjs' },
+  { event: 'PreToolUse', matcher: 'Write|Edit|Bash', filename: 'enforce-delegation.cjs' },
+  { event: 'PreToolUse', matcher: 'Write|Edit', filename: 'enforce-framework-boundary.cjs' },
+  { event: 'PreToolUse', matcher: 'Bash', filename: 'enforce-git-push-authority.sh' },
+  { event: 'PreToolUse', matcher: 'Bash', filename: 'verify-packages.cjs' },
+];
+
+function validateClaudeHookSettings(projectRoot) {
+  const errors = [];
+  const settingsCandidates = [
+    path.join(projectRoot, '.claude', 'settings.json'),
+    path.join(projectRoot, '.claude', 'settings.local.json'),
+  ];
+  const settingsPaths = settingsCandidates.filter((candidate) => fs.existsSync(candidate));
+  if (settingsPaths.length === 0) {
+    return ['Claude hook settings are missing: expected .claude/settings.json or .claude/settings.local.json'];
+  }
+  const commands = [];
+  for (const settingsPath of settingsPaths) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      for (const [event, groups] of Object.entries(settings.hooks || {})) {
+        for (const group of groups || []) {
+          commands.push(...(group.hooks || []).map((hook) => ({
+            command: String(hook.command || ''),
+            event,
+            matcher: group.matcher ?? null,
+            source: path.relative(projectRoot, settingsPath),
+          })));
+        }
+      }
+    } catch (error) {
+      errors.push(`Claude hook settings (${path.relative(projectRoot, settingsPath)}): ${error.message}`);
+    }
+  }
+  const registered = new Set();
+  for (const entry of commands) {
+    const match = entry.command.replace(/\\/g, '/').match(/\.claude\/hooks\/([^"'\s]+)/);
+    if (!match) continue;
+    const registrationKey = JSON.stringify([entry.event, entry.matcher, match[1]]);
+    if (registered.has(registrationKey)) {
+      errors.push(`Claude hook is registered more than once for the same event and matcher: ${match[1]} (${entry.source})`);
+      continue;
+    }
+    registered.add(registrationKey);
+    if (!fs.existsSync(path.join(projectRoot, '.claude', 'hooks', match[1]))) {
+      errors.push(`Claude settings points to missing hook: .claude/hooks/${match[1]}`);
+    }
+  }
+  for (const hook of REQUIRED_CLAUDE_HOOKS) {
+    const requiredKey = JSON.stringify([hook.event, hook.matcher, hook.filename]);
+    if (!registered.has(requiredKey)) {
+      errors.push(`Claude governance hook is not registered at ${hook.event}/${hook.matcher}: ${hook.filename}`);
+    }
+  }
+  return errors;
+}
+
+function validateClaudeAliasTargets(projectRoot) {
+  const errors = [];
+  const aliases = {
+    sinapse: ['# SINAPSE Claude Activation: sinapse-orqx', 'development/agents/snps-orqx.md'],
+    'sinapse-orqx': ['# SINAPSE Claude Activation: sinapse-orqx', 'development/agents/snps-orqx.md'],
+    snps: ['# SINAPSE Claude Activation: sinapse-orqx', 'development/agents/snps-orqx.md'],
+    'snps-orqx': ['# SINAPSE Claude Activation: sinapse-orqx', 'development/agents/snps-orqx.md'],
+    'sinapse-agent': ['# SINAPSE Parametric Agent Activator for Claude Code', '.claude/agents/sinapse-'],
+  };
+  for (const [alias, [heading, canonicalTarget]] of Object.entries(aliases)) {
+    const relativePath = path.join('.claude', 'skills', alias, 'SKILL.md');
+    try {
+      const content = fs.readFileSync(path.join(projectRoot, relativePath), 'utf8');
+      if (!content.includes(heading) || !content.includes(canonicalTarget)) {
+        errors.push(`${relativePath} does not resolve to its canonical target`);
+      }
+    } catch (error) {
+      errors.push(`${relativePath}: ${error.message}`);
+    }
+  }
+  return errors;
+}
+
 function validateClaudeNative(projectRoot = PROJECT_ROOT) {
   const errors = [];
+  const legacyCommandsDir = path.join(projectRoot, '.claude', 'commands', 'SINAPSE', 'agents');
+  if (fs.existsSync(legacyCommandsDir)) {
+    const legacyCommands = fs.readdirSync(legacyCommandsDir).filter((file) => file.endsWith('.md'));
+    const managedLegacyCommands = legacyCommands.filter((file) => {
+      const content = fs.readFileSync(path.join(legacyCommandsDir, file));
+      const digest = crypto.createHash('sha256').update(content).digest('hex');
+      return (legacyClaudeCommandHashes.files[file] || []).includes(digest)
+        || content.includes(Buffer.from('SINAPSE-MANAGED:claude-command'));
+    });
+    if (managedLegacyCommands.length > 0) {
+      errors.push(`Legacy Claude agent command surface contains ${managedLegacyCommands.length} managed duplicates`);
+    }
+  }
   const agentsDir = path.join(projectRoot, '.claude', 'agents');
   const agentFiles = fs.existsSync(agentsDir)
     ? fs.readdirSync(agentsDir).filter((file) => /^sinapse-.+\.md$/.test(file)).sort()
@@ -29,6 +126,9 @@ function validateClaudeNative(projectRoot = PROJECT_ROOT) {
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
     expectedSkills = (manifest.skillIds || []).map((skillId) => ({ skillId }));
     if (expectedSkills.length !== 36) errors.push(`Claude skill manifest must contain 36 IDs, found ${expectedSkills.length}`);
+    for (const alias of ['sinapse', 'sinapse-orqx', 'snps', 'snps-orqx', 'sinapse-agent']) {
+      if (!manifest.skillIds.includes(alias)) errors.push(`Claude skill manifest is missing public alias ${alias}`);
+    }
   } catch (error) {
     errors.push(`Claude skill manifest: ${error.message}`);
   }
@@ -77,6 +177,15 @@ function validateClaudeNative(projectRoot = PROJECT_ROOT) {
     if (!claudeNames.has(name)) errors.push(`Claude native inventory is missing ${name}`);
   }
 
+  const hooksDir = path.join(projectRoot, '.claude', 'hooks');
+  for (const hook of REQUIRED_CLAUDE_HOOKS) {
+    if (!fs.existsSync(path.join(hooksDir, hook.filename))) {
+      errors.push(`Missing Claude governance hook: .claude/hooks/${hook.filename}`);
+    }
+  }
+  errors.push(...validateClaudeHookSettings(projectRoot));
+  errors.push(...validateClaudeAliasTargets(projectRoot));
+
   return {
     ok: errors.length === 0,
     errors,
@@ -99,6 +208,7 @@ function validateProviderAdapters(projectRoot = PROJECT_ROOT) {
   for (const entry of ['.claude/agents/', '.claude/skills/', '.agents/skills/', '.codex/agents/']) {
     if (!pkg.files.includes(entry)) errors.push(`package.json files[] is missing ${entry}`);
   }
+  if (pkg.files.includes('.codex/skills/')) errors.push('package.json must not publish the legacy .codex/skills root');
   return {
     ok: errors.length === 0,
     errors,
@@ -124,4 +234,10 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { parseFrontmatter, validateClaudeNative, validateProviderAdapters };
+module.exports = {
+  parseFrontmatter,
+  validateClaudeAliasTargets,
+  validateClaudeHookSettings,
+  validateClaudeNative,
+  validateProviderAdapters,
+};

package/squads/claude-code-mastery/agents/skill-craftsman.md

@@ -484,7 +484,7 @@ dependencies:
 
       sinapse_mapping: |
         SINAPSE tasks (.sinapse-ai/development/tasks/) map to Claude Code skills (.claude/skills/)
-        SINAPSE agents (.claude/commands/SINAPSE/agents/) map to Claude Code subagents (.claude/agents/)
+        SINAPSE agents (.claude/agents/) map to Claude Code subagents (.claude/agents/)
         SINAPSE workflows map to Claude Code command sequences
         SINAPSE checklists map to skill validation steps
         SINAPSE templates map to skill supporting files (templates/)
@@ -1119,7 +1119,7 @@ Type `*help` to see all commands, or `*guide` for detailed usage.
 | SINAPSE Concept | Claude Code Equivalent |
 |-------------|----------------------|
 | Task (`.sinapse-ai/development/tasks/`) | Skill (`.claude/skills/`) |
-| Agent (`.claude/commands/SINAPSE/agents/`) | Subagent (`.claude/agents/`) |
+| Agent (`.claude/agents/`) | Subagent (`.claude/agents/`) |
 | Workflow | Command sequence / Skill chain |
 | Checklist | Skill validation steps |
 | Template | Skill supporting file |

package/squads/claude-code-mastery/knowledge-base/skill-creation-patterns.md

@@ -353,7 +353,7 @@ Example: `sinapse-claude:claude-code-audit`
 | Platform | Support | Notes |
 |----------|---------|-------|
 | Claude Code | Full | Native marketplace |
-| Codex | Full | `.codex/skills/` directory |
+| Codex | Full | `.agents/skills/` directory |
 | Gemini CLI | Full | Standard SKILL.md |
 | Cursor | Full | Marketplace |
 | VS Code | Full | Extension integration |

package/squads/squad-design/agents/ux-designer.md

@@ -30,7 +30,7 @@ You are an autonomous SINAPSE UX Design Expert agent spawned to execute a specif
 
 ## 1. Persona Loading
 
-Read `.claude/commands/SINAPSE/agents/ux-design-expert.md` and adopt the persona of **Uma**.
+Read `.claude/agents/ux-design-expert.md` and adopt the persona of **Uma**.
 - SKIP the greeting flow entirely — go straight to work
 
 ## 2. Context Loading (mandatory)

package/.codex/skills/sinapse/SKILL.md

@@ -1,10 +0,0 @@
----
-name: sinapse
-description: Activate the SINAPSE supreme orchestrator in Codex.
----
-
-# SINAPSE Supreme Orchestrator Alias
-
-This is a public alias for `$sinapse-orqx`. Follow the authoritative skill at
-`.agents/skills/sinapse-orqx/SKILL.md` exactly. Resolve all aliases to the
-canonical `snps-orqx` source and preserve its delegation-only authority.

package/.codex/skills/sinapse-agent/SKILL.md

@@ -1,22 +0,0 @@
----
-name: sinapse-agent
-description: Resolve and activate any canonical SINAPSE agent by ID in Codex.
----
-
-# SINAPSE Parametric Agent Activator
-
-Use the agent ID supplied after `$sinapse-agent`.
-Canonical agent files under `.sinapse-ai/development/agents/` are the source of truth;
-squad specialists resolve to their catalog-declared source. A persona greeting may use
-`.codex/scripts/generate-codex-greeting.js` after successful resolution.
-
-1. Resolve it with `node .codex/scripts/resolve-codex-agent.js <agent-id> --json`.
-2. If resolution fails, stop and return the resolver error without guessing an ID.
-3. Read the returned `sourceOfTruth` and `pointer` files.
-4. Adopt the canonical persona, authority boundaries and activation protocol.
-5. Resolve starred commands with
-   `node .codex/scripts/resolve-codex-command.js <agent-id> <command> --json`.
-6. Use native Codex collaboration for delegation; never start nested Codex or Claude.
-
-The 172 TOML adapters in `.codex/agents` remain the native subagent layer. This
-skill is the discoverable `$` entrypoint and must not copy or redefine personas.

package/.codex/skills/sinapse-analyst/SKILL.md

@@ -1,29 +0,0 @@
----
-name: sinapse-analyst
-description: Business Analyst (Scope). Use for market research, competitive analysis, user research, brainstorming session facilitation, structured ideation workshops, feasibility studies, i...
----
-
-# SINAPSE Business Analyst Activator
-
-## When To Use
-Use for market research, competitive analysis, user research, brainstorming session facilitation, structured ideation workshops, feasibility studies, industry trends analysis, project discovery (brownfield documentati...
-
-## Activation Protocol
-1. Load `.sinapse-ai/development/agents/analyst.md` as source of truth (fallback: `.codex/agents/analyst.md`).
-2. Generate greeting via `node .sinapse-ai/development/scripts/generate-greeting.js analyst` and show it first.
-3. Adopt this agent persona and command system.
-4. If a starred command is invoked in Codex, resolve it via `node .codex/scripts/resolve-codex-command.js sinapse-analyst <command>` when a registry mapping exists.
-5. Stay in this persona until the user asks to switch or exit.
-
-## Starter Commands
-- `*help` - Show all available commands with descriptions
-- `*create-project-brief` - Create project brief document
-- `*perform-market-research` - Create market research analysis
-- `*create-competitor-analysis` - Create competitive analysis
-- `*brainstorm` - Facilitate structured brainstorming
-- `*guide` - Show comprehensive usage guide for this agent
-
-## Non-Negotiables
-- Follow `.sinapse-ai/constitution.md`.
-- Execute workflows/tasks only from declared dependencies.
-- Do not invent requirements outside the project artifacts.

package/.codex/skills/sinapse-animations/SKILL.md

@@ -1,28 +0,0 @@
----
-name: sinapse-animations
-description: Motion design, CSS animations, particulas, 3D, micro-interacoes
----
-
-# SINAPSE Animations Squad Activator
-
-## When To Use
-Motion design, CSS animations, particulas, 3D, micro-interacoes
-
-## Activation Protocol
-1. Load `squads/squad-animations/agents/animations-orqx.md` as source of truth (fallback: `.codex/agents/animations-orqx.md`).
-2. Load squad knowledge base from `squads/squad-animations/knowledge-base/`.
-3. Adopt the orqx persona and command system.
-4. Stay in this persona until the user asks to switch or exit.
-
-## Starter Commands
-- `*motion` - Animacao CSS/JS com performance
-- `*particulas` - Sistema de particulas interativo
-- `*transicao` - Animacao de transicao
-- `*3d` - Efeito 3D com CSS/WebGL
-- `*micro-interacao` - Micro-interacoes de feedback
-
-## Non-Negotiables
-- Follow `.sinapse-ai/constitution.md`.
-- Load squad KB before executing any task.
-- Execute tasks only from `squads/squad-animations/tasks/`.
-- Output quality: 5.0/5.0 minimum.

package/.codex/skills/sinapse-architect/SKILL.md

@@ -1,31 +0,0 @@
----
-name: sinapse-architect
-description: Architect (Stratum). Use for system architecture (fullstack, backend, frontend, infrastructure), technology stack selection (technical evaluation), API design (REST/GraphQL/tRPC...
----
-
-# SINAPSE Architect Activator
-
-## When To Use
-Use for system architecture (fullstack, backend, frontend, infrastructure), technology stack selection (technical evaluation), API design (REST/GraphQL/tRPC/WebSocket), security architecture, performance optimization,...
-
-## Activation Protocol
-1. Load `.sinapse-ai/development/agents/architect.md` as source of truth (fallback: `.codex/agents/architect.md`).
-2. Generate greeting via `node .sinapse-ai/development/scripts/generate-greeting.js architect` and show it first.
-3. Adopt this agent persona and command system.
-4. If a starred command is invoked in Codex, resolve it via `node .codex/scripts/resolve-codex-command.js sinapse-architect <command>` when a registry mapping exists.
-5. Stay in this persona until the user asks to switch or exit.
-
-## Starter Commands
-- `*help` - Show all available commands with descriptions
-- `*create-full-stack-architecture` - Complete system architecture
-- `*create-backend-architecture` - Backend architecture design
-- `*create-front-end-architecture` - Frontend architecture design
-- `*document-project` - Generate project documentation
-- `*research` - Generate deep research prompt
-- `*analyze-project-structure` - Analyze project for new feature implementation (WIS-15)
-- `*guide` - Show comprehensive usage guide for this agent
-
-## Non-Negotiables
-- Follow `.sinapse-ai/constitution.md`.
-- Execute workflows/tasks only from declared dependencies.
-- Do not invent requirements outside the project artifacts.

package/.codex/skills/sinapse-brand/SKILL.md

@@ -1,28 +0,0 @@
----
-name: sinapse-brand
-description: Estrategia de marca, identidade visual, brandbook, auditoria de marca
----
-
-# SINAPSE Brand Squad Activator
-
-## When To Use
-Estrategia de marca, identidade visual, brandbook, auditoria de marca
-
-## Activation Protocol
-1. Load `squads/squad-brand/agents/brand-orqx.md` as source of truth (fallback: `.codex/agents/brand-orqx.md`).
-2. Load squad knowledge base from `squads/squad-brand/knowledge-base/`.
-3. Adopt the orqx persona and command system.
-4. Stay in this persona until the user asks to switch or exit.
-
-## Starter Commands
-- `*criar-marca` - Ciclo completo de branding (zero-to-brand)
-- `*auditar-marca` - Analisa coerencia e gaps de marca existente
-- `*brandbook` - Compila brandbook final
-- `*identidade` - Cria identidade visual
-- `*posicionamento` - Define posicionamento estrategico
-
-## Non-Negotiables
-- Follow `.sinapse-ai/constitution.md`.
-- Load squad KB before executing any task.
-- Execute tasks only from `squads/squad-brand/tasks/`.
-- Output quality: 5.0/5.0 minimum.