@sellable/mcp 0.1.271 → 0.1.272

package/package.json

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

package/skills/create-post/SKILL.md

@@ -336,6 +336,13 @@ write from the user's idea and context. The worker may write in a voice-inspired
 style for the private variant, but it must not claim the creator authored it,
 copy source wording, copy personal proof, or invent facts about the user.
 
+Voice variants must model **writing mechanics**, not just a broad persona.
+Before drafting, each worker must infer what "in this creator's voice" concretely
+means for this idea: target word-count band, line and paragraph rhythm, hook
+posture, recurring phrase families, vocabulary level, proof pattern, formatting
+habits, close style, and normal amount of directness or humor. If every variant
+comes back as the same long LinkedIn essay with different labels, the lab failed.
+
 The final orchestrator does not publish a collage of creator personas. It takes
 the best hooks, pressure, structure, rhythm, and proof moves from the role-played
 variants, then synthesizes the most compelling post for Christian/Sellable.
@@ -388,22 +395,26 @@ Default workflow:
    repeated patterns, engagement quality, and follower-adjusted signal when
    follower counts are available. Do not return the full scoring table.
 6. Each worker must build a `voice_model` before drafting:
-   - representative length range for similar posts
+   - target word-count band and normal variance for similar posts
    - average paragraph/line length and spacing rhythm
    - hook posture and opening moves
-   - common vocabulary, recurring phrases, and taboo phrases
+   - common vocabulary, recurring phrase families, and taboo phrases
    - proof style: story, numbers, teardown, checklist, confession, challenge
    - formatting: bullets, numbering, questions, equations, parentheticals
    - close style: command, reflection, CTA, punchline, open loop
    - factual boundaries: what must come from Christian/Sellable context
 7. Each worker writes the complete post that this creator would likely write
    from the user's idea and context. Match the inferred length/rhythm/style; do
-   not compress to a generic short draft.
+   not compress to a generic short draft, and do not stretch a short-style
+   creator into a generic long post.
 8. Each worker returns a compact voice variant:
    - person and profile URL
    - worker status
    - recent post count sampled
    - voice model, max 8 bullets
+   - mechanics receipt: target length, actual length, line rhythm,
+     vocabulary markers used, formatting markers used, close style, and
+     `mechanics_match: pass | weak | fail`
    - complete post variant in that creator's inferred voice and representative
      length
    - hook options, max 3
@@ -427,6 +438,10 @@ Hard rules:
   by the creator.
 - Do not copy outside wording, proof, jokes, personal stories, or status.
 - Do not invent user proof just because it would fit the creator's style.
+- Do not treat "voice" as a vibe label. Voice means concrete mechanics: length,
+  line rhythm, vocabulary, hook posture, proof style, formatting, and close.
+- Do not publish or save a `ready` draft when voice variants are long generic
+  essays with swapped creator names instead of person-specific mechanics.
 - Do not let a large-audience creator win only because of reach. Use engagement
   per 1k followers when follower counts are available, and mark confidence when
   follower data is missing.
@@ -1118,8 +1133,11 @@ Each worker must return:
 - recent post count sampled
 - follower count when available
 - normalization confidence
-- voice model, max 8 bullets, including representative length, rhythm,
-  vocabulary, formatting, proof style, and close style
+- voice model, max 8 bullets, including target length, rhythm, vocabulary,
+  formatting, proof style, and close style
+- mechanics receipt, including target word-count band, actual word count,
+  paragraph/line rhythm, vocabulary markers, formatting markers, close style,
+  and `mechanics_match: pass | weak | fail`
 - complete role-played post variant in the creator's inferred voice and
   representative length
 - hook options, max 3
