Skip to main content

astria 1.5.0: explain retrieval and guide change investigations

· 2 min read
Nodesify
Nodesify

1.5.0 explains how query nodes enter an answer, makes refresh recommendations actionable, and improves downstream evaluation reporting. Check the GitHub release for publication status.

Understand a retrieved result​

Rendered query nodes include a retrieval reason; structured CLI and MCP nodes expose retrievalReason. Reasons distinguish query relevance, graph neighbors, and unresolved endpoints. They describe selection evidence rather than a calibrated correctness probability. At equal relevance and traversal distance, located code declarations precede file hubs unless file preference is requested.

Relationship confidence remains separate from retrieval relevance. Verify important behavior against the cited source; missing relationships cannot establish the absence of runtime dependencies. These changes do not establish a measured improvement in completed coding tasks.

Follow a complete investigation​

The getting-started guide now connects structural indexing, querying, explaining a node, assessing affected consumers, and refreshing after edits. astria status --json includes recommendations; stale compiler indexes need regeneration and reimport with astria add --scip <index-file>, even after a structural update.

Report only supported task comparisons​

Downstream task reports identify why a pair is not comparable, including unfinished runs, unverified runtimes, revision mismatches, and missing correctness reviews. Aggregate measurements count missing or noncomparable pairs without treating them as zero savings. The reporting changes do not run agents or produce new task-quality evidence.

Upgrade​

This release also updates vulnerable spreadsheet/archive/compression dependencies, Tokio, and a yanked cryptographic dependency. See the changelog for the release record.

After publication:

npm install -g @nodesify/astria@1.5.0
astria update .
astria doctor

Restart existing MCP processes to load the updated native binding. The 1.5.0 documentation is available alongside older snapshots in the version menu.