feat: recover interrupted mobile voice transcripts (Closes #931)

frontend/dashboard.js

@@ -748,9 +748,11 @@
             root:qs('#voice-issue-capture'), start:qs('#start-voice-issue-capture'),
             stop:qs('#stop-voice-issue-capture'), review:qs('#voice-issue-review'),
             transcript:qs('#voice-issue-transcript'), append:qs('#append-voice-issue-transcript'),
-            replace:qs('#replace-with-voice-issue-transcript'), status:qs('#voice-issue-status'),
-            title:qs('#create-issue-title'), body:qs('#create-issue-body'),
+            replace:qs('#replace-with-voice-issue-transcript'), discard:qs('#discard-voice-issue-transcript'),
+            status:qs('#voice-issue-status'), title:qs('#create-issue-title'), body:qs('#create-issue-body'),
           },
+          transcriptStore:createVoiceTranscriptStore(),
+          getLogin:()=>confirmedOwnerLogin,
         });
         issueOwnerPicker = createIssueCapture.createOwnerPicker(issueCapture, document,
           () => { saveIssueCaptureDraft(); updateIssueCreateActions(); });

frontend/index.html

@@ -833,6 +833,7 @@
           <div class="voice-issue-review-actions">
             <button id="append-voice-issue-transcript" type="button">Append to draft</button>
             <button id="replace-with-voice-issue-transcript" type="button">Replace draft</button>
+            <button id="discard-voice-issue-transcript" type="button" class="secondary">Discard transcript</button>
           </div>
         </div>
       </section>
@@ -1369,6 +1370,7 @@
 <script src="static/issue-attachment.js"></script>
 <script src="static/issue-filing-review.js"></script>
 <script src="static/issue-sheet.js"></script>
+<script src="static/voice-transcript-store.js"></script>
 <script src="static/voice-issue-capture.js"></script>
 <script src="static/create-issue-sheet.js"></script>
 <script src="static/create-and-start.js"></script>

frontend/private-data-registry.js

@@ -3,6 +3,7 @@
     'stackchain-background-outbox-v1',
     'stackchain-offline-work-v2',
     'stackchain-unfiled-captures-v1',
+    'stackchain-voice-transcripts-v1',
   ]);
   if (typeof module !== 'undefined' && module.exports) module.exports = databases;
   else root.stackchainPrivateDatabases = databases;

frontend/service-worker.js

