deepline 0.3.357 → 0.3.358

package/dist/cli/index.js

@@ -4,17 +4,18 @@
 
 
 
-var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
+var _chunkWVO6AJM7js = require('./chunk-WVO6AJM7.js');
+require('./chunk-LOSZZCER.js');
 
 
 
+var _chunkAYHLUHE5js = require('./chunk-AYHLUHE5.js');
 
 
-var _chunk6P235JSNjs = require('./chunk-6P235JSN.js');
-require('./chunk-NEMHJYA4.js');
 
 
 
+var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
 
 
 
@@ -24,11 +25,10 @@ require('./chunk-NEMHJYA4.js');
 
 
 
-var _chunkC2EHMMMEjs = require('./chunk-C2EHMMME.js');
 
 
 
-var _chunkAYHLUHE5js = require('./chunk-AYHLUHE5.js');
+var _chunk5PJ6XYRVjs = require('./chunk-5PJ6XYRV.js');
 
 
 var _chunkWJYPBHTEjs = require('./chunk-WJYPBHTE.js');
@@ -38,7 +38,8 @@ var _chunkWJYPBHTEjs = require('./chunk-WJYPBHTE.js');
 
 
 
-var _chunk5UNTNKNXjs = require('./chunk-5UNTNKNX.js');
+var _chunkBVPN57ADjs = require('./chunk-BVPN57AD.js');
+
 
 
 
@@ -47,11 +48,16 @@ var _chunk5UNTNKNXjs = require('./chunk-5UNTNKNX.js');
 
 
 
-var _chunk4YXJTQ5Xjs = require('./chunk-4YXJTQ5X.js');
+var _chunkUZQWPQ6Vjs = require('./chunk-UZQWPQ6V.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-SXXUOZRS.js');
 require('./chunk-7P5AA3SN.js');
+require('./chunk-OVUDXZCK.js');
 require('./chunk-OG64RBAC.js');
+
+
+
+
+var _chunkQILHWZFPjs = require('./chunk-QILHWZFP.js');
 require('./chunk-COGTRVWW.js');
 
 // src/cli/command-invocation.ts
