@wrenautomation/knowledge 0.0.0-stage → 0.58.0

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.58.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"
+  }
 }