micro-contracts 0.14.4 → 0.15.1

package/dist/cli.js

@@ -1,858 +1,811 @@
 #!/usr/bin/env node
-/**
- * micro-contracts CLI
- *
- * A contract-first OpenAPI toolchain that keeps TypeScript UI
- * and microservices aligned via code generation.
- */
-import { Command } from 'commander';
 import fs from 'fs';
 import path from 'path';
 import { createRequire } from 'module';
 import yaml from 'yaml';
+import { createProgram } from './generated/program.js';
 import { generate, loadConfig, loadOpenAPISpec, lintSpec, formatLintResults, computeInputHash } from './generator/index.js';
 import { isMultiModuleConfig } from './types.js';
 import { getStarterTemplates, getScreenStarterTemplates } from './cli/templates.js';
 import { runAllChecks, formatCheckResults, formatSingleCheckResult, formatCheckStart, formatCheckSummary, getAvailableChecks, createGuardrailsConfig, generateManifest, writeManifest, canSkipGeneration, GATE_DESCRIPTIONS, loadGuardrailsConfigWithPath, } from './guardrails/index.js';
-// Load package.json for version info
+import { commandAuditOpenapi } from './commands/audit-openapi.js';
+import { commandReviewPublished } from './commands/review-published.js';
+import { commandProposeOverlays } from './commands/propose-overlays.js';
+import { commandAuditGuardrails } from './commands/audit-guardrails.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
-const program = new Command();
-program
-    .name('micro-contracts')
-    .description('Contract-first OpenAPI toolchain for TypeScript')
-    .version(pkg.version);
-// Generate command
-program
-    .command('generate')
-    .description('Generate code from OpenAPI specification')
-    .option('-c, --config <path>', 'Path to config file (micro-contracts.config.yaml)')
-    .option('-m, --module <names>', 'Module names, comma-separated (default: all)')
-    .option('--contracts-only', 'Generate contract packages only')
-    .option('--server-only', 'Generate server routes only')
-    .option('--frontend-only', 'Generate frontend clients only')
-    .option('--docs-only', 'Generate documentation only')
-    .option('--skip-lint', 'Skip linting before generation')
-    .option('--no-manifest', 'Skip manifest generation even if guardrails are configured')
-    .option('--manifest-dir <path>', 'Directory for manifest (default: packages/)')
-    .option('--force', 'Bypass input hash cache and always regenerate')
-    .option('--no-cache', 'Run without reading or writing input hash cache')
-    .action(async (options) => {
-    try {
-        let config;
-        // Load from config file
-        const configPath = options.config
-            ? path.resolve(options.config)
-            : findConfigFile();
-        if (!configPath) {
-            console.error('Error: No config file found.');
-            console.error('Create micro-contracts.config.yaml or use --config <path>');
-            process.exit(1);
-        }
-        if (!fs.existsSync(configPath)) {
-            console.error(`Config file not found: ${configPath}`);
-            process.exit(1);
-        }
-        console.log(`Using config: ${configPath}`);
-        config = loadConfig(configPath);
-        // Compute input hash for skip logic (multi-module config only)
-        const useCache = options.cache !== false && !options.force;
-        let inputHash;
-        if (isMultiModuleConfig(config)) {
-            inputHash = computeInputHash(config, configPath, pkg.version);
-            if (useCache) {
-                const manifestDir = options.manifestDir || 'packages/';
-                const skipCheck = await canSkipGeneration(manifestDir, inputHash);
-                if (skipCheck.skip) {
-                    console.log(`No input changes detected, skipping generation (${skipCheck.reason})`);
-                    return;
-                }
+function findConfigFile() {
+    const candidates = [
+        'micro-contracts.config.yaml',
+        'micro-contracts.config.yml',
+        'api-framework.config.yaml',
+        'api-framework.config.yml',
+    ];
+    for (const candidate of candidates) {
+        const configPath = path.resolve(candidate);
+        if (fs.existsSync(configPath))
+            return configPath;
+    }
+    return null;
+}
+const handlers = {
+    // ── generate ──────────────────────────────────────────
+    generate: async (opts) => {
+        try {
+            let config;
+            const configPath = opts.config
+                ? path.resolve(opts.config)
+                : findConfigFile();
+            if (!configPath) {
+                console.error('Error: No config file found.');
+                console.error('Create micro-contracts.config.yaml or use --config <path>');
+                process.exit(1);
             }
-        }
-        // Run generation
-        await generate(config, {
-            contractsOnly: options.contractsOnly,
-            serverOnly: options.serverOnly,
-            frontendOnly: options.frontendOnly,
-            docsOnly: options.docsOnly,
-            skipLint: options.skipLint,
-            modules: options.module,
-        });
-        // Generate manifest if guardrails config has 'generated' section
-        // (unless --no-manifest is specified)
-        if (options.manifest !== false) {
-            const { config: guardrailsConfig } = loadGuardrailsConfigWithPath();
-            // Check if guardrails config has generated patterns defined
-            if (guardrailsConfig?.generated && guardrailsConfig.generated.length > 0) {
-                const manifestDir = options.manifestDir || 'packages/';
-                if (fs.existsSync(manifestDir)) {
-                    const manifestInputHash = (options.cache !== false) ? inputHash : undefined;
-                    const { manifest, changed } = await generateManifest(manifestDir, {
-                        generatorVersion: pkg.version,
-                        inputHash: manifestInputHash,
-                    });
-                    const fileCount = Object.keys(manifest.files).length;
-                    if (changed) {
-                        const manifestPath = writeManifest(manifest, manifestDir);
-                        console.log(`\nManifest updated: ${manifestPath} (${fileCount} files)`);
+            if (!fs.existsSync(configPath)) {
+                console.error(`Config file not found: ${configPath}`);
+                process.exit(1);
+            }
+            console.log(`Using config: ${configPath}`);
+            config = loadConfig(configPath);
+            const useCache = opts.cache !== false && !opts.force;
+            let inputHash;
+            if (isMultiModuleConfig(config)) {
+                inputHash = computeInputHash(config, configPath, pkg.version);
+                if (useCache) {
+                    const manifestDir = opts.manifestDir || 'packages/';
+                    const skipCheck = await canSkipGeneration(manifestDir, inputHash);
+                    if (skipCheck.skip) {
+                        console.log(`No input changes detected, skipping generation (${skipCheck.reason})`);
+                        return;
                     }
-                    else {
-                        console.log(`\nManifest unchanged (${fileCount} files)`);
+                }
+            }
+            await generate(config, {
+                contractsOnly: opts.contractsOnly,
+                serverOnly: opts.serverOnly,
+                frontendOnly: opts.frontendOnly,
+                docsOnly: opts.docsOnly,
+                skipLint: opts.skipLint,
+                modules: opts.module,
+            });
+            if (opts.manifest !== false) {
+                const { config: guardrailsConfig } = loadGuardrailsConfigWithPath();
+                if (guardrailsConfig?.generated && guardrailsConfig.generated.length > 0) {
+                    const manifestDir = opts.manifestDir || 'packages/';
+                    if (fs.existsSync(manifestDir)) {
+                        const manifestInputHash = (opts.cache !== false) ? inputHash : undefined;
+                        const { manifest, changed } = await generateManifest(manifestDir, {
+                            generatorVersion: pkg.version,
+                            inputHash: manifestInputHash,
+                        });
+                        const fileCount = Object.keys(manifest.files).length;
+                        if (changed) {
+                            const manifestPath = writeManifest(manifest, manifestDir);
+                            console.log(`\nManifest updated: ${manifestPath} (${fileCount} files)`);
+                        }
+                        else {
+                            console.log(`\nManifest unchanged (${fileCount} files)`);
+                        }
                     }
                 }
             }
         }
-    }
-    catch (error) {
-        console.error('Generation failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Lint command
-program
-    .command('lint')
-    .description('Lint OpenAPI specification for x-public/x-private violations')
-    .argument('<input>', 'Path to OpenAPI spec file')
-    .option('--strict', 'Treat warnings as errors')
-    .action(async (input, options) => {
-    try {
-        const specPath = path.resolve(input);
-        if (!fs.existsSync(specPath)) {
-            console.error(`OpenAPI spec not found: ${specPath}`);
+        catch (error) {
+            console.error('Generation failed:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
-        console.log(`Linting: ${specPath}\n`);
-        const spec = loadOpenAPISpec(specPath);
-        const result = lintSpec(spec, { strict: options.strict });
-        console.log(formatLintResults(result));
-        if (!result.valid) {
-            process.exit(1);
+    },
+    // ── lint ───────────────────────────────────────────────
+    lint: async (input) => {
+        try {
+            const specPath = path.resolve(input);
+            if (!fs.existsSync(specPath)) {
+                console.error(`OpenAPI spec not found: ${specPath}`);
+                process.exit(1);
+            }
+            console.log(`Linting: ${specPath}\n`);
+            const spec = loadOpenAPISpec(specPath);
+            const result = lintSpec(spec, { strict: false });
+            console.log(formatLintResults(result));
+            if (!result.valid) {
+                process.exit(1);
+            }
         }
-    }
-    catch (error) {
-        console.error('Lint failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Init command
-program
-    .command('init')
-    .description('Initialize a new module structure with starter templates')
-    .argument('<name>', 'Module name (e.g., core, users)')
-    .option('-d, --dir <path>', 'Base directory', 'src')
-    .option('-i, --openapi <path>', 'OpenAPI spec to process (auto-adds x-micro-contracts-service/method)')
-    .option('-o, --output <path>', 'Output path for processed OpenAPI')
-    .option('--skip-templates', 'Skip creating starter templates')
-    .option('--screens', 'Initialize as screen spec module (generates screen templates and starter spec)')
-    .action(async (name, options) => {
-    console.log(`Initializing module "${name}"${options.screens ? ' (screen spec)' : ''}...\n`);
-    // Create spec directory structure
-    const specDirs = [
-        'spec',
-        'spec/default/templates',
-        'spec/_shared/openapi',
-        'spec/_shared/overlays',
-        `spec/${name}/openapi`,
-    ];
-    for (const dir of specDirs) {
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-            console.log(`Created: ${dir}/`);
+        catch (error) {
+            console.error('Lint failed:', error instanceof Error ? error.message : error);
+            process.exit(1);
         }
-    }
-    // Create starter templates (unless skipped)
-    if (!options.skipTemplates) {
-        const starterTemplates = getStarterTemplates();
-        for (const [filename, content] of Object.entries(starterTemplates)) {
-            const templatePath = path.join('spec/default/templates', filename);
-            if (!fs.existsSync(templatePath)) {
-                fs.writeFileSync(templatePath, content);
-                console.log(`Created: ${templatePath}`);
+    },
+    // ── init ───────────────────────────────────────────────
+    init: async (name, opts) => {
+        console.log(`Initializing module "${name}"${opts.screens ? ' (screen spec)' : ''}...\n`);
+        const specDirs = [
+            'spec',
+            'spec/default/templates',
+            'spec/_shared/openapi',
+            'spec/_shared/overlays',
+            `spec/${name}/openapi`,
+        ];
+        for (const dir of specDirs) {
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+                console.log(`Created: ${dir}/`);
             }
         }
-        // Also create screen templates when --screens is specified
-        if (options.screens) {
-            const screenTemplates = getScreenStarterTemplates();
-            for (const [filename, content] of Object.entries(screenTemplates)) {
+        if (!opts.skipTemplates) {
+            const starterTemplates = getStarterTemplates();
+            for (const [filename, content] of Object.entries(starterTemplates)) {
                 const templatePath = path.join('spec/default/templates', filename);
                 if (!fs.existsSync(templatePath)) {
                     fs.writeFileSync(templatePath, content);
                     console.log(`Created: ${templatePath}`);
                 }
             }
+            if (opts.screens) {
+                const screenTemplates = getScreenStarterTemplates();
+                for (const [filename, content] of Object.entries(screenTemplates)) {
+                    const templatePath = path.join('spec/default/templates', filename);
+                    if (!fs.existsSync(templatePath)) {
+                        fs.writeFileSync(templatePath, content);
+                        console.log(`Created: ${templatePath}`);
+                    }
+                }
+            }
         }
-    }
-    // Create shared schemas
-    const problemDetailsPath = 'spec/_shared/openapi/problem-details.yaml';
-    if (!fs.existsSync(problemDetailsPath)) {
-        fs.writeFileSync(problemDetailsPath, generateProblemDetailsSchema());
-        console.log(`Created: ${problemDetailsPath}`);
-    }
-    // Create Spectral rules
-    const spectralPath = 'spec/spectral.yaml';
-    if (!fs.existsSync(spectralPath)) {
-        fs.writeFileSync(spectralPath, generateSpectralRules());
-        console.log(`Created: ${spectralPath}`);
-    }
-    // Create starter screen spec YAML when --screens is specified
-    if (options.screens) {
-        const screenSpecDir = `spec/${name}/openapi`;
-        fs.mkdirSync(screenSpecDir, { recursive: true });
-        const screenSpecPath = path.join(screenSpecDir, `${name}.yaml`);
-        if (!fs.existsSync(screenSpecPath)) {
-            fs.writeFileSync(screenSpecPath, generateScreenSpecTemplate(name));
-            console.log(`Created: ${screenSpecPath}`);
-        }
-    }
-    // Create server/frontend directories
-    const baseDir = path.resolve(options.dir, name);
-    const dirs = [
-        baseDir,
-        path.join(baseDir, 'services'),
-        path.join(baseDir, 'models'),
-    ];
-    for (const dir of dirs) {
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-            console.log(`Created: ${dir}/`);
+        const problemDetailsPath = 'spec/_shared/openapi/problem-details.yaml';
+        if (!fs.existsSync(problemDetailsPath)) {
+            fs.writeFileSync(problemDetailsPath, generateProblemDetailsSchema());
+            console.log(`Created: ${problemDetailsPath}`);
         }
-    }
-    // Create placeholder files
-    const files = [
-        [path.join(baseDir, 'db.ts'), generateDbTemplate()],
-        [path.join(baseDir, 'container.ts'), generateContainerTemplate(name)],
-        [path.join(baseDir, 'services', 'index.ts'), '// Export service classes\n'],
-        [path.join(baseDir, 'models', 'index.ts'), '// Export models\n'],
-    ];
-    for (const [filePath, content] of files) {
-        if (!fs.existsSync(filePath)) {
-            fs.writeFileSync(filePath, content);
-            console.log(`Created: ${filePath}`);
+        const spectralPath = 'spec/spectral.yaml';
+        if (!fs.existsSync(spectralPath)) {
+            fs.writeFileSync(spectralPath, generateSpectralRules());
+            console.log(`Created: ${spectralPath}`);
         }
-    }
-    // Create config template if not exists
-    const configPath = path.resolve('micro-contracts.config.yaml');
-    if (!fs.existsSync(configPath)) {
-        const configContent = options.screens
-            ? generateScreenConfigTemplate(name)
-            : generateConfigTemplate(name);
-        fs.writeFileSync(configPath, configContent);
-        console.log(`Created: ${configPath}`);
-    }
-    // Process OpenAPI file if provided
-    if (options.openapi) {
-        const openapiPath = path.resolve(options.openapi);
-        if (!fs.existsSync(openapiPath)) {
-            console.error(`OpenAPI file not found: ${openapiPath}`);
-            process.exit(1);
+        if (opts.screens) {
+            const screenSpecDir = `spec/${name}/openapi`;
+            fs.mkdirSync(screenSpecDir, { recursive: true });
+            const screenSpecPath = path.join(screenSpecDir, `${name}.yaml`);
+            if (!fs.existsSync(screenSpecPath)) {
+                fs.writeFileSync(screenSpecPath, generateScreenSpecTemplate(name));
+                console.log(`Created: ${screenSpecPath}`);
+            }
         }
-        const outputPath = options.output
-            ? path.resolve(options.output)
-            : path.resolve(`spec/${name}/openapi/${name}.yaml`);
-        // Ensure output directory exists
-        fs.mkdirSync(path.dirname(outputPath), { recursive: true });
-        console.log(`\nProcessing OpenAPI: ${openapiPath}`);
-        const processed = processOpenAPIWithExtensions(openapiPath);
-        fs.writeFileSync(outputPath, processed.yaml);
-        console.log(`Created: ${outputPath}`);
-        console.log(`  - Added x-micro-contracts-service to ${processed.stats.servicesAdded} operations`);
-        console.log(`  - Added x-micro-contracts-method to ${processed.stats.methodsAdded} operations`);
-        if (processed.stats.services.length > 0) {
-            console.log(`  - Detected services: ${processed.stats.services.join(', ')}`);
+        const baseDir = path.resolve(opts.dir ?? 'src', name);
+        const dirs = [
+            baseDir,
+            path.join(baseDir, 'services'),
+            path.join(baseDir, 'models'),
+        ];
+        for (const dir of dirs) {
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+                console.log(`Created: ${dir}/`);
+            }
         }
-    }
-    console.log(`\nModule "${name}" initialized!`);
-    if (options.screens) {
-        console.log(`\nNext steps:`);
-        console.log(`  1. Edit spec/${name}/openapi/${name}.yaml with your screen definitions`);
-        console.log(`  2. Define ViewModels in components/schemas`);
-        console.log(`  3. Add navigation links and x-events`);
-        console.log(`  4. Run: npx micro-contracts generate`);
-    }
-    else if (!options.openapi) {
-        console.log(`\nNext steps:`);
-        console.log(`  1. Create spec/${name}/openapi/${name}.yaml with your API spec`);
-        console.log(`  2. Add x-micro-contracts-service and x-micro-contracts-method to operations`);
-        console.log(`  3. Run: npx micro-contracts generate`);
-        console.log(`\nTip: Use --openapi to auto-add extensions:`);
-        console.log(`  npx micro-contracts init ${name} --openapi path/to/spec.yaml`);
-    }
-    else {
-        console.log(`\nNext steps:`);
-        console.log(`  1. Review the generated extensions in spec/${name}/openapi/${name}.yaml`);
-        console.log(`  2. Run: npx micro-contracts generate`);
-    }
-});
-// Deps command (dependency analysis)
-program
-    .command('deps')
-    .description('Analyze module dependencies')
-    .option('-c, --config <path>', 'Path to config file')
-    .option('-m, --module <name>', 'Module to analyze')
-    .option('--graph', 'Output dependency graph in Mermaid format')
-    .option('--impact <ref>', 'Analyze impact of changing a specific API (e.g., core.User.getUsers)')
-    .option('--who-depends-on <ref>', 'Find modules that depend on a specific API')
-    .option('--validate', 'Validate dependencies against OpenAPI declarations')
-    .action(async (options) => {
-    try {
-        const configPath = options.config
-            ? path.resolve(options.config)
-            : findConfigFile();
-        if (!configPath) {
-            console.error('Error: No config file found.');
-            process.exit(1);
+        const files = [
+            [path.join(baseDir, 'db.ts'), generateDbTemplate()],
+            [path.join(baseDir, 'container.ts'), generateContainerTemplate(name)],
+            [path.join(baseDir, 'services', 'index.ts'), '// Export service classes\n'],
+            [path.join(baseDir, 'models', 'index.ts'), '// Export models\n'],
+        ];
+        for (const [filePath, content] of files) {
+            if (!fs.existsSync(filePath)) {
+                fs.writeFileSync(filePath, content);
+                console.log(`Created: ${filePath}`);
+            }
         }
-        const config = loadConfig(configPath);
-        if (!config.modules) {
-            console.error('Error: Config must have modules defined.');
-            process.exit(1);
+        const configPath = path.resolve('micro-contracts.config.yaml');
+        if (!fs.existsSync(configPath)) {
+            const configContent = opts.screens
+                ? generateScreenConfigTemplate(name)
+                : generateConfigTemplate(name);
+            fs.writeFileSync(configPath, configContent);
+            console.log(`Created: ${configPath}`);
         }
-        // Collect dependencies from all modules
-        const moduleDeps = new Map();
-        for (const [moduleName, moduleConfig] of Object.entries(config.modules)) {
-            if (options.module && moduleName !== options.module)
-                continue;
-            const openapiPath = path.resolve(path.dirname(configPath), moduleConfig.openapi);
+        if (opts.openapi) {
+            const openapiPath = path.resolve(opts.openapi);
             if (!fs.existsSync(openapiPath)) {
-                console.warn(`Warning: OpenAPI spec not found: ${openapiPath}`);
-                continue;
+                console.error(`OpenAPI file not found: ${openapiPath}`);
+                process.exit(1);
+            }
+            const outputPath = opts.output
+                ? path.resolve(opts.output)
+                : path.resolve(`spec/${name}/openapi/${name}.yaml`);
+            fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+            console.log(`\nProcessing OpenAPI: ${openapiPath}`);
+            const processed = processOpenAPIWithExtensions(openapiPath);
+            fs.writeFileSync(outputPath, processed.yaml);
+            console.log(`Created: ${outputPath}`);
+            console.log(`  - Added x-micro-contracts-service to ${processed.stats.servicesAdded} operations`);
+            console.log(`  - Added x-micro-contracts-method to ${processed.stats.methodsAdded} operations`);
+            if (processed.stats.services.length > 0) {
+                console.log(`  - Detected services: ${processed.stats.services.join(', ')}`);
             }
-            const spec = loadOpenAPISpec(openapiPath);
-            const openApiDeps = spec.info['x-micro-contracts-depend-on'] || [];
-            const configDeps = moduleConfig.dependsOn || [];
-            moduleDeps.set(moduleName, {
-                deps: openApiDeps,
-                openApiDeps,
-                configDeps,
-            });
-        }
-        // Handle different options
-        if (options.graph) {
-            outputDependencyGraph(moduleDeps);
-        }
-        else if (options.impact) {
-            outputImpactAnalysis(moduleDeps, options.impact);
         }
-        else if (options.whoDependsOn) {
-            outputWhoDependsOn(moduleDeps, options.whoDependsOn);
+        console.log(`\nModule "${name}" initialized!`);
+        if (opts.screens) {
+            console.log(`\nNext steps:`);
+            console.log(`  1. Edit spec/${name}/openapi/${name}.yaml with your screen definitions`);
+            console.log(`  2. Define ViewModels in components/schemas`);
+            console.log(`  3. Add navigation links and x-events`);
+            console.log(`  4. Run: npx micro-contracts generate`);
         }
-        else if (options.validate) {
-            validateDependencies(moduleDeps);
+        else if (!opts.openapi) {
+            console.log(`\nNext steps:`);
+            console.log(`  1. Create spec/${name}/openapi/${name}.yaml with your API spec`);
+            console.log(`  2. Add x-micro-contracts-service and x-micro-contracts-method to operations`);
+            console.log(`  3. Run: npx micro-contracts generate`);
+            console.log(`\nTip: Use --openapi to auto-add extensions:`);
+            console.log(`  npx micro-contracts init ${name} --openapi path/to/spec.yaml`);
         }
         else {
-            // Default: show all dependencies
-            outputAllDependencies(moduleDeps);
+            console.log(`\nNext steps:`);
+            console.log(`  1. Review the generated extensions in spec/${name}/openapi/${name}.yaml`);
+            console.log(`  2. Run: npx micro-contracts generate`);
         }
-    }
-    catch (error) {
-        console.error('Deps analysis failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Check command (guardrails)
-program
-    .command('check')
-    .description('Run AI guardrail checks')
-    .option('--only <checks>', 'Run only specific checks (comma-separated)')
-    .option('--skip <checks>', 'Skip specific checks (comma-separated)')
-    .option('--gate <gates>', 'Run checks for specific gates only (comma-separated, 1-5)')
-    .option('-v, --verbose', 'Enable verbose output')
-    .option('--fix', 'Auto-fix issues where possible')
-    .option('-g, --guardrails <path>', 'Path to guardrails.yaml')
-    .option('-d, --generated-dir <path>', 'Path to generated files directory', 'packages/')
-    .option('--changed-files <path>', 'Path to file containing list of changed files (for CI)')
-    .option('--list', 'List available checks')
-    .option('--list-gates', 'List available gates')
-    .action(async (options) => {
-    try {
-        // List gates
-        if (options.listGates) {
-            console.log('\nAvailable gates:\n');
-            for (const [gate, description] of Object.entries(GATE_DESCRIPTIONS)) {
-                console.log(`  Gate ${gate}: ${description}`);
+    },
+    // ── check ─────────────────────────────────────────────
+    check: async (opts) => {
+        try {
+            if (opts.listGates) {
+                console.log('\nAvailable gates:\n');
+                for (const [gate, description] of Object.entries(GATE_DESCRIPTIONS)) {
+                    console.log(`  Gate ${gate}: ${description}`);
+                }
+                console.log('\nUsage: micro-contracts check --gate 1,2,3');
+                console.log('');
+                return;
             }
-            console.log('\nUsage: micro-contracts check --gate 1,2,3');
-            console.log('');
-            return;
-        }
-        // List checks
-        if (options.list) {
-            console.log('\nAvailable checks:\n');
-            for (const check of getAvailableChecks({ guardrailsPath: options.guardrails })) {
-                const gateStr = check.gate !== undefined ? `[G${check.gate}]` : '    ';
-                console.log(`  ${gateStr} ${check.name.padEnd(20)} - ${check.description}`);
+            if (opts.list) {
+                console.log('\nAvailable checks:\n');
+                for (const check of getAvailableChecks({ guardrailsPath: opts.guardrails })) {
+                    const gateStr = check.gate !== undefined ? `[G${check.gate}]` : '    ';
+                    console.log(`  ${gateStr} ${check.name.padEnd(20)} - ${check.description}`);
+                }
+                console.log('');
+                return;
+            }
+            let gates;
+            if (opts.gate) {
+                gates = opts.gate.split(',').map((s) => {
+                    const num = parseInt(s.trim(), 10);
+                    if (num < 1 || num > 5 || isNaN(num)) {
+                        throw new Error(`Invalid gate number: ${s}. Must be 1-5.`);
+                    }
+                    return num;
+                });
             }
             console.log('');
-            return;
-        }
-        // Parse gate option
-        let gates;
-        if (options.gate) {
-            gates = options.gate.split(',').map((s) => {
-                const num = parseInt(s.trim(), 10);
-                if (num < 1 || num > 5 || isNaN(num)) {
-                    throw new Error(`Invalid gate number: ${s}. Must be 1-5.`);
-                }
-                return num;
-            });
-        }
-        // Print header immediately
-        console.log('');
-        console.log('🔍 AI Guardrail Check Results');
-        console.log('═'.repeat(50));
-        console.log('');
-        // Track whether we're using streaming output (default: yes for TTY)
-        const isStreaming = process.stdout.isTTY !== false;
-        // Parse options with streaming callbacks
-        const checkOptions = {
-            only: options.only?.split(',').map((s) => s.trim()),
-            skip: options.skip?.split(',').map((s) => s.trim()),
-            gates,
-            verbose: options.verbose,
-            fix: options.fix,
-            guardrailsPath: options.guardrails,
-            generatedDir: options.generatedDir,
-            changedFilesPath: options.changedFiles,
-            // Streaming output callbacks
-            onCheckStart: isStreaming ? (check) => {
-                // Clear line and show "running..." message
-                if (process.stdout.isTTY) {
-                    process.stdout.write(formatCheckStart(check) + '\r');
-                }
-            } : undefined,
-            onCheckComplete: isStreaming ? (result, check) => {
-                // Clear the "running..." line and print result
-                if (process.stdout.isTTY) {
-                    process.stdout.clearLine?.(0);
-                    process.stdout.cursorTo?.(0);
-                }
-                console.log(formatSingleCheckResult(result, check, options.verbose));
-            } : undefined,
-        };
-        // Run checks
-        const summary = await runAllChecks(checkOptions);
-        // Output results
-        if (isStreaming) {
-            // Only output summary (individual results already printed)
-            console.log(formatCheckSummary(summary, summary.checks));
-        }
-        else {
-            // Non-streaming: output everything at once
-            console.log(formatCheckResults(summary, options.verbose, summary.checks));
+            console.log('🔍 AI Guardrail Check Results');
+            console.log('═'.repeat(50));
+            console.log('');
+            const isStreaming = process.stdout.isTTY !== false;
+            const checkOptions = {
+                only: opts.only?.split(',').map((s) => s.trim()),
+                skip: opts.skip?.split(',').map((s) => s.trim()),
+                gates,
+                verbose: opts.verbose,
+                fix: opts.fix,
+                guardrailsPath: opts.guardrails,
+                generatedDir: opts.generatedDir,
+                changedFilesPath: opts.changedFiles,
+                onCheckStart: isStreaming ? (check) => {
+                    if (process.stdout.isTTY) {
+                        process.stdout.write(formatCheckStart(check) + '\r');
+                    }
+                } : undefined,
+                onCheckComplete: isStreaming ? (result, check) => {
+                    if (process.stdout.isTTY) {
+                        process.stdout.clearLine?.(0);
+                        process.stdout.cursorTo?.(0);
+                    }
+                    console.log(formatSingleCheckResult(result, check, opts.verbose));
+                } : undefined,
+            };
+            const summary = await runAllChecks(checkOptions);
+            if (isStreaming) {
+                console.log(formatCheckSummary(summary, summary.checks));
+            }
+            else {
+                console.log(formatCheckResults(summary, opts.verbose, summary.checks));
+            }
+            if (summary.failed > 0) {
+                process.exit(1);
+            }
         }
-        // Exit with error if any checks failed
-        if (summary.failed > 0) {
+        catch (error) {
+            console.error('Check failed:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
-    }
-    catch (error) {
-        console.error('Check failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Pipeline command (Gate 1,2 → Generate → Gate 3,4,5)
-program
-    .command('pipeline')
-    .description('Run full guardrails pipeline: Gate 1,2 → Generate → Gate 3,4,5')
-    .option('-v, --verbose', 'Enable verbose output (show detailed logs)')
-    .option('--skip <checks>', 'Skip specific checks (comma-separated)')
-    .option('--continue-on-error', 'Continue running even if a step fails')
-    .option('-g, --guardrails <path>', 'Path to guardrails.yaml')
-    .option('-c, --config <path>', 'Path to config file (micro-contracts.config.yaml)')
-    .option('-d, --generated-dir <path>', 'Path to generated files directory', 'packages/')
-    .option('--no-manifest', 'Skip manifest generation')
-    .option('--skip-lint', 'Skip linting before generation')
-    .option('--contracts-only', 'Generate contract packages only')
-    .option('--server-only', 'Generate server routes only')
-    .option('--frontend-only', 'Generate frontend clients only')
-    .option('--docs-only', 'Generate documentation only')
-    .option('--force', 'Bypass input hash cache and always regenerate')
-    .option('--no-cache', 'Run without reading or writing input hash cache')
-    .action(async (options) => {
-    try {
-        const startTime = Date.now();
-        const verbose = options.verbose;
-        let hasFailure = false;
-        let generatePassed = false;
-        let generateDuration = 0;
-        let generateSkipped = false;
-        let generateError = null;
-        // All results for final summary
-        const allResults = [];
-        console.log('');
-        console.log('🚀 Running AI Guardrails Pipeline');
-        console.log('═'.repeat(50));
-        console.log('');
-        // Parse skip option
-        const skipChecks = options.skip?.split(',').map((s) => s.trim()) || [];
-        // Common check options
-        const isStreaming = process.stdout.isTTY !== false;
-        const baseCheckOptions = {
-            verbose,
-            skip: skipChecks,
-            guardrailsPath: options.guardrails,
-            generatedDir: options.generatedDir,
-            onCheckStart: isStreaming ? (check) => {
-                if (process.stdout.isTTY) {
-                    process.stdout.write(formatCheckStart(check) + '\r');
-                }
-            } : undefined,
-            onCheckComplete: isStreaming ? (result, check) => {
-                if (process.stdout.isTTY) {
-                    process.stdout.clearLine?.(0);
-                    process.stdout.cursorTo?.(0);
-                }
-                console.log(formatSingleCheckResult(result, check, verbose));
-            } : undefined,
-        };
-        // ========================================
-        // Step 1: Gate 1,2 (Pre-generation checks)
-        // ========================================
-        if (verbose) {
-            console.log('┌─────────────────────────────────────────────────┐');
-            console.log('│ Step 1: Pre-generation checks (Gate 1, 2)       │');
-            console.log('└─────────────────────────────────────────────────┘');
+    },
+    // ── pipeline ──────────────────────────────────────────
+    pipeline: async (opts) => {
+        try {
+            const startTime = Date.now();
+            const verbose = opts.verbose;
+            let hasFailure = false;
+            let generatePassed = false;
+            let generateDuration = 0;
+            let generateSkipped = false;
+            let generateError = null;
+            const allResults = [];
             console.log('');
-        }
-        const gate12Summary = await runAllChecks({
-            ...baseCheckOptions,
-            gates: [1, 2],
-        });
-        // Collect results (only non-skipped for display count)
-        allResults.push(...gate12Summary.results);
-        if (verbose) {
-            console.log(formatCheckSummary(gate12Summary, gate12Summary.checks));
-        }
-        if (gate12Summary.failed > 0) {
-            hasFailure = true;
-            if (!options.continueOnError) {
+            console.log('🚀 Running AI Guardrails Pipeline');
+            console.log('═'.repeat(50));
+            console.log('');
+            const skipChecks = opts.skip?.split(',').map((s) => s.trim()) || [];
+            const isStreaming = process.stdout.isTTY !== false;
+            const baseCheckOptions = {
+                verbose,
+                skip: skipChecks,
+                guardrailsPath: opts.guardrails,
+                generatedDir: opts.generatedDir,
+                onCheckStart: isStreaming ? (check) => {
+                    if (process.stdout.isTTY) {
+                        process.stdout.write(formatCheckStart(check) + '\r');
+                    }
+                } : undefined,
+                onCheckComplete: isStreaming ? (result, check) => {
+                    if (process.stdout.isTTY) {
+                        process.stdout.clearLine?.(0);
+                        process.stdout.cursorTo?.(0);
+                    }
+                    console.log(formatSingleCheckResult(result, check, verbose));
+                } : undefined,
+            };
+            // Step 1: Gate 1,2
+            if (verbose) {
+                console.log('┌─────────────────────────────────────────────────┐');
+                console.log('│ Step 1: Pre-generation checks (Gate 1, 2)       │');
+                console.log('└─────────────────────────────────────────────────┘');
                 console.log('');
-                console.log('❌ Gate 1,2 failed. Stopping pipeline.');
-                console.log('   Use --continue-on-error to continue despite failures.');
-                process.exit(1);
             }
+            const gate12Summary = await runAllChecks({ ...baseCheckOptions, gates: [1, 2] });
+            allResults.push(...gate12Summary.results);
+            if (verbose)
+                console.log(formatCheckSummary(gate12Summary, gate12Summary.checks));
+            if (gate12Summary.failed > 0) {
+                hasFailure = true;
+                if (!opts.continueOnError) {
+                    console.log('');
+                    console.log('❌ Gate 1,2 failed. Stopping pipeline.');
+                    console.log('   Use --continue-on-error to continue despite failures.');
+                    process.exit(1);
+                }
+                if (verbose)
+                    console.log('⚠️  Gate 1,2 had failures. Continuing due to --continue-on-error.\n');
+            }
+            // Step 2: Generate
+            let generationCacheSkipped = false;
             if (verbose) {
-                console.log('⚠️  Gate 1,2 had failures. Continuing due to --continue-on-error.');
+                console.log('┌─────────────────────────────────────────────────┐');
+                console.log('│ Step 2: Generate contracts                      │');
+                console.log('└─────────────────────────────────────────────────┘');
                 console.log('');
             }
-        }
-        // ========================================
-        // Step 2: Generate
-        // ========================================
-        let generationCacheSkipped = false;
-        if (verbose) {
-            console.log('┌─────────────────────────────────────────────────┐');
-            console.log('│ Step 2: Generate contracts                      │');
-            console.log('└─────────────────────────────────────────────────┘');
-            console.log('');
-        }
-        const generateStartTime = Date.now();
-        // Show "running..." indicator for generate
-        if (isStreaming && process.stdout.isTTY) {
-            process.stdout.write('  ⋯ Generate              running...\r');
-        }
-        try {
-            // Load config
-            const configPath = options.config
-                ? path.resolve(options.config)
-                : findConfigFile();
-            if (!configPath) {
-                generateSkipped = true;
-                generateDuration = Date.now() - generateStartTime;
-                // Clear the running indicator
-                if (isStreaming && process.stdout.isTTY) {
-                    process.stdout.clearLine?.(0);
-                    process.stdout.cursorTo?.(0);
-                }
-                console.log('  ○ Generate              SKIP (no config file)');
+            const generateStartTime = Date.now();
+            if (isStreaming && process.stdout.isTTY) {
+                process.stdout.write('  ⋯ Generate              running...\r');
             }
-            else {
-                if (verbose) {
-                    console.log(`  Using config: ${configPath}`);
+            try {
+                const configPath = opts.config ? path.resolve(opts.config) : findConfigFile();
+                if (!configPath) {
+                    generateSkipped = true;
+                    generateDuration = Date.now() - generateStartTime;
+                    if (isStreaming && process.stdout.isTTY) {
+                        process.stdout.clearLine?.(0);
+                        process.stdout.cursorTo?.(0);
+                    }
+                    console.log('  ○ Generate              SKIP (no config file)');
                 }
-                const config = loadConfig(configPath);
-                // Compute input hash for cache (multi-module only)
-                const useCache = options.cache !== false && !options.force;
-                let inputHash;
-                if (isMultiModuleConfig(config)) {
-                    inputHash = computeInputHash(config, configPath, pkg.version);
-                    if (useCache) {
-                        const manifestDir = options.generatedDir || 'packages/';
-                        const skipCheck = await canSkipGeneration(manifestDir, inputHash);
-                        if (skipCheck.skip) {
-                            generationCacheSkipped = true;
-                            generateSkipped = true;
-                            generateDuration = Date.now() - generateStartTime;
-                            if (isStreaming && process.stdout.isTTY) {
-                                process.stdout.clearLine?.(0);
-                                process.stdout.cursorTo?.(0);
+                else {
+                    if (verbose)
+                        console.log(`  Using config: ${configPath}`);
+                    const config = loadConfig(configPath);
+                    const useCache = opts.cache !== false && !opts.force;
+                    let inputHash;
+                    if (isMultiModuleConfig(config)) {
+                        inputHash = computeInputHash(config, configPath, pkg.version);
+                        if (useCache) {
+                            const manifestDir = opts.generatedDir || 'packages/';
+                            const skipCheck = await canSkipGeneration(manifestDir, inputHash);
+                            if (skipCheck.skip) {
+                                generationCacheSkipped = true;
+                                generateSkipped = true;
+                                generateDuration = Date.now() - generateStartTime;
+                                if (isStreaming && process.stdout.isTTY) {
+                                    process.stdout.clearLine?.(0);
+                                    process.stdout.cursorTo?.(0);
+                                }
+                                console.log(`  ○ Generate              SKIP (${skipCheck.reason})`);
                             }
-                            console.log(`  ○ Generate              SKIP (${skipCheck.reason})`);
                         }
                     }
-                }
-                if (!generationCacheSkipped) {
-                    // Suppress console output during generation (unless verbose)
-                    const originalLog = console.log;
-                    if (!verbose) {
-                        console.log = () => { };
-                    }
-                    try {
-                        // Run generation
-                        await generate(config, {
-                            skipLint: options.skipLint,
-                            contractsOnly: options.contractsOnly,
-                            serverOnly: options.serverOnly,
-                            frontendOnly: options.frontendOnly,
-                            docsOnly: options.docsOnly,
-                        });
-                        // Generate manifest if enabled
-                        if (options.manifest !== false) {
-                            const { config: guardrailsConfig } = loadGuardrailsConfigWithPath(options.guardrails);
-                            if (guardrailsConfig?.generated && guardrailsConfig.generated.length > 0) {
-                                const manifestDir = options.generatedDir || 'packages/';
-                                if (fs.existsSync(manifestDir)) {
-                                    const manifestInputHash = (options.cache !== false) ? inputHash : undefined;
-                                    const { manifest, changed } = await generateManifest(manifestDir, {
-                                        generatorVersion: pkg.version,
-                                        inputHash: manifestInputHash,
-                                    });
-                                    // Only log in verbose mode
-                                    if (verbose) {
-                                        const fileCount = Object.keys(manifest.files).length;
-                                        if (changed) {
-                                            const manifestPath = writeManifest(manifest, manifestDir);
-                                            originalLog(`  Manifest updated: ${manifestPath} (${fileCount} files)`);
+                    if (!generationCacheSkipped) {
+                        const originalLog = console.log;
+                        if (!verbose)
+                            console.log = () => { };
+                        try {
+                            await generate(config, {
+                                skipLint: opts.skipLint,
+                                contractsOnly: opts.contractsOnly,
+                                serverOnly: opts.serverOnly,
+                                frontendOnly: opts.frontendOnly,
+                                docsOnly: opts.docsOnly,
+                            });
+                            if (opts.manifest !== false) {
+                                const { config: guardrailsConfig } = loadGuardrailsConfigWithPath(opts.guardrails);
+                                if (guardrailsConfig?.generated && guardrailsConfig.generated.length > 0) {
+                                    const manifestDir = opts.generatedDir || 'packages/';
+                                    if (fs.existsSync(manifestDir)) {
+                                        const manifestInputHash = (opts.cache !== false) ? inputHash : undefined;
+                                        const { manifest, changed } = await generateManifest(manifestDir, {
+                                            generatorVersion: pkg.version,
+                                            inputHash: manifestInputHash,
+                                        });
+                                        if (verbose) {
+                                            const fileCount = Object.keys(manifest.files).length;
+                                            if (changed) {
+                                                const mPath = writeManifest(manifest, manifestDir);
+                                                originalLog(`  Manifest updated: ${mPath} (${fileCount} files)`);
+                                            }
+                                            else {
+                                                originalLog(`  Manifest unchanged (${fileCount} files)`);
+                                            }
                                         }
-                                        else {
-                                            originalLog(`  Manifest unchanged (${fileCount} files)`);
+                                        else if (changed) {
+                                            writeManifest(manifest, manifestDir);
                                         }
                                     }
-                                    else if (changed) {
-                                        // Still write the manifest even in non-verbose mode
-                                        writeManifest(manifest, manifestDir);
-                                    }
                                 }
                             }
+                            generatePassed = true;
                         }
-                        generatePassed = true;
-                    }
-                    finally {
-                        // Restore console.log
-                        if (!verbose) {
-                            console.log = originalLog;
+                        finally {
+                            if (!verbose)
+                                console.log = originalLog;
                         }
-                    }
-                    generateDuration = Date.now() - generateStartTime;
-                    // Clear the running indicator
-                    if (isStreaming && process.stdout.isTTY) {
-                        process.stdout.clearLine?.(0);
-                        process.stdout.cursorTo?.(0);
-                    }
-                    console.log(`  ✓ Generate              PASS (${generateDuration}ms)`);
-                    if (verbose) {
-                        console.log('');
+                        generateDuration = Date.now() - generateStartTime;
+                        if (isStreaming && process.stdout.isTTY) {
+                            process.stdout.clearLine?.(0);
+                            process.stdout.cursorTo?.(0);
+                        }
+                        console.log(`  ✓ Generate              PASS (${generateDuration}ms)`);
+                        if (verbose)
+                            console.log('');
                     }
                 }
             }
-        }
-        catch (error) {
-            generateDuration = Date.now() - generateStartTime;
-            hasFailure = true;
-            generateError = error instanceof Error ? error.message : String(error);
-            // Clear the running indicator
-            if (isStreaming && process.stdout.isTTY) {
-                process.stdout.clearLine?.(0);
-                process.stdout.cursorTo?.(0);
-            }
-            console.log(`  ✗ Generate              FAIL (${generateDuration}ms)`);
-            if (verbose || true) { // Always show error message
+            catch (error) {
+                generateDuration = Date.now() - generateStartTime;
+                hasFailure = true;
+                generateError = error instanceof Error ? error.message : String(error);
+                if (isStreaming && process.stdout.isTTY) {
+                    process.stdout.clearLine?.(0);
+                    process.stdout.cursorTo?.(0);
+                }
+                console.log(`  ✗ Generate              FAIL (${generateDuration}ms)`);
                 console.log(`    ${generateError}`);
+                if (!opts.continueOnError) {
+                    console.log('');
+                    console.log('❌ Generation failed. Stopping pipeline.');
+                    process.exit(1);
+                }
+                if (verbose)
+                    console.log('⚠️  Continuing due to --continue-on-error.');
             }
-            if (!options.continueOnError) {
-                console.log('');
-                console.log('❌ Generation failed. Stopping pipeline.');
-                process.exit(1);
-            }
+            // Step 3: Gate 3,4,5
             if (verbose) {
-                console.log('⚠️  Continuing due to --continue-on-error.');
+                console.log('');
+                console.log('┌─────────────────────────────────────────────────┐');
+                console.log('│ Step 3: Post-generation checks (Gate 3, 4, 5)   │');
+                console.log('└─────────────────────────────────────────────────┘');
+                console.log('');
             }
-        }
-        // ========================================
-        // Step 3: Gate 3,4,5 (Post-generation checks)
-        // ========================================
-        if (verbose) {
+            const gate3Skips = generationCacheSkipped
+                ? [...skipChecks, 'drift', 'manifest']
+                : skipChecks;
+            const gate345Summary = await runAllChecks({
+                ...baseCheckOptions,
+                skip: gate3Skips,
+                gates: [3, 4, 5],
+            });
+            allResults.push(...gate345Summary.results);
+            if (verbose)
+                console.log(formatCheckSummary(gate345Summary, gate345Summary.checks));
+            if (gate345Summary.failed > 0)
+                hasFailure = true;
+            // Final Summary
+            const totalDuration = Date.now() - startTime;
+            const totalPassed = gate12Summary.passed + gate345Summary.passed + (generatePassed ? 1 : 0);
+            const totalFailed = gate12Summary.failed + gate345Summary.failed + (generateError ? 1 : 0);
+            const totalSkipped = gate12Summary.skipped + gate345Summary.skipped + (generateSkipped ? 1 : 0);
             console.log('');
-            console.log('┌─────────────────────────────────────────────────┐');
-            console.log('│ Step 3: Post-generation checks (Gate 3, 4, 5)   │');
-            console.log('└─────────────────────────────────────────────────┘');
+            console.log('━'.repeat(50));
+            console.log('📊 Pipeline Summary');
+            console.log('━'.repeat(50));
             console.log('');
-        }
-        // When generation was skipped via cache, drift/manifest are
-        // already verified — skip them to avoid redundant work.
-        const gate3Skips = generationCacheSkipped
-            ? [...skipChecks, 'drift', 'manifest']
-            : skipChecks;
-        const gate345Summary = await runAllChecks({
-            ...baseCheckOptions,
-            skip: gate3Skips,
-            gates: [3, 4, 5],
-        });
-        // Collect results
-        allResults.push(...gate345Summary.results);
-        if (verbose) {
-            console.log(formatCheckSummary(gate345Summary, gate345Summary.checks));
-        }
-        if (gate345Summary.failed > 0) {
-            hasFailure = true;
-        }
-        // ========================================
-        // Final Summary
-        // ========================================
-        const totalDuration = Date.now() - startTime;
-        const totalPassed = gate12Summary.passed + gate345Summary.passed + (generatePassed ? 1 : 0);
-        const totalFailed = gate12Summary.failed + gate345Summary.failed + (generateError ? 1 : 0);
-        const totalSkipped = gate12Summary.skipped + gate345Summary.skipped + (generateSkipped ? 1 : 0);
-        console.log('');
-        console.log('━'.repeat(50));
-        console.log('📊 Pipeline Summary');
-        console.log('━'.repeat(50));
-        console.log('');
-        console.log(`  Total Passed:  ${totalPassed}`);
-        console.log(`  Total Failed:  ${totalFailed}`);
-        if (totalSkipped > 0) {
-            console.log(`  Total Skipped: ${totalSkipped}`);
-        }
-        console.log(`  Duration:      ${totalDuration}ms`);
-        console.log('');
-        if (hasFailure) {
-            console.log('❌ Pipeline completed with failures.');
-            // Show failed check details
-            const failedResults = allResults.filter(r => r.status === 'fail' && r.details && r.details.length > 0);
-            if (failedResults.length > 0) {
-                console.log('');
-                console.log('📋 Failed Check Details:');
-                for (const result of failedResults) {
-                    console.log(`  ▶ ${result.name}`);
-                    for (const detail of result.details) {
-                        console.log(`    ${detail}`);
+            console.log(`  Total Passed:  ${totalPassed}`);
+            console.log(`  Total Failed:  ${totalFailed}`);
+            if (totalSkipped > 0)
+                console.log(`  Total Skipped: ${totalSkipped}`);
+            console.log(`  Duration:      ${totalDuration}ms`);
+            console.log('');
+            if (hasFailure) {
+                console.log('❌ Pipeline completed with failures.');
+                const failedResults = allResults.filter(r => r.status === 'fail' && r.details && r.details.length > 0);
+                if (failedResults.length > 0) {
+                    console.log('');
+                    console.log('📋 Failed Check Details:');
+                    for (const result of failedResults) {
+                        console.log(`  ▶ ${result.name}`);
+                        for (const detail of result.details) {
+                            console.log(`    ${detail}`);
+                        }
                     }
                 }
+                process.exit(1);
+            }
+            else {
+                console.log('✅ Pipeline completed successfully!');
             }
+            console.log('');
+        }
+        catch (error) {
+            console.error('Pipeline failed:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
-        else {
-            console.log('✅ Pipeline completed successfully!');
+    },
+    // ── deps ──────────────────────────────────────────────
+    deps: async (opts) => {
+        try {
+            const configPath = opts.config
+                ? path.resolve(opts.config)
+                : findConfigFile();
+            if (!configPath) {
+                console.error('Error: No config file found.');
+                process.exit(1);
+            }
+            const config = loadConfig(configPath);
+            if (!config.modules) {
+                console.error('Error: Config must have modules defined.');
+                process.exit(1);
+            }
+            const moduleDeps = new Map();
+            for (const [moduleName, moduleConfig] of Object.entries(config.modules)) {
+                if (opts.module && moduleName !== opts.module)
+                    continue;
+                const openapiPath = path.resolve(path.dirname(configPath), moduleConfig.openapi);
+                if (!fs.existsSync(openapiPath)) {
+                    console.warn(`Warning: OpenAPI spec not found: ${openapiPath}`);
+                    continue;
+                }
+                const spec = loadOpenAPISpec(openapiPath);
+                const openApiDeps = spec.info['x-micro-contracts-depend-on'] || [];
+                const configDeps = moduleConfig.dependsOn || [];
+                moduleDeps.set(moduleName, { deps: openApiDeps, openApiDeps, configDeps });
+            }
+            if (opts.graph) {
+                outputDependencyGraph(moduleDeps);
+            }
+            else if (opts.impact) {
+                outputImpactAnalysis(moduleDeps, opts.impact);
+            }
+            else if (opts.whoDependsOn) {
+                outputWhoDependsOn(moduleDeps, opts.whoDependsOn);
+            }
+            else if (opts.validate) {
+                validateDependencies(moduleDeps);
+            }
+            else {
+                outputAllDependencies(moduleDeps);
+            }
         }
-        console.log('');
-    }
-    catch (error) {
-        console.error('Pipeline failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Guardrails init command
-program
-    .command('guardrails-init')
-    .description('Create a guardrails.yaml configuration file')
-    .option('-o, --output <path>', 'Output path', 'guardrails.yaml')
-    .action((options) => {
-    try {
-        const outputPath = options.output;
-        if (fs.existsSync(outputPath)) {
-            console.error(`File already exists: ${outputPath}`);
-            console.error('Use --output to specify a different path.');
+        catch (error) {
+            console.error('Deps analysis failed:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
-        createGuardrailsConfig(outputPath);
-        console.log(`Created: ${outputPath}`);
-        console.log('\nNext steps:');
-        console.log('  1. Review and customize the guardrails configuration');
-        console.log('  2. Run: micro-contracts check');
-    }
-    catch (error) {
-        console.error('Failed to create guardrails config:', error instanceof Error ? error.message : error);
-        process.exit(1);
-    }
-});
-// Manifest command
-program
-    .command('manifest')
-    .description('Generate or verify manifest for generated artifacts')
-    .option('-d, --dir <path>', 'Directory to scan', 'packages/')
-    .option('--verify', 'Verify existing manifest')
-    .option('-o, --output <path>', 'Output manifest path (default: {dir}/.generated-manifest.json)')
-    .action(async (options) => {
-    try {
-        const baseDir = options.dir;
-        if (!fs.existsSync(baseDir)) {
-            console.error(`Directory not found: ${baseDir}`);
+    },
+    // ── guardrails-init ───────────────────────────────────
+    guardrailsInit: async (opts) => {
+        try {
+            const outputPath = opts.output ?? 'guardrails.yaml';
+            if (fs.existsSync(outputPath)) {
+                console.error(`File already exists: ${outputPath}`);
+                console.error('Use --output to specify a different path.');
+                process.exit(1);
+            }
+            createGuardrailsConfig(outputPath);
+            console.log(`Created: ${outputPath}`);
+            console.log('\nNext steps:');
+            console.log('  1. Review and customize the guardrails configuration');
+            console.log('  2. Run: micro-contracts check');
+        }
+        catch (error) {
+            console.error('Failed to create guardrails config:', error instanceof Error ? error.message : error);
             process.exit(1);
         }
-        if (options.verify) {
-            // Verify mode
-            const { verifyManifest, formatManifestResult } = await import('./guardrails/index.js');
-            const result = await verifyManifest(baseDir);
-            console.log(formatManifestResult(result));
-            if (!result.valid) {
+    },
+    // ── manifest ──────────────────────────────────────────
+    manifest: async (opts) => {
+        try {
+            const baseDir = opts.dir ?? 'packages/';
+            if (!fs.existsSync(baseDir)) {
+                console.error(`Directory not found: ${baseDir}`);
                 process.exit(1);
             }
-        }
-        else {
-            // Generate mode
-            console.log(`Generating manifest for: ${baseDir}`);
-            const { manifest, changed } = await generateManifest(baseDir, {
-                generatorVersion: pkg.version,
-            });
-            const fileCount = Object.keys(manifest.files).length;
-            if (changed) {
-                const manifestPath = writeManifest(manifest, baseDir);
-                console.log(`Manifest updated: ${manifestPath} (${fileCount} files)`);
+            if (opts.verify) {
+                const { verifyManifest, formatManifestResult } = await import('./guardrails/index.js');
+                const result = await verifyManifest(baseDir);
+                console.log(formatManifestResult(result));
+                if (!result.valid) {
+                    process.exit(1);
+                }
             }
             else {
-                console.log(`Manifest unchanged (${fileCount} files)`);
+                console.log(`Generating manifest for: ${baseDir}`);
+                const { manifest, changed } = await generateManifest(baseDir, {
+                    generatorVersion: pkg.version,
+                });
+                const fileCount = Object.keys(manifest.files).length;
+                if (changed) {
+                    const manifestPath = writeManifest(manifest, baseDir);
+                    console.log(`Manifest updated: ${manifestPath} (${fileCount} files)`);
+                }
+                else {
+                    console.log(`Manifest unchanged (${fileCount} files)`);
+                }
+            }
+        }
+        catch (error) {
+            console.error('Manifest operation failed:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+    },
+    // ── audit-openapi (LLM) ──────────────────────────────
+    auditOpenapi: async (opts) => {
+        return commandAuditOpenapi({
+            config: opts.config,
+            module: opts.module,
+            adapter: opts.adapter,
+            model: opts.model,
+            showPrompt: opts.showPrompt,
+            failOn: opts.failOn,
+            output: opts.output,
+            reportFormat: opts.reportFormat,
+        });
+    },
+    // ── review-published (LLM) ───────────────────────────
+    reviewPublished: async (opts) => {
+        return commandReviewPublished({
+            config: opts.config,
+            module: opts.module,
+            adapter: opts.adapter,
+            model: opts.model,
+            showPrompt: opts.showPrompt,
+            failOn: opts.failOn,
+            output: opts.output,
+            reportFormat: opts.reportFormat,
+        });
+    },
+    // ── propose-overlays (LLM) ───────────────────────────
+    proposeOverlays: async (opts) => {
+        return commandProposeOverlays({
+            config: opts.config,
+            module: opts.module,
+            adapter: opts.adapter,
+            model: opts.model,
+            showPrompt: opts.showPrompt,
+            failOn: opts.failOn,
+            output: opts.output,
+            reportFormat: opts.reportFormat,
+        });
+    },
+    // ── audit-guardrails (LLM) ───────────────────────────
+    auditGuardrails: async (opts) => {
+        return commandAuditGuardrails({
+            config: opts.config,
+            guardrails: opts.guardrails,
+            adapter: opts.adapter,
+            model: opts.model,
+            showPrompt: opts.showPrompt,
+            failOn: opts.failOn,
+            output: opts.output,
+            reportFormat: opts.reportFormat,
+        });
+    },
+};
+createProgram(handlers, pkg.version).parse();
+// =============================================================================
+// Helper functions (used by init, deps commands)
+// =============================================================================
+function processOpenAPIWithExtensions(openapiPath) {
+    const content = fs.readFileSync(openapiPath, 'utf-8');
+    const spec = yaml.parse(content);
+    const stats = { servicesAdded: 0, methodsAdded: 0, services: new Set() };
+    const httpMethods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+    if (spec.paths) {
+        for (const [pathKey, pathItem] of Object.entries(spec.paths)) {
+            if (!pathItem || typeof pathItem !== 'object')
+                continue;
+            const service = inferServiceFromPath(pathKey);
+            for (const method of httpMethods) {
+                const operation = pathItem[method];
+                if (!operation || typeof operation !== 'object')
+                    continue;
+                const op = operation;
+                if (!op['x-micro-contracts-service'] && service) {
+                    op['x-micro-contracts-service'] = service;
+                    stats.servicesAdded++;
+                    stats.services.add(service);
+                }
+                if (!op['x-micro-contracts-method']) {
+                    const methodName = op.operationId
+                        ? String(op.operationId)
+                        : inferMethodName(method, pathKey);
+                    op['x-micro-contracts-method'] = methodName;
+                    stats.methodsAdded++;
+                }
             }
         }
     }
-    catch (error) {
-        console.error('Manifest operation failed:', error instanceof Error ? error.message : error);
-        process.exit(1);
+    const output = yaml.stringify(spec, { indent: 2 });
+    return { yaml: output, stats: { ...stats, services: Array.from(stats.services) } };
+}
+function inferServiceFromPath(pathKey) {
+    const normalized = pathKey.replace(/^\/api\//, '/').replace(/^\/v\d+\//, '/');
+    const segments = normalized.split('/').filter(Boolean);
+    if (segments.length === 0)
+        return null;
+    const firstSegment = segments[0];
+    if (firstSegment.startsWith('{'))
+        return null;
+    const words = firstSegment.replace(/-/g, '_').split('_');
+    const pascalCase = words
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+    if (pascalCase.endsWith('s') && !pascalCase.endsWith('ss')) {
+        return pascalCase.slice(0, -1);
     }
-});
-program.parse();
-/**
- * Find config file in current directory
- */
-function findConfigFile() {
-    const candidates = [
-        'micro-contracts.config.yaml',
-        'micro-contracts.config.yml',
-        'api-framework.config.yaml', // Legacy name
-        'api-framework.config.yml',
-    ];
-    for (const candidate of candidates) {
-        const configPath = path.resolve(candidate);
-        if (fs.existsSync(configPath)) {
-            return configPath;
-        }
+    return pascalCase;
+}
+function inferMethodName(httpMethod, pathKey) {
+    const segments = pathKey
+        .replace(/^\/api\//, '/')
+        .replace(/^\/v\d+\//, '/')
+        .split('/')
+        .filter(Boolean);
+    const hasIdParam = segments.some(s => s.startsWith('{'));
+    const resourceSegments = segments.filter(s => !s.startsWith('{'));
+    const resourceName = resourceSegments
+        .map((seg) => {
+        const words = seg.replace(/-/g, '_').split('_');
+        return words
+            .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join('');
+    })
+        .join('');
+    const singularName = resourceName.endsWith('s') && !resourceName.endsWith('ss')
+        ? resourceName.slice(0, -1)
+        : resourceName;
+    switch (httpMethod.toLowerCase()) {
+        case 'get': return hasIdParam ? `get${singularName}ById` : `get${resourceName}`;
+        case 'post': return `create${singularName}`;
+        case 'put': return `update${singularName}`;
+        case 'patch': return `patch${singularName}`;
+        case 'delete': return `delete${singularName}`;
+        default: return `${httpMethod.toLowerCase()}${resourceName}`;
     }
-    return null;
 }
 function generateDbTemplate() {
-    return `/**
- * Database connection for this module
- */
-
-import pg from 'pg';
+    return `import pg from 'pg';
 import { DBModel, PostgresDriver } from 'litedbmodel';
 
 const { Pool } = pg;
 
 let pool: pg.Pool | null = null;
 
-/**
- * Get database connection pool
- */
 export function getPool(): pg.Pool {
   if (!pool) {
     pool = new Pool({
@@ -865,16 +818,9 @@ export function getPool(): pg.Pool {
   return pool;
 }
 
-/**
- * Initialize database connection
- */
 export async function initializeDb(): Promise<void> {
   const p = getPool();
-  
-  // Set litedbmodel driver
   DBModel.setDriver(new PostgresDriver(p));
-  
-  // Test connection
   const client = await p.connect();
   try {
     await client.query('SELECT 1');
@@ -883,9 +829,6 @@ export async function initializeDb(): Promise<void> {
   }
 }
 
-/**
- * Close database connection
- */
 export async function closeDb(): Promise<void> {
   if (pool) {
     await pool.end();
@@ -893,9 +836,6 @@ export async function closeDb(): Promise<void> {
   }
 }
 
-/**
- * Test database connection
- */
 export async function testConnection(): Promise<boolean> {
   try {
     const p = getPool();
@@ -914,17 +854,7 @@ export async function testConnection(): Promise<boolean> {
 }
 function generateContainerTemplate(moduleName) {
     const pascalName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
-    return `/**
- * Module container (Dependency Injection)
- */
-
-import { testConnection, closeDb } from './db.js';
-
-// Import service implementations
-// import { ExampleService } from './services/ExampleService.js';
-
-// Import service interfaces from contract
-// import type { ExampleServiceApi } from '@project/contract/${moduleName}/services';
+    return `import { testConnection, closeDb } from './db.js';
 
 export interface ${pascalName}Services {
   // example: ExampleServiceApi;
@@ -937,9 +867,7 @@ export interface ${pascalName}ModuleContainer {
 }
 
 export async function initialize${pascalName}Module(): Promise<${pascalName}ModuleContainer> {
-  const services: ${pascalName}Services = {
-    // example: new ExampleService(),
-  };
+  const services: ${pascalName}Services = {};
 
   return {
     services,
@@ -949,206 +877,39 @@ export async function initialize${pascalName}Module(): Promise<${pascalName}Modu
 }
 `;
 }
-/**
- * Process OpenAPI file and auto-add x-micro-contracts-service/method extensions
- */
-function processOpenAPIWithExtensions(openapiPath) {
-    const content = fs.readFileSync(openapiPath, 'utf-8');
-    const spec = yaml.parse(content);
-    const stats = {
-        servicesAdded: 0,
-        methodsAdded: 0,
-        services: new Set(),
-    };
-    const httpMethods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
-    if (spec.paths) {
-        for (const [pathKey, pathItem] of Object.entries(spec.paths)) {
-            if (!pathItem || typeof pathItem !== 'object')
-                continue;
-            // Infer service from path: /api/users/{id} → User
-            const service = inferServiceFromPath(pathKey);
-            for (const method of httpMethods) {
-                const operation = pathItem[method];
-                if (!operation || typeof operation !== 'object')
-                    continue;
-                const op = operation;
-                // Add x-micro-contracts-service if not present
-                if (!op['x-micro-contracts-service'] && service) {
-                    op['x-micro-contracts-service'] = service;
-                    stats.servicesAdded++;
-                    stats.services.add(service);
-                }
-                // Add x-micro-contracts-method if not present
-                if (!op['x-micro-contracts-method']) {
-                    // Use operationId if available, otherwise generate
-                    const methodName = op.operationId
-                        ? String(op.operationId)
-                        : inferMethodName(method, pathKey);
-                    op['x-micro-contracts-method'] = methodName;
-                    stats.methodsAdded++;
-                }
-            }
-        }
-    }
-    // Convert back to YAML with proper formatting
-    const output = yaml.stringify(spec, {
-        indent: 2,
-    });
-    return {
-        yaml: output,
-        stats: {
-            servicesAdded: stats.servicesAdded,
-            methodsAdded: stats.methodsAdded,
-            services: Array.from(stats.services),
-        },
-    };
-}
-/**
- * Infer service name from API path
- * /api/users → User
- * /api/users/{id} → User
- * /api/user-profiles → UserProfile
- * /api/v1/accounts → Account
- */
-function inferServiceFromPath(pathKey) {
-    // Remove /api prefix and version prefix
-    const normalized = pathKey
-        .replace(/^\/api\//, '/')
-        .replace(/^\/v\d+\//, '/');
-    // Get first path segment
-    const segments = normalized.split('/').filter(Boolean);
-    if (segments.length === 0)
-        return null;
-    const firstSegment = segments[0];
-    // Skip path parameters
-    if (firstSegment.startsWith('{'))
-        return null;
-    // Convert to PascalCase singular
-    // users → User
-    // user-profiles → UserProfile
-    // accounts → Account
-    const words = firstSegment
-        .replace(/-/g, '_')
-        .split('_');
-    const pascalCase = words
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join('');
-    // Remove trailing 's' for plural (simple heuristic)
-    if (pascalCase.endsWith('s') && !pascalCase.endsWith('ss')) {
-        return pascalCase.slice(0, -1);
-    }
-    return pascalCase;
-}
-/**
- * Infer method name from HTTP method and path
- * GET /users → getUsers
- * GET /users/{id} → getUserById
- * POST /users → createUser
- * PUT /users/{id} → updateUser
- * DELETE /users/{id} → deleteUser
- */
-function inferMethodName(httpMethod, pathKey) {
-    // Get path segments without parameters
-    const segments = pathKey
-        .replace(/^\/api\//, '/')
-        .replace(/^\/v\d+\//, '/')
-        .split('/')
-        .filter(Boolean);
-    const hasIdParam = segments.some(s => s.startsWith('{'));
-    const resourceSegments = segments.filter(s => !s.startsWith('{'));
-    // Build resource name from segments
-    const resourceName = resourceSegments
-        .map((seg, i) => {
-        const words = seg.replace(/-/g, '_').split('_');
-        return words
-            .map((word, j) => {
-            // First word of first segment: lowercase for method prefix
-            if (i === 0 && j === 0) {
-                return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
-            }
-            return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
-        })
-            .join('');
-    })
-        .join('');
-    // Make singular for single-resource operations
-    const singularName = resourceName.endsWith('s') && !resourceName.endsWith('ss')
-        ? resourceName.slice(0, -1)
-        : resourceName;
-    // Map HTTP method to action
-    switch (httpMethod.toLowerCase()) {
-        case 'get':
-            return hasIdParam
-                ? `get${singularName}ById`
-                : `get${resourceName}`;
-        case 'post':
-            return `create${singularName}`;
-        case 'put':
-            return `update${singularName}`;
-        case 'patch':
-            return `patch${singularName}`;
-        case 'delete':
-            return `delete${singularName}`;
-        default:
-            return `${httpMethod.toLowerCase()}${resourceName}`;
-    }
-}
 function generateConfigTemplate(moduleName) {
-    // Note: Using explicit string concatenation to ensure correct YAML indentation
-    const yaml = [
-        '# micro-contracts Configuration',
-        '',
-        '# Common settings (defaults for all modules)',
-        'defaults:',
-        '  contract:',
-        '    output: packages/contract/{module}',
-        '',
-        '  contractPublic:',
-        '    output: packages/contract-published/{module}',
-        '',
-        '  # Template-based outputs',
-        '  outputs:',
-        '    server-routes:',
-        '      output: server/src/{module}/routes.generated.ts',
-        '      template: fastify-routes.hbs',
-        '      config:',
-        '        servicesPath: fastify.services.{module}',
-        '',
-        '    frontend-api:',
-        '      output: frontend/src/{module}/api.generated.ts',
-        '      template: fetch-client.hbs',
-        '',
-        '    shared-client:',
-        '      output: frontend/src/shared/{module}.api.generated.ts',
-        '      template: fetch-client.hbs',
-        '      condition: hasPublicEndpoints',
-        '      config:',
-        '        contractPackage: "@project/contract-published/{module}"',
-        '',
-        '  # Overlay configuration',
-        '  overlays:',
-        '    shared:',
-        '      - spec/_shared/overlays/middleware.overlay.yaml',
-        '    collision: error',
-        '',
-        '  docs:',
-        '    enabled: true',
-        '',
-        '# Module definitions',
-        'modules:',
-        `  ${moduleName}:`,
-        `    openapi: spec/${moduleName}/openapi/${moduleName}.yaml`,
-        '',
+    return [
+        '# micro-contracts Configuration', '',
+        'defaults:', '  contract:', '    output: packages/contract/{module}', '',
+        '  contractPublic:', '    output: packages/contract-published/{module}', '',
+        '  outputs:', '    server-routes:', '      output: server/src/{module}/routes.generated.ts',
+        '      template: fastify-routes.hbs', '      config:',
+        '        servicesPath: fastify.services.{module}', '',
+        '    frontend-api:', '      output: frontend/src/{module}/api.generated.ts',
+        '      template: fetch-client.hbs', '',
+        '    shared-client:', '      output: frontend/src/shared/{module}.api.generated.ts',
+        '      template: fetch-client.hbs', '      condition: hasPublicEndpoints', '      config:',
+        '        contractPackage: "@project/contract-published/{module}"', '',
+        '  overlays:', '    shared:', '      - spec/_shared/overlays/middleware.overlay.yaml',
+        '    collision: error', '', '  docs:', '    enabled: true', '',
+        'modules:', `  ${moduleName}:`, `    openapi: spec/${moduleName}/openapi/${moduleName}.yaml`, '',
+    ].join('\n');
+}
+function generateScreenConfigTemplate(moduleName) {
+    return [
+        '# micro-contracts Configuration (Screen Spec)', '',
+        'defaults:', '  contract:', '    output: packages/contract/{module}', '',
+        '  docs:', '    enabled: false', '',
+        'modules:', `  ${moduleName}:`, `    openapi: spec/${moduleName}/openapi/${moduleName}.yaml`,
+        '    screen: true', '    outputs:', '      screen-navigation:',
+        `        output: frontend/src/screens/navigation.generated.ts`,
+        '        template: screen-navigation.hbs', '      screen-events:',
+        `        output: frontend/src/screens/events.generated.ts`,
+        '        template: screen-events.hbs', '',
     ].join('\n');
-    return yaml;
 }
-/**
- * Generate ProblemDetails schema
- */
 function generateProblemDetailsSchema() {
     return `# RFC 9457 Problem Details
-# https://www.rfc-editor.org/rfc/rfc9457.html
-
 components:
   schemas:
     ProblemDetails:
@@ -1158,29 +919,21 @@ components:
         type:
           type: string
           format: uri
-          description: "Error type URI (e.g., /errors/validation)"
         title:
           type: string
-          description: "Short human-readable summary"
         status:
           type: integer
-          description: "HTTP status code"
         detail:
           type: string
-          description: "Detailed explanation"
         instance:
           type: string
           format: uri
-          description: "URI of the specific occurrence"
         code:
           type: string
-          description: "Machine-readable error code (SCREAMING_SNAKE)"
         traceId:
           type: string
-          description: "Correlation ID for tracing"
         errors:
           type: array
-          description: "Validation errors (field-level)"
           items:
             type: object
             properties:
@@ -1188,54 +941,12 @@ components:
                 type: string
               message:
                 type: string
-
-  responses:
-    BadRequest:
-      description: Bad Request
-      content:
-        application/json:
-          schema:
-            $ref: '#/components/schemas/ProblemDetails'
-    
-    Unauthorized:
-      description: Unauthorized
-      content:
-        application/json:
-          schema:
-            $ref: '#/components/schemas/ProblemDetails'
-    
-    Forbidden:
-      description: Forbidden
-      content:
-        application/json:
-          schema:
-            $ref: '#/components/schemas/ProblemDetails'
-    
-    NotFound:
-      description: Not Found
-      content:
-        application/json:
-          schema:
-            $ref: '#/components/schemas/ProblemDetails'
-    
-    InternalError:
-      description: Internal Server Error
-      content:
-        application/json:
-          schema:
-            $ref: '#/components/schemas/ProblemDetails'
 `;
 }
-/**
- * Generate Spectral lint rules
- */
 function generateSpectralRules() {
-    return `# micro-contracts Spectral Rules
-
-extends: ["spectral:oas"]
+    return `extends: ["spectral:oas"]
 
 rules:
-  # Require x-micro-contracts-service on all operations
   operation-service:
     description: "Operations must have x-micro-contracts-service"
     severity: error
@@ -1244,7 +955,6 @@ rules:
       field: x-micro-contracts-service
       function: truthy
 
-  # Require x-micro-contracts-method on all operations  
   operation-method:
     description: "Operations must have x-micro-contracts-method"
     severity: error
@@ -1253,7 +963,6 @@ rules:
       field: x-micro-contracts-method
       function: truthy
 
-  # Require error responses
   operation-error-responses:
     description: "Operations should have 5XX or default error response"
     severity: warn
@@ -1267,7 +976,6 @@ rules:
             - required: ["5XX"]
             - required: ["default"]
 
-  # Enforce canonical extension names
   canonical-extension-prefix:
     description: "Use canonical x-micro-contracts-* extensions"
     severity: warn
@@ -1275,29 +983,93 @@ rules:
     then:
       - field: x-service
         function: falsy
-        description: "Use x-micro-contracts-service instead of x-service"
       - field: x-method
         function: falsy
-        description: "Use x-micro-contracts-method instead of x-method"
       - field: x-public
         function: falsy
-        description: "Use x-micro-contracts-published instead of x-public"
 `;
 }
-// =============================================================================
-// Dependency Analysis Helpers
-// =============================================================================
+function generateScreenSpecTemplate(moduleName) {
+    const pascalName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
+    return `openapi: '3.1.0'
+info:
+  title: ${pascalName} Screen Specification
+  version: '0.1.0'
+  description: |
+    Screen contract for ${moduleName} domain.
+servers:
+  - url: /
+    description: Screen routes (client-side)
+paths:
+  /home:
+    get:
+      operationId: renderHomePage
+      security: [{session: []}]
+      x-screen-const: HOME
+      x-screen-id: SCR-001
+      x-screen-name: HomePage
+      x-back-navigation: false
+      summary: Render home page
+      responses:
+        '200':
+          description: Home page ViewModel
+          content:
+            application/json:
+              schema:
+                \$ref: '#/components/schemas/HomePageViewModel'
+          links:
+            goToSettings:
+              operationId: renderSettingsPage
+  /settings:
+    get:
+      operationId: renderSettingsPage
+      security: [{session: []}]
+      x-screen-const: SETTINGS
+      x-screen-id: SCR-002
+      x-screen-name: SettingsPage
+      x-back-navigation: true
+      summary: Render settings page
+      responses:
+        '200':
+          description: Settings page ViewModel
+          content:
+            application/json:
+              schema:
+                \$ref: '#/components/schemas/SettingsPageViewModel'
+          links:
+            goToHome:
+              operationId: renderHomePage
+components:
+  securitySchemes:
+    session:
+      type: apiKey
+      in: cookie
+      name: session
+  schemas:
+    HomePageViewModel:
+      type: object
+      required: [greeting]
+      properties:
+        greeting:
+          type: string
+    SettingsPageViewModel:
+      type: object
+      required: [theme]
+      properties:
+        theme:
+          type: string
+          enum: [light, dark]
+`;
+}
 function outputDependencyGraph(moduleDeps) {
     console.log('```mermaid');
     console.log('graph LR');
     for (const [moduleName, { deps }] of moduleDeps) {
-        // Group deps by target module
         const moduleTargets = new Set();
         for (const dep of deps) {
             const parts = dep.split('.');
-            if (parts.length >= 1) {
+            if (parts.length >= 1)
                 moduleTargets.add(parts[0]);
-            }
         }
         for (const target of moduleTargets) {
             console.log(`  ${moduleName} --> ${target}`);
@@ -1309,40 +1081,35 @@ function outputImpactAnalysis(moduleDeps, ref) {
     console.log(`Impacted by changes to ${ref}:\n`);
     const impacted = [];
     for (const [moduleName, { deps }] of moduleDeps) {
-        if (deps.includes(ref)) {
+        if (deps.includes(ref))
             impacted.push(moduleName);
-        }
     }
     if (impacted.length === 0) {
         console.log('  No modules depend on this API.');
     }
     else {
-        for (const m of impacted) {
+        for (const m of impacted)
             console.log(`  - ${m}`);
-        }
     }
 }
 function outputWhoDependsOn(moduleDeps, ref) {
     console.log(`Modules that depend on ${ref}:\n`);
     const dependent = [];
     for (const [moduleName, { deps }] of moduleDeps) {
-        if (deps.some(d => d.startsWith(ref))) {
+        if (deps.some(d => d.startsWith(ref)))
             dependent.push(moduleName);
-        }
     }
     if (dependent.length === 0) {
         console.log('  None found.');
     }
     else {
-        for (const m of dependent) {
+        for (const m of dependent)
             console.log(`  - ${m}`);
-        }
     }
 }
 function validateDependencies(moduleDeps) {
     let hasErrors = false;
     for (const [moduleName, { openApiDeps, configDeps }] of moduleDeps) {
-        // Check that configDeps is subset of openApiDeps
         for (const dep of configDeps) {
             if (!openApiDeps.includes(dep)) {
                 console.error(`ERROR: ${moduleName}.dependsOn includes '${dep}'`);
@@ -1366,124 +1133,10 @@ function outputAllDependencies(moduleDeps) {
             console.log('  (no dependencies)');
         }
         else {
-            for (const dep of deps) {
+            for (const dep of deps)
                 console.log(`  - ${dep}`);
-            }
         }
         console.log();
     }
 }
-/**
- * Generate starter screen spec YAML
- */
-function generateScreenSpecTemplate(moduleName) {
-    const pascalName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
-    return `openapi: '3.1.0'
-info:
-  title: ${pascalName} Screen Specification
-  version: '0.1.0'
-  description: |
-    Screen contract for ${moduleName} domain. This is a screen specification, not a server API.
-    Defines ViewModels, navigation links, and analytics events per screen.
-servers:
-  - url: /
-    description: Screen routes (client-side)
-paths:
-  /home:
-    get:
-      operationId: renderHomePage
-      security: [{session: []}]
-      x-screen-const: HOME
-      x-screen-id: SCR-001
-      x-screen-name: HomePage
-      x-back-navigation: false
-      x-events:
-        - name: home_view
-          type: screen_view
-          method: trackView
-      summary: Render home page
-      responses:
-        '200':
-          description: Home page ViewModel
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/HomePageViewModel'
-          links:
-            goToSettings:
-              operationId: renderSettingsPage
-  /settings:
-    get:
-      operationId: renderSettingsPage
-      security: [{session: []}]
-      x-screen-const: SETTINGS
-      x-screen-id: SCR-002
-      x-screen-name: SettingsPage
-      x-back-navigation: true
-      x-events:
-        - name: settings_view
-          type: screen_view
-          method: trackView
-      summary: Render settings page
-      responses:
-        '200':
-          description: Settings page ViewModel
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SettingsPageViewModel'
-          links:
-            goToHome:
-              operationId: renderHomePage
-components:
-  securitySchemes:
-    session:
-      type: apiKey
-      in: cookie
-      name: session
-  schemas:
-    HomePageViewModel:
-      type: object
-      required: [greeting]
-      properties:
-        greeting:
-          type: string
-    SettingsPageViewModel:
-      type: object
-      required: [theme]
-      properties:
-        theme:
-          type: string
-          enum: [light, dark]
-`;
-}
-/**
- * Generate config template for screen module
- */
-function generateScreenConfigTemplate(moduleName) {
-    return [
-        '# micro-contracts Configuration (Screen Spec)',
-        '',
-        'defaults:',
-        '  contract:',
-        '    output: packages/contract/{module}',
-        '',
-        '  docs:',
-        '    enabled: false',
-        '',
-        'modules:',
-        `  ${moduleName}:`,
-        `    openapi: spec/${moduleName}/openapi/${moduleName}.yaml`,
-        '    screen: true',
-        '    outputs:',
-        '      screen-navigation:',
-        `        output: frontend/src/screens/navigation.generated.ts`,
-        '        template: screen-navigation.hbs',
-        '      screen-events:',
-        `        output: frontend/src/screens/events.generated.ts`,
-        '        template: screen-events.hbs',
-        '',
-    ].join('\n');
-}
-// Starter templates are imported from ./cli/templates.js
 //# sourceMappingURL=cli.js.map