cckb 0.1.0

package/README.md

@@ -0,0 +1,247 @@
+# CCKB - Claude Code Knowledge Base
+
+**Automatic project knowledge capture for Claude Code**
+
+CCKB runs silently in the background, capturing conversations and building a structured knowledge base that Claude can reference in future sessions. No manual documentation needed — your project learns as you work.
+
+---
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         Claude Code Session                              │
+│                                                                          │
+│  You: "Create an Order entity with id, items, total"                    │
+│                                    │                                     │
+│                                    ▼                                     │
+│  ┌──────────────────────────────────────────────────────────────────┐   │
+│  │                    CCKB Hooks (Background)                        │   │
+│  │                                                                   │   │
+│  │  📝 Captures conversation              🔍 Provides vault context  │   │
+│  │  📁 Logs to conversations/             💡 Injects relevant info   │   │
+│  │  🗜️  Summarizes on session end         📚 Updates knowledge base  │   │
+│  └──────────────────────────────────────────────────────────────────┘   │
+│                                    │                                     │
+└────────────────────────────────────┼─────────────────────────────────────┘
+                                     ▼
+                    ┌─────────────────────────────────────┐
+                    │       cc-knowledge-base/            │
+                    │                                     │
+                    │  vault/                             │
+                    │  ├── INDEX.md                       │
+                    │  ├── architecture.md                │
+                    │  ├── general-knowledge.md           │
+                    │  └── entities/                      │
+                    │      ├── INDEX.md                   │
+                    │      └── order/                     │
+                    │          ├── INDEX.md               │
+                    │          ├── attributes.md          │
+                    │          └── services.md            │
+                    │                                     │
+                    │  conversations/                     │
+                    │  └── {session-id}/                  │
+                    │      ├── 0.txt                      │
+                    │      └── summary.md                 │
+                    └─────────────────────────────────────┘
+```
+
+### The Cycle
+
+1. **Capture** — Hooks silently log user prompts and Claude's actions
+2. **Compact** — On session end, conversations are summarized
+3. **Integrate** — Entities, patterns, and knowledge are extracted and organized
+4. **Feedback** — Future sessions receive relevant context from the vault
+
+---
+
+## Installation
+
+### Option 1: npx (Recommended)
+
+```bash
+# From your project directory
+npx cckb init
+```
+
+### Option 2: Global Install
+
+```bash
+npm install -g cckb
+# Then from any project:
+cckb init
+```
+
+### Option 3: pnpm
+
+```bash
+pnpm dlx cckb init
+```
+
+---
+
+## What Gets Installed
+
+```
+your-project/
+├── .claude/
+│   └── settings.json        # Hook configuration added
+├── cc-knowledge-base/
+│   ├── .cckb-config.json    # CCKB settings
+│   ├── conversations/       # Session logs
+│   └── vault/               # Knowledge base
+│       ├── INDEX.md
+│       ├── architecture.md
+│       ├── general-knowledge.md
+│       └── entities/
+│           └── INDEX.md
+├── CLAUDE.md                # Vault directives added
+└── .gitignore               # State files excluded
+```
+
+---
+
+## Configuration
+
+Edit `cc-knowledge-base/.cckb-config.json`:
+
+```json
+{
+  "compaction": {
+    "trigger": "session_end",
+    "sizeThresholdKB": 50
+  },
+  "capture": {
+    "tools": ["Write", "Edit", "MultiEdit", "Bash", "Task"],
+    "maxContentLength": 500
+  },
+  "vault": {
+    "autoIntegrate": true,
+    "maxDepth": 5
+  },
+  "feedback": {
+    "enabled": true,
+    "contextDepth": 2
+  }
+}
+```
+
+| Option | Description |
+|--------|-------------|
+| `compaction.trigger` | When to summarize: `session_end`, `size`, `messages`, or `manual` |
+| `compaction.sizeThresholdKB` | File size threshold for rotation |
+| `capture.tools` | Which tool outputs to capture |
+| `capture.maxContentLength` | Max characters per tool output |
+| `vault.autoIntegrate` | Auto-update vault after compaction |
+| `vault.maxDepth` | Maximum folder nesting depth |
+| `feedback.enabled` | Inject vault context into sessions |
+| `feedback.contextDepth` | How many INDEX levels to load |
+
+---
+
+## Vault Structure
+
+The vault uses **sparse loading** — Claude only reads INDEX.md files for navigation, loading specific files only when needed.
+
+### INDEX.md Format
+
+```markdown
+# Entities
+
+## Contents
+
+| Item | Description |
+|------|-------------|
+| [user/](./user/INDEX.md) | User authentication and profiles |
+| [order/](./order/INDEX.md) | Order processing and tracking |
+```
+
+### Entity Documentation
+
+```
+entities/order/
+├── INDEX.md          # Overview and links
+├── attributes.md     # Fields: id, items, total, status
+└── services/
+    ├── INDEX.md
+    ├── repository.md # Data access methods
+    └── usecase.md    # Business logic
+```
+
+---
+
+## Hooks
+
+CCKB installs these Claude Code hooks:
+
+| Hook | Purpose |
+|------|---------|
+| `SessionStart` | Creates conversation folder, loads vault cache |
+| `UserPromptSubmit` | Captures user messages |
+| `PostToolUse` | Captures Claude's actions (filtered) |
+| `Stop` | Triggers compaction and vault integration |
+| `PreToolUse` | Injects relevant vault context |
+
+All hooks run silently in the background.
+
+---
+
+## Commands
+
+```bash
+cckb init [path]     # Install CCKB in a project
+cckb init --force    # Reinstall, overwriting existing config
+cckb hook <name>     # Run a hook (internal use)
+cckb version         # Show version
+cckb help            # Show help
+```
+
+---
+
+## How Claude Uses the Vault
+
+CCKB adds directives to your `CLAUDE.md`:
+
+```markdown
+## Project Knowledge Base (CCKB)
+
+### Usage Guidelines
+
+1. Before creating new entities/services:
+   - Check vault INDEX.md for existing patterns
+   - Review related entity structures
+   - Follow established architecture
+
+2. When uncertain about project conventions:
+   - Consult vault/general-knowledge.md
+   - Check entity-specific INDEX.md files
+
+3. Sparse Loading:
+   - Start with INDEX.md files only
+   - Deep-load specific files only when needed
+```
+
+---
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/n3m/cckb.git
+cd cckb
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Test locally
+node dist/bin/cckb.js init /tmp/test-project
+```
+
+---
+
+## License
+
+MIT

