agent-conveyor 0.1.17 → 0.1.19

package/README.md

@@ -327,6 +327,11 @@ tmux attach -t codex-live-test
   blockers, approval counts, and the next recommended manager action. This is
   also the supported way to inspect asset receipts and per-slot receipt counts;
   there is no separate `campaign assets` subcommand.
+- `campaign closeout --name C [--failure-mode TEXT] [--json]` —
+  Produce a read-only closeout report from the campaign dashboard, including
+  verdict, worker thread ids, blockers, receipt counts by assignment, proof
+  checks, and the strongest realistic failure mode evidence to carry into a
+  manager/operator handoff.
 
 Creative Ops Campaign manager loop:
 

package/dist/cli/typescript-runtime.d.ts

@@ -25,6 +25,15 @@ interface SpawnedCodexSessionDiscoveryOptions {
 }
 type TypescriptRuntimeOptions = {
     args: readonly string[];
+    campaignReadbackBeforeVerify?: (context: {
+        databasePath: string;
+        readback: {
+            assignment?: string;
+            campaign: string;
+            channel?: string;
+            slot?: string;
+        };
+    }) => void;
     codexCommandResolver?: (name: string) => string | null;
     cwd?: string;
     discoverSpawnedCodexSession?: (options: SpawnedCodexSessionDiscoveryOptions) => SpawnedCodexSessionDiscovery;

package/dist/cli/typescript-runtime.js

@@ -7,7 +7,7 @@ import { fileURLToPath } from "node:url";
 import { taskAuditSync } from "../runtime/audit.js";
 import { appAutopilotPlanSync, appLoopStatusSync, appWakeupDispatchPlanSync, appWakeupPlanSync, directInboxPollCommand, visibleSessionProtocolLines, } from "../runtime/app-autonomy.js";
 import { classifyBusyWait, classifyStartupOutput } from "../runtime/classify.js";
-import { addCampaignWorkerSlotSync, campaignDashboardSync, campaignStatusSync, createCampaignAssignmentSync, createCampaignSync, recordCampaignAssetReceiptSync, updateCampaignWorkerSlotLifecycleSync, upsertCampaignChannelBriefSync, } from "../runtime/campaigns.js";
+import { addCampaignWorkerSlotSync, campaignDashboardSync, campaignSetupReadbackProofSync, campaignStatusSync, createCampaignAssignmentSync, createCampaignSync, recordCampaignAssetReceiptSync, updateCampaignWorkerSlotLifecycleSync, upsertCampaignChannelBriefSync, } from "../runtime/campaigns.js";
 import { exportTaskSync } from "../runtime/export.js";
 import { ingestSessionSync } from "../runtime/ingest.js";
 import { acceptanceCriteriaForTaskSync, loopEvidenceCriterion, recordAdversarialLoopEvidenceSync, recordLoopEvidenceSync, recordVisualDiffLoopEvidenceSync, } from "../runtime/loop-evidence.js";
@@ -402,6 +402,7 @@ function commandHelpText(program, command) {
             `  ${program} campaign asset --name launch --slot campaign-slot-id --assignment campaign-assignment-id --asset-type copy --title "Hooks v2" --allow-additional-receipt --json`,
             `  ${program} campaign status --name launch --json`,
             `  ${program} campaign dashboard --name launch --json`,
+            `  ${program} campaign closeout --name launch --failure-mode "hidden duplicate receipt" --json`,
         ],
         "manager-ack": [
             `usage: ${program} manager-ack <task> --from-stdin ${path}`,
@@ -476,7 +477,7 @@ function commandHelpText(program, command) {
     };
     return linesByCommand[command] ?? [`usage: ${program} ${command} [-h] [options]`];
 }
-const CAMPAIGN_ACTION_NAMES = ["create", "add-slot", "attach-slot", "rotate-slot", "archive-slot", "brief", "assign", "asset", "status", "dashboard"];
+const CAMPAIGN_ACTION_NAMES = ["create", "add-slot", "attach-slot", "rotate-slot", "archive-slot", "brief", "assign", "asset", "status", "dashboard", "closeout"];
 const CAMPAIGN_ACTIONS = new Set(CAMPAIGN_ACTION_NAMES);
 const CAMPAIGN_STRING_FLAGS = {
     "--artifact-path": "artifactPath",
@@ -485,6 +486,7 @@ const CAMPAIGN_STRING_FLAGS = {
     "--brief-json": "briefJson",
     "--channel": "channel",
     "--expected-thread-id": "expectedThreadId",
+    "--failure-mode": "failureMode",
     "--instructions": "instructions",
     "--objective": "objective",
     "--prompt-summary": "promptSummary",
@@ -6094,12 +6096,16 @@ function runCampaignCommand(parsed, options) {
                 name: campaign,
                 objective,
             });
+            const readback = campaignSetupReadbackProofFromConfiguredDatabase(parsed, options, {
+                campaign: campaignId,
+            });
             return campaignResult(parsed, {
                 action,
                 campaign,
                 campaign_id: campaignId,
                 created: true,
-            }, [`campaign ${campaign} created ${campaignId}`]);
+                ledger_readback: readback,
+            }, [`campaign ${campaign} created ${campaignId}`, campaignLedgerReadbackText(readback)]);
         }
         if (action === "add-slot") {
             const slotKey = requiredStringFlag(parsed.flags.slotKey, "--slot-key");
@@ -6117,13 +6123,18 @@ function runCampaignCommand(parsed, options) {
                 slotKey,
                 ...(state ? { state } : {}),
             });
