opencode-harnmem 0.0.0-stage → 0.1.0

package/lib/format.mjs

@@ -0,0 +1,119 @@
+/**
+ * Model-facing text formatting for MCP tool results and /memory output.
+ * Port of packages/pi-harnmem/src/format.ts so every harness shows identical
+ * tool-output shapes. Tool results are the only place where live data may
+ * appear; the injected snapshot stays byte-stable (nothing here is injected).
+ */
+
+const MAX_TOOL_TEXT = 12_000;
+
+function clip(text, max = MAX_TOOL_TEXT) {
+  if (text.length <= max) return text;
+  return text.slice(0, max) + `\n…[truncated ${text.length - max} chars]`;
+}
+
+function fmtTime(ms) {
+  if (!ms) return "-";
+  return new Date(ms).toISOString().slice(0, 10);
+}
+
+export function formatWrite(result) {
+  const lines = [];
+  switch (result.action) {
+    case "NEW":
+      lines.push(`stored ${result.id} (NEW)`);
+      break;
+    case "SKIP":
+      lines.push(`already exists ${result.id} (SKIP)`);
+      break;
+    case "MERGE":
+      lines.push(`merged into ${result.id} (MERGE)`);
+      break;
+    case "SUPERSEDE":
+      lines.push(`superseded ${result.superseded.join(", ") || "(none)"} → ${result.id}`);
+      break;
+    case "LINK":
+      lines.push(`linked to existing ${result.id} (LINK)`);
+      break;
+    default:
+      lines.push(`write result: ${result.action} ${result.id}`);
+  }
+  if (result.warnings?.length) lines.push(`warnings: ${result.warnings.join("; ")}`);
+  // Contract (docs/adapter-authoring.md §2): the write tool returns exactly one
+  // line — "stored mem_x (NEW)" / "(SKIP)" / "superseded a → b" — no guidance.
+  return clip(lines.join("\n"));
+}
+
+export function formatSearch(result) {
+  if (result.abstained || result.results.length === 0) {
+    return clip(
+      `no confident memories for "${result.query}" (abstained). Try different keywords, or the memory status tool to inspect the store.`,
+    );
+  }
+  const lines = [`${result.results.length}/${result.total} matches for "${result.query}":`];
+  for (const hit of result.results) {
+    const flags = [hit.status !== "active" ? hit.status : "", hit.pinned ? "pinned" : "", hit.historical ? "historical" : ""]
+      .filter(Boolean)
+      .join(",");
+    lines.push(
+      `- ${hit.id} [${hit.type}${hit.category ? "/" + hit.category : ""}${flags ? " (" + flags + ")" : ""}] ${hit.title} — ${hit.description}` +
+        (hit.snippet ? `\n  ${hit.snippet.replace(/\s+/g, " ").slice(0, 240)}` : ""),
+    );
+  }
+  if (result.debug) {
+    // Defensive (matches the codex adapter): shards is typed string[] but a
+    // hostile/host-reshaped object must not throw inside a tool result.
+    const shards = Array.isArray(result.debug.shards) ? result.debug.shards.join(",") : String(result.debug.shards ?? "?");
+    lines.push(`debug: candidates=${result.debug.candidateCount} shards=${shards} elapsed=${result.debug.elapsedMs}ms`);
+  }
+  lines.push("Call the memory read tool with a hit id to open the record.");
+  return clip(lines.join("\n"));
+}
+
+export function formatRead(result, id) {
+  if (!result) return `not found: ${id}`;
+  const r = result.record;
+  const lines = [
+    `${r.id} [${r.type}${r.category ? "/" + r.category : ""}] ${r.scope}${r.project ? "/" + r.project : ""} status=${r.status} importance=${r.importance} confidence=${r.confidence}${r.pinned ? " pinned" : ""}`,
+    `title: ${r.title}`,
+    `description: ${r.description}`,
+    `updated: ${fmtTime(r.updated)} created: ${fmtTime(r.created)} valid: ${fmtTime(r.validFrom)} → ${r.validTo ? fmtTime(r.validTo) : "now"}`,
+  ];
+  if (r.tags?.length) lines.push(`tags: ${r.tags.join(", ")}`);
+  if (r.entities?.length) lines.push(`entities: ${r.entities.join(", ")}`);
+  if (r.links?.length) lines.push(`links: ${r.links.join(", ")}`);
+  if (result.backlinks?.length) lines.push(`backlinks: ${result.backlinks.join(", ")}`);
+  if (result.history?.length) lines.push(`history: ${result.history.map((h) => h.id).join(", ")}`);
+  lines.push("", r.content);
+  return clip(lines.join("\n"));
+}
+
+export function formatForget(result) {
+  return result.ok
+    ? result.mode === "hard"
+      ? `permanently deleted ${result.id}`
+      : `moved ${result.id} to trash (restorable for the grace period; restore with the harnmem CLI)`
+    : `could not forget ${result.id}`;
+}
+
+export function formatStats(stats) {
+  const lines = [
+    `harnmem v${stats.version} home=${stats.home}`,
+    `project: ${stats.project ?? "(none)"}`,
+    `index: seq=${stats.index.seq} stale=${stats.index.stale} built=${fmtTime(stats.index.builtAt)} size=${stats.index.sizeBytes}B overhead=${(stats.index.overhead * 100).toFixed(0)}%`,
+  ];
+  for (const shard of stats.shards) {
+    lines.push(
+      `shard ${shard.name} [${shard.scope}] total=${shard.total} active=${shard.active} superseded=${shard.superseded} archived=${shard.archived} pinned=${shard.pinned} ${Math.round(shard.bytes / 1024)}KB`,
+    );
+  }
+  if (stats.shards.length === 0) lines.push("no shards yet (empty store)");
+  lines.push(
+    `health: overBudget=${stats.health.overBudget} duplicates=${stats.health.duplicateCandidates} orphans=${stats.health.orphans} lastConsolidate=${stats.health.lastConsolidate ? fmtTime(stats.health.lastConsolidate) : "never"}`,
+  );
+  lines.push(
+    `extraction: pending=${stats.extraction.pending} failed=${stats.extraction.failed}` +
+      (Object.keys(stats.extraction.skipReasons).length ? ` skip=${JSON.stringify(stats.extraction.skipReasons)}` : ""),
+  );
+  return clip(lines.join("\n"));
+}

