cool-workflow 0.1.98 → 0.2.0

package/dist/shell/ledger-io.js

@@ -0,0 +1,169 @@
+"use strict";
+// shell/ledger-io.ts — the ledger's directory reads
+// (listLedgerEntries/unionLedgerEntries). Impure (fs); the pure verify
+// logic they call lives in core/trust/ledger.ts.
+//
+// MILESTONE 8. Byte-exact port of the old build's src/ledger.ts stage-2
+// git-transport functions (listLedgerEntries, unionLedgerEntries), split
+// out per v2/PLAN.md's core/shell rule since these two functions are the
+// ONLY impure ones in the old ledger.ts module.
+//
+// Evidence: SPEC/ledger-trust.md "Handoff ledger entry" (listLedgerEntries/
+// unionLedgerEntries JSON shapes), "Edge cases" (dir-unreadable/entry-not-
+// regular/bad-json); plugins/cool-workflow/src/ledger.ts:307-391.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listLedgerEntries = listLedgerEntries;
+exports.unionLedgerEntries = unionLedgerEntries;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ledger_1 = require("../core/trust/ledger");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Read every `*.json` in `dir`, verify each entry fail-closed, and
+ *  report. `allOk` is false if any entry is tampered, malformed, or
+ *  unreadable — so the receiving side refuses the whole inbox rather
+ *  than acting on a mixed batch. */
+function listLedgerEntries(dir) {
+    let names;
+    try {
+        names = fs.readdirSync(dir).filter((n) => n.endsWith(".json")).sort();
+    }
+    catch (error) {
+        const entry = {
+            file: dir,
+            id: null,
+            kind: null,
+            from: null,
+            to: null,
+            title: null,
+            target: null,
+            verdict: null,
+            ok: false,
+            failedChecks: [{ name: "dir", code: "ledger-dir-unreadable", detail: error.message }],
+        };
+        return { dir, count: 0, allOk: false, entries: [entry], resolution: (0, ledger_1.resolveLedgerInbox)([entry]) };
+    }
+    const entries = names.map((name) => {
+        const file = path.join(dir, name);
+        let raw;
+        try {
+            const stat = fs.lstatSync(file);
+            if (!stat.isFile()) {
+                return {
+                    file: name,
+                    id: null,
+                    kind: null,
+                    from: null,
+                    to: null,
+                    title: null,
+                    target: null,
+                    verdict: null,
+                    ok: false,
+                    failedChecks: [{ name: "file", code: "ledger-entry-not-regular" }],
+                };
+            }
+            raw = JSON.parse(fs.readFileSync(file, "utf8"));
+        }
+        catch {
+            return {
+                file: name,
+                id: null,
+                kind: null,
+                from: null,
+                to: null,
+                title: null,
+                target: null,
+                verdict: null,
+                ok: false,
+                failedChecks: [{ name: "parse", code: "ledger-bad-json" }],
+            };
+        }
+        const result = (0, ledger_1.verifyLedgerEntry)(raw);
+        const rec = isRecord(raw) ? raw : {};
+        return {
+            file: name,
+            id: result.id,
+            kind: result.kind,
+            from: typeof rec.from === "string" ? rec.from : null,
+            to: typeof rec.to === "string" ? rec.to : null,
+            title: typeof rec.title === "string" ? rec.title : null,
+            target: typeof rec.target === "string" ? rec.target : null,
+            verdict: typeof rec.verdict === "string" ? rec.verdict : null,
+            ok: result.ok,
+            failedChecks: result.failedChecks,
+        };
+    });
+    return {
+        dir,
+        count: entries.length,
+        allOk: entries.every((e) => e.ok),
+        entries,
+        resolution: (0, ledger_1.resolveLedgerInbox)(entries),
+    };
+}
+/** Union-verify several mirror directories into ONE fail-closed inbox.
+ *  Verified entries are de-duplicated by their content-addressed id;
+ *  failing entries are kept per-occurrence so every problem in every
+ *  mirror is visible. `allOk` is false if ANY entry in ANY mirror does
+ *  not verify. */
+function unionLedgerEntries(dirs) {
+    const byId = new Map();
+    const failures = [];
+    let allOk = true;
+    for (const dir of dirs) {
+        const listed = listLedgerEntries(dir);
+        if (!listed.allOk)
+            allOk = false;
+        for (const entry of listed.entries) {
+            if (entry.ok && entry.id) {
+                const existing = byId.get(entry.id);
+                if (existing) {
+                    if (!existing.dirs.includes(dir))
+                        existing.dirs.push(dir);
+                }
+                else {
+                    byId.set(entry.id, { ...entry, dirs: [dir] });
+                }
+            }
+            else {
+                failures.push({ ...entry, dirs: [dir] });
+            }
+        }
+    }
+    const entries = [...byId.values(), ...failures];
+    return { dirs, count: entries.length, allOk, entries, resolution: (0, ledger_1.resolveLedgerInbox)(entries) };
+}

