* test(mcp): expect trace_feature to report references the provider truncated A provider that reports a capped xrefs read makes the trace truncated with a residual unknown for that target. An explicit complete report and a provider that reports nothing leave the trace as before. * fix(mcp): report references a provider truncated in trace_feature Executions gain an optional flag for a capped xrefs read, set by the IDA adapter from the upstream cap. trace_feature marks the trace truncated with a residual unknown for that target only when the provider reports a truncation; a provider that reports nothing keeps its previous result. The trace_feature workflow profile is revised so earlier results are not replayed. * refactor(ida): report reference truncation whenever the runner observed an xrefs cap * test(mcp): cover session forwarding, per-target state, native reports and failures of the trace coverage * test(mcp): format the session forwarding test * test(ida): expect headless IDA to resolve containing procedures from lookups and segment facts Cover positive and negative containment, segment boundaries including addresses above 2^53, failures of the lookup and of the segment survey, cancellation, input validation and the admitted program as the only document. * test(ida): expect feature tracing and address context to work on headless IDA Run trace_feature, including a capped reference read, and inspect_address_context with and without an explicit document through the IDA session client. * test(mcp): expect trace_feature availability to follow the search operations it calls * fix(mcp): derive trace_feature availability from the search operations it calls * feat(ida): resolve containing procedures and report the admitted program as the document The modern headless profile resolves an address through the function lookup and, when no function contains it, tells a mapped address from an unmapped one using the database-scoped minimal survey. A survey that is missing, truncated or inconsistent fails the read. list_documents reports the single admitted program. The attached profiles do not declare either operation. * docs(ida): describe containing procedures, the admitted document and truncated feature traces * test(ida): verify containing procedures, the admitted document and feature tracing on real IDA * docs(testing): list the headless IDA workflows the real lane verifies * test(ida): make each survey failure case isolate a single defect * test(ida): pin large addresses, segment order, document identity, attached refusals and each trace_feature prerequisite * test(mcp): expect a repeated reference source to be resolved once in trace_feature * fix(mcp): resolve the containing procedure of a repeated reference source once * test(ida): trace the fixture procedure and derive probe addresses from its facts in the real lane * test(process): format processCaptureLifecycle.test.ts after the merge * test(ida): declare the alignment each synthetic universal slice offset satisfies * refactor(ida): move the real lane's feature trace assertions into a helper * test(ida): expect the real lane's feature trace check to accept references to every matched address * fix(ida): check each trace reference against its own matched address in the real lane * test(ida): pin that the new operations reject a document other than the admitted program * refactor(ida): move the real lane's mapped non-function probe into a helper * test(ida): expect the real lane's mapped data probe to skip strings inside functions * fix(ida): try the target's strings in order for the mapped non-function probe * test(ida): declare the real lane helper types for the verifier tests * test(ida): expect the real lane to reject a listed string that resolves as unmapped * fix(ida): fail the real lane when a listed string resolves as unmapped
162 lines
5.1 KiB
TypeScript
162 lines
5.1 KiB
TypeScript
import type { AnalysisOperation } from "./AnalysisProvider.js";
|
|
import {
|
|
createAnalysisProfile,
|
|
type AnalysisProfileCommitment,
|
|
} from "../domain/analysisProfile.js";
|
|
|
|
/** Provider identity for deterministic composed analysis workflows. */
|
|
export const REA_WORKFLOW_PROVIDER = {
|
|
id: "rea-workflow",
|
|
name: "REA composed investigation workflow",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Commit a workflow result to its upstream profile and applicable semantic revision. */
|
|
export const workflowAnalysisProfile = (
|
|
upstream: AnalysisProfileCommitment,
|
|
operation?: AnalysisOperation,
|
|
): AnalysisProfileCommitment =>
|
|
createAnalysisProfile(REA_WORKFLOW_PROVIDER, {
|
|
upstream_analysis_profile: upstream,
|
|
...(operation === "binary_overview"
|
|
? { workflow_revision: 3 }
|
|
: operation === "batch_decompile" ||
|
|
operation === "get_call_graph" ||
|
|
operation === "trace_feature"
|
|
? { workflow_revision: 2 }
|
|
: {}),
|
|
});
|
|
|
|
/** Provider identity for deterministic artifact inventories. */
|
|
export const ARTIFACT_GRAPH_PROVIDER = Object.freeze({
|
|
id: "rea-artifact-graph",
|
|
name: "REA safe artifact graph provider",
|
|
version: "1",
|
|
} as const);
|
|
|
|
/** Provider identity for execution-free managed PE/CLI analysis. */
|
|
export const MANAGED_STATIC_PROVIDER = Object.freeze({
|
|
id: "rea-dotnet-static",
|
|
name: "REA managed static analysis provider",
|
|
version: "1",
|
|
} as const);
|
|
|
|
/** Provider identity for portable, execution-free PE resource decoding. */
|
|
export const PE_RESOURCES_PROVIDER = Object.freeze({
|
|
id: "rea-pe-resources",
|
|
name: "REA PE resource parser",
|
|
version: "1",
|
|
} as const);
|
|
|
|
/** Provider identity for deterministic managed-code comparison workflows. */
|
|
export const MANAGED_WORKFLOW_PROVIDER = {
|
|
id: "rea-dotnet-workflows",
|
|
name: "REA managed-code workflows",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic Apple application projections. */
|
|
export const APPLE_APPLICATION_PROVIDER = {
|
|
id: "rea-apple-application",
|
|
name: "REA Apple application workflows",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic Android application projections. */
|
|
export const ANDROID_APPLICATION_PROVIDER = {
|
|
id: "rea-android-application",
|
|
name: "REA Android application workflows",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic HarmonyOS application projections. */
|
|
export const HARMONY_APPLICATION_PROVIDER = {
|
|
id: "rea-harmony-application",
|
|
name: "REA HarmonyOS application workflows",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for verified publication of retained website scripts. */
|
|
export const WEB_SCRIPT_EXPORT_PROVIDER = {
|
|
id: "rea-web-script-export",
|
|
name: "REA captured script export",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic static JavaScript application analysis. */
|
|
export const JAVASCRIPT_APPLICATION_PROVIDER = {
|
|
id: "rea-javascript-application",
|
|
name: "REA JavaScript application analyzer",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for static/passive-runtime JavaScript reconciliation. */
|
|
export const JAVASCRIPT_RUNTIME_RECONCILIATION_PROVIDER = {
|
|
id: "rea-javascript-runtime-reconciliation",
|
|
name: "REA JavaScript runtime reconciliation",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for selected views of retained analysis Evidence. */
|
|
export const ANALYSIS_VIEW_PROVIDER = {
|
|
id: "rea-analysis-view",
|
|
name: "REA analysis view projection",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for graph-native feature tracing and version comparison. */
|
|
export const JAVASCRIPT_APPLICATION_WORKFLOW_PROVIDER = {
|
|
id: "rea-javascript-application-workflows",
|
|
name: "REA JavaScript application workflows",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic cross-artifact comparisons. */
|
|
export const ARTIFACT_COMPARISON_PROVIDER = {
|
|
id: "rea-artifact-comparison",
|
|
name: "REA artifact comparison",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic cross-function comparisons. */
|
|
export const FUNCTION_COMPARISON_PROVIDER = {
|
|
id: "rea-function-comparison",
|
|
name: "REA function comparison",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for deterministic Evidence bundle comparisons. */
|
|
export const BUNDLE_COMPARISON_PROVIDER = {
|
|
id: "rea-bundle-comparison",
|
|
name: "REA Evidence bundle comparison",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for comparison-Evidence behavior aggregation. */
|
|
export const CHANGED_BEHAVIOR_PROVIDER = {
|
|
id: "rea-changed-behavior",
|
|
name: "REA changed behavior investigation",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for Evidence-backed call-path reconstruction. */
|
|
export const CALL_PATH_PROVIDER = {
|
|
id: "rea-call-path",
|
|
name: "REA call path reconstruction",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for explicit static/runtime hypothesis correlation. */
|
|
export const STATIC_RUNTIME_PROVIDER = {
|
|
id: "rea-static-runtime-correlation",
|
|
name: "REA static/runtime correlation",
|
|
version: "1",
|
|
} as const;
|
|
|
|
/** Provider identity for finite reconstruction specification verification. */
|
|
export const RECONSTRUCTION_PROVIDER = {
|
|
id: "rea-reconstruction-verifier",
|
|
name: "REA reconstruction verifier",
|
|
version: "1",
|
|
} as const;
|