fix: mark unimplemented HarmonyOS commands as unsupported and fix platform gaps

- capabilities: remove harmonyos support from logs and perf (not yet implemented)
- dispatch-interactions: explicitly reject read command on HarmonyOS
- client-shared: add harmonyos serial to device identifiers
- session-open-surface: include serial for harmonyos open results
- client-output: add harmonyos appstate output formatting
- boot-diagnostics: add HDC_TRANSPORT_UNAVAILABLE for harmonyos and extend platform type
- post-gesture-stabilization: include harmonyos in supported platforms
- interaction-outcome-policy: include harmonyos in supported platforms
- replay/script-utils: include harmonyos platform in script args
- maestro/runtime-targets: correctly map harmonyos platform instead of falling back to ios
- maestro/command-mapper: allow openLink on harmonyos with appId

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: wangcz

src/client-shared.ts

@@ -36,7 +36,11 @@ export function buildDeviceIdentifiers(
   return {
     deviceId: id,
     deviceName: name,
-    ...(platform === 'android' ? { serial: id } : platform === 'ios' ? { udid: id } : {}),
+    ...(platform === 'android' || platform === 'harmonyos'
+      ? { serial: id }
+      : platform === 'ios'
+        ? { udid: id }
+        : {}),
   };
 }
 
@@ -56,9 +60,12 @@ function serializeSessionDevice(
           ios_simulator_device_set: device.ios?.simulatorSetPath ?? null,
         }
       : {}),
-    ...(device.platform === 'android' && includeAndroidSerial
+    ...((device.platform === 'android' || device.platform === 'harmonyos') && includeAndroidSerial
       ? {
-          serial: device.android?.serial ?? device.id,
+          serial:
+            device.platform === 'android'
+              ? device.android?.serial ?? device.id
+              : device.harmonyos?.serial ?? device.id,
         }
       : {}),
   };

src/commands/client-output.ts

@@ -249,6 +249,11 @@ function formatAppState(data: AppStateCommandResult): string | null {
     if (data.activity) lines.push(`Activity: ${data.activity}`);
     return lines.join('\n');
   }
+  if (data.platform === 'harmonyos') {
+    const lines = [`Foreground app: ${data.bundleId ?? 'unknown'}`];
+    if (data.activity) lines.push(`Ability: ${data.activity}`);
+    return lines.join('\n');
+  }
   return null;
 }
 

src/compat/maestro/command-mapper.ts

@@ -154,7 +154,7 @@ function convertOpenLink(
 ): SessionAction {
   const rawLink = readOpenLink(value, name);
   const url = resolveMaestroString(rawLink, context);
-  if ((context.platform === 'ios' || context.platform === 'android') && config.appId) {
+  if ((context.platform === 'ios' || context.platform === 'android' || context.platform === 'harmonyos') && config.appId) {
     return action(
       'open',
       [resolveMaestroString(requireAppId(config, name), context), url],

src/compat/maestro/runtime-targets.ts

@@ -256,7 +256,9 @@ function filterReactNativeOverlayBlockedMatches(
 }
 
 export function readMaestroSelectorPlatform(flags: DaemonRequest['flags']): Platform {
-  return flags?.platform === 'android' ? 'android' : 'ios';
+  if (flags?.platform === 'android') return 'android';
+  if (flags?.platform === 'harmonyos') return 'harmonyos';
+  return 'ios';
 }
 
 export function extractMaestroVisibleTextQuery(selectorExpression: string): string | null {

src/core/capabilities.ts

@@ -180,8 +180,9 @@ const COMMAND_CAPABILITY_MATRIX: Record<string, CommandCapability> = {
   logs: {
     apple: { simulator: true, device: true },
     android: { emulator: true, device: true, unknown: true },
-    harmonyos: HARMONYOS_DEVICE,
+    harmonyos: {},
     linux: LINUX_NONE,
+    supports: (device) => device.platform !== 'harmonyos',
   },
   network: {
     apple: { simulator: true, device: true },
@@ -199,8 +200,9 @@ const COMMAND_CAPABILITY_MATRIX: Record<string, CommandCapability> = {
   perf: {
     apple: { simulator: true, device: true },
     android: { emulator: true, device: true, unknown: true },
-    harmonyos: HARMONYOS_DEVICE,
+    harmonyos: {},
     linux: LINUX_NONE,
+    supports: (device) => device.platform !== 'harmonyos',
   },
   pan: {
     apple: { simulator: true, device: true },

src/core/dispatch-interactions.ts

@@ -879,6 +879,9 @@ export async function handleReadCommand(
   context: DispatchContext | undefined,
 ): Promise<Record<string, unknown>> {
   const { x, y } = readPoint(positionals, 'read requires x y');
+  if (device.platform === 'harmonyos') {
+    throw new AppError('UNSUPPORTED_OPERATION', 'read is not yet supported on HarmonyOS');
+  }
   if (device.platform === 'android') {
     const { readAndroidTextAtPoint } = await import('../platforms/android/input-actions.ts');
     const text = await readAndroidTextAtPoint(device, x, y);

src/daemon/handlers/session-open-surface.ts

@@ -45,7 +45,7 @@ export function buildOpenResult(params: {
     result.device = device.name;
     result.id = device.id;
     result.kind = device.kind;
-    if (device.platform === 'android') {
+    if (device.platform === 'android' || device.platform === 'harmonyos') {
       result.serial = device.id;
     }
   }

src/daemon/interaction-outcome-policy.ts

@@ -187,7 +187,11 @@ export function areInteractionSurfaceSignaturesStable(
 }
 
 function supportsInteractionOutcomePolicy(session: SessionState): boolean {
-  return session.device.platform === 'ios' || session.device.platform === 'android';
+  return (
+    session.device.platform === 'ios' ||
+    session.device.platform === 'android' ||
+    session.device.platform === 'harmonyos'
+  );
 }
 
 function retryCommandForTap(command: string): string | undefined {

src/daemon/post-gesture-stabilization.ts

@@ -79,5 +79,5 @@ function isPostGestureStabilizingAction(action: string): boolean {
 }
 
 function supportsPostGestureStabilization(platform: SessionState['device']['platform']): boolean {
-  return platform === 'ios' || platform === 'android';
+  return platform === 'ios' || platform === 'android' || platform === 'harmonyos';
 }

src/platforms/boot-diagnostics.ts

@@ -6,6 +6,7 @@ export type BootFailureReason =
   | 'IOS_TOOL_MISSING'
   | 'ANDROID_BOOT_TIMEOUT'
   | 'ADB_TRANSPORT_UNAVAILABLE'
+  | 'HDC_TRANSPORT_UNAVAILABLE'
   | 'CI_RESOURCE_STARVATION_SUSPECTED'
   | 'BOOT_COMMAND_FAILED'
   | 'UNKNOWN';
@@ -16,11 +17,12 @@ const INFRASTRUCTURE_BOOT_FAILURE_REASONS = new Set<BootFailureReason>([
   'IOS_TOOL_MISSING',
   'ANDROID_BOOT_TIMEOUT',
   'ADB_TRANSPORT_UNAVAILABLE',
+  'HDC_TRANSPORT_UNAVAILABLE',
   'CI_RESOURCE_STARVATION_SUSPECTED',
 ]);
 
 type BootDiagnosticContext = {
-  platform?: 'ios' | 'android';
+  platform?: 'ios' | 'android' | 'harmonyos';
   phase?: 'boot' | 'connect' | 'transport';
 };
 
@@ -39,7 +41,11 @@ export function classifyBootFailure(input: {
   const platform = input.context?.platform;
   const phase = input.context?.phase;
   if (appErr?.code === 'TOOL_MISSING') {
-    return platform === 'android' ? 'ADB_TRANSPORT_UNAVAILABLE' : 'IOS_TOOL_MISSING';
+    return platform === 'android'
+      ? 'ADB_TRANSPORT_UNAVAILABLE'
+      : platform === 'harmonyos'
+        ? 'HDC_TRANSPORT_UNAVAILABLE'
+        : 'IOS_TOOL_MISSING';
   }
   const details = (appErr?.details ?? {}) as Record<string, unknown>;
   const detailMessage = typeof details.message === 'string' ? details.message : undefined;