chati-dev 4.2.2 → 4.3.0

package/src/utils/flatten-entities.js

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Shared entity-flattening utilities.
+ *
+ * Two variants exist because the registry YAML stores entities in two different
+ * shapes depending on who reads it:
+ *
+ * - flattenEntitiesFromRegistry: receives the full registry object
+ *   (i.e. the result of yaml.load()), where each category's value is an Array.
+ *   Used by decision/analyzer.js and decision/engine.js.
+ *
+ * - flattenEntitiesMap: receives only the `registry.entities` map,
+ *   where each category's value is a nested object keyed by entity name.
+ *   Used by intelligence/registry-manager.js.
+ *
+ * Keep both functions here so there is a single canonical implementation.
+ */
+
+/**
+ * Flatten a full entity registry (as returned by yaml.load) into a flat array.
+ *
+ * Each category value must be an Array of entity objects.
+ * The `type` field is inferred from the category key.
+ *
+ * @param {object} registry - Full registry object with a top-level `entities` key.
+ * @returns {object[]} Flat array of entity objects, each with a `type` field added.
+ */
+export function flattenEntitiesFromRegistry(registry) {
+  const entities = [];
+
+  if (!registry || !registry.entities) {
+    return entities;
+  }
+
+  Object.entries(registry.entities).forEach(([type, typeEntities]) => {
+    if (Array.isArray(typeEntities)) {
+      typeEntities.forEach(entity => {
+        entities.push({ ...entity, type });
+      });
+    }
+  });
+
+  return entities;
+}
+
+/**
+ * Flatten the `entities` section of the registry (a nested object map) into a flat array.
+ *
+ * Each category value is an object keyed by entity name, where the value is the entity.
+ * Only entities with a `path` property are included.
+ *
+ * @param {object|null|undefined} entities - The `registry.entities` map.
+ * @returns {object[]} Flat array of entity objects, each with a `name` field added.
+ */
+export function flattenEntitiesMap(entities) {
+  if (!entities) return [];
+  const flat = [];
+
+  for (const [, items] of Object.entries(entities)) {
+    if (typeof items === 'object' && items !== null) {
+      for (const [name, entity] of Object.entries(items)) {
+        if (entity && entity.path) {
+          flat.push({ name, ...entity });
+        }
+      }
+    }
+  }
+
+  return flat;
+}

package/src/utils/framework-dir.js

@@ -0,0 +1,16 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Resolve the framework directory for a given project.
+ * Supports both new (.chati.dev/) and legacy (chati.dev/) structures.
+ * New structure (v4.2.3+) uses hidden dot prefix.
+ *
+ * @param {string} projectDir - Project root directory
+ * @returns {string} Framework directory name ('.chati.dev' or 'chati.dev')
+ */
+export function resolveFrameworkDir(projectDir) {
+  const newPath = join(projectDir, '.chati.dev');
+  if (existsSync(newPath)) return '.chati.dev';
+  return 'chati.dev'; // Legacy fallback
+}

