pathmark 0.1.0

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AACtH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { runMcpServer } from "./mcp.js";
+const [domain, ...rest] = process.argv.slice(2);
+if (domain === "codex") {
+    const { runCodexCommand } = await import("./codex/cli.js");
+    await runCodexCommand(rest);
+}
+else if (domain === "setup") {
+    const { runSetupCommand } = await import("./setup.js");
+    await runSetupCommand(rest);
+}
+else if (domain === "help" || domain === "--help" || domain === "-h") {
+    console.log("Usage: pathmark [setup <client>|codex <command>]");
+    console.log("");
+    console.log("No arguments starts the Pathmark MCP stdio server.");
+}
+else {
+    if (domain) {
+        console.error(`Unknown command: ${domain}`);
+        console.error("Usage: pathmark [setup <client>|codex <command>]");
+        process.exitCode = 2;
+    }
+    else {
+        await runMcpServer();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEhD,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3D,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;KAAM,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;IAC9B,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;KAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;AACpE,CAAC;KAAM,CAAC;IACN,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1 @@
+export declare function runMcpServer(): Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,130 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { synthesizeWithCommand } from "./chat.js";
+import { loadConfig } from "./config.js";
+import { jsonText, publicConfig, summarizeRecords, summarizeSearch } from "./format.js";
+import { PathmarkStore } from "./store.js";
+export async function runMcpServer() {
+    const config = loadConfig();
+    const store = new PathmarkStore(config);
+    const server = new McpServer({
+        name: "pathmark",
+        version: "0.1.0",
+    });
+    server.registerTool("get_config", {
+        title: "Get Pathmark configuration",
+        description: "Show the local Pathmark Memory store location and enabled optional features.",
+        inputSchema: {},
+    }, async () => jsonText(publicConfig(config)));
+    server.registerTool("remember", {
+        title: "Remember",
+        description: "Save a durable local memory item.",
+        inputSchema: {
+            text: z.string().min(1).describe("Memory text to save."),
+            tags: z.array(z.string()).optional().describe("Optional lowercase-ish tags for later filtering."),
+            source: z.string().optional().describe("Optional source label, such as repo, thread, or tool name."),
+        },
+    }, async ({ text, tags, source }) => {
+        const record = await store.add({ kind: "memory", text, tags, source });
+        return jsonText(record);
+    });
+    server.registerTool("create_conclusion", {
+        title: "Create conclusion",
+        description: "Save a durable conclusion or preference that should be treated as higher-signal than raw memory.",
+        inputSchema: {
+            text: z.string().min(1).describe("Conclusion text to save."),
+            tags: z.array(z.string()).optional(),
+            source: z.string().optional(),
+        },
+    }, async ({ text, tags, source }) => {
+        const record = await store.add({ kind: "conclusion", text, tags, source });
+        return jsonText(record);
+    });
+    server.registerTool("search_memory", {
+        title: "Search memory",
+        description: "Search saved local memories and conclusions.",
+        inputSchema: {
+            query: z.string().default("").describe("Search query. Empty query returns recent records."),
+            limit: z.number().int().min(1).max(50).optional(),
+            tags: z.array(z.string()).optional(),
+            kind: z.enum(["memory", "conclusion"]).optional(),
+        },
+    }, async ({ query, limit, tags, kind }) => {
+        const results = await store.search({ query, limit, tags, kind });
+        return jsonText({
+            results: results.map((result) => ({
+                ...result.record,
+                score: result.score,
+                matchedTerms: result.matchedTerms,
+            })),
+            summary: summarizeSearch(results),
+        });
+    });
+    server.registerTool("get_context", {
+        title: "Get context",
+        description: "Return compact local memory context for a task or question.",
+        inputSchema: {
+            query: z.string().default("").describe("Task or question to retrieve context for."),
+            limit: z.number().int().min(1).max(30).optional(),
+        },
+    }, async ({ query, limit }) => {
+        const results = await store.search({ query, limit });
+        return jsonText({
+            context: summarizeSearch(results),
+            records: results.map((result) => result.record),
+        });
+    });
+    server.registerTool("list_conclusions", {
+        title: "List conclusions",
+        description: "List saved durable conclusions.",
+        inputSchema: {
+            limit: z.number().int().min(1).max(100).optional(),
+        },
+    }, async ({ limit }) => {
+        const records = (await store.all({ kind: "conclusion" })).slice(0, limit ?? 50);
+        return jsonText({
+            records,
+            summary: summarizeRecords(records),
+        });
+    });
+    server.registerTool("delete_memory", {
+        title: "Delete memory",
+        description: "Soft-delete a saved memory or conclusion by id.",
+        inputSchema: {
+            id: z.string().min(1),
+        },
+    }, async ({ id }) => {
+        const deleted = await store.delete(id);
+        return jsonText({ deleted: deleted ?? null });
+    });
+    server.registerTool("ask_memory", {
+        title: "Ask memory",
+        description: "Retrieve relevant context and optionally synthesize an answer through PATHMARK_CHAT_COMMAND. Without a command, returns context for the MCP client to synthesize.",
+        inputSchema: {
+            question: z.string().min(1),
+            limit: z.number().int().min(1).max(30).optional(),
+        },
+    }, async ({ question, limit }) => answerFromMemory(question, limit));
+    server.registerTool("chat", {
+        title: "Chat",
+        description: "Ask Pathmark memory a question. Returns the exact retrieved context so the MCP client can show what memory was used.",
+        inputSchema: {
+            question: z.string().min(1),
+            limit: z.number().int().min(1).max(30).optional(),
+        },
+    }, async ({ question, limit }) => answerFromMemory(question, limit));
+    await store.ensureReady();
+    await server.connect(new StdioServerTransport());
+    async function answerFromMemory(question, limit) {
+        const results = await store.search({ query: question, limit });
+        const answer = await synthesizeWithCommand({ config, question, context: results });
+        return jsonText({
+            answer: answer ?? null,
+            synthesis: answer ? "server_command" : "client_should_synthesize",
+            context: summarizeSearch(results),
+            records: results.map((result) => result.record),
+        });
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,5 @@
+export interface RedactionResult {
+    text: string;
+    redacted: boolean;
+}
+export declare function redactSecrets(text: string): RedactionResult;

package/dist/redact.js

@@ -0,0 +1,36 @@
+const ENV_SECRET_RE = /\b([A-Z0-9_]*(?:API[_-]?KEY|SECRET|TOKEN|PASSWORD|PRIVATE[_-]?KEY)[A-Z0-9_]*\s*[:=]\s*)(?:"[\s\S]*?"|'[\s\S]*?'|[^\s'",;}]+)/gi;
+const ENV_URL_OR_DSN_RE = /\b([A-Z0-9_]*(?:DATABASE_URL|REDIS_URL|MONGO_URL|DSN|[A-Z0-9_]+_URL)[A-Z0-9_]*)(\s*[:=]\s*)("[^"]*"|'[^']*'|[^\s'",;}]+)/gi;
+const BEARER_RE = /\bBearer\s+[A-Za-z0-9._~+/=-]+/gi;
+const STANDALONE_OPENAI_KEY_RE = /\bsk-(?:proj-)?[A-Za-z0-9_-]{16,}\b/g;
+const CREDENTIAL_URL_RE = /^[a-z][a-z0-9+.-]*:\/\/[^/\s:@]+:[^@\s]+@/i;
+export function redactSecrets(text) {
+    let redacted = false;
+    const safeText = text
+        .replace(ENV_SECRET_RE, (_match, prefix) => {
+        redacted = true;
+        return `${prefix}[REDACTED]`;
+    })
+        .replace(ENV_URL_OR_DSN_RE, (match, name, separator, value) => {
+        const normalizedName = name.toUpperCase();
+        const unquotedValue = value.replace(/^(['"])([\s\S]*)\1$/, "$2");
+        const isDsn = normalizedName.includes("DSN");
+        const isUrlName = normalizedName.includes("DATABASE_URL") ||
+            normalizedName.includes("REDIS_URL") ||
+            normalizedName.includes("MONGO_URL") ||
+            normalizedName.includes("_URL");
+        if (!isDsn && (!isUrlName || !CREDENTIAL_URL_RE.test(unquotedValue)))
+            return match;
+        redacted = true;
+        return `${name}${separator}[REDACTED]`;
+    })
+        .replace(BEARER_RE, () => {
+        redacted = true;
+        return "Bearer [REDACTED]";
+    })
+        .replace(STANDALONE_OPENAI_KEY_RE, () => {
+        redacted = true;
+        return "[REDACTED]";
+    });
+    return { text: safeText, redacted };
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAKA,MAAM,aAAa,GACjB,gIAAgI,CAAC;AACnI,MAAM,iBAAiB,GACrB,4HAA4H,CAAC;AAC/H,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,wBAAwB,GAAG,sCAAsC,CAAC;AACxE,MAAM,iBAAiB,GAAG,4CAA4C,CAAC;AAEvE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,EAAE;QACjD,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,GAAG,MAAM,YAAY,CAAC;IAC/B,CAAC,CAAC;SACD,OAAO,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,SAAiB,EAAE,KAAa,EAAE,EAAE;QACpF,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,SAAS,GACb,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC;YACpC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC;YACpC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnF,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,GAAG,IAAI,GAAG,SAAS,YAAY,CAAC;IACzC,CAAC,CAAC;SACD,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,mBAAmB,CAAC;IAC7B,CAAC,CAAC;SACD,OAAO,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACtC,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetupCommand(args: string[]): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,208 @@
+import { loadConfig } from "./config.js";
+const TARGET_ALIASES = {
+    codex: "codex",
+    "claude-code": "claude-code",
+    claude: "claude-code",
+    "claude-desktop": "claude-desktop",
+    "claude_desktop": "claude-desktop",
+    cursor: "cursor",
+    opencode: "opencode",
+    "open-code": "opencode",
+    gemini: "gemini-cli",
+    "gemini-cli": "gemini-cli",
+    generic: "generic",
+    mcp: "generic",
+    "openai-compatible": "openai-compatible",
+    openai: "openai-compatible",
+    kimi: "openai-compatible",
+    glm: "openai-compatible",
+    zai: "openai-compatible",
+    "z-ai": "openai-compatible",
+    command: "command",
+    cli: "command",
+};
+const TARGETS = [
+    "codex",
+    "claude-code",
+    "claude-desktop",
+    "cursor",
+    "opencode",
+    "gemini-cli",
+    "generic",
+    "openai-compatible",
+    "command",
+];
+export async function runSetupCommand(args) {
+    const json = args.includes("--json");
+    const targetArg = args.find((arg) => !arg.startsWith("-"));
+    if (!targetArg || targetArg === "list") {
+        if (json) {
+            console.log(JSON.stringify({ targets: TARGETS }, null, 2));
+            return;
+        }
+        console.log(`Usage: pathmark setup <${TARGETS.join("|")}> [--json]`);
+        console.log("");
+        console.log("Targets:");
+        for (const target of TARGETS)
+            console.log(`  ${target}`);
+        return;
+    }
+    const target = TARGET_ALIASES[targetArg.toLowerCase()];
+    if (!target) {
+        console.error(`Unknown setup target: ${targetArg}`);
+        console.error(`Usage: pathmark setup <${TARGETS.join("|")}> [--json]`);
+        process.exitCode = 2;
+        return;
+    }
+    const guide = setupGuide(target);
+    if (json) {
+        console.log(JSON.stringify(guide, null, 2));
+        return;
+    }
+    console.log(renderGuide(guide));
+}
+function setupGuide(target) {
+    const config = loadConfig();
+    const env = {
+        PATHMARK_STORE_DIR: config.storeDir,
+        PATHMARK_SYNTHESIS_PROVIDER: "client",
+    };
+    if (target === "codex") {
+        return {
+            target,
+            title: "Codex",
+            summary: "Register Pathmark as a Codex MCP server and optionally enable Codex auto-capture hooks.",
+            commands: ["codex mcp add pathmark -- pathmark", "pathmark codex install --replace-honcho"],
+            env,
+            notes: [
+                "Use the install command when you want automatic Codex prompt/tool/transcript capture.",
+                "The --replace-honcho flag removes old Honcho hook commands but does not delete ~/.honcho/codex/local.",
+            ],
+        };
+    }
+    if (target === "claude-code") {
+        return {
+            target,
+            title: "Claude Code",
+            summary: "Register Pathmark as a local stdio MCP server in Claude Code.",
+            commands: ["claude mcp add pathmark -- pathmark"],
+            env,
+            notes: [
+                "Keep synthesis in client mode so Claude Code's own model answers from returned memory context.",
+                "Use the same PATHMARK_STORE_DIR as Codex to share memory across harnesses.",
+            ],
+        };
+    }
+    if (target === "opencode") {
+        return {
+            target,
+            title: "opencode",
+            summary: "Add Pathmark as a local MCP server in opencode config.",
+            config: {
+                mcp: {
+                    pathmark: {
+                        type: "local",
+                        command: ["pathmark"],
+                        enabled: true,
+                        environment: env,
+                    },
+                },
+            },
+            notes: ["Merge this into your opencode config and keep the same store directory across harnesses."],
+        };
+    }
+    if (target === "gemini-cli") {
+        return {
+            target,
+            title: "Gemini CLI",
+            summary: "Add Pathmark to Gemini CLI's mcpServers settings.",
+            config: {
+                mcpServers: {
+                    pathmark: {
+                        command: "pathmark",
+                        args: [],
+                        env,
+                    },
+                },
+            },
+            notes: ["Place this in the Gemini CLI settings file that defines MCP servers."],
+        };
+    }
+    if (target === "claude-desktop" || target === "cursor" || target === "generic") {
+        const title = target === "claude-desktop" ? "Claude Desktop" : target === "cursor" ? "Cursor" : "Generic MCP Client";
+        return {
+            target,
+            title,
+            summary: "Add Pathmark as a local stdio MCP server.",
+            config: {
+                mcpServers: {
+                    pathmark: {
+                        command: "pathmark",
+                        env,
+                    },
+                },
+            },
+            notes: ["Use this shape for MCP clients that accept mcpServers JSON."],
+        };
+    }
+    if (target === "openai-compatible") {
+        return {
+            target,
+            title: "Kimi, GLM/Z.ai, OpenRouter, LiteLLM, or local OpenAI-compatible gateway",
+            summary: "Use Pathmark with an MCP host, and optionally let ask_memory synthesize through a compatible API.",
+            env: {
+                PATHMARK_STORE_DIR: config.storeDir,
+                PATHMARK_SYNTHESIS_PROVIDER: "openai-compatible",
+                PATHMARK_OPENAI_BASE_URL: "https://api.provider.example/v1",
+                PATHMARK_OPENAI_API_KEY: "replace-me",
+                PATHMARK_OPENAI_MODEL: "replace-me",
+            },
+            notes: [
+                "Raw models still need an MCP-capable host to call Pathmark tools.",
+                "The OpenAI-compatible mode affects ask_memory synthesis only; save/search tools remain local.",
+            ],
+        };
+    }
+    return {
+        target,
+        title: "Command-backed synthesis",
+        summary: "Use any local subscription CLI or model command for ask_memory synthesis.",
+        env: {
+            PATHMARK_STORE_DIR: config.storeDir,
+            PATHMARK_SYNTHESIS_PROVIDER: "command",
+            PATHMARK_CHAT_COMMAND: "your-agent-cli chat --model your-model",
+        },
+        notes: ["PATHMARK_CHAT_COMMAND receives the memory prompt on stdin and must write an answer to stdout."],
+    };
+}
+function renderGuide(guide) {
+    const lines = [`# ${guide.title}`, "", guide.summary, ""];
+    if (guide.commands?.length) {
+        lines.push("Commands:", "");
+        lines.push(...guide.commands.map((command) => `  ${command}`));
+        lines.push("");
+    }
+    if (guide.config) {
+        lines.push("Config:", "");
+        lines.push(JSON.stringify(guide.config, null, 2));
+        lines.push("");
+    }
+    if (guide.env) {
+        lines.push("Environment:", "");
+        for (const [key, value] of Object.entries(guide.env))
+            lines.push(`  ${key}=${shellQuote(value)}`);
+        lines.push("");
+    }
+    if (guide.notes.length) {
+        lines.push("Notes:");
+        for (const note of guide.notes)
+            lines.push(`  - ${note}`);
+    }
+    return lines.join("\n");
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:@-]+$/.test(value))
+        return value;
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,27 @@
+import type { PathmarkConfig, PathmarkRecord, PathmarkRecordDraft, PathmarkRecordKind, SearchResult } from "./types.js";
+export declare class PathmarkStore {
+    private readonly config;
+    constructor(config: PathmarkConfig);
+    ensureReady(): Promise<void>;
+    add(input: PathmarkRecordDraft): Promise<PathmarkRecord>;
+    addRecord(input: PathmarkRecordDraft): Promise<{
+        record: PathmarkRecord;
+        created: boolean;
+    }>;
+    all(options?: {
+        includeDeleted?: boolean;
+        kind?: PathmarkRecordKind;
+    }): Promise<PathmarkRecord[]>;
+    count(): Promise<number>;
+    delete(id: string): Promise<PathmarkRecord | undefined>;
+    search(input: {
+        query: string;
+        limit?: number;
+        tags?: string[];
+        kind?: PathmarkRecordKind;
+    }): Promise<SearchResult[]>;
+    private readRecords;
+    private append;
+    private rewrite;
+    private withWriteLock;
+}

package/dist/store.js

@@ -0,0 +1,174 @@
+import { createHash, randomUUID } from "node:crypto";
+import { appendFile, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+const WORD_RE = /[\p{L}\p{N}_'-]+/gu;
+const LOCK_RETRY_MS = 10;
+const LOCK_TIMEOUT_MS = 5000;
+export class PathmarkStore {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async ensureReady() {
+        await mkdir(this.config.storeDir, { recursive: true });
+        await appendFile(this.config.memoryFile, "", "utf8");
+    }
+    async add(input) {
+        const { record } = await this.addRecord(input);
+        return record;
+    }
+    async addRecord(input) {
+        await this.ensureReady();
+        const now = new Date().toISOString();
+        const normalizedText = input.text.trim();
+        if (!normalizedText) {
+            throw new Error("text is required");
+        }
+        return this.withWriteLock(async () => {
+            const id = input.id?.trim() || randomUUID();
+            const existing = (await this.readRecords({ includeDeleted: true })).find((record) => record.id === id);
+            if (existing) {
+                return { record: existing, created: false };
+            }
+            const record = {
+                id,
+                kind: input.kind,
+                text: normalizedText,
+                tags: normalizeTags(input.tags ?? []),
+                source: input.source?.trim() || "mcp",
+                createdAt: input.createdAt ?? now,
+                updatedAt: input.updatedAt ?? input.createdAt ?? now,
+            };
+            await this.append(record);
+            return { record, created: true };
+        });
+    }
+    async all(options = {}) {
+        await this.ensureReady();
+        const records = await this.readRecords(options);
+        return records.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    async count() {
+        return (await this.all({ includeDeleted: true })).length;
+    }
+    async delete(id) {
+        await this.ensureReady();
+        return this.withWriteLock(async () => {
+            const records = await this.readRecords({ includeDeleted: true });
+            const existing = records.find((record) => record.id === id && !record.deletedAt);
+            if (!existing)
+                return undefined;
+            const now = new Date().toISOString();
+            const updatedRecords = records.map((record) => record.id === id ? { ...record, deletedAt: now, updatedAt: now } : record);
+            await this.rewrite(updatedRecords);
+            return { ...existing, deletedAt: now, updatedAt: now };
+        });
+    }
+    async search(input) {
+        const queryTerms = tokenize(input.query);
+        const tagFilter = normalizeTags(input.tags ?? []);
+        const records = await this.all({ kind: input.kind });
+        const limit = Math.max(1, Math.min(input.limit ?? this.config.maxSearchResults, 50));
+        if (queryTerms.length === 0 && tagFilter.length === 0) {
+            return records.slice(0, limit).map((record) => ({
+                record,
+                score: 1,
+                matchedTerms: [],
+            }));
+        }
+        return records
+            .filter((record) => tagFilter.every((tag) => record.tags.includes(tag)))
+            .map((record) => scoreRecord(record, queryTerms))
+            .filter((result) => queryTerms.length === 0 || result.matchedTerms.length > 0)
+            .sort((a, b) => b.score - a.score || b.record.createdAt.localeCompare(a.record.createdAt))
+            .slice(0, limit);
+    }
+    async readRecords(options = {}) {
+        const raw = await readFile(this.config.memoryFile, "utf8");
+        return raw
+            .split("\n")
+            .filter(Boolean)
+            .map((line) => JSON.parse(line))
+            .filter((record) => options.includeDeleted || !record.deletedAt)
+            .filter((record) => !options.kind || record.kind === options.kind);
+    }
+    async append(record) {
+        const line = `${JSON.stringify(record)}\n`;
+        await appendFile(this.config.memoryFile, line, "utf8");
+    }
+    async rewrite(records) {
+        await mkdir(this.config.storeDir, { recursive: true });
+        const tmp = path.join(this.config.storeDir, `.memory.${createHash("sha256").update(String(Date.now())).digest("hex").slice(0, 8)}.tmp`);
+        const body = records.map((record) => JSON.stringify(record)).join("\n");
+        await writeFile(tmp, body ? `${body}\n` : "", "utf8");
+        await rename(tmp, this.config.memoryFile);
+    }
+    async withWriteLock(operation) {
+        await mkdir(this.config.storeDir, { recursive: true });
+        const lockDir = path.join(this.config.storeDir, ".memory.lock");
+        const startedAt = Date.now();
+        while (true) {
+            try {
+                await mkdir(lockDir);
+                break;
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+                if (Date.now() - startedAt > LOCK_TIMEOUT_MS) {
+                    throw new Error(`Timed out waiting for Pathmark store lock: ${lockDir}`);
+                }
+                await sleep(LOCK_RETRY_MS);
+            }
+        }
+        try {
+            return await operation();
+        }
+        finally {
+            await rm(lockDir, { force: true, recursive: true });
+        }
+    }
+}
+function normalizeTags(tags) {
+    return [...new Set(tags.map((tag) => tag.trim().toLowerCase()).filter(Boolean))].sort();
+}
+function tokenize(text) {
+    return [...new Set((text.toLowerCase().match(WORD_RE) ?? []).filter((term) => term.length > 1))];
+}
+function scoreRecord(record, queryTerms) {
+    const haystack = `${record.text} ${record.tags.join(" ")} ${record.source}`.toLowerCase();
+    const textTerms = tokenize(record.text);
+    const matchedTerms = queryTerms.filter((term) => haystack.includes(term));
+    const exactTextMatches = matchedTerms.filter((term) => textTerms.includes(term)).length;
+    const tagMatches = matchedTerms.filter((term) => record.tags.includes(term)).length;
+    const priority = scorePriority(record);
+    return {
+        record,
+        score: matchedTerms.length + exactTextMatches * 2 + tagMatches * 3 + priority,
+        matchedTerms,
+    };
+}
+function scorePriority(record) {
+    let priority = 0;
+    if (record.kind === "conclusion")
+        priority += 8;
+    if (record.tags.includes("codex-summary"))
+        priority += 6;
+    if (record.tags.includes("project-note"))
+        priority += 5;
+    if (record.tags.includes("decision"))
+        priority += 5;
+    if (record.tags.includes("role-user"))
+        priority += 3;
+    if (record.tags.includes("role-assistant"))
+        priority += 2;
+    if (record.tags.includes("role-tool"))
+        priority -= 4;
+    if (record.tags.includes("honcho-import"))
+        priority -= 1;
+    return priority;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=store.js.map