Add copy-from-version wand menu, build diagnostics, and checklist improvements

Author: nickustinov

docs/ASC-API.md

@@ -314,6 +314,55 @@ Replace `{w}` and `{h}` with pixel dimensions, `{f}` with format (`png`, `jpg`,
 .../AppIcon.icns/64x64bb.png
 ```
 
+### Build metrics (betaBuildUsages)
+
+```
+GET /v1/builds/{buildId}/metrics/betaBuildUsages
+```
+
+Returns: `{ data: [{ dataPoints: [{ values: { ... } }] }] }`
+
+Values fields:
+| Field | Type | Notes |
+|---|---|---|
+| `installCount` | number | Total installs |
+| `sessionCount` | number | Total sessions |
+| `crashCount` | number | Total crashes |
+| `inviteCount` | number | Total invites sent |
+| `feedbackCount` | number | Total feedback submissions |
+
+### Build diagnostic signatures
+
+```
+GET /v1/builds/{buildId}/diagnosticSignatures
+  filter[diagnosticType] = DISK_WRITES | HANGS | LAUNCHES
+  limit = 200
+```
+
+Returns: `{ data: [{ id, attributes: { diagnosticType, signature, weight } }] }`
+
+Signature attributes:
+| Field | Type | Notes |
+|---|---|---|
+| `diagnosticType` | string | `DISK_WRITES`, `HANGS`, or `LAUNCHES` |
+| `signature` | string | Human-readable signature (e.g. function name) |
+| `weight` | number | 0–1 fraction indicating relative frequency |
+
+### Diagnostic logs
+
+```
+GET /v1/diagnosticSignatures/{signatureId}/logs
+```
+
+Returns: `{ data: [{ attributes: { diagnosticMetaData, callStackTree, insights } }] }`
+
+- `diagnosticMetaData` – key-value pairs (deviceType, osVersion, etc.)
+- `callStackTree` – array of `{ callStacks: [{ callStackRootFrames: [frame, ...] }] }`
+- Each frame: `{ symbolName, binaryName, fileName?, lineNumber?, address?, isBlameFrame, sampleCount, subFrames? }`
+- `insights` – array of `{ category, description, url? }` with Apple's analysis
+
+**Note:** Diagnostic data is available for all builds including expired ones. Signatures are cached for 15 minutes. Logs are fetched on-demand (no caching).
+
 ## Known API quirks
 
 1. **`fields[type]` strips relationships** – the ASC API follows JSON:API sparse fieldsets: when you specify `fields[someType]=attr1,attr2`, the response omits **all** relationship pointers not listed. To keep relationship data needed by `include`, you must add the relationship names to `fields`. For example: `fields[appStoreVersions]=versionString,...,build,appStoreReviewDetail` – without `build,appStoreReviewDetail` in the list, the `relationships` key is missing from each version object and `resolveIncluded()` cannot match included items to their parents.

src/app/api/apps/[appId]/testflight/builds/[buildId]/diagnostics/[signatureId]/logs/route.ts

@@ -0,0 +1,22 @@
+import { NextResponse } from "next/server";
+import { errorJson } from "@/lib/api-helpers";
+import { getDiagnosticLogs } from "@/lib/asc/testflight";
+import { hasCredentials } from "@/lib/asc/client";
+
+export async function GET(
+  _request: Request,
+  { params }: { params: Promise<{ appId: string; buildId: string; signatureId: string }> },
+) {
+  const { signatureId } = await params;
+
+  if (!hasCredentials()) {
+    return NextResponse.json({ logs: [] });
+  }
+
+  try {
+    const logs = await getDiagnosticLogs(signatureId);
+    return NextResponse.json({ logs });
+  } catch (err) {
+    return errorJson(err);
+  }
+}

src/app/api/apps/[appId]/testflight/builds/[buildId]/diagnostics/route.ts

@@ -0,0 +1,31 @@
+import { NextResponse } from "next/server";
+import { errorJson } from "@/lib/api-helpers";
+import { listDiagnosticSignatures } from "@/lib/asc/testflight";
+import { hasCredentials } from "@/lib/asc/client";
+import type { TFDiagnosticType } from "@/lib/asc/testflight";
+
+const VALID_TYPES = new Set(["DISK_WRITES", "HANGS", "LAUNCHES"]);
+
+export async function GET(
+  request: Request,
+  { params }: { params: Promise<{ appId: string; buildId: string }> },
+) {
+  const { buildId } = await params;
+  const url = new URL(request.url);
+  const forceRefresh = url.searchParams.get("refresh") === "1";
+  const typeParam = url.searchParams.get("type") ?? undefined;
+  const type = typeParam && VALID_TYPES.has(typeParam)
+    ? (typeParam as TFDiagnosticType)
+    : undefined;
+
+  if (!hasCredentials()) {
+    return NextResponse.json({ signatures: [] });
+  }
+
+  try {
+    const signatures = await listDiagnosticSignatures(buildId, type, forceRefresh);
+    return NextResponse.json({ signatures });
+  } catch (err) {
+    return errorJson(err);
+  }
+}

src/app/dashboard/apps/[appId]/store-listing/page.tsx

@@ -22,8 +22,9 @@ import {
 } from "@/lib/asc/locale-names";
 import { useRegisterHeaderLocale } from "@/lib/header-locale-context";
 import { useSubmissionChecklist } from "@/lib/submission-checklist-context";
+import { computeChecklistFlags } from "@/lib/submission-checklist-utils";
 import { useLocaleManagement } from "@/lib/hooks/use-locale-management";
-import type { MagicWandLocaleProps } from "@/components/magic-wand-button";
+import type { MagicWandLocaleProps, CopyFromVersion } from "@/components/magic-wand-button";
 import { BulkAIDialog, type BulkField } from "@/components/bulk-ai-dialog";
 import { BulkAllAIDialog } from "@/components/bulk-all-ai-dialog";
 import type { TFBuild } from "@/lib/asc/testflight/types";
@@ -99,11 +100,50 @@ export default function StoreListingPage() {
 
   const current = localeData[selectedLocale] ?? emptyLocaleFields();
 
+  const copyFromVersions: CopyFromVersion[] = useMemo(
+    () =>
+      versions
+        .filter((v) => v.id !== versionId)
+        .map((v) => ({
+          versionId: v.id,
+          versionString: v.attributes.versionString,
+          platform: v.attributes.platform,
+        })),
+    [versions, versionId],
+  );
+
+  async function handleCopyFromVersion(field: string, sourceVersionId: string) {
+    try {
+      const res = await fetch(
+        `/api/apps/${appId}/versions/${sourceVersionId}/localizations`,
+      );
+      if (!res.ok) {
+        toast.error("Failed to fetch version localizations");
+        return;
+      }
+      const data = await res.json();
+      const locs: { attributes: { locale: string; [key: string]: string } }[] =
+        data.localizations ?? [];
+      const match = locs.find((l) => l.attributes.locale === selectedLocale);
+      if (!match) {
+        toast.error("Locale not available in that version");
+        return;
+      }
+      const value = match.attributes[field] ?? "";
+      updateField(field as keyof LocaleFields, value);
+      toast.success("Copied from version");
+    } catch {
+      toast.error("Failed to fetch version localizations");
+    }
+  }
+
   const wand: MagicWandLocaleProps = {
     locale: selectedLocale,
     baseLocale: locales[0] ?? "",
     localeData,
     appName: app?.name,
+    copyFromVersions,
+    onCopyFromVersion: handleCopyFromVersion,
   };
 
   const { report: reportChecklist } = useSubmissionChecklist();
@@ -247,15 +287,10 @@ export default function StoreListingPage() {
     setValidationErrors(errors);
   }, [localeData, setValidationErrors]);
 
-  // Report submission checklist flags from primary locale
+  // Report submission checklist flags across all locales
   useEffect(() => {
-    const primary = localeData[primaryLocale];
-    if (!primary) return;
-    reportChecklist({
-      hasDescription: (primary.description?.length ?? 0) > 0,
-      hasWhatsNew: (primary.whatsNew?.length ?? 0) > 0,
-      hasKeywords: (primary.keywords?.length ?? 0) > 0,
-    });
+    if (!localeData[primaryLocale]) return;
+    reportChecklist(computeChecklistFlags(localeData, primaryLocale));
   }, [localeData, primaryLocale, reportChecklist]);
 
   // Register save handler for the header Save button