@davmash/bygone 0.8.13 → 0.8.14

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.8.14
+
+- Reorganized desktop menus around familiar File, Edit, Git, Present, Navigate, View, and Window responsibilities while exposing file, directory, revision, branch, history, tour, and blank-comparison workflows
+- Fixed file and directory comparison commands with additive native selection, including sources from different folders
+- Kept completed diff decorations, counts, focus, and scroll position stable while edited comparisons recompute in the background
+
 ## 0.8.12
 
 - Fixed stacked-tour comparison switching so Monaco panes redraw immediately without requiring a window resize

package/docs/explore.md

@@ -5,13 +5,16 @@ prescribed reading order.
 
 ## Start a comparison
 
-- **Compare Files…** accepts two or more files. Two files open a side-by-side
+- The **File** menu contains the familiar new/open/save lifecycle. **New Blank
+  Comparison** opens a writable comparison without source paths.
+- **File → Compare Files…** accepts two or more files. Select one item at a time when
+  the files live in different folders, or select several together. Two files open a side-by-side
   comparison; additional files open the focused multi-panel strip.
-- **Compare Directories…** accepts two or more directories and compares their
-  trees.
+- **File → Compare Directories…** uses the same additive selection flow for two or
+  more directory trees.
 - Drag files or directories into the window for the same selection-count
   behavior.
-- Start without paths to get a blank, writable two-panel comparison.
+- Start the CLI without paths to get the same blank comparison.
 
 Writable filesystem panels are labeled **Writable file**. Git revisions,
 history, tours, and supplied snapshots are labeled **Read-only snapshot**.
@@ -19,11 +22,12 @@ Replace and save operations are unavailable for read-only content.
 
 ## Ask Git questions
 
-- **View File or Directory History…** follows one path through commits and
+- **File → View File or Directory History…** follows one path through commits and
   supported index/worktree states.
-- **Explore Current Branch Change** compares the branch tip with its merge
-  base and shows the complete changed-file inventory.
-- CLI `--git-diff` compares explicit revisions when you already know the refs.
+- **Git → Review Branch Change…** accepts a head and optional base ref, compares the
+  head with its merge base, and shows the complete changed-file inventory.
+- **Git → Compare Revisions…** accepts two or more refs, including `INDEX` and
+  `WORKTREE`, matching CLI `--git-diff`.
 
 Branch exploration uses committed content. Dirty index and worktree changes
 are reported separately and are never silently folded into a commit snapshot.
@@ -61,6 +65,8 @@ engines, options, limits, provenance, and stale-result rules.
 
 ## Move into Present
 
-**Present Current Branch** creates a guided tour of the committed branch range.
-**Open Authored Tour…** opens a checked and compiled `.bygone` narrative in
+**Present Current Branch** creates a guided tour of the committed branch range;
+**Present Branch or Ref…** accepts the same optional head and base refs as the
+CLI.
+**File → Open Authored Tour…** opens a checked and compiled `.bygone` narrative in
 its own presentation window, leaving the Explore window available.

package/docs/product-surface.md

@@ -25,28 +25,28 @@ renderer does not make every workflow appropriate in every host.
 
 | User question | Discovery and launch | Session/source | Mutability and lifecycle | Maturity | Verification |
 | --- | --- | --- | --- | --- | --- |
-| Start without source material | CLI `bygone` outside Git; blank startup | Blank multi-diff | Writable untitled panels; normal undo and dirty state | Core | `testBlankMultiDiffStartsWithTwoEditablePanels` |
+| Start without source material | File → New Blank Comparison; CLI `bygone` outside Git; blank startup | Blank multi-diff | Writable untitled panels; normal undo and dirty state | Core | `testBlankMultiDiffStartsWithTwoEditablePanels` |
 | Compare files | File → Compare Files; drag/drop; `bygone left right`; `--diff` | Files, two-way or multi-diff | Files are writable; save, reload, refresh, and external-change policy apply | Core | standalone smoke and multi-diff tests |
 | Compare directories | File → Compare Directories; drag/drop; two or more directory arguments | Directory comparison | Directory rows are read-only; writable file drill-down depends on source/review state | Core | directory smoke and directory-diff tests |
