cool-workflow 0.1.97 → 0.2.0

package/dist/cli/handlers/workbench.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleWorkbench = handleWorkbench;
-const workbench_1 = require("../../workbench");
-const workbench_host_1 = require("../../workbench-host");
-const format_1 = require("../format");
-const io_1 = require("../io");
-/** `cw workbench serve [--port N] [--once] | view <run-id> [--json]` — the optional
- *  read-only, localhost-only workbench. Behaviour-identical to the former inline case. */
-async function handleWorkbench(args, runner) {
-    const [subcommand, runId] = args.positionals;
-    switch (subcommand) {
-        case "view": {
-            // Read-only five-panel view of one run. Same core entry as cw_workbench_view.
-            const view = (0, workbench_1.buildWorkbenchRunView)(runner, (0, io_1.required)(runId, "run id"));
-            if ((0, io_1.wantsJson)(args.options))
-                (0, io_1.printJson)(view);
-            else
-                process.stdout.write(`${(0, format_1.formatWorkbenchView)(view)}\n`);
-            return;
-        }
-        case "serve": {
-            // The OPTIONAL localhost host. `--once`/`--json` emit the descriptor only
-            // (no server); the default starts the read-only, localhost-only host.
-            if (args.options.once || (0, io_1.wantsJson)(args.options)) {
-                (0, io_1.printJson)((0, workbench_1.buildWorkbenchServeDescriptor)(runner, { ...args.options, once: true }));
-                return;
-            }
-            const host = new workbench_host_1.WorkbenchHost({
-                runner,
-                cwd: String(args.options.cwd || process.cwd()),
-                port: Number(args.options.port) || undefined,
-                scope: args.options.scope === "repo" ? "repo" : "home"
-            });
-            await host.run();
-            return;
-        }
-        default:
-            throw new Error("Usage: cw.js workbench serve [--port N] [--once] | view <run-id> [--json]");
-    }
-}

package/dist/cli/handlers/worker.js

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleWorker = handleWorker;
-const operator_ux_1 = require("../../operator-ux");
-const io_1 = require("../io");
-/** `cw worker list|summary|show|manifest|output|fail|validate <run-id> [worker-id] [result-file]`. */
-function handleWorker(args, runner) {
-    const [subcommand, runId, workerId, resultPath] = args.positionals;
-    switch (subcommand) {
-        case "list":
-            (0, io_1.printJson)(runner.listWorkers((0, io_1.required)(runId, "run id"), args.options));
-            return;
-        case "summary": {
-            const summary = runner.summarizeWorkerRecords((0, io_1.required)(runId, "run id"));
-            if ((0, io_1.wantsJson)(args.options))
-                (0, io_1.printJson)(summary);
-            else
-                process.stdout.write(`${(0, operator_ux_1.formatWorkerSummary)(summary)}\n`);
-            return;
-        }
-        case "show":
-            (0, io_1.printJson)(runner.showWorker((0, io_1.required)(runId, "run id"), (0, io_1.required)(workerId, "worker id")));
-            return;
-        case "manifest":
-            (0, io_1.printJson)(runner.showWorkerManifest((0, io_1.required)(runId, "run id"), (0, io_1.required)(workerId, "worker id")));
-            return;
-        case "output":
-            (0, io_1.printJson)(runner.recordWorkerOutput((0, io_1.required)(runId, "run id"), (0, io_1.required)(workerId, "worker id"), (0, io_1.required)(resultPath, "result file"), args.options));
-            return;
-        case "fail":
-            (0, io_1.printJson)(runner.recordWorkerFailure((0, io_1.required)(runId, "run id"), (0, io_1.required)(workerId, "worker id"), String(args.options.message || (0, io_1.required)(resultPath, "failure message")), args.options));
-            return;
-        case "validate": {
-            // Non-null = a boundary violation: a validate verb must report an invalid
-            // verdict through its exit code, not just print it and exit 0.
-            const violation = runner.validateWorker((0, io_1.required)(runId, "run id"), (0, io_1.required)(workerId, "worker id"), resultPath);
-            (0, io_1.printJson)(violation);
-            if (violation)
-                process.exitCode = 1;
-            return;
-        }
-        default:
-            throw new Error("Usage: cw.js worker list|summary|show|manifest|output|fail|validate <run-id> [worker-id] [result-file]");
-    }
-}

