@sellable/mcp 0.1.142 → 0.1.144

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.
Files changed (30) hide show
  1. package/README.md +5 -3
  2. package/agents/post-find-leads-message-scout.md +47 -3
  3. package/agents/registry.json +3 -7
  4. package/dist/index-dev.js +0 -0
  5. package/dist/index.js +0 -0
  6. package/dist/server.js +59 -29
  7. package/dist/tools/auth.js +5 -5
  8. package/dist/tools/leads.js +107 -8
  9. package/dist/tools/processing.d.ts +1 -0
  10. package/dist/tools/prompts.js +3 -3
  11. package/dist/tools/rubrics.js +14 -9
  12. package/package.json +1 -1
  13. package/skills/create-campaign/SKILL.md +52 -32
  14. package/skills/create-campaign-brief/SKILL.md +4 -0
  15. package/skills/create-campaign-v2/SKILL.md +59 -9
  16. package/skills/create-campaign-v2/SOUL.md +21 -12
  17. package/skills/create-campaign-v2/core/flow.v2.json +54 -18
  18. package/skills/create-campaign-v2/core/policy.md +35 -39
  19. package/skills/create-campaign-v2/references/draft-lifecycle.md +20 -104
  20. package/skills/create-campaign-v2/references/filter-leads.md +199 -525
  21. package/skills/create-campaign-v2/references/final-handoff-contract.md +5 -5
  22. package/skills/create-campaign-v2/references/message-review-safety-gate.md +109 -28
  23. package/skills/create-campaign-v2/references/sample-validation-loop.md +5 -2
  24. package/skills/create-campaign-v2/references/step-15-re-cascade.md +2 -3
  25. package/skills/create-campaign-v2/references/watch-guide-narration.md +37 -22
  26. package/skills/create-campaign-v2/references/watch-link-handoff.md +1 -1
  27. package/skills/create-campaign-v2-tail/SKILL.md +26 -13
  28. package/skills/research/config.json +9 -0
  29. package/dist/tools/registry.d.ts +0 -4186
  30. package/dist/tools/registry.js +0 -59
@@ -1,110 +1,26 @@
1
- # Draft Lifecycle
1
+ # Legacy Debug Artifact Lifecycle
2
2
 
3
- Phase 84 validates the Phase 83 brief through chained artifacts in one draft
4
- directory:
3
+ Normal `create-campaign-v2` does not use a local draft directory. CampaignOffer
4
+ state, the watched app, selected source/list state, and campaign-table rows are
5
+ the source of truth.
5
6
 
6
- `.sellable/create-campaign-v2/drafts/{workspace-slug}/{campaign-slug}/`
7
+ Use this reference only for explicit debug/UAT work or compatibility validation
8
+ harnesses that intentionally emit local diagnostic artifacts. Do not load it for
9
+ normal customer-facing create-campaign runs.
7
10
 
8
- Required files as the chain advances:
11
+ ## Rules For Debug/UAT Artifacts
9
12
 
10
- ```text
11
- brief.md
12
- lead-review.md
13
- lead-sample.json
14
- lead-filter.md
15
- message-validation.md
16
- rubric.json # optional
17
- ```
13
+ - Treat artifacts as diagnostic copies, not durable campaign state.
14
+ - Never surface local artifact paths to customers unless they explicitly ask for
15
+ debug output.
16
+ - Never resume a live campaign from diagnostic files when CampaignOffer state is
17
+ available.
18
+ - Never let diagnostic files override selected source/list ids, table ids, row
19
+ ids, saved rubrics, approved templates, or watch narration.
20
+ - Keep all customer approvals and product mutations tied to live campaign state.
18
21
 
19
- ## Artifact Roles
22
+ ## Compatibility Boundary
20
23
 
21
- - `brief.md`
22
- - stable Phase 83 thesis
23
- - preserved during validation
24
- - `lead-review.md`
25
- - human-readable analysis of the preview run
26
- - `lead-sample.json`
27
- - machine-readable lead sample for filter and message validation
28
- - `lead-filter.md`
29
- - primary keep/exclude output for the middle step
30
- - owns required keep rules, required exclude rules, sample false positives,
31
- pass-rate judgment, and the final recommendation
32
- - `rubric.json`
33
- - optional implementation sidecar only
34
- - must be derived from `lead-filter.md`, not designed separately
35
- - `message-validation.md`
36
- - final message check against the validated lead set
37
-
38
- ## Serial Step Order
39
-
40
- Run in this order only:
41
-
42
- 1. find leads
43
- 2. filter leads
44
- 3. generate message
45
-
46
- Do not skip ahead unless the required upstream artifacts already exist and are
47
- complete.
48
-
49
- ## Atomic Writes
50
-
51
- Every artifact edit must be written as:
52
-
53
- 1. read the current artifact if it exists
54
- 2. compute the full replacement contents
55
- 3. write `{artifact}.tmp`
56
- 4. rename `{artifact}.tmp` -> `{artifact}`
57
-
58
- If the write fails before rename, the old artifact remains the valid state.
59
-
60
- ## Resume Rules
61
-
62
- - `brief.md` only -> run `find leads`
63
- - `lead-review.md` + `lead-sample.json` present -> run `filter leads` and
64
- `generate message` from the same find-leads basis
65
- - `lead-filter.md` present and `message-validation.md` missing -> run
66
- `generate message`
67
- - `message-validation.md` present and `lead-filter.md` missing -> run
68
- `filter leads`
69
- - `message-validation.md` + `lead-filter.md` present -> reconcile and stop,
70
- validation complete
71
-
72
- Invalid partial states must stop for repair:
73
-
74
- - `lead-review.md` exists but `lead-sample.json` is missing
75
- - `lead-sample.json` exists but `lead-review.md` is missing
76
- - `lead-filter.md` exists without both upstream lead artifacts
77
- - approval packet or commit gate exists without both `message-validation.md`
78
- and `lead-filter.md`
79
-
80
- ## Revision Rules
81
-
82
- - `revise-brief`
83
- - preserve `brief.md`
84
- - delete `lead-review.md`
85
- - delete `lead-sample.json`
86
- - delete `lead-filter.md`
87
- - delete `message-validation.md`
88
- - delete `rubric.json` if present
89
- - `revise-leads`
90
- - delete `lead-review.md`
91
- - delete `lead-sample.json`
92
- - delete downstream artifacts (`lead-filter.md`, `message-validation.md`, `rubric.json`)
93
- - `revise-filter`
94
- - preserve lead preview artifacts
95
- - delete `lead-filter.md`
96
- - delete `message-validation.md`
97
- - delete `rubric.json` if present
98
- - `revise-message`
99
- - preserve upstream artifacts
100
- - delete `message-validation.md`
101
-
102
- ## No-Mutation Boundary
103
-
104
- During Phase 84, the artifact chain is local draft state only. Do not:
105
-
106
- - create or update a `CampaignOffer`
107
- - import leads
108
- - persist a selected lead list
109
- - create workflow rows
110
- - attach sequences
24
+ Legacy validation harnesses may still use a serial artifact chain to test
25
+ prompt behavior without mutating product state. That boundary does not apply to
26
+ normal shell-first create-campaign execution.