chati-dev 4.3.0 → 4.4.0

package/framework/scaffold/saas-dashboard/scaffold.yaml

@@ -0,0 +1,225 @@
+# Scaffold Premium - saas-dashboard v1.0.0
+#
+# Declarative manifest for the saas-dashboard scaffold preset. Consumed by
+# the scaffold-applier at apply time to resolve placeholders and emit files
+# into the target project. App-shell category: a premium SaaS dashboard with
+# a sidebar, top bar, sortable data tables, KPI cards, an SVG chart, forms,
+# and a Cmd+K command palette. Distinct from the motion-premium presets,
+# which target animated showcase sites.
+#
+# Contract: this schema is STABLE within v1.x. Additions only.
+
+id: saas-dashboard
+version: 1.0.0
+description: "Premium SaaS dashboard and app-shell: sidebar nav, top bar, sortable data tables, KPI stat cards, a self-contained SVG chart, accessible forms, and a Cmd+K command palette. Calibrated dark palette, modular type scale, fully token-driven, WCAG AA. Opinionated for Next.js / React 18+ / Tailwind v4."
+
+framework:
+  chati_dev: ">=4.3.0"
+
+stack:
+  build_tools: ["nextjs"]
+  tailwind: ">=4.0.0"
+  typescript: ">=5.0.0"
+  node: ">=18.0.0"
+  react: ">=18.0.0"
+  next: ">=13.0.0"
+  # TypeScript dev types. create-next-app --typescript installs these; declared
+  # here so a hand-rolled Next.js project knows to add them before applying.
+  "@types/react": ">=18.0.0"
+  "@types/react-dom": ">=18.0.0"
+  # Runtime peer deps imported directly by templates. The chart and command
+  # palette are hand-rolled (no chart or cmdk dependency) to keep the footprint small.
+  lucide-react: ">=0.400.0"
+  "framer-motion": "^11.0.0"
+  # Playwright powers the QA-Visual screenshot gate. Without it, visual-qa.js
+  # falls back to source analysis (gateway: WEAK).
+  playwright: "^1.44.0"
+
+# Brandable accent (role 1 interactive affordance). The neutral and semantic
+# scales are the designed system and are not parameterized.
+placeholders:
+  ACCENT_HEX:
+    source: brand.colors.accent
+    default: "#7c5af8"
+    type: hex
+  ACCENT_HOVER_HEX:
+    source: brand.colors.accentHover
+    default: "#9070ff"
+    type: hex
+
+brand_sources:
+  - path: lib/brand.ts
+    type: typescript
+    description: "Existing brand tokens (brownfield or post-install)"
+  - path: artifacts/4-UX/brandbook.md
+    type: markdown
+    description: "UX-authored brandbook (greenfield, post-UX phase)"
+  - type: interactive
+    prompt: true
+    description: "Fallback: ask the user for the accent with default hints"
+
+# Files shipped by this scaffold (30 templates).
+files:
+  - source: app/dashboard/page.tsx.template
+    target: app/dashboard/page.tsx
+    phase: sample
+    override: full
+    notes: "Composed sample dashboard demonstrating the preset. User replaces with real pages."
+  - source: app/globals.css.template
+    target: app/globals.css
+    phase: foundation
+    override: partial
+    notes: "Design tokens (CSS custom properties). Accent vars synced from brand source; the calibrated neutral and semantic scales are the designed system, user-editable."
+  - source: app/shell.css.template
+    target: app/shell.css
+    phase: shell
+    override: partial
+    notes: "BEM styles for the app-shell layer (sidebar, topbar, breadcrumb, theme toggle). References the globals.css tokens; imported once by app/layout.tsx."
+  - source: app/layout.tsx.template
+    target: app/layout.tsx
+    phase: shell
+    override: partial
+    notes: "Ships the shell + providers + fonts. User fills metadata, analytics, chrome."
+  - source: components/data/Chart.tsx.template
+    target: components/data/Chart.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/DataTable.tsx.template
+    target: components/data/DataTable.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/DataTable.types.ts.template
+    target: components/data/DataTable.types.ts
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/DataTablePagination.tsx.template
+    target: components/data/DataTablePagination.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/SkeletonBlock.tsx.template
+    target: components/data/SkeletonBlock.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/StatCard.tsx.template
+    target: components/data/StatCard.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/data/StatCardGrid.tsx.template
+    target: components/data/StatCardGrid.tsx
+    phase: data
+    override: none
+    notes: "Data-display component (table, stat card, chart). Scaffold-owned."
+  - source: components/feedback/EmptyState.tsx.template
+    target: components/feedback/EmptyState.tsx
+    phase: feedback
+    override: partial
+    notes: "Feedback component (empty state). User supplies copy and slots."
+  - source: components/interaction/CommandPalette.tsx.template
+    target: components/interaction/CommandPalette.tsx
+    phase: interaction
+    override: none
+    notes: "Interaction component (command palette, form fields). Scaffold-owned."
+  - source: components/interaction/Field.tsx.template
+    target: components/interaction/Field.tsx
+    phase: interaction
+    override: none
+    notes: "Interaction component (command palette, form fields). Scaffold-owned."
+  - source: components/interaction/Form.tsx.template
+    target: components/interaction/Form.tsx
+    phase: interaction
+    override: none
+    notes: "Interaction component (command palette, form fields). Scaffold-owned."
+  - source: components/primitives/Badge.tsx.template
+    target: components/primitives/Badge.tsx
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/primitives/Button.tsx.template
+    target: components/primitives/Button.tsx
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/primitives/Card.tsx.template
+    target: components/primitives/Card.tsx
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/primitives/Input.tsx.template
+    target: components/primitives/Input.tsx
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/primitives/Spinner.tsx.template
+    target: components/primitives/Spinner.tsx
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/primitives/index.ts.template
+    target: components/primitives/index.ts
+    phase: primitives
+    override: none
+    notes: "Shared primitive with full resting/hover/active/disabled/focus states. Scaffold-owned."
+  - source: components/shell/AppShell.tsx.template
+    target: components/shell/AppShell.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/Breadcrumb.tsx.template
+    target: components/shell/Breadcrumb.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/Container.tsx.template
+    target: components/shell/Container.tsx
+    phase: foundation
+    override: none
+    notes: "Single authority for max-width + horizontal padding. Never edit."
+  - source: components/shell/NavItem.tsx.template
+    target: components/shell/NavItem.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/Sidebar.tsx.template
+    target: components/shell/Sidebar.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/SidebarContext.tsx.template
+    target: components/shell/SidebarContext.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/ThemeToggle.tsx.template
+    target: components/shell/ThemeToggle.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: components/shell/Topbar.tsx.template
+    target: components/shell/Topbar.tsx
+    phase: shell
+    override: none
+    notes: "App-shell component (sidebar, top bar, nav). Scaffold-owned."
+  - source: lib/brand.ts.template
+    target: lib/brand.ts
+    phase: foundation
+    override: full
+    notes: "User-owned typed brand tokens. Protected from upgrades."
+
+# Principles this scaffold encodes. Violating any breaks the premium guarantees.
+principles:
+  - "Tokens over values: every color, size, radius, shadow, and duration referenced in a component file must be a CSS custom property or a typed constant from lib/brand.ts. Raw hex strings, raw pixel numbers, and bare ease keywords are linting violations."
+  - "Semantic layering: the neutral scale provides raw steps; the semantic layer (--color-bg-*, --color-text-*, --color-border-*) is what components consume. Adding a new theme requires only overriding the semantic layer, never touching component files."
+  - "Container is the sole layout authority: max-width and horizontal page padding exist only in Container.tsx. No other component may set max-width or page-level horizontal padding."
+  - "Motion must be purposeful: every transition must specify exactly which property it transitions (never transition:all), an explicit duration token, and an explicit easing token. The easing must match the spatial metaphor: ease-out for entering, ease-in for leaving, ease-in-out for toggling."
+  - "Accessibility is structural, not an afterthought: semantic HTML elements (<table>, <nav>, <main>, <dialog>, <label>) are used for their meaning. ARIA attributes supplement but never replace semantic HTML. Focus management (trap in modals, restore on close) is implemented, not skipped."
+  - "Reduced-motion is first-class: every animation is authored assuming motion is allowed, then a separate @media (prefers-reduced-motion: reduce) block collapses all durations to 0ms or 80ms and removes transform-based animations. This is done in globals.css, not per-component."
+  - "Placeholder is never the only label: every input has a real <label> element. Placeholder text may clarify format but the field is fully understandable without it. The Field primitive enforces this structurally."
+  - "Performance budget on animation: only transform and opacity are animated. Width, height, top, left, padding, and margin transitions are forbidden. Layout shift is prevented by reserving space for loading and empty states before content arrives."
+  - "Dark palette is designed, not inverted: the dark theme is built from a calibrated neutral scale with its own shadow, surface layering, and reduced-contrast accent values. It is not produced by CSS filter or by simply swapping light and dark values."
+  - "Primitives are the contract boundary: Button, Card, Input/Field, and Badge are the shared language across all builders. New components compose primitives; they do not reimplement base patterns. Any change to a primitive propagates correctly to all consumers."

