chati-dev 4.3.1 → 4.4.1

package/framework/manifest.sig

@@ -0,0 +1 @@
+EK1FsSHB+n5Dbo2dRSF1DPgRD35si2lygeQvPZZp91Vy069v6AlHbK/delS4LVkj/sAU7Tp5PoulKchOCF75AQ==

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.
@@ -815,10 +833,13 @@ The orchestrator enforces `chati.dev/constitution.md`:
 
 | Level | Action | Articles |
 |-------|--------|----------|
-| **BLOCK** | Halt agent on violation | I, II, III, IV, VII, VIII, X, XI, XII, XIII, XV, XVIII, XX, XXI, XXII |
+| **BLOCK** | Halt agent on violation | I, II, III, IV, V, VII, VIII, X, XI, XII, XIII, XV, XX, XXI, XXII, XXIII |
 | **STRICT** | Must not bypass quality gates | XVII |
-| **GUIDE** | Correct without halting | V, IX, XIV, XVI, XIX |
+| **GUIDE** | Correct without halting | IX, XIV, XVI, XIX, XXIV |
 | **WARN** | Generate warning in QA | VI |
+| **FLAG** | Feature-flagged (inert until enabled) | XXV |
+
+Article XVIII was deprecated 2026-04-18 and folded into Article XVII; it carries no enforcement level.
 
 ---
 

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;
 }
 

package/framework/scaffold/saas-dashboard/README.md

@@ -0,0 +1,58 @@
+# saas-dashboard scaffold preset
+
+A premium SaaS dashboard and app-shell starting point. Where the motion-premium
+presets target animated showcase sites, this preset targets the build-me-a-tool
+category: a data-dense application shell that looks designed, not generated.
+
+## What it ships
+
+29 templates across foundation, primitives, shell, data, interaction, and a
+composed sample page:
+
+- **Foundation**: `app/globals.css` (the full token system, fluid type scale,
+  reduced-motion handling, the `xl` breakpoint override), `lib/brand.ts` (typed
+  tokens), and the single `Container` authority for max-width and padding.
+- **Primitives**: `Button`, `Card`, `Input`, `Badge`, `Spinner`, each with full
+  resting, hover, active, disabled, and focus states.
+- **Shell**: `AppShell`, `Sidebar` (collapsible, keyboard-accessible, responsive
+  drawer), `Topbar` (search trigger, breadcrumb, user menu), `NavItem`,
+  `ThemeToggle`, `Breadcrumb`.
+- **Data**: `DataTable` (typed, sortable, sticky header, selection, empty and
+  loading states), `StatCard` and `StatCardGrid` (KPI with delta semantics and a
+  sparkline), `Chart` (a self-contained SVG area chart, no chart dependency).
+- **Interaction**: `CommandPalette` (Cmd+K, fuzzy filter, keyboard nav, hand
+  rolled, no extra dependency), `Field` and `Form` (labeled inputs, validation
+  states, never placeholder-only labels).
+- **Feedback**: `EmptyState`.
+- **Sample**: `app/dashboard/page.tsx` composes the shell, stat cards, a chart,
+  and a data table to demonstrate the preset.
+
+## Design system
+
+- **Color**: a calibrated dark palette built from a single neutral hue with even
+  perceptual luminance steps, a 6-color data-viz series, and a designed light
+  theme via `[data-theme="light"]` (never `filter: invert`). Every color is a
+  CSS custom property; components never carry a raw hex.
+- **Type**: a 1.25 modular scale with fluid `clamp()` values, role-differentiated
+  line-heights, and optical tracking.
+- **Space**: a 4px base unit tuned for data density.
+- **Motion**: cubic-bezier easing matched to the metaphor, a duration scale, and
+  full reduced-motion support. No linear easing, no `transition: all`.
+
+## Quality contract
+
+This preset is built to clear the QA-Visual rubric
+(`chati.dev/data/qa-rubrics.yaml`) on every dimension: layout, typography, color,
+spacing, interaction, motion, accessibility (WCAG 2.1 AA), and performance
+(animate only `transform` and `opacity`).
+
+## Dependencies
+
+`lucide-react` (icons) and `framer-motion` (micro-interactions). The chart and
+the command palette are hand-rolled, so there is no chart library and no command
+menu dependency.
+
+## Brandable
+
+The accent color (`ACCENT_HEX`, `ACCENT_HOVER_HEX`) is resolved at apply time
+from your brand source. The neutral and semantic scales are the designed system.