chati-dev 2.1.2 → 3.0.1

package/src/autonomy/build-state.js

@@ -0,0 +1,269 @@
+/**
+ * @fileoverview Build state manager with checkpoint-based persistence.
+ *
+ * Manages the state of autonomous build execution, including
+ * checkpoints saved after each task completion, abandoned build
+ * detection, and attempt logging.
+ *
+ * Constitution Article XVII — Execution Mode Governance.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+/** Maximum iterations per individual task before giving up */
+export const MAX_ITERATIONS_PER_TASK = 10;
+
+/** Global timeout for an autonomous build session (30 minutes) */
+export const GLOBAL_TIMEOUT_MS = 30 * 60 * 1000;
+
+/** Time after which a build is considered abandoned (1 hour) */
+export const ABANDONED_THRESHOLD_MS = 60 * 60 * 1000;
+
+/**
+ * Build status enum.
+ * @enum {string}
+ */
+export const BuildStatus = {
+  PENDING: 'pending',
+  IN_PROGRESS: 'in_progress',
+  PAUSED: 'paused',
+  ABANDONED: 'abandoned',
+  FAILED: 'failed',
+  COMPLETED: 'completed',
+};
+
+/**
+ * Task checkpoint status.
+ * @enum {string}
+ */
+export const CheckpointStatus = {
+  PENDING: 'pending',
+  IN_PROGRESS: 'in_progress',
+  COMPLETED: 'completed',
+  FAILED: 'failed',
+  SKIPPED: 'skipped',
+};
+
+// ---------------------------------------------------------------------------
+// State Schema
+// ---------------------------------------------------------------------------
+
+/**
+ * @typedef {object} TaskCheckpoint
+ * @property {string} taskId
+ * @property {string} status - CheckpointStatus
+ * @property {number} attempts - Number of execution attempts
+ * @property {string|null} lastAttempt - ISO timestamp of last attempt
+ * @property {string|null} output - Last output summary
+ * @property {string|null} error - Last error message (if failed)
+ */
+
+/**
+ * @typedef {object} BuildState
+ * @property {string} sessionId - Build session identifier
+ * @property {string} status - BuildStatus
+ * @property {TaskCheckpoint[]} checkpoints - Per-task checkpoints
+ * @property {string} startedAt - ISO timestamp
+ * @property {string|null} lastCheckpoint - ISO timestamp of last checkpoint
+ * @property {string|null} completedAt - ISO timestamp of completion
+ * @property {number} totalAttempts - Total execution attempts across all tasks
+ */
+
+const BUILD_STATE_FILE = '.chati/build-state.json';
+
+// ---------------------------------------------------------------------------
+// State Management
+// ---------------------------------------------------------------------------
+
+/**
+ * Initialize a new build state.
+ *
+ * @param {string[]} taskIds - Array of task IDs to execute
+ * @returns {BuildState}
+ */
+export function createBuildState(taskIds) {
+  return {
+    sessionId: `build-${Date.now()}`,
+    status: BuildStatus.PENDING,
+    checkpoints: taskIds.map((taskId) => ({
+      taskId,
+      status: CheckpointStatus.PENDING,
+      attempts: 0,
+      lastAttempt: null,
+      output: null,
+      error: null,
+    })),
+    startedAt: new Date().toISOString(),
+    lastCheckpoint: null,
+    completedAt: null,
+    totalAttempts: 0,
+  };
+}
+
+/**
+ * Load build state from disk.
+ *
+ * @param {string} projectDir
+ * @returns {BuildState|null}
+ */
+export function loadBuildState(projectDir) {
+  const statePath = join(projectDir, BUILD_STATE_FILE);
+  if (!existsSync(statePath)) return null;
+  try {
+    const state = JSON.parse(readFileSync(statePath, 'utf-8'));
+
+    // Check for abandoned builds
+    if (state.status === BuildStatus.IN_PROGRESS && state.lastCheckpoint) {
+      const elapsed = Date.now() - new Date(state.lastCheckpoint).getTime();
+      if (elapsed > ABANDONED_THRESHOLD_MS) {
+        state.status = BuildStatus.ABANDONED;
+      }
+    }
+
+    return state;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Save build state to disk.
+ *
+ * @param {string} projectDir
+ * @param {BuildState} state
+ */
+export function saveBuildState(projectDir, state) {
+  const statePath = join(projectDir, BUILD_STATE_FILE);
+  mkdirSync(dirname(statePath), { recursive: true });
+  writeFileSync(statePath, JSON.stringify(state, null, 2));
+}
+
+/**
+ * Update a task checkpoint.
+ *
+ * @param {BuildState} state
+ * @param {string} taskId
+ * @param {Partial<TaskCheckpoint>} update
+ * @returns {BuildState}
+ */
+export function updateCheckpoint(state, taskId, update) {
+  const checkpoint = state.checkpoints.find((c) => c.taskId === taskId);
+  if (!checkpoint) {
+    throw new Error(`Task "${taskId}" not found in build state`);
+  }
+
+  Object.assign(checkpoint, update);
+  state.lastCheckpoint = new Date().toISOString();
+
+  if (update.attempts !== undefined) {
+    state.totalAttempts = state.checkpoints.reduce((sum, c) => sum + c.attempts, 0);
+  }
+
+  return state;
+}
+
+/**
+ * Mark the build as started.
+ *
+ * @param {BuildState} state
+ * @returns {BuildState}
+ */
+export function startBuild(state) {
+  state.status = BuildStatus.IN_PROGRESS;
+  state.startedAt = new Date().toISOString();
+  return state;
+}
+
+/**
+ * Mark the build as completed.
+ *
+ * @param {BuildState} state
+ * @returns {BuildState}
+ */
+export function completeBuild(state) {
+  state.status = BuildStatus.COMPLETED;
+  state.completedAt = new Date().toISOString();
+  return state;
+}
+
+/**
+ * Mark the build as failed.
+ *
+ * @param {BuildState} state
+ * @param {string} [reason]
+ * @returns {BuildState}
+ */
+export function failBuild(state, _reason) {
+  state.status = BuildStatus.FAILED;
+  state.completedAt = new Date().toISOString();
+  return state;
+}
+
+/**
+ * Get the next pending task checkpoint.
+ *
+ * @param {BuildState} state
+ * @returns {TaskCheckpoint|null}
+ */
+export function getNextPendingTask(state) {
+  return state.checkpoints.find(
+    (c) => c.status === CheckpointStatus.PENDING || c.status === CheckpointStatus.IN_PROGRESS,
+  ) || null;
+}
+
+/**
+ * Check if a task has exceeded max iterations.
+ *
+ * @param {TaskCheckpoint} checkpoint
+ * @returns {boolean}
+ */
+export function isTaskExhausted(checkpoint) {
+  return checkpoint.attempts >= MAX_ITERATIONS_PER_TASK;
+}
+
+/**
+ * Check if the global timeout has been exceeded.
+ *
+ * @param {BuildState} state
+ * @returns {boolean}
+ */
+export function isTimedOut(state) {
+  const elapsed = Date.now() - new Date(state.startedAt).getTime();
+  return elapsed > GLOBAL_TIMEOUT_MS;
+}
+
+/**
+ * Get build progress summary.
+ *
+ * @param {BuildState} state
+ * @returns {{ total: number, completed: number, failed: number, pending: number, progress: number }}
+ */
+export function getProgress(state) {
+  const total = state.checkpoints.length;
+  const completed = state.checkpoints.filter((c) => c.status === CheckpointStatus.COMPLETED).length;
+  const failed = state.checkpoints.filter((c) => c.status === CheckpointStatus.FAILED).length;
+  const pending = state.checkpoints.filter(
+    (c) => c.status === CheckpointStatus.PENDING || c.status === CheckpointStatus.IN_PROGRESS,
+  ).length;
+  const progress = total > 0 ? Math.round((completed / total) * 100) : 0;
+
+  return { total, completed, failed, pending, progress };
+}
+
+/**
+ * Clear build state (after completion or manual reset).
+ *
+ * @param {string} projectDir
+ */
+export function clearBuildState(projectDir) {
+  const statePath = join(projectDir, BUILD_STATE_FILE);
+  if (existsSync(statePath)) {
+    const { unlinkSync } = require('fs');
+    unlinkSync(statePath);
+  }
+}

package/src/autonomy/execution-profile.js

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview Execution profile manager.
+ *
+ * Manages 3 execution profiles that govern confirmation requirements:
+ * - explore: read-only, no writes
+ * - guided: confirm before writes (default)
+ * - autonomous: full autonomy with quality gates
+ *
+ * Profiles are orthogonal to mode governance (Article XI).
+ * Modes control WHERE; profiles control WHETHER.
+ *
+ * Constitution Article XVIII — Execution Profile Governance.
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+// ---------------------------------------------------------------------------
+// Profile Definitions
+// ---------------------------------------------------------------------------
+
+/**
+ * Execution profile enum.
+ * @enum {string}
+ */
+export const Profile = {
+  /** Read-only. Agents analyze and suggest but perform no writes. */
+  EXPLORE: 'explore',
+  /** Default. Agents propose actions and wait for user confirmation. */
+  GUIDED: 'guided',
+  /** Full autonomy. Agents execute without confirmation when gates pass. */
+  AUTONOMOUS: 'autonomous',
+};
+
+/** Minimum gate score required to activate autonomous profile */
+export const AUTONOMOUS_GATE_THRESHOLD = 90;
+
+/**
+ * Operations that ALWAYS require confirmation regardless of profile.
+ * Constitution Article XVIII, point 4.
+ */
+export const ALWAYS_CONFIRM_OPERATIONS = [
+  'file_delete',
+  'database_drop',
+  'force_push',
+  'deploy_production',
+  'deviation_activate',
+  'backward_transition',
+];
+
+// ---------------------------------------------------------------------------
+// Profile Management
+// ---------------------------------------------------------------------------
+
+/**
+ * Get the current execution profile from session state.
+ *
+ * @param {string} projectDir
+ * @returns {string} Current profile (defaults to 'guided')
+ */
+export function getCurrentProfile(projectDir) {
+  const sessionPath = join(projectDir, '.chati', 'session.yaml');
+  if (!existsSync(sessionPath)) return Profile.GUIDED;
+
+  const raw = readFileSync(sessionPath, 'utf-8');
+  const match = raw.match(/^\s*execution_profile:\s*(.+)$/m);
+  const profile = match ? match[1].trim().replace(/^["']|["']$/g, '') : Profile.GUIDED;
+
+  return Object.values(Profile).includes(profile) ? profile : Profile.GUIDED;
+}
+
+/**
+ * Check if a write operation is allowed under the current profile.
+ *
+ * @param {string} profile - Current execution profile
+ * @param {string} operation - Operation type (e.g., 'file_write', 'file_delete')
+ * @returns {{ allowed: boolean, reason: string }}
+ */
+export function isWriteAllowed(profile, operation) {
+  // Explore profile blocks ALL writes
+  if (profile === Profile.EXPLORE) {
+    return { allowed: false, reason: '[Article XVIII] Explore profile: read-only mode. No writes permitted.' };
+  }
+
+  // Always-confirm operations need user approval regardless of profile
+  if (ALWAYS_CONFIRM_OPERATIONS.includes(operation)) {
+    return { allowed: false, reason: `[Article XVIII] Operation "${operation}" always requires user confirmation.` };
+  }
+
+  // Guided profile: allowed but requires confirmation (caller handles confirmation)
+  if (profile === Profile.GUIDED) {
+    return { allowed: true, reason: 'Guided profile: confirmation required.' };
+  }
+
+  // Autonomous profile: allowed without confirmation
+  if (profile === Profile.AUTONOMOUS) {
+    return { allowed: true, reason: 'Autonomous profile: proceeding without confirmation.' };
+  }
+
+  return { allowed: true, reason: 'Default: allowed.' };
+}
+
+/**
+ * Validate whether autonomous profile can be activated.
+ *
+ * @param {string} projectDir
+ * @returns {{ canActivate: boolean, reason: string, currentScore: number }}
+ */
+export function canActivateAutonomous(projectDir) {
+  const sessionPath = join(projectDir, '.chati', 'session.yaml');
+  if (!existsSync(sessionPath)) {
+    return { canActivate: false, reason: 'No active session', currentScore: 0 };
+  }
+
+  const raw = readFileSync(sessionPath, 'utf-8');
+
+  // Look for most recent QA gate score
+  const scoreMatches = raw.match(/score:\s*([\d.]+)/g);
+  if (!scoreMatches || scoreMatches.length === 0) {
+    return { canActivate: false, reason: 'No gate scores found. Run QA gates first.', currentScore: 0 };
+  }
+
+  const scores = scoreMatches.map((m) => parseFloat(m.replace('score:', '').trim()));
+  const latestScore = scores[scores.length - 1];
+
+  if (latestScore < AUTONOMOUS_GATE_THRESHOLD) {
+    return {
+      canActivate: false,
+      reason: `Gate score ${latestScore}% < required ${AUTONOMOUS_GATE_THRESHOLD}%`,
+      currentScore: latestScore,
+    };
+  }
+
+  return { canActivate: true, reason: 'Gate scores meet threshold', currentScore: latestScore };
+}
+
+/**
+ * Check if autonomous profile should be downgraded due to quality drop.
+ *
+ * @param {number} currentScore - Current quality score
+ * @returns {{ shouldDowngrade: boolean, reason: string }}
+ */
+export function shouldDowngradeAutonomous(currentScore) {
+  if (currentScore < AUTONOMOUS_GATE_THRESHOLD) {
+    return {
+      shouldDowngrade: true,
+      reason: `Quality dropped to ${currentScore}% (< ${AUTONOMOUS_GATE_THRESHOLD}%). Auto-downgrading to guided profile.`,
+    };
+  }
+  return { shouldDowngrade: false, reason: '' };
+}

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

@@ -0,0 +1,203 @@
+/**
+ * @fileoverview Context file generator for multi-CLI support.
+ *
+ * When alternative CLI providers are enabled, generates provider-specific
+ * context files (GEMINI.md, AGENTS.md) derived from CLAUDE.md content.
+ * Constitution Article XIX — context file generation is automatic.
+ *
+ * Provider conventions (verified Feb 2026):
+ * - Gemini CLI: auto-loads GEMINI.md, uses .gemini/commands/*.toml, no rules/
+ * - Codex CLI:  auto-loads AGENTS.md, no commands/ or rules/ concept
+ * - Copilot CLI: auto-loads AGENTS.md + CLAUDE.md + GEMINI.md natively (no COPILOT.md needed)
+ */
+
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { getEnabledNonClaudeProviders } from '../utils/config-parser.js';
+
+// ---------------------------------------------------------------------------
+// Replacement Maps
+// ---------------------------------------------------------------------------
+
+/**
+ * Text replacements for Gemini CLI context file.
+ * Transforms Claude Code-specific references into Gemini CLI equivalents.
+ * Note: Gemini has no rules/ directory — references point to chati.dev/context/.
+ */
+const GEMINI_REPLACEMENTS = [
+  ['Claude Code', 'Gemini CLI'],
+  ['claude code', 'Gemini CLI'],
+  ['CLAUDE.md', 'GEMINI.md'],
+  ['Claude.md', 'GEMINI.md'],
+  ['.claude/commands/', '.gemini/commands/'],
+  ['.claude/rules/', 'chati.dev/context/'],
+  ['.claude/mcp.json', '.gemini/settings.json'],
+  ['claude --print', 'gemini --prompt'],
+  ['claude -p', 'gemini --prompt'],
+  ['CLAUDE.local.md', 'GEMINI.local.md'],
+];
+
+/**
+ * Sections to strip from Codex CLI context file.
+ * Codex does not support hooks, so hook-related content is removed.
+ */
+const CODEX_STRIP_PATTERNS = [
+  /## (?:Hooks?|Hook System)[\s\S]*?(?=\n## |\n---|\n$)/gi,
+  /- \*\*Hooks?\*\*:.*\n/gi,
+  /hook[s]? \(.*?\)/gi,
+];
+
+/**
+ * Text replacements for Codex CLI context file.
+ * Note: Codex has no commands/ or rules/ directories — references point to chati.dev/.
+ */
+const CODEX_REPLACEMENTS = [
+  ['Claude Code', 'Codex CLI'],
+  ['claude code', 'Codex CLI'],
+  ['CLAUDE.md', 'AGENTS.md'],
+  ['Claude.md', 'AGENTS.md'],
+  ['.claude/commands/', 'chati.dev/orchestrator/'],
+  ['.claude/rules/', 'chati.dev/context/'],
+  ['.claude/mcp.json', '.codex/config.toml'],
+  ['claude --print', 'codex exec'],
+  ['claude -p', 'codex exec'],
+  ['CLAUDE.local.md', 'AGENTS.local.md'],
+];
+
+// ---------------------------------------------------------------------------
+// Generators
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate GEMINI.md content from CLAUDE.md content.
+ *
+ * Adapts the content by replacing Claude Code-specific references with
+ * Gemini CLI equivalents. Preserves structure and formatting.
+ *
+ * @param {string} content - Raw CLAUDE.md content
+ * @returns {string} Adapted content for GEMINI.md
+ */
+export function generateGeminiMd(content) {
+  let result = content;
+
+  for (const [search, replace] of GEMINI_REPLACEMENTS) {
+    result = result.replaceAll(search, replace);
+  }
+
+  // Prepend a header noting this file is auto-generated
+  const header = [
+    '<!-- Auto-generated by chati.dev from CLAUDE.md — do not edit manually -->',
+    '',
+  ].join('\n');
+
+  return header + result;
+}
+
+/**
+ * Generate AGENTS.md content from CLAUDE.md content.
+ *
+ * Simplifies the content for Codex CLI: strips hook references,
+ * replaces CLI-specific paths, and produces a leaner context file
+ * focused on code execution.
+ *
+ * @param {string} content - Raw CLAUDE.md content
+ * @returns {string} Adapted content for AGENTS.md
+ */
+export function generateAgentsMd(content) {
+  let result = content;
+
+  // Strip hook-related sections (Codex has no hooks support)
+  for (const pattern of CODEX_STRIP_PATTERNS) {
+    result = result.replace(pattern, '');
+  }
+
+  // Apply text replacements
+  for (const [search, replace] of CODEX_REPLACEMENTS) {
+    result = result.replaceAll(search, replace);
+  }
+
+  // Clean up any double blank lines left by stripping
+  result = result.replace(/\n{3,}/g, '\n\n');
+
+  // Prepend a header noting this file is auto-generated
+  const header = [
+    '<!-- Auto-generated by chati.dev from CLAUDE.md — do not edit manually -->',
+    '',
+  ].join('\n');
+
+  return header + result;
+}
+
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate context files for all enabled alternative providers.
+ *
+ * Reads config.yaml to determine which providers are enabled, reads
+ * CLAUDE.md from the project root, and writes the appropriate context
+ * files (GEMINI.md, AGENTS.md) when their providers are active.
+ *
+ * Copilot CLI does not need its own context file — it natively reads
+ * AGENTS.md, CLAUDE.md, and GEMINI.md.
+ *
+ * @param {string} projectDir - Project root directory
+ * @returns {{ generated: string[], skipped: string[], warning: string|null }}
+ */
+export function generateContextFiles(projectDir) {
+  const result = { generated: [], skipped: [], warning: null };
+
+  // Read CLAUDE.md
+  const claudeMdPath = join(projectDir, 'CLAUDE.md');
+  if (!existsSync(claudeMdPath)) {
+    result.warning = 'CLAUDE.md not found — skipping context file generation';
+    return result;
+  }
+
+  const claudeContent = readFileSync(claudeMdPath, 'utf-8');
+
+  // Determine enabled providers from config.yaml
+  const enabledProviders = resolveEnabledProviders(projectDir);
+
+  // Provider-to-generator mapping
+  // Note: Copilot is intentionally excluded — it reads AGENTS.md + CLAUDE.md + GEMINI.md natively
+  const generators = {
+    gemini: {
+      filename: 'GEMINI.md',
+      generate: generateGeminiMd,
+    },
+    codex: {
+      filename: 'AGENTS.md',
+      generate: generateAgentsMd,
+    },
+  };
+
+  for (const [provider, config] of Object.entries(generators)) {
+    if (enabledProviders.includes(provider)) {
+      const outputPath = join(projectDir, config.filename);
+      const content = config.generate(claudeContent);
+      writeFileSync(outputPath, content, 'utf-8');
+      result.generated.push(config.filename);
+    } else {
+      result.skipped.push(config.filename);
+    }
+  }
+
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve which alternative providers are enabled from config.yaml.
+ * Delegates to shared config parser utility.
+ *
+ * @param {string} projectDir - Project root directory
+ * @returns {string[]} List of enabled non-Claude provider names
+ */
+function resolveEnabledProviders(projectDir) {
+  return getEnabledNonClaudeProviders(projectDir);
+}

package/src/config/ide-configs.js

@@ -41,12 +41,12 @@ export const IDE_CONFIGS = {
   },
   'gemini-cli': {
     name: 'Gemini CLI',
-    description: 'Google AI for development',
+    description: 'Google AI terminal agent',
     recommended: false,
-    configPath: '.gemini/agents/',
-    rulesFile: '.gemini/instructions.md',
-    mcpConfigFile: null,
-    formatNotes: 'Gemini agent format',
+    configPath: '.gemini/commands/',
+    rulesFile: null,
+    mcpConfigFile: '.gemini/settings.json',
+    formatNotes: 'TOML command format',
   },
   'github-copilot': {
     name: 'GitHub Copilot',
@@ -55,7 +55,7 @@ export const IDE_CONFIGS = {
     configPath: '.github/agents/',
     rulesFile: '.github/copilot-instructions.md',
     mcpConfigFile: null,
-    formatNotes: 'GitHub Copilot format',
+    formatNotes: 'GitHub Copilot agent format',
   },
 };
 

package/src/gates/g2-qa-planning.js

@@ -7,7 +7,7 @@
 
 import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { GateBase } from './gate-base.js';
+import { GateBase, determineVerdict } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
 
@@ -148,6 +148,8 @@ export class QAPlanningGate extends GateBase {
       ? Math.round((criteriaResults.length / allCriteria.length) * 100)
       : 0;
 
-    return { score, criteriaResults, allCriteria, warnings };
+    const verdict = determineVerdict(score, 95);
+
+    return { score, criteriaResults, allCriteria, warnings, verdict };
   }
 }

package/src/gates/g4-qa-implementation.js

@@ -14,7 +14,7 @@
 
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { GateBase } from './gate-base.js';
+import { GateBase, determineVerdict } from './gate-base.js';
 import { loadSession } from '../orchestrator/session-manager.js';
 import { loadHandoff } from '../tasks/handoff.js';
 
@@ -202,6 +202,9 @@ export class QAImplementationGate extends GateBase {
       ? Math.round((criteriaResults.length / allCriteria.length) * 100)
       : 0;
 
-    return { score, criteriaResults, allCriteria, warnings };
+    const hasCriticalBlocker = !evidence.noCriticalBugs;
+    const verdict = determineVerdict(score, 95, hasCriticalBlocker);
+
+    return { score, criteriaResults, allCriteria, warnings, verdict };
   }
 }