chati-dev 4.2.0 → 4.2.1

package/framework/config.yaml

@@ -1,8 +1,8 @@
 # chati.dev Configuration
-version: "4.2.0"
+version: "4.2.1"
 installed_at: "2026-02-07T10:00:00Z"
 updated_at: "2026-04-11T00:00:00Z"
-installer_version: "4.2.0"
+installer_version: "4.2.1"
 project_type: greenfield
 language: en
 ides: [claude-code]

package/framework/constitution.md

@@ -755,6 +755,7 @@ If any check is NO, the compliance block itself is an ERROR and the report canno
 
 ---
 
-*Chati.dev Constitution v4.2.0 — 22 Articles + Preamble*
+*Chati.dev Constitution v4.2.1 — 22 Articles + Preamble*
 *v4.2.0 Amendments: Article V amended (Team Communication); Article VIII amended (Team Handoff Envelope); Article XII amended (PRISM L6 Team Roster); Article XXI added (Agent Teams Governance); Article XXII added (Fault Vector Protocol)*
+*v4.2.1 Fixes: installer refactor (recursive copy), features block in config, context files sync*
 *All agents are bound by this Constitution. Violations are enforced per article.*

package/framework/context/governance.md

@@ -1,6 +1,6 @@
 # Chati.dev Governance Rules
 
-Extracted from `chati.dev/constitution.md` (19 Articles). Read the full constitution for complete rules.
+Extracted from `chati.dev/constitution.md` (22 Articles). Read the full constitution for complete rules.
 
 ## Mode Governance (Article XI)
 - **3 modes**: planning (read all, write chati.dev/ only), build (full access), deploy (full + infra)
@@ -50,3 +50,26 @@ Extracted from `chati.dev/constitution.md` (19 Articles). Read the full constitu
 - Provider selected at install time, auto-configures optimal models per agent
 - Resolution chain: agent_overrides > agent default > primary provider
 - Context files auto-generated for non-Claude providers (GEMINI.md, AGENTS.md)
+
+## Anti-Loop Protocol (Article XX)
+- 3-Strike Rule: 3 edits to same file without resolution = STOP
+- Mandatory Diagnosis Mode: read complete file, trace path, root cause in one sentence
+- Paradigm Change required after diagnosis (CSS failed → try JavaScript, etc.)
+- Escalation after 5 total attempts: present honestly, ask for direction
+- Task score capped at 0% for violations
+
+## Agent Teams Governance (Article XXI)
+- Feature-flagged (`agent_teams: true` in config.yaml), defaults to OFF
+- 2 canonical teams: Planning Team (Detail+Architect+UX) and Build Team (Dev+QA)
+- Only orchestrator can form/dissolve teams
+- Intra-team communication via Team Mailbox (Article V amendment)
+- Cross-team communication still orchestrator-mediated
+- Team Quality Gate: all tasks complete + scores pass + mailbox clean
+- Max 2 Team Correction Cycles before degraded dissolution
+- Graceful fallback to sequential pipeline when unavailable (Gemini/Codex/flag off)
+
+## Fault Vector Protocol (Article XXII)
+- Root Layer Routing: classify fault origin (INTENT/SPEC/CODE/DEFER) before correction
+- Evidence-Bound Verdicts: ERROR findings require tool evidence (lint/typecheck/test/screenshot)
+- Decision Trail: append-only log of known-bad states to prevent cyclical re-introduction
+- Echo Detection: content-similarity matching to detect same defect reappearing across review cycles

package/framework/context/quality.md

@@ -5,7 +5,8 @@
 |-------|--------------|
 | qa-planning | 95% |
 | qa-implementation | 95% |
-| All others | 90% |
+| Standard agents | 90% |
+| Discovery agents (WU, brief) | 85% |
 
 ## Review Range
 Scores within 5 points below threshold trigger REVIEW (human confirmation required even in autonomous mode).
