meeting-assistant/openspec/specs/meeting-recording/spec.md

meeting-recording Specification

Purpose

TBD - created by archiving change define-meeting-assistant-v1. Update Purpose after archive.

Requirements

Requirement: Recording mode is controlled by a configurable hotkey

Meeting Assistant SHALL use normal .NET configuration to define the global hotkey that toggles recording/transcription mode.

Scenario: Hotkey starts recording

• WHEN the configured hotkey is pressed while recording mode is inactive
• THEN Meeting Assistant starts recording/transcription mode

Scenario: Hotkey stops recording

• WHEN the configured hotkey is pressed while recording mode is active
• THEN Meeting Assistant stops recording/transcription mode

Requirement: Recording mode captures microphone and computer output

Meeting Assistant SHALL capture microphone input and computer output and combine them into one audio stream for transcription.

Scenario: Both sources produce audio

• WHEN microphone and computer output audio chunks are available
• THEN Meeting Assistant mixes them into one PCM stream before transcription

Scenario: Device-level capture cannot be verified in tests

• WHEN automated tests run without live audio devices
• THEN Meeting Assistant verifies the audio mixer through deterministic source abstractions rather than depending on physical microphone or speaker devices

Requirement: Stopping recording drains captured audio through transcription

Meeting Assistant SHALL stop capturing new audio when recording mode is stopped, but it SHALL allow already captured audio to finish running through the configured speech recognition pipeline before the recording session completes.

Scenario: Hotkey stops recording with buffered audio

• WHEN the user presses the hotkey to stop recording while captured audio is still buffered for transcription
• THEN Meeting Assistant stops capturing new audio and appends transcription output for the already captured audio before reporting the recording stopped

Requirement: Transcripts are written to the configured vault folder

Meeting Assistant SHALL write live transcript text to a markdown file in the configured vault folder.

Scenario: Recording starts

• WHEN recording mode starts
• THEN Meeting Assistant creates the configured vault folder if necessary and creates a transcript markdown file

Scenario: Transcription segment arrives

• WHEN the speech recognition pipeline emits a live transcript segment
• THEN Meeting Assistant appends that segment to the active transcript text file