pathmark 0.1.0

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+export type PathmarkRecordKind = "memory" | "conclusion";
+export interface PathmarkRecord {
+    id: string;
+    kind: PathmarkRecordKind;
+    text: string;
+    tags: string[];
+    source: string;
+    createdAt: string;
+    updatedAt: string;
+    deletedAt?: string;
+}
+export interface PathmarkRecordDraft {
+    id?: string;
+    kind: PathmarkRecordKind;
+    text: string;
+    tags?: string[];
+    source?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface PathmarkConfig {
+    storeDir: string;
+    memoryFile: string;
+    synthesisProvider: "client" | "command" | "codex" | "openai-compatible";
+    chatCommand?: string;
+    codexCommand: string;
+    codexModel?: string;
+    openaiBaseUrl: string;
+    openaiApiKey?: string;
+    openaiModel?: string;
+    chatTimeoutMs: number;
+    maxSearchResults: number;
+}
+export interface SearchResult {
+    record: PathmarkRecord;
+    score: number;
+    matchedTerms: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/claude_code.md

@@ -0,0 +1,21 @@
+# Claude Code Setup
+
+Install:
+
+```bash
+npm install -g pathmark
+```
+
+Register the MCP server:
+
+```bash
+claude mcp add pathmark -- pathmark
+```
+
+Generate this snippet from the installed CLI:
+
+```bash
+pathmark setup claude-code
+```
+
+Use the same `PATHMARK_STORE_DIR` as your other harnesses when you want shared memory.

package/examples/claude_desktop_config.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark",
+      "env": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory"
+      }
+    }
+  }
+}

package/examples/codex.md

@@ -0,0 +1,39 @@
+# Codex Setup
+
+Install:
+
+```bash
+npm install -g pathmark
+```
+
+Register the MCP server:
+
+```bash
+codex mcp add pathmark -- pathmark
+```
+
+Enable Codex auto-capture hooks:
+
+```bash
+pathmark codex install --replace-honcho
+```
+
+Check status:
+
+```bash
+pathmark codex status
+```
+
+Optional local store override:
+
+```bash
+codex mcp add pathmark --env PATHMARK_STORE_DIR=~/.pathmark/memory -- pathmark
+```
+
+Use the MCP tools from Codex:
+
+- `remember`
+- `search_memory`
+- `get_context`
+- `create_conclusion`
+- `ask_memory`

package/examples/cursor_mcp_config.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark",
+      "env": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory"
+      }
+    }
+  }
+}

package/examples/gemini_settings.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark",
+      "args": [],
+      "env": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory",
+        "PATHMARK_SYNTHESIS_PROVIDER": "client"
+      }
+    }
+  }
+}

package/examples/generic_mcp_config.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "pathmark": {
+      "command": "pathmark",
+      "args": [],
+      "env": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory",
+        "PATHMARK_SYNTHESIS_PROVIDER": "client"
+      }
+    }
+  }
+}

package/examples/openai_compatible.env

@@ -0,0 +1,8 @@
+PATHMARK_STORE_DIR=~/.pathmark/memory
+PATHMARK_SYNTHESIS_PROVIDER=openai-compatible
+PATHMARK_OPENAI_BASE_URL=https://api.provider.example/v1
+PATHMARK_OPENAI_API_KEY=
+PATHMARK_OPENAI_MODEL=
+
+# Works for Kimi, GLM/Z.ai, OpenRouter, LiteLLM, local gateways, and similar
+# OpenAI-compatible /chat/completions providers.

package/examples/opencode.jsonc

