chati-dev 4.2.1 → 4.3.0

package/framework/data/entity-registry.yaml

@@ -3,9 +3,9 @@
 # and by the Health Check for system integrity validation.
 
 metadata:
-  version: "4.1.6"
-  last_updated: "2026-04-06T00:00:00Z"
-  entity_count: 62
+  version: "4.3.0"
+  last_updated: "2026-04-14T00:00:00Z"
+  entity_count: 100
   checksum_algorithm: sha256
 
 entities:
@@ -98,6 +98,14 @@ entities:
       dependencies: [qa-gate-template, implementation-gate, session-schema]
       adaptability: 0.3
 
+    qa-visual:
+      path: chati.dev/agents/quality/qa-visual.md
+      type: agent
+      purpose: "Validate visual quality — screenshots, animations, brandbook compliance, interaction states"
+      keywords: [qa, visual, screenshots, animations, brandbook, gsap, lenis, playwright]
+      dependencies: [brandbook, ux-specification, session-schema]
+      adaptability: 0.3
+
     dev:
       path: chati.dev/agents/build/dev.md
       type: agent
@@ -305,7 +313,7 @@ entities:
     constitution:
       path: chati.dev/constitution.md
       type: governance
-      purpose: "19 Articles + Preamble governing all agent behavior"
+      purpose: "23 Articles + Preamble governing all agent behavior"
       keywords: [constitution, governance, rules, articles, enforcement]
       dependencies: []
       adaptability: 0.1
@@ -517,3 +525,368 @@ entities:
       keywords: [config, version, installation, settings]
       dependencies: [config-schema]
       adaptability: 0.3
