Files
reverse-engineering-anything/src/domain/javascript/javascriptSemanticCoverage.ts
T
morluto cb4e5cfbff feat(analysis): make resource budgets recoverable across CLI and MCP (#9706)
* refactor(analysis): centralize resource budgets and recovery facts

* feat(analysis): expose ASAR and Ghidra runtime admission controls

* feat(artifacts): expose reader admission and preserve limited recognition

* feat(javascript): expose recoverable semantic precision budgets

* feat(web): add recoverable source-map budgets and compact retained views

* feat(web): make historical capture decoding budgets recoverable

* fix(desktop): enforce selected view policies across capture and export

* feat(runtime): make Frida and LLDB retention budgets selectable

* feat(native): expose diagnostic budgets and preserve exhaustion causes

* feat(managed): expose recoverable snapshot and representation budgets

* feat(metadata): make Go and Rust inspection budgets recoverable

* feat(wasm): expose representation and producer admissions

* feat(evm): expose per-call worker resource budgets

* feat(android): make resource and string-pool omissions recoverable

* feat(producers): expose command and recorded-capture budgets

* docs(analysis): record recovery contracts and integrated validation

* fix(docs): link calibration oracle from published verification pages

* fix(docs): restore desktop task anchors and receipt links

* test(analysis): align fixtures with selectable budget contracts

* fix(analysis): remove source-location projector dependency cycle

* test(analysis): refresh budget recovery and verifier regressions

* test(analysis): preserve format and publication recovery expectations

* test(windows): align conformance with owned runtime admission

* fix(desktop): preserve selected alias kinds in exported state

* test(analysis): align provider fixtures with recoverable budgets

* test(desktop): validate emitted alias metadata structurally

* fix(ghidra): classify bounded Windows endpoint refusals

* test(cli): assert selectable artifact admission recovery

* fix(cli): preserve capture provenance in environment builds
2026-11-10 05:11:20 -05:00

109 lines
3.9 KiB
TypeScript

import { semanticResourceLimitFacts } from "./javascriptSemanticResourceLimits.js";
import type { JavaScriptSourceRange } from "./javascriptStaticAnalysisTypes.js";
import type { JavaScriptSemanticResourceLimit } from "./javascriptSemanticValueTypes.js";
import type { ApplicationCoverage } from "./javascriptApplicationEvidenceSchemas.js";
import {
JAVASCRIPT_SEMANTIC_PRECISION_DEFAULTS,
type JavaScriptSemanticPrecision,
} from "./javascriptSemanticPrecision.js";
/** Exact retention state for one callable's direct returns. */
export type JavaScriptSemanticReturnCoverage = {
readonly retainedCount: number;
} & {
readonly status: "complete" | "partial";
readonly omittedCount: 0 | null;
};
/** Coverage state for one semantic recovery pass. */
export type JavaScriptSemanticCoverage =
| {
readonly status: "complete";
readonly omittedCount: 0;
readonly resourceLimits?: readonly JavaScriptSemanticResourceLimit[];
readonly precision?: JavaScriptSemanticPrecision;
readonly widenedReturnedReferences?: readonly JavaScriptSourceRange[];
}
| {
readonly status: "partial";
readonly omittedCount: 0 | null;
readonly resourceLimits?: readonly JavaScriptSemanticResourceLimit[];
readonly precision?: JavaScriptSemanticPrecision;
readonly widenedReturnedReferences?: readonly JavaScriptSourceRange[];
}
| {
readonly status: "failed";
readonly omittedCount: null;
readonly resourceLimits?: readonly JavaScriptSemanticResourceLimit[];
readonly precision?: JavaScriptSemanticPrecision;
readonly widenedReturnedReferences?: readonly JavaScriptSourceRange[];
};
/** Source-local effect candidates broadened at a projection merge, without dropping targets. */
export const RETURNED_REFERENCE_WIDENING_LIMITATION =
"Local returned-reference projections were conservatively widened; effects include additional source-local candidates.";
/** Classify whole-file semantic coverage from parsing, value bounds and widened projections. */
export const semanticCoverage = (
parserPartial: boolean,
resourceLimits: readonly JavaScriptSemanticResourceLimit[] = [],
widenedReturnedReferences: readonly JavaScriptSourceRange[] = [],
precision: JavaScriptSemanticPrecision = JAVASCRIPT_SEMANTIC_PRECISION_DEFAULTS,
): JavaScriptSemanticCoverage => {
const details = {
...(widenedReturnedReferences.length > 0
? { widenedReturnedReferences }
: {}),
...(precision === JAVASCRIPT_SEMANTIC_PRECISION_DEFAULTS
? {}
: { precision }),
};
if (resourceLimits.length > 0)
return {
status: "partial",
omittedCount: null,
resourceLimits,
...details,
};
return {
status:
parserPartial || widenedReturnedReferences.length > 0
? "partial"
: "complete",
omittedCount: 0,
...details,
};
};
/** Read typed resource-limit classifications from any coverage state. */
export const semanticCoverageResourceLimits = (
coverage: JavaScriptSemanticCoverage,
): readonly JavaScriptSemanticResourceLimit[] => coverage.resourceLimits ?? [];
/** Effective evaluator facts, rather than reconstructed default-only bounds. */
export const semanticResourceLimitCoverage = (
resourceLimits: readonly JavaScriptSemanticResourceLimit[],
precision: JavaScriptSemanticPrecision = JAVASCRIPT_SEMANTIC_PRECISION_DEFAULTS,
): ApplicationCoverage["limits"] =>
resourceLimits.map((resourceLimit) => {
const { value, unit } = semanticResourceLimitFacts(
resourceLimit,
precision,
);
return {
name: `javascript_semantic_${resourceLimit.replaceAll("-", "_")}`,
value,
unit,
};
});
/** Classify one callable's direct-return coverage. */
export const semanticReturnCoverage = (
retainedCount: number,
parserPartial: boolean,
): JavaScriptSemanticReturnCoverage => ({
status: parserPartial ? "partial" : "complete",
retainedCount,
omittedCount: 0,
});