@ted-galago/wave-cli 0.1.4 → 0.1.5

package/README.md

@@ -84,7 +84,25 @@ wave lists create --data-json '{"name":"Weekly List"}'
 wave list-items create --data-json '{"list_id":"123","summary":"Follow up"}'
 wave todos create --data-json '{"todo_group_id":"55","name":"Send update"}'
 wave knowledge create --data-json '{"title":"Runbook","content":"..."}'
+wave notes create-member --target-member-id 67 --name "1:1 Note" --body "Strong progress"
+wave notes create-manager --actor-member-id 67 --target-member-id 68 --name "Manager Note" --body "Coaching plan"
+wave notes create-team --actor-member-id 67 --team-id 9 --name "Team Note" --body "Team context"
+wave notes create-project --actor-member-id 67 --project-id 80 --name "Project Note" --body "Project context"
+wave notes create-customer --actor-member-id 67 --customer-id 30 --name "Customer Note" --body "Customer context"
+wave notes create-contact --actor-member-id 67 --contact-id 31 --name "Contact Note" --body "Contact context"
+wave notes list --contentable-type Member --contentable-id 67 --member-id 67 --page 1 --per 20
+wave notes show --id 1001
+wave notes update --id 1001 --name "Updated Note" --body "Updated body" --status published
+wave notes destroy --id 1001
 wave pulse update --id 12 --data-json '{"status":"on_track"}'
