@curviate/cli 0.21.1 → 0.22.0

package/README.md

@@ -23,20 +23,20 @@ Requires Node.js 18 or later.
 
 ## Authentication
 
-**Option 1 — interactive login** (stores a profile in `~/.config/curviate/`):
+**Option 1: interactive login** (stores a profile in `~/.config/curviate/`):
 
 ```bash
 curviate login
 ```
 
-**Option 2 — environment variable** (preferred in CI and agent loops):
+**Option 2: environment variable** (preferred in CI and agent loops):
 
 ```bash
 export CURVIATE_API_KEY=<your-api-key>
 curviate account list
 ```
 
-**Option 3 — per-command flag**:
+**Option 3: per-command flag**:
 
 ```bash
 curviate --api-key <your-api-key> account list
@@ -80,14 +80,14 @@ These examples show how coding agents compose the CLI in real workflows.
 Search for matching profiles, preview the invitations, then send them once satisfied:
 
 ```bash
-# Look first — a search is a read, so it just runs (no --preview on reads)
+# Look first: a search is a read, so it just runs (no --preview on reads)
 curviate search people \
   --keywords "AI engineer" \
   --location "Berlin" \
   --limit 10 \
   --json
 
-# Preview a single write before sending, then pipe IDs into connect — one request per person
+# Preview a single write before sending, then pipe IDs into connect, one request per person
 curviate connect "$SOME_ID" --note "Hi, I'd love to connect." --preview
 
 curviate search people --keywords "AI engineer" --location "Berlin" --all \
@@ -107,7 +107,7 @@ curviate inbox list --json --all \
 
 ### 3. Warm up a prospect by reacting to their recent posts
 
-Read recent posts from a profile, then react to each — useful for ambient warm-up before outreach:
+Read recent posts from a profile, then react to each, which is useful for ambient warm-up before outreach:
 
 ```bash
 PROFILE_URL="https://www.linkedin.com/in/example"
@@ -126,7 +126,7 @@ curviate sales-nav search people --keywords "VP Engineering" --json \
   || {
     code=$?
     if [ "$code" -eq 5 ]; then
-      echo "Sales Navigator add-on required — upgrade at https://docs.curviate.com"
+      echo "Sales Navigator add-on required. Upgrade at https://docs.curviate.com"
     else
       echo "Search failed with exit code $code"
       exit "$code"
@@ -136,7 +136,7 @@ curviate sales-nav search people --keywords "VP Engineering" --json \
 
 ### 5. Verify an inbound webhook signature offline
 
-Validate a webhook payload before processing it — works without a network call:
+Validate a webhook payload before processing it, with no network call:
 
 ```bash
 # Pipe the raw request body from stdin; pass the signature header and secret as flags
@@ -162,7 +162,7 @@ curviate account list --all --json \
 
 ### 7. Search jobs, then fetch full detail on the top result
 
-`job get` accepts either a job URL or the bare numeric id — including the `job_urn` field a
+`job get` accepts either a job URL or the bare numeric id, including the `job_urn` field a
 job-search result already returns:
 
 ```bash
@@ -178,7 +178,7 @@ curviate job get "https://www.linkedin.com/jobs/view/4428113858" --account acc_1
 
 Company commands (`curviate company ...`) are Core-tier reads. `company <id>` accepts a public
 handle (the slug in `linkedin.com/company/<handle>`) or a numeric id; the four sub-resource
-commands require the company's **numeric provider id** — the `id` field `company <id>` returns.
+commands require the company's **numeric provider id**, the `id` field `company <id>` returns.
 `--account` (or a configured default account) is required on all of them.
 
 ### 1. Retrieve a company, then list its employees
@@ -199,7 +199,7 @@ curviate company jobs 112013061 --all --account acc_1 --json   # streams every p
 
 Sales Navigator commands (`curviate sales-nav ...`) require an account with the Sales Navigator
 add-on tier attached. A call against an account without it fails with **exit code `5`** and a
-`TIER_NOT_ACTIVE` error body naming the required tier (`sales_nav`) — branch on the exit code the
+`TIER_NOT_ACTIVE` error body naming the required tier (`sales_nav`); branch on the exit code the
 same way as example 4 above. Write commands (`save-lead`, `save-account`, `message new`) accept
 `--preview` to render the request without sending it.
 
@@ -216,7 +216,7 @@ curviate sales-nav search people \
 
 ### 2. Save a lead to a specific lead list
 
-Preview first, then send. `--list` is required — the save always targets a specific list.
+Preview first, then send. `--list` is required; the save always targets a specific list.
 
 ```bash
 curviate sales-nav save-lead ACwAAA1234567 \
