chati-dev 3.3.2 → 4.0.1

package/framework/presets/supabase-fullstack.yaml

@@ -0,0 +1,37 @@
+# Tech Preset: Supabase Fullstack
+# Auto-loaded by Architect agent when Supabase stack is detected
+
+stack: supabase-fullstack
+displayName: "Supabase Fullstack"
+
+detection:
+  - supabase/config.toml
+  - .env.local containing SUPABASE_URL
+
+conventions:
+  auth: "Supabase Auth with RLS policies for authorization"
+  database: "PostgreSQL with Row Level Security (RLS) on every table"
+  storage: "Supabase Storage for file uploads with bucket policies"
+  functions: "Supabase Edge Functions (Deno) for serverless logic"
+  realtime: "Supabase Realtime for live subscriptions"
+
+structure:
+  - "supabase/ — Supabase project configuration"
+  - "supabase/migrations/ — SQL migration files"
+  - "supabase/functions/ — Edge Functions (Deno)"
+  - "supabase/seed.sql — Seed data"
+  - "src/lib/supabase.ts — Supabase client initialization"
+
+rules:
+  - id: supabase-rls
+    text: "EVERY table MUST have RLS enabled. No exceptions. Create policies before exposing data."
+    priority: critical
+  - id: supabase-migrations
+    text: "All schema changes go through migration files. Never modify production DB directly."
+    priority: critical
+  - id: supabase-types
+    text: "Generate TypeScript types from database schema (supabase gen types)."
+    priority: high
+  - id: supabase-auth
+    text: "Use Supabase Auth helpers for SSR frameworks. Handle auth state server-side."
+    priority: high

package/framework/templates/brandbook-tmpl.yaml

@@ -0,0 +1,113 @@
+# Brandbook Template
+# Used by: UX Agent (Phase 0: Brand Identity)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Brandbook
+  version: "1.0.0"
+  description: >
+    Brand identity foundation document. Defines voice, visual language,
+    typography rationale, color philosophy, spacing rhythm, and iconography
+    style. Must be completed BEFORE design tokens.
+
+output_path: chati.dev/artifacts/4-UX/brandbook.md
+
+sections:
+  - brand_voice
+  - visual_language
+  - typography_rationale
+  - color_philosophy
+  - spacing_rhythm
+  - iconography_style
+
+brand_voice:
+  description: "Brand personality, tone, and communication style"
+  fields:
+    - name: personality_traits
+      type: array
+      description: "3-5 adjectives defining the brand personality"
+    - name: tone_spectrum
+      type: object
+      description: "Formal vs casual, technical vs approachable spectrum"
+    - name: writing_guidelines
+      type: array
+      description: "Dos and don'ts for brand voice"
+    - name: example_phrases
+      type: array
+      description: "Sample phrases demonstrating brand voice"
+
+visual_language:
+  description: "Core visual principles and aesthetic direction"
+  fields:
+    - name: design_principles
+      type: array
+      description: "3-5 guiding principles for visual design"
+    - name: mood_keywords
+      type: array
+      description: "Keywords capturing the visual mood"
+    - name: inspiration_references
+      type: array
+      description: "Visual references and mood board elements"
+
+typography_rationale:
+  description: "Font selection rationale and typographic hierarchy"
+  fields:
+    - name: primary_font
+      type: object
+      description: "Primary typeface and why it was chosen"
+    - name: secondary_font
+      type: object
+      description: "Secondary typeface for contrast"
+    - name: hierarchy_rules
+      type: array
+      description: "Heading, body, caption sizing rationale"
+
+color_philosophy:
+  description: "Color palette rationale and emotional associations"
+  fields:
+    - name: primary_palette
+      type: array
+      description: "Primary colors with emotional rationale"
+    - name: semantic_mapping
+      type: object
+      description: "Color-to-meaning mapping (success, warning, error)"
+    - name: accessibility_notes
+      type: string
+      description: "WCAG contrast compliance notes"
+
+spacing_rhythm:
+  description: "Spacing scale rationale and rhythm system"
+  fields:
+    - name: base_unit
+      type: number
+      description: "Base spacing unit in pixels"
+    - name: scale_rationale
+      type: string
+      description: "Why this scale was chosen (4px, 8px, etc.)"
+    - name: rhythm_rules
+      type: array
+      description: "Rules for consistent vertical and horizontal rhythm"
+
+iconography_style:
+  description: "Icon style direction and usage philosophy"
+  fields:
+    - name: style_direction
+      type: string
+      description: "Outlined, filled, duotone, etc."
+    - name: stroke_weight
+      type: string
+      description: "Consistent stroke weight for icon set"
+    - name: metaphor_guidelines
+      type: array
+      description: "Guidelines for icon metaphor selection"
+
+rules:
+  - id: brand-before-tokens
+    text: "Brandbook MUST be completed before design tokens are defined."
+    priority: critical
+  - id: brand-consistency
+    text: "All visual decisions must trace back to brandbook principles."
+    priority: high
+  - id: brand-voice-artifacts
+    text: "All user-facing text in artifacts must follow brand voice guidelines."
+    priority: high

