@wrenautomation/knowledge 0.0.0-stage → 0.59.0

package/dist/records.js

@@ -0,0 +1,162 @@
+/**
+ * A record: one markdown file, frontmatter + body. Design: wren/designs/2026-11-09-knowledge-repo.md.
+ * Unknown frontmatter keys are kept (never drop data); key order on write is fixed, so diffs stay small.
+ */
+import { randomBytes } from "node:crypto";
+import matter from "gray-matter";
+import { z } from "zod";
+export const TYPES = ["source", "finding", "verdict", "rule", "guide"];
+export const DIRS = {
+    source: "sources",
+    finding: "findings",
+    verdict: "verdicts",
+    rule: "rules",
+    guide: "guides",
+};
+// readable ids: a source keeps its natural one (youtube-uSTGNHGFOAo); new ones are slug + random tail
+export const Id = z
+    .string()
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/, "id: letters, digits, . _ -");
+// YAML reads a bare timestamp as a Date; every stamp is stored as a full UTC ISO string
+const Stamp = z.preprocess((v) => (v instanceof Date ? v.toISOString() : v), z.string().refine((s) => !Number.isNaN(Date.parse(s)), "not a date"));
+const Text = z.preprocess((v) => (typeof v === "number" ? String(v) : v), z.string());
+const base = {
+    id: Id,
+    title: z.string().min(1),
+    status: z.enum(["live", "retired"]),
+    version: z.number().int().positive(),
+    by: z.string().min(1),
+    why: z.string().min(1),
+    cites: z.array(Id).default([]),
+    tags: z.array(z.string()).default([]),
+    created: Stamp,
+    updated: Stamp,
+};
+export const SOURCE_KINDS = [
+    "site",
+    "page",
+    "video",
+    "reel",
+    "post",
+    "person",
+    "tool",
+    "doc",
+    "paper",
+    "feed",
+    "repo",
+    "list",
+    "other",
+];
+export const Source = z.looseObject({
+    ...base,
+    type: z.literal("source"),
+    kind: z.enum(SOURCE_KINDS),
+    url: z.url().optional(),
+    handle: z.string().optional(),
+    // 1 (low) to 9: how much a build leans on it
+    priority: z.number().int().min(1).max(9).optional(),
+    // a file in the media bucket, by content hash
+    media: z.object({ sha256: z.string().regex(/^[0-9a-f]{64}$/), type: z.string() }).optional(),
+});
+export const Finding = z.looseObject({
+    ...base,
+    type: z.literal("finding"),
+    source: Id,
+    // the source's own words; a point extracted in paraphrase has none
+    quote: z.string().min(1).optional(),
+    page: z.url().optional(),
+    // where in the source: a time (0:16), a page, a slide
+    at: Text.optional(),
+    run: z.string().optional(),
+});
+export const Verdict = z.looseObject({
+    ...base,
+    type: z.literal("verdict"),
+    from: z.enum(["vireo", "orrery", "owner", "other"]),
+    // the producer's own handle: a Vireo batch ref (hero:3), a lane id
+    ref: z.string().min(1),
+    score: z.number().optional(),
+});
+export const Rule = z.looseObject({
+    ...base,
+    type: z.literal("rule"),
+    topic: z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "topic: lowercase slug"),
+    order: z.number().optional(),
+});
+const Topic = z.string().regex(/^[a-z0-9][a-z0-9-]*$/, "topic: lowercase slug");
+// a procedure (an SOP) as one doc: body cites [n] or [n 0:16], n = 1-based index into cites
+export const Guide = z.looseObject({
+    ...base,
+    type: z.literal("guide"),
+    topic: Topic,
+    // one line: what the guide is for (a skill's description)
+    description: z.string().optional(),
+});
+export const Frontmatter = z.discriminatedUnion("type", [Source, Finding, Verdict, Rule, Guide]);
+/** Where a record lives in the repo. A rule sits under its topic. */
+export function pathOf(fm) {
+    const dir = DIRS[fm.type];
+    return fm.type === "rule" ? `${dir}/${String(fm.topic)}/${fm.id}.md` : `${dir}/${fm.id}.md`;
+}
+/** `[n]` and `[n 0:16]` in a guide's body: n is the place in its cites. */
+export const CITE_NUMBER = /\[(\d+)((?: (?:\d{1,2}:\d{2}(?::\d{2})?(?:, \d{1,2}:\d{2}(?::\d{2})?)*|caption))?)\]/g;
+/** The ids a record leans on: its cites, and a finding's source. */
+export function edgesOf(fm) {
+    return [...new Set(fm.type === "finding" ? [...fm.cites, fm.source] : fm.cites)];
+}
+const B32 = "0123456789abcdefghjkmnpqrstvwxyz";
+export function newId(title) {
+    const slug = title
+        .toLowerCase()
+        .normalize("NFKD")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40)
+        .replace(/-+$/, "");
+    const tail = [...randomBytes(6)].map((b) => B32[b % 32]).join("");
+    return slug ? `${slug}-${tail}` : tail;
+}
+export function parse(text) {
+    let m;
+    try {
+        // options object: gray-matter caches option-less calls by text and hands back one shared object
+        m = matter(text, {});
+    }
+    catch (e) {
+        return { ok: false, error: `frontmatter: ${e.message.split("\n")[0]}` };
+    }
+    const r = Frontmatter.safeParse(m.data);
+    if (!r.success)
+        return {
+            ok: false,
+            error: r.error.issues
+                .map((i) => `${i.path.join(".") || "frontmatter"}: ${i.message}`)
+                .join("; "),
+        };
+    const fm = r.data;
+    fm.created = new Date(fm.created).toISOString();
+    fm.updated = new Date(fm.updated).toISOString();
+    return { ok: true, doc: { fm, body: m.content.replace(/^\n+/, "").replace(/\s+$/, "") } };
+}
+const HEAD = ["id", "type", "title", "status", "version", "by", "why", "cites", "tags"];
+const TAIL = ["created", "updated"];
+export function serialize(doc) {
+    const fm = doc.fm;
+    const out = {};
+    const put = (k) => {
+        const v = fm[k];
+        if (v === undefined || (Array.isArray(v) && v.length === 0))
+            return;
+        out[k] = v;
+    };
+    for (const k of HEAD)
+        put(k);
+    for (const k of Object.keys(fm)
+        .filter((k) => !HEAD.includes(k) && !TAIL.includes(k))
+        .sort())
+        put(k);
+    for (const k of TAIL)
+        put(k);
+    return matter.stringify(doc.body ? `\n${doc.body}\n` : "", out);
+}
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,6 @@
+import { type Doc, type Frontmatter } from "./records.js";
+/** One record by id: the flat folders first, else a walk (a rule sits under its topic). */
+export declare function readRecord(root: string, id: string): Doc | null;
+/** `n. id, "title", handle, url`: the line a cite gets in the list. */
+export declare function citeLine(n: number, id: string, fm: Frontmatter | undefined): string;
+export declare function render(root: string, id: string): string;

