explain_impact

Category: intel
Access: write
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Shows downstream impact of a knowledge change via a bounded walk over recorded impact links. Call it before governing a fact to see what it informs.

Arguments

Optional: depth, source_kind, source_ref.

depth. Note: quick walks 1 hop, standard 3, deep 5; unknown values behave as standard.
source_kind. Note: One of chunk, claim, fact.
source_ref. Note: Id of the source chunk, claim, or fact; required.

Result

Object with source, depth, max_depth, total_impacts, impacts_by_kind grouped by session, snapshot, mapping, validation, export, and fact (each with edge, impact, and propagated scores plus depth and rationale), and a summary string.

Boundaries

Operates inside the selected profile boundary. Unknown sources answer as not-found with no further detail.

Lifecycle / side effects

Bounded breadth-first walk over recorded impact links, then a run-history entry. Read-shaped but persisted through the run log, hence write access.

Errors

Invalid source_kind rejected with a normal error payload. Empty source_ref rejected. Unknown source returns a not-found error payload.

Example

{
  "depth": "standard",
  "source_kind": "fact",
  "source_ref": "<uuid>"
}

Result shape:

{
  "max_depth": 3,
  "source": "fact:<uuid>",
  "summary": "fact: 2 affected (max score: 0.70)",
  "total_impacts": 2
}