package/lib/settings.mjs

@@ -0,0 +1,131 @@
+/**
+ * Settings resolution for the opencode adapter.
+ *
+ * Priority (low -> high), matching docs/design/07-adapter-contract.md §7:
+ *   1. `<home>/config.json` (default `~/.harnmem/config.json`)
+ *   2. `<cwd>/.harnmem.json` (project config)
+ *   3. environment variables (HARNMEM_HOME, HARNMEM_DISABLED, ...)
+ *
+ * The chain and defaults are identical to the claude adapter; only the
+ * max-inject-tokens env var is harness-scoped. Malformed JSON is ignored,
+ * never fatal.
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+
+const KNOWN_KEYS = ["enabled", "readOnly", "inject", "autoExtract", "debug", "home", "project", "maxInjectTokens"];
+
+const DEFAULTS = {
+  enabled: true,
+  readOnly: false,
+  inject: true,
+  autoExtract: false,
+  debug: false,
+  maxInjectTokens: 1200,
+};
+
+function truthy(value) {
+  if (value === undefined) return undefined;
+  const v = String(value).trim().toLowerCase();
+  if (v === "" || v === "0" || v === "false" || v === "no" || v === "off") return false;
+  return true;
+}
+
+/**
+ * Expand a leading `~` to the user home before path.resolve(): core would
+ * expand it, but by then the adapter has already resolved `~/x` into
+ * `<cwd>\~\x`. Probed failure mode shared with the other adapters.
+ */
+function expandHome(value) {
+  if (typeof value !== "string") return value;
+  const t = value.trim();
+  if (t === "~") return homedir();
+  if (t.startsWith("~/") || t.startsWith("~\\")) return path.join(homedir(), t.slice(2));
+  return t;
+}
+
+function readSettingsFile(file) {
+  if (!existsSync(file)) return undefined;
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return undefined;
+    return parsed;
+  } catch {
+    return undefined;
+  }
+}
+
+function pickKnown(source) {
+  if (!source) return {};
+  const out = {};
+  // Skip null explicitly: "enabled": null in a config file must fall back to
+  // the default (true), not be treated as a falsy override that disables the
+  // store.
+  for (const key of KNOWN_KEYS) {
+    if (source[key] === undefined || source[key] === null) continue;
+    out[key] = source[key];
+  }
+  return out;
+}
+
+const BOOL_KEYS = ["enabled", "readOnly", "inject", "autoExtract", "debug"];
+
+/**
+ * Config files are user-edited JSON: coerce boolean-ish strings the same way
+ * the env path does ("enabled": "false" must disable, not stay truthy), and
+ * validate maxInjectTokens like the env path (no strings/zero/negatives
+ * straight into core's token budget).
+ */
+function coerceFileValues(settings) {
+  for (const key of BOOL_KEYS) {
+    if (typeof settings[key] !== "string") continue;
+    const v = truthy(settings[key]);
+    if (v === undefined) delete settings[key];
+    else settings[key] = v;
+  }
+  if (settings.maxInjectTokens !== undefined) {
+    const n = Number(settings.maxInjectTokens);
+    if (!Number.isFinite(n) || n <= 0) delete settings.maxInjectTokens;
+    else settings.maxInjectTokens = Math.floor(n);
+  }
+  return settings;
+}
+
+export function resolveSettings(cwd = process.cwd(), env = process.env) {
+  const envHome = expandHome(env.HARNMEM_HOME);
+  const baseHome = envHome && envHome.trim() ? path.resolve(envHome) : path.join(homedir(), ".harnmem");
+
+  let settings = { ...DEFAULTS };
+  settings = coerceFileValues({ ...settings, ...pickKnown(readSettingsFile(path.join(baseHome, "config.json"))) });
+  settings = coerceFileValues({ ...settings, ...pickKnown(readSettingsFile(path.join(cwd, ".harnmem.json"))) });
+
+  const disabled = truthy(env.HARNMEM_DISABLED);
+  if (disabled !== undefined) settings.enabled = !disabled;
+  const ro = truthy(env.HARNMEM_READONLY);
+  if (ro !== undefined) settings.readOnly = ro;
+  const dbg = truthy(env.HARNMEM_DEBUG);
+  if (dbg !== undefined) settings.debug = dbg;
+  const ae = truthy(env.HARNMEM_AUTO_EXTRACT);
+  if (ae !== undefined) settings.autoExtract = ae;
+  const inj = truthy(env.HARNMEM_INJECT);
+  if (inj !== undefined) settings.inject = inj;
+  if (env.HARNMEM_OPENCODE_MAX_INJECT_TOKENS) {
+    const n = Number(env.HARNMEM_OPENCODE_MAX_INJECT_TOKENS);
+    if (Number.isFinite(n) && n > 0) settings.maxInjectTokens = Math.floor(n);
+  }
+
+  const home =
+    envHome && envHome.trim()
+      ? path.resolve(envHome)
+      : typeof settings.home === "string" && settings.home.trim()
+        ? path.resolve(expandHome(settings.home))
+        : baseHome;
+
+  return { ...settings, home };
+}
+
+export function debugEnabled(settings) {
+  return settings.debug === true;
+}

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "opencode-harnmem",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "opencode v2 plugin for HarnMem: byte-stable memory injection (session context hook), five native memory tools, and per-turn session journaling — in-process, zero runtime dependencies.",
+  "license": "MIT",
+  "files": [
+    "index.js",
+    "lib/",
+    "vendor/",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "index.js",
+  "devDependencies": {
+    "@harnmem/core": "0.4.0"
+  },
+  "engines": {
+    "node": ">=22.15"
+  },
+  "scripts": {
+    "build": "node scripts/vendor.mjs",
+    "test": "node --test test/*.test.mjs"
+  }
 }

