chati-dev 4.3.1 → 4.4.0

package/framework/hooks/settings.json

@@ -41,15 +41,15 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node chati.dev/hooks/advance-trigger.js"
+            "command": "node chati.dev/hooks/brief-validator.js"
           },
           {
             "type": "command",
-            "command": "node chati.dev/hooks/reference-trigger.js"
+            "command": "node chati.dev/hooks/advance-trigger.js"
           },
           {
             "type": "command",
-            "command": "node chati.dev/hooks/brief-validator.js"
+            "command": "node chati.dev/hooks/reference-trigger.js"
           },
           {
             "type": "command",
@@ -104,6 +104,10 @@
             "type": "command",
             "command": "node chati.dev/hooks/constitution-guard.js"
           },
+          {
+            "type": "command",
+            "command": "node chati.dev/hooks/git-push-authority.js"
+          },
           {
             "type": "command",
             "command": "node chati.dev/hooks/undercover-guard.js"

package/framework/hooks/style-guard.js

@@ -21,6 +21,35 @@ const EM_DASH_PATTERN = /[\u2013\u2014]/;
 /** Emoji unicode ranges (comprehensive) */
 const EMOJI_PATTERN = /[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}\u{1F900}-\u{1F9FF}\u{1FA00}-\u{1FA6F}\u{1FA70}-\u{1FAFF}\u{231A}-\u{231B}\u{23E9}-\u{23F3}\u{23F8}-\u{23FA}\u{25AA}-\u{25AB}\u{25B6}\u{25C0}\u{25FB}-\u{25FE}\u{2614}-\u{2615}\u{2648}-\u{2653}\u{267F}\u{2693}\u{26A1}\u{26AA}-\u{26AB}\u{26BD}-\u{26BE}\u{26C4}-\u{26C5}\u{26CE}\u{26D4}\u{26EA}\u{26F2}-\u{26F3}\u{26F5}\u{26FA}\u{26FD}\u{2702}\u{2705}\u{2708}-\u{270D}\u{270F}]/u;
 
