Files
reverse-engineering-anything/src/hopper/HopperProcessDiagnostic.ts
T
4d98123279 fix(hopper): recover from a Spotlight not-found launch (#2795)
* fix(hopper): recover from a Spotlight not-found launch

Hopper's native launcher locates the application through a fixed Spotlight
query before any Apple event. With indexing disabled it exits 3 with a
not-found report, but REA treated the external document as unconfirmed,
retained the runtime and failed every later open_binary until the server
restarted. Recognize the complete report as a pre-handoff failure, confirm
no document exists, and tell the caller to enable Spotlight indexing.

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

* fix(hopper): require empty stdout for native launch signatures

* fix(hopper): retain ownership after unverified Spotlight reports

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: morluto <76467478+morluto@users.noreply.github.com>
2026-10-14 06:08:31 +08:00

63 lines
2.6 KiB
TypeScript

import {
hopperStartupFailure,
type HopperStartupFailureDiagnostic,
} from "../domain/hopperStartupFailure.js";
import type { ProviderProcessDiagnostic } from "../process/ProviderProcess.js";
import { parseLinuxPrivateDisplayDiagnostic } from "./LinuxPrivateDisplayDiagnostic.js";
import type { HopperLauncherOutcome } from "../domain/hopperErrors.js";
/** Recognize launcher stderr signatures only with complete, empty stdout. */
const hasCompleteLauncherOutput = (outcome: HopperLauncherOutcome): boolean =>
outcome.output_closed &&
!outcome.diagnostic_truncated &&
outcome.stdout.text === "" &&
outcome.stdout.bytes === 0 &&
outcome.stdout.retained_bytes === 0;
/**
* Hopper's native helper sends activate before its open-document Apple event.
* Recognize its explicit authorization rejection. The launcher must separately
* establish that caller arguments could not alter the generated AppleScript.
* Other script errors, signals, and incomplete output leave ownership unknown.
*/
export const nativeHopperLaunchWasDenied = (
outcome: HopperLauncherOutcome | undefined,
): outcome is HopperLauncherOutcome =>
outcome !== undefined &&
outcome.exit_code === 2 &&
outcome.signal === null &&
hasCompleteLauncherOutput(outcome) &&
/^Cannot launch Hopper!\r?\nNot authorized to send Apple events to [^\r\n]+\.\r?\n?$/u.test(
outcome.stderr.text,
);
/**
* Recognize the launcher's complete Spotlight diagnostic for actionable setup
* guidance. Custom launchers may forward this report after a handoff, so the
* report does not establish whether a document exists or release ownership.
*/
export const hopperLauncherReportedApplicationNotFound = (
outcome: HopperLauncherOutcome | undefined,
): outcome is HopperLauncherOutcome =>
outcome !== undefined &&
outcome.exit_code === 3 &&
outcome.signal === null &&
hasCompleteLauncherOutput(outcome) &&
/^Hopper has not been found\.\r?\nPlease make sure that Spotlight is active in order for this tool to find Hopper's executable\.\r?\n?$/u.test(
outcome.stderr.text,
);
/** Extract only a matching Linux adapter failure record. */
export const hopperLauncherFailureDiagnostic = (
event: Extract<ProviderProcessDiagnostic, { readonly type: "exit" }>,
): HopperStartupFailureDiagnostic | undefined => {
const parsed = parseLinuxPrivateDisplayDiagnostic(event.snapshot.stderr.text);
if (!parsed.ok) return undefined;
const expected = hopperStartupFailure(event.code)?.code;
return parsed.value.operation === "launch" &&
parsed.value.status === "error" &&
parsed.value.failure_code === expected
? parsed.value
: undefined;
};