package/vendor/core/assets.d.ts

@@ -0,0 +1,52 @@
+export interface PromptAsset {
+    name: string;
+    version: number;
+    /** Stable system prompt (no placeholders). */
+    system: string;
+    /** User template with {{placeholders}}; null for legacy single-string prompts. */
+    user: string | null;
+    /** Where the asset was read from (diagnostics). */
+    source: string;
+}
+/** Repository/package root that contains `prompts/extract.md`, if discoverable. */
+export declare function findAssetRoot(): string | null;
+/** Read an asset, preferring the user's copy in <home>, then the shipped default. */
+export declare function readAssetRaw(home: string, relativePath: string): {
+    text: string;
+    source: string;
+} | null;
+/**
+ * Synonym tables available to the engine: shipped defaults plus the user's
+ * editable copies, deduplicated by filename and sorted for deterministic
+ * loading. A language is added by adding `data/synonyms.<lang>.txt` — no code
+ * change; the `<home>` copy of a filename overrides the shipped default of the
+ * same name.
+ */
+export declare function listSynonymFiles(home: string): string[];
+/**
+ * Parse one synonym table. Shipped format is `canonical<TAB>syn1,syn2`;
+ * `=`, `:` and full-width `：` are accepted as separators too, and synonyms may
+ * be separated by `,`, `，` or `、`. Blank lines and `#` comments are ignored.
+ */
+export declare function parseSynonymTable(raw: string): string[][];
+/** All synonym groups from every discovered table; `files` is for diagnostics. */
+export declare function loadSynonymGroups(home: string): {
+    groups: string[][];
+    files: string[];
+};
+/** Split a prompt file into stable system text + user template. */
+export declare function parsePromptAsset(name: string, raw: string, source?: string): PromptAsset;
+/** Load a prompt asset from <home>/prompts or the shipped defaults. */
+export declare function loadPromptAsset(home: string, name: string): PromptAsset | null;
+/** Replace `{{name}}` placeholders. Unknown placeholders are left in place on purpose. */
+export declare function fillPrompt(template: string, vars: Record<string, string>): string;
+export interface DeployResult {
+    copied: string[];
+    root: string | null;
+}
+/**
+ * Copy shipped defaults into <home>/ the first time they are needed. Existing
+ * user files are never overwritten. Returns copied paths (home-relative).
+ */
+export declare function deployDefaultAssets(home: string): DeployResult;
+//# sourceMappingURL=assets.d.ts.map