+/**
+ * AI-slop phrasing (Article V: no AI-detectable writing patterns). Advisory,
+ * not a block: warn so the agent rewrites in specific, concrete language with a
+ * real voice. Tuned to the clear tells (formulaic openers, marketing filler,
+ * empty intensifiers) to keep false positives low.
+ */
+const SLOP_PHRASES = [
+  /\bdelve into\b/i,
+  /\bdive into\b/i,
+  /\bit'?s important to note\b/i,
+  /\bit is important to note\b/i,
+  /\bin today'?s (world|fast[- ]paced|digital|landscape)\b/i,
+  /\bin the realm of\b/i,
+  /\ba testament to\b/i,
+  /\bunlock (the|your) (power|potential)\b/i,
+  /\bharness the power\b/i,
+  /\belevate your\b/i,
+  /\bseamless(ly)?\b/i,
+  /\bgame[- ]?changer\b/i,
+  /\bcutting[- ]edge\b/i,
+  /\bto the next level\b/i,
+  /\blook no further\b/i,
+  /\bembark on (a|your) journey\b/i,
+  /\bsupercharge\b/i,
+  /\brevolutioniz(e|ing)\b/i,
+  /\bbest[- ]in[- ]class\b/i,
+  /\bunparalleled\b/i,
+];
+
 /**
  * Paths exempt from style enforcement.
  * Framework files, configs, and context files may legitimately contain special chars.
@@ -54,20 +83,32 @@ function isExemptPath(filePath, projectDir) {
  * @returns {{ violations: string[], hasDash: boolean, hasEmoji: boolean }}
  */
 function checkStyle(content) {
-  if (!content || typeof content !== 'string') return { violations: [], hasDash: false, hasEmoji: false };
+  if (!content || typeof content !== 'string') return { violations: [], hasDash: false, hasEmoji: false, slopPhrases: [] };
 
   const violations = [];
   const hasDash = EM_DASH_PATTERN.test(content);
   const hasEmoji = EMOJI_PATTERN.test(content);
 
+  const slopPhrases = [];
+  for (const re of SLOP_PHRASES) {
+    const m = content.match(re);
+    if (m) {
+      const hit = m[0].toLowerCase();
+      if (!slopPhrases.includes(hit)) slopPhrases.push(hit);
+    }
+  }
+
   if (hasDash) {
     violations.push('Em-dash or en-dash detected. Use commas, semicolons, colons, or periods instead (Article V).');
   }
   if (hasEmoji) {
     violations.push('Emoji detected. Use icons from approved libraries instead (Directive 1).');
   }
+  if (slopPhrases.length) {
+    violations.push(`AI-slop phrasing detected: ${slopPhrases.slice(0, 5).join(', ')}. Rewrite in specific, concrete language (Article V).`);
+  }
 
-  return { violations, hasDash, hasEmoji };
+  return { violations, hasDash, hasEmoji, slopPhrases };
 }
 
 /**
@@ -129,6 +170,14 @@ async function main() {
       return;
     }
 
+    if (result.slopPhrases && result.slopPhrases.length) {
+      // AI-slop phrasing is advisory — warn but allow so the agent rewrites.
+      process.stdout.write(JSON.stringify(allowOutput(
+        `[Style Guard] AI-slop phrasing detected (${result.slopPhrases.slice(0, 5).join(', ')}). Rewrite in specific, concrete language with a real voice. Avoid formulaic marketing filler (Article V).`
+      )));
+      return;
+    }
+
     process.stdout.write(JSON.stringify(allowOutput()));
   } catch (err) {
     process.stderr.write(`[chati] style-guard: ${err.message}\n`);
@@ -157,7 +206,7 @@ function allowOutput(reason) {
   return out;
 }
 
-export { checkStyle, checkBashStyle, isExemptPath, EM_DASH_PATTERN, EMOJI_PATTERN };
+export { checkStyle, checkBashStyle, isExemptPath, EM_DASH_PATTERN, EMOJI_PATTERN, SLOP_PHRASES };
 
 // Only run main when executed directly (not imported by tests).
 // realpathSync resolves symlinks on both sides — important on macOS where

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

@@ -83,9 +83,13 @@ async function main() {
     const event = JSON.parse(input);
     const projectDir = event.cwd || process.cwd();
 
-    // Quick exit: no team active → allow everything
-    const teamId = process.env.CHATI_TEAM_ID;
-    if (!teamId) {
+    // The env var is the fast path, but it does not always propagate to a
+    // parallel hook process. Fall back to the session file: if the env var is
+    // absent AND no team is active in session.yaml, this is genuinely solo mode
+    // and we allow. If a team IS active, we enforce isolation even without the
+    // env var, otherwise cross-member overwrites slip through unblocked.
+    const teamActive = !!process.env.CHATI_TEAM_ID || hasActiveTeamInSession(projectDir);
+    if (!teamActive) {
       process.stdout.write(JSON.stringify(allowOutput()));
       return;
     }
@@ -130,9 +134,25 @@ async function main() {
     // Path not owned by anyone specific → 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(allowOutput()));
+    // Fail CLOSED while a team is active. A crash in the write-scope guard must
+    // not silently permit cross-member overwrites during parallel team
+    // execution. Outside team mode this gate guards nothing, so a crash there
+    // allows. Re-derive team state defensively from env + session.
+    let teamActive = !!process.env.CHATI_TEAM_ID;
+    if (!teamActive) {
+      try {
+        const parsed = JSON.parse(input);
+        teamActive = hasActiveTeamInSession(parsed.cwd || process.cwd());
+      } catch { /* input unparseable: fall back to the env-only signal */ }
+    }
+    if (teamActive) {
+      process.stdout.write(JSON.stringify(denyOutput(
+        `[Team Quality Gate] internal error while enforcing team write isolation (${err.message}). Write blocked as a precaution to prevent cross-member overwrites. Retry once resolved.`
+      )));
+    } else {
+      process.stdout.write(JSON.stringify(allowOutput()));
+    }
   }
 }
 
