@sellable/mcp 0.1.64 → 0.1.66

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.64",
+  "version": "0.1.66",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign-v2/SKILL.md

@@ -9,7 +9,7 @@ visibility: internal
 <role>
 You are the create-campaign-v2 orchestrator. Your job is to execute the
 configured `core/flow.v2.json` state machine from scratch: (1) interview the
-user and create `brief-v1`, (2) validate the chained Phase 84 draft artifacts,
+user and create `brief.md`, (2) validate the chained Phase 84 draft artifacts,
 (3) run a message-review gate, show the user an approval packet and commit
 gate, and (4) if the user
 approves, atomically mint a real `CampaignOffer` and hand off to the bounded
@@ -34,8 +34,8 @@ The JSON flow is the source of truth for stage order, `requiredArtifacts`,
 replace them.
 
 Each stage writes its own artifact into the draft directory before the next
-stage starts. `brief-v1.md` is the customer-facing brief output; `brief.md` is
-the canonical downstream campaign thesis input.
+stage starts. `brief.md` is the single customer-facing brief and canonical
+downstream campaign thesis input.
 
 After validation artifacts are complete, show the user a commit gate with 6
 choices (approve / revise-brief / revise-leads / revise-rubric /
@@ -51,7 +51,6 @@ Validated draft directory:
 
 ```text
 .sellable/create-campaign-v2/drafts/{workspace-slug}/{campaign-slug}/
-  brief-v1.md
   brief.md
   lead-review.md
   lead-sample.json
@@ -362,6 +361,10 @@ me`, `I’ll paste a different sender profile`, and `Other / custom`.
   Approval options should refer to what the user just read, e.g. `Approve this
 brief`, `Revise target`, `Revise offer/proof`, and `Other / custom`.
   Include an `Open artifact:` link to `brief.md` before the approval question.
+  The visible brief must come before local persistence chrome. After the brief
+  is synthesized, render the approval-ready brief in chat before running visible
+  `mkdir`, `Write`, artifact-copy, or similar local draft setup. File/folder
+  creation is not the user's value moment; the brief is.
 
 - After the brief is approved or auto-confirmed, show the next progress line:
   `Cool. Now I'm going to find people who are both a good fit and likely to
@@ -390,13 +393,13 @@ should test for this campaign. Those can run in parallel and usually take
 
 - In hosted/rehearsal runs, `Bash` is only for safe local draft-directory
   housekeeping before approval: `mkdir`, `ls`, `find`, `test`, `pwd`, `echo`,
-  `cat`, or copying `brief-v1.md` to `brief.md` inside the repo. Do not use
+  or `cat` inside the repo. Do not use
   Bash to run interpreters/scripts (`python`, `node`, `npm`, `pnpm`, `yarn`,
   `npx`), call APIs, query databases, inspect prompt dumps, run git, or
   synthesize artifact content. Use `Read`/`Write`/`Edit` for artifact files and
   MCP tools for product actions.
-- `brief-v1.md` is the user-facing brief. `brief.md` is the stable downstream
-  input and remains the thesis source.
+- `brief.md` is the single user-facing brief and stable downstream thesis
+  source.
 - `lead-review.md` and `lead-sample.json` are the required outputs of `find leads`.
 - `lead-filter.md` is the primary output of `filter leads`.
 - `rubric.json` is optional and secondary to `lead-filter.md`.
@@ -758,6 +761,14 @@ user-facing lead review. The visible response must include:
 
 - `Lead source decision`
 - `Recommendation`
+- `Primary source and filters` with the concrete source recipe the agent would
+  use if approved. For Sales Nav, name the actual role/title, company-size,
+  geography, industry/account, and activity filters. For Signals, name the
+  selected post set. For Prospeo, name the account/domain and title recipe.
+- `Runner-up sources` with the second-best choice and why it lost. Make the
+  tradeoff explicit, e.g. Sales Nav = clearer scale and fit control, Signals =
+  warmer but smaller/noisier, Prospeo = broader account coverage but weaker
+  LinkedIn intent.
 - `Why it won`
 - `Quick numbers` as bullet points, with one provider/source angle per bullet.
   Each bullet must include raw volume, sampled fit rate as `n/N`, estimated
@@ -772,6 +783,17 @@ user-facing lead review. The visible response must include:
 - `Tradeoff`
 - `Open artifact: lead-review.md`
 
+The first sentence of the visible decision must make the actual choice clear:
+`I recommend {primary source} using {exact filter/source recipe}. The runner-up
+is {source} because {reason}.` Do not make the user infer the decision from
+numbers alone.
+
+If you ask for lead-source approval, the question and choices must name the
+source decision. Prefer `Approve Sales Nav with founder/CEO filters, or use
+warmer Signals posts instead?` over `Approve this lead source?`. Option labels
+must be concrete, such as `Approve Sales Nav filters`, `Use warmer Signals
+posts`, `Try Prospeo/account search`, and `Revise source`.
+
 Do not skip or discard Signals based only on raw post count or vibes. If
 Signals was considered, show the post-level math in chat first so the user can
 see which LinkedIn posts would be scraped, how many engagers each has, how many
@@ -779,6 +801,12 @@ sampled engagers looked like good fits, and roughly how many usable prospects
 each post can produce. If no engagers could be fetched, say that explicitly and
 lower confidence instead of presenting a precise estimate.
 
+For Signals, default to sampling a few promising posts first rather than trying
+to prove the entire source can scale before the user sees evidence. Pick 3-5
+fresh, high-density posts when available, sample engagers, show fit rate, then
+state how many additional posts could be added/scraped if that first sample is
+good but volume is low.
+
 Keep discarded paths, full sample rows, and `lead-sample.json` details in
 artifacts. Do not show raw filesystem paths unless links cannot be created or
 the user asks.

package/skills/create-campaign-v2/core/flow.v2.json

@@ -12,7 +12,7 @@
   ],
   "events": [
     "bootstrap_complete",
-    "brief_v1_ready",
+    "brief_ready",
     "source_intake_ready",
     "user_brief_confirmed",
     "lead_review_ready",
@@ -139,7 +139,7 @@
             "campaignBrief": "~1-2 min"
           },
           "forbiddenWording": [
-            "brief-v1.md",
+            "brief.md",
             "lead-review.md",
             "lead-sample.json",
             "message-validation.md"
@@ -150,14 +150,24 @@
           "target": "create-campaign-brief"
         },
         {
-          "action": "write_artifact",
-          "artifact": "brief-v1.md"
+          "action": "render_brief_preview_before_artifact_write",
+          "requiredVisibleContent": [
+            "Campaign brief",
+            "Decision",
+            "Target",
+            "Pain",
+            "Offer",
+            "Proof",
+            "Lead plan",
+            "Risks",
+            "After approval"
+          ],
+          "mustRunBefore": ["write_artifact", "Bash", "mkdir"],
+          "chatRenderRule": "After synthesizing the brief, render the approval-ready brief in chat before any visible local folder creation, file write, or artifact copy. The user should see useful brief content before local persistence chrome. Do not ask the user to approve a hidden artifact."
         },
         {
-          "action": "copy_artifact",
-          "from": "brief-v1.md",
-          "to": "brief.md",
-          "reason": "brief.md remains the canonical downstream artifact name"
+          "action": "write_artifact",
+          "artifact": "brief.md"
         },
         {
           "action": "ask_source_intake_after_strategy_batch",
@@ -183,7 +193,7 @@
         }
       ],
       "requiredArtifacts": [],
-      "producesArtifacts": ["brief-v1.md", "brief.md"],
+      "producesArtifacts": ["brief.md"],
       "allowedTools": [
         "get_subskill_prompt",
         "get_subskill_asset",
@@ -211,9 +221,9 @@
         "start_campaign"
       ],
       "watchRequired": false,
-      "waitFor": ["brief_v1_ready", "confirm_with_user"],
+      "waitFor": ["brief_ready", "confirm_with_user"],
       "transitions": {
-        "brief_v1_ready": "brief-review",
+        "brief_ready": "brief-review",
         "confirm_with_user": "brief-review"
       },
       "optionalProducesArtifacts": ["lead-source-intake.json"]
@@ -224,7 +234,7 @@
       "onEnter": [
         {
           "action": "show_brief_summary",
-          "artifact": "brief-v1.md"
+          "artifact": "brief.md"
         },
         {
           "action": "render_brief_approval_checkpoint",
@@ -243,7 +253,7 @@
             "then I will find good-fit leads"
           ],
           "minimumVisibleBriefDetail": "full_readable_brief_before_question",
-          "requiredArtifactLinks": ["brief-v1.md", "brief.md"],
+          "requiredArtifactLinks": ["brief.md"],
           "artifactLinkTiming": "before_approval_question",
           "avoidQuestionWhenOnlyUsefulAnswerIs": "looks good"
         },
@@ -257,7 +267,7 @@
           }
         }
       ],
-      "requiredArtifacts": ["brief-v1.md", "brief.md"],
+      "requiredArtifacts": ["brief.md"],
       "producesArtifacts": [],
       "allowedTools": [
         "AskUserQuestion",
@@ -326,7 +336,7 @@
           "artifacts": ["lead-review.md", "lead-sample.json"]
         }
       ],
-      "requiredArtifacts": ["brief-v1.md", "brief.md"],
+      "requiredArtifacts": ["brief.md"],
       "producesArtifacts": ["lead-review.md", "lead-sample.json"],
       "allowedTools": [
         "get_subskill_prompt",
@@ -387,6 +397,8 @@
           "renderInlineSections": [
             "## Lead source decision",
             "Recommendation",
+            "Primary source and filters",
+            "Runner-up sources",
             "Why it won",
             "Quick numbers",
             "Signal keyword lanes",
@@ -419,6 +431,13 @@
             "expected reply-rate range",
             "confidence note"
           ],
+          "sourceDecisionRequiredFields": [
+            "primary source",
+            "exact Sales Nav filters or source recipe",
+            "runner-up source",
+            "why runner-up lost",
+            "what approval means"
+          ],
           "signalsInlineTableRequiredFields": [
             "keyword lane",
             "timeframe",
@@ -436,7 +455,7 @@
           "artifactLinkTiming": "before_next_step_or_revision_question",
           "doNotCompressToSummaryOnly": false,
           "doNotRenderArtifactLinksOnly": true,
-          "chatRenderRule": "Show a slim rendered-Markdown decision summary only, never a fenced code block. Use indexed sections and short bullets: recommendation, why it won, Quick numbers with one provider/source angle per bullet, raw volume, sampled fit rate as n/N, estimated good-fit range after cleanup, expected reply rate range, 3-5 representative sample leads, and one tradeoff. If Signals was searched or considered, include two compact inline Markdown tables before the recommendation is treated as final: Signal keyword lanes with keyword lane, timeframe, posts found, and finalist posts reviewed; and LinkedIn posts sampled with post URL/title, author/topic, age, engagers, sampled engagers, good fits as n/N, estimated usable prospects per post, and use/discard decision. Do not skip or discard Signals based only on raw post count or vibes; show the post-level math first, or explicitly say no engagers could be fetched and lower confidence. Keep discarded paths, full sample rows, and lead-sample.json details in lead-review.md. Do not show plain filesystem paths unless links cannot be created."
+          "chatRenderRule": "Show a slim rendered-Markdown decision summary only, never a fenced code block. The first sentence must make the decision explicit: 'I recommend {primary source} using {exact filter/source recipe}. The runner-up is {source} because {reason}.' Use indexed sections and short bullets: recommendation, Primary source and filters, Runner-up sources, why it won, Quick numbers with one provider/source angle per bullet, raw volume, sampled fit rate as n/N, estimated good-fit range after cleanup, expected reply rate range, 3-5 representative sample leads, and one tradeoff. If Signals was searched or considered, include two compact inline Markdown tables before the recommendation is treated as final: Signal keyword lanes with keyword lane, timeframe, posts found, and finalist posts reviewed; and LinkedIn posts sampled with post URL/title, author/topic, age, engagers, sampled engagers, good fits as n/N, estimated usable prospects per post, and use/discard decision. Default to selecting a few promising Signals posts for the first sample instead of trying to prove full Signals scale up front; if the sample is good but volume is low, say how many more posts to add/scrape next. Do not skip or discard Signals based only on raw post count or vibes; show the post-level math first, or explicitly say no engagers could be fetched and lower confidence. Keep discarded paths, full sample rows, and lead-sample.json details in lead-review.md. Do not show plain filesystem paths unless links cannot be created."
         },
         {
           "action": "render_post_lead_parallel_progress",
@@ -452,6 +471,7 @@
         },
         {
           "action": "ask_continue_revise_or_confirm_only_if_needed",
+          "approvalQuestionRule": "If asking the user, the question and options must name the concrete decision. Prefer: 'Approve Sales Nav with {filters}, or use warmer Signals instead?' over 'Approve this lead source?' Option labels must name the source choice, such as 'Approve Sales Nav filters', 'Use warmer Signals posts', 'Try Prospeo/account search', and 'Revise source'.",
           "autoContinueWhen": {
             "status": "confirmed",
             "confidenceIn": ["high", "medium"],

package/skills/create-campaign-v2/core/policy.md

@@ -52,7 +52,7 @@ gate is the only mandatory pre-mint approval gate.
 The minimum pre-approval chain is:
 
 ```text
-brief-v1.md / brief.md
+brief.md
 lead-review.md
 lead-sample.json
 lead-filter.md

package/skills/create-campaign-v2/references/lead-validation-preview.md

@@ -88,6 +88,12 @@ Use a compact markdown report with these sections:
 
 - Best Path: {provider or provider sequence}
 - Why It Won: {volume + reply-likelihood + fit rationale}
+- Primary Source and Filters: {exact source recipe; include Sales Nav
+  role/title, company-size, geography, industry/account, and activity filters
+  when Sales Nav wins}
+- Runner-Up Sources: {second-best source and why it lost}
+- Approval Meaning: approving this source means {what will be sampled/imported
+  next}
 
 ## Expected LinkedIn Funnel
 
@@ -111,7 +117,9 @@ what lets the user see which keyword lanes produced enough fresh post inventory.
 Include this section whenever Signals was searched or considered. Do not skip or
 discard Signals based only on raw post count or vibes; show the post-level math
 first. This table is the evidence for how many posts to scrape, including
-estimated usable prospects per post.
+estimated usable prospects per post. Default to sampling a few promising posts
+first, then state how many more similar posts to add/scrape if the fit rate is
+good but volume is low.
 
 | Post | Author / topic | Age | Engagers | Sampled engagers | Good fits | Estimated usable prospects per post | Use / discard |
 | ---- | -------------- | --- | -------- | ---------------- | --------- | ----------------------------------- | ------------- |

package/skills/find-leads/SKILL.md

@@ -267,10 +267,12 @@ Use first when the value is in conversation opportunity, competitor engagers, co
 - Favor ICP-fit conversation density over raw post volume.
 - Capture counts, false-positive patterns, and notable examples.
 - If Signals is materially in the running, do not stop at post-level quality alone.
-- Pick enough promising posts to estimate campaign viability. Start with 1-3
-  strong posts for a spot check; if the sampled pass rate is good but the
-  projected pool is below target, expand to 5-8 selected posts before
-  discarding Signals.
+- Pick a few promising posts by default so the user can see real post-level
+  evidence. Start with 3-5 fresh, high-density posts when available; if only
+  1-2 genuinely strong posts exist, sample those and say the lane needs more
+  inventory. If the sampled pass rate is good but the projected pool is below
+  target, recommend adding/scraping more similar posts as the expansion lever
+  before discarding Signals.
 - Sample a representative first page only, scoring the first 25-40 engagers across the chosen posts against a rough yes/no headline rubric or `headlineICPCriteria`.
 - Use headline and display-name cues only for the spot-check sample; do not enrich people during this phase.
 - Base `estimatedReachableLeads` on the sampled engager pass rate, not only on a guessed discount from post themes.
@@ -290,6 +292,8 @@ Use first when the value is in conversation opportunity, competitor engagers, co
   title, post age, engager count, sampled engagers, good fits as `n/N`,
   estimated usable prospects per post, and use/discard decision. This table is
   the evidence for how many posts to scrape; raw post count alone is not enough.
+  If the first few posts look good but do not produce enough volume, say how
+  many more posts to add/scrape next instead of treating the lane as failed.
 - If you cannot fetch engagers in the current runtime, say the estimate is inferred and lower confidence.
 - If Signals is too sparse, too noisy, or clearly below campaign scale after the spot check, fall back to `Sales Nav` rather than forcing a weak conversation-led lane.