@wrenautomation/knowledge 0.0.0-stage → 0.58.0

package/dist/push.js

@@ -0,0 +1,52 @@
+/**
+ * Push = compare-and-swap on the remote branch. A push that loses fetches, merges, lints the merged
+ * commit (two clean branches can still break a cite together) and tries again. A merge that conflicts
+ * or fails the lint is undone and reported; the local commit stays.
+ */
+import { git, head, tryGit } from "./git.js";
+import { errors, lint } from "./lint.js";
+import { loadAt, loadConfig } from "./repo.js";
+export function push(root, tries = 4) {
+    const cfg = loadConfig(root);
+    const branch = git(root, ["rev-parse", "--abbrev-ref", "HEAD"]);
+    let merged = false;
+    for (let i = 1; i <= tries; i++) {
+        const p = tryGit(root, ["push", "-q", cfg.remote, `HEAD:refs/heads/${branch}`]);
+        if (p.ok)
+            return { pushed: true, head: head(root), merged, tries: i };
+        if (!/rejected|non-fast-forward|fetch first|cannot lock ref/i.test(p.out))
+            return { pushed: false, head: head(root), merged, tries: i, error: p.out };
+        git(root, ["fetch", "-q", cfg.remote, branch]);
+        const before = head(root);
+        const m = tryGit(root, ["merge", "-q", "--no-edit", "FETCH_HEAD"]);
+        if (!m.ok) {
+            tryGit(root, ["merge", "--abort"]);
+            return { pushed: false, head: before, merged, tries: i, error: `merge: ${m.out}` };
+        }
+        const now = head(root);
+        const bad = newFaults(root, cfg.owner, [before, "FETCH_HEAD"], now);
+        if (bad.length) {
+            git(root, ["reset", "-q", "--merge", before]);
+            return {
+                pushed: false,
+                head: before,
+                merged,
+                tries: i,
+                problems: bad,
+                error: "the merged tree fails the lint",
+            };
+        }
+        merged = merged || now !== before;
+    }
+    return { pushed: false, head: head(root), merged, tries, error: "the remote kept moving" };
+}
+/**
+ * The lint errors at `rev` that no base had: what a change made. A push, and a server's pre-receive
+ * hook (`knowledge lint --rev <new> --base <old>`), refuse on these only.
+ */
+export function newFaults(root, owner, bases, rev) {
+    const key = (x) => `${x.path}|${x.msg}`;
+    const had = new Set(bases.flatMap((r) => errors(lint(loadAt(root, r), owner)).map(key)));
+    return errors(lint(loadAt(root, rev), owner)).filter((x) => !had.has(key(x)));
+}
+//# sourceMappingURL=push.js.map

package/dist/push.js.map

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

package/dist/record-index.d.ts

@@ -0,0 +1,458 @@
+import { type PgDatabase } from "drizzle-orm/pg-core";
+import { type RecordType } from "./records.js";
+import { type Broken } from "./repo.js";
+export declare const metaT: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "knowledge_meta";
+    schema: undefined;
+    columns: {
+        repo: import("drizzle-orm/pg-core").PgColumn<{
+            name: "repo";
+            tableName: "knowledge_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "knowledge_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        value: import("drizzle-orm/pg-core").PgColumn<{
+            name: "value";
+            tableName: "knowledge_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const recordsT: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "knowledge_records";
+    schema: undefined;
+    columns: {
+        repo: import("drizzle-orm/pg-core").PgColumn<{
+            name: "repo";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        version: import("drizzle-orm/pg-core").PgColumn<{
+            name: "version";
+            tableName: "knowledge_records";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        by: import("drizzle-orm/pg-core").PgColumn<{
+            name: "by";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        why: import("drizzle-orm/pg-core").PgColumn<{
+            name: "why";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        path: import("drizzle-orm/pg-core").PgColumn<{
+            name: "path";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        topic: import("drizzle-orm/pg-core").PgColumn<{
+            name: "topic";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        source: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        body: import("drizzle-orm/pg-core").PgColumn<{
+            name: "body";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        data: import("drizzle-orm/pg-core").PgColumn<{
+            name: "data";
+            tableName: "knowledge_records";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        created: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated";
+            tableName: "knowledge_records";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export declare const citesT: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "knowledge_cites";
+    schema: undefined;
+    columns: {
+        repo: import("drizzle-orm/pg-core").PgColumn<{
+            name: "repo";
+            tableName: "knowledge_cites";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        from: import("drizzle-orm/pg-core").PgColumn<{
+            name: "from";
+            tableName: "knowledge_cites";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        to: import("drizzle-orm/pg-core").PgColumn<{
+            name: "to";
+            tableName: "knowledge_cites";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+export type Db = PgDatabase<any, any, any>;
+export type Row = typeof recordsT.$inferSelect;
+export interface Synced {
+    repo: string;
+    head: string | null;
+    mode: "none" | "diff" | "full";
+    upserted: number;
+    deleted: number;
+    broken: Broken[];
+}
+export declare class RecordIndex {
+    readonly db: Db;
+    private readonly close_;
+    private ready;
+    constructor(db: Db, close_?: () => Promise<void>);
+    close(): Promise<void>;
+    /** Create the tables; a schema change drops and rebuilds them. */
+    init(): Promise<void>;
+    indexedHead(repo: string): Promise<string | null>;
+    /** Bring `repo` up to the checkout's HEAD. `full` rebuilds it from the files. */
+    sync(root: string, repo: string, opts?: {
+        full?: boolean;
+    }): Promise<Synced>;
+    get(repo: string, id: string): Promise<{
+        record: {
+            repo: string;
+            id: string;
+            type: string;
+            title: string;
+            status: string;
+            version: number;
+            by: string;
+            why: string;
+            path: string;
+            topic: string | null;
+            source: string | null;
+            body: string;
+            data: unknown;
+            created: string;
+            updated: string;
+        };
+        cites: {
+            id: string;
+            type: string | null;
+            title: string | null;
+            status: string;
+        }[];
+        citedBy: {
+            id: string;
+            type: string | null;
+            title: string | null;
+            status: string;
+        }[];
+    } | null>;
+    /** other = "to": what `id` cites; "from": what cites `id`. */
+    private linked;
+    find(repo: string | null, f?: {
+        q?: string;
+        type?: RecordType;
+        topic?: string;
+        status?: string;
+        limit?: number;
+    }): Promise<Row[]>;
+    /** Live records whose evidence is missing, retired, or changed after them. */
+    stale(repo: string): Promise<{
+        id: string;
+        type: string;
+        title: string;
+        cites: string;
+        why: string;
+    }[]>;
+}
+/** PGlite in a folder (a checkout's own), or Postgres when a URL is given. */
+export declare function openIndex(opts: {
+    url?: string;
+    dir?: string;
+}): Promise<RecordIndex>;