@sellable/install 0.1.195 → 0.1.197

package/README.md

@@ -70,15 +70,18 @@ source-scout agents.
 Use the same public entrypoints in both hosts:
 
 - Claude Code: `/sellable:create-campaign`
+- Claude Code: `/sellable:create-ab-test`
 - Claude Code: `/sellable:foundation`
 - Claude Code: `/sellable:content`
 - Claude Code: `/sellable:create-post`
 - Codex: `$sellable:create-campaign`
+- Codex: `$sellable:create-ab-test`
 - Codex: `$sellable:foundation`
 - Codex: `$sellable:content`
 - Codex: `$sellable:create-post`
 - Codex Desktop plugin: `sellable@sellable`
 - Codex visible skill: `Sellable Create Campaign`
+- Codex visible skill: `Sellable Create A/B Test`
 - Codex visible skill: `Sellable Foundation`
 - Codex visible skill: `Sellable Content`
 - Codex visible skill: `Sellable Create Post`

package/bin/sellable-install.mjs

@@ -180,6 +180,7 @@ function printCreateCommandHint() {
   console.log("");
   printAgentBox("Using Claude Code?", "claude", [
     { label: "Campaign", command: "/sellable:create-campaign" },
+    { label: "A/B Test", command: "/sellable:create-ab-test" },
     { label: "Foundation", command: "/sellable:foundation" },
     { label: "Content", command: "/sellable:content" },
     { label: "Post", command: "/sellable:create-post" },
@@ -188,6 +189,7 @@ function printCreateCommandHint() {
   console.log("");
   printAgentBox("Using Codex?", "codex", [
     { label: "Campaign", command: "$sellable:create-campaign" },
+    { label: "A/B Test", command: "$sellable:create-ab-test" },
     { label: "Foundation", command: "$sellable:foundation" },
     { label: "Content", command: "$sellable:content" },
     { label: "Post", command: "$sellable:create-post" },
@@ -618,6 +620,9 @@ const CREATE_CAMPAIGN_ALLOWED_TOOLS = [
   "mcp__sellable__select_campaign_cells",
   "mcp__sellable__queue_campaign_cells",
   "mcp__sellable__wait_for_campaign_processing",
+  "mcp__sellable__start_prepare_campaign_messages",
+  "mcp__sellable__get_prepare_campaign_messages_status",
+  "mcp__sellable__cancel_prepare_campaign_messages",
   "mcp__sellable__revise_message_template_and_rerun",
   "mcp__sellable__update_campaign_brief",
   "mcp__sellable__update_campaign",
@@ -1196,6 +1201,40 @@ then retry \`get_subskill_prompt\`.
 `;
 }
 
+function createAbTestSkillMd() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const templatePath = join(
+      here,
+      "..",
+      "skill-templates",
+      "create-ab-test.md"
+    );
+    if (existsSync(templatePath)) {
+      return readFileSync(templatePath, "utf8");
+    }
+  } catch {
+    // fall through to hardcoded fallback below
+  }
+  return `---
+name: create-ab-test
+description: Create a Sellable campaign A/B test from a clean source lead list.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__get_campaign
+  - mcp__sellable__prepare_campaign_ab_test
+  - mcp__sellable__load_csv_linkedin_leads
+  - mcp__sellable__wait_for_lead_list_ready
+---
+
+# Sellable Create A/B Test
+
+Use \`prepare_campaign_ab_test\` to create clean A/B split lead lists and review-copy campaigns. Do not call \`export_table_csv\` from generated campaign workflow tables as lead source data, and do not call \`start_campaign\`.
+`;
+}
+
 function genericSellableSkillMd({ name, title, description }) {
   return `---
 name: ${name}
@@ -1371,7 +1410,7 @@ then retry \`get_subskill_prompt\`.
 function createPostSkillMd() {
   return `---
 name: create-post
-description: Capture rough LinkedIn post ideas, develop a valuable premise, research current hooks and market beliefs, then save validated drafts in the user's voice.
+description: Capture rough LinkedIn post ideas, develop a valuable premise, research current hooks and audience tension, then save validated drafts in the user's voice.
 allowed-tools:
   - mcp__sellable__get_auth_status
   - mcp__sellable__get_subskill_prompt
@@ -1382,9 +1421,15 @@ allowed-tools:
   - mcp__sellable__get_post_idea
   - mcp__sellable__list_post_ideas
   - mcp__sellable__save_hook_research
+  - mcp__sellable__calculate_linkedin_hook_preview
+  - mcp__sellable__render_linkedin_post_preview
   - mcp__sellable__save_post_draft
+  - mcp__sellable__update_post_draft
+  - mcp__sellable__list_post_draft_iterations
   - mcp__sellable__get_post_draft
   - mcp__sellable__mark_post_published
+  - mcp__sellable__get_published_post
+  - mcp__sellable__update_published_post_metrics
   - mcp__sellable__list_published_posts
   - mcp__sellable__search_engagement_posts
   - mcp__sellable__fetch_linkedin_posts
@@ -1397,7 +1442,7 @@ allowed-tools:
 
 Use this as the customer-facing entrypoint for the Sellable \`create-post\`
 workflow. It captures raw LinkedIn post ideas, preserves the user's source
-wording, researches currently working hooks, extracts market beliefs, develops
+wording, researches currently working hooks, extracts audience tension, develops
 a premise with story/tension/reader value, validates proof/voice/AI tells, and
 saves drafts under \`~/.sellable/content/linkedin/**\`.
 
@@ -1633,6 +1678,12 @@ function codexPluginSkills() {
       skillMd: createCampaignSkillMd(),
       soulMd: createCampaignSoulMd(),
     },
+    {
+      dir: "sellable-create-ab-test",
+      displayName: "Sellable Create A/B Test",
+      description: "Create clean A/B campaign review copies",
+      skillMd: createAbTestSkillMd(),
+    },
     {
       dir: "sellable-content",
       displayName: "Sellable Content",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.195",
+  "version": "0.1.197",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code and Codex",
   "bin": {

package/skill-templates/create-ab-test.md

@@ -0,0 +1,99 @@
+---
+name: create-ab-test
+description: Create a Sellable campaign A/B test from a clean source lead list.
+visibility: public
+allowed-tools:
+  - mcp__sellable__get_auth_status
+  - mcp__sellable__get_active_workspace
+  - mcp__sellable__get_campaign
+  - mcp__sellable__get_campaign_context
+  - mcp__sellable__get_campaign_navigation_state
+  - mcp__sellable__get_campaign_messages_preview
+  - mcp__sellable__prepare_campaign_ab_test
+  - mcp__sellable__load_csv_linkedin_leads
+  - mcp__sellable__wait_for_lead_list_ready
+  - mcp__sellable__get_table_rows
+  - mcp__sellable__get_rows_minimal
+---
+
+# Sellable Create A/B Test
+
+Use this workflow when the user asks to create an A/B campaign test, split a
+campaign into variants, duplicate a campaign for copy testing, or compare two
+campaign-message approaches from the same source list.
+
+## Opening Contract
+
+Start by identifying the campaign idea and the one variable being tested. A
+source campaign and clean source lead list are both optional: use an existing
+campaign when the user already has one, use a clean source lead list when leads
+are already available, or use only the idea by writing a campaign name and base
+brief for A. The tool creates A first, duplicates A into B, applies the B delta,
+and stops for review. The goal is two review-copy campaigns, not a launched
+campaign.
+
+## Required Flow
+
+1. Decide the source mode:
+   - Existing campaign mode: confirm the source campaign ID or resolve it with
+     `get_campaign`.
+   - Idea-first mode: write a proper campaign name and base campaign brief from
+     the user's idea. If the user also has leads, confirm the clean source
+     lead-list ID or use `load_csv_linkedin_leads` first.
+2. Confirm the A/B variable in plain language. Keep variant B as the explicit
+   change and leave variant A as the control unless the user names an A change.
+3. If a source lead list is supplied, verify it is clean. A clean source list is
+   a lead-list or signal-lead-list table, not the generated campaign workflow
+   table.
+4. Call `prepare_campaign_ab_test` with `dryRun: true` first.
+5. Review split counts, duplicate/skipped counts, campaign names, and variant
+   brief deltas with the user.
+6. Only after review, call `prepare_campaign_ab_test` without `dryRun` using the
+   same `idempotencyKey` if one was returned or supplied.
+7. Return the A and B campaign IDs, split lead-list IDs, counts, and the
+   explicit note that both campaigns are `not_started`.
+
+## Tool Inputs
+
+Use one of these shapes:
+
+- Existing campaign mode: pass `sourceCampaignId`, `variantName`,
+  `variantBriefDelta`, and any optional split or A-variant fields.
+- Idea-first mode: omit `sourceCampaignId`, pass `campaignName`,
+  `campaignBrief`, `variantName`, and `variantBriefDelta`. If a clean lead list
+  is available, also pass `sourceLeadListId`; otherwise leave it out. The tool
+  creates the A campaign, then duplicates A to create B and applies the B brief
+  delta.
+
+## Anti-Patterns
+
+- Do not call `export_table_csv` from an enriched/generated campaign workflow
+  table as the lead source for A/B splitting.
+- Do not reimport workflow output columns such as `ICP Score`, `Passes Rubric`,
+  `Generate Message`, `Message`, `Approved`, scheduling, status, result, or
+  error columns.
+- Do not use broad workflow-table selectors to split decorated campaign rows.
+- Do not call `start_campaign`, approve launch, attach senders for launch, or
+  trigger live sends in this workflow.
+
+## Clean Source Fallback
+
+If the source campaign has no clean source lead list, or the source list is
+polluted with workflow/output columns, ask for the original CSV or clean source
+list. Use `load_csv_linkedin_leads`; it strips Sellable workflow columns if a
+contaminated CSV is supplied, then creates a clean lead list. If no clean source
+is available, continue in idea-first mode without `sourceLeadListId`.
+
+## Output Contract
+
+Report:
+
+- source campaign ID, or note that the A campaign was created as the source
+  campaign when no source campaign was provided
+- source lead-list ID when supplied
+- split strategy and counts when a source lead list was supplied
+- duplicate/skipped lead counts when a source lead list was supplied
+- A review campaign ID and split lead-list ID when supplied
+- B review campaign ID and split lead-list ID when supplied
+- variant difference
+- `launchState: not_started` for both campaigns

package/skill-templates/create-campaign.md

@@ -46,6 +46,9 @@ allowed-tools:
   - mcp__sellable__select_campaign_cells
   - mcp__sellable__queue_campaign_cells
   - mcp__sellable__wait_for_campaign_processing
+  - mcp__sellable__start_prepare_campaign_messages
+  - mcp__sellable__get_prepare_campaign_messages_status
+  - mcp__sellable__cancel_prepare_campaign_messages
   - mcp__sellable__revise_message_template_and_rerun
   - mcp__sellable__update_campaign_brief
   - mcp__sellable__update_campaign
@@ -89,6 +92,18 @@ When filters are chosen, save rubrics, get filter approval, then wait for
 message-template approval before enrichment/filtering or Generate Message cells.
 After filter approval, Filter Leads should show `Filters saved + waiting for
 message approval` until the template is approved.
+After message approval, use `start_prepare_campaign_messages` for target-ready
+message preparation such as "prepare 100 messages, checking up to 300 rows".
+Treat `campaignId` as `CampaignOffer.id`, keep the default
+`approvalMode:"mark_ready"` unless the user explicitly asks to flip Approved
+cells, and poll `get_prepare_campaign_messages_status` for checked rows,
+prepared/approved count, target, row budget remaining, and stop reason. Low
+level selector/queue tools are diagnostics and recovery only for this lane. If
+the user asks to stop preparation, the target is wrong, or status shows the
+wrong campaign/table, call `cancel_prepare_campaign_messages`; otherwise do not
+cancel a healthy prepare run.
+Never call `start_campaign` from Prepare Messages; final launch remains a
+separate explicit user greenlight.
 Use Template is the default message path; AI Generated is only an explicit
 opt-out.
 
@@ -109,6 +124,22 @@ page before importing, call `list_dnc_entries`. Confirm the active workspace
 name and ID in the response before any write. This is Sellable's workspace DNC
 list used by DNC Check.
 
+## A/B Campaign Requests
+
+If the user explicitly asks to create an A/B test, split an existing campaign
+into variants, duplicate a campaign for copy testing, or compare two campaign
+message approaches from the same source list, route them to
+`create-ab-test` instead of improvising inside this create-campaign workflow.
+
+Workflow/campaign table exports are decorated outputs for operator review and
+debugging. They are not source lead lists for A/B splitting or campaign
+duplication. Do not use `export_table_csv` from an enriched/generated campaign
+table and then reimport it as leads. If the user only has a contaminated CSV,
+`load_csv_linkedin_leads` strips Sellable workflow columns such as `ICP Score`,
+`Passes Rubric`, `Generate Message`, `Message`, and `Approved`, but the
+preferred A/B path is the dedicated `create-ab-test` workflow using
+`prepare_campaign_ab_test`.
+
 ## Opening Turn Contract
 
 On the first visible response after this skill is invoked, do not narrate
@@ -939,7 +970,8 @@ updates.
    observation state,
    `auto-execute-messaging` after at least one row passes and initial campaign-row
    messages are being generated or reviewed, `awaiting-user-greenlight` only
-   after generated campaign-row messages are approved, `settings` for sender
+   after generated campaign-row messages are approved and the Prepare Messages
+   job has reported compact checked/prepared/stop status, `settings` for sender
    selection, `sequence` after sender attach, and `send` once the recommended
    sequence is attached. Do not advance the step backward.
 7. Keep `selectedLeadListId` as the source list and `workflowTableId` as the