mewkit 1.10.1 → 1.10.3

package/dist/memory/render-views.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import path from "node:path";
+import { CURATED_STORES } from "./schemas.js";
+import { loadContentValidator } from "./validate.js";
+// Deterministic JSON→Markdown renderer. Generates human-readable views/*.md from
+// the canonical curated JSON stores. Pure transform (no LLM). Output is stable
+// (entries sorted by id) for clean diffs, idempotent, and stamped with a banner
+// declaring the file generated + non-authoritative. Re-runs validate-content per
+// text field (defense-in-depth) and annotates flagged entries inline.
+const GENERATED_BANNER = (storeFile) => `<!-- GENERATED from ${storeFile} by 'mewkit memory render-views' — do not edit; edits are overwritten. Append new entries to ${storeFile} (the canonical source). -->`;
+const LEGACY_MARKER = (storeFile, viewFile) => `<!-- NON-AUTHORITATIVE: canonical source is ${storeFile}; generated human view is ${viewFile} (regenerate via 'mewkit memory render-views'). -->`;
+function renderScalar(value) {
+    if (Array.isArray(value))
+        return value.map((v) => String(v)).join(", ");
+    return String(value);
+}
+// Render one entry as a `## ` section. Order fields deterministically: title field
+// first, then the remaining keys in a fixed order, then any extra keys sorted.
+function renderEntry(entry, spec, validator) {
+    const id = String(entry.id ?? "<no-id>");
+    const lines = [`## ${id}`, ""];
+    // Inline injection-recheck annotation (audit trail — kept, not dropped).
+    if (validator) {
+        for (const field of spec.textFields) {
+            const text = entry[field];
+            if (typeof text === "string" && !validator(text).valid) {
+                lines.push(`<!-- WARN: entry ${id} field '${field}' matched an injection pattern — verify manually -->`, "");
+            }
+        }
+    }
+    const skip = new Set(["id"]);
+    const ordered = Object.keys(entry)
+        .filter((k) => !skip.has(k))
+        .sort((a, b) => a.localeCompare(b));
+    for (const key of ordered) {
+        const value = entry[key];
+        if (value === undefined || value === null || value === "")
+            continue;
+        lines.push(`- **${key}:** ${renderScalar(value)}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+export function renderStore(data, spec, validator) {
+    const items = (data[spec.itemsKey] ?? [])
+        .slice()
+        .sort((a, b) => String(a.id).localeCompare(String(b.id)));
+    const flagged = [];
+    if (validator) {
+        for (const item of items) {
+            for (const field of spec.textFields) {
+                const text = item[field];
+                if (typeof text === "string" && !validator(text).valid)
+                    flagged.push(String(item.id));
+            }
+        }
+    }
+    const header = [
+        GENERATED_BANNER(spec.file),
+        "",
+        `# ${spec.scope} — generated view`,
+        "",
+        `> ${items.length} entr${items.length === 1 ? "y" : "ies"} from \`${spec.file}\`. This file is non-authoritative; edit the JSON and re-run \`mewkit memory render-views\`.`,
+        "",
+    ];
+    const body = items.map((it) => renderEntry(it, spec, validator)).join("\n");
+    return { md: header.join("\n") + "\n" + body, flagged: [...new Set(flagged)] };
+}
+// Idempotently prepend a non-authoritative marker to a legacy topic MD file.
+function stampLegacyMarker(memoryDir, spec) {
+    const mdName = spec.file.replace(/\.json$/, ".md");
+    const mdPath = path.join(memoryDir, mdName);
+    if (!fs.existsSync(mdPath))
+        return;
+    const content = fs.readFileSync(mdPath, "utf-8");
+    if (content.includes("NON-AUTHORITATIVE:"))
+        return;
+    const marker = LEGACY_MARKER(spec.file, `views/${mdName}`);
+    fs.writeFileSync(mdPath, `${marker}\n${content}`, "utf-8");
+}
+export function renderViews(memoryDir, opts = {}) {
+    const validator = loadContentValidator(memoryDir);
+    const viewsDir = path.join(memoryDir, "views");
+    if (!opts.check)
+        fs.mkdirSync(viewsDir, { recursive: true });
+    const results = [];
+    for (const spec of CURATED_STORES) {
+        const jsonPath = path.join(memoryDir, spec.file);
+        if (!fs.existsSync(jsonPath))
+            continue;
+        let data;
+        try {
+            data = JSON.parse(fs.readFileSync(jsonPath, "utf-8"));
+        }
+        catch {
+            continue; // invalid JSON is the validator's concern, not the renderer's
+        }
+        const { md, flagged } = renderStore(data, spec, validator);
+        const viewPath = path.join(viewsDir, spec.file.replace(/\.json$/, ".md"));
+        const exists = fs.existsSync(viewPath);
+        const current = exists ? fs.readFileSync(viewPath, "utf-8") : "";
+        const stale = current !== md;
+        let wrote = false;
+        if (!opts.check && stale) {
+            fs.writeFileSync(viewPath, md, "utf-8");
+            wrote = true;
+        }
+        if (!opts.check)
+            stampLegacyMarker(memoryDir, spec);
+        results.push({ file: spec.file, viewPath, exists, stale, flagged, wrote });
+    }
+    return results;
+}
+//# sourceMappingURL=render-views.js.map

package/dist/memory/render-views.js.map

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