package/dist/render.js

@@ -0,0 +1,37 @@
+/**
+ * A record as one markdown doc for a reader or a skill: the body, then its cites as a numbered
+ * `## Sources` list (a guide's `[n]` points into it). Reads the working tree, only the files it needs.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { DIRS, parse } from "./records.js";
+import { loadWorking } from "./repo.js";
+/** One record by id: the flat folders first, else a walk (a rule sits under its topic). */
+export function readRecord(root, id) {
+    for (const dir of Object.values(DIRS)) {
+        const f = join(root, dir, `${id}.md`);
+        if (!existsSync(f))
+            continue;
+        const p = parse(readFileSync(f, "utf8"));
+        if (p.ok && p.doc.fm.id === id)
+            return p.doc;
+    }
+    return loadWorking(root).docs.find((d) => d.doc.fm.id === id)?.doc ?? null;
+}
+/** `n. id, "title", handle, url`: the line a cite gets in the list. */
+export function citeLine(n, id, fm) {
+    const f = (fm ?? {});
+    const parts = [id, f.title ? `"${f.title}"` : "", f.handle, f.url].filter((x) => typeof x === "string" && x !== "");
+    return `${n}. ${parts.join(", ")}`;
+}
+export function render(root, id) {
+    const doc = readRecord(root, id);
+    if (!doc)
+        throw new Error(`no record ${id}`);
+    const { fm, body } = doc;
+    if (!fm.cites.length)
+        return `${body}\n`;
+    const lines = fm.cites.map((c, i) => citeLine(i + 1, c, readRecord(root, c)?.fm));
+    return `${body}\n\n## Sources\n\n${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAA8B,KAAK,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAU;IACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,CAAC,CAAC,GAAG,CAAC;IAC/C,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;AAC7E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,EAAU,EAAE,EAA2B;IACzE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAA4B,CAAC;IAChD,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CACvE,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CACtD,CAAC;IACF,OAAO,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,EAAU;IAC7C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,GAAG,IAAI,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAClF,OAAO,GAAG,IAAI,qBAAqB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC1D,CAAC"}

package/dist/repo.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { type Doc } from "./records.js";
+export declare const CONFIG = "knowledge.json";
+export declare const RECORD_DIRS: string[];
+export declare const Config: z.ZodObject<{
+    owner: z.ZodDefault<z.ZodString>;
+    push: z.ZodDefault<z.ZodBoolean>;
+    remote: z.ZodDefault<z.ZodString>;
+}, z.core.$loose>;
+export type Config = z.infer<typeof Config>;
+/** The repo root: `dir`, else the nearest folder up from cwd with a knowledge.json. */
+export declare function findRoot(dir?: string): string;
+export declare function loadConfig(root: string): Config;
+export interface Loaded {
+    path: string;
+    doc: Doc;
+}
+export interface Broken {
+    path: string;
+    error: string;
+}
+export interface Tree {
+    docs: Loaded[];
+    broken: Broken[];
+}
+/** The working tree's records (uncommitted edits included). */
+export declare function loadWorking(root: string): Tree;
+/** The records at a commit: what the index and a server hook see. */
+export declare function loadAt(root: string, rev: string): Tree;
+export declare function readPathsAt(root: string, rev: string, paths: string[]): Tree;

package/dist/repo.js

@@ -0,0 +1,75 @@
+/** A repo's records, read from the working tree or from a commit, and its config. */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { z } from "zod";
+import { lsTree, readAt } from "./git.js";
+import { DIRS, parse } from "./records.js";
+export const CONFIG = "knowledge.json";
+export const RECORD_DIRS = Object.values(DIRS);
+export const Config = z.looseObject({
+    // who may write a rule with no cites: the person whose own word is the evidence
+    owner: z.string().default("owner"),
+    // write commands push after their commit
+    push: z.boolean().default(false),
+    remote: z.string().default("origin"),
+});
+/** The repo root: `dir`, else the nearest folder up from cwd with a knowledge.json. */
+export function findRoot(dir) {
+    if (dir)
+        return resolve(dir);
+    let at = process.cwd();
+    for (;;) {
+        if (existsSync(join(at, CONFIG)))
+            return at;
+        const up = dirname(at);
+        if (up === at)
+            throw new Error(`no ${CONFIG} here or above; pass --repo or set KNOWLEDGE_DIR`);
+        at = up;
+    }
+}
+export function loadConfig(root) {
+    const p = join(root, CONFIG);
+    return Config.parse(existsSync(p) ? JSON.parse(readFileSync(p, "utf8")) : {});
+}
+function collect(files) {
+    const docs = [];
+    const broken = [];
+    for (const [path, text] of files) {
+        const r = parse(text);
+        if (r.ok)
+            docs.push({ path, doc: r.doc });
+        else
+            broken.push({ path, error: r.error });
+    }
+    return { docs, broken };
+}
+const isRecord = (p) => p.endsWith(".md") && !p.split("/").pop()?.startsWith("_");
+/** The working tree's records (uncommitted edits included). */
+export function loadWorking(root) {
+    const files = new Map();
+    const walk = (dir) => {
+        if (!existsSync(dir))
+            return;
+        for (const e of readdirSync(dir, { withFileTypes: true })) {
+            const full = join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else {
+                const rel = relative(root, full);
+                if (isRecord(rel))
+                    files.set(rel, readFileSync(full, "utf8"));
+            }
+        }
+    };
+    for (const d of RECORD_DIRS)
+        walk(join(root, d));
+    return collect(files);
+}
+/** The records at a commit: what the index and a server hook see. */
+export function loadAt(root, rev) {
+    return collect(readAt(root, rev, lsTree(root, rev, RECORD_DIRS).filter(isRecord)));
+}
+export function readPathsAt(root, rev, paths) {
+    return collect(readAt(root, rev, paths.filter(isRecord)));
+}
+//# sourceMappingURL=repo.js.map

package/dist/repo.js.map

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

package/dist/write.d.ts

@@ -0,0 +1,51 @@
+import { type Problem } from "./lint.js";
+import { type RecordType } from "./records.js";
+import { type Loaded } from "./repo.js";
+export type Change = {
+    op: "add";
+    type: RecordType;
+    title: string;
+    body?: string;
+    id?: string;
+    [k: string]: unknown;
+} | {
+    op: "edit";
+    id: string;
+    body?: string;
+    [k: string]: unknown;
+} | {
+    op: "retire";
+    id: string;
+};
+export interface Who {
+    by: string;
+    why: string;
+}
+export declare class LintError extends Error {
+    readonly problems: Problem[];
+    name: string;
+    constructor(problems: Problem[]);
+}
+/** Serialize work on one checkout: writes, syncs, and reads of a PGlite index. */
+export declare function withLock<T>(root: string, fn: () => Promise<T>): Promise<T>;
+export interface Written {
+    commit: string;
+    records: {
+        id: string;
+        type: RecordType;
+        path: string;
+        version: number;
+        op: Change["op"];
+    }[];
+    warnings: Problem[];
+}
+export declare function apply(docs: Loaded[], changes: Change[], who: Who, now?: Date): {
+    next: Loaded[];
+    touched: {
+        id: string;
+        op: Change["op"];
+        from?: string;
+    }[];
+};
+/** Apply, lint, write, commit. Throws LintError (nothing written) or the commit's error (files restored). */
+export declare function write(root: string, changes: Change[], who: Who): Promise<Written>;

package/dist/write.js

@@ -0,0 +1,175 @@
+/**
+ * One write = one commit. Changes apply to the tree in memory, the whole tree is linted, then the files
+ * land and commit together; a failed commit puts every file back. A lock serializes writers in one
+ * checkout; across checkouts, push is the compare-and-swap (push.ts).
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import lockfile from "proper-lockfile";
+import { git, head } from "./git.js";
+import { errors, lint } from "./lint.js";
+import { Frontmatter, newId, pathOf, serialize } from "./records.js";
+import { loadConfig, loadWorking } from "./repo.js";
+export class LintError extends Error {
+    problems;
+    name = "LintError";
+    constructor(problems) {
+        super(problems.map((p) => `${p.path}: ${p.msg}`).join("\n"));
+        this.problems = problems;
+    }
+}
+// fields the store owns: a change never sets them
+const OWNED = new Set(["op", "type", "version", "created", "updated", "by", "why", "status"]);
+/** Serialize work on one checkout: writes, syncs, and reads of a PGlite index. */
+export async function withLock(root, fn) {
+    const gitDir = join(root, git(root, ["rev-parse", "--git-dir"]));
+    const release = await lockfile.lock(root, {
+        lockfilePath: join(gitDir, "knowledge.lock"),
+        retries: { retries: 120, minTimeout: 50, maxTimeout: 1000 },
+        stale: 60_000,
+    });
+    try {
+        return await fn();
+    }
+    finally {
+        await release();
+    }
+}
+export function apply(docs, changes, who, now = new Date()) {
+    const stamp = now.toISOString();
+    const byId = new Map(docs.map((l) => [l.doc.fm.id, l]));
+    const touched = [];
+    for (const c of changes) {
+        if (c.op === "add") {
+            const { op: _op, body, ...rest } = c;
+            const id = c.id ?? newId(c.title);
+            if (byId.has(id))
+                throw new Error(`add: ${id} is already in the repo`);
+            const fields = Object.fromEntries(Object.entries(rest).filter(([k]) => !OWNED.has(k)));
+            const fm = Frontmatter.parse({
+                ...fields,
+                id,
+                type: c.type,
+                status: "live",
+                version: 1,
+                by: who.by,
+                why: rest.why ?? who.why,
+                created: stamp,
+                updated: stamp,
+            });
+            byId.set(id, { path: pathOf(fm), doc: { fm, body: (body ?? "").trim() } });
+            touched.push({ id, op: "add" });
+            continue;
+        }
+        const cur = byId.get(c.id);
+        if (!cur)
+            throw new Error(`${c.op}: no record ${c.id}`);
+        const old = cur.doc.fm;
+        let fm;
+        let body = cur.doc.body;
+        if (c.op === "retire") {
+            if (old.status === "retired")
+                throw new Error(`retire: ${c.id} is already retired`);
+            fm = Frontmatter.parse({ ...old, status: "retired" });
+        }
+        else {
+            const { op: _op, id: _id, body: b, ...patch } = c;
+            for (const k of Object.keys(patch))
+                if (OWNED.has(k) || k === "id")
+                    throw new Error(`edit: ${k} is set by the store`);
+            // null drops an optional field
+            const merged = { ...old, ...patch };
+            for (const [k, v] of Object.entries(merged))
+                if (v === null)
+                    delete merged[k];
+            fm = Frontmatter.parse(merged);
+            if (typeof b === "string")
+                body = b.trim();
+        }
+        fm.version = old.version + 1;
+        fm.updated = stamp;
+        fm.by = who.by;
+        fm.why = who.why;
+        byId.set(c.id, { path: pathOf(fm), doc: { fm, body } });
+        touched.push({ id: c.id, op: c.op, from: cur.path });
+    }
+    return { next: [...byId.values()], touched };
+}
+function message(changes, touched, who) {
+    const first = touched[0];
+    const subject = touched.length === 1 && first
+        ? `knowledge: ${first.op} ${first.id}`
+        : `knowledge: ${touched.length} changes (${[...new Set(changes.map((c) => c.op))].join(", ")})`;
+    const lines = touched.length > 1 ? `\n${touched.map((t) => `- ${t.op} ${t.id}`).join("\n")}\n` : "";
+    return `${subject}\n\n${who.why}\n${lines}\nKnowledge-By: ${who.by}`;
+}
+/** Apply, lint, write, commit. Throws LintError (nothing written) or the commit's error (files restored). */
+export async function write(root, changes, who) {
+    if (!changes.length)
+        throw new Error("no changes");
+    if (!who.by.trim() || !who.why.trim())
+        throw new Error("--by and --why are required");
+    return withLock(root, async () => {
+        const tree = loadWorking(root);
+        const { next, touched } = apply(tree.docs, changes, who);
+        const problems = lint({ docs: next, broken: tree.broken }, loadConfig(root).owner);
+        // a fault already elsewhere in the tree does not block this write; one in a record it touches does
+        const mine = new Set(touched.map((t) => t.id));
+        const blocking = errors(problems).filter((p) => p.id && mine.has(p.id));
+        if (blocking.length)
+            throw new LintError(blocking);
+        const byId = new Map(next.map((l) => [l.doc.fm.id, l]));
+        const paths = new Set();
+        const backup = new Map();
+        const keep = (p) => {
+            if (backup.has(p))
+                return;
+            const full = join(root, p);
+            backup.set(p, existsSync(full) ? readFileSync(full, "utf8") : null);
+            paths.add(p);
+        };
+        for (const t of touched) {
+            const l = byId.get(t.id);
+            if (!l)
+                continue;
+            if (t.from && t.from !== l.path) {
+                keep(t.from);
+                rmSync(join(root, t.from), { force: true });
+            }
+            keep(l.path);
+            mkdirSync(dirname(join(root, l.path)), { recursive: true });
+            writeFileSync(join(root, l.path), serialize(l.doc));
+        }
+        try {
+            const list = [...paths];
+            git(root, ["add", "-A", "--", ...list]);
+            git(root, ["commit", "-q", "-m", message(changes, touched, who), "--", ...list]);
+        }
+        catch (e) {
+            for (const [p, text] of backup) {
+                const full = join(root, p);
+                if (text === null)
+                    rmSync(full, { force: true });
+                else {
+                    mkdirSync(dirname(full), { recursive: true });
+                    writeFileSync(full, text);
+                }
+            }
+            try {
+                git(root, ["reset", "-q", "--", ...paths]);
+            }
+            catch { }
+            throw e;
+        }
+        const commit = head(root);
+        return {
+            commit,
+            records: touched.map((t) => {
+                const l = byId.get(t.id);
+                return { id: t.id, type: l.doc.fm.type, path: l.path, version: l.doc.fm.version, op: t.op };
+            }),
+            warnings: problems.filter((p) => p.level === "warn" && (!p.id || mine.has(p.id))),
+        };
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/write.js.map

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

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@wrenautomation/knowledge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.59.0",
+  "description": "Knowledge as files: sources, findings, verdicts and rules as markdown records in a git repo, each linked to its evidence. One commit is one transaction; a lint guards every write; a Postgres (or PGlite) index built from the commits answers queries, backlinks and stale marks.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wrenautomation/engine.git",
+    "directory": "packages/knowledge"
+  },
+  "license": "PolyForm-Strict-1.0.0",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "knowledge": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "dependencies": {
+    "@electric-sql/pglite": "0.5.11",
+    "commander": "15.0.0",
+    "drizzle-orm": "0.45.4",
+    "gray-matter": "4.0.3",
+    "postgres": "3.4.9",
+    "proper-lockfile": "4.1.2",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@types/proper-lockfile": "4.1.4"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "sh ../../scripts/build.sh cli.js"
+  }
 }