opencode-harnmem 0.0.0-stage → 0.1.0

package/vendor/core/extract.d.ts

@@ -0,0 +1,49 @@
+import type { HarnMemConfig, LlmFn, MemoryType, TranscriptMessage } from "./types.js";
+import { type PromptAsset } from "./assets.js";
+export interface ExtractedMemory {
+    title: string;
+    description: string;
+    content: string;
+    type: MemoryType;
+    scope?: "user" | "project";
+    category?: string;
+    tags?: string[];
+    entities?: string[];
+    importance?: number;
+    confidence?: number;
+    links?: string[];
+    supersedes?: string[];
+    evidence?: string[];
+}
+export interface ExistingMemoryRef {
+    id: string;
+    title: string;
+    type: string;
+    description: string;
+}
+export interface ExtractionInput {
+    messages: TranscriptMessage[];
+    existing: ExistingMemoryRef[];
+    projectName?: string;
+    date: string;
+}
+export declare const DEFAULT_EXTRACT_PROMPT = "You extract durable memory from a coding-assistant session transcript.\nReturn JSON only: {\"memories\": [ {\"title\": string, \"description\": string (one sentence, <=160 chars), \"content\": string (markdown, 3-12 lines), \"type\": \"user\"|\"feedback\"|\"project\"|\"reference\", \"scope\": \"user\"|\"project\", \"category\": string, \"tags\": string[], \"entities\": string[], \"importance\": number (0-10), \"confidence\": number (0-1), \"links\": string[] (existing memory ids only)} ]}\n\nRules:\n1. Only durable, reusable knowledge: user identity/preferences/workflow constraints (type user), corrections and lessons that change future behavior (type feedback; always include **Why:** and **How to apply:** lines in content), project architecture/decisions/conventions/facts (type project), external pointers/URLs/docs (type reference).\n2. Do NOT store: transient task state, code that is in the repo, facts already covered by AGENTS.md/project docs, secrets, or anything the user did not state or confirm.\n3. Same language as the user's conversation (Chinese stays Chinese).\n4. Every entry needs an Observation Date from the transcript; put it as the first line of content: \"Observed: YYYY-MM-DD\".\n5. Avoid duplicating existing memories (see list). If related, link by id instead of restating.\n6. Exhaustive extraction: cover every distinct durable fact in the digest; do not stop after the first topic. Max 6 entries.\n7. If nothing is durable, return {\"memories\": []}.\n8. Never invent ids, versions, numbers or dates.";
+export declare const DEFAULT_CONSOLIDATE_PROMPT = "You consolidate a personal memory store into a topical digest.\nReturn JSON only: {\"digest\": {\"title\": string, \"content\": string (markdown, <=40 lines), \"sources\": string[] (memory ids)}}\nMerge overlapping facts, resolve contradictions in favor of the newest observation, drop stale details, keep concrete numbers and dates. Do not invent facts.";
+/**
+ * Resolve a prompt asset: user copy in <home>/prompts first, shipped default
+ * second, inline constant last. Returns the parsed asset so callers can use the
+ * stable system text and fill the user template with data.
+ */
+export declare function resolvePrompt(home: string, name: string, fallbackSystem: string): PromptAsset;
+/** Build the bounded transcript digest sent to the extraction model. */
+export declare function buildDigest(messages: TranscriptMessage[], maxChars?: number): string;
+/** Existing-memory list for dedupe context: `[id] (type) title — description`. */
+export declare function buildExistingList(existing: ExistingMemoryRef[], max?: number): string;
+/** Parse the JSON payload from a (possibly chatty) model response. */
+export declare function parseExtractionResponse(text: string): ExtractedMemory[];
+/** One bounded extraction call. Returns [] when the LLM is absent or output is unusable. */
+export declare function runExtraction(llm: LlmFn | undefined, config: HarnMemConfig, input: ExtractionInput): Promise<ExtractedMemory[]>;
+/** Read a session journal file back into messages (adapter-free harnesses). */
+export declare function readSessionJournal(file: string): Promise<TranscriptMessage[]>;
+export declare function ensurePromptFiles(home: string): Promise<void>;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAc,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGjG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,sBAAsB,wgDAWc,CAAC;AAElD,eAAO,MAAM,0BAA0B,uWAEuH,CAAC;AAE/J;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,WAAW,CAI7F;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,QAAQ,SAAO,GAAG,MAAM,CAclF;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,GAAG,SAAK,GAAG,MAAM,CAKjF;AAED,sEAAsE;AACtE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA0CvE;AAED,4FAA4F;AAC5F,wBAAsB,aAAa,CACjC,GAAG,EAAE,KAAK,GAAG,SAAS,EACtB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,eAAe,EAAE,CAAC,CAmC5B;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgBnF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE"}