package/framework/templates/component-spec-tmpl.yaml

@@ -0,0 +1,74 @@
+# Component Spec Template
+# Used by: UX Agent (Phase 2: Component Specifications)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Component Spec
+  version: "1.0.0"
+  description: >
+    UI component specification document. Defines variants, states,
+    anatomy, props, accessibility, and responsive behavior.
+
+output_path: chati.dev/artifacts/4-UX/components/
+
+fields:
+  - name: id
+    type: string
+    description: "Unique component identifier (kebab-case)"
+    required: true
+  - name: name
+    type: string
+    description: "Human-readable component name"
+    required: true
+  - name: category
+    type: enum
+    values: [primitive, composite, layout, feedback, navigation, data-display, form]
+    description: "Component category for organization"
+    required: true
+  - name: description
+    type: string
+    description: "One-sentence description of the component purpose"
+    required: true
+  - name: variants
+    type: array
+    description: "Visual variants (primary, secondary, ghost, destructive, etc.)"
+    required: true
+  - name: sizes
+    type: array
+    description: "Size variants (xs, sm, md, lg, xl)"
+    required: true
+  - name: states
+    type: array
+    description: "Interactive states (default, hover, active, focus, disabled, loading, error)"
+    required: true
+  - name: anatomy
+    type: object
+    description: "Component parts and their structure"
+    required: true
+  - name: props
+    type: array
+    description: "Component API (props with types, defaults, descriptions)"
+    required: true
+  - name: tokens_used
+    type: array
+    description: "Design tokens consumed by this component"
+    required: true
+  - name: accessibility
+    type: object
+    description: "ARIA roles, keyboard navigation, screen reader behavior"
+    required: true
+  - name: responsive_behavior
+    type: object
+    description: "How component adapts across breakpoints"
+    required: false
+
+rules:
+  - id: tokens-required
+    text: "Every visual property MUST reference a design token. No hardcoded values."
+    priority: critical
+  - id: accessibility-required
+    text: "Every component MUST have ARIA roles and keyboard navigation defined."
+    priority: critical
+  - id: state-coverage
+    text: "All interactive states must be specified including disabled and loading."
+    priority: high

package/framework/templates/design-token-tmpl.yaml

@@ -0,0 +1,55 @@
+# Design Token Template
+# Used by: UX Agent (Phase 1: Design Tokens)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Design Tokens
+  version: "1.0.0"
+  description: >
+    Structured design token system with 4 layers: primitive, semantic,
+    component, and utility. Derived from brandbook decisions.
+
+output_path: chati.dev/artifacts/4-UX/design-tokens.md
+
+layers:
+  - primitive
+  - semantic
+  - component
+  - utility
+
+token_categories:
+  color:
+    primitive: "Raw color values (hex, hsl)"
+    semantic: "Mapped to meaning (primary, success, error)"
+    component: "Component-specific (button-bg, card-border)"
+  spacing:
+    primitive: "Base unit multiples (4, 8, 12, 16, 24, 32, 48, 64)"
+    semantic: "Mapped to usage (compact, default, relaxed)"
+    component: "Component-specific (card-padding, input-gap)"
+  typography:
+    primitive: "Font families, raw sizes, weights"
+    semantic: "Mapped to roles (heading, body, caption, label)"
+    component: "Component-specific (button-text, input-label)"
+  radius:
+    primitive: "Raw radius values (0, 2, 4, 8, 12, full)"
+    semantic: "Mapped to shape intent (sharp, soft, round, pill)"
+  shadow:
+    primitive: "Raw shadow definitions (offset, blur, spread, color)"
+    semantic: "Mapped to elevation (flat, raised, floating, overlay)"
+  motion:
+    primitive: "Duration and easing values"
+    semantic: "Mapped to intent (enter, exit, emphasis, feedback)"
+
+rules:
+  - id: tokens-after-brandbook
+    text: "Design tokens MUST be derived from brandbook decisions."
+    priority: critical
+  - id: primitive-first
+    text: "Define primitive tokens before semantic. Semantic references primitive."
+    priority: high
+  - id: token-naming
+    text: "Use consistent naming: layer-category-variant (e.g., color-primary-500)."
+    priority: high
+  - id: accessibility-contrast
+    text: "All text color tokens must meet WCAG AA contrast ratio (4.5:1)."
+    priority: critical