package/framework/schemas/session.schema.json

@@ -14,6 +14,11 @@
       "type": "string",
       "description": "Legacy framework-version marker on the session object (distinct from schema_version). Kept for backwards compatibility."
     },
+    "model_at_last_audit": {
+      "type": ["string", "null"],
+      "default": null,
+      "description": "Normalized active_model recorded when /chati-update last completed. Article XXIV: when active_model differs from this, the orchestrator advises a harness re-audit. The advisory is driven entirely by this comparison; there is no separate flag."
+    },
     "mode": {
       "enum": ["discover", "plan", "build", "validate", "deploy", "completed"],
       "default": "discover",

package/framework/schemas/task.schema.json

@@ -66,6 +66,15 @@
     "completed_at": {
       "type": ["string", "null"],
       "format": "date-time"
+    },
+    "execution_kind": {
+      "enum": ["agent", "script", "specialist", "human"],
+      "default": "agent",
+      "description": "How this task executes. 'agent' (default): an LLM agent implements it. 'script': a deterministic zero-LLM executor runs it (see execution_ref). 'specialist': an agent carrying an embedded methodology. 'human': a human decision gate. Omitting the field means 'agent', so existing tasks are unaffected."
+    },
+    "execution_ref": {
+      "type": ["string", "null"],
+      "description": "Resolves the executor for non-agent kinds. For 'script': an executor id from chati.dev/executors/registry.yaml, optionally with a colon-suffixed argument (e.g. 'npm-script:lint'). For 'specialist': the methodology id. For 'human': a short description of the decision required. Null or omitted for 'agent'."
     }
   }
 }

