@hyperlynq/synaptic 0.7.0

package/build/src/server.js

@@ -0,0 +1,133 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ContextIndex } from "./storage/sqlite.js";
+import { Embedder } from "./storage/embedder.js";
+import { ensureDirs } from "./storage/paths.js";
+import { detectProject } from "./storage/project.js";
+import { contextSave, contextSaveSchema } from "./tools/context-save.js";
+import { contextSearch, contextSearchSchema } from "./tools/context-search.js";
+import { contextList, contextListSchema } from "./tools/context-list.js";
+import { contextStatus } from "./tools/context-status.js";
+import { contextArchive, contextArchiveSchema } from "./tools/context-archive.js";
+import { contextGitIndex, contextGitIndexSchema } from "./tools/context-git-index.js";
+import { contextResolvePattern, contextResolvePatternSchema } from "./tools/context-resolve-pattern.js";
+import { contextSaveRule, contextSaveRuleSchema } from "./tools/context-save-rule.js";
+import { contextDeleteRule, contextDeleteRuleSchema } from "./tools/context-delete-rule.js";
+import { contextListRules } from "./tools/context-list-rules.js";
+import { contextSession, contextSessionSchema } from "./tools/context-session.js";
+import { contextCochanges, contextCochangesSchema } from "./tools/context-cochanges.js";
+import { contextDna, contextDnaSchema } from "./tools/context-dna.js";
+import { contextChain, contextChainSchema } from "./tools/context-chain.js";
+import { GitWatcher } from "./storage/watcher.js";
+let _embedder;
+let _currentProject = null;
+export function getEmbedder() {
+    return _embedder;
+}
+export function getCurrentProject() {
+    return _currentProject;
+}
+export { getSessionId } from "./storage/session.js";
+export function createServer() {
+    ensureDirs();
+    _currentProject = detectProject();
+    const index = new ContextIndex();
+    _embedder = new Embedder();
+    const embedder = _embedder;
+    // Start git event watcher (silent no-op if not a git repo)
+    const watcher = new GitWatcher({
+        index,
+        embedder,
+        getCurrentProject: () => _currentProject,
+    });
+    watcher.start();
+    const server = new McpServer({
+        name: "synaptic",
+        version: "0.6.0",
+    });
+    server.tool("context_save", "Save a context entry (decision, progress, issue, etc.) to persistent local storage", contextSaveSchema, async (args) => {
+        const result = await contextSave(args, index, embedder);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_search", "Search saved context entries using hybrid semantic + keyword search", contextSearchSchema, async (args) => {
+        const result = await contextSearch(args, index, embedder);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_list", "List context entries by date range, optionally filtered by type", contextListSchema, async (args) => {
+        const result = contextList(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_status", "Show storage stats: total entries, date range, database size, tier distribution, active patterns", {}, async () => {
+        const result = contextStatus(index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_archive", "Bulk-archive entries by ID list. Archived entries are excluded from search/list by default.", contextArchiveSchema, async (args) => {
+        const result = contextArchive(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_git_index", "Index git commits as searchable context entries. Deduplicates by SHA.", contextGitIndexSchema, async (args) => {
+        const result = await contextGitIndex(args, index, embedder);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_resolve_pattern", "Mark a recurring issue pattern as resolved. Stops surfacing in search and session-start.", contextResolvePatternSchema, async (args) => {
+        const result = contextResolvePattern(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_save_rule", "Save or update a persistent rule by label. Rules are injected every session and always enforced. If a rule with this label exists, it is overwritten.", contextSaveRuleSchema, async (args) => {
+        const result = contextSaveRule(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_delete_rule", "Delete a persistent rule by its label.", contextDeleteRuleSchema, async (args) => {
+        const result = contextDeleteRule(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_list_rules", "List all active rules with their labels and content.", {}, async () => {
+        const result = contextListRules(index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_session", "List all entries from the current or specified session. Use for agent context sharing.", contextSessionSchema, async (args) => {
+        const result = contextSession(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_cochanges", "Get files that frequently co-change with a given file, based on git history.", contextCochangesSchema, async (args) => {
+        const result = contextCochanges(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_dna", "Analyze git history to discover codebase patterns, hotspots, architectural layers, and co-change clusters. Saves a longterm reference entry.", contextDnaSchema, async (args) => {
+        const result = await contextDna(args, index, embedder);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    server.tool("context_chain", "Retrieve all entries in a decision chain by chain ID. Returns entries chronologically.", contextChainSchema, async (args) => {
+        const result = contextChain(args, index);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/src/server.js.map

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

package/build/src/storage/embedder.d.ts

@@ -0,0 +1,27 @@
+export interface TemplateEmbedding {
+    category: string;
+    text: string;
+    embedding: Float32Array;
+}
+export declare class Embedder {
+    private extractor;
+    private cache;
+    private directiveTemplates;
+    private categoryTemplates;
+    private intentTemplates;
+    /** Pre-load the model so first real query is fast. */
+    warmup(): Promise<void>;
+    private ensureModel;
+    embed(text: string): Promise<Float32Array>;
+    /** Pre-computed directive templates for correction detection */
+    getDirectiveTemplates(): Promise<TemplateEmbedding[]>;
+    /** Pre-computed category templates for distillation */
+    getCategoryTemplates(): Promise<TemplateEmbedding[]>;
+    /** Pre-computed intent templates for autonomous capture */
+    getIntentTemplates(): Promise<TemplateEmbedding[]>;
+    /** Classify a sentence against templates, return best match if above threshold */
+    classifySentence(sentence: string, templates: TemplateEmbedding[], threshold?: number): Promise<{
+        category: string;
+        similarity: number;
+    } | null>;
+}

package/build/src/storage/embedder.js

@@ -0,0 +1,126 @@
+import { pipeline, env, } from "@huggingface/transformers";
+import { MODELS_DIR } from "./paths.js";
+const MAX_CACHE = 100;
+export class Embedder {
+    extractor = null;
+    cache = new Map();
+    directiveTemplates = null;
+    categoryTemplates = null;
+    intentTemplates = null;
+    /** Pre-load the model so first real query is fast. */
+    async warmup() {
+        await this.ensureModel();
+    }
+    async ensureModel() {
+        if (!this.extractor) {
+            env.cacheDir = MODELS_DIR;
+            // @ts-expect-error -- pipeline() union type too complex for TS; runtime type is correct
+            this.extractor = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2", { dtype: "q8" });
+        }
+        return this.extractor;
+    }
+    async embed(text) {
+        const key = text.trim().toLowerCase();
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const extractor = await this.ensureModel();
+        const result = await extractor(text, {
+            pooling: "mean",
+            normalize: true,
+        });
+        const embedding = result.data;
+        // LRU eviction: delete oldest if at capacity
+        if (this.cache.size >= MAX_CACHE) {
+            const oldest = this.cache.keys().next().value;
+            this.cache.delete(oldest);
+        }
+        this.cache.set(key, embedding);
+        return embedding;
+    }
+    /** Pre-computed directive templates for correction detection */
+    async getDirectiveTemplates() {
+        if (this.directiveTemplates)
+            return this.directiveTemplates;
+        const directives = [
+            { category: "always", text: "always do this from now on" },
+            { category: "never", text: "never do that again" },
+            { category: "stop", text: "stop doing this please" },
+            { category: "remember", text: "please remember to do this going forward" },
+            { category: "preference", text: "I prefer this approach instead" },
+            { category: "correction", text: "that's wrong, do it this way instead" },
+        ];
+        this.directiveTemplates = [];
+        for (const d of directives) {
+            const embedding = await this.embed(d.text);
+            this.directiveTemplates.push({ ...d, embedding });
+        }
+        return this.directiveTemplates;
+    }
+    /** Pre-computed category templates for distillation */
+    async getCategoryTemplates() {
+        if (this.categoryTemplates)
+            return this.categoryTemplates;
+        const categories = [
+            { category: "decision", text: "we decided to go with this approach" },
+            { category: "decision", text: "let's use this option instead" },
+            { category: "solution", text: "the fix was to change this" },
+            { category: "solution", text: "this worked because of that reason" },
+            { category: "discovery", text: "turns out the issue was caused by this" },
+            { category: "discovery", text: "I found out that this is how it works" },
+        ];
+        this.categoryTemplates = [];
+        for (const c of categories) {
+            const embedding = await this.embed(c.text);
+            this.categoryTemplates.push({ ...c, embedding });
+        }
+        return this.categoryTemplates;
+    }
+    /** Pre-computed intent templates for autonomous capture */
+    async getIntentTemplates() {
+        if (this.intentTemplates)
+            return this.intentTemplates;
+        const intents = [
+            { category: "declaration", text: "this is my project" },
+            { category: "declaration", text: "that's my app" },
+            { category: "declaration", text: "my app is called" },
+            { category: "declaration", text: "I built this" },
+            { category: "declaration", text: "this is called my tool" },
+            { category: "identity", text: "my name is" },
+            { category: "identity", text: "my username is" },
+            { category: "identity", text: "my account name is" },
+            { category: "preference", text: "I like using this tool" },
+            { category: "preference", text: "I usually do it this way" },
+            { category: "preference", text: "I prefer this approach" },
+            { category: "preference", text: "I prefer using this over that" },
+            { category: "frustration", text: "this keeps happening over and over" },
+            { category: "frustration", text: "why does this always break" },
+            { category: "ownership", text: "this belongs to me" },
+            { category: "ownership", text: "I own this repository" },
+            { category: "ownership", text: "this is my repo" },
+        ];
+        this.intentTemplates = [];
+        for (const i of intents) {
+            const embedding = await this.embed(i.text);
+            this.intentTemplates.push({ ...i, embedding });
+        }
+        return this.intentTemplates;
+    }
+    /** Classify a sentence against templates, return best match if above threshold */
+    async classifySentence(sentence, templates, threshold = 0.7) {
+        const sentenceEmb = await this.embed(sentence);
+        let bestMatch = null;
+        for (const tpl of templates) {
+            let dot = 0;
+            for (let i = 0; i < sentenceEmb.length; i++) {
+                dot += sentenceEmb[i] * tpl.embedding[i];
+            }
+            // Embeddings are L2-normalized, so dot product = cosine similarity
+            if (dot >= threshold && (!bestMatch || dot > bestMatch.similarity)) {
+                bestMatch = { category: tpl.category, similarity: dot };
+            }
+        }
+        return bestMatch;
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/build/src/storage/embedder.js.map

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

package/build/src/storage/git.d.ts

@@ -0,0 +1,20 @@
+export interface GitCommit {
+    sha: string;
+    message: string;
+    author: string;
+    date: string;
+    branch: string;
+    files: Array<{
+        path: string;
+        insertions: number;
+        deletions: number;
+    }>;
+}
+export declare function isGitRepo(dir: string): boolean;
+export declare function getCurrentBranch(repoPath: string): string;
+export declare function getGitLog(repoPath: string, opts?: {
+    days?: number;
+    branch?: string;
+}): GitCommit[];
+export declare function getRecentlyChangedFiles(repoPath: string): string[];
+export declare function formatCommitAsContent(commit: GitCommit): string;

package/build/src/storage/git.js

@@ -0,0 +1,98 @@
+import { execFileSync, execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export function isGitRepo(dir) {
+    return existsSync(join(dir, ".git"));
+}
+export function getCurrentBranch(repoPath) {
+    try {
+        return execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd: repoPath,
+            encoding: "utf-8",
+        }).trim();
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function getGitLog(repoPath, opts = {}) {
+    const days = opts.days ?? 7;
+    const branch = opts.branch ?? getCurrentBranch(repoPath);
+    try {
+        // Get commits with stats (execFileSync to avoid shell injection via branch name)
+        const raw = execFileSync("git", [
+            "log", branch, `--since=${days} days ago`,
+            "--format=COMMIT_SEP%n%H%n%s%n%an%n%aI", "--numstat",
+        ], { cwd: repoPath, encoding: "utf-8", maxBuffer: 10 * 1024 * 1024 });
+        const commits = [];
+        const blocks = raw.split("COMMIT_SEP\n").filter(Boolean);
+        for (const block of blocks) {
+            const lines = block.trim().split("\n");
+            if (lines.length < 4)
+                continue;
+            const sha = lines[0];
+            const message = lines[1];
+            const author = lines[2];
+            const dateStr = lines[3].slice(0, 10); // YYYY-MM-DD
+            const files = [];
+            for (let i = 4; i < lines.length; i++) {
+                const line = lines[i].trim();
+                if (!line)
+                    continue;
+                const parts = line.split("\t");
+                if (parts.length === 3) {
+                    files.push({
+                        insertions: parseInt(parts[0]) || 0,
+                        deletions: parseInt(parts[1]) || 0,
+                        path: parts[2],
+                    });
+                }
+            }
+            commits.push({ sha, message, author, date: dateStr, branch, files });
+        }
+        return commits;
+    }
+    catch {
+        return [];
+    }
+}
+export function getRecentlyChangedFiles(repoPath) {
+    const files = new Set();
+    try {
+        // Last 3 commits
+        const committed = execSync("git diff --name-only HEAD~3", {
+            cwd: repoPath,
+            encoding: "utf-8",
+            timeout: 3000,
+        }).trim();
+        if (committed)
+            committed.split("\n").forEach(f => files.add(f));
+    }
+    catch {
+        // May fail if fewer than 3 commits
+    }
+    try {
+        // Uncommitted changes
+        const uncommitted = execSync("git diff --name-only", {
+            cwd: repoPath,
+            encoding: "utf-8",
+            timeout: 3000,
+        }).trim();
+        if (uncommitted)
+            uncommitted.split("\n").forEach(f => files.add(f));
+    }
+    catch {
+        // Ignore
+    }
+    return Array.from(files);
+}
+export function formatCommitAsContent(commit) {
+    const fileList = commit.files
+        .map(f => {
+        const stats = `+${f.insertions}/-${f.deletions}`;
+        return `${f.path} (${stats})`;
+    })
+        .join(", ");
+    return `[${commit.branch}] ${commit.message}\nFiles: ${fileList || "none"}`;
+}
+//# sourceMappingURL=git.js.map

package/build/src/storage/git.js.map

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

package/build/src/storage/maintenance.d.ts

@@ -0,0 +1,9 @@
+import { ContextIndex } from "./sqlite.js";
+export interface MaintenanceReport {
+    decayed: number;
+    demoted: number;
+    promotedStable: number;
+    promotedFrequent: number;
+    consolidated: number;
+}
+export declare function runMaintenance(index: ContextIndex): MaintenanceReport;

package/build/src/storage/maintenance.js

@@ -0,0 +1,46 @@
+export function runMaintenance(index) {
+    const decayed = index.decayEphemeral();
+    const demoted = index.demoteIdle();
+    const promotedStable = index.promoteStable();
+    const promotedFrequent = index.promoteFrequent();
+    const consolidated = consolidate(index);
+    return { decayed, demoted, promotedStable, promotedFrequent, consolidated };
+}
+function consolidate(index) {
+    const groups = index.findConsolidationCandidates(0.75);
+    if (groups.length === 0)
+        return 0;
+    let consolidated = 0;
+    for (const group of groups) {
+        // Filter to entries older than 3 days
+        const now = Date.now();
+        const threeDaysMs = 3 * 24 * 60 * 60 * 1000;
+        const eligible = group.entries.filter(e => {
+            const entryDate = new Date(e.date).getTime();
+            return (now - entryDate) > threeDaysMs;
+        });
+        if (eligible.length < 3)
+            continue; // Need 3+ to consolidate
+        // Skip rule and reference types
+        if (eligible.some(e => e.type === "rule" || e.type === "reference"))
+            continue;
+        // Find survivor: highest access count
+        eligible.sort((a, b) => (b.accessCount ?? 0) - (a.accessCount ?? 0));
+        const survivor = eligible[0];
+        const others = eligible.slice(1);
+        // Merge tags from others into survivor
+        index.mergeTagsInto(survivor.id, others.map(e => e.id));
+        // Update survivor content with consolidation note
+        const updatedContent = `${survivor.content}\n[Consolidated from ${eligible.length} entries]`;
+        index.updateEntryContent(survivor.id, updatedContent);
+        // Promote survivor if ephemeral
+        if (survivor.tier === "ephemeral") {
+            index.changeTier(survivor.id, "working");
+        }
+        // Archive others
+        index.archiveEntries(others.map(e => e.id));
+        consolidated++;
+    }
+    return consolidated;
+}
+//# sourceMappingURL=maintenance.js.map

package/build/src/storage/maintenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.js","sourceRoot":"","sources":["../../../src/storage/maintenance.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IACnC,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,KAAmB;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAElC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,sCAAsC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YAC7C,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,yBAAyB;QAE5D,gCAAgC;QAChC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;YAAE,SAAS;QAE9E,sCAAsC;QACtC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEjC,uCAAuC;QACvC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAExD,kDAAkD;QAClD,MAAM,cAAc,GAAG,GAAG,QAAQ,CAAC,OAAO,wBAAwB,QAAQ,CAAC,MAAM,WAAW,CAAC;QAC7F,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAEtD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;QAED,iBAAiB;QACjB,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5C,YAAY,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/build/src/storage/markdown.d.ts

@@ -0,0 +1,21 @@
+export interface ContextEntry {
+    id: string;
+    date: string;
+    time: string;
+    type: string;
+    tags: string[];
+    content: string;
+    sourceFile: string;
+    tier?: "ephemeral" | "working" | "longterm";
+    accessCount?: number;
+    lastAccessed?: string | null;
+    pinned?: boolean;
+    archived?: boolean;
+    project?: string | null;
+    sessionId?: string | null;
+    agentId?: string | null;
+}
+export declare function appendEntry(content: string, type: string, tags: string[]): ContextEntry;
+export declare function parseMarkdownFile(filePath: string): ContextEntry[];
+export declare function parseMarkdownText(text: string, sourceFile: string): ContextEntry[];
+export declare function listMarkdownFiles(): string[];

package/build/src/storage/markdown.js

@@ -0,0 +1,79 @@
+import { readFileSync, writeFileSync, existsSync, readdirSync } from "node:fs";
+import { dateToFilePath, CONTEXT_DIR } from "./paths.js";
+function generateId() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+}
+function formatTime() {
+    const now = new Date();
+    return now.toTimeString().slice(0, 5); // HH:MM
+}
+function formatDate() {
+    const now = new Date();
+    return now.toISOString().slice(0, 10); // YYYY-MM-DD
+}
+export function appendEntry(content, type, tags) {
+    const date = formatDate();
+    const time = formatTime();
+    const id = generateId();
+    const filePath = dateToFilePath(date);
+    const tagStr = tags.join(", ");
+    let fileContent = "";
+    if (existsSync(filePath)) {
+        fileContent = readFileSync(filePath, "utf-8");
+    }
+    else {
+        fileContent = `# Context Log: ${date}\n`;
+    }
+    const entryBlock = `\n## ${time} | ${type} | ${tagStr}\n<!-- id:${id} -->\n${content}\n`;
+    fileContent += entryBlock;
+    writeFileSync(filePath, fileContent, "utf-8");
+    return { id, date, time, type, tags, content, sourceFile: filePath };
+}
+export function parseMarkdownFile(filePath) {
+    if (!existsSync(filePath))
+        return [];
+    const text = readFileSync(filePath, "utf-8");
+    return parseMarkdownText(text, filePath);
+}
+export function parseMarkdownText(text, sourceFile) {
+    const entries = [];
+    // Extract date from header or filename
+    const dateMatch = text.match(/^# Context Log: (\d{4}-\d{2}-\d{2})/m) ??
+        sourceFile.match(/(\d{4}-\d{2}-\d{2})\.md$/);
+    const date = dateMatch?.[1] ?? "unknown";
+    // Split on ## headers
+    const sections = text.split(/^## /m).slice(1);
+    for (const section of sections) {
+        const headerEnd = section.indexOf("\n");
+        if (headerEnd === -1)
+            continue;
+        const header = section.slice(0, headerEnd).trim();
+        const body = section.slice(headerEnd + 1).trim();
+        // Parse header: "HH:MM | type | tags"
+        const parts = header.split("|").map((s) => s.trim());
+        if (parts.length < 2)
+            continue;
+        const time = parts[0];
+        const type = parts[1];
+        const tagStr = parts.slice(2).join(", ");
+        const tags = tagStr
+            ? tagStr.split(",").map((t) => t.trim()).filter(Boolean)
+            : [];
+        // Extract id from <!-- id:xxx --> comment
+        const idMatch = body.match(/<!-- id:(\S+) -->/);
+        const id = idMatch?.[1] ?? generateId();
+        // Content is everything after the id comment (or all of body if no id)
+        const content = body.replace(/<!-- id:\S+ -->\n?/, "").trim();
+        entries.push({ id, date, time, type, tags, content, sourceFile });
+    }
+    return entries;
+}
+export function listMarkdownFiles() {
+    if (!existsSync(CONTEXT_DIR))
+        return [];
+    return readdirSync(CONTEXT_DIR)
+        .filter((f) => f.endsWith(".md"))
+        .sort()
+        .map((f) => `${CONTEXT_DIR}/${f}`);
+}
+//# sourceMappingURL=markdown.js.map

package/build/src/storage/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/storage/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoBzD,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;AACjD,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;AACtD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,IAAY,EACZ,IAAc;IAEd,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,kBAAkB,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,IAAI,MAAM,IAAI,MAAM,MAAM,aAAa,EAAE,SAAS,OAAO,IAAI,CAAC;IACzF,WAAW,IAAI,UAAU,CAAC;IAC1B,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAE9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,UAAkB;IAElB,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,uCAAuC;IACvC,MAAM,SAAS,GACb,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC;QAClD,UAAU,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAEzC,sBAAsB;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,SAAS;QAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjD,sCAAsC;QACtC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM;YACjB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YACxD,CAAC,CAAC,EAAE,CAAC;QAEP,0CAA0C;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;QAExC,uEAAuE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9D,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,WAAW,CAAC,WAAW,CAAC;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,WAAW,IAAI,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/build/src/storage/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const CONTEXT_DIR: string;
+export declare const DB_DIR: string;
+export declare const DB_PATH: string;
+export declare const MODELS_DIR: string;
+export declare function ensureDirs(): void;
+export declare function dateToFilePath(date: string): string;

package/build/src/storage/paths.js

@@ -0,0 +1,17 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync } from "node:fs";
+const BASE_DIR = join(homedir(), ".claude-context");
+export const CONTEXT_DIR = join(BASE_DIR, "context");
+export const DB_DIR = join(BASE_DIR, "db");
+export const DB_PATH = join(DB_DIR, "context.db");
+export const MODELS_DIR = join(BASE_DIR, "models");
+export function ensureDirs() {
+    mkdirSync(CONTEXT_DIR, { recursive: true });
+    mkdirSync(DB_DIR, { recursive: true });
+    mkdirSync(MODELS_DIR, { recursive: true });
+}
+export function dateToFilePath(date) {
+    return join(CONTEXT_DIR, `${date}.md`);
+}
+//# sourceMappingURL=paths.js.map

package/build/src/storage/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/storage/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEnD,MAAM,UAAU,UAAU;IACxB,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/build/src/storage/project.d.ts

@@ -0,0 +1,2 @@
+export declare function detectProject(cwd?: string): string | null;
+export declare function resetProjectCache(): void;