chati-dev 4.2.2 → 4.3.0

package/scripts/doctor/index.js

@@ -1,212 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview Doctor — Modular diagnostic system with auto-fix capability.
- *
- * Orchestrates individual check modules and fix modules to provide
- * comprehensive framework health validation and automatic repair.
- *
- * Exports:
- *   runDoctor(frameworkDir, options) → DoctorReport
- *   formatDoctorReport(report) → human-readable string
- *
- * DoctorReport:
- *   { overall, checks, fixes, timestamp, summary }
- */
-
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { fileURLToPath } from 'url';
-
-// Check modules
-import { checkRegistry } from './checks/registry.js';
-import { checkSchemas } from './checks/schemas.js';
-import { checkConstitution } from './checks/constitution.js';
-import { checkAgents } from './checks/agents.js';
-import { checkPrismLayers } from './checks/prism-layers.js';
-import { checkDomainAlignment } from './checks/domain-alignment.js';
-
-// Fix modules
-import { fixRegistryCount } from './fixes/registry-fix.js';
-import { fixBrokenReferences } from './fixes/reference-fix.js';
-
-/**
- * Map of fixId to fix function.
- */
-const FIX_REGISTRY = {
-  'registry-count': fixRegistryCount,
-  'broken-references': fixBrokenReferences,
-};
-
-/**
- * All available check functions.
- */
-const CHECK_REGISTRY = {
-  registry: checkRegistry,
-  schemas: checkSchemas,
-  constitution: checkConstitution,
-  agents: checkAgents,
-  prismLayers: checkPrismLayers,
-  domainAlignment: checkDomainAlignment,
-};
-
-/**
- * Run the doctor diagnostic suite.
- *
- * @param {string} frameworkDir - Path to the framework directory
- * @param {object} [options={}] - Configuration options
- * @param {boolean} [options.fix=false] - Run auto-fix for fixable issues
- * @param {string[]} [options.checks] - Specific checks to run (default: all)
- * @returns {object} DoctorReport
- */
-export function runDoctor(frameworkDir, options = {}) {
-  const { fix = false, checks: checkFilter } = options;
-
-  if (!existsSync(frameworkDir)) {
-    return {
-      overall: 'UNHEALTHY',
-      checks: {
-        frameworkDir: { pass: false, details: `Directory not found: ${frameworkDir}`, severity: 'critical', fixable: false, fixId: null },
-      },
-      fixes: [],
-      timestamp: new Date().toISOString(),
-      summary: { total: 1, passed: 0, failed: 1, criticalFailures: 1, warnings: 0, fixesApplied: 0 },
-    };
-  }
-
-  // Run checks
-  const checksToRun = checkFilter
-    ? Object.entries(CHECK_REGISTRY).filter(([name]) => checkFilter.includes(name))
-    : Object.entries(CHECK_REGISTRY);
-
-  const checkResults = {};
-  for (const [name, checkFn] of checksToRun) {
-    checkResults[name] = checkFn(frameworkDir);
-  }
-
-  // Run fixes if requested
-  const fixes = [];
-  if (fix) {
-    for (const [name, result] of Object.entries(checkResults)) {
-      if (!result.pass && result.fixable && result.fixId) {
-        const fixFn = FIX_REGISTRY[result.fixId];
-        if (fixFn) {
-          const fixResult = fixFn(frameworkDir);
-          fixes.push({ check: name, fixId: result.fixId, ...fixResult });
-
-          // Re-run the check if fix was applied
-          if (fixResult.fixed) {
-            const checkFn = CHECK_REGISTRY[name];
-            if (checkFn) {
-              checkResults[name] = checkFn(frameworkDir);
-            }
-          }
-        }
-      }
-    }
-  }
-
-  // Determine overall health
-  const criticalFailures = Object.values(checkResults).filter(c => !c.pass && c.severity === 'critical');
-  const warnings = Object.values(checkResults).filter(c => !c.pass && c.severity === 'warning');
-
-  let overall;
-  if (criticalFailures.length > 0) {
-    overall = 'UNHEALTHY';
-  } else if (warnings.length > 0) {
-    overall = 'DEGRADED';
-  } else {
-    overall = 'HEALTHY';
-  }
-
-  return {
-    overall,
-    checks: checkResults,
-    fixes,
-    timestamp: new Date().toISOString(),
-    summary: {
-      total: Object.keys(checkResults).length,
-      passed: Object.values(checkResults).filter(c => c.pass).length,
-      failed: Object.values(checkResults).filter(c => !c.pass).length,
-      criticalFailures: criticalFailures.length,
-      warnings: warnings.length,
-      fixesApplied: fixes.filter(f => f.fixed).length,
-    },
-  };
-}
-
-/**
- * Format a DoctorReport into a human-readable string.
- *
- * @param {object} report - DoctorReport from runDoctor
- * @returns {string} Formatted report
- */
-export function formatDoctorReport(report) {
-  const statusSymbol = {
-    HEALTHY: '[OK]',
-    DEGRADED: '[WARN]',
-    UNHEALTHY: '[FAIL]',
-  };
-
-  const checkSymbol = (check) => check.pass ? '[PASS]' : '[FAIL]';
-
-  const lines = [
-    '=== Doctor Report ===',
-    `Status: ${statusSymbol[report.overall] || '[ ? ]'} ${report.overall}`,
-    `Time:   ${report.timestamp}`,
-    '',
-  ];
-
-  if (report.summary) {
-    lines.push(`Summary: ${report.summary.passed}/${report.summary.total} checks passed`);
-    if (report.summary.criticalFailures > 0) {
-      lines.push(`         ${report.summary.criticalFailures} critical failure(s)`);
-    }
-    if (report.summary.warnings > 0) {
-      lines.push(`         ${report.summary.warnings} warning(s)`);
-    }
-    if (report.summary.fixesApplied > 0) {
-      lines.push(`         ${report.summary.fixesApplied} fix(es) applied`);
-    }
-    lines.push('');
-  }
-
-  lines.push('Checks:');
-  for (const [name, check] of Object.entries(report.checks)) {
-    const symbol = checkSymbol(check);
-    const severity = check.severity !== 'info' ? ` (${check.severity})` : '';
-    const fixable = check.fixable ? ' [fixable]' : '';
-    lines.push(`  ${symbol} ${name}: ${check.details}${severity}${fixable}`);
-  }
-
-  if (report.fixes && report.fixes.length > 0) {
-    lines.push('');
-    lines.push('Fixes:');
-    for (const fix of report.fixes) {
-      const symbol = fix.fixed ? '[FIXED]' : '[SKIP]';
-      lines.push(`  ${symbol} ${fix.check}: ${fix.details}`);
-    }
-  }
-
-  lines.push('');
-  lines.push('=== End Report ===');
-
-  return lines.join('\n');
-}
-
-// ---------------------------------------------------------------------------
-// CLI entrypoint
-// ---------------------------------------------------------------------------
-
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  const args = process.argv.slice(2);
-  const fix = args.includes('--fix');
-  const frameworkDir = args.find(a => !a.startsWith('--')) || join(process.cwd(), 'chati.dev');
-
-  const report = runDoctor(frameworkDir, { fix });
-  console.log(formatDoctorReport(report));
-
-  if (report.overall === 'UNHEALTHY') {
-    process.exit(1);
-  }
-}