package/vendor/core/extract.js

@@ -0,0 +1,179 @@
+/**
+ * Post-session extraction: one bounded LLM call that turns a session digest
+ * into structured memories.
+ *
+ * Prompt assets are data on disk: `<home>/prompts/extract.md` (user-editable)
+ * overrides the shipped `prompts/extract.md`, which overrides the inline default.
+ * See `assets.ts` for the file contract and `prompts/README.md` for the format.
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { fillPrompt, loadPromptAsset, deployDefaultAssets } from "./assets.js";
+import { readTextIfExists, resolveHome } from "./util.js";
+export const DEFAULT_EXTRACT_PROMPT = `You extract durable memory from a coding-assistant session transcript.
+Return JSON only: {"memories": [ {"title": string, "description": string (one sentence, <=160 chars), "content": string (markdown, 3-12 lines), "type": "user"|"feedback"|"project"|"reference", "scope": "user"|"project", "category": string, "tags": string[], "entities": string[], "importance": number (0-10), "confidence": number (0-1), "links": string[] (existing memory ids only)} ]}
+
+Rules:
+1. Only durable, reusable knowledge: user identity/preferences/workflow constraints (type user), corrections and lessons that change future behavior (type feedback; always include **Why:** and **How to apply:** lines in content), project architecture/decisions/conventions/facts (type project), external pointers/URLs/docs (type reference).
+2. Do NOT store: transient task state, code that is in the repo, facts already covered by AGENTS.md/project docs, secrets, or anything the user did not state or confirm.
+3. Same language as the user's conversation (Chinese stays Chinese).
+4. Every entry needs an Observation Date from the transcript; put it as the first line of content: "Observed: YYYY-MM-DD".
+5. Avoid duplicating existing memories (see list). If related, link by id instead of restating.
+6. Exhaustive extraction: cover every distinct durable fact in the digest; do not stop after the first topic. Max 6 entries.
+7. If nothing is durable, return {"memories": []}.
+8. Never invent ids, versions, numbers or dates.`;
+export const DEFAULT_CONSOLIDATE_PROMPT = `You consolidate a personal memory store into a topical digest.
+Return JSON only: {"digest": {"title": string, "content": string (markdown, <=40 lines), "sources": string[] (memory ids)}}
+Merge overlapping facts, resolve contradictions in favor of the newest observation, drop stale details, keep concrete numbers and dates. Do not invent facts.`;
+/**
+ * Resolve a prompt asset: user copy in <home>/prompts first, shipped default
+ * second, inline constant last. Returns the parsed asset so callers can use the
+ * stable system text and fill the user template with data.
+ */
+export function resolvePrompt(home, name, fallbackSystem) {
+    const asset = loadPromptAsset(home, name);
+    if (asset && asset.system.trim())
+        return asset;
+    return { name, version: 0, system: fallbackSystem, user: null, source: "(built-in)" };
+}
+/** Build the bounded transcript digest sent to the extraction model. */
+export function buildDigest(messages, maxChars = 6000) {
+    const lines = [];
+    let used = 0;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        const prefix = message.role === "user" ? "User" : message.role === "assistant" ? "Assistant" : "Tool";
+        const text = (message.text ?? "").replace(/\s+/g, " ").trim();
+        if (!text)
+            continue;
+        const line = `${prefix}: ${text.slice(0, 1200)}`;
+        if (used + line.length > maxChars)
+            break;
+        lines.unshift(line);
+        used += line.length + 1;
+    }
+    return lines.join("\n");
+}
+/** Existing-memory list for dedupe context: `[id] (type) title — description`. */
+export function buildExistingList(existing, max = 60) {
+    return existing
+        .slice(0, max)
+        .map((m) => `- [${m.id}] (${m.type}) ${m.title} — ${m.description}`)
+        .join("\n");
+}
+/** Parse the JSON payload from a (possibly chatty) model response. */
+export function parseExtractionResponse(text) {
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start < 0 || end <= start)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return [];
+    }
+    const memories = parsed.memories;
+    if (!Array.isArray(memories))
+        return [];
+    const types = ["user", "feedback", "project", "reference"];
+    const out = [];
+    for (const raw of memories) {
+        if (!raw || typeof raw !== "object")
+            continue;
+        const item = raw;
+        const title = typeof item.title === "string" ? item.title.trim() : "";
+        const content = typeof item.content === "string" ? item.content.trim() : "";
+        if (!title || !content)
+            continue;
+        const typeRaw = typeof item.type === "string" ? item.type : "project";
+        const type = types.includes(typeRaw) ? typeRaw : "project";
+        const scopeRaw = typeof item.scope === "string" ? item.scope : type === "user" ? "user" : "project";
+        out.push({
+            title: title.slice(0, 200),
+            description: typeof item.description === "string" ? item.description.slice(0, 200) : title.slice(0, 200),
+            content: content.slice(0, 8000),
+            type,
+            scope: scopeRaw === "user" ? "user" : "project",
+            category: typeof item.category === "string" ? item.category : undefined,
+            tags: Array.isArray(item.tags) ? item.tags.filter((t) => typeof t === "string").slice(0, 12) : [],
+            entities: Array.isArray(item.entities) ? item.entities.filter((t) => typeof t === "string").slice(0, 12) : [],
+            importance: typeof item.importance === "number" ? Math.max(0, Math.min(10, item.importance)) : 5,
+            confidence: typeof item.confidence === "number" ? Math.max(0, Math.min(1, item.confidence)) : 0.7,
+            links: Array.isArray(item.links) ? item.links.filter((t) => typeof t === "string").slice(0, 8) : [],
+            supersedes: Array.isArray(item.supersedes)
+                ? item.supersedes.filter((t) => typeof t === "string" && /^mem_[0-9A-Z]{26}$/i.test(t)).slice(0, 8)
+                : [],
+            evidence: Array.isArray(item.evidence) ? item.evidence.filter((t) => typeof t === "string").slice(0, 3) : [],
+        });
+    }
+    return out;
+}
+/** One bounded extraction call. Returns [] when the LLM is absent or output is unusable. */
+export async function runExtraction(llm, config, input) {
+    if (!llm)
+        return [];
+    const digest = buildDigest(input.messages);
+    if (digest.length < (config.write?.minDigestChars ?? 500))
+        return [];
+    const home = config.home ?? resolveHome();
+    const asset = resolvePrompt(home, "extract", DEFAULT_EXTRACT_PROMPT);
+    const existingList = buildExistingList(input.existing) || "(none)";
+    const legacyUserPrompt = [
+        `Project: ${input.projectName ?? "(unknown)"}`,
+        `Session date: ${input.date}`,
+        "",
+        "Existing memories (link ids, do not duplicate):",
+        existingList,
+        "",
+        "Transcript digest:",
+        digest,
+    ].join("\n");
+    const userPrompt = asset.user
+        ? fillPrompt(asset.user, {
+            observation_date: input.date,
+            existing_memories: existingList,
+            transcript: digest,
+        })
+        : legacyUserPrompt;
+    const request = {
+        system: asset.system,
+        prompt: userPrompt,
+        temperature: 0,
+        maxTokens: 2000,
+    };
+    // LLM/transport failures are surfaced, not swallowed: a silent `[]` used to
+    // look like `status:"done", added:0` and hid a broken auxiliary call for
+    // days (N2). The caller records `status:"failed"` and can retry later.
+    const response = await llm(request);
+    return parseExtractionResponse(response.text).slice(0, config.write?.maxPerRun ?? 6);
+}
+/** Read a session journal file back into messages (adapter-free harnesses). */
+export async function readSessionJournal(file) {
+    const raw = await readTextIfExists(file);
+    if (!raw)
+        return [];
+    const out = [];
+    for (const rawLine of raw.split(/\r?\n/)) {
+        // Tolerate a UTF-8 BOM from hand-edited / PowerShell-written journals.
+        const line = rawLine.replace(/^\uFEFF/, "");
+        if (!line.trim())
+            continue;
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.role && parsed.text)
+                out.push({ role: parsed.role, text: parsed.text, ts: parsed.ts });
+        }
+        catch {
+            // tolerate truncated journal lines
+        }
+    }
+    return out;
+}
+export async function ensurePromptFiles(home) {
+    await fs.mkdir(join(home, "prompts"), { recursive: true });
+    // Copy shipped prompt/data defaults on first run so users have editable copies.
+    deployDefaultAssets(home);
+}
+//# sourceMappingURL=extract.js.map

