patchwork-os 0.2.0-beta.13.canary.300 → 0.2.0-beta.13.canary.302

package/dist/index.js

@@ -161,6 +161,7 @@ const KNOWN_SUBCOMMANDS = [
     "shadow-scan",
     "workers",
     "approvals",
+    "gate",
 ];
 const __invokedSubcommand = (() => {
     const sub = process.argv[2];
@@ -3937,6 +3938,76 @@ if (process.argv[2] === "approvals") {
         }
     })();
 }
+// Handle gate subcommand — "why did the worker allow/gate THIS action" over
+// the local Decision Record (worker_gate_decisions.jsonl). Reads the log
+// directly (like `workers shadow` / `approvals`); no bridge round-trip needed
+// since the record is a local file, not live state.
+if (process.argv[2] === "gate") {
+    const args = process.argv.slice(3);
+    const sub = args[0];
+    if (sub !== "explain" ||
+        args.includes("--help") ||
+        args.includes("-h") ||
+        args.length < 3) {
+        process.stdout.write("Usage: patchwork gate explain <workerId> <classKey> [--limit N] [--diff] [--json]\n\n" +
+            "Explain the worker-autonomy gate's most recent decision(s) for a given\n" +
+            "worker × action-class, from the local Decision Record\n" +
+            "(~/.patchwork/worker_gate_decisions.jsonl) — no bridge required.\n\n" +
+            '  <classKey>       e.g. "issue:compensable:high" (domain:reversibility:blastTier)\n' +
+            "  --limit N        show the N most recent decisions (default 1, or 2 with --diff)\n" +
+            "  --diff           compare the 2 most recent decisions and show what changed\n" +
+            "  --json            emit raw JSON (for scripting)\n");
+        process.exit(sub === "explain" ? 1 : 0);
+    }
+    (async () => {
+        try {
+            // Length checked above (args.length < 3 short-circuits to usage), so
+            // args[1]/[2] are present here — noUncheckedIndexedAccess just can't see
+            // across the `if` block above.
+            const workerId = args[1];
+            const classKey = args[2];
+            const wantDiff = args.includes("--diff");
+            const limitIdx = args.indexOf("--limit");
+            const explicitLimit = limitIdx >= 0 && limitIdx + 1 < args.length
+                ? Number.parseInt(args[limitIdx + 1], 10)
+                : undefined;
+            const limit = explicitLimit ?? (wantDiff ? 2 : 1);
+            if (!Number.isFinite(limit) || limit < 1) {
+                process.stderr.write("Error: --limit must be a positive integer\n");
+                process.exit(1);
+            }
+            const { WorkerGateDecisionLog, formatGateDecisionHistory, formatGateDecisionDiff, } = await import("./workerGateDecisionLog.js");
+            const patchworkDir = process.env.PATCHWORK_HOME ?? path.join(os.homedir(), ".patchwork");
+            const log = new WorkerGateDecisionLog({ dir: patchworkDir });
+            const decisions = log.query({ workerId, classKey, limit });
+            if (args.includes("--json")) {
+                process.stdout.write(`${JSON.stringify(decisions, null, 2)}\n`);
+                process.exit(0);
+            }
+            if (decisions.length === 0) {
+                process.stdout.write(`No gate decisions found for worker "${workerId}" on class "${classKey}".\n` +
+                    "Either the worker hasn't acted on this class yet, or worker.autonomy is off.\n");
+                process.exit(0);
+            }
+            if (wantDiff) {
+                // query() sorts most-recent-first: newer is [0], older is [1].
+                const [newer, older] = decisions;
+                if (!newer || !older) {
+                    process.stdout.write(`Only one decision found for worker "${workerId}" on class "${classKey}" — nothing to diff against yet.\n`);
+                    process.exit(0);
+                }
+                process.stdout.write(`${formatGateDecisionDiff(newer, older)}\n`);
+                process.exit(0);
+            }
+            process.stdout.write(`${formatGateDecisionHistory(decisions)}\n`);
+            process.exit(0);
+        }
+        catch (err) {
+            process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}\n`);
+            process.exit(1);
+        }
+    })();
+}
 // Handle launchd subcommand — install/uninstall macOS LaunchAgent for auto-start
 if (process.argv[2] === "launchd") {
     const sub = process.argv[3];