+
+  hooks:
+    constitution-guard:
+      path: chati.dev/hooks/constitution-guard.js
+      type: hook
+      purpose: "Enforce constitution rules on every agent output — blocks non-compliant actions"
+      keywords: [hook, constitution, enforcement, governance, blocking]
+      dependencies: [constitution]
+      adaptability: 0.1
+
+    license-guard:
+      path: chati.dev/hooks/license-guard.js
+      type: hook
+      purpose: "Validate active license before allowing framework operations"
+      keywords: [hook, license, validation, enforcement, access-control]
+      dependencies: [constitution]
+      adaptability: 0.1
+
+    mode-governance:
+      path: chati.dev/hooks/mode-governance.js
+      type: hook
+      purpose: "Enforce mode-based write scope and action restrictions (planning/build/deploy)"
+      keywords: [hook, mode, governance, write-scope, restrictions]
+      dependencies: [constitution]
+      adaptability: 0.1
+
+    model-governance:
+      path: chati.dev/hooks/model-governance.js
+      type: hook
+      purpose: "Enforce per-agent model selection rules and prevent unauthorized downgrades"
+      keywords: [hook, model, governance, agent, selection]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    prism-engine:
+      path: chati.dev/hooks/prism-engine.js
+      type: hook
+      purpose: "Inject bracket-aware context into every agent turn via the PRISM engine"
+      keywords: [hook, prism, context, injection, brackets, layers]
+      dependencies: [context-engine, constitution]
+      adaptability: 0.2
+
+    read-protection:
+      path: chati.dev/hooks/read-protection.js
+      type: hook
+      purpose: "Block unauthorized reads of protected framework files outside allowed scope"
+      keywords: [hook, read, protection, security, access-control]
+      dependencies: [constitution]
+      adaptability: 0.1
+
+    session-digest:
+      path: chati.dev/hooks/session-digest.js
+      type: hook
+      purpose: "PreCompact hook — saves session digest and triggers memory consolidation"
+      keywords: [hook, session, digest, precompact, memory, consolidation]
+      dependencies: [memory-layer, memory-consolidation]
+      adaptability: 0.3
+
+    style-guard:
+      path: chati.dev/hooks/style-guard.js
+      type: hook
+      purpose: "Block disallowed style patterns (em-dashes, prohibited punctuation) from all outputs"
+      keywords: [hook, style, guard, em-dash, punctuation, enforcement]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    team-quality-gate:
+      path: chati.dev/hooks/team-quality-gate.js
+      type: hook
+      purpose: "Enforce Team Quality Gate (Article XXI) — validate all tasks complete and scores pass before team dissolves"
+      keywords: [hook, team, quality-gate, dissolution, article-xxi, scores]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    undercover-guard:
+      path: chati.dev/hooks/undercover-guard.js
+      type: hook
+      purpose: "Block framework-internal identifier leaks into deliverables (agent names, hook names, internal path prefixes)"
+      keywords: [hook, undercover, identifier, leak, guard, deliverables]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    reasoning-escalator:
+      path: chati.dev/hooks/reasoning-escalator.js
+      type: hook
+      purpose: "Article XXIII tier evaluator (UserPromptSubmit) + deliberate-tier plan gate (PreToolUse Write/Edit). Locale-aware friction keywords."
+      keywords: [hook, reasoning, tier, article-xxiii, friction, plan, deliberate]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    advance-trigger:
+      path: chati.dev/hooks/advance-trigger.js
+      type: hook
+      purpose: "PostToolUse (Write) — detect agent handoff writes and auto-advance the pipeline deterministically"
+      keywords: [hook, posttooluse, handoff, advance, pipeline, autonomous]
+      dependencies: [constitution, session-manager]
+      adaptability: 0.2
+
+    reference-trigger:
+      path: chati.dev/hooks/reference-trigger.js
+      type: hook
+      purpose: "PostToolUse (Write) — spawn reference-capture.js in background when brief-report.md is written"
+      keywords: [hook, posttooluse, brief, reference, capture, background]
+      dependencies: [brief]
+      adaptability: 0.2
+
+    brief-validator:
+      path: chati.dev/hooks/brief-validator.js
+      type: hook
+      purpose: "PostToolUse (Write) — validate brief-report.md completeness when brief-handoff.md lands"
+      keywords: [hook, posttooluse, brief, validator, handoff]
+      dependencies: [brief]
+      adaptability: 0.2
+
+    post-dev:
+      path: chati.dev/hooks/post-dev.js
+      type: hook
+      purpose: "PostToolUse (Write) — autonomous-completion v1 ADR-AUTO-06. Spawns visual-qa.js detached on dev-handoff write."
+      keywords: [hook, posttooluse, autonomous-completion, visual-qa, dev-handoff]
+      dependencies: [dev, qa-visual]
+      adaptability: 0.2
+
+  scripts:
+    visual-qa:
+      path: chati.dev/scripts/visual-qa.js
+      type: script
+      purpose: "Visual QA script — captures screenshots via Playwright for qa-visual agent validation"
+      keywords: [script, visual-qa, playwright, screenshots, animations, validation]
+      dependencies: [qa-visual]
+      adaptability: 0.5
+
+  scaffold:
+    motion-premium:
+      path: chati.dev/scaffold/motion-premium/scaffold.yaml
+      type: scaffold
+      purpose: "Premium animation infrastructure preset — GSAP + Lenis + cinematic providers. 15 files across foundation/animations/providers/ui-contract phases."
+      keywords: [scaffold, motion, premium, gsap, lenis, framer-motion, animation, phase-10]
+      dependencies: [ux-brand-architect]
+      adaptability: 0.4
+
+    motion-premium-3d:
+      path: chati.dev/scaffold/motion-premium-3d/scaffold.yaml
+      type: scaffold
+      purpose: "R3F + Three.js scroll-driven 3D layer. Extends motion-premium with 12 templates across webgl/canvas/scroll-scene/demo phases. Disjoint target paths."
+      keywords: [scaffold, motion, premium, 3d, r3f, three, webgl, scroll, phase-10]
+      dependencies: [motion-premium, ux-brand-architect]
+      adaptability: 0.4
+
+  context:
+    context-governance:
+      path: chati.dev/context/governance.md
+      type: governance
+      purpose: "Governance rules extracted from constitution — mode, execution profile, anti-loop, agent teams"
+      keywords: [context, governance, rules, mode, constitution]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    context-protocols:
+      path: chati.dev/context/protocols.md
+      type: governance
+      purpose: "8 universal protocols that apply to all agents — self-validation, loop, handoff, language"
+      keywords: [context, protocols, agents, universal, handoff, validation]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    context-quality:
+      path: chati.dev/context/quality.md
+      type: governance
+      purpose: "Quality standards — gate thresholds, pipeline gates, blocker taxonomy, fault vector protocol"
+      keywords: [context, quality, gates, thresholds, blockers, fvp]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    context-root:
+      path: chati.dev/context/root.md
+      type: governance
+      purpose: "System context overview — version, pipeline, key references, how to use"
+      keywords: [context, root, system, pipeline, overview, references]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+  domains:
+    domain-constitution:
+      path: chati.dev/domains/constitution.yaml
+      type: governance
+      purpose: "Domain definition for constitution governance — articles, rules, enforcement scope"
+      keywords: [domain, constitution, governance, articles]
+      dependencies: [constitution]
+      adaptability: 0.1
+
+    domain-global:
+      path: chati.dev/domains/global.yaml
+      type: governance
+      purpose: "Global domain definitions shared across all agents and pipeline phases"
+      keywords: [domain, global, shared, agents, pipeline]
+      dependencies: [constitution]
+      adaptability: 0.2
+
+    domain-agent-orchestrator:
+      path: chati.dev/domains/agents/orchestrator.yaml
+      type: governance
+      purpose: "Domain definition for orchestrator agent — routing rules, session scope"
+      keywords: [domain, orchestrator, routing, session]
+      dependencies: [orchestrator]
+      adaptability: 0.2
+
+    domain-agent-brief:
+      path: chati.dev/domains/agents/brief.yaml
+      type: governance
+      purpose: "Domain definition for brief agent — elicitation rules, output scope"
+      keywords: [domain, brief, elicitation, requirements]
+      dependencies: [brief]
+      adaptability: 0.3
+
+    domain-agent-brownfield-wu:
+      path: chati.dev/domains/agents/brownfield-wu.yaml
+      type: governance
+      purpose: "Domain definition for brownfield warm-up agent — discovery scope, codebase analysis"
+      keywords: [domain, brownfield, warm-up, discovery]
+      dependencies: [brownfield-wu]
+      adaptability: 0.3
+
+    domain-agent-detail:
+      path: chati.dev/domains/agents/detail.yaml
+      type: governance
+      purpose: "Domain definition for detail agent — PRD scope, specification rules"
+      keywords: [domain, detail, prd, specification]
+      dependencies: [detail]
+      adaptability: 0.3
+
+    domain-agent-architect:
+      path: chati.dev/domains/agents/architect.yaml
+      type: governance
+      purpose: "Domain definition for architect agent — architecture scope, technology decisions"
+      keywords: [domain, architect, architecture, technology]
+      dependencies: [architect]
+      adaptability: 0.2
+
+    domain-agent-ux:
+      path: chati.dev/domains/agents/ux.yaml
+      type: governance
+      purpose: "Domain definition for UX agent — design scope, interaction rules"
+      keywords: [domain, ux, design, interaction]
+      dependencies: [ux]
+      adaptability: 0.3
+
+    domain-agent-phases:
+      path: chati.dev/domains/agents/phases.yaml
+      type: governance
+      purpose: "Domain definition for phases agent — decomposition rules, MVP strategy"
+      keywords: [domain, phases, decomposition, mvp]
+      dependencies: [phases]
+      adaptability: 0.3
+
+    domain-agent-tasks:
+      path: chati.dev/domains/agents/tasks.yaml
+      type: governance
+      purpose: "Domain definition for tasks agent — task creation rules, acceptance criteria scope"
+      keywords: [domain, tasks, acceptance-criteria, execution]
+      dependencies: [tasks]
+      adaptability: 0.3
+
+    domain-agent-qa-planning:
+      path: chati.dev/domains/agents/qa-planning.yaml
+      type: governance
+      purpose: "Domain definition for QA-Planning agent — planning validation rules and thresholds"
+      keywords: [domain, qa-planning, validation, planning-gate]
+      dependencies: [qa-planning]
+      adaptability: 0.2
+
+    domain-agent-qa-implementation:
+      path: chati.dev/domains/agents/qa-implementation.yaml
+      type: governance
+      purpose: "Domain definition for QA-Implementation agent — implementation validation rules"
+      keywords: [domain, qa-implementation, validation, implementation-gate]
+      dependencies: [qa-implementation]
+      adaptability: 0.2
+
+    domain-agent-qa-visual:
+      path: chati.dev/domains/agents/qa-visual.yaml
+      type: governance
+      purpose: "Domain definition for QA-Visual agent — visual validation rules, screenshot scope"
+      keywords: [domain, qa-visual, visual, screenshots, animations]
+      dependencies: [qa-visual]
+      adaptability: 0.2
+
+    domain-agent-dev:
+      path: chati.dev/domains/agents/dev.yaml
+      type: governance
+      purpose: "Domain definition for dev agent — implementation scope, coding rules"
+      keywords: [domain, dev, implementation, coding]
+      dependencies: [dev]
+      adaptability: 0.3
+
+    domain-agent-devops:
+      path: chati.dev/domains/agents/devops.yaml
+      type: governance
+      purpose: "Domain definition for devops agent — deployment scope, infrastructure rules"
+      keywords: [domain, devops, deployment, infrastructure]
+      dependencies: [devops]
+      adaptability: 0.3
+
+    domain-agent-greenfield-wu:
+      path: chati.dev/domains/agents/greenfield-wu.yaml
+      type: governance
+      purpose: "Domain definition for greenfield warm-up agent — context analysis scope"
+      keywords: [domain, greenfield, warm-up, context]
+      dependencies: [greenfield-wu]
+      adaptability: 0.3
+
+    domain-workflow-greenfield-fullstack:
+      path: chati.dev/domains/workflows/greenfield-fullstack.yaml
+      type: governance
+      purpose: "Domain definition for greenfield fullstack workflow — pipeline step rules"
+      keywords: [domain, workflow, greenfield, fullstack]
+      dependencies: [greenfield-fullstack]
+      adaptability: 0.3
+
+    domain-workflow-brownfield-discovery:
+      path: chati.dev/domains/workflows/brownfield-discovery.yaml
+      type: governance
+      purpose: "Domain definition for brownfield discovery workflow — analysis step rules"
+      keywords: [domain, workflow, brownfield, discovery]
+      dependencies: [brownfield-discovery]
+      adaptability: 0.3
+
+    domain-workflow-brownfield-fullstack:
+      path: chati.dev/domains/workflows/brownfield-fullstack.yaml
+      type: governance
+      purpose: "Domain definition for brownfield fullstack workflow — pipeline step rules"
+      keywords: [domain, workflow, brownfield, fullstack]
+      dependencies: [brownfield-fullstack]
+      adaptability: 0.3
+
+    domain-workflow-brownfield-ui:
+      path: chati.dev/domains/workflows/brownfield-ui.yaml
+      type: governance
+      purpose: "Domain definition for brownfield UI workflow — frontend change rules"
+      keywords: [domain, workflow, brownfield, ui, frontend]
+      dependencies: [brownfield-ui]
+      adaptability: 0.4
+
+    domain-workflow-brownfield-service:
+      path: chati.dev/domains/workflows/brownfield-service.yaml
+      type: governance
+      purpose: "Domain definition for brownfield service workflow — backend change rules"
+      keywords: [domain, workflow, brownfield, service, backend]
+      dependencies: [brownfield-service]
+      adaptability: 0.4
+
+    domain-workflow-quick-flow:
+      path: chati.dev/domains/workflows/quick-flow.yaml
+      type: governance
+      purpose: "Domain definition for quick flow workflow — fast-track pipeline rules"
+      keywords: [domain, workflow, quick, fast-track, hotfix]
+      dependencies: [quick-flow]
+      adaptability: 0.4
+
+    domain-workflow-standard-flow:
+      path: chati.dev/domains/workflows/standard-flow.yaml
+      type: governance
+      purpose: "Domain definition for standard flow workflow — balanced pipeline rules"
+      keywords: [domain, workflow, standard, balanced, feature]
+      dependencies: [standard-flow]
+      adaptability: 0.4