package/dist/shell/man-cli.js

@@ -0,0 +1,89 @@
+"use strict";
+// shell/man-cli.ts — the CLI/MCP-reachable body for `cw man <topic>`.
+//
+// Reads docs/<topic>.7.md, then docs/<topic>.md, then docs/<topic>, and
+// writes the raw file bytes to stdout with NO added trailing newline.
+//
+// Evidence: SPEC/cli-surface.md "man <topic>" row, and the old build's
+// src/cli/command-surface.ts:147-161 ("man" case) — docsDir is resolved
+// relative to the plugin root the same way shell/workflow-app-loader.ts's
+// walkUpFor and shell/metrics-cli.ts's pluginRoot() do (walk up from this
+// file's own location looking for a sibling plugins/cool-workflow tree).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManPageNotFoundError = void 0;
+exports.readManPage = readManPage;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class ManPageNotFoundError extends Error {
+    topic;
+    constructor(topic) {
+        super(`Man page not found: ${topic}.\n  Tip: cw list for workflow topics, or browse docs/ for manuals.`);
+        this.topic = topic;
+        this.name = "ManPageNotFoundError";
+    }
+}
+exports.ManPageNotFoundError = ManPageNotFoundError;
+function pluginRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 8; i++) {
+        const candidate = path.join(dir, "plugins", "cool-workflow");
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return process.cwd();
+}
+/** Resolves `topic` to the raw file bytes of its manual page, trying
+ *  `docs/<topic>.7.md`, then `docs/<topic>.md`, then `docs/<topic>` in
+ *  that order. Throws `ManPageNotFoundError` when none of the three
+ *  candidates exists as a file. */
+function readManPage(topic) {
+    const docsDir = path.join(pluginRoot(), "docs");
+    const candidates = [path.join(docsDir, `${topic}.7.md`), path.join(docsDir, `${topic}.md`), path.join(docsDir, topic)];
+    for (const candidate of candidates) {
+        try {
+            if (fs.statSync(candidate).isFile())
+                return fs.readFileSync(candidate, "utf8");
+        }
+        catch {
+            // keep looking
+        }
+    }
+    throw new ManPageNotFoundError(topic);
+}

package/dist/shell/metrics-cli.js

@@ -0,0 +1,98 @@
+"use strict";
+// shell/metrics-cli.ts — CLI/MCP-facing entry points for `cw metrics
+// show`/`cw metrics summary`.
+//
+// MILESTONE 11 (reporting/observability). Wires shell/observability.ts
+// into the shapes core/capability-table.ts's CLI/MCP bindings call.
+//
+// Evidence: SPEC/reporting-ux.md "cw metrics show" / "cw metrics
+// summary".
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricsShowCli = metricsShowCli;
+exports.metricsSummaryCli = metricsSummaryCli;
+const path = __importStar(require("node:path"));
+const run_store_1 = require("./run-store");
+const observability_1 = require("./observability");
+const run_registry_io_1 = require("./run-registry-io");
+function invocationCwd(args) {
+    return typeof args.cwd === "string" && args.cwd.trim() ? path.resolve(args.cwd) : process.cwd();
+}
+function pluginRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 8; i++) {
+        const candidate = path.join(dir, "plugins", "cool-workflow");
+        if (require("node:fs").existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return process.cwd();
+}
+function nowOf(args) {
+    return typeof args.now === "string" && args.now.trim() ? args.now : new Date().toISOString();
+}
+/** `cw metrics show <run-id> [--json] [--pricing ...] [--now ISO]`. */
+function metricsShowCli(runId, args) {
+    const run = (0, run_store_1.loadRunFromCwd)(runId, invocationCwd(args));
+    const policy = (0, observability_1.loadCostPolicy)(args, pluginRoot());
+    return (0, observability_1.showMetricsReport)(run, { now: nowOf(args), policy });
+}
+/** `cw metrics summary [--scope repo|home] [--pricing ...] [--now ISO]`. */
+function metricsSummaryCli(args) {
+    const cwd = invocationCwd(args);
+    const scope = args.scope === "home" ? "home" : "repo";
+    const registry = new run_registry_io_1.RunRegistry(cwd);
+    const listing = registry.list({ scope, includeArchived: true });
+    const inputs = [];
+    let unreadableRuns = 0;
+    for (const record of listing.records) {
+        try {
+            const result = (0, run_store_1.loadRunStateFile)(record.statePath, { dryRun: true });
+            if (result.report.status === "unsupported") {
+                unreadableRuns++;
+                continue;
+            }
+            inputs.push({ run: result.run, repo: record.repo, persistedFingerprint: (0, observability_1.loadPersistedMetricsFingerprint)(result.run) });
+        }
+        catch {
+            unreadableRuns++;
+        }
+    }
+    const policy = (0, observability_1.loadCostPolicy)(args, pluginRoot());
+    return (0, observability_1.deriveMetricsSummary)(inputs, { now: nowOf(args), scope, policy, unreadableRuns });
+}