Implement meeting assistant v1

2026-05-20 02:06:16 +02:00
parent 90df1edc03
commit 0297bcc0f6
120 changed files with 11883 additions and 180 deletions
@@ -0,0 +1,45 @@
+# 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
+