package/vendor/core/extract.js.map

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

package/vendor/core/frontmatter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * YAML-subset frontmatter parser/serializer + MemoryRecord mapping.
+ *
+ * We intentionally do NOT implement full YAML: only the canonical subset the
+ * engine writes (scalars, inline arrays, block arrays, one nested map). Parsing
+ * is tolerant: unknown keys are preserved in `extra`, malformed lines are kept
+ * in `raw` so `doctor` can report them instead of losing data.
+ */
+import type { MemoryRecord } from "./types.js";
+export interface ParsedFrontmatter {
+    data: Record<string, unknown>;
+    body: string;
+    /** True when the file had no frontmatter at all. */
+    noFrontmatter: boolean;
+}
+/** Minimal YAML subset parser. */
+export declare function parseYamlSubset(yaml: string): {
+    data: Record<string, unknown>;
+    errors: string[];
+};
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter & {
+    errors: string[];
+};
+/** Serialize a MemoryRecord into a markdown file with canonical frontmatter. */
+export declare function serializeRecord(record: MemoryRecord): string;
+export declare function recordFromFrontmatter(data: Record<string, unknown>, body: string, fallbackId: string, now: number): MemoryRecord;
+/** Filename for a record: `<id>.md` is enough; title is in frontmatter. */
+export declare function recordFileName(id: string): string;
+/** Human-readable index line, e.g. `- [Title](mem_x.md) 📌 — description`. */
+export declare function indexLine(record: MemoryRecord): string;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAuD,MAAM,YAAY,CAAC;AAGpG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,aAAa,EAAE,OAAO,CAAC;CACxB;AA8CD,kCAAkC;AAClC,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAkGjG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAKtF;AAwCD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAkD5D;AA6BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CA8DhI;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAKtD"}

