@sellable/install 0.1.99 → 0.1.101
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.
package/README.md
CHANGED
|
@@ -55,12 +55,15 @@ starts in one registry entry instead of scattered prompt edits.
|
|
|
55
55
|
|
|
56
56
|
## Names
|
|
57
57
|
|
|
58
|
-
Use the same public
|
|
58
|
+
Use the same public entrypoints in both hosts:
|
|
59
59
|
|
|
60
60
|
- Claude Code: `/sellable:create-campaign`
|
|
61
|
+
- Claude Code: `/sellable:interview`
|
|
61
62
|
- Codex: `$sellable:create-campaign`
|
|
63
|
+
- Codex: `$sellable:interview`
|
|
62
64
|
- Codex Desktop plugin: `sellable@sellable`
|
|
63
65
|
- Codex visible skill: `Sellable Create Campaign`
|
|
66
|
+
- Codex visible skill: `Sellable Identity Interview`
|
|
64
67
|
- Internal MCP workflow prompt: `create-campaign-v2`
|
|
65
68
|
|
|
66
69
|
Do not ask users to run `/sellable:create-campaign-v2`,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
You are Lead Fit Builder for Sellable create-campaign-v2.
|
|
2
2
|
|
|
3
|
-
Your job starts only after
|
|
4
|
-
|
|
3
|
+
Your job starts only after the lead source has been approved or auto-confirmed
|
|
4
|
+
and the bounded review batch exists in the campaign table.
|
|
5
5
|
Work only on the lead filter branch. Do not source new leads, draft messages,
|
|
6
6
|
import leads, create campaigns, or ask the user questions. Your only live
|
|
7
7
|
campaign mutation is calling `save_rubrics` after the production rubrics are
|
|
@@ -9,41 +9,38 @@ ready.
|
|
|
9
9
|
|
|
10
10
|
Required inputs:
|
|
11
11
|
|
|
12
|
-
- `
|
|
13
|
-
- `
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
12
|
+
- `campaignId`
|
|
13
|
+
- campaign revision or `campaignUpdatedAt`
|
|
14
|
+
- campaign brief content
|
|
15
|
+
- selected source decision and provider/list state
|
|
16
|
+
- `selectedLeadListId`
|
|
17
|
+
- `workflowTableId`
|
|
18
|
+
- imported review-batch rows, including row ids/hash when available
|
|
19
|
+
- filter choice
|
|
17
20
|
|
|
18
21
|
Required first steps:
|
|
19
22
|
|
|
20
|
-
1.
|
|
21
|
-
|
|
23
|
+
1. Verify the campaign/source/table ids from the parent thread match the live
|
|
24
|
+
campaign context.
|
|
25
|
+
2. Load the filter-leads reference before designing rubrics:
|
|
22
26
|
`get_subskill_asset({ subskillName: "create-campaign-v2", assetPath: "references/filter-leads.md" })`.
|
|
23
27
|
3. Treat campaign state and the campaign table sample as the input of record.
|
|
24
|
-
|
|
28
|
+
Do not require or hunt for local markdown/json artifacts.
|
|
25
29
|
|
|
26
30
|
Owned outputs:
|
|
27
31
|
|
|
28
32
|
- Durable campaign rubrics via `save_rubrics({ campaignOfferId, leadScoringRubrics })`
|
|
29
33
|
when the filter is confirmed and production-shaped rubrics are safe to write.
|
|
30
34
|
`save_rubrics` is the durable writer.
|
|
31
|
-
-
|
|
32
|
-
- `rubric.json` debug artifact after the durable campaign write
|
|
35
|
+
- concise filter/rubric summary returned to the parent thread
|
|
33
36
|
|
|
34
|
-
Do not write or modify
|
|
35
|
-
|
|
36
|
-
- `message-validation.md`
|
|
37
|
-
- `message-review.md`
|
|
38
|
-
- `approval-packet.md`
|
|
39
|
-
- `brief.md`
|
|
40
|
-
- `lead-review.md`
|
|
41
|
-
- `lead-sample.json`
|
|
37
|
+
Do not write or modify local markdown/json artifacts. Durable output is only
|
|
38
|
+
via `save_rubrics` plus the parent-thread summary.
|
|
42
39
|
|
|
43
40
|
Process:
|
|
44
41
|
|
|
45
|
-
1. Preserve the approved source decision and
|
|
46
|
-
|
|
42
|
+
1. Preserve the approved source decision and review-batch sample math supplied
|
|
43
|
+
by the parent; do not re-run sourcing.
|
|
47
44
|
2. Turn the sample's good-fit and false-positive patterns into a strict but
|
|
48
45
|
campaign-native filter.
|
|
49
46
|
3. Include keep rules, exclude rules, sample false positives, pass-rate /
|
|
@@ -56,14 +53,11 @@ Process:
|
|
|
56
53
|
6. If status is `confirmed`, call `save_rubrics` with 2-5 production-shaped
|
|
57
54
|
active `leadScoringRubrics` before reporting success. If `save_rubrics`
|
|
58
55
|
fails, stop and report the blocker; do not claim the filter is persisted.
|
|
59
|
-
7. Write `lead-filter.md` and `rubric.json` only as debug artifacts after
|
|
60
|
-
campaign persistence succeeds.
|
|
61
56
|
|
|
62
57
|
Return a concise final status with:
|
|
63
58
|
|
|
64
59
|
- filter status: `confirmed`, `confirm-with-user`, or `revise-find-leads`
|
|
65
60
|
- whether `save_rubrics` succeeded and how many active rubrics were persisted
|
|
66
|
-
- artifacts written
|
|
67
61
|
- strongest keep rules
|
|
68
62
|
- strongest exclusion rules
|
|
69
63
|
- expected pass-rate / yield impact
|
|
@@ -80,6 +80,27 @@ When reporting branch runtime proof, use this shape under
|
|
|
80
80
|
Do not tell the UI to show Message Draft Builder as running unless this proof
|
|
81
81
|
exists and points at the current non-empty bounded review batch.
|
|
82
82
|
|
|
83
|
+
## Basis Changes And Rewrites
|
|
84
|
+
|
|
85
|
+
The first completed recommendation is the default message review candidate.
|
|
86
|
+
Do not automatically retry or regenerate only because Lead Fit Builder finished,
|
|
87
|
+
rubrics were saved, Filter Leads completed, enrichment cells populated, or more
|
|
88
|
+
row data became available after this branch started.
|
|
89
|
+
|
|
90
|
+
Treat later filter/enrichment data as optional rewrite context. If campaign id,
|
|
91
|
+
brief hash, selected source, `selectedLeadListId`, `workflowTableId`, and
|
|
92
|
+
review-batch row ids/hash still match, keep the initial recommendation usable
|
|
93
|
+
and report `status: ready` with `basisStatus: "usable_initial"` or
|
|
94
|
+
`"enriched_rewrite_available"`. The parent thread may offer the user a choice
|
|
95
|
+
to keep the initial draft or rewrite with enriched/filter data, but the rewrite
|
|
96
|
+
must be explicit user opt-in.
|
|
97
|
+
|
|
98
|
+
Retry or regenerate without asking only when the initial recommendation is
|
|
99
|
+
missing, failed, structurally invalid, unsafe, or mismatched on campaign id,
|
|
100
|
+
brief hash, selected source, `selectedLeadListId`, `workflowTableId`, or
|
|
101
|
+
review-batch rows. Filter/rubric/enrichment basis drift alone is not a stale
|
|
102
|
+
blocker.
|
|
103
|
+
|
|
83
104
|
## Hard Rules
|
|
84
105
|
|
|
85
106
|
- Do not call product Generate Message cells. This worker drafts the template
|
package/agents/registry.json
CHANGED
|
@@ -158,22 +158,20 @@
|
|
|
158
158
|
"displayName": "Lead Fit Builder",
|
|
159
159
|
"target": "filter-leads",
|
|
160
160
|
"inputs": [
|
|
161
|
-
"
|
|
162
|
-
"
|
|
163
|
-
"
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
"lead-filter.md"
|
|
167
|
-
],
|
|
168
|
-
"optionalProducesArtifacts": [
|
|
169
|
-
"rubric.json"
|
|
161
|
+
"campaignId",
|
|
162
|
+
"campaignBrief",
|
|
163
|
+
"source decision and selectedLeadList/source state",
|
|
164
|
+
"workflowTableId",
|
|
165
|
+
"imported review-batch rows"
|
|
170
166
|
],
|
|
167
|
+
"producesArtifacts": [],
|
|
168
|
+
"optionalProducesArtifacts": [],
|
|
171
169
|
"ownership": "lead quality, false-positive patterns, keep/exclude rules, ability-to-pay checks, and production rubric translation only",
|
|
172
170
|
"codex": {
|
|
173
171
|
"description": "Lead Fit Builder for campaign-backed lead filtering and rubric persistence after source approval.",
|
|
174
172
|
"model": "gpt-5.5",
|
|
175
173
|
"modelReasoningEffort": "high",
|
|
176
|
-
"sandboxMode": "
|
|
174
|
+
"sandboxMode": "read-only",
|
|
177
175
|
"nicknameCandidates": [
|
|
178
176
|
"Lead Fit Builder",
|
|
179
177
|
"Fit Builder",
|
|
@@ -181,17 +179,12 @@
|
|
|
181
179
|
]
|
|
182
180
|
},
|
|
183
181
|
"claude": {
|
|
184
|
-
"description": "Use proactively as Lead Fit Builder after lead source approval to persist campaign rubrics
|
|
182
|
+
"description": "Use proactively as Lead Fit Builder after lead source approval to persist campaign rubrics from campaign state.",
|
|
185
183
|
"model": "inherit",
|
|
186
184
|
"background": true,
|
|
187
185
|
"maxTurns": 8,
|
|
188
186
|
"color": "yellow",
|
|
189
187
|
"tools": [
|
|
190
|
-
"Read",
|
|
191
|
-
"Write",
|
|
192
|
-
"Edit",
|
|
193
|
-
"Grep",
|
|
194
|
-
"Glob",
|
|
195
188
|
"mcp__sellable__get_subskill_prompt",
|
|
196
189
|
"mcp__sellable__get_subskill_asset",
|
|
197
190
|
"mcp__sellable__save_rubrics"
|
|
@@ -9,8 +9,8 @@ Required first step:
|
|
|
9
9
|
"signal-discovery", campaignOfferId, confirmed: true })` and include that same
|
|
10
10
|
`campaignOfferId` plus `currentStep: "signal-discovery"` in `search_signals`
|
|
11
11
|
so the owning search route can show the source lane with current find-leads
|
|
12
|
-
narration and user options. Treat that as a campaign-attached persisted
|
|
13
|
-
|
|
12
|
+
narration and user options. Treat that as a campaign-attached persisted search;
|
|
13
|
+
do not run a post-mint search without the campaign ID. If no campaign
|
|
14
14
|
ID is supplied, run campaignless preview mode.
|
|
15
15
|
|
|
16
16
|
Use the inherited Sellable MCP tools when available:
|
package/bin/sellable-install.mjs
CHANGED
|
@@ -134,7 +134,7 @@ Usage:
|
|
|
134
134
|
npx -y @sellable/install@latest -- [options]
|
|
135
135
|
|
|
136
136
|
Commands:
|
|
137
|
-
create Show how to launch
|
|
137
|
+
create Show how to launch public Sellable workflows.
|
|
138
138
|
auth set <token> Save a Sellable API token for first-run auth.
|
|
139
139
|
uninstall Remove Sellable host config and installed artifacts.
|
|
140
140
|
|
|
@@ -167,7 +167,7 @@ Auth:
|
|
|
167
167
|
function printCreateCommandHint() {
|
|
168
168
|
printBanner();
|
|
169
169
|
console.log(
|
|
170
|
-
` ${C.bold}
|
|
170
|
+
` ${C.bold}Run Sellable from Claude Code or Codex.${C.reset}`
|
|
171
171
|
);
|
|
172
172
|
console.log("");
|
|
173
173
|
console.log(
|
|
@@ -175,14 +175,20 @@ function printCreateCommandHint() {
|
|
|
175
175
|
);
|
|
176
176
|
console.log("");
|
|
177
177
|
console.log(` ${"═".repeat(63)}`);
|
|
178
|
-
console.log(` ${C.bold}Start a Sellable
|
|
178
|
+
console.log(` ${C.bold}Start a Sellable workflow:${C.reset}`);
|
|
179
179
|
console.log(` ${"═".repeat(63)}`);
|
|
180
180
|
console.log("");
|
|
181
181
|
console.log("");
|
|
182
|
-
printAgentBox("Using Claude Code?", "claude",
|
|
182
|
+
printAgentBox("Using Claude Code?", "claude", [
|
|
183
|
+
{ label: "Campaign", command: "/sellable:create-campaign" },
|
|
184
|
+
{ label: "Identity", command: "/sellable:interview" },
|
|
185
|
+
]);
|
|
183
186
|
console.log("");
|
|
184
187
|
console.log("");
|
|
185
|
-
printAgentBox("Using Codex?", "codex",
|
|
188
|
+
printAgentBox("Using Codex?", "codex", [
|
|
189
|
+
{ label: "Campaign", command: "$sellable:create-campaign" },
|
|
190
|
+
{ label: "Identity", command: "$sellable:interview" },
|
|
191
|
+
]);
|
|
186
192
|
console.log("");
|
|
187
193
|
console.log(` ${"─".repeat(63)}`);
|
|
188
194
|
console.log(` ${C.grey}If those commands are missing, run:${C.reset}`);
|
|
@@ -1000,6 +1006,59 @@ If subskill lookup fails, use \`mcp__sellable__search_subskill_prompts({ query:
|
|
|
1000
1006
|
`;
|
|
1001
1007
|
}
|
|
1002
1008
|
|
|
1009
|
+
function interviewSkillMd() {
|
|
1010
|
+
return `---
|
|
1011
|
+
name: interview
|
|
1012
|
+
description: Build Sellable core identity/company memory for writing workflows.
|
|
1013
|
+
allowed-tools:
|
|
1014
|
+
- mcp__sellable__get_subskill_prompt
|
|
1015
|
+
- mcp__sellable__get_subskill_asset
|
|
1016
|
+
- mcp__sellable__search_subskill_prompts
|
|
1017
|
+
- Read
|
|
1018
|
+
- Write
|
|
1019
|
+
- Edit
|
|
1020
|
+
- Glob
|
|
1021
|
+
- Grep
|
|
1022
|
+
---
|
|
1023
|
+
|
|
1024
|
+
# Sellable Identity Interview
|
|
1025
|
+
|
|
1026
|
+
Use this as the customer-facing entrypoint for the Sellable \`interview\`
|
|
1027
|
+
workflow. It builds durable identity/company memory, proof hygiene, reusable
|
|
1028
|
+
answers, transcript references, and anti-AI writing rules for downstream
|
|
1029
|
+
Sellable writing workflows.
|
|
1030
|
+
|
|
1031
|
+
## Bootstrap
|
|
1032
|
+
|
|
1033
|
+
MCP prompt access is required. Do not inspect repo files, run shell commands,
|
|
1034
|
+
use \`npm\`, \`node\`, local harness scripts, or read local prompt files to
|
|
1035
|
+
emulate this workflow.
|
|
1036
|
+
|
|
1037
|
+
If the Sellable MCP prompt tools are unavailable, stop and say this is a Codex
|
|
1038
|
+
install/reload problem. Tell the user to run
|
|
1039
|
+
\`npx -y ${INSTALL_PACKAGE_SPEC} --host all\`, fully quit and reopen Codex
|
|
1040
|
+
Desktop, then start a new thread.
|
|
1041
|
+
|
|
1042
|
+
## Execute Workflow
|
|
1043
|
+
|
|
1044
|
+
1. Load the canonical prompt via
|
|
1045
|
+
\`mcp__sellable__get_subskill_prompt({ subskillName: "interview" })\`.
|
|
1046
|
+
If the response has \`hasMore=true\`, continue with \`nextOffset\` until
|
|
1047
|
+
\`hasMore=false\`.
|
|
1048
|
+
2. When the canonical prompt asks for \`references/*.md\`, load those files
|
|
1049
|
+
with \`mcp__sellable__get_subskill_asset({ subskillName: "interview", assetPath: "references/<file>.md" })\`.
|
|
1050
|
+
3. Follow the canonical prompt exactly. Save local memory only where that prompt
|
|
1051
|
+
directs, under \`.sellable/configs/core/**\` and
|
|
1052
|
+
\`.sellable/interviews/**\`.
|
|
1053
|
+
|
|
1054
|
+
## MCP Prompt Fallback
|
|
1055
|
+
|
|
1056
|
+
If exact subskill lookup fails, use
|
|
1057
|
+
\`mcp__sellable__search_subskill_prompts({ query: "interview", includePublic: true })\`,
|
|
1058
|
+
then retry \`get_subskill_prompt\`.
|
|
1059
|
+
`;
|
|
1060
|
+
}
|
|
1061
|
+
|
|
1003
1062
|
function createCampaignSoulMd() {
|
|
1004
1063
|
return `# Sellable Campaign GTM Engineer Soul
|
|
1005
1064
|
|
|
@@ -1189,6 +1248,12 @@ function codexPluginSkills() {
|
|
|
1189
1248
|
skillMd: createCampaignSkillMd(),
|
|
1190
1249
|
soulMd: createCampaignSoulMd(),
|
|
1191
1250
|
},
|
|
1251
|
+
{
|
|
1252
|
+
dir: "sellable-interview",
|
|
1253
|
+
displayName: "Sellable Identity Interview",
|
|
1254
|
+
description: "Build durable identity and company memory",
|
|
1255
|
+
skillMd: interviewSkillMd(),
|
|
1256
|
+
},
|
|
1192
1257
|
];
|
|
1193
1258
|
}
|
|
1194
1259
|
|
|
@@ -1795,16 +1860,21 @@ function verify(opts) {
|
|
|
1795
1860
|
".codex-plugin",
|
|
1796
1861
|
"plugin.json"
|
|
1797
1862
|
);
|
|
1798
|
-
const
|
|
1799
|
-
|
|
1800
|
-
|
|
1801
|
-
|
|
1802
|
-
|
|
1803
|
-
|
|
1804
|
-
|
|
1805
|
-
|
|
1806
|
-
|
|
1807
|
-
|
|
1863
|
+
const skillPaths = codexPluginSkills().map((skill) =>
|
|
1864
|
+
join(
|
|
1865
|
+
codexHome(),
|
|
1866
|
+
"plugins",
|
|
1867
|
+
"cache",
|
|
1868
|
+
"sellable",
|
|
1869
|
+
"sellable",
|
|
1870
|
+
CODEX_PLUGIN_VERSION,
|
|
1871
|
+
"skills",
|
|
1872
|
+
skill.dir,
|
|
1873
|
+
"SKILL.md"
|
|
1874
|
+
)
|
|
1875
|
+
);
|
|
1876
|
+
const hasSkillBundles = skillPaths.every((skillPath) =>
|
|
1877
|
+
existsSync(skillPath)
|
|
1808
1878
|
);
|
|
1809
1879
|
checks.push({
|
|
1810
1880
|
ok: existsSync(pluginPath),
|
|
@@ -1813,10 +1883,10 @@ function verify(opts) {
|
|
|
1813
1883
|
: "Codex Desktop plugin missing",
|
|
1814
1884
|
});
|
|
1815
1885
|
checks.push({
|
|
1816
|
-
ok:
|
|
1817
|
-
label:
|
|
1818
|
-
? "Codex skill
|
|
1819
|
-
: "Codex skill
|
|
1886
|
+
ok: hasSkillBundles,
|
|
1887
|
+
label: hasSkillBundles
|
|
1888
|
+
? "Codex skill bundles present"
|
|
1889
|
+
: "Codex skill bundles missing",
|
|
1820
1890
|
});
|
|
1821
1891
|
const codexAgentPaths = codexCustomAgents().map((agent) =>
|
|
1822
1892
|
join(codexHome(), "agents", agent.filename)
|
|
@@ -1878,10 +1948,13 @@ function visibleLen(s) {
|
|
|
1878
1948
|
return s.replace(/\x1b\[[0-9;]*m/g, "").length;
|
|
1879
1949
|
}
|
|
1880
1950
|
|
|
1881
|
-
function printAgentBox(title, terminalCmd,
|
|
1951
|
+
function printAgentBox(title, terminalCmd, agentCommands) {
|
|
1882
1952
|
// Inner width between │ ... │ — i.e. the printable area excluding the borders.
|
|
1883
1953
|
const W = 58;
|
|
1884
1954
|
const agentName = title.replace("Using ", "").replace("?", "");
|
|
1955
|
+
const commands = Array.isArray(agentCommands)
|
|
1956
|
+
? agentCommands
|
|
1957
|
+
: [{ label: "", command: agentCommands }];
|
|
1885
1958
|
|
|
1886
1959
|
const line = (text) => {
|
|
1887
1960
|
const pad = Math.max(0, W - visibleLen(text));
|
|
@@ -1902,7 +1975,10 @@ function printAgentBox(title, terminalCmd, agentCmd) {
|
|
|
1902
1975
|
console.log(blank());
|
|
1903
1976
|
console.log(line(` ${C.bold}STEP 2${C.reset} Then in ${agentName}, run:`));
|
|
1904
1977
|
console.log(blank());
|
|
1905
|
-
|
|
1978
|
+
for (const item of commands) {
|
|
1979
|
+
const label = item.label ? `${item.label.padEnd(8)} ` : "";
|
|
1980
|
+
console.log(line(` ${label}${C.cyan}${item.command}${C.reset}`));
|
|
1981
|
+
}
|
|
1906
1982
|
console.log(blank());
|
|
1907
1983
|
console.log(bot);
|
|
1908
1984
|
}
|
|
@@ -2015,18 +2091,24 @@ function printNextSteps(installedHosts, authReused) {
|
|
|
2015
2091
|
console.log("");
|
|
2016
2092
|
console.log("");
|
|
2017
2093
|
console.log(` ${"═".repeat(63)}`);
|
|
2018
|
-
console.log(` ${C.bold}To launch
|
|
2094
|
+
console.log(` ${C.bold}To launch a Sellable workflow:${C.reset}`);
|
|
2019
2095
|
console.log(` ${"═".repeat(63)}`);
|
|
2020
2096
|
console.log("");
|
|
2021
2097
|
console.log("");
|
|
2022
2098
|
|
|
2023
2099
|
if (hasClaude) {
|
|
2024
|
-
printAgentBox("Using Claude Code?", "claude",
|
|
2100
|
+
printAgentBox("Using Claude Code?", "claude", [
|
|
2101
|
+
{ label: "Campaign", command: "/sellable:create-campaign" },
|
|
2102
|
+
{ label: "Identity", command: "/sellable:interview" },
|
|
2103
|
+
]);
|
|
2025
2104
|
console.log("");
|
|
2026
2105
|
console.log("");
|
|
2027
2106
|
}
|
|
2028
2107
|
if (hasCodex) {
|
|
2029
|
-
printAgentBox("Using Codex?", "codex",
|
|
2108
|
+
printAgentBox("Using Codex?", "codex", [
|
|
2109
|
+
{ label: "Campaign", command: "$sellable:create-campaign" },
|
|
2110
|
+
{ label: "Identity", command: "$sellable:interview" },
|
|
2111
|
+
]);
|
|
2030
2112
|
console.log("");
|
|
2031
2113
|
}
|
|
2032
2114
|
|