comber 0.1.0

package/dist/desktop/driver.js

@@ -0,0 +1,433 @@
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { buildDesktopEvidence } from "./evidence.js";
+import { evaluateDesktopReadiness } from "./preflight.js";
+import { blindSpotDetailsOf, macosAccessibilityBlindSpotDetailsOf, macosAccessibilityScreenNameOf, macosAccessibilityScreenSignature, macosAccessibilityViewToSurfaceNodes, viewToSurfaceNodes, windowsScreenNameOf, windowsScreenSignature, } from "./view.js";
+const LAUNCH_ID = "launch";
+const UIA_PATH_PREFIX = "uiapath:";
+const AX_PATH_PREFIX = "axpath:";
+const BASE_SEP = "::";
+const ACTION_SEP = ">>";
+const PROBE_TEXT = "comber-probe";
+const NOOP_COVERAGE = { skip() { }, bumpExtra() { } };
+export class DesktopDriver {
+    name = "desktop";
+    capabilities = {
+        screenshot: false,
+        probes: [
+            { name: "session", slot: "after-goto" },
+            { name: "dom", slot: "after-snapshot" },
+            { name: "crash", slot: "after-exercise" },
+        ],
+    };
+    platform;
+    runner;
+    launchTarget;
+    desktopProfile;
+    cov = NOOP_COVERAGE;
+    signals = [];
+    anchor = { id: LAUNCH_ID, scope: LAUNCH_ID, label: "launch" };
+    baseAnchorId = LAUNCH_ID;
+    currentActions = [];
+    drifted = false;
+    justWentTo = false;
+    anchorFp = "";
+    currentScope = LAUNCH_ID;
+    lastTree;
+    controlsExercised = 0;
+    desktopEvidenceGapsReported = false;
+    observedAutomationTreeArtifacts = new Set();
+    runDir;
+    snapshotArtifactCount = 0;
+    constructor(opts) {
+        const windowsTargetFields = {};
+        if (opts.platform === "windows") {
+            if (opts.processId !== undefined)
+                windowsTargetFields.processId = opts.processId;
+            if (opts.windowTitle !== undefined)
+                windowsTargetFields.windowTitle = opts.windowTitle;
+        }
+        this.platform = opts.platform;
+        this.runner = opts.runner;
+        this.launchTarget = {
+            ...(opts.appId !== undefined ? { appId: opts.appId } : {}),
+            ...(opts.appPath !== undefined ? { appPath: opts.appPath } : {}),
+            ...(opts.processName !== undefined ? { processName: opts.processName } : {}),
+            ...windowsTargetFields,
+        };
+        this.desktopProfile =
+            opts.desktopProfile ?? {
+                platform: opts.platform,
+                ...(opts.appId !== undefined ? { appId: opts.appId } : {}),
+                ...(opts.appPath !== undefined ? { appPath: opts.appPath } : {}),
+                ...(opts.processName !== undefined ? { processName: opts.processName } : {}),
+                ...windowsTargetFields,
+                automationBackend: opts.platform === "windows" ? "uia" : "accessibility",
+            };
+        this.capabilities = {
+            ...this.capabilities,
+            screenshot: typeof this.runner.screenshot === "function",
+        };
+    }
+    attachCoverage(sink) {
+        this.cov = sink;
+    }
+    attachRunDir(runDir) {
+        this.runDir = runDir;
+    }
+    async start() {
+        /* Session establishment is done by goto(), matching the native driver's relaunch model. */
+    }
+    async close() {
+        await this.runner.close().catch(() => { });
+    }
+    entryAddress() {
+        return { id: LAUNCH_ID, scope: LAUNCH_ID, label: "launch" };
+    }
+    currentAddress() {
+        if (!this.drifted)
+            return this.anchor;
+        return { id: `${this.anchor.id}#drifted`, scope: this.anchor.scope, label: "(navigated away)" };
+    }
+    inScope(addr) {
+        return addr.id === LAUNCH_ID || addr.id.startsWith(this.pathPrefix());
+    }
+    async goto(addr) {
+        if (addr.id.startsWith(this.pathPrefix())) {
+            const parsed = parseActionPath(addr.id, this.pathPrefix());
+            await this.relaunch();
+            for (const action of parsed.actions) {
+                await this.runner.perform(action).catch((error) => {
+                    this.signals.push(desktopSignal("frozen", parsed.base, `desktop replay action failed: ${errMessage(error)}`, action.kind));
+                });
+            }
+            this.anchor = { id: addr.id, scope: addr.scope, ...(addr.label !== undefined ? { label: addr.label } : {}) };
+            this.baseAnchorId = parsed.base;
+            this.currentActions = parsed.actions;
+        }
+        else {
+            await this.relaunch();
+            this.anchor = { id: LAUNCH_ID, scope: LAUNCH_ID, label: "launch" };
+            this.baseAnchorId = LAUNCH_ID;
+            this.currentActions = [];
+        }
+        this.drifted = false;
+        this.justWentTo = true;
+        this.anchorFp = "";
+    }
+    async relaunch() {
+        try {
+            await this.runner.launch(this.launchTarget);
+        }
+        catch (error) {
+            this.signals.push(desktopSignal("crash", this.anchor.scope, `desktop launch failed: ${errMessage(error)}`, "launch"));
+        }
+    }
+    async snapshot() {
+        let tree = null;
+        try {
+            tree = await this.runner.snapshot();
+        }
+        catch (error) {
+            this.signals.push(desktopSignal("frozen", this.anchor.scope, `${this.automationLabel()} snapshot failed: ${errMessage(error)}`));
+        }
+        if (!tree) {
+            const details = this.takeDesktopEvidenceGaps(this.anchor.scope);
+            details.unshift({
+                kind: this.platform === "macos" ? "desktop-accessibility-unavailable" : "desktop-automation-unavailable",
+                severity: "blocker-for-exhaustive",
+                scope: this.anchor.scope,
+                message: `${this.automationLabel()} tree was unavailable`,
+            });
+            return {
+                address: { ...this.anchor },
+                title: this.anchor.label,
+                nodes: [],
+                blindSpots: details.length,
+                blindSpotDetails: details,
+            };
+        }
+        tree = await this.persistAutomationTree(tree);
+        this.lastTree = tree;
+        if (tree.artifactPath) {
+            this.observedAutomationTreeArtifacts.add(tree.artifactPath);
+        }
+        if (this.justWentTo) {
+            this.anchorFp = this.screenSignature(tree);
+            this.justWentTo = false;
+        }
+        const label = this.screenNameOf(tree, this.anchor.label ?? this.anchor.scope);
+        const address = { id: this.anchor.id, scope: this.anchor.scope, label };
+        this.currentScope = address.scope;
+        const blindSpotDetails = [...this.blindSpotDetailsOf(tree, address.scope), ...this.takeDesktopEvidenceGaps(address.scope)];
+        return {
+            address,
+            title: label,
+            nodes: this.surfaceNodesOf(tree),
+            blindSpots: blindSpotDetails.length,
+            blindSpotDetails,
+        };
+    }
+    async exercise(node) {
+        const action = this.actionForNode(node);
+        const scope = this.currentScope;
+        const signals = [];
+        try {
+            await this.runner.perform(action);
+            this.controlsExercised++;
+            this.cov.bumpExtra("desktopControlsExercised");
+        }
+        catch (error) {
+            this.drifted = true;
+            signals.push(desktopSignal("frozen", scope, `${node.kind} "${node.label}" did not respond: ${errMessage(error)}`, node.label, node.id));
+            return { signals };
+        }
+        const foreground = await this.runner.foregroundProcess().catch(() => expectedProcessName(this.launchTarget));
+        const expectedProcess = expectedProcessName(this.launchTarget);
+        if (expectedProcess && foreground && normalizeProcessName(foreground) !== normalizeProcessName(expectedProcess)) {
+            this.drifted = true;
+            signals.push(desktopSignal("crash", scope, `desktop app left foreground after "${node.label}" (now: ${foreground})`, node.label, node.id));
+        }
+        let after = null;
+        try {
+            after = await this.runner.snapshot();
+        }
+        catch (error) {
+            this.drifted = true;
+            signals.push(desktopSignal("frozen", scope, `screen unresponsive after "${node.label}": ${errMessage(error)}`, node.label, node.id));
+        }
+        if (after) {
+            if (after.artifactPath) {
+                this.observedAutomationTreeArtifacts.add(after.artifactPath);
+            }
+            const afterFp = this.screenSignature(after);
+            if (this.anchorFp && afterFp !== this.anchorFp) {
+                this.drifted = true;
+                return { signals, discovered: [this.actionPathAddress(after, [...this.currentActions, action])] };
+            }
+        }
+        return { signals };
+    }
+    async probe(phase) {
+        if (phase === "session") {
+            const signals = [];
+            const expectedProcess = expectedProcessName(this.launchTarget);
+            const foreground = await this.runner.foregroundProcess().catch(() => "");
+            if (expectedProcess && foreground && normalizeProcessName(foreground) !== normalizeProcessName(expectedProcess)) {
+                signals.push(desktopSignal("crash", this.anchor.scope, `desktop app not foreground after launch (now: ${foreground})`, "launch"));
+            }
+            try {
+                await this.runner.snapshot();
+            }
+            catch (error) {
+                signals.push(desktopSignal("frozen", this.anchor.scope, `${this.automationLabel()} tree unavailable: ${errMessage(error)}`, "snapshot"));
+            }
+            return signals;
+        }
+        if (phase === "dom") {
+            return this.lastTree ? firstErrorText(this.lastTree, this.currentScope) : [];
+        }
+        if (phase === "crash") {
+            const expectedProcess = expectedProcessName(this.launchTarget);
+            const foreground = await this.runner.foregroundProcess().catch(() => expectedProcess);
+            return expectedProcess && foreground && normalizeProcessName(foreground) !== normalizeProcessName(expectedProcess)
+                ? [desktopSignal("crash", this.currentScope, `desktop app not foreground (now: ${foreground})`, "after-exercise")]
+                : [];
+        }
+        return [];
+    }
+    async softReset() {
+        /* Windows UIA v1 has no generic, safe reset key. The core escalates to goto() when needed. */
+    }
+    drainSignals() {
+        const out = this.signals;
+        this.signals = [];
+        return out;
+    }
+    async screenshot() {
+        return (await this.runner.screenshot?.().catch(() => Buffer.alloc(0))) ?? Buffer.alloc(0);
+    }
+    auditExtra() {
+        return {
+            desktopAudit: {
+                platform: this.platform,
+                automationBackend: this.automationBackend(),
+                appId: this.launchTarget.appId,
+                appPath: this.launchTarget.appPath,
+                processName: this.launchTarget.processName,
+                controlsExercised: this.controlsExercised,
+                egressEnforced: hasCompleteDesktopEgressProxyEvidence(this.currentDesktopEvidence().egressProxy),
+            },
+            desktopEvidence: this.currentDesktopEvidence(),
+            desktopReadiness: this.currentDesktopReadiness(),
+        };
+    }
+    actionPathAddress(after, actions) {
+        const fingerprint = this.screenSignature(after);
+        const label = this.screenNameOf(after, "");
+        const scope = label ? label.toLowerCase().replace(/[^a-z0-9/_-]+/g, "-") : `desktop/${fingerprint.slice(0, 8)}`;
+        return {
+            id: encodeActionPath(this.pathPrefix(), this.baseAnchorId, actions),
+            scope,
+            dedupeKey: `${this.platform}:${fingerprint}`,
+            label: label || scope,
+        };
+    }
+    takeDesktopEvidenceGaps(scope) {
+        if (this.desktopEvidenceGapsReported)
+            return [];
+        this.desktopEvidenceGapsReported = true;
+        return this.currentDesktopEvidence().gaps.map((gap) => ({ ...gap, scope }));
+    }
+    currentDesktopEvidence() {
+        return buildDesktopEvidence(this.currentDesktopProfile());
+    }
+    currentDesktopReadiness() {
+        return evaluateDesktopReadiness(this.currentDesktopProfile());
+    }
+    currentDesktopProfile() {
+        const existingArtifacts = this.desktopProfile.evidenceArtifacts ?? [];
+        const artifactPaths = new Set(existingArtifacts.map((artifact) => `${artifact.kind}:${artifact.path}`));
+        const evidenceArtifacts = existingArtifacts.map((artifact) => ({ ...artifact }));
+        for (const path of this.observedAutomationTreeArtifacts) {
+            const kind = this.platform === "macos" ? "accessibility-tree" : "automation-tree";
+            const key = `${kind}:${path}`;
+            if (artifactPaths.has(key))
+                continue;
+            evidenceArtifacts.push({ kind, path });
+        }
+        return {
+            ...this.desktopProfile,
+            platform: this.platform,
+            automationBackend: this.automationBackend(),
+            ...(this.platform === "windows"
+                ? { uiAutomationTreeAvailable: this.observedAutomationTreeArtifacts.size > 0 || this.desktopProfile.uiAutomationTreeAvailable === true }
+                : { accessibilityPermissionVerified: this.observedAutomationTreeArtifacts.size > 0 || this.desktopProfile.accessibilityPermissionVerified === true }),
+            evidenceArtifacts,
+        };
+    }
+    async persistAutomationTree(tree) {
+        if (tree.artifactPath || this.runDir === undefined)
+            return tree;
+        this.snapshotArtifactCount++;
+        const prefix = this.platform === "macos" ? "desktop-ax-state" : "desktop-uia-state";
+        const artifactPath = join(this.runDir, `${prefix}-${this.snapshotArtifactCount}.json`);
+        try {
+            await writeFile(artifactPath, JSON.stringify(tree, null, 2), "utf8");
+            return { ...tree, artifactPath };
+        }
+        catch (error) {
+            this.signals.push(desktopSignal("desktop-evidence", this.anchor.scope, `failed to write desktop tree artifact: ${errMessage(error)}`));
+            return tree;
+        }
+    }
+    pathPrefix() {
+        return this.platform === "macos" ? AX_PATH_PREFIX : UIA_PATH_PREFIX;
+    }
+    automationBackend() {
+        return this.platform === "macos" ? "accessibility" : "uia";
+    }
+    automationLabel() {
+        return this.platform === "macos" ? "macOS Accessibility" : "Windows UI Automation";
+    }
+    surfaceNodesOf(tree) {
+        return this.platform === "macos"
+            ? macosAccessibilityViewToSurfaceNodes(tree)
+            : viewToSurfaceNodes(tree);
+    }
+    screenNameOf(tree, fallback) {
+        return this.platform === "macos"
+            ? macosAccessibilityScreenNameOf(tree, fallback)
+            : windowsScreenNameOf(tree, fallback);
+    }
+    screenSignature(tree) {
+        return this.platform === "macos"
+            ? macosAccessibilityScreenSignature(tree)
+            : windowsScreenSignature(tree);
+    }
+    blindSpotDetailsOf(tree, scope) {
+        return this.platform === "macos"
+            ? macosAccessibilityBlindSpotDetailsOf(tree, scope)
+            : blindSpotDetailsOf(tree, scope);
+    }
+    actionForNode(node) {
+        if (this.platform === "macos") {
+            return macosActionForHandle(node.handle);
+        }
+        return windowsActionForHandle(node.handle);
+    }
+}
+function windowsActionForHandle(handle) {
+    if (handle.actionKind === "set-value") {
+        return { kind: "set-value", selector: handle.selector, value: PROBE_TEXT };
+    }
+    if (handle.actionKind === "range") {
+        return { kind: "range", selector: handle.selector, delta: 1 };
+    }
+    return { kind: handle.actionKind, selector: handle.selector };
+}
+function macosActionForHandle(handle) {
+    if (handle.actionKind === "set-value") {
+        return { kind: "set-value", selector: handle.selector, value: PROBE_TEXT };
+    }
+    if (handle.actionKind === "increment" || handle.actionKind === "decrement") {
+        return { kind: handle.actionKind, selector: handle.selector, delta: 1 };
+    }
+    return { kind: handle.actionKind, selector: handle.selector };
+}
+function hasCompleteDesktopEgressProxyEvidence(proxy) {
+    return proxy?.verified === true && Boolean(proxy.provider && proxy.command && proxy.artifactPath);
+}
+function expectedProcessName(target) {
+    if (target.processId !== undefined)
+        return "";
+    const processName = target.processName ?? target.appPath?.split(/[\\/]/).pop() ?? "";
+    return processName.replace(/\.exe$/i, "").replace(/\.app$/i, "");
+}
+function normalizeProcessName(value) {
+    return value.replace(/\.exe$/i, "").toLowerCase();
+}
+function encodeActionPath(prefix, base, actions) {
+    const tokens = actions.map((action) => Buffer.from(JSON.stringify(action), "utf8").toString("base64url"));
+    return `${prefix}${base}${BASE_SEP}${tokens.join(ACTION_SEP)}`;
+}
+function parseActionPath(id, prefix) {
+    const body = id.slice(prefix.length);
+    const sep = body.indexOf(BASE_SEP);
+    const base = sep < 0 ? body : body.slice(0, sep);
+    const actionText = sep < 0 ? "" : body.slice(sep + BASE_SEP.length);
+    const actions = actionText
+        ? actionText.split(ACTION_SEP).map((token) => JSON.parse(Buffer.from(token, "base64url").toString("utf8")))
+        : [];
+    return { base, actions };
+}
+function errMessage(error) {
+    return (error instanceof Error ? error.message : String(error)).slice(0, 160);
+}
+function desktopSignal(kind, scope, message, action, discriminator) {
+    return {
+        kind,
+        severity: kind === "crash" ? "fail" : "warn",
+        message,
+        url: scope,
+        signature: `desktop:${kind}:${scope}:${action ?? ""}:${discriminator ?? ""}:${message.slice(0, 80)}`,
+        ...(action !== undefined ? { action } : {}),
+    };
+}
+function isWindowsUiaNode(node) {
+    return "controlType" in node || "automationId" in node || "name" in node;
+}
+function firstErrorText(tree, scope) {
+    const stack = [tree.root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        const text = isWindowsUiaNode(node) ? (node.name ?? "").trim() : `${node.title ?? ""} ${node.value ?? ""}`.trim();
+        if (/\b(error|failed|exception|not responding|crash|fatal)\b/i.test(text)) {
+            return [desktopSignal("error-text", scope, `on-screen desktop error: ${text.slice(0, 120)}`)];
+        }
+        for (const child of node.children ?? []) {
+            stack.push(child);
+        }
+    }
+    return [];
+}

