Skip to content

docs: add missing DebugRPCServer endpoints and mt-cli subcommands#253

Open
pasrom wants to merge 1 commit into
mainfrom
docs/auto-update
Open

docs: add missing DebugRPCServer endpoints and mt-cli subcommands#253
pasrom wants to merge 1 commit into
mainfrom
docs/auto-update

Conversation

@pasrom
Copy link
Copy Markdown
Owner

@pasrom pasrom commented May 13, 2026

Summary

  • Six new RPC action endpoints added since the last docs sync (skipNaming, enqueueFile, renameSpeaker, deleteSpeaker, mergeSpeakers, seedSpeaker) were absent from both CLAUDE.md and docs/architecture-macos.md.
  • Four matching mt-cli subcommands (seed-speaker, rename-speaker, delete-speaker, merge-speakers) were also missing from the Companion CLIs table in the architecture doc.

Files changed:

  • CLAUDE.md — extended endpoint list under Debug RPC server; clarified that speaker-DB actions are wired via the speakerActions closure injected by AppState
  • docs/architecture-macos.md — updated ASCII diagram, Companion CLIs table, and Testing Hooks table

No code changes. README, CONTRIBUTING, and all source files are up to date.

Test plan

  • Verify endpoint list in CLAUDE.md matches DebugRPCServer.swift switch cases
  • Verify mt-cli subcommand list matches MTCLI.swift subcommands: array

Generated by Claude Code


View in Codesmith
Need help on this PR? Tag @codesmith with what you need.

  • Let Codesmith autofix CI failures and bot reviews

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 13, 2026
@pasrom pasrom force-pushed the docs/auto-update branch from 7286517 to 2aa7cca Compare May 14, 2026 07:06
Copy link
Copy Markdown
Owner Author

pasrom commented May 14, 2026

Doc-sync run 2026-05-14

Branch was reset onto current main (61fee2b). Changes in this run:

  • CLAUDE.md: added scripts/export-lcov.sh to the file tree (missing since the Codecov CI work landed after the last docs sync)
  • CLAUDE.md: extended DebugRPCServer endpoint list with all six new action endpoints (skipNaming, enqueueFile, renameSpeaker, deleteSpeaker, mergeSpeakers, seedSpeaker)
  • docs/architecture-macos.md: same six endpoints added to the ASCII pipeline diagram box, the Support table row, and the Testing Hooks table
  • docs/architecture-macos.md: four new mt-cli subcommands (seed-speaker, rename-speaker, delete-speaker, merge-speakers) added to the Companion CLIs table

README.md and CONTRIBUTING.md are up to date — no changes needed.


Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from 2aa7cca to 686a6e0 Compare May 15, 2026 07:12
Copy link
Copy Markdown
Owner Author

pasrom commented May 15, 2026

Doc sync run — 2026-05-15

Branch reset onto latest main (a1fcbb9). Changes included in this run:

  • CLAUDE.md

    • Added export-lcov.sh to the scripts listing (new script from ci(codecov): move LCOV export shell into scripts/export-lcov.sh)
    • Updated ci.yml description from "3 parallel jobs" to reflect the Codecov coverage upload and the new audiotap-coverage job
    • Extended DebugRPCServer endpoints list with all six new action endpoints
  • docs/architecture-macos.md

    • Updated ASCII pipeline diagram to list the six new RPC action endpoints
    • Added seed-speaker, rename-speaker, delete-speaker, merge-speakers to the mt-cli Companion CLIs table
    • Updated the Testing Hooks table entry for DebugRPCServer to include the new endpoints

README.md and CONTRIBUTING.md are up to date — no changes needed.


Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from 686a6e0 to c71bdf0 Compare May 16, 2026 07:06
Copy link
Copy Markdown
Owner Author

pasrom commented May 16, 2026

Doc sync update (2026-05-16)

Branch force-pushed with a new commit on top of latest main. Changes in this run:

  • CLAUDE.md — file tree: Added Settings/PickerLanguages.swift (language picker entries extracted from transcription settings views for WhisperKit, Parakeet, and Qwen3).
  • CLAUDE.md — scripts: Added scripts/export-lcov.sh (SPM LCOV coverage export, used by CI codecov jobs) and scripts/keychain-prepend.sh (idempotent atomic keychain helper, used by CI).
  • CLAUDE.md — architecture notes: Updated Parakeet language-selection note — was "auto-detects language (no parameter)", now documents the optional AppSettings.parakeetLanguage hint added by the Parakeet language-picker feature.
  • docs/architecture-macos.md: Updated Parakeet "Language selection" column from "Auto-detect only" to "Manual or auto-detect", and added a bullet to the Parakeet Engine section describing the language hint and PickerLanguages.parakeet (18 exposed languages).

No code changes. README and CONTRIBUTING are up to date.


Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from c71bdf0 to 20592a3 Compare May 17, 2026 07:14
Copy link
Copy Markdown
Owner Author

pasrom commented May 17, 2026

Doc-sync update (2026-05-17)

New files and changes since last sync:

New source files added to CLAUDE.md and docs/architecture-macos.md:

  • WatchLoopEndPolicy.swift, WatchLoopState.swift, ManualRecordingMonitorPolicy.swift — pure-function extractions from WatchLoop for testability
  • PipelineSnapshot.swift — off-main-actor I/O helper extracted from PipelineQueue
  • RecordingFileSuffix.swift — centralized filename suffix constants (_mix.wav, _app.wav, _mic.wav)
  • PairedImportPanelDelegate.swift + PairedRecordingResolver.swift — paired _app+_mic reimport feature
  • Settings/PickerLanguages.swift — language picker entries for WhisperKit, Parakeet, and Qwen3

New scripts added to CLAUDE.md:

  • export-lcov.sh — LCOV coverage export for SPM xctest bundles
  • keychain-prepend.sh — idempotent keychain search-list prepend helper

Architecture notes updated:

  • Parakeet now supports explicit language selection (AppSettings.parakeetLanguage); "Auto-detect only" row in the engine comparison table corrected to "Manual or auto-detect"
  • Record-only mode suffix-constants note updated to reference the new centralized RecordingFileSuffix enum
  • docs/architecture-macos.md: Parakeet Engine section now documents the language setting; new files added to source tables

Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from 20592a3 to 52e0bc7 Compare May 18, 2026 07:07
Copy link
Copy Markdown
Owner Author

pasrom commented May 18, 2026

Docs sync update (2026-05-18)

Added 9 source files and 2 scripts that appeared since the last sync:

