cool-workflow 0.1.97 → 0.2.0

package/dist/shell/node-store.js

@@ -0,0 +1,124 @@
+"use strict";
+// shell/node-store.ts — writeRunNode, node-snapshot/replay disk persistence
+// and reads.
+//
+// MILESTONE 3. The disk half of core/state/state-node.ts (writeRunNode)
+// and core/state/node-snapshot.ts (persist callbacks + readNodeSnapshot/
+// readNodeReplay's directory scans). Byte-exact port of the old build's
+// src/state-node.ts:226-231 and src/node-snapshot.ts:96-127.
+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.writeRunNode = writeRunNode;
+exports.appendRunNode = appendRunNode;
+exports.snapshotNode = snapshotNode;
+exports.replayNodeSnapshot = replayNodeSnapshot;
+exports.readNodeSnapshot = readNodeSnapshot;
+exports.readNodeReplay = readNodeReplay;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const fs_atomic_1 = require("./fs-atomic");
+const state_node_1 = require("../core/state/state-node");
+const node_snapshot_1 = require("../core/state/node-snapshot");
+const validation_1 = require("../core/state/validation");
+const node_snapshot_2 = require("../core/state/node-snapshot");
+/** Writes the node JSON to `<stateNodesDir>/<safeFileName(node.id)>.json`
+ *  with `writeJson` (NOT durable) and returns the file path. */
+function writeRunNode(run, node) {
+    const dir = run.paths.stateNodesDir || path.join(run.paths.runDir, "nodes");
+    const file = path.join(dir, `${(0, fs_atomic_1.safeFileName)(node.id)}.json`);
+    (0, fs_atomic_1.writeJson)(file, node);
+    return file;
+}
+/** Upserts `node` into `run.nodes` in place, then writes it to disk. */
+function appendRunNode(run, node) {
+    return (0, state_node_1.appendRunNode)(run, node, writeRunNode);
+}
+function snapshotsRoot(run) {
+    const base = run.paths.stateNodesDir || path.join(run.paths.runDir, "nodes");
+    return path.join(base, "snapshots");
+}
+function snapshotDir(run, nodeId) {
+    return path.join(snapshotsRoot(run), (0, fs_atomic_1.safeFileName)(nodeId));
+}
+/** Snapshot one StateNode by id, persisting by default under
+ *  `nodes/snapshots/<safeFileName(nodeId)>/<snapshotId>.json`. */
+function snapshotNode(run, nodeId, options = {}) {
+    return (0, node_snapshot_1.snapshotNode)(run, nodeId, {
+        now: options.now,
+        persist: options.persist === false
+            ? false
+            : (snapshot) => (0, fs_atomic_1.writeJson)(path.join(snapshotDir(run, nodeId), `${snapshot.snapshotId}.json`), snapshot),
+    });
+}
+/** Deterministically replay one node from a snapshot, persisting by
+ *  default under `.../replays/<replayId>.json`. `pathExists` defaults to
+ *  the real filesystem. */
+function replayNodeSnapshot(run, snapshot, options = {}) {
+    return (0, node_snapshot_1.replayNodeSnapshot)(run, snapshot, {
+        now: options.now,
+        pathExists: fs.existsSync,
+        persist: options.persist === false
+            ? false
+            : (replay) => (0, fs_atomic_1.writeJson)(path.join(snapshotDir(run, snapshot.nodeId), "replays", `${replay.replayId}.json`), replay),
+    });
+}
+/** Scans every dir under `nodes/snapshots/` for `<snapshotId>.json`. */
+function readNodeSnapshot(run, snapshotId) {
+    const root = snapshotsRoot(run);
+    if (fs.existsSync(root)) {
+        for (const nodeDir of fs.readdirSync(root)) {
+            const file = path.join(root, nodeDir, `${snapshotId}.json`);
+            if (fs.existsSync(file))
+                return (0, validation_1.validateNodeSnapshot)(JSON.parse(fs.readFileSync(file, "utf8")));
+        }
+    }
+    throw new node_snapshot_2.NodeSnapshotError("snapshot-not-found", `Node snapshot ${snapshotId} not found in run ${run.id}`, {
+        freshness: "absent",
+    });
+}
+/** Scans every dir under `nodes/snapshots/<nodeDir>/replays/` for `<replayId>.json`. */
+function readNodeReplay(run, replayId) {
+    const root = snapshotsRoot(run);
+    if (fs.existsSync(root)) {
+        for (const nodeDir of fs.readdirSync(root)) {
+            const file = path.join(root, nodeDir, "replays", `${replayId}.json`);
+            if (fs.existsSync(file))
+                return (0, validation_1.validateNodeReplayRun)(JSON.parse(fs.readFileSync(file, "utf8")));
+        }
+    }
+    throw new node_snapshot_2.NodeSnapshotError("replay-not-found", `Node replay ${replayId} not found in run ${run.id}`, {
+        freshness: "absent",
+    });
+}

