@exero1/claudecontext 0.1.0

package/hooks/pre-tool-use.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * ClaudeContext PreToolUse hook.
+ * Gate check on Bash, Write, Edit, MultiEdit tool calls.
+ * Timeout: 8s.
+ */
+
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+const projectRoot = resolve(process.env.CLAUDECONTEXT_PROJECT_ROOT ?? process.cwd());
+
+function findCli() {
+  const local = join(projectRoot, 'node_modules', '.bin', 'claudecontext-cli');
+  if (existsSync(local)) return local;
+  return null;
+}
+
+// Read hook input from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => { input += chunk; });
+process.stdin.on('end', () => {
+  try {
+    const hookData = JSON.parse(input);
+    const toolName = hookData.tool_name ?? '';
+    const gatedTools = ['Bash', 'Write', 'Edit', 'MultiEdit'];
+
+    if (!gatedTools.includes(toolName)) {
+      process.exit(0);
+    }
+
+    // Extract the command/content to gate-check
+    const toolInput = hookData.tool_input ?? {};
+    let checkString = '';
+
+    if (toolName === 'Bash') {
+      checkString = toolInput.command ?? '';
+    } else if (['Write', 'Edit', 'MultiEdit'].includes(toolName)) {
+      checkString = toolInput.file_path ?? toolInput.new_string ?? '';
+    }
+
+    if (!checkString) process.exit(0);
+
+    const cli = findCli();
+    const gateRulesPath = join(projectRoot, '.claudecontext', 'gate-rules.json');
+    const gateArgs = existsSync(gateRulesPath)
+      ? ['gate-check', '--rules-file', gateRulesPath, checkString]
+      : ['gate-check', checkString];
+
+    try {
+      if (cli) {
+        execFileSync(cli, gateArgs, {
+          cwd: projectRoot,
+          env: { ...process.env, NODE_NO_WARNINGS: '1' },
+          timeout: 7000,
+          stdio: ['ignore', 'ignore', 'pipe'],
+        });
+      } else {
+        execFileSync('npx', ['claudecontext-cli', ...gateArgs], {
+          cwd: projectRoot,
+          env: { ...process.env, NODE_NO_WARNINGS: '1' },
+          timeout: 7000,
+          stdio: ['ignore', 'ignore', 'pipe'],
+        });
+      }
+      // Exit 0 = allow (also: exit 1 = warn, execFileSync throws for non-zero but warn is caught below)
+      process.exit(0);
+    } catch (err) {
+      // exit code 2 = deny
+      const code = err?.status ?? err?.code;
+      if (code === 2) {
+        // Extract the DENY: line from stderr (strip any Node.js warning noise)
+        const stderrText = String(err?.stderr ?? '');
+        const denyLine = stderrText.split('\n').find(l => l.startsWith('DENY:'));
+        const reason = denyLine ? denyLine.slice('DENY: '.length).trim() : 'destructive pattern detected';
+        process.stdout.write(JSON.stringify({ decision: 'block', reason }));
+        process.exit(0);
+      }
+      // exit 1 = warn — allow but stderr already written
+      process.exit(0);
+    }
+  } catch {
+    process.exit(0); // Fail open — don't break tool use
+  }
+});

package/hooks/session-start.mjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * ClaudeContext SessionStart hook.
+ * Fires on Claude Code startup and resume.
+ *
+ * Detects active task → hydrates context bundle → outputs additionalContext.
+ * Timeout: 15s (Claude Code default).
+ */
+
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+
+const projectRoot = resolve(process.env.CLAUDECONTEXT_PROJECT_ROOT ?? process.cwd());
+
+// Prefer installed local binary (~2x faster than npx)
+function findCli() {
+  const local = join(projectRoot, 'node_modules', '.bin', 'claudecontext-cli');
+  if (existsSync(local)) return local;
+  return null; // will fall back to npx
+}
+
+try {
+  const cli = findCli();
+  let result;
+
+  if (cli) {
+    result = execFileSync(cli, ['hydrate'], {
+      cwd: projectRoot,
+      env: { ...process.env, NODE_NO_WARNINGS: '1' },
+      timeout: 14000,
+      encoding: 'utf8',
+    });
+  } else {
+    result = execFileSync('npx', ['claudecontext-cli', 'hydrate'], {
+      cwd: projectRoot,
+      env: { ...process.env, NODE_NO_WARNINGS: '1' },
+      timeout: 14000,
+      encoding: 'utf8',
+    });
+  }
+
+  // result is JSON: { additionalContext: "..." }
+  const parsed = JSON.parse(result);
+  if (parsed.additionalContext) {
+    // Output in the format Claude Code expects for session hooks
+    process.stdout.write(JSON.stringify({ additionalContext: parsed.additionalContext }));
+  }
+} catch (err) {
+  // Fail silently — don't break Claude Code startup
+  process.stderr.write(`[claudecontext/session-start] Error: ${err?.message ?? err}\n`);
+}
+
+process.exit(0);

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@exero1/claudecontext",
+  "version": "0.1.0",
+  "description": "Persistent memory system for Claude Code — hierarchical cache levels + association graph",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "hooks",
+    "README.md"
+  ],
+  "bin": {
+    "claudecontext": "dist/installer/install.js",
+    "claudecontext-mcp": "dist/src/index.js",
+    "claudecontext-cli": "dist/src/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --experimental-test-coverage 'dist/src/**/*.test.js' 'dist/installer/**/*.test.js'",
+    "test:unit": "node --test 'dist/src/cache/*.test.js' 'dist/src/graph/*.test.js' 'dist/src/storage/*.test.js' 'dist/src/markdown/*.test.js' 'dist/src/gating/*.test.js' 'dist/src/utils/*.test.js'",
+    "test:integration": "node --test 'dist/src/integration/*.test.js'",
+    "lint": "eslint src/**/*.ts installer/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts installer/**/*.ts --fix",
+    "clean": "rm -rf dist",
+    "ci": "npm run typecheck && npm run build && npm run test:unit && npm run test:integration",
+    "build:publish": "tsc --project tsconfig.build.json",
+    "prepublishOnly": "npm run clean && npm run build:publish && npm run typecheck"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "acorn": "^8.14.1",
+    "acorn-walk": "^8.3.4",
+    "simple-git": "^3.27.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/acorn": "^4.0.6",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": ["claude", "claude-code", "mcp", "context", "memory", "ai"],
+  "license": "MIT"
+}