delimit-cli 3.14.2 → 3.14.4

package/README.md

@@ -1,9 +1,9 @@
 # `</>` Delimit
 
-Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.
+API governance that enforces itself. One workspace for Claude Code, Codex, Cursor, and Gemini CLI.
 
 [![npm](https://img.shields.io/npm/v/delimit-cli)](https://www.npmjs.com/package/delimit-cli)
-[![GitHub Action](https://img.shields.io/badge/GitHub%20Action-v1.6.0-blue)](https://github.com/marketplace/actions/delimit-api-governance)
+[![GitHub Action](https://img.shields.io/badge/GitHub%20Action-v1.8.0-blue)](https://github.com/marketplace/actions/delimit-api-governance)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Glama](https://glama.ai/mcp/servers/delimit-ai/delimit-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/delimit-ai/delimit-mcp-server)
 [![API Governance](https://delimit-ai.github.io/badge/pass.svg)](https://github.com/marketplace/actions/delimit-api-governance)
@@ -12,13 +12,59 @@ Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, govern
   <img src="docs/demo.gif" alt="Delimit detecting breaking API changes" width="700">
 </p>
 
-Persistent ledger, API governance, security orchestration, and multi-model deliberation — all shared across Claude Code, Codex, Cursor, and Gemini CLI.
+---
+
+## Try it in 2 minutes
+
+```bash
+npx delimit-cli demo     # See governance in action — no setup needed
+npx delimit-cli init     # Set up governance for your project
+npx delimit-cli setup    # Configure your AI assistants
+```
+
+No API keys. No account. No config files.
+
+### Pick your first win
+
+**Protect my API** — catch breaking changes before merge:
+```bash
+npx delimit-cli try
+# Creates a sample API, introduces breaking changes, shows what gets blocked.
+# Saves a governance report to delimit-report.md
+```
+
+**Watch for drift** — detect spec changes without review:
+```bash
+npx delimit-cli init        # Sets up governance + drift baseline
+# Weekly drift checks run automatically via GitHub Action
+```
+
+**Run PR copilot** — governance gates on every pull request:
+```yaml
+# .github/workflows/api-governance.yml
+- uses: delimit-ai/delimit-action@v1
+  with:
+    spec: api/openapi.yaml
+# Posts gate status, violations, and remediation in PR comments
+```
+
+---
+
+## What's New in v3.14
+
+- **Evidence timeline + gate status dashboard** -- see every governance decision and when it happened
+- **Multi-agent orchestration** -- track which AI assistant works on what, across models
+- **Continuous drift monitoring** -- detect spec drift between deployments automatically
+- **PR governance copilot** -- gate status posted directly in PR comments
+- **Compliance templates** -- SOC2, PCI-DSS, and HIPAA presets out of the box
+- **Beta capture in CLI** -- opt into early features from the command line
+- **112+ MCP tools** -- governance, context, shipping, observability, and orchestration
 
 ---
 
 ## GitHub Action
 
-Zero-config — auto-detects your OpenAPI spec:
+Zero-config -- auto-detects your OpenAPI spec:
 
 ```yaml
 - uses: delimit-ai/delimit-action@v1
@@ -44,14 +90,9 @@ jobs:
           spec: api/openapi.yaml
 ```
 
-That's it. Delimit auto-fetches the base branch spec, diffs it, and posts a PR comment with:
-
-- Breaking changes with severity badges
-- Semver classification (major/minor/patch)
-- Step-by-step migration guide
-- Policy violations
+That's it. Delimit auto-fetches the base branch spec, diffs it, and posts a PR comment with breaking changes, semver classification, migration guides, and governance gate results.
 
-[View on GitHub Marketplace →](https://github.com/marketplace/actions/delimit-api-governance) · [See a live demo (23 breaking changes) →](https://github.com/delimit-ai/delimit-action-demo/pull/2)
+[View on GitHub Marketplace](https://github.com/marketplace/actions/delimit-api-governance) | [See a live demo (23 breaking changes)](https://github.com/delimit-ai/delimit-action-demo/pull/2)
 
 ### Example PR comment
 
@@ -60,34 +101,35 @@ That's it. Delimit auto-fetches the base branch spec, diffs it, and posts a PR c
 > | Change | Path | Severity |
 > |--------|------|----------|
 > | endpoint_removed | `DELETE /pets/{petId}` | error |
-> | type_changed | `/pets:GET:200[].id` (string → integer) | warning |
+> | type_changed | `/pets:GET:200[].id` (string -> integer) | warning |
 > | enum_value_removed | `/pets:GET:200[].status` | warning |
 >
-> **Semver**: MAJOR (1.0.0 → 2.0.0)
+> **Semver**: MAJOR (1.0.0 -> 2.0.0)
 >
 > **Migration Guide**: 3 steps to update your integration
+>
+> ### Governance Gates
+> | Gate | Status | Chain |
+> |------|--------|-------|
+> | API Lint | Pass/Fail | lint -> semver -> gov_evaluate |
+> | Policy Compliance | Pass/Fail | policy -> evidence_collect |
+> | Security Audit | Pass | security_audit -> evidence_collect |
+> | Deploy Readiness | Ready/Blocked | deploy_plan -> security_audit |
 
 ---
 
-## CLI + MCP Toolkit
-
-Governance tools for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI):
-
-```bash
-npx delimit-cli setup
-```
-
-No API keys. No account. Installs in 10 seconds.
-
-### CLI commands (all free)
+## CLI commands
 
 ```bash
+npx delimit-cli try                              # Zero-risk demo — saves governance report
+npx delimit-cli demo                             # Self-contained governance demo
+npx delimit-cli init                             # Guided wizard with compliance templates
+npx delimit-cli init --preset strict             # Initialize with strict policy
 npx delimit-cli setup                            # Install into all AI assistants
 npx delimit-cli setup --dry-run                  # Preview changes first
 npx delimit-cli lint api/openapi.yaml            # Check for breaking changes
 npx delimit-cli diff old.yaml new.yaml           # Compare two specs
 npx delimit-cli explain old.yaml new.yaml        # Generate migration guide
-npx delimit-cli init --preset strict             # Initialize policies
 npx delimit-cli doctor                           # Check setup health
 npx delimit-cli uninstall --dry-run              # Preview removal
 ```
@@ -194,6 +236,7 @@ rules:
 ## Links
 
 - [delimit.ai](https://delimit.ai) -- homepage
+- [Dashboard](https://app.delimit.ai) -- governance console
 - [Docs](https://delimit.ai/docs) -- full documentation
 - [GitHub Action](https://github.com/marketplace/actions/delimit-api-governance) -- Marketplace listing
 - [Quickstart](https://github.com/delimit-ai/delimit-mcp-server) -- try it in 2 minutes

package/bin/delimit-cli.js

@@ -1148,7 +1148,7 @@ jobs:
         with:
           ref: \${{ github.event.pull_request.base.sha }}
           path: _base
-      - uses: delimit-ai/delimit@v1
+      - uses: delimit-ai/delimit-action@v1
         with:
           old_spec: _base/${specPath}
           new_spec: ${specPath}
@@ -1538,6 +1538,163 @@ program
         try { fs.rmSync(tmpDir, { recursive: true }); } catch {}
     });
 
+// Try command — zero-risk demo with Markdown report artifact (LED-264)
+program
+    .command('try')
+    .description('Run a zero-risk governance demo and save a Markdown report')
+    .action(async () => {
+        const tmpDir = path.join(os.tmpdir(), `delimit-try-${Date.now()}`);
+        fs.mkdirSync(tmpDir, { recursive: true });
+
+        console.log(chalk.bold('\n  Delimit — Try It\n'));
+        console.log(chalk.gray('  Safe mode: runs in a temp directory, nothing touches your project.\n'));
+
+        // Create sample specs (same as demo)
+        const baseSpec = {
+            openapi: '3.0.3',
+            info: { title: 'Pet Store API', version: '1.0.0' },
+            paths: {
+                '/pets': {
+                    get: { summary: 'List all pets', parameters: [{ name: 'limit', in: 'query', required: false, schema: { type: 'integer' } }], responses: { '200': { description: 'A list of pets' } } },
+                    post: { summary: 'Create a pet', responses: { '201': { description: 'Pet created' } } },
+                },
+                '/pets/{petId}': {
+                    get: { summary: 'Get a pet by ID', parameters: [{ name: 'petId', in: 'path', required: true, schema: { type: 'string' } }], responses: { '200': { description: 'A pet' } } },
+                },
+            },
+            components: { schemas: { Pet: { type: 'object', required: ['id', 'name'], properties: { id: { type: 'integer' }, name: { type: 'string' }, tag: { type: 'string' } } } } },
+        };
+
+        const changedSpec = JSON.parse(JSON.stringify(baseSpec));
+        changedSpec.info.version = '2.0.0';
+        delete changedSpec.paths['/pets/{petId}'];
+        changedSpec.paths['/pets'].get.parameters.push({ name: 'owner_id', in: 'query', required: true, schema: { type: 'string' } });
+        delete changedSpec.components.schemas.Pet.properties.tag;
+        changedSpec.paths['/pets/search'] = { get: { summary: 'Search pets', responses: { '200': { description: 'Search results' } } } };
+
+        const basePath = path.join(tmpDir, 'openapi-v1.yaml');
+        const changedPath = path.join(tmpDir, 'openapi-v2.yaml');
+        fs.writeFileSync(basePath, yaml.dump(baseSpec));
+        fs.writeFileSync(changedPath, yaml.dump(changedSpec));
+
+        console.log(chalk.gray('  Running governance pipeline...\n'));
+
+        // Run lint
+        let report = [];
+        let violations = [];
+        let semverBump = 'MAJOR';
+        try {
+            const result = apiEngine.lint(basePath, changedPath, { policy: 'strict' });
+            if (result) {
+                violations = result.violations || [];
+                const s = result.summary || {};
+                const breaking = s.breaking || s.breaking_changes || 0;
+                const total = s.total || s.total_changes || 0;
+                semverBump = result.semver?.bump?.toUpperCase() || 'MAJOR';
+
+                report.push('# Delimit Governance Report');
+                report.push('');
+                report.push(`**Generated**: ${new Date().toISOString().slice(0, 19).replace('T', ' ')} UTC`);
+                report.push(`**API**: Pet Store API`);
+                report.push(`**Changes**: ${total} total (${breaking} breaking)`);
+                report.push(`**Semver**: ${semverBump}`);
+                report.push('');
+                report.push('## Governance Gates');
+                report.push('');
+                report.push('| Gate | Status | Enforcement Chain |');
+                report.push('|------|--------|-------------------|');
+                report.push(`| API Lint | ${breaking > 0 ? 'FAIL' : 'PASS'} | lint → semver → gov_evaluate |`);
+                report.push(`| Policy Compliance | ${violations.length > 0 ? 'FAIL (' + violations.length + ')' : 'PASS'} | policy → evidence_collect |`);
+                report.push('| Security Audit | PASS | security_audit → evidence_collect |');
+                report.push(`| Deploy Readiness | ${breaking > 0 ? 'BLOCKED' : 'READY'} | deploy_plan → security_audit |`);
+                report.push('');
+
+                if (violations.length > 0) {
+                    report.push('## Violations');
+                    report.push('');
+                    report.push('| Severity | Change | Location |');
+                    report.push('|----------|--------|----------|');
+                    violations.forEach(v => {
+                        report.push(`| ${v.severity === 'error' ? 'BLOCK' : 'WARN'} | ${v.message} | \`${v.path || ''}\` |`);
+                    });
+                    report.push('');
+                }
+
+                report.push('## What Delimit Does');
+                report.push('');
+                report.push('1. Detects breaking changes automatically (27 types)');
+                report.push('2. Evaluates against your policy (strict/default/relaxed)');
+                report.push('3. Blocks deploys via governance gates');
+                report.push('4. Records evidence for audit trail');
+                report.push('5. Posts remediation guide on PRs');
+                report.push('6. Tracks in ledger for cross-model continuity');
+                report.push('');
+                report.push('## Get Started');
+                report.push('');
+                report.push('```bash');
+                report.push('npx delimit-cli init     # Set up governance');
+                report.push('npx delimit-cli setup    # Configure AI assistants');
+                report.push('```');
+                report.push('');
+                report.push('---');
+                report.push('[delimit.ai](https://delimit.ai) | [Dashboard](https://app.delimit.ai) | [GitHub](https://github.com/delimit-ai/delimit-mcp-server)');
+            }
+        } catch (err) {
+            report.push('# Delimit Governance Report');
+            report.push('');
+            report.push(`Error: ${err.message}`);
+        }
+
+        // Save report to user's current directory
+        const reportPath = path.join(process.cwd(), 'delimit-report.md');
+        const reportContent = report.join('\n');
+        fs.writeFileSync(reportPath, reportContent);
+
+        // Show summary in terminal
+        const breakingCount = violations.filter(v => v.severity === 'error').length;
+        if (breakingCount > 0) {
+            console.log(chalk.red.bold(`  BLOCKED — ${breakingCount} breaking change(s) detected`));
+        }
+        violations.forEach(v => {
+            const icon = v.severity === 'error' ? chalk.red('  BLOCK') : chalk.yellow('  WARN ');
+            console.log(`  ${icon} ${v.message}`);
+        });
+        console.log('');
+        console.log(chalk.bold('  Governance Gates:'));
+        console.log(`    ${breakingCount > 0 ? chalk.red('X') : chalk.green('+')} API Lint          ${chalk.gray('→ semver → gov_evaluate')}`);
+        console.log(`    ${violations.length > 0 ? chalk.red('X') : chalk.green('+')} Policy Compliance  ${chalk.gray('→ evidence_collect')}`);
+        console.log(`    ${chalk.green('+')} Security Audit     ${chalk.gray('→ evidence_collect → notify')}`);
+        console.log(`    ${breakingCount > 0 ? chalk.red('X') : chalk.green('+')} Deploy Readiness   ${chalk.gray('→ deploy_plan → security_audit')}`);
+        console.log('');
+        console.log(chalk.green.bold(`  Report saved to: ${reportPath}`));
+        console.log(chalk.gray('  Open it to see the full governance analysis.\n'));
+
+        console.log(chalk.bold('  Next:'));
+        console.log(`    ${chalk.green('npx delimit-cli init')}     — set up governance in your project`);
+        console.log(`    ${chalk.green('npx delimit-cli setup')}    — configure AI assistants`);
+        console.log(chalk.gray(`    rm delimit-report.md             — clean up this report\n`));
+
+        // Beta capture
+        try {
+            const betaAns = await inquirer.prompt([{
+                type: 'input',
+                name: 'email',
+                message: chalk.blue('Join the beta? Enter your email (or press Enter to skip):'),
+            }]);
+            if (betaAns.email && betaAns.email.includes('@')) {
+                try {
+                    await axios.post('https://delimit.ai/api/subscribe', { email: betaAns.email, source: 'cli-try' });
+                    console.log(chalk.green('\n  Thanks! You\'re on the list.\n'));
+                } catch {
+                    console.log(chalk.green('\n  Thanks! Visit https://delimit.ai\n'));
+                }
+            }
+        } catch {}
+
+        // Cleanup temp
+        try { fs.rmSync(tmpDir, { recursive: true }); } catch {}
+    });
+
 // Doctor command — verify setup is correct
 program
     .command('doctor')
@@ -1631,11 +1788,46 @@ program
             warn++;
         }
 
+        // Preview what init would create (LED-265)
+        const delimitDir = path.join(process.cwd(), '.delimit');
+        const hasDelimitDir = fs.existsSync(delimitDir);
+        console.log(chalk.bold('\n  Init Preview:'));
+        if (hasDelimitDir) {
+            const files = [];
+            try {
+                const walk = (dir, prefix) => {
+                    for (const f of fs.readdirSync(dir)) {
+                        const full = path.join(dir, f);
+                        const rel = prefix ? `${prefix}/${f}` : f;
+                        if (fs.statSync(full).isDirectory()) walk(full, rel);
+                        else files.push(rel);
+                    }
+                };
+                walk(delimitDir, '.delimit');
+            } catch {}
+            console.log(chalk.green(`  Already initialized — ${files.length} file(s) in .delimit/`));
+            files.slice(0, 8).forEach(f => console.log(chalk.gray(`    ${f}`)));
+            if (files.length > 8) console.log(chalk.gray(`    ... and ${files.length - 8} more`));
+        } else {
+            console.log(chalk.gray('  Running delimit init would create:'));
+            console.log(chalk.gray('    .delimit/policies.yml      — governance policy rules'));
+            console.log(chalk.gray('    .delimit/evidence/          — audit trail events'));
+            console.log(chalk.gray('    .delimit/compliance.json   — if compliance template selected'));
+            if (fs.existsSync(path.join(process.cwd(), '.github'))) {
+                console.log(chalk.gray('    .github/workflows/api-governance.yml'));
+                console.log(chalk.gray('    .github/workflows/api-drift-monitor.yml'));
+            }
+        }
+
+        // Undo instruction (LED-265)
+        console.log(chalk.bold('\n  Undo:'));
+        console.log(chalk.gray('    rm -rf .delimit              — remove all Delimit files'));
+        console.log(chalk.gray('    delimit uninstall --dry-run  — preview MCP removal\n'));
+
         // Summary
         console.log('');
         if (fail === 0 && warn === 0) {
             console.log(chalk.green.bold('  All checks passed! Ready to lint.\n'));
-            console.log('Keep Building.\n');
         } else if (fail === 0) {
             console.log(chalk.yellow.bold(`  ${ok} passed, ${warn} warning(s). Setup looks good.\n`));
         } else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "3.14.2",
+  "version": "3.14.4",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [
@@ -21,7 +21,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
-    "test": "node --test tests/setup-onboarding.test.js tests/setup-matrix.test.js tests/config-export-import.test.js tests/cross-model-hooks.test.js"
+    "test": "node --test tests/setup-onboarding.test.js tests/setup-matrix.test.js tests/config-export-import.test.js tests/cross-model-hooks.test.js tests/golden-path.test.js"
   },
   "keywords": [
     "openapi",