@ted-galago/wave-cli 0.1.9 → 0.1.11

package/README.md

@@ -190,6 +190,28 @@ If a required parent field is missing, CLI returns JSON error with exit code `2`
 - `content.member_id` is required.
 - `content.type` is not required for create.
 
+`knowledge.list` filter notes:
+
+- `--assigned true` uses backend "assigned for current authenticated member" logic.
+- `--assigned true` defaults to incomplete items only.
+- CLI `knowledge list` does not currently expose an `include_completed` toggle.
+- `--member-id` filters `contents.member_id` (owner/author), not assignment target.
+- `--focus-member-id` filters `contents.focus_member_id` (focus scope), not assignment target.
+- For manager/admin users, `--assigned true` may include creator-visible items with assignments, not only direct assignee matches.
+
+Examples:
+
+```bash
+# Assigned to current authenticated member (incomplete only by default)
+wave knowledge list --assigned true --page 1 --per 50
+
+# Owner filter (not assignment target filter)
+wave knowledge list --member-id 67 --page 1 --per 50
+
+# Focus scope filter (not assignment target filter)
+wave knowledge list --focus-member-id 67 --page 1 --per 50
+```
+
 `news.create` contract notes:
 
 - Requires `headline.member_id`, `headline.status`, and `headline.headline_type`.

package/dist/index.cjs