@@ -233,7 +233,7 @@ curviate sales-nav save-lead ACwAAA1234567 --account acc_1 --list 987654
 curviate sales-nav message new \
   --to ACwAAA1234567 \
   --account acc_1 \
-  "Hi — I'd love to connect about an opportunity at our company."
+  "Hi, I'd love to connect about an opportunity at our company."
 ```
 
 ### 4. Search Sales Navigator companies
@@ -321,7 +321,7 @@ the v2 job body. `recruiter job publish` is project-scoped and requires `--mode`
 ```bash
 curviate recruiter job create \
   --account acc_1 \
-  --project-name "Backend Hiring — 2026" \
+  --project-name "Backend Hiring 2026" \
   --job-title "Senior Backend Engineer" \
   --description "Remote-first team building the core platform." \
   --employment-status FULL_TIME \
@@ -380,14 +380,14 @@ curviate recruiter message new \
   --to AEM789 \
   --account acc_1 \
   --subject "A role you'd be a great fit for" \
-  --signature "— Alex, Talent Team" \
-  "Hi — I came across your profile and think you'd be a great fit for a role we're hiring for."
+  --signature "- Alex, Talent Team" \
+  "Hi, I came across your profile and think you'd be a great fit for a role we're hiring for."
 ```
 
 ### 9. List your postings, and get any public job posting through the Recruiter lens
 
 Unlike `recruiter jobs` (which lists postings you manage), `recruiter job get` retrieves the full
-detail of *any* public LinkedIn job posting — the Recruiter-seated counterpart to the top-level
+detail of *any* public LinkedIn job posting, the Recruiter-seated counterpart to the top-level
 `job get` command:
 
 ```bash
@@ -410,4 +410,4 @@ curviate recruiter job get "https://www.linkedin.com/jobs/view/4428113858" --acc
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT. See [LICENSE](LICENSE).

package/dist/{account-OIV73PXX.js → account-QRGWUQXF.js}

@@ -4,16 +4,16 @@ import {
 } from "./chunk-H4KV7MIN.js";
 import {
   AUTH_NEEDED
-} from "./chunk-M6UDWFHX.js";
+} from "./chunk-PMRQXBCP.js";
 import {
   slimAccountGet,
   slimAccountList,
   slimAccountListItem
-} from "./chunk-WYRYCTUM.js";
+} from "./chunk-RFUO2G3M.js";
 import {
   pageDelayFromFlags,
   streamAll
-} from "./chunk-HZFK45IW.js";
+} from "./chunk-H6XD3F66.js";
 import {
   buildPreviewOutput
 } from "./chunk-R3VLWLVV.js";
