@bluewombat/runtime 0.1.0

package/dist/loop/work-line.js

@@ -0,0 +1,109 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { ISOLATION_GIT } from "../config/defaults.js";
+import { inHome } from "../config/home.js";
+/** What is at that path today. Integrator folds by merge only on a git tree. */
+export function inspectWorkLine(path) {
+    if (!existsSync(path)) {
+        return { kind: "missing" };
+    }
+    if (!statSync(path).isDirectory()) {
+        return { kind: "not-a-directory" };
+    }
+    if (!existsSync(join(path, ".git"))) {
+        return { kind: "plain" };
+    }
+    return { kind: "git", branch: branchOf(path) };
+}
+/**
+ * `symbolic-ref` first: it answers on a repository with no commit yet, where
+ * `rev-parse HEAD` has nothing to resolve. `rev-parse` is the fallback for a
+ * detached HEAD.
+ */
+function branchOf(path) {
+    const symbolic = git(["symbolic-ref", "--short", "HEAD"], path);
+    if (symbolic.ok && symbolic.stdout.trim().length > 0) {
+        return symbolic.stdout.trim();
+    }
+    const revision = git(["rev-parse", "--short", "HEAD"], path);
+    return revision.ok ? `detached at ${revision.stdout.trim()}` : "unknown";
+}
+/** Offline. Everything here reads; `materializeWorkLine` is the one write. */
+export function resolveWorkLine(input) {
+    // A reference is where an Authority keeps the work line. With none, the
+    // fold lands here and is final, so the directory is the operator's — even
+    // when the manager could name one.
+    if (input.reference === undefined || !input.wantsAuthority) {
+        if (input.stable === undefined) {
+            const why = input.wantsAuthority
+                ? `${input.manager} names no reference work line to copy from`
+                : "without an Authority the fold lands here and is final";
+            return {
+                kind: "invalid",
+                reason: `"workLine.stable" is not set, and ${why}. Set it to the directory the work is folded into.`,
+            };
+        }
+        return { kind: "operators", stable: input.stable };
+    }
+    const backend = input.strategy.reference;
+    if (backend === undefined) {
+        const reason = `${input.manager} names a reference work line, but ${input.strategyName} cannot keep a copy of one.`;
+        if (input.stable === undefined) {
+            return {
+                kind: "invalid",
+                reason: `${reason} Set "workLine.stable" to a copy you maintain, or use a strategy that can (e.g. "${ISOLATION_GIT}").`,
+            };
+        }
+        return { kind: "unchecked", stable: input.stable, reason };
+    }
+    const parsed = backend.parse(input.reference);
+    if (!parsed.ok) {
+        return {
+            kind: "invalid",
+            reason: `${input.strategyName} cannot read the reference work line ${input.manager} names: ${parsed.reason}.`,
+        };
+    }
+    if (input.branch !== undefined && input.branch !== parsed.target) {
+        return {
+            kind: "invalid",
+            reason: `"workLine.branch" is "${input.branch}", but ${input.manager} names "${parsed.target}" as the reference. Drop the key, or make them agree.`,
+        };
+    }
+    const stable = input.stable ?? inHome(input.home, "workLine");
+    return {
+        kind: "copy",
+        stable,
+        target: parsed.target,
+        reference: parsed,
+        state: parsed.inspect(stable),
+    };
+}
+/**
+ * Bring a `copy` resolution to a directory a run can use: fetch a missing one,
+ * refuse a directory that is not a copy of the reference. Network.
+ */
+export async function materializeWorkLine(resolution) {
+    if (resolution.state.kind === "matches") {
+        return { ok: true, fetched: false };
+    }
+    if (resolution.state.kind === "mismatch") {
+        return {
+            ok: false,
+            reason: `${resolution.stable} is not a copy of ${resolution.reference.summary}: ${resolution.state.reason}. Move it, or point "workLine.stable" elsewhere.`,
+        };
+    }
+    const made = await resolution.reference.materialize(resolution.stable);
+    if (!made.ok) {
+        return {
+            ok: false,
+            reason: `Cannot copy ${resolution.reference.summary} to ${resolution.stable}: ${made.reason}`,
+        };
+    }
+    return { ok: true, fetched: true };
+}
+function git(argv, cwd) {
+    const result = spawnSync("git", argv, { encoding: "utf8", cwd });
+    return { ok: result.status === 0, stdout: result.stdout ?? "" };
+}
+//# sourceMappingURL=work-line.js.map