@@ -91,10 +91,7 @@ function toOptionalNonEmpty(raw) {
   const trimmed = raw.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
-function parseDebug(rawDebugOption, rawDebugEnv) {
-  if (typeof rawDebugOption === "boolean") {
-    return rawDebugOption;
-  }
+function parseDebug(rawDebugEnv) {
   if (!rawDebugEnv) {
     return false;
   }
@@ -124,7 +121,7 @@ function getConfig(options) {
     baseUrl,
     token,
     timeoutMs: parseTimeoutMs(options.timeoutMs ?? process.env.WAVE_TIMEOUT_MS),
-    debug: parseDebug(options.debug, process.env.WAVE_DEBUG),
+    debug: parseDebug(process.env.WAVE_DEBUG),
     agentName: toOptionalNonEmpty(options.agentName ?? process.env.WAVE_AGENT_NAME),
     agentRunId: toOptionalNonEmpty(options.agentRunId ?? process.env.WAVE_AGENT_RUN_ID),
     requestId: toOptionalNonEmpty(options.requestId ?? process.env.WAVE_REQUEST_ID),
@@ -723,13 +720,52 @@ async function graphqlRequest(input) {
 }
 
 // src/output.ts
+var import_node_fs = require("fs");
+var RETRYABLE_WRITE_CODES = /* @__PURE__ */ new Set(["EAGAIN", "EINTR"]);
+var RETRY_BACKOFF_MS = 1;
+var EnvelopeEmittedSignal = class extends Error {
+  constructor() {
+    super("wave_cli_envelope_emitted");
+    this.name = "EnvelopeEmittedSignal";
+  }
+};
+function sleepBriefly(ms) {
+  const lock = new Int32Array(new SharedArrayBuffer(4));
+  Atomics.wait(lock, 0, 0, ms);
+}
+function writeStdoutFully(text) {
+  const fd = typeof process.stdout.fd === "number" ? process.stdout.fd : 1;
+  const buffer = Buffer.from(text, "utf8");
+  let offset = 0;
+  while (offset < buffer.length) {
+    try {
+      const bytesWritten = (0, import_node_fs.writeSync)(fd, buffer, offset, buffer.length - offset);
+      if (bytesWritten <= 0) {
+        sleepBriefly(RETRY_BACKOFF_MS);
+        continue;
+      }
+      offset += bytesWritten;
+    } catch (error) {
+      const code = typeof error === "object" && error && "code" in error ? String(error.code ?? "") : "";
+      if (RETRYABLE_WRITE_CODES.has(code)) {
+        sleepBriefly(RETRY_BACKOFF_MS);
+        continue;
+      }
+      throw error;
+    }
+  }
+}
 function printEnvelope(envelope) {
-  process.stdout.write(`${JSON.stringify(envelope)}
+  writeStdoutFully(`${JSON.stringify(envelope)}
 `);
 }
 function printEnvelopeAndExit(params) {
   printEnvelope(params.envelope);
-  process.exit(params.exitCode ?? EXIT_CODES.success);
+  process.exitCode = params.exitCode ?? EXIT_CODES.success;
+  throw new EnvelopeEmittedSignal();
+}
+function isEnvelopeEmittedSignal(error) {
+  return error instanceof EnvelopeEmittedSignal;
 }
 
 // src/commandRunner.ts
@@ -1371,8 +1407,11 @@ async function runGraphqlQueryCommand(input) {
     }
     printEnvelopeAndExit(result);
   } catch (error) {
+    if (isEnvelopeEmittedSignal(error)) {
+      throw error;
+    }
     if (error instanceof CliError) {
-      printEnvelopeAndExit({
+      return printEnvelopeAndExit({
         envelope: buildCliErrorEnvelope({
           command: input.command,
           status: error.status,
@@ -1384,7 +1423,7 @@ async function runGraphqlQueryCommand(input) {
       });
     }
     const message = error instanceof Error ? error.message : "Unexpected error.";
-    printEnvelopeAndExit({
+    return printEnvelopeAndExit({
       envelope: buildCliErrorEnvelope({
         command: input.command,
         status: 500,
@@ -1410,8 +1449,11 @@ async function runGraphqlMutationCommand(input) {
     });
     printEnvelopeAndExit(result);
   } catch (error) {
+    if (isEnvelopeEmittedSignal(error)) {
+      throw error;
+    }
     if (error instanceof CliError) {
-      printEnvelopeAndExit({
+      return printEnvelopeAndExit({
         envelope: buildCliErrorEnvelope({
           command: input.command,
           status: error.status,
@@ -1423,7 +1465,7 @@ async function runGraphqlMutationCommand(input) {
       });
     }
     const message = error instanceof Error ? error.message : "Unexpected error.";
-    printEnvelopeAndExit({
+    return printEnvelopeAndExit({
       envelope: buildCliErrorEnvelope({
         command: input.command,
         status: 500,
@@ -1533,11 +1575,7 @@ function resolveFromSources(options, stdin, env) {
     normalize(env.WAVE_ORG_ID)
   );
   const timeoutMs = firstDefined(options.timeoutMs, stdin.timeoutMs, env.WAVE_TIMEOUT_MS);
-  const debug = firstDefined(
-    options.debug === true ? true : void 0,
-    stdin.debug,
-    parseBool(env.WAVE_DEBUG)
-  );
+  const debug = parseBool(env.WAVE_DEBUG);
   const agentName = firstDefined(
     normalize(options.agentName),
     normalize(stdin.agentName),
@@ -2413,11 +2451,12 @@ function registerEntityCrudCommands(program, config) {
   const updateHelp5 = buildDataJsonHelp(config.rootKey, "update") ?? "JSON object, optionally wrapped with root key";
   const list = entityCommand.command("list").option("--page <page>").option("--per <per>");
   const listParams = config.listParams ?? [];
+  const listParamHelp = config.listParamHelp ?? {};
   const showParams = config.showParams ?? [];
   const allowQueryJson = config.allowQueryJson !== false;
   listParams.forEach((param) => {
     const cliParam = param.replace(/_/g, "-");
-    list.option(`--${cliParam} <${cliParam}>`);
+    list.option(`--${cliParam} <${cliParam}>`, listParamHelp[param]);
   });
   if (allowQueryJson) {
     list.option("--query-json <queryJson>", "Additional query params as JSON object");
@@ -2594,7 +2633,7 @@ function registerProjectCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
       command: "projects.list",
-      operationName: "ProjectsIndexSlim",
+      operationName: "ProjectsList",
       runtimeOptions: context.runtimeOptions,
       field: "projects",
       variables: normalizeGraphqlVariables2({
@@ -2622,7 +2661,7 @@ function registerProjectCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
       command: "projects.show",
-      operationName: "ProjectShowDeepV2",
+      operationName: "ProjectsShow",
       runtimeOptions: context.runtimeOptions,
       field: "project",
       variables: {
@@ -3885,6 +3924,11 @@ function registerSystemToolCommands(program) {
       "term",
       "type"
     ],
+    listParamHelp: {
+      assigned: "Show assigned knowledge for the authenticated current member context (not a direct assignee-id filter).",
+      member_id: "Filter by content owner/author (contents.member_id), not assignment target member.",
+      focus_member_id: "Filter by focus scope (contents.focus_member_id), not assignment target member."
+    },
     showParams: ["include_all_rollups"],
     allowQueryJson: false
   });
@@ -4537,6 +4581,7 @@ function registerFoundationCommands(program) {
 var import_zod12 = require("zod");
 var idSchema11 = import_zod12.z.string().min(1);
 var jsonObjectSchema = import_zod12.z.record(import_zod12.z.string(), import_zod12.z.unknown());
+var childListMinimalSelectionSet = "{ data { id type attributes } count currentPage totalPages }";
 function parseJsonObject2(raw) {
   try {
     const parsed = JSON.parse(raw);
@@ -4737,11 +4782,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_subtask",
     destroyField: "destroy_subtask",
     idVariable: "subtask_id",
-    listOperationName: "SubtasksForTask",
-    createOperationName: "CreateSubtask",
-    updateOperationName: "UpdateSubtask",
-    destroyOperationName: "DestroySubtask",
-    listSelectionSet: "{ data { id type name status taskId attributes } count currentPage totalPages }",
+    listOperationName: "SubtasksList",
+    createOperationName: "SubtasksCreate",
+    updateOperationName: "SubtasksUpdate",
+    destroyOperationName: "SubtasksDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "taskId",
     normalizeCreateBody: normalizeSubtaskCreateBody
   });
@@ -4756,11 +4801,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_milestone",
     destroyField: "destroy_milestone",
     idVariable: "milestone_id",
-    listOperationName: "MilestonesForRock",
-    createOperationName: "CreateMilestone",
-    updateOperationName: "UpdateMilestone",
-    destroyOperationName: "DestroyMilestone",
-    listSelectionSet: "{ data { id type name slug status attributes } count currentPage totalPages }"
+    listOperationName: "MilestonesList",
+    createOperationName: "MilestonesCreate",
+    updateOperationName: "MilestonesUpdate",
+    destroyOperationName: "MilestonesDestroy",
+    listSelectionSet: childListMinimalSelectionSet
   });
   registerChildCommands(program, {
     command: "subitems",
@@ -4773,11 +4818,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_subitem",
     destroyField: "destroy_subitem",
     idVariable: "subitem_id",
-    listOperationName: "SubitemsForListItem",
-    createOperationName: "CreateSubitem",
-    updateOperationName: "UpdateSubitem",
-    destroyOperationName: "DestroySubitem",
-    listSelectionSet: "{ data { id type name status listItemId attributes } count currentPage totalPages }",
+    listOperationName: "SubitemsList",
+    createOperationName: "SubitemsCreate",
+    updateOperationName: "SubitemsUpdate",
+    destroyOperationName: "SubitemsDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "listItemId"
   });
   registerChildCommands(program, {
@@ -4791,11 +4836,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_sub_todo",
     destroyField: "destroy_sub_todo",
     idVariable: "sub_todo_id",
-    listOperationName: "SubtodosForTodo",
-    createOperationName: "CreateSubTodo",
-    updateOperationName: "UpdateSubTodo",
-    destroyOperationName: "DestroySubTodo",
-    listSelectionSet: "{ data { id type name status todoId attributes } count currentPage totalPages }",
+    listOperationName: "SubtodosList",
+    createOperationName: "SubtodosCreate",
+    updateOperationName: "SubtodosUpdate",
+    destroyOperationName: "SubtodosDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "todoId"
   });
   registerChildCommands(program, {
@@ -4809,11 +4854,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_sub_issue",
     destroyField: "destroy_sub_issue",
     idVariable: "sub_issue_id",
-    listOperationName: "SubissuesForIssue",
-    createOperationName: "CreateSubIssue",
-    updateOperationName: "UpdateSubIssue",
-    destroyOperationName: "DestroySubIssue",
-    listSelectionSet: "{ data { id type name status issueId attributes } count currentPage totalPages }",
+    listOperationName: "SubissuesList",
+    createOperationName: "SubissuesCreate",
+    updateOperationName: "SubissuesUpdate",
+    destroyOperationName: "SubissuesDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "issueId"
   });
   registerChildCommands(program, {
@@ -4827,23 +4872,23 @@ function registerChildEntityCommands(program) {
     updateField: "update_talking_point",
     destroyField: "destroy_talking_point",
     idVariable: "talking_point_id",
-    listOperationName: "TalkingPointsForMeeting",
-    createOperationName: "CreateTalkingPoint",
-    updateOperationName: "UpdateTalkingPoint",
-    destroyOperationName: "DestroyTalkingPoint",
-    listSelectionSet: "{ data { id type name description status priority rank dueDate memberId creatorId meetingId attributes } count currentPage totalPages }",
+    listOperationName: "TalkingPointsList",
+    createOperationName: "TalkingPointsCreate",
+    updateOperationName: "TalkingPointsUpdate",
+    destroyOperationName: "TalkingPointsDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "meetingId"
   });
 }
 
-// src/commands/notes.ts
+// src/commands/content.ts
 var import_zod13 = require("zod");
 var idSchema12 = import_zod13.z.string().min(1);
 var nonEmptyString = import_zod13.z.string().min(1);
 function assertUpdateFields(params) {
   if (!params.name && !params.content && !params.status) {
     throw new CliError({
-      message: "notes update requires at least one of --name, --body, or --status.",
+      message: "content update requires at least one of --name, --body, or --status.",
       kind: "invalid_args",
       status: 400,
       exitCode: EXIT_CODES.invalidArgs
@@ -4866,13 +4911,13 @@ async function createContent(command, cmd, payload) {
     })
   });
 }
-function registerNoteCommands(program) {
-  const notes = program.command("notes").description("Content note operations");
-  notes.command("list").option("--contentable-type <contentableType>").option("--contentable-id <contentableId>").option("--member-id <memberId>").option("--focus-member-id <focusMemberId>").option("--focus-team-id <focusTeamId>").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+function registerContentCommands(program) {
+  const content = program.command("content").description("Content note operations");
+  content.command("list").option("--contentable-type <contentableType>").option("--contentable-id <contentableId>").option("--member-id <memberId>").option("--focus-member-id <focusMemberId>").option("--focus-team-id <focusTeamId>").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
-      command: "notes.list",
+      command: "content.list",
       operationName: "ContentsIndex",
       runtimeOptions: context.runtimeOptions,
       field: "contents",
@@ -4887,15 +4932,15 @@ function registerNoteCommands(program) {
         per: opts.per
       }),
       isList: true,
-      selectionSet: "{ count currentPage totalPages data { id type name slug firstChildSlug rootParentSlug status contentType lastEdited organizationId memberId focusMemberId focusTeamId teamId creatorId createdAt updatedAt childCount assignmentType contentableId contentableSlug contentableType votesTotal labelIds rootContentId parentContentId attributes } }"
+      selectionSet: "{ count currentPage totalPages data { id type attributes } }"
     });
   });
-  notes.command("show").requiredOption("--id <id>").action(async (opts, cmd) => {
+  content.command("show").requiredOption("--id <id>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const id = idSchema12.parse(opts.id);
     await runGraphqlQueryCommand({
-      command: "notes.show",
+      command: "content.show",
       operationName: "ContentShow",
       runtimeOptions: context.runtimeOptions,
       field: "content",
@@ -4907,7 +4952,7 @@ function registerNoteCommands(program) {
       selectionSet: "{ id type name slug firstChildSlug rootParentSlug status contentType lastEdited organizationId memberId focusMemberId focusTeamId teamId creatorId createdAt updatedAt childCount assignmentType contentableId contentableSlug contentableType votesTotal labelIds rootContentId parentContentId attributes }"
     });
   });
-  notes.command("update").requiredOption("--id <id>").option("--name <name>").option("--body <body>").option("--status <status>").action(async (opts, cmd) => {
+  content.command("update").requiredOption("--id <id>").option("--name <name>").option("--body <body>").option("--status <status>").action(async (opts, cmd) => {
     assertUpdateFields({
       name: opts.name,
       content: opts.body,
@@ -4917,7 +4962,7 @@ function registerNoteCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     const contentId = idSchema12.parse(opts.id);
     await runGraphqlMutationCommand({
-      command: "notes.update",
+      command: "content.update",
       operationName: "UpdateContent",
       runtimeOptions: context.runtimeOptions,
       field: "update_content",
@@ -4934,12 +4979,12 @@ function registerNoteCommands(program) {
       })
     });
   });
-  notes.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
+  content.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const contentId = idSchema12.parse(opts.id);
     await runGraphqlMutationCommand({
-      command: "notes.destroy",
+      command: "content.destroy",
       operationName: "DestroyContent",
       runtimeOptions: context.runtimeOptions,
       field: "destroy_content",
@@ -4949,9 +4994,9 @@ function registerNoteCommands(program) {
       })
     });
   });
-  notes.command("create-member").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-member").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const targetMemberId = nonEmptyString.parse(opts.targetMemberId);
-    await createContent("notes.create-member", cmd, {
+    await createContent("content.create-member", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4963,9 +5008,9 @@ function registerNoteCommands(program) {
       focus_team_id: null
     });
   });
-  notes.command("create-manager").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-manager").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
-    await createContent("notes.create-manager", cmd, {
+    await createContent("content.create-manager", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4976,10 +5021,10 @@ function registerNoteCommands(program) {
       focus_member_id: nonEmptyString.parse(opts.targetMemberId)
     });
   });
-  notes.command("create-team").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--team-id <teamId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-team").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--team-id <teamId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
     const teamId = nonEmptyString.parse(opts.teamId);
-    await createContent("notes.create-team", cmd, {
+    await createContent("content.create-team", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4990,8 +5035,8 @@ function registerNoteCommands(program) {
       focus_team_id: teamId
     });
   });
-  notes.command("create-project").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--project-id <projectId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-project", cmd, {
+  content.command("create-project").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--project-id <projectId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-project", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5001,8 +5046,8 @@ function registerNoteCommands(program) {
       member_id: nonEmptyString.parse(opts.actorMemberId)
     });
   });
-  notes.command("create-customer").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--customer-id <customerId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-customer", cmd, {
+  content.command("create-customer").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--customer-id <customerId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-customer", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5012,8 +5057,8 @@ function registerNoteCommands(program) {
       member_id: nonEmptyString.parse(opts.actorMemberId)
     });
   });
-  notes.command("create-contact").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--contact-id <contactId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-contact", cmd, {
+  content.command("create-contact").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--contact-id <contactId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-contact", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5970,26 +6015,26 @@ function emitUnsupportedMutation(params) {
   });
 }
 function registerMutationCapabilityCommands(program) {
-  const projectNotes = program.command("project-notes").description("Project notes node (read-only in CLI mutation surface)");
-  projectNotes.command("create").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  const projectContent = program.command("project-content").description("Project content node (read-only in CLI mutation surface)");
+  projectContent.command("create").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.create",
+      command: "project-content.create",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
     });
   });
-  projectNotes.command("update").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  projectContent.command("update").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.update",
+      command: "project-content.update",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
     });
   });
-  projectNotes.command("destroy").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  projectContent.command("destroy").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.destroy",
+      command: "project-content.destroy",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
@@ -6009,7 +6054,7 @@ function buildCli(options) {
   ).option(
     "--organization-id <organizationId>",
     "Organization ID (prefer WAVE_ORGANIZATION_ID env var)"
-  ).option("--timeout-ms <timeoutMs>", "HTTP timeout in milliseconds").option("--debug", "Enable debug logs to stderr").option("--agent-name <agentName>", "Agent name for tracing").option("--agent-run-id <agentRunId>", "Agent run identifier for tracing").option("--request-id <requestId>", "Request identifier").option(
+  ).option("--timeout-ms <timeoutMs>", "HTTP timeout in milliseconds").option("--agent-name <agentName>", "Agent name for tracing").option("--agent-run-id <agentRunId>", "Agent run identifier for tracing").option("--request-id <requestId>", "Request identifier").option(
     "--openapi-path <openapiPath>",
     "Optional local OpenAPI file path for contract-aware tooling"
   ).option(
@@ -6031,7 +6076,7 @@ function buildCli(options) {
   registerSystemToolCommands(program);
   registerFoundationCommands(program);
   registerChildEntityCommands(program);
-  registerNoteCommands(program);
+  registerContentCommands(program);
   registerMutationCapabilityCommands(program);
   registerMarkdownTreeCommands(program);
   registerNavigationCommands(program);
@@ -6063,6 +6108,9 @@ async function main() {
   await program.parseAsync(process.argv);
 }
 main().catch((error) => {
+  if (isEnvelopeEmittedSignal(error)) {
+    return;
+  }
   if (error instanceof CliError) {
     printCliFailure({
       status: error.status,
@@ -6071,10 +6119,12 @@ main().catch((error) => {
       details: error.details,
       exitCode: error.exitCode
     });
+    return;
   }
   if (error instanceof import_commander2.CommanderError) {
     if (error.code === "commander.helpDisplayed" || error.code === "commander.version") {
-      process.exit(EXIT_CODES.success);
+      process.exitCode = EXIT_CODES.success;
+      return;
     }
     printCliFailure({
       status: 400,
@@ -6082,6 +6132,7 @@ main().catch((error) => {
       message: error.message,
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   if (error instanceof import_zod16.ZodError || error instanceof import_commander2.InvalidArgumentError) {
     printCliFailure({
@@ -6093,6 +6144,7 @@ main().catch((error) => {
       },
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   const message = error instanceof Error ? error.message : "Unexpected error.";
   printCliFailure({
@@ -6101,4 +6153,5 @@ main().catch((error) => {
     message,
     exitCode: EXIT_CODES.generic
   });
+  return;
 });

package/dist/index.js

@@ -90,10 +90,7 @@ function toOptionalNonEmpty(raw) {
   const trimmed = raw.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
-function parseDebug(rawDebugOption, rawDebugEnv) {
-  if (typeof rawDebugOption === "boolean") {
-    return rawDebugOption;
-  }
+function parseDebug(rawDebugEnv) {
   if (!rawDebugEnv) {
     return false;
   }
@@ -123,7 +120,7 @@ function getConfig(options) {
     baseUrl,
     token,
     timeoutMs: parseTimeoutMs(options.timeoutMs ?? process.env.WAVE_TIMEOUT_MS),
-    debug: parseDebug(options.debug, process.env.WAVE_DEBUG),
+    debug: parseDebug(process.env.WAVE_DEBUG),
     agentName: toOptionalNonEmpty(options.agentName ?? process.env.WAVE_AGENT_NAME),
     agentRunId: toOptionalNonEmpty(options.agentRunId ?? process.env.WAVE_AGENT_RUN_ID),
     requestId: toOptionalNonEmpty(options.requestId ?? process.env.WAVE_REQUEST_ID),
@@ -722,13 +719,52 @@ async function graphqlRequest(input) {
 }
 
 // src/output.ts
+import { writeSync } from "fs";
+var RETRYABLE_WRITE_CODES = /* @__PURE__ */ new Set(["EAGAIN", "EINTR"]);
+var RETRY_BACKOFF_MS = 1;
+var EnvelopeEmittedSignal = class extends Error {
+  constructor() {
+    super("wave_cli_envelope_emitted");
+    this.name = "EnvelopeEmittedSignal";
+  }
+};
+function sleepBriefly(ms) {
+  const lock = new Int32Array(new SharedArrayBuffer(4));
+  Atomics.wait(lock, 0, 0, ms);
+}
+function writeStdoutFully(text) {
+  const fd = typeof process.stdout.fd === "number" ? process.stdout.fd : 1;
+  const buffer = Buffer.from(text, "utf8");
+  let offset = 0;
+  while (offset < buffer.length) {
+    try {
+      const bytesWritten = writeSync(fd, buffer, offset, buffer.length - offset);
+      if (bytesWritten <= 0) {
+        sleepBriefly(RETRY_BACKOFF_MS);
+        continue;
+      }
+      offset += bytesWritten;
+    } catch (error) {
+      const code = typeof error === "object" && error && "code" in error ? String(error.code ?? "") : "";
+      if (RETRYABLE_WRITE_CODES.has(code)) {
+        sleepBriefly(RETRY_BACKOFF_MS);
+        continue;
+      }
+      throw error;
+    }
+  }
+}
 function printEnvelope(envelope) {
-  process.stdout.write(`${JSON.stringify(envelope)}
+  writeStdoutFully(`${JSON.stringify(envelope)}
 `);
 }
 function printEnvelopeAndExit(params) {
   printEnvelope(params.envelope);
-  process.exit(params.exitCode ?? EXIT_CODES.success);
+  process.exitCode = params.exitCode ?? EXIT_CODES.success;
+  throw new EnvelopeEmittedSignal();
+}
+function isEnvelopeEmittedSignal(error) {
+  return error instanceof EnvelopeEmittedSignal;
 }
 
 // src/commandRunner.ts
@@ -1370,8 +1406,11 @@ async function runGraphqlQueryCommand(input) {
     }
     printEnvelopeAndExit(result);
   } catch (error) {
+    if (isEnvelopeEmittedSignal(error)) {
+      throw error;
+    }
     if (error instanceof CliError) {
-      printEnvelopeAndExit({
+      return printEnvelopeAndExit({
         envelope: buildCliErrorEnvelope({
           command: input.command,
           status: error.status,
@@ -1383,7 +1422,7 @@ async function runGraphqlQueryCommand(input) {
       });
     }
     const message = error instanceof Error ? error.message : "Unexpected error.";
-    printEnvelopeAndExit({
+    return printEnvelopeAndExit({
       envelope: buildCliErrorEnvelope({
         command: input.command,
         status: 500,
@@ -1409,8 +1448,11 @@ async function runGraphqlMutationCommand(input) {
     });
     printEnvelopeAndExit(result);
   } catch (error) {
+    if (isEnvelopeEmittedSignal(error)) {
+      throw error;
+    }
     if (error instanceof CliError) {
-      printEnvelopeAndExit({
+      return printEnvelopeAndExit({
         envelope: buildCliErrorEnvelope({
           command: input.command,
           status: error.status,
@@ -1422,7 +1464,7 @@ async function runGraphqlMutationCommand(input) {
       });
     }
     const message = error instanceof Error ? error.message : "Unexpected error.";
-    printEnvelopeAndExit({
+    return printEnvelopeAndExit({
       envelope: buildCliErrorEnvelope({
         command: input.command,
         status: 500,
@@ -1532,11 +1574,7 @@ function resolveFromSources(options, stdin, env) {
     normalize(env.WAVE_ORG_ID)
   );
   const timeoutMs = firstDefined(options.timeoutMs, stdin.timeoutMs, env.WAVE_TIMEOUT_MS);
-  const debug = firstDefined(
-    options.debug === true ? true : void 0,
-    stdin.debug,
-    parseBool(env.WAVE_DEBUG)
-  );
+  const debug = parseBool(env.WAVE_DEBUG);
   const agentName = firstDefined(
     normalize(options.agentName),
     normalize(stdin.agentName),
@@ -2412,11 +2450,12 @@ function registerEntityCrudCommands(program, config) {
   const updateHelp5 = buildDataJsonHelp(config.rootKey, "update") ?? "JSON object, optionally wrapped with root key";
   const list = entityCommand.command("list").option("--page <page>").option("--per <per>");
   const listParams = config.listParams ?? [];
+  const listParamHelp = config.listParamHelp ?? {};
   const showParams = config.showParams ?? [];
   const allowQueryJson = config.allowQueryJson !== false;
   listParams.forEach((param) => {
     const cliParam = param.replace(/_/g, "-");
-    list.option(`--${cliParam} <${cliParam}>`);
+    list.option(`--${cliParam} <${cliParam}>`, listParamHelp[param]);
   });
   if (allowQueryJson) {
     list.option("--query-json <queryJson>", "Additional query params as JSON object");
@@ -2593,7 +2632,7 @@ function registerProjectCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
       command: "projects.list",
-      operationName: "ProjectsIndexSlim",
+      operationName: "ProjectsList",
       runtimeOptions: context.runtimeOptions,
       field: "projects",
       variables: normalizeGraphqlVariables2({
@@ -2621,7 +2660,7 @@ function registerProjectCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
       command: "projects.show",
-      operationName: "ProjectShowDeepV2",
+      operationName: "ProjectsShow",
       runtimeOptions: context.runtimeOptions,
       field: "project",
       variables: {
@@ -3884,6 +3923,11 @@ function registerSystemToolCommands(program) {
       "term",
       "type"
     ],
+    listParamHelp: {
+      assigned: "Show assigned knowledge for the authenticated current member context (not a direct assignee-id filter).",
+      member_id: "Filter by content owner/author (contents.member_id), not assignment target member.",
+      focus_member_id: "Filter by focus scope (contents.focus_member_id), not assignment target member."
+    },
     showParams: ["include_all_rollups"],
     allowQueryJson: false
   });
@@ -4536,6 +4580,7 @@ function registerFoundationCommands(program) {
 import { z as z12 } from "zod";
 var idSchema11 = z12.string().min(1);
 var jsonObjectSchema = z12.record(z12.string(), z12.unknown());
+var childListMinimalSelectionSet = "{ data { id type attributes } count currentPage totalPages }";
 function parseJsonObject2(raw) {
   try {
     const parsed = JSON.parse(raw);
@@ -4736,11 +4781,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_subtask",
     destroyField: "destroy_subtask",
     idVariable: "subtask_id",
-    listOperationName: "SubtasksForTask",
-    createOperationName: "CreateSubtask",
-    updateOperationName: "UpdateSubtask",
-    destroyOperationName: "DestroySubtask",
-    listSelectionSet: "{ data { id type name status taskId attributes } count currentPage totalPages }",
+    listOperationName: "SubtasksList",
+    createOperationName: "SubtasksCreate",
+    updateOperationName: "SubtasksUpdate",
+    destroyOperationName: "SubtasksDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "taskId",
     normalizeCreateBody: normalizeSubtaskCreateBody
   });
@@ -4755,11 +4800,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_milestone",
     destroyField: "destroy_milestone",
     idVariable: "milestone_id",
-    listOperationName: "MilestonesForRock",
-    createOperationName: "CreateMilestone",
-    updateOperationName: "UpdateMilestone",
-    destroyOperationName: "DestroyMilestone",
-    listSelectionSet: "{ data { id type name slug status attributes } count currentPage totalPages }"
+    listOperationName: "MilestonesList",
+    createOperationName: "MilestonesCreate",
+    updateOperationName: "MilestonesUpdate",
+    destroyOperationName: "MilestonesDestroy",
+    listSelectionSet: childListMinimalSelectionSet
   });
   registerChildCommands(program, {
     command: "subitems",
@@ -4772,11 +4817,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_subitem",
     destroyField: "destroy_subitem",
     idVariable: "subitem_id",
-    listOperationName: "SubitemsForListItem",
-    createOperationName: "CreateSubitem",
-    updateOperationName: "UpdateSubitem",
-    destroyOperationName: "DestroySubitem",
-    listSelectionSet: "{ data { id type name status listItemId attributes } count currentPage totalPages }",
+    listOperationName: "SubitemsList",
+    createOperationName: "SubitemsCreate",
+    updateOperationName: "SubitemsUpdate",
+    destroyOperationName: "SubitemsDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "listItemId"
   });
   registerChildCommands(program, {
@@ -4790,11 +4835,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_sub_todo",
     destroyField: "destroy_sub_todo",
     idVariable: "sub_todo_id",
-    listOperationName: "SubtodosForTodo",
-    createOperationName: "CreateSubTodo",
-    updateOperationName: "UpdateSubTodo",
-    destroyOperationName: "DestroySubTodo",
-    listSelectionSet: "{ data { id type name status todoId attributes } count currentPage totalPages }",
+    listOperationName: "SubtodosList",
+    createOperationName: "SubtodosCreate",
+    updateOperationName: "SubtodosUpdate",
+    destroyOperationName: "SubtodosDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "todoId"
   });
   registerChildCommands(program, {
@@ -4808,11 +4853,11 @@ function registerChildEntityCommands(program) {
     updateField: "update_sub_issue",
     destroyField: "destroy_sub_issue",
     idVariable: "sub_issue_id",
-    listOperationName: "SubissuesForIssue",
-    createOperationName: "CreateSubIssue",
-    updateOperationName: "UpdateSubIssue",
-    destroyOperationName: "DestroySubIssue",
-    listSelectionSet: "{ data { id type name status issueId attributes } count currentPage totalPages }",
+    listOperationName: "SubissuesList",
+    createOperationName: "SubissuesCreate",
+    updateOperationName: "SubissuesUpdate",
+    destroyOperationName: "SubissuesDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "issueId"
   });
   registerChildCommands(program, {
@@ -4826,23 +4871,23 @@ function registerChildEntityCommands(program) {
     updateField: "update_talking_point",
     destroyField: "destroy_talking_point",
     idVariable: "talking_point_id",
-    listOperationName: "TalkingPointsForMeeting",
-    createOperationName: "CreateTalkingPoint",
-    updateOperationName: "UpdateTalkingPoint",
-    destroyOperationName: "DestroyTalkingPoint",
-    listSelectionSet: "{ data { id type name description status priority rank dueDate memberId creatorId meetingId attributes } count currentPage totalPages }",
+    listOperationName: "TalkingPointsList",
+    createOperationName: "TalkingPointsCreate",
+    updateOperationName: "TalkingPointsUpdate",
+    destroyOperationName: "TalkingPointsDestroy",
+    listSelectionSet: childListMinimalSelectionSet,
     listParentTypedField: "meetingId"
   });
 }
 
-// src/commands/notes.ts
+// src/commands/content.ts
 import { z as z13 } from "zod";
 var idSchema12 = z13.string().min(1);
 var nonEmptyString = z13.string().min(1);
 function assertUpdateFields(params) {
   if (!params.name && !params.content && !params.status) {
     throw new CliError({
-      message: "notes update requires at least one of --name, --body, or --status.",
+      message: "content update requires at least one of --name, --body, or --status.",
       kind: "invalid_args",
       status: 400,
       exitCode: EXIT_CODES.invalidArgs
@@ -4865,13 +4910,13 @@ async function createContent(command, cmd, payload) {
     })
   });
 }
-function registerNoteCommands(program) {
-  const notes = program.command("notes").description("Content note operations");
-  notes.command("list").option("--contentable-type <contentableType>").option("--contentable-id <contentableId>").option("--member-id <memberId>").option("--focus-member-id <focusMemberId>").option("--focus-team-id <focusTeamId>").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+function registerContentCommands(program) {
+  const content = program.command("content").description("Content note operations");
+  content.command("list").option("--contentable-type <contentableType>").option("--contentable-id <contentableId>").option("--member-id <memberId>").option("--focus-member-id <focusMemberId>").option("--focus-team-id <focusTeamId>").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     await runGraphqlQueryCommand({
-      command: "notes.list",
+      command: "content.list",
       operationName: "ContentsIndex",
       runtimeOptions: context.runtimeOptions,
       field: "contents",
@@ -4886,15 +4931,15 @@ function registerNoteCommands(program) {
         per: opts.per
       }),
       isList: true,
-      selectionSet: "{ count currentPage totalPages data { id type name slug firstChildSlug rootParentSlug status contentType lastEdited organizationId memberId focusMemberId focusTeamId teamId creatorId createdAt updatedAt childCount assignmentType contentableId contentableSlug contentableType votesTotal labelIds rootContentId parentContentId attributes } }"
+      selectionSet: "{ count currentPage totalPages data { id type attributes } }"
     });
   });
-  notes.command("show").requiredOption("--id <id>").action(async (opts, cmd) => {
+  content.command("show").requiredOption("--id <id>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const id = idSchema12.parse(opts.id);
     await runGraphqlQueryCommand({
-      command: "notes.show",
+      command: "content.show",
       operationName: "ContentShow",
       runtimeOptions: context.runtimeOptions,
       field: "content",
@@ -4906,7 +4951,7 @@ function registerNoteCommands(program) {
       selectionSet: "{ id type name slug firstChildSlug rootParentSlug status contentType lastEdited organizationId memberId focusMemberId focusTeamId teamId creatorId createdAt updatedAt childCount assignmentType contentableId contentableSlug contentableType votesTotal labelIds rootContentId parentContentId attributes }"
     });
   });
-  notes.command("update").requiredOption("--id <id>").option("--name <name>").option("--body <body>").option("--status <status>").action(async (opts, cmd) => {
+  content.command("update").requiredOption("--id <id>").option("--name <name>").option("--body <body>").option("--status <status>").action(async (opts, cmd) => {
     assertUpdateFields({
       name: opts.name,
       content: opts.body,
@@ -4916,7 +4961,7 @@ function registerNoteCommands(program) {
     const organizationId = resolveOrganizationId(context.organizationId);
     const contentId = idSchema12.parse(opts.id);
     await runGraphqlMutationCommand({
-      command: "notes.update",
+      command: "content.update",
       operationName: "UpdateContent",
       runtimeOptions: context.runtimeOptions,
       field: "update_content",
@@ -4933,12 +4978,12 @@ function registerNoteCommands(program) {
       })
     });
   });
-  notes.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
+  content.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const contentId = idSchema12.parse(opts.id);
     await runGraphqlMutationCommand({
-      command: "notes.destroy",
+      command: "content.destroy",
       operationName: "DestroyContent",
       runtimeOptions: context.runtimeOptions,
       field: "destroy_content",
@@ -4948,9 +4993,9 @@ function registerNoteCommands(program) {
       })
     });
   });
-  notes.command("create-member").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-member").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const targetMemberId = nonEmptyString.parse(opts.targetMemberId);
-    await createContent("notes.create-member", cmd, {
+    await createContent("content.create-member", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4962,9 +5007,9 @@ function registerNoteCommands(program) {
       focus_team_id: null
     });
   });
-  notes.command("create-manager").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-manager").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--target-member-id <targetMemberId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
-    await createContent("notes.create-manager", cmd, {
+    await createContent("content.create-manager", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4975,10 +5020,10 @@ function registerNoteCommands(program) {
       focus_member_id: nonEmptyString.parse(opts.targetMemberId)
     });
   });
-  notes.command("create-team").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--team-id <teamId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+  content.command("create-team").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--team-id <teamId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
     const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
     const teamId = nonEmptyString.parse(opts.teamId);
-    await createContent("notes.create-team", cmd, {
+    await createContent("content.create-team", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -4989,8 +5034,8 @@ function registerNoteCommands(program) {
       focus_team_id: teamId
     });
   });
-  notes.command("create-project").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--project-id <projectId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-project", cmd, {
+  content.command("create-project").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--project-id <projectId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-project", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5000,8 +5045,8 @@ function registerNoteCommands(program) {
       member_id: nonEmptyString.parse(opts.actorMemberId)
     });
   });
-  notes.command("create-customer").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--customer-id <customerId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-customer", cmd, {
+  content.command("create-customer").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--customer-id <customerId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-customer", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5011,8 +5056,8 @@ function registerNoteCommands(program) {
       member_id: nonEmptyString.parse(opts.actorMemberId)
     });
   });
-  notes.command("create-contact").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--contact-id <contactId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
-    await createContent("notes.create-contact", cmd, {
+  content.command("create-contact").requiredOption("--actor-member-id <actorMemberId>").requiredOption("--contact-id <contactId>").requiredOption("--name <name>").requiredOption("--body <body>").option("--status <status>", "draft").action(async (opts, cmd) => {
+    await createContent("content.create-contact", cmd, {
       type: "WrittenContent",
       name: nonEmptyString.parse(opts.name),
       content: nonEmptyString.parse(opts.body),
@@ -5969,26 +6014,26 @@ function emitUnsupportedMutation(params) {
   });
 }
 function registerMutationCapabilityCommands(program) {
-  const projectNotes = program.command("project-notes").description("Project notes node (read-only in CLI mutation surface)");
-  projectNotes.command("create").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  const projectContent = program.command("project-content").description("Project content node (read-only in CLI mutation surface)");
+  projectContent.command("create").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.create",
+      command: "project-content.create",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
     });
   });
-  projectNotes.command("update").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  projectContent.command("update").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.update",
+      command: "project-content.update",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
     });
   });
-  projectNotes.command("destroy").option("--path <path>", "Canonical path for the selected node").action((opts) => {
+  projectContent.command("destroy").option("--path <path>", "Canonical path for the selected node").action((opts) => {
     emitUnsupportedMutation({
-      command: "project-notes.destroy",
+      command: "project-content.destroy",
       toolKey: "projects",
       nodeKey: "project_notes",
       canonicalPath: opts.path
@@ -6008,7 +6053,7 @@ function buildCli(options) {
   ).option(
     "--organization-id <organizationId>",
     "Organization ID (prefer WAVE_ORGANIZATION_ID env var)"
-  ).option("--timeout-ms <timeoutMs>", "HTTP timeout in milliseconds").option("--debug", "Enable debug logs to stderr").option("--agent-name <agentName>", "Agent name for tracing").option("--agent-run-id <agentRunId>", "Agent run identifier for tracing").option("--request-id <requestId>", "Request identifier").option(
+  ).option("--timeout-ms <timeoutMs>", "HTTP timeout in milliseconds").option("--agent-name <agentName>", "Agent name for tracing").option("--agent-run-id <agentRunId>", "Agent run identifier for tracing").option("--request-id <requestId>", "Request identifier").option(
     "--openapi-path <openapiPath>",
     "Optional local OpenAPI file path for contract-aware tooling"
   ).option(
@@ -6030,7 +6075,7 @@ function buildCli(options) {
   registerSystemToolCommands(program);
   registerFoundationCommands(program);
   registerChildEntityCommands(program);
-  registerNoteCommands(program);
+  registerContentCommands(program);
   registerMutationCapabilityCommands(program);
   registerMarkdownTreeCommands(program);
   registerNavigationCommands(program);
@@ -6062,6 +6107,9 @@ async function main() {
   await program.parseAsync(process.argv);
 }
 main().catch((error) => {
+  if (isEnvelopeEmittedSignal(error)) {
+    return;
+  }
   if (error instanceof CliError) {
     printCliFailure({
       status: error.status,
@@ -6070,10 +6118,12 @@ main().catch((error) => {
       details: error.details,
       exitCode: error.exitCode
     });
+    return;
   }
   if (error instanceof CommanderError) {
     if (error.code === "commander.helpDisplayed" || error.code === "commander.version") {
-      process.exit(EXIT_CODES.success);
+      process.exitCode = EXIT_CODES.success;
+      return;
     }
     printCliFailure({
       status: 400,
@@ -6081,6 +6131,7 @@ main().catch((error) => {
       message: error.message,
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   if (error instanceof ZodError || error instanceof InvalidArgumentError) {
     printCliFailure({
@@ -6092,6 +6143,7 @@ main().catch((error) => {
       },
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   const message = error instanceof Error ? error.message : "Unexpected error.";
   printCliFailure({
@@ -6100,4 +6152,5 @@ main().catch((error) => {
     message,
     exitCode: EXIT_CODES.generic
   });
+  return;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ted-galago/wave-cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "type": "module",
   "bin": {
     "wave": "dist/index.js"