mirror of
https://github.com/morluto/rea.git
synced 2026-11-11 17:28:08 +00:00
feat(javascript): query retained application facts by exact path (#4265)
Expose exact-path, selected-property, paged reads of retained JavaScript application facts through the shared CLI/MCP analysis view. Preserve original identities, complete row Evidence and partial coverage; retain reproducible real-Joplin and actual-agent measurements, including negative cost results. Fixes #4190. Part of #4027. Code mode remains deferred by #4091. Integrate main after #4274. Validation: 114 distinct focused cases across documented invocations, 106 Python cases, full static/docs checks and 18 version-labelled real-application workflows with 9 complete CLI/MCP view parity controls. Preserve two local fixture deadline failures and the unchanged test passing on an available single CPU. Final-head CI passed all 36 jobs after one Windows timeout retry without source changes; both exact-head automated reviews are clear and all review threads resolved. Downloadable apps and raw large Evidence/transcripts are excluded. Co-authored-by: Kaoru0822 <208281322+kaoru0822-kitauji@users.noreply.github.com>
This commit is contained in:
1 parent
1b97b0f370
commit
d9d085a15e
18 files changed
+10256
-50
No files matched your search
@@ -80,6 +80,65 @@ incompletely analyzed application. CLI `inspect-analysis-view` reads the same
|
||||
request from a JSON file; portable input uses `source.kind: "inline"` with the
|
||||
complete parent Evidence.
|
||||
|
||||
## Retained file and native facts
|
||||
|
||||
Read metadata, native inventory and unavailable processing scopes directly from
|
||||
retained application observations:
|
||||
|
||||
```json
|
||||
{
|
||||
"source": {
|
||||
"kind": "retained-evidence",
|
||||
"evidence_id": "ev_ACTUAL_PARENT_ID"
|
||||
},
|
||||
"view": {
|
||||
"kind": "javascript-facts",
|
||||
"where": { "paths": ["package.json", "build/Release/addon.node"] },
|
||||
"property_keys": [
|
||||
"name",
|
||||
"version",
|
||||
"bytes",
|
||||
"availability",
|
||||
"operation",
|
||||
"analysis_status"
|
||||
],
|
||||
"offset": 0,
|
||||
"limit": 32
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Each row preserves its node identity, observation ID, source-map reference and
|
||||
original Evidence, including location, authority, confidence, coverage and
|
||||
limitations. `property_keys` selects exact retained property names; absent keys
|
||||
stay omitted and retained null values stay null. An empty list requests only
|
||||
identity/provenance. Observations are not merged into a single asserted fact.
|
||||
When property names are unknown, opt into
|
||||
`include_available_property_keys: true`. Each returned row then lists its
|
||||
original `available_property_keys`, without unselected values; combine this with
|
||||
`property_keys: []` for discovery only. The default is false, so known-field
|
||||
reads do not pay for field inventories. Keep node/observation IDs paired when
|
||||
combining rows; location-related observations need not belong to the same node.
|
||||
|
||||
`where.paths` compares exact Evidence `artifact-path` values or `source-range`
|
||||
sources. Empty query strings remain valid selectors, though current location
|
||||
contracts require nonempty paths/sources. It does not inspect display labels or a
|
||||
property named `path`, normalize URLs, or reopen files. Omission includes unknown
|
||||
locations; an empty list matches none. Optional `where.kinds` filters original
|
||||
node kinds, with an empty list likewise matching none. Multiple locations of
|
||||
shared content remain separate rows with the same canonical node identity.
|
||||
|
||||
These rows select application-graph observations. Semantic relationships and
|
||||
semantic unknown records remain in complete parent Evidence and trace tools.
|
||||
|
||||
Rows follow retained node/observation order. The default offset/limit is 0/64;
|
||||
follow `coverage.next_offset`. Page totals count matching retained observations,
|
||||
while `source_coverage` preserves caller selection and application/semantic
|
||||
partial or unknown states. An empty or exhausted page does not establish absence
|
||||
outside examined coverage. Complete source Evidence remains available through
|
||||
export. CLI `inspect-analysis-view` and portable Evidence use the same contract
|
||||
and application implementation as MCP.
|
||||
|
||||
## Feature tracing
|
||||
|
||||
Select one literal seed kind: node ID, route, string, API, IPC channel, module,
|
||||
|
||||
Reference in new issue
Block a user