memkin 0.4.0

package/dist/sync/obsidian.js

@@ -0,0 +1,543 @@
+/**
+ * Obsidian vault bidirectional sync.
+ *
+ * Implements `memkin export --vault <path>` and `memkin import --vault <path>`.
+ * See spec: docs/specs/memkin-2026-06-04-obsidian-sync.md (v7).
+ */
+import { createHash } from "node:crypto";
+import { access, lstat, mkdir, open, readdir, readFile, rename, unlink, writeFile, } from "node:fs/promises";
+import { dirname, join, relative, resolve, sep } from "node:path";
+import { parse as yamlParse, stringify as yamlStringify } from "yaml";
+// ============================================================================
+// Constants
+// ============================================================================
+const RELATED_MARKER = "<!-- memkin:related -->";
+const TIMELINE_MARKER = "<!-- memkin:timeline -->";
+/** Unicode-safe slug regex (H3). */
+const SLUG_REGEX = /^[\p{L}\p{N}_-]+(\/[\p{L}\p{N}_-]+)*$/u;
+/** Windows reserved names (L6) — rejected on all platforms for portability. */
+const WINDOWS_RESERVED = new Set([
+    "con",
+    "prn",
+    "aux",
+    "nul",
+    "com1",
+    "com2",
+    "com3",
+    "com4",
+    "com5",
+    "com6",
+    "com7",
+    "com8",
+    "com9",
+    "lpt1",
+    "lpt2",
+    "lpt3",
+    "lpt4",
+    "lpt5",
+    "lpt6",
+    "lpt7",
+    "lpt8",
+    "lpt9",
+]);
+const MAX_SLUG_LENGTH = 200;
+/** Wikilink pattern: matches [[slug]] or [[slug|display]] with Unicode support. */
+const WIKILINK_REGEX = /\[\[([^\]|]+?)(?:\|[^\]]+?)?\]\]/gu;
+// ============================================================================
+// Section 1: serializePage (Spec §4.4)
+// ============================================================================
+/**
+ * Serialize a Page into Obsidian-compatible markdown.
+ *
+ * Fixes applied:
+ *   H1: explicit fields written AFTER `...page.frontmatter` so they cannot be
+ *       clobbered by user-supplied frontmatter that happens to share a key.
+ *   M1: `updated_at` is NOT written to frontmatter — it would change every export
+ *       even when content is identical, defeating incremental sync.
+ *   N3: rebuild `## Aliases` body section from `frontmatter.aliases` each time
+ *       (frontmatter is the single source of truth; the body section is derived).
+ */
+export function serializePage(page, tags, links, timeline, userEdited) {
+    const fm = {
+        // 1. spread page.frontmatter FIRST (low precedence — H1)
+        ...page.frontmatter,
+        // 2. explicit fields LAST (high precedence — H1)
+        title: page.title,
+        type: page.type,
+        slug: page.slug,
+        tags,
+        links: links.map((l) => ({ target: l.to_slug, type: l.link_type })),
+        content_hash: page.content_hash,
+        user_edited: userEdited,
+        // NOTE: updated_at intentionally omitted (M1)
+    };
+    // N3: rebuild Aliases section from frontmatter, not from body
+    const aliases = page.frontmatter.aliases ?? [];
+    const compiledWithoutAliases = stripAliasesSection(page.compiled_truth);
+    const bodyParts = [];
+    if (aliases.length > 0) {
+        bodyParts.push("## Aliases", "");
+        for (const alias of aliases) {
+            bodyParts.push(`- ${alias}`);
+        }
+        bodyParts.push("");
+    }
+    bodyParts.push(compiledWithoutAliases.trim());
+    if (links.length > 0) {
+        bodyParts.push("", "<!-- memkin:related -->", "");
+        for (const link of links) {
+            bodyParts.push(`- [[${link.to_slug}]]`);
+        }
+    }
+    if (timeline.length > 0) {
+        bodyParts.push("", "<!-- memkin:timeline -->", "");
+        bodyParts.push("> ⚠️ Timeline 为只读派生数据，编辑此处不会同步回 DB", "");
+        for (const entry of timeline) {
+            bodyParts.push(`- **${entry.date}**: ${entry.summary}`);
+        }
+    }
+    const body = bodyParts.join("\n");
+    const fmYaml = yamlStringify(fm).trimEnd();
+    return `---\n${fmYaml}\n---\n\n${body}\n`;
+}
+/**
+ * Strip `## Aliases\n\n- ...` section if it appears at the start of body.
+ *
+ * Only matches at body start so that mid-body Aliases-like headings stay intact.
+ */
+export function stripAliasesSection(body) {
+    const pattern = /^##\s+Aliases\s*\n+(?:- .+\n?)+\n*/;
+    return body.replace(pattern, "").trimStart();
+}
+/**
+ * Split body into three sections by HTML comment markers.
+ *
+ * Fixes:
+ *   M3: detect marker order reversal (timeline before related) and signal error.
+ */
+export function splitBody(body) {
+    const rIdx = body.indexOf(RELATED_MARKER);
+    const tIdx = body.indexOf(TIMELINE_MARKER);
+    // M3: timeline marker must come after related marker if both exist
+    if (rIdx >= 0 && tIdx >= 0 && tIdx < rIdx) {
+        return { mainBody: "", related: "", timeline: "", orderError: true };
+    }
+    let main = body;
+    let related = "";
+    let timeline = "";
+    // Split timeline first (later marker), then related
+    if (tIdx >= 0) {
+        timeline = main.slice(tIdx + TIMELINE_MARKER.length).trim();
+        main = main.slice(0, tIdx);
+    }
+    if (rIdx >= 0) {
+        related = main.slice(rIdx + RELATED_MARKER.length).trim();
+        main = main.slice(0, rIdx);
+    }
+    return { mainBody: main.trim(), related, timeline, orderError: false };
+}
+/** Validate slug: Unicode-safe + Windows reserved + length (H3 + L6). */
+export function isValidSlug(slug) {
+    if (!slug || slug.length === 0)
+        return false;
+    if (slug.length > MAX_SLUG_LENGTH)
+        return false;
+    if (!SLUG_REGEX.test(slug))
+        return false;
+    for (const segment of slug.split("/")) {
+        if (WINDOWS_RESERVED.has(segment.toLowerCase()))
+            return false;
+    }
+    return true;
+}
+/** Convert a file path (relative to vault root) to slug. */
+export function slugifyPath(relativePath) {
+    return relativePath.replace(/^\.\//, "").replace(/^\//, "").replace(/\.md$/i, "");
+}
+/** Extract all wikilink targets from text, stripping display suffix. */
+export function extractWikilinks(text) {
+    const results = [];
+    const re = new RegExp(WIKILINK_REGEX.source, WIKILINK_REGEX.flags);
+    for (const match of text.matchAll(re)) {
+        results.push(match[1].trim());
+    }
+    return results;
+}
+function parseFrontmatterAndBody(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match) {
+        return { fm: {}, body: content };
+    }
+    const fm = (yamlParse(match[1]) ?? {});
+    return { fm, body: match[2] };
+}
+/**
+ * Parse a vault markdown file into the pieces needed for putPage / addTag / addLink.
+ *
+ * Fixes:
+ *   H2-incomplete: filter links by type — only obsidian and bare strings are
+ *                  taken as user-editable; pipeline-managed types (works_on,
+ *                  collaborates, etc.) are ignored here so they cannot be
+ *                  duplicated as obsidian-type edges on round-trip.
+ *   H4: inject user_edited=true into cleanMarkdown so putPage persists the lock.
+ *   M3: throw if body marker order is reversed.
+ *   M7: timeline section is NOT parsed (export-only).
+ *   L4: body `## Aliases` section is not interpreted — only frontmatter is.
+ */
+export function parseVaultFile(content, relativePath) {
+    const { fm, body } = parseFrontmatterAndBody(content);
+    const slugRaw = fm.slug ?? slugifyPath(relativePath);
+    if (!isValidSlug(slugRaw)) {
+        throw new Error(`invalid slug: ${slugRaw}`);
+    }
+    const slug = slugRaw;
+    const split = splitBody(body);
+    if (split.orderError) {
+        throw new Error("marker order incorrect: timeline appears before related");
+    }
+    // H2-incomplete: filter frontmatter links to obsidian-type only
+    const rawFmLinks = Array.isArray(fm.links) ? fm.links : [];
+    const fmLinks = [];
+    for (const item of rawFmLinks) {
+        if (typeof item === "string") {
+            fmLinks.push(item);
+        }
+        else if (item && typeof item === "object") {
+            const obj = item;
+            if (typeof obj.target === "string") {
+                const type = obj.type;
+                if (type === undefined || type === null || type === "obsidian") {
+                    fmLinks.push(obj.target);
+                }
+            }
+        }
+    }
+    // Wikilinks from main body (always treated as obsidian)
+    const bodyLinks = extractWikilinks(split.mainBody);
+    const links = Array.from(new Set([...fmLinks, ...bodyLinks]));
+    const tags = Array.isArray(fm.tags) ? fm.tags : [];
+    // Build clean frontmatter for putPage (strip sync-layer metadata)
+    const cleanFm = { ...fm };
+    delete cleanFm.slug;
+    delete cleanFm.tags;
+    delete cleanFm.links;
+    delete cleanFm.content_hash;
+    delete cleanFm.user_edited;
+    // H4: stamp user_edited=true
+    cleanFm.user_edited = true;
+    const cleanFmYaml = yamlStringify(cleanFm).trimEnd();
+    // M7: drop timeline section from main body; keep mainBody only
+    const cleanMarkdown = `---\n${cleanFmYaml}\n---\n\n${split.mainBody}\n`;
+    return { slug, cleanMarkdown, tags, links };
+}
+// ============================================================================
+// Section 3: Manifest I/O (Spec §4.7 + §7.8)
+// ============================================================================
+const MANIFEST_FILENAME = ".memkin-sync.json";
+const MANIFEST_VERSION = 2;
+/** Load the sync manifest from a vault. Returns null if missing or invalid. */
+export async function loadManifest(vaultPath) {
+    const path = join(vaultPath, MANIFEST_FILENAME);
+    try {
+        const raw = await readFile(path, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== MANIFEST_VERSION)
+            return null;
+        if (!parsed.pages || typeof parsed.pages !== "object")
+            return null;
+        return parsed;
+    }
+    catch {
+        // Missing, unreadable, or malformed — treat as no manifest
+        return null;
+    }
+}
+/**
+ * Atomically write the sync manifest (M8 + N2).
+ *
+ * Procedure:
+ *   1. open(tmpPath, "w") → write JSON → handle.sync() → handle.close()
+ *   2. rename(tmpPath, targetPath) — POSIX atomic
+ *   3. On error: close handle if open, unlink tmp
+ *
+ * Note: Node `fs.fsync()` takes a file descriptor, not a path. We use
+ * `FileHandle.sync()` which is the FileHandle API's wrapper around fsync(fd).
+ */
+export async function saveManifest(vaultPath, manifest) {
+    const targetPath = join(vaultPath, MANIFEST_FILENAME);
+    const tmpPath = `${targetPath}.tmp`;
+    let handle = null;
+    try {
+        handle = await open(tmpPath, "w");
+        await handle.writeFile(JSON.stringify(manifest, null, 2), "utf-8");
+        await handle.sync();
+        await handle.close();
+        handle = null;
+        await rename(tmpPath, targetPath);
+    }
+    catch (e) {
+        if (handle)
+            await handle.close().catch(() => { });
+        await unlink(tmpPath).catch(() => { });
+        throw e;
+    }
+}
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+// ============================================================================
+// Section 5: exportToVault (Spec §5)
+// ============================================================================
+export async function exportToVault(stores, vaultPath, opts = {}) {
+    const result = { written: 0, skipped: 0, errors: [] };
+    // 1. Ensure vault directory exists
+    await mkdir(vaultPath, { recursive: true });
+    // 2. Load old manifest
+    const oldManifest = await loadManifest(vaultPath);
+    // 3. List all pages
+    const pages = await stores.pages.listPages({ limit: 100000 });
+    // 4. M6: batch pre-query tags / links / timeline
+    const [tagsBySlug, linksBySlug, timelineBySlug] = await Promise.all([
+        stores.tags.getAllTagsGrouped(),
+        stores.graph.getAllLinksGrouped(),
+        stores.timeline.getAllTimelineGrouped(),
+    ]);
+    // 5. Build new manifest as we go
+    const newManifest = {
+        version: 2,
+        last_sync_at: nowIso(),
+        last_sync_op: "export",
+        pages: {},
+    };
+    // 6. Per-page serialization
+    for (const page of pages) {
+        try {
+            const tags = tagsBySlug.get(page.slug) ?? [];
+            const links = linksBySlug.get(page.slug) ?? [];
+            const timeline = timelineBySlug.get(page.slug) ?? [];
+            const userEdited = oldManifest?.pages[page.slug]?.user_edited ?? false;
+            const content = serializePage(page, tags, links, timeline, userEdited);
+            const fileHash = sha256(content);
+            const previousFileHash = oldManifest?.pages[page.slug]?.file_hash;
+            const unchanged = !opts.force && previousFileHash === fileHash;
+            if (!unchanged && !opts.dryRun) {
+                const filePath = join(vaultPath, `${page.slug}.md`);
+                await mkdir(dirname(filePath), { recursive: true });
+                await writeFile(filePath, content, "utf-8");
+            }
+            newManifest.pages[page.slug] = {
+                file_hash: fileHash,
+                db_content_hash_at_last_sync: page.content_hash,
+                last_synced_at: newManifest.last_sync_at,
+                last_synced_op: "export",
+                user_edited: userEdited,
+            };
+            if (unchanged) {
+                result.skipped += 1;
+            }
+            else {
+                result.written += 1;
+            }
+        }
+        catch (e) {
+            result.errors.push({
+                slug: page.slug,
+                reason: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    // 7. Persist manifest
+    if (!opts.dryRun) {
+        await saveManifest(vaultPath, newManifest);
+    }
+    return result;
+}
+// ============================================================================
+// Section 6: importFromVault (Spec §6)
+// ============================================================================
+/**
+ * Recursively scan markdown files in vault. Defensive against symlinks (L8).
+ */
+async function scanMarkdownFiles(dir, vaultRoot, results = []) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        // L8: refuse to follow symlinks
+        const stat = await lstat(fullPath);
+        if (stat.isSymbolicLink())
+            continue;
+        // Defensive: stay within vault boundary
+        const resolved = resolve(fullPath);
+        if (!resolved.startsWith(resolve(vaultRoot) + sep) && resolved !== resolve(vaultRoot)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            if (entry.name.startsWith("."))
+                continue;
+            if (entry.name === "node_modules")
+                continue;
+            await scanMarkdownFiles(fullPath, vaultRoot, results);
+        }
+        else if (entry.isFile()) {
+            if (!entry.name.endsWith(".md"))
+                continue;
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * Read vault file content, returning null when the file is an iCloud
+ * placeholder or empty (L7 + N1).
+ */
+async function readVaultFile(filePath) {
+    // L7: check for iCloud placeholder sibling .filename.icloud
+    const dir = dirname(filePath);
+    const base = filePath.slice(dir.length + 1);
+    const placeholderPath = join(dir, `.${base}.icloud`);
+    try {
+        await access(placeholderPath);
+        return null;
+    }
+    catch {
+        // No placeholder — proceed
+    }
+    const content = await readFile(filePath, "utf-8");
+    // N1: only flag genuinely empty content (the v4 regex /^[ -]+/ was nonsense)
+    if (content.length === 0 || content.trim().length === 0) {
+        return null;
+    }
+    return content;
+}
+export async function importFromVault(stores, vaultPath, opts = {}) {
+    const result = {
+        imported: 0,
+        skipped: 0,
+        errors: [],
+        warnings: [],
+    };
+    // 1. Verify vault exists
+    await access(vaultPath);
+    // 2. Load existing manifest (may be null on first import)
+    const manifest = (await loadManifest(vaultPath)) ??
+        {
+            version: 2,
+            last_sync_at: nowIso(),
+            last_sync_op: "import",
+            pages: {},
+        };
+    // 3. Scan vault for markdown files
+    const files = await scanMarkdownFiles(vaultPath, vaultPath);
+    for (const filePath of files) {
+        const relPath = relative(vaultPath, filePath);
+        try {
+            const content = await readVaultFile(filePath);
+            if (content === null) {
+                result.warnings.push({
+                    slug: relPath,
+                    reason: "iCloud placeholder or empty file — skipping",
+                });
+                result.skipped += 1;
+                continue;
+            }
+            const fileHash = sha256(content);
+            // 4. Parse to extract slug (needed for hash comparison)
+            const parsed = parseVaultFile(content, relPath);
+            const slug = parsed.slug;
+            const previousFileHash = manifest.pages[slug]?.file_hash;
+            if (!opts.force && previousFileHash === fileHash) {
+                result.skipped += 1;
+                continue;
+            }
+            // 5. H5: detect DB-side changes between syncs
+            const existingPage = await stores.pages.getPage(slug);
+            const recordedDbHash = manifest.pages[slug]?.db_content_hash_at_last_sync;
+            if (!opts.force &&
+                existingPage &&
+                recordedDbHash &&
+                existingPage.content_hash !== recordedDbHash) {
+                result.warnings.push({
+                    slug,
+                    reason: "DB content changed since last sync — your vault edits will overwrite DB changes",
+                });
+                if (opts.strictConflict) {
+                    result.skipped += 1;
+                    continue;
+                }
+            }
+            if (opts.dryRun) {
+                result.imported += 1;
+                continue;
+            }
+            // 6. Per-file write sequence (M2 deferred — see Spec §7.9 note)
+            //
+            // NOTE: We do NOT wrap in pg.transaction() — PGlite's transaction uses
+            // a mutex on the single connection, and store methods using `this.pg.query`
+            // (instead of tx.query) would deadlock waiting for the mutex to release.
+            // Refactoring all store methods to accept tx is out of scope.
+            //
+            // Atomicity guarantee: NONE. We rely on idempotent upserts:
+            //   - putPage: INSERT ... ON CONFLICT UPDATE (idempotent)
+            //   - addTag: INSERT ... ON CONFLICT DO NOTHING (idempotent)
+            //   - addLink: INSERT ... ON CONFLICT UPDATE (idempotent)
+            //   - rechunk: DELETE + INSERT (eventual consistency; retry-safe)
+            //
+            // If the process crashes mid-write, the next `memkin import` run will
+            // re-process the file (file_hash will still differ) and reach a
+            // consistent state. Worst case: chunks briefly out of date.
+            // autoWikilink:false — Obsidian sync owns [[...]] semantics (creates "obsidian"-typed
+            // links below); disable Spec 10 generic auto-wiring so it doesn't shadow them with "mentions".
+            const newPage = await stores.pages.putPage(slug, parsed.cleanMarkdown, {
+                autoWikilink: false,
+            });
+            for (const tag of parsed.tags) {
+                await stores.tags.addTag(slug, tag);
+            }
+            // H2-incomplete: only add obsidian-typed links; do not touch
+            // pipeline-typed links (works_on, collaborates, mentions, etc.)
+            const existingLinks = await stores.graph.getLinks(slug);
+            const existingObsidian = new Set(existingLinks.filter((l) => l.link_type === "obsidian").map((l) => l.to_slug));
+            for (const target of parsed.links) {
+                if (existingObsidian.has(target))
+                    continue;
+                try {
+                    await stores.graph.addLink(slug, target, "obsidian", "from obsidian vault");
+                }
+                catch (linkErr) {
+                    // Target may not exist — warn, do not fail
+                    result.warnings.push({
+                        slug,
+                        reason: `addLink ${slug} → ${target}: ${linkErr instanceof Error ? linkErr.message : String(linkErr)}`,
+                    });
+                }
+            }
+            // M7: NOT processing timeline (export-only)
+            await stores.chunks.rechunk(newPage.id, newPage.compiled_truth);
+            manifest.pages[slug] = {
+                file_hash: fileHash,
+                db_content_hash_at_last_sync: newPage.content_hash,
+                last_synced_at: nowIso(),
+                last_synced_op: "import",
+                user_edited: true,
+            };
+            result.imported += 1;
+        }
+        catch (e) {
+            result.errors.push({
+                file: relPath,
+                reason: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    // 7. Persist manifest
+    if (!opts.dryRun) {
+        manifest.last_sync_at = nowIso();
+        manifest.last_sync_op = "import";
+        await saveManifest(vaultPath, manifest);
+    }
+    return result;
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/sync/obsidian.js.map

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

package/dist/synth/cache.d.ts

@@ -0,0 +1,17 @@
+import type { StoreContext } from "../server/api.js";
+import type { AssembledCandidate, SynthesisResult, SynthScope } from "./types.js";
+/** input_hash = stable hash of the candidate (slug, date) set (Spec 7 §九 freshness). */
+export declare function computeInputHash(candidates: AssembledCandidate[]): string;
+/**
+ * Read a cached synthesis result for a scope, returning it only when fresh
+ * (stored input_hash matches the current one). Returns null on miss/staleness/query-scope.
+ */
+export declare function read(intent: string, scope: SynthScope, inputHash: string, stores: StoreContext): Promise<SynthesisResult | null>;
+/**
+ * Write a synthesis result into its scope's cache carrier page.
+ * - entity scope → entity page frontmatter.synth[intent]
+ * - time scope   → reports/<intent>/<from..to> knowledge page (frontmatter.is_report=true)
+ * - query scope  → no-op (not cached)
+ */
+export declare function write(intent: string, scope: SynthScope, result: SynthesisResult, inputHash: string, stores: StoreContext): Promise<void>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/synth/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/synth/cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AASlF,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAMzE;AAgBD;;;GAGG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAYjC;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CACzB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/synth/cache.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+/** input_hash = stable hash of the candidate (slug, date) set (Spec 7 §九 freshness). */
+export function computeInputHash(candidates) {
+    const key = candidates
+        .map((c) => `${c.slug}:${c.date ?? ""}`)
+        .sort()
+        .join("|");
+    return createHash("sha256").update(key).digest("hex");
+}
+/** Page slug carrying the cache for a given scope, or null for non-cacheable (query) scopes. */
+function cacheCarrierSlug(intent, scope) {
+    if (scope.entity)
+        return scope.entity;
+    if (scope.time) {
+        // Spec 9 §5.2: a daily report keyed by a single day caches to reports/daily/<date>.
+        if (intent === "daily_report") {
+            const date = scope.time.from.slice(0, 10);
+            return `reports/daily/${date}`;
+        }
+        return `reports/${intent}/${scope.time.from}..${scope.time.to}`;
+    }
+    return null; // query scope → not cached (Spec 7 §九)
+}
+/**
+ * Read a cached synthesis result for a scope, returning it only when fresh
+ * (stored input_hash matches the current one). Returns null on miss/staleness/query-scope.
+ */
+export async function read(intent, scope, inputHash, stores) {
+    const slug = cacheCarrierSlug(intent, scope);
+    if (!slug)
+        return null;
+    const page = await stores.pages.getPage(slug);
+    if (!page)
+        return null;
+    const synth = page.frontmatter.synth;
+    const entry = synth?.[intent];
+    if (!entry || entry.input_hash !== inputHash)
+        return null;
+    return { ...entry.result, meta: { ...entry.result.meta, cached: true } };
+}
+/**
+ * Write a synthesis result into its scope's cache carrier page.
+ * - entity scope → entity page frontmatter.synth[intent]
+ * - time scope   → reports/<intent>/<from..to> knowledge page (frontmatter.is_report=true)
+ * - query scope  → no-op (not cached)
+ */
+export async function write(intent, scope, result, inputHash, stores) {
+    const slug = cacheCarrierSlug(intent, scope);
+    if (!slug)
+        return;
+    const entry = {
+        input_hash: inputHash,
+        generated_at: result.meta.generated_at,
+        result,
+    };
+    const isReport = Boolean(scope.time);
+    const existing = await stores.pages.getPage(slug);
+    if (!existing) {
+        // Entity scope: never create a phantom entity page just to cache a synthesis.
+        if (!isReport)
+            return;
+        // Report (time) scope: create the dedicated report page once.
+        await stores.pages.putPage(slug, `---\ntitle: ${intent} report ${slug}\ntype: knowledge\nis_report: true\n---\n`);
+    }
+    await stores.pages.setSynthCache(slug, intent, entry);
+}
+//# sourceMappingURL=cache.js.map

package/dist/synth/cache.js.map

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