@@ -26,3 +27,15 @@ Scores within 5 points below threshold trigger REVIEW (human confirmation requir
 ## Blocker Taxonomy
 - **C01-C15**: Code blockers (technical)
 - **G01-G08**: General blockers (process, communication, dependency)
+
+## Fault Vector Protocol (Article XXII)
+- **Root Layer Routing**: INTENT (requirement wrong) -> Brief/Detail | SPEC (spec wrong) -> Architect/Tasks | CODE (implementation wrong) -> Dev | DEFER (out of scope) -> Backlog
+- **Evidence-Bound Verdicts**: ERROR/WARNING require tool evidence. Without evidence -> downgraded to SUGGESTION (non-blocking)
+- **Decision Trail**: Known-bad states logged in session.yaml `decision_trail[]`. Agents read before iterating.
+- **Echo Detection**: Similarity >= 0.85 with prior Decision Trail entry = ECHO. Escalate immediately, no more automated loops.
+- **FVP Compliance Checklist**: Mandatory in every QA correction report
+
+## Team Quality Gate (Article XXI)
+- All team tasks complete + all scores pass tier threshold + mailbox clean
+- Max 2 Team Correction Cycles before degraded dissolution
+- Team score = average of member task scores

package/framework/context/root.md

@@ -1,10 +1,11 @@
 # Chati.dev System Context
 
 ## Framework
-- **Version**: 4.1.6
+- **Version**: 4.2.1
 - **Agents**: Specialized agents across DISCOVER, PLAN, BUILD, DEPLOY phases
-- **Constitution**: 19 Articles + Preamble
-- **Quality**: 5 pipeline gates + 3-tier verdicts (APPROVED / NEEDS_REVISION / BLOCKED)
+- **Constitution**: 22 Articles + Preamble
+- **Quality**: 5 pipeline gates + 3-tier verdicts + Fault Vector Protocol (Article XXII)
+- **Agent Teams**: Native Claude Code teams with peer communication (Article XXI, feature-flagged)
 
 ## Key References
 - **Session State**: `.chati/session.yaml` (runtime — not committed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chati-dev",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "AI-Powered Multi-Agent Orchestration System — Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {

package/scripts/validate-package.js

@@ -166,6 +166,114 @@ function checkBinExists(packageRoot, results) {
   }
 }
 
+/**
+ * Validate that every hook referenced in hooks/settings.json exists on disk.
+ * Prevents shipping a bundle where settings.json references a hook file that
+ * was never copied.
+ */
+function checkHooksParity(packageRoot, results) {
+  results.checks++;
+  const settingsPath = join(packageRoot, 'framework', 'hooks', 'settings.json');
+  if (!existsSync(settingsPath)) {
+    results.warnings.push('framework/hooks/settings.json not found — skipping hooks parity check.');
+    results.passed++;
+    return;
+  }
+
+  try {
+    const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+    const missing = new Set();
+    const hooksDir = join(packageRoot, 'framework', 'hooks');
+
+    // Walk all hook events and collect referenced .js files
+    for (const event of Object.keys(settings.hooks || {})) {
+      for (const matcher of settings.hooks[event] || []) {
+        for (const hook of matcher.hooks || []) {
+          if (hook.type === 'command' && typeof hook.command === 'string') {
+            // command format: "node chati.dev/hooks/foo.js"
+            const match = hook.command.match(/hooks\/([^\s]+\.js)/);
+            if (match) {
+              const hookFile = match[1];
+              if (!existsSync(join(hooksDir, hookFile))) {
+                missing.add(hookFile);
+              }
+            }
+          }
+        }
+      }
+    }
+
+    if (missing.size === 0) {
+      results.passed++;
+    } else {
+      results.errors.push(`Hooks referenced in settings.json but missing from framework/hooks/: ${[...missing].join(', ')}`);
+    }
+  } catch (err) {
+    results.errors.push(`Failed to parse hooks/settings.json: ${err.message}`);
+  }
+}
+
+/**
+ * Parity check: every file in source chati.dev/ (that belongs to a copied
+ * directory) must exist in framework/. Catches bundling bugs where new files
+ * are added to the source but not included in the bundle.
+ *
+ * Only runs when the monorepo source is available (skipped inside the
+ * published package since the source is not shipped).
+ */
+function checkSourceBundleParity(packageRoot, results) {
+  results.checks++;
+  const monorepoSource = join(packageRoot, '..', '..', 'chati.dev');
+  const bundleDir = join(packageRoot, 'framework');
+
+  if (!existsSync(monorepoSource)) {
+    // Running inside the published package — skip (nothing to compare against)
+    results.passed++;
+    return;
+  }
+
+  // Collect all files in source, grouped by the top-level directory
+  const missing = [];
+  const COPIED_DIRS = [
+    'orchestrator', 'agents', 'templates', 'workflows', 'quality-gates',
+    'schemas', 'frameworks', 'intelligence', 'patterns', 'hooks',
+    'domains', 'i18n', 'migrations', 'data', 'context', 'tasks', 'presets',
+  ];
+  const COPIED_ROOT_FILES = ['constitution.md'];
+
+  function walk(srcDir, relBase) {
+    if (!existsSync(srcDir)) return;
+    for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
+      const srcPath = join(srcDir, entry.name);
+      const relPath = relBase ? `${relBase}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) {
+        walk(srcPath, relPath);
+      } else if (entry.isFile()) {
+        const bundlePath = join(bundleDir, relPath);
+        if (!existsSync(bundlePath)) missing.push(relPath);
+      }
+    }
+  }
+
+  for (const file of COPIED_ROOT_FILES) {
+    const src = join(monorepoSource, file);
+    const bundled = join(bundleDir, file);
+    if (existsSync(src) && !existsSync(bundled)) missing.push(file);
+  }
+
+  for (const dir of COPIED_DIRS) {
+    walk(join(monorepoSource, dir), dir);
+  }
+
+  if (missing.length === 0) {
+    results.passed++;
+  } else {
+    const sample = missing.slice(0, 10).join(', ');
+    const more = missing.length > 10 ? ` (+ ${missing.length - 10} more)` : '';
+    results.errors.push(`Files in source chati.dev/ missing from framework/ bundle: ${sample}${more}`);
+  }
+}
+
 /**
  * Compare entity count in registry vs actual files in framework/.
  */
@@ -216,6 +324,8 @@ export function validatePackage(packageRoot) {
   checkExportsResolve(packageRoot, results);
   checkBinExists(packageRoot, results);
   checkEntityCount(packageRoot, results);
+  checkHooksParity(packageRoot, results);
+  checkSourceBundleParity(packageRoot, results);
 
   return results;
 }

package/src/installer/core.js

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync, copyFileSync, existsSync, readFileSync } from 'fs';
+import { mkdirSync, writeFileSync, copyFileSync, existsSync, readFileSync, readdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { IDE_CONFIGS, IDE_TO_PROVIDER } from '../config/ide-configs.js';
@@ -146,144 +146,103 @@ export async function installFramework(config) {
 }
 
 /**
- * Copy framework files from the Chati.dev source directory
+ * Framework directories to copy recursively from source to target.
+ * This list controls WHICH top-level directories under chati.dev/ get copied.
+ * Everything inside each directory is copied automatically — no need to
+ * enumerate individual files.
+ *
+ * New files added to the source framework are picked up automatically.
  */
-export function copyFrameworkFiles(destDir, provider = 'claude') {
-  if (!existsSync(FRAMEWORK_SOURCE)) return;
-
-  const filesToCopy = [
-    'constitution.md',
-    'orchestrator/chati.md',
-    // DISCOVER agents
-    'agents/discover/greenfield-wu.md',
-    'agents/discover/brownfield-wu.md',
-    'agents/discover/brief.md',
-    // PLAN agents
-    'agents/plan/detail.md',
-    'agents/plan/architect.md',
-    'agents/plan/architect-system.md',
-    'agents/plan/architect-data-engineer.md',
-    'agents/plan/ux.md',
-    'agents/plan/ux-brand-architect.md',
-    'agents/plan/ux-researcher.md',
-    'agents/plan/ux-component-engineer.md',
-    'agents/plan/phases.md',
-    'agents/plan/tasks.md',
-    // Quality agents
-    'agents/quality/qa-planning.md',
-    'agents/quality/qa-implementation.md',
-    // BUILD + DEPLOY agents
-    'agents/build/dev.md',
-    'agents/deploy/devops.md',
-    // Templates
-    'templates/prd-tmpl.yaml',
-    'templates/brownfield-prd-tmpl.yaml',
-    'templates/fullstack-architecture-tmpl.yaml',
-    'templates/task-tmpl.yaml',
-    'templates/qa-gate-tmpl.yaml',
-    'templates/quick-brief-tmpl.yaml',
-    'templates/brandbook-tmpl.yaml',
-    'templates/brandbook-html-tmpl.md',
-    'templates/design-token-tmpl.yaml',
-    'templates/component-spec-tmpl.yaml',
-    'templates/icon-system-tmpl.yaml',
-    'templates/session-memory-tmpl.yaml',
-    // Workflows
-    'workflows/greenfield-fullstack.yaml',
-    'workflows/brownfield-fullstack.yaml',
-    'workflows/brownfield-discovery.yaml',
-    'workflows/brownfield-service.yaml',
-    'workflows/brownfield-ui.yaml',
-    'workflows/quick-flow.yaml',
-    'workflows/standard-flow.yaml',
-    // Quality gates
-    'quality-gates/planning-gate.md',
-    'quality-gates/implementation-gate.md',
-    // Schemas
-    'schemas/session.schema.json',
-    'schemas/config.schema.json',
-    'schemas/task.schema.json',
-    'schemas/context.schema.json',
-    'schemas/memory.schema.json',
-    // Frameworks
-    'frameworks/quality-dimensions.yaml',
-    'frameworks/decision-heuristics.yaml',
-    // Intelligence
-    'intelligence/gotchas.yaml',
-    'intelligence/patterns.yaml',
-    'intelligence/confidence.yaml',
-    'intelligence/context-engine.md',
-    'intelligence/memory-layer.md',
-    'intelligence/decision-engine.md',
-    // Patterns
-    'patterns/elicitation.md',
-    'patterns/elicitation-library.yaml',
-    // Hooks
-    'hooks/prism-engine.js',
-    'hooks/mode-governance.js',
-    'hooks/constitution-guard.js',
-    'hooks/session-digest.js',
-    'hooks/model-governance.js',
-    'hooks/settings.json',
-    'hooks/read-protection.js',
-    // Domains (PRISM Context Engine)
-    'domains/constitution.yaml',
-    'domains/global.yaml',
-    'domains/agents/orchestrator.yaml',
-    'domains/agents/greenfield-wu.yaml',
-    'domains/agents/brownfield-wu.yaml',
-    'domains/agents/brief.yaml',
-    'domains/agents/detail.yaml',
-    'domains/agents/architect.yaml',
-    'domains/agents/ux.yaml',
-    'domains/agents/phases.yaml',
-    'domains/agents/tasks.yaml',
-    'domains/agents/qa-planning.yaml',
-    'domains/agents/qa-implementation.yaml',
-    'domains/agents/dev.yaml',
-    'domains/agents/devops.yaml',
-    'domains/workflows/greenfield-fullstack.yaml',
-    'domains/workflows/brownfield-fullstack.yaml',
-    'domains/workflows/brownfield-discovery.yaml',
-    'domains/workflows/brownfield-service.yaml',
-    'domains/workflows/brownfield-ui.yaml',
-    'domains/workflows/quick-flow.yaml',
-    'domains/workflows/standard-flow.yaml',
-    // i18n
-    'i18n/en.yaml',
-    'i18n/pt.yaml',
-    'i18n/es.yaml',
-    'i18n/fr.yaml',
-    // Migrations
-    'migrations/v1.0-to-v1.1.yaml',
-    // Data
-    'data/entity-registry.yaml',
-    // Context (@ import chain for CLAUDE.md)
-    'context/root.md',
-    'context/governance.md',
-    'context/protocols.md',
-    'context/quality.md',
-  ];
-
-  for (const file of filesToCopy) {
-    const src = join(FRAMEWORK_SOURCE, file);
-    const dest = join(destDir, file);
+const FRAMEWORK_DIRS_TO_COPY = [
+  'orchestrator',
+  'agents',
+  'templates',
+  'workflows',
+  'quality-gates',
+  'schemas',
+  'frameworks',
+  'intelligence',
+  'patterns',
+  'hooks',
+  'domains',
+  'i18n',
+  'migrations',
+  'data',
+  'context',
+  'tasks',
+  'presets',
+];
 
-    if (existsSync(src)) {
-      createDir(dirname(dest));
+/**
+ * Loose files at the root of chati.dev/ that get copied directly.
+ */
+const FRAMEWORK_ROOT_FILES = [
+  'constitution.md',
+];
 
-      if (provider !== 'claude' && ADAPTABLE_FILES.has(file)) {
+/**
+ * Recursively copy a directory from source to destination, applying provider
+ * adaptation for files listed in ADAPTABLE_FILES when the provider is not Claude.
+ */
+function copyDirRecursive(srcDir, destDir, provider, relBase = '') {
+  if (!existsSync(srcDir)) return;
+  createDir(destDir);
+
+  const entries = readdirSync(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry.name);
+    const destPath = join(destDir, entry.name);
+    const relPath = relBase ? join(relBase, entry.name) : entry.name;
+
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath, provider, relPath);
+    } else if (entry.isFile()) {
+      if (provider !== 'claude' && ADAPTABLE_FILES.has(relPath)) {
         // Non-Claude provider: read, adapt, write
-        const content = readFileSync(src, 'utf-8');
-        writeFileSync(dest, adaptFrameworkFile(content, file, provider), 'utf-8');
+        const content = readFileSync(srcPath, 'utf-8');
+        writeFileSync(destPath, adaptFrameworkFile(content, relPath, provider), 'utf-8');
       } else {
         // Claude or non-adaptable: direct copy
-        copyFileSync(src, dest);
+        copyFileSync(srcPath, destPath);
       }
     }
   }
 }
 
+/**
+ * Copy framework files from the Chati.dev source directory.
+ *
+ * Uses recursive directory copy instead of a hardcoded file list, so that
+ * new files added to the framework source are automatically picked up.
+ *
+ * @param {string} destDir - Target framework directory (e.g., {project}/chati.dev/)
+ * @param {string} provider - Primary provider for text adaptation ('claude' | 'gemini' | 'codex')
+ */
+export function copyFrameworkFiles(destDir, provider = 'claude') {
+  if (!existsSync(FRAMEWORK_SOURCE)) return;
+
+  // Copy loose root files
+  for (const file of FRAMEWORK_ROOT_FILES) {
+    const src = join(FRAMEWORK_SOURCE, file);
+    if (!existsSync(src)) continue;
+    const dest = join(destDir, file);
+    createDir(dirname(dest));
+    if (provider !== 'claude' && ADAPTABLE_FILES.has(file)) {
+      const content = readFileSync(src, 'utf-8');
+      writeFileSync(dest, adaptFrameworkFile(content, file, provider), 'utf-8');
+    } else {
+      copyFileSync(src, dest);
+    }
+  }
+
+  // Copy each framework directory recursively
+  for (const dir of FRAMEWORK_DIRS_TO_COPY) {
+    const srcDir = join(FRAMEWORK_SOURCE, dir);
+    const destSubDir = join(destDir, dir);
+    copyDirRecursive(srcDir, destSubDir, provider, dir);
+  }
+}
+
 /**
  * Configure a specific IDE
  */

package/src/installer/templates.js

@@ -108,6 +108,40 @@ export function generateConfigYaml(config) {
     },
   };
 
+  // Feature flags (Intelligence Upgrade + Article XXI Agent Teams)
+  // Must match source chati.dev/config.yaml features block.
+  configData.features = {
+    hybrid_budget: true,
+    anti_dash: true,
+    rate_limiter_integration: true,
+    l5_keywords: true,
+    prompt_size_guard: true,
+    ids_decision_engine: true,
+    surface_criteria: true,
+    parallel_fallback: true,
+    tool_mesh: true,
+    tech_presets: true,
+    doctor_autofix: true,
+    brandbook: true,
+    // Intelligence Upgrade (v4.0.5 — Claude Code patterns)
+    undercover_mode: true,
+    memory_extraction: true,
+    memory_consolidation: true,
+    daily_digest: true,
+    structured_session_memory: true,
+    static_prism_boundary: true,
+    token_bracket_estimation: true,
+    model_fallback: true,
+    frustration_detection: true,
+    bash_security_checks: true,
+    // Agent Teams (v4.2.0 — Article XXI)
+    agent_teams: false,
+    team_planning_size: 3,
+    team_build_size: 2,
+    team_echo_threshold: 0.92,
+    team_correction_cycles_max: 2,
+  };
+
   // Add telemetry config
   configData.telemetry = {
     enabled: config.telemetryEnabled !== false,