deepline 0.3.408 → 0.3.410

package/dist/cli/{chunk-MJELBQBU.mjs → chunk-XIHWSXSV.mjs}

@@ -1,9 +1,6 @@
 import {
-  getActiveCliProgress
-} from "./chunk-67RWR34T.mjs";
-import {
-  printCommandEnvelope
-} from "./chunk-4CFULMRB.mjs";
+  isJsonOutputMode
+} from "./chunk-5V5Y37BC.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -13,162 +10,20 @@ import {
   autoDetectBaseUrl,
   deploymentProtectionHeaders,
   detectAgentRuntime,
-  ensureProjectPrivatePathsIgnored,
   hasActivePluginSkills,
   readSdkSkillsLocalVersion,
   resolveApiKeyForBaseUrl,
   resolveAutoSyncSkillAgents,
-  resolveProjectPinTarget,
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-SD7MXAJA.mjs";
+} from "./chunk-RFB25DSQ.mjs";
 import {
   DeeplineError
-} from "./chunk-NXGCO4JB.mjs";
+} from "./chunk-E4IXDAZI.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-WTT6CLED.mjs";
-
-// src/cli/commands/skills.ts
-import { spawn as spawn2 } from "child_process";
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
-import { homedir as homedir3 } from "os";
-import { dirname as dirname3, join as join3 } from "path";
-
-// contracts/install-commands.json
-var install_commands_default = {
-  skills: {
-    index_path: "/.well-known/skills/index.json",
-    default_agents: [
-      "codex",
-      "claude-code",
-      "cursor",
-      "gemini-cli",
-      "antigravity"
-    ],
-    npx_binary: "npx",
-    npx_add_args_template: [
-      "--yes",
-      "skills@1.5.15",
-      "add",
-      "{skills_source_url}",
-      "--agent",
-      "{agents}",
-      "--global",
-      "--yes",
-      "--skill",
-      "{skill_name}",
-      "--full-depth"
-    ]
-  },
-  cli: {
-    sdk_npm_global: "npm install -g deepline@latest"
-  }
-};
-
-// src/cli/install-commands.ts
-var INSTALL_COMMANDS = install_commands_default;
-var skillsNpxPackage = INSTALL_COMMANDS.skills.npx_add_args_template.find(
-  (arg) => /^skills@\d+\.\d+\.\d+$/.test(arg)
-);
-if (!skillsNpxPackage) {
-  throw new Error(
-    "shared_libs/cli/install-commands.json must pin an exact skills package version."
-  );
-}
-var SKILLS_NPX_PACKAGE = skillsNpxPackage;
-var DEFAULT_V1_SKILL_NAMES = [
-  "deepline-org-chart",
-  "build-tam",
-  "clay-to-deepline",
-  "deepline-analytics",
-  "deepline-engine",
-  // Retired: its guidance lives in `feedback send --help` and `sessions send
-  // --help`. Kept as a stub because installed CLIs list it and refuse to
-  // sync any skill when the published index lacks a listed name. Move to
-  // LEGACY_SKILL_NAMES_TO_REMOVE once those CLIs are out of the field.
-  "deepline-feedback",
-  "deepline-gtm",
-  "deepline-start",
-  "deepline-plays",
-  "deepline-quickstart",
-  "deepline-research",
-  "deepline-scoring",
-  "find-qualified-titles",
-  "linkedin-url-lookup",
-  // Deprecated alias for `deepline-scoring`, kept installable so saved prompts
-  // and scripts using `/niche-signal-discovery` keep routing to the renamed
-  // skill. Move to LEGACY_SKILL_NAMES_TO_REMOVE once the window closes.
-  "niche-signal-discovery",
-  "portfolio-prospecting"
-];
-var DEFAULT_SDK_SKILL_NAMES = [...DEFAULT_V1_SKILL_NAMES];
-var LEGACY_SKILL_NAMES_TO_REMOVE = [
-  "deepline-plays-feedback",
-  "deepline-plays-quickstart",
-  "workflow-hello-world"
-];
-function normalizeBaseUrl(baseUrl) {
-  return baseUrl.replace(/\/$/, "");
-}
-function renderTemplate(template, values) {
-  return template.replace(/\{([a-z_]+)\}/g, (match, key) => {
-    return values[key] ?? match;
-  });
-}
-function skillsIndexUrl(baseUrl) {
-  return `${normalizeBaseUrl(baseUrl)}${INSTALL_COMMANDS.skills.index_path}`;
-}
-function skillsSourceUrl(baseUrl) {
-  return normalizeBaseUrl(baseUrl);
-}
-function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
-  const skillNames = Array.isArray(skillName) ? skillName : [skillName];
-  const [firstSkillName, ...extraSkillNames] = skillNames;
-  const agents = options.agents ?? DEFAULT_SKILL_AGENTS;
-  const values = {
-    skills_index_url: skillsIndexUrl(baseUrl),
-    skills_source_url: skillsSourceUrl(baseUrl),
-    agents: agents.join(" "),
-    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);
-      if (arg === "{agents}") {
-        return agents;
-      }
-      if (arg === "{skill_name}") {
-        return [
-          value,
-          ...extraSkillNames.flatMap((name) => ["--skill", name])
-        ];
-      }
-      return value;
-    }
-  );
-  return rendered;
-}
-
-// src/cli/skills-sync.ts
-import { spawn, spawnSync } from "child_process";
-import { createHash, randomUUID as randomUUID2 } from "crypto";
-import { homedir as homedir2 } from "os";
-import { gunzipSync } from "zlib";
-import {
-  appendFileSync,
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  readdirSync,
-  readFileSync as readFileSync2,
-  renameSync as renameSync2,
-  rmSync as rmSync2,
-  unlinkSync,
-  writeFileSync as writeFileSync2
-} from "fs";
-import { dirname as dirname2, join as join2 } from "path";
+} from "./chunk-2YR7BIIC.mjs";
 
 // src/compat.ts
 import { randomUUID } from "crypto";
