chati-dev 4.2.1 → 4.3.0

package/scripts/doctor/checks/agents.js

@@ -1,77 +0,0 @@
-/**
- * @fileoverview Doctor check: Agent definition files.
- *
- * Validates that all primary 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

@@ -1,41 +0,0 @@
-/**
- * @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

@@ -1,58 +0,0 @@
-/**
- * @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

@@ -1,84 +0,0 @@
-/**
- * @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 };
-}

package/scripts/doctor/checks/registry.js

@@ -1,55 +0,0 @@
-/**
- * @fileoverview Doctor check: Entity Registry integrity.
- *
- * Validates entity-registry.yaml exists, parses correctly,
- * entity count matches metadata, and all entity paths exist.
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import yaml from 'js-yaml';
-
-/**
- * Run entity registry integrity check.
- *
- * @param {string} frameworkDir - Path to framework directory
- * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
- */
-export function checkRegistry(frameworkDir) {
-  const regPath = join(frameworkDir, 'data', 'entity-registry.yaml');
-  if (!existsSync(regPath)) {
-    return { pass: false, details: 'entity-registry.yaml not found', severity: 'critical', fixable: false, fixId: null };
-  }
-
-  try {
-    const content = readFileSync(regPath, 'utf8');
-    const registry = yaml.load(content);
-
-    if (!registry || !registry.entities) {
-      return { pass: false, details: 'entity-registry.yaml has no entities section', severity: 'critical', fixable: false, fixId: null };
-    }
-
-    // Count all entities across all categories
-    let entityCount = 0;
-    for (const category of Object.values(registry.entities)) {
-      if (typeof category === 'object' && category !== null) {
-        entityCount += Object.keys(category).length;
-      }
-    }
-
-    const declaredCount = registry.metadata?.entity_count || 0;
-    if (declaredCount > 0 && entityCount !== declaredCount) {
-      return {
-        pass: false,
-        details: `Entity count mismatch: declared ${declaredCount}, actual ${entityCount}`,
-        severity: 'warning',
-        fixable: true,
-        fixId: 'registry-count',
-      };
-    }
-
-    return { pass: true, details: `${entityCount} entities registered`, severity: 'info', fixable: false, fixId: null };
-  } catch (err) {
-    return { pass: false, details: `Failed to parse: ${err.message}`, severity: 'critical', fixable: false, fixId: null };
-  }
-}

package/scripts/doctor/checks/schemas.js

@@ -1,61 +0,0 @@
-/**
- * @fileoverview Doctor check: JSON Schema validation.
- *
- * Validates that all expected schema files exist and contain valid JSON.
- */
-
-import { readFileSync, existsSync, readdirSync } from 'fs';
-import { join } from 'path';
-
-const EXPECTED_SCHEMAS = [
-  'session.schema.json',
-  'config.schema.json',
-  'context.schema.json',
-  'memory.schema.json',
-  'task.schema.json',
-];
-
-/**
- * Run schema validation check.
- *
- * @param {string} frameworkDir - Path to framework directory
- * @returns {{ pass: boolean, details: string, severity: string, fixable: boolean, fixId: string|null }}
- */
-export function checkSchemas(frameworkDir) {
-  const schemasDir = join(frameworkDir, 'schemas');
-  if (!existsSync(schemasDir)) {
-    return { pass: false, details: 'schemas/ directory not found', severity: 'critical', fixable: false, fixId: null };
-  }
-
-  const missing = [];
-  const invalid = [];
-
-  for (const schema of EXPECTED_SCHEMAS) {
-    const schemaPath = join(schemasDir, schema);
-    if (!existsSync(schemaPath)) {
-      missing.push(schema);
-      continue;
-    }
-    try {
-      JSON.parse(readFileSync(schemaPath, 'utf8'));
-    } catch {
-      invalid.push(schema);
-    }
-  }
-
-  if (missing.length > 0 || invalid.length > 0) {
-    const issues = [];
-    if (missing.length) issues.push(`missing: ${missing.join(', ')}`);
-    if (invalid.length) issues.push(`invalid JSON: ${invalid.join(', ')}`);
-    return {
-      pass: false,
-      details: issues.join('; '),
-      severity: missing.length > 0 ? 'critical' : 'warning',
-      fixable: false,
-      fixId: null,
-    };
-  }
-
-  const actualSchemas = readdirSync(schemasDir).filter(f => f.endsWith('.json'));
-  return { pass: true, details: `${actualSchemas.length} schemas valid`, severity: 'info', fixable: false, fixId: null };
-}

package/scripts/doctor/fixes/reference-fix.js

