chati-dev 4.2.1 → 4.3.0

package/framework/hooks/settings.json

@@ -16,6 +16,10 @@
           {
             "type": "command",
             "command": "node chati.dev/hooks/model-governance.js"
+          },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/reasoning-escalator.js"
           }
         ]
       }
@@ -31,6 +35,29 @@
         ]
       }
     ],
+    "PostToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/advance-trigger.js"
+          },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/reference-trigger.js"
+          },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/brief-validator.js"
+          },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/post-dev.js"
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "Read",
@@ -42,7 +69,7 @@
         ]
       },
       {
-        "matcher": "Write|Edit",
+        "matcher": "Write|Edit|NotebookEdit",
         "hooks": [
           {
             "type": "command",
@@ -63,6 +90,10 @@
           {
             "type": "command",
             "command": "node chati.dev/hooks/team-quality-gate.js"
+          },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/reasoning-escalator.js"
           }
         ]
       },

package/framework/hooks/style-guard.js

@@ -6,7 +6,7 @@
  * - No em-dashes (U+2013 EN DASH, U+2014 EM DASH)
  * - No emojis in generated content
  *
- * Mode: Advisory (warn, not block). Agent receives warning and should self-correct.
+ * Mode: Em-dashes are HARD BLOCKED (deny). Emojis are advisory (warn).
  * Feature-flag gated: respects anti_dash and no_emojis in config.yaml.
  *
  * Exempt paths: framework files (chati.dev/, .chati/), YAML configs, CLAUDE.md
@@ -35,8 +35,9 @@ const EXEMPT_PATTERNS = [
   /AGENTS\.md$/,
   /\.yaml$/,
   /\.yml$/,
-  /\.json$/,
   /package\.json$/,
+  /package-lock\.json$/,
+  /tsconfig\.json$/,
   /\.lock$/,
 ];
 