package/src/utils/model-id.js

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Claude model-id parser — single point of truth.
+ *
+ * Consumers everywhere (provider-limits, prism-engine, status handler,
+ * session boot) call parseClaudeModelId() to convert ANY Claude model
+ * string into a stable `family[variant]` key. Without this unification,
+ * we end up with drift — prism-engine.js historically hard-coded its own
+ * variant-blind map, which is how Opus 1M users got false DEPLETED
+ * alerts at 10% context used.
+ *
+ * Canonical output key format: `<family>` or `<family>[<variant>]`
+ *   opus, opus[1m], sonnet, sonnet[1m], haiku
+ *
+ * Input tolerance:
+ *   - full id:      claude-opus-4-7, claude-opus-4-7[1m], claude-haiku-4-5-20251001
+ *   - dated id:     claude-3-5-sonnet-20241022
+ *   - bare family:  opus, sonnet, haiku
+ *   - variant syntax: [1m], (1m), :1m  (all equivalent)
+ *   - case:         any case, output is lowercase
+ *   - whitespace:   trimmed
+ *
+ * Returns `null` (not throws) for anything the parser cannot identify as
+ * a known Claude family — downstream code treats `null` as "unknown,
+ * fall through to provider/agent defaults".
+ */
+
+const FAMILIES = new Set(['opus', 'sonnet', 'haiku']);
+
+/**
+ * @typedef {object} ParsedModelId
+ * @property {'opus'|'sonnet'|'haiku'} family
+ * @property {'default'|'1m'|string} variant
+ * @property {string} normalized - e.g. 'opus', 'opus[1m]'
+ * @property {'claude'} provider
+ */
+
+/**
+ * Parse a Claude model id (from env var, hook event, transcript, config)
+ * into its canonical `family[variant]` shape.
+ *
+ * @param {string} raw
+ * @returns {ParsedModelId | null}
+ */
+export function parseClaudeModelId(raw) {
+  if (typeof raw !== 'string') return null;
+
+  const s = raw.trim().toLowerCase();
+  if (!s) return null;
+
+  // 1) Extract variant hint if present. Accept [1m], (1m), :1m — settle on [].
+  let variant = 'default';
+  let body = s;
+  const variantMatch = body.match(/[[(:]\s*(1m)\s*\)?\]?$/);
+  if (variantMatch) {
+    variant = variantMatch[1]; // '1m'
+    body = body.slice(0, variantMatch.index).trim();
+  }
+
+  // 2) Find the family token. In canonical ids it appears between dashes;
+  //    a bare family ('opus', 'sonnet', 'haiku') is also accepted.
+  let family = null;
+  for (const candidate of FAMILIES) {
+    // Word-boundary match so 'opus' in 'opuschatter' does not falsely match.
+    const re = new RegExp(`(^|-)${candidate}(-|$)`);
+    if (re.test(body)) {
+      family = candidate;
+      break;
+    }
+  }
+  if (!family) return null;
+
+  const normalized = variant === 'default' ? family : `${family}[${variant}]`;
+
+  return { family, variant, normalized, provider: 'claude' };
+}
+
+/**
+ * Convenience: return just the normalized string (or null).
+ * @param {string} raw
+ * @returns {string | null}
+ */
+export function normalizeModelId(raw) {
+  const parsed = parseClaudeModelId(raw);
+  return parsed ? parsed.normalized : null;
+}

package/src/utils/provider-limits.js

@@ -1,44 +1,105 @@
 /**
  * @fileoverview Canonical context window limits by provider and model.
  *
- * Single source of truth for token limits used by
- * bracket-tracker, context-status, prompt-builder, and prism-engine hook.
+ * Single source of truth for token limits used by bracket-tracker,
+ * context-status, prompt-builder, and the prism-engine hook.
  *
- * SYNC: chati.dev/hooks/prism-engine.js has an inline copy of MODEL_LIMITS.
- * If you update here, update there too.
+ * The table itself lives in `chati.dev/data/model-limits.json` (canonical)
+ * and mirrors into `packages/chati-dev/framework/data/model-limits.json`
+ * at sync time. This module loads the JSON at import time via a resolution
+ * chain (bundled > monorepo > in-tree). Scan check #25 asserts the exports
+ * here equal the JSON to catch any drift between consumers.
  */
 
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { parseClaudeModelId } from './model-id.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Resolution chain for model-limits.json:
+//   1. Bundled with the package:    {pkgRoot}/framework/data/model-limits.json
+//   2. Monorepo canonical (dev):    {repoRoot}/chati.dev/data/model-limits.json
+const CANDIDATE_PATHS = [
+  join(__dirname, '..', '..', 'framework', 'data', 'model-limits.json'),
+  join(__dirname, '..', '..', '..', '..', 'chati.dev', 'data', 'model-limits.json'),
+];
+
+function loadLimits() {
+  for (const candidate of CANDIDATE_PATHS) {
+    if (existsSync(candidate)) {
+      return JSON.parse(readFileSync(candidate, 'utf-8'));
+    }
+  }
+  // Last-resort embedded fallback — matches model-limits.json verbatim.
+  // Scan check #25 asserts parity between this block and the JSON so drift
+  // is caught at CI time. Any active install has the JSON present; this
+  // branch exists so unit tests that run the module without sync still work.
+  // 2026-04-18 (context-window-auto-detect-v2): opus family is 1M by default.
+  return {
+    providers: { claude: 1_000_000, gemini: 1_000_000, codex: 128_000 },
+    models: {
+      opus:         1_000_000,
+      'opus[1m]':   1_000_000,
+      sonnet:       1_000_000,
+      'sonnet[1m]': 1_000_000,
+      haiku:        200_000,
+      pro:          1_000_000,
+      flash:        1_000_000,
+      codex:        128_000,
+    },
+  };
+}
+
+const _data = loadLimits();
+
 /** Provider context window limits (tokens) — fallback when model unknown. */