package/framework/templates/icon-system-tmpl.yaml

@@ -0,0 +1,95 @@
+# Icon System Template
+# Used by: UX Agent (Phase 0: Brand Identity / Iconography)
+# Language: English (Constitution Article VII)
+
+template:
+  name: Icon System
+  version: "1.0.0"
+  description: >
+    Icon library selection, sizing scale, usage guidelines, and inventory.
+    Aligned with brandbook iconography style.
+
+output_path: chati.dev/artifacts/4-UX/icon-system.md
+
+sections:
+  library_selection:
+    description: "Chosen icon library and rationale"
+    fields:
+      - name: library_name
+        type: string
+        description: "Selected icon library (e.g., Lucide, Phosphor, Heroicons)"
+      - name: rationale
+        type: string
+        description: "Why this library was chosen"
+      - name: style
+        type: enum
+        values: [outlined, filled, duotone, solid]
+        description: "Icon style variant"
+      - name: license
+        type: string
+        description: "Icon library license (MIT, Apache, etc.)"
+
+  sizing_scale:
+    description: "Icon size scale aligned with spacing tokens"
+    fields:
+      - name: xs
+        type: number
+        description: "Extra small icon size (12-14px)"
+      - name: sm
+        type: number
+        description: "Small icon size (16px)"
+      - name: md
+        type: number
+        description: "Medium icon size (20-24px)"
+      - name: lg
+        type: number
+        description: "Large icon size (28-32px)"
+      - name: xl
+        type: number
+        description: "Extra large icon size (40-48px)"
+      - name: xxl
+        type: number
+        description: "Display icon size (56-64px)"
+
+  usage_guidelines:
+    description: "Rules for consistent icon usage"
+    fields:
+      - name: with_text
+        type: string
+        description: "When to pair icons with text labels"
+      - name: standalone
+        type: string
+        description: "When icons can stand alone (with aria-label)"
+      - name: color_rules
+        type: string
+        description: "How icons inherit or override color tokens"
+      - name: touch_target
+        type: string
+        description: "Minimum touch target size (44x44px for mobile)"
+
+  icon_inventory:
+    description: "Catalog of icons used in the project"
+    fields:
+      - name: navigation
+        type: array
+        description: "Icons used in navigation elements"
+      - name: actions
+        type: array
+        description: "Icons for user actions (add, edit, delete, etc.)"
+      - name: status
+        type: array
+        description: "Icons for status indicators (success, warning, error, info)"
+      - name: content
+        type: array
+        description: "Icons for content types (file, folder, image, etc.)"
+
+rules:
+  - id: icon-library-consistency
+    text: "Use ONE icon library per project. Do not mix libraries."
+    priority: critical
+  - id: icon-accessibility
+    text: "Standalone icons MUST have aria-label. Decorative icons use aria-hidden."
+    priority: critical
+  - id: icon-sizing-alignment
+    text: "Icon sizes must align with the spacing token scale from design tokens."
+    priority: high

package/package.json

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

package/scripts/bundle-framework.js

