cc-brain 0.1.9 → 0.2.1

package/README.md

@@ -17,7 +17,7 @@
   <a href="#installation">Installation</a> -
   <a href="#how-it-works">How It Works</a> -
   <a href="#architecture">Architecture</a> -
-  <a href="#commands">Commands</a> -
+  <a href="#skills">Skills</a> -
   <a href="#cli">CLI</a>
 </p>
 
@@ -39,15 +39,15 @@ cc-brain creates a persistent memory layer that:
 
 ## Installation
 
-### npm (recommended)
+### npx (quickest)
 ```bash
-npm install -g cc-brain
-cc-brain install
+npx cc-brain install
 ```
 
-### npx (one-liner)
+### npm (global)
 ```bash
-npx cc-brain install
+npm install -g cc-brain
+cc-brain install
 ```
 
 ### bun
@@ -64,8 +64,7 @@ cc-brain install
 
 ### Upgrade
 ```bash
-npm install -g cc-brain@latest
-cc-brain install
+npx cc-brain@latest install
 ```
 
 ---
@@ -202,6 +201,7 @@ src/
   recall.js           Scored archive search with safe regex and color detection
   archive.js          Archive management (list, prune, stats)
   project-id.js       Stable project identity (.brain-id)
+  saver-prompt.md     Instructions for saving
 bin/
   cc-brain.js         CLI entry point with fast runtime detection
 hooks/
@@ -213,6 +213,7 @@ skills/
 scripts/
   install.js          Install hooks + skills to ~/.claude/
   uninstall.js        Remove hooks + skills (--purge for full removal)