package/vendor/core/frontmatter.js

@@ -0,0 +1,372 @@
+import { normalizeNewlines } from "./util.js";
+const FIELD_ORDER = [
+    "schema",
+    "id",
+    "type",
+    "category",
+    "scope",
+    "project",
+    "project_name",
+    "title",
+    "description",
+    "tags",
+    "entities",
+    "importance",
+    "confidence",
+    "pinned",
+    "status",
+    "created",
+    "updated",
+    "last_used",
+    "used_count",
+    "valid_from",
+    "valid_to",
+    "observed_at",
+    "evidence",
+    "source",
+    "provenance",
+    "links",
+    "supersedes",
+    "superseded_by",
+    "sensitive",
+    "migrated_from",
+];
+function splitFrontmatter(raw) {
+    const text = normalizeNewlines(raw);
+    if (!text.startsWith("---"))
+        return { yaml: "", body: text, hadMarker: false };
+    const end = text.indexOf("\n---", 3);
+    if (end === -1)
+        return { yaml: "", body: text, hadMarker: false };
+    const yaml = text.slice(3, end).replace(/^\n/, "");
+    let body = text.slice(end + 4);
+    if (body.startsWith("\n"))
+        body = body.slice(1);
+    return { yaml, body, hadMarker: true };
+}
+/** Minimal YAML subset parser. */
+export function parseYamlSubset(yaml) {
+    const data = {};
+    const errors = [];
+    const lines = yaml.split("\n");
+    let i = 0;
+    const parseScalar = (input) => {
+        const value = input.trim();
+        if (value === "" || value === "null" || value === "~")
+            return null;
+        if (value === "true")
+            return true;
+        if (value === "false")
+            return false;
+        if (/^-?\d+(\.\d+)?$/.test(value))
+            return Number(value);
+        if (value.startsWith("[") && value.endsWith("]")) {
+            const inner = value.slice(1, -1).trim();
+            if (!inner)
+                return [];
+            return splitInline(inner).map((item) => parseScalar(item));
+        }
+        if (value.startsWith("{") && value.endsWith("}")) {
+            // Nested objects (e.g. source with migratedFrom) are serialized as compact
+            // JSON on a single line to keep the YAML subset parser simple. See
+            // valueToYamlLines("…nested object inside nested object").
+            try {
+                const parsed = JSON.parse(value);
+                if (parsed && typeof parsed === "object")
+                    return parsed;
+            }
+            catch {
+                // fall through: keep the raw string for malformed/legacy values
+            }
+        }
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            return value.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+        }
+        return value;
+    };
+    const splitInline = (input) => {
+        const out = [];
+        let cur = "";
+        let quote = null;
+        for (const ch of input) {
+            if (quote) {
+                cur += ch;
+                if (ch === quote)
+                    quote = null;
+                continue;
+            }
+            if (ch === '"' || ch === "'") {
+                quote = ch;
+                cur += ch;
+                continue;
+            }
+            if (ch === ",") {
+                out.push(cur.trim());
+                cur = "";
+                continue;
+            }
+            cur += ch;
+        }
+        if (cur.trim())
+            out.push(cur.trim());
+        return out;
+    };
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        i++;
+        if (!line.trim() || line.trimStart().startsWith("#"))
+            continue;
+        const match = /^([A-Za-z0-9_][A-Za-z0-9_.-]*):(.*)$/.exec(line);
+        if (!match) {
+            errors.push(`line ${i}: not a key:value line: ${line.slice(0, 120)}`);
+            continue;
+        }
+        const key = match[1];
+        const rest = (match[2] ?? "").trim();
+        if (rest === "") {
+            // nested map (one level) or block array
+            const nested = {};
+            const list = [];
+            let sawList = false;
+            while (i < lines.length) {
+                const next = lines[i] ?? "";
+                if (!/^\s+/.test(next))
+                    break;
+                i++;
+                const trimmed = next.trim();
+                if (!trimmed || trimmed.startsWith("#"))
+                    continue;
+                if (trimmed.startsWith("- ")) {
+                    sawList = true;
+                    list.push(parseScalar(trimmed.slice(2)));
+                    continue;
+                }
+                const kv = /^([A-Za-z0-9_][A-Za-z0-9_.-]*):(.*)$/.exec(trimmed);
+                if (!kv) {
+                    errors.push(`line ${i}: bad nested entry: ${trimmed.slice(0, 120)}`);
+                    continue;
+                }
+                nested[kv[1]] = parseScalar(kv[2] ?? "");
+            }
+            data[key] = sawList ? list : nested;
+            continue;
+        }
+        data[key] = parseScalar(rest);
+    }
+    return { data, errors };
+}
+export function parseFrontmatter(raw) {
+    const { yaml, body, hadMarker } = splitFrontmatter(raw);
+    if (!hadMarker)
+        return { data: {}, body, noFrontmatter: true, errors: [] };
+    const { data, errors } = parseYamlSubset(yaml);
+    return { data, body, noFrontmatter: false, errors };
+}
+function needsQuote(value) {
+    if (value === "")
+        return true;
+    if (/^[\s]|[\s]$/.test(value))
+        return true;
+    if (/^[-?:,[\]{}#&*!|>'"%@`]/.test(value))
+        return true;
+    if (value.includes(": ") || value.includes(" #"))
+        return true;
+    if (value === "true" || value === "false" || value === "null")
+        return true;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return true;
+    return false;
+}
+function scalarToYaml(value) {
+    if (value === null || value === undefined)
+        return "null";
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    if (typeof value === "number")
+        return Number.isFinite(value) ? String(value) : "null";
+    if (typeof value === "string")
+        return needsQuote(value) ? JSON.stringify(value) : value;
+    if (Array.isArray(value))
+        return `[${value.map((v) => scalarToYaml(v)).join(", ")}]`;
+    return JSON.stringify(value);
+}
+function valueToYamlLines(key, value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return [`${key}: []`];
+        const allScalar = value.every((v) => v === null || typeof v !== "object");
+        if (allScalar)
+            return [`${key}: ${scalarToYaml(value)}`];
+        return [`${key}:`, ...value.map((v) => `  - ${scalarToYaml(v)}`)];
+    }
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value).filter(([, v]) => v !== undefined);
+        if (entries.length === 0)
+            return [`${key}: {}`];
+        if (entries.every(([, v]) => v === null || typeof v !== "object")) {
+            return [`${key}:`, ...entries.map(([k, v]) => `  ${k}: ${scalarToYaml(v)}`)];
+        }
+        // nested object inside nested object: serialize compressed JSON to keep the parser simple
+        return [`${key}: ${JSON.stringify(value)}`];
+    }
+    return [`${key}: ${scalarToYaml(value)}`];
+}
+/** Serialize a MemoryRecord into a markdown file with canonical frontmatter. */
+export function serializeRecord(record) {
+    const data = {
+        schema: 1,
+        id: record.id,
+        type: record.type,
+        category: record.category,
+        scope: record.scope,
+        project: record.project,
+        project_name: record.projectName,
+        title: record.title,
+        description: record.description,
+        tags: record.tags,
+        entities: record.entities,
+        importance: record.importance,
+        confidence: record.confidence,
+        pinned: record.pinned,
+        status: record.status,
+        created: record.created,
+        updated: record.updated,
+        last_used: record.lastUsed,
+        used_count: record.usedCount,
+        valid_from: record.validFrom,
+        valid_to: record.validTo,
+        observed_at: record.observedAt,
+        evidence: record.evidence,
+        source: record.source,
+        provenance: record.provenance,
+        links: record.links,
+        supersedes: record.supersedes,
+        superseded_by: record.supersededBy,
+        sensitive: record.sensitive ?? undefined,
+    };
+    if (record.source?.migratedFrom)
+        data["migrated_from"] = record.source.migratedFrom;
+    const extra = record.extra ?? {};
+    for (const [k, v] of Object.entries(extra)) {
+        if (k in data)
+            continue;
+        data[k] = v;
+    }
+    const keys = [
+        ...FIELD_ORDER.filter((k) => k in data && data[k] !== undefined),
+        ...Object.keys(data).filter((k) => !FIELD_ORDER.includes(k)),
+    ];
+    const lines = ["---"];
+    for (const key of keys) {
+        const value = data[key];
+        if (value === undefined)
+            continue;
+        lines.push(...valueToYamlLines(key, value));
+    }
+    lines.push("---", "", record.content.trimEnd(), "");
+    return lines.join("\n");
+}
+function asString(value, fallback = "") {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return fallback;
+}
+function asNumber(value, fallback) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && /^-?\d+(\.\d+)?$/.test(value.trim()))
+        return Number(value);
+    return fallback;
+}
+function asBoolean(value, fallback) {
+    if (typeof value === "boolean")
+        return value;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    return fallback;
+}
+function asStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((v) => asString(v)).filter((v) => v.length > 0);
+}
+const TYPES = ["user", "feedback", "project", "reference"];
+const STATUSES = ["active", "superseded", "archived", "dropped"];
+export function recordFromFrontmatter(data, body, fallbackId, now) {
+    const id = asString(data["id"], fallbackId);
+    const typeRaw = asString(data["type"], "project");
+    const type = TYPES.includes(typeRaw) ? typeRaw : "project";
+    const scopeRaw = asString(data["scope"], "project");
+    const scope = scopeRaw === "user" ? "user" : "project";
+    const statusRaw = asString(data["status"], "active");
+    const status = STATUSES.includes(statusRaw) ? statusRaw : "active";
+    const created = asNumber(data["created"], now);
+    const updated = asNumber(data["updated"], created);
+    const sourceRaw = (data["source"] ?? {});
+    const migrated = (data["migrated_from"] ?? sourceRaw["migrated_from"]);
+    const source = {
+        harness: asString(sourceRaw["harness"], "unknown"),
+        session: asString(sourceRaw["session"]) || undefined,
+        turn: typeof sourceRaw["turn"] === "number" ? sourceRaw["turn"] : undefined,
+        ts: asNumber(sourceRaw["ts"], created),
+        migratedFrom: migrated && typeof migrated === "object"
+            ? {
+                system: asString(migrated["system"], "unknown"),
+                path: asString(migrated["path"]) || undefined,
+                originalId: asString(migrated["original_id"] ?? migrated["originalId"]) || undefined,
+            }
+            : undefined,
+    };
+    const validFrom = asNumber(data["valid_from"], created);
+    const validToRaw = data["valid_to"];
+    const validTo = validToRaw === null || validToRaw === undefined || validToRaw === "" ? null : asNumber(validToRaw, validFrom);
+    return {
+        schema: 1,
+        id,
+        type,
+        category: asString(data["category"]) || undefined,
+        scope,
+        project: asString(data["project"]) || undefined,
+        projectName: asString(data["project_name"]) || undefined,
+        title: asString(data["title"], "(untitled)"),
+        description: asString(data["description"]),
+        content: body.trimEnd(),
+        tags: asStringArray(data["tags"]),
+        entities: asStringArray(data["entities"]),
+        importance: asNumber(data["importance"], 5),
+        confidence: asNumber(data["confidence"], 0.8),
+        pinned: asBoolean(data["pinned"], false),
+        status,
+        created,
+        updated,
+        lastUsed: data["last_used"] === undefined || data["last_used"] === null ? undefined : asNumber(data["last_used"], 0),
+        usedCount: asNumber(data["used_count"], 0),
+        validFrom,
+        validTo,
+        observedAt: data["observed_at"] === undefined ? undefined : asNumber(data["observed_at"], created),
+        evidence: asNumber(data["evidence"], 0),
+        source,
+        provenance: asStringArray(data["provenance"]),
+        links: asStringArray(data["links"]),
+        supersedes: asStringArray(data["supersedes"]),
+        supersededBy: asString(data["superseded_by"]) || null,
+        sensitive: data["sensitive"] === undefined ? undefined : asBoolean(data["sensitive"], false),
+        extra: {},
+    };
+}
+/** Filename for a record: `<id>.md` is enough; title is in frontmatter. */
+export function recordFileName(id) {
+    return `${id}.md`;
+}
+/** Human-readable index line, e.g. `- [Title](mem_x.md) 📌 — description`. */
+export function indexLine(record) {
+    const pin = record.pinned ? " 📌" : "";
+    const type = record.type ? `[${record.type}] ` : "";
+    const desc = record.description ? ` — ${record.description}` : "";
+    return `- ${type}[${record.title}](${recordFileName(record.id)})${pin}${desc}`;
+}
+//# sourceMappingURL=frontmatter.js.map