@@ -75,6 +75,7 @@ const SHELL = [
   BASE + 'static/issue-filing-review.js',
   BASE + 'static/issue-sheet.js',
   BASE + 'static/checklist-conflict.js',
+  BASE + 'static/voice-transcript-store.js',
   BASE + 'static/voice-issue-capture.js',
   BASE + 'static/create-issue-sheet.js',
   BASE + 'static/create-and-start.js',

frontend/voice-issue-capture.js

@@ -7,22 +7,34 @@ function mapVoiceTranscript(value) {
   return {title, body};
 }
 
-function createVoiceIssueCapture({Recognition, elements, createEvent = name => new Event(name, {bubbles:true})}) {
+function createVoiceIssueCapture({
+  Recognition, elements, createEvent = name => new Event(name, {bubbles:true}),
+  transcriptStore = null, getLogin = () => '',
+}) {
   const supported = typeof Recognition === 'function';
+  const login = String(getLogin() || '').trim();
+  const ready = supported && login && transcriptStore ? Promise.resolve(transcriptStore.load(login)).then(value => {
+    const recovered = String(value || '').replace(/\s+/g, ' ').trim().slice(0, 10255);
+    if (recovered) showReview(recovered, {persist:false, recovered:true});
+  }) : Promise.resolve();
   elements.root.hidden = !supported;
   if (!supported) {
     elements.status.textContent = 'Voice capture is unavailable; type the title and note instead.';
-    return {supported:false, cancel() {}};
+    return {supported:false, ready, cancel() {}};
   }
   let recognition = null;
 
-  function showReview(value) {
+  function showReview(value, {persist = true, recovered = false} = {}) {
     elements.transcript.value = value;
+    const activeLogin = String(getLogin() || '').trim();
+    if (persist && activeLogin && transcriptStore) void transcriptStore.save(activeLogin, value);
     const hasDraft = Boolean(elements.title.value.trim() || elements.body.value.trim());
     elements.append.textContent = hasDraft ? 'Append to draft' : 'Use transcript';
     elements.replace.hidden = !hasDraft;
     elements.review.hidden = false;
-    elements.status.textContent = 'Transcript ready. Review it before using it.';
+    elements.status.textContent = recovered ?
+      'Recovered transcript. Review it before using or discarding it.' :
+      'Transcript ready. Review it before using it.';
   }
 
   elements.start.addEventListener('click', () => {
@@ -33,7 +45,11 @@ function createVoiceIssueCapture({Recognition, elements, createEvent = name => n
       const finalText = Array.from(event.results || [])
         .filter(result => result.isFinal)
         .map(result => result[0]?.transcript || '').join(' ').replace(/\s+/g, ' ').trim();
-      if (finalText) showReview(finalText);
+      if (finalText) {
+        const accumulated = [elements.transcript.value.trim(), finalText]
+          .filter(Boolean).join(' ').replace(/\s+/g, ' ').trim().slice(0, 10255);
+        showReview(accumulated);
+      }
     };
     recognition.onerror = event => {
       elements.start.hidden = false;
@@ -56,6 +72,11 @@ function createVoiceIssueCapture({Recognition, elements, createEvent = name => n
     elements.status.textContent = 'Finishing transcript…';
   });
 
+  function clearCheckpoint() {
+    const activeLogin = String(getLogin() || '').trim();
+    if (activeLogin && transcriptStore) void transcriptStore.clear(activeLogin);
+  }
+
   function commit(mode) {
     const mapped = mapVoiceTranscript(elements.transcript.value);
     if (mode === 'replace') {
@@ -71,13 +92,20 @@ function createVoiceIssueCapture({Recognition, elements, createEvent = name => n
     }
     elements.title.dispatchEvent(createEvent('input'));
     elements.body.dispatchEvent(createEvent('input'));
+    clearCheckpoint();
     elements.review.hidden = true;
     elements.status.textContent = 'Transcript added. Review the title and note before saving.';
   }
   elements.append.addEventListener('click', () => commit('append'));
   elements.replace.addEventListener('click', () => commit('replace'));
+  elements.discard?.addEventListener('click', () => {
+    clearCheckpoint();
+    elements.transcript.value = '';
+    elements.review.hidden = true;
+    elements.status.textContent = 'Recovered transcript discarded.';
+  });
 
-  return {supported:true, cancel() { recognition?.abort(); recognition = null; }};
+  return {supported:true, ready, cancel() { recognition?.abort(); recognition = null; }};
 }
 
 if (typeof module !== 'undefined') module.exports = {mapVoiceTranscript, createVoiceIssueCapture};

frontend/voice-transcript-store.js

@@ -0,0 +1,87 @@
+(function (root, factory) {
+  const createVoiceTranscriptStore = factory(root.indexedDB);
+  if (typeof module !== 'undefined' && module.exports) module.exports = createVoiceTranscriptStore;
+  else root.createVoiceTranscriptStore = createVoiceTranscriptStore;
+})(typeof globalThis !== 'undefined' ? globalThis : this, function buildFactory(defaultIndexedDB) {
+  const dbName = 'stackchain-voice-transcripts-v1';
+  const STORE_NAME = 'checkpoints';
+  const MAX_TRANSCRIPT_LENGTH = 10255;
+
+  function requestResult(request) {
+    return new Promise((resolve, reject) => {
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error || new Error('Private transcript storage failed.'));
+    });
+  }
+
+  function createIndexedDbTransaction(indexedDB) {
+    if (!indexedDB) return null;
+    let databasePromise = null;
+    function openDatabase() {
+      if (databasePromise) return databasePromise;
+      databasePromise = new Promise((resolve, reject) => {
+        const request = indexedDB.open(dbName, 1);
+        request.onupgradeneeded = () => {
+          if (!request.result.objectStoreNames.contains(STORE_NAME)) {
+            request.result.createObjectStore(STORE_NAME, {keyPath:'login'});
+          }
+        };
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error || new Error('Private transcript storage is unavailable.'));
+      });
+      return databasePromise;
+    }
+    return async (work, mode = 'readonly') => {
+      const database = await openDatabase();
+      const transaction = database.transaction(STORE_NAME, mode);
+      const store = transaction.objectStore(STORE_NAME);
+      const completed = new Promise((resolve, reject) => {
+        transaction.oncomplete = () => resolve();
+        transaction.onerror = () => reject(transaction.error || new Error('Private transcript storage failed.'));
+        transaction.onabort = () => reject(transaction.error || new Error('Private transcript storage was interrupted.'));
+      });
+      const result = await work({
+        get:key => requestResult(store.get(key)),
+        put:value => requestResult(store.put(value)),
+        delete:key => requestResult(store.delete(key)),
+      });
+      await completed;
+      return result;
+    };
+  }
+
+  function normalizeLogin(value) {
+    return String(value || '').trim().toLowerCase();
+  }
+
+  function normalizeTranscript(value) {
+    return String(value || '').replace(/\s+/g, ' ').trim().slice(0, MAX_TRANSCRIPT_LENGTH);
+  }
+
+  function createVoiceTranscriptStore({transaction = createIndexedDbTransaction(defaultIndexedDB)} = {}) {
+    async function load(login) {
+      const key = normalizeLogin(login);
+      if (!key || !transaction) return '';
+      const record = await transaction(store => store.get(key));
+      return normalizeTranscript(record?.transcript);
+    }
+
+    async function save(login, transcript) {
+      const key = normalizeLogin(login);
+      const value = normalizeTranscript(transcript);
+      if (!key || !value || !transaction) return;
+      await transaction(store => store.put({login:key, transcript:value}), 'readwrite');
+    }
+
+    async function clear(login) {
+      const key = normalizeLogin(login);
+      if (!key || !transaction) return;
+      await transaction(store => store.delete(key), 'readwrite');
+    }
+
+    return {load, save, clear};
+  }
+
+  createVoiceTranscriptStore.databaseName = dbName;
+  return createVoiceTranscriptStore;
+});