Documentation

Graphtia documentation · workflow

Impact analysis

Build a reviewable assessment of a proposed change.

Turn a proposed change into a review scope

Impact analysis identifies source entities that may be affected by a change to the selected subject. The result supports investigation and planning. It does not predict every runtime effect or decide whether the change is safe.

A change has a direction

A validation change can affect its checkout consumer and the tests associated with that consumer. Reachability identifies candidates for review; it does not prove a defect.

Validation changeSelected source
01
CheckoutDependent module
02
Order contractBoundary to inspect
03
Checkout testsReview candidates
04
Review scopeInspect source evidence
05
Change → potential dependents → review candidates

Investigate a validation change

  1. Describe the intended change before opening an impact view: for example, reject orders with non-positive totals.

  2. Select validation.ts, open the inspector’s Impact tab and choose “Explore impact”.

  3. Inspect the returned consumers and the relationships that connect them to the subject.

  4. Read relevant tests and add checks for assumptions that the graph cannot establish.

  5. Record the revision, selected scope and unresolved questions with the proposed change.

Review the explanation behind a candidate

A candidate can be structurally reachable without needing an edit. For example, a consumer that already handles the validation error might remain correct. Conversely, an external or dynamically registered consumer may not appear in the static result. Both observations affect the review plan.

After implementation

Refresh the source/index relationship and revisit the investigation when the revision changes. Run the chosen checks. The evidence supporting the final result should describe the implemented state, not only the state that existed before editing.

The native impact view for validation.ts alongside its source and the Impact inspector tab.
A bounded impact query identifies source candidates for review. It does not prove that a change will cause a defect.

The example starts with validation.ts. Its consumers are review candidates because they depend on that source. Open a candidate and inspect how it uses the changed contract before deciding whether the behavior is affected.

Graphtia

This page is on its way. Join the waitlist to hear what’s next for Graphtia.

Join waitlist