@exero1/claudecontext 0.1.0

package/dist/src/cli.js

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+/**
+ * ClaudeContext CLI — short-lived helper for hooks.
+ *
+ * Commands:
+ *   gate-check <input>             Check input against gate rules. Exit 0=allow, 1=warn, 2=deny.
+ *   ingest-diff <file> [file...]   Record file touches in DB + L0.
+ *   create-edges --type <type> --files <f1,f2,...>  Create edge(s) between files.
+ *   summarize-session              Write deterministic session summary to L4 archive.
+ *   status                         Print current context status.
+ *   graph-inspect <file>           Show all edges for a file.
+ *   hydrate                        Output additionalContext JSON for session-start hook.
+ */
+import { existsSync, readFileSync, mkdirSync } from 'node:fs';
+import { join, resolve, relative } from 'node:path';
+import { Db } from './storage/db.js';
+import { check, loadRulesFromConfig, prependRules } from './gating/gate.js';
+import { upsertBidirectionalEdge, applyDecayToAll } from './graph/edges.js';
+import { indexFileImports, indexFileSubsystem } from './graph/indexer.js';
+import { appendLog, readLastLines, patchSection, safeRead } from './markdown/writer.js';
+import { buildBundle } from './cache/manager.js';
+import { detectTask } from './detection/task.js';
+import { scoreFile } from './indexing/codebase.js';
+import { L0_MAX_LINES } from './cache/levels.js';
+import { compressL1 } from './cache/compressor.js';
+// CLAUDE_SESSION_ID is provided in hook JSON payload (not env var) in Claude Code v2+
+// so we no longer gate on it here — hooks are only invoked by Claude Code via settings.json
+const projectRoot = resolve(process.env['CLAUDECONTEXT_PROJECT_ROOT'] ?? process.cwd());
+const stateDir = join(projectRoot, '.claudecontext');
+if (!existsSync(stateDir)) {
+    mkdirSync(stateDir, { recursive: true });
+}
+const dbPath = join(stateDir, 'state.db');
+const l0LogPath = join(stateDir, 'l0.log');
+const areasPath = join(stateDir, 'areas.json');
+let areas = [];
+if (existsSync(areasPath)) {
+    try {
+        areas = JSON.parse(readFileSync(areasPath, 'utf8'));
+    }
+    catch { /* ignore */ }
+}
+const db = new Db(dbPath);
+const args = process.argv.slice(2);
+const command = args[0];
+switch (command) {
+    // ── gate-check ─────────────────────────────────────────────────────────────
+    case 'gate-check': {
+        // Extract --rules-file flag
+        const rfIdx = args.indexOf('--rules-file');
+        const rulesFile = rfIdx !== -1 ? args[rfIdx + 1] : null;
+        // Remaining args (skip command name, --rules-file flag, and its value)
+        const filteredArgs = args.filter((_, i) => i !== 0 && i !== rfIdx && i !== rfIdx + 1);
+        const input = filteredArgs.join(' ');
+        if (rulesFile) {
+            try {
+                const config = JSON.parse(readFileSync(rulesFile, 'utf8'));
+                prependRules(loadRulesFromConfig(config));
+            }
+            catch (e) {
+                process.stderr.write(`ERROR: Could not load rules from ${rulesFile}: ${e}\n`);
+                process.exit(1);
+            }
+        }
+        const result = check(input);
+        if (result.action === 'deny') {
+            process.stderr.write(`DENY: ${result.reason}\n`);
+            process.exit(2);
+        }
+        if (result.action === 'warn') {
+            process.stderr.write(`WARN: ${result.reason}\n`);
+            process.exit(1);
+        }
+        process.exit(0);
+        break;
+    }
+    // ── ingest-diff ────────────────────────────────────────────────────────────
+    case 'ingest-diff': {
+        const files = args.slice(1).map(f => f.startsWith('/') ? f : join(projectRoot, f));
+        if (files.length === 0) {
+            process.stderr.write('Usage: ingest-diff <file1> [file2...]\n');
+            process.exit(1);
+        }
+        const timestamp = new Date().toISOString();
+        for (const file of files) {
+            db.touchFile(file);
+            const fi = db.getFile(file);
+            const score = scoreFile(fi?.last_touched ?? Date.now(), fi?.touch_count ?? 1, false);
+            db.updateRelevanceScore(file, score);
+            indexFileImports(db, file, projectRoot);
+            indexFileSubsystem(db, file, areas, projectRoot);
+            appendLog(l0LogPath, `[${timestamp}] WRITE ${file} (touch_count=${fi?.touch_count ?? 1})`, L0_MAX_LINES);
+        }
+        // Create co_modified edges:
+        // 1. Between all pairs within this batch (if multiple files passed at once)
+        // 2. Between each new file and other files touched recently (same session window = 30 min)
+        db.runInTransaction(() => {
+            for (const file of files) {
+                // Batch pairs
+                for (const other of files) {
+                    if (other !== file) {
+                        upsertBidirectionalEdge(db, {
+                            fromNode: file, fromType: 'file',
+                            toNode: other, toType: 'file',
+                            edgeType: 'co_modified',
+                        });
+                    }
+                }
+                // Cross-session pairs: this file ↔ other recently-touched files
+                const recentFiles = db.getRecentlyTouchedFiles(30 * 60 * 1000, file);
+                for (const recent of recentFiles) {
+                    upsertBidirectionalEdge(db, {
+                        fromNode: file, fromType: 'file',
+                        toNode: recent, toType: 'file',
+                        edgeType: 'co_modified',
+                    });
+                }
+            }
+        });
+        // Auto-update L1 "Files touched" — so it stays current without user discipline
+        try {
+            const info = await detectTask(projectRoot);
+            const taskFilePath = join(projectRoot, 'tasks', `${info.id}.md`);
+            const taskContent = safeRead(taskFilePath);
+            // Bug 4: ensure task exists in DB so context_status shows Tasks > 0
+            db.ensureTask(info.id, info.id);
+            if (taskContent) {
+                // Normalize all paths to relative so absolute and relative forms don't duplicate
+                const toRel = (p) => p.startsWith('/') ? relative(projectRoot, p) : p;
+                const existing = new Set(taskContent.split('\n')
+                    .filter(l => l.startsWith('- '))
+                    .map(l => toRel(l.slice(2).trim())));
+                const toAdd = files.map(toRel).filter(f => !existing.has(f));
+                if (toAdd.length > 0) {
+                    const allFiles = [...existing, ...toAdd];
+                    patchSection(taskFilePath, 'Files touched', allFiles.map(f => `- ${f}`).join('\n'));
+                }
+            }
+        }
+        catch {
+            // Non-fatal — best-effort L1 update
+        }
+        db.close();
+        process.exit(0);
+        break;
+    }
+    // ── create-edges ───────────────────────────────────────────────────────────
+    case 'create-edges': {
+        const typeIdx = args.indexOf('--type');
+        const filesIdx = args.indexOf('--files');
+        if (typeIdx === -1 || filesIdx === -1) {
+            process.stderr.write('Usage: create-edges --type <type> --files <f1,f2,...>\n');
+            process.exit(1);
+        }
+        const edgeType = args[typeIdx + 1];
+        const fileList = (args[filesIdx + 1] ?? '').split(',').filter(Boolean);
+        if (!edgeType || fileList.length < 2) {
+            process.stderr.write('Need --type and at least 2 --files\n');
+            process.exit(1);
+        }
+        for (let i = 0; i < fileList.length; i++) {
+            for (let j = i + 1; j < fileList.length; j++) {
+                const f1 = fileList[i];
+                const f2 = fileList[j];
+                if (f1 && f2) {
+                    upsertBidirectionalEdge(db, {
+                        fromNode: f1, fromType: 'file',
+                        toNode: f2, toType: 'file',
+                        edgeType,
+                    });
+                }
+            }
+        }
+        db.close();
+        process.exit(0);
+        break;
+    }
+    // ── summarize-session ──────────────────────────────────────────────────────
+    case 'summarize-session': {
+        const info = await detectTask(projectRoot);
+        const l0Lines = readLastLines(l0LogPath, 200);
+        const writes = l0Lines.filter(l => / WRITE /.test(l));
+        const notes = l0Lines.filter(l => / NOTE /.test(l) || / DECISION /.test(l) || / OBSERVATION /.test(l));
+        const errors = l0Lines.filter(l => / ERROR /.test(l));
+        const tests = l0Lines.filter(l => / TEST /.test(l));
+        const lastTest = tests[tests.length - 1] ?? '';
+        const summary = [
+            `Session on branch ${info.branch}`,
+            `Files touched: ${writes.length}`,
+            notes.length > 0 ? `Notes: ${notes.length}` : '',
+            tests.length > 0 ? `Tests: ${lastTest.replace(/.*TEST /, '')}` : '',
+            errors.length > 0 ? `Errors: ${errors.length}` : '',
+        ].filter(Boolean).join('. ');
+        const archiveId = `${info.id}-${Date.now()}`;
+        db.insertArchive({
+            id: archiveId,
+            task_id: info.id,
+            summary,
+            created_at: Date.now(),
+            source_level: 'L4',
+        });
+        // Compress L1 task file (trim Files touched + archive old decisions)
+        const taskFilePath = join(projectRoot, 'tasks', `${info.id}.md`);
+        const compressResult = compressL1(taskFilePath, db);
+        if (compressResult.filesCompressed > 0 || compressResult.decisionsArchived > 0) {
+            appendLog(l0LogPath, `[${new Date().toISOString()}] L1 COMPRESS files=${compressResult.filesCompressed} decisions=${compressResult.decisionsArchived}`);
+        }
+        // Apply lazy weight decay + prune stale edges on each pre-compact sweep
+        const decayResult = applyDecayToAll(db);
+        appendLog(l0LogPath, `[${new Date().toISOString()}] SESSION SUMMARY written to archive: ${archiveId} | decay: ${decayResult.updated} edges updated, ${decayResult.pruned} pruned`);
+        db.close();
+        process.exit(0);
+        break;
+    }
+    // ── status ─────────────────────────────────────────────────────────────────
+    case 'status': {
+        const info = await detectTask(projectRoot);
+        const stats = db.getStats();
+        const edgeCounts = db.countEdgesByType();
+        const edgeStr = Object.entries(edgeCounts).map(([t, c]) => `${t}=${c}`).join(' ');
+        process.stdout.write([
+            `Active task: ${info.id} (branch: ${info.branch})`,
+            `Files indexed: ${stats.fileCount} | Tasks: ${stats.taskCount} | Archive: ${stats.archiveCount}`,
+            `Edges: ${edgeStr || 'none'}`,
+        ].join('\n') + '\n');
+        db.close();
+        process.exit(0);
+        break;
+    }
+    // ── graph-inspect ──────────────────────────────────────────────────────────
+    case 'graph-inspect': {
+        const fileArg = args[1];
+        if (!fileArg) {
+            process.stderr.write('Usage: graph-inspect <file>\n');
+            process.exit(1);
+        }
+        // Resolve relative paths against projectRoot so both forms work
+        const file = fileArg.startsWith('/') ? fileArg : join(projectRoot, fileArg);
+        const outgoing = db.getEdgesFrom(file, 50);
+        const incoming = db.getEdgesTo(file, 50);
+        process.stdout.write(`\nEdges for: ${file}\n`);
+        process.stdout.write(`\nOutgoing (${outgoing.length}):\n`);
+        for (const e of outgoing) {
+            process.stdout.write(`  → ${e.to_node} [${e.edge_type}] weight=${e.weight.toFixed(3)} sessions=${e.session_count}\n`);
+        }
+        process.stdout.write(`\nIncoming (${incoming.length}):\n`);
+        for (const e of incoming) {
+            process.stdout.write(`  ← ${e.from_node} [${e.edge_type}] weight=${e.weight.toFixed(3)} sessions=${e.session_count}\n`);
+        }
+        db.close();
+        process.exit(0);
+        break;
+    }
+    // ── hydrate ────────────────────────────────────────────────────────────────
+    case 'hydrate': {
+        const info = await detectTask(projectRoot);
+        const bundle = buildBundle(db, {
+            projectRoot,
+            stateDir,
+            taskId: info.id,
+            taskBranch: info.branch,
+            areas,
+            depth: 1,
+        });
+        // Output additionalContext JSON for session-start hook
+        const output = JSON.stringify({ additionalContext: bundle.markdown });
+        process.stdout.write(output + '\n');
+        db.close();
+        process.exit(0);
+        break;
+    }
+    default: {
+        process.stderr.write(`Unknown command: ${command ?? '(none)'}\n`);
+        process.stderr.write('Commands: gate-check, ingest-diff, create-edges, summarize-session, status, graph-inspect, hydrate\n');
+        db.close();
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/detection/areas.d.ts

@@ -0,0 +1,13 @@
+import type { AreaDef } from '../graph/indexer.js';
+/**
+ * Detect subsystem areas by scanning the project source tree.
+ *
+ * Strategy: for each of src/, lib/, app/ (first one that has results), scan
+ * immediate subdirectories. Any subdirectory with ≥3 source files becomes
+ * a candidate area with glob `<root>/<dir>/**`.
+ *
+ * @param projectRoot - absolute path to project root
+ * @param files       - optional pre-collected relative file list (drives detection without filesystem access, for testing)
+ */
+export declare function detectAreas(projectRoot: string, files?: string[]): AreaDef[];
+//# sourceMappingURL=areas.d.ts.map

package/dist/src/detection/areas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"areas.d.ts","sourceRoot":"","sources":["../../../src/detection/areas.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAkE5E"}

package/dist/src/detection/areas.js

@@ -0,0 +1,96 @@
+/**
+ * Auto-detect subsystem areas from directory structure.
+ *
+ * Scans top-level source directories (src/, lib/, app/) and proposes an AreaDef
+ * for each subdirectory that contains ≥3 source files.
+ */
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { collectSourceFiles } from '../graph/indexer.js';
+const SOURCE_ROOTS = ['src', 'lib', 'app'];
+const SKIP_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '.next', '.nuxt',
+    'coverage', '.cache', '__pycache__', '.claudecontext',
+    '__tests__', 'test', 'tests', 'spec', 'specs',
+]);
+const MIN_FILES = 3;
+/**
+ * Detect subsystem areas by scanning the project source tree.
+ *
+ * Strategy: for each of src/, lib/, app/ (first one that has results), scan
+ * immediate subdirectories. Any subdirectory with ≥3 source files becomes
+ * a candidate area with glob `<root>/<dir>/**`.
+ *
+ * @param projectRoot - absolute path to project root
+ * @param files       - optional pre-collected relative file list (drives detection without filesystem access, for testing)
+ */
+export function detectAreas(projectRoot, files) {
+    const areas = [];
+    for (const root of SOURCE_ROOTS) {
+        if (files !== undefined) {
+            // Derive subdirectory names from the provided file list — no filesystem access.
+            // Only count files that are in a subdirectory (rest contains '/').
+            const subdirFileCounts = new Map();
+            for (const f of files) {
+                if (!f.startsWith(`${root}/`))
+                    continue;
+                const rest = f.slice(root.length + 1);
+                if (!rest.includes('/'))
+                    continue; // flat file at root level
+                const subdir = rest.split('/')[0];
+                if (SKIP_DIRS.has(subdir))
+                    continue;
+                subdirFileCounts.set(subdir, (subdirFileCounts.get(subdir) ?? 0) + 1);
+            }
+            for (const [subdir, count] of subdirFileCounts) {
+                if (count >= MIN_FILES) {
+                    areas.push({
+                        name: subdir,
+                        globs: [`${root}/${subdir}/**`],
+                        docPath: `docs/context/${subdir}.md`,
+                    });
+                }
+            }
+        }
+        else {
+            // Scan filesystem
+            const rootPath = join(projectRoot, root);
+            if (!existsSync(rootPath))
+                continue;
+            let entries;
+            try {
+                entries = readdirSync(rootPath);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (SKIP_DIRS.has(entry))
+                    continue;
+                const fullPath = join(rootPath, entry);
+                let stat;
+                try {
+                    stat = statSync(fullPath);
+                }
+                catch {
+                    continue;
+                }
+                if (!stat.isDirectory())
+                    continue;
+                const dirFiles = collectSourceFiles(fullPath, projectRoot);
+                if (dirFiles.length >= MIN_FILES) {
+                    areas.push({
+                        name: entry,
+                        globs: [`${root}/${entry}/**`],
+                        docPath: `docs/context/${entry}.md`,
+                    });
+                }
+            }
+        }
+        // Stop at the first source root that yields results
+        if (areas.length > 0)
+            break;
+    }
+    return areas;
+}
+//# sourceMappingURL=areas.js.map