package/framework/data/model-limits.json

@@ -0,0 +1,19 @@
+{
+  "$comment": "Single source of truth for context window limits (tokens) per provider and model. Consumed by packages/chati-dev/src/utils/provider-limits.js AND chati.dev/hooks/prism-engine.js. Scan-stale check #25 asserts provider-limits.js fallback matches this file. 2026-04-18 (context-window-auto-detect-v2): opus family resolves to 1M by default (the prior 200K fallback was a regression-lock from PR #3 when Opus 200K + Opus 1M shipped side-by-side; current Claude Opus 4.7 is uniformly 1M). The opus[1m] key is retained as a backwards-compat alias and resolves identically. Baseline appendix 2026-04-18-a documents the regression-lock removal with the new invariant: `MODEL_LIMITS.opus >= 1_000_000`. Model keys follow parseClaudeModelId's normalized shape: `<family>` or `<family>[<variant>]`. Non-Claude providers keep bare family keys (pro, flash, codex).",
+  "updated_at": "2026-04-18T00:00:00Z",
+  "providers": {
+    "claude": 1000000,
+    "gemini": 1000000,
+    "codex": 128000
+  },
+  "models": {
+    "opus": 1000000,
+    "opus[1m]": 1000000,
+    "sonnet": 1000000,
+    "sonnet[1m]": 1000000,
+    "haiku": 200000,
+    "pro": 1000000,
+    "flash": 1000000,
+    "codex": 128000
+  }
+}