package/dist/loop/work-line.js.map

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

package/dist/operator/board.d.ts

@@ -0,0 +1,31 @@
+import type { WorkLedger } from "@bluewombat/work-ledger";
+export type BoardFeature = {
+    key: string;
+    project: string;
+    state: string;
+    priority: number;
+    received_at: number;
+    bail_expires_at?: number;
+    attempts_used?: number;
+    subtasks?: {
+        id: string;
+        state: string;
+    }[];
+    escalation?: {
+        kind: string;
+        subtask_id?: string;
+    };
+    invalid?: {
+        code: string;
+        reason: string;
+    };
+    submission?: {
+        reference: string;
+        refusals: number;
+        last_report?: string;
+    };
+    line: string;
+};
+export declare function boardOf(ledger: WorkLedger): Promise<BoardFeature[]>;
+export declare function jsonOf(rows: BoardFeature[]): unknown;
+//# sourceMappingURL=board.d.ts.map

package/dist/operator/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/operator/board.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoC,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG5F,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,UAAU,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAQzE;AAyDD,wBAAgB,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAEpD"}

package/dist/operator/board.js

@@ -0,0 +1,67 @@
+import { describeFeature } from "../loop/trace.js";
+export async function boardOf(ledger) {
+    const summaries = await ledger.list();
+    const rows = [];
+    for (const summary of summaries) {
+        const got = await ledger.get(summary.key);
+        rows.push(got.ok ? rowOf(got.aggregate) : rowFromSummary(summary));
+    }
+    return rows;
+}
+function rowFromSummary(summary) {
+    const row = {
+        key: summary.key,
+        project: summary.project,
+        state: summary.state,
+        priority: summary.priority,
+        received_at: summary.received_at,
+        line: `${summary.key}  ${summary.state}`,
+    };
+    if (summary.bail_expires_at !== undefined) {
+        row.bail_expires_at = summary.bail_expires_at;
+    }
+    return row;
+}
+function rowOf(aggregate) {
+    const row = {
+        key: aggregate.intention.key,
+        project: aggregate.intention.project,
+        state: aggregate.state,
+        priority: aggregate.intention.priority,
+        received_at: aggregate.received_at,
+        attempts_used: aggregate.attempts_used,
+        line: describeFeature(aggregate),
+    };
+    if (aggregate.bail !== undefined) {
+        row.bail_expires_at = aggregate.bail.expires_at;
+    }
+    if (aggregate.plan !== undefined) {
+        row.subtasks = aggregate.plan.subtasks.map((subtask) => ({
+            id: subtask.id,
+            state: subtask.state,
+        }));
+    }
+    if (aggregate.escalation !== undefined) {
+        row.escalation = { kind: aggregate.escalation.kind };
+        if (aggregate.escalation.subtask_id !== undefined) {
+            row.escalation.subtask_id = aggregate.escalation.subtask_id;
+        }
+    }
+    if (aggregate.invalid !== undefined) {
+        row.invalid = { code: aggregate.invalid.code, reason: aggregate.invalid.reason };
+    }
+    if (aggregate.submission !== undefined) {
+        row.submission = {
+            reference: aggregate.submission.reference,
+            refusals: aggregate.submission.refusals,
+        };
+        if (aggregate.submission.last_report !== undefined) {
+            row.submission.last_report = aggregate.submission.last_report;
+        }
+    }
+    return row;
+}
+export function jsonOf(rows) {
+    return rows.map(({ line, ...rest }) => rest);
+}
+//# sourceMappingURL=board.js.map