-export const PROVIDER_LIMITS = {
-  claude: 200_000,
-  gemini: 1_000_000,
-  codex: 128_000,
-};
+export const PROVIDER_LIMITS = Object.freeze({ ...(_data.providers || {}) });
 
 /**
  * Model-specific context window limits (tokens).
  * Takes precedence over PROVIDER_LIMITS when model tier is known.
+ * Keys are the `normalized` output of parseClaudeModelId() — e.g.
+ * "opus", "opus[1m]", "sonnet", "haiku" — plus bare provider models
+ * ("pro", "flash", "codex") for other CLIs.
  */
-export const MODEL_LIMITS = {
-  // Claude models
-  opus: 1_000_000,
-  sonnet: 200_000,
-  haiku: 200_000,
-  // Gemini models
-  pro: 1_000_000,
-  flash: 1_000_000,
-  // Codex models
-  codex: 128_000,
-};
+export const MODEL_LIMITS = Object.freeze({ ...(_data.models || {}) });
 
 /**
  * Resolve context window limit: model-specific > provider fallback > default.
- * @param {string} [model] - Model tier (opus, sonnet, haiku, pro, flash, codex)
+ *
+ * The model lookup tries (in order):
+ *   1. Exact key match (e.g. "opus[1m]", "sonnet")
+ *   2. Normalized via parseClaudeModelId (handles "claude-opus-4-7[1m]" input)
+ *   3. Bare family without variant (e.g. "opus[1m]" → "opus")
+ * Then falls through to PROVIDER_LIMITS[provider], then 200_000.
+ *
+ * @param {string} [model] - Normalized key OR raw Claude id
  * @param {string} [provider] - Provider name (claude, gemini, codex)
  * @returns {number} Context window limit in tokens
  */
 export function resolveContextLimit(model, provider) {
-  if (model && MODEL_LIMITS[model]) return MODEL_LIMITS[model];
-  if (provider && PROVIDER_LIMITS[provider]) return PROVIDER_LIMITS[provider];
+  if (model) {
+    // 1. Exact match on the already-normalized key.
+    if (MODEL_LIMITS[model] != null) return MODEL_LIMITS[model];
+
+    // 2. Try parseClaudeModelId to normalize a raw Claude id.
+    const parsed = parseClaudeModelId(model);
+    if (parsed && MODEL_LIMITS[parsed.normalized] != null) {
+      return MODEL_LIMITS[parsed.normalized];
+    }
+
+    // 3. Bare family fallback (variant unknown → family default).
+    if (parsed && MODEL_LIMITS[parsed.family] != null) {
+      return MODEL_LIMITS[parsed.family];
+    }
+  }
+  if (provider && PROVIDER_LIMITS[provider] != null) return PROVIDER_LIMITS[provider];
+  // Final fallback when model + provider are both unknown. 2026-04-18: kept at
+  // 200K as the SAFEST value — an unknown model might be Haiku or an older
+  // Sonnet variant. When the model IS identified, the map above returns the
+  // correct (often 1M) value. This fallback only fires on genuinely-unknown
+  // inputs.
   return 200_000;
 }

package/src/utils/schema-validator.js

@@ -172,7 +172,7 @@ export const SESSION_SCHEMA = {
     pipeline_phase: { type: 'string', enum: ['discover', 'plan', 'build', 'deploy', 'completed'] },
     current_agent: { type: 'string' },
     governance_mode: { type: 'string', enum: ['planning', 'build', 'deploy'] },
-    execution_profile: { type: 'string', enum: ['explore', 'guided', 'autonomous'] },
+    execution_mode: { type: 'string', enum: ['interactive', 'autonomous'] },
     context_bracket: { type: 'string', enum: ['FRESH', 'MODERATE', 'DEPLETED', 'CRITICAL'] },
   },
 };

package/src/wizard/i18n.js