package/dist/src/detection/areas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"areas.js","sourceRoot":"","sources":["../../../src/detection/areas.ts"],"names":[],"mappings":"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"}

package/dist/src/detection/task.d.ts

@@ -0,0 +1,28 @@
+export interface TaskInfo {
+    id: string;
+    branch: string;
+    isGit: boolean;
+}
+/**
+ * Convert a git branch name to a filesystem-safe slug.
+ * e.g. "feature/add-auth" → "feature-add-auth"
+ */
+export declare function branchToSlug(branch: string): string;
+/**
+ * Detect the active task from the git branch.
+ * Falls back to 'default' for non-git repos or detached HEAD.
+ */
+export declare function detectTask(projectRoot: string): Promise<TaskInfo>;
+/**
+ * Get the path to a task's markdown file.
+ */
+export declare function taskFilePath(projectRoot: string, taskId: string): string;
+/**
+ * Check if a task file exists.
+ */
+export declare function taskFileExists(projectRoot: string, taskId: string): boolean;
+/**
+ * Generate default task file content for a new task.
+ */
+export declare function defaultTaskContent(taskId: string, branch: string): string;
+//# sourceMappingURL=task.d.ts.map

package/dist/src/detection/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/detection/task.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoBvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsBzE"}

package/dist/src/detection/task.js

