@nodetool-ai/cli 0.7.0-rc.23 → 0.8.1

package/dist/commands/generations.js

@@ -0,0 +1,408 @@
+/**
+ * `nodetool generations` — the record of every media generation, from the
+ * local DB, no server needed.
+ *
+ * One row per provider media call, opened before the call and closed with
+ * its outcome (docs/media-generation-tracking-design.md). `list` and `get`
+ * read the rows, `await` waits for one to settle, `cancel` closes a running
+ * one, `reconcile` asks the provider what it billed, and `sweep` runs the
+ * startup sweep plus one drain of the reconcile queue by hand.
+ *
+ * `provider-list` and `provider-get` ask the *provider* instead: its own
+ * record of what this account ran, from any machine, at the price it billed.
+ * The seven actions are the `generations` agent capabilities.
+ */
+import { deriveGenerationStatus, Prediction, getSecret } from "@nodetool-ai/models";
+import { drainReconcileQueue, reconcileGeneration, sweepInterruptedGenerations } from "@nodetool-ai/execution";
+import { isProviderGenerationsUnsupported } from "@nodetool-ai/runtime";
+import { createProviderStrict } from "../providers.js";
+import { asJson, printTable, printKv } from "./output.js";
+import { setupLocalDb, LOCAL_USER_ID } from "./local-db.js";
+import { isString } from "../predicates.js";
+const PUBLIC_STATUSES = new Set([
+    "pending",
+    "running",
+    "recovering",
+    "completed",
+    "failed",
+    "cancelled",
+    "needs_attention",
+    "interrupted"
+]);
+const TERMINAL = new Set([
+    "completed",
+    "failed",
+    "cancelled",
+    "needs_attention",
+    "interrupted"
+]);
+function lifecycleError(row, key) {
+    const value = row.metadata?.[key];
+    return isString(value) ? value : null;
+}
+/** Completed is public only after the durable output has been saved. */
+function publicGenerationStatus(row) {
+    if (row.status === "interrupted")
+        return "interrupted";
+    if (row.lifecycle_owner !== "durable") {
+        return PUBLIC_STATUSES.has(row.status) ? row.status : "pending";
+    }
+    return deriveGenerationStatus(row);
+}
+function fail(e) {
+    console.error(String(e instanceof Error ? e.message : e));
+    process.exit(1);
+}
+function costCell(cost) {
+    return cost == null ? "unpriced" : `$${cost.toFixed(4)}`;
+}
+/** The row, in the shape `get_generation` answers with. */
+function record(row) {
+    const metadata = row.metadata ?? {};
+    return {
+        generation_id: row.id,
+        status: publicGenerationStatus(row),
+        submission_status: row.submission_status ?? null,
+        provider_status: row.provider_status ?? null,
+        output_status: row.output_status ?? null,
+        attachment_status: row.attachment_status ?? null,
+        provider: row.provider,
+        model: row.model,
+        capability: row.capability ?? null,
+        cost: row.cost,
+        currency: row.currency,
+        billing_unit: row.billing_unit,
+        quantity: row.quantity,
+        unit_price: row.unit_price,
+        price_source: metadata.price_source ?? null,
+        asset_ids: row.asset_ids ?? [],
+        started_at: row.started_at,
+        completed_at: row.completed_at,
+        duration_seconds: row.duration,
+        generation_error: row.error,
+        submission_error: lifecycleError(row, "submission_error"),
+        provider_error: lifecycleError(row, "provider_error"),
+        output_error: lifecycleError(row, "output_error"),
+        attachment_error: lifecycleError(row, "attachment_error"),
+        origin: {
+            surface: row.surface ?? null,
+            thread_id: row.thread_id ?? null,
+            tool_call_id: row.tool_call_id ?? null,
+            job_id: row.job_id ?? null,
+            node_id: row.node_id,
+            workflow_id: row.workflow_id
+        },
+        provider_request_id: row.provider_request_id,
+        reconcile: {
+            reconciled_at: row.reconciled_at ?? null,
+            attempts: row.reconcile_attempts ?? 0,
+            error: metadata.reconcile_error ?? null,
+            next_at: metadata.reconcile_next_at ?? null
+        },
+        parameters: row.parameters
+    };
+}
+function summaryRow(row) {
+    return {
+        id: row.id,
+        status: publicGenerationStatus(row),
+        provider: row.provider,
+        model: row.model,
+        capability: row.capability ?? "",
+        cost: costCell(row.cost),
+        assets: (row.asset_ids ?? []).join(","),
+        output: row.output_status ?? "",
+        started: row.started_at ?? row.created_at ?? ""
+    };
+}
+const resolveSecret = (key, userId) => getSecret(key, userId);
+const PROVIDER_STATUSES = new Set([
+    "running",
+    "completed",
+    "failed",
+    "cancelled",
+    "unknown"
+]);
+/** `--status` as the provider vocabulary, rejecting anything else outright. */
+function providerStatusOption(value) {
+    if (!PROVIDER_STATUSES.has(value)) {
+        fail(`Invalid --status value: ${value}. One of ${[...PROVIDER_STATUSES].join(", ")}.`);
+    }
+    // SAFETY: the set holds exactly the members of ProviderGenerationStatus.
+    return value;
+}
+/** A provider with no history API is a capability answer, not a stack trace. */
+function providerGenerationsMessage(providerId, error) {
+    if (isProviderGenerationsUnsupported(error)) {
+        return (`${providerId} exposes no generation history. Read this installation's ` +
+            `own record with \`nodetool generations list\`.`);
+    }
+    return String(error instanceof Error ? error.message : error);
+}
+function providerSummaryRow(row) {
+    return {
+        request_id: row.request_id,
+        status: row.status,
+        model: row.model ?? "",
+        cost: costCell(row.cost),
+        started: row.created_at ?? "",
+        outputs: String(row.output_urls.length)
+    };
+}
+export function registerGenerationsCommands(program) {
+    const generations = program
+        .command("generations")
+        .description("Inspect, wait on, cancel and reconcile media generations");
+    generations
+        .command("list")
+        .description("List generations, newest first")
+        .option("--status <status>", "pending, running, recovering, completed, failed, cancelled, needs_attention, interrupted")
+        .option("--provider <name>", "Filter by provider")
+        .option("--capability <name>", "Filter by capability, e.g. text_to_video")
+        .option("--thread-id <id>", "Only generations a chat thread asked for")
+        .option("--job-id <id>", "Only generations a workflow run asked for")
+        .option("--since <iso>", "Only generations created at or after this time")
+        .option("--limit <n>", "Max results", "50")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const limit = Number.parseInt(opts.limit, 10);
+        if (!Number.isFinite(limit) || limit <= 0) {
+            console.error(`Invalid --limit value: ${opts.limit}`);
+            process.exit(1);
+        }
+        try {
+            await setupLocalDb();
+            const [rows, next] = await Prediction.listGenerations(LOCAL_USER_ID, {
+                status: opts.status,
+                provider: opts.provider,
+                capability: opts.capability,
+                threadId: opts.threadId,
+                jobId: opts.jobId,
+                since: opts.since,
+                limit
+            });
+            if (opts.json) {
+                asJson({ generations: rows.map(record), next: next || null });
+                return;
+            }
+            if (rows.length === 0) {
+                console.log("No generations recorded.");
+                return;
+            }
+            printTable(rows.map(summaryRow));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    generations
+        .command("get <generation_id>")
+        .description("Read one generation in full")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        try {
+            await setupLocalDb();
+            const row = await Prediction.findForUser(LOCAL_USER_ID, id);
+            if (!row)
+                fail(`Generation ${id} was not found.`);
+            const rec = record(row);
+            if (opts.json) {
+                asJson(rec);
+                return;
+            }
+            printKv(rec);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    generations
+        .command("await <generation_id>")
+        .description("Wait for a generation to settle, polling the row")
+        .option("--timeout <seconds>", "How long to wait", "300")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const timeoutMs = Math.max(1, Number.parseInt(opts.timeout, 10) || 300) * 1000;
+        try {
+            await setupLocalDb();
+            const deadline = Date.now() + timeoutMs;
+            let row = await Prediction.findForUser(LOCAL_USER_ID, id);
+            if (!row)
+                fail(`Generation ${id} was not found.`);
+            while (!TERMINAL.has(publicGenerationStatus(row)) &&
+                Date.now() < deadline) {
+                await new Promise((r) => setTimeout(r, 2_000));
+                row = (await Prediction.findForUser(LOCAL_USER_ID, id)) ?? row;
+            }
+            const rec = record(row);
+            if (opts.json) {
+                asJson(rec);
+            }
+            else {
+                printKv(rec);
+            }
+            // The exit code is the verdict: a generation still running when the
+            // wait ran out is not a settled one.
+            process.exit(TERMINAL.has(publicGenerationStatus(row)) ? 0 : 1);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    generations
+        .command("cancel <generation_id>")
+        .description("Close a running generation as cancelled")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        try {
+            await setupLocalDb();
+            const row = await Prediction.findForUser(LOCAL_USER_ID, id);
+            const isDurable = row?.lifecycle_owner === "durable";
+            const cancellationRequested = isDurable
+                ? await Prediction.requestCancellation(id, LOCAL_USER_ID)
+                : false;
+            const cancelled = isDurable
+                ? false
+                : await Prediction.markCancelledIfRunning(id, LOCAL_USER_ID);
+            const succeeded = cancellationRequested || cancelled;
+            const result = {
+                generation_id: id,
+                cancelled,
+                cancellation_requested: cancellationRequested
+            };
+            if (opts.json)
+                asJson(result);
+            else
+                console.log(cancellationRequested
+                    ? `Cancellation requested for durable generation ${id}. The worker will close the record after the provider responds.`
+                    : cancelled
+                        ? `Generation ${id} cancelled. A call running in a server process finishes on its own; the record is closed.`
+                        : `Generation ${id} is not running — it already settled, or it does not exist.`);
+            process.exit(succeeded ? 0 : 1);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    generations
+        .command("reconcile <generation_id>")
+        .description("Ask the provider what it billed, by request id, and update the row")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        try {
+            await setupLocalDb();
+            const outcome = await reconcileGeneration(id, LOCAL_USER_ID, (key) => resolveSecret(key, LOCAL_USER_ID));
+            if (!outcome.found)
+                fail(`Generation ${id} was not found.`);
+            const result = {
+                generation_id: id,
+                before: outcome.before,
+                after: outcome.after,
+                reconciled: outcome.reconciled,
+                reason: outcome.reason ?? null
+            };
+            if (opts.json)
+                asJson(result);
+            else
+                printKv(result);
+            process.exit(outcome.reconciled ? 0 : 1);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    generations
+        .command("provider-list")
+        .description("List the provider's own record of this account's generations")
+        .requiredOption("--provider <name>", "Provider id, e.g. fal_ai")
+        .option("--model <id>", "Only this endpoint / model id (comma-separated)")
+        .option("--status <status>", "running, completed, failed, cancelled, unknown")
+        .option("--since <iso>", "Only generations started at or after this time")
+        .option("--until <iso>", "Exclusive upper bound")
+        .option("--limit <n>", "Max results", "50")
+        .option("--cursor <cursor>", "The next_cursor from a previous page")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const provider = await createProviderStrict(opts.provider);
+            const query = {
+                limit: Math.max(1, Number.parseInt(opts.limit, 10) || 50)
+            };
+            if (opts.model)
+                query.model = opts.model.split(",").map((m) => m.trim());
+            if (opts.status)
+                query.status = providerStatusOption(opts.status);
+            if (opts.since)
+                query.since = opts.since;
+            if (opts.until)
+                query.until = opts.until;
+            if (opts.cursor)
+                query.cursor = opts.cursor;
+            const page = await provider.listGenerations(query);
+            if (opts.json) {
+                asJson(page);
+                return;
+            }
+            if (page.generations.length === 0) {
+                console.log(`${opts.provider} reports no generations.`);
+            }
+            else {
+                printTable(page.generations.map(providerSummaryRow));
+            }
+            if (page.note)
+                console.log(page.note);
+            if (page.next_cursor)
+                console.log(`next_cursor: ${page.next_cursor}`);
+        }
+        catch (e) {
+            fail(providerGenerationsMessage(opts.provider, e));
+        }
+    });
+    generations
+        .command("provider-get <request_id>")
+        .description("Ask a provider about one generation, by its own request id")
+        .requiredOption("--provider <name>", "Provider id, e.g. fal_ai")
+        .option("--model <id>", "The endpoint / model id, when known")
+        .option("--json", "Output as JSON")
+        .action(async (requestId, opts) => {
+        try {
+            await setupLocalDb();
+            const provider = await createProviderStrict(opts.provider);
+            const lookup = {};
+            if (opts.model)
+                lookup.model = opts.model;
+            const row = await provider.getGeneration(requestId, lookup);
+            if (!row)
+                fail(`${opts.provider} has no request ${requestId}.`);
+            if (opts.json)
+                asJson(row);
+            else
+                printKv({ ...row });
+        }
+        catch (e) {
+            fail(providerGenerationsMessage(opts.provider, e));
+        }
+    });
+    generations
+        .command("sweep")
+        .description("Close running rows older than now as interrupted, then drain the reconcile queue once")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            // Nothing is running in this process, so every open row is orphaned.
+            const interrupted = await sweepInterruptedGenerations(new Date().toISOString());
+            const reconciled = await drainReconcileQueue(resolveSecret);
+            const result = { interrupted, reconcile_attempts: reconciled };
+            if (opts.json)
+                asJson(result);
+            else
+                printKv(result);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=generations.js.map

package/dist/commands/generations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generations.js","sourceRoot":"","sources":["../../src/commands/generations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,SAAS,EACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gCAAgC,EAGjC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,SAAS;IACT,SAAS;IACT,YAAY;IACZ,WAAW;IACX,QAAQ;IACR,WAAW;IACX,iBAAiB;IACjB,aAAa;CACd,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,WAAW;IACX,QAAQ;IACR,WAAW;IACX,iBAAiB;IACjB,aAAa;CACd,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,GAAe,EAAE,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC;AAED,wEAAwE;AACxE,SAAS,sBAAsB,CAAC,GAAe;IAC7C,IAAI,GAAG,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACvD,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,CAAC;IACD,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,IAAI,CAAC,CAAU;IACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,IAA+B;IAC/C,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,2DAA2D;AAC3D,SAAS,MAAM,CAAC,GAAe;IAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,EAAE;QACrB,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC;QACnC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;QAChD,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,IAAI;QAC5C,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;QACxC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;QAChD,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;QAClC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,IAAI;QAC3C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,gBAAgB,EAAE,GAAG,CAAC,QAAQ;QAC9B,gBAAgB,EAAE,GAAG,CAAC,KAAK;QAC3B,gBAAgB,EAAE,cAAc,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACzD,cAAc,EAAE,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC;QACrD,YAAY,EAAE,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC;QACjD,gBAAgB,EAAE,cAAc,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACzD,MAAM,EAAE;YACN,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;YAChC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACtC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,IAAI;YAC1B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;SAC7B;QACD,mBAAmB,EAAE,GAAG,CAAC,mBAAmB;QAC5C,SAAS,EAAE;YACT,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;YACxC,QAAQ,EAAE,GAAG,CAAC,kBAAkB,IAAI,CAAC;YACrC,KAAK,EAAE,QAAQ,CAAC,eAAe,IAAI,IAAI;YACvC,OAAO,EAAE,QAAQ,CAAC,iBAAiB,IAAI,IAAI;SAC5C;QACD,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,GAAe;IACjC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC;QACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QACxB,MAAM,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACvC,MAAM,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;QAC/B,OAAO,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,MAAc,EAA0B,EAAE,CAC5E,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAEzB,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IACrD,SAAS;IACT,WAAW;IACX,QAAQ;IACR,WAAW;IACX,SAAS;CACV,CAAC,CAAC;AAEH,+EAA+E;AAC/E,SAAS,oBAAoB,CAC3B,KAAa;IAEb,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,IAAI,CACF,2BAA2B,KAAK,YAAY,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACjF,CAAC;IACJ,CAAC;IACD,yEAAyE;IACzE,OAAO,KAA0C,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,SAAS,0BAA0B,CACjC,UAAkB,EAClB,KAAc;IAEd,IAAI,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CACL,GAAG,UAAU,2DAA2D;YACxE,gDAAgD,CACjD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAuB;IACjD,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QACxB,OAAO,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,0DAA0D,CAAC,CAAC;IAE3E,WAAW;SACR,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gCAAgC,CAAC;SAC7C,MAAM,CACL,mBAAmB,EACnB,0FAA0F,CAC3F;SACA,MAAM,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;SACjD,MAAM,CAAC,qBAAqB,EAAE,0CAA0C,CAAC;SACzE,MAAM,CAAC,kBAAkB,EAAE,0CAA0C,CAAC;SACtE,MAAM,CAAC,eAAe,EAAE,2CAA2C,CAAC;SACpE,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC;SACzE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CACL,KAAK,EAAE,IASN,EAAE,EAAE;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,aAAa,EAAE;gBACnE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK;aACN,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;IAEJ,WAAW;SACR,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,IAAwB,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,GAAG;gBAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAA8B,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,KAAK,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,IAAyC,EAAE,EAAE;QACtE,MAAM,SAAS,GACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;QAC/D,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,IAAI,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG;gBAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAClD,OACE,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EACrB,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC/C,GAAG,GAAG,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;YACjE,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAA8B,CAAC,CAAC;YAC1C,CAAC;YACD,oEAAoE;YACpE,qCAAqC;YACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,IAAwB,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,GAAG,EAAE,eAAe,KAAK,SAAS,CAAC;YACrD,MAAM,qBAAqB,GAAG,SAAS;gBACrC,CAAC,CAAC,MAAM,UAAU,CAAC,mBAAmB,CAAC,EAAE,EAAE,aAAa,CAAC;gBACzD,CAAC,CAAC,KAAK,CAAC;YACV,MAAM,SAAS,GAAG,SAAS;gBACzB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,MAAM,UAAU,CAAC,sBAAsB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,qBAAqB,IAAI,SAAS,CAAC;YACrD,MAAM,MAAM,GAAG;gBACb,aAAa,EAAE,EAAE;gBACjB,SAAS;gBACT,sBAAsB,EAAE,qBAAqB;aAC9C,CAAC;YACF,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC;;gBAE5B,OAAO,CAAC,GAAG,CACT,qBAAqB;oBACnB,CAAC,CAAC,iDAAiD,EAAE,iEAAiE;oBACtH,CAAC,CAAC,SAAS;wBACT,CAAC,CAAC,cAAc,EAAE,2FAA2F;wBAC7G,CAAC,CAAC,cAAc,EAAE,6DAA6D,CACpF,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CACV,oEAAoE,CACrE;SACA,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,IAAwB,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CACnE,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,CAClC,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG;gBACb,aAAa,EAAE,EAAE;gBACjB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;aAC/B,CAAC;YACF,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC;;gBACzB,OAAO,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,WAAW;SACR,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,8DAA8D,CAAC;SAC3E,cAAc,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SAC/D,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;SACzE,MAAM,CACL,mBAAmB,EACnB,gDAAgD,CACjD;SACA,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC;SACzE,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CACL,KAAK,EAAE,IASN,EAAE,EAAE;QACH,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,KAAK,GAA4B;gBACrC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;aAC1D,CAAC;YACF,IAAI,IAAI,CAAC,KAAK;gBACZ,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzC,IAAI,IAAI,CAAC,KAAK;gBAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACzC,IAAI,IAAI,CAAC,MAAM;gBAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,CAAC;gBACb,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,0BAA0B,CAAC,CAAC;YAC1D,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACxE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CACF,CAAC;IAEJ,WAAW;SACR,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,4DAA4D,CAAC;SACzE,cAAc,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SAC/D,MAAM,CAAC,cAAc,EAAE,qCAAqC,CAAC;SAC7D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CACL,KAAK,EACH,SAAiB,EACjB,IAA0D,EAC1D,EAAE;QACF,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAuB,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5D,IAAI,CAAC,GAAG;gBAAE,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,mBAAmB,SAAS,GAAG,CAAC,CAAC;YAChE,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBACtB,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CACF,CAAC;IAEJ,WAAW;SACR,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CACV,uFAAuF,CACxF;SACA,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC;YACrB,qEAAqE;YACrE,MAAM,WAAW,GAAG,MAAM,2BAA2B,CACnD,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CACzB,CAAC;YACF,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM,CAAC,MAAM,CAAC,CAAC;;gBACzB,OAAO,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/harness.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `nodetool harness` — list the registry, audit surface coverage, and run
+ * the gate.
+ *
+ * The registry (src/harness/registry.ts) is the source of truth for
+ * harness-first engineering: `list` prints every headless harness and what it
+ * can do; `audit` prints each product surface with the harnesses covering it
+ * and the documented gaps (`--strict` exits non-zero while any gap remains);
+ * `gate` maps a diff onto surfaces and runs the selfcheck of every harness
+ * covering a touched surface — the checks are selected by the diff, not by
+ * the author. `gate`'s changed-file collection (rename handling, deleted
+ * files, base-ref + working-tree merge) lives in ../harness/changed-files.ts;
+ * `--timeout <seconds>` bounds each selfcheck (default 900s, fails closed on
+ * timeout); a code file no surface claims fails the gate outright, and
+ * `--strict` also fails on a touched surface only a gap note covers.
+ */
+import type { Command } from "commander";
+export declare function registerHarnessCommands(program: Command): void;
+//# sourceMappingURL=harness.d.ts.map

package/dist/commands/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/commands/harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqX9D"}