package/framework/scripts/visual-qa.js

@@ -92,6 +92,43 @@ export function computeReducedMotionViolations(report, reducedMotionMode, primar
     }));
 }
 
+/**
+ * Spring-motion veto: derive visual errors from each page's motion_quality scan.
+ * Linear easing on a state transition and transition-property: all are amateur
+ * motion tells. ERROR severity so the qa-visual gate factors them into APPROVED
+ * (routed to dev via Fault Vector Protocol); not a hard crash.
+ *
+ * @param {{pages: Array<{path:string, js_checks?:object}>}} report
+ * @returns {Array<{severity:string, type:string, page:string, detail:string, samples:object[]}>}
+ */
+export function computeMotionErrors(report) {
+  const pages = Array.isArray(report?.pages) ? report.pages : [];
+  const errors = [];
+  for (const p of pages) {
+    const m = p?.js_checks?.motion_quality;
+    if (!m) continue;
+    if (m.transition_all > 0) {
+      errors.push({
+        severity: 'error',
+        type: 'transition_all',
+        page: p.path,
+        detail: `${m.transition_all} visible element(s) use transition-property: all, which animates layout properties and janks. Transition specific compositor properties (transform, opacity) instead.`,
+        samples: (m.samples || []).filter(s => s.issue && s.issue.includes('all')).slice(0, 3),
+      });
+    }
+    if (m.linear_transitions > 0) {
+      errors.push({
+        severity: 'error',
+        type: 'linear_easing',
+        page: p.path,
+        detail: `${m.linear_transitions} visible element(s) use linear easing on a state transition, which feels robotic. Use ease-out, a cubic-bezier, or a spring.`,
+        samples: (m.samples || []).filter(s => s.issue && s.issue.includes('linear')).slice(0, 3),
+      });
+    }
+  }
+  return errors;
+}
+
 // ---------------------------------------------------------------------------
 // Args
 // ---------------------------------------------------------------------------
@@ -370,8 +407,20 @@ async function main() {
         if (chromium) break;
       } catch { /* try next */ }
     }