package/dist/desktop/driver.js.map

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

package/dist/desktop/evidence.js

@@ -0,0 +1,206 @@
+import { normalizeDesktopProfile } from "./desktop-profile.js";
+const VALID_ARTIFACT_KINDS = new Set([
+    "screenshot",
+    "video",
+    "log",
+    "crash-log",
+    "accessibility-tree",
+    "automation-tree",
+]);
+const VALID_AUTOMATION_BACKENDS = new Set([
+    "accessibility",
+    "xctest",
+    "uia",
+    "unknown",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function hasAppIdentity(profile) {
+    return isNonEmptyString(profile.appId) || isNonEmptyString(profile.appPath) || isNonEmptyString(profile.processName);
+}
+function isPlatform(value) {
+    return value === "macos" || value === "windows";
+}
+function isAutomationBackend(value) {
+    return typeof value === "string" && VALID_AUTOMATION_BACKENDS.has(value);
+}
+function isArtifactKind(value) {
+    return typeof value === "string" && VALID_ARTIFACT_KINDS.has(value);
+}
+function hasPathTraversal(value) {
+    return value.replace(/\\/g, "/").split("/").includes("..");
+}
+function addValidationIssue(errors, code, field, message) {
+    errors.push({ code, field, message });
+}
+function validateEvidenceArtifacts(errors, artifactsValue) {
+    const artifacts = Array.isArray(artifactsValue) ? artifactsValue : [];
+    for (let index = 0; index < artifacts.length; index++) {
+        const artifact = artifacts[index];
+        const field = `evidenceArtifacts[${index}]`;
+        if (!isRecord(artifact)) {
+            addValidationIssue(errors, "evidence-artifact-kind-invalid", `${field}.kind`, "Evidence artifact must be an object");
+            continue;
+        }
+        if (!isArtifactKind(artifact.kind)) {
+            addValidationIssue(errors, "evidence-artifact-kind-invalid", `${field}.kind`, "Evidence artifact kind must be screenshot, video, log, crash-log, accessibility-tree, or automation-tree");
+        }
+        if (!isNonEmptyString(artifact.path)) {
+            addValidationIssue(errors, "evidence-artifact-path-missing", `${field}.path`, "Evidence artifact path must be non-empty");
+        }
+        else if (hasPathTraversal(artifact.path)) {
+            addValidationIssue(errors, "evidence-artifact-path-traversal", `${field}.path`, "Evidence artifact path must not contain '..'");
+        }
+    }
+}
+function validateEgressProxy(errors, proxy) {
+    if (proxy?.verified !== true)
+        return;
+    if (!isNonEmptyString(proxy.provider)) {
+        addValidationIssue(errors, "egress-proxy-provider-missing", "egressProxy.provider", "Verified proxy evidence requires a provider");
+    }
+    if (!isNonEmptyString(proxy.command)) {
+        addValidationIssue(errors, "egress-proxy-command-missing", "egressProxy.command", "Verified proxy evidence requires the proxy command");
+    }
+    if (!isNonEmptyString(proxy.artifactPath)) {
+        addValidationIssue(errors, "egress-proxy-artifact-missing", "egressProxy.artifactPath", "Verified proxy evidence requires an artifact path");
+    }
+}
+export function validateDesktopAppProfile(input) {
+    const profile = normalizeDesktopProfile(input);
+    const errors = [];
+    if (!hasAppIdentity(profile)) {
+        addValidationIssue(errors, "app-identity-missing", "appId", "Desktop evidence requires an app id, path, or process name");
+    }
+    if (!isPlatform(profile.platform)) {
+        addValidationIssue(errors, "platform-invalid", "platform", "Desktop evidence platform must be macos or windows");
+    }
+    if (!isAutomationBackend(profile.automationBackend)) {
+        addValidationIssue(errors, "automation-backend-invalid", "automationBackend", "Desktop automation backend must be accessibility, xctest, uia, or unknown");
+    }
+    validateEvidenceArtifacts(errors, profile.evidenceArtifacts);
+    if (profile.providerRunId !== undefined && !isNonEmptyString(profile.provider)) {
+        addValidationIssue(errors, "provider-required-for-run-id", "provider", "Provider run id requires provider metadata");
+    }
+    validateEgressProxy(errors, profile.egressProxy);
+    return { errors };
+}
+function validEvidenceArtifacts(profile) {
+    const artifacts = Array.isArray(profile.evidenceArtifacts) ? profile.evidenceArtifacts : [];
+    const out = [];
+    for (const artifact of artifacts) {
+        if (!isRecord(artifact))
+            continue;
+        if (!isArtifactKind(artifact.kind))
+            continue;
+        if (!isNonEmptyString(artifact.path))
+            continue;
+        if (hasPathTraversal(artifact.path))
+            continue;
+        out.push({ kind: artifact.kind, path: artifact.path });
+    }
+    return out;
+}
+function pathsForKind(artifacts, kind) {
+    const out = [];
+    for (const artifact of artifacts) {
+        if (artifact.kind === kind)
+            out.push(artifact.path);
+    }
+    return out;
+}
+function hasCompleteDesktopEgressProxyEvidence(proxy) {
+    return proxy?.verified === true && Boolean(proxy.provider && proxy.command && proxy.artifactPath);
+}
+function desktopEgressGap(profile) {
+    if (hasCompleteDesktopEgressProxyEvidence(profile.egressProxy))
+        return undefined;
+    if (profile.egressProxy?.verified === true) {
+        return {
+            kind: "desktop-egress-unenforced",
+            severity: "blocker-for-exhaustive",
+            scope: profile.platform,
+            message: "Desktop network egress proxy was marked verified, but verified proxy evidence is incomplete; provide provider, command, and artifact",
+        };
+    }
+    return {
+        kind: "desktop-egress-unenforced",
+        severity: "blocker-for-exhaustive",
+        scope: profile.platform,
+        message: "Desktop network egress is not enforced without verified OS-level proxy evidence",
+    };
+}
+function platformEvidenceGaps(profile, artifacts) {
+    const gaps = [];
+    if (profile.platform === "macos") {
+        const hasAccessibilityTree = pathsForKind(artifacts, "accessibility-tree").length > 0;
+        if (profile.accessibilityPermissionVerified !== true || !hasAccessibilityTree) {
+            gaps.push({
+                kind: "desktop-accessibility-unavailable",
+                severity: "blocker-for-exhaustive",
+                scope: "macos",
+                message: "macOS desktop coverage requires verified Accessibility permission and an accessibility-tree artifact",
+            });
+        }
+    }
+    if (profile.platform === "windows") {
+        const hasAutomationTree = profile.uiAutomationTreeAvailable === true || pathsForKind(artifacts, "automation-tree").length > 0;
+        if (!hasAutomationTree) {
+            gaps.push({
+                kind: "desktop-automation-unavailable",
+                severity: "blocker-for-exhaustive",
+                scope: "windows",
+                message: "Windows desktop coverage requires UI Automation tree evidence",
+            });
+        }
+    }
+    return gaps;
+}
+export function buildDesktopEvidence(input) {
+    const profile = normalizeDesktopProfile(input);
+    const validation = validateDesktopAppProfile(profile);
+    const evidenceArtifacts = validEvidenceArtifacts(profile);
+    const egressGap = desktopEgressGap(profile);
+    const validationGaps = validation.errors.length > 0
+        ? [
+            {
+                kind: "desktop-evidence-invalid",
+                severity: "blocker-for-exhaustive",
+                scope: profile.platform,
+                message: `Desktop evidence validation failed: ${validation.errors.map((error) => error.code).join(", ")}`,
+            },
+        ]
+        : [];
+    const gaps = [
+        ...(egressGap ? [egressGap] : []),
+        ...validationGaps,
+        ...platformEvidenceGaps(profile, evidenceArtifacts),
+    ];
+    return {
+        platform: profile.platform,
+        ...(profile.appId !== undefined ? { appId: profile.appId } : {}),
+        ...(profile.appPath !== undefined ? { appPath: profile.appPath } : {}),
+        ...(profile.processName !== undefined ? { processName: profile.processName } : {}),
+        ...(profile.appVersion !== undefined ? { appVersion: profile.appVersion } : {}),
+        ...(profile.osVersion !== undefined ? { osVersion: profile.osVersion } : {}),
+        automationBackend: profile.automationBackend ?? "unknown",
+        ...(profile.provider !== undefined ? { provider: profile.provider } : {}),
+        ...(profile.providerRunId !== undefined ? { providerRunId: profile.providerRunId } : {}),
+        ...(profile.launchCommand !== undefined ? { launchCommand: profile.launchCommand } : {}),
+        ...(profile.verificationCommand !== undefined ? { verificationCommand: profile.verificationCommand } : {}),
+        evidenceArtifacts: evidenceArtifacts.map((artifact) => ({ ...artifact })),
+        screenshots: pathsForKind(evidenceArtifacts, "screenshot"),
+        videos: pathsForKind(evidenceArtifacts, "video"),
+        logs: pathsForKind(evidenceArtifacts, "log"),
+        crashLogs: pathsForKind(evidenceArtifacts, "crash-log"),
+        accessibilityTrees: pathsForKind(evidenceArtifacts, "accessibility-tree"),
+        automationTrees: pathsForKind(evidenceArtifacts, "automation-tree"),
+        ...(profile.egressProxy !== undefined ? { egressProxy: { ...profile.egressProxy } } : {}),
+        validationErrors: validation.errors.map((error) => ({ ...error })),
+        gaps,
+    };
+}