deepline 0.3.356 → 0.3.358

package/dist/cli/index.mjs

@@ -1,17 +1,21 @@
 #!/usr/bin/env node
+import {
+  canAutomaticallyApplyUpdatePlan,
+  resolveUpdatePlan,
+  runAutomaticUpdatePlan,
+  shouldRunCliAutoUpdate
+} from "./chunk-Q77PWYDF.mjs";
+import "./chunk-4IUOBUNS.mjs";
+import {
+  recordCliTrace,
+  traceCliSpan
+} from "./chunk-UFS752TU.mjs";
 import {
   beginToolExecuteCommand,
   compatibilityCatalog,
   finishToolExecuteCommand,
   runToolExecuteStage
 } from "./chunk-WXLOW623.mjs";
-import {
-  canAutomaticallyApplyUpdatePlan,
-  resolveUpdatePlan,
-  runAutomaticUpdatePlan,
-  shouldRunCliAutoUpdate
-} from "./chunk-YFLAUIJN.mjs";
-import "./chunk-35AZMPQV.mjs";
 import {
   SDK_COMPATIBILITY_FAST_DEADLINE_MS,
   SKILLS_AUTO_SYNC_COMMAND,
@@ -24,11 +28,7 @@ import {
   readTrustedCleanCompatibility,
   resolveSdkCliFailureExitCode,
   syncSdkSkillsIfNeeded
-} from "./chunk-7LFNGGH6.mjs";
-import {
-  recordCliTrace,
-  traceCliSpan
-} from "./chunk-UFS752TU.mjs";
+} from "./chunk-YWGKGXSH.mjs";
 import {
   createCliProgress
 } from "./chunk-GAMFK2ZP.mjs";
@@ -38,20 +38,26 @@ import {
   printCompactJson,
   printJson,
   shouldEmitJson
-} from "./chunk-6S2HRJIV.mjs";
+} from "./chunk-EL62MLRD.mjs";
 import {
   AuthError,
   HttpClient,
   SDK_VERSION,
+  agentSessionIdFromEnvironment,
   autoDetectBaseUrl,
   readSdkSkillsLocalVersion,
   resolveApiKeyForBaseUrl,
   resolveConfig
-} from "./chunk-WF5BHZWA.mjs";
+} from "./chunk-VZBNBCEB.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-2CTZ4MRZ.mjs";
 import "./chunk-NXGCO4JB.mjs";
