Region proposals help reviewers move from structured constraints to a reviewed, approved region. The public workflow imports selection artifacts, ranks candidate proposals, and records a human approval before any scope verdict is treated as authoritative.
Key terms: selection artifact is a precomputed JSON document; allowed and immutable are change classes that constrain what the approved region can modify. See the glossary for Candidate Proposal, Approved Region, Scope, and Verdict, or the full guide.
Workflow
- Confirm structured constraints such as allowed classes, immutable classes, and bounds using
valence-domains validate-refinement-constraints. - Import one or more precomputed selection artifacts using
valence-domains propose-region. - Review ranked candidate proposals with their warnings and evidence.
- Approve one proposal with a human actor and reason using
valence-domains approve-region-proposal. - Use the approved region for deterministic scope review.
What survives as authority
Candidate proposals are advisory. An approved region is the artifact that crosses the authority boundary and can be used for enforcement-grade scope verdicts.
Generation
For an offline, runnable walkthrough of the complete workflow, see intent_guided_region_proposal.ipynb on GitHub.
See Trust, Provenance & Authority Boundaries for the full authority model behind proposals and approved regions.