agent-conveyor 0.1.15 → 0.1.17

package/README.md

@@ -315,14 +315,18 @@ tmux attach -t codex-live-test
   Upsert the structured brief for a channel.
 - `campaign assign --name C --slot SLOT_ID --title TEXT --instructions TEXT [--status queued|active|blocked|done|cancelled] [--metadata-json JSON] [--json]` —
   Create a slot-scoped assignment.
-- `campaign asset --name C --slot SLOT_ID --asset-type image|video|hyperframes|copy|audio|other --title TEXT [--assignment ASSIGNMENT_ID] [--channel CH] [--status draft|needs_review|approved|rejected|published] [--prompt-summary TEXT] [--artifact-path PATH] [--metadata-json JSON] [--review-notes TEXT] [--json]` —
-  Record a structured creative asset receipt.
+- `campaign asset --name C --slot SLOT_ID --asset-type image|video|hyperframes|copy|audio|other --title TEXT [--assignment ASSIGNMENT_ID] [--channel CH] [--status draft|needs_review|approved|rejected|published] [--prompt-summary TEXT] [--artifact-path PATH] [--metadata-json JSON] [--review-notes TEXT] [--allow-additional-receipt] [--json]` —
+  Record a structured creative asset receipt. Assignment-scoped receipts are
+  one-per-assignment by default; use `--allow-additional-receipt` only for
+  intentional variants or revisions.
 - `campaign status --name C [--json]` —
   Show campaign metadata, worker slots, channel briefs, assignment counts, and
   asset receipt counts.
 - `campaign dashboard --name C [--json]` —
   Show a manager-oriented campaign aggregate: worker slot lifecycle states,
-  blockers, approval counts, and the next recommended manager action.
+  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.
 
 Creative Ops Campaign manager loop:
 
@@ -606,6 +610,9 @@ stay out of receipts.
   permissions, expected tools, epilogues, evidence gates, cleanup behavior,
   disallowed actions, locked setup summary template, and suggested
   `manager-config` command. Use this before cutting a manager loose.
+  `campaign-duplicate-guard-dogfood` is the recipe for visible creative
+  campaign dogfoods that prove accidental duplicate assignment receipts are
+  rejected unless a worker explicitly uses `--allow-additional-receipt`.
 - `worker-ack <task> --from-stdin|--json [--correlation-id ID]` /
   `manager-ack <task> --from-stdin|--json [--correlation-id ID]` — Persist or
   read the latest structured acknowledgement from the worker or manager. Acks

package/dist/cli/typescript-runtime.js

@@ -384,7 +384,11 @@ function commandHelpText(program, command) {
             `  ${program} finish-task my-task --reason "Accepted criteria satisfied" --require-criteria-audit --path /tmp/work/workerctl.db --json`,
         ],
         campaign: [
-            `usage: ${program} campaign <create|add-slot|attach-slot|rotate-slot|archive-slot|brief|assign|asset|status|dashboard> --name <campaign> [options] ${path} [--json]`,
+            `usage: ${program} campaign <${campaignActionsUsage()}> --name <campaign> [options] ${path} [--json]`,
+            "",
+            `Supported subcommands: ${campaignActionsUsage()}`,
+            "",
+            "Use `dashboard` to list campaign assets and slot receipt counts; there is no separate `assets` subcommand.",
             "",
             "Examples:",
             `  ${program} campaign create --name launch --objective "Create launch assets" --metadata-json '{"owner":"ops"}' --json`,
@@ -395,6 +399,7 @@ function commandHelpText(program, command) {
             `  ${program} campaign brief --name launch --channel tiktok --brief-json '{"format":"9:16"}' --json`,
             `  ${program} campaign assign --name launch --slot campaign-slot-id --title "Draft hooks" --instructions "Create hooks" --status active --json`,
             `  ${program} campaign asset --name launch --slot campaign-slot-id --assignment campaign-assignment-id --asset-type copy --title "Hooks v1" --status needs_review --json`,
+            `  ${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`,
         ],
@@ -471,7 +476,8 @@ function commandHelpText(program, command) {
     };
     return linesByCommand[command] ?? [`usage: ${program} ${command} [-h] [options]`];
 }