+wave subtasks list --task-id 123 --page 1 --per 20
+wave milestones list --rock-id 234 --page 1 --per 20
+wave subitems list --list-item-id 345 --page 1 --per 20
+wave subtodos list --todo-id 456 --page 1 --per 20
+wave subissues list --issue-id 567 --page 1 --per 20
+wave talking-points list --meeting-id 678 --page 1 --per 20
+wave subtasks create --data-json '{"subtask":{"task_id":"123","member_id":"67","name":"Subtask name","description":"Subtask description"}}'
+wave subissues destroy --id 999
 ```
 
 All commands require organization context via `--organization-id` or `WAVE_ORGANIZATION_ID`.
@@ -99,9 +117,56 @@ These child resources enforce parent IDs at CLI validation time:
 - `todos.create` requires `todo_group_id`
 - `rocks.create` requires `rock_collection_id`
 - `scorecards.create` requires `measurable_group_id`
+- `subtasks.create` requires `task_id`
+- `milestones.create` requires `rock_id`
+- `subitems.create` requires `list_item_id`
+- `subtodos.create` requires `todo_id`
+- `subissues.create` requires `issue_id`
+- `talking-points.create` requires `meeting_id`
 
 If a required parent field is missing, CLI returns JSON error with exit code `2`.
 
+## Notes Contract
+
+The `notes` command uses exact GraphQL operation names:
+
+- `CreateContent`
+- `UpdateContent`
+- `DestroyContent`
+- `ContentShow`
+- `ContentsIndex`
+
+Placement rules enforced by command shape:
+
+- `notes create-member`
+  - `contentable_type: "Member"`
+  - `contentable_id: TARGET_MEMBER_ID`
+  - `member_id: TARGET_MEMBER_ID`
+  - `focus_member_id: null`
+  - `focus_team_id: null`
+- `notes create-manager`
+  - `contentable_type: "Member"`
+  - `contentable_id: ACTOR_MEMBER_ID`
+  - `member_id: ACTOR_MEMBER_ID`
+  - `focus_member_id: TARGET_MEMBER_ID`
+- `notes create-team`
+  - `contentable_type: "Team"`
+  - `contentable_id: TEAM_ID`
+  - `member_id: ACTOR_MEMBER_ID`
+  - `focus_team_id: TEAM_ID`
+- `notes create-project`
+  - `contentable_type: "Project"`
+  - `contentable_id: PROJECT_ID`
+  - `member_id: ACTOR_MEMBER_ID`
+- `notes create-customer`
+  - `contentable_type: "Customer"`
+  - `contentable_id: CUSTOMER_ID`
+  - `member_id: ACTOR_MEMBER_ID`
+- `notes create-contact`
+  - `contentable_type: "Contact"`
+  - `contentable_id: CONTACT_ID`
+  - `member_id: ACTOR_MEMBER_ID`
+
 ## JSON Envelope
 
 Success:

package/dist/index.cjs

@@ -3,7 +3,7 @@
 
 // src/index.ts
 var import_commander2 = require("commander");
-var import_zod12 = require("zod");
+var import_zod14 = require("zod");
 
 // src/cli.ts
 var import_commander = require("commander");
@@ -252,7 +252,7 @@ function normalizeGraphqlVariables(variables) {
 function buildGraphqlBody(input) {
   const graphqlField = toCamelCase(input.field);
   const graphqlVariables = normalizeGraphqlVariables(input.variables);
-  const operationName = graphqlOperationName(input.command);
+  const operationName = input.operationName ?? graphqlOperationName(input.command);
   const variableEntries = Object.entries(graphqlVariables).filter(([, value]) => value !== void 0);
   const variableDecl = variableEntries.map(([name, value]) => `$${name}: ${withNonNull(graphqlTypeForVariable(name, value))}`).join(", ");
   const fieldArgs = variableEntries.map(([name]) => `${name}: $${name}`).join(", ");
@@ -490,12 +490,21 @@ async function runGraphqlQueryCommand(input) {
     const result = await graphqlRequest({
       config,
       command: input.command,
+      operationName: input.operationName,
       operationType: "query",
       field: input.field,
       variables: input.variables ?? {},
       selectionSet: input.selectionSet ?? defaultQuerySelectionSet(input.field, Boolean(input.isList)),
       isShow: input.isShow
     });
+    if (result.envelope.ok && input.transformData && result.envelope.data) {
+      const dataRecord = result.envelope.data;
+      const transformed = input.transformData(dataRecord[input.field]);
+      result.envelope.data = {
+        ...dataRecord,
+        [input.field]: transformed
+      };
+    }
     printEnvelopeAndExit(result);
   } catch (error) {
     if (error instanceof CliError) {
@@ -528,6 +537,7 @@ async function runGraphqlMutationCommand(input) {
     const result = await graphqlRequest({
       config,
       command: input.command,
+      operationName: input.operationName,
       operationType: "mutation",
       field: input.field,
       variables: input.variables ?? {},
@@ -2541,6 +2551,480 @@ function registerFoundationCommands(program) {
   });
 }
 
+// src/commands/childEntities.ts
+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());
+function parseJsonObject2(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    return jsonObjectSchema.parse(parsed);
+  } catch (error) {
+    throw new CliError({
+      message: error instanceof Error ? `Invalid --data-json: ${error.message}` : "Invalid --data-json.",
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+function normalizeBody2(raw, rootKey) {
+  const payload = parseJsonObject2(raw);
+  const rooted = payload[rootKey];
+  if (rooted && typeof rooted === "object" && !Array.isArray(rooted)) {
+    return payload;
+  }
+  return { [rootKey]: payload };
+}
+function assertRequiredParent(body, rootKey, parentKey) {
+  const entity = body[rootKey];
+  if (!entity || typeof entity !== "object" || Array.isArray(entity)) {
+    throw new CliError({
+      message: `Invalid payload. Expected object at "${rootKey}".`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  const value = entity[parentKey];
+  if (!(typeof value === "string" && value.trim().length > 0)) {
+    throw new CliError({
+      message: `Missing required create field for ${rootKey}: ${parentKey}.`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+function attrValue(attrs, keys) {
+  if (!attrs || typeof attrs !== "object" || Array.isArray(attrs)) {
+    return void 0;
+  }
+  const record = attrs;
+  for (const key of keys) {
+    if (record[key] !== void 0 && record[key] !== null && `${record[key]}`.trim() !== "") {
+      return record[key];
+    }
+  }
+  return void 0;
+}
+function normalizePlacementRow(row, parentKind, parentIdFallback, parentTypedField) {
+  const typedParent = parentTypedField ? row[parentTypedField] : void 0;
+  const parentId = (typeof typedParent === "string" && typedParent.trim().length > 0 ? typedParent : void 0) ?? parentIdFallback ?? null;
+  const attrs = row.attributes;
+  const memberId = (typeof row.memberId === "string" ? row.memberId : void 0) ?? attrValue(attrs, ["memberId", "member_id"]) ?? null;
+  const creatorId = (typeof row.creatorId === "string" ? row.creatorId : void 0) ?? attrValue(attrs, ["creatorId", "creator_id"]) ?? null;
+  const ownerRaw = attrValue(attrs, ["memberId", "member_id", "creatorId", "creator_id"]) ?? null;
+  const description = (typeof row.description === "string" && row.description.length > 0 ? row.description : attrValue(attrs, ["description"])) ?? null;
+  return {
+    id: row.id ?? null,
+    type: row.type ?? null,
+    parent: {
+      kind: parentKind,
+      id: parentId
+    },
+    owner: {
+      memberId,
+      creatorId,
+      raw: ownerRaw
+    },
+    description,
+    attributes: attrs ?? {}
+  };
+}
+function normalizeListPayload(payload, parentKind, parentIdFallback, parentTypedField) {
+  const record = payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  const rows = Array.isArray(record.data) ? record.data : [];
+  const normalizedRows = rows.map(
+    (row) => normalizePlacementRow(
+      row,
+      parentKind,
+      parentIdFallback,
+      parentTypedField
+    )
+  );
+  return {
+    data: normalizedRows,
+    count: record.count ?? normalizedRows.length,
+    currentPage: record.currentPage ?? 1,
+    totalPages: record.totalPages ?? 1
+  };
+}
+function registerChildCommands(program, config) {
+  const command = program.command(config.command).description(config.description);
+  command.command("list").requiredOption(`--${config.parentFlag} <${config.parentFlag}>`).option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const parentId = idSchema11.parse(opts[config.parentFlag.replace(/-([a-z])/g, (_, c) => c.toUpperCase())]);
+    await runGraphqlQueryCommand({
+      command: `${config.command}.list`,
+      operationName: config.listOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.listField,
+      variables: {
+        organization_id: organizationId,
+        [config.parentFlag.replace(/-/g, "_")]: parentId,
+        page: opts.page,
+        per: opts.per
+      },
+      isList: true,
+      selectionSet: config.listSelectionSet,
+      transformData: (payload) => normalizeListPayload(
+        payload,
+        config.parentKind,
+        parentId,
+        config.listParentTypedField
+      )
+    });
+  });
+  command.command("create").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const body = normalizeBody2(String(opts.dataJson), config.rootKey);
+    assertRequiredParent(body, config.rootKey, config.parentFlag.replace(/-/g, "_"));
+    await runGraphqlMutationCommand({
+      command: `${config.command}.create`,
+      operationName: config.createOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.createField,
+      variables: {
+        organization_id: organizationId,
+        params: body
+      }
+    });
+  });
+  command.command("update").requiredOption("--id <id>").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const id = idSchema11.parse(opts.id);
+    const body = normalizeBody2(String(opts.dataJson), config.rootKey);
+    await runGraphqlMutationCommand({
+      command: `${config.command}.update`,
+      operationName: config.updateOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.updateField,
+      variables: {
+        organization_id: organizationId,
+        [config.idVariable]: id,
+        params: body
+      }
+    });
+  });
+  command.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const id = idSchema11.parse(opts.id);
+    await runGraphqlMutationCommand({
+      command: `${config.command}.destroy`,
+      operationName: config.destroyOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.destroyField,
+      variables: {
+        organization_id: organizationId,
+        [config.idVariable]: id
+      }
+    });
+  });
+}
+function registerChildEntityCommands(program) {
+  registerChildCommands(program, {
+    command: "subtasks",
+    description: "Subtask operations",
+    parentFlag: "task-id",
+    parentKind: "task",
+    rootKey: "subtask",
+    listField: "subtasks",
+    createField: "create_subtask",
+    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 }",
+    listParentTypedField: "taskId"
+  });
+  registerChildCommands(program, {
+    command: "milestones",
+    description: "Milestone operations",
+    parentFlag: "rock-id",
+    parentKind: "rock",
+    rootKey: "milestone",
+    listField: "milestones",
+    createField: "create_milestone",
+    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 }"
+  });
+  registerChildCommands(program, {
+    command: "subitems",
+    description: "Subitem operations",
+    parentFlag: "list-item-id",
+    parentKind: "listItem",
+    rootKey: "subitem",
+    listField: "subitems",
+    createField: "create_subitem",
+    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 }",
+    listParentTypedField: "listItemId"
+  });
+  registerChildCommands(program, {
+    command: "subtodos",
+    description: "Subtodo operations",
+    parentFlag: "todo-id",
+    parentKind: "todo",
+    rootKey: "sub_todo",
+    listField: "sub_todos",
+    createField: "create_sub_todo",
+    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 }",
+    listParentTypedField: "todoId"
+  });
+  registerChildCommands(program, {
+    command: "subissues",
+    description: "Subissue operations",
+    parentFlag: "issue-id",
+    parentKind: "issue",
+    rootKey: "sub_issue",
+    listField: "sub_issues",
+    createField: "create_sub_issue",
+    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 }",
+    listParentTypedField: "issueId"
+  });
+  registerChildCommands(program, {
+    command: "talking-points",
+    description: "Talking point operations",
+    parentFlag: "meeting-id",
+    parentKind: "meeting",
+    rootKey: "talking_point",
+    listField: "talking_points",
+    createField: "create_talking_point",
+    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 }",
+    listParentTypedField: "meetingId"
+  });
+}
+
+// src/commands/notes.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.",
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+async function createContent(command, cmd, payload) {
+  const context = await resolveCommandContext(cmd.optsWithGlobals());
+  const organizationId = resolveOrganizationId(context.organizationId);
+  return runGraphqlMutationCommand({
+    command,
+    operationName: "CreateContent",
+    runtimeOptions: context.runtimeOptions,
+    field: "create_content",
+    variables: normalizeGraphqlVariables2({
+      organization_id: organizationId,
+      params: {
+        content: 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) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "notes.list",
+      operationName: "ContentsIndex",
+      runtimeOptions: context.runtimeOptions,
+      field: "contents",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        contentable_type: opts.contentableType,
+        contentable_id: opts.contentableId,
+        member_id: opts.memberId,
+        focus_member_id: opts.focusMemberId,
+        focus_team_id: opts.focusTeamId,
+        page: opts.page,
+        per: opts.per
+      }),
+      isList: true,
+      selectionSet: "{ count currentPage totalPages data { id type name contentableType contentableId memberId focusMemberId focusTeamId attributes } }"
+    });
+  });
+  notes.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",
+      operationName: "ContentShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        id
+      }),
+      isShow: true,
+      selectionSet: "{ id type name contentableType contentableId memberId focusMemberId focusTeamId attributes }"
+    });
+  });
+  notes.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,
+      status: opts.status
+    });
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const contentId = idSchema12.parse(opts.id);
+    await runGraphqlMutationCommand({
+      command: "notes.update",
+      operationName: "UpdateContent",
+      runtimeOptions: context.runtimeOptions,
+      field: "update_content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        content_id: contentId,
+        params: {
+          content: normalizeGraphqlVariables2({
+            name: opts.name,
+            content: opts.body,
+            status: opts.status
+          })
+        }
+      })
+    });
+  });
+  notes.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",
+      operationName: "DestroyContent",
+      runtimeOptions: context.runtimeOptions,
+      field: "destroy_content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        content_id: contentId
+      })
+    });
+  });
+  notes.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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Member",
+      contentable_id: targetMemberId,
+      member_id: targetMemberId,
+      focus_member_id: null,
+      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) => {
+    const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
+    await createContent("notes.create-manager", cmd, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Member",
+      contentable_id: actorMemberId,
+      member_id: actorMemberId,
+      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) => {
+    const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
+    const teamId = nonEmptyString.parse(opts.teamId);
+    await createContent("notes.create-team", cmd, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Team",
+      contentable_id: teamId,
+      member_id: actorMemberId,
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Project",
+      contentable_id: nonEmptyString.parse(opts.projectId),
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Customer",
+      contentable_id: nonEmptyString.parse(opts.customerId),
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Contact",
+      contentable_id: nonEmptyString.parse(opts.contactId),
+      member_id: nonEmptyString.parse(opts.actorMemberId)
+    });
+  });
+}
+
 // src/cli.ts
 function buildCli() {
   const program = new import_commander.Command();
@@ -2573,6 +3057,8 @@ function buildCli() {
   registerIssueCommands(program);
   registerSystemToolCommands(program);
   registerFoundationCommands(program);
+  registerChildEntityCommands(program);
+  registerNoteCommands(program);
   return program;
 }
 
@@ -2621,13 +3107,13 @@ main().catch((error) => {
       exitCode: EXIT_CODES.invalidArgs
     });
   }
-  if (error instanceof import_zod12.ZodError || error instanceof import_commander2.InvalidArgumentError) {
+  if (error instanceof import_zod14.ZodError || error instanceof import_commander2.InvalidArgumentError) {
     printCliFailure({
       status: 400,
       code: "invalid_args",
       message: "Invalid command arguments.",
       details: {
-        issues: error instanceof import_zod12.ZodError ? error.issues : [{ message: error.message, code: "invalid_argument" }]
+        issues: error instanceof import_zod14.ZodError ? error.issues : [{ message: error.message, code: "invalid_argument" }]
       },
       exitCode: EXIT_CODES.invalidArgs
     });

package/dist/index.js

@@ -251,7 +251,7 @@ function normalizeGraphqlVariables(variables) {
 function buildGraphqlBody(input) {
   const graphqlField = toCamelCase(input.field);
   const graphqlVariables = normalizeGraphqlVariables(input.variables);
-  const operationName = graphqlOperationName(input.command);
+  const operationName = input.operationName ?? graphqlOperationName(input.command);
   const variableEntries = Object.entries(graphqlVariables).filter(([, value]) => value !== void 0);
   const variableDecl = variableEntries.map(([name, value]) => `$${name}: ${withNonNull(graphqlTypeForVariable(name, value))}`).join(", ");
   const fieldArgs = variableEntries.map(([name]) => `${name}: $${name}`).join(", ");
@@ -489,12 +489,21 @@ async function runGraphqlQueryCommand(input) {
     const result = await graphqlRequest({
       config,
       command: input.command,
+      operationName: input.operationName,
       operationType: "query",
       field: input.field,
       variables: input.variables ?? {},
       selectionSet: input.selectionSet ?? defaultQuerySelectionSet(input.field, Boolean(input.isList)),
       isShow: input.isShow
     });
+    if (result.envelope.ok && input.transformData && result.envelope.data) {
+      const dataRecord = result.envelope.data;
+      const transformed = input.transformData(dataRecord[input.field]);
+      result.envelope.data = {
+        ...dataRecord,
+        [input.field]: transformed
+      };
+    }
     printEnvelopeAndExit(result);
   } catch (error) {
     if (error instanceof CliError) {
@@ -527,6 +536,7 @@ async function runGraphqlMutationCommand(input) {
     const result = await graphqlRequest({
       config,
       command: input.command,
+      operationName: input.operationName,
       operationType: "mutation",
       field: input.field,
       variables: input.variables ?? {},
@@ -2540,6 +2550,480 @@ function registerFoundationCommands(program) {
   });
 }
 
+// src/commands/childEntities.ts
+import { z as z12 } from "zod";
+var idSchema11 = z12.string().min(1);
+var jsonObjectSchema = z12.record(z12.string(), z12.unknown());
+function parseJsonObject2(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    return jsonObjectSchema.parse(parsed);
+  } catch (error) {
+    throw new CliError({
+      message: error instanceof Error ? `Invalid --data-json: ${error.message}` : "Invalid --data-json.",
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+function normalizeBody2(raw, rootKey) {
+  const payload = parseJsonObject2(raw);
+  const rooted = payload[rootKey];
+  if (rooted && typeof rooted === "object" && !Array.isArray(rooted)) {
+    return payload;
+  }
+  return { [rootKey]: payload };
+}
+function assertRequiredParent(body, rootKey, parentKey) {
+  const entity = body[rootKey];
+  if (!entity || typeof entity !== "object" || Array.isArray(entity)) {
+    throw new CliError({
+      message: `Invalid payload. Expected object at "${rootKey}".`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+  const value = entity[parentKey];
+  if (!(typeof value === "string" && value.trim().length > 0)) {
+    throw new CliError({
+      message: `Missing required create field for ${rootKey}: ${parentKey}.`,
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+function attrValue(attrs, keys) {
+  if (!attrs || typeof attrs !== "object" || Array.isArray(attrs)) {
+    return void 0;
+  }
+  const record = attrs;
+  for (const key of keys) {
+    if (record[key] !== void 0 && record[key] !== null && `${record[key]}`.trim() !== "") {
+      return record[key];
+    }
+  }
+  return void 0;
+}
+function normalizePlacementRow(row, parentKind, parentIdFallback, parentTypedField) {
+  const typedParent = parentTypedField ? row[parentTypedField] : void 0;
+  const parentId = (typeof typedParent === "string" && typedParent.trim().length > 0 ? typedParent : void 0) ?? parentIdFallback ?? null;
+  const attrs = row.attributes;
+  const memberId = (typeof row.memberId === "string" ? row.memberId : void 0) ?? attrValue(attrs, ["memberId", "member_id"]) ?? null;
+  const creatorId = (typeof row.creatorId === "string" ? row.creatorId : void 0) ?? attrValue(attrs, ["creatorId", "creator_id"]) ?? null;
+  const ownerRaw = attrValue(attrs, ["memberId", "member_id", "creatorId", "creator_id"]) ?? null;
+  const description = (typeof row.description === "string" && row.description.length > 0 ? row.description : attrValue(attrs, ["description"])) ?? null;
+  return {
+    id: row.id ?? null,
+    type: row.type ?? null,
+    parent: {
+      kind: parentKind,
+      id: parentId
+    },
+    owner: {
+      memberId,
+      creatorId,
+      raw: ownerRaw
+    },
+    description,
+    attributes: attrs ?? {}
+  };
+}
+function normalizeListPayload(payload, parentKind, parentIdFallback, parentTypedField) {
+  const record = payload && typeof payload === "object" && !Array.isArray(payload) ? payload : {};
+  const rows = Array.isArray(record.data) ? record.data : [];
+  const normalizedRows = rows.map(
+    (row) => normalizePlacementRow(
+      row,
+      parentKind,
+      parentIdFallback,
+      parentTypedField
+    )
+  );
+  return {
+    data: normalizedRows,
+    count: record.count ?? normalizedRows.length,
+    currentPage: record.currentPage ?? 1,
+    totalPages: record.totalPages ?? 1
+  };
+}
+function registerChildCommands(program, config) {
+  const command = program.command(config.command).description(config.description);
+  command.command("list").requiredOption(`--${config.parentFlag} <${config.parentFlag}>`).option("--page <page>").option("--per <per>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const parentId = idSchema11.parse(opts[config.parentFlag.replace(/-([a-z])/g, (_, c) => c.toUpperCase())]);
+    await runGraphqlQueryCommand({
+      command: `${config.command}.list`,
+      operationName: config.listOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.listField,
+      variables: {
+        organization_id: organizationId,
+        [config.parentFlag.replace(/-/g, "_")]: parentId,
+        page: opts.page,
+        per: opts.per
+      },
+      isList: true,
+      selectionSet: config.listSelectionSet,
+      transformData: (payload) => normalizeListPayload(
+        payload,
+        config.parentKind,
+        parentId,
+        config.listParentTypedField
+      )
+    });
+  });
+  command.command("create").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const body = normalizeBody2(String(opts.dataJson), config.rootKey);
+    assertRequiredParent(body, config.rootKey, config.parentFlag.replace(/-/g, "_"));
+    await runGraphqlMutationCommand({
+      command: `${config.command}.create`,
+      operationName: config.createOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.createField,
+      variables: {
+        organization_id: organizationId,
+        params: body
+      }
+    });
+  });
+  command.command("update").requiredOption("--id <id>").requiredOption("--data-json <dataJson>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const id = idSchema11.parse(opts.id);
+    const body = normalizeBody2(String(opts.dataJson), config.rootKey);
+    await runGraphqlMutationCommand({
+      command: `${config.command}.update`,
+      operationName: config.updateOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.updateField,
+      variables: {
+        organization_id: organizationId,
+        [config.idVariable]: id,
+        params: body
+      }
+    });
+  });
+  command.command("destroy").requiredOption("--id <id>").action(async (opts, cmd) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const id = idSchema11.parse(opts.id);
+    await runGraphqlMutationCommand({
+      command: `${config.command}.destroy`,
+      operationName: config.destroyOperationName,
+      runtimeOptions: context.runtimeOptions,
+      field: config.destroyField,
+      variables: {
+        organization_id: organizationId,
+        [config.idVariable]: id
+      }
+    });
+  });
+}
+function registerChildEntityCommands(program) {
+  registerChildCommands(program, {
+    command: "subtasks",
+    description: "Subtask operations",
+    parentFlag: "task-id",
+    parentKind: "task",
+    rootKey: "subtask",
+    listField: "subtasks",
+    createField: "create_subtask",
+    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 }",
+    listParentTypedField: "taskId"
+  });
+  registerChildCommands(program, {
+    command: "milestones",
+    description: "Milestone operations",
+    parentFlag: "rock-id",
+    parentKind: "rock",
+    rootKey: "milestone",
+    listField: "milestones",
+    createField: "create_milestone",
+    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 }"
+  });
+  registerChildCommands(program, {
+    command: "subitems",
+    description: "Subitem operations",
+    parentFlag: "list-item-id",
+    parentKind: "listItem",
+    rootKey: "subitem",
+    listField: "subitems",
+    createField: "create_subitem",
+    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 }",
+    listParentTypedField: "listItemId"
+  });
+  registerChildCommands(program, {
+    command: "subtodos",
+    description: "Subtodo operations",
+    parentFlag: "todo-id",
+    parentKind: "todo",
+    rootKey: "sub_todo",
+    listField: "sub_todos",
+    createField: "create_sub_todo",
+    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 }",
+    listParentTypedField: "todoId"
+  });
+  registerChildCommands(program, {
+    command: "subissues",
+    description: "Subissue operations",
+    parentFlag: "issue-id",
+    parentKind: "issue",
+    rootKey: "sub_issue",
+    listField: "sub_issues",
+    createField: "create_sub_issue",
+    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 }",
+    listParentTypedField: "issueId"
+  });
+  registerChildCommands(program, {
+    command: "talking-points",
+    description: "Talking point operations",
+    parentFlag: "meeting-id",
+    parentKind: "meeting",
+    rootKey: "talking_point",
+    listField: "talking_points",
+    createField: "create_talking_point",
+    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 }",
+    listParentTypedField: "meetingId"
+  });
+}
+
+// src/commands/notes.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.",
+      kind: "invalid_args",
+      status: 400,
+      exitCode: EXIT_CODES.invalidArgs
+    });
+  }
+}
+async function createContent(command, cmd, payload) {
+  const context = await resolveCommandContext(cmd.optsWithGlobals());
+  const organizationId = resolveOrganizationId(context.organizationId);
+  return runGraphqlMutationCommand({
+    command,
+    operationName: "CreateContent",
+    runtimeOptions: context.runtimeOptions,
+    field: "create_content",
+    variables: normalizeGraphqlVariables2({
+      organization_id: organizationId,
+      params: {
+        content: 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) => {
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    await runGraphqlQueryCommand({
+      command: "notes.list",
+      operationName: "ContentsIndex",
+      runtimeOptions: context.runtimeOptions,
+      field: "contents",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        contentable_type: opts.contentableType,
+        contentable_id: opts.contentableId,
+        member_id: opts.memberId,
+        focus_member_id: opts.focusMemberId,
+        focus_team_id: opts.focusTeamId,
+        page: opts.page,
+        per: opts.per
+      }),
+      isList: true,
+      selectionSet: "{ count currentPage totalPages data { id type name contentableType contentableId memberId focusMemberId focusTeamId attributes } }"
+    });
+  });
+  notes.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",
+      operationName: "ContentShow",
+      runtimeOptions: context.runtimeOptions,
+      field: "content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        id
+      }),
+      isShow: true,
+      selectionSet: "{ id type name contentableType contentableId memberId focusMemberId focusTeamId attributes }"
+    });
+  });
+  notes.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,
+      status: opts.status
+    });
+    const context = await resolveCommandContext(cmd.optsWithGlobals());
+    const organizationId = resolveOrganizationId(context.organizationId);
+    const contentId = idSchema12.parse(opts.id);
+    await runGraphqlMutationCommand({
+      command: "notes.update",
+      operationName: "UpdateContent",
+      runtimeOptions: context.runtimeOptions,
+      field: "update_content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        content_id: contentId,
+        params: {
+          content: normalizeGraphqlVariables2({
+            name: opts.name,
+            content: opts.body,
+            status: opts.status
+          })
+        }
+      })
+    });
+  });
+  notes.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",
+      operationName: "DestroyContent",
+      runtimeOptions: context.runtimeOptions,
+      field: "destroy_content",
+      variables: normalizeGraphqlVariables2({
+        organization_id: organizationId,
+        content_id: contentId
+      })
+    });
+  });
+  notes.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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Member",
+      contentable_id: targetMemberId,
+      member_id: targetMemberId,
+      focus_member_id: null,
+      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) => {
+    const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
+    await createContent("notes.create-manager", cmd, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Member",
+      contentable_id: actorMemberId,
+      member_id: actorMemberId,
+      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) => {
+    const actorMemberId = nonEmptyString.parse(opts.actorMemberId);
+    const teamId = nonEmptyString.parse(opts.teamId);
+    await createContent("notes.create-team", cmd, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Team",
+      contentable_id: teamId,
+      member_id: actorMemberId,
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Project",
+      contentable_id: nonEmptyString.parse(opts.projectId),
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Customer",
+      contentable_id: nonEmptyString.parse(opts.customerId),
+      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, {
+      type: "WrittenContent",
+      name: nonEmptyString.parse(opts.name),
+      content: nonEmptyString.parse(opts.body),
+      status: String(opts.status ?? "draft"),
+      contentable_type: "Contact",
+      contentable_id: nonEmptyString.parse(opts.contactId),
+      member_id: nonEmptyString.parse(opts.actorMemberId)
+    });
+  });
+}
+
 // src/cli.ts
 function buildCli() {
   const program = new Command();
@@ -2572,6 +3056,8 @@ function buildCli() {
   registerIssueCommands(program);
   registerSystemToolCommands(program);
   registerFoundationCommands(program);
+  registerChildEntityCommands(program);
+  registerNoteCommands(program);
   return program;
 }
 

package/package.json

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