delimit-cli 4.1.4 → 4.1.5

package/bin/delimit-cli.js

@@ -1312,7 +1312,7 @@ program
 
         if (fs.existsSync(policyFile)) {
             console.log(chalk.yellow('  Already initialized — .delimit/policies.yml exists'));
-            console.log(`  Run ${chalk.bold('delimit lint')} to check your API.\n`);
+            console.log(`  Run ${chalk.bold('npx delimit-cli lint')} to check your API.\n`);
             return;
         }
 
@@ -1723,7 +1723,7 @@ jobs:
               owner: context.repo.owner,
               repo: context.repo.repo,
               title: 'API Drift Detected — Governance Review Needed',
-              body: 'The weekly drift monitor detected changes to the API spec that have not been reviewed through governance. Run delimit lint to review.',
+              body: 'The weekly drift monitor detected changes to the API spec that have not been reviewed through governance. Run npx delimit-cli lint to review.',
               labels: ['api-governance', 'drift'],
             });
 `;
@@ -1781,10 +1781,10 @@ jobs:
                         console.log(chalk.green('  Saved baseline to .delimit/baseline.yaml'));
                     }
                 } else {
-                    console.log(chalk.gray('  Zero-Spec extraction skipped — run `delimit lint` manually'));
+                    console.log(chalk.gray('  Zero-Spec extraction skipped — run `npx delimit-cli lint` manually'));
                 }
             } catch {
-                console.log(chalk.gray('  Zero-Spec extraction skipped — run `delimit lint` manually'));
+                console.log(chalk.gray('  Zero-Spec extraction skipped — run `npx delimit-cli lint` manually'));
             }
         }
 
@@ -1878,11 +1878,11 @@ jobs:
         console.log(chalk.gray(`  Evidence saved to .delimit/evidence/\n`));
         console.log('  Next steps:');
         if (specPath) {
-            console.log(`    ${chalk.bold('delimit lint')} ${specPath} ${specPath}  — lint on every PR`);
+            console.log(`    ${chalk.bold('npx delimit-cli lint')} ${specPath} ${specPath}  — lint on every PR`);
         } else if (['fastapi', 'nestjs', 'express'].includes(framework)) {
-            console.log(`    ${chalk.bold('delimit lint')}                           — zero-spec mode (${frameworkLabel})`);
+            console.log(`    ${chalk.bold('npx delimit-cli lint')}                           — zero-spec mode (${frameworkLabel})`);
         } else {
-            console.log(`    ${chalk.bold('delimit lint')}                           — add an OpenAPI spec first`);
+            console.log(`    ${chalk.bold('npx delimit-cli lint')}                           — add an OpenAPI spec first`);
         }
         console.log(`    ${chalk.bold('delimit doctor')}                         — verify setup`);
         console.log(`    ${chalk.bold('delimit explain')}                        — human-readable report`);
@@ -2175,7 +2175,7 @@ program
                 console.log(chalk.green('  Spec validated — no breaking changes'));
             }
         } else {
-            console.log(chalk.yellow('  No spec files found. Run delimit lint manually.'));
+            console.log(chalk.yellow('  No spec files found. Run npx delimit-cli lint manually.'));
         }
 
         // Step 4: Show what to do next
@@ -2467,8 +2467,31 @@ program
                         }
                     } 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.yellow('\u2014')} No OpenAPI specs found in this directory\n`);
+                    // Run demo on bundled example spec so users always see value
+                    const demoSpec = path.join(__dirname, '..', 'examples', 'petstore-v1.yaml');
+                    if (fs.existsSync(demoSpec)) {
+                        console.log(chalk.gray('  Running demo on a sample Pet Store API...\n'));
+                        try {
+                            const demoResult = 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('${demoSpec}')); r=score_spec(spec); print(json.dumps(r))"`,
+                                { encoding: 'utf-8', timeout: 15000, cwd: serverDir }
+                            );
+                            const health = JSON.parse(demoResult);
+                            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('Sample: Pet Store API')}\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}`);
+                            }
+                            console.log(chalk.gray('\n  This is a demo. Point at your spec: npx delimit-cli scan openapi.yaml'));
+                        } catch {}
+                    } else {
+                        console.log(chalk.gray('  Tip: point at a spec file: npx delimit-cli scan openapi.yaml'));
+                    }
                 }
                 // Interactive next step picker
                 try {
@@ -2816,7 +2839,7 @@ program
                 if (!zeroResult.success) {
                     console.error(chalk.red(`\n  ${zeroResult.error}\n`));
                     if (zeroResult.error_type === 'no_framework') {
-                        console.log('  Usage: delimit lint <old_spec> <new_spec>');
+                        console.log('  Usage: npx delimit-cli lint <old_spec> <new_spec>');
                         console.log('  Or run from a FastAPI project directory.\n');
                     }
                     process.exit(1);

package/package.json

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