feat(native): admit raw binaries with caller-supplied architecture and entry (#1868)

* feat(native): admit raw binaries with caller-supplied architecture and entry

* fix(native): honor raw-binary preparation and entry identity

* fix(ghidra): stream raw snapshot attestation with cancellation

* fix(native): preserve and validate raw lifecycle entries

---------

Co-authored-by: morluto <76467478+morluto@users.noreply.github.com>

src/application/binary/BinarySessionOpen.ts

@@ -1,4 +1,5 @@
 import type { ExecutableFormatHint } from "../../domain/dosCom.js";
+import type { BinaryArchitecture } from "../../domain/binaryTargetTypes.js";
 import type { AnalysisProviderSelector } from "../../contracts/providerSelection.js";
 import type { AnalysisProfileCommitment } from "../../domain/analysisProfile.js";
 import {
@@ -22,6 +23,8 @@ export interface BinarySessionOpenOptions {
   readonly signal?: AbortSignal;
   readonly targetKind?: BinaryTarget["kind"];
   readonly formatHint?: ExecutableFormatHint;
+  readonly architecture?: BinaryArchitecture;
+  readonly entryPoint?: string;
   readonly snapshot?: AnalysisSnapshot;
   readonly providerId?: AnalysisProviderSelector;
 }
@@ -72,6 +75,12 @@ export const resolveSessionOpen = async (
     ...(options.formatHint === undefined
       ? {}
       : { formatHint: options.formatHint }),
+    ...(options.architecture === undefined
+      ? {}
+      : { architecture: options.architecture }),
+    ...(options.entryPoint === undefined
+      ? {}
+      : { entryPoint: options.entryPoint }),
     ...(options.signal === undefined ? {} : { signal: options.signal }),
   });
   if (!parsed.ok) return parsed;

src/application/binary/BinarySessionPort.ts

@@ -1,6 +1,9 @@
 import type { InvestigationRecordPort } from "../investigation/InvestigationRecordPort.js";
 import type { ExecutableFormatHint } from "../../domain/dosCom.js";
-import type { BinaryTarget } from "../../domain/binaryTargetTypes.js";
+import type {
+  BinaryArchitecture,
+  BinaryTarget,
+} from "../../domain/binaryTargetTypes.js";
 import type { JsonValue } from "../../domain/jsonValue.js";
 import type { AnalysisSnapshot } from "../../domain/analysisSnapshot.js";
 import type { AnalysisProfileCommitment } from "../../domain/analysisProfile.js";
@@ -44,6 +47,8 @@ export interface BinarySessionPort
       readonly signal?: AbortSignal;
       readonly targetKind?: BinaryTarget["kind"];
       readonly formatHint?: ExecutableFormatHint;
+      readonly architecture?: BinaryArchitecture;
+      readonly entryPoint?: string;
       readonly snapshot?: AnalysisSnapshot;
       readonly providerId?: AnalysisProviderSelector;
     },

src/application/binary/BinarySessionStatus.ts

@@ -1,4 +1,5 @@
 import type { BinaryTarget } from "../../domain/binaryTargetTypes.js";
+import { binaryTargetSummary } from "./BinaryTargetSummary.js";
 import type { JsonValue } from "../../domain/jsonValue.js";
 import type { ProviderOperationHealth } from "../../domain/providerOperationHealth.js";
 import type {
@@ -92,11 +93,7 @@ export const binarySessionStatus = ({
     : {
         open: true,
         ...common,
-        path: target.path,
-        sha256: target.sha256,
-        format: target.format,
-        kind: target.kind,
-        architecture: target.architecture ?? null,
+        ...binaryTargetSummary(target),
       };
 };
 

src/application/binary/BinaryTargetSummary.ts

@@ -0,0 +1,11 @@
+import type { BinaryTarget } from "../../domain/binaryTargetTypes.js";
+
+/** Preserve the admitted target interpretation in public lifecycle results. */
+export const binaryTargetSummary = (target: BinaryTarget) => ({
+  path: target.path,
+  format: target.format,
+  kind: target.kind,
+  sha256: target.sha256,
+  architecture: target.architecture ?? null,
+  ...(target.format === "raw-binary" ? { entry_point: target.entryPoint } : {}),
+});