package/framework/domains/agents/qa-visual.yaml

@@ -0,0 +1,74 @@
+# QA Visual Agent Domain — Authority boundaries and behavioral rules for PRISM L2
+
+mission: "Validate visual quality of UI implementation — screenshots, animations, brandbook compliance, and interaction states."
+
+authority:
+  exclusive:
+    - screenshot_analysis
+    - animation_verification
+    - brandbook_compliance_check
+    - visual_qa_verdict
+  allowed:
+    - read_any_file
+    - run_playwright
+    - capture_screenshots
+    - read_brandbook
+    - read_ux_specification
+  blocked:
+    - code_implementation
+    - architecture_modification
+    - deployment
+    - style_changes
+  redirectMessage: "QA Visual validates visual quality. Dev agent fixes visual issues found."
+
+outputs:
+  - artifacts/handoffs/qa-visual
+
+rules:
+  - id: qav-screenshots
+    text: >
+      Screenshots MUST be captured at minimum 5 scroll positions (top, 25%, 50%, 75%, bottom)
+      plus all interactive states (hover, active, focus, disabled). Missing screenshots block APPROVED.
+    priority: critical
+
+  - id: qav-animation
+    text: >
+      GSAP and Lenis presence MUST be verified when the project's ux-specification.md specifies
+      premium animations. Verify: GSAP loaded, ScrollTrigger active, Lenis scroll initialized,
+      scroll reveal triggers firing at correct thresholds.
+    priority: critical
+
+  - id: qav-brandbook
+    text: >
+      Every visual element MUST comply with brandbook.md — colors, typography, spacing, component
+      style. Deviations from brandbook are BLOCKING findings (C-level).
+    priority: critical
+
+  - id: qav-verdict
+    text: "Verdict must be one of: APPROVED, NEEDS_REVISION, or BLOCKED."
+    priority: critical
+
+  - id: qav-adversarial
+    text: >
+      ADVERSARIAL REVIEW: Every visual QA pass MUST identify minimum 3 visual findings
+      (spacing issues, color deviations, animation timing, responsiveness gaps, etc.).
+      Zero findings is suspiciously clean — trigger mandatory re-review with deeper analysis.
+    priority: critical
+
+  - id: qav-responsive
+    text: >
+      Validate at 3 breakpoints minimum: mobile (375px), tablet (768px), desktop (1440px).
+      Each breakpoint requires screenshot evidence.
+    priority: high
+
+  - id: qav-interaction
+    text: >
+      All interactive components (buttons, links, inputs, cards) MUST have verified hover states
+      with smooth transitions. Missing or janky transitions are WARNING-level findings.
+    priority: high
+
+  - id: qav-performance
+    text: >
+      Animations must run at 60fps. If any animation causes layout shift (CLS > 0.1) or
+      forces synchronous layout, flag as WARNING. Jank on scroll is a BLOCKING finding.
+    priority: high