-    if (!chromium) throw new Error('Playwright not installed. Run: npx playwright install chromium');
-    const browser = await chromium.launch({ headless: true });
+    if (!chromium) {
+      // v4.3.1+ G17: disambiguate npm-package-missing from binary-missing for actionable hints
+      throw new Error('Playwright npm package missing. Run: npm install playwright');
+    }
+    let browser;
+    try {
+      browser = await chromium.launch({ headless: true });
+    } catch (e) {
+      if (e.message.includes("Executable doesn't exist")
+          || e.message.includes('browserType.launch')) {
+        throw new Error('Chromium binary missing. Run: npx playwright install chromium');
+      }
+      throw e;
+    }
     const report = { pages: [], summary: {} };
 
     for (const pagePath of pages) {
@@ -539,6 +588,45 @@ async function main() {
         }
         checks.custom_properties_count = count;
 
+        // Motion quality (spring-motion veto). Premium motion uses spring or
+        // cubic-bezier easing on specific compositor properties. Linear easing
+        // on a state transition feels robotic, and transition-property: all
+        // animates layout and janks. Both are strong amateur-motion tells. Scan
+        // visible elements that actually declare a transition.
+        // Linear easing is a robotic tell for discrete state transitions
+        // (transform, opacity, color), but it is the correct, physical choice for
+        // continuous or progress motion (a progress bar width, an SVG stroke
+        // draw, a parallax offset). Exempt those properties, plus an explicit
+        // data-linear-ok opt-out, so a legitimate loader is never falsely flagged.
+        const SAFE_LINEAR_PROPS = ['width', 'height', 'max-width', 'max-height', 'min-width', 'min-height', 'background-position', 'background-size', 'stroke-dashoffset', 'stroke-dasharray', 'clip-path', 'left', 'right', 'top', 'bottom'];
+        const motion = { linear_transitions: 0, transition_all: 0, samples: [] };
+        for (const el of document.querySelectorAll('body *')) {
+          const cs = getComputedStyle(el);
+          const dur = cs.transitionDuration || '0s';
+          if (!dur.split(',').some(d => parseFloat(d) > 0)) continue; // no real transition
+          const rect = el.getBoundingClientRect();
+          if (rect.width < 4 || rect.height < 4) continue; // not visible
+          const prop = (cs.transitionProperty || '').split(',').map(s => s.trim());
+          const tf = cs.transitionTimingFunction || '';
+          let issue = null;
+          if (prop.includes('all')) { motion.transition_all++; issue = 'transition-property: all'; }
+          else if (/\blinear\b(?!\s*\()/.test(tf)) {
+            const allSafe = prop.length > 0 && prop.every(p => SAFE_LINEAR_PROPS.includes(p));
+            if (!allSafe && !el.hasAttribute('data-linear-ok')) { motion.linear_transitions++; issue = 'linear easing'; }
+          }
+          if (issue && motion.samples.length < 8) {
+            motion.samples.push({
+              tag: el.tagName.toLowerCase(),
+              cls: [...el.classList].slice(0, 4).join(' '),
+              issue,
+              timing: tf,
+              property: cs.transitionProperty,
+              duration: dur,
+            });
+          }
+        }
+        checks.motion_quality = motion;
+
         // 3D scaffold signals (motion-premium-3d workstream P7). Detects
         // whether the page rendered a Canvas or fell back to SceneFallback.
         // The data-* attributes come from the CanvasProvider + SceneFallback
@@ -610,6 +698,7 @@ async function main() {
     const reducedMotionViolations = computeReducedMotionViolations(
       report, reducedMotionMode, viewports[0]
     );
+    const motionErrors = computeMotionErrors(report);
 
     report.summary = {
       total_pages: report.pages.length,
@@ -630,6 +719,8 @@ async function main() {
       viewport_profiles:   viewports.map(v => v.checkKey),
       layout_errors: allLayoutErrors,
       layout_error_count: allLayoutErrors.filter(e => e.severity === 'error').length,
+      motion_errors: motionErrors,
+      motion_error_count: motionErrors.length,
     };
 
     // 6. Write report
@@ -648,7 +739,14 @@ async function main() {
       }
     }
 
-    if (!report.summary.lenis_active_all || !report.summary.gsap_loaded_all || report.summary.em_dashes_detected || report.summary.layout_error_count > 0) {
+    if (report.summary.motion_error_count > 0) {
+      console.log(`\nMotion errors (spring-motion veto): ${report.summary.motion_error_count}`);
+      for (const err of report.summary.motion_errors.slice(0, 6)) {
+        console.log(`  [${err.type}] ${err.page || ''}: ${err.detail}`);
+      }
+    }
+
+    if (!report.summary.lenis_active_all || !report.summary.gsap_loaded_all || report.summary.em_dashes_detected || report.summary.layout_error_count > 0 || report.summary.motion_error_count > 0) {
       exitCode = 1;
     }
 

package/framework/tasks/orchestrator-health.md

@@ -29,7 +29,7 @@ Validate the chati.dev framework installation, check system dependencies, verify
 
 ### 1. Check Core Framework Files
 Verify essential framework files exist and are valid:
-- `chati.dev/constitution.md` (Article I through XI)
+- `chati.dev/constitution.md` (Article I through XXV)
 - `chati.dev/config.yaml` (framework configuration)
 - `chati.dev/installer/install.js` (installer script)
 - `.chati/` directory structure
@@ -192,7 +192,7 @@ health_report:
       - file: "chati.dev/constitution.md"
         status: "ok"
         size_kb: 45
-        articles_count: 11
+        articles_count: 25
       - file: "chati.dev/config.yaml"
         status: "ok"
         valid_yaml: true
@@ -280,7 +280,7 @@ health_report:
 
   constitution_validation:
     status: "healthy"
-    articles_present: 11
+    articles_present: 25
     article_xi_valid: true
     mode_definitions: ["planning", "build", "deploy"]
     transition_rules_defined: true
@@ -308,7 +308,7 @@ health_report:
     ✓ Framework Health: HEALTHY
 
     All core components validated successfully:
-    - Constitution with 11 articles
+    - Constitution with 25 articles
     - 12 agent definitions
     - 35 task definitions
     - 8 schema files

package/framework/tasks/qa-impl-verdict.md

@@ -62,11 +62,17 @@ Issue the final QA verdict by synthesizing all QA implementation results (tests,
    - Document gate outcome with rationale
 
 6. **Calculate Overall Quality Score**
-   - **Test Results**: 25 points (pass rate, coverage)
-   - **SAST**: 25 points (vulnerability severity, count)
-   - **Regressions**: 25 points (regression count, severity)
-   - **Performance**: 25 points (threshold compliance, degradation)
-   - Total: 100 points maximum
+   - Use the canonical weighted scoring table from `docs/architecture/quality-gates.md` (single source of truth). Weights:
+     - **Tests**: 0.20
+     - **Security (SAST)**: 0.20
+     - **Adversarial Review**: 0.15
+     - **Visual Review**: 0.15
+     - **Code Quality**: 0.10
+     - **Coverage**: 0.10
+     - **Acceptance Criteria**: 0.10
+   - Each dimension is scored 0-100; the weighted sum is the overall score (0-100).
+   - Verdict thresholds: **>= 95%** APPROVED | **90–94%** NEEDS_REVISION | **< 90%** BLOCKED.
+   - Note: the legacy 4-gate 25-point equal-weight table (Tests/SAST/Regressions/Performance = 25/25/25/25) is DEPRECATED — `qa-gate-tmpl.yaml` and `docs/architecture/quality-gates.md` both use the weighted scheme above.
 
 7. **Apply Gate Logic**
    - **ALL gates PASS**: Overall verdict = PASS

package/framework/templates/brandbook-html-tmpl.md

@@ -103,5 +103,5 @@ sections must exist and what each must contain.
 
 ## Reference
 
-See `/Users/ogabrielalonso/code/focus-ai/ping/docs/brand/brandbook.html` for a production
+See `<your-project>/docs/brand/brandbook.html` for a production
 example with 14 sections, sticky nav, dark mode toggle, and complete token rendering.

package/framework/templates/qa-gate-tmpl.yaml

@@ -46,28 +46,41 @@ sections:
         description: "Each agent defined rigorous, binary criteria"
         penalty_on_fail: -10
 
+  # Implementation gate weights — single source of truth:
+  # `docs/architecture/quality-gates.md` § Weighted Scoring. The legacy 30/20/25/15/10
+  # (Test/Coverage/SAST/Review/AC) table was deprecated 2026-05; consumers
+  # SHALL use the 7-dimension table below. Verdict thresholds:
+  #   >= 95% APPROVED | 90-94% NEEDS_REVISION | < 90% BLOCKED.
   - id: implementation_gate
     applicable_to: implementation
     checks:
-      - name: "Test Execution"
+      - name: "Tests"
         description: "All tests pass"
-        weight: 0.30
-        threshold: "100% pass rate"
-
-      - name: "Code Coverage"
-        description: "Line and branch coverage"
         weight: 0.20
-        threshold: ">= 80%"
+        threshold: "100% pass rate"
 
-      - name: "Security Scan (SAST)"
+      - name: "Security (SAST)"
         description: "No critical or high vulnerabilities"
-        weight: 0.25
+        weight: 0.20
         threshold: "0 critical, 0 high"
 
-      - name: "Code Review"
-        description: "Architecture adherence, patterns, quality"
+      - name: "Adversarial Review"
+        description: "Devil's-advocate cross-review of risky changes"
+        weight: 0.15
+
+      - name: "Visual Review"
+        description: "Playwright screenshots + brandbook token compliance"
         weight: 0.15
 
+      - name: "Code Quality"
+        description: "Architecture adherence, patterns, style"
+        weight: 0.10
+
+      - name: "Coverage"
+        description: "Line and branch coverage"
+        weight: 0.10
+        threshold: ">= 80%"
+
       - name: "Acceptance Criteria"
         description: "All Given-When-Then criteria verified"
         weight: 0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chati-dev",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "AI-Powered Multi-Agent Orchestration System - Structured vibe coding for Full Stack Development",
   "type": "module",
   "bin": {
@@ -10,7 +10,6 @@
   "main": "src/wizard/index.js",
   "exports": {
     ".": "./src/wizard/index.js",
-    "./api": "./src/api/index.js",
     "./installer": "./src/installer/core.js",
     "./dashboard": "./src/dashboard/renderer.js",
     "./upgrade": "./src/upgrade/checker.js"
@@ -32,7 +31,9 @@
     "prepublishOnly": "node scripts/sync-framework.js && node scripts/scan-stale.js && node scripts/validate-package.js && node scripts/sign-manifest.js",
     "test": "node --test test/**/*.test.js",
     "lint": "eslint src/ bin/",
-    "lint:fix": "eslint src/ bin/ --fix"
+    "lint:fix": "eslint src/ bin/ --fix",
+    "verify-v431": "npm test && node scripts/scan-stale.js && npm run sync && node scripts/validate-package.js && node test/fixtures/manual-smoke-v430-upgrade.mjs",
+    "smoke:scaffold-build": "node test/fixtures/manual-smoke-scaffold-build.mjs"
   },
   "keywords": [
     "ai",

package/src/config/context-file-generator.js

@@ -72,12 +72,6 @@ function buildCodexReplacements(frameworkDir = 'chati.dev') {
   ];
 }
 
-/**
- * Text replacements for Codex CLI context file (legacy constant using default 'chati.dev/' prefix).
- * @deprecated Use buildCodexReplacements(frameworkDir) for correct path resolution.
- */
-const CODEX_REPLACEMENTS = buildCodexReplacements();
-
 // ---------------------------------------------------------------------------
 // Generators
 // ---------------------------------------------------------------------------

package/src/dashboard/renderer.js

@@ -69,39 +69,3 @@ export async function renderDashboardWatch(targetDir, intervalMs = 5000) {
 
   return timer;
 }
-
-/**
- * Render plain text fallback (for terminals without TUI support)
- */
-export async function renderPlainDashboard(targetDir) {
-  const data = await readDashboardData(targetDir);
-
-  if (!data.session) {
-    console.log('No chati.dev session found. Run `npx chati-dev init` first.');
-    return;
-  }
-
-  const session = data.session;
-  const project = session.project || {};
-
-  console.log();
-  console.log('=== chati.dev Dashboard ===');
-  console.log();
-  console.log(`Project:  ${project.name || 'unknown'}`);
-  console.log(`Type:     ${project.type || 'unknown'}`);
-  console.log(`Phase:    ${project.state || 'unknown'}`);
-  console.log(`Mode:     ${session.execution_mode || 'interactive'}`);
-  console.log(`Language: ${session.language || 'en'}`);
-  console.log();
-
-  console.log('--- Agent Scores ---');
-  for (const [name, info] of Object.entries(data.agentScores)) {
-    const status = info.status === 'pending' ? '--' : info.status === 'in_progress' ? '...' : String(info.score);
-    console.log(`  ${name.padEnd(20)} ${status}`);
-  }
-
-  console.log();
-  console.log(`Blockers: ${data.blockers.length || 'None'}`);
-  console.log(`Gotchas:  ${data.gotchas.length} patterns`);
-  console.log();
-}