claude-ketchup 0.7.0

package/README.md

@@ -0,0 +1,172 @@
+# Claude Ketchup
+
+**Stop Babysitting. Start Parallelizing.**
+
+[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square)]()
+
+---
+
+## The Problem: You're an AI Babysitter
+
+AI-assisted coding captured your cognitive load.
+
+Every session demands your full attention. Watching, nudging, correcting. You can't walk away because you don't trust the system.
+
+- You can't context-switch while supervising
+- One task at a time, full attention required
+- The bottleneck is your attention, not AI's speed
+
+That's not multiplication. That's marginally faster serial work.
+
+---
+
+## The Solution: The Quality Stack
+
+Claude Ketchup creates trust. Trust enables parallelization.
+
+| Component          | What It Does                                 | Result                          |
+| ------------------ | -------------------------------------------- | ------------------------------- |
+| **Auto-Planner**   | Generates plan from your requirements        | No need to specify every detail |
+| **Supervisor AI**  | Validates every commit against your criteria | Automated review                |
+| **TCR Discipline** | Test && Commit \|\| Revert                   | Bad code auto-reverts           |
+| **Auto-Continue**  | Keeps going until the plan is done           | No nudging required             |
+
+The system is trustworthy. That's what frees you.
+
+---
+
+## The Multiplier: Git Worktrees
+
+Git worktrees let you run multiple isolated workspaces from the same repo.
+
+```bash
+# Create worktrees for parallel features
+git worktree add ../feature-auth feature/auth
+git worktree add ../feature-payments feature/payments
+git worktree add ../feature-dashboard feature/dashboard
+```
+
+Each runs a Ketchup instance. All quality-validated.
+
+| Approach                  | Features/Week |
+| ------------------------- | ------------- |
+| Manual coding             | 1             |
+| AI-assisted (babysitting) | 1-2           |
+| **Ketchup + Worktrees**   | **5-10**      |
+
+---
+
+## Three Steps
+
+### 1. Install
+
+```bash
+npx claude-ketchup install
+```
+
+Feed your requirements. Ketchup auto-generates the plan with Bottles, Bursts, and Dependencies.
+
+### 2. Release
+
+Start execution and walk away. The Supervisor validates every commit. Auto-continue keeps it going until done.
+
+### 3. Multiply
+
+Open another worktree. Start another instance. Three features. Five features. All in parallel.
+
+---
+
+## The Transformation
+
+| Before (Babysitter)              | After (Bionic)                 |
+| -------------------------------- | ------------------------------ |
+| Watching one AI session          | Directing multiple workstreams |
+| Nudging, correcting in real-time | Defining, approving, releasing |
+| Serial productivity              | Parallel productivity          |
+| Marginal gains (1.5x)            | Multiplicative gains (5-10x)   |
+| Brain captured by supervision    | Brain freed for the next thing |
+
+From Babysitter to Bionic.
+
+---
+
+## Installation
+
+```bash
+# Install Claude Ketchup
+npx claude-ketchup install
+
+# Verify installation
+npx claude-ketchup doctor
+
+# You're ready to become Bionic
+```
+
+After installation, claude-ketchup automatically:
+
+- Injects hooks that validate every commit
+- Creates reminders that inject your guidelines
+- Sets up file protection via deny-lists
+- Merges settings with smart project/local overrides
+
+---
+
+## Authority: Battle-Tested
+
+Built on foundations from Kent Beck's TCR and Extreme Programming principles. Refined through production features at Auto.
+
+The on.auto team ships 5-10 features per week. Not 1-2.
+
+**[Read the origin story →](./docs/origin-story.md)**
+
+---
+
+## CLI Reference
+
+| Command                    | Description                                         |
+| ------------------------- | --------------------------------------------------- |
+| `claude-ketchup install`  | Install and configure claude-ketchup in your project |
+| `claude-ketchup init`     | Initialize ketchup configuration                    |
+| `claude-ketchup status`   | Show symlink status for hook scripts and reminders  |
+| `claude-ketchup doctor`   | Diagnose installation health                        |
+| `claude-ketchup repair`   | Recreate broken or missing symlinks                 |
+| `claude-ketchup reminders`| List active reminders with metadata                 |
+| `claude-ketchup clean-logs`| Remove old log files (use `--older-than=N` to keep N recent logs) |
+
+---
+
+## Documentation
+
+| Guide                                            | Description                     |
+| ------------------------------------------------ | ------------------------------- |
+| [Getting Started](./docs/getting-started.md)     | 5-minute transformation         |
+| [Installation](./docs/installation.md)           | Detailed installation guide     |
+| [The Quality Stack](./docs/ketchup-technique.md) | Why you can walk away           |
+| [Configuration](./docs/configuration.md)         | All configuration options       |
+| [Hooks Guide](./docs/hooks-guide.md)             | Configure your supervision      |
+| [Reminders Guide](./docs/reminders-guide.md)     | Context injection system        |
+| [Validators Guide](./docs/validators-guide.md)   | Commit validation rules         |
+| [API Reference](./docs/api-reference.md)         | Programmatic access             |
+| [Architecture](./docs/architecture.md)           | System design internals         |
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/BeOnAuto/claude-ketchup.git
+cd claude-ketchup
+pnpm install
+pnpm test
+pnpm build
+```
+
+---
+
+## License
+
+MIT © 2025 BeOnAuto, Inc.
+
+See [LICENSE](LICENSE) for details.
+
+---

package/bin/cli.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import { createCli } from '../src/cli/cli.js';
+
+const program = createCli();
+program.parse();

package/bin/postinstall.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env npx tsx
+
+import { runPostinstall } from '../src/postinstall.js';
+
+runPostinstall().catch((err) => {
+  console.error('Postinstall failed:', err);
+  process.exit(1);
+});

package/bin/preuninstall.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env npx tsx
+
+import { runPreuninstall } from '../src/preuninstall.js';
+
+runPreuninstall().catch((err) => {
+  console.error('Preuninstall failed:', err);
+  process.exit(1);
+});

package/commands/ketchup.md

@@ -0,0 +1,107 @@
+# /ketchup - Ketchup Status & Control
+
+Check the status of your claude-ketchup installation and manage symlinks.
+
+## Commands
+
+### `/ketchup` or `/ketchup status`
+
+Show the current status of all managed symlinks.
+
+### `/ketchup doctor`
+
+Run diagnostics to check for issues with the installation.
+
+### `/ketchup repair`
+
+Fix any broken or missing symlinks.
+
+### `/ketchup skills`
+
+List all active skills with their metadata.
+
+## Implementation
+
+When the user runs `/ketchup <command>`, you should:
+
+1. Determine the package directory (node_modules/claude-ketchup)
+2. Determine the .claude directory (project root/.claude)
+3. Run the appropriate command function
+4. Display the results
+
+### Response Format
+
+**For `/ketchup status`:**
+
+```
+╭─────────────────────────────────────────╮
+│         🥫 Ketchup Status               │
+├─────────────────────────────────────────┤
+│  Symlinks:                              │
+│    ✓ scripts/session-start.ts           │
+│    ✓ scripts/pre-tool-use.ts            │
+│    ✓ skills/coding.md                   │
+├─────────────────────────────────────────┤
+│  All symlinks healthy                   │
+╰─────────────────────────────────────────╯
+```
+
+**For `/ketchup doctor`:**
+
+```
+╭─────────────────────────────────────────╮
+│         🩺 Ketchup Doctor               │
+├─────────────────────────────────────────┤
+│  ✓ All symlinks valid                   │
+│  ✓ Settings merged                      │
+│  ✓ Gitignore updated                    │
+├─────────────────────────────────────────┤
+│  Status: Healthy                        │
+╰─────────────────────────────────────────╯
+```
+
+**For `/ketchup repair`:**
+
+```
+╭─────────────────────────────────────────╮
+│         🔧 Ketchup Repair               │
+├─────────────────────────────────────────┤
+│  Repaired:                              │
+│    ↻ scripts/session-start.ts           │
+│    ↻ skills/coding.md                   │
+├─────────────────────────────────────────┤
+│  2 symlinks repaired                    │
+╰─────────────────────────────────────────╯
+```
+
+**For `/ketchup skills`:**
+
+```
+╭─────────────────────────────────────────╮
+│         📚 Active Skills                │
+├─────────────────────────────────────────┤
+│  coding.md                              │
+│    Hook: SessionStart                   │
+│    Priority: 10                         │
+│                                         │
+│  reminder.md                            │
+│    Hook: UserPromptSubmit               │
+│    Priority: 5                          │
+├─────────────────────────────────────────┤
+│  2 skills active                        │
+╰─────────────────────────────────────────╯
+```
+
+**For `/ketchup help`:**
+
+```
+/ketchup - Ketchup Status & Control
+
+Commands:
+  /ketchup              Show symlink status
+  /ketchup status       Show symlink status
+  /ketchup doctor       Run diagnostics
+  /ketchup repair       Fix broken symlinks
+  /ketchup skills       List active skills
+  /ketchup help         Show this help
+```

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_js_1 = require("../src/cli/cli.js");
+const program = (0, cli_js_1.createCli)();
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";;;AAEA,8CAA8C;AAE9C,MAAM,OAAO,GAAG,IAAA,kBAAS,GAAE,CAAC;AAC5B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/bin/postinstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/bin/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../../bin/postinstall.ts"],"names":[],"mappings":""}

package/dist/bin/postinstall.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env npx tsx
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const postinstall_js_1 = require("../src/postinstall.js");
+(0, postinstall_js_1.runPostinstall)().catch((err) => {
+    console.error('Postinstall failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=postinstall.js.map

package/dist/bin/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../../bin/postinstall.ts"],"names":[],"mappings":";;;AAEA,0DAAuD;AAEvD,IAAA,+BAAc,GAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7B,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/bin/preuninstall.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=preuninstall.d.ts.map

package/dist/bin/preuninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preuninstall.d.ts","sourceRoot":"","sources":["../../bin/preuninstall.ts"],"names":[],"mappings":""}

package/dist/bin/preuninstall.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env npx tsx
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const preuninstall_js_1 = require("../src/preuninstall.js");
+(0, preuninstall_js_1.runPreuninstall)().catch((err) => {
+    console.error('Preuninstall failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=preuninstall.js.map

package/dist/bin/preuninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preuninstall.js","sourceRoot":"","sources":["../../bin/preuninstall.ts"],"names":[],"mappings":";;;AAEA,4DAAyD;AAEzD,IAAA,iCAAe,GAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/scripts/auto-continue.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env npx tsx
+export {};
+//# sourceMappingURL=auto-continue.d.ts.map

package/dist/scripts/auto-continue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-continue.d.ts","sourceRoot":"","sources":["../../scripts/auto-continue.ts"],"names":[],"mappings":""}

package/dist/scripts/auto-continue.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env npx tsx
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const hook_logger_js_1 = require("../src/hook-logger.js");
+const auto_continue_js_1 = require("../src/hooks/auto-continue.js");
+const projectDir = process.cwd();
+const claudeDir = path.resolve(projectDir, '.claude');
+const stdin = fs.readFileSync(0, 'utf8').trim();
+if (!stdin) {
+    process.exit(0);
+}
+const input = JSON.parse(stdin);
+const startTime = Date.now();
+const result = (0, auto_continue_js_1.handleStop)(projectDir, input);
+const output = result.decision === 'block' ? { stopReason: result.reason, forceResult: { behaviour: 'block' } } : null;
+(0, hook_logger_js_1.writeHookLog)(claudeDir, {
+    hookName: 'auto-continue',
+    timestamp: new Date().toISOString(),
+    input,
+    output: output ?? { decision: result.decision, reason: result.reason },
+    durationMs: Date.now() - startTime,
+});
+if (output) {
+    console.log(JSON.stringify(output));
+}
+process.exit(0);
+//# sourceMappingURL=auto-continue.js.map

package/dist/scripts/auto-continue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-continue.js","sourceRoot":"","sources":["../../scripts/auto-continue.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,4CAA8B;AAC9B,gDAAkC;AAElC,0DAAqD;AACrD,oEAA+E;AAE/E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACtD,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,KAAK,GAAkB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,MAAM,MAAM,GAAG,IAAA,6BAAU,EAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAE7C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAEvH,IAAA,6BAAY,EAAC,SAAS,EAAE;IACtB,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACnC,KAAK;IACL,MAAM,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IACtE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;CACnC,CAAC,CAAC;AAEH,IAAI,MAAM,EAAE,CAAC;IACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/scripts/generate-changeset.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env tsx
+/**
+ * AI-powered changeset generation script
+ *
+ * This script:
+ * 1. Gets commits since last changeset/tag
+ * 2. Parses conventional commits (feat/fix/etc)
+ * 3. Determines bump type (breaking→major, feat→minor, else→patch)
+ * 4. Generates changelog via Claude CLI (with simple fallback)
+ * 5. Creates .changeset/*.md file
+ */
+export {};
+//# sourceMappingURL=generate-changeset.d.ts.map

package/dist/scripts/generate-changeset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-changeset.d.ts","sourceRoot":"","sources":["../../scripts/generate-changeset.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}