package/framework/domains/constitution.yaml

@@ -1,5 +1,5 @@
 # Constitution Domain — Extracted governance rules for PRISM L0
-# Source: chati.dev/constitution.md (19 Articles + Preamble)
+# Source: chati.dev/constitution.md (23 Articles + Preamble)
 
 summary: >
   Constitution governance: self-validation required (loop until tier-specific threshold met),
@@ -9,7 +9,7 @@ summary: >
   context brackets, memory governance, registry governance,
   session lock, model governance.
 
-articleCount: 19
+articleCount: 22
 
 rules:
   - id: art-i
@@ -107,3 +107,47 @@ articles:
         priority: high
       - provider-context-files: "Context file generation is automatic when a provider is enabled."
         priority: normal
+  article-xx:
+    name: "Anti-Loop Protocol (3-Strike Rule)"
+    enforcement: block
+    rules:
+      - three-strike-rule: "3 edits to the same file without resolution = STOP. Mandatory Diagnosis Mode activates."
+        priority: critical
+      - diagnosis-mode: "Read complete file, trace execution path, state root cause in one sentence before any further edit."
+        priority: critical
+      - paradigm-change: "After diagnosis, use a different approach than what failed (e.g. CSS failed -> try JavaScript)."
+        priority: high
+      - escalation: "After 5 total attempts without resolution, present the situation honestly and ask for user direction."
+        priority: critical
+      - score-cap: "Task score is capped at 0% for anti-loop protocol violations."
+        priority: critical
+  article-xxi:
+    name: "Agent Teams Governance"
+    enforcement: block
+    rules:
+      - feature-flag: "Agent Teams is feature-flagged (agent_teams: true in config.yaml). Defaults to OFF for non-Claude providers."
+        priority: high
+      - canonical-teams: "Two canonical teams: Planning Team (Detail+Architect+UX+QA-Planning) and Build Team (Dev+QA-Implementation)."
+        priority: critical
+      - orchestrator-authority: "Only the orchestrator can form or dissolve teams. No agent may self-organize."
+        priority: critical
+      - intra-team-mailbox: "Intra-team communication uses the Team Mailbox. Cross-team communication is orchestrator-mediated."
+        priority: high
+      - team-quality-gate: "Team Quality Gate: all tasks complete + all scores pass tier threshold + mailbox clean."
+        priority: critical
+      - max-correction-cycles: "Maximum 2 Team Correction Cycles before degraded dissolution."
+        priority: high
+      - graceful-fallback: "Graceful fallback to sequential pipeline when Agent Teams is unavailable."
+        priority: high
+  article-xxii:
+    name: "Fault Vector Protocol"
+    enforcement: block
+    rules:
+      - root-layer-routing: "Classify fault origin (INTENT/SPEC/CODE/DEFER) before correction. Route to correct layer."
+        priority: critical
+      - evidence-bound-verdicts: "ERROR findings require tool evidence (lint/typecheck/test/screenshot). Without evidence, downgrade to SUGGESTION (non-blocking)."
+        priority: critical
+      - decision-trail: "Append-only log of known-bad states in session.yaml decision_trail[]. Agents read before iterating."
+        priority: high
+      - echo-detection: "Content-similarity >= 0.85 with prior Decision Trail entry = ECHO. Escalate immediately, no more automated loops."
+        priority: critical

package/framework/domains/workflows/greenfield-fullstack.yaml

@@ -19,8 +19,8 @@ rules:
     text: "Follow pipeline order strictly. WU must complete before Brief."
     priority: high
   - id: gf-parallel
-    text: "Detail, Architect, and UX can run in parallel after Brief."
+    text: "Detail, Architect, and UX can run in parallel after Brief. QA-Planning activates after all three complete as 4th Planning Team member."
     priority: normal
   - id: gf-gate
-    text: "QA-Planning gate must pass before entering BUILD phase."
+    text: "QA-Planning runs inside the Planning Team. Team dissolves only when QA-Planning approves (>= 95%)."
     priority: critical