package/dist/cli/run-summary.js

@@ -1,45 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.emitRunSummary = emitRunSummary;
-// Shared calm end-of-run summary helper, lifted out of command-surface.ts so the
-// `audit-run`/`quickstart` path (still in the dispatcher) AND the carved `run`
-// drive paths (src/cli/handlers/run.ts) emit ONE identical summary — no copy.
-// Stderr/human-side ONLY: stdout (the `--json` payload) stays byte-exact.
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const capability_core_1 = require("../capability-core");
-const reporter_1 = require("../reporter");
-/** Emit the calm end-of-run summary (stderr, TTY-gated inside the reporter): the COMPACT findings
- *  table re-parsed from each completed worker's `cw:result`, the report path, where the per-worker
- *  transcripts live, and — under `--full` — the report inline. Stderr/human-side ONLY: stdout (the
- *  `--json` payload printed just before this) stays byte-exact. Shared by the quickstart and the
- *  two `run --drive` paths so all three render an identical summary. */
-function emitRunSummary(runner, options, fields) {
-    // Anchor run reads to the run's OWN repo (a drive/quickstart may run cross-directory): the run
-    // dir is <repo>/.cw/runs/<id>/, holding each worker's transcript.md next to its result.md.
-    const runDir = typeof fields.statePath === "string" ? node_path_1.default.dirname(fields.statePath) : undefined;
-    const baseDir = runDir ? node_path_1.default.resolve(runDir, "..", "..", "..") : undefined;
-    const findings = (0, capability_core_1.collectRunFindings)(runner, fields.runId, baseDir);
-    // --full ALSO prints the report inline at run end (the compact table stays the default summary).
-    let fullReport;
-    if (options.full && fields.reportPath && node_fs_1.default.existsSync(fields.reportPath)) {
-        try {
-            fullReport = node_fs_1.default.readFileSync(fields.reportPath, "utf8");
-        }
-        catch { /* best-effort inline */ }
-    }
-    reporter_1.reporter.runSummary({
-        runId: fields.runId,
-        reportPath: fields.reportPath,
-        status: fields.status,
-        completedWorkers: fields.completedWorkers,
-        plannedWorkers: fields.plannedWorkers,
-        agentConfigured: fields.agentConfigured,
-        findings,
-        runDir,
-        fullReport
-    });
-}

package/dist/clones.js

