opensquid 0.5.395

package/dist/setup/cli/checkpoints_actions.js

@@ -0,0 +1,153 @@
+/**
+ * Action handlers for `opensquid checkpoints` (CLI.6) — split out of
+ * checkpoints.ts for the file-size budget.
+ *
+ * One handler per verb. Each owns:
+ *   - libsql client lifecycle (open → store.init() → run → close)
+ *   - confirmation (`--yes` + non-TTY refusal mirror schedule/webhooks)
+ *   - exit-code semantics: 1 on missing run / missing manifest / bad
+ *     duration / no Resumer wired; 0 otherwise.
+ *
+ * The `show` verb emits RAW JSONL (one JSON object per line, `_kind`
+ * discriminator) — explicitly distinct from `opensquid trace` (OBSERVE.2)
+ * which renders a styled timeline. Tee-able into `jq` without a
+ * `--format json` flag.
+ *
+ * Imports from: ./checkpoints.js (pure handlers), ./checkpoints_render.js
+ *   (table render + parseLimit), ./audit_state.js (parseDurationToMs).
+ * Imported by: ./checkpoints.ts (commander wiring).
+ */
+import { CheckpointStore } from '../../runtime/durable/index.js';
+import { parseDurationToMs } from './audit_state.js';
+import { clean, list, resume, show } from './checkpoints_core.js';
+import { parseLimit, renderListTable } from './checkpoints_render.js';
+const DEFAULT_LIMIT = 20;
+async function confirmTty(question, isTty) {
+    if (!isTty())
+        return false;
+    const rl = (await import('node:readline/promises')).createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const answer = (await rl.question(question)).trim().toLowerCase();
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function actList(deps, opts) {
+    const client = deps.open(opts.db);
+    try {
+        const store = new CheckpointStore(client);
+        await store.init();
+        const rows = await list({ store, windowMs: null, nowMs: deps.now });
+        const limit = parseLimit(opts.limit) ?? DEFAULT_LIMIT;
+        const capped = rows.slice(0, limit);
+        if (capped.length === 0) {
+            deps.out('(no interrupted runs)\n');
+            return;
+        }
+        deps.out(renderListTable(capped) + '\n');
+    }
+    finally {
+        client.close();
+    }
+}
+export async function actShow(deps, runId, opts) {
+    const client = deps.open(opts.db);
+    try {
+        const store = new CheckpointStore(client);
+        await store.init();
+        const { manifest, checkpoints, hasTerminalMarker } = await show(store, runId);
+        if (manifest === null && checkpoints.length === 0) {
+            deps.err(`opensquid checkpoints show: no run found for id "${runId}"\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (manifest !== null) {
+            deps.out(JSON.stringify({ _kind: 'manifest', ...manifest }) + '\n');
+        }
+        for (const row of checkpoints) {
+            deps.out(JSON.stringify({ _kind: 'checkpoint', ...row }) + '\n');
+        }
+        if (hasTerminalMarker) {
+            deps.out(JSON.stringify({ _kind: 'terminal', runId }) + '\n');
+        }
+    }
+    finally {
+        client.close();
+    }
+}
+export async function actResume(deps, runId, opts) {
+    const client = deps.open(opts.db);
+    try {
+        const store = new CheckpointStore(client);
+        await store.init();
+        if (!opts.yes && !deps.isTty()) {
+            deps.err(`opensquid checkpoints resume: refusing to resume "${runId}" without --yes in non-interactive context\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (!opts.yes && !(await confirmTty(`Resume run "${runId}"? [y/N] `, deps.isTty))) {
+            deps.out('aborted\n');
+            return;
+        }
+        if (deps.resumerFor === undefined) {
+            deps.err('opensquid checkpoints resume: manual resume requires a daemon-wired Resumer (deferred to the daemon track — see daemon start)\n');
+            process.exitCode = 1;
+            return;
+        }
+        const resumer = deps.resumerFor(store);
+        if (resumer === null) {
+            deps.err('opensquid checkpoints resume: no Resumer available (pack registry not loaded)\n');
+            process.exitCode = 1;
+            return;
+        }
+        const result = await resume(resumer, store, runId);
+        if (result.manifestMissing === true) {
+            deps.err(`opensquid checkpoints resume: no manifest for runId "${runId}"\n`);
+            process.exitCode = 1;
+            return;
+        }
+        if (result.resumed) {
+            deps.out(`resumed ${runId}\n`);
+            return;
+        }
+        deps.out(`not resumed (${result.reason ?? 'unknown'})\n`);
+        process.exitCode = 1;
+    }
+    finally {
+        client.close();
+    }
+}
+export async function actClean(deps, opts) {
+    const ms = parseDurationToMs(opts.olderThan);
+    if (ms === null) {
+        deps.err(`opensquid checkpoints clean: --older-than "${opts.olderThan}" must be like 30s|10m|2h|7d\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!opts.yes && !deps.isTty()) {
+        deps.err(`opensquid checkpoints clean: refusing to prune without --yes in non-interactive context\n`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!opts.yes &&
+        !(await confirmTty(`Prune checkpoints older than ${opts.olderThan}? [y/N] `, deps.isTty))) {
+        deps.out('aborted\n');
+        return;
+    }
+    const client = deps.open(opts.db);
+    try {
+        const store = new CheckpointStore(client);
+        await store.init();
+        const { removed } = await clean({ store, olderThanMs: ms, nowMs: deps.now });
+        deps.out(`removed ${String(removed)} checkpoint row${removed === 1 ? '' : 's'}\n`);
+    }
+    finally {
+        client.close();
+    }
+}
+//# sourceMappingURL=checkpoints_actions.js.map

package/dist/setup/cli/checkpoints_actions.js.map

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

package/dist/setup/cli/checkpoints_core.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure handlers for `opensquid checkpoints` (CLI.6 + DURABLE.4 scaffold) —
+ * split out of checkpoints.ts for the file-size budget.
+ *
+ * Commander-agnostic. Direct-import callers (tests, future programmatic
+ * tooling) use these. The commander wiring in `./checkpoints.ts` calls
+ * these through `./checkpoints_actions.ts`.
+ *
+ * Imports from: ../../runtime/durable/index.js.
+ * Imported by: ./checkpoints.ts (re-exports public surface),
+ *   ./checkpoints_actions.ts (verb handlers).
+ */
+import type { CheckpointStore, Resumer } from '../../runtime/durable/index.js';
+/** One row in the `list` verb's output. */
+export interface ListEntry {
+    runId: string;
+    packId: string;
+    skill: string;
+    ruleId: string;
+    lastCompletedStep: number;
+    lastCompletedAtMs: number;
+    ageMs: number;
+}
+export interface ListOpts {
+    store: CheckpointStore;
+    /** Window in ms; `null` / `Infinity` disables. */
+    windowMs?: number | null;
+    nowMs?: () => number;
+}
+/** Inspect interrupted runs (manifest-orphan checkpoints are dropped). */
+export declare function list(opts: ListOpts): Promise<ListEntry[]>;
+export interface ShowResult {
+    manifest: Awaited<ReturnType<CheckpointStore['getRunManifest']>>;
+    checkpoints: Awaited<ReturnType<CheckpointStore['fetchRun']>>;
+    hasTerminalMarker: boolean;
+}
+/** Inspect one run: manifest + every checkpoint row + terminal state. */
+export declare function show(store: CheckpointStore, runId: string): Promise<ShowResult>;
+export interface ResumeCliResult {
+    resumed: boolean;
+    reason?: string;
+    manifestMissing?: true;
+}
+/** Explicit resume — bypasses DURABLE.4's resume window
+ *  (`Resumer.resume` itself never consults the window; only
+ *  `scanInterrupted` / `resumeOnStartup` do). */
+export declare function resume(resumer: Resumer, store: CheckpointStore, runId: string): Promise<ResumeCliResult>;
+export interface CleanOpts {
+    store: CheckpointStore;
+    olderThanMs: number;
+    nowMs?: () => number;
+}
+/** Prune old checkpoint rows. Pass-through to `pruneOlderThan`. */
+export declare function clean(opts: CleanOpts): Promise<{
+    removed: number;
+}>;
+//# sourceMappingURL=checkpoints_core.d.ts.map

package/dist/setup/cli/checkpoints_core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints_core.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/checkpoints_core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAE/E,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,0EAA0E;AAC1E,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmB/D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACjE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,yEAAyE;AACzE,wBAAsB,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOrF;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB;AAED;;iDAEiD;AACjD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAoB1B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,mEAAmE;AACnE,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAGzE"}

package/dist/setup/cli/checkpoints_core.js

@@ -0,0 +1,73 @@
+/**
+ * Pure handlers for `opensquid checkpoints` (CLI.6 + DURABLE.4 scaffold) —
+ * split out of checkpoints.ts for the file-size budget.
+ *
+ * Commander-agnostic. Direct-import callers (tests, future programmatic
+ * tooling) use these. The commander wiring in `./checkpoints.ts` calls
+ * these through `./checkpoints_actions.ts`.
+ *
+ * Imports from: ../../runtime/durable/index.js.
+ * Imported by: ./checkpoints.ts (re-exports public surface),
+ *   ./checkpoints_actions.ts (verb handlers).
+ */
+/** Inspect interrupted runs (manifest-orphan checkpoints are dropped). */
+export async function list(opts) {
+    const now = (opts.nowMs ?? Date.now)();
+    const windowMs = opts.windowMs ?? Number.POSITIVE_INFINITY;
+    const summaries = await opts.store.scanInterrupted(windowMs, now);
+    const out = [];
+    for (const s of summaries) {
+        const m = await opts.store.getRunManifest(s.runId);
+        if (!m)
+            continue;
+        out.push({
+            runId: s.runId,
+            packId: m.packId,
+            skill: m.skill,
+            ruleId: m.ruleId,
+            lastCompletedStep: s.lastCompletedStep,
+            lastCompletedAtMs: s.lastCompletedAtMs,
+            ageMs: now - s.lastCompletedAtMs,
+        });
+    }
+    return out;
+}
+/** Inspect one run: manifest + every checkpoint row + terminal state. */
+export async function show(store, runId) {
+    const [manifest, checkpoints, hasTerminalMarker] = await Promise.all([
+        store.getRunManifest(runId),
+        store.fetchRun(runId),
+        store.hasTerminalMarker(runId),
+    ]);
+    return { manifest, checkpoints, hasTerminalMarker };
+}
+/** Explicit resume — bypasses DURABLE.4's resume window
+ *  (`Resumer.resume` itself never consults the window; only
+ *  `scanInterrupted` / `resumeOnStartup` do). */
+export async function resume(resumer, store, runId) {
+    const manifest = await store.getRunManifest(runId);
+    if (!manifest) {
+        return { resumed: false, manifestMissing: true };
+    }
+    const lastCompleted = await store.lastCompletedStep(runId);
+    const result = await resumer.resume({
+        runId: manifest.runId,
+        packId: manifest.packId,
+        packVersion: manifest.packVersion,
+        skill: manifest.skill,
+        ruleId: manifest.ruleId,
+        eventKind: manifest.eventKind,
+        eventPayload: manifest.eventPayload,
+        lastCompletedStep: lastCompleted?.stepIdx ?? -1,
+        lastCompletedAtMs: lastCompleted?.completedAtMs ?? manifest.startedAtMs,
+    });
+    return result.reason
+        ? { resumed: result.resumed, reason: result.reason }
+        : { resumed: result.resumed };
+}
+/** Prune old checkpoint rows. Pass-through to `pruneOlderThan`. */
+export async function clean(opts) {
+    const removed = await opts.store.pruneOlderThan(opts.olderThanMs, (opts.nowMs ?? Date.now)());
+    return { removed };
+}
+//# sourceMappingURL=checkpoints_core.js.map

package/dist/setup/cli/checkpoints_core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints_core.js","sourceRoot":"","sources":["../../../src/setup/cli/checkpoints_core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAC3D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,iBAAiB;SACjC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAsB,EAAE,KAAa;IAC9D,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC;QAC3B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC;KAC/B,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;AACtD,CAAC;AAQD;;iDAEiD;AACjD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAgB,EAChB,KAAsB,EACtB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QAClC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,iBAAiB,EAAE,aAAa,EAAE,OAAO,IAAI,CAAC,CAAC;QAC/C,iBAAiB,EAAE,aAAa,EAAE,aAAa,IAAI,QAAQ,CAAC,WAAW;KACxE,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM;QAClB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QACpD,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AAClC,CAAC;AAQD,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAe;IACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9F,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/setup/cli/checkpoints_render.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Rendering helpers for `opensquid checkpoints` (CLI.6) — split out of
+ * checkpoints.ts for the file-size budget.
+ *
+ * Two concerns:
+ *   - `renderListTable` — fixed-column ASCII table for `checkpoints list`.
+ *   - `parseLimit` / `formatAge` — small utilities used only by the list
+ *     verb's table render.
+ *
+ * Column widths: 8-char runId prefix + 12-char pack + 14-char skill +
+ * 14-char rule + step + age fit inside 100 cols. Comparable to Temporal
+ * `tctl workflow list` — fixed columns over flexible widths because the
+ * intended consumer is a human eyeballing a recovery scenario, not a
+ * piped tool (which uses `show` for JSONL).
+ *
+ * Imports from: none.
+ * Imported by: src/setup/cli/checkpoints.ts (+ checkpoints_actions.ts).
+ */
+import type { ListEntry } from './checkpoints_core.js';
+/** Compact fixed-column table. */
+export declare function renderListTable(rows: readonly ListEntry[]): string;
+export declare function parseLimit(raw: string | undefined): number | null;
+//# sourceMappingURL=checkpoints_render.d.ts.map

package/dist/setup/cli/checkpoints_render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints_render.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/checkpoints_render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,kCAAkC;AAClC,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAqBlE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKjE"}

package/dist/setup/cli/checkpoints_render.js

@@ -0,0 +1,65 @@
+/**
+ * Rendering helpers for `opensquid checkpoints` (CLI.6) — split out of
+ * checkpoints.ts for the file-size budget.
+ *
+ * Two concerns:
+ *   - `renderListTable` — fixed-column ASCII table for `checkpoints list`.
+ *   - `parseLimit` / `formatAge` — small utilities used only by the list
+ *     verb's table render.
+ *
+ * Column widths: 8-char runId prefix + 12-char pack + 14-char skill +
+ * 14-char rule + step + age fit inside 100 cols. Comparable to Temporal
+ * `tctl workflow list` — fixed columns over flexible widths because the
+ * intended consumer is a human eyeballing a recovery scenario, not a
+ * piped tool (which uses `show` for JSONL).
+ *
+ * Imports from: none.
+ * Imported by: src/setup/cli/checkpoints.ts (+ checkpoints_actions.ts).
+ */
+/** Compact fixed-column table. */
+export function renderListTable(rows) {
+    const lines = [];
+    lines.push(pad('RUN', 12) +
+        pad('PACK', 14) +
+        pad('SKILL', 16) +
+        pad('RULE', 16) +
+        pad('STEP', 6) +
+        pad('AGE', 10));
+    for (const r of rows) {
+        lines.push(pad(r.runId.slice(0, 10), 12) +
+            pad(r.packId, 14) +
+            pad(r.skill, 16) +
+            pad(r.ruleId, 16) +
+            pad(String(r.lastCompletedStep), 6) +
+            pad(formatAge(r.ageMs), 10));
+    }
+    return lines.join('\n');
+}
+export function parseLimit(raw) {
+    if (raw === undefined)
+        return null;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    return n;
+}
+function pad(s, w) {
+    if (s.length >= w)
+        return s.slice(0, w - 1) + ' ';
+    return s + ' '.repeat(w - s.length);
+}
+function formatAge(ms) {
+    if (ms < 1000)
+        return `${String(ms)}ms`;
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${String(s)}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${String(m)}m`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${String(h)}h`;
+    return `${String(Math.floor(h / 24))}d`;
+}
+//# sourceMappingURL=checkpoints_render.js.map

package/dist/setup/cli/checkpoints_render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints_render.js","sourceRoot":"","sources":["../../../src/setup/cli/checkpoints_render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,kCAAkC;AAClC,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC;QACZ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAChB,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACd,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CACjB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACjB,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACnC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAC9B,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAuB;IAChD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS;IAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAClD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACnC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC;AAC1C,CAAC"}

package/dist/setup/cli/codex_hooks.d.ts

@@ -0,0 +1,27 @@
+/**
+ * T-CODEX-HOST-SHELL CHS.1 — `opensquid setup wizard codex-hooks`.
+ *
+ * Writes the user-layer `~/.codex/hooks.json` with opensquid's five hook
+ * entries (NO SessionEnd — codex's Stop is turn-scoped; see the writer
+ * module header). Create-or-merge idempotent, backup before rewrite,
+ * absolute bin paths. ACTIVATION REQUIRES TRUST: codex excludes non-managed
+ * hooks until the user reviews + trusts them via `/hooks` in codex — the
+ * outro says exactly that (no silent activation; the git boundary gates
+ * remain the backstop enforcement either way).
+ *
+ * Imports from: commander, node:fs, node:fs/promises, node:os, node:path,
+ *   ../wizard/codex-hooks-writer.js.
+ * Imported by: src/cli.ts (registration beside the hooks wizard).
+ */
+import type { Command } from 'commander';
+export interface CodexHooksCliDeps {
+    /** Test injection — the codex home dir (default `~/.codex`). */
+    codexDir?: string;
+    /** Test injection — the hook-bin dir (default `resolveHookBinDir()`). */
+    binDir?: string;
+    out?: (line: string) => void;
+}
+export declare function runCodexHooksWizard(deps?: CodexHooksCliDeps): Promise<void>;
+/** Register `wizard codex-hooks` under the existing wizard subgroup. */
+export declare function registerCodexHooksWizard(wizard: Command, deps?: CodexHooksCliDeps): void;
+//# sourceMappingURL=codex_hooks.d.ts.map

package/dist/setup/cli/codex_hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex_hooks.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/codex_hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAoBD,wBAAsB,mBAAmB,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BrF;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,GAAE,iBAAsB,GAAG,IAAI,CAS5F"}

package/dist/setup/cli/codex_hooks.js

@@ -0,0 +1,73 @@
+/**
+ * T-CODEX-HOST-SHELL CHS.1 — `opensquid setup wizard codex-hooks`.
+ *
+ * Writes the user-layer `~/.codex/hooks.json` with opensquid's five hook
+ * entries (NO SessionEnd — codex's Stop is turn-scoped; see the writer
+ * module header). Create-or-merge idempotent, backup before rewrite,
+ * absolute bin paths. ACTIVATION REQUIRES TRUST: codex excludes non-managed
+ * hooks until the user reviews + trusts them via `/hooks` in codex — the
+ * outro says exactly that (no silent activation; the git boundary gates
+ * remain the backstop enforcement either way).
+ *
+ * Imports from: commander, node:fs, node:fs/promises, node:os, node:path,
+ *   ../wizard/codex-hooks-writer.js.
+ * Imported by: src/cli.ts (registration beside the hooks wizard).
+ */
+import { existsSync } from 'node:fs';
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { projectCodexHooks, resolveHookBinDir, } from '../wizard/codex-hooks-writer.js';
+async function readJsonOr(path, fallback) {
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+async function backupThenWrite(path, content) {
+    try {
+        await copyFile(path, `${path}.bak-${new Date().toISOString().slice(0, 10)}`);
+    }
+    catch {
+        /* ENOENT — nothing to back up */
+    }
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, 'utf8');
+}
+export async function runCodexHooksWizard(deps = {}) {
+    const out = deps.out ?? ((l) => void process.stdout.write(`${l}\n`));
+    const codexDir = deps.codexDir ?? join(homedir(), '.codex');
+    if (!existsSync(codexDir)) {
+        out('~/.codex not found — codex is not installed on this machine; nothing written.');
+        return;
+    }
+    let binDir;
+    try {
+        binDir = deps.binDir ?? resolveHookBinDir();
+    }
+    catch (e) {
+        out(`cancelled: ${e instanceof Error ? e.message : String(e)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const codexHooksPath = join(codexDir, 'hooks.json');
+    const current = await readJsonOr(codexHooksPath, {});
+    const { next, added, replaced, preserved } = projectCodexHooks({ current, binDir });
+    await backupThenWrite(codexHooksPath, `${JSON.stringify(next, null, 2)}\n`);
+    out(`codex hooks written to ${codexHooksPath}: ${String(added)} added, ${String(replaced)} replaced, ${String(preserved)} foreign group(s) preserved.`);
+    out('ACTIVATION REQUIRES TRUST: open `codex`, run `/hooks`, review and trust the');
+    out('opensquid entries — codex excludes untrusted hooks by design. The git');
+    out('boundary gates remain enforcing either way.');
+}
+/** Register `wizard codex-hooks` under the existing wizard subgroup. */
+export function registerCodexHooksWizard(wizard, deps = {}) {
+    wizard
+        .command('codex-hooks')
+        .description("Write opensquid's hook entries into ~/.codex/hooks.json (codex host shell; trust via /hooks in codex)")
+        .action(async () => {
+        await runCodexHooksWizard(deps);
+    });
+}
+//# sourceMappingURL=codex_hooks.js.map

package/dist/setup/cli/codex_hooks.js.map

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

package/dist/setup/cli/cost.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `opensquid cost` CLI verb group (CLI.8) — thin commander wiring.
+ *
+ * Three verbs, all backed by `CostRoutingLog` + `readSubscriptionPools`:
+ *
+ *   (default)     — pool-usage summary aggregated from `cost_routing_log`.
+ *                   Empty log → placeholder.
+ *   routing       — last N decisions newest-first (default 20).
+ *   subscriptions — list configured pools from `~/.opensquid/config.yaml`.
+ *
+ * The router doesn't persist by default — `cost_router.ts` exposes an
+ * `audit:` sink the daemon wires to `CostRoutingLog.append`. Pure handlers
+ * (table renders, log reads, pools loader) live in `./cost_state.ts`;
+ * this file owns commander wiring + libsql client lifecycle.
+ *
+ * Imports from: commander, @libsql/client, ./audit_state.js, ./cost_state.js.
+ * Imported by: src/cli.ts, src/setup/cli/cost.test.ts.
+ */
+import type { Client } from '@libsql/client';
+import type { Command } from 'commander';
+export interface CostCliDeps {
+    openClient?: (dbPath: string) => Client;
+    stdout?: (s: string) => void;
+    stderr?: (s: string) => void;
+    now?: () => number;
+}
+/** Register `opensquid cost` on the parent program. */
+export declare function registerCost(parent: Command, deps?: CostCliDeps): Command;
+//# sourceMappingURL=cost.d.ts.map

package/dist/setup/cli/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAyED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAsB7E"}

package/dist/setup/cli/cost.js

@@ -0,0 +1,98 @@
+/**
+ * `opensquid cost` CLI verb group (CLI.8) — thin commander wiring.
+ *
+ * Three verbs, all backed by `CostRoutingLog` + `readSubscriptionPools`:
+ *
+ *   (default)     — pool-usage summary aggregated from `cost_routing_log`.
+ *                   Empty log → placeholder.
+ *   routing       — last N decisions newest-first (default 20).
+ *   subscriptions — list configured pools from `~/.opensquid/config.yaml`.
+ *
+ * The router doesn't persist by default — `cost_router.ts` exposes an
+ * `audit:` sink the daemon wires to `CostRoutingLog.append`. Pure handlers
+ * (table renders, log reads, pools loader) live in `./cost_state.ts`;
+ * this file owns commander wiring + libsql client lifecycle.
+ *
+ * Imports from: commander, @libsql/client, ./audit_state.js, ./cost_state.js.
+ * Imported by: src/cli.ts, src/setup/cli/cost.test.ts.
+ */
+import { createClient } from '@libsql/client';
+import { defaultAuditDbPath } from './audit_state.js';
+import { CostRoutingLog, defaultConfigPath, readSubscriptionPools, renderRouting, renderSubscriptions, renderSummary, } from './cost_state.js';
+function defaultOpen(dbPath) {
+    const url = dbPath.startsWith('file:') || dbPath === ':memory:' ? dbPath : `file:${dbPath}`;
+    return createClient({ url });
+}
+function buildDeps(deps) {
+    return {
+        open: deps.openClient ?? defaultOpen,
+        out: deps.stdout ?? ((s) => process.stdout.write(s)),
+        err: deps.stderr ?? ((s) => process.stderr.write(s)),
+        now: deps.now ?? (() => Date.now()),
+    };
+}
+async function actSummary(deps, opts) {
+    const client = deps.open(opts.db);
+    try {
+        const log = new CostRoutingLog(client);
+        const rows = await log.summary();
+        if (rows.length === 0) {
+            deps.out('(no cost routing decisions yet)\n');
+            return;
+        }
+        deps.out(renderSummary(rows) + '\n');
+    }
+    finally {
+        client.close();
+    }
+}
+async function actRouting(deps, opts) {
+    const limit = Number.parseInt(opts.limit, 10);
+    if (!Number.isFinite(limit) || limit <= 0) {
+        deps.err(`opensquid cost routing: --limit "${opts.limit}" must be a positive integer\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const client = deps.open(opts.db);
+    try {
+        const log = new CostRoutingLog(client);
+        const rows = await log.recent(limit);
+        if (rows.length === 0) {
+            deps.out('(no cost routing decisions yet)\n');
+            return;
+        }
+        deps.out(renderRouting(rows) + '\n');
+    }
+    finally {
+        client.close();
+    }
+}
+async function actSubscriptions(deps, opts) {
+    const pools = await readSubscriptionPools(opts.config);
+    const total = (pools.cheap?.length ?? 0) + (pools.balanced?.length ?? 0) + (pools.premium?.length ?? 0);
+    if (total === 0) {
+        deps.out('(no subscription pools configured)\n');
+        deps.err(`hint: declare \`subscription_pools:\` in ${opts.config} — see docs/opensquid-real-design.md\n`);
+        return;
+    }
+    deps.out(renderSubscriptions(pools) + '\n');
+}
+/** Register `opensquid cost` on the parent program. */
+export function registerCost(parent, deps = {}) {
+    const r = buildDeps(deps);
+    const c = parent.command('cost').description('Cross-subscription cost routing');
+    const db = defaultAuditDbPath();
+    const cfg = defaultConfigPath();
+    c.option('--db <path>', 'Path to the libsql DB', db).action(async (opts) => actSummary(r, opts));
+    c.command('routing')
+        .description('Recent cost-tier routing decisions (default: last 20)')
+        .option('--db <path>', 'Path to the libsql DB', db)
+        .option('--limit <n>', 'cap result count', '20')
+        .action((opts) => actRouting(r, opts));
+    c.command('subscriptions')
+        .description('List configured subscription pools (from ~/.opensquid/config.yaml)')
+        .option('--config <path>', 'Path to the config YAML', cfg)
+        .action((opts) => actSubscriptions(r, opts));
+    return c;
+}
+//# sourceMappingURL=cost.js.map