refactor(surface): separate direct and interactive entrypoints (#463) #469

Merged

barrettruth merged 1 commit from chore/surface-taxonomy-463 into main

2026-04-27 20:17:15 +00:00

barrettruth commented

2026-04-27 20:16:29 +00:00

Problem

forge.nvim's public surface still blurred deterministic entrypoints with interactive route and picker workflows, especially through thin ops.lua wrappers and flattened API docs.

Solution

Document the taxonomy in doc/forge.nvim.txt, route create and browse/CI entrypoints through the top-level forge API, and remove the redundant ops.lua wrapper layer so the operations surface only contains actual operations.

## Problem forge.nvim's public surface still blurred deterministic entrypoints with interactive route and picker workflows, especially through thin `ops.lua` wrappers and flattened API docs. ## Solution Document the taxonomy in `doc/forge.nvim.txt`, route create and browse/CI entrypoints through the top-level `forge` API, and remove the redundant `ops.lua` wrapper layer so the operations surface only contains actual operations.