Move Hopper loader derivation and compatibility projection into the Hopper adapter so BinaryTarget carries only provider-neutral identity and format metadata. Introduce bounded canonical analysis-profile commitments, exact provider/profile snapshot v2 bindings, legacy snapshot rejection guidance, and backward-compatible profiled Evidence v2 records. Partition cache and replay behavior by target, concrete provider build, and profile while preserving custom Hopper loader overrides. Propagate profiles consistently through CLI, MCP, composed workflows, and session lifecycle; preserve the 78-tool contract and legacy loaderArgs response projection. Add migration documentation, generated API updates, property regressions, package verification, and real Hopper coverage.
95 lines
3.3 KiB
TypeScript
95 lines
3.3 KiB
TypeScript
import { mkdtemp, rm, writeFile } from "node:fs/promises";
|
|
import { tmpdir } from "node:os";
|
|
import { join } from "node:path";
|
|
|
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
|
|
|
import { writeAnalysisSnapshot } from "../src/application/AnalysisSnapshotFiles.js";
|
|
import { runDirectAnalysis } from "../src/application/DirectAnalysis.js";
|
|
import type { AnalysisSnapshot } from "../src/domain/analysisSnapshot.js";
|
|
import {
|
|
snapshotBinding,
|
|
snapshotTarget,
|
|
} from "../src/domain/analysisSnapshot.js";
|
|
import { parseBinaryTarget } from "../src/domain/binaryTarget.js";
|
|
import { createEvidence } from "../src/domain/evidence.js";
|
|
import { createEvidenceBundle } from "../src/domain/evidenceBundle.js";
|
|
import { permissionAuthorityForRoot } from "./fixtures/permissionAuthority.js";
|
|
import {
|
|
REA_WORKFLOW_PROVIDER,
|
|
workflowAnalysisProfile,
|
|
} from "../src/application/InvestigationProviders.js";
|
|
import { HOPPER_PROVIDER_IDENTITY } from "../src/hopper/HopperProvider.js";
|
|
import { resolveHopperAnalysisProfile } from "../src/hopper/HopperAnalysisProfile.js";
|
|
|
|
let directory: string | undefined;
|
|
|
|
afterEach(async () => {
|
|
vi.unstubAllEnvs();
|
|
if (directory !== undefined)
|
|
await rm(directory, { recursive: true, force: true });
|
|
directory = undefined;
|
|
});
|
|
|
|
describe("direct analysis snapshot permissions", () => {
|
|
it("replays a cache hit with snapshot read authority only", async () => {
|
|
directory = await mkdtemp(join(tmpdir(), "rea-direct-snapshot-"));
|
|
const snapshotPath = join(directory, "analysis.json");
|
|
const launcherPath = join(directory, "hopper-launcher");
|
|
await writeFile(launcherPath, "fixture Hopper launcher");
|
|
const target = await parseBinaryTarget(process.execPath);
|
|
if (!target.ok) throw target.error;
|
|
const resolved = await resolveHopperAnalysisProfile(target.value, {
|
|
launcherPath,
|
|
loaderArgsOverride: [],
|
|
provider: HOPPER_PROVIDER_IDENTITY,
|
|
});
|
|
if (!resolved.ok || resolved.value.profile === null)
|
|
throw new Error("fixture Hopper profile did not resolve");
|
|
const profile = resolved.value.profile;
|
|
const workflowProfile = workflowAnalysisProfile(profile);
|
|
const evidence = createEvidence(target.value, REA_WORKFLOW_PROVIDER, {
|
|
operation: "binary_overview",
|
|
parameters: {},
|
|
result: { cached: true },
|
|
analysisProfile: workflowProfile,
|
|
});
|
|
const snapshot: AnalysisSnapshot = {
|
|
snapshot_version: 2,
|
|
target: snapshotTarget(target.value),
|
|
binding: snapshotBinding(profile),
|
|
entries: [],
|
|
evidence_bundle: createEvidenceBundle([evidence]),
|
|
};
|
|
const policy = {
|
|
roots: [directory],
|
|
maxBytes: 1024 * 1024,
|
|
maxDepth: 64,
|
|
maxStringLength: 1024,
|
|
maxNodes: 10_000,
|
|
};
|
|
expect(
|
|
(await writeAnalysisSnapshot(snapshot, snapshotPath, false, policy)).ok,
|
|
).toBe(true);
|
|
const authority = await permissionAuthorityForRoot(
|
|
directory,
|
|
["snapshot_read", "snapshot_write"],
|
|
["snapshot_read"],
|
|
);
|
|
vi.stubEnv("REA_ANALYSIS_SNAPSHOT_ROOTS_JSON", JSON.stringify([directory]));
|
|
vi.stubEnv("HOPPER_LAUNCHER_PATH", launcherPath);
|
|
|
|
await expect(
|
|
runDirectAnalysis(
|
|
process.execPath,
|
|
"binary_overview",
|
|
{},
|
|
{
|
|
snapshotPath,
|
|
permissionAuthority: authority,
|
|
},
|
|
),
|
|
).resolves.toEqual(evidence);
|
|
});
|
|
});
|