@gotcos/glasses-server 6.21.31 → 6.21.33

package/server/routes/meeting.ts

@@ -11,6 +11,7 @@ import { durableAtomicWriteFileSync } from '../lib/atomic-fs.js'
 import { appendCorrection, appliedCorrections, pendingCorrections } from '../lib/meeting-corrections.js'
 import { isSampleFromSession, untraceableSampleCount } from '../lib/training-audio-provenance.js'
 import { sendAudioFile } from '../lib/send-audio.js'
+import { adaptivePlaybackAudio } from '../lib/adaptive-playback-audio.js'
 import { chunkDiagnostics } from '../lib/chunk-embedding-diagnostics.js'
 import { errMsg } from '../lib/utils.js'
 import { confirmedLabels } from '../lib/meeting-corrections.js'
@@ -100,6 +101,7 @@ import {
   getSessionStartTime,
   getSessionTranscript,
   getMeetingSessionStatus,
+  getTranscriptionSessionLiveness,
   hasSessionAudio,
   moveSessionAudioToPending,
   type IndexedTranscriptChunk,
@@ -110,6 +112,7 @@ import {
 import { getServerInstanceId } from '../lib/server-instance-id.js'
 import {
   cosOperationsMeetingsConfigured,
+  findDirectLibraryMeetingBySessionId,
   findCosOperationsMeetingBySessionId,
   resolveCosOperationsDir,
 } from '../lib/cos-operations-meetings.js'
@@ -154,6 +157,10 @@ function cosOpsPipelineConfigured(): boolean {
   return Boolean(process.env.COS_SCRIPTS_DIR?.trim())
 }
 
+function requestedRecordMatches(requested: unknown, expected: string): boolean {
+  return requested == null || requested === '' || requested === expected
+}
+
 interface MeetingSessionSource {
   getTranscript(sessionId: string): string | null
   getStartTime(sessionId: string): number | null
@@ -710,15 +717,16 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     const operations = cosOperationsMeetingsConfigured()
       ? findCosOperationsMeetingBySessionId(sessionId)
       : null
-    const saved = operations ? null : store.findBySessionId(sessionId)
-    if (!operations && !saved) {
+    const direct = operations ? null : findDirectLibraryMeetingBySessionId(sessionId)
+    const saved = operations || direct ? null : store.findBySessionId(sessionId)
+    if (!operations && !direct && !saved) {
       res.status(404).json({ error: 'No saved meeting for this session', reason: 'meeting_not_found' })
       return
     }
-    const sidecarPath = operations?.sidecarPath ?? saved!.sidecarPath
-    const title = operations?.title ?? saved!.title
-    const domain = operations?.domain ?? saved!.domain
-    const filename = operations?.filename ?? saved!.filename
+    const sidecarPath = operations?.sidecarPath ?? direct?.sidecarPath ?? saved!.sidecarPath
+    const title = operations?.title ?? direct?.title ?? saved!.title
+    const domain = operations?.domain ?? direct?.domain ?? saved!.domain
+    const filename = operations?.filename ?? direct?.filename ?? saved!.filename
 
     let chunks: unknown
     try {
@@ -768,7 +776,11 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
       title,
       domain,
       filename,
-      source: operations ? 'cos_operations' : 'standalone_recordings',
+      source: operations ? 'cos_operations' : direct ? 'direct_library' : 'standalone_recordings',
+      recordId: operations
+        ? `ops:${operations.domain}:${operations.month}:${operations.filename}`
+        : direct?.recordId ?? `standalone:${sessionId}`,
+      mutable: direct == null,
       ...(saved ? { durationMin: saved.durationMin } : {}),
       ...review,
     })
@@ -810,14 +822,15 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     const operations = cosOperationsMeetingsConfigured()
       ? findCosOperationsMeetingBySessionId(sessionId)
       : null
-    const saved = operations ? null : store.findBySessionId(sessionId)
-    if (!operations && !saved) {
+    const direct = operations ? null : findDirectLibraryMeetingBySessionId(sessionId)
+    const saved = operations || direct ? null : store.findBySessionId(sessionId)
+    if (!operations && !direct && !saved) {
       res.status(404).json({ error: 'No saved meeting for this session', reason: 'meeting_not_found' })
       return
     }
-    const sidecarPath = operations?.sidecarPath ?? saved!.sidecarPath
-    const title = operations?.title ?? saved!.title
-    const mdPath = operations?.meetingPath ?? sidecarPath.replace(/\.g2-chunks\.json$/, '.md')
+    const sidecarPath = operations?.sidecarPath ?? direct?.sidecarPath ?? saved!.sidecarPath
+    const title = operations?.title ?? direct?.title ?? saved!.title
+    const mdPath = operations?.meetingPath ?? direct?.meetingPath ?? sidecarPath.replace(/\.g2-chunks\.json$/, '.md')
 
     let sidecar: Record<string, unknown>
     try {
@@ -907,7 +920,7 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
       // Which business this is. The sibling /speakers route has always carried
       // this and this one dropped it, so a personal 1:1 about someone's
       // compensation was byte-identical to a marketing sync.
-      domain: operations?.domain ?? saved?.domain ?? '',
+      domain: operations?.domain ?? direct?.domain ?? saved?.domain ?? '',
       // Transcript actually captured, whether or not a write-up exists yet. 140
       // of 399 real sidecars have no .md, and the fallback text claimed there was
       // no transcript while holding one.
@@ -941,6 +954,11 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
       // no write-up yet.
       capturedChars: clip.capturedChars,
       domain: clip.domain,
+      source: operations ? 'cos_operations' : direct ? 'direct_library' : 'standalone_recordings',
+      recordId: operations
+        ? `ops:${operations.domain}:${operations.month}:${operations.filename}`
+        : direct?.recordId ?? `standalone:${sessionId}`,
+      mutable: direct == null,
       // So the panel can warn above the write-up, not just the clipboard.
       removedNames: clip.removed,
       coverage,
@@ -988,11 +1006,32 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     const operations = cosOperationsMeetingsConfigured()
       ? findCosOperationsMeetingBySessionId(sessionId)
       : null
+    const direct = operations ? null : findDirectLibraryMeetingBySessionId(sessionId)
+    if (direct) {
+      if (!requestedRecordMatches(req.body?.recordId, direct.recordId || '')) {
+        res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+        return
+      }
+      res.status(409).json({
+        error: 'This meeting comes from a read-only library',
+        reason: 'direct_library_read_only',
+        recordId: direct.recordId,
+        mutable: false,
+      })
+      return
+    }
     const saved = operations ? null : store.findBySessionId(sessionId)
     if (!operations && !saved) {
       res.status(404).json({ error: 'No saved meeting for this session', reason: 'meeting_not_found' })
       return
     }
+    const selectedRecordId = operations
+      ? `ops:${operations.domain}:${operations.month}:${operations.filename}`
+      : `standalone:${sessionId}`
+    if (!requestedRecordMatches(req.body?.recordId, selectedRecordId)) {
+      res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+      return
+    }
     const sidecarPath = operations?.sidecarPath ?? saved!.sidecarPath
     const meetingPath = operations?.meetingPath ?? saved!.filepath
     const title = operations?.title ?? saved!.title
@@ -1162,11 +1201,32 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     const operations = cosOperationsMeetingsConfigured()
       ? findCosOperationsMeetingBySessionId(sessionId)
       : null
+    const direct = operations ? null : findDirectLibraryMeetingBySessionId(sessionId)
+    if (direct) {
+      if (!requestedRecordMatches(req.body?.recordId, direct.recordId || '')) {
+        res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+        return
+      }
+      res.status(409).json({
+        error: 'This meeting comes from a read-only library',
+        reason: 'direct_library_read_only',
+        recordId: direct.recordId,
+        mutable: false,
+      })
+      return
+    }
     const saved = operations ? null : store.findBySessionId(sessionId)
     if (!operations && !saved) {
       res.status(404).json({ error: 'No saved meeting for this session', reason: 'meeting_not_found' })
       return
     }
+    const selectedRecordId = operations
+      ? `ops:${operations.domain}:${operations.month}:${operations.filename}`
+      : `standalone:${sessionId}`
+    if (!requestedRecordMatches(req.body?.recordId, selectedRecordId)) {
+      res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+      return
+    }
     const sidecarPath = operations?.sidecarPath ?? saved!.sidecarPath
 
     // Refuse to confirm a label the meeting does not actually carry. Otherwise
@@ -1240,11 +1300,32 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     const operations = cosOperationsMeetingsConfigured()
       ? findCosOperationsMeetingBySessionId(sessionId)
       : null
+    const direct = operations ? null : findDirectLibraryMeetingBySessionId(sessionId)
+    if (direct) {
+      if (!requestedRecordMatches(req.body?.recordId, direct.recordId || '')) {
+        res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+        return
+      }
+      res.status(409).json({
+        error: 'This meeting comes from a read-only library',
+        reason: 'direct_library_read_only',
+        recordId: direct.recordId,
+        mutable: false,
+      })
+      return
+    }
     const saved = operations ? null : store.findBySessionId(sessionId)
     if (!operations && !saved) {
       res.status(404).json({ error: 'No saved meeting for this session', reason: 'meeting_not_found' })
       return
     }
+    const selectedRecordId = operations
+      ? `ops:${operations.domain}:${operations.month}:${operations.filename}`
+      : `standalone:${sessionId}`
+    if (!requestedRecordMatches(req.body?.recordId, selectedRecordId)) {
+      res.status(409).json({ error: 'Meeting source changed; reopen the meeting', reason: 'record_source_mismatch' })
+      return
+    }
     const sidecarPath = operations?.sidecarPath ?? saved!.sidecarPath
     const meetingPath = operations?.meetingPath ?? saved!.filepath
     const title = operations?.title ?? saved!.title
@@ -1423,7 +1504,7 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
   // voice. Retention is 7 days (see meeting-audio-archive), so this answers with
   // 404 + a reason once the window has passed rather than pretending the audio
   // was never there.
-  router.get('/meeting/:sessionId/audio/:chunkIndex', (req, res) => {
+  router.get('/meeting/:sessionId/audio/:chunkIndex', async (req, res) => {
     res.set('Cache-Control', 'private, no-store')
     const sessionId = String(req.params.sessionId ?? '')
     if (!/^[A-Za-z0-9:_-]{3,96}$/.test(sessionId)) {
@@ -1440,8 +1521,8 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
     // fallback there is nothing to play on any meeting predating 6.21.18 — while
     // 72 hours of unidentified-voice audio is sitting right there, and an
     // unidentified voice is exactly what a reviewer needs to hear.
-    const path = meetingAudioChunkPath(sessionId, chunkIndex)
-      ?? extAudioChunkPath(sessionId, chunkIndex)
+    const archivedPath = meetingAudioChunkPath(sessionId, chunkIndex)
+    const path = archivedPath ?? extAudioChunkPath(sessionId, chunkIndex)
     if (!path) {
       const retained = [...new Set([
         ...listMeetingAudioChunks(sessionId),
@@ -1460,7 +1541,30 @@ export function createMeetingRouter(deps: MeetingRouteDependencies = {}): Router
       })
       return
     }
-    sendAudioFile(res, path)
+    // Canary scope is intentionally narrow: only the week-retained immutable
+    // archive gets a derived playback copy. Legacy ext-audio remains byte-for-
+    // byte raw. `?raw=1` is the authenticated A/B and emergency per-request
+    // escape hatch; the COS Control toggle is the machine-wide rollback.
+    const liveRecording = getTranscriptionSessionLiveness().live > 0
+    const playback = archivedPath && req.query.raw !== '1' && !liveRecording
+      ? await adaptivePlaybackAudio(archivedPath, {
+          // Admission is not enough: if a meeting starts while FFmpeg is
+          // working, the replay job is preempted and this request hears raw.
+          shouldAbort: () => getTranscriptionSessionLiveness().live > 0,
+        })
+      : { path, mode: 'raw' as const, profile: null }
+    res.set('X-COS-Audio-Playback', playback.mode)
+    const bypassReason = 'reason' in playback ? playback.reason : undefined
+    const bypass = liveRecording
+      ? 'live_recording'
+      : bypassReason === 'live_recording'
+        ? 'live_recording'
+        : bypassReason === 'cleanup_busy'
+          ? 'cleanup_busy'
+          : null
+    if (bypass) res.set('X-COS-Audio-Bypass', bypass)
+    if (playback.profile) res.set('X-COS-Audio-Profile', playback.profile)
+    sendAudioFile(res, playback.path)
   })
 
   /**

package/server/routes/meetings.ts

@@ -4,10 +4,44 @@ import { Router } from 'express'
 import { getMeetingStore, MeetingStore, MeetingStoreError } from '../lib/meeting-store.js'
 import {
   cosOperationsMeetingsConfigured,
+  getDirectLibraryMeetingDetail,
   getCosOperationsMeetingDetail,
+  listDirectLibraryMeetings,
   listCosOperationsMeetings,
-  resolveCosOperationsDir,
+  resolveMeetingLibrary,
 } from '../lib/cos-operations-meetings.js'
+import type { MeetingMeta } from '../lib/meeting-store.js'
+
+function withStandaloneIdentity(meeting: MeetingMeta): MeetingMeta {
+  return {
+    ...meeting,
+    librarySource: 'standalone_recordings',
+    recordId: `standalone:${meeting.sessionId || `${meeting.domain}:${meeting.month}:${meeting.filename}`}`,
+    mutable: true,
+  }
+}
+
+function mergeMeetingSources(groups: MeetingMeta[][], limit: number): MeetingMeta[] {
+  const seenSessions = new Set<string>()
+  const seenExact = new Set<string>()
+  const merged: MeetingMeta[] = []
+  for (const group of groups) {
+    for (const meeting of group) {
+      if (meeting.sessionId) {
+        if (seenSessions.has(meeting.sessionId)) continue
+        seenSessions.add(meeting.sessionId)
+      } else {
+        const exact = `${meeting.librarySource || ''}:${meeting.domain}:${meeting.month}:${meeting.filename}`
+        if (seenExact.has(exact)) continue
+        seenExact.add(exact)
+      }
+      merged.push(meeting)
+    }
+  }
+  merged.sort((a, b) => `${b.date}T${b.time || '00:00'}`.localeCompare(`${a.date}T${a.time || '00:00'}`)
+    || b.filename.localeCompare(a.filename))
+  return merged.slice(0, Math.min(Math.max(limit, 1), 50))
+}
 
 export function createMeetingsRouter(store: MeetingStore = getMeetingStore()): Router {
   const router = Router()
@@ -20,17 +54,54 @@ export function createMeetingsRouter(store: MeetingStore = getMeetingStore()): R
       const domain = typeof req.query.domain === 'string' ? req.query.domain : 'all'
       res.set('Cache-Control', 'private, no-store')
 
-      if (cosOperationsMeetingsConfigured()) {
+      const library = resolveMeetingLibrary()
+      if (library.layout === 'invalid_explicit_root') {
+        res.status(409).json({
+          error: 'Configured meetings library is unavailable or malformed',
+          reason: 'invalid_explicit_root',
+          layout: library.layout,
+          warnings: library.warnings,
+        })
+        return
+      }
+
+      if (library.layout === 'direct') {
+        const operations = cosOperationsMeetingsConfigured()
+          ? listCosOperationsMeetings({ limit: 50, domain })
+          : []
+        const direct = domain === 'all' || domain === 'library'
+          ? listDirectLibraryMeetings({ limit: 50 })
+          : []
+        const standalone = store.list({ limit: 50, domain }).map(withStandaloneIdentity)
+        const meetings = mergeMeetingSources([operations, direct, standalone], limit)
+        res.json({
+          meetings,
+          source: operations.length > 0 ? 'mixed_library' : 'direct_library',
+          layout: 'direct',
+          root: library.root,
+          rootFingerprint: library.rootFingerprint,
+          meetingCount: meetings.length,
+          warnings: library.warnings,
+        })
+        return
+      }
+
+      if (library.layout === 'multi_domain') {
         const meetings = listCosOperationsMeetings({ limit, domain })
         res.json({
           meetings,
           source: 'cos_operations',
-          operationsDir: resolveCosOperationsDir(),
+          layout: 'multi_domain',
+          root: library.root,
+          rootFingerprint: library.rootFingerprint,
+          meetingCount: meetings.length,
+          warnings: library.warnings,
         })
         return
       }
 
-      res.json({ meetings: store.list({ limit, domain }), source: 'standalone_recordings' })
+      const meetings = store.list({ limit, domain }).map(withStandaloneIdentity)
+      res.json({ meetings, source: 'standalone_recordings', layout: 'standalone', meetingCount: meetings.length })
     } catch (error) {
       sendMeetingStoreError(res, error)
     }
@@ -49,6 +120,14 @@ export function createMeetingsRouter(store: MeetingStore = getMeetingStore()): R
       }
       res.set('Cache-Control', 'private, no-store')
 
+      if (domain === 'library') {
+        const detail = getDirectLibraryMeetingDetail(month, filename)
+        if (detail) {
+          res.json(detail)
+          return
+        }
+      }
+
       if (cosOperationsMeetingsConfigured()) {
         const detail = getCosOperationsMeetingDetail(domain, month, filename)
         if (detail) {
@@ -71,6 +150,14 @@ export function createMeetingsRouter(store: MeetingStore = getMeetingStore()): R
     try {
       res.set('Cache-Control', 'private, no-store')
 
+      if (req.params.domain === 'library') {
+        const detail = getDirectLibraryMeetingDetail(req.params.month, req.params.filename)
+        if (detail) {
+          res.json(detail)
+          return
+        }
+      }
+
       if (cosOperationsMeetingsConfigured()) {
         const detail = getCosOperationsMeetingDetail(
           req.params.domain,