@@ -37,7 +37,7 @@ const dirs = [
   'schemas', 'frameworks', 'intelligence', 'patterns',
   'hooks', 'domains',
   'i18n', 'migrations', 'data',
-  'tasks', 'context',
+  'tasks', 'context', 'presets',
 ];
 
 for (const dir of dirs) {

package/scripts/doctor/checks/agents.js

@@ -0,0 +1,77 @@
+/**
+ * @fileoverview Doctor check: Agent definition files.
+ *
+ * Validates that all 13 agent definition files exist with valid structure.
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+const EXPECTED_AGENTS = {
+  'discover/greenfield-wu.md': 'greenfield-wu',
+  'discover/brownfield-wu.md': 'brownfield-wu',
+  'discover/brief.md': 'brief',
+  'plan/detail.md': 'detail',
+  'plan/architect.md': 'architect',
+  'plan/ux.md': 'ux',
+  'plan/phases.md': 'phases',
+  'plan/tasks.md': 'tasks',
+  'quality/qa-planning.md': 'qa-planning',
+  'quality/qa-implementation.md': 'qa-implementation',
+  'build/dev.md': 'dev',
+  'deploy/devops.md': 'devops',
+};
+
+/**
+ * Run agents check.
+ *
+ * @param {string} frameworkDir - Path to framework directory
+ * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
+ */
+export function checkAgents(frameworkDir) {
+  const agentsDir = join(frameworkDir, 'agents');
+  const orchestratorDir = join(frameworkDir, 'orchestrator');
+
+  const missing = [];
+  const invalid = [];
+
+  for (const [relPath, name] of Object.entries(EXPECTED_AGENTS)) {
+    const fullPath = join(agentsDir, relPath);
+    if (!existsSync(fullPath)) {
+      missing.push(name);
+      continue;
+    }
+    try {
+      const content = readFileSync(fullPath, 'utf8');
+      if (!content.includes('## Identity') && !content.includes('## Mission')) {
+        invalid.push(name);
+      }
+    } catch {
+      invalid.push(name);
+    }
+  }
+
+  // Check orchestrator
+  const orchPath = join(orchestratorDir, 'chati.md');
+  if (!existsSync(orchPath)) {
+    missing.push('orchestrator');
+  }
+
+  const total = Object.keys(EXPECTED_AGENTS).length + 1;
+  const found = total - missing.length;
+
+  if (missing.length > 0 || invalid.length > 0) {
+    const issues = [];
+    if (missing.length) issues.push(`missing: ${missing.join(', ')}`);
+    if (invalid.length) issues.push(`invalid: ${invalid.join(', ')}`);
+    return {
+      pass: false,
+      details: `${found}/${total} agents found; ${issues.join('; ')}`,
+      severity: missing.length > 0 ? 'critical' : 'warning',
+      fixable: false,
+      fixId: null,
+    };
+  }
+
+  return { pass: true, details: `${found}/${total} agents present`, severity: 'info', fixable: false, fixId: null };
+}

package/scripts/doctor/checks/constitution.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Doctor check: Constitution integrity.
+ *
+ * Validates constitution.md exists and contains the expected number of articles.
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Run constitution integrity check.
+ *
+ * @param {string} frameworkDir - Path to framework directory
+ * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
+ */
+export function checkConstitution(frameworkDir) {
+  const constPath = join(frameworkDir, 'constitution.md');
+  if (!existsSync(constPath)) {
+    return { pass: false, details: 'constitution.md not found', severity: 'critical', fixable: false, fixId: null };
+  }
+
+  try {
+    const content = readFileSync(constPath, 'utf8');
+    const articleMatches = content.match(/^## Article [IVXLCDM]+/gm) || [];
+    const articleCount = articleMatches.length;
+
+    if (articleCount < 10) {
+      return {
+        pass: false,
+        details: `Only ${articleCount} articles found (expected 10+)`,
+        severity: 'warning',
+        fixable: false,
+        fixId: null,
+      };
+    }
+
+    return { pass: true, details: `${articleCount} articles found`, severity: 'info', fixable: false, fixId: null };
+  } catch (err) {
+    return { pass: false, details: `Failed to read: ${err.message}`, severity: 'critical', fixable: false, fixId: null };
+  }
+}

package/scripts/doctor/checks/domain-alignment.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Doctor check: Domain-Agent alignment.
+ *
+ * Validates that each agent domain YAML has a corresponding agent .md file.
+ */
+
+import { existsSync, readdirSync } from 'fs';
+import { join, basename } from 'path';
+
+/**
+ * Run domain-agent alignment check.
+ *
+ * @param {string} frameworkDir - Path to framework directory
+ * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
+ */
+export function checkDomainAlignment(frameworkDir) {
+  const domainsDir = join(frameworkDir, 'domains', 'agents');
+  if (!existsSync(domainsDir)) {
+    return { pass: false, details: 'domains/agents/ directory not found', severity: 'warning', fixable: false, fixId: null };
+  }
+
+  const domainFiles = readdirSync(domainsDir).filter(f => f.endsWith('.yaml'));
+  const mismatches = [];
+
+  for (const file of domainFiles) {
+    const agentName = basename(file, '.yaml');
+
+    // Orchestrator has a different path
+    if (agentName === 'orchestrator') {
+      if (!existsSync(join(frameworkDir, 'orchestrator', 'chati.md'))) {
+        mismatches.push('orchestrator');
+      }
+      continue;
+    }
+
+    // Other agents: check all category dirs
+    const agentDirs = ['agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy'];
+    const found = agentDirs.some(dir =>
+      existsSync(join(frameworkDir, dir, `${agentName}.md`))
+    );
+
+    if (!found) {
+      mismatches.push(agentName);
+    }
+  }
+
+  if (mismatches.length > 0) {
+    return {
+      pass: false,
+      details: `Mismatched agents: ${mismatches.join(', ')}`,
+      severity: 'warning',
+      fixable: false,
+      fixId: null,
+    };
+  }
+
+  return { pass: true, details: `${domainFiles.length} domain-agent pairs aligned`, severity: 'info', fixable: false, fixId: null };
+}

package/scripts/doctor/checks/prism-layers.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Doctor check: PRISM Layer integrity.
+ *
+ * Validates that all 6 PRISM layers (L0-L5) have the required
+ * domain files and configuration in place.
+ */
+
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Run PRISM layers integrity check.
+ *
+ * @param {string} frameworkDir - Path to framework directory
+ * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
+ */
+export function checkPrismLayers(frameworkDir) {
+  const domainsDir = join(frameworkDir, 'domains');
+  if (!existsSync(domainsDir)) {
+    return { pass: false, details: 'domains/ directory not found', severity: 'critical', fixable: false, fixId: null };
+  }
+
+  const issues = [];
+
+  // L0: Constitution domain
+  const constitutionDomain = join(domainsDir, 'constitution.yaml');
+  if (!existsSync(constitutionDomain)) {
+    issues.push('L0: constitution.yaml missing');
+  }
+
+  // L1: Global domain
+  const globalDomain = join(domainsDir, 'global.yaml');
+  if (!existsSync(globalDomain)) {
+    issues.push('L1: global.yaml missing');
+  }
+
+  // L2: Agent domains
+  const agentsDir = join(domainsDir, 'agents');
+  if (!existsSync(agentsDir)) {
+    issues.push('L2: agents/ directory missing');
+  } else {
+    const agentDomains = readdirSync(agentsDir).filter(f => f.endsWith('.yaml'));
+    if (agentDomains.length < 12) {
+      issues.push(`L2: only ${agentDomains.length}/12 agent domains found`);
+    }
+  }
+
+  // L3: Workflow domains
+  const workflowsDir = join(domainsDir, 'workflows');
+  if (!existsSync(workflowsDir)) {
+    issues.push('L3: workflows/ directory missing');
+  }
+
+  // L4: Task context (checked via task domain files or inline)
+  // L4 is dynamic (loaded from handoff data), so we check that the task
+  // processing layer module exists
+  const l4Module = join(frameworkDir, '..', 'src', 'context', 'layers', 'l4-task.js');
+  if (!existsSync(l4Module)) {
+    issues.push('L4: l4-task.js module missing');
+  }
+
+  // L5: Keywords domains
+  const keywordsDir = join(domainsDir, 'keywords');
+  if (!existsSync(keywordsDir)) {
+    issues.push('L5: keywords/ directory missing');
+  } else {
+    const keywordFiles = readdirSync(keywordsDir).filter(f => f.endsWith('.yaml'));
+    if (keywordFiles.length === 0) {
+      issues.push('L5: no keyword domain files found');
+    }
+  }
+
+  if (issues.length > 0) {
+    return {
+      pass: false,
+      details: issues.join('; '),
+      severity: issues.some(i => i.includes('L0') || i.includes('L1')) ? 'critical' : 'warning',
+      fixable: false,
+      fixId: null,
+    };
+  }
+
+  return { pass: true, details: 'All 6 PRISM layers (L0-L5) validated', severity: 'info', fixable: false, fixId: null };
+}