package/dist/bin/cckb.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/cckb.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import {
+  install
+} from "../chunk-GUB5D6EN.js";
+import "../chunk-TFFLX3YY.js";
+
+// src/bin/cckb.ts
+var args = process.argv.slice(2);
+var command = args[0];
+async function main() {
+  switch (command) {
+    case "init":
+      const targetPath = args[1] || process.cwd();
+      const force = args.includes("--force");
+      await install(targetPath, { force });
+      break;
+    case "hook":
+      const hookName = args[1];
+      await runHook(hookName);
+      break;
+    case "version":
+    case "-v":
+    case "--version":
+      console.log("cckb v0.1.0");
+      break;
+    case "help":
+    case "-h":
+    case "--help":
+    default:
+      printHelp();
+      break;
+  }
+}
+async function runHook(hookName) {
+  switch (hookName) {
+    case "session-start": {
+      const { handleSessionStart } = await import("../hooks/session-start.js");
+      await handleSessionStart();
+      break;
+    }
+    case "user-prompt": {
+      const { handleUserPrompt } = await import("../hooks/user-prompt.js");
+      await handleUserPrompt();
+      break;
+    }
+    case "post-tool-use": {
+      const { handlePostToolUse } = await import("../hooks/post-tool-use.js");
+      await handlePostToolUse();
+      break;
+    }
+    case "stop": {
+      const { handleStop } = await import("../hooks/stop.js");
+      await handleStop();
+      break;
+    }
+    case "notification": {
+      const { handleNotification } = await import("../hooks/notification.js");
+      await handleNotification();
+      break;
+    }
+    default:
+      console.error(`Unknown hook: ${hookName}`);
+      process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+CCKB - Claude Code Knowledge Base
+
+Usage:
+  cckb init [path]    Install CCKB into a project
+  cckb hook <name>    Run a specific hook (internal use)
+  cckb version        Show version
+  cckb help           Show this help message
+
+Options:
+  --force             Overwrite existing installation
+
+Examples:
+  cckb init           Install in current directory
+  cckb init ./myapp   Install in ./myapp directory
+  cckb init --force   Reinstall, overwriting existing config
+`);
+}
+main().catch((error) => {
+  console.error("Error:", error.message);
+  process.exit(1);
+});
+//# sourceMappingURL=cckb.js.map

package/dist/bin/cckb.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bin/cckb.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { install } from \"../cli/install.js\";\n\nconst args = process.argv.slice(2);\nconst command = args[0];\n\nasync function main() {\n  switch (command) {\n    case \"init\":\n      const targetPath = args[1] || process.cwd();\n      const force = args.includes(\"--force\");\n      await install(targetPath, { force });\n      break;\n\n    case \"hook\":\n      const hookName = args[1];\n      await runHook(hookName);\n      break;\n\n    case \"version\":\n    case \"-v\":\n    case \"--version\":\n      console.log(\"cckb v0.1.0\");\n      break;\n\n    case \"help\":\n    case \"-h\":\n    case \"--help\":\n    default:\n      printHelp();\n      break;\n  }\n}\n\nasync function runHook(hookName: string) {\n  switch (hookName) {\n    case \"session-start\": {\n      const { handleSessionStart } = await import(\n        \"../hooks/session-start.js\"\n      );\n      await handleSessionStart();\n      break;\n    }\n    case \"user-prompt\": {\n      const { handleUserPrompt } = await import(\"../hooks/user-prompt.js\");\n      await handleUserPrompt();\n      break;\n    }\n    case \"post-tool-use\": {\n      const { handlePostToolUse } = await import(\"../hooks/post-tool-use.js\");\n      await handlePostToolUse();\n      break;\n    }\n    case \"stop\": {\n      const { handleStop } = await import(\"../hooks/stop.js\");\n      await handleStop();\n      break;\n    }\n    case \"notification\": {\n      const { handleNotification } = await import(\"../hooks/notification.js\");\n      await handleNotification();\n      break;\n    }\n    default:\n      console.error(`Unknown hook: ${hookName}`);\n      process.exit(1);\n  }\n}\n\nfunction printHelp() {\n  console.log(`\nCCKB - Claude Code Knowledge Base\n\nUsage:\n  cckb init [path]    Install CCKB into a project\n  cckb hook <name>    Run a specific hook (internal use)\n  cckb version        Show version\n  cckb help           Show this help message\n\nOptions:\n  --force             Overwrite existing installation\n\nExamples:\n  cckb init           Install in current directory\n  cckb init ./myapp   Install in ./myapp directory\n  cckb init --force   Reinstall, overwriting existing config\n`);\n}\n\nmain().catch((error) => {\n  console.error(\"Error:\", error.message);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;AAIA,IAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,IAAM,UAAU,KAAK,CAAC;AAEtB,eAAe,OAAO;AACpB,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,YAAM,aAAa,KAAK,CAAC,KAAK,QAAQ,IAAI;AAC1C,YAAM,QAAQ,KAAK,SAAS,SAAS;AACrC,YAAM,QAAQ,YAAY,EAAE,MAAM,CAAC;AACnC;AAAA,IAEF,KAAK;AACH,YAAM,WAAW,KAAK,CAAC;AACvB,YAAM,QAAQ,QAAQ;AACtB;AAAA,IAEF,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,cAAQ,IAAI,aAAa;AACzB;AAAA,IAEF,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL;AACE,gBAAU;AACV;AAAA,EACJ;AACF;AAEA,eAAe,QAAQ,UAAkB;AACvC,UAAQ,UAAU;AAAA,IAChB,KAAK,iBAAiB;AACpB,YAAM,EAAE,mBAAmB,IAAI,MAAM,OACnC,2BACF;AACA,YAAM,mBAAmB;AACzB;AAAA,IACF;AAAA,IACA,KAAK,eAAe;AAClB,YAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,yBAAyB;AACnE,YAAM,iBAAiB;AACvB;AAAA,IACF;AAAA,IACA,KAAK,iBAAiB;AACpB,YAAM,EAAE,kBAAkB,IAAI,MAAM,OAAO,2BAA2B;AACtE,YAAM,kBAAkB;AACxB;AAAA,IACF;AAAA,IACA,KAAK,QAAQ;AACX,YAAM,EAAE,WAAW,IAAI,MAAM,OAAO,kBAAkB;AACtD,YAAM,WAAW;AACjB;AAAA,IACF;AAAA,IACA,KAAK,gBAAgB;AACnB,YAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,0BAA0B;AACtE,YAAM,mBAAmB;AACzB;AAAA,IACF;AAAA,IACA;AACE,cAAQ,MAAM,iBAAiB,QAAQ,EAAE;AACzC,cAAQ,KAAK,CAAC;AAAA,EAClB;AACF;AAEA,SAAS,YAAY;AACnB,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAgBb;AACD;AAEA,KAAK,EAAE,MAAM,CAAC,UAAU;AACtB,UAAQ,MAAM,UAAU,MAAM,OAAO;AACrC,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/chunk-GUB5D6EN.js

@@ -0,0 +1,197 @@
+import {
+  DEFAULT_CONFIG,
+  ensureDir,
+  fileExists,
+  readJSON,
+  readTextFile,
+  writeJSON,
+  writeTextFile
+} from "./chunk-TFFLX3YY.js";
+
+// src/cli/install.ts
+import * as fs from "fs/promises";
+import * as fsSync from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+function findPackageRoot() {
+  let dir = __dirname;
+  for (let i = 0; i < 5; i++) {
+    const packageJson = path.join(dir, "package.json");
+    if (fsSync.existsSync(packageJson)) {
+      return dir;
+    }
+    dir = path.dirname(dir);
+  }
+  return path.resolve(__dirname, "../..");
+}
+var PACKAGE_ROOT = findPackageRoot();
+var TEMPLATES_DIR = path.join(PACKAGE_ROOT, "templates");
+async function install(targetPath, options = {}) {
+  const resolvedPath = path.resolve(targetPath);
+  console.log(`Installing CCKB to: ${resolvedPath}`);
+  await validateTargetPath(resolvedPath);
+  await checkExistingInstallation(resolvedPath, options.force);
+  await createDirectoryStructure(resolvedPath);
+  await copyTemplateFiles(resolvedPath);
+  await createConfigFile(resolvedPath);
+  await installHooks(resolvedPath);
+  await updateClaudeMd(resolvedPath);
+  await updateGitignore(resolvedPath);
+  console.log("\nCCKB installed successfully!");
+  console.log("\nNext steps:");
+  console.log("  1. Review cc-knowledge-base/vault/ structure");
+  console.log("  2. Check .claude/settings.json for hook configuration");
+  console.log("  3. Start a new Claude Code session to begin capturing knowledge");
+}
+async function validateTargetPath(targetPath) {
+  const exists = await fileExists(targetPath);
+  if (!exists) {
+    throw new Error(`Target path does not exist: ${targetPath}`);
+  }
+  const stats = await fs.stat(targetPath);
+  if (!stats.isDirectory()) {
+    throw new Error(`Target path is not a directory: ${targetPath}`);
+  }
+}
+async function checkExistingInstallation(targetPath, force) {
+  const kbPath = path.join(targetPath, "cc-knowledge-base");
+  const exists = await fileExists(kbPath);
+  if (exists && !force) {
+    throw new Error(
+      "CCKB is already installed in this project. Use --force to reinstall."
+    );
+  }
+}
+async function createDirectoryStructure(targetPath) {
+  const directories = [
+    "cc-knowledge-base",
+    "cc-knowledge-base/conversations",
+    "cc-knowledge-base/vault",
+    "cc-knowledge-base/vault/entities",
+    "cc-knowledge-base/.cckb-state"
+  ];
+  for (const dir of directories) {
+    await ensureDir(path.join(targetPath, dir));
+  }
+  console.log("  Created directory structure");
+}
+async function copyTemplateFiles(targetPath) {
+  const vaultFiles = [
+    { src: "vault/INDEX.md", dest: "cc-knowledge-base/vault/INDEX.md" },
+    {
+      src: "vault/architecture.md",
+      dest: "cc-knowledge-base/vault/architecture.md"
+    },
+    {
+      src: "vault/general-knowledge.md",
+      dest: "cc-knowledge-base/vault/general-knowledge.md"
+    },
+    {
+      src: "vault/entities/INDEX.md",
+      dest: "cc-knowledge-base/vault/entities/INDEX.md"
+    }
+  ];
+  for (const file of vaultFiles) {
+    const srcPath = path.join(TEMPLATES_DIR, file.src);
+    const destPath = path.join(targetPath, file.dest);
+    const content = await readTextFile(srcPath);
+    if (content) {
+      await writeTextFile(destPath, content);
+    }
+  }
+  await writeTextFile(
+    path.join(targetPath, "cc-knowledge-base/conversations/.gitkeep"),
+    ""
+  );
+  console.log("  Copied vault template files");
+}
+async function createConfigFile(targetPath) {
+  const configPath = path.join(
+    targetPath,
+    "cc-knowledge-base",
+    ".cckb-config.json"
+  );
+  await writeJSON(configPath, DEFAULT_CONFIG);
+  console.log("  Created configuration file");
+}
+async function installHooks(targetPath) {
+  const claudeDir = path.join(targetPath, ".claude");
+  const settingsPath = path.join(claudeDir, "settings.json");
+  await ensureDir(claudeDir);
+  let settings = await readJSON(settingsPath) || {};
+  const templatePath = path.join(TEMPLATES_DIR, "settings.json.tmpl");
+  const hookSettings = await readJSON(
+    templatePath
+  );
+  if (!hookSettings) {
+    throw new Error("Failed to load hook template");
+  }
+  const existingHooks = settings.hooks || {};
+  const newHooks = hookSettings.hooks;
+  settings.hooks = mergeHooks(existingHooks, newHooks);
+  await writeJSON(settingsPath, settings);
+  console.log("  Installed hook configuration");
+}
+function mergeHooks(existing, incoming) {
+  const merged = { ...existing };
+  for (const [hookType, hooks] of Object.entries(incoming)) {
+    if (!merged[hookType]) {
+      merged[hookType] = [];
+    }
+    for (const hook of hooks) {
+      const hookObj = hook;
+      const command = hookObj.command;
+      if (command?.includes("cckb")) {
+        merged[hookType] = merged[hookType].filter((h) => {
+          const existingCmd = h.command;
+          return !existingCmd?.includes("cckb");
+        });
+      }
+      merged[hookType].push(hook);
+    }
+  }
+  return merged;
+}
+async function updateClaudeMd(targetPath) {
+  const claudeMdPath = path.join(targetPath, "CLAUDE.md");
+  const templatePath = path.join(TEMPLATES_DIR, "CLAUDE.md.tmpl");
+  const template = await readTextFile(templatePath);
+  if (!template) {
+    throw new Error("Failed to load CLAUDE.md template");
+  }
+  const marker = "## Project Knowledge Base (CCKB)";
+  let existing = await readTextFile(claudeMdPath);
+  if (existing) {
+    if (existing.includes(marker)) {
+      const regex = /## Project Knowledge Base \(CCKB\)[\s\S]*?(?=\n## |$)/;
+      existing = existing.replace(regex, template.trim());
+    } else {
+      existing = existing.trimEnd() + "\n\n" + template;
+    }
+    await writeTextFile(claudeMdPath, existing);
+  } else {
+    await writeTextFile(claudeMdPath, template);
+  }
+  console.log("  Updated CLAUDE.md with vault directives");
+}
+async function updateGitignore(targetPath) {
+  const gitignorePath = path.join(targetPath, ".gitignore");
+  const entries = [
+    "",
+    "# CCKB state files",
+    "cc-knowledge-base/.cckb-state/"
+  ];
+  let existing = await readTextFile(gitignorePath) || "";
+  if (existing.includes("cc-knowledge-base/.cckb-state/")) {
+    return;
+  }
+  existing = existing.trimEnd() + "\n" + entries.join("\n") + "\n";
+  await writeTextFile(gitignorePath, existing);
+  console.log("  Updated .gitignore");
+}
+
+export {
+  install
+};
+//# sourceMappingURL=chunk-GUB5D6EN.js.map

package/dist/chunk-GUB5D6EN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/install.ts"],"sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as fsSync from \"node:fs\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  ensureDir,\n  fileExists,\n  readJSON,\n  writeJSON,\n  readTextFile,\n  writeTextFile,\n} from \"../utils/file-utils.js\";\nimport { DEFAULT_CONFIG } from \"../utils/config.js\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n// Find package root by looking for package.json\nfunction findPackageRoot(): string {\n  let dir = __dirname;\n  for (let i = 0; i < 5; i++) {\n    const packageJson = path.join(dir, \"package.json\");\n    if (fsSync.existsSync(packageJson)) {\n      return dir;\n    }\n    dir = path.dirname(dir);\n  }\n  // Fallback to relative from __dirname\n  return path.resolve(__dirname, \"../..\");\n}\n\nconst PACKAGE_ROOT = findPackageRoot();\nconst TEMPLATES_DIR = path.join(PACKAGE_ROOT, \"templates\");\n\nexport interface InstallOptions {\n  force?: boolean;\n}\n\nexport async function install(\n  targetPath: string,\n  options: InstallOptions = {}\n): Promise<void> {\n  const resolvedPath = path.resolve(targetPath);\n\n  console.log(`Installing CCKB to: ${resolvedPath}`);\n\n  // Pre-flight checks\n  await validateTargetPath(resolvedPath);\n  await checkExistingInstallation(resolvedPath, options.force);\n\n  // Create directory structure\n  await createDirectoryStructure(resolvedPath);\n\n  // Copy template files\n  await copyTemplateFiles(resolvedPath);\n\n  // Create config file\n  await createConfigFile(resolvedPath);\n\n  // Install hooks configuration\n  await installHooks(resolvedPath);\n\n  // Update CLAUDE.md\n  await updateClaudeMd(resolvedPath);\n\n  // Update .gitignore\n  await updateGitignore(resolvedPath);\n\n  console.log(\"\\nCCKB installed successfully!\");\n  console.log(\"\\nNext steps:\");\n  console.log(\"  1. Review cc-knowledge-base/vault/ structure\");\n  console.log(\"  2. Check .claude/settings.json for hook configuration\");\n  console.log(\"  3. Start a new Claude Code session to begin capturing knowledge\");\n}\n\nasync function validateTargetPath(targetPath: string): Promise<void> {\n  const exists = await fileExists(targetPath);\n  if (!exists) {\n    throw new Error(`Target path does not exist: ${targetPath}`);\n  }\n\n  const stats = await fs.stat(targetPath);\n  if (!stats.isDirectory()) {\n    throw new Error(`Target path is not a directory: ${targetPath}`);\n  }\n}\n\nasync function checkExistingInstallation(\n  targetPath: string,\n  force?: boolean\n): Promise<void> {\n  const kbPath = path.join(targetPath, \"cc-knowledge-base\");\n  const exists = await fileExists(kbPath);\n\n  if (exists && !force) {\n    throw new Error(\n      \"CCKB is already installed in this project. Use --force to reinstall.\"\n    );\n  }\n}\n\nasync function createDirectoryStructure(targetPath: string): Promise<void> {\n  const directories = [\n    \"cc-knowledge-base\",\n    \"cc-knowledge-base/conversations\",\n    \"cc-knowledge-base/vault\",\n    \"cc-knowledge-base/vault/entities\",\n    \"cc-knowledge-base/.cckb-state\",\n  ];\n\n  for (const dir of directories) {\n    await ensureDir(path.join(targetPath, dir));\n  }\n\n  console.log(\"  Created directory structure\");\n}\n\nasync function copyTemplateFiles(targetPath: string): Promise<void> {\n  const vaultFiles = [\n    { src: \"vault/INDEX.md\", dest: \"cc-knowledge-base/vault/INDEX.md\" },\n    {\n      src: \"vault/architecture.md\",\n      dest: \"cc-knowledge-base/vault/architecture.md\",\n    },\n    {\n      src: \"vault/general-knowledge.md\",\n      dest: \"cc-knowledge-base/vault/general-knowledge.md\",\n    },\n    {\n      src: \"vault/entities/INDEX.md\",\n      dest: \"cc-knowledge-base/vault/entities/INDEX.md\",\n    },\n  ];\n\n  for (const file of vaultFiles) {\n    const srcPath = path.join(TEMPLATES_DIR, file.src);\n    const destPath = path.join(targetPath, file.dest);\n\n    const content = await readTextFile(srcPath);\n    if (content) {\n      await writeTextFile(destPath, content);\n    }\n  }\n\n  // Create .gitkeep for conversations\n  await writeTextFile(\n    path.join(targetPath, \"cc-knowledge-base/conversations/.gitkeep\"),\n    \"\"\n  );\n\n  console.log(\"  Copied vault template files\");\n}\n\nasync function createConfigFile(targetPath: string): Promise<void> {\n  const configPath = path.join(\n    targetPath,\n    \"cc-knowledge-base\",\n    \".cckb-config.json\"\n  );\n\n  await writeJSON(configPath, DEFAULT_CONFIG);\n\n  console.log(\"  Created configuration file\");\n}\n\nasync function installHooks(targetPath: string): Promise<void> {\n  const claudeDir = path.join(targetPath, \".claude\");\n  const settingsPath = path.join(claudeDir, \"settings.json\");\n\n  await ensureDir(claudeDir);\n\n  // Load existing settings or create new\n  let settings: Record<string, unknown> =\n    (await readJSON<Record<string, unknown>>(settingsPath)) || {};\n\n  // Load hook template\n  const templatePath = path.join(TEMPLATES_DIR, \"settings.json.tmpl\");\n  const hookSettings = await readJSON<{ hooks: Record<string, unknown> }>(\n    templatePath\n  );\n\n  if (!hookSettings) {\n    throw new Error(\"Failed to load hook template\");\n  }\n\n  // Merge hooks (CCKB hooks take precedence for its own hook types)\n  const existingHooks = (settings.hooks as Record<string, unknown[]>) || {};\n  const newHooks = hookSettings.hooks as Record<string, unknown[]>;\n\n  settings.hooks = mergeHooks(existingHooks, newHooks);\n\n  await writeJSON(settingsPath, settings);\n\n  console.log(\"  Installed hook configuration\");\n}\n\nfunction mergeHooks(\n  existing: Record<string, unknown[]>,\n  incoming: Record<string, unknown[]>\n): Record<string, unknown[]> {\n  const merged = { ...existing };\n\n  for (const [hookType, hooks] of Object.entries(incoming)) {\n    if (!merged[hookType]) {\n      merged[hookType] = [];\n    }\n\n    // Add incoming hooks, avoiding duplicates based on command\n    for (const hook of hooks) {\n      const hookObj = hook as Record<string, unknown>;\n      const command = hookObj.command as string | undefined;\n\n      if (command?.includes(\"cckb\")) {\n        // Remove any existing CCKB hooks for this type\n        merged[hookType] = merged[hookType].filter((h) => {\n          const existingCmd = (h as Record<string, unknown>).command as\n            | string\n            | undefined;\n          return !existingCmd?.includes(\"cckb\");\n        });\n      }\n\n      merged[hookType].push(hook);\n    }\n  }\n\n  return merged;\n}\n\nasync function updateClaudeMd(targetPath: string): Promise<void> {\n  const claudeMdPath = path.join(targetPath, \"CLAUDE.md\");\n  const templatePath = path.join(TEMPLATES_DIR, \"CLAUDE.md.tmpl\");\n\n  const template = await readTextFile(templatePath);\n  if (!template) {\n    throw new Error(\"Failed to load CLAUDE.md template\");\n  }\n\n  const marker = \"## Project Knowledge Base (CCKB)\";\n\n  let existing = await readTextFile(claudeMdPath);\n\n  if (existing) {\n    // Check if CCKB section already exists\n    if (existing.includes(marker)) {\n      // Replace existing CCKB section\n      const regex = /## Project Knowledge Base \\(CCKB\\)[\\s\\S]*?(?=\\n## |$)/;\n      existing = existing.replace(regex, template.trim());\n    } else {\n      // Append CCKB section\n      existing = existing.trimEnd() + \"\\n\\n\" + template;\n    }\n    await writeTextFile(claudeMdPath, existing);\n  } else {\n    // Create new CLAUDE.md with CCKB section\n    await writeTextFile(claudeMdPath, template);\n  }\n\n  console.log(\"  Updated CLAUDE.md with vault directives\");\n}\n\nasync function updateGitignore(targetPath: string): Promise<void> {\n  const gitignorePath = path.join(targetPath, \".gitignore\");\n\n  const entries = [\n    \"\",\n    \"# CCKB state files\",\n    \"cc-knowledge-base/.cckb-state/\",\n  ];\n\n  let existing = (await readTextFile(gitignorePath)) || \"\";\n\n  // Check if already added\n  if (existing.includes(\"cc-knowledge-base/.cckb-state/\")) {\n    return;\n  }\n\n  existing = existing.trimEnd() + \"\\n\" + entries.join(\"\\n\") + \"\\n\";\n  await writeTextFile(gitignorePath, existing);\n\n  console.log(\"  Updated .gitignore\");\n}\n"],"mappings":"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","names":[]}