@onmyway133/asc-cli 1.0.2 → 1.0.3

package/src/commands/versions.ts

@@ -1,5 +1,10 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
-import type { AppStoreVersion, Platform } from "../api/types.ts"
+import {
+  appsAppStoreVersionsGetToManyRelated,
+  appStoreVersionsCreateInstance,
+  appStoreVersionReleaseRequestsCreateInstance,
+} from "../api/generated/sdk.gen.ts"
+import type { Platform } from "../api/generated/types.gen.ts"
+import { throwOnError, ascFetch } from "../api/client.ts"
 import { detectFormat, formatDate, printJSON, printSuccess, printTable } from "../utils/output.ts"
 
 export async function versionsList(opts: {
@@ -7,15 +12,15 @@ export async function versionsList(opts: {
   platform?: string
   output?: string
 }): Promise<void> {
-  const params: Record<string, string> = {
-    "fields[appStoreVersions]": "platform,versionString,appStoreState,createdDate",
-  }
-  if (opts.platform) params["filter[platform]"] = opts.platform.toUpperCase()
-
-  const versions = await ascFetchAll<AppStoreVersion>(
-    `/v1/apps/${opts.appId}/appStoreVersions`,
-    { params },
-  )
+  const result = await appsAppStoreVersionsGetToManyRelated({
+    path: { id: opts.appId },
+    query: {
+      "fields[appStoreVersions]": ["platform", "versionString", "appStoreState", "createdDate"],
+      ...(opts.platform ? { "filter[platform]": [opts.platform.toUpperCase() as Platform] } : {}),
+    },
+  })
+  const data = throwOnError(result)
+  const versions = data.data
 
   const fmt = detectFormat(opts.output)
   if (fmt === "json") {
@@ -27,10 +32,10 @@ export async function versionsList(opts: {
     ["ID", "Version", "Platform", "State", "Created"],
     versions.map((v) => [
       v.id,
-      v.attributes.versionString,
-      v.attributes.platform,
-      v.attributes.appStoreState,
-      formatDate(v.attributes.createdDate),
+      v.attributes?.versionString ?? "-",
+      v.attributes?.platform ?? "-",
+      v.attributes?.appStoreState ?? "-",
+      formatDate(v.attributes?.createdDate),
     ]),
     `Versions (${versions.length})`,
   )
@@ -42,8 +47,7 @@ export async function versionsCreate(opts: {
   platform: string
 }): Promise<void> {
   const platform = opts.platform.toUpperCase() as Platform
-  const res = await ascFetch<AppStoreVersion>("/v1/appStoreVersions", {
-    method: "POST",
+  const result = await appStoreVersionsCreateInstance({
     body: {
       data: {
         type: "appStoreVersions",
@@ -57,9 +61,12 @@ export async function versionsCreate(opts: {
       },
     },
   })
-  printSuccess(`Created version ${opts.version} (${platform}) — ID: ${res.data.id}`)
+  const data = throwOnError(result)
+  printSuccess(`Created version ${opts.version} (${platform}) — ID: ${data.data.id}`)
 }
 
+// versionsSubmit uses the deprecated appStoreVersionSubmissions API which has no
+// generated create SDK function (only delete). Keep using ascFetch.
 export async function versionsSubmit(versionId: string): Promise<void> {
   await ascFetch("/v1/appStoreVersionSubmissions", {
     method: "POST",
@@ -74,3 +81,18 @@ export async function versionsSubmit(versionId: string): Promise<void> {
   })
   printSuccess(`Version ${versionId} submitted for review`)
 }
+
+export async function releaseRequestCreate(versionId: string): Promise<void> {
+  const result = await appStoreVersionReleaseRequestsCreateInstance({
+    body: {
+      data: {
+        type: "appStoreVersionReleaseRequests",
+        relationships: {
+          appStoreVersion: { data: { type: "appStoreVersions", id: versionId } },
+        },
+      },
+    },
+  })
+  throwOnError(result)
+  printSuccess(`Release request created for version ${versionId}`)
+}

package/src/commands/xcode-cloud.ts

@@ -1,4 +1,13 @@
-import { ascFetch, ascFetchAll } from "../api/client.ts"
+import {
+  appsCiProductGetToOneRelated,
+  ciProductsGetCollection,
+  ciProductsWorkflowsGetToManyRelated,
+  ciWorkflowsGetInstance,
+  ciWorkflowsBuildRunsGetToManyRelated,
+  ciProductsBuildRunsGetToManyRelated,
+  ciBuildRunsCreateInstance,
+} from "../api/generated/sdk.gen.ts"
+import { throwOnError, ascFetchAll } from "../api/client.ts"
 import { detectFormat, formatDate, printJSON, printSuccess, printTable, truncate } from "../utils/output.ts"
 
 // ---- Xcode Cloud Products ----
@@ -7,22 +16,27 @@ export async function xcodeCloudProductsList(opts: {
   appId?: string
   output?: string
 } = {}): Promise<void> {
-  const url = opts.appId
-    ? `/v1/apps/${opts.appId}/ciProduct`
-    : "/v1/ciProducts"
-  const items = await ascFetchAll<{
-    id: string
-    attributes: { name?: string; createdDate?: string; productType?: string }
-  }>(url)
+  let items: Array<{ id: string; attributes?: { name?: string; createdDate?: string; productType?: string } }>
+
+  if (opts.appId) {
+    const result = await appsCiProductGetToOneRelated({ path: { id: opts.appId } })
+    const data = throwOnError(result)
+    items = [data.data]
+  } else {
+    const result = await ciProductsGetCollection()
+    const data = throwOnError(result)
+    items = data.data
+  }
+
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   printTable(
     ["Product ID", "Name", "Type", "Created"],
     items.map(p => [
       p.id,
-      p.attributes.name ?? "-",
-      p.attributes.productType ?? "-",
-      formatDate(p.attributes.createdDate ?? ""),
+      p.attributes?.name ?? "-",
+      p.attributes?.productType ?? "-",
+      formatDate(p.attributes?.createdDate ?? ""),
     ]),
     `Xcode Cloud Products (${items.length})`,
   )
@@ -34,55 +48,34 @@ export async function workflowsList(opts: {
   productId: string
   output?: string
 }): Promise<void> {
-  const items = await ascFetchAll<{
-    id: string
-    attributes: {
-      name?: string
-      description?: string
-      isEnabled?: boolean
-      isLockedForEditing?: boolean
-      lastModifiedDate?: string
-    }
-  }>(`/v1/ciProducts/${opts.productId}/workflows`)
+  const result = await ciProductsWorkflowsGetToManyRelated({ path: { id: opts.productId } })
+  const data = throwOnError(result)
+  const items = data.data
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   printTable(
     ["Workflow ID", "Name", "Enabled", "Last Modified"],
     items.map(w => [
       w.id,
-      truncate(w.attributes.name ?? "-", 40),
-      String(w.attributes.isEnabled ?? "-"),
-      formatDate(w.attributes.lastModifiedDate ?? ""),
+      truncate(w.attributes?.name ?? "-", 40),
+      String(w.attributes?.isEnabled ?? "-"),
+      formatDate(w.attributes?.lastModifiedDate ?? ""),
     ]),
     `Workflows (${items.length})`,
   )
 }
 
 export async function workflowGet(workflowId: string, opts: { output?: string } = {}): Promise<void> {
-  const result = await ascFetch<{
-    data: {
-      id: string
-      attributes: {
-        name?: string
-        description?: string
-        isEnabled?: boolean
-        isLockedForEditing?: boolean
-        lastModifiedDate?: string
-        branchStartCondition?: unknown
-        pullRequestStartCondition?: unknown
-        scheduledStartCondition?: unknown
-        tagStartCondition?: unknown
-      }
-    }
-  }>(`/v1/ciWorkflows/${workflowId}`)
+  const result = await ciWorkflowsGetInstance({ path: { id: workflowId } })
+  const data = throwOnError(result)
   const fmt = detectFormat(opts.output)
-  if (fmt === "json") { printJSON(result.data.data); return }
-  const a = result.data.data.attributes
-  console.log(`ID:            ${result.data.data.id}`)
-  console.log(`Name:          ${a.name ?? "-"}`)
-  console.log(`Description:   ${a.description ?? "-"}`)
-  console.log(`Enabled:       ${a.isEnabled ?? "-"}`)
-  console.log(`Last Modified: ${formatDate(a.lastModifiedDate ?? "")}`)
+  if (fmt === "json") { printJSON(data.data); return }
+  const a = data.data.attributes
+  console.log(`ID:            ${data.data.id}`)
+  console.log(`Name:          ${a?.name ?? "-"}`)
+  console.log(`Description:   ${a?.description ?? "-"}`)
+  console.log(`Enabled:       ${a?.isEnabled ?? "-"}`)
+  console.log(`Last Modified: ${formatDate(a?.lastModifiedDate ?? "")}`)
 }
 
 // ---- Builds ----
@@ -92,33 +85,41 @@ export async function xcodeCloudBuildsList(opts: {
   productId?: string
   output?: string
 } = {}): Promise<void> {
-  const url = opts.workflowId
-    ? `/v1/ciWorkflows/${opts.workflowId}/buildRuns`
-    : opts.productId
-    ? `/v1/ciProducts/${opts.productId}/buildRuns`
-    : "/v1/ciBuildRuns"
-  const items = await ascFetchAll<{
+  let items: Array<{
     id: string
-    attributes: {
+    attributes?: {
       number?: number
       createdDate?: string
       startedDate?: string
       finishedDate?: string
-      sourceCommit?: { commitSha?: string; message?: string }
       executionProgress?: string
       completionStatus?: string
     }
-  }>(url)
+  }>
+
+  if (opts.workflowId) {
+    const result = await ciWorkflowsBuildRunsGetToManyRelated({ path: { id: opts.workflowId } })
+    const data = throwOnError(result)
+    items = data.data
+  } else if (opts.productId) {
+    const result = await ciProductsBuildRunsGetToManyRelated({ path: { id: opts.productId } })
+    const data = throwOnError(result)
+    items = data.data
+  } else {
+    // No SDK collection for ciBuildRuns without filter — fall back to ascFetchAll
+    items = await ascFetchAll("/v1/ciBuildRuns")
+  }
+
   const fmt = detectFormat(opts.output)
   if (fmt === "json") { printJSON(items); return }
   printTable(
     ["Build ID", "#", "Status", "Progress", "Started"],
     items.map(b => [
       b.id,
-      String(b.attributes.number ?? "-"),
-      b.attributes.completionStatus ?? "RUNNING",
-      b.attributes.executionProgress ?? "-",
-      formatDate(b.attributes.startedDate ?? b.attributes.createdDate ?? ""),
+      String(b.attributes?.number ?? "-"),
+      b.attributes?.completionStatus ?? "RUNNING",
+      b.attributes?.executionProgress ?? "-",
+      formatDate(b.attributes?.startedDate ?? b.attributes?.createdDate ?? ""),
     ]),
     `Xcode Cloud Builds (${items.length})`,
   )
@@ -131,20 +132,20 @@ export async function xcodeCloudBuildRun(opts: {
 }): Promise<void> {
   const attributes: Record<string, unknown> = { isPullRequestBuild: false }
   if (opts.branch) attributes["sourceCommit"] = { branch: opts.branch }
-  const result = await ascFetch<{ data: { id: string; attributes: { number?: number } } }>("/v1/ciBuildRuns", {
-    method: "POST",
+  const result = await ciBuildRunsCreateInstance({
     body: {
       data: {
         type: "ciBuildRuns",
-        attributes,
+        attributes: attributes as never,
         relationships: {
           workflow: { data: { type: "ciWorkflows", id: opts.workflowId } },
         },
       },
     },
   })
-  const num = result.data.data.attributes.number
-  printSuccess(`Build run started: ${result.data.data.id}${num ? ` (#${num})` : ""}`)
+  const data = throwOnError(result)
+  const num = data.data.attributes?.number
+  printSuccess(`Build run started: ${data.data.id}${num ? ` (#${num})` : ""}`)
 }
 
 // ---- Artifacts ----
@@ -153,6 +154,7 @@ export async function xcodeCloudArtifactsList(opts: {
   buildRunId: string
   output?: string
 }): Promise<void> {
+  // No SDK function for /v1/ciBuildRuns/{id}/artifacts — keep ascFetchAll
   const items = await ascFetchAll<{
     id: string
     attributes: {
@@ -182,6 +184,7 @@ export async function xcodeCloudTestResultsList(opts: {
   buildRunId: string
   output?: string
 }): Promise<void> {
+  // No SDK function for /v1/ciBuildRuns/{id}/testResults — keep ascFetchAll
   const items = await ascFetchAll<{
     id: string
     attributes: {

package/src/index.ts

@@ -25,6 +25,9 @@ import { printError } from "./utils/output.ts"
 import { buildHelpDocument } from "./utils/help-spec.ts"
 import pkg from "../package.json"
 
+// ---- hey-api generated client (sets JWT auth interceptor) ----
+import "./api/hey-api-client.ts"
+
 // ---- Auth commands ----
 import { authLogin, authList, authLogout, authStatus, authUse, profileView, profileUpdate, profileDelete as authProfileDelete } from "./commands/auth.ts"
 
@@ -35,7 +38,7 @@ import { appsList, appsGet } from "./commands/apps.ts"
 import { buildsList, buildsGet, buildsUpdateBetaNotes } from "./commands/builds.ts"
 
 // ---- Versions ----
-import { versionsList, versionsCreate, versionsSubmit } from "./commands/versions.ts"
+import { versionsList, versionsCreate, versionsSubmit, releaseRequestCreate } from "./commands/versions.ts"
 
 // ---- TestFlight ----
 import {
@@ -48,6 +51,27 @@ import {
 // ---- Metadata ----
 import { metadataList, metadataUpdate } from "./commands/metadata.ts"
 
+// ---- Localizations ----
+import { localizationsList, localizationsGet, localizationsCreate, localizationsDelete } from "./commands/localizations.ts"
+
+// ---- Review Details ----
+import { reviewDetailsGet, reviewDetailsUpdate } from "./commands/review-details.ts"
+
+// ---- Review Submission ----
+import {
+  reviewSubmissionList,
+  reviewSubmissionCreate,
+  reviewSubmissionGet,
+  reviewSubmissionSubmit,
+  reviewSubmissionCancel,
+  reviewSubmissionItemsList,
+  reviewSubmissionItemAdd,
+  reviewSubmissionItemDelete,
+} from "./commands/review-submission.ts"
+
+// ---- Phased Release ----
+import { phasedReleaseGet, phasedReleaseCreate, phasedReleaseUpdate, phasedReleaseDelete } from "./commands/phased-release.ts"
+
 // ---- Reviews ----
 import { reviewsList, reviewsGet, reviewsRespond } from "./commands/reviews.ts"
 
@@ -439,6 +463,25 @@ const versionsSubmitCmd = defineCommand({
   async run({ args }) { await versionsSubmit(args["version-id"]) },
 })
 
+const releaseRequestCreateCmd = defineCommand({
+  meta: {
+    name: "create",
+    description: "Manually trigger release of an approved version. Use when auto-release is disabled. Requires the version to be in PENDING_DEVELOPER_RELEASE state.",
+  },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID (get from: asc versions list)" },
+  },
+  async run({ args }) { await releaseRequestCreate(args["version-id"]) },
+})
+
+const releaseRequestCmd = defineCommand({
+  meta: {
+    name: "release-request",
+    description: "Manually release an approved version. Use after Apple approves the build and auto-release is off.",
+  },
+  subCommands: { create: releaseRequestCreateCmd },
+})
+
 const versionsCmd = defineCommand({
   meta: {
     name: "versions",
@@ -579,6 +622,270 @@ const metadataCmd = defineCommand({
   subCommands: { list: metadataListCmd, update: metadataUpdateCmd },
 })
 
+// =============================================================================
+// LOCALIZATIONS
+// =============================================================================
+
+const localizationsListCmd = defineCommand({
+  meta: { name: "list", description: "List all localizations for a version. Returns localization IDs needed for screenshots and metadata updates." },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list --app-id <id>" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await localizationsList({ versionId: args["version-id"], output: args.output }) },
+})
+
+const localizationsGetCmd = defineCommand({
+  meta: { name: "get", description: "Get full details of a localization including all text fields and screenshot set IDs." },
+  args: {
+    id: { type: "positional", required: true, description: "Localization ID. Use: asc localizations list --version-id <id>" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await localizationsGet(args.id, args.output) },
+})
+
+const localizationsCreateCmd = defineCommand({
+  meta: { name: "create", description: "Add a new locale to a version. Use to support additional languages." },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list" },
+    locale: { type: "string", alias: "l", required: true, description: "Locale code, e.g. en-US, fr-FR, ja" },
+    description: { type: "string", description: "App description for this locale" },
+    "whats-new": { type: "string", description: "What's new text for this locale" },
+    keywords: { type: "string", description: "Comma-separated keywords" },
+  },
+  async run({ args }) {
+    await localizationsCreate({
+      versionId: args["version-id"],
+      locale: args.locale,
+      description: args.description,
+      whatsNew: args["whats-new"],
+      keywords: args.keywords,
+    })
+  },
+})
+
+const localizationsDeleteCmd = defineCommand({
+  meta: { name: "delete", description: "Remove a localization from a version." },
+  args: {
+    id: { type: "positional", required: true, description: "Localization ID. Use: asc localizations list" },
+  },
+  async run({ args }) { await localizationsDelete(args.id) },
+})
+
+const localizationsCmd = defineCommand({
+  meta: {
+    name: "localizations",
+    description: [
+      "Manage App Store version localizations.",
+      "Each locale has its own metadata and screenshot sets.",
+      "Get localization IDs first: asc localizations list --version-id <id>",
+    ].join("\n"),
+  },
+  subCommands: { list: localizationsListCmd, get: localizationsGetCmd, create: localizationsCreateCmd, delete: localizationsDeleteCmd },
+})
+
+// =============================================================================
+// REVIEW DETAILS
+// =============================================================================
+
+const reviewDetailsGetCmd = defineCommand({
+  meta: { name: "get", description: "Show current review contact info, demo account, and reviewer notes for a version." },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await reviewDetailsGet(args["version-id"], args.output) },
+})
+
+const reviewDetailsUpdateCmd = defineCommand({
+  meta: {
+    name: "update",
+    description: [
+      "Set reviewer contact info, demo account credentials, and notes for this version.",
+      "Required before submitting for review.",
+      "Creates review details if they don't exist yet.",
+    ].join("\n"),
+  },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list" },
+    "contact-first-name": { type: "string", description: "Reviewer contact first name" },
+    "contact-last-name": { type: "string", description: "Reviewer contact last name" },
+    "contact-email": { type: "string", description: "Reviewer contact email" },
+    "contact-phone": { type: "string", description: "Reviewer contact phone" },
+    "demo-account-name": { type: "string", description: "Demo account username" },
+    "demo-account-password": { type: "string", description: "Demo account password" },
+    "demo-account-required": { type: "boolean", description: "Whether a demo account is required" },
+    notes: { type: "string", description: "Additional notes for the reviewer (up to 4000 characters)" },
+  },
+  async run({ args }) {
+    await reviewDetailsUpdate({
+      versionId: args["version-id"],
+      contactFirstName: args["contact-first-name"],
+      contactLastName: args["contact-last-name"],
+      contactEmail: args["contact-email"],
+      contactPhone: args["contact-phone"],
+      demoAccountName: args["demo-account-name"],
+      demoAccountPassword: args["demo-account-password"],
+      demoAccountRequired: args["demo-account-required"],
+      notes: args.notes,
+    })
+  },
+})
+
+const reviewDetailsCmd = defineCommand({
+  meta: {
+    name: "review-details",
+    description: "Manage App Store review contact info, demo account, and reviewer notes. Must be set before submission.",
+  },
+  subCommands: { get: reviewDetailsGetCmd, update: reviewDetailsUpdateCmd },
+})
+
+// =============================================================================
+// REVIEW SUBMISSION
+// =============================================================================
+
+const reviewSubmissionListCmd = defineCommand({
+  meta: { name: "list", description: "List all review submissions for an app." },
+  args: {
+    "app-id": { type: "string", required: true, description: "App ID. Use: asc apps list" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await reviewSubmissionList({ appId: args["app-id"], output: args.output }) },
+})
+
+const reviewSubmissionCreateCmd = defineCommand({
+  meta: { name: "create", description: "Create a new review submission. Add items (versions) then call submit to trigger review." },
+  args: {
+    "app-id": { type: "string", required: true, description: "App ID. Use: asc apps list" },
+    platform: { type: "string", description: "Platform: IOS (default) | MAC_OS | TV_OS | VISION_OS" },
+  },
+  async run({ args }) { await reviewSubmissionCreate({ appId: args["app-id"], platform: args.platform }) },
+})
+
+const reviewSubmissionGetCmd = defineCommand({
+  meta: { name: "get", description: "Get status and details of a review submission." },
+  args: {
+    id: { type: "positional", required: true, description: "Submission ID. Use: asc review-submission list" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await reviewSubmissionGet(args.id, args.output) },
+})
+
+const reviewSubmissionSubmitCmd = defineCommand({
+  meta: { name: "submit", description: "Submit for review. Sets submitted=true — triggers Apple review. Ensure metadata and screenshots are complete first." },
+  args: {
+    "submission-id": { type: "string", required: true, description: "Submission ID. Use: asc review-submission create" },
+  },
+  async run({ args }) { await reviewSubmissionSubmit(args["submission-id"]) },
+})
+
+const reviewSubmissionCancelCmd = defineCommand({
+  meta: { name: "cancel", description: "Cancel a pending review submission." },
+  args: {
+    "submission-id": { type: "string", required: true, description: "Submission ID" },
+  },
+  async run({ args }) { await reviewSubmissionCancel(args["submission-id"]) },
+})
+
+const reviewSubmissionItemsListCmd = defineCommand({
+  meta: { name: "list", description: "List items (versions) attached to a review submission." },
+  args: {
+    "submission-id": { type: "string", required: true, description: "Submission ID" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await reviewSubmissionItemsList({ submissionId: args["submission-id"], output: args.output }) },
+})
+
+const reviewSubmissionItemAddCmd = defineCommand({
+  meta: { name: "add", description: "Add an app store version to a review submission." },
+  args: {
+    "submission-id": { type: "string", required: true, description: "Submission ID" },
+    "app-store-version-id": { type: "string", required: true, description: "Version ID. Use: asc versions list" },
+  },
+  async run({ args }) {
+    await reviewSubmissionItemAdd({ submissionId: args["submission-id"], appStoreVersionId: args["app-store-version-id"] })
+  },
+})
+
+const reviewSubmissionItemDeleteCmd = defineCommand({
+  meta: { name: "delete", description: "Remove an item from a review submission." },
+  args: {
+    id: { type: "positional", required: true, description: "Item ID. Use: asc review-submission items list" },
+  },
+  async run({ args }) { await reviewSubmissionItemDelete(args.id) },
+})
+
+const reviewSubmissionCmd = defineCommand({
+  meta: {
+    name: "review-submission",
+    description: [
+      "Manage App Store review submissions (modern API).",
+      "Workflow: create → items add → submit",
+      "  asc review-submission create --app-id <id>",
+      "  asc review-submission items add --submission-id <id> --app-store-version-id <id>",
+      "  asc review-submission submit --submission-id <id>",
+    ].join("\n"),
+  },
+  subCommands: {
+    list: reviewSubmissionListCmd,
+    create: reviewSubmissionCreateCmd,
+    get: reviewSubmissionGetCmd,
+    submit: reviewSubmissionSubmitCmd,
+    cancel: reviewSubmissionCancelCmd,
+    items: defineCommand({
+      meta: { name: "items", description: "Manage items (versions) in a review submission" },
+      subCommands: { list: reviewSubmissionItemsListCmd, add: reviewSubmissionItemAddCmd, delete: reviewSubmissionItemDeleteCmd },
+    }),
+  },
+})
+
+// =============================================================================
+// PHASED RELEASE
+// =============================================================================
+
+const phasedReleaseGetCmd = defineCommand({
+  meta: { name: "get", description: "Get phased release status for a version. Shows current rollout day and state." },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list" },
+    output: { type: "string", alias: "o", description: "Output format: table | json" },
+  },
+  async run({ args }) { await phasedReleaseGet(args["version-id"], args.output) },
+})
+
+const phasedReleaseCreateCmd = defineCommand({
+  meta: { name: "create", description: "Enable phased (gradual) rollout for a version. Rolls out over 7 days: 1% → 2% → 5% → 10% → 20% → 50% → 100%." },
+  args: {
+    "version-id": { type: "string", alias: "v", required: true, description: "Version ID. Use: asc versions list" },
+    state: { type: "string", description: "Initial state: INACTIVE (default) | ACTIVE | PAUSED" },
+  },
+  async run({ args }) { await phasedReleaseCreate({ versionId: args["version-id"], state: args.state }) },
+})
+
+const phasedReleaseUpdateCmd = defineCommand({
+  meta: { name: "update", description: "Change phased release state. PAUSED halts rollout, ACTIVE resumes, COMPLETE skips to 100%." },
+  args: {
+    id: { type: "positional", required: true, description: "Phased release ID. Use: asc phased-release get --version-id <id>" },
+    state: { type: "string", required: true, description: "New state: INACTIVE | ACTIVE | PAUSED | COMPLETE" },
+  },
+  async run({ args }) { await phasedReleaseUpdate({ phasedReleaseId: args.id, state: args.state }) },
+})
+
+const phasedReleaseDeleteCmd = defineCommand({
+  meta: { name: "delete", description: "Remove phased release configuration from a version." },
+  args: {
+    id: { type: "positional", required: true, description: "Phased release ID. Use: asc phased-release get --version-id <id>" },
+  },
+  async run({ args }) { await phasedReleaseDelete(args.id) },
+})
+
+const phasedReleaseCmd = defineCommand({
+  meta: {
+    name: "phased-release",
+    description: "Manage phased (gradual) rollout for App Store versions. Rolls out over 7 days to increasing percentages of users.",
+  },
+  subCommands: { get: phasedReleaseGetCmd, create: phasedReleaseCreateCmd, update: phasedReleaseUpdateCmd, delete: phasedReleaseDeleteCmd },
+})
+
 // =============================================================================
 // REVIEWS (Customer Reviews)
 // =============================================================================
@@ -1594,8 +1901,13 @@ const main = defineCommand({
     apps: appsCmd,
     builds: buildsCmd,
     versions: versionsCmd,
+    "release-request": releaseRequestCmd,
     testflight: testflightCmd,
     metadata: metadataCmd,
+    localizations: localizationsCmd,
+    "review-details": reviewDetailsCmd,
+    "review-submission": reviewSubmissionCmd,
+    "phased-release": phasedReleaseCmd,
     reviews: reviewsCmd,
     pricing: pricingCmd,
     availability: availabilityCmd,