@sellable/install 0.1.209 → 0.1.211

package/bin/sellable-install.mjs

@@ -771,7 +771,46 @@ function codexSkillOpenAiYaml(displayName, description) {
 `;
 }
 
-function createCampaignSkillMd() {
+function createCampaignHostContract(host) {
+  if (host === "codex") {
+    return `## Installed Host Contract
+
+This installed skill is running in Codex. Treat Codex as the current host, use
+\`request_user_input\` for structured questions when it is exposed, use
+\`$sellable:create-campaign\` in user-facing retry instructions, and call
+\`mcp__sellable__bootstrap_create_campaign\` with \`host: "Codex"\` plus the
+current Codex model and reasoning when available.
+
+Do not describe this run as Claude Code and do not recommend Claude Code-only
+commands or settings from this Codex skill.`;
+  }
+
+  if (host === "claude") {
+    return `## Installed Host Contract
+
+This installed command is running in Claude Code. Treat Claude Code as the
+current host, use \`AskUserQuestion\` for structured questions, use
+\`/sellable:create-campaign\` in user-facing retry instructions, and call
+\`mcp__sellable__bootstrap_create_campaign\` with \`host: "Claude Code"\` plus
+the current Claude Code model and reasoning when available.
+
+Do not describe this run as Codex and do not recommend Codex-only commands or
+settings from this Claude Code command.`;
+  }
+
+  return "";
+}
+
+function addCreateCampaignHostContract(markdown, host) {
+  const contract = createCampaignHostContract(host);
+  if (!contract) return markdown;
+  return String(markdown).replace(
+    "\n# Sellable Create Campaign\n",
+    `\n# Sellable Create Campaign\n\n${contract}\n`
+  );
+}
+
+function createCampaignSkillMd({ host = "shared" } = {}) {
   // Single source of truth: ../skill-templates/create-campaign.md, which is
   // copied from the canonical mcp/sellable/skills/create-campaign/SKILL.md at
   // publish time via scripts/sync-skill-templates.mjs (prepublishOnly hook).
@@ -786,7 +825,10 @@ function createCampaignSkillMd() {
       "create-campaign.md"
     );
     if (existsSync(templatePath)) {
-      return readFileSync(templatePath, "utf8");
+      return addCreateCampaignHostContract(
+        readFileSync(templatePath, "utf8"),
+        host
+      );
     }
   } catch {
     // fall through to hardcoded fallback below
@@ -814,11 +856,17 @@ person/company this campaign is for, then I’ll turn that into a campaign brief
 before anything is created.
 \`\`\`
 
-Exception: if \`bootstrap_create_campaign.modelQuality.status === "warn"\`,
-the first visible campaign message must be the model-quality warning from
+Exception: if \`bootstrap_create_campaign.modelQuality.status === "warn"\` and
+\`bootstrap_create_campaign.modelQuality.metadataStale !== true\`, the first
+visible campaign message must be the model-quality warning from
 \`modelQuality.message\`. Ask the user to switch to the configured minimum model
 or explicitly continue anyway before identity setup, research, lead filtering,
-message generation, or launch review.
+message generation, or launch review. If \`metadataStale === true\`, continue
+normally and do not ask the user to switch.
+
+If \`bootstrap_create_campaign.modelQuality.metadataStale === true\`, continue
+normally. Do not ask the user to switch models; this is an accepted Codex host
+metadata mismatch.
 
 If a linked/local skill file is stale or missing, silently use the installed
 \`sellable@sellable\` plugin copy. Do not tell the user about the stale link,
@@ -1260,8 +1308,10 @@ updates.
 5. Call \`mcp__sellable__bootstrap_create_campaign({ flowVersion: "v2", campaignId?, host?, model?, reasoningEffort? })\`.
    Pass the current host, model, and reasoning when the host exposes them.
 6. If \`safeToProceed !== true\`, stop and show \`blockingErrors\` + \`nextStep\`.
-7. If \`modelQuality.status === "warn"\`, show \`modelQuality.message\` before any
-   setup/research and wait for the user to switch or explicitly continue.
+7. If \`modelQuality.status === "warn"\` and \`modelQuality.metadataStale !== true\`,
+   show \`modelQuality.message\` before any setup/research and wait for the user
+   to switch or explicitly continue. If \`metadataStale === true\`, continue
+   normally and do not tell the user to switch.
 
 ## Execute Workflow
 
@@ -1819,7 +1869,7 @@ function codexPluginSkills() {
       dir: "sellable-create-campaign",
       displayName: "Sellable Create Campaign",
       description: "Create a Sellable campaign with approval gates",
-      skillMd: createCampaignSkillMd(),
+      skillMd: createCampaignSkillMd({ host: "codex" }),
       soulMd: createCampaignSoulMd(),
     },
     {
@@ -2043,7 +2093,7 @@ function claudeCommands() {
       filename: join("sellable", "create-campaign.md"),
       description: "Create a Sellable campaign through the approval-gated workflow.",
       argumentHint: "[campaign goal, company, or offer]",
-      skillMd: createCampaignSkillMd(),
+      skillMd: createCampaignSkillMd({ host: "claude" }),
       allowedTools: ["AskUserQuestion", "Task", ...CREATE_CAMPAIGN_ALLOWED_TOOLS],
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.209",
+  "version": "0.1.211",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code and Codex",
   "bin": {

package/skill-templates/create-campaign.md

@@ -179,11 +179,17 @@ person/company this campaign is for, then I’ll turn that into a campaign brief
 before we move into lead sourcing.
 ```
 
-Exception: if `bootstrap_create_campaign.modelQuality.status === "warn"`,
-the first visible campaign message must be the model-quality warning from
+Exception: if `bootstrap_create_campaign.modelQuality.status === "warn"` and
+`bootstrap_create_campaign.modelQuality.metadataStale !== true`, the first
+visible campaign message must be the model-quality warning from
 `modelQuality.message`. Ask the user to switch to the configured minimum model
 or explicitly continue anyway before identity setup, research, lead filtering,
-message generation, or launch review.
+message generation, or launch review. If `metadataStale === true`, continue
+normally and do not ask the user to switch.
+
+If `bootstrap_create_campaign.modelQuality.metadataStale === true`, continue
+normally. Do not ask the user to switch models; this is an accepted Codex host
+metadata mismatch.
 
 If a linked/local skill file is stale or missing, silently use the installed
 `sellable@sellable` plugin copy. Do not tell the user about the stale link,
@@ -769,9 +775,10 @@ messages, and wait for final launch approval.
 What's your LinkedIn profile URL or handle?
 ```
 
-Do not silently ask Codex intake or approval questions as plain chat when
-`request_user_input` is unavailable in an interactive session. Stop and tell
-the user:
+Codex only: do not silently ask intake or approval questions as plain chat when
+`request_user_input` is unavailable in an interactive Codex session. Claude Code
+uses `AskUserQuestion`; do not apply this Codex setup blocker in Claude Code.
+In Codex, stop and tell the user:
 
 ```text
 I need Codex’s quick question panel to collect campaign inputs and approvals cleanly.
@@ -810,17 +817,18 @@ there.
 ## Bootstrap
 
 MCP tool access is required. First call `mcp__sellable__get_auth_status({})`
-directly. If that tool is unavailable, stop and say this is a Codex
-install/reload problem, not a campaign problem. Tell the user to
-run `curl -fsSL "https://app.sellable.dev/api/v2/cli/install" | sh` so the
-packaged MCP server, Codex Desktop plugin, and Sellable skill bundle are
-installed. If they want an agent-readable checklist, tell them:
+directly. If that tool is unavailable, stop and say this is a Sellable
+install/reload problem for the current host, not a campaign problem. Tell the
+user to run `curl -fsSL "https://app.sellable.dev/api/v2/cli/install" | sh` so
+the packaged MCP server and the current host integration are installed. If they
+want an agent-readable checklist, tell them:
 `Install Sellable CLI and skills using https://app.sellable.dev/agent-install.txt`.
 For CLI verification, tell them to run
 `sellable --verify-only --host all --json --artifact "$HOME/.local/sellable/app-sellable-dev/installer/.last-verify.json"`.
-After that, they must fully quit and reopen Codex Desktop before starting a new
-thread. Do not use `scripts/mcp/sellable-tool-call.mjs`, `npm run`, `node`, or
-any local harness as a fallback for this interactive skill.
+After that, they must fully quit and reopen the current host app before starting
+a new thread. In Codex, say Codex Desktop. In Claude Code, say Claude Code. Do
+not use `scripts/mcp/sellable-tool-call.mjs`, `npm run`, `node`, or any local
+harness as a fallback for this interactive skill.
 Do not mention prompt loading, local skill files, missing linked versions,
 plugin cache paths, MCP namespaces, or runbooks in customer-facing progress
 updates.
@@ -932,11 +940,15 @@ updates.
    - Do not call `mcp__sellable__get_campaigns`.
    - Do not call `mcp__sellable__get_campaign` to hunt for IDs.
    - Do not call `mcp__sellable__create_campaign({ campaignId: ... })` unless the user supplied that id.
-6. Call `mcp__sellable__bootstrap_create_campaign({ flowVersion: "v2", campaignId?, host?, model?, reasoningEffort? })`.
-   Pass the current host, model, and reasoning when the host exposes them.
+6. Call `mcp__sellable__bootstrap_create_campaign({ flowVersion: "v2", campaignId?, host, model?, reasoningEffort? })`.
+   Pass the explicit current host label: `host: "Codex"` from Codex and
+   `host: "Claude Code"` from Claude Code. Also pass the current model and
+   reasoning when the host exposes them.
 7. If `safeToProceed !== true`, stop and show `blockingErrors` + `nextStep`.
-8. If `modelQuality.status === "warn"`, show `modelQuality.message` before any
-   setup/research and wait for the user to switch or explicitly continue.
+8. If `modelQuality.status === "warn"` and `modelQuality.metadataStale !== true`,
+   show `modelQuality.message` before any setup/research and wait for the user
+   to switch or explicitly continue. If `metadataStale === true`, continue
+   normally and do not tell the user to switch.
 
 ## Execute Workflow