deepline 0.3.357 → 0.3.359

package/dist/cli/index.mjs

@@ -1,17 +1,21 @@
 #!/usr/bin/env node
+import {
+  canAutomaticallyApplyUpdatePlan,
+  resolveUpdatePlan,
+  runAutomaticUpdatePlan,
+  shouldRunCliAutoUpdate
+} from "./chunk-4DCOBHTZ.mjs";
+import "./chunk-WNBXT425.mjs";
+import {
+  recordCliTrace,
+  traceCliSpan
+} from "./chunk-UFS752TU.mjs";
 import {
   beginToolExecuteCommand,
   compatibilityCatalog,
   finishToolExecuteCommand,
   runToolExecuteStage
 } from "./chunk-WXLOW623.mjs";
-import {
-  canAutomaticallyApplyUpdatePlan,
-  resolveUpdatePlan,
-  runAutomaticUpdatePlan,
-  shouldRunCliAutoUpdate
-} from "./chunk-2NZUC5OS.mjs";
-import "./chunk-IWBFG4XI.mjs";
 import {
   SDK_COMPATIBILITY_FAST_DEADLINE_MS,
   SKILLS_AUTO_SYNC_COMMAND,
@@ -24,11 +28,7 @@ import {
   readTrustedCleanCompatibility,
   resolveSdkCliFailureExitCode,
   syncSdkSkillsIfNeeded
-} from "./chunk-QYCAH7SM.mjs";
-import {
-  recordCliTrace,
-  traceCliSpan
-} from "./chunk-UFS752TU.mjs";
+} from "./chunk-ZY6QZZ5K.mjs";
 import {
   createCliProgress
 } from "./chunk-GAMFK2ZP.mjs";
@@ -38,20 +38,26 @@ import {
   printCompactJson,
   printJson,
   shouldEmitJson
-} from "./chunk-PJYCAGKK.mjs";
+} from "./chunk-WR7H6MZ6.mjs";
 import {
   AuthError,
   HttpClient,
   SDK_VERSION,
+  agentSessionIdFromEnvironment,
   autoDetectBaseUrl,
   readSdkSkillsLocalVersion,
   resolveApiKeyForBaseUrl,
   resolveConfig
-} from "./chunk-VG5WMYSF.mjs";
+} from "./chunk-FCZIE4UQ.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-N47R7S3E.mjs";
 import "./chunk-NXGCO4JB.mjs";
+import "./chunk-BJYW3XTM.mjs";
 import "./chunk-WZYKRD7T.mjs";
+import {
+  commandDocKey,
+  helpDetailFromArgv,
+  renderCommandExplanation
+} from "./chunk-QFBHEQCQ.mjs";
 import "./chunk-KRD6H754.mjs";
 
 // src/cli/command-invocation.ts
