sinapse-ai 1.12.2 → 1.14.0

package/.sinapse-ai/infrastructure/scripts/validate-agents.js

@@ -28,6 +28,10 @@ const yaml = require('js-yaml');
 // Paths
 const ROOT_DIR = path.join(__dirname, '..', '..');
 const AGENTS_DIR = path.join(ROOT_DIR, 'development', 'agents');
+// Squad agents live in the repo root under squads/<squad>/agents/*.md.
+// ROOT_DIR is .sinapse-ai/; the repo root is one level up.
+const REPO_ROOT = path.join(ROOT_DIR, '..');
+const SQUADS_DIR = path.join(REPO_ROOT, 'squads');
 const TASKS_DIR = path.join(ROOT_DIR, 'development', 'tasks');
 const TEMPLATES_DIR = path.join(ROOT_DIR, 'development', 'templates');
 const CHECKLISTS_DIR = path.join(ROOT_DIR, 'development', 'checklists');
@@ -93,9 +97,10 @@ function extractYamlFromMarkdown(content) {
 }
 
 /**
- * Load all agent files
+ * Load the 12 CORE agents (development/agents/*.md).
+ * Core agents are held to the STRICT schema (problems -> errors).
  */
-async function loadAllAgents() {
+async function loadCoreAgents() {
   const agents = [];
 
   try {
@@ -115,6 +120,8 @@ async function loadAllAgents() {
             commands: parsed.commands || [],
             dependencies: parsed.dependencies || {},
             parsed,
+            isCore: true,
+            tier: 'core',
           });
         }
       }
@@ -126,6 +133,100 @@ async function loadAllAgents() {
   return agents;
 }
 
+/**
+ * Load the SQUAD agents (squads/<squad>/agents/*.md).
+ *
+ * Non-breaking by design: squad agents carry KNOWN pre-existing debt (3
+ * different definition formats, malformed frontmatter, missing roster
+ * entries) that later waves will fix. Here they are classified as WARNINGS,
+ * never errors — the only thing that can ERROR is an unreadable file.
+ *
+ * Each record is tagged isCore:false so the validators downgrade their
+ * findings to warnings.
+ */
+async function loadSquadAgents() {
+  const agents = [];
+
+  let squadDirs;
+  try {
+    const entries = await fs.readdir(SQUADS_DIR, { withFileTypes: true });
+    squadDirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+  } catch {
+    // No squads/ dir (e.g. a stripped checkout) -> nothing to add, not fatal.
+    return agents;
+  }
+
+  for (const squad of squadDirs) {
+    const agentsDir = path.join(SQUADS_DIR, squad, 'agents');
+    let files;
+    try {
+      files = await fs.readdir(agentsDir);
+    } catch {
+      continue; // squad without an agents/ dir -> skip
+    }
+
+    for (const file of files) {
+      if (!file.endsWith('.md') || file.startsWith('_')) continue;
+      const filePath = path.join(agentsDir, file);
+
+      let content;
+      try {
+        content = await fs.readFile(filePath, 'utf-8');
+      } catch (error) {
+        // Unreadable file is the ONE critical issue allowed to error for squads.
+        agents.push({
+          file: `${squad}/agents/${file}`,
+          path: filePath,
+          id: file.replace('.md', ''),
+          name: undefined,
+          commands: [],
+          dependencies: {},
+          parsed: null,
+          isCore: false,
+          tier: 'squad',
+          squad,
+          readError: error.message,
+        });
+        continue;
+      }
+
+      let parsed = null;
+      try {
+        parsed = extractYamlFromMarkdown(content);
+      } catch {
+        // Malformed frontmatter -> parsed stays null; surfaced as a WARNING.
+        parsed = null;
+      }
+
+      const agentBlock = parsed && parsed.agent ? parsed.agent : {};
+      agents.push({
+        file: `${squad}/agents/${file}`,
+        path: filePath,
+        id: agentBlock.id || file.replace('.md', ''),
+        name: agentBlock.name,
+        commands: (parsed && parsed.commands) || [],
+        dependencies: (parsed && parsed.dependencies) || {},
+        parsed,
+        isCore: false,
+        tier: 'squad',
+        squad,
+        parseFailed: parsed === null,
+      });
+    }
+  }
+
+  return agents;
+}
+
+/**
+ * Load all agent files (core + squad).
+ */
+async function loadAllAgents() {
+  const core = await loadCoreAgents();
+  const squad = await loadSquadAgents();
+  return [...core, ...squad];
+}
+
 /**
  * Check if a file exists
  */
@@ -171,21 +272,32 @@ function validateCommandUniqueness(agents) {
         agent: agent.id,
         file: agent.file,
         hasVisibility: cmd.visibility !== undefined,
+        isCore: agent.isCore === true,
       });
     }
   }
 
-  // Check for duplicates
+  // Check for duplicates.
+  // A collision is an ERROR only when it is entirely between CORE agents
+  // (the strict, long-standing guarantee). Any collision that involves a
+  // SQUAD agent is downgraded to a WARNING — squad agents carry pre-existing
+  // naming debt that later waves will reconcile, and they must not break CI.
   for (const [cmd, owners] of commandOwners) {
     if (owners.length > 1 && !SHARED_COMMANDS.has(cmd)) {
       const ownerList = owners.map((o) => `@${o.agent}`).join(', ');
-      errors.push({
+      const allCore = owners.every((o) => o.isCore);
+      const finding = {
         type: 'DUPLICATE_COMMAND',
         command: cmd,
         owners: owners.map((o) => o.agent),
         message: `Command "*${cmd}" has multiple owners: ${ownerList}`,
         suggestion: `Keep "*${cmd}" only in the primary owner agent and remove from others, or add to SHARED_COMMANDS if intentionally shared.`,
-      });
+      };
+      if (allCore) {
+        errors.push(finding);
+      } else {
+        warnings.push(finding);
+      }
     }
   }
 
@@ -282,9 +394,37 @@ function validateAgentFormat(agents) {
   for (const agent of agents) {
     const { parsed, file, id } = agent;
 
+    // SQUAD agents: known pre-existing debt. Every structural problem here is
+    // a WARNING (never an error) so the 160 squad agents never break CI. The
+    // single exception (unreadable file) is handled earlier in the loader.
+    // CORE agents keep the strict behavior — structural problems are errors.
+    const sink = agent.isCore ? errors : warnings;
+
+    // Unreadable file is the ONLY truly-critical squad issue -> error.
+    if (agent.readError) {
+      errors.push({
+        type: 'UNREADABLE_AGENT',
+        agent: id,
+        message: `Cannot read agent file ${file}: ${agent.readError}`,
+      });
+      continue;
+    }
+
+    // A squad agent whose YAML didn't parse at all -> one consolidated warning,
+    // then skip the field-by-field checks (parsed is null).
+    if (!parsed || !parsed.agent) {
+      warnings.push({
+        type: 'UNPARSEABLE_AGENT',
+        agent: id,
+        message: `Could not parse agent definition in ${file} (no agent block / malformed frontmatter) — squad debt, later wave`,
+        suggestion: 'Normalize the agent frontmatter to the standard schema (agent.id/name/title).',
+      });
+      continue;
+    }
+
     // Check required fields
     if (!parsed.agent.id) {
-      errors.push({
+      sink.push({
         type: 'MISSING_FIELD',
         agent: id,
         field: 'agent.id',
@@ -293,7 +433,7 @@ function validateAgentFormat(agents) {
     }
 
     if (!parsed.agent.name) {
-      errors.push({
+      sink.push({
         type: 'MISSING_FIELD',
         agent: id,
         field: 'agent.name',
@@ -302,7 +442,7 @@ function validateAgentFormat(agents) {
     }
 
     if (!parsed.agent.title) {
-      errors.push({
+      sink.push({
         type: 'MISSING_FIELD',
         agent: id,
         field: 'agent.title',
@@ -443,6 +583,10 @@ function formatResults(results, showSuggestions = false) {
   lines.push('  Summary');
   lines.push('━'.repeat(60));
   lines.push(`  Agents validated: ${summary.totalAgents}`);
+  if (summary.coreAgents !== undefined) {
+    lines.push(`    Core (strict):  ${summary.coreAgents}`);
+    lines.push(`    Squad (warn):   ${summary.squadAgents}`);
+  }
   lines.push(`  Errors: ${summary.totalErrors}`);
   lines.push(`  Warnings: ${summary.totalWarnings}`);
   lines.push('');
@@ -487,12 +631,17 @@ async function validateAgents(options = {}) {
     dependencyValidation.warnings.length +
     formatValidation.warnings.length;
 
+  const coreAgents = agents.filter((a) => a.isCore);
+  const squadAgents = agents.filter((a) => !a.isCore);
+
   const results = {
     commandValidation,
     dependencyValidation,
     formatValidation,
     summary: {
       totalAgents: agents.length,
+      coreAgents: coreAgents.length,
+      squadAgents: squadAgents.length,
       totalErrors,
       totalWarnings,
       valid: totalErrors === 0,
@@ -545,6 +694,8 @@ module.exports = {
   validateDependencies,
   validateAgentFormat,
   loadAllAgents,
+  loadCoreAgents,
+  loadSquadAgents,
 };
 
 // Run CLI if called directly

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

@@ -7,9 +7,9 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.12.2
+version: 1.14.0
 generator: scripts/generate-install-manifest.js
-file_count: 1181
+file_count: 1147
 files:
   - path: cli/commands/config/index.js
     hash: sha256:bfa83cb1dc111b0b30dd298dc0abc2150b73f939b6cd4458effa8e6d407bc9e2
@@ -108,9 +108,9 @@ files:
     type: cli
     size: 5039
   - path: cli/commands/pro/index.js
-    hash: sha256:be706f637b3f54d882a8e1d3ee953a40c7ae7b94ca3bfcafdd4d6865d0526964
+    hash: sha256:3bf6709d9981201f3466fdf30f8f36e2a7585282d590550e44ef475248d01972
     type: cli
-    size: 22145
+    size: 20545
   - path: cli/commands/qa/audit.js
     hash: sha256:e177f5eb9cbf3ce4b6decbc24b8c171633aa6cb8506d393a3d4b12d3cc475882
     type: cli
@@ -563,26 +563,6 @@ files:
     hash: sha256:3a171bf985b7deb1a30abd9c28f5d339cc3bc2f5c94f0efc444ee3597acc47c3
     type: core
     size: 3600
-  - path: core/grounding/brand.cjs
-    hash: sha256:05e1e8b8a7415885ba5709189aa26fe0bc0bd97478e3f87d685592427fa08c5f
-    type: core
-    size: 884
-  - path: core/grounding/config-loader.cjs
-    hash: sha256:bab7222b546570e124e8dd986b94b7cb3ddcbf3a9ab7d9c4c9e56ada5896ffc7
-    type: core
-    size: 1555
-  - path: core/grounding/design-system.cjs
-    hash: sha256:369bff34d0d507486ab4fa005b46a4c4f3f73e4ad35571241a6b9ad9d258fcc9
-    type: core
-    size: 938
-  - path: core/grounding/README.md
-    hash: sha256:ce4b0e0cef09f1eb337dd3aa321b5b48fe3c82dac0ea2dfa580edd9197cf7892
-    type: core
-    size: 3549
-  - path: core/grounding/vault.cjs
-    hash: sha256:9254360614fd3625479465a04e34f14a8e11cfe8adb5cea75386c0597ac9ae8d
-    type: core
-    size: 1259
   - path: core/health-check/base-check.js
     hash: sha256:1d322d1bd5cbb4cb4834165e795691fe761e0d84a208d4f4db1b839fa9b01dec
     type: core
@@ -1364,9 +1344,9 @@ files:
     type: data
     size: 9602
   - path: data/entity-registry.yaml
-    hash: sha256:4d8f1c23bf4240a845ab90b7b82092e7c5022ff0e1d583900b750d95f44ffe0b
+    hash: sha256:8b5182998467ccf39613571300eb714e7bdd1f51e0f031582cadaf44fcdf555a
     type: data
-    size: 558883
+    size: 547889
   - path: data/learned-patterns.yaml
     hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
     type: data
@@ -1471,90 +1451,50 @@ files:
     hash: sha256:25c833e36babf8b227321d40105d069fca29e301a4ecedcd7a74ba8dace625b0
     type: agent
     size: 16361
-  - path: development/agents/analyst/MEMORY.md
-    hash: sha256:1c0f22927a27f6b4446b74253747db214e78456bde7343fe98300b7106858025
-    type: agent
-    size: 1257
   - path: development/agents/architect.md
     hash: sha256:43fa59df34a2cd7cc68c8496da7b41d6f65fe0a7a05bd1c0cee2395c0ec5aedb
     type: agent
     size: 25192
-  - path: development/agents/architect/MEMORY.md
-    hash: sha256:6ce3f0187f34b9d9cd97fbc744f9eb33efb08cff48b64528ffce2dd08d453c09
-    type: agent
-    size: 1395
   - path: development/agents/data-engineer.md
     hash: sha256:c411c75db1c8a67385af3ea1e46d862cfced843f38881004bca801b432f1b16a
     type: agent
     size: 24405
-  - path: development/agents/data-engineer/MEMORY.md
-    hash: sha256:91b84ee63dafd3fbeec8d00744752753d1a74acdd3a6b398f26db6662d2babf3
-    type: agent
-    size: 1110
   - path: development/agents/developer.md
     hash: sha256:05e2e6362f95eb66c80e4f01dcb25232e283666c2195ec070e1bb59cc486ecb2
     type: agent
     size: 29832
-  - path: development/agents/developer/MEMORY.md
-    hash: sha256:98e00ca0bd5b0b2fdfbcf8ad52256dd7f73df6236e2098618d63fae97652949a
-    type: agent
-    size: 2493
   - path: development/agents/devops.md
     hash: sha256:81144f100a7ea8ef339a51691d32e7c480e24fef6ab4c3276e927568ba6ba0e4
     type: agent
     size: 28149
-  - path: development/agents/devops/MEMORY.md
-    hash: sha256:c9c574566f3ab627135219eefb2e0039169016f4f0a8605b02593d0cfd38f071
-    type: agent
-    size: 1403
   - path: development/agents/product-lead.md
     hash: sha256:a6427801bc1ab8af034d7ca64a9992c918d340503e34105844c657f212b547e7
     type: agent
     size: 16213
-  - path: development/agents/product-lead/MEMORY.md
-    hash: sha256:148c843a490e35e89d5fac74cea9beafb2fc4055aa9bbf52505ab383b265360f
-    type: agent
-    size: 1398
   - path: development/agents/project-lead.md
     hash: sha256:be876cef505639e7cf4fdfd82028bb61be459f6a2fbca72ce8cb83836ef4c594
     type: agent
     size: 18587
-  - path: development/agents/project-lead/MEMORY.md
-    hash: sha256:b7b754e37419cb605871920283decde2c01125c5f641f90afe569491838cf5e3
-    type: agent
-    size: 1238
   - path: development/agents/quality-gate.md
     hash: sha256:bc99385b3aee34ed5234287f37b53dd57c1f59b7f4cf1bd401447da4562117d4
     type: agent
     size: 23745
-  - path: development/agents/quality-gate/MEMORY.md
-    hash: sha256:a17353257dc4dce493f6a87690c8ac8e8bbc1f0d71018f926277324c6a2869bb
-    type: agent
-    size: 1369
   - path: development/agents/snps-orqx.md
-    hash: sha256:ac7f931f107fe2adc020ef26f8ea0e1aba57dd0ba3d02bbff3b92e3ca6466368
+    hash: sha256:313fd53fcb43bec1a0e0e1dc90867c6a6b3643e08a9a41e32e2fa86e090ce8ae
     type: agent
-    size: 41103
+    size: 42694
   - path: development/agents/sprint-lead.md
     hash: sha256:572289b770cdbb0cff9ae2de4b2d19c38ce814fe978df397aa2794297f562c91
     type: agent
     size: 14441
-  - path: development/agents/sprint-lead/MEMORY.md
-    hash: sha256:12a5b03243b3dd6d8df71ae70cb74bd380f00ad892aa2aeffcd9ec6a447cebb0
-    type: agent
-    size: 2023
   - path: development/agents/squad-creator.md
-    hash: sha256:45326e5a21a8d0497f8164160c03db991ea8782300a8880ca46ec4df9835ac01
+    hash: sha256:80fc6cdfd6d7102803a5c477d576cbfadf96990ffd8f6c7246047603f2a80d33
     type: agent
-    size: 16584
+    size: 18180
   - path: development/agents/ux-design-expert.md
     hash: sha256:ef221c2ce9dc7b808feab65d04c80e5d0186fe3343e079404d761b1d9ff056a2
     type: agent
     size: 21931
-  - path: development/agents/ux/MEMORY.md
-    hash: sha256:315ac4d963d09f50c2686fdcb56fa4c34761b5097600f6a834a44cfacca12414
-    type: agent
-    size: 1078
   - path: development/checklists/agent-quality-gate.md
     hash: sha256:511d05a2df0e59f3503d882f61131703a5fcecb47d75f99b392086fc3a663433
     type: checklist
@@ -1663,10 +1603,6 @@ files:
     hash: sha256:e58ad5d52b329d335ee73245352ae545df19c8122e23f34750a6a75996ca9dc6
     type: script
     size: 5386
-  - path: development/scripts/approval-workflow.js
-    hash: sha256:3e0874ab55558dd39539dc1da7eea97c60f5797129165c385a01a699b1e98df0
-    type: script
-    size: 21560
   - path: development/scripts/audit-agent-config.js
     hash: sha256:fde7fba12b7b451109911d75ac7719c0c5f586bf81341fb0d79d4110be3750af
     type: script
@@ -1675,30 +1611,10 @@ files:
     hash: sha256:38cd58a782cc942481bcf1279bdb239c4ea760de0c6df7f5f09166110d6e8b19
     type: script
     size: 10019
-  - path: development/scripts/backup-manager.js
-    hash: sha256:04aee4ddce4943ae7457319cd57df9a4d592be641a007b79efde33273b0cdd90
-    type: script
-    size: 16666
   - path: development/scripts/batch-update-agents-session-context.js
     hash: sha256:5b301f24fd43c6054000cafae9e2457abd023aae1d80a6f65e43a1bf3ce07319
     type: script
     size: 2928
-  - path: development/scripts/branch-manager.js
-    hash: sha256:694c20fe8725e06e7f263a8d3ec19057aab1bfdf3820cf70c350e4c54523fffa
-    type: script
-    size: 11540
-  - path: development/scripts/code-quality-improver.js
-    hash: sha256:541d7028563a510020119967c3237dfcc84feb039d85bf790624a690c43c18e9
-    type: script
-    size: 40546
-  - path: development/scripts/commit-message-generator.js
-    hash: sha256:d97f1cac89c86dfc489a5327bf3e2583ebcceef3b090887002367ee440abcf33
-    type: script
-    size: 25379
-  - path: development/scripts/conflict-resolver.js
-    hash: sha256:f27bbf2ce203c74634064b5d369aa90d506b364cabf2a303c911a849218b5c5d
-    type: script
-    size: 19189
   - path: development/scripts/decision-context.js
     hash: sha256:e9bfb559fbd9732f5ba3d25564ddfaec41d7d6c3cc719ceba5c750a637df14dc
     type: script
@@ -1715,26 +1631,14 @@ files:
     hash: sha256:aaeefc65620010f8ad22213595c833228d1037d2775e96dd1708d198040ae6a7
     type: script
     size: 5137
-  - path: development/scripts/dependency-analyzer.js
-    hash: sha256:39880d23a840dcc06d2e235e5e04417b435497f87acae8a57104c130be74e718
-    type: script
-    size: 18035
   - path: development/scripts/dev-context-loader.js
     hash: sha256:6de474e8311aa8f7f19494b6bf81287592f8f577b0c1a345b2e1a28e94b28171
     type: script
     size: 8238
-  - path: development/scripts/diff-generator.js
-    hash: sha256:d55d4a61ad34053338b29ecfbcf1d2547980ba884318c0752f7a9e3b22389460
-    type: script
-    size: 10668
   - path: development/scripts/generate-greeting.js
     hash: sha256:052b669917fe0934942cc85f613af8fe7302a9b7d70187c9558337bef3f9ec92
     type: script
     size: 3221
-  - path: development/scripts/git-wrapper.js
-    hash: sha256:172aa10616b1fb98a685af9afa81c85b09db3546176dc4a83cfdb06ca1015588
-    type: script
-    size: 11890
   - path: development/scripts/greeting-builder.js
     hash: sha256:293b89379a558837cfab65893130b638d6207079cde2d5252578089bb25732be
     type: script
@@ -1763,34 +1667,14 @@ files:
     hash: sha256:d6f3a03f975b01e4bf86b185228833e965145e3be10ce8a1d4e6cfc54c85b3f4
     type: script
     size: 9455
-  - path: development/scripts/modification-validator.js
-    hash: sha256:0bce67d53b19243654626bf53d754019011e327d037fdc7ca06bb0e1e1889022
-    type: script
-    size: 16489
   - path: development/scripts/pattern-learner.js
     hash: sha256:8fc513199884abdc7ac011fac381ba1bb695d43fa7d08a655951bf55754749f4
     type: script
     size: 35071
-  - path: development/scripts/performance-analyzer.js
-    hash: sha256:a28eb3b242415f6bb4252c2b1579723cd8c6a5dbb59549783ef9150baaa259c4
-    type: script
-    size: 23414
   - path: development/scripts/populate-entity-registry.js
     hash: sha256:2232bebc783c13e222c7b80713eae016343406ab2a878b0c6950b0691202d8c1
     type: script
     size: 25928
-  - path: development/scripts/refactoring-suggester.js
-    hash: sha256:66bf0be38efb417619e652c690d41337202dae7defa454bec73b010b05bb6db4
-    type: script
-    size: 35228
-  - path: development/scripts/rollback-handler.js
-    hash: sha256:c79a84fa3b4bc86b6e26f994039555a854063c0f036b0b08d7ce2c32a2134c7e
-    type: script
-    size: 16563
-  - path: development/scripts/security-checker.js
-    hash: sha256:b1ccf2428b623bdb3bac364ed92092fe55a8ec8a4fb5f086a0ad1b140fe69d25
-    type: script
-    size: 9524
   - path: development/scripts/skill-validator.js
     hash: sha256:9e8decda5a7bf73f05772ba0a315931b55bc61e333efea16901c5170752fb297
     type: script
@@ -1859,26 +1743,10 @@ files:
     hash: sha256:c4c46498b93e3ddf268648735e8059edbc6c84b21ef7675ba1557fa8cc856bcb
     type: script
     size: 3986
-  - path: development/scripts/template-engine.js
-    hash: sha256:d4143c5ec5fb4238e4d86a7cdbae610787f7647117bd5ed76cf61cfd7792cdb7
-    type: script
-    size: 6961
-  - path: development/scripts/template-validator.js
-    hash: sha256:f08cc27cbcc2990df0eb48f0aa677f196949b5a6c82c1837d0fdff0c7684f39f
-    type: script
-    size: 8335
-  - path: development/scripts/test-generator.js
-    hash: sha256:55dc8708ad43492fa886dfb1bbb8f9c25138f49a1d4e3a310f30ee30574050aa
-    type: script
-    size: 24943
   - path: development/scripts/test-greeting-system.js
     hash: sha256:eb0379edc43f6a448138420cda25b1685caaa8e5d2884afee27766a525e92f5d
     type: script
     size: 5563
-  - path: development/scripts/transaction-manager.js
-    hash: sha256:4df7b626b5d29c0527e265451099e65ab2aa004534259cf094695f5d71eac620
-    type: script
-    size: 17614
   - path: development/scripts/unified-activation-pipeline.js
     hash: sha256:9ac8eabc4635500e9d10cebe52e2147f15366840b0a3f97313f17a61b95d1062
     type: script
@@ -1915,10 +1783,6 @@ files:
     hash: sha256:05226c7d3c27cf94ccd653686f3ce043c7b649fef753ce0f17ffb470cf01bd76
     type: script
     size: 25486
-  - path: development/scripts/yaml-validator.js
-    hash: sha256:b64ef84a6def84cc600aca2c04fedd1999be394cac017409231752ee9eb51f46
-    type: script
-    size: 10338
   - path: development/skills/captcha-handler.md
     hash: sha256:de3fcdf981a727a2b2efd532d4596bed50a0f2ba14c340bcd8b735ad7fab5876
     type: development
@@ -2836,9 +2700,9 @@ files:
     type: template
     size: 1106
   - path: development/templates/chrome-brain/knowledge-base/chrome-brain.md
-    hash: sha256:ed47917601edfe48153290ea57b3d367220ceba6b976e7222c2451af6b4a6566
+    hash: sha256:4b73f2a5c680aa9260e7c66a0a222a6927a0032784ca803eb309816774a5de84
     type: template
-    size: 5923
+    size: 5894
   - path: development/templates/chrome-brain/knowledge-base/claude-in-chrome.md
     hash: sha256:b91572e0ddf072f21546a8ee7b910c692e052ba87dc3a6eb829fe049d28180c2
     type: template
@@ -3440,9 +3304,9 @@ files:
     type: script
     size: 8847
   - path: infrastructure/scripts/ide-sync/index.js
-    hash: sha256:b2cb08dc1d0e7c6c22436c11f073cdaae9516b28a55ad5a454412e87aaf59bba
+    hash: sha256:86578adee8ec6fd5cc7a38d70ea04984d4c7bdb717126c21e0cc32b044c4c5c9
     type: script
-    size: 18011
+    size: 18770
   - path: infrastructure/scripts/ide-sync/persona-renderer.js
     hash: sha256:44f76be1e48c4a6271d8c721687d8788d2317a1163d74731abfe97f36775334d
     type: script
@@ -3684,9 +3548,9 @@ files:
     type: script
     size: 18249
   - path: infrastructure/scripts/validate-agents.js
-    hash: sha256:1fb818950cfa60c572cdc63b5f822ffe9b0a11d351d136f2373bffb24eef99e8
+    hash: sha256:62f4f46fa2117f633b96b42be5fcf0448cf56408998affee6728e798c8014733
     type: script
-    size: 16777
+    size: 21894
   - path: infrastructure/scripts/validate-claude-integration.js
     hash: sha256:fe5e85f257724ec86178d4ed0a4cc6ce4d98b5b093f707851852ae0d2469abad
     type: script

package/AGENTS.md

@@ -29,8 +29,19 @@ SINAPSE is a meta-framework that orchestrates AI agents into specialized squads
 
 - **CLI First** -- All intelligence lives in the CLI. Dashboards observe, never control.
 - **4-Layer Boundary** -- L1 (core, immutable) / L2 (templates, extend-only) / L3 (config, mutable) / L4 (runtime, always modify).
-- **Documentation-First** -- No code without a validated story. Pipeline: Epic -> Story -> Validation -> Implementation.
-- **Constitution** -- 11 articles with automatic gates that block violations. See `.sinapse-ai/constitution.md`.
+- **Documentation-First Development** -- No code without a validated story. Pipeline: Epic -> Story -> Validation -> Implementation.
+- **Constitution** -- 11 articles with automatic gates that block violations (full text: `.sinapse-ai/constitution.md`):
+  - **I. CLI First** -- intelligence in the CLI; dashboards observe, never control.
+  - **II. Agent Authority** -- exclusive authorities (only @devops pushes/PRs/releases); no agent assumes another's role.
+  - **III. Documentation-First Development** -- no code without a validated story.
+  - **IV. No Invention** -- every spec statement traces to a requirement/research finding.
+  - **V. Quality First** -- lint, typecheck, tests and (when applicable) build must pass.
+  - **VI. Absolute Imports** -- prefer `@/` over relative paths.
+  - **VII. Ecosystem Metrics Accuracy** -- squad/agent counts must be exact across all docs.
+  - **VIII. Mandatory Delegation** -- orchestrators always delegate domain work to specialists.
+  - **IX. Safe Collaboration** -- branch + sync + secret-scan; never work directly on main.
+  - **X. Security & Data Protection** -- RLS, least privilege, secrets in env, LGPD compliance.
+  - **XI. Conservative Default** -- prefer the least-destructive action; deletions in protected paths need an explicit override.
 
 ### Project Structure