package/dist/operator/board.js.map

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

package/dist/operator/cancel.d.ts

@@ -0,0 +1,19 @@
+export type CancelInput = {
+    cwd: string;
+    argv: string[];
+    env?: Record<string, string | undefined>;
+    write: (line: string) => void;
+    interruptFlag?: {
+        interrupted: boolean;
+    };
+};
+/**
+ * Abandon one Feature by key.
+ *
+ * The team still abandons in the FeatureManager. This is the hatch when the
+ * tracker cannot say the intention is gone — a manager with no `probe`, or
+ * an operator who already knows — and the ledger would otherwise freeze the
+ * Project. It takes the ledger lock: stop `run` first if it holds it.
+ */
+export declare function runCancel(input: CancelInput): Promise<number>;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/operator/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/operator/cancel.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDnE"}

package/dist/operator/cancel.js

@@ -0,0 +1,70 @@
+import { PRODUCT } from "@bluewombat/manager-kit";
+import { parseArgs } from "../config/parse-args.js";
+import { openHost } from "../loop/open-host.js";
+/**
+ * Abandon one Feature by key.
+ *
+ * The team still abandons in the FeatureManager. This is the hatch when the
+ * tracker cannot say the intention is gone — a manager with no `probe`, or
+ * an operator who already knows — and the ledger would otherwise freeze the
+ * Project. It takes the ledger lock: stop `run` first if it holds it.
+ */
+export async function runCancel(input) {
+    const peeled = peelKey(input.argv);
+    if (peeled.key === undefined) {
+        input.write(`Usage: ${PRODUCT} cancel <key>\n`);
+        return 2;
+    }
+    const { key } = peeled;
+    const parsed = parseArgs(peeled.rest, { cwd: input.cwd });
+    if (!parsed.ok) {
+        input.write(`${parsed.reason}\n`);
+        return 2;
+    }
+    const interruptFlag = input.interruptFlag ?? { interrupted: false };
+    const options = {
+        ...parsed.invocation,
+        interruptFlag,
+        ...(input.env === undefined ? {} : { env: input.env }),
+    };
+    let host;
+    try {
+        host = await openHost(options);
+        const result = await host.cancel(key);
+        if (result.ok) {
+            input.write(`Cancelled ${key}.\n`);
+            return 0;
+        }
+        switch (result.code) {
+            case "already-cancelled":
+                input.write(`Already cancelled.\n`);
+                return 0;
+            case "not-found":
+                input.write(`No Feature named "${key}" in the ledger.\n`);
+                return 2;
+            case "done":
+                input.write("Too late: that Feature is already done.\n");
+                return 1;
+            case "point-of-no-return":
+                input.write("Too late: abandon is refused after merging.\n");
+                return 1;
+        }
+        return 2;
+    }
+    catch (error) {
+        input.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        return 2;
+    }
+    finally {
+        await host?.close();
+    }
+}
+/** The key is the first positional: `cancel <key> [flags]`. */
+function peelKey(argv) {
+    const first = argv[0];
+    if (first === undefined || first.startsWith("-")) {
+        return { key: undefined, rest: argv };
+    }
+    return { key: first, rest: argv.slice(1) };
+}
+//# sourceMappingURL=cancel.js.map

package/dist/operator/cancel.js.map

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

package/dist/operator/doctor.d.ts

@@ -0,0 +1,15 @@
+export type DoctorInput = {
+    cwd: string;
+    argv: string[];
+    env: Record<string, string | undefined>;
+    write: (line: string) => void;
+    /** Defaults to the running one. Named so the check itself stays testable. */
+    nodeVersion?: string;
+};
+/**
+ * Say what is missing before a run says it. Nothing here uses the network:
+ * the answer must be the same offline, and a manager's own check is held to
+ * the same rule.
+ */
+export declare function runDoctor(input: DoctorInput): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/operator/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/operator/doctor.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAIF;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA0EnE"}