+            const readback = campaignSetupReadbackProofFromConfiguredDatabase(parsed, options, {
+                campaign,
+                slot: slotId,
+            });
             return campaignResult(parsed, {
                 action,
                 campaign,
                 created: true,
+                ledger_readback: readback,
                 slot_id: slotId,
                 slot_key: slotKey,
-            }, [`campaign ${campaign} slot ${slotKey} created ${slotId}`]);
+            }, [`campaign ${campaign} slot ${slotKey} created ${slotId}`, campaignLedgerReadbackText(readback)]);
         }
         if (action === "attach-slot") {
             const slot = requiredStringFlag(parsed.flags.slot, "--slot");
@@ -6192,13 +6203,18 @@ function runCampaignCommand(parsed, options) {
                 campaign,
                 channel,
             });
+            const readback = campaignSetupReadbackProofFromConfiguredDatabase(parsed, options, {
+                campaign,
+                channel,
+            });
             return campaignResult(parsed, {
                 action,
                 brief_id: briefId,
                 campaign,
                 channel,
+                ledger_readback: readback,
                 upserted: true,
-            }, [`campaign ${campaign} brief ${channel} upserted ${briefId}`]);
+            }, [`campaign ${campaign} brief ${channel} upserted ${briefId}`, campaignLedgerReadbackText(readback)]);
         }
         if (action === "assign") {
             const slot = requiredStringFlag(parsed.flags.slot, "--slot");
@@ -6214,13 +6230,19 @@ function runCampaignCommand(parsed, options) {
                 title,
                 ...(status ? { status } : {}),
             });