@@ -183,6 +38,7 @@ import {
 import { homedir } from "os";
 import { dirname, join } from "path";
 var CHECK_TIMEOUT_MS = 2e3;
+var SDK_CLI_AUTO_UPDATE_CAPABILITY = "safe-continuation-v1";
 var SDK_COMPATIBILITY_TRUST_MS = 10 * 60 * 1e3;
 var SDK_COMPATIBILITY_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 var SDK_COMPATIBILITY_FAST_DEADLINE_MS = 400;
@@ -201,10 +57,10 @@ function shouldSkipCompatibilityCheck() {
   const value = process.env.DEEPLINE_SKIP_SDK_COMPAT_CHECK?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes";
 }
-function sdkCompatibilityCachePath(baseUrl, homeDir = homedir()) {
+function sdkCompatibilityCachePath(baseUrl, homeDir = process.env.HOME?.trim() || homedir()) {
   return join(sdkCliStateDirPath(baseUrl, homeDir), "compat-cache.json");
 }
-function legacySdkCompatibilityCachePath(homeDir = homedir()) {
+function legacySdkCompatibilityCachePath(homeDir = process.env.HOME?.trim() || homedir()) {
   return join(homeDir, ".cache", "deepline", "sdk-compat-cache.json");
 }
 function compatibilityCacheKey(baseUrl, command, skillsVersion) {
@@ -244,6 +100,22 @@ function isSavedWithin(savedAt, windowMs, now) {
   const age = now - savedAt;
   return Number.isFinite(age) && age >= 0 && age <= windowMs;
 }
+var UPDATE_ADVISORY_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+function claimUpdateAdvisory(baseUrl, now = Date.now()) {
+  const path = join(sdkCliStateDirPath(baseUrl), "update-advisory.json");
+  try {
+    const { shownAt } = JSON.parse(readFileSync(path, "utf8"));
+    if (isSavedWithin(shownAt, UPDATE_ADVISORY_INTERVAL_MS, now)) return false;
+  } catch {
+  }
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify({ shownAt: now })}
+`);
+  } catch {
+  }
+  return true;
+}
 function readCachedCompatibility(baseUrl, command, skillsVersion) {
   return readCachedCompatibilityEntry(baseUrl, command, skillsVersion)?.response ?? null;
 }
@@ -327,6 +199,9 @@ async function checkSdkCompatibility(baseUrl, options = {}) {
     }
     if (options.catalog) {
       url.searchParams.set("catalog_tool_id", options.catalog.toolId);
+      if (options.catalog.purpose) {
+        url.searchParams.set("catalog_purpose", options.catalog.purpose);
+      }
     }
     const response = await fetch(url, {
       method: "GET",
@@ -337,7 +212,9 @@ async function checkSdkCompatibility(baseUrl, options = {}) {
         "X-Deepline-API-Major": String(SDK_API_MAJOR),
         "X-Deepline-API-Contract": SDK_API_CONTRACT,
         "X-Deepline-CLI-Update-Preferences": "1",
-        ...options.catalog ? { Authorization: `Bearer ${resolveApiKeyForBaseUrl(baseUrl)}` } : {}
+        "X-Deepline-CLI-Auto-Update-Capability": SDK_CLI_AUTO_UPDATE_CAPABILITY,
+        ...options.catalog ? { Authorization: `Bearer ${resolveApiKeyForBaseUrl(baseUrl)}` } : {},
+        ...options.catalog?.cliInvocationId ? { "X-Deepline-CLI-Invocation-ID": options.catalog.cliInvocationId } : {}
       },
       signal: controller.signal
     });
@@ -356,7 +233,7 @@ async function checkSdkCompatibility(baseUrl, options = {}) {
         data
       );
     }
-    if (options.catalog && catalogMetadata && typeof catalogMetadata === "object" && "toolId" in catalogMetadata && catalogMetadata.toolId === options.catalog.toolId) {
+    if (data.ok && options.catalog && catalogMetadata && typeof catalogMetadata === "object" && "toolId" in catalogMetadata && catalogMetadata.toolId === options.catalog.toolId) {
       options.catalog.acceptMetadata(catalogMetadata);
     }
     return { response: data, error: null };
@@ -403,6 +280,269 @@ function enforceSdkCompatibilityResponse(response, options = {}) {
   }
 }
 
+// contracts/install-commands.json
+var install_commands_default = {
+  skills: {
+    index_path: "/.well-known/skills/index.json",
+    default_agents: [
+      "codex",
+      "claude-code",
+      "cursor",
+      "gemini-cli",
+      "antigravity"
+    ],
+    npx_binary: "npx",
+    npx_add_args_template: [
+      "--yes",
+      "skills@1.5.15",
+      "add",
+      "{skills_source_url}",
+      "--agent",
+      "{agents}",
+      "--global",
+      "--yes",
+      "--skill",
+      "{skill_name}",
+      "--full-depth"
+    ]
+  },
+  cli: {
+    sdk_npm_global: "npm install -g deepline@latest"
+  }
+};
+
+// src/cli/install-commands.ts
+var INSTALL_COMMANDS = install_commands_default;
+var skillsNpxPackage = INSTALL_COMMANDS.skills.npx_add_args_template.find(
+  (arg) => /^skills@\d+\.\d+\.\d+$/.test(arg)
+);
+if (!skillsNpxPackage) {
+  throw new Error(
+    "shared_libs/cli/install-commands.json must pin an exact skills package version."
+  );
+}
+var SKILLS_NPX_PACKAGE = skillsNpxPackage;
+var DEFAULT_V1_SKILL_NAMES = [
+  "deepline-org-chart",
+  "build-tam",
+  "clay-to-deepline",
+  "deepline-analytics",
+  "deepline-engine",
+  // Retired: its guidance lives in `feedback send --help` and `sessions send
+  // --help`. Kept as a stub because installed CLIs list it and refuse to
+  // sync any skill when the published index lacks a listed name. Move to
+  // LEGACY_SKILL_NAMES_TO_REMOVE once those CLIs are out of the field.
+  "deepline-feedback",
+  "deepline-gtm",
+  "deepline-start",
+  "deepline-plays",
+  "deepline-quickstart",
+  "deepline-research",
+  "deepline-scoring",
+  "find-qualified-titles",
+  "linkedin-url-lookup",
+  // Deprecated alias for `deepline-scoring`, kept installable so saved prompts
+  // and scripts using `/niche-signal-discovery` keep routing to the renamed
+  // skill. Move to LEGACY_SKILL_NAMES_TO_REMOVE once the window closes.
+  "niche-signal-discovery",
+  "portfolio-prospecting"
+];
+var DEFAULT_SDK_SKILL_NAMES = [...DEFAULT_V1_SKILL_NAMES];
+var LEGACY_SKILL_NAMES_TO_REMOVE = [
+  "deepline-plays-feedback",
+  "deepline-plays-quickstart",
+  "workflow-hello-world"
+];
+function normalizeBaseUrl(baseUrl) {
+  return baseUrl.replace(/\/$/, "");
+}
+function renderTemplate(template, values) {
+  return template.replace(/\{([a-z_]+)\}/g, (match, key) => {
+    return values[key] ?? match;
+  });
+}
+function skillsIndexUrl(baseUrl) {
+  return `${normalizeBaseUrl(baseUrl)}${INSTALL_COMMANDS.skills.index_path}`;
+}
+function skillsSourceUrl(baseUrl) {
+  return normalizeBaseUrl(baseUrl);
+}
+function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
+  const skillNames = Array.isArray(skillName) ? skillName : [skillName];
+  const [firstSkillName, ...extraSkillNames] = skillNames;
+  const agents = options.agents ?? DEFAULT_SKILL_AGENTS;
+  const values = {
+    skills_index_url: skillsIndexUrl(baseUrl),
+    skills_source_url: skillsSourceUrl(baseUrl),
+    agents: agents.join(" "),
+    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);
+      if (arg === "{agents}") {
+        return agents;
+      }
+      if (arg === "{skill_name}") {
+        return [
+          value,
+          ...extraSkillNames.flatMap((name) => ["--skill", name])
+        ];
+      }
+      return value;
+    }
+  );
+  return rendered;
+}
+
+// src/cli/progress.ts
+import { Worker } from "worker_threads";
+var CliProgress = class {
+  lastMessage = null;
+  interactive = Boolean(process.stderr.isTTY);
+  grey = "\x1B[90m";
+  cyan = "\x1B[36m";
+  dim = "\x1B[2m";
+  reset = "\x1B[0m";
+  worker = null;
+  enabled;
+  // --json output is one JSON document: progress never renders under it.
+  constructor(enabled) {
+    this.enabled = enabled && !isJsonOutputMode();
+  }
+  phase(message) {
+    if (!this.enabled || this.lastMessage === message) {
+      return;
+    }
+    if (this.interactive && this.lastMessage) {
+      this.settle("\u2713");
+    }
+    this.lastMessage = message;
+    if (!this.interactive) {
+      process.stderr.write(`${message}
+`);
+      return;
+    }
+    this.ensureWorker();
+    this.worker?.postMessage({ type: "phase", message });
+  }
+  complete() {
+    this.settle("\u2713");
+  }
+  fail() {
+    this.settle("\u2717");
+  }
+  writeLogLine(line) {
+    if (isJsonOutputMode()) return;
+    if (!this.enabled) {
+      process.stderr.write(`${line}
+`);
+      return;
+    }
+    const message = this.interactive ? `${this.cyan}[logs]${this.reset} ${this.dim}${line}${this.reset}` : `[logs] ${line}`;
+    if (!this.interactive) {
+      process.stderr.write(`${message}
+`);
+      return;
+    }
+    const activeMessage = this.lastMessage;
+    this.worker?.terminate().catch(() => void 0);
+    this.worker = null;
+    process.stderr.write(`\r\x1B[2K${message}
+`);
+    if (activeMessage) {
+      this.startWorker().postMessage({ type: "phase", message: activeMessage });
+    }
+  }
+  writeLine(line, stream = process.stderr) {
+    if (!this.enabled || !this.interactive) {
+      stream.write(`${line}
+`);
+      return;
+    }
+    const activeMessage = this.lastMessage;
+    this.worker?.terminate().catch(() => void 0);
+    this.worker = null;
+    stream.write(`\r\x1B[2K${line}
+`);
+    if (activeMessage) {
+      this.startWorker().postMessage({ type: "phase", message: activeMessage });
+    }
+  }
+  settle(mark) {
+    if (!this.enabled || !this.lastMessage) {
+      return;
+    }
+    if (this.interactive) {
+      this.worker?.terminate().catch(() => void 0);
+      this.worker = null;
+      process.stderr.write(
+        `\r\x1B[2K${this.grey}${mark} ${this.lastMessage}${this.reset}
+`
+      );
+    }
+    this.lastMessage = null;
+  }
+  ensureWorker() {
+    this.startWorker();
+  }
+  startWorker() {
+    if (this.worker) {
+      return this.worker;
+    }
+    this.worker = new Worker(
+      `
+        const { parentPort } = require('node:worker_threads');
+        const { writeSync } = require('node:fs');
+        const frames = ['\u2014', '\\\\', '|', '/'];
+        const grey = '\\x1b[90m';
+        const reset = '\\x1b[0m';
+        let message = '';
+        let frameIndex = 0;
+        let timer = null;
+        function render() {
+          if (!message) return;
+          const frame = frames[frameIndex % frames.length] || '\u2014';
+          frameIndex += 1;
+          writeSync(2, '\\r\\x1b[2K' + grey + frame + ' ' + message + reset);
+        }
+        parentPort.on('message', (event) => {
+          if (event.type === 'phase') {
+            message = String(event.message || '');
+            frameIndex = 0;
+            render();
+            if (!timer) {
+              timer = setInterval(render, 120);
+              timer.unref && timer.unref();
+            }
+          }
+          if (event.type === 'stop') {
+            if (timer) clearInterval(timer);
+            timer = null;
+            writeSync(2, '\\r\\x1b[2K');
+          }
+        });
+      `,
+      { eval: true }
+    );
+    this.worker.unref();
+    return this.worker;
+  }
+};
+var activeProgress = null;
+function setActiveCliProgress(progress) {
+  activeProgress = progress;
+}
+function getActiveCliProgress() {
+  return activeProgress;
+}
+function createCliProgress(enabled) {
+  const progress = new CliProgress(enabled);
+  setActiveCliProgress(progress);
+  return progress;
+}
+
 // src/cli/windows-arg-escape.ts
 import { statSync } from "fs";
 import { win32 } from "path";
@@ -547,7 +687,13 @@ function classifyNetworkFailure(error) {
     if (combined.includes("remotedisconnected") || combined.includes("remote end closed connection") || combined.includes("other side closed") || combined.includes("socket hang up")) {
       return "network_remote_disconnected";
     }
-    if (combined.includes("ssl") || combined.includes("tls") || combined.includes("unexpected_eof_while_reading")) {
+    if (
+      // Local filenames and retry commands may contain "ssl" or "tls".
+      // Require a transport identifier or protocol failure text instead.
+      code.includes("ssl") || code.includes("tls") || name.includes("ssl") || name.includes("tls") || /(?:^|[\s[(:])(?:ssl|tls)[\s:_-]+(?:error|handshake|certificate|routines|connection|failed|failure)(?:$|[\s:_-])/.test(
+        text
+      ) || combined.includes("unexpected_eof_while_reading")
+    ) {
       return "network_ssl_error";
     }
     current = record.cause ?? record.context;
@@ -833,6 +979,22 @@ async function maybeReportSdkCliFailure(input) {
 }
 
 // src/cli/skills-sync.ts
+import { spawn, spawnSync } from "child_process";
+import { createHash, randomUUID as randomUUID2 } from "crypto";
+import { homedir as homedir2 } from "os";
+import { gunzipSync } from "zlib";
+import {
+  appendFileSync,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readdirSync,
+  readFileSync as readFileSync2,
+  renameSync as renameSync2,
+  rmSync as rmSync2,
+  unlinkSync,
+  writeFileSync as writeFileSync2
+} from "fs";
+import { dirname as dirname2, join as join2 } from "path";
 var CHECK_TIMEOUT_MS2 = 3e3;
 var INSTALLER_PROBE_TIMEOUT_MS = 1e3;
 var PUBLISHED_VERIFICATION_RETRY_MS = 5 * 6e4;
@@ -1907,474 +2069,20 @@ async function runInlineSkillsSync(baseUrl, remoteVersion, agents, notices) {
   notice("Deepline agent skills are up to date.");
 }
 
-// src/cli/commands/skills.ts
-var SKILLS_INSTALL_LEASE_WAIT_MS = 9e4;
-var SKILLS_PROCESS_TIMEOUT_MS = 45e3;
-var RUNTIME_TO_SKILLS_AGENT = {
-  antigravity: "antigravity",
-  claude_code: "claude-code",
-  claude_cowork: "claude-code",
-  cline: "cline",
-  codex: "codex",
-  cursor: "cursor",
-  gemini: "gemini-cli",
-  windsurf: "windsurf"
-};
-var AGENT_MARKERS = [
-  { agent: "codex", paths: [".codex"] },
-  { agent: "claude-code", paths: [".claude"] },
-  { agent: "cursor", paths: [".cursor"] },
-  { agent: "gemini-cli", paths: [".gemini", ".gemini-cli"] },
-  { agent: "antigravity", paths: [".antigravity"] }
-];
-var WORKSPACE_SKILL_ROOTS_BY_AGENT = {
-  antigravity: [".agents"],
-  "claude-code": [".claude"],
-  cline: [".agents"],
-  codex: [".agents"],
-  cursor: [".agents"],
-  "gemini-cli": [".agents"],
-  windsurf: [".windsurf"],
-  "*": [".agents", ".claude", ".windsurf"]
-};
-function workspaceSkillRootsForAgents(agents) {
-  return [
-    ...new Set(
-      agents.flatMap((agent) => WORKSPACE_SKILL_ROOTS_BY_AGENT[agent] ?? [])
-    )
-  ].sort((a, b) => a.localeCompare(b));
-}
-function normalizeScope(value) {
-  if (value === "global") return "global";
-  if (value === "local") return "local";
-  if (!value) return inferActiveSkillsScope();
-  throw new Error("--scope must be one of: global, local");
-}
-function inferActiveSkillsScope(entrypoint = process.argv[1] ?? "") {
-  return /[\\/]\.deepline[\\/]runtime[\\/]/.test(entrypoint) ? "local" : "global";
-}
-function resolveLocalRoot() {
-  const target = resolveProjectPinTarget();
-  if (!target.ok) {
-    throw new Error(
-      `Cowork project folder is ambiguous. Candidate folders: ${target.candidates.join(
-        ", "
-      )}. Set CLAUDE_PROJECT_DIR or cd into the intended project folder.`
-    );
-  }
-  return target.dir;
-}
-function detectSkillsAgents(input) {
-  const runtime = input.runtime ?? detectAgentRuntime();
-  const knownAgent = RUNTIME_TO_SKILLS_AGENT[runtime];
-  if (knownAgent) return [knownAgent];
-  const roots = [
-    ...input.scope === "local" && input.root ? [input.root] : [],
-    input.homeDir ?? homedir3()
-  ];
-  const detected = AGENT_MARKERS.filter(
-    (marker) => roots.some(
-      (root) => marker.paths.some((path) => existsSync3(join3(root, path)))
-    )
-  ).map((marker) => marker.agent);
-  return detected.length > 0 ? detected : ["*"];
-}
-function skillsStatePathForScope(baseUrl, scope, root) {
-  return scope === "local" && root ? join3(root, ".deepline", "setup", "skills.json") : join3(sdkCliStateDirPath(baseUrl), "skills-install.json");
-}
-function buildSkillsPlan(input) {
-  const scopeArgs = input.scope === "global" ? ["--global"] : [];
-  const legacyNames = [...LEGACY_SKILL_NAMES_TO_REMOVE].sort(
-    (a, b) => a.localeCompare(b)
-  );
-  return {
-    scope: input.scope,
-    root: input.root,
-    agents: input.agents,
-    skillNames: input.skillNames,
-    version: input.version,
-    remove: {
-      command: "npm",
-      args: [
-        "exec",
-        "--yes",
-        `--package=${SKILLS_NPX_PACKAGE}`,
-        "--",
-        "skills",
-        "remove",
-        ...scopeArgs,
-        "--agent",
-        ...input.agents,
-        "-y",
-        ...legacyNames
-      ]
-    },
-    install: {
-      command: "npm",
-      args: [
-        "exec",
-        "--yes",
-        `--package=${SKILLS_NPX_PACKAGE}`,
-        "--",
-        "skills",
-        "add",
-        skillsSourceUrl(input.baseUrl),
-        "--agent",
-        ...input.agents,
-        ...scopeArgs,
-        "--yes",
-        ...input.skillNames.flatMap((name) => ["--skill", name]),
-        "--full-depth"
-      ]
-    },
-    statePath: skillsStatePathForScope(input.baseUrl, input.scope, input.root)
-  };
-}
-function sortedStrings(value) {
-  if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
-    return null;
-  }
-  return [...value].sort((a, b) => a.localeCompare(b));
-}
-function isSkillsPlanCurrent(plan, state) {
-  if (!state || state.scope !== plan.scope || state.skillsVersion !== plan.version) {
-    return false;
-  }
-  const installedAgents = sortedStrings(state.agents);
-  const installedSkillNames = sortedStrings(state.skillNames);
-  if (!installedAgents || !installedSkillNames) return false;
-  return installedAgents.join("\0") === [...plan.agents].sort((a, b) => a.localeCompare(b)).join("\0") && installedSkillNames.join("\0") === [...plan.skillNames].sort((a, b) => a.localeCompare(b)).join("\0");
-}
-function readSkillsInstallState(path) {
-  try {
-    const parsed = JSON.parse(readFileSync3(path, "utf8"));
-    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function runProcess(command, args, cwd) {
-  return new Promise((resolve, reject) => {
-    const plan = resolveShellSpawn(
-      command,
-      args,
-      process.platform,
-      process.env,
-      cwd
-    );
-    const child = spawn2(plan.command, plan.args, {
-      cwd,
-      env: process.env,
-      stdio: ["ignore", "ignore", "pipe"],
-      shell: plan.shell
-    });
-    let stderr = "";
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk.toString("utf8");
-      process.stderr.write(chunk);
-    });
-    const timeout = setTimeout(() => {
-      child.kill("SIGTERM");
-      reject(
-        new Error(
-          `${SKILLS_NPX_PACKAGE} timed out after ${SKILLS_PROCESS_TIMEOUT_MS}ms.`
-        )
-      );
-    }, SKILLS_PROCESS_TIMEOUT_MS);
-    child.once("error", (error) => {
-      clearTimeout(timeout);
-      reject(error);
-    });
-    child.once("close", (code) => {
-      clearTimeout(timeout);
-      if (code && stderr.trim()) {
-        process.stderr.write(`${SKILLS_NPX_PACKAGE} exited ${code}.
-`);
-      }
-      resolve(code ?? 1);
-    });
-  });
-}
-async function runSkillsCommand(options, dependencies = {}) {
-  let scope;
-  let root;
-  try {
-    scope = normalizeScope(options.scope);
-    root = scope === "local" ? resolveLocalRoot() : null;
-  } catch (error) {
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "INVALID_SKILLS_SCOPE",
-        exitCode: 2,
-        message: error instanceof Error ? error.message : String(error)
-      },
-      { json: options.json }
-    );
-    return 2;
-  }
-  const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
-  const catalog = {
-    skillNames: [...DEFAULT_SDK_SKILL_NAMES],
-    version: SDK_VERSION
-  };
-  const agents = options.agent ? [options.agent] : detectSkillsAgents({ scope, root });
-  const plan = buildSkillsPlan({ baseUrl, scope, root, agents, ...catalog });
-  if (options.dryRun) {
-    printCommandEnvelope(
-      { ok: true, status: "planned", dryRun: true, ...plan },
-      { json: options.json }
-    );
-    return 0;
-  }
-  if (isSkillsPlanCurrent(plan, readSkillsInstallState(plan.statePath)) && !hasFailedAutomaticSkillsSync(baseUrl, agents)) {
-    printCommandEnvelope(
-      {
-        ok: true,
-        status: "current",
-        complete: true,
-        changed: false,
-        skipped: true,
-        skipReason: "skills_version_current",
-        scope,
-        agents,
-        skillsVersion: plan.version,
-        skillCount: plan.skillNames.length,
-        statePath: plan.statePath,
-        render: {
-          sections: [
-            {
-              title: "skills",
-              lines: [
-                `Scope: ${scope}`,
-                `Agents: ${agents.join(", ")}`,
-                `Current: ${plan.skillNames.length}`
-              ]
-            }
-          ]
-        }
-      },
-      { json: options.json }
-    );
-    return 0;
-  }
-  if (scope === "local" && root) {
-    const managedNames = [
-      .../* @__PURE__ */ new Set([...plan.skillNames, ...LEGACY_SKILL_NAMES_TO_REMOVE])
-    ];
-    const agentRoots = workspaceSkillRootsForAgents(plan.agents);
-    ensureProjectPrivatePathsIgnored(root, [
-      ".deepline/",
-      ...agentRoots.flatMap(
-        (agentRoot) => managedNames.map((name) => `${agentRoot}/skills/${name}/`)
-      )
-    ]);
-  }
-  let lease;
-  try {
-    lease = scope === "global" ? await acquireSkillsInstallLease(baseUrl, agents, plan.version, {
-      waitMs: dependencies.installLeaseWaitMs ?? SKILLS_INSTALL_LEASE_WAIT_MS,
-      onWait: () => process.stderr.write(
-        "Waiting for a background Deepline skills refresh to finish...\n"
-      )
-    }) : { release: () => {
-    } };
-  } catch (error) {
-    if (!(error instanceof SkillsStateUnavailableError)) throw error;
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "SKILLS_STATE_UNAVAILABLE",
-        exitCode: 5,
-        scope,
-        agents,
-        message: error.message,
-        next: `Resolve this filesystem error, then run: deepline skills --scope ${scope}`
-      },
-      { json: options.json }
-    );
-    return 5;
-  }
-  if (!lease) {
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "SKILLS_SYNC_IN_PROGRESS",
-        exitCode: 7,
-        scope,
-        agents,
-        message: "A background Deepline skills refresh is still running for these agents.",
-        next: `Retry in a moment: deepline skills --scope ${scope}. If no refresh is running, remove ${skillsInstallLeasePath(baseUrl, agents)}`
-      },
-      { json: options.json }
-    );
-    return 7;
-  }
-  try {
-    return await runSkillsInstallWithLease({
-      options,
-      dependencies,
-      baseUrl,
-      scope,
-      root,
-      agents,
-      plan
-    });
-  } finally {
-    lease.release();
-  }
-}
-async function runSkillsInstallWithLease(input) {
-  const { options, dependencies, baseUrl, scope, root, agents, plan } = input;
-  process.stderr.write(
-    `Replacing Deepline skills for ${agents.join(", ")} (${scope})...
-`
-  );
-  const execute = dependencies.runProcess ?? runProcess;
-  try {
-    const installCode = await execute(
-      plan.install.command,
-      plan.install.args,
-      root ?? void 0
-    );
-    if (installCode !== 0) {
-      throw new Error("Could not install the current Deepline skills.");
-    }
-  } catch (error) {
-    printCommandEnvelope(
-      {
-        ok: false,
-        status: "failed",
-        code: "SKILLS_INSTALL_FAILED",
-        exitCode: 5,
-        scope,
-        agents,
-        message: error instanceof Error ? error.message : String(error),
-        next: `deepline skills --scope ${scope}`
-      },
-      { json: options.json }
-    );
-    return 5;
-  }
-  try {
-    const removeCode = await execute(
-      plan.remove.command,
-      plan.remove.args,
-      root ?? void 0
-    );
-    if (removeCode !== 0) {
-      process.stderr.write(
-        "Current Deepline skills installed, but legacy skill cleanup failed. The installed skills remain usable.\n"
-      );
-    }
-  } catch (error) {
-    process.stderr.write(
-      `Current Deepline skills installed, but legacy skill cleanup failed: ${error instanceof Error ? error.message : String(error)}. The installed skills remain usable.
-`
-    );
-  }
-  mkdirSync3(dirname3(plan.statePath), { recursive: true });
-  writeFileSync3(
-    plan.statePath,
-    `${JSON.stringify(
-      {
-        schemaVersion: 1,
-        installedAt: (/* @__PURE__ */ new Date()).toISOString(),
-        cliVersion: SDK_VERSION,
-        scope,
-        agents,
-        skillsVersion: plan.version,
-        skillNames: plan.skillNames
-      },
-      null,
-      2
-    )}
-`,
-    "utf8"
-  );
-  if (scope === "global") {
-    clearFailedAutomaticSkillsSync(baseUrl, agents);
-  }
-  printCommandEnvelope(
-    {
-      ok: true,
-      status: "complete",
-      scope,
-      agents,
-      skillsVersion: plan.version,
-      skillCount: plan.skillNames.length,
-      statePath: plan.statePath,
-      render: {
-        sections: [
-          {
-            title: "skills",
-            lines: [
-              `Scope: ${scope}`,
-              `Agents: ${agents.join(", ")}`,
-              `Installed: ${plan.skillNames.length}`
-            ]
-          }
-        ]
-      }
-    },
-    { json: options.json }
-  );
-  return 0;
-}
-function registerSkillsCommand(program) {
-  program.command("skills").description("Replace Deepline agent skills with the current release.").option("--scope <scope>", "Install scope: global or local").option("--agent <agent>", "Override the detected agent target").option("--dry-run", "Print the install plan without changing files").option("--json", "Emit one JSON result envelope").addHelpText(
-    "after",
-    `
-Notes:
-  This command reinstalls current Deepline-managed skills using ${SKILLS_NPX_PACKAGE},
-  then removes legacy Deepline skill names. Local scope writes into the resolved
-  persistent project.
-
-Examples:
-  deepline skills
-  deepline skills --scope local
-  deepline skills --agent codex --dry-run
-`
-  ).action(async (options) => {
-    process.exitCode = await runSkillsCommand(options);
-  });
-  program.command(SKILLS_AUTO_SYNC_COMMAND, { hidden: true }).description("Refresh Deepline agent skills in the background.").option(
-    "--claim <token>",
-    "Owner token of the leases this child was started for."
-  ).action(async (options) => {
-    const claim = options.claim?.trim();
-    if (!claim) {
-      printCommandEnvelope(
-        {
-          ok: false,
-          status: "failed",
-          code: "SKILLS_AUTO_SYNC_CLAIM_REQUIRED",
-          exitCode: 2,
-          message: "skills-auto-sync is started by ordinary deepline commands and requires the lease token they pass; run `deepline skills` to install skills yourself."
-        },
-        { json: true }
-      );
-      process.exitCode = 2;
-      return;
-    }
-    await syncSdkSkillsIfNeeded(autoDetectBaseUrl().replace(/\/$/, ""), {
-      mode: "inline",
-      notices: "defer",
-      claim
-    });
-  });
-}
-
 export {
   SDK_COMPATIBILITY_FAST_DEADLINE_MS,
   readFreshCleanCompatibility,
   readTrustedCleanCompatibility,
+  claimUpdateAdvisory,
   checkSdkCompatibility,
   isCiEnvironment,
   enforceSdkCompatibilityResponse,
+  SKILLS_NPX_PACKAGE,
+  DEFAULT_SDK_SKILL_NAMES,
+  LEGACY_SKILL_NAMES_TO_REMOVE,
+  skillsSourceUrl,
+  getActiveCliProgress,
+  createCliProgress,
   resolveShellSpawn,
   isFailureReportingDisabled,
   redactFailureText,
@@ -2382,15 +2090,12 @@ export {
   failureReportHeaders,
   resolveSdkCliFailureExitCode,
   maybeReportSdkCliFailure,
+  SkillsStateUnavailableError,
+  acquireSkillsInstallLease,
+  skillsInstallLeasePath,
   flushDeferredSkillsSyncNotices,
   SKILLS_AUTO_SYNC_COMMAND,
-  syncSdkSkillsIfNeeded,
-  workspaceSkillRootsForAgents,
-  inferActiveSkillsScope,
-  detectSkillsAgents,
-  skillsStatePathForScope,
-  buildSkillsPlan,
-  isSkillsPlanCurrent,
-  runSkillsCommand,
-  registerSkillsCommand
+  hasFailedAutomaticSkillsSync,
+  clearFailedAutomaticSkillsSync,
+  syncSdkSkillsIfNeeded
 };