insert branches with modify

[skarim]

add insert branch operation to modify TUI

Add i (insert below) and I (insert above) key bindings to the
interactive modify view, allowing users to insert new empty branches
into an existing stack. This follows Vim-inspired semantics where
lowercase i inserts below the cursor and uppercase I inserts above.

TUI behavior

When the user presses i or I, the TUI enters an insert input mode
(similar to rename mode) where they type a new branch name. The input
is validated against git ref naming rules, local branch uniqueness, and
in-stack name collisions. On confirm, a placeholder node is inserted at
the correct position in the branch list with a green "✚ insert"
annotation badge and green connector styling.

Insert is a structure operation — it works alongside fold, rename, and
drop, but is mutually exclusive with reorder (consistent with existing
mode exclusivity rules). Undo (z) removes the inserted node cleanly.

Apply engine

At apply time (Step 2 in the pipeline, between renames and folds), the
engine creates the new git branch at the parent branch's tip via
git.CreateBranch and inserts a BranchRef into the stack metadata at
the correct position. If the insertion changes the base of a branch
that has an open PR, affectsPRs is set to trigger a required
gh stack submit afterward.

Header shortcut updates

• Combined the fold shortcuts into a single line: d/u - fold down/up
• Added insert shortcuts on their own line: i/I - insert below/above
• Reordered fold references throughout to list "down" before "up" for
  consistency with the insert shortcut ordering

Files changed

• types.go: ActionInsertBelow/ActionInsertAbove types, IsInserted field,
  InsertedBranches in ApplyResult
• model.go: key bindings, insert input mode, undo, mode exclusivity,
  annotation, styling, header shortcuts, effective-index tracking to
  prevent false reorder detection when inserts shift node positions
• styles.go: green insert badge/branch/connector styles
• status.go: insert counting in pending change summary
• help.go: new "Insert below / above" section, reordered fold heading
• apply.go: BuildPlan and ApplyPlan handle insert actions
• modify.go: updated command description and success summary
• README.md: updated keybindings table

Test coverage

• 16 new TUI tests: insert below/above, top/bottom edges, undo, mode
  exclusivity, merged branch guard, cancel/empty input, duplicate name
  validation, pending summary counting, annotation rendering, mixed
  operations with drop/fold, apply acceptance
• 4 new apply tests: BuildPlan produces correct insert actions,
  ApplyPlan creates branches and updates stack metadata, insert at
  stack start uses trunk as parent, affectsPRs triggered when inserting
  before a branch with an open PR

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[Copilot]

Pull request overview

Adds an “insert branch” operation to the gh stack modify TUI, letting users stage insertion of new empty branches above/below the cursor (Vim-style I/i) and apply them via the modify engine.

Changes:

• Extend modifyview to support inserting placeholder nodes (modal input, validation, undo behavior, styling/annotations, and pending-change summaries).
• Teach the apply engine to create inserted branches and update stack metadata during apply.
• Update CLI/docs/help text and keybinding references to include insert semantics.

Show a summary per file

File	Description
README.md	Documents insert operation and updates keybinding table.
internal/tui/shared/header.go	Adjusts header sizing constants to accommodate updated shortcut text.
internal/tui/modifyview/types.go	Adds insert action types and tracks inserted nodes/results.
internal/tui/modifyview/styles.go	Adds green styling for inserted nodes/connectors/badges.
internal/tui/modifyview/status.go	Counts inserts in the pending change summary and avoids false move detection.
internal/tui/modifyview/model.go	Implements insert mode (i/I), validation, rendering, undo semantics, and mode exclusivity updates.
internal/tui/modifyview/model_test.go	Adds/updates extensive tests for insert behaviors and related edge cases.
internal/tui/modifyview/help.go	Adds insert section and updates help description text.
internal/modify/apply.go	Adds insert handling in apply pipeline and updates move detection to account for inserts.
internal/modify/apply_test.go	Adds BuildPlan/ApplyPlan tests covering insert behavior and PR-affecting cases.
docs/src/content/docs/reference/cli.md	Updates keybindings and apply-phase description to include inserts.
docs/src/content/docs/introduction/overview.md	Mentions gh stack modify as the restructuring tool (now including insert).
docs/src/content/docs/guides/workflows.md	Updates restructure workflow docs and key list with insert.
docs/src/content/docs/guides/ui.md	Clarifies UI vs CLI restructuring and references modify/insert.
docs/src/content/docs/guides/modify.md	Adds insert documentation and updates limitations/mode-exclusivity text.
docs/src/content/docs/faq.md	Updates FAQ to include insert in modify capabilities/examples.
cmd/modify.go	Updates command description and success summary to include inserted branches.
cmd/add.go	Improves error guidance, pointing users to gh stack modify for inserting into an existing stack.
cmd/add_test.go	Updates test to assert new guidance output is shown.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 19/20 changed files
• Comments generated: 2