@wave-ai-os/wave-cli 0.1.73 → 0.1.75

package/dist/index.cjs

@@ -2556,6 +2556,20 @@ function parseSearchQuery(raw) {
   }
   return raw.trim();
 }
+function parseRequiredOption(raw, flag) {
+  if (typeof raw !== "string" || raw.trim().length === 0) {
+    throw new CliError({
+      message: `Missing required option: --${flag}.`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  return raw.trim();
+}
+function optionKey(flag) {
+  return flag.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
 function asRecord2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -2592,10 +2606,21 @@ function buildSearchTransform(query, transformData) {
   };
 }
 function registerGraphqlSearchCommand(command, config) {
-  command.command("search").description("Search records through the existing list GraphQL contract").requiredOption("--query <query>", "Search query").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+  const requiredOptions = config.requiredOptions ?? [];
+  const search = command.command("search").description("Search records through the existing list GraphQL contract").requiredOption("--query <query>", "Search query").option("--page <page>").option("--per <per>");
+  for (const requiredOption of requiredOptions) {
+    search.requiredOption(`--${requiredOption.flag} <${requiredOption.flag}>`, requiredOption.description);
+  }
+  search.action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const query = parseSearchQuery(opts.query);
+    const requiredVariables = Object.fromEntries(
+      requiredOptions.map((requiredOption) => [
+        requiredOption.variable,
+        parseRequiredOption(opts[optionKey(requiredOption.flag)], requiredOption.flag)
+      ])
+    );
     await runGraphqlQueryCommand({
       command: `${config.command}.search`,
       operationName: config.operationName,
@@ -2604,13 +2629,20 @@ function registerGraphqlSearchCommand(command, config) {
       variables: normalizeGraphqlVariables2({
         organization_id: organizationId,
         page: opts.page,
-        per: opts.per
+        per: opts.per,
+        ...requiredVariables
       }),
       variableTypes: {
         organization_id: "ID!",
         page: "Int",
         per: "Int",
-        ...config.variableTypes ?? {}
+        ...config.variableTypes ?? {},
+        ...Object.fromEntries(
+          requiredOptions.map((requiredOption) => [
+            requiredOption.variable,
+            requiredOption.variableType
+          ])
+        )
       },
       isList: true,
       selectionSet: config.selectionSet,
@@ -3448,8 +3480,8 @@ function registerEntityCrudCommands(program, config) {
     const extraQuery = allowQueryJson ? parseQueryJson(opts.queryJson ? String(opts.queryJson) : void 0) : {};
     const mappedKnownParams = Object.fromEntries(
       listParams.map((param) => {
-        const optionKey = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
-        return [param, opts[optionKey]];
+        const optionKey2 = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+        return [param, opts[optionKey2]];
       })
     );
     const variables = normalizeGraphqlVariables2({
@@ -3488,8 +3520,8 @@ function registerEntityCrudCommands(program, config) {
     const defaultField = config.showField ?? (config.resourcePath === "feedback" ? "feedback" : toSingularResourceName(config.resourcePath));
     const mappedShowParams = Object.fromEntries(
       showParams.map((param) => {
-        const optionKey = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
-        return [param, opts[optionKey]];
+        const optionKey2 = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+        return [param, opts[optionKey2]];
       })
     );
     const defaultVariables = normalizeGraphqlVariables2({
@@ -5788,12 +5820,41 @@ function registerFoundationCommands(program) {
 var import_zod13 = require("zod");
 var idSchema12 = import_zod13.z.string().min(1);
 var jsonObjectSchema = import_zod13.z.record(import_zod13.z.string(), import_zod13.z.unknown());
-function buildChildListSelectionSet(parentField, extraFields = []) {
+var NOTE_DETAIL_FIELDS = [
+  "notes",
+  "hasNotes",
+  "hasUnreadNotes",
+  "notesUpdatedAt",
+  "notesLastReadAt",
+  "estimateIds"
+];
+var PARENT_KIND_LABELS = {
+  task: "task",
+  rock: "rock",
+  listItem: "list item",
+  todo: "todo",
+  issue: "issue",
+  meeting: "meeting"
+};
+function requiredParentSearchOption(parentFlag, parentKind) {
+  return [
+    {
+      flag: parentFlag,
+      variable: parentFlag.replace(/-/g, "_"),
+      variableType: "ID!",
+      description: `Parent ${PARENT_KIND_LABELS[parentKind]} ID`
+    }
+  ];
+}
+function buildChildResourceSelectionSet(parentField, extraFields = []) {
   const fields = Array.from(
     /* @__PURE__ */ new Set(["id", "type", "name", "status", "priority", "rank", "dueDate", "memberId", parentField, ...extraFields])
   );
   const attributeFields = fields.filter((field) => field !== "type");
-  return `{ data { ${fields.join(" ")} attributes { ${attributeFields.join(" ")} } } count currentPage totalPages }`;
+  return `{ ${fields.join(" ")} attributes { ${attributeFields.join(" ")} } }`;
+}
+function buildChildListSelectionSet(parentField, extraFields = []) {
+  return `{ data ${buildChildResourceSelectionSet(parentField, extraFields)} count currentPage totalPages }`;
 }
 function parseJsonObject2(raw) {
   try {
@@ -5937,7 +5998,31 @@ function registerChildCommands(program, config) {
       )
     });
   });
-  registerGraphqlSearchCommand(command, {
+  if (config.showField) {
+    const showField = config.showField;
+    command.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: `${config.command}.show`,
+        ...config.showOperationName ? { operationName: config.showOperationName } : {},
+        runtimeOptions: context.runtimeOptions,
+        field: showField,
+        variables: {
+          organization_id: organizationId,
+          id
+        },
+        variableTypes: {
+          organization_id: "ID!",
+          id: "ID!"
+        },
+        ...config.showSelectionSet ? { selectionSet: config.showSelectionSet } : {},
+        isShow: true
+      });
+    });
+  }
+  const searchConfig = {
     command: config.command,
     operationName: `${config.listOperationName.replace(/List$/, "")}Search`,
     field: config.listField,
@@ -5947,8 +6032,10 @@ function registerChildCommands(program, config) {
       config.parentKind,
       void 0,
       config.listParentTypedField
-    )
-  });
+    ),
+    ...config.searchRequiredOptions ? { requiredOptions: config.searchRequiredOptions } : {}
+  };
+  registerGraphqlSearchCommand(command, searchConfig);
   command.command("create").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
@@ -6019,6 +6106,10 @@ function registerChildEntityCommands(program) {
     destroyOperationName: "SubtasksDestroy",
     listSelectionSet: buildChildListSelectionSet("taskId"),
     listParentTypedField: "taskId",
+    searchRequiredOptions: requiredParentSearchOption("task-id", "task"),
+    showField: "subtask",
+    showOperationName: "SubtasksShow",
+    showSelectionSet: buildChildResourceSelectionSet("taskId", NOTE_DETAIL_FIELDS),
     normalizeCreateBody: normalizeSubtaskCreateBody
   });
   registerChildCommands(program, {
@@ -6036,7 +6127,12 @@ function registerChildEntityCommands(program) {
     createOperationName: "MilestonesCreate",
     updateOperationName: "MilestonesUpdate",
     destroyOperationName: "MilestonesDestroy",
-    listSelectionSet: buildChildListSelectionSet("rockId")
+    listSelectionSet: buildChildListSelectionSet("rockId"),
+    listParentTypedField: "rockId",
+    searchRequiredOptions: requiredParentSearchOption("rock-id", "rock"),
+    showField: "milestone",
+    showOperationName: "MilestonesShow",
+    showSelectionSet: buildChildResourceSelectionSet("rockId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subitems",
@@ -6054,7 +6150,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubitemsUpdate",
     destroyOperationName: "SubitemsDestroy",
     listSelectionSet: buildChildListSelectionSet("listItemId"),
-    listParentTypedField: "listItemId"
+    listParentTypedField: "listItemId",
+    searchRequiredOptions: requiredParentSearchOption("list-item-id", "listItem"),
+    showField: "subitem",
+    showOperationName: "SubitemsShow",
+    showSelectionSet: buildChildResourceSelectionSet("listItemId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subtodos",
@@ -6072,7 +6172,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubtodosUpdate",
     destroyOperationName: "SubtodosDestroy",
     listSelectionSet: buildChildListSelectionSet("todoId"),
-    listParentTypedField: "todoId"
+    listParentTypedField: "todoId",
+    searchRequiredOptions: requiredParentSearchOption("todo-id", "todo"),
+    showField: "sub_todo",
+    showOperationName: "SubtodosShow",
+    showSelectionSet: buildChildResourceSelectionSet("todoId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subissues",
@@ -6090,7 +6194,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubissuesUpdate",
     destroyOperationName: "SubissuesDestroy",
     listSelectionSet: buildChildListSelectionSet("issueId"),
-    listParentTypedField: "issueId"
+    listParentTypedField: "issueId",
+    searchRequiredOptions: requiredParentSearchOption("issue-id", "issue"),
+    showField: "sub_issue",
+    showOperationName: "SubissuesShow",
+    showSelectionSet: buildChildResourceSelectionSet("issueId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "talking-points",
@@ -14775,6 +14883,7 @@ var idempotencyKeySchema = import_zod19.z.string().min(1).refine((value) => valu
 var skillScopeSchema = import_zod19.z.enum(["ADMIN_GLOBAL", "MEMBER_PERSONAL"]);
 var isoDateSchema = import_zod19.z.iso.date();
 var nonEmptyStringSchema = import_zod19.z.string().trim().min(1);
+var AUTOMATION_RUN_HTTP_TIMEOUT_MS = 6e4;
 var agentToolAccessSchema = import_zod19.z.array(
   import_zod19.z.object({
     tool_key: nonEmptyStringSchema,
@@ -14910,10 +15019,33 @@ var AUTOMATION_SELECTION = `{
   aiTaskConfig
   organizationId
   memberId
+  agentId
   createdAt
   updatedAt
   updateVersion
 }`;
+var AUTOMATION_RUN_SELECTION = `{
+  id
+  type
+  attributes {
+    id
+    title
+    status
+    errorMessage
+    usedAt
+    agentTriggerId
+    executionId
+    executionSlug
+    traceId
+    outputContentId
+    outputContentSlug
+    outputContent {
+      id
+      slug
+    }
+    targetId
+  }
+}`;
 function asRecord7(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -15021,12 +15153,92 @@ function normalizePersistedUpdatePayload(payload) {
     persisted: { id, slug, update_version: updateVersion }
   };
 }
+function normalizeAutomationRunPayload(payload) {
+  const mutation = asRecord7(payload);
+  if (!mutation) {
+    throw new CliError({
+      message: "Automation run response did not include a mutation payload.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  if (mutation.ok !== true) {
+    return {
+      ok: mutation.ok,
+      status: mutation.status,
+      errorCode: mutation.errorCode ?? null,
+      errors: mutation.errors ?? null,
+      data: mutation.data ?? null
+    };
+  }
+  const data = asRecord7(mutation.data);
+  const automationTaskId = asRequiredString(data?.automation_task_id);
+  const automationTaskSlug = asRequiredString(data?.automation_task_slug);
+  const agentId = asRequiredString(data?.agent_id);
+  const agentSlug = asRequiredString(data?.agent_slug);
+  const agentTriggerId = asRequiredString(data?.agent_trigger_id);
+  const executionId = asRequiredString(data?.execution_id);
+  const executionSlug = asRequiredString(data?.execution_slug);
+  const executionStatus = asRequiredString(data?.execution_status);
+  const traceId = asRequiredString(data?.trace_id);
+  if (!data || !automationTaskId || !automationTaskSlug || !agentId || !agentSlug || !agentTriggerId || !executionId || !executionSlug || !executionStatus || !traceId) {
+    throw new CliError({
+      message: "Automation run response did not include automation, execution, and trace evidence.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  return {
+    ok: mutation.ok,
+    status: mutation.status,
+    errorCode: mutation.errorCode ?? null,
+    errors: mutation.errors ?? null,
+    run: {
+      executed: data.executed === true,
+      skipped_reason: asRequiredString(data.skipped_reason),
+      automation: {
+        id: automationTaskId,
+        slug: automationTaskSlug
+      },
+      agent: {
+        id: agentId,
+        slug: agentSlug
+      },
+      trigger: {
+        id: agentTriggerId,
+        type: asRequiredString(data.trigger_type)
+      },
+      execution: {
+        id: executionId,
+        slug: executionSlug,
+        status: executionStatus
+      },
+      output_content: {
+        id: asRequiredString(data.output_content_id),
+        slug: asRequiredString(data.output_content_slug)
+      },
+      trace_id: traceId,
+      correlation_id: asRequiredString(data.correlation_id),
+      readback_command: `wave automations run-show --agent-id ${agentSlug} --execution-slug ${executionSlug}`
+    }
+  };
+}
 function parseAutomationConfig(value) {
   return automationConfigSchema.parse(parseJson(String(value), "--ai-task-config"));
 }
 function parseExpectedUpdateVersion(value) {
   return nonEmptyStringSchema.parse(String(value));
 }
+function withAutomationRunTimeout(runtimeOptions) {
+  const configuredTimeoutMs = Number(runtimeOptions.timeoutMs);
+  const timeoutMs = Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > AUTOMATION_RUN_HTTP_TIMEOUT_MS ? configuredTimeoutMs : AUTOMATION_RUN_HTTP_TIMEOUT_MS;
+  return {
+    ...runtimeOptions,
+    timeoutMs
+  };
+}
 function registerAtlasAuthoringCommands(program) {
   const agents = program.command("agents").description("Bounded Agent authoring operations");
   agents.command("create").description("Create an Agent through the API-owned createAgent contract").requiredOption("--idempotency-key <key>", "Required create idempotency key").option("--name <name>").option("--description <description>").option("--notes <notes>").option("--member-id <memberId>").option("--status <status>").option("--visibility <visibility>").option("--model <model>").option("--run-when-mentioned <boolean>", "true or false").option("--web-access-enabled <boolean>", "true or false").option("--web-fetch-enabled <boolean>", "true or false").option("--search-past-conversations-enabled <boolean>", "true or false").option("--app-rules-creation-enabled <boolean>", "true or false").option("--tool-discovery-enabled <boolean>", "true or false").option("--self-updates-enabled <boolean>", "true or false").option("--trusted-urls <urls>", "Comma-separated trusted URLs").option("--tool-access <json>", "JSON array of canonical native Agent tool scopes").option(
@@ -15259,7 +15471,7 @@ function registerAtlasAuthoringCommands(program) {
           ...opts.description !== void 0 ? { description: String(opts.description) } : {},
           ...opts.notes !== void 0 ? { notes: String(opts.notes) } : {},
           ...opts.memberId !== void 0 ? { member_id: idSchema14.parse(opts.memberId) } : {},
-          ...opts.agentId !== void 0 ? { agentId: idSchema14.parse(opts.agentId) } : {},
+          ...opts.agentId !== void 0 ? { agent_id: idSchema14.parse(opts.agentId) } : {},
           ...opts.priority !== void 0 ? { priority: String(opts.priority) } : {},
           ...opts.dueDate !== void 0 ? { due_date: isoDateSchema.parse(opts.dueDate) } : {}
         },
@@ -15283,6 +15495,44 @@ function registerAtlasAuthoringCommands(program) {
       isShow: true
     });
   });
+  automations.command("run").description("Run one scheduled Automation by id or slug and return execution trace evidence").requiredOption("--id <idOrSlug>", "Automation id or slug").action(async (opts, cmd) => {
+    const automationId = idSchema14.parse(opts.id);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlMutationCommand({
+      command: "automations.run",
+      operationName: "AutomationsRunNow",
+      runtimeOptions: withAutomationRunTimeout(context.runtimeOptions),
+      field: "run_automation_now",
+      variableTypes: { organization_id: "ID!", automation_id: "ID!" },
+      variables: { organization_id: organizationId, automation_id: automationId },
+      transformMutationPayload: normalizeAutomationRunPayload
+    });
+  });
+  automations.command("run-show").description("Read one Automation run artifact by Agent id and execution slug").requiredOption("--agent-id <agentIdOrSlug>", "Agent id or slug").requiredOption("--execution-slug <executionSlug>", "Execution slug returned by automations run").action(async (opts, cmd) => {
+    const agentId = idSchema14.parse(opts.agentId);
+    const executionSlug = idSchema14.parse(opts.executionSlug);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "automations.run-show",
+      operationName: "AutomationsRunShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "agent_automation_run",
+      variables: {
+        organization_id: organizationId,
+        agent_id: agentId,
+        automation_id: executionSlug
+      },
+      variableTypes: {
+        organization_id: "ID!",
+        agent_id: "ID!",
+        automation_id: "ID!"
+      },
+      selectionSet: AUTOMATION_RUN_SELECTION,
+      isShow: true
+    });
+  });
   automations.command("update").description("Update one task-backed Automation without changing its system-managed status").requiredOption("--id <idOrSlug>", "Automation id or slug").requiredOption(
     "--expected-update-version <version>",
     "Exact opaque updateVersion value from automations show; rejects stale writes"
@@ -15424,7 +15674,7 @@ var import_node_path4 = require("path");
 var import_node_crypto3 = require("crypto");
 
 // src/version.ts
-var CLI_VERSION = "0.1.73";
+var CLI_VERSION = "0.1.74";
 
 // src/operationMetadata.ts
 var DISCOVERY_OPERATION_IDS = [
@@ -15546,6 +15796,7 @@ var READ_OPERATION_IDS = [
   "agents.plugin-catalog",
   "agents.show",
   "auth.status",
+  "automations.run-show",
   "automations.show",
   "broadcast.community",
   "broadcast.list",
@@ -15620,6 +15871,7 @@ var READ_OPERATION_IDS = [
   "members.show",
   "milestones.list",
   "milestones.search",
+  "milestones.show",
   "news.list",
   "news.search",
   "news.show",
@@ -15690,12 +15942,16 @@ var READ_OPERATION_IDS = [
   "stand-ups.show",
   "subissues.list",
   "subissues.search",
+  "subissues.show",
   "subitems.list",
   "subitems.search",
+  "subitems.show",
   "subtasks.list",
   "subtasks.search",
+  "subtasks.show",
   "subtodos.list",
   "subtodos.search",
+  "subtodos.show",
   "support.counts",
   "support.inbox",
   "support.knowledge-articles",
@@ -15739,6 +15995,7 @@ var WRITE_OPERATION_IDS = [
   "agents.create",
   "agents.update",
   "automations.create",
+  "automations.run",
   "automations.update",
   "contacts.create",
   "contacts.update",
@@ -16249,6 +16506,8 @@ var NAMESPACE_DOCS = {
     examples: [
       `wave automations create --summary "Weekly review" --agent-id 123 --ai-task-config '{"cycle":"repeat","repeatSchedule":{"interval":1,"frequency":"week","weekdays":[1,3],"at":"2:30 PM","starting":"2026-07-20T00:00:00.000Z","ending":"never","endingRuns":1,"endingDate":null,"timezone":"America/Phoenix"}}' --idempotency-key automation-create-001`,
       "wave automations show --id ATK-01",
+      "wave automations run --id ATK-01",
+      "wave automations run-show --agent-id AGT-01 --execution-slug ART-1234567890",
       'wave automations update --id ATK-01 --expected-update-version 2026-07-17T12:00:00.123456Z --summary "Weekly project review"'
     ],
     schema: {
@@ -16260,10 +16519,11 @@ var NAMESPACE_DOCS = {
         "Only the API-defined ai_task_config field accepts validated JSON.",
         "Optional executor Agent linkage is sent only through the API-defined top-level agentId input.",
         "Update calls only updateTask with an exact opaque updateVersion token; it cannot change status, task type, ownership, or project linkage.",
-        "Does not create a project Task, run an Automation, or invoke AI OS actions.",
+        "Run calls only runAutomationNow for an existing scheduled Automation and returns execution/trace evidence.",
+        "Run-show reads the persisted Automation run artifact through agentAutomationRun by Agent id and execution slug.",
         "Show uses the API-owned automation query by id; no slug fallback is implemented."
       ],
-      commands: ["create", "show", "update"]
+      commands: ["create", "show", "run", "run-show", "update"]
     }
   },
   broadcast: {
@@ -16743,10 +17003,14 @@ async function resolveDoctorAuthOrganization(params) {
     }
     const id = organization.id;
     const slug = organization.slug;
-    return {
-      id: typeof id === "string" && id.trim() !== "" ? id : void 0,
-      slug: typeof slug === "string" && slug.trim() !== "" ? slug : void 0
-    };
+    const result = {};
+    if (typeof id === "string" && id.trim() !== "") {
+      result.id = id;
+    }
+    if (typeof slug === "string" && slug.trim() !== "") {
+      result.slug = slug;
+    }
+    return result;
   } catch {
     return null;
   }
@@ -16759,7 +17023,14 @@ async function runDoctor(cmd, opts) {
   const tokenSource = runtime.tokenSource ?? "none";
   const organizationId = context.organizationId;
   const authStorage = await getAuthStorageInfo(baseUrl);
-  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization({ baseUrl, token });
+  const authOptions = {};
+  if (baseUrl) {
+    authOptions.baseUrl = baseUrl;
+  }
+  if (token) {
+    authOptions.token = token;
+  }
+  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization(authOptions);
   const checks = [
     {
       name: "auth_token",

package/dist/index.js

@@ -2555,6 +2555,20 @@ function parseSearchQuery(raw) {
   }
   return raw.trim();
 }
+function parseRequiredOption(raw, flag) {
+  if (typeof raw !== "string" || raw.trim().length === 0) {
+    throw new CliError({
+      message: `Missing required option: --${flag}.`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  return raw.trim();
+}
+function optionKey(flag) {
+  return flag.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
 function asRecord2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -2591,10 +2605,21 @@ function buildSearchTransform(query, transformData) {
   };
 }
 function registerGraphqlSearchCommand(command, config) {
-  command.command("search").description("Search records through the existing list GraphQL contract").requiredOption("--query <query>", "Search query").option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+  const requiredOptions = config.requiredOptions ?? [];
+  const search = command.command("search").description("Search records through the existing list GraphQL contract").requiredOption("--query <query>", "Search query").option("--page <page>").option("--per <per>");
+  for (const requiredOption of requiredOptions) {
+    search.requiredOption(`--${requiredOption.flag} <${requiredOption.flag}>`, requiredOption.description);
+  }
+  search.action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
     const query = parseSearchQuery(opts.query);
+    const requiredVariables = Object.fromEntries(
+      requiredOptions.map((requiredOption) => [
+        requiredOption.variable,
+        parseRequiredOption(opts[optionKey(requiredOption.flag)], requiredOption.flag)
+      ])
+    );
     await runGraphqlQueryCommand({
       command: `${config.command}.search`,
       operationName: config.operationName,
@@ -2603,13 +2628,20 @@ function registerGraphqlSearchCommand(command, config) {
       variables: normalizeGraphqlVariables2({
         organization_id: organizationId,
         page: opts.page,
-        per: opts.per
+        per: opts.per,
+        ...requiredVariables
       }),
       variableTypes: {
         organization_id: "ID!",
         page: "Int",
         per: "Int",
-        ...config.variableTypes ?? {}
+        ...config.variableTypes ?? {},
+        ...Object.fromEntries(
+          requiredOptions.map((requiredOption) => [
+            requiredOption.variable,
+            requiredOption.variableType
+          ])
+        )
       },
       isList: true,
       selectionSet: config.selectionSet,
@@ -3447,8 +3479,8 @@ function registerEntityCrudCommands(program, config) {
     const extraQuery = allowQueryJson ? parseQueryJson(opts.queryJson ? String(opts.queryJson) : void 0) : {};
     const mappedKnownParams = Object.fromEntries(
       listParams.map((param) => {
-        const optionKey = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
-        return [param, opts[optionKey]];
+        const optionKey2 = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+        return [param, opts[optionKey2]];
       })
     );
     const variables = normalizeGraphqlVariables2({
@@ -3487,8 +3519,8 @@ function registerEntityCrudCommands(program, config) {
     const defaultField = config.showField ?? (config.resourcePath === "feedback" ? "feedback" : toSingularResourceName(config.resourcePath));
     const mappedShowParams = Object.fromEntries(
       showParams.map((param) => {
-        const optionKey = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
-        return [param, opts[optionKey]];
+        const optionKey2 = param.replace(/_([a-z])/g, (_, char) => char.toUpperCase());
+        return [param, opts[optionKey2]];
       })
     );
     const defaultVariables = normalizeGraphqlVariables2({
@@ -5787,12 +5819,41 @@ function registerFoundationCommands(program) {
 import { z as z13 } from "zod";
 var idSchema12 = z13.string().min(1);
 var jsonObjectSchema = z13.record(z13.string(), z13.unknown());
-function buildChildListSelectionSet(parentField, extraFields = []) {
+var NOTE_DETAIL_FIELDS = [
+  "notes",
+  "hasNotes",
+  "hasUnreadNotes",
+  "notesUpdatedAt",
+  "notesLastReadAt",
+  "estimateIds"
+];
+var PARENT_KIND_LABELS = {
+  task: "task",
+  rock: "rock",
+  listItem: "list item",
+  todo: "todo",
+  issue: "issue",
+  meeting: "meeting"
+};
+function requiredParentSearchOption(parentFlag, parentKind) {
+  return [
+    {
+      flag: parentFlag,
+      variable: parentFlag.replace(/-/g, "_"),
+      variableType: "ID!",
+      description: `Parent ${PARENT_KIND_LABELS[parentKind]} ID`
+    }
+  ];
+}
+function buildChildResourceSelectionSet(parentField, extraFields = []) {
   const fields = Array.from(
     /* @__PURE__ */ new Set(["id", "type", "name", "status", "priority", "rank", "dueDate", "memberId", parentField, ...extraFields])
   );
   const attributeFields = fields.filter((field) => field !== "type");
-  return `{ data { ${fields.join(" ")} attributes { ${attributeFields.join(" ")} } } count currentPage totalPages }`;
+  return `{ ${fields.join(" ")} attributes { ${attributeFields.join(" ")} } }`;
+}
+function buildChildListSelectionSet(parentField, extraFields = []) {
+  return `{ data ${buildChildResourceSelectionSet(parentField, extraFields)} count currentPage totalPages }`;
 }
 function parseJsonObject2(raw) {
   try {
@@ -5936,7 +5997,31 @@ function registerChildCommands(program, config) {
       )
     });
   });
-  registerGraphqlSearchCommand(command, {
+  if (config.showField) {
+    const showField = config.showField;
+    command.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: `${config.command}.show`,
+        ...config.showOperationName ? { operationName: config.showOperationName } : {},
+        runtimeOptions: context.runtimeOptions,
+        field: showField,
+        variables: {
+          organization_id: organizationId,
+          id
+        },
+        variableTypes: {
+          organization_id: "ID!",
+          id: "ID!"
+        },
+        ...config.showSelectionSet ? { selectionSet: config.showSelectionSet } : {},
+        isShow: true
+      });
+    });
+  }
+  const searchConfig = {
     command: config.command,
     operationName: `${config.listOperationName.replace(/List$/, "")}Search`,
     field: config.listField,
@@ -5946,8 +6031,10 @@ function registerChildCommands(program, config) {
       config.parentKind,
       void 0,
       config.listParentTypedField
-    )
-  });
+    ),
+    ...config.searchRequiredOptions ? { requiredOptions: config.searchRequiredOptions } : {}
+  };
+  registerGraphqlSearchCommand(command, searchConfig);
   command.command("create").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
     const context = await resolveCommandContext(cmd.optsWithGlobals());
     const organizationId = resolveOrganizationId(context.organizationId);
@@ -6018,6 +6105,10 @@ function registerChildEntityCommands(program) {
     destroyOperationName: "SubtasksDestroy",
     listSelectionSet: buildChildListSelectionSet("taskId"),
     listParentTypedField: "taskId",
+    searchRequiredOptions: requiredParentSearchOption("task-id", "task"),
+    showField: "subtask",
+    showOperationName: "SubtasksShow",
+    showSelectionSet: buildChildResourceSelectionSet("taskId", NOTE_DETAIL_FIELDS),
     normalizeCreateBody: normalizeSubtaskCreateBody
   });
   registerChildCommands(program, {
@@ -6035,7 +6126,12 @@ function registerChildEntityCommands(program) {
     createOperationName: "MilestonesCreate",
     updateOperationName: "MilestonesUpdate",
     destroyOperationName: "MilestonesDestroy",
-    listSelectionSet: buildChildListSelectionSet("rockId")
+    listSelectionSet: buildChildListSelectionSet("rockId"),
+    listParentTypedField: "rockId",
+    searchRequiredOptions: requiredParentSearchOption("rock-id", "rock"),
+    showField: "milestone",
+    showOperationName: "MilestonesShow",
+    showSelectionSet: buildChildResourceSelectionSet("rockId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subitems",
@@ -6053,7 +6149,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubitemsUpdate",
     destroyOperationName: "SubitemsDestroy",
     listSelectionSet: buildChildListSelectionSet("listItemId"),
-    listParentTypedField: "listItemId"
+    listParentTypedField: "listItemId",
+    searchRequiredOptions: requiredParentSearchOption("list-item-id", "listItem"),
+    showField: "subitem",
+    showOperationName: "SubitemsShow",
+    showSelectionSet: buildChildResourceSelectionSet("listItemId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subtodos",
@@ -6071,7 +6171,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubtodosUpdate",
     destroyOperationName: "SubtodosDestroy",
     listSelectionSet: buildChildListSelectionSet("todoId"),
-    listParentTypedField: "todoId"
+    listParentTypedField: "todoId",
+    searchRequiredOptions: requiredParentSearchOption("todo-id", "todo"),
+    showField: "sub_todo",
+    showOperationName: "SubtodosShow",
+    showSelectionSet: buildChildResourceSelectionSet("todoId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "subissues",
@@ -6089,7 +6193,11 @@ function registerChildEntityCommands(program) {
     updateOperationName: "SubissuesUpdate",
     destroyOperationName: "SubissuesDestroy",
     listSelectionSet: buildChildListSelectionSet("issueId"),
-    listParentTypedField: "issueId"
+    listParentTypedField: "issueId",
+    searchRequiredOptions: requiredParentSearchOption("issue-id", "issue"),
+    showField: "sub_issue",
+    showOperationName: "SubissuesShow",
+    showSelectionSet: buildChildResourceSelectionSet("issueId", NOTE_DETAIL_FIELDS)
   });
   registerChildCommands(program, {
     command: "talking-points",
@@ -14774,6 +14882,7 @@ var idempotencyKeySchema = z19.string().min(1).refine((value) => value.trim() ==
 var skillScopeSchema = z19.enum(["ADMIN_GLOBAL", "MEMBER_PERSONAL"]);
 var isoDateSchema = z19.iso.date();
 var nonEmptyStringSchema = z19.string().trim().min(1);
+var AUTOMATION_RUN_HTTP_TIMEOUT_MS = 6e4;
 var agentToolAccessSchema = z19.array(
   z19.object({
     tool_key: nonEmptyStringSchema,
@@ -14909,10 +15018,33 @@ var AUTOMATION_SELECTION = `{
   aiTaskConfig
   organizationId
   memberId
+  agentId
   createdAt
   updatedAt
   updateVersion
 }`;
+var AUTOMATION_RUN_SELECTION = `{
+  id
+  type
+  attributes {
+    id
+    title
+    status
+    errorMessage
+    usedAt
+    agentTriggerId
+    executionId
+    executionSlug
+    traceId
+    outputContentId
+    outputContentSlug
+    outputContent {
+      id
+      slug
+    }
+    targetId
+  }
+}`;
 function asRecord7(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -15020,12 +15152,92 @@ function normalizePersistedUpdatePayload(payload) {
     persisted: { id, slug, update_version: updateVersion }
   };
 }
+function normalizeAutomationRunPayload(payload) {
+  const mutation = asRecord7(payload);
+  if (!mutation) {
+    throw new CliError({
+      message: "Automation run response did not include a mutation payload.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  if (mutation.ok !== true) {
+    return {
+      ok: mutation.ok,
+      status: mutation.status,
+      errorCode: mutation.errorCode ?? null,
+      errors: mutation.errors ?? null,
+      data: mutation.data ?? null
+    };
+  }
+  const data = asRecord7(mutation.data);
+  const automationTaskId = asRequiredString(data?.automation_task_id);
+  const automationTaskSlug = asRequiredString(data?.automation_task_slug);
+  const agentId = asRequiredString(data?.agent_id);
+  const agentSlug = asRequiredString(data?.agent_slug);
+  const agentTriggerId = asRequiredString(data?.agent_trigger_id);
+  const executionId = asRequiredString(data?.execution_id);
+  const executionSlug = asRequiredString(data?.execution_slug);
+  const executionStatus = asRequiredString(data?.execution_status);
+  const traceId = asRequiredString(data?.trace_id);
+  if (!data || !automationTaskId || !automationTaskSlug || !agentId || !agentSlug || !agentTriggerId || !executionId || !executionSlug || !executionStatus || !traceId) {
+    throw new CliError({
+      message: "Automation run response did not include automation, execution, and trace evidence.",
+      kind: "malformed_response",
+      status: 502,
+      exitCode: EXIT_CODES.networkOrUpstream
+    });
+  }
+  return {
+    ok: mutation.ok,
+    status: mutation.status,
+    errorCode: mutation.errorCode ?? null,
+    errors: mutation.errors ?? null,
+    run: {
+      executed: data.executed === true,
+      skipped_reason: asRequiredString(data.skipped_reason),
+      automation: {
+        id: automationTaskId,
+        slug: automationTaskSlug
+      },
+      agent: {
+        id: agentId,
+        slug: agentSlug
+      },
+      trigger: {
+        id: agentTriggerId,
+        type: asRequiredString(data.trigger_type)
+      },
+      execution: {
+        id: executionId,
+        slug: executionSlug,
+        status: executionStatus
+      },
+      output_content: {
+        id: asRequiredString(data.output_content_id),
+        slug: asRequiredString(data.output_content_slug)
+      },
+      trace_id: traceId,
+      correlation_id: asRequiredString(data.correlation_id),
+      readback_command: `wave automations run-show --agent-id ${agentSlug} --execution-slug ${executionSlug}`
+    }
+  };
+}
 function parseAutomationConfig(value) {
   return automationConfigSchema.parse(parseJson(String(value), "--ai-task-config"));
 }
 function parseExpectedUpdateVersion(value) {
   return nonEmptyStringSchema.parse(String(value));
 }
+function withAutomationRunTimeout(runtimeOptions) {
+  const configuredTimeoutMs = Number(runtimeOptions.timeoutMs);
+  const timeoutMs = Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > AUTOMATION_RUN_HTTP_TIMEOUT_MS ? configuredTimeoutMs : AUTOMATION_RUN_HTTP_TIMEOUT_MS;
+  return {
+    ...runtimeOptions,
+    timeoutMs
+  };
+}
 function registerAtlasAuthoringCommands(program) {
   const agents = program.command("agents").description("Bounded Agent authoring operations");
   agents.command("create").description("Create an Agent through the API-owned createAgent contract").requiredOption("--idempotency-key <key>", "Required create idempotency key").option("--name <name>").option("--description <description>").option("--notes <notes>").option("--member-id <memberId>").option("--status <status>").option("--visibility <visibility>").option("--model <model>").option("--run-when-mentioned <boolean>", "true or false").option("--web-access-enabled <boolean>", "true or false").option("--web-fetch-enabled <boolean>", "true or false").option("--search-past-conversations-enabled <boolean>", "true or false").option("--app-rules-creation-enabled <boolean>", "true or false").option("--tool-discovery-enabled <boolean>", "true or false").option("--self-updates-enabled <boolean>", "true or false").option("--trusted-urls <urls>", "Comma-separated trusted URLs").option("--tool-access <json>", "JSON array of canonical native Agent tool scopes").option(
@@ -15258,7 +15470,7 @@ function registerAtlasAuthoringCommands(program) {
           ...opts.description !== void 0 ? { description: String(opts.description) } : {},
           ...opts.notes !== void 0 ? { notes: String(opts.notes) } : {},
           ...opts.memberId !== void 0 ? { member_id: idSchema14.parse(opts.memberId) } : {},
-          ...opts.agentId !== void 0 ? { agentId: idSchema14.parse(opts.agentId) } : {},
+          ...opts.agentId !== void 0 ? { agent_id: idSchema14.parse(opts.agentId) } : {},
           ...opts.priority !== void 0 ? { priority: String(opts.priority) } : {},
           ...opts.dueDate !== void 0 ? { due_date: isoDateSchema.parse(opts.dueDate) } : {}
         },
@@ -15282,6 +15494,44 @@ function registerAtlasAuthoringCommands(program) {
       isShow: true
     });
   });
+  automations.command("run").description("Run one scheduled Automation by id or slug and return execution trace evidence").requiredOption("--id <idOrSlug>", "Automation id or slug").action(async (opts, cmd) => {
+    const automationId = idSchema14.parse(opts.id);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlMutationCommand({
+      command: "automations.run",
+      operationName: "AutomationsRunNow",
+      runtimeOptions: withAutomationRunTimeout(context.runtimeOptions),
+      field: "run_automation_now",
+      variableTypes: { organization_id: "ID!", automation_id: "ID!" },
+      variables: { organization_id: organizationId, automation_id: automationId },
+      transformMutationPayload: normalizeAutomationRunPayload
+    });
+  });
+  automations.command("run-show").description("Read one Automation run artifact by Agent id and execution slug").requiredOption("--agent-id <agentIdOrSlug>", "Agent id or slug").requiredOption("--execution-slug <executionSlug>", "Execution slug returned by automations run").action(async (opts, cmd) => {
+    const agentId = idSchema14.parse(opts.agentId);
+    const executionSlug = idSchema14.parse(opts.executionSlug);
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "automations.run-show",
+      operationName: "AutomationsRunShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "agent_automation_run",
+      variables: {
+        organization_id: organizationId,
+        agent_id: agentId,
+        automation_id: executionSlug
+      },
+      variableTypes: {
+        organization_id: "ID!",
+        agent_id: "ID!",
+        automation_id: "ID!"
+      },
+      selectionSet: AUTOMATION_RUN_SELECTION,
+      isShow: true
+    });
+  });
   automations.command("update").description("Update one task-backed Automation without changing its system-managed status").requiredOption("--id <idOrSlug>", "Automation id or slug").requiredOption(
     "--expected-update-version <version>",
     "Exact opaque updateVersion value from automations show; rejects stale writes"
@@ -15423,7 +15673,7 @@ import { join as join3 } from "path";
 import { createHash } from "crypto";
 
 // src/version.ts
-var CLI_VERSION = "0.1.73";
+var CLI_VERSION = "0.1.74";
 
 // src/operationMetadata.ts
 var DISCOVERY_OPERATION_IDS = [
@@ -15545,6 +15795,7 @@ var READ_OPERATION_IDS = [
   "agents.plugin-catalog",
   "agents.show",
   "auth.status",
+  "automations.run-show",
   "automations.show",
   "broadcast.community",
   "broadcast.list",
@@ -15619,6 +15870,7 @@ var READ_OPERATION_IDS = [
   "members.show",
   "milestones.list",
   "milestones.search",
+  "milestones.show",
   "news.list",
   "news.search",
   "news.show",
@@ -15689,12 +15941,16 @@ var READ_OPERATION_IDS = [
   "stand-ups.show",
   "subissues.list",
   "subissues.search",
+  "subissues.show",
   "subitems.list",
   "subitems.search",
+  "subitems.show",
   "subtasks.list",
   "subtasks.search",
+  "subtasks.show",
   "subtodos.list",
   "subtodos.search",
+  "subtodos.show",
   "support.counts",
   "support.inbox",
   "support.knowledge-articles",
@@ -15738,6 +15994,7 @@ var WRITE_OPERATION_IDS = [
   "agents.create",
   "agents.update",
   "automations.create",
+  "automations.run",
   "automations.update",
   "contacts.create",
   "contacts.update",
@@ -16248,6 +16505,8 @@ var NAMESPACE_DOCS = {
     examples: [
       `wave automations create --summary "Weekly review" --agent-id 123 --ai-task-config '{"cycle":"repeat","repeatSchedule":{"interval":1,"frequency":"week","weekdays":[1,3],"at":"2:30 PM","starting":"2026-07-20T00:00:00.000Z","ending":"never","endingRuns":1,"endingDate":null,"timezone":"America/Phoenix"}}' --idempotency-key automation-create-001`,
       "wave automations show --id ATK-01",
+      "wave automations run --id ATK-01",
+      "wave automations run-show --agent-id AGT-01 --execution-slug ART-1234567890",
       'wave automations update --id ATK-01 --expected-update-version 2026-07-17T12:00:00.123456Z --summary "Weekly project review"'
     ],
     schema: {
@@ -16259,10 +16518,11 @@ var NAMESPACE_DOCS = {
         "Only the API-defined ai_task_config field accepts validated JSON.",
         "Optional executor Agent linkage is sent only through the API-defined top-level agentId input.",
         "Update calls only updateTask with an exact opaque updateVersion token; it cannot change status, task type, ownership, or project linkage.",
-        "Does not create a project Task, run an Automation, or invoke AI OS actions.",
+        "Run calls only runAutomationNow for an existing scheduled Automation and returns execution/trace evidence.",
+        "Run-show reads the persisted Automation run artifact through agentAutomationRun by Agent id and execution slug.",
         "Show uses the API-owned automation query by id; no slug fallback is implemented."
       ],
-      commands: ["create", "show", "update"]
+      commands: ["create", "show", "run", "run-show", "update"]
     }
   },
   broadcast: {
@@ -16742,10 +17002,14 @@ async function resolveDoctorAuthOrganization(params) {
     }
     const id = organization.id;
     const slug = organization.slug;
-    return {
-      id: typeof id === "string" && id.trim() !== "" ? id : void 0,
-      slug: typeof slug === "string" && slug.trim() !== "" ? slug : void 0
-    };
+    const result = {};
+    if (typeof id === "string" && id.trim() !== "") {
+      result.id = id;
+    }
+    if (typeof slug === "string" && slug.trim() !== "") {
+      result.slug = slug;
+    }
+    return result;
   } catch {
     return null;
   }
@@ -16758,7 +17022,14 @@ async function runDoctor(cmd, opts) {
   const tokenSource = runtime.tokenSource ?? "none";
   const organizationId = context.organizationId;
   const authStorage = await getAuthStorageInfo(baseUrl);
-  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization({ baseUrl, token });
+  const authOptions = {};
+  if (baseUrl) {
+    authOptions.baseUrl = baseUrl;
+  }
+  if (token) {
+    authOptions.token = token;
+  }
+  const authOrganization = organizationId ? null : await resolveDoctorAuthOrganization(authOptions);
   const checks = [
     {
       name: "auth_token",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wave-ai-os/wave-cli",
-  "version": "0.1.73",
+  "version": "0.1.75",
   "type": "module",
   "bin": {
     "wave": "dist/index.js"