delimit-cli 4.1.32 → 4.1.34

package/README.md

@@ -31,6 +31,7 @@ Works across any configuration — from a single model on a budget to an enterpr
 
 ```bash
 npx delimit-cli scan              # Instant health grade for your API spec
+npx delimit-cli try owner/repo    # Try governance on any GitHub repo
 npx delimit-cli pr owner/repo#123 # Review any GitHub PR for breaking changes
 npx delimit-cli setup && source ~/.bashrc  # Configure AI assistants + activate
 ```

package/bin/delimit-cli.js

@@ -2540,8 +2540,44 @@ program
                         console.log(chalk.gray('  Tip: point at a spec file: npx delimit-cli scan openapi.yaml'));
                     }
                 }
+                // Governance readiness checklist
+                const hasPolicy = fs.existsSync(path.join(target, '.delimit', 'policies.yml'));
+                const hasWorkflow = fs.existsSync(path.join(target, '.github', 'workflows', 'api-governance.yml'));
+                const hasGitHooks = fs.existsSync(path.join(target, '.git', 'hooks', 'pre-commit')) &&
+                    (() => { try { return fs.readFileSync(path.join(target, '.git', 'hooks', 'pre-commit'), 'utf-8').includes('delimit'); } catch { return false; } })();
+                const hasMcp = fs.existsSync(path.join(os.homedir(), '.mcp.json')) &&
+                    (() => { try { return fs.readFileSync(path.join(os.homedir(), '.mcp.json'), 'utf-8').includes('delimit'); } catch { return false; } })();
+                const hasSpecs = found.length > 0;
+
+                const checks = [
+                    { name: 'API spec', done: hasSpecs, fix: 'Add an openapi.yaml to your project' },
+                    { name: 'Policy', done: hasPolicy, fix: 'npx delimit-cli init' },
+                    { name: 'CI gate', done: hasWorkflow, fix: 'npx delimit-cli ci' },
+                    { name: 'Git hooks', done: hasGitHooks, fix: 'npx delimit-cli hooks install' },
+                    { name: 'MCP tools', done: hasMcp, fix: 'npx delimit-cli setup' },
+                ];
+                const score = checks.filter(c => c.done).length;
+
+                console.log(chalk.bold(`\n  Governance Readiness: ${score}/${checks.length}\n`));
+                for (const c of checks) {
+                    if (c.done) {
+                        console.log(`  ${chalk.green('●')} ${c.name}`);
+                    } else {
+                        console.log(`  ${chalk.gray('○')} ${c.name} ${chalk.gray('—')} ${chalk.yellow(c.fix)}`);
+                    }
+                }
+                console.log('');
+
                 // Interactive next step picker
                 try {
+                    // Pre-select the first missing item
+                    const firstMissing = checks.find(c => !c.done);
+                    const defaultChoice = firstMissing ?
+                        (firstMissing.name === 'Policy' ? 'init' :
+                         firstMissing.name === 'CI gate' ? 'ci' :
+                         firstMissing.name === 'Git hooks' ? 'hooks' :
+                         firstMissing.name === 'MCP tools' ? 'setup' : 'init') : 'exit';
+
                     const { next } = await inquirer.prompt([{
                         type: 'list',
                         name: 'next',
@@ -2549,15 +2585,19 @@ program
                         choices: [
                             { name: 'Set up governance for this project', value: 'init' },
                             { name: 'Add CI gate (GitHub Action)', value: 'ci' },
+                            { name: 'Install git hooks', value: 'hooks' },
                             { name: 'Configure AI assistants (Claude, Codex, Gemini)', value: 'setup' },
                             { name: 'Run a breaking change demo', value: 'try' },
                             { name: 'Exit', value: 'exit' },
                         ],
+                        default: defaultChoice,
                     }]);
                     if (next === 'init') {
                         execSync('npx delimit-cli init', { stdio: 'inherit' });
                     } else if (next === 'ci') {
                         execSync('npx delimit-cli ci', { stdio: 'inherit' });
+                    } else if (next === 'hooks') {
+                        execSync('npx delimit-cli hooks install', { stdio: 'inherit' });
                     } else if (next === 'setup') {
                         execSync('npx delimit-cli setup', { stdio: 'inherit' });
                     } else if (next === 'try') {
@@ -2747,15 +2787,52 @@ print(json.dumps({'changes':[{'type':c.type.value if hasattr(c.type,'value') els
         }
     });
 
-// Try command — zero-risk demo with Markdown report artifact (LED-264)
+// Try command — zero-risk demo with Markdown report artifact (LED-264 + LED-424)
 program
-    .command('try')
-    .description('Run a zero-risk governance demo and save a Markdown report')
-    .action(async () => {
+    .command('try [repo]')
+    .description('Run governance on your project, a GitHub repo, or a built-in demo')
+    .action(async (repo) => {
         const tmpDir = path.join(os.tmpdir(), `delimit-try-${Date.now()}`);
         fs.mkdirSync(tmpDir, { recursive: true });
 
         console.log(chalk.bold('\n  Delimit — Try It\n'));
+
+        // Mode 1: Clone a GitHub repo and scan it
+        if (repo && (repo.includes('/') || repo.startsWith('http'))) {
+            const repoUrl = repo.startsWith('http') ? repo : `https://github.com/${repo}`;
+            console.log(chalk.gray(`  Cloning ${repoUrl}...\n`));
+            try {
+                execSync(`git clone --depth 1 ${repoUrl} ${tmpDir}/repo 2>&1`, { timeout: 30000 });
+                console.log(chalk.green('  Cloned. Scanning for OpenAPI specs...\n'));
+                execSync(`node "${path.join(__dirname, 'delimit-cli.js')}" scan ${tmpDir}/repo`, { stdio: 'inherit', timeout: 30000 });
+                // Show governance readiness for their repo
+                console.log(chalk.bold('\n  Want to add governance to this repo?\n'));
+                console.log(`    ${chalk.green('1.')} Fork it and run ${chalk.bold('npx delimit-cli init')}`);
+                console.log(`    ${chalk.green('2.')} Add CI: ${chalk.bold('npx delimit-cli ci')}`);
+                console.log(`    ${chalk.green('3.')} Open a PR — Delimit comments with breaking changes automatically\n`);
+                try { fs.rmSync(tmpDir, { recursive: true }); } catch {}
+                return;
+            } catch (err) {
+                console.log(chalk.red(`  Could not clone: ${err.message}\n`));
+                console.log(chalk.gray('  Falling back to built-in demo...\n'));
+            }
+        }
+
+        // Mode 2: Use current directory if it has specs
+        if (!repo) {
+            const cwd = process.cwd();
+            const localSpecs = ['openapi.yaml', 'openapi.yml', 'openapi.json', 'swagger.yaml', 'swagger.json',
+                'api/openapi.yaml', 'api/openapi.yml', 'api/openapi.json', 'spec/api.json', 'docs/openapi.yaml'];
+            const foundLocal = localSpecs.find(s => fs.existsSync(path.join(cwd, s)));
+            if (foundLocal) {
+                console.log(chalk.green(`  Found ${foundLocal} in current directory. Running governance scan...\n`));
+                execSync(`node "${path.join(__dirname, 'delimit-cli.js')}" scan ${path.join(cwd, foundLocal)}`, { stdio: 'inherit', timeout: 30000 });
+                try { fs.rmSync(tmpDir, { recursive: true }); } catch {}
+                return;
+            }
+        }
+
+        // Mode 3: Built-in demo (original behavior)
         console.log(chalk.gray('  Safe mode: runs in a temp directory, nothing touches your project.\n'));
 
         // Create sample specs (same as demo)

package/package.json

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