@sellable/mcp 0.1.83 → 0.1.84

package/dist/update-check.js

@@ -77,12 +77,14 @@ function isVersionOutdated(currentVersion, latestVersion) {
     }
     return false;
 }
-function readCache(ttlMs) {
+function readCache(ttlMs, currentVersion) {
     const file = cachePath();
     try {
         const raw = JSON.parse(fs.readFileSync(file, "utf8"));
         if (!raw.checkedAtMs || Date.now() - raw.checkedAtMs > ttlMs)
             return null;
+        if (raw.mcp?.currentVersion !== currentVersion)
+            return null;
         return {
             ...raw,
             cachePath: file,
@@ -157,7 +159,7 @@ export async function checkForUpdates(options) {
         return disabledStatus(currentVersion);
     }
     if (!options?.force) {
-        const cached = readCache(ttlMs);
+        const cached = readCache(ttlMs, currentVersion);
         if (cached)
             return cached;
     }

package/package.json

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

package/skills/create-campaign/SKILL.md

@@ -108,6 +108,13 @@ rows, sampled people, sampled fits as n/N (%), estimated usable people, and the
 confidence basis. Never show a percent like "73% match" without the numerator,
 denominator, and sample basis.
 
+Do not forecast LinkedIn connection acceptance rates, reply rates, meetings,
+pipeline, revenue, or ROI in customer-facing source reviews unless the user
+supplied verified benchmark data for this exact workspace/sender. Without that
+data, compare sources by source volume, sampled ICP fit, activity/warmth
+signals, cleanup risk, and confidence basis. If a user asks for a forecast,
+label it explicitly as not estimated from this run.
+
 When the user has not supplied a source and multiple source angles are viable,
 scout those angles as independent branches when the host can actually do it:
 LinkedIn Engagement / active post engagers (internal `signal-discovery`

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

@@ -198,9 +198,9 @@ Validated draft directory:
     web lookup.
   - Existing client prospect id: use it directly and do one company/profile
     lookup only if a URL/domain is also available.
-  Then summarize what you found in one or two lines and ask the user to confirm
-  the campaign identity/focus before continuing. Do not mention connected sender
-  availability in this confirmation.
+    Then summarize what you found in one or two lines and ask the user to confirm
+    the campaign identity/focus before continuing. Do not mention connected sender
+    availability in this confirmation.
 - If the user did not provide the launch identity, ask in normal chat for the
   LinkedIn profile or company website to use as the campaign identity. Do not ask
   them to choose an input type with the structured question tool:
@@ -380,11 +380,11 @@ brief`, `Revise target`, `Revise offer/proof`, and `Other / custom`.
   finish the write synchronously at that boundary.
 
 - 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
-reply on LinkedIn. I'll compare source paths by expected volume, likely
-connection acceptance rate, likely reply rate, signal quality, and tradeoffs.
-This usually takes ~3-5 min, and I'll show you the source decision + sample
-before anything goes live.`
+  `Cool. Now I'm going to find people who are both a good fit and active enough
+to be worth a LinkedIn test. I'll compare source paths by expected volume,
+sampled ICP fit, activity/warmth signal, cleanup risk, and tradeoffs. This
+usually takes ~3-5 min, and I'll show you the source decision + sample before
+anything goes live.`
 - After the lead sample/source decision is ready and approved or auto-confirmed,
   show the next progress line:
   `Lead source is set. I'll import the first 10-row review batch into the
@@ -775,9 +775,13 @@ usable leads`.
 - preview count
 - ICP match rate with numerator/denominator and sample basis; never percent-only
 - volume comparison
-- expected LinkedIn funnel: likely connection acceptance range, likely reply
-  range, and whether the estimate is sample-backed, historical, founder-supplied,
-  or directional
+- source viability: expected source volume, expected usable leads after
+  filtering, source activity/warmth indicators, cleanup risk, and confidence
+  basis
+- do not forecast connection acceptance, reply rate, meetings, pipeline,
+  revenue, or ROI unless the user supplied verified benchmark data for this
+  exact workspace/sender. If no verified benchmark exists, state that
+  performance is not estimated from this source review.
 - for Signals-first paths: top candidate posts reviewed, selected post URLs,
   post author, post topic/excerpt, post age or posted date, engagement count,
   sampled engager count per selected post, sampled fit count per selected post,
@@ -801,7 +805,7 @@ customer-visible sections with literal headings:
 - `## Source Decision`
 - `## Evidence Snapshot`
 - `## Selected Signal Posts` for Signals-first campaigns
-- `## Expected LinkedIn Funnel`
+- `## Source Viability`
 - `## Sample Leads` for Signals-first campaigns
 - `## Pros`
 - `## Tradeoffs`
@@ -835,10 +839,11 @@ For Signals-first campaigns, `## Sample Leads` must group representative sample
 rows by source post when possible, so the user can see not just that the search
 found posts, but which posts produce believable prospects.
 
-`## Expected LinkedIn Funnel` must include expected source volume, expected
-usable leads after filtering, likely connection acceptance range, likely reply
-range, and estimate basis. If exact performance data is unavailable, use a
-directional range and label it `directional`, not definitive.
+`## Source Viability` must include expected source volume, expected usable
+leads after filtering, source activity/warmth indicators, cleanup risk, and
+estimate basis. Do not include likely connection acceptance or reply-rate
+ranges unless verified benchmark data was supplied by the user for this exact
+workspace/sender.
 
 When showing `lead-review.md` to the user, render a slim decision summary in
 chat, not the full evidence table. Use rendered Markdown directly with short
@@ -858,7 +863,8 @@ user-facing lead review. The visible response must include:
 - `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
-  good-fit range after cleanup, and expected reply-rate range when available.
+  good-fit range after cleanup, source activity/warmth basis, and confidence
+  note.
 - If Signals was searched or considered, `Signal keyword lanes` as a compact
   table with keyword lane, timeframe, posts found, and finalist posts reviewed.
 - If Signals was searched or considered, `LinkedIn posts sampled` as a compact

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

@@ -475,13 +475,13 @@
         {
           "action": "render_find_leads_progress",
           "requiredVisibleContent": [
-            "good fit and likely to reply on LinkedIn",
+            "good fit and active enough to be worth a LinkedIn test",
             "campaign source step",
             "primary source",
             "expected volume",
-            "likely connection acceptance rate",
-            "likely reply rate",
-            "signal quality",
+            "sampled ICP fit",
+            "activity/warmth signal",
+            "cleanup risk",
             "tradeoffs",
             "search lanes",
             "timeframe",
@@ -639,7 +639,6 @@
             "sampled fits as n/N (%)",
             "estimated usable people",
             "estimated good-fit range after cleanup",
-            "expected reply-rate range",
             "confidence note"
           ],
           "sourceDecisionRequiredFields": [
@@ -668,7 +667,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. 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."
+          "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, activity/warmth basis, confidence note, 3-5 representative sample leads, and one tradeoff. Do not forecast connection acceptance rates, reply rates, meetings, pipeline, revenue, or ROI unless the user supplied verified benchmark data for this exact workspace/sender. 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",

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

@@ -95,7 +95,7 @@ Use a compact markdown report with these sections:
 - Preview Count: {n}
 - ICP Match Rate: {x/y or % if supportable}
 - Volume Comparison: above target | in range | below target
-- Expected LinkedIn Funnel: connection acceptance {range}, reply {range}, estimate basis {sample-backed | historical | founder-supplied | directional}
+- Source Viability: source volume {n or range}, usable leads after filtering {n or range}, activity/warmth basis {sample-backed | directional | needs more sample}, cleanup risk {low | medium | high}
 
 ## Source Decision
 
@@ -108,13 +108,13 @@ Use a compact markdown report with these sections:
 - Approval Meaning: approving this source means {what will be sampled/imported
   next}
 
-## Expected LinkedIn Funnel
+## Source Viability
 
 - Source Volume: {n or range}
 - Expected Usable Leads After Filtering: {n or range}
-- Likely Connection Acceptance: {range}
-- Likely Reply Rate: {range}
-- Estimate Basis: sample-backed | historical | founder-supplied | directional
+- Activity/Warmth Basis: sample-backed | directional | needs more sample
+- Cleanup Risk: low | medium | high
+- Performance Forecast: not estimated unless the user supplied verified benchmark data for this exact workspace/sender
 
 ## Signal Keyword Lanes
 

package/skills/create-campaign-v2/references/validation-criteria.md

@@ -114,9 +114,12 @@ Lead preview must:
 - preview count
 - ICP match rate
 - volume comparison
-- expected LinkedIn funnel: likely connection acceptance range, likely reply
-  range, and whether the estimate is sample-backed, historical, founder-supplied,
-  or directional
+- source viability: expected source volume, expected usable leads after
+  filtering, source activity/warmth indicators, cleanup risk, and confidence
+  basis
+- no connection acceptance, reply-rate, meeting, pipeline, revenue, or ROI
+  forecast unless the user supplied verified benchmark data for this exact
+  workspace/sender
 - source decision: best path, why it won, pros, cons/tradeoffs, and discarded
   source paths with the reason each lost
 - false-positive patterns
@@ -126,15 +129,16 @@ For normal LinkedIn discovery, `lead-review.md` must include literal
 customer-visible headings:
 
 - `## Source Decision`
-- `## Expected LinkedIn Funnel`
+- `## Source Viability`
 - `## Pros`
 - `## Tradeoffs`
 - `## Discarded Paths`
 
-`## Expected LinkedIn Funnel` must include expected source volume, expected
-usable leads after filtering, likely connection acceptance range, likely reply
-range, and estimate basis. If exact performance data is unavailable, use a
-directional range and label it `directional`, not definitive.
+`## Source Viability` must include expected source volume, expected usable
+leads after filtering, source activity/warmth indicators, cleanup risk, and
+estimate basis. Do not include likely connection acceptance or reply-rate
+ranges unless verified benchmark data was supplied by the user for this exact
+workspace/sender.
 
 `lead-sample.json` must include enough structured lead data for downstream
 filtering:

package/skills/find-leads/SKILL.md

@@ -343,10 +343,13 @@ Use first when LinkedIn activity plus tighter role / company filters matter.
 - For InMail or LinkedIn-send motions, establish the baseline TAM first, then test a `POSTED_ON_LINKEDIN` slice when the pool can still sustain a campaign.
 - Treat recent posters as a preferred first-send slice, not just a nice-to-have proxy. When the recently-posted slice still yields enough projected good fits, prefer it because reply / acceptance performance is usually materially better than the cold full-TAM pool.
 - When explaining a LinkedIn source decision, make the buying logic obvious:
-  pick people who are both good fits and likely to reply. Compare source paths
-  by expected volume, likely connection acceptance, likely reply rate, signal
-  quality, and tradeoffs. Use sample-backed or historical numbers when
-  available; otherwise label ranges as directional.
+  pick people who are good fits and active enough to be worth a LinkedIn test.
+  Compare source paths by expected volume, sampled ICP fit, activity/warmth
+  signal, cleanup risk, and tradeoffs.
+- Do not forecast connection acceptance rates, reply rates, meetings, pipeline,
+  revenue, or ROI unless the user supplied verified benchmark data for this
+  exact workspace/sender. Without that data, say performance is not estimated
+  from the source review.
 - Use these rough planning bands only as directional defaults when better
   workspace/founder data is not available: Signals/recent engagers = lower
   volume, higher reply upside; Sales Nav with recent LinkedIn activity = medium