@@ -0,0 +1,77 @@
+import { simpleGit } from 'simple-git';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Convert a git branch name to a filesystem-safe slug.
+ * e.g. "feature/add-auth" → "feature-add-auth"
+ */
+export function branchToSlug(branch) {
+    return branch
+        .replace(/\//g, '-')
+        .replace(/[^a-zA-Z0-9-_]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Detect the active task from the git branch.
+ * Falls back to 'default' for non-git repos or detached HEAD.
+ */
+export async function detectTask(projectRoot) {
+    try {
+        const git = simpleGit(projectRoot);
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo)
+            return { id: 'default', branch: 'default', isGit: false };
+        const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        const trimmed = branch.trim();
+        // Detached HEAD
+        if (trimmed === 'HEAD' || trimmed === '') {
+            const sha = await git.revparse(['HEAD']);
+            const shortSha = sha.trim().slice(0, 7);
+            return { id: `detached-${shortSha}`, branch: `HEAD@${shortSha}`, isGit: true };
+        }
+        return { id: branchToSlug(trimmed), branch: trimmed, isGit: true };
+    }
+    catch {
+        return { id: 'default', branch: 'default', isGit: false };
+    }
+}
+/**
+ * Get the path to a task's markdown file.
+ */
+export function taskFilePath(projectRoot, taskId) {
+    return join(projectRoot, 'tasks', `${taskId}.md`);
+}
+/**
+ * Check if a task file exists.
+ */
+export function taskFileExists(projectRoot, taskId) {
+    return existsSync(taskFilePath(projectRoot, taskId));
+}
+/**
+ * Generate default task file content for a new task.
+ */
+export function defaultTaskContent(taskId, branch) {
+    const now = new Date().toISOString();
+    return `# Task: ${taskId}
+**Branch:** ${branch}
+**Created:** ${now}
+**Status:** active
+
+## Goal
+[Describe what you're trying to accomplish in this session]
+
+## Files touched
+[Files modified in this task]
+
+## Open questions
+[Questions or uncertainties to resolve]
+
+## Decisions
+[Key decisions made during this task]
+
+## Notes
+[Anything else worth remembering]
+`;
+}
+//# sourceMappingURL=task.js.map

package/dist/src/detection/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/detection/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM;SACV,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9B,gBAAgB;QAChB,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACxC,OAAO,EAAE,EAAE,EAAE,YAAY,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC5D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,MAAc;IAC9D,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,MAAc;IAChE,OAAO,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAc;IAC/D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,WAAW,MAAM;cACZ,MAAM;eACL,GAAG;;;;;;;;;;;;;;;;;CAiBjB,CAAC;AACF,CAAC"}

package/dist/src/gating/gate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Gate engine — synchronous regex-rule-based allow/deny/warn decisions.
+ * Target: <5ms per check. No async, no I/O.
+ */
+export type GateAction = 'allow' | 'warn' | 'deny';
+export interface GateRule {
+    action: GateAction;
+    pattern: RegExp;
+    reason: string;
+}
+export interface GateResult {
+    action: GateAction;
+    reason: string;
+    matched: boolean;
+}
+/**
+ * Replace the active rule set (e.g., loaded from areas.json config).
+ */
+export declare function setRules(newRules: GateRule[]): void;
+/**
+ * Add rules at the front (highest priority).
+ */
+export declare function prependRules(newRules: GateRule[]): void;
+/**
+ * Evaluate a command/content string against the active rules.
+ * Returns the first matching rule's action and reason.
+ */
+export declare function check(input: string): GateResult;
+/**
+ * Load gate rules from a JSON config (subset of areas.json).
+ * Expected format: Array of { action, pattern, reason }
+ */
+export declare function loadRulesFromConfig(config: Array<{
+    action: string;
+    pattern: string;
+    reason: string;
+}>): GateRule[];
+//# sourceMappingURL=gate.d.ts.map

package/dist/src/gating/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/gating/gate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAwCD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAO/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,QAAQ,EAAE,CAMlH"}

package/dist/src/gating/gate.js

@@ -0,0 +1,74 @@
+/**
+ * Gate engine — synchronous regex-rule-based allow/deny/warn decisions.
+ * Target: <5ms per check. No async, no I/O.
+ */
+/**
+ * Default rules. Rules are evaluated in order; first match wins.
+ * deny > warn > allow (by convention, deny rules come first).
+ *
+ * NOTE: These are best-effort safeguards against obvious mistakes, not a
+ * complete security boundary. Determined users or malicious prompts can
+ * always bypass regex patterns. Project teams should tune rules via
+ * areas.json to match their own risk tolerance.
+ */
+const DEFAULT_RULES = [
+    // Hard denies — destructive/irreversible system operations
+    { action: 'deny', pattern: /rm\s+-rf\s+\//, reason: 'Refuses to delete root filesystem' },
+    { action: 'deny', pattern: /rm\s+-rf\s+\*/, reason: 'Refuses to delete everything in current directory' },
+    { action: 'deny', pattern: />\s*\/etc\//, reason: 'Refuses to overwrite system config files' },
+    { action: 'deny', pattern: /^\/etc\//, reason: 'Refuses to write system config files' },
+    { action: 'deny', pattern: /dd\s+if=.*of=\/dev\//, reason: 'Refuses raw disk writes' },
+    { action: 'deny', pattern: /mkfs\./, reason: 'Refuses filesystem formatting' },
+    // Fork bomb: classic form and common variants (f(){ f|f& }; f or :(){ :|:& };:)
+    { action: 'deny', pattern: /\w+\s*\(\s*\)\s*\{[^}]*\|\s*\w+\s*&/, reason: 'Fork bomb pattern detected' },
+    // Warn — potentially destructive, require user attention
+    { action: 'warn', pattern: /rm\s+-rf/, reason: 'Recursive deletion — confirm this is intentional' },
+    { action: 'warn', pattern: /git\s+reset\s+--hard/, reason: 'Hard reset will discard uncommitted changes' },
+    { action: 'warn', pattern: /git\s+push\s+.*--force/, reason: 'Force push can overwrite remote history' },
+    { action: 'warn', pattern: /DROP\s+TABLE/i, reason: 'SQL DROP TABLE detected' },
+    { action: 'warn', pattern: /DROP\s+DATABASE/i, reason: 'SQL DROP DATABASE detected' },
+    { action: 'warn', pattern: /TRUNCATE\s+TABLE/i, reason: 'SQL TRUNCATE detected' },
+    { action: 'warn', pattern: /chmod\s+777/, reason: 'chmod 777 creates world-writable files' },
+    { action: 'warn', pattern: /sudo\s+rm/, reason: 'Privileged deletion detected' },
+    { action: 'warn', pattern: /\beval\s+["'`$]/, reason: 'eval with dynamic input — confirm this is intentional' },
+    { action: 'warn', pattern: /\bexec\s+[^(]/, reason: 'exec replaces current process — confirm this is intentional' },
+    // Allow everything else
+    { action: 'allow', pattern: /.*/, reason: 'No gate rules matched' },
+];
+let rules = [...DEFAULT_RULES];
+/**
+ * Replace the active rule set (e.g., loaded from areas.json config).
+ */
+export function setRules(newRules) {
+    rules = newRules;
+}
+/**
+ * Add rules at the front (highest priority).
+ */
+export function prependRules(newRules) {
+    rules = [...newRules, ...rules];
+}
+/**
+ * Evaluate a command/content string against the active rules.
+ * Returns the first matching rule's action and reason.
+ */
+export function check(input) {
+    for (const rule of rules) {
+        if (rule.pattern.test(input)) {
+            return { action: rule.action, reason: rule.reason, matched: true };
+        }
+    }
+    return { action: 'allow', reason: 'No rules matched', matched: false };
+}
+/**
+ * Load gate rules from a JSON config (subset of areas.json).
+ * Expected format: Array of { action, pattern, reason }
+ */
+export function loadRulesFromConfig(config) {
+    return config.map(r => ({
+        action: r.action,
+        pattern: new RegExp(r.pattern),
+        reason: r.reason,
+    }));
+}
+//# sourceMappingURL=gate.js.map