@@ -97,7 +98,7 @@ async function main() {
     // Skip exempt paths
     const filePath = toolInput.file_path || '';
     if (isExemptPath(filePath, projectDir)) {
-      process.stdout.write(JSON.stringify({ decision: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
@@ -111,25 +112,63 @@ async function main() {
       result = checkBashStyle(command);
     }
 
-    if (result.violations.length > 0) {
-      // Block all style violations — agent must rewrite
-      process.stdout.write(JSON.stringify({
-        decision: 'block',
-        reason: `[Style Guard] ${result.violations.join(' ')} Rewrite without em-dashes and emojis.`,
-      }));
+    if (result.hasDash) {
+      // Em-dashes are HARD BLOCKED — they are never acceptable in project output.
+      // Use commas, semicolons, colons, or periods instead.
+      process.stdout.write(JSON.stringify(denyOutput(
+        `[Style Guard] Em-dash or en-dash detected. REWRITE without em-dashes. Use commas, semicolons, colons, or periods instead. This is non-negotiable.`
+      )));
       return;
     }
 
-    process.stdout.write(JSON.stringify({ decision: 'allow' }));
+    if (result.hasEmoji) {
+      // Emojis are advisory — warn but allow
+      process.stdout.write(JSON.stringify(allowOutput(
+        `[Style Guard] Emoji detected. Consider using icons from approved libraries instead.`
+      )));
+      return;
+    }
+
+    process.stdout.write(JSON.stringify(allowOutput()));
   } catch (err) {
     process.stderr.write(`[chati] style-guard: ${err.message}\n`);
-    process.stdout.write(JSON.stringify({ decision: 'allow' }));
+    process.stdout.write(JSON.stringify(allowOutput()));
   }
 }
 
+function denyOutput(reason) {
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'deny',
+      permissionDecisionReason: reason,
+    },
+  };
+}
+
+function allowOutput(reason) {
+  const out = {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'allow',
+    },
+  };
+  if (reason) out.hookSpecificOutput.permissionDecisionReason = reason;
+  return out;
+}
+
 export { checkStyle, checkBashStyle, isExemptPath, EM_DASH_PATTERN, EMOJI_PATTERN };
 
+// Only run main when executed directly (not imported by tests).
+// realpathSync resolves symlinks on both sides — important on macOS where
+// /tmp is a symlink to /private/tmp. Without realpath the comparison fails
+// silently and main() never runs.
 import { fileURLToPath } from 'url';
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  main();
+import { realpathSync } from 'fs';
+if (process.argv[1]) {
+  try {
+    if (realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) {
+      main();
+    }
+  } catch { /* path resolution failed — not invoked as a script */ }
 }

package/framework/hooks/team-quality-gate.js

@@ -19,18 +19,18 @@ import { join } from 'path';
 // Artifact scope per agent — defines which output paths each agent owns
 const AGENT_ARTIFACT_SCOPES = {
   detail: [
-    'chati.dev/artifacts/2-PRD/',
-    'chati.dev/artifacts/handoffs/detail-',
+    'artifacts/2-PRD/',
+    'artifacts/handoffs/detail-',
     'prd.md',
   ],
   architect: [
-    'chati.dev/artifacts/3-Architecture/',
-    'chati.dev/artifacts/handoffs/architect-',
+    'artifacts/3-Architecture/',
+    'artifacts/handoffs/architect-',
     'architecture.md',
   ],
   ux: [
-    'chati.dev/artifacts/4-UX/',
-    'chati.dev/artifacts/handoffs/ux-',
+    'artifacts/4-UX/',
+    'artifacts/handoffs/ux-',
     'ux-specification.md',
     'brandbook.md',
     'brandbook.html',
@@ -50,20 +50,27 @@ const AGENT_ARTIFACT_SCOPES = {
     'test/',
     'tests/',
     '__tests__/',
-    'chati.dev/artifacts/8-Implementation/',
-    'chati.dev/artifacts/handoffs/dev-',
+    'artifacts/8-Implementation/',
+    'artifacts/handoffs/dev-',
+  ],
+  'qa-planning': [
+    'artifacts/7-QA-Planning/',
+    'artifacts/handoffs/qa-planning',
   ],
   'qa-implementation': [
-    'chati.dev/artifacts/9-QA-Implementation/',
-    'chati.dev/artifacts/handoffs/qa-implementation-',
+    'artifacts/9-QA-Implementation/',
+    'artifacts/handoffs/qa-implementation-',
+  ],
+  'qa-visual': [
+    'artifacts/handoffs/qa-visual',
   ],
 };
 
 // Shared paths any teammate can write to
 const SHARED_PATHS = [
   '.chati/',
-  'chati.dev/artifacts/handoffs/teams/',
-  'chati.dev/artifacts/decisions/',
+  'artifacts/handoffs/teams/',
+  'artifacts/decisions/',
 ];
 
 async function main() {
@@ -79,7 +86,7 @@ async function main() {
     // Quick exit: no team active → allow everything
     const teamId = process.env.CHATI_TEAM_ID;
     if (!teamId) {
-      process.stdout.write(JSON.stringify({ result: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
@@ -87,14 +94,14 @@ async function main() {
     const currentAgent = process.env.CHATI_TEAM_MEMBER || detectAgentFromSession(projectDir);
     if (!currentAgent) {
       // Cannot determine agent → allow (fail-open for safety)
-      process.stdout.write(JSON.stringify({ result: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
     // Get the file path being written
     const filePath = event.tool_input?.file_path || '';
     if (!filePath) {
-      process.stdout.write(JSON.stringify({ result: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
@@ -103,7 +110,7 @@ async function main() {
 
     // Check shared paths first — always allowed
     if (SHARED_PATHS.some(sp => relativePath.startsWith(sp))) {
-      process.stdout.write(JSON.stringify({ result: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
@@ -112,24 +119,42 @@ async function main() {
       if (agent === currentAgent) continue;
       for (const scope of scopes) {
         if (relativePath.startsWith(scope) || (!scope.includes('/') && relativePath.endsWith(scope))) {
-          process.stdout.write(JSON.stringify({
-            result: 'block',
-            reason: `[Team Quality Gate] ${currentAgent} cannot write to ${relativePath} — this path belongs to ${agent}. Use the team mailbox to coordinate changes (Article XXI).`,
-          }));
+          process.stdout.write(JSON.stringify(denyOutput(
+            `[Team Quality Gate] ${currentAgent} cannot write to ${relativePath} — this path belongs to ${agent}. Use the team mailbox to coordinate changes (Article XXI).`
+          )));
           return;
         }
       }
     }
 
     // Path not owned by anyone specific → allow
-    process.stdout.write(JSON.stringify({ result: 'allow' }));
+    process.stdout.write(JSON.stringify(allowOutput()));
   } catch (err) {
     // Fail-open: hook errors should not block execution
     process.stderr.write(`[chati] team-quality-gate: ${err.message}\n`);
-    process.stdout.write(JSON.stringify({ result: 'allow' }));
+    process.stdout.write(JSON.stringify(allowOutput()));
   }
 }
 
+function allowOutput() {
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'allow',
+    },
+  };
+}
+
+function denyOutput(reason) {
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'deny',
+      permissionDecisionReason: reason,
+    },
+  };
+}
+
 function detectAgentFromSession(projectDir) {
   const sessionPath = join(projectDir, '.chati', 'session.yaml');
   if (!existsSync(sessionPath)) return null;
@@ -138,8 +163,16 @@ function detectAgentFromSession(projectDir) {
   return match ? match[1].trim().replace(/^["']|["']$/g, '') : null;
 }
 
-// Only run main when executed directly
+// Only run main when executed directly (not imported by tests).
+// realpathSync resolves symlinks on both sides — important on macOS where
+// /tmp is a symlink to /private/tmp. Without realpath the comparison fails
+// silently and main() never runs.
 import { fileURLToPath } from 'url';
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  main();
+import { realpathSync } from 'fs';
+if (process.argv[1]) {
+  try {
+    if (realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) {
+      main();
+    }
+  } catch { /* path resolution failed — not invoked as a script */ }
 }

package/framework/hooks/undercover-guard.js

@@ -13,7 +13,7 @@
  * What gets sanitized:
  *   - Agent names (greenfield-wu, brownfield-wu, qa-planning, etc.)
  *   - Pipeline terminology (PRISM, L0-L5, deviation protocol)
- *   - Internal paths (chati.dev/artifacts/, .chati/)
+ *   - Internal paths (artifacts/, .chati/)
  *   - Framework name references in generated code/commits
  *   - Constitution/Article references
  *   - Quality gate internals (adversarial review, devil's advocate)
@@ -44,6 +44,7 @@ const UNDERCOVER_RULES = [
   { pattern: /\bbrownfield-wu\b/gi, replacement: 'codebase analysis', category: 'agent' },
   { pattern: /\bqa-planning\b/gi, replacement: 'planning review', category: 'agent' },
   { pattern: /\bqa-implementation\b/gi, replacement: 'code review', category: 'agent' },
+  { pattern: /\bqa-visual\b/gi, replacement: 'visual review', category: 'agent' },
   { pattern: /\bdevops agent\b/gi, replacement: 'deployment', category: 'agent' },
   { pattern: /\bdev agent\b/gi, replacement: 'implementation', category: 'agent' },
   { pattern: /\bbrief agent\b/gi, replacement: 'requirements analysis', category: 'agent' },
@@ -110,7 +111,8 @@ function isExemptPath(filePath, projectDir) {
  */
 function isUndercoverEnabled(projectDir) {
   try {
-    const configPath = join(projectDir, 'chati.dev', 'config.yaml');
+    const fwDir = existsSync(join(projectDir, '.chati.dev')) ? '.chati.dev' : 'chati.dev';
+    const configPath = join(projectDir, fwDir, 'config.yaml');
     if (!existsSync(configPath)) return true;
     const raw = readFileSync(configPath, 'utf-8');
     const match = raw.match(/^\s*undercover_mode:\s*(false|no|off|0)/mi);
@@ -173,14 +175,14 @@ async function main() {
 
     // Check if undercover mode is enabled
     if (!isUndercoverEnabled(projectDir)) {
-      process.stdout.write(JSON.stringify({ decision: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
     // Skip framework-internal files
     const filePath = toolInput.file_path || '';
     if (isExemptPath(filePath, projectDir)) {
-      process.stdout.write(JSON.stringify({ decision: 'allow' }));
+      process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
 
@@ -196,25 +198,44 @@ async function main() {
 
     if (scan.found) {
       const terms = scan.matches.map(m => `"${m.term}" → "${m.replacement}"`).join(', ');
-      process.stdout.write(JSON.stringify({
-        decision: 'allow',  // Advisory — don't block, just warn
-        reason: `[Undercover] Internal references detected in output: ${terms}. Please sanitize before shipping to production. Replace internal terms with their generic equivalents.`,
-      }));
+      // Advisory only — surface findings as reason, allow operation.
+      process.stdout.write(JSON.stringify(allowOutput(
+        `[Undercover] Internal references detected: ${terms}. Sanitize before shipping. Replace internal terms with their generic equivalents.`
+      )));
       return;
     }
 
-    process.stdout.write(JSON.stringify({ decision: 'allow' }));
+    process.stdout.write(JSON.stringify(allowOutput()));
   } catch (err) {
     process.stderr.write(`[chati-hook-error] undercover-guard: ${err?.message || 'unknown'}\n`);
     // Fail-open: undercover is advisory, not security-critical
-    process.stdout.write(JSON.stringify({ decision: 'allow' }));
+    process.stdout.write(JSON.stringify(allowOutput()));
   }
 }
 
+function allowOutput(reason) {
+  const out = {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecision: 'allow',
+    },
+  };
+  if (reason) out.hookSpecificOutput.permissionDecisionReason = reason;
+  return out;
+}
+
 export { scanForInternals, scanBashForInternals, isExemptPath, isUndercoverEnabled, UNDERCOVER_RULES };
 
-// Only run main when executed directly (not imported by tests)
+// Only run main when executed directly (not imported by tests).
+// realpathSync resolves symlinks on both sides — important on macOS where
+// /tmp is a symlink to /private/tmp. Without realpath the comparison fails
+// silently and main() never runs.
 import { fileURLToPath } from 'url';
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  main();
+import { realpathSync } from 'fs';
+if (process.argv[1]) {
+  try {
+    if (realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) {
+      main();
+    }
+  } catch { /* path resolution failed — not invoked as a script */ }
 }

package/framework/i18n/en.yaml

@@ -31,7 +31,7 @@ installer:
   agents_count: "Agent definitions across DISCOVER, PLAN, BUILD, DEPLOY phases"
   workflows_count: "7 workflow blueprints"
   templates_count: "10 templates (PRD, Brownfield PRD, Architecture, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
-  constitution: "Constitution (19 Articles + Preamble)"
+  constitution: "Constitution (23 Articles + Preamble)"
   session_mgmt: "Session management system"
   quality_gates: "Quality gates (3-tier verdicts)"
   proceed: "Proceed with installation?"
@@ -39,7 +39,7 @@ installer:
   created_chati: "Created .chati/ session directory"
   created_framework: "Created chati.dev/ system directory (agents, templates, workflows)"
   created_commands: "Created .claude/commands/ (thin router)"
-  installed_constitution: "Installed Constitution (Articles I-XIX)"
+  installed_constitution: "Installed Constitution (Articles I-XXIII)"
   created_session: "Created session.yaml schema"
   created_claude_md: "Created CLAUDE.md"
   configured_mcps: "Configured MCPs:"
@@ -47,7 +47,7 @@ installer:
   agents_valid: "All agents implement 8 protocols"
   handoff_ok: "Handoff protocol: OK"
   validation_ok: "Self-validation criteria: OK"
-  constitution_ok: "Constitution: 19 articles verified"
+  constitution_ok: "Constitution: 23 articles verified"
   created_memories: "Created .chati/memories/ (Memory Layer)"
   installed_intelligence: "Installed Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 spec files verified"

package/framework/i18n/es.yaml

@@ -31,7 +31,7 @@ installer:
   agents_count: "Definiciones de agentes en las fases DISCOVER, PLAN, BUILD, DEPLOY"
   workflows_count: "7 blueprints de workflow"
   templates_count: "10 templates (PRD, PRD Brownfield, Arquitectura, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
-  constitution: "Constitucion (19 Articulos + Preambulo)"
+  constitution: "Constitucion (22 Articulos + Preambulo)"
   session_mgmt: "Sistema de gestion de sesion"
   quality_gates: "Quality gates (veredictos en 3 niveles)"
   proceed: "Proceder con la instalacion?"
@@ -39,7 +39,7 @@ installer:
   created_chati: "Creado directorio de sesion .chati/"
   created_framework: "Creado directorio del sistema chati.dev/ (agentes, templates, workflows)"
   created_commands: "Creado .claude/commands/ (enrutador)"
-  installed_constitution: "Instalada Constitucion (Articulos I-XIX)"
+  installed_constitution: "Instalada Constitucion (Artículos I-XXIII)"
   created_session: "Creado schema session.yaml"
   created_claude_md: "Creado CLAUDE.md"
   configured_mcps: "MCPs configurados:"
@@ -47,7 +47,7 @@ installer:
   agents_valid: "Todos los agentes implementan 8 protocolos"
   handoff_ok: "Protocolo de handoff: OK"
   validation_ok: "Criterios de auto-validacion: OK"
-  constitution_ok: "Constitucion: 19 articulos verificados"
+  constitution_ok: "Constitucion: 22 articulos verificados"
   created_memories: "Creado .chati/memories/ (Memory Layer)"
   installed_intelligence: "Instalada Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 archivos de spec verificados"

package/framework/i18n/fr.yaml

@@ -31,7 +31,7 @@ installer:
   agents_count: "Definitions d'agents dans les phases DISCOVER, PLAN, BUILD, DEPLOY"
   workflows_count: "7 blueprints de workflow"
   templates_count: "10 templates (PRD, PRD Brownfield, Architecture, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
-  constitution: "Constitution (19 Articles + Preambule)"
+  constitution: "Constitution (23 Articles + Preambule)"
   session_mgmt: "Systeme de gestion de session"
   quality_gates: "Quality gates (verdicts en 3 niveaux)"
   proceed: "Proceder a l'installation?"
@@ -39,7 +39,7 @@ installer:
   created_chati: "Cree le repertoire de session .chati/"
   created_framework: "Cree le repertoire du systeme chati.dev/ (agents, templates, workflows)"
   created_commands: "Cree .claude/commands/ (routeur)"
-  installed_constitution: "Installee la Constitution (Articles I-XIX)"
+  installed_constitution: "Installee la Constitution (Articles I-XXIII)"
   created_session: "Cree le schema session.yaml"
   created_claude_md: "Cree CLAUDE.md"
   configured_mcps: "MCPs configures:"
@@ -47,7 +47,7 @@ installer:
   agents_valid: "Tous les agents implementent 8 protocoles"
   handoff_ok: "Protocole de passation: OK"
   validation_ok: "Criteres d'auto-validation: OK"
-  constitution_ok: "Constitution: 19 articles verifies"
+  constitution_ok: "Constitution: 23 articles verifies"
   created_memories: "Cree .chati/memories/ (Memory Layer)"
   installed_intelligence: "Installee Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 fichiers de spec verifies"

package/framework/i18n/pt.yaml

@@ -31,7 +31,7 @@ installer:
   agents_count: "Definicoes de agentes nas fases DISCOVER, PLAN, BUILD, DEPLOY"
   workflows_count: "7 blueprints de workflow"
   templates_count: "10 templates (PRD, PRD Brownfield, Arquitetura, Task, QA Gate, Quick Brief, Brandbook, Design Tokens, Component Spec, Icon System)"
-  constitution: "Constituicao (19 Artigos + Preambulo)"
+  constitution: "Constituicao (22 Artigos + Preambulo)"
   session_mgmt: "Sistema de gerenciamento de sessao"
   quality_gates: "Quality gates (veredictos em 3 niveis)"
   proceed: "Prosseguir com a instalacao?"
@@ -39,7 +39,7 @@ installer:
   created_chati: "Criado diretorio de sessao .chati/"
   created_framework: "Criado diretorio do sistema chati.dev/ (agentes, templates, workflows)"
   created_commands: "Criado .claude/commands/ (roteador)"
-  installed_constitution: "Instalada Constituicao (Artigos I-XIX)"
+  installed_constitution: "Instalada Constituicao (Artigos I-XXIII)"
   created_session: "Criado schema session.yaml"
   created_claude_md: "Criado CLAUDE.md"
   configured_mcps: "MCPs configurados:"
@@ -47,7 +47,7 @@ installer:
   agents_valid: "Todos os agentes implementam 8 protocolos"
   handoff_ok: "Protocolo de handoff: OK"
   validation_ok: "Criterios de auto-validacao: OK"
-  constitution_ok: "Constituicao: 19 artigos verificados"
+  constitution_ok: "Constituicao: 22 artigos verificados"
   created_memories: "Criado .chati/memories/ (Memory Layer)"
   installed_intelligence: "Instalada Intelligence Layer (Context Engine, Memory, Registry)"
   intelligence_valid: "Intelligence: 6 arquivos de spec verificados"

package/framework/intelligence/context-engine.md

@@ -33,7 +33,7 @@ The orchestrator injects context through 6 hierarchical layers:
 
 | Layer | Name | Source | When Active |
 |-------|------|--------|-------------|
-| **L0** | Constitution | `chati.dev/constitution.md` (Articles I-XIX) | ALWAYS (non-negotiable) |
+| **L0** | Constitution | `chati.dev/constitution.md` (Articles I-XXIII) | ALWAYS (non-negotiable) |
 | **L1** | Mode + Global | `config.yaml` + mode governance (planning/build/deploy) | ALWAYS |
 | **L2** | Agent Scope | `chati.dev/agents/{agent}/` — mission, inputs, outputs, criteria | When agent is active |
 | **L3** | Pipeline State | `.chati/session.yaml` — pipeline position, scores, backlog | When session is active |
@@ -60,7 +60,7 @@ The orchestrator produces a structured XML block injected into agent prompts:
 ```xml
 <chati-context bracket="MODERATE">
   <constitution>
-    Articles I-XIX governing agent behavior.
+    Articles I-XXIII governing agent behavior.
     Key: Self-validation required. Loop until quality threshold.
     Guided options (1,2,3). Persistent session state.
     Two-layer handoff. Language protocol. Deviation protocol.
@@ -77,8 +77,7 @@ The orchestrator produces a structured XML block injected into agent prompts:
   </agent>
 
   <pipeline>
-    WU(100%) -> Brief(in_progress, 45%) -> Detail(pending) -> Architect(pending)
-    -> UX(pending) -> Phases(pending) -> Tasks(pending) -> QA-Planning(pending)
+    WU(100%) -> Brief(in_progress, 45%) -> [Planning Team: Detail+Architect+UX+QA-Planning](pending) -> Phases(pending) -> Tasks(pending)
   </pipeline>
 
   <task>Phase 2: Core Requirements Elicitation</task>
@@ -186,7 +185,7 @@ Memory injection follows the same progressive reinforcement principle: as contex
 
 ---
 
-*Context Engine v4.0 — Chati.dev Intelligence Layer (Progressive Reinforcement Model)*
+*Context Engine v4.3.0 — Chati.dev Intelligence Layer (Progressive Reinforcement Model)*
 
 ---
 

package/framework/intelligence/decision-engine.md

@@ -96,7 +96,7 @@ npx chati-dev health
 Checks:
 1. All registered entities exist on disk
 2. Schema files are valid JSON
-3. Constitution has >= 19 articles
+3. Constitution has >= 23 articles
 4. Agents contain required protocol references
 5. Entity count matches actual file count
 6. Checksums match (if calculated)

package/framework/intelligence/hooks-performance.md

@@ -16,7 +16,7 @@ Claude Code spawns each hook as a child process, waits for JSON output, then pro
 | PreCompact | `.*` | session-digest.js | Session state capture + auto-dream + daily digest |
 | PreToolUse | `Read` | read-protection.js | Block reading sensitive files |
 | PreToolUse | `Write\|Edit` | mode-governance.js | Write scope enforcement by phase |
-| PreToolUse | `Write\|Edit` | constitution-guard.js | Secret detection + 23 shell injection checks |
+| PreToolUse | `Write\|Edit` | constitution-guard.js | Secret detection + 21 shell injection checks |
 | PreToolUse | `Write\|Edit` | undercover-guard.js | Sanitize framework terms from deliverables |
 | PreToolUse | `Write\|Edit` | style-guard.js | Em-dash and emoji enforcement |
 | PreToolUse | `Bash` | constitution-guard.js | Destructive command + shell injection checks |
@@ -31,7 +31,7 @@ Claude Code spawns each hook as a child process, waits for JSON output, then pro
 | PreCompact | 1 | ~50-200ms | Runs rarely (context compaction). Auto-dream may add 5-10s if triggered |
 | PreToolUse (Read) | 1 | ~30ms | Minimal overhead per file read |
 | PreToolUse (Write/Edit) | 4 | ~200ms | Heaviest path. 4 sequential hooks |
-| PreToolUse (Bash) | 3 | ~150ms | 23 regex checks in constitution-guard are negligible (<5ms) |
+| PreToolUse (Bash) | 3 | ~150ms | 21 regex checks in constitution-guard are negligible (<5ms) |
 
 ## Performance Characteristics
 
@@ -42,7 +42,7 @@ Claude Code spawns each hook as a child process, waits for JSON output, then pro
 
 ## Optimization Notes
 
-1. constitution-guard's 23 shell injection regex checks run in <5ms total (all patterns compiled once)
+1. constitution-guard's 21 shell injection regex checks run in <5ms total (all patterns compiled once)
 2. undercover-guard and style-guard could be skipped in discover/plan phases (no code being written)
 3. If latency becomes noticeable, consider merging undercover-guard + style-guard into one hook (same event, similar logic)
 4. license-guard has a 5-minute ping throttle to avoid network latency on every message

package/framework/migrations/v1.0-to-v1.1.yaml

@@ -45,4 +45,4 @@ notes: |
   - Every migration is idempotent (safe to run multiple times)
   - Backup is created BEFORE any migration
   - Automatic rollback on failure
-  - User artifacts (chati.dev/artifacts/, chati.dev/intelligence/) are NEVER modified
+  - User artifacts (artifacts/, chati.dev/intelligence/) are NEVER modified

package/framework/migrations/v1.4-to-v2.0.yaml

@@ -34,17 +34,17 @@ operations:
       - .chati/checkpoints
       - .chati/decisions
       - chati.dev/data
-      - chati.dev/artifacts/0-WU
-      - chati.dev/artifacts/1-Brief
-      - chati.dev/artifacts/2-PRD
-      - chati.dev/artifacts/3-Architecture
-      - chati.dev/artifacts/4-UX
-      - chati.dev/artifacts/5-Phases
-      - chati.dev/artifacts/6-Tasks
-      - chati.dev/artifacts/7-QA-Planning
-      - chati.dev/artifacts/8-QA-Impl
-      - chati.dev/artifacts/9-Deploy
-      - chati.dev/artifacts/handoffs
+      - artifacts/0-WU
+      - artifacts/1-Brief
+      - artifacts/2-PRD
+      - artifacts/3-Architecture
+      - artifacts/4-UX
+      - artifacts/5-Phases
+      - artifacts/6-Tasks
+      - artifacts/7-QA-Planning
+      - artifacts/8-QA-Impl
+      - artifacts/9-Deploy
+      - artifacts/handoffs
 
   # 2. Create agent memory directories
   - type: create_directory

package/framework/migrations/v4.0-to-v4.1.yaml

@@ -17,8 +17,8 @@ preconditions:
     version: "4.0.0"
     message: "Requires chati.dev v4.0.0 or later"
   - type: constitution_articles
-    count: 19
-    message: "Requires Constitution with 19 Articles"
+    count: 22
+    message: "Requires Constitution with 22 Articles"
 
 backup:
   directories: