Module watchkeeper 

Watchkeeper report assembly (decided.services.watchkeeper): resolve the base and head of a comparison — each an existing directory or a git revision materialized through revisions — load both states, compare, run intent analysis, and derive the deterministic review verdict. to_dict (rendered in output.rs) is the stable JSON contract (ADR-007, schema_version “1”).

Structs

ReviewRecommendation

One deterministic reason human review is recommended.

WatchkeeperReport

One product knowledge review: base state, head state, what changed.

Constants

REASON_BROKEN_RELATIONSHIP

REASON_VALIDATION_REGRESSION

RECOMMENDING_FINDINGS

Findings that recommend review on their own. Ambiguity, unlinked scope, and relationship impact inform but never recommend (v0.12.2 contract).

Functions

build_watchkeeper_report

build_watchkeeper_report(directory, base=..., head=...) — compare the corpus at directory between base and head (None head = the working tree at directory).

derive_recommendations

The deterministic finding/delta -> reason mapping (v0.12.2): validation regressions, broken relationships, then finding-driven reasons in finding order, deduplicated by code.

is_recommending