+import "./chunk-SJY4SUCH.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-PFLCB6IL.mjs")).registerAuthCommands
+    load: async () => (await import("./auth-QSEB4OI6.mjs")).registerAuthCommands
   },
   {
     names: ["providers"],
-    load: async () => (await import("./providers-RH5ZPZXO.mjs")).registerProviderCommands
+    load: async () => (await import("./providers-5JHHZWMF.mjs")).registerProviderCommands
   },
   {
     names: ["search"],
-    load: async () => (await import("./search-TBOZ5R36.mjs")).registerSearchCommand
+    load: async () => (await import("./search-B2BB2MHO.mjs")).registerSearchCommand
   },
   {
     names: ["describe"],
-    load: async () => (await import("./describe-LFKBFDRQ.mjs")).registerDescribeCommand
+    load: async () => (await import("./describe-NCUJW2JG.mjs")).registerDescribeCommand
   },
   {
     names: ["tools"],
-    load: async () => (await import("./tools-AMNLACHH.mjs")).registerToolsCommands
+    load: async () => (await import("./tools-N2H5HJYP.mjs")).registerToolsCommands
   },
   {
     names: ["executions"],
-    load: async () => (await import("./executions-6UVFDX2O.mjs")).registerExecutionsCommands
+    load: async () => (await import("./executions-NOZELHEN.mjs")).registerExecutionsCommands
   },
   {
     names: ["plays", "runs"],
-    load: async () => (await import("./play-42RA7JRU.mjs")).registerPlayCommands
+    load: async () => (await import("./play-FMPNHLXU.mjs")).registerPlayCommands
   },
   {
     names: ["sessions"],
-    load: async () => (await import("./sessions-BAMVNM3F.mjs")).registerSessionsCommands
+    load: async () => (await import("./sessions-VRDJCPKE.mjs")).registerSessionsCommands
   },
   {
     names: ["workflows"],
-    load: async () => (await import("./workflow-C2KGKJJD.mjs")).registerWorkflowCommands
+    load: async () => (await import("./workflow-WY2CL73A.mjs")).registerWorkflowCommands
   },
   {
     names: ["secrets"],
-    load: async () => (await import("./secrets-IN4XCGBJ.mjs")).registerSecretsCommands
+    load: async () => (await import("./secrets-XJOXWVUG.mjs")).registerSecretsCommands
   },
   {
     names: ["settings", "notifications"],
     load: async () => {
-      const commands = await import("./settings-HZFVYTEW.mjs");
+      const commands = await import("./settings-QEL2SD7N.mjs");
       return (p) => {
         commands.registerSettingsCommands(p);
         commands.registerNotificationCommands(p);
@@ -165,51 +171,51 @@ var COMMAND_GROUPS = [
   },
   {
     names: ["billing"],
-    load: async () => (await import("./billing-T3K2KS55.mjs")).registerBillingCommands
+    load: async () => (await import("./billing-KNJ6ZHSN.mjs")).registerBillingCommands
   },
   {
     names: ["monitors"],
-    load: async () => (await import("./monitors-JL7A5ZOX.mjs")).registerMonitorsCommands
+    load: async () => (await import("./monitors-LEGM63T3.mjs")).registerMonitorsCommands
   },
   {
     names: ["org"],
-    load: async () => (await import("./org-L6TG5MRM.mjs")).registerOrgCommands
+    load: async () => (await import("./org-RBIBSVP3.mjs")).registerOrgCommands
   },
   {
     names: ["git", "projects", "deployments"],
-    load: async () => (await import("./git-BLVZPTBC.mjs")).registerGitCommands
+    load: async () => (await import("./git-C3SPUEUB.mjs")).registerGitCommands
   },
   {
     names: ["csv"],
-    load: async () => (await import("./csv-NLCVCEZ3.mjs")).registerCsvCommands
+    load: async () => (await import("./csv-OQUTHAMD.mjs")).registerCsvCommands
   },
   {
     names: ["db"],
-    load: async () => (await import("./db-IMLYZF3N.mjs")).registerDbCommands
+    load: async () => (await import("./db-QH56PKPT.mjs")).registerDbCommands
   },
   {
     names: ["feedback"],
-    load: async () => (await import("./feedback-PH3WH5LE.mjs")).registerFeedbackCommands
+    load: async () => (await import("./feedback-GL7YHJAK.mjs")).registerFeedbackCommands
   },
   {
     names: ["enrich", "session", "backend"],
-    load: async () => (await import("./legacy-noops-5JDDNT4H.mjs")).registerDeprecatedCommands
+    load: async () => (await import("./legacy-noops-BBDNHMAW.mjs")).registerDeprecatedCommands
   },
   {
     names: ["update"],
-    load: async () => (await import("./update-3PBHH5FL.mjs")).registerUpdateCommand
+    load: async () => (await import("./update-MUMZ6L7J.mjs")).registerUpdateCommand
   },
   {
     names: ["skills", "skills-auto-sync"],
-    load: async () => (await import("./skills-DB3TE5LF.mjs")).registerSkillsCommand
+    load: async () => (await import("./skills-73PM6I6F.mjs")).registerSkillsCommand
   },
   {
     names: ["setup", "doctor"],
-    load: async () => (await import("./setup-3YOU6BBX.mjs")).registerSetupCommands
+    load: async () => (await import("./setup-FNVP5XQR.mjs")).registerSetupCommands
   },
   {
     names: ["quickstart"],
-    load: async () => (await import("./quickstart-OMZY743O.mjs")).registerQuickstartCommands
+    load: async () => (await import("./quickstart-RYKNMAFN.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-42RA7JRU.mjs");
+      const { handlePlayRun } = await import("./play-FMPNHLXU.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-XMFAODL2.mjs");
+      const { DeeplineClient } = await import("./client-M2TQV23S.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-QSEB4OI6.mjs");
+      rootHelpStatus = `Version: ${SDK_VERSION}
+${await authStatusLine()}
+`;
+    }
     await program.parseAsync(process.argv);
     recordCliTrace({
       phase: "cli.main_total",

package/dist/cli/{legacy-noops-5JDDNT4H.mjs → legacy-noops-BBDNHMAW.mjs}

@@ -1,16 +1,16 @@
 import {
   registerSessionSendRenderCommands
-} from "./chunk-GD4YCB5C.mjs";
+} from "./chunk-NMHQTEIQ.mjs";
 import {
   ENRICH_COMMAND_DEPRECATION_MESSAGE
 } from "./chunk-ITOFSXIU.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-6S2HRJIV.mjs";
-import "./chunk-WF5BHZWA.mjs";
+} from "./chunk-EL62MLRD.mjs";
+import "./chunk-VZBNBCEB.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-2CTZ4MRZ.mjs";
 import "./chunk-NXGCO4JB.mjs";
+import "./chunk-SJY4SUCH.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{legacy-noops-KQBQ4WMC.js → legacy-noops-W6UWORVY.js}

@@ -1,16 +1,16 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkMK3WFSJNjs = require('./chunk-MK3WFSJN.js');
+var _chunkHNAFCPM4js = require('./chunk-HNAFCPM4.js');
 
 
 var _chunk3XX5TEA4js = require('./chunk-3XX5TEA4.js');
 
 
-var _chunkHBN5ORV2js = require('./chunk-HBN5ORV2.js');
-require('./chunk-A544Z3OR.js');
+var _chunkBVPN57ADjs = require('./chunk-BVPN57AD.js');
+require('./chunk-UZQWPQ6V.js');
 require('./chunk-XNYIZMNQ.js');
-require('./chunk-YILVDBYO.js');
 require('./chunk-7P5AA3SN.js');
+require('./chunk-OVUDXZCK.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -51,7 +51,7 @@ function deprecatedCommandEnvelope(input) {
   };
 }
 function printDeprecatedCommand(input) {
-  _chunkHBN5ORV2js.printCommandEnvelope.call(void 0, deprecatedCommandEnvelope(input), {
+  _chunkBVPN57ADjs.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) => {
-    _chunkHBN5ORV2js.printCommandEnvelope.call(void 0, 
+    _chunkBVPN57ADjs.printCommandEnvelope.call(void 0, 
       {
         ok: false,
         command: "deepline enrich",
@@ -114,7 +114,7 @@ Examples:
       options
     });
   });
-  _chunkMK3WFSJNjs.registerSessionSendRenderCommands.call(void 0, session, "session");
+  _chunkHNAFCPM4js.registerSessionSendRenderCommands.call(void 0, session, "session");
   for (const subcommand of SESSION_SUBCOMMANDS) {
     addDeprecatedSubcommand(
       session,

package/dist/cli/{monitors-JL7A5ZOX.mjs → monitors-LEGM63T3.mjs}

@@ -1,7 +1,8 @@
 import "./chunk-EXMLR72R.mjs";
 import {
   DeeplineClient
-} from "./chunk-AUQYSGGD.mjs";
+} from "./chunk-EVPWVNJV.mjs";
+import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
 import {
   MONITOR_FLEET_DOCUMENTATION,
@@ -16,16 +17,15 @@ import {
   printCommandEnvelope,
   printJson,
   shouldEmitJson
-} from "./chunk-6S2HRJIV.mjs";
+} from "./chunk-EL62MLRD.mjs";
 import {
   AuthError
-} from "./chunk-WF5BHZWA.mjs";
+} from "./chunk-VZBNBCEB.mjs";
 import "./chunk-DLIRSHV6.mjs";
-import "./chunk-2CTZ4MRZ.mjs";
-import "./chunk-6IKARAYD.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
+import "./chunk-SJY4SUCH.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";