@@ -1138,6 +1156,7 @@ Variant labels must be:
 ```text
 voice_variant_from: <person>
 role_play_basis: public posts sampled + configured Reason lane
+mechanics_receipt: target length | actual length | rhythm | vocabulary markers | formatting markers | close | mechanics_match
 post_variant: <complete variant>
 steal_for_final: hook | structure | proof order | rhythm | close move
 drop_for_final: copied wording | borrowed personal proof | fake user fact
@@ -1156,6 +1175,7 @@ Before drafting, record:
 - `actualVoiceVariantCount`
 - `missingVoiceVariants`
 - `weakVoiceVariants`
+- `mechanicsReceipts`
 - `selectedSynthesisIngredients`
 - `voiceVariantsGeneratedBeforeFinalProse: yes | no`
 - `workerExecutionMode: background_agents | sequential_fallback`
@@ -1175,6 +1195,7 @@ actualVoiceVariantCount: <number>
 
 1. <person>
 - worker_status:
+- mechanics_match:
 - draft_review:
 - strongest_move:
 - weakness_or_drop:
@@ -1238,7 +1259,8 @@ Every saved draft needs a validation receipt with:
 - pre-draft narrative outline
 - selected source template and no-copy adaptation rationale
 - thought leader voice variant lab, including skipped/opt-out reason when
-  omitted and expected-vs-actual variant counts for the active configured list
+  omitted, expected-vs-actual variant counts for the active configured list,
+  and per-person mechanics receipts
 - post positioning breakdown
 - viral-post outline
 - hook-to-body promise map

package/skills/create-post/references/hook-research-playbook.md

@@ -718,6 +718,13 @@ missing variants, weak variants, and selected synthesis ingredients. Ready
 drafts require one voice variant per active configured person unless the user
 explicitly opted out or supplied a smaller named subset.
 
+Voice variants must model writing mechanics, not just a broad creator lens.
+Each worker has to define what "in this person's voice" means for this idea:
+target word-count band, line and paragraph rhythm, hook posture, recurring
+phrase families, vocabulary level, proof pattern, formatting habits, close
+style, and normal directness or humor. If multiple creator variants all become
+the same long LinkedIn essay with different labels, mark the lab weak or failed.
+
 Use one bounded background worker per person when the host supports background
 agents. This is required for Codex/Claude hosts that expose background agents or
 Task workers. If the host does not expose a worker mechanism, process the list
@@ -755,10 +762,10 @@ Worker steps:
    - adaptation fit for Christian/Sellable voice
    - lead-magnet, giveaway, and status-only penalties
 5. Build a `voice_model` before drafting. It must infer:
-   - representative post length range for similar ideas
+   - target word-count band and normal variance for similar ideas
    - paragraph and line rhythm
    - hook posture and opening moves
-   - vocabulary and recurring phrases
+   - vocabulary and recurring phrase families
    - formatting habits: bullets, numbering, equations, parentheticals, spacing
    - proof style: story, metric, teardown, confession, field guide, challenge
    - close style: command, reflection, CTA, punchline, or open loop
@@ -768,7 +775,8 @@ Worker steps:
    hook tension, pacing, section shape, directness, humor level, proof style,
    formatting, and editorial instincts.
 7. Write the complete post that this creator would likely write from the user's
-   selected premise and context. Do not compress it into a short generic draft.
+   selected premise and context. Do not compress it into a short generic draft
+   or stretch a short-style creator into a generic long post.
 8. Identify what the final synthesis should steal and what it must drop.
 9. Keep factual claims grounded in the user's context. Do not invent user proof.
 
@@ -796,7 +804,15 @@ worker_status: pass | weak | retry_needed | blocked
 recent_posts_sampled:
 follower_count: <number | unavailable>
 normalization_confidence: high | medium | low
-voice_model: [max 8 bullets covering length, rhythm, vocabulary, formatting, proof style, close]
+voice_model: [max 8 bullets covering target length, rhythm, vocabulary, formatting, proof style, close]
+mechanics_receipt:
+- target_word_count_band:
+- actual_word_count:
+- paragraph_line_rhythm:
+- vocabulary_markers:
+- formatting_markers:
+- close_style:
+- mechanics_match: pass | weak | fail
 hook_options: [max 3]
 post_variant: <complete post in the creator's inferred voice and representative length>
 steal_for_final: [max 5 bullets]

package/skills/create-post/references/post-validation.md

@@ -356,8 +356,11 @@ Record:
 - `workerExecutionMode`: `background_agents` | `sequential_fallback`
 - `backgroundWorkerIds`: worker IDs or labels when available
 - `thoughtLeaderList`: names and profile URLs or handles
-- `voiceModels`: inferred length, rhythm, vocabulary, formatting, proof style,
-  and close style per person
+- `voiceModels`: inferred target length, rhythm, vocabulary, formatting, proof
+  style, and close style per person
+- `mechanicsReceipts`: target word-count band, actual word count, line rhythm,
+  vocabulary markers, formatting markers, close style, and
+  `mechanics_match: pass | weak | fail` per person
 - `voiceVariants`: one representative-length role-played post per person, or
   `not_available` with reason
 - `normalizationConfidence`: high | medium | low
@@ -380,6 +383,12 @@ when variants are replaced by a generic influencer summary, or when voice
 variants were generated after final prose instead of before final prose. Return
 `retry-needed` when a tool/package/search failure prevents fetching configured
 profiles or posts.
+
+Save as `needs_revision` when the variants do not demonstrate person-specific
+writing mechanics, when `mechanicsReceipts` are missing, or when multiple
+variants are effectively the same long LinkedIn essay with different creator
+labels.
+
 Only mark `thought_leader_adaptation: not_used` when the user explicitly opted
 out before drafting.