refactor(api): tighten public implicit-ref surface #403

Merged

barrettruth merged 1 commit from cleanup/public-implicit-ref-surface into main

2026-04-25 18:46:58 +00:00

barrettruth commented

2026-04-25 18:43:53 +00:00

Problem

The public implicit-ref API still documented and exposed legacy PR entrypoints, duplicated explicit PR routing, and carried redundant tests that mostly restated implementation shape.

Solution

Tighten explicit PR resolution, move PR edit plumbing into forge.ops, document the canonical top-level API surface, and trim the new tests down to behavior that actually protects the contract.

## Problem The public implicit-ref API still documented and exposed legacy PR entrypoints, duplicated explicit PR routing, and carried redundant tests that mostly restated implementation shape. ## Solution Tighten explicit PR resolution, move PR edit plumbing into `forge.ops`, document the canonical top-level API surface, and trim the new tests down to behavior that actually protects the contract.