+plugin.json             Plugin manifest
 ```
 
 ---

package/hooks/hooks.json

@@ -1,27 +1,27 @@
-{
-  "SessionStart": [
-    {
-      "matcher": "startup|resume|compact",
-      "hooks": [
-        {
-          "type": "command",
-          "command": "npx cc-brain load",
-          "timeout": 10,
-          "statusMessage": "Loading brain..."
-        }
-      ]
-    }
-  ],
-  "PreCompact": [
-    {
-      "hooks": [
-        {
-          "type": "agent",
-          "prompt": "Context is being compacted. Save important information using the structured saver.\n\nANALYZE this session for:\n- New user insights (T1 - rare)\n- New preferences (T1 - rare)\n- Project decisions + rationale (T2)\n- Current focus/state (T2)\n- Session summary (T3 - if significant)\n\nBUILD JSON payload:\n```json\n{\n  \"t2\": {\n    \"what\": \"Project description\",\n    \"focus\": [\"current tasks\"],\n    \"decisions\": {\"decision\": \"rationale\"}\n  },\n  \"t3\": \"Session summary if significant work done.\"\n}\n```\n\nSAVE using:\n```bash\nnpx cc-brain save --json '<payload>'\n```\n\nRules:\n- Only include tiers with new info\n- T2 updates are common, T1 updates are rare\n- Decisions need rationale\n- Keep it concise",
-          "timeout": 120,
-          "statusMessage": "Saving to brain..."
-        }
-      ]
-    }
-  ]
-}
+{
+  "SessionStart": [
+    {
+      "matcher": "startup|resume|compact",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-brain load",
+          "timeout": 10,
+          "statusMessage": "Loading brain..."
+        }
+      ]
+    }
+  ],
+  "PreCompact": [
+    {
+      "hooks": [
+        {
+          "type": "agent",
+          "prompt": "Context is being compacted. Save important information using the structured saver.\n\nANALYZE this session for:\n- New user insights (T1 - rare)\n- New preferences (T1 - rare)\n- Project decisions + rationale (T2)\n- Current focus/state (T2)\n- Session summary (T3 - if significant)\n\nBUILD JSON payload:\n```json\n{\n  \"t2\": {\n    \"what\": \"Project description\",\n    \"focus\": [\"current tasks\"],\n    \"decisions\": {\"decision\": \"rationale\"}\n  },\n  \"t3\": \"Session summary if significant work done.\"\n}\n```\n\nSAVE using:\n```bash\nnpx cc-brain save --json '<payload>'\n```\n\nRules:\n- Only include tiers with new info\n- T2 updates are common, T1 updates are rare\n- Decisions need rationale\n- Keep it concise",
+          "timeout": 120,
+          "statusMessage": "Saving to brain..."
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-brain",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "Persistent memory system for Claude Code - remembers context across sessions",
   "type": "module",
   "bin": {

package/scripts/install.js

@@ -1,136 +1,137 @@
-#!/usr/bin/env node
-
-/**
- * Install cc-brain
- * Sets up brain directory and hooks
- */
-
-import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, unlinkSync, realpathSync } from 'fs';
-import { join, dirname } from 'path';
-import { homedir } from 'os';
-import { fileURLToPath } from 'url';
-
-const HOME = homedir();
-const CLAUDE_DIR = join(HOME, '.claude');
-const BRAIN_DIR = join(CLAUDE_DIR, 'brain');
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = join(__dirname, '..');
-
-console.log('Installing cc-brain...\n');
-
-// Create brain directory structure
-const dirs = [
-  BRAIN_DIR,
-  join(BRAIN_DIR, 'projects')
-];
-
-for (const dir of dirs) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-    console.log(`Created: ${dir}`);
-  }
-}
-
-// Clean up legacy files from previous versions
-const legacyFiles = [
-  join(BRAIN_DIR, 'load-brain.sh'),
-];
-
-for (const file of legacyFiles) {
-  if (existsSync(file)) {
-    unlinkSync(file);
-    console.log(`Removed: ${file} (legacy)`);
-  }
-}
-
-// Copy template brain files if they don't exist
-const templates = ['user.md', 'preferences.md'];
-for (const file of templates) {
-  const dest = join(BRAIN_DIR, file);
-  if (!existsSync(dest)) {
-    copyFileSync(join(PROJECT_ROOT, 'brain', file), dest);
-    console.log(`Created: ${dest}`);
-  } else {
-    console.log(`Exists:  ${dest} (skipped)`);
-  }
-}
-
-// Add hooks to settings.json
-const settingsPath = join(CLAUDE_DIR, 'settings.json');
-let settings = {};
-
-if (existsSync(settingsPath)) {
-  settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-}
-
-// Read our hooks config
-const hooks = JSON.parse(readFileSync(join(PROJECT_ROOT, 'hooks', 'hooks.json'), 'utf-8'));
-
-// Resolve absolute paths — avoids PATH issues on macOS with nvm/fnm/volta
-// Hook subprocesses don't source shell profiles, so npx/node may not be on PATH
-let nodePath;
-try {
-  nodePath = realpathSync(process.execPath);
-} catch {
-  nodePath = process.execPath;
-}
-const loaderScript = join(PROJECT_ROOT, 'src', 'loader.js');
-hooks.SessionStart[0].hooks[0].command = `"${nodePath}" "${loaderScript}"`;
-
-// Merge hooks — preserve user's other hooks, replace/append ours
-function isCcBrainHook(entry) {
-  if (!entry || !entry.hooks) return false;
-  return entry.hooks.some(h =>
-    (h.command && (h.command.includes('cc-brain') || h.command.includes('loader.js'))) ||
-    (h.prompt && h.prompt.includes('structured saver'))
-  );
-}
-
-function mergeHookArray(existing, ours) {
-  if (!existing) return ours;
-  // Filter out old cc-brain hooks, then append ours
-  const filtered = existing.filter(entry => !isCcBrainHook(entry));
-  return [...filtered, ...ours];
-}
-
-settings.hooks = settings.hooks || {};
-settings.hooks.SessionStart = mergeHookArray(settings.hooks.SessionStart, hooks.SessionStart);
-settings.hooks.PreCompact = mergeHookArray(settings.hooks.PreCompact, hooks.PreCompact);
-
-writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-console.log(`\nUpdated: ${settingsPath}`);
-
-// --- Install Skills to ~/.claude/skills/ ---
-const SKILLS_DIR = join(CLAUDE_DIR, 'skills');
-const skillNames = ['save', 'recall', 'brain'];
-
-for (const name of skillNames) {
-  const skillDir = join(SKILLS_DIR, name);
-  mkdirSync(skillDir, { recursive: true });
-  copyFileSync(
-    join(PROJECT_ROOT, 'skills', `${name}.md`),
-    join(skillDir, 'SKILL.md')
-  );
-}
-
-console.log(`\nInstalled skills to: ${SKILLS_DIR}`);
-console.log('  /save, /recall, /brain');
-
-console.log(`
-cc-brain installed!
-
-Brain location: ${BRAIN_DIR}
-
-Memory tiers:
-  T1 (always):   user.md, preferences.md
-  T2 (project):  projects/{name}/context.md
-  T3 (archive):  projects/{name}/archive/
-
-Hooks installed:
-  SessionStart → loads T1 + T2 into context
-  PreCompact   → saves important bits before compaction
-
-Edit your brain:
-  ${BRAIN_DIR}/user.md
-  ${BRAIN_DIR}/preferences.md
-`);
+#!/usr/bin/env node
+
+/**
+ * Install cc-brain
+ * Sets up brain directory and hooks
+ */
+
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, unlinkSync, realpathSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const HOME = homedir();
+const CLAUDE_DIR = join(HOME, '.claude');
+const BRAIN_DIR = join(CLAUDE_DIR, 'brain');
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = join(__dirname, '..');
+
+console.log('Installing cc-brain...\n');
+
+// Create brain directory structure
+const dirs = [
+  BRAIN_DIR,
+  join(BRAIN_DIR, 'projects')
+];
+
+for (const dir of dirs) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+    console.log(`Created: ${dir}`);
+  }
+}
+
+// Clean up legacy files from previous versions
+const legacyFiles = [
+  join(BRAIN_DIR, 'load-brain.sh'),
+];
+
+for (const file of legacyFiles) {
+  if (existsSync(file)) {
+    unlinkSync(file);
+    console.log(`Removed: ${file} (legacy)`);
+  }
+}
+
+// Copy template brain files if they don't exist
+const templates = ['user.md', 'preferences.md'];
+for (const file of templates) {
+  const dest = join(BRAIN_DIR, file);
+  if (!existsSync(dest)) {
+    copyFileSync(join(PROJECT_ROOT, 'brain', file), dest);
+    console.log(`Created: ${dest}`);
+  } else {
+    console.log(`Exists:  ${dest} (skipped)`);
+  }
+}
+
+// Add hooks to settings.json
+const settingsPath = join(CLAUDE_DIR, 'settings.json');
+let settings = {};
+
+if (existsSync(settingsPath)) {
+  settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+}
+
+// Read our hooks config
+const hooks = JSON.parse(readFileSync(join(PROJECT_ROOT, 'hooks', 'hooks.json'), 'utf-8'));
+
+// Resolve absolute paths — avoids PATH issues on macOS with nvm/fnm/volta
+// Hook subprocesses don't source shell profiles, so npx/node may not be on PATH
+let nodePath;
+try {
+  nodePath = realpathSync(process.execPath);
+} catch {
+  nodePath = process.execPath;
+}
+const loaderScript = join(PROJECT_ROOT, 'src', 'loader.js');
+hooks.SessionStart[0].hooks[0].command = `"${nodePath}" "${loaderScript}"`;
+
+// Merge hooks — preserve user's other hooks, replace/append ours
+function isCcBrainHook(entry) {
+  if (!entry || !entry.hooks) return false;
+  return entry.hooks.some(h =>
+    (h.command && (h.command.includes('cc-brain') || h.command.includes('loader.js'))) ||
+    (h.prompt && h.prompt.includes('structured saver')) ||
+    (h.statusMessage && h.statusMessage.includes('brain'))
+  );
+}
+
+function mergeHookArray(existing, ours) {
+  if (!existing) return ours;
+  // Filter out old cc-brain hooks, then append ours
+  const filtered = existing.filter(entry => !isCcBrainHook(entry));
+  return [...filtered, ...ours];
+}
+
+settings.hooks = settings.hooks || {};
+settings.hooks.SessionStart = mergeHookArray(settings.hooks.SessionStart, hooks.SessionStart);
+settings.hooks.PreCompact = mergeHookArray(settings.hooks.PreCompact, hooks.PreCompact);
+
+writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+console.log(`\nUpdated: ${settingsPath}`);
+
+// --- Install Skills to ~/.claude/skills/ ---
+const SKILLS_DIR = join(CLAUDE_DIR, 'skills');
+const skillNames = ['save', 'recall', 'brain'];
+
+for (const name of skillNames) {
+  const skillDir = join(SKILLS_DIR, name);
+  mkdirSync(skillDir, { recursive: true });
+  copyFileSync(
+    join(PROJECT_ROOT, 'skills', `${name}.md`),
+    join(skillDir, 'SKILL.md')
+  );
+}
+
+console.log(`\nInstalled skills to: ${SKILLS_DIR}`);
+console.log('  /save, /recall, /brain');
+
+console.log(`
+cc-brain installed!
+
+Brain location: ${BRAIN_DIR}
+
+Memory tiers:
+  T1 (always):   user.md, preferences.md
+  T2 (project):  projects/{name}/context.md
+  T3 (archive):  projects/{name}/archive/
+
+Hooks installed:
+  SessionStart → loads T1 + T2 into context
+  PreCompact   → saves important bits before compaction
+
+Edit your brain:
+  ${BRAIN_DIR}/user.md
+  ${BRAIN_DIR}/preferences.md
+`);

package/scripts/uninstall.js

@@ -24,7 +24,8 @@ function isCcBrainHook(entry) {
   if (!entry || !entry.hooks) return false;
   return entry.hooks.some(h =>
     (h.command && (h.command.includes('cc-brain') || h.command.includes('loader.js'))) ||
-    (h.prompt && h.prompt.includes('structured saver'))
+    (h.prompt && h.prompt.includes('structured saver')) ||
+    (h.statusMessage && h.statusMessage.includes('brain'))
   );
 }