@@ -107,7 +113,7 @@ function inspectCliInvocation(program, argv) {
 
 // src/cli/index.ts
 import { mkdtemp, rm, writeFile } from "fs/promises";
-import { join } from "path";
+import { join as join2 } from "path";
 import { tmpdir } from "os";
 import { Command as Command2 } from "commander";
 
@@ -115,48 +121,48 @@ import { Command as Command2 } from "commander";
 var COMMAND_GROUPS = [
   {
     names: ["auth"],
-    load: async () => (await import("./auth-5Y2YV5LY.mjs")).registerAuthCommands
+    load: async () => (await import("./auth-ZOW4L37H.mjs")).registerAuthCommands
   },
   {
     names: ["providers"],
-    load: async () => (await import("./providers-L2MPYA3E.mjs")).registerProviderCommands
+    load: async () => (await import("./providers-GFR4DPBC.mjs")).registerProviderCommands
   },
   {
     names: ["search"],
-    load: async () => (await import("./search-IPTZAOUE.mjs")).registerSearchCommand
+    load: async () => (await import("./search-OVRR4XOJ.mjs")).registerSearchCommand
   },
   {
     names: ["describe"],
-    load: async () => (await import("./describe-K2SJ22B3.mjs")).registerDescribeCommand
+    load: async () => (await import("./describe-5WQ55FIR.mjs")).registerDescribeCommand
   },
   {
     names: ["tools"],
-    load: async () => (await import("./tools-ILYNEPGQ.mjs")).registerToolsCommands
+    load: async () => (await import("./tools-M4VNLWYB.mjs")).registerToolsCommands
   },
   {
     names: ["executions"],
-    load: async () => (await import("./executions-452G2REF.mjs")).registerExecutionsCommands
+    load: async () => (await import("./executions-R7WAC2JA.mjs")).registerExecutionsCommands
   },
   {
     names: ["plays", "runs"],
-    load: async () => (await import("./play-OFO6XZ5L.mjs")).registerPlayCommands
+    load: async () => (await import("./play-PB6LSSNG.mjs")).registerPlayCommands
   },
   {
     names: ["sessions"],
-    load: async () => (await import("./sessions-D4JETMAW.mjs")).registerSessionsCommands
+    load: async () => (await import("./sessions-JP4XKXEJ.mjs")).registerSessionsCommands
   },
   {
     names: ["workflows"],
-    load: async () => (await import("./workflow-A6ID4C6N.mjs")).registerWorkflowCommands
+    load: async () => (await import("./workflow-PE2IONVL.mjs")).registerWorkflowCommands
   },
   {
     names: ["secrets"],
-    load: async () => (await import("./secrets-TCOPPNXR.mjs")).registerSecretsCommands
+    load: async () => (await import("./secrets-VXXVGDET.mjs")).registerSecretsCommands
   },
   {
     names: ["settings", "notifications"],
     load: async () => {
-      const commands = await import("./settings-IVJPCORG.mjs");
+      const commands = await import("./settings-MMC5Q5FJ.mjs");
       return (p) => {
         commands.registerSettingsCommands(p);
         commands.registerNotificationCommands(p);
@@ -165,51 +171,51 @@ var COMMAND_GROUPS = [
   },
   {
     names: ["billing"],
-    load: async () => (await import("./billing-UOFR7KDB.mjs")).registerBillingCommands
+    load: async () => (await import("./billing-JPMZX77W.mjs")).registerBillingCommands
   },
   {
     names: ["monitors"],
-    load: async () => (await import("./monitors-43R6CUFK.mjs")).registerMonitorsCommands
+    load: async () => (await import("./monitors-7GHIY5BR.mjs")).registerMonitorsCommands
   },
   {
     names: ["org"],
-    load: async () => (await import("./org-X5WSLJRD.mjs")).registerOrgCommands
+    load: async () => (await import("./org-ZGU7BBDD.mjs")).registerOrgCommands
   },
   {
     names: ["git", "projects", "deployments"],
-    load: async () => (await import("./git-CAPESVAJ.mjs")).registerGitCommands
+    load: async () => (await import("./git-Y6VXODAK.mjs")).registerGitCommands
   },
   {
     names: ["csv"],
-    load: async () => (await import("./csv-VKEF5C65.mjs")).registerCsvCommands
+    load: async () => (await import("./csv-4QWZUAJP.mjs")).registerCsvCommands
   },
   {
     names: ["db"],
-    load: async () => (await import("./db-KX7FDHL4.mjs")).registerDbCommands
+    load: async () => (await import("./db-T4CMZPJQ.mjs")).registerDbCommands
   },
   {
     names: ["feedback"],
-    load: async () => (await import("./feedback-55HU4EQY.mjs")).registerFeedbackCommands
+    load: async () => (await import("./feedback-2V5PBCPX.mjs")).registerFeedbackCommands
   },
   {
     names: ["enrich", "session", "backend"],
-    load: async () => (await import("./legacy-noops-3B3MG33Y.mjs")).registerDeprecatedCommands
+    load: async () => (await import("./legacy-noops-YEEZNYIS.mjs")).registerDeprecatedCommands
   },
   {
     names: ["update"],
-    load: async () => (await import("./update-P3VIHMC6.mjs")).registerUpdateCommand
+    load: async () => (await import("./update-HXQVI37L.mjs")).registerUpdateCommand
   },
   {
     names: ["skills", "skills-auto-sync"],
-    load: async () => (await import("./skills-GYWMUDDF.mjs")).registerSkillsCommand
+    load: async () => (await import("./skills-VRVG63GO.mjs")).registerSkillsCommand
   },
   {
     names: ["setup", "doctor"],
-    load: async () => (await import("./setup-WCKQK7FE.mjs")).registerSetupCommands
+    load: async () => (await import("./setup-6LWUQ34C.mjs")).registerSetupCommands
   },
   {
     names: ["quickstart"],
-    load: async () => (await import("./quickstart-NHFMGZ3B.mjs")).registerQuickstartCommands
+    load: async () => (await import("./quickstart-MXH3LZQ5.mjs")).registerQuickstartCommands
   }
 ];
 async function registerDeeplineCommandGroups(program, requestedCommand) {
@@ -231,6 +237,87 @@ function registerDeeplineInlineCommands(program) {
   return { preflight, health, version };
 }
 
+// src/cli/help-seen.ts
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync
+} from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+var MAX_SESSIONS = 20;
+function helpSeenPath(homeDir = homedir()) {
+  return join(homeDir, ".local", "deepline", "sdk-cli", "help-seen.json");
+}
+function resolveHelpDetail(argv, key, homeDir = homedir(), sessionId = agentSessionIdFromEnvironment()) {
+  const explicit = helpDetailFromArgv(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 (!existsSync(path)) return /* @__PURE__ */ new Map();
+  try {
+    const parsed = JSON.parse(readFileSync(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 {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(
+      tempPath,
+      `${JSON.stringify(
+        {
+          schemaVersion: 2,
+          sessions: recent.map(([id, seen]) => ({ id, seen }))
+        },
+        null,
+        2
+      )}
+`,
+      { encoding: "utf8", mode: 384 }
+    );
+    renameSync(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 {
+    rmSync(tempPath, { force: true });
+  }
+}
+
 // src/cli/self-update.ts
 import { spawn } from "child_process";
 var AUTO_UPDATE_TELEMETRY_TIMEOUT_MS = 2e3;
@@ -507,8 +594,8 @@ function topLevelCommandKnown(program, commandName) {
   );
 }
 async function runPlayRunnerHealthCheck() {
-  const dir = await mkdtemp(join(tmpdir(), "deepline-health-play-"));
-  const file = join(dir, "health-check.play.ts");
+  const dir = await mkdtemp(join2(tmpdir(), "deepline-health-play-"));
+  const file = join2(dir, "health-check.play.ts");
   try {
     await writeFile(
       file,
@@ -536,7 +623,7 @@ async function runPlayRunnerHealthCheck() {
     });
     let exitCode = 1;
     try {
-      const { handlePlayRun } = await import("./play-OFO6XZ5L.mjs");
+      const { handlePlayRun } = await import("./play-PB6LSSNG.mjs");
       exitCode = await handlePlayRun([
         file,
         "--input",
@@ -709,6 +796,7 @@ async function newerCliCommandHint(baseUrl, command) {
 }
 async function runMain(ensureTransport) {
   const mainStartedAt = Date.now();
+  let rootHelpStatus = "";
   recordCliTrace({
     phase: "cli.main_start",
     argv: process.argv.slice(2)
@@ -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 = commandDocKey(command);
+    const { detail, firstRead } = resolveHelpDetail(process.argv, key);
+    return renderCommandExplanation(key, detail, { firstRead });
+  });
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const maintenance = resolveCliMaintenancePolicy(
       actionCommand.optsWithGlobals()
@@ -923,7 +1015,7 @@ Examples:
         printJson(data2);
         return;
       }
-      const { DeeplineClient } = await import("./client-23QTYYIR.mjs");
+      const { DeeplineClient } = await import("./client-32IMOGBO.mjs");
       const client = new DeeplineClient();
       const data = await client.health();
       printJson(data);
@@ -994,6 +1086,14 @@ 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 import("./auth-ZOW4L37H.mjs");
+      rootHelpStatus = `Version: ${SDK_VERSION}
+${await authStatusLine()}
+`;
+    }
     await program.parseAsync(process.argv);
     recordCliTrace({
       phase: "cli.main_total",

package/dist/cli/{legacy-noops-PV5AWTIZ.js → legacy-noops-KDRTNUUC.js}

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkR5P3KFF5js = require('./chunk-R5P3KFF5.js');
+var _chunkP4CCF5ZVjs = require('./chunk-P4CCF5ZV.js');
 
 
 var _chunk3XX5TEA4js = require('./chunk-3XX5TEA4.js');
 
 
-var _chunk5UNTNKNXjs = require('./chunk-5UNTNKNX.js');
-require('./chunk-4YXJTQ5X.js');
+var _chunkARNODHMCjs = require('./chunk-ARNODHMC.js');
+require('./chunk-5ZKZWXVN.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-SXXUOZRS.js');
 require('./chunk-7P5AA3SN.js');
+require('./chunk-3EF4OMSE.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -51,7 +51,7 @@ function deprecatedCommandEnvelope(input) {
   };
 }
 function printDeprecatedCommand(input) {
-  _chunk5UNTNKNXjs.printCommandEnvelope.call(void 0, deprecatedCommandEnvelope(input), {
+  _chunkARNODHMCjs.printCommandEnvelope.call(void 0, deprecatedCommandEnvelope(input), {
     json: input.options.json
   });
   process.exitCode = 2;
@@ -71,7 +71,7 @@ function registerDeprecatedCommands(program) {
   program.command("enrich", { hidden: true }).description("Deprecated CSV enrichment command.").allowUnknownOption(true).allowExcessArguments(true).option("--json", "Emit JSON output").argument("[args...]").addHelpText("after", `
 ${_chunk3XX5TEA4js.ENRICH_COMMAND_DEPRECATION_MESSAGE}
 `).action((_args, options) => {
-    _chunk5UNTNKNXjs.printCommandEnvelope.call(void 0, 
+    _chunkARNODHMCjs.printCommandEnvelope.call(void 0, 
       {
         ok: false,
         command: "deepline enrich",
@@ -114,7 +114,7 @@ Examples:
       options
     });
   });
-  _chunkR5P3KFF5js.registerSessionSendRenderCommands.call(void 0, session, "session");
+  _chunkP4CCF5ZVjs.registerSessionSendRenderCommands.call(void 0, session, "session");
   for (const subcommand of SESSION_SUBCOMMANDS) {
     addDeprecatedSubcommand(
       session,

package/dist/cli/{legacy-noops-3B3MG33Y.mjs → legacy-noops-YEEZNYIS.mjs}

@@ -1,16 +1,16 @@
 import {
   registerSessionSendRenderCommands
-} from "./chunk-2AROJ4EZ.mjs";
+} from "./chunk-U2G2WO43.mjs";
 import {
   ENRICH_COMMAND_DEPRECATION_MESSAGE
 } from "./chunk-ITOFSXIU.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-PJYCAGKK.mjs";
-import "./chunk-VG5WMYSF.mjs";
+} from "./chunk-WR7H6MZ6.mjs";
+import "./chunk-FCZIE4UQ.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-N47R7S3E.mjs";
 import "./chunk-NXGCO4JB.mjs";
+import "./chunk-BJYW3XTM.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{monitors-43R6CUFK.mjs → monitors-7GHIY5BR.mjs}

@@ -1,7 +1,8 @@
 import "./chunk-EXMLR72R.mjs";
 import {
   DeeplineClient
-} from "./chunk-NZ6BT4NL.mjs";
+} from "./chunk-72362UER.mjs";
+import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
   MONITOR_FLEET_DOCUMENTATION,
@@ -16,16 +17,15 @@ import {
   printCommandEnvelope,
   printJson,
   shouldEmitJson
-} from "./chunk-PJYCAGKK.mjs";
+} from "./chunk-WR7H6MZ6.mjs";
 import {
   AuthError
-} from "./chunk-VG5WMYSF.mjs";
+} from "./chunk-FCZIE4UQ.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-N47R7S3E.mjs";
-import "./chunk-6IKARAYD.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
+import "./chunk-BJYW3XTM.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";