@@ -0,0 +1,13 @@
+{
+  "mcp": {
+    "pathmark": {
+      "type": "local",
+      "command": ["pathmark"],
+      "enabled": true,
+      "environment": {
+        "PATHMARK_STORE_DIR": "~/.pathmark/memory",
+        "PATHMARK_SYNTHESIS_PROVIDER": "client"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "pathmark",
+  "version": "0.1.0",
+  "description": "Cross-harness local memory for Codex, Claude Code, opencode, Cursor, Gemini CLI, and other MCP-capable AI agents.",
+  "type": "module",
+  "bin": {
+    "pathmark": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "assets/pathmark-icon-v3-glyph.png",
+    "README.md",
+    "SECURITY.md",
+    "LICENSE",
+    "examples",
+    "scripts/import-honcho.mjs"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "smoke": "node scripts/smoke.mjs",
+    "test": "npm run build && npm run smoke && npm run test:setup && npm run test:codex-adapter",
+    "test:setup": "npm run build && node scripts/test-setup.mjs",
+    "test:codex-adapter": "npm run build && node scripts/test-codex-adapter.mjs",
+    "import:honcho": "node scripts/import-honcho.mjs",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "memory",
+    "local-first",
+    "codex",
+    "claude",
+    "claude-code",
+    "cursor",
+    "opencode",
+    "gemini",
+    "gemini-cli",
+    "kimi",
+    "glm",
+    "mcp-server"
+  ],
+  "author": "",
+  "license": "MIT",
+  "homepage": "https://github.com/hacksurvivor/pathmark#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hacksurvivor/pathmark.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hacksurvivor/pathmark/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/import-honcho.mjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+import { createHash } from "node:crypto";
+import { mkdir, readFile, readdir, rename, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+const DEFAULT_HONCHO_DIR = "~/.honcho/codex/local";
+const DEFAULT_PATHMARK_DIR = "~/.pathmark/memory";
+
+const args = parseArgs(process.argv.slice(2));
+const honchoDir = expandHome(args["honcho-dir"] ?? process.env.HONCHO_STORE_DIR ?? DEFAULT_HONCHO_DIR);
+const pathmarkDir = expandHome(args["pathmark-dir"] ?? process.env.PATHMARK_STORE_DIR ?? DEFAULT_PATHMARK_DIR);
+const memoryFile = path.join(pathmarkDir, "memory.jsonl");
+const dryRun = Boolean(args["dry-run"]);
+const noBackup = Boolean(args["no-backup"]);
+
+const stats = {
+  conclusionsRead: 0,
+  sessionsRead: 0,
+  recordsPrepared: 0,
+  duplicatesSkipped: 0,
+  invalidLinesSkipped: 0,
+  emptySkipped: 0,
+  redactedRecords: 0,
+  written: 0,
+};
+
+await assertDirectory(honchoDir, "Honcho store");
+await mkdir(pathmarkDir, { recursive: true });
+await ensureFile(memoryFile);
+
+const existingRecords = await readJsonl(memoryFile);
+const existingIds = new Set(existingRecords.records.map((record) => record.id));
+const imported = [];
+
+await importConclusions();
+await importSessions();
+
+const newRecords = imported.filter((record) => {
+  if (existingIds.has(record.id)) {
+    stats.duplicatesSkipped += 1;
+    return false;
+  }
+  existingIds.add(record.id);
+  return true;
+});
+
+stats.written = newRecords.length;
+
+if (!dryRun && newRecords.length > 0) {
+  if (!noBackup) {
+    const backupFile = path.join(pathmarkDir, `memory.jsonl.backup-${timestamp()}`);
+    await writeFile(backupFile, await readFile(memoryFile, "utf8"), "utf8");
+  }
+
+  const body = [...existingRecords.records, ...newRecords].map((record) => JSON.stringify(record)).join("\n");
+  const tmp = path.join(pathmarkDir, `.memory.import-honcho.${Date.now()}.tmp`);
+  await writeFile(tmp, body ? `${body}\n` : "", "utf8");
+  await rename(tmp, memoryFile);
+}
+
+console.log(
+  JSON.stringify(
+    {
+      honchoDir,
+      pathmarkDir,
+      memoryFile,
+      dryRun,
+      ...stats,
+      existingPathmarkRecords: existingRecords.records.length,
+      parseErrorsInExistingPathmark: existingRecords.invalidLines,
+    },
+    null,
+    2,
+  ),
+);
+
+async function importConclusions() {
+  const file = path.join(honchoDir, "conclusions.jsonl");
+  if (!(await exists(file))) return;
+
+  const parsed = await readJsonl(file);
+  stats.invalidLinesSkipped += parsed.invalidLines;
+
+  for (const raw of parsed.records) {
+    stats.conclusionsRead += 1;
+    const text = String(raw.text ?? "").trim();
+    if (!text) {
+      stats.emptySkipped += 1;
+      continue;
+    }
+
+    const redacted = redact(text);
+    if (redacted.changed) stats.redactedRecords += 1;
+
+    imported.push({
+      id: deterministicId(`honcho:conclusion:${raw.id ?? text}`),
+      kind: "conclusion",
+      text: redacted.text,
+      tags: ["honcho-conclusion", "honcho-import"],
+      source: "honcho:conclusions",
+      createdAt: isoDate(raw.createdAt),
+      updatedAt: isoDate(raw.createdAt),
+    });
+    stats.recordsPrepared += 1;
+  }
+}
+
+async function importSessions() {
+  const sessionsDir = path.join(honchoDir, "sessions");
+  if (!(await exists(sessionsDir))) return;
+
+  const files = (await readdir(sessionsDir)).filter((file) => file.endsWith(".jsonl")).sort();
+  for (const fileName of files) {
+    const file = path.join(sessionsDir, fileName);
+    const parsed = await readJsonl(file);
+    stats.invalidLinesSkipped += parsed.invalidLines;
+
+    for (const [index, raw] of parsed.records.entries()) {
+      stats.sessionsRead += 1;
+      const text = String(raw.text ?? "").trim();
+      if (!text) {
+        stats.emptySkipped += 1;
+        continue;
+      }
+
+      const session = String(raw.session ?? path.basename(fileName, ".jsonl"));
+      const role = normalizeRole(raw.role);
+      const redacted = redact(text);
+      if (redacted.changed) stats.redactedRecords += 1;
+
+      imported.push({
+        id: deterministicId(`honcho:session:${session}:${index}:${role}:${text}`),
+        kind: "memory",
+        text: redacted.text,
+        tags: ["honcho-import", "honcho-session", `role-${role}`],
+        source: `honcho:session:${session}`,
+        createdAt: isoDate(raw.at),
+        updatedAt: isoDate(raw.at),
+      });
+      stats.recordsPrepared += 1;
+    }
+  }
+}
+
+async function readJsonl(file) {
+  const raw = await readFile(file, "utf8");
+  const records = [];
+  let invalidLines = 0;
+
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      records.push(JSON.parse(line));
+    } catch {
+      invalidLines += 1;
+    }
+  }
+
+  return { records, invalidLines };
+}
+
+async function assertDirectory(dir, label) {
+  const info = await stat(dir).catch(() => undefined);
+  if (!info?.isDirectory()) {
+    throw new Error(`${label} not found or not a directory: ${dir}`);
+  }
+}
+
+async function ensureFile(file) {
+  if (await exists(file)) return;
+  await writeFile(file, "", "utf8");
+}
+
+async function exists(file) {
+  try {
+    await stat(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function parseArgs(argv) {
+  const parsed = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg.startsWith("--")) continue;
+    const key = arg.slice(2);
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) {
+      parsed[key] = true;
+      continue;
+    }
+    parsed[key] = next;
+    index += 1;
+  }
+  return parsed;
+}
+
+function expandHome(value) {
+  if (value === "~") return os.homedir();
+  if (value.startsWith("~/")) return path.join(os.homedir(), value.slice(2));
+  return value;
+}
+
+function deterministicId(value) {
+  const hash = createHash("sha256").update(value).digest("hex");
+  return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+}
+
+function isoDate(value) {
+  const date = value ? new Date(value) : new Date();
+  if (Number.isNaN(date.getTime())) return new Date().toISOString();
+  return date.toISOString();
+}
+
+function normalizeRole(value) {
+  return String(value ?? "unknown")
+    .toLowerCase()
+    .replace(/[^a-z0-9_-]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 40) || "unknown";
+}
+
+function redact(text) {
+  let changed = false;
+  const redacted = text
+    .replace(/\b([A-Z0-9_]*(?:API[_-]?KEY|SECRET|TOKEN|PASSWORD|PRIVATE[_-]?KEY)[A-Z0-9_]*)\s*[:=]\s*(['"]?)([^\s'",}]{8,})\2/gi, (_match, name) => {
+      changed = true;
+      return `${name}=[REDACTED]`;
+    })
+    .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]{12,}/g, () => {
+      changed = true;
+      return "Bearer [REDACTED]";
+    });
+
+  return { text: redacted, changed };
+}
+
+function timestamp() {
+  return new Date().toISOString().replace(/[:.]/g, "-");
+}