@bragi-gmbh/codebus 1.4.0 → 1.6.1

package/dist/commands/correlation.js

@@ -0,0 +1,194 @@
+import { CodebusError } from "../errors.js";
+import { makeCtx } from "../client.js";
+import { resolveConfig } from "../config.js";
+import { randomUUID } from "node:crypto";
+export class CorrelationError extends CodebusError {
+    constructor(message) {
+        super(message);
+        this.name = "CorrelationError";
+    }
+}
+/** Validate null/absent fields explicitly; never silently drop unknown ids. */
+function pickFirst(...vals) {
+    for (const v of vals) {
+        if (v === undefined || v === null)
+            continue;
+        if (typeof v !== "string")
+            throw new CorrelationError(`correlation id must be a string, got: ${typeof v}`);
+        const t = v.trim();
+        if (t.length === 0)
+            continue;
+        return t;
+    }
+    return undefined;
+}
+function requireField(name, value) {
+    // Explicit null/absent validation: missing is a typed error, never a silent drop.
+    if (value === undefined || value === null || value.trim().length === 0) {
+        throw new CorrelationError(`correlation chain missing required field: ${name}`);
+    }
+    return value;
+}
+export function validateCorrelationEnvelope(chain) {
+    for (const f of ["actor", "environment", "transport"]) {
+        const v = chain?.[f];
+        // Require all three fields to be present and strings; reject non-strings (numbers, objects, etc)
+        if (typeof v !== "string" || v.trim().length === 0) {
+            throw new CorrelationError(`correlation envelope field '${f}' must be a non-empty string, got: ${typeof v} ${JSON.stringify(v)}`);
+        }
+    }
+    // Validate specific field values
+    if (chain.environment !== "dev" && chain.environment !== "prod") {
+        throw new CorrelationError(`correlation envelope has invalid environment: ${chain.environment} (expected 'dev' | 'prod')`);
+    }
+    if (chain.transport !== "cli" && chain.transport !== "mcp") {
+        throw new CorrelationError(`correlation envelope has invalid transport: ${chain.transport} (expected 'cli' | 'mcp')`);
+    }
+}
+/**
+ * Resolve the authenticated person's GitHub login from the CodeBus session.
+ * Uses the identity precedence from resolveConfig: flags > env > session/cwd/config.
+ * Returns undefined when no CodeBus identity is available (e.g., in tests).
+ */
+async function resolveGithubLogin(overrides) {
+    try {
+        const cfg = resolveConfig(overrides || {});
+        const ctx = await makeCtx(cfg);
+        const { data, error } = await ctx.supabase
+            .from("agents")
+            .select("people!person_id(github_login)")
+            .eq("slug", ctx.agentSlug)
+            .single();
+        if (error)
+            return undefined;
+        return data?.people?.github_login ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Build a fully validated T-01 correlation chain.
+ * Fills run_id (generated when absent), actor (GitHub login), environment (--env, default 'prod' per ADR-0011).
+ * respects Overrides (--url, --token, --agent, --workspace) per identity precedence: flags > env > session/cwd/config.
+ * Actor resolution: opts.actor > partial.actor > githubLogin (verified CodeBus identity) > env vars.
+ */
+export async function buildCorrelationChain(partial, opts = {}) {
+    // Idempotency lookups BEFORE policy checks on retry paths: resolve the
+    // cheapest deterministic fields first (ids), then enforce policy (actor/env/transport).
+    const plan_id = pickFirst(partial.plan_id, partial.plan);
+    const stage_id = pickFirst(partial.stage_id, partial.stage);
+    const child_id = pickFirst(partial.child_id, partial.child);
+    const binding_id = pickFirst(partial.binding_id, partial.binding);
+    const run_id = pickFirst(partial.run_id, partial.run) ?? randomUUID();
+    const jira_key = pickFirst(partial.jira_key);
+    const pr_url = pickFirst(partial.pr_url, partial.pr);
+    const receipt_id = pickFirst(partial.receipt_id, partial.receipt);
+    requireField("plan_id", plan_id);
+    requireField("stage_id", stage_id);
+    requireField("child_id", child_id);
+    requireField("binding_id", binding_id);
+    requireField("run_id", run_id);
+    // Actor: explicit opt > partial > verified CodeBus GitHub login > GitHub env vars.
+    // Actor must be a GitHub login (people.github_login), not an agent slug.
+    // Never silently drop: absent actor is a typed error.
+    let actor = pickFirst(opts.actor, partial.actor, opts.githubLogin);
+    if (!actor && opts.overrides) {
+        actor = await resolveGithubLogin(opts.overrides);
+    }
+    if (!actor) {
+        actor = pickFirst(process.env.GITHUB_USER, process.env.GH_USER, process.env.GITHUB_ACTOR);
+    }
+    if (!actor) {
+        throw new CorrelationError(`correlation chain requires actor (GitHub login); provide via --actor flag, authenticate with codebus login, or set GITHUB_USER/GITHUB_ACTOR env`);
+    }
+    const environment = pickFirst(opts.environment, opts.env, partial.environment, partial.env) ?? "prod";
+    const transport = pickFirst(opts.transport, partial.transport) ?? "cli";
+    const chain = {
+        plan_id: plan_id,
+        stage_id: stage_id,
+        child_id: child_id,
+        binding_id: binding_id,
+        run_id: run_id,
+        actor: actor || "",
+        environment: environment || "prod",
+        transport: transport || "cli",
+    };
+    if (jira_key !== undefined)
+        chain.jira_key = jira_key;
+    if (pr_url !== undefined)
+        chain.pr_url = pr_url;
+    if (receipt_id !== undefined)
+        chain.receipt_id = receipt_id;
+    // Negative-fixture behavior: missing actor/environment/transport raises typed error.
+    validateCorrelationEnvelope(chain);
+    return chain;
+}
+/** Resolve the authenticated person's GitHub login from the CodeBus session. */
+async function resolveActorFromSession(o) {
+    try {
+        const ctx = await makeCtx(resolveConfig(o));
+        const { data, error } = await ctx.supabase
+            .from("agents")
+            .select("people!person_id(github_login)")
+            .eq("slug", ctx.agentSlug)
+            .single();
+        if (error)
+            return undefined;
+        return data?.people?.github_login ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function correlationCmd(o) {
+    try {
+        // Resolve actor via CodeBus identity (ADR-0003/ADR-0011 precedence: flags > env > session/cwd/config).
+        // An explicit --actor is VERIFIED against the authenticated GitHub login
+        // whenever a session identity resolves: a caller must not be able to emit
+        // a chain naming an arbitrary GitHub login while authenticated as someone
+        // else. Without a resolvable session (offline/tests), --actor is trusted
+        // as the flag tier of the precedence.
+        let actor = o.actor;
+        const resolvedLogin = await resolveActorFromSession(o);
+        if (resolvedLogin) {
+            if (actor && actor !== resolvedLogin) {
+                throw new CorrelationError(`--actor '${actor}' does not match authenticated GitHub login '${resolvedLogin}'`);
+            }
+            actor = resolvedLogin;
+        }
+        const chain = await buildCorrelationChain({
+            jira_key: o.jiraKey,
+            plan: o.plan,
+            stage: o.stage,
+            child: o.child,
+            binding: o.binding,
+            run: o.run,
+            pr: o.pr,
+            receipt: o.receipt,
+            actor: actor,
+            env: o.env,
+        }, { transport: "cli", overrides: o });
+        console.log(JSON.stringify(chain, null, 2));
+    }
+    catch (err) {
+        if (err instanceof CodebusError)
+            throw err;
+        throw new CodebusError(`Failed to build correlation chain: ${err instanceof Error ? err.message : String(err)}`, 1);
+    }
+}
+export function registerCorrelation(program, g) {
+    g(program.command("correlation").description("build a T-01 correlation chain"))
+        .option("--jira-key <k>", "jira key")
+        .option("--plan <id>", "plan id")
+        .option("--stage <id>", "stage id")
+        .option("--child <id>", "child id")
+        .option("--binding <id>", "binding id")
+        .option("--run <id>", "run id (generated when absent)")
+        .option("--pr <url>", "pr url")
+        .option("--receipt <id>", "receipt id")
+        .option("--actor <login>", "GitHub login (defaults to authenticated CodeBus identity, then GITHUB_USER/GH_USER/GITHUB_ACTOR env)")
+        .option("--env <e>", "environment dev|prod (default prod per ADR-0011)")
+        .action((o) => correlationCmd(o));
+}
+//# sourceMappingURL=correlation.js.map

package/dist/commands/correlation.js.map

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

package/dist/commands/decision.js

@@ -34,6 +34,52 @@ export async function acceptDecisionCore(ctx, idOrDisplay) {
         throw new CodebusError(`accept failed (owner-only): ${error.message}`);
     return { display_id: data.display_id, status: data.status, id: data.id };
 }
+export async function transitionDecisionCore(ctx, decisionId, opts) {
+    const { data, error } = await ctx.supabase.rpc("decision_transition", {
+        p_decision_id: decisionId,
+        p_expected_status: opts.from,
+        p_new_status: opts.to,
+    });
+    if (error)
+        throw new CodebusError(error.message);
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        throw new CodebusError("decision transition RPC returned an invalid response");
+    }
+    return data;
+}
+/**
+ * Shared core: list all decisions in the workspace (read-only).
+ * Exported for reuse in MCP tool.
+ */
+export async function decisionListCore(ctx) {
+    const ws = await workspaceId(ctx);
+    const { data, error } = await ctx.supabase.from("decisions")
+        .select("display_id, id, slug, title, status, created_at")
+        .eq("workspace_id", ws).order("created_at", { ascending: false });
+    if (error)
+        throw new CodebusError(error.message);
+    return data ?? [];
+}
+/**
+ * Shared core: show a single decision by CB-DEC-… display id or UUID.
+ * Exported for reuse in MCP tool.
+ */
+export async function decisionShowCore(ctx, idOrDisplay) {
+    const ws = await workspaceId(ctx);
+    const isDisplay = /^CB-DEC-/i.test(idOrDisplay);
+    const key = isDisplay ? "display_id" : "id";
+    const val = isDisplay ? idOrDisplay.toUpperCase() : idOrDisplay;
+    // display ids are only unique per workspace (bus_counters, 0004) — scope
+    // the lookup, or a multi-workspace agent could show the WRONG workspace's
+    // decision when two workspaces happen to share a display_id.
+    const { data, error } = await ctx.supabase.from("decisions")
+        .select("*").eq("workspace_id", ws).eq(key, val).maybeSingle();
+    if (error)
+        throw new CodebusError(error.message);
+    if (!data)
+        throw new CodebusError(`decision not found (or not visible to you): ${idOrDisplay}`);
+    return data;
+}
 async function addDecision(o) {
     const ctx = await makeCtx(resolveConfig(o));
     const result = await createDecisionCore(ctx, { title: o.title, slug: o.slug, body: o.body });
@@ -44,9 +90,26 @@ async function acceptDecision(idOrDisplay, o) {
     const result = await acceptDecisionCore(ctx, idOrDisplay);
     console.log(render([{ display_id: result.display_id, status: result.status }], { json: !!o.json }));
 }
+async function listDecisions(o) {
+    const rows = await decisionListCore(await makeCtx(resolveConfig(o)));
+    console.log(render(rows, { json: !!o.json }));
+}
+async function showDecision(idOrDisplay, o) {
+    const result = await decisionShowCore(await makeCtx(resolveConfig(o)), idOrDisplay);
+    console.log(o.json ? JSON.stringify(result, null, 2) : render([result], { json: false }));
+}
 export function registerDecision(program, g) {
     const dec = program.command("decision").description("decision operations");
     g(dec.command("add")).requiredOption("--title <t>").option("--slug <s>").option("--body <b>").action(addDecision);
+    g(dec.command("list")).action(listDecisions);
+    g(dec.command("show").argument("<id>", "CB-DEC-… or UUID")).action(showDecision);
     g(dec.command("accept").argument("<id>")).action((id, o) => acceptDecision(id, o));
+    g(dec.command("transition").argument("<id>"))
+        .requiredOption("--from <status>")
+        .requiredOption("--to <status>")
+        .action(async (id, o) => {
+        const result = await transitionDecisionCore(await makeCtx(resolveConfig(o)), id, { from: o.from, to: o.to });
+        console.log(render([result], { json: !!o.json }));
+    });
 }
 //# sourceMappingURL=decision.js.map

package/dist/commands/decision.js.map

@@ -1 +1 @@
-{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/commands/decision.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAa,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAO,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAQ,EACR,IAAqD;IAErD,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;SACzD,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;IACpG,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,UAAU,EAAE,IAAK,CAAC,UAAU,EAAE,IAAI,EAAE,IAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAK,CAAC,MAAM,EAAE,EAAE,EAAE,IAAK,CAAC,EAAE,EAAE,CAAC;AAChG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAQ,EACR,WAAmB;IAEnB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAChE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,IAAI,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnF,IAAI,SAAS;QAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;IAClD,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClF,OAAO,EAAE,UAAU,EAAE,IAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAK,CAAC,MAAM,EAAE,EAAE,EAAE,IAAK,CAAC,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAQ,EACR,UAAkB,EAClB,IAAkC;IAElC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,qBAAqB,EAAE;QACpE,aAAa,EAAE,UAAU;QACzB,iBAAiB,EAAE,IAAI,CAAC,IAAI;QAC5B,YAAY,EAAE,IAAI,CAAC,EAAE;KACtB,CAAC,CAAC;IACH,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,YAAY,CAAC,sDAAsD,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAQ;IAC7C,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;SACzD,MAAM,CAAC,iDAAiD,CAAC;SACzD,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAQ,EAAE,WAAmB;IAClE,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IAChE,yEAAyE;IACzE,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;SACzD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,YAAY,CAAC,+CAA+C,WAAW,EAAE,CAAC,CAAC;IAChG,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,CAA8E;IACvG,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7F,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACzH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,CAAiC;IAClF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,CAAiC;IAC5D,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,CAAiC;IAChF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IACpF,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,CAA0B;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAC3E,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClH,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SAC1C,cAAc,CAAC,iBAAiB,CAAC;SACjC,cAAc,CAAC,eAAe,CAAC;SAC/B,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,CAA2D,EAAE,EAAE;QAChF,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7G,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/digest.js

@@ -18,6 +18,9 @@ const COUNT_LABEL = {
     // reply work order is never indistinguishable from FYI chatter in the
     // counts. Ranked and counted separately; never a reason to act.
     8: "FYI",
+    9: "DECIDE",
+    10: "STUCK",
+    11: "UNKNOWN",
 };
 export function digestCounts(items) {
     const counts = {};
@@ -27,6 +30,10 @@ export function digestCounts(items) {
     }
     return counts;
 }
+export const DIGEST_ALGORITHM_VERSION = "digest-v2";
+export function stableDigestItems(items) {
+    return [...items].sort((a, b) => a.class_rank - b.class_rank || b.score - a.score || a.display_id.localeCompare(b.display_id) || a.id.localeCompare(b.id));
+}
 // FYI class (0061, RC2): class_rank 8 is deliberately non-actionable — the
 // whole point of the class-7/8 split is that nothing is owed on an item in
 // class 8. review finding on this PR: NEXT (`codebus next`, MCP
@@ -49,7 +56,9 @@ export async function fetchAndCacheDigest(ctx) {
     const { data, error } = await ctx.supabase.rpc("bus_digest", { p_workspace: ws });
     if (error)
         throw new CodebusError(error.message);
-    const items = (data ?? []);
+    const { data: sourceData } = await ctx.supabase.rpc("action_snapshot_sources", { p_workspace_id: ws });
+    const sources = sourceData && typeof sourceData === "object" && !Array.isArray(sourceData) ? sourceData : {};
+    const items = stableDigestItems((data ?? []).map((item) => ({ ...item, ...(sources[item.display_id] ?? {}) })));
     // S5: Count speak_now messages in my inbox that are still UNHANDLED. Gate on
     // handled_at, not read_at (review MAJOR finding #2 — delivery gap #5/#6):
     // read_at is a pure "opened" marker, so gating here on read_at meant a
@@ -80,6 +89,7 @@ export async function fetchAndCacheDigest(ctx) {
         counts: digestCounts(items),
         items,
         speak_now_count: speakNowCount,
+        algorithm_version: DIGEST_ALGORITHM_VERSION,
     };
     await mkdir(CACHE_DIR, { recursive: true });
     await writeFile(DIGEST_FILE, JSON.stringify(snapshot, null, 2), { mode: 0o600 });
@@ -111,7 +121,8 @@ async function refreshCmd(o) {
     }
 }
 export function registerDigest(program, g) {
-    const d = program.command("digest").description("deterministic attention digest");
-    g(d.command("refresh")).action(refreshCmd);
+    const d = g(program.command("digest")).description("deterministic attention digest");
+    const refresh = g(d.command("refresh", { isDefault: true }));
+    refresh.action((o, command) => refreshCmd({ ...command.parent?.opts(), ...o }));
 }
 //# sourceMappingURL=digest.js.map

package/dist/commands/digest.js.map

@@ -1 +1 @@
-{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"digest.js","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAa,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAO,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAoB1D,MAAM,WAAW,GAA2B;IAC1C,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW;IAC9E,4EAA4E;IAC5E,sEAAsE;IACtE,qEAAqE;IACrE,mBAAmB;IACnB,CAAC,EAAE,SAAS;IACZ,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,gEAAgE;IAChE,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,QAAQ;IACX,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,SAAS;CACd,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC;AAEpD,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7J,CAAC;AAED,2EAA2E;AAC3E,2EAA2E;AAC3E,gEAAgE;AAChE,sEAAsE;AACtE,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,yEAAyE;AACzE,0EAA0E;AAC1E,2EAA2E;AAC3E,qBAAqB;AACrB,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEpC,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,yBAAyB,CAAC,IAAI,IAAI,CAAC;AAC/E,CAAC;AAED,8EAA8E;AAC9E,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAQ;IAChD,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IAClF,IAAI,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;IACvG,MAAM,OAAO,GAAG,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAiD,CAAC,CAAC,CAAC,EAAE,CAAC;IACpJ,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAiB,CAAC,CAAC;IAE5I,6EAA6E;IAC7E,0EAA0E;IAC1E,uEAAuE;IACvE,6EAA6E;IAC7E,2EAA2E;IAC3E,6EAA6E;IAC7E,wEAAwE;IACxE,wEAAwE;IACxE,4DAA4D;IAC5D,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,QAAQ;aACjC,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aAClF,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC;aACtB,EAAE,CAAC,aAAa,EAAE,IAAI,CAAC;aACvB,EAAE,CAAC,uBAAuB,EAAE,EAAE,CAAC;aAC/B,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;QACvC,aAAa,GAAG,KAAK,IAAI,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAmB;QAC/B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,SAAS,EAAE,GAAG,CAAC,aAAa;QAC5B,KAAK,EAAE,GAAG,CAAC,SAAS;QACpB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;QAC3B,KAAK;QACL,eAAe,EAAE,aAAa;QAC9B,iBAAiB,EAAE,wBAAwB;KAC5C,CAAC;IACF,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAmB,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,CAAiC;IACzD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAChD,8BAA8B;IAC9B,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CACzB,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EACrF,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC;IAC9G,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM;SACjE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB,EAAE,CAA0B;IACzE,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,MAAM,CAAC,CAAC,CAAiC,EAAE,OAAgB,EAAE,EAAE,CACrE,UAAU,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/commands/do.js

@@ -0,0 +1,127 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createHash } from "node:crypto";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { resolveConfig } from "../config.js";
+import { makeCtx, workspaceId } from "../client.js";
+import { CodebusError } from "../errors.js";
+import { render } from "../output.js";
+import { dispatchFactoryRunCore, makeExecutionClient } from "./factory.js";
+import { readCachedDigest } from "./digest.js";
+const execFileAsync = promisify(execFile);
+function parseEnvelope(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new CodebusError("action_resolve returned an invalid envelope");
+    const e = value;
+    if (e.version !== 1 || typeof e.action_id !== "string" || typeof e.operation !== "string" || !e.source || typeof e.source !== "object" || typeof e.idempotency_key !== "string")
+        throw new CodebusError("action_resolve returned an invalid envelope");
+    return e;
+}
+export function resolveActionTarget(target, snapshot) {
+    if (!/^\d+$/.test(target))
+        return target.toUpperCase();
+    const item = snapshot?.items?.[Number(target) - 1];
+    if (!item?.display_id)
+        throw new CodebusError(`digest snapshot index is stale: ${target}`);
+    return item.display_id;
+}
+async function promptRelease(displayId) {
+    if (!input.isTTY || !output.isTTY)
+        throw new CodebusError("authority-sensitive commit requires an interactive TTY — run 'codebus do' from a terminal, not a piped/automation context.");
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question(`Type ${displayId} to authorize: `);
+        if (answer !== displayId)
+            throw new CodebusError("interactive confirmation did not match the display id — re-run 'codebus do' and type the display id exactly.");
+        return answer;
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function dispatchActionCore(ctx, target, phase, options) {
+    const displayId = resolveActionTarget(target, options.snapshot ?? null);
+    const snapshotItem = /^\d+$/.test(target) ? options.snapshot?.items?.[Number(target) - 1] : undefined;
+    const expected = { ...(snapshotItem?.source_revision ? { expected_revision: snapshotItem.source_revision } : {}), ...(snapshotItem?.source_state_digest ? { expected_state_digest: snapshotItem.source_state_digest } : {}) };
+    const rpc = async (rpcPhase, params = {}) => {
+        const { data, error } = await ctx.supabase.rpc("action_resolve", { p_workspace_id: options.workspaceId, p_display_id: displayId, p_phase: rpcPhase, p_params: { ...expected, ...params } });
+        if (error)
+            throw new CodebusError(`action ${rpcPhase} failed: ${error.message} — inspect the run with 'codebus factory status' (or '--json --run-id <id>'); re-run 'codebus do' to resume.`);
+        return parseEnvelope(data);
+    };
+    if (phase === "commit") {
+        if (!options.commitToken)
+            throw new CodebusError("commit requires the single-use token returned by prepare");
+        const prepared = await rpc("prepare", { commit_token: options.commitToken });
+        let proof = options.releaseProof;
+        if (!proof && ["approve", "merge", "answer", "ratify"].includes(prepared.operation)) {
+            const confirmation = await promptRelease(displayId);
+            const { data, error } = await ctx.supabase.rpc("action_release_proof", { p_workspace_id: options.workspaceId, p_display_id: displayId, p_commit_token: options.commitToken, p_confirmation: confirmation });
+            if (error)
+                throw new CodebusError(`action release proof failed: ${error.message}`);
+            proof = data && typeof data === "object" && typeof data.proof === "string" ? data.proof : undefined;
+            if (!proof)
+                throw new CodebusError("action release proof returned no proof");
+        }
+        if (["approve", "merge"].includes(prepared.operation) && prepared.source.kind === "pr") {
+            if (!options.externalAction || !options.persistExternalEvidence)
+                throw new CodebusError("PR action requires authoritative external evidence");
+            await options.persistExternalEvidence(prepared, await options.externalAction(prepared));
+        }
+        return rpc("commit", { commit_token: options.commitToken, ...(proof ? { release_proof: proof } : {}) });
+    }
+    const prepared = await rpc("prepare");
+    const factory = prepared.mutation.factory;
+    if (factory && typeof factory === "object") {
+        if (!options.factoryPrepare)
+            throw new CodebusError("action requires a managed Factory run but no dispatcher was provided");
+        const result = await options.factoryPrepare(factory);
+        if (result.exitCode !== 0)
+            throw new CodebusError(result.stderr.trim() || `factory exited with code ${result.exitCode}`, result.exitCode);
+        const value = result.value && typeof result.value === "object" && !Array.isArray(result.value) ? result.value : {};
+        const runId = typeof value.run_id === "string" ? value.run_id : typeof value.id === "string" ? value.id : undefined;
+        const bindingId = result.bindingId;
+        if (!runId || !bindingId)
+            throw new CodebusError("Factory prepare returned no managed run or binding id");
+        return { ...await rpc("prepare", { prepared_run_id: runId, prepared_binding_id: bindingId, preparation_id: prepared.preparation_id, commit_token: prepared.commit_token }), prepared_run_id: runId, prepared_binding_id: bindingId };
+    }
+    return prepared;
+}
+async function doAction(target, o) {
+    const ctx = await makeCtx(resolveConfig(o));
+    const ws = await workspaceId(ctx);
+    const snapshot = /^\d+$/.test(target) ? await readCachedDigest() : null;
+    const actionCtx = { supabase: { rpc: (name, args) => ctx.supabase.rpc(name, args) } };
+    const factoryPrepare = o.commit ? undefined : async (spec) => {
+        if (!spec.plan || !spec.stage || !spec.role)
+            throw new CodebusError("Factory action is missing plan, stage, or role");
+        return dispatchFactoryRunCore(ctx, makeExecutionClient(o.host), spec);
+    };
+    const externalAction = async (e) => {
+        const repo = e.repo;
+        const number = e.mutation.number ?? e.mutation.pr_number;
+        if (!repo || number === undefined)
+            throw new CodebusError("PR action is missing immutable repo and number");
+        const args = e.operation === "approve" ? ["pr", "review", String(number), "--repo", repo, "--approve"] : ["pr", "merge", String(number), "--repo", repo, "--merge", "--delete-branch=false"];
+        await execFileAsync("gh", args);
+        const verified = await execFileAsync("gh", ["pr", "view", String(number), "--repo", repo, "--json", "state,reviewDecision,mergeCommit"]);
+        const status = JSON.parse(verified.stdout);
+        if (e.operation === "approve" && status.reviewDecision !== "APPROVED")
+            throw new CodebusError("GitHub did not report an approved PR review");
+        if (e.operation === "merge" && (status.state !== "MERGED" || !status.mergeCommit?.oid))
+            throw new CodebusError("GitHub did not report a completed PR merge");
+        return { ref: `gh:${repo}#${number}:${e.operation}`, digest: createHash("sha256").update(verified.stdout).digest("hex") };
+    };
+    const persistExternalEvidence = async (e, evidence) => {
+        const { error } = await ctx.supabase.rpc("action_external_evidence", { p_workspace_id: ws, p_preparation_id: e.preparation_id, p_commit_token: o.commitToken, p_ref: evidence.ref, p_digest: evidence.digest });
+        if (error)
+            throw new CodebusError(`external PR evidence failed: ${error.message}`);
+    };
+    const result = await dispatchActionCore(actionCtx, target, o.commit ? "commit" : "prepare", { workspaceId: ws, snapshot, commitToken: o.commitToken, releaseProof: o.releaseProof, factoryPrepare, externalAction, persistExternalEvidence });
+    console.log(render([{ ...result }], { json: !!o.json }));
+}
+export function registerDo(program, g) {
+    g(program.command("do").argument("<display-id|snapshot-index>").option("--commit", "consume the prepared action").option("--commit-token <token>", "single-use commit token returned by prepare").option("--release-proof <proof>", "pre-issued single-use A9 proof").option("--host <host>", "execute prepare through OpenSSH").action(doAction));
+}
+//# sourceMappingURL=do.js.map

package/dist/commands/do.js.map

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

package/dist/commands/factory-attention.js

@@ -0,0 +1,106 @@
+/**
+ * Console attention view over CLI (`factory-attention`) — routes a single read
+ * through the attention_queue_v1(p_actor_login) RPC defined in 0109_attention_queue.sql.
+ *
+ * The projection yields six categories (ADR 0005: the console reads state over
+ * the API; each stuck/dead/over-cap/waiting-on-human item opens its details):
+ *   blocked-question  execution reported BLOCKED, waiting on a human answer
+ *   stalled           available non-terminal execution with a stale heartbeat
+ *   dead              terminal failed execution (ERROR/CANCELLED/INCOMPLETE) not resumed
+ *   over-cap          execution past its stage max_minutes cap (0098 deadline)
+ *   receipt-ruling    proposed decision awaiting a human ruling (0003/0104)
+ *   gate-approval     human plan gate to approve or release (0104/0107)
+ *
+ * Positive fixture: attention_queue_v1_returns_user_items
+ *   — calling attention_queue_v1(p_actor_login) for the accountable person
+ *     returns exactly the items they own/drive/rule on, scoped by RLS.
+ *
+ * Negative fixture: attention_returns_empty_for_other_user
+ *   — the same RPC called for a login that owns/drives/none of the items
+ *     returns zero rows (the actor_login filter narrows to the named person,
+ *     unknown logins yield nothing, never an error).
+ *
+ * Reusable core exported for tests and future MCP parity.
+ */
+import { resolveConfig } from "../config.js";
+import { makeCtx } from "../client.js";
+import { CodebusError } from "../errors.js";
+import { render } from "../output.js";
+/** Resolve the current agent's accountable person slug to use as the default
+ *  actor_login for attention_queue_v1. Falls back to null (the caller must
+ *  supply --login) since a service agent has no person of its own. Mirrors
+ *  whoami.ts's person-resolution shape. */
+export async function resolveActorLogin(ctx) {
+    const { data, error } = await ctx.supabase
+        .from("agents")
+        .select("people!person_id(id,slug)")
+        .eq("slug", ctx.agentSlug)
+        .single();
+    if (error)
+        throw new CodebusError(`unable to resolve actor identity: ${error.message}`);
+    const me = data?.people ?? null;
+    return me?.slug ?? null;
+}
+/** Shared core — calls the attention_queue_v1 RPC (positive fixture: returns
+ *  the named person's items; negative fixture: empty for another login). The
+ *  RPC itself enforces RLS + the actor_login scope, so no extra client-side
+ *  filtering is applied: the projection is authoritative. */
+export async function factoryAttentionCore(ctx, options) {
+    const actorLogin = options.login || (await resolveActorLogin(ctx));
+    if (!actorLogin) {
+        throw new CodebusError("no actor login available — pass --login <github-login-or-slug> (your accountable person)", 2);
+    }
+    const { data, error } = await ctx.supabase.rpc("attention_queue_v1", {
+        p_actor_login: actorLogin,
+    });
+    if (error)
+        throw new CodebusError(`attention_queue_v1 RPC failed: ${error.message}`);
+    const rows = (Array.isArray(data) ? data : []);
+    return rows;
+}
+function attentionHumanRow(item) {
+    const plural = (n) => n === null ? "—" : `${n}s`;
+    const ageLabel = item.age_seconds !== null && item.age_seconds !== undefined
+        ? `${Math.floor(item.age_seconds / 60)}m ${item.age_seconds % 60}s`
+        : "—";
+    return {
+        category: item.category,
+        severity: item.severity,
+        id: item.item_id.slice(0, 8),
+        plan: item.plan_id ? item.plan_id.slice(0, 8) : "—",
+        stage: item.stage_id ?? "—",
+        owner: item.owner_login ?? "—",
+        reason: (item.reason_or_question ?? "—").slice(0, 60),
+        age: ageLabel,
+        deadline: item.deadline
+            ? new Date(item.deadline).toLocaleString("en-US", {
+                month: "short", day: "numeric", hour: "2-digit", minute: "2-digit", timeZoneName: "short",
+            })
+            : "—",
+    };
+}
+const SEVERITY_ORDER = { critical: 0, high: 1, medium: 2, low: 3 };
+async function attentionCmd(login, o, command) {
+    const ctx = await makeCtx(resolveConfig(command.optsWithGlobals()));
+    const items = await factoryAttentionCore(ctx, { login: login ?? "" });
+    if (o.json) {
+        console.log(JSON.stringify(items, null, 2));
+        return;
+    }
+    if (items.length === 0) {
+        console.log("No attention items.");
+        return;
+    }
+    const sorted = [...items].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 9) - (SEVERITY_ORDER[b.severity] ?? 9) || a.category.localeCompare(b.category));
+    console.log(render(sorted.map(attentionHumanRow), { json: false }));
+}
+export function registerFactoryAttention(program, g) {
+    const factory = program.commands.find((c) => c.name() === "factory") ??
+        program.command("factory").description("coding factory intake");
+    g(factory.command("attention")
+        .description("console attention view: items needing a human (0109 attention_queue_v1)")
+        .argument("[login]", "GitHub login or person slug to project attention for (default: your agent's person)"))
+        .option("-j, --json", "render raw JSON rows")
+        .action(attentionCmd);
+}
+//# sourceMappingURL=factory-attention.js.map