Skip to content

feat: VocaHQ parity (output polish, power controls, settings shell) - #207

Merged
jatinkrmalik merged 17 commits into
mainfrom
jatin/vocamac-cli-features-042a
Aug 12, 2026
Merged

feat: VocaHQ parity (output polish, power controls, settings shell)#207
jatinkrmalik merged 17 commits into
mainfrom
jatin/vocamac-cli-features-042a

Conversation

@jatinkrmalik

@jatinkrmalik jatinkrmalik commented Aug 11, 2026

Copy link
Copy Markdown
Member

Summary

Ports the main VocaLinux v0.15 gaps onto VocaMac, then polishes the settings shell and recording overlay after Tahoe testing. Includes the docs parity plan that used to live in #206.

Dictation and power

  • Trailing space and auto-capitalize before inject (defaults on)
  • Auto-pause for listed apps (match by bundle ID or process name); unloads the model and blocks hotkeys while they run
  • Optional idle model unload (default off) with sleep/wake recovery via NSWorkspace
  • Shared SpeechTranscribing.unloadModel() path on TranscriptionRouter
  • Performance settings show loaded/unloaded state, estimated model RAM, and approx RSS drop after unload
  • Menu bar explains auto-pause (including which app) and idle unload so "no model loaded" is not a mystery

Settings shell

  • Sidebar + detail layout with search at the top of the sidebar (System Settings style)
  • One top-right sidebar toggle (custom layout; no duplicate/jumping system toggles)
  • Footer Test Dictation: status, level meter, results in place; does not inject text
  • Speech Model focuses on catalog + language; translation/vocab only when the engine supports them
  • System info and live resource pills live under Advanced
  • Stats Share copies a dark branded card image to the clipboard
  • Setup Wizard stays under About (removed from the menu bar popover)
  • Expanded searchable language catalog (~36 + auto)
  • Recording overlay controls stay under Application

Recording overlay and menu bar

  • Overlay follows light/dark appearance, with stronger contrast and a brand-teal glow while recording
  • Waveform is more sensitive to quiet speech; slide-in from top or bottom based on position
  • Cancel button removed; brand mark instead of a red status dot; clicks pass through
  • Hot mic uses brand teal in the menu bar; processing uses yellow (not purple)

Docs

  • docs/VOCAHQ_PARITY.md matrix and phased delivery notes updated
  • Preference keys documented in DATA_MODEL.md

Test plan

  • Unit tests (formatter, auto-pause, keep-alive, search index, languages, overlay sizes, share snapshot, inject vs test-dictation)
  • CI green on macos-15
  • Signed/notarized /build DMGs exercised on Tahoe during review
  • Final smoke after merge: two PTT sessions with trailing space; auto-pause with a listed app; idle unload; Test Dictation footer only; sidebar toggle stays top-right; overlay colors in light and dark; menu bar teal while recording
Open in Web Open in Cursor 

@github-actions github-actions Bot added app ci docs documentation Improvements or additions to documentation web and removed ci web labels Aug 11, 2026
@cursor
cursor Bot changed the base branch from jatin/vocahq-parity-plan-eb4c to main August 11, 2026 02:07
@cursor
cursor Bot force-pushed the jatin/vocamac-cli-features-042a branch from 7e54b65 to 9ac0a4f Compare August 11, 2026 18:13
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for 9ac0a4f

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+9ac0a4f-arm64.dmg
Size 20M
Branch jatin/vocamac-cli-features-042a
Commit 9ac0a4f
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
ce813d01fc7b9a65d66c483861a4b6ebe0f35461faeee8b0d78aec25d1d888c5  VocaMac-0.7.2-pr.207+9ac0a4f-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