@@ -115,48 +121,48 @@ var _os = require('os');
 var COMMAND_GROUPS = [
   {
     names: ["auth"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./auth-AABYKR2S.js")))).registerAuthCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./auth-VP5WIGFS.js")))).registerAuthCommands
   },
   {
     names: ["providers"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./providers-RJYHQC4J.js")))).registerProviderCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./providers-WAUWYRTK.js")))).registerProviderCommands
   },
   {
     names: ["search"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./search-2FJA6OH4.js")))).registerSearchCommand
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./search-RQLY5D2A.js")))).registerSearchCommand
   },
   {
     names: ["describe"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-5ZQ6KIJH.js")))).registerDescribeCommand
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-BKJNG2I5.js")))).registerDescribeCommand
   },
   {
     names: ["tools"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./tools-ZOKG4AX4.js")))).registerToolsCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./tools-BY6D7M4I.js")))).registerToolsCommands
   },
   {
     names: ["executions"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./executions-KCZZY6SS.js")))).registerExecutionsCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./executions-63CSEYKE.js")))).registerExecutionsCommands
   },
   {
     names: ["plays", "runs"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./play-ZO4HDGMC.js")))).registerPlayCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./play-GDDOUU3I.js")))).registerPlayCommands
   },
   {
     names: ["sessions"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./sessions-QV4LUKEP.js")))).registerSessionsCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./sessions-ELBTWKLS.js")))).registerSessionsCommands
   },
   {
     names: ["workflows"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./workflow-YWKK3A4X.js")))).registerWorkflowCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./workflow-X66V6L3H.js")))).registerWorkflowCommands
   },
   {
     names: ["secrets"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./secrets-6LD4CA2X.js")))).registerSecretsCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./secrets-BEAESK2H.js")))).registerSecretsCommands
   },
   {
     names: ["settings", "notifications"],
     load: async () => {
-      const commands = await Promise.resolve().then(() => _interopRequireWildcard(require("./settings-JOYKXSY7.js")));
+      const commands = await Promise.resolve().then(() => _interopRequireWildcard(require("./settings-V5RI4UWE.js")));
       return (p) => {
         commands.registerSettingsCommands(p);
         commands.registerNotificationCommands(p);
@@ -165,51 +171,51 @@ var COMMAND_GROUPS = [
   },
   {
     names: ["billing"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./billing-Y6IKDJ6H.js")))).registerBillingCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./billing-UE2CP5O5.js")))).registerBillingCommands
   },
   {
     names: ["monitors"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./monitors-DVFEJHQT.js")))).registerMonitorsCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./monitors-R32SKFE3.js")))).registerMonitorsCommands
   },
   {
     names: ["org"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./org-BGCB45VI.js")))).registerOrgCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./org-RYRHB22V.js")))).registerOrgCommands
   },
   {
     names: ["git", "projects", "deployments"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./git-VESXOJ4M.js")))).registerGitCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./git-4EBFGJAN.js")))).registerGitCommands
   },
   {
     names: ["csv"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./csv-SQIEBX66.js")))).registerCsvCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./csv-VSVZWQ24.js")))).registerCsvCommands
   },
   {
     names: ["db"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./db-Z33ZRE3N.js")))).registerDbCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./db-6QNWRH47.js")))).registerDbCommands
   },
   {
     names: ["feedback"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./feedback-BM7ZNH7Y.js")))).registerFeedbackCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./feedback-T4FGM7DY.js")))).registerFeedbackCommands
   },
   {
     names: ["enrich", "session", "backend"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./legacy-noops-PV5AWTIZ.js")))).registerDeprecatedCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./legacy-noops-W6UWORVY.js")))).registerDeprecatedCommands
   },
   {
     names: ["update"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./update-WUMDEAEE.js")))).registerUpdateCommand
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./update-PEGDRQ3G.js")))).registerUpdateCommand
   },
   {
     names: ["skills", "skills-auto-sync"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./skills-JL4J5CII.js")))).registerSkillsCommand
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./skills-OH3X3OUA.js")))).registerSkillsCommand
   },
   {
     names: ["setup", "doctor"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./setup-MIJZTYMH.js")))).registerSetupCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./setup-CS3IACGU.js")))).registerSetupCommands
   },
   {
     names: ["quickstart"],
-    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./quickstart-E6OWYYMT.js")))).registerQuickstartCommands
+    load: async () => (await Promise.resolve().then(() => _interopRequireWildcard(require("./quickstart-V5LHMW2X.js")))).registerQuickstartCommands
   }
 ];
 async function registerDeeplineCommandGroups(program, requestedCommand) {
@@ -231,6 +237,87 @@ function registerDeeplineInlineCommands(program) {
   return { preflight, health, version };
 }
 
+// src/cli/help-seen.ts
+
+
+
+
+
+
+
+var _fs = require('fs');
+
+
+var MAX_SESSIONS = 20;
+function helpSeenPath(homeDir = _os.homedir.call(void 0, )) {
+  return _path.join.call(void 0, homeDir, ".local", "deepline", "sdk-cli", "help-seen.json");
+}
+function resolveHelpDetail(argv, key, homeDir = _os.homedir.call(void 0, ), sessionId = _chunkUZQWPQ6Vjs.agentSessionIdFromEnvironment.call(void 0, )) {
+  const explicit = _chunkQILHWZFPjs.helpDetailFromArgv.call(void 0, argv);
+  if (explicit === "quiet") return { detail: "quiet", firstRead: false };
+  if (!sessionId) return { detail: explicit, firstRead: false };
+  const path = helpSeenPath(homeDir);
+  const sessions = readSessions(path);
+  const seen = new Set(sessions.get(sessionId));
+  const firstRead = !seen.has(key);
+  if (!firstRead) return { detail: explicit, firstRead: false };
+  seen.add(key);
+  sessions.delete(sessionId);
+  sessions.set(sessionId, [...seen].sort());
+  writeSessions(path, sessions);
+  return { detail: "verbose", firstRead: true };
+}
+function readSessions(path) {
+  if (!_fs.existsSync.call(void 0, path)) return /* @__PURE__ */ new Map();
+  try {
+    const parsed = JSON.parse(_fs.readFileSync.call(void 0, path, "utf8"));
+    const sessions = /* @__PURE__ */ new Map();
+    for (const entry of Array.isArray(parsed.sessions) ? parsed.sessions : []) {
+      const { id, seen } = entry;
+      if (typeof id !== "string" || !Array.isArray(seen)) continue;
+      sessions.set(
+        id,
+        seen.filter((value) => typeof value === "string")
+      );
+    }
+    return sessions;
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    console.error(
+      `[deepline] Could not read ${path}; treating every command's help as unread. ${detail}`
+    );
+    return /* @__PURE__ */ new Map();
+  }
+}
+function writeSessions(path, sessions) {
+  const tempPath = `${path}.${process.pid}.tmp`;
+  const recent = [...sessions].slice(-MAX_SESSIONS);
+  try {
+    _fs.mkdirSync.call(void 0, _path.dirname.call(void 0, path), { recursive: true });
+    _fs.writeFileSync.call(void 0, 
+      tempPath,
+      `${JSON.stringify(
+        {
+          schemaVersion: 2,
+          sessions: recent.map(([id, seen]) => ({ id, seen }))
+        },
+        null,
+        2
+      )}
+`,
+      { encoding: "utf8", mode: 384 }
+    );
+    _fs.renameSync.call(void 0, tempPath, path);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    console.error(
+      `[deepline] Could not record help state at ${path}; the full explanation will print again next time. ${detail}`
+    );
+  } finally {
+    _fs.rmSync.call(void 0, tempPath, { force: true });
+  }
+}
+
 // src/cli/self-update.ts
 var _child_process = require('child_process');
 var AUTO_UPDATE_TELEMETRY_TIMEOUT_MS = 2e3;
@@ -247,7 +334,7 @@ function trustedAutoUpdateRegistryUrl(baseUrl) {
 async function reportAutoUpdateEvent(input) {
   let apiKey = "";
   try {
-    apiKey = _chunk4YXJTQ5Xjs.resolveApiKeyForBaseUrl.call(void 0, input.baseUrl);
+    apiKey = _chunkUZQWPQ6Vjs.resolveApiKeyForBaseUrl.call(void 0, input.baseUrl);
   } catch (e2) {
     return;
   }
@@ -263,15 +350,15 @@ async function reportAutoUpdateEvent(input) {
       headers: {
         Authorization: `Bearer ${apiKey}`,
         "Content-Type": "application/json",
-        "User-Agent": `deepline-ts-sdk/${_chunk4YXJTQ5Xjs.SDK_VERSION}`,
+        "User-Agent": `deepline-ts-sdk/${_chunkUZQWPQ6Vjs.SDK_VERSION}`,
         "X-Deepline-Client-Family": "sdk",
         "X-Deepline-CLI-Family": "sdk",
-        "X-Deepline-CLI-Version": _chunk4YXJTQ5Xjs.SDK_VERSION,
-        "X-Deepline-SDK-Version": _chunk4YXJTQ5Xjs.SDK_VERSION
+        "X-Deepline-CLI-Version": _chunkUZQWPQ6Vjs.SDK_VERSION,
+        "X-Deepline-SDK-Version": _chunkUZQWPQ6Vjs.SDK_VERSION
       },
       body: JSON.stringify({
         event: input.event,
-        current_version: _optionalChain([input, 'access', _4 => _4.response, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]) || _chunk4YXJTQ5Xjs.SDK_VERSION,
+        current_version: _optionalChain([input, 'access', _4 => _4.response, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]) || _chunkUZQWPQ6Vjs.SDK_VERSION,
         target_version: input.response.latest,
         reason: _optionalChain([input, 'access', _8 => _8.response, 'access', _9 => _9.auto_update, 'optionalAccess', _10 => _10.reason]),
         command: _nullishCoalesce(input.response.command, () => ( null)),
@@ -290,7 +377,7 @@ function envTruthy(name) {
   return value === "1" || value === "true" || value === "yes";
 }
 function shouldSkipSelfUpdate(policy) {
-  return policy === "off" || envTruthy("DEEPLINE_SKIP_SELF_UPDATE") || envTruthy("DEEPLINE_NO_AUTO_UPDATE") || envTruthy("DEEPLINE_SKIP_SDK_AUTO_UPDATE") || envTruthy("DEEPLINE_DISABLE_AUTO_UPDATE") || !_chunk6P235JSNjs.shouldRunCliAutoUpdate.call(void 0, ) || _chunkC2EHMMMEjs.isCiEnvironment.call(void 0, );
+  return policy === "off" || envTruthy("DEEPLINE_SKIP_SELF_UPDATE") || envTruthy("DEEPLINE_NO_AUTO_UPDATE") || envTruthy("DEEPLINE_SKIP_SDK_AUTO_UPDATE") || envTruthy("DEEPLINE_DISABLE_AUTO_UPDATE") || !_chunkWVO6AJM7js.shouldRunCliAutoUpdate.call(void 0, ) || _chunk5PJ6XYRVjs.isCiEnvironment.call(void 0, );
 }
 function parseSemver(version) {
   const trimmed = _optionalChain([version, 'optionalAccess', _17 => _17.trim, 'call', _18 => _18()]);
@@ -320,7 +407,7 @@ function compareSemver(left, right) {
 }
 function isDowngradeAutoUpdateResponse(response) {
   const target = _optionalChain([response, 'optionalAccess', _19 => _19.latest, 'optionalAccess', _20 => _20.trim, 'call', _21 => _21()]);
-  const current = _optionalChain([response, 'optionalAccess', _22 => _22.current, 'optionalAccess', _23 => _23.trim, 'call', _24 => _24()]) || _chunk4YXJTQ5Xjs.SDK_VERSION;
+  const current = _optionalChain([response, 'optionalAccess', _22 => _22.current, 'optionalAccess', _23 => _23.trim, 'call', _24 => _24()]) || _chunkUZQWPQ6Vjs.SDK_VERSION;
   if (!target) return false;
   return compareSemver(target, current) < 0;
 }
@@ -359,7 +446,7 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
   }
   if (isDowngradeAutoUpdateResponse(response)) {
     const target = response.latest;
-    const current = _optionalChain([response, 'access', _27 => _27.current, 'optionalAccess', _28 => _28.trim, 'call', _29 => _29()]) || _chunk4YXJTQ5Xjs.SDK_VERSION;
+    const current = _optionalChain([response, 'access', _27 => _27.current, 'optionalAccess', _28 => _28.trim, 'call', _29 => _29()]) || _chunkUZQWPQ6Vjs.SDK_VERSION;
     process.stderr.write(
       `Deepline SDK/CLI auto-update refused: server advertised older ${target} than current ${current}. Continuing without mutating the CLI.
 `
@@ -367,12 +454,12 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
     return false;
   }
   const packageSpec = response.latest ? `deepline@${response.latest}` : void 0;
-  const plan = _chunk6P235JSNjs.resolveUpdatePlan.call(void 0, {
+  const plan = _chunkWVO6AJM7js.resolveUpdatePlan.call(void 0, {
     packageSpec,
     requireVerifiedNpmOwnership: true,
     npmFallbackRegistryUrl: trustedAutoUpdateRegistryUrl(baseUrl)
   });
-  if (!_chunk6P235JSNjs.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) {
+  if (!_chunkWVO6AJM7js.canAutomaticallyApplyUpdatePlan.call(void 0, plan)) {
     return false;
   }
   const label = autoUpdate.reason === "rollback_forced" ? "has a server rollback pending and needs the latest rollback-aware CLI" : autoUpdate.reason === "deprecated" ? "is deprecated and will update automatically" : autoUpdate.required ? "requires an update" : "has an update available and will update automatically";
@@ -386,7 +473,7 @@ async function maybeAutoUpdateAndRelaunch(response, baseUrl, policy = "configure
     event: "started",
     installKind: plan.kind
   });
-  const updateResult = await _chunk6P235JSNjs.runAutomaticUpdatePlan.call(void 0, plan);
+  const updateResult = await _chunkWVO6AJM7js.runAutomaticUpdatePlan.call(void 0, plan);
   if (updateResult.status === "skipped_previous_failure") {
     void reportAutoUpdateEvent({
       baseUrl,
@@ -536,7 +623,7 @@ async function runPlayRunnerHealthCheck() {
     });
     let exitCode = 1;
     try {
-      const { handlePlayRun } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-ZO4HDGMC.js")));
+      const { handlePlayRun } = await Promise.resolve().then(() => _interopRequireWildcard(require("./play-GDDOUU3I.js")));
       exitCode = await handlePlayRun([
         file,
         "--input",
@@ -576,7 +663,7 @@ function preflightErrorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
 async function runPreflightCheck() {
-  const baseUrl = _chunk4YXJTQ5Xjs.autoDetectBaseUrl.call(void 0, ).replace(/\/$/, "");
+  const baseUrl = _chunkUZQWPQ6Vjs.autoDetectBaseUrl.call(void 0, ).replace(/\/$/, "");
   const healthController = new AbortController();
   const healthTimeout = setTimeout(
     () => healthController.abort(),
@@ -591,9 +678,9 @@ async function runPreflightCheck() {
       version: pickString(payload, "version")
     };
   }).catch(() => ({ status: "unreachable", version: null })).finally(() => clearTimeout(healthTimeout));
-  const apiKey = _chunk4YXJTQ5Xjs.resolveApiKeyForBaseUrl.call(void 0, baseUrl);
-  const http = apiKey ? new (0, _chunk4YXJTQ5Xjs.HttpClient)(
-    _chunk4YXJTQ5Xjs.resolveConfig.call(void 0, {
+  const apiKey = _chunkUZQWPQ6Vjs.resolveApiKeyForBaseUrl.call(void 0, baseUrl);
+  const http = apiKey ? new (0, _chunkUZQWPQ6Vjs.HttpClient)(
+    _chunkUZQWPQ6Vjs.resolveConfig.call(void 0, {
       baseUrl,
       apiKey,
       timeout: PREFLIGHT_TIMEOUT_MS,
@@ -638,7 +725,7 @@ async function runPreflightCheck() {
   const connected = authStatus === "connected" || authStatus === "claimed";
   return {
     status: healthResult.status === "ok" && connected ? "ok" : "check",
-    cli_version: _chunk4YXJTQ5Xjs.SDK_VERSION,
+    cli_version: _chunkUZQWPQ6Vjs.SDK_VERSION,
     host: baseUrl,
     health: {
       status: healthResult.status,
@@ -664,7 +751,7 @@ async function runPreflightCheck() {
         {
           title: "preflight",
           lines: [
-            `cli: ${_chunk4YXJTQ5Xjs.SDK_VERSION}`,
+            `cli: ${_chunkUZQWPQ6Vjs.SDK_VERSION}`,
             `host: ${baseUrl}`,
             `health: ${healthResult.status}`,
             `auth: ${authStatus}`,
@@ -689,12 +776,12 @@ function printPreflightHuman(data) {
 }
 async function newerCliCommandHint(baseUrl, command) {
   if (!command.trim()) return null;
-  const { response, error } = await _chunkC2EHMMMEjs.checkSdkCompatibility.call(void 0, baseUrl, { command });
+  const { response, error } = await _chunk5PJ6XYRVjs.checkSdkCompatibility.call(void 0, baseUrl, { command });
   if (error || !response) return null;
   const introduced = response.command_introduced_in;
   if (introduced) {
     return [
-      `\`deepline ${introduced.command}\` was added in SDK CLI ${introduced.introduced_in}. This CLI is ${_chunk4YXJTQ5Xjs.SDK_VERSION}.`,
+      `\`deepline ${introduced.command}\` was added in SDK CLI ${introduced.introduced_in}. This CLI is ${_chunkUZQWPQ6Vjs.SDK_VERSION}.`,
       `  ${introduced.reason}`,
       `  Update with: ${response.update_command}`,
       "  Agent skills are served by Deepline and refresh on their own, so a skill can describe a command this CLI does not have yet."
@@ -703,12 +790,13 @@ async function newerCliCommandHint(baseUrl, command) {
   if (!response.update_required) return null;
   return [
     response.message,
-    `  Installed: ${_chunk4YXJTQ5Xjs.SDK_VERSION}. Run: ${response.update_command}`,
+    `  Installed: ${_chunkUZQWPQ6Vjs.SDK_VERSION}. Run: ${response.update_command}`,
     "  If an agent skill told you to run this, the skill is newer than this CLI."
   ].join("\n");
 }
 async function runMain(ensureTransport) {
   const mainStartedAt = Date.now();
+  let rootHelpStatus = "";
   _chunkAYHLUHE5js.recordCliTrace.call(void 0, {
     phase: "cli.main_start",
     argv: process.argv.slice(2)
@@ -721,7 +809,7 @@ async function runMain(ensureTransport) {
   const program = new (0, _commander.Command)();
   program.name("deepline").description(
     "Deepline CLI \u2014 GTM enrichment tools, plays, and runs from your terminal."
-  ).version(_chunk4YXJTQ5Xjs.SDK_VERSION, "-v, --version", "Show version").option(
+  ).version(_chunkUZQWPQ6Vjs.SDK_VERSION, "-v, --version", "Show version").option(
     "--maintenance <policy>",
     "Installation maintenance: configured preferences or off; independent of output format",
     parseCliMaintenancePolicy,
@@ -729,7 +817,7 @@ async function runMain(ensureTransport) {
   ).exitOverride().showHelpAfterError().showSuggestionAfterError(true).addHelpText(
     "beforeAll",
     "for agents: ensure you are using the /deepline-gtm skill\n"
-  ).addHelpText(
+  ).addHelpText("before", () => rootHelpStatus).addHelpText(
     "after",
     `
 Common commands:
@@ -765,7 +853,11 @@ Exit codes:
   0 success; 2 usage/local input error; 3 auth/permission error; 4 not found;
   5 server/runtime/provider failure; 7 validation/check failed.
 `
-  );
+  ).addHelpText("afterAll", ({ command }) => {
+    const key = _chunkQILHWZFPjs.commandDocKey.call(void 0, command);
+    const { detail, firstRead } = resolveHelpDetail(process.argv, key);
+    return _chunkQILHWZFPjs.renderCommandExplanation.call(void 0, key, detail, { firstRead });
+  });
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const maintenance = resolveCliMaintenancePolicy(
       actionCommand.optsWithGlobals()
@@ -773,7 +865,7 @@ Exit codes:
     if (actionCommand.name() !== "version") {
       await ensureTransport();
     }
-    if (actionCommand.name() === "version" || actionCommand.name() === "update" || actionCommand.name() === "setup" || actionCommand.name() === "skills" || actionCommand.name() === _chunkC2EHMMMEjs.SKILLS_AUTO_SYNC_COMMAND || actionCommand.name() === "doctor" || isAutoUpdateSettingsInvocation() || isDeprecatedCommandInvocation()) {
+    if (actionCommand.name() === "version" || actionCommand.name() === "update" || actionCommand.name() === "setup" || actionCommand.name() === "skills" || actionCommand.name() === _chunk5PJ6XYRVjs.SKILLS_AUTO_SYNC_COMMAND || actionCommand.name() === "doctor" || isAutoUpdateSettingsInvocation() || isDeprecatedCommandInvocation()) {
       return;
     }
     const compatibilityCommand = compatibilityCommandPath(actionCommand) || actionCommand.name();
@@ -786,16 +878,16 @@ Exit codes:
       _optionalChain([progress, 'optionalAccess', _37 => _37.phase, 'call', _38 => _38("checking sdk compatibility")]);
     }
     const startup = await runStartupStage("SDK compatibility", async () => {
-      const baseUrl = _chunk4YXJTQ5Xjs.autoDetectBaseUrl.call(void 0, ).replace(/\/$/, "");
-      if (maintenance !== "off") _chunkC2EHMMMEjs.flushDeferredSkillsSyncNotices.call(void 0, baseUrl);
+      const baseUrl = _chunkUZQWPQ6Vjs.autoDetectBaseUrl.call(void 0, ).replace(/\/$/, "");
+      if (maintenance !== "off") _chunk5PJ6XYRVjs.flushDeferredSkillsSyncNotices.call(void 0, baseUrl);
       const shouldDeferSkillsSync = maintenance === "off" || shouldDeferSkillsSyncForCommand();
-      const skillsVersion = shouldDeferSkillsSync ? void 0 : _chunk4YXJTQ5Xjs.readSdkSkillsLocalVersion.call(void 0, baseUrl);
-      const trusted = _chunkC2EHMMMEjs.readTrustedCleanCompatibility.call(void 0, 
+      const skillsVersion = shouldDeferSkillsSync ? void 0 : _chunkUZQWPQ6Vjs.readSdkSkillsLocalVersion.call(void 0, baseUrl);
+      const trusted = _chunk5PJ6XYRVjs.readTrustedCleanCompatibility.call(void 0, 
         baseUrl,
         compatibilityCommand,
         skillsVersion
       );
-      const fastDeadline = trusted === null && _chunkC2EHMMMEjs.readFreshCleanCompatibility.call(void 0, 
+      const fastDeadline = trusted === null && _chunk5PJ6XYRVjs.readFreshCleanCompatibility.call(void 0, 
         baseUrl,
         compatibilityCommand,
         skillsVersion
@@ -819,12 +911,12 @@ Exit codes:
           skillsVersion: _nullishCoalesce(skillsVersion, () => ( null)),
           fastDeadline
         },
-        () => _chunkC2EHMMMEjs.checkSdkCompatibility.call(void 0, baseUrl, {
+        () => _chunk5PJ6XYRVjs.checkSdkCompatibility.call(void 0, baseUrl, {
           command: compatibilityCommand,
           skillsVersion,
           persistCache: maintenance !== "off",
           catalog: _chunkQJBJZVG6js.compatibilityCatalog.call(void 0, actionCommand),
-          ...fastDeadline ? { timeoutMs: _chunkC2EHMMMEjs.SDK_COMPATIBILITY_FAST_DEADLINE_MS } : {}
+          ...fastDeadline ? { timeoutMs: _chunk5PJ6XYRVjs.SDK_COMPATIBILITY_FAST_DEADLINE_MS } : {}
         })
       );
       if (compatibility.error) {
@@ -848,7 +940,7 @@ Exit codes:
           response: compatibility.response
         };
       }
-      _chunkC2EHMMMEjs.enforceSdkCompatibilityResponse.call(void 0, compatibility.response, {
+      _chunk5PJ6XYRVjs.enforceSdkCompatibilityResponse.call(void 0, compatibility.response, {
         quietAdvisory: process.argv.includes("--json")
       });
       return {
@@ -869,7 +961,7 @@ Exit codes:
         () => _chunkAYHLUHE5js.traceCliSpan.call(void 0, 
           "cli.sdk_skills_sync",
           { baseUrl: startup.baseUrl },
-          () => _chunkC2EHMMMEjs.syncSdkSkillsIfNeeded.call(void 0, startup.baseUrl, {
+          () => _chunk5PJ6XYRVjs.syncSdkSkillsIfNeeded.call(void 0, startup.baseUrl, {
             update: skillsUpdate,
             mode: "detached"
           })
@@ -897,8 +989,8 @@ Examples:
 `
   ).action(async (options) => {
     const data = await runPreflightCheck();
-    if (_chunk5UNTNKNXjs.shouldEmitJson.call(void 0, options.json)) {
-      _chunk5UNTNKNXjs.printJson.call(void 0, data);
+    if (_chunkBVPN57ADjs.shouldEmitJson.call(void 0, options.json)) {
+      _chunkBVPN57ADjs.printJson.call(void 0, data);
     } else {
       printPreflightHuman(data);
     }
@@ -920,13 +1012,13 @@ Examples:
     try {
       if (options.playRunner) {
         const data2 = await runPlayRunnerHealthCheck();
-        _chunk5UNTNKNXjs.printJson.call(void 0, data2);
+        _chunkBVPN57ADjs.printJson.call(void 0, data2);
         return;
       }
-      const { DeeplineClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./client-3DYV3HZ4.js")));
+      const { DeeplineClient } = await Promise.resolve().then(() => _interopRequireWildcard(require("./client-I4RRFLPM.js")));
       const client = new DeeplineClient();
       const data = await client.health();
-      _chunk5UNTNKNXjs.printJson.call(void 0, data);
+      _chunkBVPN57ADjs.printJson.call(void 0, data);
     } catch (error) {
       throw new Error(
         `Cannot reach Deepline API: ${error instanceof Error ? error.message : String(error)}`
@@ -947,15 +1039,15 @@ Examples:
 `
   ).action((options) => {
     if (options.json) {
-      _chunk5UNTNKNXjs.printCompactJson.call(void 0, { version: _chunk4YXJTQ5Xjs.SDK_VERSION });
+      _chunkBVPN57ADjs.printCompactJson.call(void 0, { version: _chunkUZQWPQ6Vjs.SDK_VERSION });
       return;
     }
-    process.stdout.write(`deepline ${_chunk4YXJTQ5Xjs.SDK_VERSION}
+    process.stdout.write(`deepline ${_chunkUZQWPQ6Vjs.SDK_VERSION}
 `);
   });
   if (process.argv.slice(2).length === 0) {
     if (!process.stdout.isTTY) {
-      _chunk5UNTNKNXjs.printJson.call(void 0, {
+      _chunkBVPN57ADjs.printJson.call(void 0, {
         ok: false,
         exitCode: 2,
         code: "MISSING_COMMAND",
@@ -979,7 +1071,7 @@ Examples:
   const requestedTopLevelCommand = _nullishCoalesce(process.argv.slice(2)[0], () => ( ""));
   if (!topLevelCommandKnown(program, requestedTopLevelCommand)) {
     console.error(`error: unknown command '${requestedTopLevelCommand}'`);
-    const baseUrl = _chunk4YXJTQ5Xjs.autoDetectBaseUrl.call(void 0, );
+    const baseUrl = _chunkUZQWPQ6Vjs.autoDetectBaseUrl.call(void 0, );
     await ensureTransport();
     const versionHint = await newerCliCommandHint(
       baseUrl,
@@ -994,13 +1086,21 @@ Examples:
     return;
   }
   try {
+    const helpArgs = process.argv.slice(2);
+    const helpPositionals = helpArgs.filter((arg) => !arg.startsWith("-"));
+    if (helpPositionals.length === 0 ? helpArgs.includes("--help") || helpArgs.includes("-h") : helpPositionals.length === 1 && helpPositionals[0] === "help") {
+      const { authStatusLine } = await Promise.resolve().then(() => _interopRequireWildcard(require("./auth-VP5WIGFS.js")));
+      rootHelpStatus = `Version: ${_chunkUZQWPQ6Vjs.SDK_VERSION}
+${await authStatusLine()}
+`;
+    }
     await program.parseAsync(process.argv);
     _chunkAYHLUHE5js.recordCliTrace.call(void 0, {
       phase: "cli.main_total",
       ms: Date.now() - mainStartedAt,
       ok: true
     });
-    await _chunkC2EHMMMEjs.maybeReportSdkCliFailure.call(void 0, {
+    await _chunk5PJ6XYRVjs.maybeReportSdkCliFailure.call(void 0, {
       argv: process.argv.slice(2),
       startedAtMs: mainStartedAt,
       exitCode: typeof process.exitCode === "number" ? process.exitCode : null
@@ -1025,7 +1125,7 @@ Examples:
         const commandPath = invocation.commandPath || requestedTopLevelCommand;
         await ensureTransport();
         const versionHint = await newerCliCommandHint(
-          _chunk4YXJTQ5Xjs.autoDetectBaseUrl.call(void 0, ),
+          _chunkUZQWPQ6Vjs.autoDetectBaseUrl.call(void 0, ),
           commandPath
         );
         if (versionHint) console.error(versionHint);
@@ -1036,24 +1136,24 @@ Examples:
       process.exitCode = commanderError.code === "commander.unknownCommand" && !wantsJson ? 2 : _nullishCoalesce(commanderError.exitCode, () => ( 1));
       return;
     } else if (wantsJson) {
-      _chunk5UNTNKNXjs.printJson.call(void 0, {
-        ..._chunk5UNTNKNXjs.errorToJsonPayload.call(void 0, error),
-        ...error instanceof _chunk4YXJTQ5Xjs.AuthError ? { next: AUTH_RECOVERY_COMMAND } : {}
+      _chunkBVPN57ADjs.printJson.call(void 0, {
+        ..._chunkBVPN57ADjs.errorToJsonPayload.call(void 0, error),
+        ...error instanceof _chunkUZQWPQ6Vjs.AuthError ? { next: AUTH_RECOVERY_COMMAND } : {}
       });
     } else if (error instanceof Error) {
       console.error(`Error: ${error.message}`);
-      if (error instanceof _chunk4YXJTQ5Xjs.AuthError) {
+      if (error instanceof _chunkUZQWPQ6Vjs.AuthError) {
         console.error(`Not authenticated. Run: ${AUTH_RECOVERY_COMMAND}`);
       }
-      const providerConcurrency = _chunk5UNTNKNXjs.formatProviderConcurrencyDiagnostic.call(void 0, error);
+      const providerConcurrency = _chunkBVPN57ADjs.formatProviderConcurrencyDiagnostic.call(void 0, error);
       if (providerConcurrency) console.error(providerConcurrency);
     } else {
       console.error(`Error: ${String(error)}`);
     }
     const explicitExitCode = error && typeof error === "object" && typeof error.exitCode === "number" ? error.exitCode : void 0;
-    const failureExitCode = _nullishCoalesce(explicitExitCode, () => ( _chunkC2EHMMMEjs.resolveSdkCliFailureExitCode.call(void 0, error)));
+    const failureExitCode = _nullishCoalesce(explicitExitCode, () => ( _chunk5PJ6XYRVjs.resolveSdkCliFailureExitCode.call(void 0, error)));
     process.exitCode = failureExitCode;
-    await _chunkC2EHMMMEjs.maybeReportSdkCliFailure.call(void 0, {
+    await _chunk5PJ6XYRVjs.maybeReportSdkCliFailure.call(void 0, {
       argv: process.argv.slice(2),
       startedAtMs: mainStartedAt,
       exitCode: failureExitCode,