+            const readback = campaignSetupReadbackProofFromConfiguredDatabase(parsed, options, {
+                assignment: assignmentId,
+                campaign,
+                slot,
+            });
             return campaignResult(parsed, {
                 action,
                 assignment_id: assignmentId,
                 campaign,
                 created: true,
+                ledger_readback: readback,
                 slot_id: slot,
-            }, [`campaign ${campaign} assignment created ${assignmentId}`]);
+            }, [`campaign ${campaign} assignment created ${assignmentId}`, campaignLedgerReadbackText(readback)]);
         }
         if (action === "asset") {
             const slot = requiredStringFlag(parsed.flags.slot, "--slot");
@@ -6258,6 +6280,13 @@ function runCampaignCommand(parsed, options) {
             const dashboard = campaignDashboardSync(database, campaign);
             return campaignResult(parsed, dashboard, renderCampaignDashboardText(dashboard));
         }
+        if (action === "closeout") {
+            const dashboard = campaignDashboardSync(database, campaign);
+            const closeout = campaignCloseoutReport(dashboard, {
+                failureMode: parsed.flags.failureMode,
+            });
+            return campaignResult(parsed, closeout, renderCampaignCloseoutText(closeout));
+        }
         return errorResult(unsupportedCampaignActionMessage(action));
     }
     finally {
@@ -6267,6 +6296,25 @@ function runCampaignCommand(parsed, options) {
 function campaignActionsUsage() {
     return CAMPAIGN_ACTION_NAMES.join("|");
 }
+function campaignSetupReadbackProofFromConfiguredDatabase(parsed, options, readbackOptions) {
+    const databasePath = runtimeDbPath(parsed, options);
+    options.campaignReadbackBeforeVerify?.({ databasePath, readback: readbackOptions });
+    const database = openDatabaseSync(databasePath);
+    initializeDatabaseSync(database);
+    try {
+        return campaignSetupReadbackProofSync(database, readbackOptions);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`campaign ledger readback failed after setup write: ${message}`, { cause: error });
+    }
+    finally {
+        database.close();
+    }
+}
+function campaignLedgerReadbackText(proof) {
+    return `ledger_readback ok campaign=${proof.campaign_id} checks=${proof.checks.map((check) => check.entity).join(",")}`;
+}
 function unsupportedCampaignActionMessage(action) {
     return `Unsupported campaign action: ${action ?? "<missing>"}; expected one of: ${CAMPAIGN_ACTION_NAMES.join(", ")}. Use \`conveyor campaign dashboard --name <campaign> --json\` to list assets and receipt counts.`;
 }
@@ -6342,6 +6390,107 @@ function renderCampaignDashboardText(dashboard) {
     }
     return lines;
 }