@@ -1,100 +0,0 @@
-/**
- * @fileoverview Doctor fix: Broken path references.
- *
- * Scans entity-registry.yaml for broken path references and
- * attempts to locate the correct paths.
- */
-
-import { readFileSync, writeFileSync, existsSync, readdirSync } from 'fs';
-import { join, basename } from 'path';
-import yaml from 'js-yaml';
-
-/**
- * Fix broken path references in entity-registry.yaml.
- *
- * @param {string} frameworkDir - Path to framework directory
- * @returns {{ fixed: boolean, details: string, fixedPaths: string[] }}
- */
-export function fixBrokenReferences(frameworkDir) {
-  const regPath = join(frameworkDir, 'data', 'entity-registry.yaml');
-  if (!existsSync(regPath)) {
-    return { fixed: false, details: 'entity-registry.yaml not found', fixedPaths: [] };
-  }
-
-  try {
-    const content = readFileSync(regPath, 'utf8');
-    const registry = yaml.load(content);
-
-    if (!registry || !registry.entities) {
-      return { fixed: false, details: 'No entities section found', fixedPaths: [] };
-    }
-
-    const fixedPaths = [];
-    let updatedContent = content;
-
-    for (const category of Object.values(registry.entities)) {
-      for (const [name, entity] of Object.entries(category)) {
-        if (!entity.path) continue;
-
-        // Path in registry is relative to project root (e.g., "chati.dev/agents/...")
-        const relPath = entity.path.replace(/^chati\.dev\//, '');
-        const fullPath = join(frameworkDir, relPath);
-
-        if (existsSync(fullPath)) continue;
-
-        // Try to find the file by name
-        const fileName = basename(relPath);
-        const found = findFile(frameworkDir, fileName);
-
-        if (found) {
-          const newPath = 'chati.dev/' + found;
-          updatedContent = updatedContent.replace(
-            `path: ${entity.path}`,
-            `path: ${newPath}`
-          );
-          fixedPaths.push(`${name}: ${entity.path} -> ${newPath}`);
-        }
-      }
-    }
-
-    if (fixedPaths.length === 0) {
-      return { fixed: false, details: 'No broken references found', fixedPaths: [] };
-    }
-
-    writeFileSync(regPath, updatedContent, 'utf8');
-    return { fixed: true, details: `Fixed ${fixedPaths.length} path reference(s)`, fixedPaths };
-  } catch (err) {
-    return { fixed: false, details: `Fix failed: ${err.message}`, fixedPaths: [] };
-  }
-}
-
-/**
- * Search for a file by name within the framework directory.
- *
- * @param {string} dir - Directory to search
- * @param {string} fileName - File name to find
- * @param {string} [prefix=''] - Path prefix for recursion
- * @param {number} [depth=0] - Current depth
- * @returns {string|null} Relative path from frameworkDir or null
- */
-function findFile(dir, fileName, prefix = '', depth = 0) {
-  if (depth > 4) return null;
-
-  try {
-    const entries = readdirSync(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-      if (entry.isFile() && entry.name === fileName) {
-        return rel;
-      }
-      if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
-        const found = findFile(join(dir, entry.name), fileName, rel, depth + 1);
-        if (found) return found;
-      }
-    }
-  } catch {
-    // Permission error or inaccessible directory
-  }
-
-  return null;
-}

package/scripts/doctor/fixes/registry-fix.js

@@ -1,56 +0,0 @@
-/**
- * @fileoverview Doctor fix: Registry count correction.
- *
- * Auto-fixes entity_count mismatch in entity-registry.yaml
- * by counting actual entities and updating metadata.
- */
-
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import yaml from 'js-yaml';
-
-/**
- * Fix entity count mismatch in entity-registry.yaml.
- *
- * @param {string} frameworkDir - Path to framework directory
- * @returns {{ fixed: boolean, details: string }}
- */
-export function fixRegistryCount(frameworkDir) {
-  const regPath = join(frameworkDir, 'data', 'entity-registry.yaml');
-  if (!existsSync(regPath)) {
-    return { fixed: false, details: 'entity-registry.yaml not found' };
-  }
-
-  try {
-    const content = readFileSync(regPath, 'utf8');
-    const registry = yaml.load(content);
-
-    if (!registry || !registry.entities) {
-      return { fixed: false, details: 'No entities section found' };
-    }
-
-    // Count actual entities
-    let entityCount = 0;
-    for (const category of Object.values(registry.entities)) {
-      if (typeof category === 'object' && category !== null) {
-        entityCount += Object.keys(category).length;
-      }
-    }
-
-    const declaredCount = registry.metadata?.entity_count || 0;
-    if (entityCount === declaredCount) {
-      return { fixed: false, details: 'Entity count already correct' };
-    }
-
-    // Update the count using regex to preserve YAML formatting
-    const updatedContent = content.replace(
-      /entity_count:\s*\d+/,
-      `entity_count: ${entityCount}`
-    );
-
-    writeFileSync(regPath, updatedContent, 'utf8');
-    return { fixed: true, details: `Updated entity_count from ${declaredCount} to ${entityCount}` };
-  } catch (err) {
-    return { fixed: false, details: `Fix failed: ${err.message}` };
-  }
-}