`append`
mapsplice append <target> <file-to-append>
append is phase-only in the current release. The fragment file must contain
one or more phases, and those phases are appended to the end of the target
roadmap.
When the target roadmap is gate-clean, append preserves untouched existing
task lists byte-for-byte, including deliberate blank lines and nested body
spacing. Task lists are regenerated only when the operation changes that list,
for example by renumbering, replacing, deleting, inserting tasks, or rewriting
dependency text inside the list.
`insert`
mapsplice insert <target> <anchor> <file-to-insert>
mapsplice insert --after <target> <anchor> <file-to-insert>
insert places sibling content before the addressed anchor by default. Pass
--after to place the fragment after the anchor instead.
Examples:
mapsplice insert docs/roadmap.md 8 new-phase.md
mapsplice insert --after docs/roadmap.md 8.2.3 new-task.md
`delete`
mapsplice delete <target> <anchor>
delete removes exactly one addressed phase, step, or task. Any later items at
the same or deeper levels are renumbered as needed.
`replace`
mapsplice replace <target> <anchor> <file-to-replace-with>
replace removes the addressed item and splices in one or more sibling items
from the fragment file. Replacing a phase with multiple phases is supported,
provided the fragment itself contains phases.