@openrig/cli 0.1.12 → 0.3.0

package/dist/commands/workflow.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "commander";
+import type { StatusDeps } from "./status.js";
+/**
+ * `rig workflow` — daemon-native Workflow Runtime (PL-004 Phase D).
+ *
+ * Backed by `/api/workflow`. Operates only via the daemon HTTP API.
+ *
+ * Per PRD § L4 Workflow Runtime: workflow specs are markdown/YAML
+ * authoritative, daemon caches a read-through copy. Owner-as-author
+ * + workflow-as-transactional-scribe: owner closure + next-qitem
+ * projection happen in the SAME daemon transaction. Lost handoffs
+ * are impossible by design.
+ */
+export interface WorkflowDeps extends StatusDeps {
+}
+export declare function workflowCommand(depsOverride?: WorkflowDeps): Command;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/commands/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAa,SAAQ,UAAU;CAAG;AAyBnD,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAiLpE"}

package/dist/commands/workflow.js

@@ -0,0 +1,175 @@
+import { Command } from "commander";
+import { DaemonClient } from "../client.js";
+import { getDaemonStatus, getDaemonUrl } from "../daemon-lifecycle.js";
+import { realDeps } from "./daemon.js";
+async function withClient(deps, fn) {
+    const status = await getDaemonStatus(deps.lifecycleDeps);
+    if (status.state !== "running" || status.healthy === false) {
+        console.error("Daemon not running. Start it with: rig daemon start");
+        process.exitCode = 1;
+        return undefined;
+    }
+    const client = deps.clientFactory(getDaemonUrl(status));
+    return fn(client);
+}
+function printResult(json, body, status) {
+    if (json) {
+        console.log(JSON.stringify(body));
+    }
+    else {
+        console.log(JSON.stringify(body, null, 2));
+    }
+    if (status >= 400)
+        process.exitCode = status >= 500 ? 2 : 1;
+}
+export function workflowCommand(depsOverride) {
+    const cmd = new Command("workflow").description("Daemon-native Workflow Runtime — declarative spec + transactional-scribe step projection (PL-004 Phase D)");
+    const getDeps = () => depsOverride ?? {
+        lifecycleDeps: realDeps(),
+        clientFactory: (url) => new DaemonClient(url),
+    };
+    cmd
+        .command("validate <specPath>")
+        .description("Validate a workflow spec file (returns structured ok/error report)")
+        .option("--json", "JSON output for agents")
+        .action(async (specPath, opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.post("/api/workflow/validate", { specPath });
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    cmd
+        .command("instantiate <specPath>")
+        .description("Create a workflow instance + entry-step qitem from a spec")
+        .requiredOption("--root-objective <text>", "Root objective for the run")
+        .requiredOption("--created-by <session>", "Session creating the instance (canonical <member>@<rig>)")
+        .option("--entry-owner <session>", "Override default entry-step owner")
+        .option("--json", "JSON output for agents")
+        .action(async (specPath, opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.post("/api/workflow/instantiate", {
+                specPath,
+                rootObjective: opts.rootObjective,
+                createdBySession: opts.createdBy,
+                entryOwnerSession: opts.entryOwner,
+            });
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    cmd
+        .command("project")
+        .description("Close a current packet AND project the next-step packet (transactional-scribe; one daemon transaction)")
+        .requiredOption("--instance <id>", "Workflow instance id")
+        .requiredOption("--current-packet <qitem-id>", "qitem being closed (must be on instance frontier)")
+        .requiredOption("--exit <kind>", "Closure exit kind: handoff | waiting | done | failed")
+        .requiredOption("--actor-session <session>", "Session closing the packet (owner-as-author)")
+        .option("--result-note <text>", "Closure result note (audit context)")
+        .option("--blocked-on <ref>", "For waiting exits: blocker reference (qitem id, gate name)")
+        .option("--next-owner <session>", "Override default next-step owner")
+        .option("--json", "JSON output for agents")
+        .action(async (opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.post("/api/workflow/project", {
+                instanceId: opts.instance,
+                currentPacketId: opts.currentPacket,
+                exit: opts.exit,
+                actorSession: opts.actorSession,
+                resultNote: opts.resultNote,
+                blockedOn: opts.blockedOn,
+                nextOwnerSession: opts.nextOwner,
+            });
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    cmd
+        .command("list")
+        .description("List workflow instances; optionally filter by status")
+        .option("--status <s>", "Filter by status (active | waiting | completed | failed)")
+        .option("--json", "JSON output for agents")
+        .action(async (opts) => {
+        const deps = getDeps();
+        const params = new URLSearchParams();
+        if (opts.status)
+            params.set("status", opts.status);
+        const qs = params.toString();
+        await withClient(deps, async (client) => {
+            const res = await client.get(`/api/workflow/list${qs ? `?${qs}` : ""}`);
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    // List cached workflow_specs (NOT instances). The existing
+    // `rig workflow list` lists instances; this is the complementary
+    // surface for inspecting which specs are registered, including any
+    // built-in starter(s) shipped at daemon startup.
+    // Built-in rows display a `(built-in)` indicator in human output and
+    // an `isBuiltIn: true` field in JSON output.
+    cmd
+        .command("specs")
+        .description("List registered workflow specs; built-in starters tagged with (built-in)")
+        .option("--json", "JSON output for agents")
+        .action(async (opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.get("/api/workflow/specs");
+            if (opts.json) {
+                printResult(true, res.data, res.status);
+                return;
+            }
+            if (res.status >= 400) {
+                printResult(false, res.data, res.status);
+                return;
+            }
+            const rows = res.data.specs ?? [];
+            if (rows.length === 0) {
+                console.log("No workflow specs registered.");
+                return;
+            }
+            // Compact human table — name, version, source, indicator.
+            for (const row of rows) {
+                const indicator = row.isBuiltIn ? " (built-in)" : "";
+                console.log(`${row.name} v${row.version}${indicator}`);
+                if (row.purpose)
+                    console.log(`  purpose: ${row.purpose.replace(/\n/g, " ").slice(0, 120)}`);
+                console.log(`  source: ${row.sourcePath}`);
+            }
+        });
+    });
+    cmd
+        .command("show <instanceId>")
+        .description("Show one workflow instance")
+        .option("--json", "JSON output for agents")
+        .action(async (instanceId, opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.get(`/api/workflow/${encodeURIComponent(instanceId)}`);
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    cmd
+        .command("trace <instanceId>")
+        .description("Show one workflow instance + its append-only step trail (audit-only verdict)")
+        .option("--json", "JSON output for agents")
+        .action(async (instanceId, opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.get(`/api/workflow/${encodeURIComponent(instanceId)}/trace`);
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    cmd
+        .command("continue <instanceId>")
+        .description("Mechanically advance an instance after truthful closure (idempotent inspector in v1)")
+        .option("--json", "JSON output for agents")
+        .action(async (instanceId, opts) => {
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.post(`/api/workflow/${encodeURIComponent(instanceId)}/continue`, {});
+            printResult(opts.json ?? false, res.data, res.status);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/commands/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiBvC,KAAK,UAAU,UAAU,CACvB,IAAkB,EAClB,EAAwC;IAExC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,IAAa,EAAE,MAAc;IAC/D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAA2B;IACzD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAC7C,2GAA2G,CAC5G,CAAC;IACF,MAAM,OAAO,GAAG,GAAiB,EAAE,CACjC,YAAY,IAAI;QACd,aAAa,EAAE,QAAQ,EAAE;QACzB,aAAa,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC;KACtD,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAwB,EAAE,EAAE;QAC3D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,wBAAwB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/E,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,2DAA2D,CAAC;SACxE,cAAc,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;SACvE,cAAc,CAAC,wBAAwB,EAAE,0DAA0D,CAAC;SACpG,MAAM,CAAC,yBAAyB,EAAE,mCAAmC,CAAC;SACtE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAKhC,EAAE,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,2BAA2B,EAAE;gBAClE,QAAQ;gBACR,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,gBAAgB,EAAE,IAAI,CAAC,SAAS;gBAChC,iBAAiB,EAAE,IAAI,CAAC,UAAU;aACnC,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,wGAAwG,CAAC;SACrH,cAAc,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACzD,cAAc,CAAC,6BAA6B,EAAE,mDAAmD,CAAC;SAClG,cAAc,CAAC,eAAe,EAAE,sDAAsD,CAAC;SACvF,cAAc,CAAC,2BAA2B,EAAE,8CAA8C,CAAC;SAC3F,MAAM,CAAC,sBAAsB,EAAE,qCAAqC,CAAC;SACrE,MAAM,CAAC,oBAAoB,EAAE,4DAA4D,CAAC;SAC1F,MAAM,CAAC,wBAAwB,EAAE,kCAAkC,CAAC;SACpE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,IASd,EAAE,EAAE;QACH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,uBAAuB,EAAE;gBAC9D,UAAU,EAAE,IAAI,CAAC,QAAQ;gBACzB,eAAe,EAAE,IAAI,CAAC,aAAa;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,gBAAgB,EAAE,IAAI,CAAC,SAAS;aACjC,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,cAAc,EAAE,0DAA0D,CAAC;SAClF,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,qBAAqB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjF,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,2DAA2D;IAC3D,iEAAiE;IACjE,mEAAmE;IACnE,iDAAiD;IACjD,qEAAqE;IACrE,6CAA6C;IAC7C,GAAG;SACA,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAItB,qBAAqB,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBACxC,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBACtB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;gBACzC,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,0DAA0D;YAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC,CAAC;gBACvD,IAAI,GAAG,CAAC,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC5F,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,IAAwB,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,iBAAiB,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACzF,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,8EAA8E,CAAC;SAC3F,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,IAAwB,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAU,iBAAiB,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC/F,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,sFAAsF,CAAC;SACnG,MAAM,CAAC,QAAQ,EAAE,wBAAwB,CAAC;SAC1C,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,IAAwB,EAAE,EAAE;QAC7D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,iBAAiB,kBAAkB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACvG,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/workspace.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+import type { StatusDeps } from "./status.js";
+export interface WorkspaceDeps extends StatusDeps {
+}
+export declare function workspaceCommand(depsOverride?: WorkspaceDeps): Command;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAc,SAAQ,UAAU;CAAG;AAkCpD,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CA4DtE"}

package/dist/commands/workspace.js

@@ -0,0 +1,83 @@
+// PL-007 Workspace Primitive v0 — `rig workspace` CLI surface.
+//
+// v0 surface (one verb): `rig workspace validate`. Walks a workspace root,
+// parses each .md file's YAML frontmatter, and emits a structured gap
+// report. Advisory only — never modifies. curate-steward consumes the
+// report.
+import { Command } from "commander";
+import { DaemonClient } from "../client.js";
+import { getDaemonStatus, getDaemonUrl } from "../daemon-lifecycle.js";
+import * as path from "node:path";
+import { realDeps } from "./daemon.js";
+async function withClient(deps, fn) {
+    const status = await getDaemonStatus(deps.lifecycleDeps);
+    if (status.state !== "running" || status.healthy === false) {
+        console.error("Daemon not running. Start it with: rig daemon start");
+        process.exitCode = 1;
+        return undefined;
+    }
+    const client = deps.clientFactory(getDaemonUrl(status));
+    return fn(client);
+}
+export function workspaceCommand(depsOverride) {
+    const cmd = new Command("workspace").description("PL-007 Workspace Primitive — typed-kind tooling. v0: `validate` walks a root and reports frontmatter gaps.");
+    const getDeps = () => depsOverride ?? {
+        lifecycleDeps: realDeps(),
+        clientFactory: (url) => new DaemonClient(url),
+    };
+    cmd
+        .command("validate [root]")
+        .description("Walk a workspace root, parse each .md file's YAML frontmatter, and emit a structured gap report. Advisory only — never modifies files. Default root: cwd.")
+        .option("--kind <kind>", "Workspace kind to validate against: user | project | knowledge | lab | delivery")
+        .option("--no-recursive", "Do not descend into subdirectories")
+        .option("--require-frontmatter", "Report a gap for every .md file without a frontmatter delimiter")
+        .option("--max-files <n>", "Hard cap on .md files walked", "10000")
+        .option("--json", "JSON output for agents")
+        .action(async (rootArg, opts) => {
+        const root = path.resolve(rootArg ?? process.cwd());
+        const deps = getDeps();
+        await withClient(deps, async (client) => {
+            const res = await client.post("/api/workspace/validate", {
+                root,
+                workspaceKind: opts.kind,
+                recursive: opts.recursive !== false,
+                requireFrontmatter: opts.requireFrontmatter ?? false,
+                maxFiles: Number.parseInt(opts.maxFiles, 10),
+            });
+            if (res.status >= 400) {
+                console.error(JSON.stringify(res.data, null, 2));
+                process.exitCode = 1;
+                return;
+            }
+            const report = res.data;
+            if (opts.json) {
+                console.log(JSON.stringify(report));
+            }
+            else {
+                renderHumanReport(report);
+            }
+            // Exit non-zero when gaps found — operators chain into hygiene fix loops.
+            if (report.gapCount > 0)
+                process.exitCode = 1;
+        });
+    });
+    return cmd;
+}
+function renderHumanReport(r) {
+    console.log(`workspace root: ${r.root}`);
+    console.log(`workspace kind: ${r.workspaceKind ?? "(none — kind-agnostic structural check)"}`);
+    console.log(`files walked:   ${r.totalFiles}`);
+    console.log(`with frontmatter: ${r.filesWithFrontmatter}`);
+    console.log(`gaps:           ${r.gapCount}`);
+    if (r.gapCount === 0) {
+        console.log("\n  no gaps — canon is clean against v0 contract.");
+        return;
+    }
+    console.log("\n  Gaps:");
+    for (const g of r.gaps) {
+        const fieldStr = g.field ? ` [${g.field}]` : "";
+        console.log(`    [${g.kind}] ${g.relativePath}${fieldStr}`);
+        console.log(`        ${g.message}`);
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/commands/workspace.js.map

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

package/dist/config-store.d.ts

@@ -9,15 +9,87 @@ export interface RiggedConfig {
     transcripts: {
         enabled: boolean;
         path: string;
+        lines: number;
+        pollIntervalSeconds: number;
+    };
+    workspace: {
+        root: string;
+        slicesRoot: string;
+        steeringPath: string;
+        fieldNotesRoot: string;
+        specsRoot: string;
+        dogfoodEvidenceRoot: string;
+    };
+    files: {
+        allowlist: string;
+    };
+    progress: {
+        scanRoots: string;
+    };
+    ui: {
+        preview: {
+            refreshIntervalSeconds: number;
+            maxPins: number;
+            defaultLines: number;
+        };
+    };
+    recovery: {
+        autoDriveProviderPrompts: boolean;
+        providerAuthEnvAllowlist: string;
+    };
+    agents: {
+        advisorSession: string;
+        operatorSession: string;
+    };
+    feed: {
+        subscriptions: {
+            actionRequired: boolean;
+            approvals: boolean;
+            shipped: boolean;
+            progress: boolean;
+            auditLog: boolean;
+        };
     };
 }
+export declare const VALID_KEYS: readonly ["daemon.port", "daemon.host", "db.path", "transcripts.enabled", "transcripts.path", "transcripts.lines", "transcripts.poll_interval_seconds", "workspace.root", "workspace.slices_root", "workspace.steering_path", "workspace.field_notes_root", "workspace.specs_root", "workspace.dogfood_evidence_root", "files.allowlist", "progress.scan_roots", "ui.preview.refresh_interval_seconds", "ui.preview.max_pins", "ui.preview.default_lines", "recovery.auto_drive_provider_prompts", "recovery.provider_auth_env_allowlist", "agents.advisor_session", "agents.operator_session", "feed.subscriptions.action_required", "feed.subscriptions.approvals", "feed.subscriptions.shipped", "feed.subscriptions.progress", "feed.subscriptions.audit_log"];
+export type ValidKey = typeof VALID_KEYS[number];
+export declare const ENV_MAP: Record<ValidKey, {
+    primary: string;
+    legacy?: string;
+}>;
+export declare function deriveWorkspaceDefault(key: ValidKey, workspaceRoot: string): string;
+export type SettingSource = "env" | "file" | "default";
+export interface ResolvedSetting {
+    value: string | number | boolean;
+    source: SettingSource;
+    defaultValue: string | number | boolean;
+}
 export declare class ConfigStore {
     readonly configPath: string;
     constructor(configPath?: string);
     resolve(): RiggedConfig;
+    /**
+     * Resolve a single key with its source. Used by the daemon HTTP route
+     * + UI Settings panel for honest provenance display (env / file /
+     * default).
+     */
+    resolveWithSource(key: string): ResolvedSetting;
+    /** Resolve all valid keys with sources. Convenience for the UI. */
+    resolveAllWithSource(): Record<ValidKey, ResolvedSetting>;
+    private resolveOne;
     get(key: string): string | number | boolean;
     set(key: string, value: string): void;
-    reset(): void;
+    /**
+     * Clear an override. Without a key argument, deletes the whole config
+     * file (revert all to defaults). With a key, removes just that key
+     * from the config file.
+     */
+    reset(key?: string): void;
     private readConfigFile;
 }
+export interface NamedPair {
+    name: string;
+    path: string;
+}
+export declare function parseNamedPairs(raw: string): NamedPair[];
 //# sourceMappingURL=config-store.d.ts.map

package/dist/config-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrB,WAAW,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAwED,qBAAa,WAAW;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,CAAC,EAAE,MAAM;IAI/B,OAAO,IAAI,YAAY;IAiCvB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;IAQ3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAYrC,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;CAYvB"}
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../src/config-store.ts"],"names":[],"mappings":"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"}