mirror of
https://github.com/morluto/rea.git
synced 2026-11-16 11:43:20 +00:00
* 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
109 lines
3.9 KiB
TypeScript
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,
|
|
});
|