@dench.com/cli 3.8.0-staging.389 → 3.8.2-staging.391

package/meetings.ts

@@ -721,7 +721,11 @@ async function runImport(ctx: CrmCliContext): Promise<void> {
 // ── help ───────────────────────────────────────────────────────────────────
 
 function meetingsHelp(): void {
-  console.log(`Usage: dench meetings <subcommand>
+  console.log(meetingsHelpText());
+}
+
+export function meetingsHelpText(): string {
+  return `Usage: dench meetings <subcommand>
 
 A meeting is an ordinary CRM record on the protected \`meeting\` object —
 create, update and delete it with \`dench crm entries … meeting\`, query it
@@ -778,5 +782,5 @@ Import many calls at once:
       created/updated meeting gets its transcript, items and attendees.
       Run it as a signed-in member: meetings are owner-scoped records.
 
-Read public/references/CRM-IMPORT.md ("Importing meetings") before a bulk import.`);
+Read public/references/CRM-IMPORT.md ("Importing meetings") before a bulk import.`;
 }

package/members.ts

@@ -440,7 +440,11 @@ async function callQuery(
 }
 
 function membersHelp(): void {
-  console.log(`Usage: dench members <subcommand>
+  console.log(membersHelpText());
+}
+
+export function membersHelpText(): string {
+  return `Usage: dench members <subcommand>
 
 Workspace members for the active organization. Use these userIds when
 assigning CRM \`user\`-type cells (e.g. \`Owner\`, \`Assignee\`) so the
@@ -483,5 +487,5 @@ The server best-effort-resolves a name / email passed to a \`user\`
 field when the match against the roster is unique, but the explicit
 lookup via \`dench members list\` is the correct pattern. Unknown field
 names are rejected on write (pass --allow-unknown to bypass).
-`);
+`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dench.com/cli",
-  "version": "3.8.0-staging.389",
+  "version": "3.8.2-staging.391",
   "description": "Dench agent workspace CLI.",
   "type": "module",
   "bin": {

package/search.ts

@@ -519,7 +519,11 @@ async function runAnswerSubcommand(ctx: SearchCliContext): Promise<void> {
 }
 
 function searchHelp(): void {
-  console.log(`Usage: dench search <subcommand>
+  console.log(searchHelpText());
+}
+
+export function searchHelpText(): string {
+  return `Usage: dench search <subcommand>
 
 Live web access through the Dench Cloud Gateway. Auths
 with DENCH_API_KEY or the active \`dench signin\` agent session. Agent
@@ -566,7 +570,7 @@ Environment variables:
   DENCH_HOST           If it points at localhost, defaults to
                        http://localhost:8787 instead of production.
 
-Exit codes: 0 success, non-zero on gateway / network errors.`);
+Exit codes: 0 success, non-zero on gateway / network errors.`;
 }
 
 // ────────────────────────────────────────────────────────────────────────────

package/tools.ts

@@ -1402,8 +1402,8 @@ function redactForDisplay(value: unknown, key?: string): unknown {
 // Help text
 // ---------------------------------------------------------------------------
 
-export function toolHelp() {
-  console.log(`Dench tool commands
+export function toolHelpText(): string {
+  return `Dench tool commands
 
 Usage:
   dench integrations [--json]
@@ -1436,10 +1436,14 @@ Notes:
   LinkedIn tools are QUEUED, not run inline, so account-safety pacing (daily
   caps, working hours, spacing) applies. They return an action_id — poll it with
   LINKEDIN_GET_ACTION_STATUS.
-  dench tool connect prints the OAuth redirect URL for the human to open.
-  dench tool run output is redacted for display; pass --json for raw output.
+  \`dench tool connect\` prints the OAuth redirect URL for the human to open.
+  \`dench tool run\` output is redacted for display; pass --json for raw output.
   Override the gateway base with DENCH_GATEWAY_URL or GATEWAY_URL.
-`);
+`;
+}
+
+export function toolHelp() {
+  console.log(toolHelpText());
 }
 
 // ---------------------------------------------------------------------------

package/web.ts

@@ -20,7 +20,10 @@ class WebCliError extends Error {}
 const CRAWL_DEFAULT_PAGES = 15;
 const CRAWL_MAX_PAGES = 50;
 
-function parsePositiveInt(name: string, raw: string | undefined): number | undefined {
+function parsePositiveInt(
+  name: string,
+  raw: string | undefined,
+): number | undefined {
   if (raw === undefined) return undefined;
   const parsed = Number(raw);
   if (!Number.isFinite(parsed) || parsed <= 0) {
@@ -125,7 +128,11 @@ function formatMarkdown(data: unknown): string {
 }
 
 export function webHelp(): void {
-  console.log(`Dench web
+  console.log(webHelpText());
+}
+
+export function webHelpText(): string {
+  return `Dench web
 
 Read pages, brand kits, sitemaps, screenshots, and structured extracts
 through the Dench gateway. Prefer these over writing your own scraper.
@@ -145,7 +152,7 @@ through the Dench gateway. Prefer these over writing your own scraper.
 
 Crawl defaults to 15 pages and is hard-capped at 50. Search stays on
 \`dench search\`. \`dench context\` is workspace orientation, not this.
-`);
+`;
 }
 
 async function runWebSubcommand(ctx: WebCliContext): Promise<void> {
@@ -199,7 +206,9 @@ async function runWebSubcommand(ctx: WebCliContext): Promise<void> {
     assertNoUnknownFlags(rest, "web sitemap");
     const domain = rest[0];
     if (!domain) {
-      throw new WebCliError("Usage: dench web sitemap <domain> [--limit N] [--json]");
+      throw new WebCliError(
+        "Usage: dench web sitemap <domain> [--limit N] [--json]",
+      );
     }
     const data = await callWebOp(ctx, "web-sitemap", {
       domain,
@@ -246,7 +255,11 @@ async function runWebSubcommand(ctx: WebCliContext): Promise<void> {
       fullScreenshot: fullPage,
     });
     const record = asRecord(data);
-    out(ctx, data, asString(record?.screenshot) ?? JSON.stringify(data, null, 2));
+    out(
+      ctx,
+      data,
+      asString(record?.screenshot) ?? JSON.stringify(data, null, 2),
+    );
     return;
   }
 
@@ -310,7 +323,8 @@ async function runWebSubcommand(ctx: WebCliContext): Promise<void> {
   if (sub === "fonts") {
     assertNoUnknownFlags(rest, "web fonts");
     const domain = rest[0];
-    if (!domain) throw new WebCliError("Usage: dench web fonts <domain> [--json]");
+    if (!domain)
+      throw new WebCliError("Usage: dench web fonts <domain> [--json]");
     const data = await callWebOp(ctx, "brand-fonts", { domain });
     out(ctx, data, JSON.stringify(data, null, 2));
     return;