From 87b23482e28ed4e43674c4b9a775da4b16cb4636 Mon Sep 17 00:00:00 2001
From: N0zoM1z0 <1705004398@qq.com>
Date: Thu, 16 Jul 2026 08:52:32 +0800
Subject: [PATCH] docs: refresh runtime reconciliation API
---
...vaScriptRuntimeReconciliationEvidence.html | 2 +-
...ce.reconcileJavaScriptRuntimeEvidence.html | 2 +-
...criptEvents.ingestElectronScriptEvent.html | 2 +-
...lectronScripts.captureElectronScripts.html | 2 +-
...lectronWorkers.captureElectronWorkers.html | 2 +-
...imeLoadState.classifyStaticLoadStates.html | 2 +-
...nciliation.reconcileJavaScriptRuntime.html | 2 +-
...Graph.buildReconciledApplicationGraph.html | 2 +-
...tionMatching.reconcileRuntimeEntities.html | 2 +-
...ReconciliationParsing.digestCanonical.html | 2 +-
...ciliationParsing.parseRuntimeCaptures.html | 2 +-
...conciliationParsing.parseStaticLayers.html | 2 +-
...JavaScriptRuntimeReconciliationResult.html | 2 +-
...liationRuntime.projectRuntimeCaptures.html | 2 +-
...idates.collectStaticRuntimeCandidates.html | 2 +-
...icCandidates.createStaticRuntimeScope.html | 2 +-
...meStaticCandidates.mappedRuntimePaths.html | 2 +-
...ndidates.staticNodeWithinRuntimeScope.html | 2 +-
...ctronScriptEvents.ElectronScriptDraft.html | 16 +++++++--------
...meLoadState.StaticLoadStateProjection.html | 6 +++---
....ReconciledApplicationGraphProjection.html | 6 +++---
...ionMatching.RuntimeMatchingProjection.html | 8 ++++----
...conciliationParsing.ParsedStaticLayer.html | 16 +++++++--------
...conciliationRuntime.RuntimeProjection.html | 12 +++++------
...onRuntime.RuntimeReconciliationEntity.html | 20 +++++++++----------
...imeStaticCandidates.MappedRuntimePath.html | 6 +++---
...aticCandidates.StaticRuntimeCandidate.html | 12 +++++------
...meStaticCandidates.StaticRuntimeScope.html | 6 +++---
...ciliationParsing.ParsedRuntimeCapture.html | 2 +-
...s.JavaScriptRuntimeReconciliationItem.html | 2 +-
...JavaScriptRuntimeReconciliationResult.html | 2 +-
...tionSchemas.JavaScriptStaticLoadState.html | 2 +-
...hemas.ReconcileJavaScriptRuntimeInput.html | 2 +-
...SCRIPT_RUNTIME_RECONCILIATION_EXAMPLE.html | 2 +-
...riptRuntimeReconciliationResultSchema.html | 2 +-
...reconcileJavaScriptRuntimeInputSchema.html | 2 +-
36 files changed, 80 insertions(+), 80 deletions(-)
diff --git a/docs/api/functions/application_JavaScriptRuntimeReconciliationEvidence.createJavaScriptRuntimeReconciliationEvidence.html b/docs/api/functions/application_JavaScriptRuntimeReconciliationEvidence.createJavaScriptRuntimeReconciliationEvidence.html
index 10f6471d1..3febee4c9 100644
--- a/docs/api/functions/application_JavaScriptRuntimeReconciliationEvidence.createJavaScriptRuntimeReconciliationEvidence.html
+++ b/docs/api/functions/application_JavaScriptRuntimeReconciliationEvidence.createJavaScriptRuntimeReconciliationEvidence.html
@@ -25,7 +25,7 @@
result: {
coverage: {
omitted_graph_items: number;
omitted_reconciliation_items: number;
omitted_runtime_entities: number;
omitted_static_load_states: number;
status: "truncated" | "partial" | "complete-within-inputs";
truncated: boolean;
};
evidence_links: string[];
graph: {
coverage: {
limits: {
name: string;
unit: | "other"
| "items"
| "bytes"
| "depth"
| "milliseconds"
| "characters"
| "instructions";
value: number;
}[];
omitted_count: number
| null;
status: "unknown" | "unavailable" | "complete" | "partial";
truncated: boolean;
};
edges: {
edge_id: string;
evidence: {
artifact: | { artifact_id: string; available: true; sha256: string }
| {
available: false;
detail: string;
reason:
| "unknown"
| "truncated"
| "unresolved"
| "not-applicable"
| "not-observed"
| "not-approved"
| "provider-unavailable";
};
authority: | "unknown"
| "controlled-replay"
| "historical-reference"
| "artifact-bytes"
| "ast-static-analysis"
| "static-relationship-inference"
| "passive-cdp-runtime"
| "cross-layer-reconciliation"
| "native-analysis-provider"
| "user-assertion";
confidence: "unknown"
| "exact"
| "low"
| "medium"
| "high";
coverage: {
limits: {
name: string;
unit:
| "other"
| "items"
| "bytes"
| "depth"
| "milliseconds"
| "characters"
| "instructions";
value: number;
}[];
omitted_count: number
| null;
status: "unknown" | "unavailable" | "complete" | "partial";
truncated: boolean;
};
evidence_ids: string[];
extractor: {
executable_sha256: string
| null;
name: string;
operation: string;
version: string;
};
limitations: string[];
location: | {
available: false;
detail: string;
reason: | "unknown"
| "truncated"
| "unresolved"
| "not-applicable"
| "not-observed"
| "not-approved"
| "provider-unavailable";
}
| {
available: true;
value: | {
end: { column: number; line: number };
kind: "source-range";
source: string;
start: { column: number; line: number };
}
| { end: number; kind: "file-offset-range"; start: number }
| { kind: "artifact-path"; path: string }
| { kind: "url"; url: string }
| {
capture_sha256: string;
frame_key: string | null;
kind: "runtime";
script_key: string | null;
target_key: string;
}
| { address: string; kind: "native-address"; symbol: string
| null }
| { export_path: string; kind: "package-export"; package_name: string };
};
state: "unknown"
| "observed"
| "inferred"
| "unavailable";
};
identifier_strategy: {
stability: "relationship-exact";
strategy: "semantic-content-sha256";
};
properties: Record<string, JSONType>;
relation:
| "contains"
| "loads"
| "calls"
| "imports"
| "maps_to"
| "exposes"
| "sends"
| "invokes"
| "handles"
| "persists_to"
| "observed_as"
| "changed_from";
source_node_id: string;
target_node_id: string;
}[];
graph_id: string;
limitations: string[];
nodes: {
identity: | {
sha256: string;
stability: "global-exact";
strategy: "content-digest";
}
| {
original_source: string;
source_map_sha256: string;
source_sha256: string
| null;
stability: "source-map-exact";
strategy: "source-map-original";
}
| {
artifact_sha256: string;
path: string;
stability: "artifact-version";
strategy: "canonical-path";
}
| {
algorithm: string;
basis: (
| "imports"
| "exports"
| "syntax-tree"
| "control-flow"
| "literals"
| "api-usage"
)[];
fingerprint_sha256: string;
stability: "cross-version-inference";
strategy: "structural-fingerprint";
}
| {
artifact_sha256: string;
key: string;
namespace: string;
stability: "artifact-version";
strategy: "artifact-local-key";
}
| {
capture_sha256: string;
runtime_key: string;
stability: "capture-only";
strategy: "runtime-instance";
}
| {
observation_sha256: string;
scope: string;
stability: "observation-only";
strategy: "observation-fingerprint";
};
kind: | "unknown"
| "target"
| "native-addon"
| "source-map"
| "artifact"
| "package"
| "storage"
| "installer"
| "asar-entry"
| "electron-main"
| "electron-preload"
| "electron-renderer"
| "electron-utility"
| "javascript-asset"
| "javascript-chunk"
| "javascript-module"
| "source-module"
| "browser-window"
| "frame"
| "context-bridge-api"
| "ipc-channel"
| "ipc-handler"
| "worker"
| "service-worker"
| "endpoint"
| "native-export"
| "runtime-script-instance";
node_id: string;
observations: {
evidence: {
artifact: | { artifact_id: string; available: true; sha256: string }
| {
available: false;
detail: string;
reason:
| "unknown"
| "truncated"
| "unresolved"
| "not-applicable"
| "not-observed"
| "not-approved"
| "provider-unavailable";
};
authority: | "unknown"
| "controlled-replay"
| "historical-reference"
| "artifact-bytes"
| "ast-static-analysis"
| "static-relationship-inference"
| "passive-cdp-runtime"
| "cross-layer-reconciliation"
| "native-analysis-provider"
| "user-assertion";
confidence: "unknown"
| "exact"
| "low"
| "medium"
| "high";
coverage: {
limits: {
name: string;
unit: (...) | (...) | (...) | (...) | (...) | (...) | (...);
value: number;
}[];
omitted_count: number
| null;
status: "unknown" | "unavailable" | "complete" | "partial";
truncated: boolean;
};
evidence_ids: string[];
extractor: {
executable_sha256: string
| null;
name: string;
operation: string;
version: string;
};
limitations: string[];
location: | {
available: false;
detail: string;
reason: | "unknown"
| "truncated"
| "unresolved"
| "not-applicable"
| "not-observed"
| "not-approved"
| "provider-unavailable";
}
| {
available: true;
value: | { end: ...; kind: ...; source: ...; start: ... }
| { end: ...; kind: ...; start: ... }
| { kind: ...; path: ... }
| { kind: ...; url: ... }
| {
capture_sha256: ...;
frame_key: ...;
kind: ...;
script_key: ...;
target_key: ...;
}
| { address: ...; kind: ...; symbol: ... }
| { export_path: ...; kind: ...; package_name: ... };
};
state: "unknown"
| "observed"
| "inferred"
| "unavailable";
};
identifier_strategy: {
stability: "observation-exact";
strategy: "semantic-content-sha256";
};
label: string
| null;
observation_id: string;
properties: Record<string, JSONType>;
}[];
}[];
root_node_ids: string[];
schema: "JavaScriptApplicationGraph";
schema_version: 1;
};
limitations: string[];
reconciliation_id: string;
reconciliations: {
basis: | "none"
| "artifact-path"
| "content-and-location"
| "content-sha256"
| "module-source-sha256"
| "operator-file-mapping"
| "operator-url-mapping";
candidate_static_count: number;
candidate_static_nodes: {
static_layer_id: string;
static_node_id: string;
}[];
confidence: "unknown"
| "exact"
| "low"
| "medium"
| "high";
entity_kind: "target" | "frame" | "worker" | "script";
reason:
| "content-and-location-match"
| "unique-content-match"
| "unique-location-match"
| "ambiguous-static-candidates"
| "captured-content-disagrees-with-static-location"
| "no-static-content-match"
| "no-authorized-location-mapping"
| "runtime-frame-unattributed"
| "static-or-runtime-coverage-incomplete"
| "reconciliation-limit-reached";
reconciliation_id: string;
runtime_evidence_id: string;
runtime_node_id: string;
static_layer_id: string
| null;
static_node_id: string | null;
status: "unknown" | "matched" | "unmatched" | "ambiguous";
}[];
runtime_captures: {
capture_sha256: string;
evidence_id: string;
frames: number;
kind: "browser"
| "electron";
scripts: number;
scripts_complete_within_scope: boolean;
target_key: string;
target_location: string;
target_node_id: string;
workers: number;
}[];
schema_version: 1;
source_map_authority: {
limitation: string;
runtime_script_declarations: number;
static_layers_with_read_approval: number;
used_for_primary_matching: false;
};
static_layers: {
evidence_id: string;
format: "directory"
| "asar";
graph_id: string;
input_path: string;
layer_id: string;
role: "application" | "cache" | "assets";
root_artifact_sha256: string;
runtime_mappings: (
| { artifact_prefix: string; kind: "file-root"; root: string }
| { artifact_prefix: string; kind: "url-prefix"; prefix: string }
)[];
}[];
static_load_states: {
kind: "javascript-asset"
| "javascript-chunk"
| "javascript-module";
reason:
| "static-or-runtime-coverage-incomplete"
| "runtime-script-correspondence"
| "containing-asset-was-loaded"
| "not-observed-in-bounded-capture"
| "layer-outside-runtime-scope";
runtime_node_ids: string[];
static_layer_id: string;
static_node_id: string;
status: | "unknown"
| "loaded"
| "resident-in-loaded-asset"
| "not-observed-in-capture";
}[];
summary: {
ambiguous: number;
matched: number;
runtime_frames: number;
runtime_scripts: number;
runtime_targets: number;
runtime_workers: number;
static_loaded: number;
static_not_observed: number;
static_resident: number;
static_unknown: number;
unknown: number;
unmatched: number;
};
}
Returns
| {
analysis_profile: {
digest: string;
parameters: Record<string, JSONType>;
provider: { id: string; name: string; version: string };
provider_profile_schema_version: number;
schema_version: 1;
};
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| {
architecture: string;
id: string;
isolation: "process"
| "none"
| "container"
| "virtual-machine";
platform: string;
}
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: (
| { address: string; kind: "address" }
| { end: string; kind: "address-range"; start: string }
| { kind: "artifact-path"; path: string }
| { kind: "file-offset"; offset: number }
| { end: number; kind: "file-offset-range"; start: number }
)[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: string | null };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: "x86"
| "x86_64"
| "arm"
| "arm64"
| null;
digest: { sha256: string };
format:
| "unknown"
| "file"
| "directory"
| "javascript"
| "source-map"
| "plist"
| "entitlements"
| "dmg"
| "zip"
| "pkg"
| "asar"
| "javascript-bundle"
| "mach-o-universal"
| "mach-o"
| "elf"
| "pe"
| "hopper"
| "analysis-database"
| "ipa"
| "apk";
local_path: string;
name: string;
}
| null;
}
| {
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| {
architecture: string;
id: string;
isolation: "process"
| "none"
| "container"
| "virtual-machine";
platform: string;
}
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: (
| { address: string; kind: "address" }
| { end: string; kind: "address-range"; start: string }
| { kind: "artifact-path"; path: string }
| { kind: "file-offset"; offset: number }
| { end: number; kind: "file-offset-range"; start: number }
)[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: string | null };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: "x86"
| "x86_64"
| "arm"
| "arm64"
| null;
digest: { sha256: string };
format:
| "unknown"
| "file"
| "directory"
| "javascript"
| "source-map"
| "plist"
| "entitlements"
| "dmg"
| "zip"
| "pkg"
| "asar"
| "javascript-bundle"
| "mach-o-universal"
| "mach-o"
| "elf"
| "pe"
| "hopper"
| "analysis-database"
| "ipa"
| "apk";
local_path: string;
name: string;
}
| null;
}
+Defined in src/application/JavaScriptRuntimeReconciliationEvidence.ts:14
+Defined in src/application/JavaScriptRuntimeReconciliationService.ts:17
+Defined in src/browser/CdpElectronScriptEvents.ts:21
+Defined in src/browser/CdpElectronScripts.ts:29
+Defined in src/browser/CdpElectronWorkers.ts:18
+Defined in src/domain/javascriptRuntimeLoadState.ts:23
+Defined in src/domain/javascriptRuntimeReconciliation.ts:15
+Defined in src/domain/javascriptRuntimeReconciliationGraph.ts:40
+Defined in src/domain/javascriptRuntimeReconciliationMatching.ts:26
+Defined in src/domain/javascriptRuntimeReconciliationParsing.ts:76
+Defined in src/domain/javascriptRuntimeReconciliationParsing.ts:67
+Defined in src/domain/javascriptRuntimeReconciliationParsing.ts:59
+Defined in src/domain/javascriptRuntimeReconciliationResult.ts:35
+Defined in src/domain/javascriptRuntimeReconciliationRuntime.ts:32
+Defined in src/domain/javascriptRuntimeStaticCandidates.ts:37
+Defined in src/domain/javascriptRuntimeStaticCandidates.ts:80
+Defined in src/domain/javascriptRuntimeStaticCandidates.ts:49
+Defined in src/domain/javascriptRuntimeStaticCandidates.ts:89
Deterministic static/passive-runtime reconciliation with a combined JAG.