+function campaignCloseoutReport(dashboard, options = {}) {
+    const receiptCountsByAssignment = campaignReceiptCountsByAssignment(dashboard);
+    const activeSlots = dashboard.slots.filter((slot) => slot.state !== "archived");
+    const slotsMissingReceipts = activeSlots.filter((slot) => slot.assignments.length > 0 && slot.asset_receipts === 0);
+    const duplicateAssignmentCounts = receiptCountsByAssignment.filter((item) => item.receipt_count > 1);
+    const failureMode = options.failureMode
+        ?? "A hidden duplicate or missing worker receipt could make the campaign look closed while dashboard receipt counts are wrong.";
+    const receiptEvidence = dashboard.slots
+        .map((slot) => `${slot.slot_key}:assignments=${slot.assignments.length},receipts=${slot.asset_receipts}`)
+        .join("; ");
+    return {
+        action: "closeout",
+        approvals: dashboard.approvals,
+        blockers: dashboard.blockers,
+        campaign: dashboard.campaign,
+        failure_mode: {
+            evidence: `dashboard asset_total=${dashboard.summary.asset_total}; assignment_total=${dashboard.summary.assignment_total}; ${receiptEvidence}`,
+            strongest_realistic_failure_mode: failureMode,
+        },
+        next_manager_action: dashboard.next_manager_action,
+        proof_checks: [
+            {
+                check: "dashboard_loaded",
+                evidence: `campaign_id=${dashboard.campaign.id}; updated_at=${dashboard.campaign.updated_at}`,
+                status: "passed",
+            },
+            {
+                check: "blockers_absent",
+                evidence: `blockers=${dashboard.blockers.length}`,
+                status: dashboard.blockers.length === 0 ? "passed" : "failed",
+            },
+            {
+                check: "active_worker_slots_have_receipts",
+                evidence: slotsMissingReceipts.length === 0
+                    ? "all active slots with assignments have at least one receipt"
+                    : `missing_receipt_slots=${slotsMissingReceipts.map((slot) => slot.slot_key).join(",")}`,
+                status: slotsMissingReceipts.length === 0 ? "passed" : "attention",
+            },
+            {
+                check: "assignment_receipt_counts",
+                evidence: duplicateAssignmentCounts.length === 0
+                    ? "no assignment has more than one receipt"
+                    : `additional_receipt_assignments=${duplicateAssignmentCounts.map((item) => `${item.assignment_id}:${item.receipt_count}`).join(",")}`,
+                status: duplicateAssignmentCounts.length === 0 ? "passed" : "attention",
+            },
+            {
+                check: "human_review_gate",
+                evidence: `needs_review=${dashboard.approvals.needs_review}; approved=${dashboard.approvals.approved}; published=${dashboard.approvals.published}`,
+                status: dashboard.approvals.needs_review > 0 && dashboard.approvals.published === 0 ? "passed" : "attention",
+            },
+        ],
+        receipt_counts_by_assignment: receiptCountsByAssignment,
+        summary: dashboard.summary,
+        verdict: campaignCloseoutVerdict(dashboard),
+        workers: dashboard.slots.map((slot) => ({
+            active_assignments: slot.active_assignments,
+            asset_receipts: slot.asset_receipts,
+            blockers: slot.blockers,
+            channel: slot.channel,
+            codex_app_thread_id: slot.codex_app_thread_id,
+            codex_app_thread_title: slot.codex_app_thread_title,
+            lifecycle_state: slot.lifecycle.state,
+            receipt_ids: slot.assets.map((asset) => asset.id),
+            slot_key: slot.slot_key,
+            state: slot.state,
+        })),
+    };
+}
+function campaignReceiptCountsByAssignment(dashboard) {
+    return dashboard.slots.flatMap((slot) => slot.assignments.map((assignment) => ({
+        assignment_id: assignment.id,
+        receipt_count: slot.assets.filter((asset) => asset.assignment_id === assignment.id).length,
+        slot_key: slot.slot_key,
+    })));
+}
+function campaignCloseoutVerdict(dashboard) {
+    if (dashboard.blockers.length > 0 || dashboard.summary.blocked_assignments > 0 || dashboard.summary.blocked_slots > 0 || dashboard.summary.stale_slots > 0) {
+        return "blocked";
+    }
+    if (dashboard.next_manager_action.action === "close_campaign") {
+        return "ready_to_close";
+    }
+    if (dashboard.approvals.needs_review > 0 || dashboard.approvals.rejected > 0) {
+        return "needs_review";
+    }
+    return "needs_work";
+}
+function renderCampaignCloseoutText(report) {
+    return [
+        `campaign ${report.campaign.name} ${report.campaign.status}`,
+        `closeout verdict ${report.verdict}`,
+        `next ${report.next_manager_action.action}: ${report.next_manager_action.reason}`,
+        `summary slots=${report.summary.active_slots}/${report.summary.archived_slots} assignments=${report.summary.assignment_total} assets=${report.summary.asset_total} blockers=${report.blockers.length}`,
+        `approvals needs_review=${report.approvals.needs_review} approved=${report.approvals.approved} rejected=${report.approvals.rejected} published=${report.approvals.published}`,
+        `failure_mode ${report.failure_mode.strongest_realistic_failure_mode}`,
+        `failure_mode_evidence ${report.failure_mode.evidence}`,
+        ...report.proof_checks.map((check) => `proof ${check.status} ${check.check}: ${check.evidence}`),
+        ...report.receipt_counts_by_assignment.map((item) => `assignment_receipts ${item.slot_key} ${item.assignment_id}=${item.receipt_count}`),
+        ...report.workers.slice(0, 8).map((worker) => `worker ${worker.slot_key} ${worker.state}/${worker.lifecycle_state} assignments=${worker.active_assignments} receipts=${worker.asset_receipts} thread=${worker.codex_app_thread_id ?? "none"}`),
+    ];
+}
 function statusCountsText(counts) {
     return Object.entries(counts).map(([status, count]) => `${status}=${count}`).join(" ");
 }