delimit-cli 4.1.1 → 4.1.2

package/bin/delimit-cli.js

@@ -2328,6 +2328,97 @@ 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 || '.';
+        console.log(chalk.bold('\n  Delimit Scan\n'));
+
+        // 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,'${continuityContext.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: continuityContext.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 and scan
+            console.log(chalk.gray(`  Scanning ${path.resolve(target)}...\n`));
+            try {
+                const result = execSync(
+                    `python3 -c "import sys,json; sys.path.insert(0,'${continuityContext.serverDir}'); from ai.server import delimit_scan; r=delimit_scan.fn('${target}') if hasattr(delimit_scan,'fn') else delimit_scan('${target}'); print(json.dumps(r))"`,
+                    { encoding: 'utf-8', timeout: 30000, cwd: continuityContext.serverDir }
+                );
+                const scan = JSON.parse(result);
+                const findings = scan.findings || [];
+                const specs = findings.find(f => f.type === 'openapi_specs');
+                if (specs) {
+                    console.log(`  ${chalk.green('✓')} Found ${specs.count} OpenAPI spec(s): ${specs.files.slice(0, 3).join(', ')}`);
+                } else {
+                    console.log(`  ${chalk.yellow('—')} No OpenAPI specs found`);
+                }
+                const frameworks = findings.filter(f => f.type === 'framework');
+                frameworks.forEach(f => console.log(`  ${chalk.green('✓')} Framework: ${f.name}`));
+                const suggestions = scan.suggestions || [];
+                if (suggestions.length > 0) {
+                    console.log(chalk.bold('\n  Suggestions:\n'));
+                    suggestions.slice(0, 3).forEach(s => {
+                        console.log(`  ${chalk.blue('→')} ${s.detail}`);
+                    });
+                }
+                // If spec found, run health on it
+                if (specs && specs.files.length > 0) {
+                    const specFile = path.join(target, specs.files[0]);
+                    console.log(chalk.gray(`\n  Running spec health on ${specs.files[0]}...`));
+                    try {
+                        const healthResult = execSync(
+                            `python3 -c "import sys,json; sys.path.insert(0,'${continuityContext.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: continuityContext.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(`\n  ${chalk[gradeColor].bold(health.grade)} ${chalk.white.bold(health.overall_score + '/100')}  ${chalk.gray('Spec Health Score')}`);
+                    } catch {}
+                }
+                console.log(chalk.bold('\n  Next:\n'));
+                console.log(`  ${chalk.green('npx delimit-cli init')}     ${chalk.gray('— set up governance')}`);
+                console.log(`  ${chalk.green('npx delimit-cli setup')}    ${chalk.gray('— 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.2",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [