Function isCommandSupportedOnDevice

src/core/capabilities.ts:81–109

(command: string, device: DeviceInfo)

}

export function isCommandSupportedOnDevice(command: string, device: DeviceInfo): boolean {
  const capability = COMMAND_CAPABILITY_MATRIX[command];
  if (!capability) return true;
  // Platform -> capability-bucket selection now flows through the single
  // PlatformPlugin registry (ADR-0009, Phase 3 step b.1): the bucket a leaf
  // platform reads from a CommandCapability is the owning plugin's
  // `capability.bucket`. This replaces the former `selectCapabilityForPlatform`
  // fold over `platformDescriptors`; the plugin bucket is proven byte-for-byte
  // equal to that derivation by `platform-plugin/__tests__/parity.test.ts`, and
  // `__tests__/capability-plugin-routing-parity.test.ts` pins that this swap leaves
  // `isCommandSupportedOnDevice` unchanged across the full command x device matrix.
  // `tryGetPlugin` returns undefined only for an unregistered platform — the same
  // "no bucket -> unsupported" fall-through the fold produced for a platform with
  // no capability family (ADR-0009's plugin registry: `if (!plugin) return false`).
  const plugin = tryGetPlugin(device.platform);
  if (!plugin) return false;
  const byPlatform = capability[plugin.capability.bucket];
  if (!byPlatform) return false;
  // The per-command `supports()` gate now flows through the owning PlatformPlugin
  // (ADR-0009, Phase 3 step b.2): the family that owns `device.platform` carries the
  // `supports()` closure RELOCATED VERBATIM in `capability.supportsByDefault`, keyed by
  // command. A family with no entry for `command` admits it unchanged — proven equal to
  // the former command-facet closure across the device matrix by
  // `__tests__/capability-plugin-routing-parity.test.ts`.
  const supportsByDefault = plugin.capability.supportsByDefault?.[command];
  if (supportsByDefault && !supportsByDefault(device)) return false;
  const kind = (device.kind ?? 'unknown') as keyof KindMatrix;
  return byPlatform[kind] === true;
}

export function unsupportedHintForDevice(command: string, device: DeviceInfo): string | undefined {
  // Counterpart of the `supports()` relocation (Phase 3 step b.2): the hint closure is