@@ -1,162 +0,0 @@
-"use strict";
-// src/clones.ts — manage the remote-source clone cache that `--link`/URL reviews populate.
-//
-// The cache lives under resolveCwHome()/clones/<hash>/ (one content-addressed checkout per
-// URL+ref). `cw clones list` inspects it; `cw clones gc` reclaims it (a TTL sweep, or --all).
-// Pure filesystem work — no network, no git. Fail closed: gc only ever deletes a path it has
-// proven is INSIDE the clones root (the hash dir names are hex, so this always holds; the
-// assertion guards against a future change).
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listClones = listClones;
-exports.gcClones = gcClones;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const run_registry_1 = require("./run-registry");
-function isTrue(value) {
-    return value === true || value === "true" || value === "1" || value === 1;
-}
-function optionalNumber(value) {
-    if (value === undefined || value === null || value === "")
-        return undefined;
-    const n = Number(value);
-    return Number.isFinite(n) ? n : undefined;
-}
-function clonesRoot(args) {
-    // resolveCwHome reads CW_HOME/XDG_STATE_HOME from the environment — the same root the
-    // materialize step writes to, so list/gc see exactly what `--link` created.
-    void args;
-    return node_path_1.default.join((0, run_registry_1.resolveCwHome)(), "clones");
-}
-/** Total bytes of a directory tree, NOT following symlinks (lstat). Missing/unreadable
- *  entries are skipped — sizing is best-effort and must never throw. */
-function dirSize(dir) {
-    let total = 0;
-    const walk = (d) => {
-        let names;
-        try {
-            names = node_fs_1.default.readdirSync(d);
-        }
-        catch {
-            return;
-        }
-        for (const name of names) {
-            const p = node_path_1.default.join(d, name);
-            let st;
-            try {
-                st = node_fs_1.default.lstatSync(p);
-            }
-            catch {
-                continue;
-            }
-            if (st.isDirectory())
-                walk(p);
-            else
-                total += st.size;
-        }
-    };
-    walk(dir);
-    return total;
-}
-function readEntries(root) {
-    let names = [];
-    try {
-        names = node_fs_1.default.readdirSync(root);
-    }
-    catch {
-        return []; // no cache yet
-    }
-    const entries = [];
-    for (const hash of names) {
-        if (hash.startsWith("."))
-            continue; // skip in-progress .stage-* temp dirs
-        const dir = node_path_1.default.join(root, hash);
-        let st;
-        try {
-            st = node_fs_1.default.statSync(dir);
-        }
-        catch {
-            continue;
-        }
-        if (!st.isDirectory())
-            continue;
-        let meta = {};
-        try {
-            meta = JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.join(dir, ".cw-clone-meta.json"), "utf8"));
-        }
-        catch {
-            /* legacy/partial entry without meta — still listable/reclaimable */
-        }
-        entries.push({
-            hash,
-            url: typeof meta.url === "string" ? meta.url : "(unknown)",
-            kind: typeof meta.kind === "string" ? meta.kind : "git",
-            ref: typeof meta.ref === "string" ? meta.ref : null,
-            fetchedAt: typeof meta.fetchedAt === "string" ? meta.fetchedAt : null,
-            commit: typeof meta.commit === "string" ? meta.commit : null,
-            bytes: dirSize(dir)
-        });
-    }
-    entries.sort((a, b) => (a.fetchedAt || "").localeCompare(b.fetchedAt || ""));
-    return entries;
-}
-/** `cw clones list` — every cached remote checkout with its origin, commit, age, and size. */
-function listClones(args) {
-    const root = clonesRoot(args);
-    const entries = readEntries(root);
-    return {
-        schemaVersion: 1,
-        clonesDir: root,
-        count: entries.length,
-        totalBytes: entries.reduce((sum, e) => sum + e.bytes, 0),
-        entries
-    };
-}
-/** `cw clones gc [--older-than-days N] [--all]` — reclaim cached checkouts. Default keeps
- *  entries fetched within the last 30 days; `--all` removes every entry. Deletes ONLY paths
- *  proven inside the clones root (fail closed). `--now` (ISO) is injectable for deterministic
- *  tests; an entry with no fetchedAt is treated as old (eligible). */
-function gcClones(args) {
-    const root = clonesRoot(args);
-    const all = isTrue(args.all);
-    let olderThanDays = null;
-    if (!all) {
-        const raw = args.olderThanDays ?? args["older-than-days"];
-        olderThanDays = optionalNumber(raw) ?? 30;
-        if (!Number.isFinite(olderThanDays) || olderThanDays < 0) {
-            throw new Error(`--older-than-days must be a non-negative number (got ${String(raw)})`);
-        }
-    }
-    let now = Date.now();
-    if (args.now !== undefined) {
-        now = new Date(String(args.now)).getTime();
-        if (!Number.isFinite(now))
-            throw new Error(`--now must be a valid ISO date (got ${String(args.now)})`);
-    }
-    const cutoff = olderThanDays != null ? now - olderThanDays * 24 * 60 * 60 * 1000 : Infinity;
-    const rootResolved = node_path_1.default.resolve(root);
-    const removed = [];
-    let freedBytes = 0;
-    const entries = readEntries(root);
-    for (const entry of entries) {
-        if (!all) {
-            // Fail-SAFE: a TTL sweep reclaims only entries we can PROVE are old enough. An entry with
-            // no (or an unparseable) fetchedAt is a partial/legacy materialize that never wrote meta —
-            // we cannot date it, so we KEEP it (never delete what you can't age). `--all` clears them.
-            if (!entry.fetchedAt)
-                continue;
-            const age = new Date(entry.fetchedAt).getTime();
-            if (!Number.isFinite(age) || age > cutoff)
-                continue;
-        }
-        const dir = node_path_1.default.join(root, entry.hash);
-        if (!node_path_1.default.resolve(dir).startsWith(rootResolved + node_path_1.default.sep))
-            continue; // containment, fail closed
-        node_fs_1.default.rmSync(dir, { recursive: true, force: true });
-        removed.push({ hash: entry.hash, url: entry.url, bytes: entry.bytes });
-        freedBytes += entry.bytes;
-    }
-    return { schemaVersion: 1, clonesDir: root, removed, freedBytes, keptCount: entries.length - removed.length, olderThanDays, all };
-}