jatinkrmalik and others added 6 commits August 11, 2026 19:24
Capture the Mac gap matrix and phased port plan (settings sidebar +
search, auto-pause, idle unload, dictation polish) and point
ARCHITECTURE cross-platform notes at VocaLinux / VocaHQ.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Port VocaLinux output polish (#554/#608) and power controls (#592):
trailing space + auto-capitalize before inject, AutoPauseMonitor,
ModelKeepAlive, sleep/wake recovery, and SpeechTranscribing.unloadModel.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Replace TabView settings chrome with NavigationSplitView, live search,
and a status/Test Dictation footer. Expand the transcription language
catalog with a searchable picker and update the VocaHQ parity matrix.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor
cursor Bot force-pushed the jatin/vocamac-cli-features-042a branch from 9ac0a4f to bdd00bf Compare August 11, 2026 19:24
@jatinkrmalik

Copy link
Copy Markdown
Member Author

/build

@github-actions

Copy link
Copy Markdown

PR Build started for bdd00bf

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+bdd00bf-arm64.dmg
Size 19M
Branch jatin/vocamac-cli-features-042a
Commit bdd00bf
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
6a6fa95a464debe929cc0555d51685884ee1f0398adf2468dab49741ea2b6323  VocaMac-0.7.2-pr.207+bdd00bf-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

Fix Tahoe NavigationSplitView About breakage via safeAreaInset footer,
improve Test Dictation feedback, slim Speech Model IA, add Stats Share,
bury menu-bar Setup Wizard, and replace overlay cancel/red-dot with the
Voca mark.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for 6a0d7ea

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build failed for 6a0d7ea

View build logs →

💡 Fix the issue and comment /build to retry.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for e5ee3de

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+e5ee3de-arm64.dmg
Size 20M
Branch jatin/vocamac-cli-features-042a
Commit e5ee3de
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
c9da673c9d321a77fe7b4c03422510915f7d450e319c9b95f03d5cfdd276cf26  VocaMac-0.7.2-pr.207+e5ee3de-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

@github-actions

Copy link
Copy Markdown

PR Build started for 7e13254

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+7e13254-arm64.dmg
Size 20M
Branch jatin/vocamac-cli-features-042a
Commit 7e13254
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
a1743c59b0c7c37cb8641e8027ab81aa7a98664e2b70e8d30e2c157de2c047c3  VocaMac-0.7.2-pr.207+7e13254-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

Replace NavigationSplitView's relocating system sidebar button with a
custom trailing toolbar control and hide the default toggle on macOS 15+.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for c233a19

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+c233a19-arm64.dmg
Size 19M
Branch jatin/vocamac-cli-features-042a
Commit c233a19
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
435f6bda64db9e366eca368f8b9a6447e7353f577056f9a307523b88e2df8ce9  VocaMac-0.7.2-pr.207+c233a19-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

Use a manual sidebar + detail layout with a single top-right toolbar
button so Tahoe no longer injects relocating left/right system toggles.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for 375fa34

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+375fa34-arm64.dmg
Size 19M
Branch jatin/vocamac-cli-features-042a
Commit 375fa34
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
2ae3313f4c6453f1b118d4b403e4525e42ba96f3922a32733e9f30a4c3a88c0d  VocaMac-0.7.2-pr.207+375fa34-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

Show loaded/unloaded state with estimated RAM in Performance, track
unload reason and approx freed RSS, and explain auto-pause clearly in
the menu bar popover.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 12, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for 8146c82

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

Align menu bar mark, popover status, and overlay processing colors with
the trademark teal recording state instead of red/purple.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 12, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for e2e0e30

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+e2e0e30-arm64.dmg
Size 20M
Branch jatin/vocamac-cli-features-042a
Commit e2e0e30
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
d83ac50956430f885fe58e807bd2b5492c8c9818569ad010cbc1209d5a86f695  VocaMac-0.7.2-pr.207+e2e0e30-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

@jatinkrmalik

Copy link
Copy Markdown
Member Author
image image

@cursor cursor Bot changed the title feat: VocaHQ parity — output polish, power controls, sidebar settings feat: VocaHQ parity (output polish, power controls, settings shell) Aug 12, 2026
@jatinkrmalik
jatinkrmalik marked this pull request as ready for review August 12, 2026 00:33
cursoragent and others added 2 commits August 12, 2026 00:38
No behavior changes. Clean up strings and docs added in this branch so
the UI does not read like generated filler.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
Correct sidebar implementation notes, footer behavior, Performance vs
Advanced placement, resolved open questions, and follow-up items.

Co-authored-by: Jatin K Malik <jatinkrmalik@users.noreply.github.com>
@cursor

cursor Bot commented Aug 12, 2026

Copy link
Copy Markdown

/build

@github-actions

Copy link
Copy Markdown

PR Build started for 4fac241

Build signed & notarized DMG... this usually takes 10–20 minutes.

Watch the build →

@github-actions

Copy link
Copy Markdown

PR Build ready!

DMG VocaMac-0.7.2-pr.207+4fac241-arm64.dmg
Size 20M
Branch jatin/vocamac-cli-features-042a
Commit 4fac241
Signed ✅ Developer ID
Notarized ✅ Apple

📥 Install

  1. Click the DMG link above to download
  2. Open the DMG and drag VocaMac to Applications (replace existing)
  3. Open VocaMac — No Gatekeeper warnings, no permission resets
SHA-256 checksum
6c5b34e3e33f8a4c7ef18b6e557d322279b4f26148735784e52e054a00334905  VocaMac-0.7.2-pr.207+4fac241-arm64.dmg

💡 Comment /build or /build-quick to rebuild.

@jatinkrmalik
jatinkrmalik merged commit 9250c0f into main Aug 12, 2026
5 checks passed
@jatinkrmalik
jatinkrmalik deleted the jatin/vocamac-cli-features-042a branch August 22, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

app docs documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants