sinapse-ai 1.17.0 → 1.19.0

package/scripts/validate-agent-codenames.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+/**
+ * validate-agent-codenames — AuditFinding AF-20260629 #32
+ *
+ * Rejects DUPLICATE persona codenames (the `name:` field) shared across two or
+ * more DISTINCT agents. A codename is an agent's public identity (Pixel, Litmus,
+ * Meridian, ...); two unrelated agents answering to the same codename is a
+ * collision that confuses routing, selos and the agent badges.
+ *
+ * Scope (sources scanned):
+ *   - squads/{squad}/agents/*.md      (squad specialists + orqx)
+ *   - sinapse/agents/*.md             (master squad)
+ *   - .sinapse-ai/development/agents/*.md (framework core agents)
+ *
+ * Codename extraction: the FIRST quoted `name: "X"` in the file. In every agent
+ * format the persona block sits at the top, so the first quoted name is the
+ * codename — knowledge-base `name:` entries (mental models, frameworks) appear
+ * far below and are intentionally ignored. Files with no quoted `name:` (table /
+ * frontmatter-only formats) are skipped — there is no codename to compare.
+ *
+ * Allow-list: the master orchestrator (Imperator) is intentionally registered
+ * under multiple entry-point files (snps-orqx / sinapse-orqx) — same logical
+ * agent, dual register (Constitution Article XI). It is NOT a collision.
+ *
+ * Exit codes:
+ *   0  every codename is unique (modulo the allow-list)
+ *   1  one or more codenames are shared by distinct agents
+ *
+ * Usage:
+ *   node scripts/validate-agent-codenames.js
+ *   node scripts/validate-agent-codenames.js --json
+ *   node scripts/validate-agent-codenames.js --quiet
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+
+// Source directories that hold agent definition files.
+const AGENT_DIRS = [
+  path.join(PROJECT_ROOT, 'sinapse', 'agents'),
+  path.join(PROJECT_ROOT, '.sinapse-ai', 'development', 'agents'),
+];
+const SQUADS_DIR = path.join(PROJECT_ROOT, 'squads');
+
+// Codenames allowed to appear in more than one file because they are the SAME
+// logical agent registered under multiple alias files (dual register).
+const ALLOWED_DUPLICATES = new Set(['Imperator']);
+
+// Non-agent markdown that may live in an agents/ dir.
+const SKIP_FILES = new Set(['README.md', 'MEMORY.md']);
+
+function parseArgs(argv = process.argv.slice(2)) {
+  const args = new Set(argv);
+  return { quiet: args.has('--quiet') || args.has('-q'), json: args.has('--json') };
+}
+
+function isAgentFile(fileName) {
+  return (
+    fileName.endsWith('.md') &&
+    !SKIP_FILES.has(fileName) &&
+    !fileName.startsWith('_')
+  );
+}
+
+function collectAgentDirs() {
+  const dirs = [...AGENT_DIRS];
+  if (fs.existsSync(SQUADS_DIR)) {
+    for (const entry of fs.readdirSync(SQUADS_DIR, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const agentsDir = path.join(SQUADS_DIR, entry.name, 'agents');
+      if (fs.existsSync(agentsDir)) dirs.push(agentsDir);
+    }
+  }
+  return dirs;
+}
+
+/**
+ * Extract the agent codename: the first quoted `name: "X"` in the file.
+ * @returns {string|null}
+ */
+function extractCodename(content) {
+  const match = content.match(/^\s*name:\s*"([^"]+)"\s*$/m);
+  return match ? match[1].trim() : null;
+}
+
+function collectCodenames() {
+  const byName = new Map(); // codename -> [relPath, ...]
+  for (const dir of collectAgentDirs()) {
+    let files;
+    try {
+      files = fs.readdirSync(dir).filter(isAgentFile);
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      const filePath = path.join(dir, file);
+      let content;
+      try {
+        content = fs.readFileSync(filePath, 'utf8');
+      } catch {
+        continue;
+      }
+      const codename = extractCodename(content);
+      if (!codename) continue;
+      const relPath = path.relative(PROJECT_ROOT, filePath).replace(/\\/g, '/');
+      if (!byName.has(codename)) byName.set(codename, []);
+      byName.get(codename).push(relPath);
+    }
+  }
+  return byName;
+}
+
+function findCollisions(byName) {
+  const collisions = [];
+  for (const [codename, files] of byName) {
+    if (files.length > 1 && !ALLOWED_DUPLICATES.has(codename)) {
+      collisions.push({ codename, files: files.sort() });
+    }
+  }
+  return collisions.sort((a, b) => a.codename.localeCompare(b.codename));
+}
+
+function formatReport(byName, collisions) {
+  const lines = [];
+  const totalAgents = [...byName.values()].reduce((n, f) => n + f.length, 0);
+  lines.push(`Scanned ${totalAgents} agent file(s) with a codename; ${byName.size} distinct codename(s).`);
+  if (collisions.length === 0) {
+    lines.push('OK — every codename is unique (master dual-register allow-listed).');
+    return lines.join('\n');
+  }
+  lines.push('');
+  lines.push(`FAIL — ${collisions.length} duplicate codename(s) found:`);
+  for (const c of collisions) {
+    lines.push(`  "${c.codename}" used by ${c.files.length} agents:`);
+    for (const f of c.files) lines.push(`    - ${f}`);
+  }
+  lines.push('');
+  lines.push('Fix: rename the least-canonical side to a unique codename.');
+  return lines.join('\n');
+}
+
+function main() {
+  const args = parseArgs();
+  const byName = collectCodenames();
+  const collisions = findCollisions(byName);
+
+  if (args.json) {
+    console.log(JSON.stringify({ collisions, distinct: byName.size }, null, 2));
+  } else if (!args.quiet) {
+    console.log('=== validate-agent-codenames ===');
+    console.log(formatReport(byName, collisions));
+  }
+
+  return collisions.length > 0 ? 1 : 0;
+}
+
+if (require.main === module) {
+  process.exitCode = main();
+}
+
+module.exports = {
+  parseArgs,
+  extractCodename,
+  collectAgentDirs,
+  collectCodenames,
+  findCollisions,
+  formatReport,
+  main,
+  ALLOWED_DUPLICATES,
+};

