deepline 0.1.105 → 0.1.107

package/dist/cli/index.js

@@ -241,12 +241,23 @@ var SDK_RELEASE = {
   // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
   // 0.1.105 ships the billing catalog surface: billing plans, subscribe,
   // subscription status/cancel, invoices, and the client.billing namespace.
-  version: "0.1.105",
+  // 0.1.106 ships play cell provenance metadata and v2 preview retry hardening.
+  // 0.1.107 ships the v2 quickstart command, the deepline-plays-quickstart
+  // skill on the sdk sync surface, and the people-search-to-email prebuilt.
+  version: "0.1.107",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.105",
+    latest: "0.1.107",
     minimumSupported: "0.1.53",
-    deprecatedBelow: "0.1.53"
+    deprecatedBelow: "0.1.53",
+    commandMinimumSupported: [
+      {
+        command: "enrich",
+        minimumSupported: "0.1.106",
+        reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
+      }
+    ],
+    autoUpdatePatchLag: 2
   }
 };
 
@@ -3168,7 +3179,7 @@ function shouldSkipCompatibilityCheck() {
   const value = process.env.DEEPLINE_SKIP_SDK_COMPAT_CHECK?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes";
 }
-async function checkSdkCompatibility(baseUrl) {
+async function checkSdkCompatibility(baseUrl, options = {}) {
   if (shouldSkipCompatibilityCheck()) {
     return { response: null, error: null };
   }
@@ -3177,6 +3188,9 @@ async function checkSdkCompatibility(baseUrl) {
   try {
     const url = new URL("/api/v2/sdk/compat", baseUrl);
     url.searchParams.set("version", SDK_VERSION);
+    if (options.command?.trim()) {
+      url.searchParams.set("command", options.command.trim());
+    }
     const response = await fetch(url, {
       method: "GET",
       headers: {
@@ -3197,9 +3211,8 @@ async function checkSdkCompatibility(baseUrl) {
     clearTimeout(timeout);
   }
 }
-async function enforceSdkCompatibility(baseUrl) {
-  const { response, error } = await checkSdkCompatibility(baseUrl);
-  if (error || !response) {
+function enforceSdkCompatibilityResponse(response) {
+  if (!response) {
     return;
   }
   if (response.update_required) {
@@ -12271,8 +12284,13 @@ function exportableSheetRow(row) {
 function mergeExportColumns(preferredColumns, rows) {
   const columns = [];
   const seen = /* @__PURE__ */ new Set();
+  const hasActualColumn = (column) => rows.some((row) => Object.prototype.hasOwnProperty.call(row, column));
+  const hasCanonicalReplacement = (column) => {
+    const canonical = sqlSafeExportColumnName(column);
+    return canonical !== column && hasActualColumn(canonical);
+  };
   for (const column of preferredColumns) {
-    if (!column || seen.has(column)) {
+    if (!column || seen.has(column) || hasCanonicalReplacement(column)) {
       continue;
     }
     seen.add(column);
@@ -12280,7 +12298,7 @@ function mergeExportColumns(preferredColumns, rows) {
   }
   for (const row of rows) {
     for (const column of Object.keys(row)) {
-      if (seen.has(column)) {
+      if (seen.has(column) || hasCanonicalReplacement(column)) {
         continue;
       }
       seen.add(column);
@@ -12289,6 +12307,11 @@ function mergeExportColumns(preferredColumns, rows) {
   }
   return columns;
 }
+function sqlSafeExportColumnName(id) {
+  const normalized = id.trim().replace(/\.+/g, "__").replace(/[^A-Za-z0-9_]+/g, "_").replace(/^_+|_+$/g, "").toLowerCase();
+  const safe = normalized || "column";
+  return /^[A-Za-z_]/.test(safe) ? safe : `c_${safe}`;
+}
 async function fetchBackingDatasetRows(input2) {
   const playName = extractRunPlayName(input2.status);
   const tableNamespace = input2.rowsInfo.tableNamespace?.trim();
@@ -17940,6 +17963,244 @@ Examples:
   ).option("--org-id <id>", "Switch using an explicit organization id").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleOrgSwitch);
 }
 
+// src/cli/commands/quickstart.ts
+var import_node_child_process = require("child_process");
+var import_node_crypto4 = require("crypto");
+var import_node_http = require("http");
+var EXIT_OK2 = 0;
+var EXIT_AUTH2 = 1;
+var EXIT_SERVER3 = 2;
+var MAX_PROMPT_LENGTH = 8e3;
+var MAX_BODY_BYTES = 64 * 1024;
+function shellQuote(arg) {
+  return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+function hasClaudeBinary() {
+  try {
+    const result = (0, import_node_child_process.spawnSync)("claude", ["--version"], {
+      stdio: "ignore",
+      shell: process.platform === "win32"
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+function launchClaude(prompt) {
+  return new Promise((resolve16) => {
+    const child = (0, import_node_child_process.spawn)("claude", [prompt], {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("error", () => resolve16(EXIT_SERVER3));
+    child.on("close", (status) => resolve16(status ?? EXIT_OK2));
+  });
+}
+function readBody(req) {
+  return new Promise((resolve16, reject) => {
+    let raw = "";
+    req.setEncoding("utf8");
+    req.on("data", (chunk) => {
+      raw += chunk;
+      if (raw.length > MAX_BODY_BYTES) {
+        reject(new Error("Request body too large."));
+        req.destroy();
+      }
+    });
+    req.on("end", () => resolve16(raw));
+    req.on("error", reject);
+  });
+}
+function writeJson(res, status, payload) {
+  res.writeHead(status, { "content-type": "application/json" });
+  res.end(JSON.stringify(payload));
+}
+function startCallbackServer(input2) {
+  const server = (0, import_node_http.createServer)((req, res) => {
+    res.setHeader("Access-Control-Allow-Origin", req.headers.origin ?? "*");
+    res.setHeader("Vary", "Origin");
+    res.setHeader("Access-Control-Allow-Methods", "POST, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "content-type");
+    res.setHeader("Access-Control-Allow-Private-Network", "true");
+    res.setHeader("Access-Control-Max-Age", "600");
+    if (req.method === "OPTIONS") {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+    if (req.method !== "POST" || req.url !== "/submit") {
+      writeJson(res, 404, { error: "Not found." });
+      return;
+    }
+    void readBody(req).then((raw) => {
+      let body = null;
+      try {
+        body = JSON.parse(raw);
+      } catch {
+        body = null;
+      }
+      const state = typeof body?.state === "string" ? body.state : "";
+      const prompt = typeof body?.prompt === "string" ? body.prompt.trim() : "";
+      const workflowId = typeof body?.workflow_id === "string" && body.workflow_id.trim() ? body.workflow_id.trim() : null;
+      if (!state || state !== input2.state) {
+        writeJson(res, 403, { error: "Invalid quickstart state token." });
+        return;
+      }
+      if (!prompt) {
+        writeJson(res, 400, { error: "prompt is required." });
+        return;
+      }
+      if (prompt.length > MAX_PROMPT_LENGTH) {
+        writeJson(res, 400, {
+          error: `prompt exceeds ${MAX_PROMPT_LENGTH} characters.`
+        });
+        return;
+      }
+      writeJson(res, 200, { ok: true });
+      setImmediate(() => input2.onSelection({ prompt, workflowId }));
+    }).catch(() => {
+      writeJson(res, 400, { error: "Invalid request body." });
+    });
+  });
+  return new Promise((resolve16, reject) => {
+    server.once("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+      if (!address || typeof address === "string") {
+        reject(new Error("Failed to bind quickstart callback server."));
+        return;
+      }
+      resolve16({ server, port: address.port });
+    });
+  });
+}
+async function handleQuickstart(options) {
+  const jsonOutput = shouldEmitJson(options.json === true);
+  const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  let apiKey = resolveApiKeyForBaseUrl(baseUrl);
+  if (!apiKey) {
+    if (interactive) {
+      console.error("Not connected yet \u2014 registering this device first.");
+      const registerExit = await handleRegister([]);
+      if (registerExit !== EXIT_OK2) return registerExit;
+      apiKey = resolveApiKeyForBaseUrl(baseUrl);
+    }
+    if (!apiKey) {
+      console.error("Not connected. Run: deepline auth register");
+      return EXIT_AUTH2;
+    }
+  }
+  const state = (0, import_node_crypto4.randomBytes)(32).toString("hex");
+  let resolveSelection;
+  const selectionPromise = new Promise((resolve16) => {
+    resolveSelection = resolve16;
+  });
+  let callback;
+  try {
+    callback = await startCallbackServer({
+      state,
+      onSelection: (selection) => resolveSelection(selection)
+    });
+  } catch (error) {
+    console.error(
+      `Could not start the local quickstart listener: ${error instanceof Error ? error.message : String(error)}`
+    );
+    return EXIT_SERVER3;
+  }
+  const quickstartUrl = `${baseUrl}/cli/quickstart?cb=${callback.port}&state=${state}`;
+  console.error("  Opening the recipe picker in your browser.");
+  console.error(`  If it didn't open, cmd+click: ${quickstartUrl}`);
+  if (options.open !== false) {
+    openInBrowser(quickstartUrl);
+  }
+  const timeoutSeconds = Number.parseInt(options.timeout ?? "300", 10);
+  const timeoutMs = (Number.isFinite(timeoutSeconds) && timeoutSeconds > 0 ? timeoutSeconds : 300) * 1e3;
+  const timeoutHandle = setTimeout(
+    () => resolveSelection("timeout"),
+    timeoutMs
+  );
+  const progress = createCliProgress(!jsonOutput);
+  progress.phase("waiting for your pick in the browser (Ctrl+C to skip)");
+  const onSigint = () => resolveSelection("sigint");
+  process.once("SIGINT", onSigint);
+  const outcome = await selectionPromise;
+  clearTimeout(timeoutHandle);
+  process.removeListener("SIGINT", onSigint);
+  callback.server.close();
+  if (outcome === "sigint") {
+    progress.fail();
+    console.error("\nSkipped \u2014 run `deepline quickstart` anytime.");
+    return EXIT_OK2;
+  }
+  if (outcome === "timeout") {
+    progress.fail();
+    console.error(
+      "Timed out waiting for a selection. Run: deepline quickstart"
+    );
+    return EXIT_AUTH2;
+  }
+  progress.complete();
+  const { prompt, workflowId } = outcome;
+  const claudeCommand = `claude ${shellQuote(prompt)}`;
+  const claudeAvailable = hasClaudeBinary();
+  const willLaunch = options.launch !== false && !jsonOutput && interactive && claudeAvailable;
+  printCommandEnvelope(
+    {
+      status: "submitted",
+      workflowId,
+      prompt,
+      claudeCommand,
+      url: quickstartUrl,
+      launched: willLaunch,
+      render: {
+        sections: [
+          {
+            title: "quickstart",
+            lines: [
+              ...workflowId ? [`Recipe: ${workflowId}`] : [],
+              willLaunch ? "Launching Claude Code with your recipe..." : claudeAvailable ? "Run the command below to start your recipe." : "Claude Code not found. Install it (https://code.claude.com/docs/en/overview), then run the command below."
+            ]
+          }
+        ],
+        actions: [{ label: "Run", command: claudeCommand }]
+      }
+    },
+    { json: jsonOutput }
+  );
+  if (willLaunch) {
+    return launchClaude(prompt);
+  }
+  return EXIT_OK2;
+}
+function registerQuickstartCommands(program) {
+  program.command("quickstart").description(
+    "Pick a starter recipe in the browser and launch it with Claude Code."
+  ).addHelpText(
+    "after",
+    `
+Notes:
+  Opens the hosted recipe picker in your browser. The picker sends your
+  selection back to a temporary listener on 127.0.0.1, so the browser must run
+  on the same machine as the CLI. Once a recipe arrives, the CLI prints the
+  matching claude command and, when Claude Code is installed and the shell is
+  interactive, launches it directly. Press Ctrl+C while waiting to skip.
+
+Examples:
+  deepline quickstart
+  deepline quickstart --no-open
+  deepline quickstart --no-launch --json
+  deepline quickstart --timeout 120
+`
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option("--no-open", "Do not open the browser; print the URL only").option("--no-launch", "Print the claude command instead of launching it").option(
+    "--timeout <seconds>",
+    "Maximum seconds to wait for a selection",
+    "300"
+  ).action(async (options) => {
+    process.exitCode = await handleQuickstart(options);
+  });
+}
+
 // src/cli/commands/secrets.ts
 var import_node_process = require("process");
 var hiddenInputBuffer = "";
@@ -18157,7 +18418,7 @@ var import_node_fs11 = require("fs");
 var import_node_os8 = require("os");
 var import_node_path14 = require("path");
 var import_node_zlib = require("zlib");
-var import_node_crypto4 = require("crypto");
+var import_node_crypto5 = require("crypto");
 var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var MAX_SESSION_UPLOAD_BYTES = 35e5;
 var MAX_DIRECT_SESSION_DECODED_BYTES = 50 * 1024 * 1024;
@@ -18420,7 +18681,7 @@ async function uploadPayload(path, payload) {
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
-  const uploadId = (0, import_node_crypto4.randomUUID)();
+  const uploadId = (0, import_node_crypto5.randomUUID)();
   for (const session of sessions) {
     const bytes = Buffer.from(session.encodedContent, "base64");
     const chunks = [];
@@ -19944,7 +20205,7 @@ function parseExecuteOptions(args) {
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function shellQuote(value) {
+function shellQuote2(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function powerShellQuote(value) {
@@ -19996,7 +20257,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     path: scriptPath,
     sourceCode: script,
     projectDir,
-    macCopyCommand: `mkdir -p ${shellQuote(projectDir)} && cp ${shellQuote(scriptPath)} ${shellQuote(`${projectDir}/${fileName}`)}`,
+    macCopyCommand: `mkdir -p ${shellQuote2(projectDir)} && cp ${shellQuote2(scriptPath)} ${shellQuote2(`${projectDir}/${fileName}`)}`,
     windowsCopyCommand: `New-Item -ItemType Directory -Force -Path ${powerShellQuote(projectDir.replace(/\//g, "\\"))} | Out-Null; Copy-Item -LiteralPath ${powerShellQuote(scriptPath)} -Destination ${powerShellQuote(`${projectDir.replace(/\//g, "\\")}\\${fileName}`)}`
   };
 }
@@ -20015,7 +20276,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     summary: input2.summary
   };
   const envelopeHasCanonicalOutput = isRecord7(envelope.toolResponse) && Object.prototype.hasOwnProperty.call(envelope.toolResponse, "raw");
-  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote(JSON.stringify(input2.params))} --json`;
+  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote2(JSON.stringify(input2.params))} --json`;
   const actions = input2.listConversion ? [
     {
       label: "next",
@@ -20249,7 +20510,7 @@ var import_promises6 = require("fs/promises");
 var import_node_path17 = require("path");
 
 // src/cli/workflow-to-play.ts
-var import_node_crypto5 = require("crypto");
+var import_node_crypto6 = require("crypto");
 var HITL_WAIT_FOR_SIGNAL_TOOL = "deepline_workflow_wait_for_signal";
 var HITL_SLACK_TOOL = "slack_message_with_hitl";
 var SUB_WORKFLOW_TOOL_PREFIX = "deepline_workflow_";
@@ -20355,7 +20616,7 @@ function sanitizePlayNameSegment(value) {
 }
 function deriveWorkflowPlayName(workflowName) {
   const base = sanitizePlayNameSegment(workflowName) || "workflow";
-  const suffix = (0, import_node_crypto5.createHash)("sha256").update(workflowName).digest("hex").slice(0, 8);
+  const suffix = (0, import_node_crypto6.createHash)("sha256").update(workflowName).digest("hex").slice(0, 8);
   const reserved = suffix.length + 1;
   const allowedBase = Math.max(1, MAX_PLAY_NAME_LENGTH - reserved);
   let name = `${base.slice(0, allowedBase)}_${suffix}`;
@@ -20734,7 +20995,7 @@ Notes:
 }
 
 // src/cli/commands/update.ts
-var import_node_child_process = require("child_process");
+var import_node_child_process2 = require("child_process");
 var import_node_fs14 = require("fs");
 var import_node_path18 = require("path");
 function posixShellQuote(value) {
@@ -20743,14 +21004,14 @@ function posixShellQuote(value) {
 function windowsCmdQuote(value) {
   return `"${value.replace(/"/g, '""')}"`;
 }
-function shellQuote2(value) {
+function shellQuote3(value) {
   if (process.platform === "win32") {
     return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : windowsCmdQuote(value);
   }
   return posixShellQuote(value);
 }
 function buildSourceUpdateCommand(sourceRoot) {
-  const quotedRoot = shellQuote2(sourceRoot);
+  const quotedRoot = shellQuote3(sourceRoot);
   const cdCommand = process.platform === "win32" ? `cd /d ${quotedRoot}` : `cd ${quotedRoot}`;
   return `${cdCommand} && git fetch origin main --tags && git merge --ff-only origin/main`;
 }
@@ -20781,12 +21042,12 @@ function resolveUpdatePlan() {
     kind: "npm-global",
     command,
     args,
-    manualCommand: `${command} ${args.map(shellQuote2).join(" ")}`
+    manualCommand: `${command} ${args.map(shellQuote3).join(" ")}`
   };
 }
 function runCommand(command, args) {
   return new Promise((resolveExitCode) => {
-    const child = (0, import_node_child_process.spawn)(command, args, {
+    const child = (0, import_node_child_process2.spawn)(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env: process.env
@@ -20801,6 +21062,12 @@ function runCommand(command, args) {
     });
   });
 }
+async function runNpmGlobalUpdatePlan(plan) {
+  if (plan.kind !== "npm-global") {
+    return 1;
+  }
+  return runCommand(plan.command, plan.args);
+}
 async function handleUpdate(options) {
   const plan = resolveUpdatePlan();
   const render = {
@@ -20947,16 +21214,27 @@ function skillsIndexUrl(baseUrl) {
   return `${normalizeBaseUrl2(baseUrl)}${INSTALL_COMMANDS.skills.index_path}`;
 }
 function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
+  const skillNames = Array.isArray(skillName) ? skillName : [skillName];
+  const [firstSkillName, ...extraSkillNames] = skillNames;
   const values = {
     skills_index_url: skillsIndexUrl(baseUrl),
     agents: INSTALL_COMMANDS.skills.default_agents.join(" "),
-    skill_name: skillName
+    skill_name: firstSkillName ?? ""
   };
   const rendered = INSTALL_COMMANDS.skills.npx_add_args_template.flatMap(
     (arg, index) => {
       const next = index === 0 && options.firstArg ? options.firstArg : arg;
       const value = renderTemplate(next, values);
-      return arg === "{agents}" ? INSTALL_COMMANDS.skills.default_agents : value;
+      if (arg === "{agents}") {
+        return INSTALL_COMMANDS.skills.default_agents;
+      }
+      if (arg === "{skill_name}") {
+        return [
+          value,
+          ...extraSkillNames.flatMap((name) => ["--skill", name])
+        ];
+      }
+      return value;
     }
   );
   return rendered;
@@ -21027,13 +21305,78 @@ function unknownCommandNameFromMessage(message) {
   return command ? command : null;
 }
 
+// src/cli/self-update.ts
+var import_node_child_process3 = require("child_process");
+function envTruthy(name) {
+  const value = process.env[name]?.trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes";
+}
+function isCi() {
+  return envTruthy("CI") || envTruthy("GITHUB_ACTIONS");
+}
+function shouldSkipSelfUpdate() {
+  return envTruthy("DEEPLINE_SKIP_SELF_UPDATE") || envTruthy("DEEPLINE_NO_AUTO_UPDATE") || envTruthy("DEEPLINE_SKIP_SDK_AUTO_UPDATE") || envTruthy("DEEPLINE_DISABLE_AUTO_UPDATE") || isCi();
+}
+function relaunchCurrentCommand() {
+  return new Promise((resolve16) => {
+    const child = (0, import_node_child_process3.spawn)(process.execPath, process.argv.slice(1), {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        DEEPLINE_NO_AUTO_UPDATE: "1"
+      }
+    });
+    child.on("error", (error) => {
+      process.stderr.write(
+        `Deepline SDK/CLI updated, but relaunch failed: ${error.message}
+`
+      );
+      resolve16(1);
+    });
+    child.on("close", (code) => resolve16(code ?? 1));
+  });
+}
+async function maybeAutoUpdateAndRelaunch(response) {
+  const autoUpdate = response?.auto_update;
+  if (!response || !autoUpdate?.should_auto_update || shouldSkipSelfUpdate()) {
+    return false;
+  }
+  const plan = resolveUpdatePlan();
+  if (plan.kind !== "npm-global") {
+    return false;
+  }
+  const label = autoUpdate.required ? "requires an update" : "is more than the supported auto-update lag behind";
+  process.stderr.write(
+    `Deepline SDK/CLI ${label}; running ${plan.manualCommand}
+`
+  );
+  const updateExitCode = await runNpmGlobalUpdatePlan(plan);
+  if (updateExitCode !== 0) {
+    if (autoUpdate.required) {
+      throw new Error(
+        `Automatic Deepline SDK/CLI update failed with exit code ${updateExitCode}. ${response.message}`
+      );
+    }
+    process.stderr.write(
+      `Deepline SDK/CLI auto-update failed with exit code ${updateExitCode}; continuing with ${response.current ?? "current version"}.
+`
+    );
+    return false;
+  }
+  process.stderr.write("Deepline SDK/CLI updated; rerunning command.\n");
+  const exitCode = await relaunchCurrentCommand();
+  process.exit(exitCode);
+  return true;
+}
+
 // src/cli/skills-sync.ts
-var import_node_child_process2 = require("child_process");
+var import_node_child_process4 = require("child_process");
 var import_node_fs15 = require("fs");
 var import_node_os11 = require("os");
 var import_node_path19 = require("path");
 var CHECK_TIMEOUT_MS2 = 3e3;
 var SDK_SKILL_NAME = "deepline-plays";
+var SDK_SKILL_NAMES = [SDK_SKILL_NAME, "deepline-plays-quickstart"];
 var attemptedSync = false;
 function shouldSkipSkillsSync() {
   const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
@@ -21150,19 +21493,19 @@ async function fetchSkillsUpdate(baseUrl, localVersion) {
   }
 }
 function buildSkillsInstallArgs(baseUrl) {
-  return buildSkillsAddArgs(baseUrl, SDK_SKILL_NAME);
+  return buildSkillsAddArgs(baseUrl, SDK_SKILL_NAMES);
 }
 function buildBunxSkillsInstallArgs(baseUrl) {
-  return buildSkillsAddArgs(baseUrl, SDK_SKILL_NAME, { firstArg: "--bun" });
+  return buildSkillsAddArgs(baseUrl, SDK_SKILL_NAMES, { firstArg: "--bun" });
 }
 function hasCommand(command) {
-  const result = (0, import_node_child_process2.spawnSync)(command, ["--version"], {
+  const result = (0, import_node_child_process4.spawnSync)(command, ["--version"], {
     stdio: "ignore",
     shell: process.platform === "win32"
   });
   return result.status === 0;
 }
-function shellQuote3(arg) {
+function shellQuote4(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function resolveSkillsInstallCommands(baseUrl) {
@@ -21170,7 +21513,7 @@ function resolveSkillsInstallCommands(baseUrl) {
   const npxInstall = {
     command: "npx",
     args: npxArgs,
-    manualCommand: `npx ${npxArgs.map(shellQuote3).join(" ")}`
+    manualCommand: `npx ${npxArgs.map(shellQuote4).join(" ")}`
   };
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl);
@@ -21178,7 +21521,7 @@ function resolveSkillsInstallCommands(baseUrl) {
       {
         command: "bunx",
         args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote3).join(" ")}`
+        manualCommand: `bunx ${bunxArgs.map(shellQuote4).join(" ")}`
       },
       npxInstall
     ];
@@ -21187,7 +21530,7 @@ function resolveSkillsInstallCommands(baseUrl) {
 }
 function runOneSkillsInstall(install) {
   return new Promise((resolve16) => {
-    const child = (0, import_node_child_process2.spawn)(install.command, install.args, {
+    const child = (0, import_node_child_process4.spawn)(install.command, install.args, {
       stdio: ["ignore", "ignore", "pipe"],
       env: process.env
     });
@@ -21255,7 +21598,7 @@ async function syncSdkSkillsIfNeeded(baseUrl) {
   if (!update?.needsUpdate && !hasStaleInstalledSkill || !update?.remoteVersion) {
     return;
   }
-  writeSdkSkillsStatusLine("SDK skills changed; syncing deepline-plays skill...");
+  writeSdkSkillsStatusLine("SDK skills changed; syncing Deepline SDK skills...");
   const installed = await runSkillsInstall(baseUrl);
   if (!installed) return;
   if (installedSdkSkillHasStalePositionalExecuteExamples()) {
@@ -21478,7 +21821,9 @@ async function main() {
     progress?.phase("loading deepline cli");
   }
   const program = new import_commander3.Command();
-  program.name("deepline").description("Deepline CLI (TypeScript SDK)").version(SDK_VERSION, "-v, --version", "Show version").exitOverride().showHelpAfterError().showSuggestionAfterError(true).addHelpText(
+  program.name("deepline").description(
+    "Deepline CLI \u2014 GTM enrichment tools, plays, and runs from your terminal."
+  ).version(SDK_VERSION, "-v, --version", "Show version").exitOverride().showHelpAfterError().showSuggestionAfterError(true).addHelpText(
     "after",
     `
 Common commands:
@@ -21519,11 +21864,23 @@ Exit codes:
       progress?.phase("checking sdk compatibility");
     }
     const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
-    await traceCliSpan(
+    const compatibility = await traceCliSpan(
       "cli.sdk_compatibility",
-      { baseUrl },
-      () => enforceSdkCompatibility(baseUrl)
+      { baseUrl, command: actionCommand.name() },
+      () => checkSdkCompatibility(baseUrl, {
+        command: actionCommand.name()
+      })
+    );
+    if (compatibility.error) {
+      return;
+    }
+    const relaunched = await maybeAutoUpdateAndRelaunch(
+      compatibility.response
     );
+    if (relaunched) {
+      return;
+    }
+    enforceSdkCompatibilityResponse(compatibility.response);
     if (printStartupPhase) {
       progress?.phase("checking sdk skills");
     }
@@ -21548,6 +21905,7 @@ Exit codes:
   registerDbCommands(program);
   registerFeedbackCommands(program);
   registerUpdateCommand(program);
+  registerQuickstartCommands(program);
   program.command("preflight").description("Run compact health, auth, and Deepline billing checks.").option("--json", "Force JSON output.").addHelpText(
     "after",
     `
@@ -21623,6 +21981,29 @@ Examples:
     process.stdout.write(`deepline ${SDK_VERSION}
 `);
   });
+  if (process.argv.slice(2).length === 0) {
+    if (!process.stdout.isTTY) {
+      printJson({
+        ok: false,
+        exitCode: 2,
+        code: "MISSING_COMMAND",
+        message: "No command provided.",
+        next: "deepline --help"
+      });
+      console.error("error: missing command (see: deepline --help)");
+    } else {
+      program.outputHelp({ error: true });
+      console.error("\nerror: missing command (see usage above)");
+    }
+    recordCliTrace({
+      phase: "cli.main_total",
+      ms: Date.now() - mainStartedAt,
+      ok: false,
+      error: "missing command"
+    });
+    process.exitCode = 2;
+    return;
+  }
   try {
     await program.parseAsync(process.argv);
     recordCliTrace({