-const CAMPAIGN_ACTIONS = new Set(["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"];
+const CAMPAIGN_ACTIONS = new Set(CAMPAIGN_ACTION_NAMES);
 const CAMPAIGN_STRING_FLAGS = {
     "--artifact-path": "artifactPath",
     "--asset-type": "assetType",
@@ -498,6 +504,7 @@ function parseRuntimeArgs(args, env) {
         includeFullTranscripts: false,
         includeTranscripts: false,
         all: false,
+        allowAdditionalReceipt: false,
         action: null,
         artifactPath: null,
         assetType: null,
@@ -767,6 +774,12 @@ function parseRuntimeArgs(args, env) {
         else if (arg === "--all") {
             flags.all = true;
         }
+        else if (arg === "--allow-additional-receipt") {
+            if (command !== "campaign") {
+                return { command, enabled, error: "Unsupported TypeScript runtime option: --allow-additional-receipt", explicit, flags, passthroughArgs, task };
+            }
+            flags.allowAdditionalReceipt = true;
+        }
         else if (arg === "--active") {
             flags.active = true;
         }
@@ -3014,7 +3027,7 @@ function parseRuntimeArgs(args, env) {
         }
         else if (command === "campaign" && flags.action === null) {
             if (!CAMPAIGN_ACTIONS.has(arg)) {
-                return { command, enabled, error: `Unsupported campaign action: ${arg}`, explicit, flags, task };
+                return { command, enabled, error: unsupportedCampaignActionMessage(arg), explicit, flags, task };
             }
             flags.action = arg;
         }
@@ -6216,6 +6229,7 @@ function runCampaignCommand(parsed, options) {
             const status = campaignAssetStatusArg(parsed.flags.statusState);
             const metadata = jsonObjectArg(parsed.flags.metadataJson, "--metadata-json");
             const assetReceiptId = recordCampaignAssetReceiptSync(database, {
+                allowAdditionalReceipt: parsed.flags.allowAdditionalReceipt,
                 artifactPath: parsed.flags.artifactPath,
                 assetType,
                 assignment: parsed.flags.assignment,
@@ -6244,12 +6258,18 @@ function runCampaignCommand(parsed, options) {
             const dashboard = campaignDashboardSync(database, campaign);
             return campaignResult(parsed, dashboard, renderCampaignDashboardText(dashboard));
         }
-        return errorResult(`Unsupported campaign action: ${action}`);
+        return errorResult(unsupportedCampaignActionMessage(action));
     }
     finally {
         database.close();
     }
 }
+function campaignActionsUsage() {
+    return CAMPAIGN_ACTION_NAMES.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.`;
+}
 function campaignResult(parsed, payload, lines) {
     return parsed.flags.json ? jsonResult(payload) : textResult(lines);
 }
@@ -17203,6 +17223,45 @@ const MANAGER_RECIPES = {
         supportPatterns: ["Inbox / No-Tmux App Loop", "Recovery / Resume / Handoff"],
         tools: ["verification.run_tests", "context.fetch_prs"],
     },
+    "campaign-duplicate-guard-dogfood": {
+        acceptance: [
+            "The campaign dashboard shows exactly one normal asset receipt for each active assignment before the duplicate probe.",
+            "A worker visibly attempts an accidental duplicate `campaign asset` receipt without --allow-additional-receipt and records the expected non-zero failure.",
+            "Manager independently verifies the post-probe dashboard still has the original asset_total, the probed slot still has one receipt, and blockers are empty.",
+        ],
+        cleanup: "off by default; archive or rotate only campaign-owned worker slots with exact expected thread ids",
+        description: "Dogfood creative campaign workers while proving assignment-scoped duplicate receipts are blocked unless explicitly allowed.",
+        disallowedActions: [
+            "Do not use --allow-additional-receipt for the accidental duplicate probe.",
+            "Do not treat the worker's duplicate-failure claim as proof until the manager verifies the dashboard.",
+            "Do not publish, schedule, contact external services, inspect private content, edit product/content files, or commit during the dogfood.",
+            "Do not archive or rotate a worker thread unless the campaign slot owns that exact thread id.",
+        ],
+        displayName: "Campaign Duplicate-Guard Dogfood",
+        epilogues: [],
+        evidenceGates: [
+            "campaign_dashboard_pre_probe",
+            "visible_worker_duplicate_failure",
+            "duplicate_failure_exit_code",
+            "post_probe_dashboard_no_extra_asset",
+            "manager_duplicate_guard_decision",
+        ],
+        finalReportRequirements: [
+            "Report the manager thread id, worker thread ids, assignment ids, original receipt ids, duplicate error text, pre/post dashboard counts, and residual cleanup status.",
+        ],
+        guidelines: [
+            "Keep manager and worker sessions visibly chatty with CONVEYOR RECEIVED, WORK, and CONVEYOR SEND sections.",
+            "Use `campaign dashboard --name <campaign> --json` as the supported receipt-listing surface.",
+            "Ask exactly one worker to perform the missing-override duplicate probe, then require manager-side dashboard verification before closeout.",
+        ],
+        loopTemplate: null,
+        mode: "strict",
+        name: "campaign-duplicate-guard-dogfood",
+        objective: "Supervise a visible campaign dogfood that proves duplicate assignment receipts fail closed without --allow-additional-receipt.",
+        permissions: [],
+        supportPatterns: ["Creative Ops Campaign", "Inbox / No-Tmux App Loop", "Recovery / Resume / Handoff"],
+        tools: ["campaign.dashboard", "codex_app.send_message_to_thread"],
+    },
     "nudge-whats-next": {
         acceptance: [
             "Accepted criteria are satisfied or explicitly deferred.",
@@ -17361,6 +17420,10 @@ const MANAGER_RECIPES = {
     },
 };
 const MANAGER_RECIPE_ALIASES = {
+    "campaign duplicate guard": "campaign-duplicate-guard-dogfood",
+    "campaign duplicate guard dogfood": "campaign-duplicate-guard-dogfood",
+    "creative duplicate guard": "campaign-duplicate-guard-dogfood",
+    "duplicate guard dogfood": "campaign-duplicate-guard-dogfood",
     "goalbuddy conveyor": "goalbuddy-conveyor",
     goalbuddy: "goalbuddy-conveyor",
     "nudge / what's next manager": "nudge-whats-next",