@ted-galago/wave-cli 0.1.10 → 0.1.13

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),
@@ -726,6 +723,12 @@ async function graphqlRequest(input) {
 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);
@@ -758,7 +761,11 @@ function printEnvelope(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
@@ -1400,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,
@@ -1413,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,
@@ -1439,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,
@@ -1452,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,
@@ -1562,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),
@@ -2442,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");
@@ -3033,11 +3043,40 @@ var import_zod7 = require("zod");
 var idSchema6 = import_zod7.z.string().min(1);
 var createHelp3 = buildDataJsonHelp("member", "create") ?? 'JSON object for member or {"member": {...}}';
 var updateHelp3 = buildDataJsonHelp("member", "update") ?? 'JSON object for member or {"member": {...}}';
+function parseStrictBooleanOption(value, optionName) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const lowered = value.trim().toLowerCase();
+    if (lowered === "true") {
+      return true;
+    }
+    if (lowered === "false") {
+      return false;
+    }
+  }
+  throw new CliError({
+    message: `Invalid ${optionName} value. Use true or false.`,
+    kind: "invalid_args",
+    status: 400,
+    exitCode: EXIT_CODES.invalidArgs,
+    details: {
+      option: optionName,
+      value,
+      allowed: ["true", "false"]
+    }
+  });
+}
 function registerMemberCommands(program) {
   const members = program.command("members").description("Member operations");
-  members.command("list").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+  members.command("list").option("--page <page>").option("--per <per>").option(
+    "--include-coaches <includeCoaches>",
+    "Include linked coach members. Defaults to false; omitted/false returns organization members only."
+  ).action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
+    const includeCoaches = opts.includeCoaches === void 0 ? void 0 : parseStrictBooleanOption(opts.includeCoaches, "--include-coaches");
     await runGraphqlQueryCommand({
       command: "members.list",
       runtimeOptions: context.runtimeOptions,
@@ -3045,7 +3084,8 @@ function registerMemberCommands(program) {
       variables: normalizeGraphqlVariables2({
         organization_id: organizationId,
         page: opts.page,
-        per: opts.per
+        per: opts.per,
+        include_coaches: includeCoaches
       }),
       isList: true
     });
@@ -3914,6 +3954,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
   });
@@ -6039,7 +6084,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(
@@ -6093,6 +6138,9 @@ async function main() {
   await program.parseAsync(process.argv);
 }
 main().catch((error) => {
+  if (isEnvelopeEmittedSignal(error)) {
+    return;
+  }
   if (error instanceof CliError) {
     printCliFailure({
       status: error.status,
@@ -6101,10 +6149,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,
@@ -6112,6 +6162,7 @@ main().catch((error) => {
       message: error.message,
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   if (error instanceof import_zod16.ZodError || error instanceof import_commander2.InvalidArgumentError) {
     printCliFailure({
@@ -6123,6 +6174,7 @@ main().catch((error) => {
       },
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   const message = error instanceof Error ? error.message : "Unexpected error.";
   printCliFailure({
@@ -6131,4 +6183,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),
@@ -725,6 +722,12 @@ async function graphqlRequest(input) {
 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);
@@ -757,7 +760,11 @@ function printEnvelope(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
@@ -1399,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,
@@ -1412,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,
@@ -1438,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,
@@ -1451,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,
@@ -1561,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),
@@ -2441,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");
@@ -3032,11 +3042,40 @@ import { z as z7 } from "zod";
 var idSchema6 = z7.string().min(1);
 var createHelp3 = buildDataJsonHelp("member", "create") ?? 'JSON object for member or {"member": {...}}';
 var updateHelp3 = buildDataJsonHelp("member", "update") ?? 'JSON object for member or {"member": {...}}';
+function parseStrictBooleanOption(value, optionName) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const lowered = value.trim().toLowerCase();
+    if (lowered === "true") {
+      return true;
+    }
+    if (lowered === "false") {
+      return false;
+    }
+  }
+  throw new CliError({
+    message: `Invalid ${optionName} value. Use true or false.`,
+    kind: "invalid_args",
+    status: 400,
+    exitCode: EXIT_CODES.invalidArgs,
+    details: {
+      option: optionName,
+      value,
+      allowed: ["true", "false"]
+    }
+  });
+}
 function registerMemberCommands(program) {
   const members = program.command("members").description("Member operations");
-  members.command("list").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+  members.command("list").option("--page <page>").option("--per <per>").option(
+    "--include-coaches <includeCoaches>",
+    "Include linked coach members. Defaults to false; omitted/false returns organization members only."
+  ).action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
+    const includeCoaches = opts.includeCoaches === void 0 ? void 0 : parseStrictBooleanOption(opts.includeCoaches, "--include-coaches");
     await runGraphqlQueryCommand({
       command: "members.list",
       runtimeOptions: context.runtimeOptions,
@@ -3044,7 +3083,8 @@ function registerMemberCommands(program) {
       variables: normalizeGraphqlVariables2({
         organization_id: organizationId,
         page: opts.page,
-        per: opts.per
+        per: opts.per,
+        include_coaches: includeCoaches
       }),
       isList: true
     });
@@ -3913,6 +3953,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
   });
@@ -6038,7 +6083,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(
@@ -6092,6 +6137,9 @@ async function main() {
   await program.parseAsync(process.argv);
 }
 main().catch((error) => {
+  if (isEnvelopeEmittedSignal(error)) {
+    return;
+  }
   if (error instanceof CliError) {
     printCliFailure({
       status: error.status,
@@ -6100,10 +6148,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,
@@ -6111,6 +6161,7 @@ main().catch((error) => {
       message: error.message,
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   if (error instanceof ZodError || error instanceof InvalidArgumentError) {
     printCliFailure({
@@ -6122,6 +6173,7 @@ main().catch((error) => {
       },
       exitCode: EXIT_CODES.invalidArgs
     });
+    return;
   }
   const message = error instanceof Error ? error.message : "Unexpected error.";
   printCliFailure({
@@ -6130,4 +6182,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.10",
+  "version": "0.1.13",
   "type": "module",
   "bin": {
     "wave": "dist/index.js"