@sellable/install 0.1.28 → 0.1.30

package/bin/sellable-install.mjs

@@ -5,12 +5,12 @@ import {
   mkdirSync,
   readFileSync,
   rmSync,
+  symlinkSync,
   writeFileSync,
 } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { stdin as input, stdout as output } from "node:process";
-import { createInterface } from "node:readline/promises";
+import { dirname, join, relative } from "node:path";
+import { stdout as output } from "node:process";
 
 const DEFAULT_API_URL = "https://app.sellable.dev";
 const DEFAULT_SERVER_PACKAGE =
@@ -40,6 +40,62 @@ const CODEX_PLUGIN_COMPAT_VERSIONS = [
 const INSTALL_PACKAGE_SPEC =
   process.env.SELLABLE_INSTALL_PACKAGE_SPEC || "@sellable/install@latest";
 
+const useColor = Boolean(output.isTTY) && process.env.NO_COLOR === undefined;
+const C = {
+  reset: useColor ? "\x1b[0m" : "",
+  green: useColor ? "\x1b[32m" : "",
+  cyan: useColor ? "\x1b[36m" : "",
+  yellow: useColor ? "\x1b[33m" : "",
+  grey: useColor ? "\x1b[90m" : "",
+  bold: useColor ? "\x1b[1m" : "",
+  magenta: useColor ? "\x1b[35m" : "",
+};
+
+let VERBOSE = false;
+
+function logVerbose(line) {
+  if (VERBOSE) console.log(line);
+}
+
+function logMilestone(line) {
+  console.log(`  ${C.green}✓${C.reset} ${line}`);
+}
+
+function logWarn(line) {
+  console.log(`  ${C.yellow}!${C.reset} ${line}`);
+}
+
+function logStep(line) {
+  console.log(`  ${C.grey}${line}${C.reset}`);
+}
+
+function printBanner() {
+  const cols = output.columns || 80;
+  if (output.isTTY && cols >= 70) {
+    const lines = [
+      " ███████╗ ███████╗ ██╗      ██╗      █████╗  ██████╗  ██╗      ███████╗",
+      " ██╔════╝ ██╔════╝ ██║      ██║     ██╔══██╗ ██╔══██╗ ██║      ██╔════╝",
+      " ███████╗ █████╗   ██║      ██║     ███████║ ██████╔╝ ██║      █████╗  ",
+      " ╚════██║ ██╔══╝   ██║      ██║     ██╔══██║ ██╔══██╗ ██║      ██╔══╝  ",
+      " ███████║ ███████╗ ███████╗ ███████╗██║  ██║ ██████╔╝ ███████╗ ███████╗",
+      " ╚══════╝ ╚══════╝ ╚══════╝ ╚══════╝╚═╝  ╚═╝ ╚═════╝  ╚══════╝ ╚══════╝",
+    ];
+    console.log("");
+    for (const line of lines) console.log(`${C.magenta}${line}${C.reset}`);
+    console.log("");
+  } else {
+    console.log("");
+    console.log(`${C.bold}${C.magenta}SELLABLE${C.reset}`);
+    console.log("");
+  }
+}
+
+function printDivider() {
+  console.log(
+    `${C.cyan}────────────────────────────────────────────────────────────${C.reset}`
+  );
+}
+
 function usage() {
   return `Sellable agent installer
 
@@ -56,14 +112,20 @@ Options:
   --mcp-package <pkg>       MCP server package. Default: ${DEFAULT_SERVER_PACKAGE}
   --local-command <cmd>     Local MCP command for --server local.
   --hosted-url <url>        Hosted MCP URL for --server hosted.
+  --verbose                 Print every file write and shell command.
   --dry-run                 Print actions without writing or running host commands.
   --verify-only             Verify installed host config where possible.
   --help                    Show help.
 
 Auth:
-  Sign up or log in at ${DEFAULT_API_URL}/settings, create an API token, then
-  pass it with --token or SELLABLE_TOKEN. In an interactive terminal, the
-  installer will prompt for missing auth values.
+  Install is auth-free by default. Sign in happens on the first run of
+  /sellable:create-campaign in Claude Code or Codex, where the agent walks
+  you through signup or sign-in and stores credentials in
+  ~/.sellable/config.json.
+
+  For CI/scripted installs, pass --token + --workspace-id or set
+  SELLABLE_TOKEN + SELLABLE_WORKSPACE_ID and the installer will write the
+  config file directly without prompting.
 `;
 }
 
@@ -79,6 +141,7 @@ function parseArgs(argv) {
     hostedUrl: process.env.SELLABLE_MCP_HOSTED_URL || "",
     dryRun: false,
     verifyOnly: false,
+    verbose: false,
   };
 
   for (let i = 0; i < argv.length; i += 1) {
@@ -114,6 +177,8 @@ function parseArgs(argv) {
       opts.dryRun = true;
     } else if (arg === "--verify-only") {
       opts.verifyOnly = true;
+    } else if (arg === "--verbose") {
+      opts.verbose = true;
     } else {
       throw new Error(`Unknown option: ${arg}`);
     }
@@ -137,13 +202,13 @@ function redact(value) {
 
 function run(command, args, opts = {}) {
   const rendered = [command, ...args].join(" ");
-  console.log(
-    `+ ${rendered.replace(opts.token || "__NO_TOKEN__", "[redacted-token]")}`
+  logVerbose(
+    `${C.grey}+ ${rendered.replace(opts.token || "__NO_TOKEN__", "[redacted-token]")}${C.reset}`
   );
   if (opts.dryRun) return { status: 0, stdout: "", stderr: "" };
   const result = spawnSync(command, args, {
     encoding: "utf8",
-    stdio: "pipe",
+    stdio: VERBOSE ? "inherit" : "pipe",
   });
   if (result.status !== 0 && !opts.allowFail) {
     const stderr = (result.stderr || "").trim();
@@ -159,10 +224,6 @@ function commandExists(command) {
   return result.status === 0;
 }
 
-function isInteractive() {
-  return Boolean(input.isTTY && output.isTTY);
-}
-
 function authPath() {
   return join(homedir(), ".sellable", "config.json");
 }
@@ -190,7 +251,7 @@ function readStoredAuth() {
   return raw ? normalizeStoredAuth(raw) : null;
 }
 
-async function promptForMissingAuth(opts) {
+async function loadAuthIfPresent(opts) {
   if (opts.token && opts.workspaceId) return opts;
 
   const stored = readStoredAuth();
@@ -199,58 +260,19 @@ async function promptForMissingAuth(opts) {
     opts.workspaceId ||= stored.workspaceId;
     opts.apiUrl = opts.apiUrl || stored.apiUrl || DEFAULT_API_URL;
     opts.authFromExistingConfig = true;
-    console.log(`Using existing Sellable auth config: ${authPath()}`);
-    return opts;
-  }
-
-  if (!isInteractive()) {
-    throw new Error(
-      [
-        "Missing Sellable token/workspace id.",
-        `Create a token at ${opts.apiUrl}/settings, then rerun:`,
-        `  npx -y ${INSTALL_PACKAGE_SPEC} --host all --token <token> --workspace-id <workspace_id>`,
-        "",
-        "You can also use SELLABLE_TOKEN and SELLABLE_WORKSPACE_ID.",
-      ].join("\n")
-    );
-  }
-
-  console.log("");
-  console.log(
-    "Sellable needs one API token to connect Claude/Codex to your workspace."
-  );
-  console.log(
-    `Open ${opts.apiUrl}/settings, create a token, then paste the values below.`
-  );
-  console.log(`Auth will be stored once at ${authPath()}.`);
-  console.log("");
-
-  const rl = createInterface({ input, output });
-  try {
-    if (!opts.token) {
-      opts.token = (await rl.question("Sellable API token: ")).trim();
-    }
-    if (!opts.workspaceId) {
-      opts.workspaceId = (await rl.question("Sellable workspace id: ")).trim();
-    }
-  } finally {
-    rl.close();
-  }
-
-  if (!opts.token || !opts.workspaceId) {
-    throw new Error("Sellable token and workspace id are both required.");
   }
-
   return opts;
 }
 
 function writeJson(path, data, opts) {
-  const redacted = JSON.stringify(
-    { ...data, token: redact(data.token) },
-    null,
-    2
-  );
-  console.log(`Writing ${path}: ${redacted}`);
+  if (VERBOSE) {
+    const redacted = JSON.stringify(
+      { ...data, token: redact(data.token) },
+      null,
+      2
+    );
+    logVerbose(`${C.grey}Writing ${path}: ${redacted}${C.reset}`);
+  }
   if (opts.dryRun) return;
   mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
   writeFileSync(path, `${JSON.stringify(data, null, 2)}\n`, { mode: 0o600 });
@@ -317,12 +339,25 @@ function upsertTomlBoolean(content, tableName, key, value) {
 }
 
 function writeFile(path, content, opts, mode = 0o644) {
-  console.log(`Writing ${path}`);
+  logVerbose(`${C.grey}Writing ${path}${C.reset}`);
   if (opts.dryRun) return;
   mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
   writeFileSync(path, content, { mode });
 }
 
+function ensureSymlink(target, linkPath, opts) {
+  logVerbose(`${C.grey}Linking ${linkPath} -> ${target}${C.reset}`);
+  if (opts.dryRun) return;
+  mkdirSync(dirname(linkPath), { recursive: true, mode: 0o700 });
+  try {
+    rmSync(linkPath, { recursive: true, force: true });
+  } catch {
+    // ignore
+  }
+  const rel = relative(dirname(linkPath), target);
+  symlinkSync(rel, linkPath, "dir");
+}
+
 function codexPluginManifest(opts) {
   return {
     name: "sellable",
@@ -1062,13 +1097,7 @@ function installCodexDesktopPlugin(opts) {
   );
   const pluginRoot = join(marketplaceRoot, "plugins", "sellable");
   const cacheRoot = join(home, "plugins", "cache", "sellable", "sellable");
-  const pluginCache = join(cacheRoot, CODEX_PLUGIN_VERSION);
-  const pluginCacheVersions = [
-    CODEX_PLUGIN_VERSION,
-    ...CODEX_PLUGIN_COMPAT_VERSIONS.filter(
-      (version) => version !== CODEX_PLUGIN_VERSION
-    ),
-  ];
+  const canonicalCachePath = join(cacheRoot, CODEX_PLUGIN_VERSION);
 
   const marketplace = {
     name: "sellable",
@@ -1110,23 +1139,24 @@ function installCodexDesktopPlugin(opts) {
   if (!opts.dryRun) {
     rmSync(cacheRoot, { recursive: true, force: true });
   }
-  for (const version of pluginCacheVersions) {
-    const cachePath = join(cacheRoot, version);
-    writeFile(
-      join(cachePath, ".codex-plugin", "plugin.json"),
-      `${JSON.stringify(
-        { ...manifest, version: CODEX_PLUGIN_VERSION },
-        null,
-        2
-      )}\n`,
-      opts
-    );
-    writeFile(
-      join(cachePath, ".mcp.json"),
-      `${JSON.stringify(mcp, null, 2)}\n`,
-      opts
-    );
-    writeCodexPluginSkills(cachePath, opts);
+
+  // Write canonical version once
+  writeFile(
+    join(canonicalCachePath, ".codex-plugin", "plugin.json"),
+    `${JSON.stringify({ ...manifest, version: CODEX_PLUGIN_VERSION }, null, 2)}\n`,
+    opts
+  );
+  writeFile(
+    join(canonicalCachePath, ".mcp.json"),
+    `${JSON.stringify(mcp, null, 2)}\n`,
+    opts
+  );
+  writeCodexPluginSkills(canonicalCachePath, opts);
+
+  // Symlink older compat versions to canonical (one ln per version, no file copy)
+  for (const version of CODEX_PLUGIN_COMPAT_VERSIONS) {
+    if (version === CODEX_PLUGIN_VERSION) continue;
+    ensureSymlink(canonicalCachePath, join(cacheRoot, version), opts);
   }
 
   if (!opts.dryRun) {
@@ -1162,28 +1192,31 @@ enabled = false`
     );
     writeFileSync(configPath, `${content.trimEnd()}\n`, { mode: 0o600 });
   } else {
-    console.log(`+ upsert [marketplaces.sellable] in ${configPath}`);
-    console.log(`+ enable [plugins."sellable@sellable"] in ${configPath}`);
-    console.log(
-      `+ disable stale [plugins."sellable@sellable-local"] in ${configPath}`
+    logVerbose(
+      `${C.grey}+ upsert [marketplaces.sellable] in ${configPath}${C.reset}`
     );
-    console.log(
-      `+ enable [features].default_mode_request_user_input in ${configPath}`
+    logVerbose(
+      `${C.grey}+ enable [plugins."sellable@sellable"] in ${configPath}${C.reset}`
+    );
+    logVerbose(
+      `${C.grey}+ enable [features].default_mode_request_user_input in ${configPath}${C.reset}`
     );
   }
 
-  console.log("Codex Desktop plugin installed:");
-  console.log(`- marketplace: ${marketplaceRoot}`);
-  console.log(`- plugin:      sellable@sellable`);
-  console.log(`- cache:       ${pluginCache}`);
-  console.log(`- compat:      ${CODEX_PLUGIN_COMPAT_VERSIONS.join(", ")}`);
+  return {
+    marketplaceRoot,
+    canonicalCachePath,
+    compatCount: CODEX_PLUGIN_COMPAT_VERSIONS.length,
+  };
 }
 
 function writeAuth(opts) {
   if (!opts.token || !opts.workspaceId) {
-    throw new Error(
-      `Missing Sellable token/workspace id. Create a token at ${opts.apiUrl}/settings, then rerun with --token and --workspace-id or SELLABLE_TOKEN and SELLABLE_WORKSPACE_ID.`
-    );
+    return { written: false, reused: false };
+  }
+
+  if (opts.authFromExistingConfig) {
+    return { written: false, reused: true };
   }
 
   const config = {
@@ -1191,16 +1224,8 @@ function writeAuth(opts) {
     activeWorkspaceId: opts.workspaceId,
     apiUrl: opts.apiUrl,
   };
-
-  if (opts.authFromExistingConfig) {
-    console.log(
-      `Leaving existing Sellable auth config unchanged: ${authPath()}`
-    );
-    return;
-  }
-
-  const sellablePath = authPath();
-  writeJson(sellablePath, config, opts);
+  writeJson(authPath(), config, opts);
+  return { written: true, reused: false };
 }
 
 function installSelfShim(opts) {
@@ -1234,7 +1259,7 @@ function installClaude(opts) {
     const message =
       "Claude CLI not found. Install/login to Claude Code, then rerun: sellable --host claude";
     if (opts.host === "all") {
-      console.log(`Skipping Claude Code: ${message}`);
+      logWarn(`Skipping Claude Code: ${message}`);
       return false;
     }
     throw new Error(message);
@@ -1266,15 +1291,15 @@ function installCodex(opts) {
     const message =
       "Codex CLI not found. Install/login to Codex, then rerun: sellable --host codex";
     if (opts.host === "all") {
-      console.log(`Skipping Codex: ${message}`);
-      return false;
+      logWarn(`Skipping Codex: ${message}`);
+      return { installed: false };
     }
     throw new Error(message);
   }
   if (opts.server === "hosted") {
     run("codex", ["mcp", "add", "sellable", "--url", opts.hostedUrl], opts);
-    installCodexDesktopPlugin(opts);
-    return true;
+    const info = installCodexDesktopPlugin(opts);
+    return { installed: true, ...info };
   }
   const [command, args] = mcpCommand(opts);
   run("codex", ["mcp", "remove", "sellable"], {
@@ -1283,27 +1308,35 @@ function installCodex(opts) {
     allowFail: true,
   });
   run("codex", ["mcp", "add", "sellable", "--", command, ...args], opts);
-  installCodexDesktopPlugin(opts);
-  return true;
+  const info = installCodexDesktopPlugin(opts);
+  return { installed: true, ...info };
 }
 
 function verify(opts) {
   const stored = readStoredAuth();
-  if (!stored?.token || !stored?.workspaceId) {
-    throw new Error(
-      `Sellable auth config missing or incomplete: ${authPath()}`
-    );
+  const checks = [];
+  if (stored?.token && stored?.workspaceId) {
+    checks.push({ ok: true, label: `Auth config: ${authPath()}` });
+  } else {
+    checks.push({
+      ok: true,
+      label: `Auth: not yet signed in — sign in on first run of /sellable:create-campaign`,
+    });
   }
-  console.log(`Sellable auth config present: ${authPath()}`);
+
   if (opts.host === "claude" || opts.host === "all") {
-    console.log(
-      commandExists("claude") ? "Claude CLI present" : "Claude CLI missing"
-    );
+    checks.push({
+      ok: commandExists("claude"),
+      label: commandExists("claude")
+        ? "Claude CLI present"
+        : "Claude CLI missing",
+    });
   }
   if (opts.host === "codex" || opts.host === "all") {
-    console.log(
-      commandExists("codex") ? "Codex CLI present" : "Codex CLI missing"
-    );
+    checks.push({
+      ok: commandExists("codex"),
+      label: commandExists("codex") ? "Codex CLI present" : "Codex CLI missing",
+    });
     const pluginPath = join(
       codexHome(),
       "plugins",
@@ -1325,45 +1358,81 @@ function verify(opts) {
       "sellable-create-campaign",
       "SKILL.md"
     );
-    console.log(
-      existsSync(pluginPath)
+    checks.push({
+      ok: existsSync(pluginPath),
+      label: existsSync(pluginPath)
         ? "Codex Desktop plugin present"
-        : "Codex Desktop plugin missing"
-    );
-    console.log(
-      existsSync(skillPath)
+        : "Codex Desktop plugin missing",
+    });
+    checks.push({
+      ok: existsSync(skillPath),
+      label: existsSync(skillPath)
         ? "Codex skill bundle present"
-        : "Codex skill bundle missing"
-    );
+        : "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"
+    const hasFlag = configContent.includes(
+      "default_mode_request_user_input = true"
     );
+    checks.push({
+      ok: hasFlag,
+      label: hasFlag
+        ? "Codex Default-mode request_user_input enabled"
+        : "Codex Default-mode request_user_input missing",
+    });
+  }
+
+  for (const c of checks) {
+    if (c.ok) logMilestone(c.label);
+    else logWarn(c.label);
   }
 }
 
 function printNextSteps(installedHosts) {
   console.log("");
-  console.log("Next steps:");
+  printDivider();
+  console.log(`  ${C.bold}Next steps${C.reset}`);
+  printDivider();
+  console.log("");
   if (installedHosts.length > 0) {
     console.log(
-      `1. Fully quit and reopen ${installedHosts.join(" and ")} so MCP tools reload.`
+      `  1. Quit and reopen ${installedHosts.join(" and ")} so MCP tools reload.`
     );
-    console.log("2. Start a new thread and choose Sellable Create Campaign.");
+    console.log("  2. Start a new thread and run:");
+    if (installedHosts.includes("Claude Code")) {
+      console.log(
+        `     ${C.cyan}/sellable:create-campaign${C.reset}     ${C.grey}(Claude Code)${C.reset}`
+      );
+    }
+    if (installedHosts.includes("Codex")) {
+      console.log(
+        `     ${C.cyan}$sellable:create-campaign${C.reset}     ${C.grey}(Codex)${C.reset}`
+      );
+    }
+    console.log(
+      `     ${C.grey}Sellable will walk you through signup or sign-in on first use.${C.reset}`
+    );
+    console.log("");
+    console.log(
+      `  Verify any time:  ${C.cyan}sellable --verify-only --host all${C.reset}`
+    );
+    console.log(`  Need help?`);
     console.log(
-      "3. If tools do not appear, run: sellable --verify-only --host all"
+      `    Slack:  ${C.cyan}https://join.slack.com/t/ditttoai/shared_invite/zt-3wvs86yau-csKZGP3iGXO3oEiAUmtH9A${C.reset}`
     );
+    console.log(`    Email:  ${C.cyan}admin@dittto.ai${C.reset}`);
   } else {
     console.log(
-      "1. Install Claude Code or Codex, then rerun this installer for that host."
+      "  1. Install Claude Code or Codex, then rerun this installer for that host."
+    );
+    console.log(
+      `  2. Verify auth later with: ${C.cyan}sellable --verify-only --host all${C.reset}`
     );
-    console.log("2. Verify auth later with: sellable --verify-only --host all");
   }
+  console.log("");
 }
 
 async function main() {
@@ -1374,38 +1443,84 @@ async function main() {
       return;
     }
 
-    console.log("Sellable installer");
-    console.log(`- host: ${opts.host}`);
-    console.log(`- server: ${opts.server}`);
-    if (opts.server === "package") {
-      console.log(`- mcp package: ${opts.mcpPackage}`);
+    VERBOSE = Boolean(opts.verbose);
+
+    if (!opts.verifyOnly) {
+      printBanner();
+      console.log(
+        `  ${C.bold}Connecting Sellable to Claude Code and Codex…${C.reset}`
+      );
+      console.log("");
+    } else {
+      printBanner();
+      console.log(`  ${C.bold}Verifying Sellable install…${C.reset}`);
+      console.log("");
+    }
+
+    if (VERBOSE) {
+      logStep(`host: ${opts.host}`);
+      logStep(`server: ${opts.server}`);
+      if (opts.server === "package") logStep(`mcp package: ${opts.mcpPackage}`);
+      logStep(`api: ${opts.apiUrl}`);
+      logStep(`token: ${opts.token ? redact(opts.token) : "(missing)"}`);
     }
-    console.log(`- api: ${opts.apiUrl}`);
-    console.log(`- token: ${opts.token ? redact(opts.token) : "(missing)"}`);
 
     const installedHosts = [];
     if (!opts.verifyOnly) {
-      await promptForMissingAuth(opts);
-      writeAuth(opts);
+      await loadAuthIfPresent(opts);
+      const authResult = writeAuth(opts);
       installSelfShim(opts);
+      if (authResult.reused) {
+        logMilestone(`Using existing auth config: ${authPath()}`);
+      } else if (authResult.written) {
+        logMilestone(`Authenticated (workspace: ${opts.workspaceId})`);
+      } else {
+        logMilestone(
+          "Sellable infrastructure ready — sign in happens on first /sellable:create-campaign"
+        );
+      }
+
       if (opts.host === "claude" || opts.host === "all") {
-        if (installClaude(opts)) installedHosts.push("Claude Code");
+        if (installClaude(opts)) {
+          installedHosts.push("Claude Code");
+          logMilestone("Claude Code MCP server registered");
+        }
       }
       if (opts.host === "codex" || opts.host === "all") {
-        if (installCodex(opts)) installedHosts.push("Codex");
+        const result = installCodex(opts);
+        if (result.installed) {
+          installedHosts.push("Codex");
+          logMilestone("Codex MCP server registered");
+          logMilestone(
+            `Codex Desktop plugin installed (sellable@sellable v${CODEX_PLUGIN_VERSION})`
+          );
+          logMilestone(
+            "Skill bundle: create-campaign, engage, interview, workflow-sequences"
+          );
+          if (result.compatCount) {
+            logMilestone(
+              `Backwards-compat cache linked (${result.compatCount} versions → symlinked, no copy)`
+            );
+          }
+          logMilestone("Codex Default-mode request_user_input enabled");
+        }
       }
     }
+
     if (opts.dryRun) {
-      console.log(
-        "Dry run complete; verification skipped because no files were written."
-      );
-    } else {
+      console.log("");
+      logStep("Dry run complete; no files were written.");
+    } else if (opts.verifyOnly) {
       verify(opts);
     }
-    console.log("Sellable install complete.");
-    if (!opts.verifyOnly && !opts.dryRun) printNextSteps(installedHosts);
+
+    if (!opts.verifyOnly && !opts.dryRun) {
+      printNextSteps(installedHosts);
+    }
   } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
+    console.error(
+      `${C.yellow}✗${C.reset} ${error instanceof Error ? error.message : String(error)}`
+    );
     process.exitCode = 1;
   }
 }

package/package.json

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