package/scripts/validate-all.js

@@ -54,6 +54,7 @@ const GUARDS = [
   { name: 'manifest:parity', script: 'validate:manifest:parity' },
   { name: 'squad-yaml', script: 'validate:squad-yaml' },
   { name: 'squad-orqx', script: 'validate:squad-orqx' },
+  { name: 'agent-codenames', script: 'validate:agent-codenames' },
 ];
 
 /**

package/sinapse/agents/sinapse-orqx.md

@@ -291,7 +291,7 @@ routing_table:
       orchestrator: copy-orqx (Quill)
       invocation: "/copywriting:agents:copy-orqx"
       domain: "Copywriting, persuasao, headlines, landing pages, email copy, ads copy"
-      agents: 12
+      agents: 13
       tasks: 81
       keywords: ["copy", "copywriting", "headline", "persuasao", "CTA", "landing page", "email", "anuncio", "ad copy", "sales page", "VSL", "script"]
 
@@ -318,7 +318,7 @@ routing_table:
       orchestrator: finance-orqx (Ledger)
       invocation: "/finance:agents:finance-orqx"
       domain: "Inteligencia financeira, pricing, P&L, budget, unit economics, financial modeling"
-      agents: 5
+      agents: 8
       tasks: 45
       keywords: ["financeiro", "finance", "pricing", "P&L", "budget", "unit economics", "modelo financeiro", "receita", "custo", "margem", "ROI", "CAC", "LTV"]
 
@@ -363,7 +363,7 @@ routing_table:
       orchestrator: swarm-orqx (Nexus)
       invocation: "/claude:agents:swarm-orqx"
       domain: "Claude Code mastery, prompt engineering, MCP, automacao, hooks, skills, plugins, agent teams, context engineering"
-      agents: 11
+      agents: 8
       tasks: 51
       keywords: ["Claude", "prompt", "MCP", "automacao", "agent", "squad", "Claude Code", "prompt engineering", "tool use", "workflow", "hooks", "skills", "plugins"]
 
@@ -399,7 +399,7 @@ routing_table:
       orchestrator: cloning-orqx (Helix)
       invocation: "/cloning:agents:cloning-orqx"
       domain: "Clonagem cognitiva, extracao de DNA mental, geracao de agentes a partir de mentes reais"
-      agents: 8
+      agents: 9
       tasks: 54
       keywords: ["clone", "clonagem", "extracao", "DNA cognitivo", "mental model", "heuristic", "transcricao", "Whisper", "cognitive profile", "mind", "mente"]
 
@@ -773,7 +773,7 @@ Imperator can provide ecosystem-wide insights by combining capabilities across s
 | 16 | cloning | cloning | Helix | Cognitive cloning, mental DNA extraction |
 | 17 | courses | courses | Syllabus | Course creation, workshops, ebooks |
 
-**Total ecosystem:** 17 squads, 172 agents, 1,200 tasks
+**Total ecosystem:** 17 squads, 172 agents (160 de squad + 12 core), 1,200 tasks
 
 ## Cross-Squad Handoffs
 - **Receives from:** Every squad (escalations, cross-squad requests)

package/sinapse/agents/snps-orqx.md

@@ -291,7 +291,7 @@ routing_table:
       orchestrator: copy-orqx (Quill)
       invocation: "/copywriting:agents:copy-orqx"
       domain: "Copywriting, persuasao, headlines, landing pages, email copy, ads copy"
-      agents: 12
+      agents: 13
       tasks: 81
       keywords: ["copy", "copywriting", "headline", "persuasao", "CTA", "landing page", "email", "anuncio", "ad copy", "sales page", "VSL", "script"]
 
@@ -318,7 +318,7 @@ routing_table:
       orchestrator: finance-orqx (Ledger)
       invocation: "/finance:agents:finance-orqx"
       domain: "Inteligencia financeira, pricing, P&L, budget, unit economics, financial modeling"
-      agents: 5
+      agents: 8
       tasks: 45
       keywords: ["financeiro", "finance", "pricing", "P&L", "budget", "unit economics", "modelo financeiro", "receita", "custo", "margem", "ROI", "CAC", "LTV"]
 
@@ -363,7 +363,7 @@ routing_table:
       orchestrator: swarm-orqx (Nexus)
       invocation: "/claude:agents:swarm-orqx"
       domain: "Claude Code mastery, prompt engineering, MCP, automacao, hooks, skills, plugins, agent teams, context engineering"
-      agents: 11
+      agents: 8
       tasks: 51
       keywords: ["Claude", "prompt", "MCP", "automacao", "agent", "squad", "Claude Code", "prompt engineering", "tool use", "workflow", "hooks", "skills", "plugins"]
 
@@ -399,7 +399,7 @@ routing_table:
       orchestrator: cloning-orqx (Helix)
       invocation: "/cloning:agents:cloning-orqx"
       domain: "Clonagem cognitiva, extracao de DNA mental, geracao de agentes a partir de mentes reais"
-      agents: 8
+      agents: 9
       tasks: 54
       keywords: ["clone", "clonagem", "extracao", "DNA cognitivo", "mental model", "heuristic", "transcricao", "Whisper", "cognitive profile", "mind", "mente"]
 
@@ -773,7 +773,7 @@ Imperator can provide ecosystem-wide insights by combining capabilities across s
 | 16 | cloning | cloning | Helix | Cognitive cloning, mental DNA extraction |
 | 17 | courses | courses | Syllabus | Course creation, workshops, ebooks |
 
-**Total ecosystem:** 17 squads, 172 agents, 1,200 tasks
+**Total ecosystem:** 17 squads, 172 agents (160 de squad + 12 core), 1,200 tasks
 
 ## Cross-Squad Handoffs
 - **Receives from:** Every squad (escalations, cross-squad requests)

package/squads/squad-brand/agents/brand-creative-engineer.md

@@ -1,8 +1,8 @@
-# brand-creative-engineer — Forge
+# brand-creative-engineer — Ember
 
 ```yaml
 agent:
-  name: "Forge"
+  name: "Ember"
   id: "squad-brand/brand-creative-engineer"
   title: "Creative Asset Engineer"
   icon: "🔥"
@@ -13,9 +13,9 @@ persona_profile:
     tone: systematic
     greeting_levels:
       minimal: "🔥 brand-creative-engineer ready"
-      named: "🔥 Forge (Builder-Creator) ready to create!"
-      archetypal: "🔥 Forge the Creator — code is my canvas, AI is my brush."
-    signature_closing: "— Forge, criando via codigo e IA 🔥"
+      named: "🔥 Ember (Builder-Creator) ready to create!"
+      archetypal: "🔥 Ember the Creator — code is my canvas, AI is my brush."
+    signature_closing: "— Ember, criando via codigo e IA 🔥"
 
 persona:
   role: "Creative Asset Engineer — cria assets via codigo (SVG, CSS, HTML) e via prompt engineering para APIs generativas"

package/squads/squad-brand/squad.yaml

@@ -124,7 +124,7 @@ components:
     - brand-growth-strategist.md   # Catalyst — Alchemist (6 tasks) ★ NEW v3.0
     - brand-culture-architect.md   # Ethos — Purpose Guardian (8 tasks) ★ +3 v3.1
     - brand-identity-designer.md   # Iris — Artist (13 tasks) ★ +1 v3.2
-    - brand-creative-engineer.md   # Forge — Builder-Creator (12 tasks) ★ +1 v3.2
+    - brand-creative-engineer.md   # Ember — Builder-Creator (12 tasks) ★ +1 v3.2
     - brand-collateral-designer.md # Vellum — Craftsman (12 tasks) ★ +1 v3.1
     - brand-system-architect.md    # Grid — Architect (5 tasks)
     - brand-motion-vfx.md          # Flux — Animator (5 tasks)
@@ -194,7 +194,7 @@ components:
     - design-dynamic-identity-system.md   # ★ v3.1 — Generative/responsive identity
     - design-illustration-system.md      # ★ v3.2 — Brand illustration style, guidelines, AI prompting
 
-    # ── Creative Engineer (Forge) — 12 tasks ── ★ +1 v3.2
+    # ── Creative Engineer (Ember) — 12 tasks ── ★ +1 v3.2
     - create-svg-logo.md
     - create-icon-set.md
     - create-pattern.md
@@ -294,7 +294,7 @@ components:
     - gestalt-principles.md              # Gestalt aplicada a branding e design
     - photography-styles.md              # estilos fotograficos, iluminacao, composicao
 
-    # Creative Engineer (Forge) + Identity Designer (Iris)
+    # Creative Engineer (Ember) + Identity Designer (Iris)
     - prompt-engineering-visual.md        # templates de prompts por categoria de asset
     - 3d-render-styles.md               # estilos de render 3D, PBR materials
     - product-categories.md             # categorias de produto com specs de mockup
@@ -434,7 +434,7 @@ brand_value_tracker:
 # v3.2.0 (2026-03-13) — Illustration System, Characters & Auto-Learning
 #   +3 tasks:
 #     1. design-illustration-system.md (Iris) — Brand illustration style, AI prompting
-#     2. create-brand-characters.md (Forge) — Characters, avatars, mascots
+#     2. create-brand-characters.md (Ember) — Characters, avatars, mascots
 #     3. update-brand-preferences.md (Sentinel) — Auto-learning preference tracking
 #   +1 knowledge base:
 #     - illustration-styles.md — Styles, character design, AI gen, case studies
@@ -451,13 +451,13 @@ brand_value_tracker:
 #     1. define-brand-identity-prism.md (Athena) — Kapferer 6-facet Prism
 #     2. define-sensory-brand-strategy.md (Ethos) — Lindstrom multi-sensory
 #     3. define-cultural-adaptation-guidelines.md (Athena) — Hofstede/Meyer glocal
-#     4. create-digital-ad-templates.md (Forge) — All platform ad templates
+#     4. create-digital-ad-templates.md (Ember) — All platform ad templates
 #     5. design-dynamic-identity-system.md (Iris) — Generative/responsive identity
 #     6. create-brand-training-program.md (Ethos) — Training & certification
 #     7. define-ai-voice-guidelines.md (Athena) — AI/chatbot brand voice
 #     8. create-event-branding.md (Vellum) — Event branding system
 #     9. define-sustainability-branding.md (Ethos) — ESG anti-greenwashing
-#    10. create-creator-toolkit.md (Forge) — Creator/influencer toolkit
+#    10. create-creator-toolkit.md (Ember) — Creator/influencer toolkit
 #   +1 knowledge base:
 #     - cultural-brand-adaptation.md — Hofstede, Meyer, sensibilidades culturais
 #   Total: 78 → 88 tasks, 15 → 16 KBs, 117 → 128 files

package/squads/squad-content/agents/content-engineer.md

@@ -1,8 +1,8 @@
-# content-engineer — Arc
+# content-engineer — Truss
 
 ```yaml
 agent:
-  name: "Arc"
+  name: "Truss"
   id: "squad-content/content-engineer"
   title: "Content Structure & Production Engineer"
   icon: "⚡"
@@ -13,19 +13,19 @@ persona_profile:
     tone: precise
     greeting_levels:
       minimal: "⚡ content-engineer ready"
-      named: "⚡ Arc (Engineer) ready to build content that converts!"
-      archetypal: "⚡ Arc the Engineer — structure is invisible when done right, painful when missing."
-    signature_closing: "— Arc, engenheirando conteudo ⚡"
+      named: "⚡ Truss (Engineer) ready to build content that converts!"
+      archetypal: "⚡ Truss the Engineer — structure is invisible when done right, painful when missing."
+    signature_closing: "— Truss, engenheirando conteudo ⚡"
 
 persona:
   role: "Content Structure & Production Engineer — projeta Espinha Dorsal, estrutura narrativas e escreve conteudo em todos os formatos"
   identity: >
     Engenheiro de conteudo que domina tanto a ARQUITETURA (como um conteudo e
-    estruturado) quanto a EXECUCAO (como e escrito). Arc e a fusao de storyteller
+    estruturado) quanto a EXECUCAO (como e escrito). Truss e a fusao de storyteller
     e wordsmith — porque estrutura sem escrita e esqueleto, e escrita sem estrutura
     e ruido. Cada conteudo comeca com uma Espinha Dorsal (tese-mecanismo-prova-direcao),
     depois ganha estrutura narrativa, depois e escrito respeitando regras de escrita
-    e contratos de template. Arc opera em 3 modos: Structure (projetar), Write
+    e contratos de template. Truss opera em 3 modos: Structure (projetar), Write
     (escrever), Batch (escala).
   core_principles:
     - "Espinha Dorsal obrigatoria — NENHUM conteudo comeca sem tese-mecanismo-prova-direcao"

package/squads/squad-content/squad.yaml

@@ -136,7 +136,7 @@ core_concepts:
       parte da mesma Espinha Dorsal — TESE (o que defende), MECANISMO (como funciona),
       PROVA (evidencia), DIRECAO (proximo passo). A Espinha Dorsal e format-agnostic:
       mesma espinha → carrossel, thread, reel, blog, newsletter.
-    agent: "content-engineer (Arc)"
+    agent: "content-engineer (Truss)"
     knowledge_base: "content-spine-engine.md"
 
   template_contract_system:
@@ -145,7 +145,7 @@ core_concepts:
       define: numero de blocos/slides, numero de campos textuais, limites de caracteres
       por campo (min/max), regras de formatacao, specs tecnicas. Contratos sao inviolaveis
       — AI DEVE respeitar limites. Versionados para acompanhar mudancas de plataforma.
-    agents: ["content-engineer (Arc)", "platform-specialist (Morph)", "content-governor (Index)"]
+    agents: ["content-engineer (Truss)", "platform-specialist (Morph)", "content-governor (Index)"]
     knowledge_base: "template-contract-system.md"
     template: "template-contract-registry-template.md"
 
@@ -158,7 +158,7 @@ components:
     - content-orqx.md      # Nexus — Conductor (5 tasks)
     - signal-intelligence.md       # Radar — Scout (9 tasks)
     - editorial-strategist.md      # North — Navigator (10 tasks)
-    - content-engineer.md          # Arc — Engineer (25 tasks)
+    - content-engineer.md          # Truss — Engineer (25 tasks)
     - platform-specialist.md       # Morph — Shapeshifter (15 tasks)
     - content-governor.md          # Index — Librarian (10 tasks)
     - content-analyst.md           # Lens — Analyst (11 tasks)
@@ -199,7 +199,7 @@ components:
     - balance-content-mix.md
     - define-content-kpis.md
 
-    # ── Content Engineer (Arc) — 25 tasks ──
+    # ── Content Engineer (Truss) — 25 tasks ──
     # Structure mode
     - design-content-spine.md
     - design-narrative-arc.md
@@ -285,7 +285,7 @@ components:
     - editorial-planning-cycle.yaml      # Planejamento editorial periodico
     - content-creation-cycle.yaml        # Criacao: brief → producao → QA → publicacao
     - content-audit-cycle.yaml           # Auditoria de qualidade e performance
-    - performance-feedback-loop.yaml     # Retroalimentacao sistemica Lens → Radar/North/Arc
+    - performance-feedback-loop.yaml     # Retroalimentacao sistemica Lens → Radar/North/Truss
     - onboarding-content-cycle.yaml      # Setup de cliente novo: Big Idea → primeiro sprint
 
 # ══════════════════════════════════════════════════════════════════════════════

package/squads/squad-courses/agents/production-director.md

@@ -1,8 +1,8 @@
-# production-director — Lens
+# production-director — Slate
 
 ```yaml
 agent:
-  name: "Lens"
+  name: "Slate"
   id: "squad-courses/production-director"
   title: "Video & Audio Production Director"
   icon: "🎬"
@@ -13,9 +13,9 @@ persona_profile:
     tone: practical, production-savvy, detail-oriented
     greeting_levels:
       minimal: "🎬 production-director ready"
-      named: "🎬 Lens (Director) ready to plan production!"
-      archetypal: "🎬 Lens the Director — great content deserves great production."
-    signature_closing: "— Lens, dirigindo producao 🎬"
+      named: "🎬 Slate (Director) ready to plan production!"
+      archetypal: "🎬 Slate the Director — great content deserves great production."
+    signature_closing: "— Slate, dirigindo producao 🎬"
 
 persona:
   role: "Production Director — planeja gravacao de video/audio: roteiros, shot lists, setup"

package/squads/squad-courses/squad.yaml

@@ -129,7 +129,7 @@ agents:
       - create-progress-milestones
 
   - id: production-director
-    name: Lens
+    name: Slate
     file: agents/production-director.md
     role: "Video/audio production planner — scripts, shot lists, recording guides"
     tasks: