comber 0.1.0

package/dist/native/maestro.js

@@ -0,0 +1,153 @@
+// The MaestroRunner transport seam — the pluggable boundary between the NativeDriver and the
+// real `maestro` CLI / Maestro MCP / a booted emulator|simulator. It mirrors the ApiDriver's
+// `ApiTransport`: the driver depends ONLY on this interface, so the whole driver is testable
+// hermetically by injecting a stub (no device, no maestro binary). The default shell-out
+// implementation below is best-effort and REQUIRES `maestro` + a booted device to do anything.
+//
+// Dependency arrow: this file imports nothing from `core`, `web`, or `api` — it is a leaf
+// transport type plus a stdlib-only default impl. `src/native/*` may import it; `core` never does.
+import { execFile } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/** Promisified execFile that resolves { stdout } and rejects on a non-zero exit / timeout. */
+function run(bin, args, opts) {
+    return new Promise((resolve, reject) => {
+        const child = execFile(bin, args, { timeout: opts.timeoutMs, maxBuffer: 32 * 1024 * 1024 }, (err, stdout, stderr) => {
+            if (err)
+                return reject(err);
+            resolve({ stdout: String(stdout), stderr: String(stderr) });
+        });
+        if (opts.input !== undefined) {
+            child.stdin?.end(opts.input);
+        }
+    });
+}
+/**
+ * REQUIRES `maestro` on PATH + a booted emulator/simulator (or a Maestro Cloud session). This
+ * is a BEST-EFFORT default: it composes ephemeral one-command Maestro flows for launch/tap/
+ * input/back, parses `maestro hierarchy` for the view tree, and reads `adb logcat`/`xcrun simctl`
+ * for crash/ANR logs. None of it runs in the hermetic test suite — the tests inject a stub
+ * MaestroRunner. Treat the exact command strings as a starting point to reconcile against the
+ * installed maestro version, not a verified-on-CI contract (no device was available at authoring).
+ */
+export class DefaultMaestroRunner {
+    opts;
+    bin;
+    timeoutMs;
+    constructor(opts) {
+        this.opts = opts;
+        this.bin = opts.maestroBin ?? "maestro";
+        this.timeoutMs = opts.commandTimeoutMs ?? 30_000;
+    }
+    deviceArgs() {
+        return this.opts.device ? ["--device", this.opts.device] : [];
+    }
+    /** Write a temp flow YAML, run it via `maestro test`, and clean up. */
+    async flow(body) {
+        const dir = await mkdtemp(join(tmpdir(), "comber-maestro-"));
+        const file = join(dir, "flow.yaml");
+        const yaml = `appId: ${this.opts.appId}\n---\n${body}\n`;
+        try {
+            await writeFile(file, yaml, "utf8");
+            await run(this.bin, [...this.deviceArgs(), "test", file], { timeoutMs: this.timeoutMs });
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    async launch(appId, deeplink) {
+        // `launchApp` with a clearState reset, then (optionally) openLink to the deeplink.
+        const lines = [`- launchApp:`, `    appId: "${appId}"`, `    clearState: false`];
+        if (deeplink)
+            lines.push(`- openLink: "${deeplink}"`);
+        await this.flow(lines.join("\n"));
+    }
+    async viewHierarchy() {
+        const { stdout } = await run(this.bin, [...this.deviceArgs(), "hierarchy"], { timeoutMs: this.timeoutMs });
+        return parseMaestroHierarchy(stdout, this.opts.appId);
+    }
+    async tap(selector) {
+        await this.flow(`- tapOn:\n${selectorYaml(selector)}`);
+    }
+    async input(selector, text) {
+        await this.flow(`- tapOn:\n${selectorYaml(selector)}\n- inputText: "${escapeYaml(text)}"`);
+    }
+    async back() {
+        await this.flow(`- back`);
+    }
+    async foregroundApp() {
+        if (this.opts.platform === "android") {
+            const { stdout } = await run("adb", [...(this.opts.device ? ["-s", this.opts.device] : []), "shell", "dumpsys", "activity", "activities"], { timeoutMs: this.timeoutMs }).catch(() => ({ stdout: "", stderr: "" }));
+            const m = stdout.match(/mResumedActivity.*?\s([A-Za-z0-9_.]+)\//);
+            return m?.[1] ?? this.opts.appId;
+        }
+        // iOS: no first-class CLI; best-effort fall back to the configured appId.
+        return this.opts.appId;
+    }
+    async logsSince(sinceMs) {
+        if (this.opts.platform !== "android")
+            return [];
+        const stamp = new Date(sinceMs).toISOString().replace("T", " ").slice(0, 19) + ".000";
+        const { stdout } = await run("adb", [...(this.opts.device ? ["-s", this.opts.device] : []), "logcat", "-d", "-t", stamp, "*:E"], { timeoutMs: this.timeoutMs }).catch(() => ({ stdout: "", stderr: "" }));
+        return stdout.split(/\r?\n/).filter(Boolean);
+    }
+    async runFlow(yaml) {
+        const dir = await mkdtemp(join(tmpdir(), "comber-maestro-"));
+        const file = join(dir, "flow.yaml");
+        try {
+            await writeFile(file, yaml, "utf8");
+            await run(this.bin, [...this.deviceArgs(), "test", file], { timeoutMs: this.timeoutMs });
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    async screenshot() {
+        // Maestro writes screenshots to disk; a stdout-PNG path is version-dependent. Default: none.
+        return Buffer.alloc(0);
+    }
+}
+function escapeYaml(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/** Compose a maestro selector block (id ⇒ id:, else text, else index). */
+function selectorYaml(sel) {
+    if (sel.id)
+        return `    id: "${escapeYaml(sel.id)}"`;
+    if (sel.text)
+        return `    text: "${escapeYaml(sel.text)}"`;
+    return `    index: ${sel.index ?? 0}`;
+}
+/**
+ * Parse the JSON `maestro hierarchy` dump into a NativeView. Tolerant: maestro's node shape
+ * carries an `attributes` bag + `children`; field names vary by platform/version, so we read
+ * a superset and degrade gracefully. Unknown shapes yield an empty root (an honest blind spot).
+ */
+export function parseMaestroHierarchy(stdout, appId) {
+    let json;
+    try {
+        json = JSON.parse(stdout);
+    }
+    catch {
+        return { appId, root: {} };
+    }
+    const obj = (json ?? {});
+    const rootRaw = (obj.root ?? obj);
+    return { appId, root: convertNode(rootRaw) };
+}
+function convertNode(raw) {
+    const attrs = (raw.attributes ?? raw);
+    const str = (k) => (typeof attrs[k] === "string" ? attrs[k] : undefined);
+    const bool = (k) => attrs[k] === true || attrs[k] === "true" ? true : attrs[k] === false || attrs[k] === "false" ? false : undefined;
+    const childrenRaw = Array.isArray(raw.children) ? raw.children : [];
+    return {
+        id: str("resource-id") ?? str("resourceId") ?? str("accessibilityIdentifier") ?? str("testTag") ?? str("id"),
+        text: str("text") ?? str("label") ?? str("accessibilityText") ?? str("hintText"),
+        type: str("class") ?? str("className") ?? str("elementType") ?? str("type"),
+        enabled: bool("enabled"),
+        clickable: bool("clickable") ?? bool("focusable"),
+        focusable: bool("focusable"),
+        children: childrenRaw.map(convertNode),
+    };
+}

package/dist/native/maestro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maestro.js","sourceRoot":"","sources":["../../src/native/maestro.ts"],"names":[],"mappings":"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"}

package/dist/native/preflight.js

@@ -0,0 +1,72 @@
+import { normalizeDeviceProfile } from "./device-profile.js";
+import { validateNativeDeviceProfile } from "./evidence.js";
+import { samsungEvidence } from "./samsung.js";
+function hasText(value) {
+    return value !== undefined && value.trim().length > 0;
+}
+function addIssue(issues, severity, code, field, message) {
+    issues.push({
+        severity,
+        code,
+        ...(field !== undefined ? { field } : {}),
+        message,
+    });
+}
+export function evaluateNativeReadiness(input) {
+    const profile = normalizeDeviceProfile(input);
+    const issues = [];
+    if (!hasText(profile.deviceId)) {
+        addIssue(issues, "blocker", "device-id-missing", "deviceId", "Native readiness requires a concrete device id");
+    }
+    if (!hasText(profile.provider)) {
+        addIssue(issues, "blocker", "provider-missing", "provider", "Native readiness requires a provider or local device source");
+    }
+    if (!hasText(profile.verificationCommand)) {
+        addIssue(issues, "blocker", "verification-command-missing", "verificationCommand", "Native readiness requires the command that produced the evidence");
+    }
+    if ((profile.evidenceArtifacts ?? []).length === 0) {
+        addIssue(issues, "blocker", "evidence-artifacts-missing", "evidenceArtifacts", "Native readiness requires at least one evidence artifact path");
+    }
+    const validation = validateNativeDeviceProfile(profile);
+    for (const error of validation.errors) {
+        addIssue(issues, "blocker", error.code, error.field, error.message);
+    }
+    const samsung = samsungEvidence(profile);
+    if (profile.samsung?.requested === true && samsung.samsung?.claimAllowed !== true) {
+        addIssue(issues, "blocker", "samsung-evidence-incomplete", "samsung", "Samsung coverage requires exact Galaxy/One UI evidence from a physical or device-lab class device");
+    }
+    if (profile.platform === "ios" && profile.appleCrashLogsAvailable !== true) {
+        addIssue(issues, "warning", "apple-crash-log-evidence-missing", "appleCrashLogsAvailable", "Apple crash-log evidence was not declared available");
+    }
+    const blockerCount = issues.filter((issue) => issue.severity === "blocker").length;
+    const warningCount = issues.filter((issue) => issue.severity === "warning").length;
+    return {
+        platform: profile.platform,
+        appId: profile.appId,
+        status: blockerCount > 0 ? "blocked" : warningCount > 0 ? "warning" : "ready",
+        blockerCount,
+        warningCount,
+        issues,
+    };
+}
+function blindSpotKindForIssue(issue) {
+    if (issue.code === "samsung-evidence-incomplete")
+        return "device-class-unavailable";
+    return "native-evidence-invalid";
+}
+export function readinessBlindSpots(report, ignoredCodes, scope) {
+    const out = [];
+    for (const issue of report.issues) {
+        if (issue.severity !== "blocker")
+            continue;
+        if (ignoredCodes.has(issue.code))
+            continue;
+        out.push({
+            kind: blindSpotKindForIssue(issue),
+            severity: "blocker-for-exhaustive",
+            scope,
+            message: `Native readiness preflight blocked exhaustive proof: ${issue.message}`,
+        });
+    }
+    return out;
+}

package/dist/native/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/native/preflight.ts"],"names":[],"mappings":"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"}

package/dist/native/proxy-proof.js

@@ -0,0 +1,182 @@
+import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { redactText } from "../core/redact.js";
+export const NATIVE_EGRESS_PROXY_PROOF_SCHEMA = "comber.native-egress-proxy-proof.v1";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_CAPTURE_CHARS = 16_000;
+function hasText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function redactedBounded(value) {
+    const redacted = redactText(value);
+    if (redacted.length <= MAX_CAPTURE_CHARS)
+        return redacted;
+    const keep = Math.floor(MAX_CAPTURE_CHARS / 2);
+    const omitted = redacted.length - MAX_CAPTURE_CHARS;
+    return `${redacted.slice(0, keep)}\n...[truncated ${omitted} chars]...\n${redacted.slice(-keep)}`;
+}
+function shellQuoteForDisplay(value) {
+    if (/^[A-Za-z0-9_./:=@%+-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+function formatCommand(argv) {
+    return redactText(argv.map(shellQuoteForDisplay).join(" "));
+}
+function errorExitCode(error) {
+    if (isRecord(error) && typeof error.code === "number")
+        return error.code;
+    return 1;
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export function execFileCommandRunner(argv, timeoutMs) {
+    const executable = argv[0];
+    if (!hasText(executable)) {
+        return Promise.resolve({ exitCode: 1, stdout: "", stderr: "proof command executable is missing" });
+    }
+    return new Promise((resolve) => {
+        execFile(executable, argv.slice(1), { timeout: timeoutMs, maxBuffer: 32 * 1024 * 1024 }, (error, stdout, stderr) => {
+            const stderrText = String(stderr);
+            const errorText = error ? errorMessage(error) : "";
+            resolve({
+                exitCode: error ? errorExitCode(error) : 0,
+                stdout: String(stdout),
+                stderr: errorText && !stderrText.includes(errorText) ? `${stderrText}${stderrText ? "\n" : ""}${errorText}` : stderrText,
+            });
+        });
+    });
+}
+export function parseCommandJson(value, fieldName) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new Error(`${fieldName} must be a JSON array of command argv strings`);
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new Error(`${fieldName} must be a non-empty JSON array of command argv strings`);
+    }
+    const argv = [];
+    for (const entry of parsed) {
+        if (typeof entry !== "string") {
+            throw new Error(`${fieldName} entries must be strings`);
+        }
+        argv.push(entry);
+    }
+    if (!hasText(argv[0])) {
+        throw new Error(`${fieldName} executable must be a non-empty string`);
+    }
+    return argv;
+}
+function validateRequest(request) {
+    if (!hasText(request.deviceId))
+        throw new Error("deviceId is required");
+    if (!hasText(request.provider))
+        throw new Error("provider is required");
+    if (!hasText(request.proxyCommand))
+        throw new Error("proxyCommand is required");
+    if (!hasText(request.artifactPath))
+        throw new Error("artifactPath is required");
+    if (request.proofCommand.length === 0 || !hasText(request.proofCommand[0])) {
+        throw new Error("proofCommand must include an executable");
+    }
+    if (request.expectedOutput.length === 0)
+        throw new Error("expectedOutput must include at least one marker");
+    for (const expected of request.expectedOutput) {
+        if (!hasText(expected))
+            throw new Error("expectedOutput markers must be non-empty strings");
+    }
+}
+export async function runNativeIosProxyVerification(request) {
+    validateRequest(request);
+    const timeoutMs = request.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const commandRunner = request.commandRunner ?? execFileCommandRunner;
+    const result = await commandRunner(request.proofCommand, timeoutMs);
+    const stdout = redactedBounded(result.stdout);
+    const stderr = redactedBounded(result.stderr);
+    const combinedOutput = `${result.stdout}\n${result.stderr}`;
+    const checks = [
+        {
+            code: "proof-command-exit-zero",
+            passed: result.exitCode === 0,
+            message: result.exitCode === 0 ? "proof command exited 0" : `proof command exited ${result.exitCode}`,
+        },
+    ];
+    for (const expected of request.expectedOutput) {
+        checks.push({
+            code: "expected-output",
+            expected: redactText(expected),
+            passed: combinedOutput.includes(expected),
+            message: combinedOutput.includes(expected)
+                ? "proof command output contained expected marker"
+                : "proof command output did not contain expected marker",
+        });
+    }
+    const artifact = {
+        schema: NATIVE_EGRESS_PROXY_PROOF_SCHEMA,
+        platform: "ios",
+        deviceId: request.deviceId,
+        provider: request.provider,
+        verified: checks.every((check) => check.passed),
+        command: redactText(request.proxyCommand),
+        proofCommand: formatCommand(request.proofCommand),
+        artifactPath: request.artifactPath,
+        createdAt: (request.now ?? (() => new Date()))().toISOString(),
+        checks,
+        stdout,
+        stderr,
+    };
+    await mkdir(dirname(request.artifactPath), { recursive: true });
+    await writeFile(request.artifactPath, JSON.stringify(artifact, null, 2), "utf8");
+    return artifact;
+}
+function textField(record, field) {
+    const value = record[field];
+    return hasText(value) ? value : undefined;
+}
+function checksAreVerified(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return false;
+    for (const check of value) {
+        if (!isRecord(check) || check.passed !== true)
+            return false;
+    }
+    return true;
+}
+export function loadNativeEgressProxyEvidenceFromProof(proofPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(proofPath, "utf8"));
+    }
+    catch {
+        return { verified: false, artifactPath: proofPath };
+    }
+    if (!isRecord(parsed))
+        return { verified: false, artifactPath: proofPath };
+    const provider = textField(parsed, "provider");
+    const command = textField(parsed, "command");
+    const deviceId = textField(parsed, "deviceId");
+    const verified = parsed.schema === NATIVE_EGRESS_PROXY_PROOF_SCHEMA &&
+        parsed.platform === "ios" &&
+        parsed.verified === true &&
+        provider !== undefined &&
+        command !== undefined &&
+        deviceId !== undefined &&
+        checksAreVerified(parsed.checks);
+    return {
+        verified,
+        ...(provider !== undefined ? { provider: redactText(provider) } : {}),
+        ...(command !== undefined ? { command: redactText(command) } : {}),
+        artifactPath: proofPath,
+    };
+}

package/dist/native/proxy-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-proof.js","sourceRoot":"","sources":["../../src/native/proxy-proof.ts"],"names":[],"mappings":"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"}

package/dist/native/samsung.js

@@ -0,0 +1,34 @@
+function hasSamsungIdentity(profile) {
+    const model = profile.samsung?.model ?? profile.model ?? "";
+    return /\b(samsung|galaxy|sm-)/i.test(model);
+}
+export function samsungEvidence(profile) {
+    if (profile.samsung?.requested !== true)
+        return { gaps: [] };
+    const model = profile.samsung.model ?? profile.model;
+    const androidVersion = profile.androidVersion ?? profile.osVersion;
+    const oneUiVersion = profile.samsung.oneUiVersion;
+    const buildFingerprint = profile.samsung.buildFingerprint;
+    const physicalOrLabDevice = profile.deviceClass === "phone" || profile.deviceClass === "tablet" || profile.deviceClass === "foldable";
+    const claimAllowed = profile.platform === "android" && physicalOrLabDevice && hasSamsungIdentity(profile) && Boolean(androidVersion && oneUiVersion);
+    const gaps = [];
+    if (!claimAllowed) {
+        gaps.push({
+            kind: "device-class-unavailable",
+            severity: "blocker-for-exhaustive",
+            scope: "samsung",
+            message: "Samsung coverage was requested but exact Galaxy/One UI physical or device-lab evidence is unavailable",
+        });
+    }
+    return {
+        samsung: {
+            requested: true,
+            claimAllowed,
+            ...(model !== undefined ? { model } : {}),
+            ...(androidVersion !== undefined ? { androidVersion } : {}),
+            ...(oneUiVersion !== undefined ? { oneUiVersion } : {}),
+            ...(buildFingerprint !== undefined ? { buildFingerprint } : {}),
+        },
+        gaps,
+    };
+}

package/dist/native/samsung.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samsung.js","sourceRoot":"","sources":["../../src/native/samsung.ts"],"names":[],"mappings":"AAYA,SAAS,kBAAkB,CAAC,OAA4B;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAC5D,OAAO,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,IAAI,OAAO,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAE7D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IACrD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IACnE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;IAClD,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC1D,MAAM,mBAAmB,GACvB,OAAO,CAAC,WAAW,KAAK,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;IAC5G,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,mBAAmB,IAAI,kBAAkB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,cAAc,IAAI,YAAY,CAAC,CAAC;IACrJ,MAAM,IAAI,GAAgB,EAAE,CAAC;IAE7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,wBAAwB;YAClC,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,uGAAuG;SACjH,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,SAAS,EAAE,IAAI;YACf,YAAY;YACZ,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChE;QACD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/native/signals.js

@@ -0,0 +1,50 @@
+const SEVERITY = {
+    crash: "fail",
+    anr: "warn",
+    frozen: "warn",
+    "error-text": "warn",
+    "assertion-fail": "warn",
+};
+/**
+ * Dedupe key — keyed on screen SCOPE + signal KIND (per the native design), so the same broken
+ * screen re-seen across the crawl collapses to one finding. An optional `discriminator` (e.g. the
+ * control id that crashed) separates two distinct breakages on the SAME screen.
+ */
+export function signatureOf(kind, scope, discriminator) {
+    return `${kind}|${scope}${discriminator ? `|${discriminator}` : ""}`.slice(0, 80);
+}
+/** Construct a native BreakageSignal. `where` is the screen scope/name (NOT a real URL — the core
+ *  redactor leaves a scheme-less screen token intact); `action` is what we did just before. */
+export function nativeSignal(kind, scope, message, opts = {}) {
+    return {
+        kind,
+        severity: SEVERITY[kind],
+        message,
+        url: scope,
+        signature: signatureOf(kind, scope, opts.discriminator),
+        ...(opts.action ? { action: opts.action } : {}),
+    };
+}
+/**
+ * On-screen error canaries — the native analogue of the web console/error-banner canaries. A
+ * visible string matching this on a screen is surfaced as `error-text` (warn). Conservative so
+ * ordinary UI copy ("Error code" labels in a form's help text are still flagged, by design — a
+ * QA pass would rather over-surface a visible "error" than miss a real one).
+ */
+export const NATIVE_ERROR_TEXT = /(something went wrong|unexpected error|an error occurred|app (?:keeps )?stopp(?:ed|ing)|isn'?t responding|unfortunately|failed to load|couldn'?t (?:load|connect)|null is not|undefined is not|NullPointerException|RuntimeException|IndexOutOfBounds|unhandled exception|fatal error|stack trace)/i;
+/** Log-line markers for a hard crash (fail). */
+export const CRASH_LOG = /(FATAL EXCEPTION|SIGSEGV|SIGABRT|has died|Process .* crashed|libc: Fatal signal)/i;
+/** Log-line markers for an ANR / not-responding condition (warn). */
+export const ANR_LOG = /(ANR in |Application Not Responding|Input dispatching timed out|Reason: Input|executing service)/i;
+/** Scan a window of device log lines; return the first crash/ANR kind seen, if any. */
+export function scanLogs(lines) {
+    for (const line of lines) {
+        if (CRASH_LOG.test(line))
+            return { kind: "crash", line };
+    }
+    for (const line of lines) {
+        if (ANR_LOG.test(line))
+            return { kind: "anr", line };
+    }
+    return undefined;
+}

package/dist/native/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../src/native/signals.ts"],"names":[],"mappings":"AAiBA,MAAM,QAAQ,GAA8C;IAC1D,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,MAAM;IACX,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAsB,EAAE,KAAa,EAAE,aAAsB;IACvF,OAAO,GAAG,IAAI,IAAI,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACpF,CAAC;AAED;+FAC+F;AAC/F,MAAM,UAAU,YAAY,CAC1B,IAAsB,EACtB,KAAa,EACb,OAAe,EACf,OAAoD,EAAE;IAEtD,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;QACxB,OAAO;QACP,GAAG,EAAE,KAAK;QACV,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qSAAqS,CAAC;AAExS,gDAAgD;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,mFAAmF,CAAC;AAE7G,qEAAqE;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,mGAAmG,CAAC;AAE3H,uFAAuF;AACvF,MAAM,UAAU,QAAQ,CAAC,KAAe;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}