@davmash/bygone 0.8.6 → 0.8.7

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.8.7
+
+- Refined tour narration controls with clearer playback state, sentence-level skipping, and consolidated play/pause behavior
+- Allowed narration skips to continue across adjacent tour steps and slides while preserving paused playback
+- Improved tour and comparison toolbar controls, including clearer disabled word-wrap feedback
+
 ## 0.8.6
 
 - Added optional authored-tour `windowTitle` labels and context-aware desktop and VS Code window titles

package/README.md

@@ -98,6 +98,12 @@ new comparison brings the central app window forward and replaces its current
 session after any unsaved-change confirmation. Tours reuse a dedicated window
 owned by that same app process.
 
+When Bygone is quit or restarted for an upgrade, the desktop app remembers the
+open Explore session and tour windows. A normal no-argument launch restores
+them; an explicit file, directory, review, or presentation launch takes
+precedence. Windows whose source files or Git targets no longer exist are
+skipped or replaced with a blank Explore window.
+
 Shell completion is generated from the same command specification as `bygone --help`, including contextual file arguments and local Git refs for branch review. `npm run dev:sync`, the desktop app's command-line installer, and the Homebrew packages install completions automatically. To install one manually, choose the command for your shell:
 
 ```bash

package/cli/present.js

@@ -46,6 +46,20 @@ async function startPresentation(args, cwd, packageRoot, options = {}) {
 
     const server = createServer((request, response) => {
         const requestUrl = new URL(request.url || '/', 'http://127.0.0.1');
+        if (requestUrl.pathname === '/narration/claim') {
+            if (request.method !== 'POST') {
+                respond(response, 405, 'Method not allowed');
+                return;
+            }
+            if (!isSameOriginLoopbackRequest(request)) {
+                respond(response, 403, 'Forbidden');
+                return;
+            }
+            options.onNarrationClaim?.();
+            response.writeHead(204, { 'Cache-Control': 'no-store' });
+            response.end();
+            return;
+        }
         if (requestUrl.pathname === '/tour.json') {
             response.writeHead(200, {
                 'Content-Type': 'application/json; charset=utf-8',
@@ -180,6 +194,18 @@ function respond(response, statusCode, message) {
     response.end(message);
 }
 
+function isSameOriginLoopbackRequest(request) {
+    const origin = request.headers.origin;
+    const host = request.headers.host;
+    if (typeof origin !== 'string' || typeof host !== 'string') return false;
+    try {
+        const parsed = new URL(origin);
+        return parsed.protocol === 'http:' && parsed.hostname === '127.0.0.1' && parsed.host === host;
+    } catch {
+        return false;
+    }
+}
+
 function escapeHtml(text) {
     return text
         .replaceAll('&', '&')

package/docs/present.md

@@ -14,6 +14,38 @@ The Files rail is independent of the narrative. Browsing another file keeps
 the active tour anchor visible and offers **Return to Tour** to restore the
 scene's intended focus.
 
+## Listen to a tour
+
+Use **Listen** in the narrative header or **Present → Listen to Tour** in the
+desktop app to read the tour aloud with a device voice. Narration works
+offline and does not send tour text to a hosted speech service.
+
+- **Pause/Resume** retains the current sentence; **Stop** clears playback. The
+  outer jump controls move one sentence backward or forward within the current
+  narration item.
+- Existing Previous and Next controls move through the same scene/step order
+  used by continuous narration.
+- Choose any device voice exposed by the browser and a speed from 0.75× to
+  1.5×. Bygone stores those preferences locally and returns to the system
+  default if a selected voice disappears.
+- The visible sentence is highlighted while it is spoken. Pausing retains a
+  distinct paused highlight without moving keyboard focus.
+- Direct scene, file, or search navigation interrupts speech and leaves it
+  paused at the selected tour position. Resume continues from there.
+
+Automatic narration reads chapter and scene framing, summaries, bullets,
+step titles and bodies, connection labels, and takeaways. It does not
+automatically read diff contents, code blocks, hashes, line numbers, or raw
+URLs. Those remain visible and available to assistive technology normally.
+
+Device voice names and quality depend on the operating system and browser.
+If no device speech engine is exposed, Bygone disables Listen with a specific
+unsupported-device message; lack of network access alone never disables it.
+
+Future narration work may add opt-in treatment for code and raw URLs, plus
+higher-quality hosted voices or routing through the agent that originated the
+conversation. Those remain separate from the offline, device-first baseline.
+
 ## Read provenance correctly
 
 - Normal walkthrough scenes point to exact committed source evidence.

package/docs/product-surface.md

@@ -48,6 +48,7 @@ not packaged.
 | --- | --- | --- | --- | --- | --- |
 | 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 |
 | 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` |
 | Explain a change in conceptual stages | `deconstructed-diff` scene | Explicitly labeled synthetic explanation stages backed by exact hunk IDs | Read-only | Advanced/experimental authoring | `examples/deconstructed-diff.bygone` |
 | Browse away from the narration | Files rail, change navigation | Browsed file versus active tour focus remain distinct | Read-only; Return to Tour restores narrative focus | Core | tour focus and persistent-anchor tests |