New source files (CLAUDE.md + architecture-macos.md):

  • Settings/PickerLanguages.swift — language picker data for WhisperKit, Parakeet, Qwen3
  • PairedImportPanelDelegate.swift + PairedRecordingResolver.swift — paired _app+_mic recording re-import (feat from #9e436dc)
  • PipelineSnapshot.swift — I/O helper extracted from PipelineQueue
  • RecordingFileSuffix.swift — centralized _mix.wav / _app.wav / _mic.wav constants
  • WatchLoopEndPolicy.swift + WatchLoopState.swift — decision function and value-type snapshot extracted from WatchLoop
  • ManualRecordingMonitorPolicy.swift — decision function for WatchLoop.monitorManualRecording

New scripts (CLAUDE.md):

  • export-lcov.sh — LCOV coverage export for SPM xctest bundles
  • keychain-prepend.sh — idempotent, atomic keychain search-list helper

Updated prose (CLAUDE.md):

  • Record-only mode suffix-constants note updated: audio suffixes now centralized in RecordingFileSuffix; DualSourceRecorder.mixFilenameSuffix is a forwarding alias.

Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from 52e0bc7 to e6bf8f4 Compare May 19, 2026 07:12
Copy link
Copy Markdown
Owner Author

pasrom commented May 19, 2026

Doc sync update — 2026-05-19

This run added documentation for files introduced since the last pass:

New source files (CLAUDE.md project structure + architecture-macos.md Source Files tables):

  • WatchLoopState, WatchLoopEndPolicy, ManualRecordingMonitorPolicy — pure decision helpers extracted from WatchLoop for testability
  • PipelineSnapshot — pure I/O helper extracted from PipelineQueue for off-main-actor serialization
  • RecordingFileSuffix — centralised audio-file suffix constants (_mix/_app/_mic.wav); the Record-only mode note updated to reflect that DualSourceRecorder.mixFilenameSuffix is now a forwarding alias
  • PairedImportPanelDelegate + PairedRecordingResolver — paired recording import feature (import _app+_mic as one dual-track job)
  • Settings/PickerLanguages — language picker entries for all three ASR engines

New scripts (CLAUDE.md scripts listing):

  • export-lcov.sh — LCOV coverage export for SPM packages
  • keychain-prepend.sh — idempotent keychain prepend used by CI

Testing Hooks table (architecture-macos.md):

  • Added WatchLoopEndPolicy.step and ManualRecordingMonitorPolicy.step as pure-function test entry points (same pattern as BadgeKind.compute)

No code changes.


Generated by Claude Code

@pasrom pasrom force-pushed the docs/auto-update branch from e6bf8f4 to df3ea5e Compare May 20, 2026 07:09
Copy link
Copy Markdown
Owner Author

pasrom commented May 20, 2026

Doc sync — 2026-05-20

Branch force-updated onto current main (b7b2f97). Changes in this run:

CLAUDE.md — project structure:

  • Added 10 new source files under Sources/: ChannelHealthMonitor, SilentRecordingMonitor, WatchLoopEndPolicy, WatchLoopState, ManualRecordingMonitorPolicy, PairedImportPanelDelegate, PairedRecordingResolver, PipelineSnapshot, SnapshotWriterActor, RecordingFileSuffix
  • Added Settings/PickerLanguages.swift
  • Added 2 new AudioTapLib sources: CurrentLevel, LevelPublisher
  • Added new scripts: e2e-channel-health.sh, e2e-silent-recording.sh, export-lcov.sh, keychain-prepend.sh, assert-red-pixels.swift, scripts/lib/e2e-helpers.sh
  • Updated docs/ entry: new channel-silent GIFs, settings-overview.png, two new plan files

docs/architecture-macos.md — Source Files tables:

  • Added all the above new files to the appropriate sections (App Entry & UI, Core Pipeline, Audio Processing)
  • Noted CurrentLevel and LevelPublisher in the AudioTapLib entry

README.md — features list:

  • Added "Record-only mode" and "Per-channel silent indicator" bullet points

Generated by Claude Code

Add 12 new app source files, 4 new AudioTapLib source files, and 6 new
scripts that were added to the codebase but not listed in the docs.

New app sources: ChannelHealthMonitor, SilentRecordingMonitor (per-channel
and symmetric-silence state machines), WatchLoopState, WatchLoopEndPolicy,
ManualRecordingMonitorPolicy (WatchLoop pure-policy extractions),
PipelineSnapshot, SnapshotWriterActor (queue persistence helpers),
RecordingFileSuffix (suffix constants), PairedImportPanelDelegate,
PairedRecordingResolver (paired file import), ParakeetTokenGrouping,
Qwen3AsrChunking (extracted ASR helpers).

New AudioTapLib sources: AppAudioCapture+PIDTranslation, ProcessTreeEnumerator
(Electron PID-tree tap), CurrentLevel, LevelPublisher (per-channel RMS).

New scripts: e2e-channel-health.sh, e2e-silent-recording.sh, assert-red-pixels.swift,
export-lcov.sh, keychain-prepend.sh, lib/e2e-helpers.sh.

Also updates architecture-macos.md Source Files tables with entries for
all newly added types.

https://claude.ai/code/session_01DvhVqViXHCdnQp8kpa35sn
@pasrom pasrom force-pushed the docs/auto-update branch from df3ea5e to 0ac111d Compare May 21, 2026 07:14
Copy link
Copy Markdown
Owner Author

pasrom commented May 21, 2026

Doc-sync update — 2026-05-21

Branch force-pushed with a new commit covering source files and scripts that have been added since the last sync.

CLAUDE.md — file tree additions:

  • Sources/: ChannelHealthMonitor, SilentRecordingMonitor, WatchLoopState, WatchLoopEndPolicy, ManualRecordingMonitorPolicy, PipelineSnapshot, SnapshotWriterActor, RecordingFileSuffix, PairedImportPanelDelegate, PairedRecordingResolver, ParakeetTokenGrouping, Qwen3AsrChunking
  • tools/audiotap/Sources/: AppAudioCapture+PIDTranslation, ProcessTreeEnumerator, CurrentLevel, LevelPublisher
  • scripts/: e2e-channel-health.sh, e2e-silent-recording.sh, assert-red-pixels.swift, export-lcov.sh, keychain-prepend.sh, lib/e2e-helpers.sh

docs/architecture-macos.md — Source Files tables:

  • Core Pipeline: added WatchLoopState, WatchLoopEndPolicy, ManualRecordingMonitorPolicy, PipelineSnapshot, SnapshotWriterActor, ParakeetTokenGrouping, Qwen3AsrChunking, RecordingFileSuffix, PairedImportPanelDelegate, PairedRecordingResolver
  • Audio Processing: added ChannelHealthMonitor, SilentRecordingMonitor

No code changes. README and CONTRIBUTING are up to date.


Generated by Claude Code

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