@jeanzorzetti/context-keeper 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,eAAe,CAAC"}

package/dist/cli.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const index_js_1 = require("./index.js");
+const extractor_js_1 = require("./extractor.js");
+const merger_js_1 = require("./merger.js");
+const [, , command, ...args] = process.argv;
+async function main() {
+    switch (command) {
+        case 'start': {
+            const autoCommit = args.includes('--auto-commit');
+            console.log('[cli] Starting Context Keeper daemon...');
+            const stop = (0, index_js_1.startDaemon)({ autoCommit });
+            process.on('SIGINT', () => {
+                console.log('\n[cli] Shutting down...');
+                stop();
+                process.exit(0);
+            });
+            process.on('SIGTERM', () => {
+                stop();
+                process.exit(0);
+            });
+            break;
+        }
+        case 'extract': {
+            const filePath = args[0];
+            if (!filePath) {
+                console.error('Usage: context-keeper extract <path-to-session.jsonl>');
+                process.exit(1);
+            }
+            if (!process.env.GROQ_API_KEY) {
+                console.error('GROQ_API_KEY is not set.');
+                process.exit(1);
+            }
+            console.log(`[cli] Extracting decisions from: ${filePath}`);
+            const decisions = await (0, extractor_js_1.processTranscript)(filePath);
+            if (decisions.length === 0) {
+                console.log('[cli] No architectural decisions found.');
+                return;
+            }
+            console.log(`[cli] Found ${decisions.length} decision(s):`);
+            decisions.forEach((d, i) => console.log(`  ${i + 1}. ${d}`));
+            const projectDir = (0, merger_js_1.resolveProjectDir)(filePath);
+            if (projectDir) {
+                const contextFiles = (0, merger_js_1.findContextFiles)(projectDir);
+                for (const cf of contextFiles) {
+                    (0, merger_js_1.mergeDecisions)(cf, decisions);
+                    console.log(`[cli] Updated ${cf}`);
+                }
+            }
+            else {
+                console.warn('[cli] Could not resolve project dir — skipping file update.');
+            }
+            break;
+        }
+        case 'status': {
+            console.log('[cli] Context Keeper status: daemon not running in this process.');
+            console.log('[cli] Use `context-keeper start` to launch the daemon.');
+            break;
+        }
+        default: {
+            console.log(`Context Keeper v0.1.0
+
+Usage:
+  context-keeper start [--auto-commit]   Start the daemon
+  context-keeper extract <path>          Manually extract decisions from a session
+  context-keeper status                  Show daemon status
+`);
+        }
+    }
+}
+main().catch((err) => {
+    console.error('[cli] Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/extractor.d.ts

@@ -0,0 +1,27 @@
+export interface JsonlMessage {
+    role: string;
+    content: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+    timestamp?: string;
+}
+/**
+ * Reads a .jsonl file and returns its messages.
+ */
+export declare function readTranscript(filePath: string): JsonlMessage[];
+/**
+ * Converts messages array to a plain-text transcript, capped at MAX_CHARS.
+ * Prioritises recent messages (sliding window from the end).
+ */
+export declare function formatTranscript(messages: JsonlMessage[]): string;
+/**
+ * Calls Groq to extract architectural decisions from a transcript.
+ * Returns an array of decision strings (may be empty).
+ */
+export declare function extractDecisions(transcript: string): Promise<string[]>;
+/**
+ * Full pipeline: read JSONL → format → extract decisions via Groq.
+ */
+export declare function processTranscript(filePath: string): Promise<string[]>;
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../src/extractor.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAqB/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CA4BjE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA+B5E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ3E"}

package/dist/extractor.js

@@ -0,0 +1,155 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTranscript = readTranscript;
+exports.formatTranscript = formatTranscript;
+exports.extractDecisions = extractDecisions;
+exports.processTranscript = processTranscript;
+const fs = __importStar(require("fs"));
+const groq_sdk_1 = __importDefault(require("groq-sdk"));
+const MAX_TOKENS = 8000;
+const CHARS_PER_TOKEN = 4; // rough estimate
+const MAX_CHARS = MAX_TOKENS * CHARS_PER_TOKEN;
+const SYSTEM_PROMPT = `You are an architectural decision extractor. Given a coding session transcript,
+extract only concrete architectural decisions made (technology choices, patterns adopted,
+constraints identified). Output as a JSON array of strings. Each string: one decision,
+max 100 chars, past tense, format "chose X over Y because Z" or "decided to X because Y".
+Ignore questions, debugging steps, and implementation details. Max 10 decisions per session.`;
+/**
+ * Reads a .jsonl file and returns its messages.
+ */
+function readTranscript(filePath) {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    const messages = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            // Claude Code JSONL can wrap messages inside a top-level object
+            if (parsed.message) {
+                messages.push(parsed.message);
+            }
+            else if (parsed.role) {
+                messages.push(parsed);
+            }
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    return messages;
+}
+/**
+ * Converts messages array to a plain-text transcript, capped at MAX_CHARS.
+ * Prioritises recent messages (sliding window from the end).
+ */
+function formatTranscript(messages) {
+    const lines = [];
+    for (const msg of messages) {
+        const role = msg.role ?? 'unknown';
+        let text;
+        if (typeof msg.content === 'string') {
+            text = msg.content;
+        }
+        else if (Array.isArray(msg.content)) {
+            text = msg.content
+                .filter((b) => b.type === 'text' && b.text)
+                .map((b) => b.text)
+                .join('\n');
+        }
+        else {
+            text = '';
+        }
+        if (text.trim()) {
+            lines.push(`[${role}]: ${text.trim()}`);
+        }
+    }
+    const full = lines.join('\n\n');
+    if (full.length <= MAX_CHARS)
+        return full;
+    // Sliding window: take the last MAX_CHARS characters
+    return '...(truncated)\n\n' + full.slice(full.length - MAX_CHARS);
+}
+/**
+ * Calls Groq to extract architectural decisions from a transcript.
+ * Returns an array of decision strings (may be empty).
+ */
+async function extractDecisions(transcript) {
+    const groq = new groq_sdk_1.default({ apiKey: process.env.GROQ_API_KEY });
+    const completion = await groq.chat.completions.create({
+        model: 'llama-3.3-70b-versatile',
+        messages: [
+            { role: 'system', content: SYSTEM_PROMPT },
+            { role: 'user', content: `Transcript:\n\n${transcript}` },
+        ],
+        temperature: 0.1,
+        max_tokens: 1024,
+    });
+    const raw = completion.choices[0]?.message?.content ?? '[]';
+    try {
+        // Strip markdown code fences if present
+        const cleaned = raw.replace(/```(?:json)?\n?/g, '').replace(/```/g, '').trim();
+        const parsed = JSON.parse(cleaned);
+        if (Array.isArray(parsed)) {
+            return parsed
+                .filter((item) => typeof item === 'string')
+                .map((s) => s.trim())
+                .filter(Boolean)
+                .slice(0, 10);
+        }
+    }
+    catch {
+        // Groq returned something unexpected — return empty
+    }
+    return [];
+}
+/**
+ * Full pipeline: read JSONL → format → extract decisions via Groq.
+ */
+async function processTranscript(filePath) {
+    const messages = readTranscript(filePath);
+    if (messages.length === 0)
+        return [];
+    const transcript = formatTranscript(messages);
+    if (!transcript.trim())
+        return [];
+    return extractDecisions(transcript);
+}
+//# sourceMappingURL=extractor.js.map

package/dist/extractor.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Commits the given files in the repository that contains them.
+ * No-op if the files have no staged/unstaged changes or if the directory
+ * is not a git repository.
+ */
+export declare function commitContextFiles(filePaths: string[]): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB3E"}

package/dist/git.js

@@ -0,0 +1,66 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitContextFiles = commitContextFiles;
+const simple_git_1 = __importDefault(require("simple-git"));
+const path = __importStar(require("path"));
+/**
+ * Commits the given files in the repository that contains them.
+ * No-op if the files have no staged/unstaged changes or if the directory
+ * is not a git repository.
+ */
+async function commitContextFiles(filePaths) {
+    if (filePaths.length === 0)
+        return;
+    // Use the directory of the first file as the git repo root candidate
+    const repoDir = path.dirname(filePaths[0]);
+    const git = (0, simple_git_1.default)(repoDir);
+    const isRepo = await git.checkIsRepo().catch(() => false);
+    if (!isRepo)
+        return;
+    // Stage only the context files that actually changed
+    await git.add(filePaths);
+    const status = await git.status();
+    const staged = status.staged;
+    if (staged.length === 0)
+        return;
+    await git.commit('chore: update context-keeper decisions', filePaths, {
+        '--no-verify': null,
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,gDAoBC;AA5BD,4DAAmC;AACnC,2CAA6B;AAE7B;;;;GAIG;AACI,KAAK,UAAU,kBAAkB,CAAC,SAAmB;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEnC,qEAAqE;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAA,oBAAS,EAAC,OAAO,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,qDAAqD;IACrD,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEhC,MAAM,GAAG,CAAC,MAAM,CAAC,wCAAwC,EAAE,SAAS,EAAE;QACpE,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/index-writer.d.ts

@@ -0,0 +1,29 @@
+export interface DecisionEntry {
+    /** Unique ID for the decision (cuid-style, generated by daemon). */
+    id: string;
+    /** Absolute path to the project directory. */
+    projectPath: string;
+    /** Human-readable project name (basename of projectPath). */
+    projectName: string;
+    /** Basename of the source .jsonl file (session identifier). */
+    sessionId: string;
+    /** The decision text, max ~100 chars. */
+    text: string;
+    /** ISO 8601 timestamp when the decision was captured. */
+    capturedAt: string;
+}
+export interface DecisionIndex {
+    /** Schema version — bump if shape changes to allow migrations. */
+    version: 1;
+    /** All captured decisions, sorted descending by capturedAt (newest first). */
+    decisions: DecisionEntry[];
+}
+/**
+ * Appends new decisions to ~/.context-keeper/index.json.
+ * Deduplicates by (projectPath, sessionId, text) to avoid re-adding on retry.
+ * Entries are kept sorted newest-first.
+ */
+export declare function appendToIndex(projectPath: string, sessionId: string, decisions: string[]): void;
+/** Returns the path to the index file (useful for tests/CLI). */
+export declare function getIndexPath(): string;
+//# sourceMappingURL=index-writer.d.ts.map

package/dist/index-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-writer.d.ts","sourceRoot":"","sources":["../src/index-writer.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC;IACX,8EAA8E;IAC9E,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAkCD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CA8BN;AAED,iEAAiE;AACjE,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/index-writer.js

@@ -0,0 +1,105 @@
+"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 });
+exports.appendToIndex = appendToIndex;
+exports.getIndexPath = getIndexPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+// ---------------------------------------------------------------------------
+const INDEX_DIR = path.join(os.homedir(), '.context-keeper');
+const INDEX_PATH = path.join(INDEX_DIR, 'index.json');
+const SCHEMA_VERSION = 1;
+function readIndex() {
+    if (!fs.existsSync(INDEX_PATH)) {
+        return { version: 1, decisions: [] };
+    }
+    try {
+        const raw = fs.readFileSync(INDEX_PATH, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed.version || !Array.isArray(parsed.decisions)) {
+            return { version: 1, decisions: [] };
+        }
+        return parsed;
+    }
+    catch {
+        return { version: 1, decisions: [] };
+    }
+}
+function writeIndex(index) {
+    fs.mkdirSync(INDEX_DIR, { recursive: true });
+    fs.writeFileSync(INDEX_PATH, JSON.stringify(index, null, 2) + '\n', 'utf-8');
+}
+/** Simple collision-resistant ID (no external deps). */
+function generateId() {
+    return crypto.randomBytes(12).toString('base64url');
+}
+/**
+ * Appends new decisions to ~/.context-keeper/index.json.
+ * Deduplicates by (projectPath, sessionId, text) to avoid re-adding on retry.
+ * Entries are kept sorted newest-first.
+ */
+function appendToIndex(projectPath, sessionId, decisions) {
+    if (decisions.length === 0)
+        return;
+    const index = readIndex();
+    const capturedAt = new Date().toISOString();
+    const projectName = path.basename(projectPath);
+    // Build a dedup key set for existing entries in this session
+    const existingKeys = new Set(index.decisions
+        .filter((e) => e.projectPath === projectPath && e.sessionId === sessionId)
+        .map((e) => e.text));
+    const newEntries = decisions
+        .filter((text) => !existingKeys.has(text))
+        .map((text) => ({
+        id: generateId(),
+        projectPath,
+        projectName,
+        sessionId,
+        text,
+        capturedAt,
+    }));
+    if (newEntries.length === 0)
+        return;
+    index.decisions = [...newEntries, ...index.decisions];
+    index.version = 1;
+    writeIndex(index);
+}
+/** Returns the path to the index file (useful for tests/CLI). */
+function getIndexPath() {
+    return INDEX_PATH;
+}
+//# sourceMappingURL=index-writer.js.map

package/dist/index-writer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import 'dotenv/config';
+export interface DaemonOptions {
+    autoCommit?: boolean;
+}
+/**
+ * Starts the Context Keeper daemon.
+ * Returns a cleanup function to stop the watcher.
+ */
+export declare function startDaemon(options?: DaemonOptions): () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAQvB,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,IAAI,CA6DnE"}

package/dist/index.js

@@ -0,0 +1,104 @@
+"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 });
+exports.startDaemon = startDaemon;
+require("dotenv/config");
+const path = __importStar(require("path"));
+const watcher_js_1 = require("./watcher.js");
+const extractor_js_1 = require("./extractor.js");
+const merger_js_1 = require("./merger.js");
+const git_js_1 = require("./git.js");
+const index_writer_js_1 = require("./index-writer.js");
+/**
+ * Starts the Context Keeper daemon.
+ * Returns a cleanup function to stop the watcher.
+ */
+function startDaemon(options = {}) {
+    const { autoCommit = false } = options;
+    if (!process.env.GROQ_API_KEY) {
+        console.error('[daemon] GROQ_API_KEY is not set. Extraction will fail.');
+    }
+    const stop = (0, watcher_js_1.startWatcher)(async (filePath) => {
+        console.log(`[daemon] Session ended: ${filePath}`);
+        const projectDir = (0, merger_js_1.resolveProjectDir)(filePath);
+        if (!projectDir) {
+            console.warn(`[daemon] Could not resolve project dir from: ${filePath}`);
+            return;
+        }
+        let decisions;
+        try {
+            decisions = await (0, extractor_js_1.processTranscript)(filePath);
+        }
+        catch (err) {
+            console.error(`[daemon] Extraction failed for ${filePath}:`, err);
+            return;
+        }
+        if (decisions.length === 0) {
+            console.log(`[daemon] No decisions extracted from ${filePath}`);
+            return;
+        }
+        console.log(`[daemon] Extracted ${decisions.length} decision(s):`, decisions);
+        // Write to global index (~/.context-keeper/index.json) for MCP server consumption
+        const sessionId = path.basename(filePath);
+        try {
+            (0, index_writer_js_1.appendToIndex)(projectDir, sessionId, decisions);
+            console.log(`[daemon] Updated index for session ${sessionId}`);
+        }
+        catch (err) {
+            console.error('[daemon] Failed to update index:', err);
+        }
+        const contextFiles = (0, merger_js_1.findContextFiles)(projectDir);
+        for (const cf of contextFiles) {
+            try {
+                (0, merger_js_1.mergeDecisions)(cf, decisions);
+                console.log(`[daemon] Updated ${cf}`);
+            }
+            catch (err) {
+                console.error(`[daemon] Failed to merge into ${cf}:`, err);
+            }
+        }
+        if (autoCommit) {
+            try {
+                await (0, git_js_1.commitContextFiles)(contextFiles);
+                console.log('[daemon] Committed context files');
+            }
+            catch (err) {
+                console.error('[daemon] Git commit failed:', err);
+            }
+        }
+    });
+    return stop;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,kCA6DC;AA7ED,yBAAuB;AACvB,2CAA6B;AAC7B,6CAA4C;AAC5C,iDAAmD;AACnD,2CAAkF;AAClF,qCAA8C;AAC9C,uDAAkD;AAMlD;;;GAGG;AACH,SAAgB,WAAW,CAAC,UAAyB,EAAE;IACrD,MAAM,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,IAAA,yBAAY,EAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC3C,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QAEnD,MAAM,UAAU,GAAG,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,gDAAgD,QAAQ,EAAE,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QAED,IAAI,SAAmB,CAAC;QACxB,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAA,gCAAiB,EAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,SAAS,CAAC,MAAM,eAAe,EAAE,SAAS,CAAC,CAAC;QAE9E,kFAAkF;QAClF,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,IAAA,+BAAa,EAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,sCAAsC,SAAS,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,YAAY,GAAG,IAAA,4BAAgB,EAAC,UAAU,CAAC,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,IAAA,0BAAc,EAAC,EAAE,EAAE,SAAS,CAAC,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;gBACvC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/merger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Merges new decisions into the managed section.
+ *
+ * Rules (from spec §6.4):
+ * 1. First run: append section to end of existing CLAUDE.md.
+ * 2. Subsequent updates: replace only the content between markers.
+ * 3. File doesn't exist: create with minimal header + section.
+ * 4. Manual edits inside markers: additive merge (new decisions appended, nothing deleted).
+ * 5. AGENTS.md: same behaviour.
+ */
+export declare function mergeDecisions(filePath: string, newDecisions: string[]): void;
+/**
+ * Finds CLAUDE.md and AGENTS.md starting from projectDir upward (git root detection).
+ * Returns all found paths (may be empty).
+ */
+export declare function findContextFiles(projectDir: string): string[];
+/**
+ * Resolves the project directory from a transcript file path.
+ *
+ * Claude Code stores transcripts at:
+ *   ~/.claude/projects/<encoded-project-path>/<session-id>.jsonl
+ *
+ * The directory name is encoded differently on Unix vs Windows:
+ * - Unix/Linux/Mac: URL-encoded with %2F for path separators
+ * - Windows: dash-encoded, where single dashes replace both path separators (\) AND spaces
+ *   Example: c--users-jeanz-onedrive-desktop-roi-labs-context-keeper
+ *   Maps to: C:\Users\jeanz\OneDrive\Desktop\ROI Labs\context-keeper
+ *
+ * NOTE: Windows encoding is lossy and cannot be reliably decoded without filesystem context.
+ * Strategy: Use filesystem walk + git root discovery to find the actual project directory,
+ * ensuring projectName (via path.basename) is always correct and readable.
+ */
+export declare function resolveProjectDir(transcriptPath: string): string | null;
+//# sourceMappingURL=merger.d.ts.map

package/dist/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../src/merger.ts"],"names":[],"mappings":"AAkCA;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAoD7E;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAS7D;AAYD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8CvE"}

package/dist/merger.js

@@ -0,0 +1,241 @@
+"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 });
+exports.mergeDecisions = mergeDecisions;
+exports.findContextFiles = findContextFiles;
+exports.resolveProjectDir = resolveProjectDir;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const MARKER_START = '<!-- context-keeper:start';
+const MARKER_END = '<!-- context-keeper:end -->';
+const SECTION_HEADER = '## Architectural Decisions (auto-captured)';
+const MINIMAL_HEADER = `# Project Context\n\n`;
+/**
+ * Builds the full managed section string (including markers).
+ */
+function buildManagedSection(decisions, timestamp) {
+    const lines = decisions.map((d) => `- [${timestamp.slice(0, 10)}] ${d}`).join('\n');
+    return (`${MARKER_START} (last updated: ${timestamp}) -->\n` +
+        `${SECTION_HEADER}\n\n` +
+        `${lines}\n\n` +
+        `${MARKER_END}`);
+}
+/**
+ * Reads the current content between markers (if any).
+ * Returns null if no markers found.
+ */
+function extractManagedSection(content) {
+    const startIdx = content.indexOf(MARKER_START);
+    if (startIdx === -1)
+        return null;
+    const endIdx = content.indexOf(MARKER_END, startIdx);
+    if (endIdx === -1)
+        return null;
+    return content.slice(startIdx, endIdx + MARKER_END.length);
+}
+/**
+ * Merges new decisions into the managed section.
+ *
+ * Rules (from spec §6.4):
+ * 1. First run: append section to end of existing CLAUDE.md.
+ * 2. Subsequent updates: replace only the content between markers.
+ * 3. File doesn't exist: create with minimal header + section.
+ * 4. Manual edits inside markers: additive merge (new decisions appended, nothing deleted).
+ * 5. AGENTS.md: same behaviour.
+ */
+function mergeDecisions(filePath, newDecisions) {
+    const timestamp = new Date().toISOString();
+    if (newDecisions.length === 0)
+        return;
+    // Read existing file (or empty string if not found)
+    let existing = '';
+    if (fs.existsSync(filePath)) {
+        existing = fs.readFileSync(filePath, 'utf-8');
+    }
+    const currentSection = extractManagedSection(existing);
+    if (currentSection === null) {
+        // First run or markers not present — append section
+        const section = buildManagedSection(newDecisions, timestamp);
+        const base = existing.trim() ? existing.trimEnd() + '\n\n' : MINIMAL_HEADER;
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, base + section + '\n', 'utf-8');
+        return;
+    }
+    // Extract existing decisions to enable additive merge
+    const existingDecisionLines = currentSection
+        .split('\n')
+        .filter((line) => line.startsWith('- ['));
+    // Deduplicate: only add decisions not already present (by text)
+    const existingTexts = new Set(existingDecisionLines.map((l) => l.replace(/^- \[\d{4}-\d{2}-\d{2}\] /, '')));
+    const deduplicated = newDecisions.filter((d) => !existingTexts.has(d));
+    if (deduplicated.length === 0)
+        return;
+    const allDecisionLines = [
+        ...existingDecisionLines,
+        ...deduplicated.map((d) => `- [${timestamp.slice(0, 10)}] ${d}`),
+    ];
+    const updatedSection = `${MARKER_START} (last updated: ${timestamp}) -->\n` +
+        `${SECTION_HEADER}\n\n` +
+        `${allDecisionLines.join('\n')}\n\n` +
+        `${MARKER_END}`;
+    const updated = existing.replace(new RegExp(`${escapeRegex(MARKER_START)}[\\s\\S]*?${escapeRegex(MARKER_END)}`), updatedSection);
+    fs.writeFileSync(filePath, updated, 'utf-8');
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Finds CLAUDE.md and AGENTS.md starting from projectDir upward (git root detection).
+ * Returns all found paths (may be empty).
+ */
+function findContextFiles(projectDir) {
+    const root = findGitRoot(projectDir) ?? projectDir;
+    const candidates = [
+        path.join(root, 'CLAUDE.md'),
+        path.join(root, 'AGENTS.md'),
+    ];
+    // Return all that exist, or [CLAUDE.md path] as default to create
+    const existing = candidates.filter((p) => fs.existsSync(p));
+    return existing.length > 0 ? existing : [path.join(root, 'CLAUDE.md')];
+}
+function findGitRoot(dir) {
+    let current = path.resolve(dir);
+    while (true) {
+        if (fs.existsSync(path.join(current, '.git')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * Resolves the project directory from a transcript file path.
+ *
+ * Claude Code stores transcripts at:
+ *   ~/.claude/projects/<encoded-project-path>/<session-id>.jsonl
+ *
+ * The directory name is encoded differently on Unix vs Windows:
+ * - Unix/Linux/Mac: URL-encoded with %2F for path separators
+ * - Windows: dash-encoded, where single dashes replace both path separators (\) AND spaces
+ *   Example: c--users-jeanz-onedrive-desktop-roi-labs-context-keeper
+ *   Maps to: C:\Users\jeanz\OneDrive\Desktop\ROI Labs\context-keeper
+ *
+ * NOTE: Windows encoding is lossy and cannot be reliably decoded without filesystem context.
+ * Strategy: Use filesystem walk + git root discovery to find the actual project directory,
+ * ensuring projectName (via path.basename) is always correct and readable.
+ */
+function resolveProjectDir(transcriptPath) {
+    const parentDir = path.basename(path.dirname(transcriptPath));
+    // Try percent-decoding first (Unix/Linux format: %2F for separator)
+    try {
+        const decoded = decodeURIComponent(parentDir);
+        // Check if it looks like a valid absolute path
+        if (decoded.startsWith('/') || decoded.match(/^[a-zA-Z]:/)) {
+            // For Unix paths, return as-is (already decoded)
+            return decoded;
+        }
+    }
+    catch {
+        // Fall through to dash-decoding
+    }
+    // Try dash-decoding for Windows (lossy format: c--users-path-with-spaces-encoding)
+    if (parentDir.match(/^[a-z]--/)) {
+        try {
+            const driveLetter = parentDir[0].toUpperCase();
+            const driveRoot = driveLetter + ':';
+            // Search for the real directory by walking from common roots
+            // This allows us to derive the correct projectName from the git root's basename
+            const searchRoots = [
+                path.join(driveRoot, 'Users'),
+                path.join(driveRoot, 'Temp'),
+                path.join(driveRoot, 'Dev'),
+                driveRoot,
+            ];
+            for (const root of searchRoots) {
+                if (fs.existsSync(root)) {
+                    const found = findProjectRootByEncoding(root, parentDir, 0);
+                    if (found)
+                        return found;
+                }
+            }
+            // If filesystem search fails, return null (unable to resolve)
+            // Better to fail safely than return an unverified encoded path
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Searches for a real directory that matches the encoded path pattern,
+ * then climbs to find its git root (project root).
+ * Returns the git root path, ensuring projectName via path.basename() is correct.
+ */
+function findProjectRootByEncoding(currentPath, encodedPath, depth) {
+    if (depth > 6)
+        return null; // Limit recursion depth
+    try {
+        const entries = fs.readdirSync(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const normalizedName = entry.name.toLowerCase();
+            const encodedName = normalizedName.replace(/\s+/g, '-');
+            // Check if this directory's encoded name appears in the transcript encoding
+            if (encodedPath.includes(encodedName)) {
+                const fullPath = path.join(currentPath, entry.name);
+                // Found a matching directory — now climb to its git root
+                const gitRoot = findGitRoot(fullPath);
+                if (gitRoot) {
+                    // Verify this is a real project (has .git)
+                    return gitRoot;
+                }
+                // If no git root found but we matched, continue searching deeper
+                // (might be an intermediate directory, not the project root)
+                const found = findProjectRootByEncoding(fullPath, encodedPath, depth + 1);
+                if (found)
+                    return found;
+            }
+        }
+    }
+    catch {
+        // Skip on permission errors or other I/O issues
+    }
+    return null;
+}
+//# sourceMappingURL=merger.js.map

package/dist/merger.js.map

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

package/dist/watcher.d.ts

@@ -0,0 +1,7 @@
+export type SessionEndedCallback = (filePath: string) => Promise<void>;
+/**
+ * Watches ~/.claude/projects/**\/*.jsonl for session end events.
+ * A session is considered ended when a file stops being modified for 5 minutes.
+ */
+export declare function startWatcher(onSessionEnded: SessionEndedCallback): () => void;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,oBAAoB,GAAG,MAAM,IAAI,CA2C7E"}

package/dist/watcher.js

@@ -0,0 +1,87 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startWatcher = startWatcher;
+const chokidar_1 = __importDefault(require("chokidar"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const DEBOUNCE_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Watches ~/.claude/projects/**\/*.jsonl for session end events.
+ * A session is considered ended when a file stops being modified for 5 minutes.
+ */
+function startWatcher(onSessionEnded) {
+    const watchDir = path.join(os.homedir(), '.claude', 'projects');
+    const timers = new Map();
+    const watcher = chokidar_1.default.watch(`${watchDir}/**/*.jsonl`, {
+        persistent: true,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 2000,
+            pollInterval: 500,
+        },
+    });
+    function scheduleSessionEnd(filePath) {
+        const existing = timers.get(filePath);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(async () => {
+            timers.delete(filePath);
+            try {
+                await onSessionEnded(filePath);
+            }
+            catch (err) {
+                console.error(`[watcher] Error processing session for ${filePath}:`, err);
+            }
+        }, DEBOUNCE_MS);
+        timers.set(filePath, timer);
+    }
+    watcher.on('add', scheduleSessionEnd);
+    watcher.on('change', scheduleSessionEnd);
+    watcher.on('error', (err) => {
+        console.error('[watcher] Filesystem error:', err);
+    });
+    console.log(`[watcher] Watching ${watchDir}/**/*.jsonl (5-min debounce)`);
+    return () => {
+        for (const timer of timers.values())
+            clearTimeout(timer);
+        timers.clear();
+        watcher.close();
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,oCA2CC;AAvDD,wDAAgC;AAChC,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAI/C;;;GAGG;AACH,SAAgB,YAAY,CAAC,cAAoC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEhE,MAAM,OAAO,GAAG,kBAAQ,CAAC,KAAK,CAAC,GAAG,QAAQ,aAAa,EAAE;QACvD,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE;YAChB,kBAAkB,EAAE,IAAI;YACxB,YAAY,EAAE,GAAG;SAClB;KACF,CAAC,CAAC;IAEH,SAAS,kBAAkB,CAAC,QAAgB;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,EAAE,WAAW,CAAC,CAAC;QAEhB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAEzC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,8BAA8B,CAAC,CAAC;IAE1E,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@jeanzorzetti/context-keeper",
+  "version": "0.1.0",
+  "description": "Context Keeper daemon — watches Claude Code transcripts, extracts decisions via Groq, updates CLAUDE.md",
+  "main": "dist/index.js",
+  "bin": {
+    "context-keeper": "dist/cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "chokidar": "^3.6.0",
+    "groq-sdk": "^0.7.0",
+    "dotenv": "^16.4.5",
+    "simple-git": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}