@@ -163,6 +183,24 @@ function detectAgentFromSession(projectDir) {
   return match ? match[1].trim().replace(/^["']|["']$/g, '') : null;
 }
 
+/**
+ * Detect whether a team is active from session.yaml alone, for the case where
+ * CHATI_TEAM_ID did not propagate to this hook process. An active team is an
+ * entry in teams[] whose status is forming, active or
+ * completing. preview.status uses a different vocabulary (inactive/running/
+ * approved/adjusting), so matching these specific values is team-specific.
+ */
+function hasActiveTeamInSession(projectDir) {
+  const sessionPath = join(projectDir, '.chati', 'session.yaml');
+  if (!existsSync(sessionPath)) return false;
+  try {
+    const raw = readFileSync(sessionPath, 'utf-8');
+    return /team_id:\s*\S/.test(raw) && /^\s*status:\s*(active|forming|completing)\b/m.test(raw);
+  } catch {
+    return false;
+  }
+}
+
 // 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

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 (23 Articles + Preamble)"
+  constitution: "Constitution (25 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-XXIII)"
+  installed_constitution: "Installed Constitution (Articles I-XXV)"
   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: 23 articles verified"
+  constitution_ok: "Constitution: 25 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 (22 Articulos + Preambulo)"
+  constitution: "Constitucion (25 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 (Artículos I-XXIII)"
+  installed_constitution: "Instalada Constitucion (Artículos I-XXV)"
   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: 22 articulos verificados"
+  constitution_ok: "Constitucion: 25 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 (23 Articles + Preambule)"
+  constitution: "Constitution (25 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-XXIII)"
+  installed_constitution: "Installee la Constitution (Articles I-XXV)"
   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: 23 articles verifies"
+  constitution_ok: "Constitution: 25 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 (22 Artigos + Preambulo)"
+  constitution: "Constituicao (25 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-XXIII)"
+  installed_constitution: "Instalada Constituicao (Artigos I-XXV)"
   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: 22 artigos verificados"
+  constitution_ok: "Constituicao: 25 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/confidence.yaml

@@ -1,11 +1,22 @@
 # Intelligence Layer — Agent Confidence Calibration
-# Tracks agent performance across technologies and patterns
-# Updated after each execution
-# NEVER overwritten during upgrades
+# Tracks agent performance across technologies and patterns.
+# Updated after each execution (the agent appends real results here).
+# NEVER overwritten during upgrades.
+#
+# calibration_status:
+#   seed         — initial estimate, NOT measured from real runs. Treat as a
+#                  prior, not evidence. Replaced by measured values after runs.
+#   uncalibrated — no data yet. overall is null until the agent has run enough
+#                  times to calibrate. Do not treat the absence of a number as
+#                  low confidence; it means unknown.
+#   calibrated   — overall and breakdowns reflect measured results across runs.
+#
+# Every pipeline agent has an entry so it has a place to accrue calibration.
 
 confidence:
   dev:
     overall: 0.90
+    calibration_status: seed
     by_technology:
       react: 0.92
       nextjs: 0.88
@@ -17,10 +28,11 @@ confidence:
       crud_operations: 0.95
       form_handling: 0.92
       api_design: 0.88
-    last_calibrated: "2026-02-07"
+    last_calibrated: null
 
   architect:
     overall: 0.88
+    calibration_status: seed
     by_technology:
       react: 0.90
       nextjs: 0.87
@@ -30,13 +42,80 @@ confidence:
       monolith: 0.92
       microservices: 0.80
       serverless: 0.78
-    last_calibrated: "2026-02-07"
+    last_calibrated: null
 
   qa-implementation:
     overall: 0.92
+    calibration_status: seed
     by_category:
       test_execution: 0.95
       security_scan: 0.90
       code_review: 0.88
       acceptance_verification: 0.93
-    last_calibrated: "2026-02-07"
+    last_calibrated: null
+
+  # Uncalibrated: every other pipeline agent. overall stays null until measured.
+  greenfield-wu:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  brownfield-wu:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  brief:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  detail:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  architect-system:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  architect-data-engineer:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  ux:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  ux-brand-architect:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  ux-component-engineer:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  ux-researcher:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  phases:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  tasks:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  qa-planning:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  qa-visual:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  visualizer:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null
+  devops:
+    overall: null
+    calibration_status: uncalibrated
+    last_calibrated: null

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-XXIII) | ALWAYS (non-negotiable) |
+| **L0** | Constitution | `chati.dev/constitution.md` (Articles I-XXV) | 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 |
@@ -42,7 +42,7 @@ The orchestrator injects context through 6 hierarchical layers:
 
 ### Layer Activation by Bracket
 
-| Bracket | Active Layers | Budget Ratio | Claude (200K) | Gemini (1M) | Codex (128K) |
+| Bracket | Active Layers | Budget Ratio | Claude (1M) | Gemini (1M) | Codex (128K) |
 |---------|--------------|-------------|---------------|-------------|--------------|
 | FRESH | L0, L1 | 1.5% | 3,000 | 15,000 | 1,920 |
 | MODERATE | L0, L1, L2, L3 | 2.5% | 5,000 | 25,000 | 3,200 |
@@ -60,7 +60,7 @@ The orchestrator produces a structured XML block injected into agent prompts:
 ```xml
 <chati-context bracket="MODERATE">
   <constitution>
-    Articles I-XXIII governing agent behavior.
+    Articles I-XXV 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.
@@ -116,7 +116,7 @@ estimatedTokens = promptText.length / 4
 remainingPercent = (1 - estimatedTokens / providerLimit) * 100
 ```
 
-This replaces the legacy heuristic (`turnCount / maxTurns`) which was inaccurate for sessions with large tool results or long agent outputs. The token-based approach scales correctly across providers (Claude 200K, Gemini 1M, Codex 128K).
+This replaces the legacy heuristic (`turnCount / maxTurns`) which was inaccurate for sessions with large tool results or long agent outputs. The token-based approach scales correctly across providers (Claude 1M, Gemini 1M, Codex 128K).
 
 Fallback: If prompt text is unavailable, the turn-count heuristic is used.
 
@@ -150,11 +150,15 @@ If Smart Continuation is insufficient, the orchestrator spawns a new session:
 
 | Condition | Threshold | Rationale |
 |-----------|-----------|-----------|
+| BUILD phase + DEPLETED/CRITICAL | Immediate (default to Level 2) | During code generation a depleted window produces regressions faster than a reset costs; a clean slate beats in-place compaction |
 | Multiple compactions | 3+ in single session | Context is churning too fast |
 | Post-compact quality | Agent score drops >15% | Compaction lost critical context |
 | Critical bracket persists | CRITICAL for 3+ consecutive interactions | Recovery not working |
+| Echo loop detected | 2+ echo entries in the current phase (session.yaml decision_trail) | The model is looping; a fresh session breaks the cycle |
 | Agent handoff pending | Current agent done, next agent needs fresh context | Clean start is better |
 
+**BUILD-phase reset preference:** During the BUILD phase, when the active agent reaches DEPLETED or CRITICAL, the orchestrator defaults to Level 2 (Autonomous Session Spawn, a clean reset) rather than Level 1 (Smart Continuation, in-place compaction). Compaction preserves continuity but not a clean slate, so the model can keep wrapping up work prematurely while code is being written; a reset carrying a full handoff is safer there. Level 1 stays the default for the MODERATE bracket and for the DISCOVER and PLAN phases.
+
 ### IDE-Specific Behavior
 
 | IDE | Level 1 | Level 2 |
@@ -185,7 +189,7 @@ Memory injection follows the same progressive reinforcement principle: as contex
 
 ---
 
-*Context Engine v4.3.0 — Chati.dev Intelligence Layer (Progressive Reinforcement Model)*
+*Context Engine v4.4.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 >= 23 articles
+3. Constitution has >= 25 articles
 4. Agents contain required protocol references
 5. Entity count matches actual file count
 6. Checksums match (if calculated)

package/framework/orchestrator/chati-router.js

@@ -192,7 +192,7 @@ const VALID_ORCHESTRATE_SUBS = new Set([
   'qa-plan-score', 'qa-impl-score', 'qa-visual-score', 'scan',
   'spawn-team', 'team-status', 'team-dissolve',
   'wait-for-capture', 'wave-status', 'assess-coverage',
-  'wait-for-license', 'doctor',
+  'wait-for-license', 'doctor', 'run-script-task',
 ]);
 
 /**

package/framework/orchestrator/chati-update.md

@@ -10,7 +10,7 @@ You are the **Chati Update Agent**, a specialized evolution advisor for the chat
 
 1. **NEVER copy blindly** - Adapt concepts to chati.dev's identity and patterns
 2. **NEVER break existing tests** - All tests must continue passing (run `npm test` to verify)
-3. **NEVER violate the constitution** - 23 articles are sacred
+3. **NEVER violate the constitution** - 25 articles are sacred
 4. **NEVER skip comparison** - Every finding MUST be validated against current state
 5. **ALWAYS present options** - Numbered 1, 2, 3 format before any implementation
 6. **ALWAYS use sub-agents** - Parallelize SCAN and COMPARE for throughput
@@ -102,7 +102,7 @@ Launch **in parallel** with Phase 1 a **Task agent (subagent_type=Explore, thoro
 Map the COMPLETE current state of chati.dev. Analyze:
 
 1. **CONSTITUTION** - Read chati.dev/constitution.md fully. Extract:
-   - All 23 articles with key rules
+   - All 25 articles with key rules
    - Quality thresholds
    - Governance patterns
 
@@ -247,7 +247,7 @@ Use `/ralph-loop` with the following prompt structure:
 
 REQUIREMENTS:
 1. Implement each change following chati.dev patterns and conventions
-2. Respect the constitution (23 articles) - especially originality
+2. Respect the constitution (25 articles) - especially originality
 3. Update relevant tests for each change
 4. Run full test suite after each change - ALL must pass
 5. Run lint after each change - must be clean
@@ -300,6 +300,22 @@ After ralph-wiggum completes, generate final report:
 
 ---
 
+## Phase 7: MODEL-HARNESS PARITY (Article XXIV)
+
+This step runs whether the update was triggered by a reference comparison or by a model change.
+
+1. **Re-baseline the model.** Record the current model as the audited one so the parity advisory clears:
+   - set `session.model_at_last_audit = session.active_model`
+   Write this through the session manager (the CLI-managed path), never by editing `.chati/session.yaml` directly.
+
+2. **Model-change audit checklist.** When the model family changed, re-check the parts of the harness whose calibration is model-dependent, and keep the model-agnostic parts:
+   - Context bracket token budgets (Article XII, `context-engine.md`): are the FRESH/MODERATE/DEPLETED/CRITICAL boundaries still right for the new window size?
+   - Agent confidence calibration (`intelligence/confidence.yaml`): re-calibrate after a few real runs on the new model.
+   - Load-bearing agents: is any scaffolding agent now redundant because the new model does that step natively? Is any new capability worth a new agent?
+   - Keep unchanged: the Articles, the quality gates and thresholds, the registry. These are model-agnostic.
+
+---
+
 ## Error Handling
 
 - **Clone fails**: Ask user for correct URL/path, suggest alternatives

package/framework/orchestrator/chati.md

@@ -229,6 +229,24 @@ Quality gate passed: {score}%.
 
 ---
 
+## Action: Script Task (Execution Kinds)
+
+When the `execution_kinds` feature is on and the next task's `execution_kind` is
+not `agent`, route it here instead of spawning an agent. When the feature is off
+or the kind is `agent`, skip this entirely and use the normal agent path. This
+is purely a dispatch optimization: it never changes WHAT a task must achieve,
+only what executes it, and it is invisible when the feature is off.
+
+- **script**: run it deterministically with no LLM. Via Bash:
+  `node .chati.dev/orchestrator/chati-router.js run-script-task --ref "{execution_ref}" --id "{task_id}" --title "{task_title}"`
+  Handle the JSON `status`:
+  - `passed` → the task is done. Advance: `node .chati.dev/orchestrator/chati-router.js advance --agent {current_agent} --score 100`
+  - `failed` → the deterministic check is negative. Route to dev (Fault Vector Protocol: CODE) to fix, then re-run the script task.
+  - `error` → the executor could not run. Surface the summary to the user and check the execution_ref against the executor registry.
+  - `ran: false` → the feature is off or the kind is not script; fall back to the agent path silently.
+- **human**: present the decision in the user's language as a Guided Option and wait for their choice. Record it, then advance. Never decide for them.
+- **specialist**: reserved; today, run it through the normal agent path.
+
 ## Action: Autonomous Agent
 
 These agents run in separate Claude Code processes.
@@ -790,7 +808,7 @@ interactive (default):
   → All 8 universal protocols apply.
 
 autonomous (Ralph Wiggum mode):
-  → Requires: most recent QA gate score >= 95% (Article XVIII prerequisite).
+  → Requires: most recent QA gate score >= 95% (Article XVII prerequisite).
   → If quality gate not met, inform user and suggest guided mode instead.
   → Agent executes without asking unless blocker encountered.
   → Primarily for Dev agent during BUILD phase.

package/framework/quality-gates/planning-gate.md

@@ -34,6 +34,8 @@ QA-Planning
 | Agent defined weak criteria | -10 |
 
 ## Decision
+Thresholds are canonical in `chati.dev/data/qa-rubrics.yaml` (thresholds.qa-planning); the values below must match that file.
+
 - **Score >= 95**: APPROVED -> proceed to BUILD
 - **Score < 95**: Silent correction loop (max 3 per agent)
 - **Still < 95 after loops**: ESCALATE to user

package/framework/scaffold/motion-premium/scaffold.yaml

@@ -15,11 +15,12 @@ framework:
   chati_dev: ">=4.3.0"
 
 stack:
-  build_tools: ["nextjs", "react-vite"]
+  build_tools: ["nextjs"]
   tailwind: ">=4.0.0"
   typescript: ">=5.0.0"
   node: ">=18.0.0"
   react: ">=18.0.0"
+  next: ">=13.0.0"
   # Runtime peer deps imported directly by templates. Bumping policy: every two
   # minor bumps, re-validate templates. GSAP 3.12 is the stable line post-3.11;
   # framer-motion 11 is the React 19 support line; lenis 1.1 introduced the

package/framework/scaffold/motion-premium-3d/components/webgl/WebGLContext.tsx.template

@@ -24,7 +24,7 @@ import { detectWebGL, type WebGLAvailability } from '@/lib/webgl/detect';
 
 export interface WebGLContextValue {
   status: 'pending' | 'available' | 'unavailable';
-  reason: WebGLAvailability extends { reason: infer R } ? R | null : null;
+  reason: Extract<WebGLAvailability, { available: false }>['reason'] | null;
   webglVersion: 1 | 2 | null;
 }