From e46f01885b9899211f2bbc6c1b5229793bf5a36a Mon Sep 17 00:00:00 2001
From: Twest2 <git@twestbrook.com>
Date: Sat, 13 Jun 2026 14:05:10 -0500
Subject: [PATCH] Prompt to start recording for library guides

---
 app/renderer/app.js     | 27 ++++++++++++++++++++++-----
 app/renderer/dialogs.js |  9 ++++++---
 2 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/app/renderer/app.js b/app/renderer/app.js
index 103c3c7..5f4b1fa 100644
--- a/app/renderer/app.js
+++ b/app/renderer/app.js
@@ -191,8 +191,7 @@ class StepForgeApp {
     const guide = await api.library.create({ title: 'Untitled capture' });
     await this.refreshData();
     await this.openGuide(guide.guideId);
-    const state = await api.capture.session({ action: 'start', guideId: guide.guideId });
-    this.updateCaptureState(state);
+    const state = await this.armCaptureSession(guide.guideId);
     const hotkey = this.state.settings?.capture?.hotkeyCapture;
     let how;
     if (state.clickCapture) {
@@ -230,14 +229,26 @@ class StepForgeApp {
     this.renderTopbar();
   }
 
+  // Start a paused session, optionally show a reminder, and continue once
+  // the user acknowledges it.
+  async armCaptureSession(guideId, reminder = null) {
+    const state = await api.capture.session({ action: 'start', guideId });
+    this.updateCaptureState(state);
+    if (!reminder) return state;
+    const acknowledged = await dialogs.showRecordingReminder(reminder);
+    if (!acknowledged) return state;
+    const next = await api.capture.session({ action: 'resume', guideId });
+    this.updateCaptureState(next);
+    return next;
+  }
+
   // Opens a guide and arms (paused) capture for it, so the red REC bar pops
   // up right away with a "Start recording" option to resume capturing steps.
   async openGuideAndArmCapture(guideId, stepId = null) {
     await this.openGuide(guideId, stepId);
     // Don't restart (and reset the count of) a session already running for this guide.
     if (this.captureState?.active && this.captureState.guideId === guideId) return;
-    const state = await api.capture.session({ action: 'start', guideId });
-    this.updateCaptureState(state);
+    await this.armCaptureSession(guideId);
   }
 
   onEditorMeta(meta) {
@@ -767,7 +778,8 @@ class StepForgeApp {
     await this.refreshLibrary();
   }
 
-  async createGuide() {
+  async createGuide({ armCapture = undefined } = {}) {
+    const shouldArmCapture = armCapture ?? this.state.view === 'library';
     const title = await dialogs.promptText({
       title: 'New Guide',
       label: 'Title',
@@ -778,6 +790,11 @@ class StepForgeApp {
     const guide = await api.library.create({ title: title.trim() || 'Untitled guide' });
     await this.refreshLibrary();
     await this.openGuide(guide.guideId);
+    if (!shouldArmCapture) return;
+    await this.armCaptureSession(guide.guideId, {
+      actionLabel: 'Start recording',
+      headline: 'StepForge will hide after you start recording.',
+    });
   }
 
   async createFolder() {
diff --git a/app/renderer/dialogs.js b/app/renderer/dialogs.js
index 4bb4fe7..2b03c1f 100644
--- a/app/renderer/dialogs.js
+++ b/app/renderer/dialogs.js
@@ -693,13 +693,16 @@ function showInfoDialog(title, bodyText) {
   });
 }
 
-function showRecordingReminder() {
+function showRecordingReminder({
+  actionLabel = 'Continue',
+  headline = 'StepForge will hide after you continue.',
+} = {}) {
   return new Promise((resolve) => {
     const { close } = openModal({
       title: 'Before recording starts',
       body: el('div.recording-notice', {},
         el('div.recording-notice__badge', {}, 'Recording tip'),
-        el('div.recording-notice__title', {}, 'StepForge will hide after you continue.'),
+        el('div.recording-notice__title', {}, headline),
         el('div.recording-notice__text', {},
           'When you want to pause or stop, use the red tray icon in the system tray.',
         ),
@@ -707,7 +710,7 @@ function showRecordingReminder() {
       footer: [
         el('button.primary', {
           onClick: () => { close(); resolve(true); },
-        }, 'Continue'),
+        }, actionLabel),
       ],
       onClose: () => resolve(false),
     });