package/dist/{observability/format.js → shell/observability-format.js}

@@ -1,11 +1,17 @@
 "use strict";
+// shell/observability-format.ts — human formatters for `cw metrics show`/
+// `cw metrics summary`. Byte-exact port of the old build's
+// src/observability/format.ts.
+//
+// MILESTONE 11 (reporting/observability). Evidence: SPEC/reporting-ux.md
+// "cw metrics show / summary" (exact line shapes).
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatMetricsReport = formatMetricsReport;
 exports.formatMetricsSummary = formatMetricsSummary;
 function formatRate(r) {
     if (r.state === "n/a")
         return `n/a (0 samples)`;
-    return `${((r.rate * 100)).toFixed(1)}% (${r.count}/${r.total})`;
+    return `${(r.rate * 100).toFixed(1)}% (${r.count}/${r.total})`;
 }
 function formatMs(ms) {
     if (ms === null)

package/dist/{observability/intake.js → shell/observability-intake.js}

@@ -1,74 +1,75 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+// shell/observability-intake.ts — POLICY as DATA + host-attested usage
+// parsing for shell/observability.ts. Byte-exact port of the old build's
+// src/observability/intake.ts.
+//
+// MILESTONE 11 (reporting/observability).
+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.loadCostPolicy = loadCostPolicy;
 exports.parseUsageFromArgs = parseUsageFromArgs;
-// Intake helpers for observability — POLICY as DATA and host-attested usage
-// parsing, kept out of the kernel. Pure/IO-edge functions carved out of
-// observability.ts (god-module carve) so the metrics module no longer bundles
-// the CLI/MCP argument-intake layer. Re-exported from observability.ts to keep
-// the public surface byte-unchanged.
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const state_1 = require("../state");
-/** Resolve a CostPolicy from CLI/MCP args. `--pricing <path>` loads a policy
- *  file; `--pricing default|bundled` loads the bundled example under
- *  manifest/pricing.policy.json. Absent ⇒ undefined ⇒ cost is `unpriced`/
- *  `unreported`, never guessed. */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const fs_atomic_1 = require("./fs-atomic");
+/** Resolve a CostPolicy from CLI/MCP args. `--pricing <path>` loads a
+ *  policy file; `--pricing default|bundled` loads the bundled example.
+ *  Absent -> undefined -> cost is `unpriced`/`unreported`, never
+ *  guessed. */
 function loadCostPolicy(args, pluginRoot) {
     const raw = args.pricing ?? args.pricingPolicy ?? args.policy;
     if (raw === undefined || raw === null || raw === "")
         return undefined;
     const value = String(raw);
-    const file = value === "default" || value === "bundled"
-        ? node_path_1.default.join(pluginRoot, "manifest", "pricing.policy.json")
-        : node_path_1.default.resolve(value);
-    if (!node_fs_1.default.existsSync(file))
+    const file = value === "default" || value === "bundled" ? path.join(pluginRoot, "manifest", "pricing.policy.json") : path.resolve(value);
+    if (!fs.existsSync(file))
         throw new Error(`Pricing policy file not found: ${file}`);
-    const parsed = (0, state_1.readJson)(file);
+    const parsed = (0, fs_atomic_1.readJson)(file);
     if (!parsed || parsed.schemaVersion !== 1 || !Array.isArray(parsed.models)) {
         throw new Error(`Invalid pricing policy (expected schemaVersion 1 + models[]): ${file}`);
     }
     return parsed;
 }
-/** Parse a host-attested UsageRecord from CLI/MCP intake args. Returns undefined
- *  when NO usage was provided (⇒ `unreported`). CW never fabricates usage, so a
- *  caller that passes nothing gets nothing. */
-function parseUsageFromArgs(args, now) {
-    const inline = args.usage;
-    if (inline && typeof inline === "object" && !Array.isArray(inline)) {
-        return normalizeUsage(inline, now);
-    }
-    const input = numeric(args.usageInputTokens ?? args["usage-input-tokens"]);
-    const output = numeric(args.usageOutputTokens ?? args["usage-output-tokens"]);
-    const model = args.usageModel ?? args["usage-model"];
-    const total = numeric(args.usageTotalTokens ?? args["usage-total-tokens"]);
-    const cacheRead = numeric(args.usageCacheReadTokens ?? args["usage-cache-read-tokens"]);
-    const cacheWrite = numeric(args.usageCacheWriteTokens ?? args["usage-cache-write-tokens"]);
-    if (input === undefined && output === undefined && total === undefined && model === undefined) {
+function numeric(value) {
+    if (value === undefined || value === null || value === "")
         return undefined;
-    }
-    return normalizeUsage({
-        source: args.usageSource ?? args["usage-source"],
-        model,
-        inputTokens: input,
-        outputTokens: output,
-        totalTokens: total,
-        cacheReadTokens: cacheRead,
-        cacheWriteTokens: cacheWrite,
-        attestedAt: args.usageAttestedAt ?? args["usage-attested-at"],
-        note: args.usageNote ?? args["usage-note"]
-    }, now);
+    const n = Number(value);
+    return Number.isFinite(n) ? n : undefined;
 }
 function normalizeUsage(raw, now) {
     const source = raw.source === "operator-recorded" ? "operator-recorded" : "host-attested";
-    const usage = {
-        schemaVersion: 1,
-        source,
-        attestedAt: typeof raw.attestedAt === "string" && raw.attestedAt ? raw.attestedAt : now
-    };
+    const usage = { schemaVersion: 1, source, attestedAt: typeof raw.attestedAt === "string" && raw.attestedAt ? raw.attestedAt : now };
     if (raw.model !== undefined && raw.model !== null && raw.model !== "")
         usage.model = String(raw.model);
     const input = numeric(raw.inputTokens);
@@ -90,9 +91,31 @@ function normalizeUsage(raw, now) {
         usage.note = String(raw.note);
     return usage;
 }
-function numeric(value) {
-    if (value === undefined || value === null || value === "")
+/** Parse a host-attested UsageRecord from CLI/MCP intake args. Returns
+ *  undefined when NO usage was provided (-> `unreported`). CW never
+ *  fabricates usage. */
+function parseUsageFromArgs(args, now) {
+    const inline = args.usage;
+    if (inline && typeof inline === "object" && !Array.isArray(inline)) {
+        return normalizeUsage(inline, now);
+    }
+    const input = numeric(args.usageInputTokens ?? args["usage-input-tokens"]);
+    const output = numeric(args.usageOutputTokens ?? args["usage-output-tokens"]);
+    const model = args.usageModel ?? args["usage-model"];
+    const total = numeric(args.usageTotalTokens ?? args["usage-total-tokens"]);
+    const cacheRead = numeric(args.usageCacheReadTokens ?? args["usage-cache-read-tokens"]);
+    const cacheWrite = numeric(args.usageCacheWriteTokens ?? args["usage-cache-write-tokens"]);
+    if (input === undefined && output === undefined && total === undefined && model === undefined)
         return undefined;
-    const n = Number(value);
-    return Number.isFinite(n) ? n : undefined;
+    return normalizeUsage({
+        source: args.usageSource ?? args["usage-source"],
+        model,
+        inputTokens: input,
+        outputTokens: output,
+        totalTokens: total,
+        cacheReadTokens: cacheRead,
+        cacheWriteTokens: cacheWrite,
+        attestedAt: args.usageAttestedAt ?? args["usage-attested-at"],
+        note: args.usageNote ?? args["usage-note"],
+    }, now);
 }