@sellable/install 0.1.247 → 0.1.248

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sellable/install",
3
- "version": "0.1.247",
3
+ "version": "0.1.248",
4
4
  "type": "module",
5
5
  "description": "One-command installer for Sellable MCP in Claude Code and Codex",
6
6
  "bin": {
@@ -123,7 +123,6 @@ such as "fill campaigns", "fill up", "refill sends", "max out sends", or
123
123
  ```text
124
124
  get_subskill_prompt({ subskillName: "refill-sends-workflow" })
125
125
  resolve_campaign_fill_route({ intent:"plain" })
126
- list_senders
127
126
  get_campaign_refill_state
128
127
  ```
129
128
 
@@ -134,20 +133,15 @@ campaign refill. Route outcomes are `route:"evergreen_horizon"`,
134
133
  returns `route:"ask_create"`, ask whether to create a normal campaign or
135
134
  evergreen campaigns. Campaign creation is allowed only after this route and
136
135
  explicit user selection; it is never the default response to plain fill. When
137
- choosing among active targets, use refill-state scheduled-count evidence to
138
- continue the campaign that most recently had scheduler-owned sends for the
139
- relevant sender set; do not treat every active campaign as a refill candidate.
140
- When more leads are needed, the refill workflow must recommend same-campaign
141
- source-ladder replenishment first; do not create warm-post-engager side
142
- campaigns, on-demand campaigns, or unrelated campaigns. Surface sender-health
143
- blockers separately from prepared/approved/scheduled counts.
136
+ more leads are needed, the refill workflow must recommend same-campaign
137
+ source-ladder replenishment; do not create warm-post-engager side campaigns,
138
+ on-demand campaigns, or unrelated campaigns. Surface sender-health blockers
139
+ separately from prepared/approved/scheduled counts.
144
140
 
145
141
  Treat active fills as capacity-fill preparation: calculate the bounded target
146
142
  from sender capacity when needed, then use the refill workflow to decide source
147
- replenishment, enrichment/prep, approval policy, and scheduler proof. Present
148
- operator decisions by campaign name and sender name first, with campaign/table
149
- ids as proof only. Mutation requires exact visible approval and a fresh
150
- `get_campaign_refill_state` reread.
143
+ replenishment, enrichment/prep, approval policy, and scheduler proof. Mutation
144
+ requires exact visible approval and a fresh `get_campaign_refill_state` reread.
151
145
  For already-running regular campaigns that need Signal Discovery source
152
146
  replenishment, the refill workflow owns the guarded recovery: clear
153
147
  `currentStep` only with `clearCurrentStepIfMatches:"running"`, load the
@@ -58,6 +58,22 @@ Default evergreen plan per workspace (override only if the prompt specifies diff
58
58
  1. **`<Sender Name> - Post Engagers`** — one per sender (warm lane, highest priority)
59
59
  2. **`<Workspace/Team> - Shared Signal Discovery`** — one shared warm-signal campaign lane across senders
60
60
  3. **`<Workspace/Team> - Shared Cold Fallback`** — one shared cold/fallback campaign lane across senders
61
+
62
+ Sender scope resolution is safety-critical. Do not pass
63
+ `allConnectedSenders:true` unless the invoking prompt explicitly says "all
64
+ connected senders", "every connected sender", "all seats", or names an
65
+ equivalent all-sender scope. If the user says "all 4 campaigns", "the four
66
+ evergreen campaigns", or names specific senders, resolve those exact senders
67
+ and pass explicit `postEngagerSenderIds` plus `sharedSenderIds`; do not broaden
68
+ the plan to every connected sender. In non-interactive or `--yolo` mode, when
69
+ more than two connected senders exist and the prompt does not explicitly
70
+ authorize all connected senders, stop before mutation with
71
+ `blocked: ambiguous_post_engager_sender_scope` and report the sender ids/names
72
+ needed for approval. Never let "workspace default" silently create Post
73
+ Engagers lanes for extra senders.
74
+ Short form: Do not pass `allConnectedSenders:true` unless the prompt explicitly says all/every connected sender.
75
+ Short form: "all 4 campaigns" means explicit sender scope plus two shared lanes, not all connected senders.
76
+ Short form: In `--yolo`, ambiguous multi-sender scope blocks before mutation.
61
77
  </inputs>
62
78
 
63
79
  <command_backed_workflow>
@@ -215,7 +231,8 @@ After bounded delegated approval or safe `--yolo`, fan out lane worker tasks
215
231
  only from the current plan. Each worker receives the complete lane packet:
216
232
  workspace id, sender ids, lane key/type, existing campaign/table binding or
217
233
  create intent, source hints, caps, planRevision, actionId, allowed side effects,
218
- postconditions, and the packet's `workerDispatch` policy. Treat
234
+ postconditions, the parent `postEngagerSenderIds`, the parent
235
+ `sharedSenderIds`, and the packet's `workerDispatch` policy. Treat
219
236
  `workerDispatch.requiresVisibleThreadOrDurableReceipt:true` as a hard
220
237
  execution boundary, not guidance. Read and preserve `workerDispatch.acceptedRuntimes`,
221
238
  `workerDispatch.rejectedRuntimes`, and `workerDispatch.receiptArtifactHint`
@@ -234,6 +251,15 @@ parent packet, do not mutate and do not use it as `setupPlanCall` proof; stop
234
251
  with `blocked: worker_plan_scope_drift` and ask the parent to re-plan.
235
252
  Short form: If a worker-local plan omits `postEngagerSenderIds:[]`, do not use it as `setupPlanCall` proof.
236
253
  Short form: stop with `blocked: worker_plan_scope_drift`.
254
+ Every worker prompt must include both parent scope arrays as explicit fields:
255
+ `Parent postEngagerSenderIds:` and `Parent sharedSenderIds:`. Workers must
256
+ preserve parent postEngagerSenderIds even for shared lanes. Never run a
257
+ shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent
258
+ `postEngagerSenderIds` is exactly `[]`. Every durable receipt must copy these
259
+ arrays to top-level `parentPostEngagerSenderIds` and `parentSharedSenderIds`
260
+ before completion.
261
+ Short form: Workers must preserve parent postEngagerSenderIds even for shared lanes.
262
+ Short form: Never run a shared-lane worker-local plan with `postEngagerSenderIds:[]` unless the parent `postEngagerSenderIds` is exactly `[]`.
237
263
 
238
264
  Worker fan-out must use visible or durable execution. Preferred in local Codex
239
265
  is a visible Codex thread created with the actual Codex app thread tools:
@@ -264,10 +290,36 @@ CLI builds that expose `-a`/`-s` only at top level. Do not use
264
290
  forms fail on current customer CLI installs. Pipe the lane packet prompt on
265
291
  stdin, require the worker to write `workerDispatch.receiptArtifactHint`, and
266
292
  pass exactly one lane packet per worker.
293
+ When wrapping multiple local Codex CLI workers in a shell launcher, run the
294
+ wrapper with `/bin/bash -lc` or another explicitly chosen portable shell. Do not
295
+ rely on zsh-specific behavior. Do not use `status` as a shell variable because
296
+ zsh treats it as read-only; use `exit_code` or `rc` instead. Receipt polling
297
+ must use `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print` or an
298
+ explicit nullglob-safe equivalent. Do not use naked `*.json` globs under zsh,
299
+ and keep zero-receipt polls quiet with no `no matches found` diagnostics.
300
+ Do not embed `<<'WORKER_PROMPT'` heredocs inside a single quoted or double
301
+ quoted `/bin/bash -lc '...'` command string; nested quoting is brittle and can
302
+ truncate the first worker before mutation. For multi-worker launchers, write one
303
+ plain prompt file per lane under the current run directory, then start each
304
+ worker with `codex -a never -s danger-full-access exec -C "$REPO" -o
305
+ "$worker_final_file" - < "$worker_prompt_file"`. Keep launcher shell variables
306
+ double-quoted and keep the prompt heredoc only in a standalone script/prompt-file
307
+ write step, not inside an already quoted shell argument. If the first launcher
308
+ attempt exits with a shell parse error or before starting the first worker,
309
+ stop with `blocked: worker_launcher_quoting_failed` and do not retry by
310
+ loosening sender scope or mutating in the parent.
311
+ Short form: run the wrapper with `/bin/bash -lc`.
312
+ Short form: Do not rely on zsh-specific behavior.
313
+ Short form: Do not use `status` as a shell variable; use `exit_code` or `rc`.
314
+ Short form: Receipt polling uses `find <receipt-dir> -maxdepth 1 -name 'evg_*.json' -print`.
315
+ Short form: Do not use naked `*.json` globs under zsh; no `no matches found` diagnostics.
316
+ Short form: Do not embed `<<'WORKER_PROMPT'` heredocs inside a quoted `/bin/bash -lc` command string.
317
+ Short form: Multi-worker launchers write prompt files and run `codex ... - < "$worker_prompt_file"`.
267
318
  After creating receipt directories, dispatch workers immediately; do not perform extended parent reasoning, extra inventory, or prompt rewriting loops.
268
319
  Use a compact worker prompt: include lane packet JSON, original selectedActionIds,
269
- original planRevision, receiptArtifactPath, workspace id, sender ids,
270
- side-effect caps, and the instruction to load packaged prompts through MCP.
320
+ original planRevision, parent postEngagerSenderIds, parent sharedSenderIds,
321
+ receiptArtifactPath, workspace id, sender ids, side-effect caps, and the
322
+ instruction to load packaged prompts through MCP.
271
323
  Do not paste the entire wrapper skill into worker prompts. If the parent cannot
272
324
  launch at least one visible/durable worker immediately after directory setup,
273
325
  stop with `blocked: worker_dispatch_stalled` before any mutation.
@@ -276,8 +328,11 @@ current lane packet for receipt paths.
276
328
  Do not hardcode machine-specific paths, workspace ids, campaign ids, sender ids, or UAT/phase artifact paths in this MCP prompt or any worker prompt.
277
329
  After the receipt-directory `mkdir`, the next shell/tool call must launch the first lane worker.
278
330
  Do not run `find`, `ls`, extra inventory, or another preflight between directory setup and the first worker launch.
279
- For the local Codex CLI fallback, use this literal durable CLI worker launch template
280
- and fill only the lane-specific placeholders:
331
+ For the local Codex CLI fallback, use this literal durable CLI worker launch
332
+ template and fill only the lane-specific placeholders. For one-off direct worker
333
+ launches you may pipe a heredoc directly to `codex`; for multi-worker shell
334
+ launchers, write the same prompt body to `<worker-prompt-file>` and launch the
335
+ worker with stdin redirected from that file:
281
336
 
282
337
  ```
283
338
  codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - <<'WORKER_PROMPT'
@@ -286,6 +341,8 @@ Use $sellable:create-evergreen-campaigns as the governing skill for this one lan
286
341
  Workspace id: <workspaceId>
287
342
  Parent planRevision: <planRevision>
288
343
  Parent selectedActionIds: <selectedActionIds JSON>
344
+ Parent postEngagerSenderIds: <postEngagerSenderIds JSON>
345
+ Parent sharedSenderIds: <sharedSenderIds JSON>
289
346
  Action id: <actionId>
290
347
  Lane key: <laneKey>
291
348
  Allowed side effects: <allowedSideEffects JSON>
@@ -299,6 +356,9 @@ Use mcp__sellable only. Do not use admin tools, direct DB, Prisma, SQL, web sear
299
356
  Do not launch, start, schedule, send, or use paid InMail.
300
357
  Complete only this lane, write the required durable receipt JSON, and stop.
301
358
  WORKER_PROMPT
359
+
360
+ # Multi-worker launcher equivalent:
361
+ codex -a never -s danger-full-access exec -C <repo> -o <worker-final-file> - < <worker-prompt-file>
302
362
  ```
303
363
 
304
364
  If any placeholder cannot be filled from the current lane packet, do not inspect
@@ -368,7 +428,14 @@ not a parent-thread summary. The receipt must include:
368
428
  `senderIds`, `campaignId`, `tableId`, and `createIntent`. Do not use
369
429
  `laneActionId`, `lanePacketActionId`, `delegatedPlanRevision`,
370
430
  `delegatedActionId`, or freeform `requestedCall` text as a substitute for
371
- these fields.
431
+ these fields. For create lanes, `setupPlanCall.campaignId` and
432
+ `setupPlanCall.tableId` must be the actual created campaign/table ids after
433
+ creation and readback. If the parent lane packet carried null ids before
434
+ creation, preserve that original packet only in a separate `parentLanePacket`
435
+ object; do not leave `setupPlanCall.campaignId:null` or
436
+ `setupPlanCall.tableId:null`.
437
+ Short form: For create lanes, `setupPlanCall.campaignId` and `setupPlanCall.tableId` must be the actual created campaign/table ids.
438
+ Short form: Do not leave `setupPlanCall.campaignId:null` or `setupPlanCall.tableId:null`.
372
439
  - `createCampaignWorkflowReceipt`: proof the worker loaded the actual installed
373
440
  `$sellable:create-campaign` wrapper instead of doing ad hoc MCP calls. It must
374
441
  include `skillCommand:"$sellable:create-campaign"`,
@@ -423,8 +490,25 @@ not a parent-thread summary. The receipt must include:
423
490
  evidence field such as `rowCount`, `rowIdsHash`, or `rowEvidence`; do not
424
491
  leave those only in `searchSignalsProof`, `importProof`, `coldFallbackProof`,
425
492
  or narrative text for the parent/verifier to infer.
426
- - `filterDecisionReceipt`: saved/applied filter ids or explicit skip-filter
427
- decision with current campaign/table basis.
493
+ - `filterDecisionReceipt`: saved/applied ICP filter proof for the current
494
+ campaign/table basis. Customer-visible evergreen lanes must enable ICP
495
+ filtering with `enableICPFilters:true`, call `save_rubrics`, and save at
496
+ least three rubric/filter criteria before Message Drafting. Do not skip
497
+ filtering for evergreen setup. Missing or skipped filter proof is
498
+ `blocked: missing_filter_setup`.
499
+ Before the worker exits, the durable JSON must contain
500
+ `filterDecisionReceipt.status:"applied"`,
501
+ `filterDecisionReceipt.enableICPFilters:true`, the current
502
+ `workflowTableId`, and concrete saved-filter proof such as
503
+ `filterDecisionReceipt.filterIds`, `filterDecisionReceipt.rubricIds`,
504
+ `filterDecisionReceipt.savedRubricCount`, or
505
+ `filterDecisionReceipt.headlineICPCriteria`.
506
+ The exact status string is contractual: use `status:"applied"` only.
507
+ Do not write `status:"confirmed"`, `status:"saved"`, `status:"done"`, or
508
+ any other alias after saving filters; the parent verifier rejects those
509
+ aliases even when saved rubric proof exists.
510
+ Short form: Filter receipt status must be exactly `applied`.
511
+ Short form: Do not write `filterDecisionReceipt.status:"confirmed"`.
428
512
  - `messageDraftingReceipt`: the Message Drafting proof described below,
429
513
  including packaged `generate-messages` prompt/assets and validation. Raw
430
514
  fields like `generateMessagesPromptLoadedToHasMoreFalse`,
@@ -560,7 +644,12 @@ verification unless the same object also appears inside
560
644
  "sourceLadderReason": "<why the current source is valid before colder sources>"
561
645
  },
562
646
  "filterDecisionReceipt": {
563
- "status": "skipped",
647
+ "status": "applied",
648
+ "enableICPFilters": true,
649
+ "filterIds": ["<saved filter/rubric id>"],
650
+ "rubricIds": ["<saved rubric id>"],
651
+ "headlineICPCriteria": ["<saved ICP criterion>", "<saved ICP criterion>", "<saved ICP criterion>"],
652
+ "savedRubricCount": 3,
564
653
  "workflowTableId": "<workflow table id>"
565
654
  },
566
655
  "messageDraftingReceipt": {
@@ -641,6 +730,19 @@ path itself in the worker thread:
641
730
  exactly one semantic Approved cell through `select_campaign_cells` and
642
731
  `update_cell`.
643
732
  Approval shorthand: approve exactly one semantic Approved cell.
733
+ In this message-drafting path, `update_cell` is allowed only for the semantic
734
+ Approved checkbox. Do not use `update_cell` or any row/cell write to edit
735
+ generated message text, sample copy, or final message bodies in automation.
736
+ If generated copy fails review, update the campaign brief/message template
737
+ with `update_campaign_brief` or `revise_message_template_and_rerun`, then
738
+ rerun Generate Message and review current-revision generated output. Receipt
739
+ `sampleMessages` must come from generated current-revision cells after the
740
+ brief/template rerun, not from hand-edited message cell overrides. If a lane
741
+ used a generated-message body override, report
742
+ `blocked: generated_message_cell_override` instead of success.
743
+ Short form: `update_cell` is allowed only for the semantic Approved checkbox.
744
+ Short form: Do not use `update_cell` to edit generated message text.
745
+ Short form: Bad copy requires brief/template revision plus Generate Message rerun.
644
746
  4. Poll `get_campaign_message_preparation_status` until no queued/active cells
645
747
  remain or a bounded stop reason is returned.
646
748
  5. Use `get_campaign_messages_preview` or `select_campaign_cells` to inspect
@@ -667,6 +769,26 @@ The only accepted statusSource values are exactly `branch` and
667
769
  `packaged-generate-messages-worker`; descriptive aliases such as
668
770
  `package-readback-local-thread` are rejected.
669
771
 
772
+ Before any provider-specific source mutation for a newly created campaign,
773
+ reread `get_campaign_navigation_state({ campaignId })` and use that product
774
+ navigation state as the source-step authority. Do not jump from a shell directly
775
+ into `contact-search`, and do not jump from a shell directly into
776
+ `signal-discovery`. Advance through the product-visible source-selection step
777
+ first, then load the provider prompt and write only the provider/source fields
778
+ accepted for that current step. Never include sender reassignment fields in
779
+ source-step updates, never include custom narration fields in source-step
780
+ updates, and do not use guessed `currentStep` or watched narration payloads to
781
+ force the flow forward. If `update_campaign` rejects the source transition
782
+ twice, reread navigation/campaign state once; if the campaign is not already on
783
+ the intended source step, stop the lane with
784
+ `blocked: watched_source_transition_blocked` and include the rejected tool
785
+ result plus the readback. Do not loop on rejected `update_campaign` transitions.
786
+ Short form: do not jump from a shell directly into `contact-search`.
787
+ Short form: do not jump from a shell directly into `signal-discovery`.
788
+ Short form: never include sender reassignment fields in source-step updates.
789
+ Short form: never include custom narration fields in source-step updates.
790
+ Short form: do not loop on rejected `update_campaign` transitions.
791
+
670
792
  One lane may produce exactly one CampaignOffer/campaign id and one current
671
793
  workflow table id. For `intent:"create"`, the first successful
672
794
  `create_campaign` result establishes the lane's only allowed campaign/table
@@ -705,9 +827,14 @@ the prospect's engagement unless the selected source evidence proves that exact
705
827
  sender authored the post.
706
828
  Shared lanes must reject generic product-summary samples that explain the
707
829
  product in the same broad words for every row. Shared lanes must reject three
708
- nearly identical samples after stripping the leading name. If either failure
709
- appears, revise or rerun the packaged create-campaign/generate-messages path
710
- from the lane worker before writing a success receipt.
830
+ nearly identical samples after stripping the leading name. Shared lanes must
831
+ fail quality review when any reviewed sample has non-empty `issues`; do not
832
+ approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
833
+ If any of these failures appears, revise or rerun the packaged
834
+ create-campaign/generate-messages path from the lane worker before writing a
835
+ success receipt.
836
+ Short form: Shared lanes must fail quality review when any reviewed sample has non-empty `issues`.
837
+ Short form: Do not approve or final-report samples with `verdict:"passed"` and non-empty `issues`.
711
838
  The generated-message cells are not prompt proof: `currentRevisionGeneratedMessages`,
712
839
  Generate Message column counts, `messagesCount`, or rendered row previews prove
713
840
  only that table cells exist from the current brief/template, not that the
@@ -727,6 +854,22 @@ duplicate-lane blockers before you call the command finished. If verify blocks,
727
854
  report the blocker and repair only the missing postconditions from the same
728
855
  current plan.
729
856
 
857
+ Before calling verify, the parent should build compact receipt objects from the
858
+ durable receipt files and pass those compact objects to MCP. The compact receipt
859
+ must preserve every verifier-owned field named above, including top-level ids,
860
+ `createCampaignStepReceipt`, canonical filter/message/review/sequence/final
861
+ proof, and at least three concrete sample messages. It should omit large raw
862
+ search outputs, long post lists, full row arrays, raw provider responses, and
863
+ debug-only narration fields. Do not pass multi-hundred-kilobyte raw receipt
864
+ objects when a compact canonical receipt has the same proof; large raw verify
865
+ payloads can stall local MCP bridges and make UAT ambiguous.
866
+ Do not print or `jq .` full receipt JSON into the terminal. For local checks,
867
+ print only compact summaries such as file, actionId, laneKey, campaignId,
868
+ filter status, sample count, approved count, and final status.
869
+ Short form: Parent verify uses compact canonical receipt objects, not raw giant receipts.
870
+ Short form: Do not dump full receipt JSON with `jq .`.
871
+ Short form: Never change planRevision/actionId/laneKey while compacting receipts.
872
+
730
873
  Message proof for every customer-visible lane must come from the current
731
874
  campaign/table basis and include at least 3 generated review rows from the
732
875
  packaged `generate-messages` path before completion is reported.
@@ -765,6 +908,8 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
765
908
  Short form: Do not pass the warm template into Shared Signal Discovery or Shared Cold Fallback.
766
909
  Short form: Shared lanes must reject generic product-summary samples.
767
910
  Short form: Shared lanes must reject three nearly identical samples.
911
+ Short form: Shared lanes must reject low-confidence relevance hedges.
912
+ Short form: Shared lanes must reject internal workflow vocabulary.
768
913
  Short form: revise or rerun the packaged create-campaign/generate-messages path.
769
914
  - **Post Engagers** first-message style: short, casual, references the
770
915
  sender-authored post they engaged with, closed question, **no internal
@@ -775,7 +920,7 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
775
920
 
776
921
  Hey there
777
922
 
778
- Thanks for the support on my post about {{post_topic_line}}
923
+ Thank you for the support on my post about {{post_topic_line}}
779
924
  ```
780
925
 
781
926
  - **Shared Signal Discovery** first-message style: short, casual, references
@@ -791,6 +936,22 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
791
936
  say it. Prefer sender-agnostic company/team language such as "we're
792
937
  helping CX teams..." or "at cxconnect.ai, we help..." and one clear
793
938
  problem question.
939
+ Before Message Drafting runs, the campaign brief must already include
940
+ these shared-lane hard avoids and source-use rules. Do not rely on a
941
+ failed first generation batch to discover that self-intros, generic
942
+ product summaries, or repeated structure are bad. If the first generated
943
+ batch violates these rules, rerun, but record that as a repaired UAT path
944
+ rather than the desired zero-shot path.
945
+ Do not use low-confidence relevance hedges such as "hope this is
946
+ relevant" in Shared Signal Discovery samples. Translate source/tool terms
947
+ into prospect-facing business language; do not put internal workflow
948
+ vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or
949
+ "Claude-style agent workflows" in customer-facing message one.
950
+ Short form: Shared Signal Discovery uses no self-intro such as "I'm building Sellable".
951
+ Short form: Shared Signal Discovery uses no self-intro such as "We're building Sellable".
952
+ Short form: Shared Signal Discovery uses no "I've put together".
953
+ Short form: no low-confidence relevance hedge such as "hope this is relevant".
954
+ Short form: no internal workflow vocabulary such as "Codex-style workflow", "MCP", "agent workflows", or "Claude-style agent workflows".
794
955
  - **Shared Cold Fallback** first-message style: cold, direct, and cohesive.
795
956
  It must not pretend there was engagement, must not say "saw you pop up",
796
957
  and must not use a standalone name line followed by "Hey there" or other
@@ -805,14 +966,52 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
805
966
  Sellable/Codex/Claude-Code feature summary
806
967
  across prospects. This is a single-message cold path unless the approved
807
968
  create-campaign message workflow proves a better delivery format.
969
+ Do not open with "hope this is relevant" or a similar low-confidence
970
+ relevance hedge. Do not use a repeated product-definition paragraph such
971
+ as "Sellable is a GTM system" across samples; every reviewed cold sample
972
+ should be specific enough to the role, company, or problem that the three
973
+ sample messages do not share the same body skeleton.
974
+ Before Message Drafting runs, the campaign brief must already forbid
975
+ self-intros, generic product summaries, opt-out shrugs, product-stack
976
+ dumps, and repeated template structure. Do not let the first generation
977
+ batch use "I'm building", "We're building", "I've put together", or
978
+ similar language and then rely on a cleanup rerun as the normal path.
808
979
  Short form: Shared Cold Fallback must not pass just because the receipt says `generate-messages` loaded.
809
980
  Short form: Shared Cold Fallback uses no self-intro such as "We're building".
981
+ Short form: Shared Cold Fallback uses no self-intro such as "I'm building Sellable".
982
+ Short form: Shared Cold Fallback uses no "I've put together".
810
983
  Short form: Shared Cold Fallback uses no opt-out shrug such as "If this isn't relevant, ignore me".
811
984
  Short form: Shared Cold Fallback uses no product-stack dump.
812
- - Every customer-visible lane must run Message Drafting from the current
813
- campaign/table basis after source rows exist. The worker must load the full
814
- packaged `generate-messages` prompt, every required asset, and
815
- `create-campaign-v2-validation`; if the internal branch handoff is not
985
+ Short form: no low-confidence relevance hedge such as "hope this is relevant".
986
+ Short form: no repeated product-definition paragraph such as "Sellable is a GTM system".
987
+ - Customer-visible evergreen lanes must enable ICP filtering before Message
988
+ Drafting. This applies to Post Engagers, Shared Signal Discovery, and
989
+ Shared Cold Fallback. Do not skip filtering for evergreen setup, even when
990
+ the source is warm. Use the normal `$sellable:create-campaign` filter
991
+ workflow: set or save 3-5 headline ICP criteria, call `save_rubrics`, and
992
+ persist `enableICPFilters:true` on the campaign before generating
993
+ messages. Good evergreen filters should be light but real: role/budget
994
+ relevance, company/market fit, and obvious non-buyer exclusion. For
995
+ Post Engagers, keep filters permissive enough that warm source rows are not
996
+ over-pruned, but still save the filter rules. For shared lanes, filter for
997
+ buyers/operators relevant to the workspace offer and exclude students,
998
+ job seekers, vendors, and off-topic commenters. The receipt must show
999
+ `filterDecisionReceipt.status:"applied"`,
1000
+ `filterDecisionReceipt.enableICPFilters:true`, current `workflowTableId`,
1001
+ and saved filter/rubric proof with at least three saved rubric/filter
1002
+ criteria (`filterIds`, `rubricIds`, `headlineICPCriteria`, or
1003
+ `savedRubricCount`). Missing or skipped filter proof is
1004
+ `blocked: missing_filter_setup`.
1005
+ Short form: Customer-visible evergreen lanes must enable ICP filtering.
1006
+ Short form: `enableICPFilters:true`.
1007
+ Short form: Do not skip filtering for evergreen setup.
1008
+ Short form: at least three saved rubric/filter criteria.
1009
+ Short form: missing or skipped filter proof is `blocked: missing_filter_setup`.
1010
+ Short form: run Message Drafting only after saved filters are applied.
1011
+ - Every customer-visible lane must run Message Drafting from the current
1012
+ campaign/table basis after source rows exist. The worker must load the full
1013
+ packaged `generate-messages` prompt, every required asset, and
1014
+ `create-campaign-v2-validation`; if the internal branch handoff is not
816
1015
  callable in the packaged runtime, the worker must call
817
1016
  `start_campaign_message_preparation` and poll
818
1017
  `get_campaign_message_preparation_status` from the lane worker. The
@@ -842,10 +1041,13 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
842
1041
  - A source/list decision has been resolved and campaign rows are loaded. If
843
1042
  there is no approved source or no rows can be copied, report `blocked` with
844
1043
  the missing source detail; do not call the campaign complete.
845
- - The filter step is resolved: either saved/applied filters are present, or
846
- the campaign explicitly skipped filters. Do not leave customer-visible
847
- campaigns at `filter-choice`, `filter-rules`, or `apply-icp-rubric` and
848
- report success.
1044
+ - The filter step is resolved with saved/applied filters. Customer-visible
1045
+ evergreen lanes must have `enableICPFilters:true`, at least three saved
1046
+ ICP filter/rubric criteria, and a receipt with
1047
+ `filterDecisionReceipt.status:"applied"`. Do not skip filters for
1048
+ evergreen setup. Do not leave customer-visible campaigns at
1049
+ `filter-choice`, `filter-rules`, or `apply-icp-rubric` and report success.
1050
+ Do not proceed to Message Drafting until saved filters are applied.
849
1051
  - Message Drafting has run from the current campaign/table basis, using the
850
1052
  create-campaign message prompt/assets and validation gate. Updating
851
1053
  `currentStep:"messages"` is not proof. Parent-thread handwritten copy is
@@ -864,13 +1066,17 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
864
1066
  reviewed sample messages. For Shared Cold Fallback, reject samples that
865
1067
  open with a standalone name followed by "Hey there" or a similarly generic
866
1068
  greeting. For Shared Cold Fallback, also reject samples with a self-intro
867
- such as "We're building", an opt-out shrug such as "If this isn't
868
- relevant, ignore me", or a product-stack dump that repeats the same
1069
+ such as "We're building", "I'm building Sellable", or "I've put
1070
+ together", an opt-out shrug such as "If this isn't relevant, ignore me",
1071
+ or a product-stack dump that repeats the same
869
1072
  Sellable/Codex/Claude-Code feature summary across prospects. For all
870
1073
  shared lanes, reject generic product-summary samples, repeated
871
- near-identical samples, and any preserved Post Engagers opener; revise or
872
- rerun the packaged create-campaign/generate-messages path before reporting
873
- completion.
1074
+ near-identical samples, low-confidence relevance hedges such as "hope this
1075
+ is relevant", internal workflow vocabulary, any sample with non-empty
1076
+ `issues`, and any preserved Post Engagers opener; revise or rerun the packaged
1077
+ create-campaign/generate-messages path before reporting completion. Do not
1078
+ approve or final-report samples with `verdict:"passed"` and non-empty
1079
+ `issues`.
874
1080
  - The first review batch exists and at least 3 review rows have generated
875
1081
  messages from the approved brief. If fewer than 3 usable rows exist, report
876
1082
  the actual count and why.
@@ -944,7 +1150,9 @@ Parent-thread handwritten copy or setting `currentStep` is not proof.
944
1150
  **Also confirm the delivery format and keep config in sync.** Ask the user whether DM lanes should send multiline (paragraph-per-message) or as a single message. Record the answer as the brief's `Delivery format:` line, and when multiline is chosen, set `actionConfig.sendEachParagraphAsMessage: true` on that campaign's `send_dm` column via `update_column` (config edits run no cells and nothing sends from unlaunched campaigns). Never set the paragraph-split flag on InMail columns — the option does not apply to InMail.
945
1151
  6. **Interactive polish mode only: prove the template on one real row.** For ONE campaign that has at least one lead row (add one via `add_on_demand_leads` if every lane is empty and the user provides/approves a test lead), generate a message for exactly one row (`queue_campaign_cells` with `columnRole: "generateMessage"`, `rowSelector: { type: "reviewBatch", limit: 1 }` or the single row's ID), wait for it, then show the user the generated message next to the template — AND show how it would split if paragraph-per-message sending is enabled (list each paragraph as `msg 1:`, `msg 2:`, …) so the user confirms each one reads like a real typed message. Check alignment: tone, structure, no internal vocabulary, correct token substitution, no letter punctuation. Do NOT approve the row or generate for more rows — one sample only.
946
1152
  7. **Automation mode template/config audit**: inspect existing send-lane briefs for a `Delivery format:` line and chat-native warm template. If a send lane is missing the line and the prompt allows cleanup, update only the campaign brief metadata with the safest default for that lane (`Delivery format: single message (LinkedIn DM; line breaks remain inside one generated message; no follow-up until reply)`). If cleanup is not allowed, flag it. Do not generate a sample row in automation mode unless the invocation explicitly asks for sample proof. In structure-only automation, do not generate a sample row unless the invocation explicitly asks for sample proof. In customer-visible completion, follow the Customer-Visible Completion Contract instead.
947
- 8. **Report the reconcile plan and result** every slot tagged `reused`, `created`, `repaired`, `flagged`, or `blocked`, plus template/sample details only when that mode ran:
1153
+ 8. **Final customer-facing completion must include sample messaging**: after customer-visible verify and the idempotency rerun pass, add a `Sample Messaging Review` section to the final answer. For every completed lane, show at least one full generated first message for every completed lane with campaign name, campaign id, row id, and verdict. Extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages`, not from top-level summaries; extract samples from nested `createCampaignStepReceipt.messageDraftingReceipt.sampleMessages` when building the final answer. Prefer the approved route-proof row when it is quality-valid; otherwise use the best reviewed generated row from the verified receipt. A final `passed` sample must have `issues:[]`; if every reviewed sample has issues, report the lane as needing message revision instead of presenting a passed sample. Do not summarize the sample into a copy theme. Show the actual message text so the user can inspect tone and specificity. If any sample is not quite right, tell the user they can ask the AI to update the campaign brief/message template and rerun Generate Message before launch. Never suggest launching, scheduling, or sending as the next step from this command.
1154
+ If the `Sample Messaging Review` section is omitted, the command is incomplete even when the structural campaign setup succeeded.
1155
+ 9. **Report the reconcile plan and result** — every slot tagged `reused`, `created`, `repaired`, `flagged`, or `blocked`, plus template/sample details only when that mode ran:
948
1156
 
949
1157
  ```
950
1158
  Evergreen Reconcile — {date}
@@ -953,6 +1161,17 @@ Evergreen Reconcile — {date}
953
1161
  • Sellable.dev - Shared Signal Discovery: repaired (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
954
1162
  • Sellable.dev - Shared Cold Fallback: created (send review ready; 50 rows, 3 generated, 1 approved gate row, sequence attached, paused)
955
1163
  All campaigns remain unlaunched. Next: enrich/approve more rows when you want more items ready to schedule.
1164
+
1165
+ Sample Messaging Review
1166
+ • Christian Reyes - Post Engagers (`cmp_...`, row `row_...`, verdict: passed)
1167
+ ```
1168
+ {{full generated first message}}
1169
+ ```
1170
+ • Sellable.dev - Shared Cold Fallback (`cmp_...`, row `row_...`, verdict: passed)
1171
+ ```
1172
+ {{full generated first message}}
1173
+ ```
1174
+ If any sample is not quite right, ask the AI to update the campaign brief/message template and rerun Generate Message before launch.
956
1175
  ```
957
1176
  </objective>
958
1177
 
@@ -5,9 +5,6 @@ visibility: public
5
5
  allowed-tools:
6
6
  - mcp__sellable__get_subskill_prompt
7
7
  - mcp__sellable__search_subskill_prompts
8
- - mcp__sellable__list_senders
9
- - mcp__sellable__get_sender_routing
10
- - mcp__sellable__get_campaign_waterfall
11
8
  - mcp__sellable__resolve_campaign_fill_route
12
9
  - mcp__sellable__get_campaign_refill_state
13
10
  - mcp__sellable__fill_campaign_horizon
@@ -54,11 +51,10 @@ get_subskill_prompt({ subskillName: "refill-sends-workflow" })
54
51
  ```
55
52
 
56
53
  Then follow that workflow exactly. The default path is read-only research:
57
- resolve the route, identify the sender-relevant campaign that most recently had
58
- scheduler-owned sends, read refill state for that target, report the next safe
59
- step using campaign names first, and stop before mutation unless the user has
60
- explicitly approved the exact workspace, campaign/table/source ids, caps/dates,
61
- approval mode, expected side effects, and stop/rollback condition.
54
+ resolve the route, read target refill state, report the next safe step, and stop
55
+ before mutation unless the user has explicitly approved the exact workspace,
56
+ campaign/table/source ids, caps/dates, approval mode, expected side effects,
57
+ and stop/rollback condition.
62
58
 
63
59
  Public concepts are regular campaign and evergreen campaign. Internal direct
64
60
  campaign types are unsupported refill targets. `fill_campaign_horizon` is only a