@sellable/install 0.1.7 → 0.1.9

package/README.md

@@ -47,12 +47,22 @@ Do not ask users to run `/sellable:create-campaign-v2`,
 ## Structured Questions
 
 Claude Code uses `AskUserQuestion`. Codex uses `request_user_input` when that
-tool is exposed in an interactive Plan/collaboration-mode session.
-`codex exec` is non-interactive, so it cannot show the structured questionnaire
-UI.
+tool is exposed in an interactive session. The installer enables Codex Default
+mode support by writing `default_mode_request_user_input = true` under
+`[features]` in `~/.codex/config.toml`. `codex exec` is non-interactive, so it
+cannot show the structured questionnaire UI.
 
 For Codex Desktop, the installer also writes a local Sellable plugin bundle into
 `~/.sellable/codex-marketplace`, includes the Sellable skill entrypoints, and
 enables it in `~/.codex/config.toml`.
 
+## Create-Campaign Soul
+
+The create-campaign workflow includes a `SOUL.md` identity for the Sellable
+campaign GTM engineer. It keeps the UX focused on launching a campaign: quick
+setup questions, campaign brief, lead sourcing, message review, and approval.
+It uses the phrase `quick question panel` for structured intake and approvals.
+It also tells the agent not to expose prompt-loading, MCP, plugin-cache, or tool
+names in normal customer-facing progress updates.
+
 If only one host is installed, `--host all` installs the available host and tells you how to add the other one later.

package/bin/sellable-install.mjs

@@ -15,7 +15,7 @@ import { createInterface } from "node:readline/promises";
 const DEFAULT_API_URL = "https://app.sellable.dev";
 const DEFAULT_SERVER_PACKAGE =
   process.env.SELLABLE_MCP_PACKAGE || "@sellable/mcp";