-| Follow one file or directory through Git | Git → View File or Directory History; one path; `--history` | Git commits plus supported index/worktree states | Commits are read-only; worktree/index provenance is explicit | Core | Git history and directory-history tests |
-| Compare named revisions | `bygone --git-diff <refs…>` | Git blobs/revisions | Read-only snapshots | Secondary; CLI discovery needs improvement | Git comparison tests |
-| Explore the current branch change | Git → Explore Current Branch Change; `bygone review` | Merge-base-to-tip branch inventory | Read-only review snapshots; dirty state is reported, not silently included | Core | branch comparison and review-path tests |
+| Follow one file or directory through Git | File → View File or Directory History; one path; `--history` | Git commits plus supported index/worktree states | Commits are read-only; worktree/index provenance is explicit | Core | Git history and directory-history tests |
+| Compare named revisions | Git → Compare Revisions; `bygone --git-diff <refs…>` | Git blobs/revisions | Read-only snapshots | Core | Git comparison tests and desktop menu contract |
+| Explore a branch change | Git → Review Branch Change; `bygone review` | Merge-base-to-tip branch inventory for a selected head and optional base | Read-only review snapshots; dirty state is reported, not silently included | Core | branch comparison, review-path, and desktop menu tests |
 | Search comparison code | Edit → Find or Search Comparison | Active, visible, all loaded panels, unopened changed text snapshots, or one file's Git history | Search is read-only; history distinguishes content occurrence from introduction/removal; Replace requires the active writable model | Core | find, comparison-search, change-set-search, and history-search tests |
 | Search or safely replace in a filesystem tree | Edit → Search in Files; explicit directory root | System ripgrep 14+ with include/exclude, hidden, ignore, and result-limit controls | Search is read-only and cancellable; completed case-sensitive literal searches can build an exclusion-aware, revalidated, atomic replacement preview with guarded undo | Optional system capability | repository search/replace contracts, benchmark, and host-protocol tests |
 | Move through a multi-panel comparison | Strip buttons, panel headers, gutters, wheel, or `Alt+Arrow` | Active panel and adjacent pair | Does not change source identity | Core | focused-strip controller and standalone smoke tests |
 | Search an authored tour | Presenter search or `Cmd/Ctrl+Shift+F` | Authored narrative plus compiled base/head code snapshots | Read-only; narrative hits navigate scenes/steps and code hits preserve Return to tour | Core | tour-search and presenter-host tests |
 
-The File menu owns sources and persistence; Edit owns focused text operations;
-Git owns historical/revision questions; Present changes product area; Navigate
-owns movement within the current session; View owns display preferences; Window
-owns native window lifecycle. Developer fixtures appear only when Electron is
-not packaged.
+File owns new/open/save lifecycle; Edit owns text operations and search; Git
+owns revision and branch questions; Present changes product area; Navigate owns
+movement within the current session, including history movement; View owns
+display preferences; Window owns native window lifecycle. Developer fixtures
+appear only when Electron is not packaged.
 
 ## Standalone Present and browser presenter
 
 | User question | Discovery and launch | Identity/provenance | Mutability | Maturity | Verification |
 | --- | --- | --- | --- | --- | --- |
-| Explain the current branch automatically | Present → Present Current Branch; `bygone present` | Committed merge-base-to-tip range | Read-only | Core | presentation launch and generated-tour tests |
+| Explain a branch automatically | Present → Present Current Branch or Present Branch or Ref; `bygone present` | Committed merge-base-to-tip range for the current or selected head/base | Read-only | Core | presentation launch, generated-tour, and desktop menu tests |
 | Open an authored walkthrough | Present → Open Authored Tour; `bygone present --tour`; VS Code hand-off | Manifest range, scene, step, exact source anchor | Read-only | Core | reproducible example and tour validation tests |
 | Listen to a generated or authored tour | Narrative Listen controls; Present → Listen to Tour | Existing manifest narrative segmented locally by scene/step and visible sentence | Read-only device TTS; voice/rate preferences remain local; continuous playback follows tour navigation and direct exploration pauses it | Core | narration model/controller and presenter-host tests |
 | Explain a real stack | `stacked-diff` scene | Exact real Git revisions per panel | Read-only | Advanced | `examples/stacked-diff.bygone` |