@@ -23,7 +23,7 @@ import {
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-VPKMJYIF.js";
+} from "./chunk-JA3NNST6.js";
 import {
   GLOBAL_FLAGS,
   READ_SINGLE_FLAGS,
@@ -221,7 +221,7 @@ function resolveOutputOpts(flags) {
 async function handleError(err, outOpts, out) {
   const { CurviateError } = await import("@curviate/sdk");
   if (err instanceof CurviateError) {
-    const { getExitCode } = await import("./exit-codes-63JE5GM5.js");
+    const { getExitCode } = await import("./exit-codes-KAVZN5BQ.js");
     renderError(err, outOpts, out);
     process.exit(getExitCode(err.code));
   }
@@ -284,13 +284,13 @@ async function buildAuthBody(flags, ctx) {
       readSingleLine: ctx.readSingleLine,
       required: true,
       // The masked-prompt/fail-fast tiers (3/4) only engage once --email is
-      // present (nothing meaningful to prompt toward yet otherwise) — and
+      // present (nothing meaningful to prompt toward yet otherwise), and
       // never under --preview (a client-side render must not prompt or
       // exit).
       allowInteractive: !ctx.previewMode && Boolean(flags.email),
       // Tier-1b's own gate is preview-only, deliberately NOT email-gated: a
       // user who passed --password-stdin on a TTY gets the read regardless
-      // of --email — an email-less body still fails downstream validation,
+      // of --email, an email-less body still fails downstream validation,
       // as expected, rather than the flag being silently ignored.
       allowInteractiveStdinRead: !ctx.previewMode,
       failMessage: "no password. Pass --password, --password-stdin, or set CURVIATE_LINKEDIN_PASSWORD",
@@ -357,11 +357,11 @@ function resolveCredentialIO(io) {
     isOutputTTY: io.isOutputTTY ?? (process.stdout.isTTY ?? false),
     readline: io.readline ?? readlineSync,
     readStdin: io.readStdin ?? defaultReadStdin,
-    // Always the masked, no-echo raw-mode branch — never a bare readlineSync
+    // Always the masked, no-echo raw-mode branch, never a bare readlineSync
     // pass-through, which would default mask to false and echo the secret.
     // Prompt is deliberately EMPTY, not `cue`: credential-resolve.ts already
     // wrote STDIN_TTY_CUE to out.stderr before calling this reader, and
-    // readlineSync itself writes its `prompt` argument to stderr too — the
+    // readlineSync itself writes its `prompt` argument to stderr too, the
     // cue text would otherwise print twice on a real terminal.
     readSingleLine: io.readSingleLine ?? (() => readlineSync("", { mask: true })),
     sleep: io.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms))),
@@ -504,8 +504,8 @@ async function runAccountLink(client, flags, out, io = {}) {
   const body = {
     seat_id: flags["seat-id"],
     ...authBody,
-    // --account-id (0.15.0): present → re-authenticate this existing account in
-    // place (reconnect); omit → connect a new account, with NO account_id key in
+    // --account-id (0.15.0): present -> re-authenticate this existing account in
+    // place (reconnect); omit -> connect a new account, with NO account_id key in
     // the body at all (not undefined, not empty).
     ...flags["account-id"] ? { account_id: flags["account-id"] } : {}
   };
@@ -548,7 +548,7 @@ async function runConnectSessionWaitLoop(client, sessionId, ctx) {
     const n = ctx.now();
     if (n >= timeoutAt) return { kind: "timeout", result };
     if (ctx.showTicker) {
-      ctx.out.stderr.write(`\rWaiting for the account to connect\u2026 ${formatRemaining(timeoutAt - n)} remaining`);
+      ctx.out.stderr.write(`\rWaiting for the account to connect... ${formatRemaining(timeoutAt - n)} remaining`);
     }
     await ctx.sleep(nextCheckpointPollDelayMs(n - startedAt));
   }
@@ -570,7 +570,7 @@ function resolveWaitTimeoutOverrideMs(flags, out) {
 }
 async function runAccountConnectSessionPoll(client, flags, out, io = {}) {
   if (!flags.session) {
-    out.stderr.write("error: --session is required (the account's acc_\u2026 id from `account link` or a checkpoint response).\n");
+    out.stderr.write("error: --session is required (the account's acc_... id from `account link` or a checkpoint response).\n");
     process.exit(2);
   }
   const sessionId = flags.session;
@@ -783,7 +783,7 @@ async function runCheckpointPollWaitLoop(client, accountId, ctx) {
     const n = ctx.now();
     if (n >= timeoutAt) return { kind: "timeout", result };
     if (ctx.showTicker) {
-      ctx.out.stderr.write(`\rWaiting for approval\u2026 ${formatRemaining(timeoutAt - n)} remaining`);
+      ctx.out.stderr.write(`\rWaiting for approval... ${formatRemaining(timeoutAt - n)} remaining`);
     }
     await ctx.sleep(nextCheckpointPollDelayMs(n - startedAt));
   }
@@ -881,7 +881,7 @@ var accountGetCommand = defineCommand({
   args: {
     // Single-object read: READ_SINGLE_FLAGS omits pagination flags, keeps --fields
     ...READ_SINGLE_FLAGS,
-    "account-id": { type: "positional", description: "Account id (acc_\u2026)." }
+    "account-id": { type: "positional", description: "Account id (acc_...)." }
   },
   async run({ args }) {
     const flags = args;
@@ -924,7 +924,7 @@ var accountLinkCommand = defineCommand({
     "proxy-password": { type: "string", description: `Proxy auth password. ${OPTIONAL_SECRET_WARNING("CURVIATE_PROXY_PASSWORD")}` },
     "user-agent": { type: "string", description: "Browser User-Agent to pin for this account." },
     "recruiter-contract-id": { type: "string", description: "Recruiter contract to bind to (Recruiter tier only)." },
-    "account-id": { type: "string", description: "Existing account id (acc_\u2026) to re-authenticate IN PLACE. Passing it makes this an in-place reconnect of that account. Omit to connect a NEW account into --seat-id." },
+    "account-id": { type: "string", description: "Existing account id (acc_...) to re-authenticate IN PLACE. Passing it makes this an in-place reconnect of that account. Omit to connect a NEW account into --seat-id." },
     "no-interactive": {
       type: "boolean",
       description: "Never prompt for a checkpoint code. On a checkpoint, always render the envelope and exit 12, even on a TTY.",
@@ -957,7 +957,7 @@ var accountConnectSessionPollCommand = defineCommand({
     ...WRITE_SINGLE_FLAGS,
     session: {
       type: "string",
-      description: "The account's acc_\u2026 id, returned by `account link` or a checkpoint response.",
+      description: "The account's acc_... id, returned by `account link` or a checkpoint response.",
       required: true
     },
     wait: {
@@ -966,7 +966,7 @@ var accountConnectSessionPollCommand = defineCommand({
       default: false
     },
     // Override WRITE_SINGLE_FLAGS.timeout: on this command --timeout is the
-    // --wait loop's own wall-clock bound in MILLISECONDS (requires --wait) —
+    // --wait loop's own wall-clock bound in MILLISECONDS (requires --wait),
     // NOT the SDK request timeout. Default: the time remaining to the
     // session's own expiry.
     timeout: {
@@ -1003,8 +1003,8 @@ var accountUpdateCommand = defineCommand({
   meta: { name: "update", description: "Update an account's metadata and/or custom-proxy configuration." },
   args: {
     ...WRITE_SINGLE_FLAGS,
-    "account-id": { type: "positional", description: "Account id (acc_\u2026)." },
-    metadata: { type: "string", description: `Custom metadata as a JSON object (flat string\u2192string map). Replaces the store wholesale. Example: '{"team":"growth"}'.` },
+    "account-id": { type: "positional", description: "Account id (acc_...)." },
+    metadata: { type: "string", description: `Custom metadata as a JSON object (flat string->string map). Replaces the store wholesale. Example: '{"team":"growth"}'.` },
     "clear-proxy": { type: "boolean", description: "Clear the custom proxy (revert to automatic proxy protection). Mutually exclusive with --proxy-host.", default: false },
     "proxy-protocol": { type: "string", description: "Proxy protocol: http | https | socks5." },
     "proxy-host": { type: "string", description: "Proxy host or IP." },
@@ -1033,7 +1033,7 @@ var accountDisconnectCommand = defineCommand({
   meta: { name: "disconnect", description: "Hard-disconnect a LinkedIn account and release its seat." },
   args: {
     ...WRITE_SINGLE_FLAGS,
-    "account-id": { type: "positional", description: "Account id (acc_\u2026)." }
+    "account-id": { type: "positional", description: "Account id (acc_...)." }
   },
   async run({ args }) {
     const flags = args;
@@ -1058,7 +1058,7 @@ var accountCheckpointSolveCommand = defineCommand({
     ...WRITE_SINGLE_FLAGS,
     "account-id": {
       type: "positional",
-      description: "The provisional account_id (acc_\u2026) from the 202 checkpoint_required response."
+      description: "The provisional account_id (acc_...) from the 202 checkpoint_required response."
     },
     code: {
       type: "string",
@@ -1092,7 +1092,7 @@ var accountCheckpointPollCommand = defineCommand({
     ...WRITE_SINGLE_FLAGS,
     "account-id": {
       type: "positional",
-      description: "The provisional account_id (acc_\u2026) from the 202 checkpoint_required response."
+      description: "The provisional account_id (acc_...) from the 202 checkpoint_required response."
     },
     wait: {
       type: "boolean",
@@ -1100,7 +1100,7 @@ var accountCheckpointPollCommand = defineCommand({
       default: false
     },
     // Override WRITE_SINGLE_FLAGS.timeout: on this command --timeout is the
-    // --wait loop's own wall-clock bound in MILLISECONDS (requires --wait) —
+    // --wait loop's own wall-clock bound in MILLISECONDS (requires --wait),
     // NOT the SDK request timeout, and NOT seconds like `inbox sync-chat
     // --timeout`. Default: the time remaining to the checkpoint's own expiry.
     timeout: {
@@ -1133,7 +1133,7 @@ var accountCheckpointRequestCommand = defineCommand({
     ...WRITE_SINGLE_FLAGS,
     "account-id": {
       type: "positional",
-      description: "The provisional account_id (acc_\u2026) from the 202 checkpoint_required response."
+      description: "The provisional account_id (acc_...) from the 202 checkpoint_required response."
     }
   },
   async run({ args }) {

package/dist/{chunk-HZFK45IW.js → chunk-H6XD3F66.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   renderNotices
-} from "./chunk-VPKMJYIF.js";
+} from "./chunk-JA3NNST6.js";
 
 // src/lib/paginate.ts
 var PaginateError = class extends Error {

package/dist/{chunk-VPKMJYIF.js → chunk-JA3NNST6.js}

@@ -95,6 +95,14 @@ function applyProjection(data, fields) {
   }
   return data;
 }
+function withPreservedNotices(original, rendered) {
+  const isPlain = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+  if (!isPlain(original) || !isPlain(rendered)) return rendered;
+  const notices = original["notices"];
+  if (!Array.isArray(notices) || notices.length === 0) return rendered;
+  if (rendered["notices"] === notices) return rendered;
+  return { ...rendered, notices };
+}
 function firstProjectableItem(data) {
   const isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
   if (Array.isArray(data)) {
@@ -131,7 +139,7 @@ function renderSuccess(data, opts, out) {
 `
     );
   }
-  const projected = applyProjection(slimmed, fields);
+  const projected = withPreservedNotices(data, applyProjection(slimmed, fields));
   if (json) {
     out.stdout.write(JSON.stringify(projected) + "\n");
   } else {

package/dist/{chunk-M6UDWFHX.js → chunk-PMRQXBCP.js}

@@ -51,7 +51,7 @@ var EXIT_CODE_MAP = {
   PAYMENT_FAILED: 11,
   SUBSCRIPTION_BUSY: 11,
   SEAT_CANCELLED: 11,
-  // Internal / uncaught (1) — last resort bucket
+  // Internal / uncaught (1), last resort bucket
   INTERNAL: 1,
   PLATFORM_NOT_IMPLEMENTED: 1
 };

package/dist/{chunk-WYRYCTUM.js → chunk-RFUO2G3M.js}

@@ -41,7 +41,7 @@ function slimProfileMe(data) {
     first_name: d["first_name"] ?? null,
     last_name: d["last_name"] ?? null,
     // LinkedIn serves the profile headline in the `description` wire field
-    // on reads, not a field named `headline` — see JSDoc above.
+    // on reads, not a field named `headline`, see JSDoc above.
     headline: d["description"] ?? null,
     public_identifier: d["public_identifier"] ?? null,
     location: d["location"] ?? null,
@@ -59,7 +59,7 @@ function slimProfile(data) {
     first_name: d["first_name"] ?? null,
     last_name: d["last_name"] ?? null,
     // LinkedIn serves the profile headline in the `description` wire field
-    // on reads, not a field named `headline` — see slimProfileMe's JSDoc.
+    // on reads, not a field named `headline`, see slimProfileMe's JSDoc.
     headline: d["description"] ?? null,
     location: d["location"] ?? null,
     network_distance: specifics?.["network_distance"] ?? null,

package/dist/{chunk-OE7OMTCM.js → chunk-T5LPGAGJ.js}

@@ -25,7 +25,7 @@ import {
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-VPKMJYIF.js";
+} from "./chunk-JA3NNST6.js";
 import {
   READ_SINGLE_FLAGS,
   WRITE_FLAGS
@@ -77,7 +77,7 @@ var MEMBER_PROVIDER_ID_RE = /^A[CDE][A-Za-z0-9_-]{4,}$/;
 async function handleSdkError(err, outOpts, out) {
   const { CurviateError } = await import("@curviate/sdk");
   if (err instanceof CurviateError) {
-    const { getExitCode } = await import("./exit-codes-63JE5GM5.js");
+    const { getExitCode } = await import("./exit-codes-KAVZN5BQ.js");
     renderError(err, outOpts, out);
     process.exit(getExitCode(err.code));
   }
@@ -390,7 +390,7 @@ var messageNewCommand = defineCommand({
     ...WRITE_FLAGS,
     to: {
       type: "string",
-      description: "Recipient: LinkedIn profile URL (e.g. https://www.linkedin.com/in/some-slug), bare slug (e.g. some-slug), or provider ID (e.g. ACoAAA\u2026). URL and slug inputs resolve the provider ID automatically.",
+      description: "Recipient: LinkedIn profile URL (e.g. https://www.linkedin.com/in/some-slug), bare slug (e.g. some-slug), or provider ID (e.g. ACoAAA...). URL and slug inputs resolve the provider ID automatically.",
       required: true
     },
     text: { type: "positional", stdinArg: true, description: "Opening message text. Pass - to read from stdin (e.g. via heredoc or pipe)." },
@@ -565,7 +565,7 @@ var messageInMailCommand = defineCommand({
     ...WRITE_FLAGS,
     to: {
       type: "string",
-      description: "Recipient: LinkedIn profile URL, bare slug, provider-id (ACoAAA\u2026), or member URN (urn:li:member:<id>). URL and slug inputs resolve the provider ID automatically.",
+      description: "Recipient: LinkedIn profile URL, bare slug, provider-id (ACoAAA...), or member URN (urn:li:member:<id>). URL and slug inputs resolve the provider ID automatically.",
       required: true
     },
     subject: { type: "string", description: "InMail subject line.", required: true },
@@ -657,12 +657,12 @@ var MESSAGE_SUBCOMMANDS = [
   "inmail",
   "inmail-balance"
 ];
-var MESSAGE_USAGE = 'Usage: curviate message new --to <attendee> "<text>" [--attach <file>\u2026]\n       curviate message send <chat_id> "<text>" [--attach <file>\u2026]\n       curviate message <chat_id> "<text>" [--attach <file>\u2026]\n       curviate message get <chat_id> <message_id>\n       curviate message edit <chat_id> <message_id> "<text>"\n       curviate message delete <chat_id> <message_id>\n       curviate message react <chat_id> <message_id> <emoji>\n       curviate message attachment <chat_id> <message_id> <attachment_id> [-o <file>]\n       curviate message inmail --to <id> --subject <s> "<text>"\n       curviate message inmail-balance\n';
+var MESSAGE_USAGE = 'Usage: curviate message new --to <attendee> "<text>" [--attach <file>...]\n       curviate message send <chat_id> "<text>" [--attach <file>...]\n       curviate message <chat_id> "<text>" [--attach <file>...]\n       curviate message get <chat_id> <message_id>\n       curviate message edit <chat_id> <message_id> "<text>"\n       curviate message delete <chat_id> <message_id>\n       curviate message react <chat_id> <message_id> <emoji>\n       curviate message attachment <chat_id> <message_id> <attachment_id> [-o <file>]\n       curviate message inmail --to <id> --subject <s> "<text>"\n       curviate message inmail-balance\n';
 function guardBareMessageForm(chatId, out) {
   if (!looksLikeCommandWord(chatId)) return;
   const suggestion = nearestSubcommand(chatId, [...MESSAGE_SUBCOMMANDS]);
   out.stderr.write(
-    `error: \`${chatId}\` is not a curviate message subcommand, and it is not a chat id (a chat id looks like 2-\u2026 or COMPANY_\u2026, or a linkedin.com/messaging/thread/\u2026 URL).
+    `error: \`${chatId}\` is not a curviate message subcommand, and it is not a chat id (a chat id looks like 2-... or COMPANY_..., or a linkedin.com/messaging/thread/... URL).
 `
   );
   if (suggestion) {

package/dist/cli.js

@@ -78,6 +78,15 @@ async function nodeName(cmd) {
   const meta = await resolveValue(cmd.meta ?? {});
   return meta.name ?? "this command";
 }
+function renderPath(path) {
+  const parts = path[0] === "curviate" ? path.slice(1) : path;
+  return ["curviate", ...parts].join(" ");
+}
+function arityPhrase(count) {
+  if (count === 0) return "no positional arguments";
+  if (count === 1) return "1 positional argument";
+  return `${count} positional arguments`;
+}
 function positionalTokens(rawArgs, booleanFlags) {
   const out = [];
   let afterDoubleDash = false;
@@ -104,6 +113,24 @@ function positionalTokens(rawArgs, booleanFlags) {
   }
   return out;
 }
+async function extraPositionals(cmd, rawArgs) {
+  const booleanFlags = await booleanFlagNames(cmd);
+  const positionals = positionalTokens(rawArgs, booleanFlags);
+  const declaredCount = await nodePositionalCount(cmd);
+  return positionals.slice(declaredCount);
+}
+async function assertLeafConsumesPositionals(leaf, leafArgs, path, siblings) {
+  const extras = await extraPositionals(leaf, leafArgs);
+  if (extras.length === 0) return;
+  const token = extras[0].token;
+  const form = renderPath(path);
+  const arity = arityPhrase(await nodePositionalCount(leaf));
+  const hint = siblings && Object.prototype.hasOwnProperty.call(siblings, token) ? `Did you mean \`${renderPath([...path.slice(0, -1), token])}\`?` : void 0;
+  usageError(
+    `unexpected argument \`${token}\` after \`${form}\`. \`${form}\` takes ${arity}. Run \`${form} --help\` for its usage.`,
+    hint
+  );
+}
 async function declaredArgNames(cmd) {
   const names = /* @__PURE__ */ new Set();
   const argsDef = await resolveValue(cmd.args ?? {});
@@ -155,7 +182,8 @@ function usageError(message, hint) {
   process.stderr.write("Run `curviate --help` for usage.\n");
   process.exit(2);
 }
-async function resolveLeaf(cmd, rawArgs) {
+async function resolveLeaf(cmd, rawArgs, descent) {
+  const here = descent ?? { path: [await nodeName(cmd)] };
   const subCommands = await resolveValue(cmd.subCommands);
   if (subCommands && Object.keys(subCommands).length > 0) {
     const idx = firstPositionalIndex(rawArgs);
@@ -163,7 +191,10 @@ async function resolveLeaf(cmd, rawArgs) {
     const hasBarePositional = await nodeHasPositional(cmd);
     if (token !== void 0 && subCommands[token]) {
       const sub = await resolveValue(subCommands[token]);
-      return resolveLeaf(sub, rawArgs.slice(idx + 1));
+      return resolveLeaf(sub, rawArgs.slice(idx + 1), {
+        path: [...here.path, token],
+        siblings: subCommands
+      });
     }
     if (token !== void 0) {
       const hint = successorHint(await nodeName(cmd), token);
@@ -172,16 +203,16 @@ async function resolveLeaf(cmd, rawArgs) {
       }
     }
     if (token !== void 0 && hasBarePositional) {
-      const booleanFlags = await booleanFlagNames(cmd);
-      const positionals = positionalTokens(rawArgs, booleanFlags);
-      const declaredCount = await nodePositionalCount(cmd);
-      const extras = positionals.slice(declaredCount);
+      const extras = await extraPositionals(cmd, rawArgs);
       if (extras.length > 0) {
         const first = extras[0];
         if (extras.length === 1 && Object.prototype.hasOwnProperty.call(subCommands, first.token)) {
           const sub = await resolveValue(subCommands[first.token]);
           const remaining = rawArgs.filter((_, i) => i !== first.index);
-          return resolveLeaf(sub, remaining);
+          return resolveLeaf(sub, remaining, {
+            path: [...here.path, first.token],
+            siblings: subCommands
+          });
         }
         const name = await nodeName(cmd);
         usageError(
@@ -195,6 +226,7 @@ async function resolveLeaf(cmd, rawArgs) {
     }
     return { leaf: cmd, leafArgs: rawArgs };
   }
+  await assertLeafConsumesPositionals(cmd, rawArgs, here.path, here.siblings);
   return { leaf: cmd, leafArgs: rawArgs };
 }
 async function dispatch(root, rawArgs) {
@@ -259,31 +291,31 @@ var main = defineCommand({
     version: pkg.version,
     description: "Official command-line interface for the Curviate API."
   },
-  // Subcommand registry — names and descriptions are static for help rendering;
+  // Subcommand registry, names and descriptions are static for help rendering;
   // the handler implementation is loaded lazily on first invocation.
   subCommands: {
     login: () => import("./login-ZLDDIAFW.js").then((m) => m.loginCommand),
     config: () => import("./config-FPWWYG7G.js").then((m) => m.configCommand),
     // ---------------------------------------------------------------------------
-    // Noun groups — lazy-loaded on first invocation.
+    // Noun groups, lazy-loaded on first invocation.
     // ---------------------------------------------------------------------------
-    profile: () => import("./profile-GADE33FY.js").then((m) => m.profileCommand),
-    company: () => import("./company-NT4VO6JV.js").then((m) => m.companyCommand),
-    job: () => import("./job-VOVQZGCK.js").then((m) => m.jobCommand),
-    connect: () => import("./connect-VXWRLGQZ.js").then((m) => m.connectCommand),
-    search: () => import("./search-V35MFTXL.js").then((m) => m.searchCommand),
-    inbox: () => import("./inbox-GZAOUWZP.js").then((m) => m.inboxCommand),
-    inboxes: () => import("./inboxes-6AZOB43U.js").then((m) => m.inboxesCommand),
-    message: () => import("./message-FIEWH2BU.js").then((m) => m.messageCommand),
-    post: () => import("./post-G4IMWUE2.js").then((m) => m.postCommand),
-    comment: () => import("./comment-W4XTOTHN.js").then((m) => m.commentCommand),
-    account: () => import("./account-OIV73PXX.js").then((m) => m.accountCommand),
-    webhook: () => import("./webhook-5HXMJQFO.js").then((m) => m.webhookCommand),
-    "sales-nav": () => import("./sales-nav-OXLRN6YK.js").then((m) => m.salesNavCommand),
-    recruiter: () => import("./recruiter-LI2TMRHY.js").then((m) => m.recruiterCommand),
-    group: () => import("./group-43PHTFP7.js").then((m) => m.groupCommand),
-    feed: () => import("./feed-4Q3B56WI.js").then((m) => m.feedCommand),
-    notification: () => import("./notification-65V67NWK.js").then((m) => m.notificationCommand)
+    profile: () => import("./profile-TJS2YAZD.js").then((m) => m.profileCommand),
+    company: () => import("./company-WDDLWP7E.js").then((m) => m.companyCommand),
+    job: () => import("./job-75ML7R7I.js").then((m) => m.jobCommand),
+    connect: () => import("./connect-5OROSY5C.js").then((m) => m.connectCommand),
+    search: () => import("./search-TDSLK2MB.js").then((m) => m.searchCommand),
+    inbox: () => import("./inbox-L6JBGZIB.js").then((m) => m.inboxCommand),
+    inboxes: () => import("./inboxes-UIO74C5Q.js").then((m) => m.inboxesCommand),
+    message: () => import("./message-DAQHRBSJ.js").then((m) => m.messageCommand),
+    post: () => import("./post-RGDOCGC4.js").then((m) => m.postCommand),
+    comment: () => import("./comment-MCGXFMN4.js").then((m) => m.commentCommand),
+    account: () => import("./account-QRGWUQXF.js").then((m) => m.accountCommand),
+    webhook: () => import("./webhook-7ESDSIRU.js").then((m) => m.webhookCommand),
+    "sales-nav": () => import("./sales-nav-5O7FR57S.js").then((m) => m.salesNavCommand),
+    recruiter: () => import("./recruiter-NSM33IEK.js").then((m) => m.recruiterCommand),
+    group: () => import("./group-HSZY2IJU.js").then((m) => m.groupCommand),
+    feed: () => import("./feed-SFVYEAYP.js").then((m) => m.feedCommand),
+    notification: () => import("./notification-DYJN4ZHN.js").then((m) => m.notificationCommand)
   },
   async run() {
     const { runMain } = await import("citty");

package/dist/{comment-W4XTOTHN.js → comment-MCGXFMN4.js}

@@ -11,7 +11,7 @@ import {
 import {
   pageDelayFromFlags,
   streamAll
-} from "./chunk-HZFK45IW.js";
+} from "./chunk-H6XD3F66.js";
 import "./chunk-DMQZEPQE.js";
 import {
   buildPreviewOutput
@@ -22,7 +22,7 @@ import {
   renderSuccess,
   renderUnexpectedError,
   resolveEffectiveConfig
-} from "./chunk-VPKMJYIF.js";
+} from "./chunk-JA3NNST6.js";
 import {
   GLOBAL_FLAGS,
   WRITE_SINGLE_FLAGS
@@ -70,7 +70,7 @@ function buildListQuery(flags) {
 async function handleSdkError(err, outOpts, out) {
   const { CurviateError } = await import("@curviate/sdk");
   if (err instanceof CurviateError) {
-    const { getExitCode } = await import("./exit-codes-63JE5GM5.js");
+    const { getExitCode } = await import("./exit-codes-KAVZN5BQ.js");
     renderError(err, outOpts, out);
     process.exit(getExitCode(err.code));
   }