package/scripts/framework-analyzer.js

@@ -1,308 +0,0 @@
-/**
- * Framework Analyzer — Detects project technology stack through static analysis.
- *
- * Inspects package.json, configuration files, and file patterns to identify
- * frameworks, languages, package managers, ORMs, databases, and monorepo tools.
- *
- * @module scripts/framework-analyzer
- */
-
-import { readFileSync, readdirSync, existsSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-
-/**
- * @typedef {Object} FrameworkReport
- * @property {string[]} frontendFrameworks
- * @property {string[]} backendFrameworks
- * @property {string[]} languages
- * @property {string} packageManager
- * @property {string[]} monorepoTools
- * @property {string[]} orms
- * @property {string[]} databases
- * @property {string[]} testingFrameworks
- * @property {string[]} buildTools
- * @property {Object} raw — raw detection results before merging
- */
-
-/**
- * Safely reads and parses a JSON file.
- * @param {string} filePath
- * @returns {Object|null}
- */
-function readJSON(filePath) {
-  try {
-    return JSON.parse(readFileSync(filePath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Checks if a file or directory exists.
- * @param  {...string} segments
- * @returns {boolean}
- */
-function pathExists(...segments) {
-  return existsSync(join(...segments));
-}
-
-/**
- * Detects technologies from package.json dependencies.
- *
- * @param {string} targetDir
- * @returns {Partial<FrameworkReport>}
- */
-export function detectByPackageJson(targetDir) {
-  const pkg = readJSON(join(targetDir, 'package.json'));
-  if (!pkg) return {};
-
-  const allDeps = {
-    ...pkg.dependencies,
-    ...pkg.devDependencies,
-    ...pkg.peerDependencies,
-  };
-  const depNames = new Set(Object.keys(allDeps));
-
-  const frontendFrameworks = [];
-  const backendFrameworks = [];
-  const orms = [];
-  const databases = [];
-  const testingFrameworks = [];
-  const buildTools = [];
-  const monorepoTools = [];
-
-  // Frontend
-  if (depNames.has('next')) frontendFrameworks.push('Next.js');
-  else if (depNames.has('react')) frontendFrameworks.push('React');
-  if (depNames.has('nuxt') || depNames.has('nuxt3')) frontendFrameworks.push('Nuxt');
-  else if (depNames.has('vue')) frontendFrameworks.push('Vue');
-  if (depNames.has('@sveltejs/kit')) frontendFrameworks.push('SvelteKit');
-  else if (depNames.has('svelte')) frontendFrameworks.push('Svelte');
-  if (depNames.has('@angular/core')) frontendFrameworks.push('Angular');
-
-  // Backend
-  if (depNames.has('express')) backendFrameworks.push('Express');
-  if (depNames.has('fastify')) backendFrameworks.push('Fastify');
-  if (depNames.has('koa')) backendFrameworks.push('Koa');
-  if (depNames.has('@nestjs/core')) backendFrameworks.push('NestJS');
-  if (depNames.has('hono')) backendFrameworks.push('Hono');
-  if (depNames.has('@hapi/hapi') || depNames.has('hapi')) backendFrameworks.push('Hapi');
-
-  // ORM
-  if (depNames.has('prisma') || depNames.has('@prisma/client')) orms.push('Prisma');
-  if (depNames.has('drizzle-orm')) orms.push('Drizzle');
-  if (depNames.has('typeorm')) orms.push('TypeORM');
-  if (depNames.has('sequelize')) orms.push('Sequelize');
-  if (depNames.has('mongoose')) orms.push('Mongoose');
-  if (depNames.has('knex')) orms.push('Knex');
-
-  // Database
-  if (depNames.has('pg') || depNames.has('postgres') || depNames.has('@vercel/postgres')) databases.push('PostgreSQL');
-  if (depNames.has('mysql2') || depNames.has('mysql')) databases.push('MySQL');
-  if (depNames.has('mongodb') || depNames.has('mongoose')) databases.push('MongoDB');
-  if (depNames.has('better-sqlite3') || depNames.has('sqlite3')) databases.push('SQLite');
-  if (depNames.has('redis') || depNames.has('ioredis')) databases.push('Redis');
-
-  // Testing
-  if (depNames.has('jest')) testingFrameworks.push('Jest');
-  if (depNames.has('vitest')) testingFrameworks.push('Vitest');
-  if (depNames.has('mocha')) testingFrameworks.push('Mocha');
-  if (depNames.has('@playwright/test') || depNames.has('playwright')) testingFrameworks.push('Playwright');
-  if (depNames.has('cypress')) testingFrameworks.push('Cypress');
-
-  // Build tools
-  if (depNames.has('vite')) buildTools.push('Vite');
-  if (depNames.has('webpack')) buildTools.push('Webpack');
-  if (depNames.has('esbuild')) buildTools.push('esbuild');
-  if (depNames.has('rollup')) buildTools.push('Rollup');
-  if (depNames.has('tsup')) buildTools.push('tsup');
-  if (depNames.has('turbo')) buildTools.push('Turborepo');
-
-  // Monorepo
-  if (depNames.has('turbo') || depNames.has('turborepo')) monorepoTools.push('Turborepo');
-  if (depNames.has('lerna')) monorepoTools.push('Lerna');
-  if (depNames.has('nx') || depNames.has('@nrwl/workspace')) monorepoTools.push('Nx');
-
-  return { frontendFrameworks, backendFrameworks, orms, databases, testingFrameworks, buildTools, monorepoTools };
-}
-
-/**
- * Detects technologies from configuration files present in the project.
- *
- * @param {string} targetDir
- * @returns {Partial<FrameworkReport>}
- */
-export function detectByConfigFiles(targetDir) {
-  const languages = [];
-  const buildTools = [];
-  const monorepoTools = [];
-
-  // TypeScript
-  if (pathExists(targetDir, 'tsconfig.json') || pathExists(targetDir, 'tsconfig.base.json')) {
-    languages.push('TypeScript');
-  }
-
-  // Python
-  if (pathExists(targetDir, 'pyproject.toml') || pathExists(targetDir, 'setup.py') || pathExists(targetDir, 'requirements.txt')) {
-    languages.push('Python');
-  }
-
-  // Go
-  if (pathExists(targetDir, 'go.mod')) {
-    languages.push('Go');
-  }
-
-  // Rust
-  if (pathExists(targetDir, 'Cargo.toml')) {
-    languages.push('Rust');
-  }
-
-  // Build tools
-  if (pathExists(targetDir, 'vite.config.js') || pathExists(targetDir, 'vite.config.ts')) {
-    buildTools.push('Vite');
-  }
-  if (pathExists(targetDir, 'webpack.config.js') || pathExists(targetDir, 'webpack.config.ts')) {
-    buildTools.push('Webpack');
-  }
-  if (pathExists(targetDir, 'rollup.config.js') || pathExists(targetDir, 'rollup.config.mjs')) {
-    buildTools.push('Rollup');
-  }
-
-  // Monorepo
-  if (pathExists(targetDir, 'turbo.json')) monorepoTools.push('Turborepo');
-  if (pathExists(targetDir, 'lerna.json')) monorepoTools.push('Lerna');
-  if (pathExists(targetDir, 'nx.json')) monorepoTools.push('Nx');
-  if (pathExists(targetDir, 'pnpm-workspace.yaml')) monorepoTools.push('pnpm workspaces');
-
-  // Package manager detection
-  let packageManager = 'npm'; // default
-  if (pathExists(targetDir, 'bun.lockb') || pathExists(targetDir, 'bun.lock')) {
-    packageManager = 'bun';
-  } else if (pathExists(targetDir, 'pnpm-lock.yaml')) {
-    packageManager = 'pnpm';
-  } else if (pathExists(targetDir, 'yarn.lock')) {
-    packageManager = 'yarn';
-  }
-
-  return { languages, buildTools, monorepoTools, packageManager };
-}
-
-/**
- * Detects technologies from file patterns in the project directory.
- *
- * @param {string} targetDir
- * @returns {Partial<FrameworkReport>}
- */
-export function detectByFilePatterns(targetDir) {
-  const languages = [];
-
-  // Check top-level files and src/ for language clues
-  const dirsToCheck = [targetDir];
-  if (pathExists(targetDir, 'src')) dirsToCheck.push(join(targetDir, 'src'));
-
-  const extensions = new Set();
-  for (const dir of dirsToCheck) {
-    let entries;
-    try {
-      entries = readdirSync(dir);
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      try {
-        const stat = statSync(join(dir, entry));
-        if (stat.isFile()) {
-          const ext = entry.slice(entry.lastIndexOf('.'));
-          extensions.add(ext);
-        }
-      } catch {
-        // skip
-      }
-    }
-  }
-
-  if (extensions.has('.ts') || extensions.has('.tsx')) {
-    languages.push('TypeScript');
-  }
-  if (extensions.has('.js') || extensions.has('.jsx') || extensions.has('.mjs')) {
-    languages.push('JavaScript');
-  }
-  if (extensions.has('.py')) {
-    languages.push('Python');
-  }
-  if (extensions.has('.go')) {
-    languages.push('Go');
-  }
-  if (extensions.has('.rs')) {
-    languages.push('Rust');
-  }
-
-  return { languages };
-}
-
-/**
- * Merges multiple partial detection reports, deduplicating arrays.
- *
- * @param  {...Partial<FrameworkReport>} reports
- * @returns {FrameworkReport}
- */
-export function mergeDetections(...reports) {
-  const merged = {
-    frontendFrameworks: [],
-    backendFrameworks: [],
-    languages: [],
-    packageManager: 'npm',
-    monorepoTools: [],
-    orms: [],
-    databases: [],
-    testingFrameworks: [],
-    buildTools: [],
-    raw: {},
-  };
-
-  const arrayFields = [
-    'frontendFrameworks',
-    'backendFrameworks',
-    'languages',
-    'monorepoTools',
-    'orms',
-    'databases',
-    'testingFrameworks',
-    'buildTools',
-  ];
-
-  for (const report of reports) {
-    if (!report) continue;
-    for (const field of arrayFields) {
-      if (Array.isArray(report[field])) {
-        for (const item of report[field]) {
-          if (!merged[field].includes(item)) {
-            merged[field].push(item);
-          }
-        }
-      }
-    }
-    if (report.packageManager) {
-      merged.packageManager = report.packageManager;
-    }
-  }
-
-  // Store raw detections for debugging
-  merged.raw = { reports: reports.filter(Boolean) };
-
-  return merged;
-}
-
-/**
- * Full framework analysis for a target directory.
- *
- * @param {string} targetDir
- * @returns {FrameworkReport}
- */
-export function analyzeFramework(targetDir) {
-  const byPackage = detectByPackageJson(targetDir);
-  const byConfig = detectByConfigFiles(targetDir);
-  const byFiles = detectByFilePatterns(targetDir);
-
-  return mergeDetections(byPackage, byConfig, byFiles);
-}