package/vendor/core/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,mFAAmF;AACnF,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAwB7C;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAaxG;AAQD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAevD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAazD;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAQvF;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,SAAa,GAAG,WAAW,CAqC5F;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAI9E;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMjF;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA0B9D"}

package/vendor/core/assets.js

@@ -0,0 +1,227 @@
+/**
+ * Prompt/data asset loading + first-run deployment.
+ *
+ * Assets are plain files so users can edit them:
+ *   <home>/prompts/*.md    extraction / consolidation prompts
+ *   <home>/data/*.txt      tokenizer synonym tables
+ *
+ * Shipped defaults live at the repository (or package) root next to `packages/`,
+ * found by walking up from this module. When that root is unavailable (e.g. a
+ * bundled single-file build) callers fall back to the constants in extract.ts.
+ *
+ * Prompt file contract (see prompts/README.md): HTML comments are metadata and
+ * stripped at load time; a prompt file may contain `## system` and `## user`
+ * sections. Placeholders `{{name}}` are only allowed in the user section so the
+ * system prompt stays byte-stable for KV-cache reuse.
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+let assetRootCache;
+/** Repository/package root that contains `prompts/extract.md`, if discoverable. */
+export function findAssetRoot() {
+    if (assetRootCache !== undefined)
+        return assetRootCache;
+    const candidates = [];
+    const env = process.env.HARNMEM_ASSETS_DIR;
+    if (env)
+        candidates.push(resolve(env));
+    try {
+        let dir = dirname(fileURLToPath(import.meta.url));
+        for (let i = 0; i < 8; i += 1) {
+            candidates.push(dir);
+            const parent = dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // import.meta.url is always available in ESM; ignore exotic loaders.
+    }
+    for (const candidate of candidates) {
+        if (existsSync(join(candidate, "prompts", "extract.md"))) {
+            assetRootCache = candidate;
+            return candidate;
+        }
+    }
+    assetRootCache = null;
+    return null;
+}
+/** Read an asset, preferring the user's copy in <home>, then the shipped default. */
+export function readAssetRaw(home, relativePath) {
+    const candidates = [join(home, relativePath)];
+    const root = findAssetRoot();
+    if (root)
+        candidates.push(join(root, relativePath));
+    for (const file of candidates) {
+        try {
+            const text = readFileSync(file, "utf8");
+            if (text.trim())
+                return { text, source: file };
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return null;
+}
+/**
+ * Language-tagged synonym tables: `synonyms.zh.txt`, `synonyms.en.txt`, ...;
+ * a bare `synonyms.txt` is accepted too.
+ */
+const SYNONYM_FILE_RE = /^synonyms(?:\.[a-z0-9_-]+)?\.txt$/i;
+/**
+ * Synonym tables available to the engine: shipped defaults plus the user's
+ * editable copies, deduplicated by filename and sorted for deterministic
+ * loading. A language is added by adding `data/synonyms.<lang>.txt` — no code
+ * change; the `<home>` copy of a filename overrides the shipped default of the
+ * same name.
+ */
+export function listSynonymFiles(home) {
+    const names = new Set();
+    const collect = (root) => {
+        if (!root)
+            return;
+        try {
+            for (const file of readdirSync(join(root, "data"))) {
+                if (SYNONYM_FILE_RE.test(file))
+                    names.add(file);
+            }
+        }
+        catch {
+            // optional directory
+        }
+    };
+    collect(home);
+    collect(findAssetRoot());
+    return [...names].sort();
+}
+/**
+ * Parse one synonym table. Shipped format is `canonical<TAB>syn1,syn2`;
+ * `=`, `:` and full-width `：` are accepted as separators too, and synonyms may
+ * be separated by `,`, `，` or `、`. Blank lines and `#` comments are ignored.
+ */
+export function parseSynonymTable(raw) {
+    const groups = [];
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const match = /^([^\t=:：]+)[\t=:：]+(.+)$/.exec(trimmed);
+        if (!match)
+            continue;
+        const head = match[1];
+        const tail = match[2];
+        const group = [head, ...tail.split(/[,，、]/)].map((s) => s.trim()).filter(Boolean);
+        if (group.length >= 2)
+            groups.push(group);
+    }
+    return groups;
+}
+/** All synonym groups from every discovered table; `files` is for diagnostics. */
+export function loadSynonymGroups(home) {
+    const files = listSynonymFiles(home);
+    const groups = [];
+    for (const file of files) {
+        const asset = readAssetRaw(home, join("data", file));
+        if (asset)
+            groups.push(...parseSynonymTable(asset.text));
+    }
+    return { groups, files };
+}
+/** Split a prompt file into stable system text + user template. */
+export function parsePromptAsset(name, raw, source = "(inline)") {
+    const header = /<!--\s*version:\s*(\d+)\s*-->/i.exec(raw);
+    const version = header ? Number(header[1]) : 1;
+    const stripped = raw.replace(/<!--[\s\S]*?-->/g, "").replace(/\r\n/g, "\n");
+    const lines = stripped.split("\n");
+    const sections = {
+        system: [],
+        user: [],
+        current: "system",
+    };
+    const markers = [];
+    lines.forEach((line, index) => {
+        const match = /^\s*##\s+(system|user)\s*$/.exec(line);
+        if (match) {
+            markers.push({ at: index, kind: match[1] });
+        }
+    });
+    let system;
+    let user = null;
+    if (markers.length === 0) {
+        // Legacy custom prompt: whole file is the system prompt.
+        system = stripped.trim();
+    }
+    else {
+        const first = markers[0];
+        const body = lines.slice(0, first.at).join("\n").trim();
+        if (body)
+            sections.system.push(body);
+        for (let i = 0; i < markers.length; i += 1) {
+            const marker = markers[i];
+            const next = markers[i + 1];
+            const chunk = lines.slice(marker.at + 1, next ? next.at : lines.length).join("\n").trim();
+            if (marker.kind === "system")
+                sections.system.push(chunk);
+            else
+                sections.user.push(chunk);
+        }
+        system = sections.system.filter(Boolean).join("\n\n").trim();
+        user = sections.user.filter(Boolean).join("\n\n").trim() || null;
+    }
+    return { name, version, system, user, source };
+}
+/** Load a prompt asset from <home>/prompts or the shipped defaults. */
+export function loadPromptAsset(home, name) {
+    const found = readAssetRaw(home, join("prompts", `${name}.md`));
+    if (!found)
+        return null;
+    return parsePromptAsset(name, found.text, found.source);
+}
+/** Replace `{{name}}` placeholders. Unknown placeholders are left in place on purpose. */
+export function fillPrompt(template, vars) {
+    let out = template;
+    for (const [key, value] of Object.entries(vars)) {
+        out = out.split(`{{${key}}}`).join(value);
+    }
+    return out;
+}
+/**
+ * Copy shipped defaults into <home>/ the first time they are needed. Existing
+ * user files are never overwritten. Returns copied paths (home-relative).
+ */
+export function deployDefaultAssets(home) {
+    const root = findAssetRoot();
+    if (!root)
+        return { copied: [], root: null };
+    const copied = [];
+    const copyTree = (relDir, filter) => {
+        const fromDir = join(root, relDir);
+        if (!existsSync(fromDir))
+            return;
+        const toDir = join(home, relDir);
+        mkdirSync(toDir, { recursive: true });
+        for (const file of readdirSync(fromDir)) {
+            if (!filter(file))
+                continue;
+            const from = join(fromDir, file);
+            const to = join(toDir, file);
+            if (existsSync(to))
+                continue;
+            try {
+                readFileSync(from); // existence/readability check
+                copyFileSync(from, to);
+                copied.push(join(relDir, file).replace(/\\/g, "/"));
+            }
+            catch {
+                // deployment is best-effort
+            }
+        }
+    };
+    copyTree("prompts", (file) => file.endsWith(".md") || file.endsWith(".txt"));
+    copyTree("data", (file) => file.endsWith(".txt") || file.endsWith(".tsv"));
+    return { copied, root };
+}
+//# sourceMappingURL=assets.js.map

package/vendor/core/assets.js.map

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

package/vendor/core/config.d.ts

@@ -0,0 +1,36 @@
+import type { BudgetConfig, HarnMemConfig, GovernanceConfig, RetrievalConfig, WriteConfig } from "./types.js";
+import { type FieldConfig } from "./text.js";
+export declare const DEFAULT_BUDGET: BudgetConfig;
+type FullRetrieval = RetrievalConfig;
+type FullWrite = WriteConfig;
+type FullGovernance = GovernanceConfig;
+export declare const DEFAULT_RETRIEVAL: FullRetrieval;
+export declare const DEFAULT_WRITE: FullWrite;
+export declare const DEFAULT_GOVERNANCE: FullGovernance;
+export interface Defaults {
+    home: string;
+    harness: string;
+    cwd: string;
+    now: () => number;
+    budget: BudgetConfig;
+    retrieval: FullRetrieval;
+    write: FullWrite;
+    governance: FullGovernance;
+}
+export declare const DEFAULT_CONFIG: Defaults;
+export declare function mergeConfig(base: HarnMemConfig, override: HarnMemConfig | undefined): HarnMemConfig;
+/**
+ * Load config from the home config file and the project-local `.harnmem.json`
+ * (if any), then apply explicit overrides.
+ */
+export declare function loadConfig(home: string, projectRoot: string | undefined, explicit: HarnMemConfig | undefined): Promise<HarnMemConfig>;
+export declare function fieldsOf(config: HarnMemConfig): FieldConfig;
+/** Resolved ttl days for a type. */
+export declare function ttlDays(config: HarnMemConfig, type: string): number;
+/** Resolved retrieval config with all defaults applied. */
+export declare function retrievalOf(config: HarnMemConfig): FullRetrieval;
+export declare function writeOf(config: HarnMemConfig): FullWrite;
+export declare function governanceOf(config: HarnMemConfig): FullGovernance;
+export declare function budgetOf(config: HarnMemConfig): BudgetConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/vendor/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7D,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AAEF,KAAK,aAAa,GAAG,eAAe,CAAC;AACrC,KAAK,SAAS,GAAG,WAAW,CAAC;AAC7B,KAAK,cAAc,GAAG,gBAAgB,CAAC;AAEvC,eAAO,MAAM,iBAAiB,EAAE,aAe/B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAQ3B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAQhC,CAAC;AAEF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,EAAE,QAS5B,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAcnG;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAE3D;AAED,oCAAoC;AACpC,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEhE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAExD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAElE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAE5D"}