delimit-cli 4.1.1 → 4.1.3

package/bin/delimit-cli.js

@@ -2328,6 +2328,139 @@ program
         console.log('');
     });
 
+// Scan command — instant governance analysis of any project or spec
+program
+    .command('scan [path]')
+    .description('Scan a project or OpenAPI spec for governance insights')
+    .action(async (specPath) => {
+        const target = specPath ? path.resolve(specPath) : process.cwd();
+        console.log(chalk.bold('\n  Delimit Scan\n'));
+
+        // Resolve gateway dir: installed server > bundled in npm package
+        const bundledGateway = path.join(__dirname, '..', 'gateway');
+        const serverDir = (continuityContext.serverDir && continuityContext.serverDir !== 'undefined' && fs.existsSync(continuityContext.serverDir))
+            ? continuityContext.serverDir
+            : fs.existsSync(bundledGateway) ? bundledGateway : null;
+
+        if (!serverDir) {
+            console.log(chalk.yellow('  Gateway not found. Installing...\n'));
+            try {
+                execSync('npx delimit-cli setup --yes', { stdio: 'inherit', timeout: 60000 });
+                // Retry after setup
+                console.log(chalk.green('\n  Setup complete. Re-running scan...\n'));
+                execSync(`npx delimit-cli scan ${specPath || ''}`, { stdio: 'inherit', timeout: 30000 });
+            } catch {
+                console.log(chalk.red('\n  Auto-setup failed. Run manually: npx delimit-cli setup'));
+            }
+            return;
+        }
+
+        // Check Python + yaml dependency
+        try {
+            execSync('python3 -c "import yaml"', { stdio: 'ignore', timeout: 5000 });
+        } catch {
+            console.log(chalk.yellow('  Installing Python dependency (pyyaml)...\n'));
+            try { execSync('pip3 install pyyaml -q', { stdio: 'ignore', timeout: 30000 }); } catch {}
+        }
+
+        // Detect if target is a spec file or a project directory
+        const isFile = fs.existsSync(target) && fs.statSync(target).isFile();
+
+        if (isFile) {
+            // Spec file — run spec health + show results
+            console.log(chalk.gray(`  Analyzing ${target}...\n`));
+            try {
+                const result = execSync(
+                    `python3 -c "import sys,json; sys.path.insert(0,'${serverDir}'); from core.spec_health import score_spec; import yaml; spec=yaml.safe_load(open('${target}')); r=score_spec(spec); print(json.dumps(r))"`,
+                    { encoding: 'utf-8', timeout: 15000, cwd: serverDir }
+                );
+                const health = JSON.parse(result);
+                const gradeColors = { A: 'green', B: 'blue', C: 'yellow', D: 'red', F: 'red' };
+                const gradeColor = gradeColors[health.grade] || 'white';
+                console.log(`  ${chalk[gradeColor].bold(health.grade)} ${chalk.white.bold(health.overall_score + '/100')}  ${chalk.gray('Spec Health Score')}\n`);
+                for (const [dim, data] of Object.entries(health.dimensions || {})) {
+                    const score = data.score || 0;
+                    const bar = '█'.repeat(Math.round(score / 5)) + '░'.repeat(20 - Math.round(score / 5));
+                    const color = score >= 70 ? 'green' : score >= 40 ? 'yellow' : 'red';
+                    console.log(`  ${chalk.gray(dim.padEnd(16))} ${chalk[color](bar)} ${score}`);
+                }
+                if (health.recommendations && health.recommendations.length > 0) {
+                    console.log(chalk.bold('\n  Recommendations:\n'));
+                    health.recommendations.slice(0, 5).forEach(r => {
+                        const text = typeof r === 'object' ? (r.recommendation || r.text || JSON.stringify(r)) : r;
+                        console.log(`  ${chalk.yellow('→')} ${text}`);
+                    });
+                }
+                console.log(chalk.bold('\n  Next steps:\n'));
+                console.log(`  ${chalk.green('npx delimit-cli lint')} ${target} ${chalk.gray('— check for breaking changes')}`);
+                console.log(`  ${chalk.green('npx delimit-cli init')}       ${chalk.gray('— set up governance for this project')}\n`);
+            } catch (e) {
+                console.log(chalk.red(`  Error: ${e.message}`));
+            }
+        } else {
+            // Project directory — find specs using simple glob, no server.py needed
+            console.log(chalk.gray(`  Scanning ${target}...\n`));
+            try {
+                // Find OpenAPI/Swagger specs
+                const specPatterns = ['openapi.yaml', 'openapi.yml', 'openapi.json', 'swagger.yaml', 'swagger.yml', 'swagger.json'];
+                const found = [];
+                const _findSpecs = (dir, depth) => {
+                    if (depth > 4) return;
+                    try {
+                        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                            if (entry.name === 'node_modules' || entry.name === '.next' || entry.name === 'venv' || entry.name === '.git') continue;
+                            const full = path.join(dir, entry.name);
+                            if (entry.isFile() && specPatterns.includes(entry.name.toLowerCase())) {
+                                found.push(path.relative(target, full));
+                            } else if (entry.isDirectory()) {
+                                _findSpecs(full, depth + 1);
+                            }
+                        }
+                    } catch {}
+                };
+                _findSpecs(target, 0);
+
+                if (found.length > 0) {
+                    console.log(`  ${chalk.green('✓')} Found ${found.length} OpenAPI spec(s): ${found.slice(0, 3).join(', ')}`);
+                    // Run health on the first spec
+                    const specFile = path.join(target, found[0]);
+                    console.log(chalk.gray(`\n  Scoring ${found[0]}...\n`));
+                    try {
+                        const healthResult = execSync(
+                            `python3 -c "import sys,json; sys.path.insert(0,'${serverDir}'); from core.spec_health import score_spec; import yaml; spec=yaml.safe_load(open('${specFile}')); r=score_spec(spec); print(json.dumps(r))"`,
+                            { encoding: 'utf-8', timeout: 15000, cwd: serverDir }
+                        );
+                        const health = JSON.parse(healthResult);
+                        const gradeColors = { A: 'green', B: 'blue', C: 'yellow', D: 'red', F: 'red' };
+                        const gradeColor = gradeColors[health.grade] || 'white';
+                        console.log(`  ${chalk[gradeColor].bold(health.grade)} ${chalk.white.bold(health.overall_score + '/100')}  ${chalk.gray('Spec Health Score')}\n`);
+                        for (const [dim, data] of Object.entries(health.dimensions || {})) {
+                            const score = data.score || 0;
+                            const bar = '\u2588'.repeat(Math.round(score / 5)) + '\u2591'.repeat(20 - Math.round(score / 5));
+                            const color = score >= 70 ? 'green' : score >= 40 ? 'yellow' : 'red';
+                            console.log(`  ${chalk.gray(dim.padEnd(16))} ${chalk[color](bar)} ${score}`);
+                        }
+                        if (health.recommendations && health.recommendations.length > 0) {
+                            console.log(chalk.bold('\n  Recommendations:\n'));
+                            health.recommendations.slice(0, 5).forEach(r => {
+                                const text = typeof r === 'object' ? (r.recommendation || r.text || JSON.stringify(r)) : r;
+                                console.log(`  ${chalk.yellow('\u2192')} ${text}`);
+                            });
+                        }
+                    } catch {}
+                } else {
+                    console.log(`  ${chalk.yellow('\u2014')} No OpenAPI specs found in this directory`);
+                    console.log(chalk.gray('  Tip: point at a spec file directly: npx delimit-cli scan openapi.yaml'));
+                }
+                console.log(chalk.bold('\n  Next:\n'));
+                console.log(`  ${chalk.green('npx delimit-cli init')}     ${chalk.gray('\u2014 set up governance')}`);
+                console.log(`  ${chalk.green('npx delimit-cli setup')}    ${chalk.gray('\u2014 configure AI assistants')}\n`);
+            } catch (e) {
+                console.log(chalk.red(`  Error: ${e.message}`));
+            }
+        }
+    });
+
 // Try command — zero-risk demo with Markdown report artifact (LED-264)
 program
     .command('try')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [