cli-plan-review-apply-pattern

IN premise

Several commands (`derive`, `deduplicate`, `contradictions`) follow a three-phase workflow: (1) generate proposals to a file, (2) human reviews/edits the file, (3) `--accept FILE` parses and applies the reviewed plan — with `--auto` collapsing all three phases

Summary

The system uses a consistent pattern where potentially destructive operations go through a generate-review-apply pipeline, giving humans a chance to inspect and edit proposed changes before they take effect. This matters because it means batch operations are safe by default — nothing gets applied without explicit approval — while the --auto flag lets experienced users skip the review step when they trust the output.

Details

Sourceentries/2026/05/11/reasons_lib-cli.md