delimit-cli 3.6.0 → 3.6.1

package/README.md

@@ -1,11 +1,11 @@
 # delimit
 
-Stop Describing. Start Building.
+Your AI Remembers. Verifies. Ships.
 
 [![npm](https://img.shields.io/npm/v/delimit-cli)](https://www.npmjs.com/package/delimit-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-77 MCP governance tools for AI coding assistants. Prevents hallucinated results, verifies tests actually ran, enforces policies, and catches breaking API changes. Works with Claude Code, Codex, and Cursor.
+Governance layer for AI coding assistants. Your AI verifies its own work -- confirms tests ran, catches breaking API changes, audits security, and enforces policies. Works with Claude Code, Codex, and Cursor.
 
 ## Install
 
@@ -13,18 +13,18 @@ Stop Describing. Start Building.
 npx delimit-cli setup
 ```
 
-10 seconds. No API keys. No account. Installs MCP tools into your existing AI coding assistant.
+10 seconds. No API keys. No account. Installs into your existing AI coding assistant.
 
-## What happens
+## What it does
 
-Your AI agent gets 77 governance tools that verify its own work:
+Your AI agent gains the ability to verify its own work:
 
-- **Test verification** — confirms tests actually ran, measures coverage
-- **Security audit** — scans dependencies, detects hardcoded secrets and anti-patterns
-- **API governance** — catches breaking changes in OpenAPI specs before they ship
-- **Repo analysis** — code quality, health checks, config validation
-- **Deploy tracking** — plan, build, publish, verify, rollback
-- **Multi-model consensus** — Grok + Gemini + Codex deliberate on strategic decisions
+- **Test verification** -- confirms tests actually ran, measures coverage
+- **Security audit** -- scans dependencies, detects hardcoded secrets and anti-patterns
+- **API governance** -- catches breaking changes in OpenAPI specs before they ship
+- **Repo analysis** -- code quality, health checks, config validation
+- **Deploy tracking** -- plan, build, publish, verify, rollback
+- **Multi-model consensus** -- multiple AI models deliberate on strategic decisions
 
 ## Real examples
 
@@ -32,14 +32,13 @@ These happened in a single session:
 
 | Command | Result |
 |---------|--------|
-| "keep building" | Parallel agents replaced 37 dead tools with real implementations |
-| "fix the 502 error" | Traced Vercel → Caddy → Docker, found wrong IP, fixed, verified |
-| "run test coverage" | 299 → 1,113 tests, zero written manually |
+| "fix the 502 error" | Traced Vercel to Caddy to Docker, found wrong IP, fixed, verified |
+| "run test coverage" | 299 to 1,113 tests, zero written manually |
 | "run consensus on pricing" | 3 AI models debated, reached unanimous agreement |
 
 ## Free vs Pro
 
-**Free (15 tools)**: lint, diff, policy, semver, test coverage, security audit, repo analysis, zero-spec extraction, and more.
+**Free**: lint, diff, policy, semver, test coverage, security audit, repo analysis, zero-spec extraction, and more.
 
 **Pro ($10/mo)**: governance, deploy tracking, memory/vault, multi-model deliberation, evidence collection. Activate with `delimit activate YOUR_KEY`.
 

package/bin/delimit-setup.js

@@ -290,48 +290,33 @@ Run full governance compliance checks. Verify security, policy compliance, evide
 
     const claudeMd = path.join(os.homedir(), 'CLAUDE.md');
     if (!fs.existsSync(claudeMd)) {
-        fs.writeFileSync(claudeMd, `# Delimit AI Guardrails
-
-Delimit governance tools are installed. On first use, try:
-
-- "check governance health" — see the status of this project
-- "initialize governance" — set up policies and ledger for this project
-- "run test coverage" — measure test coverage
-- "analyze this repo" — get a health report
-
-## Quick Start
-If this project hasn't been initialized for governance yet, say:
-"initialize governance for this project"
-
-This creates .delimit/policies.yml and a ledger directory.
-
-## Available Agents
-- /lint — check API specs for breaking changes
-- /engineering — build, test, refactor with governance checks
-- /governance — full compliance audit
-
-## Key Tools
-- delimit_init — bootstrap governance for a project
-- delimit_lint — diff two OpenAPI specs
-- delimit_test_coverage — measure test coverage
-- delimit_gov_health — check governance status
-- delimit_repo_analyze — full repo health report
-`);
+        fs.writeFileSync(claudeMd, getClaudeMdContent());
         log(`  ${green('✓')} Created ${claudeMd} with first-run guidance`);
     } else {
-        log(`  ${dim('  CLAUDE.md already exists — skipped')}`);
+        // Check if existing CLAUDE.md is an older Delimit version that should be upgraded
+        const existing = fs.readFileSync(claudeMd, 'utf-8');
+        if (existing.includes('# Delimit AI Guardrails') || existing.includes('delimit_init') || existing.includes('delimit_lint')) {
+            fs.writeFileSync(claudeMd, getClaudeMdContent());
+            log(`  ${green('✓')} Updated ${claudeMd} with improved onboarding`);
+        } else {
+            log(`  ${dim('  CLAUDE.md already exists with custom content — skipped')}`);
+        }
     }
 
-    // Step 6: Summary
+    // Step 6: Try it now
     step(6, 'Done!');
     log('');
-    log(`  ${green('Delimit is installed.')} Your AI agents are now monitored.`);
+    log(`  ${green('Delimit is installed.')} Your AI now has persistent memory and governance.`);
+    log('');
+    log('  Try it now:');
+    log(`  ${bold('$ claude')}`);
+    log('');
+    log(`  Then say: ${blue('"check this project\'s health"')}`);
     log('');
-    log('  What happens next:');
-    log(`  ${dim('1.')} Start Claude Code in any project`);
-    log(`  ${dim('2.')} The delimit MCP tools load automatically`);
-    log(`  ${dim('3.')} Use agents: ${blue('/lint')}, ${blue('/governance')}, ${blue('/engineering')}`);
-    log(`  ${dim('4.')} Or ask: "check governance health" / "run test coverage"`);
+    log('  Or try:');
+    log(`  ${dim('-')} "add to ledger: set up CI pipeline"  ${dim('— start tracking tasks')}`);
+    log(`  ${dim('-')} "what\'s on the ledger?"               ${dim('— see what\'s pending')}`);
+    log(`  ${dim('-')} "delimit help"                        ${dim('— see all capabilities')}`);
     log('');
     log(`  ${dim('Config:')} ${MCP_CONFIG}`);
     log(`  ${dim('Server:')} ${actualServer}`);
@@ -342,6 +327,36 @@ This creates .delimit/policies.yml and a ledger directory.
     log('');
 }
 
+function getClaudeMdContent() {
+    return `# Delimit
+
+Your AI has persistent memory, verified execution, and governance.
+
+## First time? Say one of these:
+- "check this project's health" -- see what Delimit finds
+- "add to ledger: [anything]" -- start tracking tasks
+- "what's on the ledger?" -- see what's pending
+
+## Returning? Your AI remembers:
+- Ledger items persist across sessions
+- Governance rules stay configured
+- Memory carries forward
+
+## On first session, your AI will automatically:
+1. Diagnose the environment to verify everything is connected
+2. Check the ledger for any pending items from previous sessions
+3. If no governance exists yet, suggest initializing it
+
+## Available Agents
+- /lint -- check API specs for breaking changes
+- /engineering -- build, test, refactor with governance checks
+- /governance -- full compliance audit
+
+## Need help?
+Say "delimit help" for docs on any capability.
+`;
+}
+
 function copyDir(src, dest) {
     fs.mkdirSync(dest, { recursive: true });
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "delimit-cli",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "Stop Describing. Start Building. 77 MCP governance tools for AI coding assistants.",
   "main": "index.js",
   "bin": {

package/tests/setup-onboarding.test.js

@@ -0,0 +1,147 @@
+const { describe, it } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Extract getClaudeMdContent by loading the setup script source
+// We test the content function and upgrade logic in isolation.
+
+function getClaudeMdContent() {
+    return `# Delimit
+
+Your AI has persistent memory, verified execution, and governance.
+
+## First time? Say one of these:
+- "check this project's health" -- see what Delimit finds
+- "add to ledger: [anything]" -- start tracking tasks
+- "what's on the ledger?" -- see what's pending
+
+## Returning? Your AI remembers:
+- Ledger items persist across sessions
+- Governance rules stay configured
+- Memory carries forward
+
+## On first session, your AI will automatically:
+1. Diagnose the environment to verify everything is connected
+2. Check the ledger for any pending items from previous sessions
+3. If no governance exists yet, suggest initializing it
+
+## Available Agents
+- /lint -- check API specs for breaking changes
+- /engineering -- build, test, refactor with governance checks
+- /governance -- full compliance audit
+
+## Need help?
+Say "delimit help" for docs on any capability.
+`;
+}
+
+describe('CLAUDE.md onboarding content', () => {
+    it('does not mention individual tool names', () => {
+        const content = getClaudeMdContent();
+        // These tool names should never appear in user-facing CLAUDE.md
+        const toolNames = [
+            'delimit_init',
+            'delimit_lint',
+            'delimit_diff',
+            'delimit_test_coverage',
+            'delimit_gov_health',
+            'delimit_repo_analyze',
+            'delimit_diagnose',
+            'delimit_ledger_context',
+        ];
+        for (const tool of toolNames) {
+            assert.ok(
+                !content.includes(tool),
+                `CLAUDE.md should not contain tool name "${tool}"`
+            );
+        }
+    });
+
+    it('contains natural language prompts for first-time users', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('check this project\'s health'), 'Should have health check prompt');
+        assert.ok(content.includes('add to ledger'), 'Should have ledger add prompt');
+        assert.ok(content.includes('what\'s on the ledger'), 'Should have ledger check prompt');
+    });
+
+    it('mentions persistent memory and governance', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('persistent memory'), 'Should mention persistent memory');
+        assert.ok(content.includes('governance'), 'Should mention governance');
+    });
+
+    it('includes returning user section', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('Returning?'), 'Should have returning user section');
+        assert.ok(content.includes('Ledger items persist'), 'Should mention ledger persistence');
+        assert.ok(content.includes('Memory carries forward'), 'Should mention memory persistence');
+    });
+
+    it('includes automatic first-session actions', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('Diagnose the environment'), 'Should mention auto-diagnose');
+        assert.ok(content.includes('Check the ledger'), 'Should mention auto-ledger check');
+        assert.ok(content.includes('suggest initializing'), 'Should mention governance init suggestion');
+    });
+
+    it('includes help instruction', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('delimit help'), 'Should tell users how to get help');
+    });
+
+    it('lists agents by slash-command not tool name', () => {
+        const content = getClaudeMdContent();
+        assert.ok(content.includes('/lint'), 'Should reference /lint agent');
+        assert.ok(content.includes('/engineering'), 'Should reference /engineering agent');
+        assert.ok(content.includes('/governance'), 'Should reference /governance agent');
+    });
+});
+
+describe('CLAUDE.md upgrade detection', () => {
+    it('detects old-format CLAUDE.md with "Delimit AI Guardrails" header', () => {
+        const oldContent = '# Delimit AI Guardrails\n\nSome old content';
+        assert.ok(
+            oldContent.includes('# Delimit AI Guardrails'),
+            'Should detect old header'
+        );
+    });
+
+    it('detects old-format CLAUDE.md with tool names', () => {
+        const oldContent = 'Some content with delimit_init and delimit_lint';
+        assert.ok(
+            oldContent.includes('delimit_init') || oldContent.includes('delimit_lint'),
+            'Should detect old tool name references'
+        );
+    });
+
+    it('does not upgrade custom CLAUDE.md without Delimit markers', () => {
+        const customContent = '# My Project\n\nThis is a custom CLAUDE.md for my project.';
+        const hasOldMarkers =
+            customContent.includes('# Delimit AI Guardrails') ||
+            customContent.includes('delimit_init') ||
+            customContent.includes('delimit_lint');
+        assert.ok(!hasOldMarkers, 'Custom content should not be detected as old Delimit format');
+    });
+});
+
+describe('setup script output messaging', () => {
+    it('setup script file contains try-it-now messaging', () => {
+        const setupPath = path.join(__dirname, '..', 'bin', 'delimit-setup.js');
+        const setupContent = fs.readFileSync(setupPath, 'utf-8');
+        assert.ok(setupContent.includes('Try it now:'), 'Should have "Try it now:" prompt');
+        assert.ok(setupContent.includes('$ claude'), 'Should suggest running claude');
+        assert.ok(setupContent.includes('check this project\'s health'), 'Should suggest health check');
+    });
+
+    it('setup script does not list tool names in output', () => {
+        const setupPath = path.join(__dirname, '..', 'bin', 'delimit-setup.js');
+        const setupContent = fs.readFileSync(setupPath, 'utf-8');
+        // Check that Step 6 output area does not reference internal tool names
+        const step6Onwards = setupContent.split('// Step 6')[1];
+        assert.ok(step6Onwards, 'Should have Step 6 section');
+        assert.ok(!step6Onwards.includes('delimit_init'), 'Step 6 should not mention delimit_init');
+        assert.ok(!step6Onwards.includes('delimit_gov_health'), 'Step 6 should not mention delimit_gov_health');
+    });
+});