-const CODEX_PLUGIN_VERSION = "0.1.7";
+const CODEX_PLUGIN_VERSION = "0.1.9";
 const INSTALL_PACKAGE_SPEC = `@sellable/install@${CODEX_PLUGIN_VERSION}`;
 
 function usage() {
@@ -271,6 +271,29 @@ function upsertTomlTable(content, tableName, block) {
   return `${content.trimEnd()}\n\n${normalizedBlock}\n`;
 }
 
+function upsertTomlBoolean(content, tableName, key, value) {
+  const line = `${key} = ${value ? "true" : "false"}`;
+  const tablePattern = new RegExp(
+    `(^|\\n)(\\[${escapeRegExp(tableName)}\\]\\n)([\\s\\S]*?)(?=\\n\\[[^\\n]+\\]|$)`
+  );
+
+  if (!tablePattern.test(content)) {
+    return `${content.trimEnd()}\n\n[${tableName}]\n${line}\n`;
+  }
+
+  return content.replace(tablePattern, (_, prefix, header, body) => {
+    const keyPattern = new RegExp(
+      `(^|\\n)\\s*${escapeRegExp(key)}\\s*=.*`,
+      "m"
+    );
+    const updatedBody = keyPattern.test(body)
+      ? body.replace(keyPattern, `$1${line}`)
+      : `${body.trimEnd()}${body.trimEnd() ? "\n" : ""}${line}\n`;
+
+    return `${prefix}${header}${updatedBody.trimEnd()}`;
+  });
+}
+
 function writeFile(path, content, opts, mode = 0o644) {
   console.log(`Writing ${path}`);
   if (opts.dryRun) return;
@@ -429,6 +452,22 @@ ${allowedToolsYaml(CREATE_CAMPAIGN_ALLOWED_TOOLS)}
 
 Use this as the customer-facing entrypoint for Sellable campaign creation.
 
+## Command Soul
+
+You are the Sellable campaign GTM engineer. The user is a founder or operator
+who wants a LinkedIn campaign launched, not a developer debugging an agent
+runtime. Translate the workflow into clear business decisions, tradeoffs, and
+approval gates. Use product language:
+
+- "quick question panel", not \`request_user_input\`
+- "campaign brief", not prompt artifact
+- "lead source", not provider internals unless comparing source options
+- "nothing is created until you approve", not mutation jargon
+
+Never mention MCP namespaces, prompt chunking, plugin cache paths, missing
+linked skill versions, runbooks, or local skill files in normal customer-facing
+copy.
+
 ## Names To Use
 
 Use these exact public names so Claude Code and Codex do not drift:
@@ -451,15 +490,64 @@ Do not tell users to run \`/sellable:create-campaign-v2\`,
 Use the host-native structured question gate for intake and approval:
 
 - Claude Code: \`AskUserQuestion\`
-- Codex: \`request_user_input\` when exposed in an interactive
-  Plan/collaboration-mode session
+- Codex: \`request_user_input\` when exposed in an interactive session. The
+  installer enables this in Default mode with
+  \`[features].default_mode_request_user_input = true\`.
+
+Customer-facing language must call this the "quick question panel." Do not tell
+customers about \`request_user_input\`, Default mode, plugin caches, prompt
+loading, or skill file versions.
+
+Before the first intake gate, use this customer-facing shape:
+
+\`\`\`text
+I’m ready to build the campaign in {workspace}.
+
+First I’ll ask 4 quick setup questions:
+1. who you want to target
+2. what you want them to do
+3. what proof or offer we should use
+4. where we should source leads
+
+Then I’ll turn that into a campaign brief for you to approve before anything is created.
+\`\`\`
 
 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 to switch to Plan mode / collaboration mode, then rerun
-\`$sellable:create-campaign\`. Plain chat questions are only acceptable in
-non-interactive \`codex exec\` smoke/rehearsal runs because structured user
-input is unavailable by design there.
+the user:
+
+\`\`\`text
+I need Codex’s quick question panel to collect campaign inputs and approvals cleanly.
+
+It isn’t enabled in this Codex session yet. I can fix that by updating your Codex settings once, then you’ll reopen Codex and run this again.
+
+Can I update your Codex settings so Sellable can use the quick question panel?
+\`\`\`
+
+If they approve, update \`~/.codex/config.toml\` so
+\`[features].default_mode_request_user_input = true\`, then tell them:
+
+\`\`\`text
+Done. Please fully quit and reopen Codex, then run:
+
+$sellable:create-campaign
+
+After that, I’ll ask the 4 setup questions and start the campaign brief.
+\`\`\`
+
+If they decline, tell them:
+
+\`\`\`text
+No problem. You can still continue by switching Codex to Plan mode and running:
+
+$sellable:create-campaign
+
+I won’t create or change anything in Sellable until you approve the final campaign.
+\`\`\`
+
+Plain chat questions are only acceptable in non-interactive \`codex exec\`
+smoke/rehearsal runs because structured user input is unavailable by design
+there.
 
 ## Bootstrap
 
@@ -472,6 +560,9 @@ CLI verification, tell them to run \`sellable --verify-only --host all\`. 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.
+Do not mention prompt loading, local skill files, missing linked versions,
+plugin cache paths, MCP namespaces, or runbooks in customer-facing progress
+updates.
 
 1. Call \`mcp__sellable__get_auth_status({})\`.
 2. If auth is not OK, stop and show the returned guidance.
@@ -548,6 +639,47 @@ If subskill lookup fails, use \`mcp__sellable__search_subskill_prompts({ query:
 `;
 }
 
+function createCampaignSoulMd() {
+  return `# Sellable Campaign GTM Engineer Soul
+
+## Role
+
+You are the Sellable campaign GTM engineer. The user is a founder or operator
+who wants a LinkedIn campaign launched, not a developer debugging an agent
+runtime. Your job is to translate expert outbound work into clear choices,
+drafts, and approval gates.
+
+## Voice
+
+- Calm, direct, and useful.
+- Operator language, not agent language.
+- "quick question panel" beats \`request_user_input\`.
+- "I’ll build the brief" beats "I loaded the prompt."
+- "no campaign is created until you approve" beats mutation jargon.
+
+## Normal Progress Shape
+
+Every customer-facing update should say what Sellable learned, what decision is
+being made, what the user will see next, or what is protected until approval.
+
+## Setup Blocker Translation
+
+If the quick question panel is unavailable, ask:
+
+\`\`\`text
+I need Codex’s quick question panel to collect campaign inputs and approvals cleanly.
+
+It isn’t enabled in this Codex session yet. I can fix that by updating your Codex settings once, then you’ll reopen Codex and run this again.
+
+Can I update your Codex settings so Sellable can use the quick question panel?
+\`\`\`
+
+Only mention \`~/.codex/config.toml\` and
+\`[features].default_mode_request_user_input = true\` if the user asks what
+will change or after they approve the settings update.
+`;
+}
+
 function codexPluginSkills() {
   return [
     {
@@ -555,6 +687,7 @@ function codexPluginSkills() {
       displayName: "Sellable Create Campaign",
       description: "Create a Sellable campaign with approval gates",
       skillMd: createCampaignSkillMd(),
+      soulMd: createCampaignSoulMd(),
     },
     {
       dir: "sellable-engage",
@@ -596,6 +729,9 @@ function writeCodexPluginSkills(pluginRoot, opts) {
   for (const skill of codexPluginSkills()) {
     const skillRoot = join(pluginRoot, "skills", skill.dir);
     writeFile(join(skillRoot, "SKILL.md"), skill.skillMd, opts);
+    if (skill.soulMd) {
+      writeFile(join(skillRoot, "SOUL.md"), skill.soulMd, opts);
+    }
     writeFile(
       join(skillRoot, "agents", "openai.yaml"),
       codexSkillOpenAiYaml(skill.displayName, skill.description),
@@ -695,6 +831,12 @@ enabled = true`
       `[plugins."sellable@sellable-local"]
 enabled = false`
     );
+    content = upsertTomlBoolean(
+      content,
+      "features",
+      "default_mode_request_user_input",
+      true
+    );
     writeFileSync(configPath, `${content.trimEnd()}\n`, { mode: 0o600 });
   } else {
     console.log(`+ upsert [marketplaces.sellable] in ${configPath}`);
@@ -702,6 +844,9 @@ enabled = false`
     console.log(
       `+ disable stale [plugins."sellable@sellable-local"] in ${configPath}`
     );
+    console.log(
+      `+ enable [features].default_mode_request_user_input in ${configPath}`
+    );
   }
 
   console.log("Codex Desktop plugin installed:");
@@ -858,6 +1003,15 @@ function verify(opts) {
         ? "Codex skill bundle present"
         : "Codex skill bundle missing"
     );
+    const configPath = join(codexHome(), "config.toml");
+    const configContent = existsSync(configPath)
+      ? readFileSync(configPath, "utf8")
+      : "";
+    console.log(
+      configContent.includes("default_mode_request_user_input = true")
+        ? "Codex Default-mode request_user_input enabled"
+        : "Codex Default-mode request_user_input missing"
+    );
   }
 }
 

package/package.json

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