@@ -2,6 +2,7 @@ import { readFileSync, existsSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import yaml from 'js-yaml';
+import { resolveFrameworkDir } from '../utils/framework-dir.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -38,7 +39,7 @@ const FALLBACK_EN = {
     agents_count: 'Specialized agent definitions across DISCOVER, PLAN, BUILD, DEPLOY phases',
     workflows_count: '6 workflow blueprints',
     templates_count: '6 templates (PRD, Brownfield PRD, Architecture, Task, QA Gate, Quick Brief)',
-    constitution: 'Constitution (19 Articles + Preamble)',
+    constitution: 'Constitution (23 Articles + Preamble)',
     session_mgmt: 'Session management system',
     quality_gates: 'Quality gates (3-tier verdicts)',
     proceed: 'Proceed with installation?',
@@ -46,7 +47,7 @@ const FALLBACK_EN = {
     created_chati: 'Created .chati/ session directory',
     created_framework: 'Created chati.dev/ system directory (agents, templates, workflows)',
     created_commands: 'Created .claude/commands/ (thin router)',
-    installed_constitution: 'Installed Constitution (Articles I-XIX)',
+    installed_constitution: 'Installed Constitution (Articles I-XXIII)',
     created_session: 'Created session.yaml schema',
     created_claude_md: 'Created CLAUDE.md',
     configured_mcps: 'Configured MCPs:',
@@ -54,7 +55,7 @@ const FALLBACK_EN = {
     agents_valid: 'All agents implement 8 protocols',
     handoff_ok: 'Handoff protocol: OK',
     validation_ok: 'Self-validation criteria: OK',
-    constitution_ok: 'Constitution: 19 articles verified',
+    constitution_ok: 'Constitution: 23 articles verified',
     created_memories: 'Created .chati/memories/ (Memory Layer)',
     installed_intelligence: 'Installed Intelligence Layer (Context Engine, Memory, Registry)',
     intelligence_valid: 'Intelligence: 6 spec files verified',
@@ -126,7 +127,7 @@ export function loadLanguage(lang, targetDir = null) {
 
   // Try to load from installed project i18n
   const paths = [
-    targetDir && join(targetDir, 'chati.dev', 'i18n', `${lang}.yaml`),
+    targetDir && join(targetDir, resolveFrameworkDir(targetDir), 'i18n', `${lang}.yaml`),
     join(__dirname, '..', '..', 'assets', 'i18n', `${lang}.yaml`),
   ].filter(Boolean);
 

package/src/wizard/index.js

@@ -38,6 +38,20 @@ export async function runWizard(targetDir, options = {}) {
 
   await runLicenseActivationStep();
 
+  // Preflight: validate system prerequisites (Node >= 20, npm, Git, Playwright)
+  const { runPreflightCheck } = await import('../installer/preflight.js');
+  const preflight = await runPreflightCheck();
+  const preflightFmt = preflight.checks.map(c => {
+    const icon = c.status === 'pass' ? '✓' : c.status === 'warn' ? '⚠' : '✗';
+    return `  ${icon} ${c.message}`;
+  }).join('\n');
+  if (!preflight.passed) {
+    p.log.error(`System prerequisites not met:\n${preflightFmt}`);
+    p.cancel('Fix the issues above and try again.');
+    process.exit(1);
+  }
+  p.log.success(`System check:\n${preflightFmt}`);
+
   // Step 2: Language Selection
   const language = options.language || await stepLanguage();
 

package/assets/logo.svg

@@ -1,42 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 620 200">
-  <defs>
-    <clipPath id="c">
-      <path d="M100,8 C155,8 190,40 190,90 C190,140 155,172 100,172 C82,172 66,167 52,159 L22,192 L34,155 C18,140 10,118 10,90 C10,40 45,8 100,8 Z"/>
-    </clipPath>
-    <radialGradient id="g" cx="38%" cy="30%" r="68%">
-      <stop offset="0%" stop-color="#8EC5F5"/>
-      <stop offset="40%" stop-color="#5DA2E2"/>
-      <stop offset="75%" stop-color="#4A90D9"/>
-      <stop offset="100%" stop-color="#2D6BAF"/>
-    </radialGradient>
-    <linearGradient id="r" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="rgba(255,255,255,0.5)"/>
-      <stop offset="30%" stop-color="rgba(255,255,255,0.15)"/>
-      <stop offset="100%" stop-color="rgba(0,0,0,0)"/>
-    </linearGradient>
-    <linearGradient id="bs" x1="0" y1="0" x2="0" y2="1">
-      <stop offset="0%" stop-color="rgba(0,0,0,0)"/>
-      <stop offset="65%" stop-color="rgba(0,0,0,0)"/>
-      <stop offset="100%" stop-color="rgba(15,30,60,0.25)"/>
-    </linearGradient>
-  </defs>
-
-  <!-- Chat bubble -->
-  <path d="M100,8 C155,8 190,40 190,90 C190,140 155,172 100,172 C82,172 66,167 52,159 L22,192 L34,155 C18,140 10,118 10,90 C10,40 45,8 100,8 Z" fill="url(#g)"/>
-  <ellipse cx="82" cy="38" rx="52" ry="25" fill="rgba(255,255,255,0.18)" clip-path="url(#c)"/>
-  <path d="M100,8 C155,8 190,40 190,90 C190,140 155,172 100,172 C82,172 66,167 52,159 L22,192 L34,155 C18,140 10,118 10,90 C10,40 45,8 100,8 Z" fill="url(#bs)" clip-path="url(#c)"/>
-  <path d="M100,8 C155,8 190,40 190,90 C190,140 155,172 100,172 C82,172 66,167 52,159 L22,192 L34,155 C18,140 10,118 10,90 C10,40 45,8 100,8 Z" fill="none" stroke="url(#r)" stroke-width="1.5"/>
-
-  <!-- Eyes -->
-  <ellipse cx="72" cy="95" rx="18" ry="20" fill="#1a1a2e"/>
-  <ellipse cx="128" cy="95" rx="18" ry="20" fill="#1a1a2e"/>
-  <ellipse cx="65" cy="86" rx="7" ry="5" fill="rgba(255,255,255,0.55)"/>
-  <ellipse cx="121" cy="86" rx="7" ry="5" fill="rgba(255,255,255,0.55)"/>
-  <ellipse cx="77" cy="100" rx="3.5" ry="2.5" fill="rgba(255,255,255,0.3)"/>
-  <ellipse cx="133" cy="100" rx="3.5" ry="2.5" fill="rgba(255,255,255,0.3)"/>
-
-  <!-- "Chati.dev" text inline -->
-  <text x="210" y="122" font-family="ui-monospace,'SF Mono','Menlo','Consolas','Liberation Mono',monospace" font-weight="700" font-size="68" letter-spacing="-1">
-    <tspan fill="#e6edf3">Chati</tspan><tspan fill="#4A90D9">.</tspan><tspan fill="#e6edf3">dev</tspan>
-  </text>
-</svg>

package/scripts/bundle-framework.js

@@ -1,69 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Bundle framework files into the npm package.
- * Run before `npm publish` — copies chati.dev/ source files
- * into packages/chati-dev/framework/ so they ship with the package.
- */
-
-import { cpSync, mkdirSync, rmSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const PACKAGE_ROOT = join(__dirname, '..');
-const MONOREPO_ROOT = join(PACKAGE_ROOT, '..', '..');
-const SOURCE = join(MONOREPO_ROOT, 'chati.dev');
-const DEST = join(PACKAGE_ROOT, 'framework');
-
-if (!existsSync(SOURCE)) {
-  console.error('Error: chati.dev/ source directory not found at:', SOURCE);
-  process.exit(1);
-}
-
-// Clean previous bundle
-if (existsSync(DEST)) {
-  rmSync(DEST, { recursive: true });
-}
-
-// Copy framework files
-console.log('Bundling framework files...');
-mkdirSync(DEST, { recursive: true });
-
-const dirs = [
-  'orchestrator',
-  'agents/discover', 'agents/plan', 'agents/quality', 'agents/build', 'agents/deploy',
-  'templates', 'workflows', 'quality-gates',
-  'schemas', 'frameworks', 'intelligence', 'patterns',
-  'hooks', 'domains',
-  'i18n', 'migrations', 'data',
-  'tasks', 'context', 'presets',
-];
-
-for (const dir of dirs) {
-  const src = join(SOURCE, dir);
-  if (existsSync(src)) {
-    cpSync(src, join(DEST, dir), { recursive: true });
-  }
-}
-
-// Copy root files
-const rootFiles = ['constitution.md', 'config.yaml'];
-for (const file of rootFiles) {
-  const src = join(SOURCE, file);
-  if (existsSync(src)) {
-    cpSync(src, join(DEST, file));
-  }
-}
-
-console.log('Framework bundled to:', DEST);
-
-// Copy README from monorepo root so npm displays it
-const readmeSrc = join(MONOREPO_ROOT, 'README.md');
-const readmeDest = join(PACKAGE_ROOT, 'README.md');
-if (existsSync(readmeSrc)) {
-  cpSync(readmeSrc, readmeDest);
-  console.log('README.md copied to package.');
-}
-
-console.log('Done.');