Skip to content

docs: update documentation to match current codebase#68

Merged
pasrom merged 1 commit intomainfrom
docs/auto-update-2026-03-24
Mar 24, 2026
Merged

docs: update documentation to match current codebase#68
pasrom merged 1 commit intomainfrom
docs/auto-update-2026-03-24

Conversation

@pasrom
Copy link
Copy Markdown
Owner

@pasrom pasrom commented Mar 24, 2026

Summary

Documentation was out of sync with the codebase after several recent feature additions. This PR updates CLAUDE.md and docs/architecture-macos.md to reflect the current state of the code.

Changes

New source files added to project structure:

  • AudioConstants.swift — shared audio pipeline constants (target sample rate)
  • MeetingDetecting.swiftMeetingDetecting protocol + DetectedMeeting model
  • PermissionRow.swift — permission status row UI component
  • PowerAssertionDetector.swift — IOKit power assertion–based meeting detection
  • MicRestartPolicy.swift (audiotap) — pure decision logic for mic engine restart on device change

Removed stale entries:

  • MuteDetector.swift — file no longer exists in the codebase

Protocol generation updates (from feat(app): add None LLM provider and feat(app): make protocol output language configurable):

  • ProtocolProvider enum now has .none option (transcript only, no LLM)
  • AppSettings.protocolLanguage replaces the hardcoded "German" convention note
  • Architecture doc updated with a new Provider Selection section and corrected language substitution description

Other fixes:

  • Package.swift description now mentions SnapshotTesting test dependency
  • Added three new plan files to docs/plans/ listing
  • architecture-macos.md: ProtocolGenerator.swift description corrected (it's shared utilities, not the CLI invoker); ClaudeCLIProtocolGenerator.swift and OpenAIProtocolGenerator.swift added as separate table rows
  • Testing Hooks table: replaced stale MuteDetector / muteStateProvider row with PowerAssertionDetector / assertionProvider + windowListProvider

https://claude.ai/code/session_01Vrp4inxdcSo3sFFqWpdD2C

- Add AudioConstants.swift, MeetingDetecting.swift, PermissionRow.swift,
  PowerAssertionDetector.swift to CLAUDE.md project structure
- Remove deleted MuteDetector.swift from CLAUDE.md and architecture-macos.md
- Add MicRestartPolicy.swift to tools/audiotap/Sources/ listing
- Add new plan files (appstate-tests, repo-review, workflow integration tests)
  to docs/plans/ listing
- Update Package.swift description to mention SnapshotTesting dependency
- Update Conventions: protocol output language is now configurable via
  AppSettings.protocolLanguage (default German), not hardcoded
- Update Architecture Notes: ProtocolProvider enum now has .none option;
  add protocolLanguage note; add MeetingDetecting protocol + PowerAssertionDetector
- Fix architecture-macos.md: ProtocolGenerator.swift is shared utilities,
  not the CLI invoker; split out ClaudeCLIProtocolGenerator and OpenAIProtocolGenerator
  as separate table rows; add Provider Selection section in Protocol Generation
- Update Testing Hooks: replace MuteDetector row with PowerAssertionDetector
- Add PermissionRow.swift and AudioConstants.swift to architecture-macos.md tables

https://claude.ai/code/session_01Vrp4inxdcSo3sFFqWpdD2C
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 24, 2026
@pasrom pasrom merged commit 2773401 into main Mar 24, 2026
7 checks passed
@pasrom pasrom deleted the docs/auto-update-2026-03-24 branch March 24, 2026 19:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants