stenograf 0.2.2__tar.gz → 0.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (288) hide show
  1. {stenograf-0.2.2 → stenograf-0.4.0}/.claude/skills/verify/SKILL.md +5 -0
  2. stenograf-0.4.0/.gitattributes +5 -0
  3. {stenograf-0.2.2 → stenograf-0.4.0}/.github/workflows/ci.yml +7 -1
  4. stenograf-0.4.0/.github/workflows/release.yml +303 -0
  5. stenograf-0.4.0/CLAUDE.md +83 -0
  6. {stenograf-0.2.2 → stenograf-0.4.0}/PKG-INFO +90 -13
  7. stenograf-0.4.0/PLAN-LINUX.md +378 -0
  8. stenograf-0.4.0/PLAN.md +407 -0
  9. {stenograf-0.2.2 → stenograf-0.4.0}/README.md +86 -12
  10. stenograf-0.4.0/eval/README.md +406 -0
  11. {stenograf-0.2.2 → stenograf-0.4.0}/eval/adjudicate.py +189 -15
  12. {stenograf-0.2.2 → stenograf-0.4.0}/eval/aec_rig.py +1 -1
  13. {stenograf-0.2.2 → stenograf-0.4.0}/eval/aec_score.py +1 -1
  14. {stenograf-0.2.2 → stenograf-0.4.0}/eval/backends.py +1 -1
  15. stenograf-0.4.0/eval/bias.py +858 -0
  16. stenograf-0.4.0/eval/bias_confidence.py +190 -0
  17. stenograf-0.4.0/eval/bias_data.py +226 -0
  18. stenograf-0.4.0/eval/bias_fluid.py +346 -0
  19. stenograf-0.4.0/eval/bias_score.py +452 -0
  20. stenograf-0.4.0/eval/bias_tts.py +314 -0
  21. {stenograf-0.2.2 → stenograf-0.4.0}/eval/common.py +16 -4
  22. stenograf-0.4.0/eval/context_ab.py +276 -0
  23. {stenograf-0.2.2 → stenograf-0.4.0}/eval/der.py +1 -1
  24. {stenograf-0.2.2 → stenograf-0.4.0}/eval/diarize.py +13 -7
  25. {stenograf-0.2.2 → stenograf-0.4.0}/eval/extract.py +7 -1
  26. {stenograf-0.2.2 → stenograf-0.4.0}/eval/live.py +60 -25
  27. {stenograf-0.2.2 → stenograf-0.4.0}/eval/manifest.example.json +9 -0
  28. {stenograf-0.2.2 → stenograf-0.4.0}/eval/parity.py +5 -3
  29. stenograf-0.4.0/eval/retranscribe_compare.py +267 -0
  30. {stenograf-0.2.2 → stenograf-0.4.0}/eval/scan_languages.py +13 -3
  31. {stenograf-0.2.2 → stenograf-0.4.0}/eval/transcribe.py +1 -3
  32. stenograf-0.4.0/eval/windows.py +161 -0
  33. stenograf-0.4.0/hatch_build.py +162 -0
  34. {stenograf-0.2.2 → stenograf-0.4.0}/native/README.md +39 -4
  35. stenograf-0.4.0/native/appbundle/Info.plist +50 -0
  36. stenograf-0.4.0/native/appbundle/README.md +120 -0
  37. stenograf-0.4.0/native/appbundle/build.sh +49 -0
  38. stenograf-0.4.0/native/appbundle/icon.svg +116 -0
  39. stenograf-0.4.0/native/appbundle/main.c +310 -0
  40. stenograf-0.4.0/native/appbundle/render_icon.py +56 -0
  41. stenograf-0.4.0/native/helper/main.swift +825 -0
  42. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/Cargo.lock +11 -0
  43. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/Cargo.toml +10 -0
  44. stenograf-0.4.0/native/stenodiar/build.sh +42 -0
  45. {stenograf-0.2.2 → stenograf-0.4.0}/pyproject.toml +34 -1
  46. stenograf-0.4.0/scripts/hooks/pre-commit +33 -0
  47. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/__init__.py +6 -0
  48. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/aec.py +3 -3
  49. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/asr/base.py +1 -1
  50. stenograf-0.4.0/src/stenograf/asr/biasing.py +368 -0
  51. stenograf-0.4.0/src/stenograf/asr/parakeet.py +254 -0
  52. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/asr/parakeet_onnx.py +101 -3
  53. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/asr/registry.py +1 -1
  54. stenograf-0.4.0/src/stenograf/asr/tokens.py +146 -0
  55. stenograf-0.4.0/src/stenograf/assets/Stenograf.app/Contents/Info.plist +50 -0
  56. stenograf-0.4.0/src/stenograf/assets/Stenograf.app/Contents/MacOS/Stenograf +0 -0
  57. stenograf-0.4.0/src/stenograf/assets/Stenograf.app/Contents/Resources/Stenograf.icns +0 -0
  58. stenograf-0.4.0/src/stenograf/assets/Stenograf.app/Contents/_CodeSignature/CodeResources +128 -0
  59. stenograf-0.4.0/src/stenograf/assets/icon.png +0 -0
  60. stenograf-0.4.0/src/stenograf/assets/tray.svg +28 -0
  61. stenograf-0.4.0/src/stenograf/captions.py +161 -0
  62. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/base.py +13 -1
  63. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/file.py +2 -2
  64. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/linux.py +26 -6
  65. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/macos.py +133 -13
  66. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/streaming.py +38 -0
  67. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/windows.py +12 -8
  68. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/__init__.py +37 -10
  69. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/doctor_cmd.py +24 -7
  70. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/format.py +2 -3
  71. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/notes.py +42 -2
  72. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/run.py +17 -8
  73. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/start.py +145 -40
  74. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/transcribe.py +12 -4
  75. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/config.py +6 -6
  76. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/diarization/sherpa.py +1 -1
  77. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/doctor.py +11 -5
  78. stenograf-0.4.0/src/stenograf/flow.py +525 -0
  79. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/glossary.py +78 -13
  80. stenograf-0.4.0/src/stenograf/gui/__init__.py +41 -0
  81. stenograf-0.4.0/src/stenograf/gui/app.py +517 -0
  82. stenograf-0.4.0/src/stenograf/gui/meeting.py +316 -0
  83. stenograf-0.4.0/src/stenograf/gui/qml/Btn.qml +37 -0
  84. stenograf-0.4.0/src/stenograf/gui/qml/Combo.qml +93 -0
  85. stenograf-0.4.0/src/stenograf/gui/qml/Doctor.qml +79 -0
  86. stenograf-0.4.0/src/stenograf/gui/qml/Field.qml +23 -0
  87. stenograf-0.4.0/src/stenograf/gui/qml/Home.qml +92 -0
  88. stenograf-0.4.0/src/stenograf/gui/qml/Main.qml +79 -0
  89. stenograf-0.4.0/src/stenograf/gui/qml/Meeting.qml +301 -0
  90. stenograf-0.4.0/src/stenograf/gui/qml/Notes.qml +78 -0
  91. stenograf-0.4.0/src/stenograf/gui/qml/Panel.qml +77 -0
  92. stenograf-0.4.0/src/stenograf/gui/qml/Settings.qml +58 -0
  93. stenograf-0.4.0/src/stenograf/gui/qml/Setup.qml +166 -0
  94. stenograf-0.4.0/src/stenograf/gui/qml/Theme.qml +34 -0
  95. stenograf-0.4.0/src/stenograf/gui/qml/Toggle.qml +79 -0
  96. stenograf-0.4.0/src/stenograf/gui/qml/Transcribe.qml +94 -0
  97. stenograf-0.4.0/src/stenograf/gui/qml/qmldir +3 -0
  98. stenograf-0.4.0/src/stenograf/gui/screens.py +309 -0
  99. stenograf-0.4.0/src/stenograf/gui/tray.py +386 -0
  100. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/lid.py +1 -1
  101. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/live.py +32 -17
  102. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/loaders.py +83 -11
  103. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/__init__.py +1 -1
  104. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/command.py +1 -1
  105. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/export.py +1 -2
  106. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/generate.py +1 -1
  107. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/mlx.py +1 -1
  108. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/model.py +2 -2
  109. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/ollama.py +1 -1
  110. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/prompt.py +2 -2
  111. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/output.py +64 -9
  112. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/pipeline.py +33 -7
  113. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/profiles.py +5 -5
  114. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/session.py +38 -21
  115. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/settings.py +49 -7
  116. stenograf-0.4.0/src/stenograf/shortcut.py +401 -0
  117. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/transcript.py +2 -2
  118. stenograf-0.4.0/src/stenograf/ui/__init__.py +40 -0
  119. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/_fps.py +1 -1
  120. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/app.py +12 -2
  121. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/doctor.py +1 -1
  122. stenograf-0.4.0/src/stenograf/ui/flow.py +71 -0
  123. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/home.py +1 -1
  124. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/meeting.py +46 -112
  125. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/notes.py +7 -29
  126. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/settings.py +5 -19
  127. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/setup.py +31 -77
  128. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/transcribe.py +21 -135
  129. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/ui/widgets.py +1 -2
  130. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/vad.py +51 -1
  131. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/view.py +31 -7
  132. {stenograf-0.2.2 → stenograf-0.4.0}/tests/fake_parec.py +6 -1
  133. stenograf-0.4.0/tests/fake_stenocap.py +99 -0
  134. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_asr_parakeet_onnx.py +1 -1
  135. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_asr_tokens.py +15 -0
  136. stenograf-0.4.0/tests/test_biasing.py +157 -0
  137. stenograf-0.4.0/tests/test_biasing_loops.py +207 -0
  138. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_build_hook.py +78 -8
  139. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_capture_linux.py +25 -0
  140. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_capture_macos.py +89 -1
  141. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_capture_windows.py +14 -0
  142. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_cli.py +237 -19
  143. stenograf-0.4.0/tests/test_eval_bias.py +312 -0
  144. stenograf-0.4.0/tests/test_flow.py +138 -0
  145. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_glossary.py +60 -5
  146. stenograf-0.4.0/tests/test_gui.py +814 -0
  147. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_live.py +18 -6
  148. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_live_orchestration.py +52 -4
  149. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_meeting.py +2 -2
  150. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_notes_backends.py +1 -3
  151. stenograf-0.4.0/tests/test_output.py +113 -0
  152. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_session.py +32 -6
  153. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_settings.py +2 -0
  154. stenograf-0.4.0/tests/test_shortcut.py +422 -0
  155. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_transcript.py +1 -1
  156. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_ui.py +6 -1
  157. {stenograf-0.2.2 → stenograf-0.4.0}/uv.lock +123 -34
  158. stenograf-0.2.2/.github/workflows/release.yml +0 -191
  159. stenograf-0.2.2/CLAUDE.md +0 -55
  160. stenograf-0.2.2/PLAN-AEC.md +0 -217
  161. stenograf-0.2.2/PLAN-CLEANUP.md +0 -460
  162. stenograf-0.2.2/PLAN.md +0 -1301
  163. stenograf-0.2.2/eval/README.md +0 -142
  164. stenograf-0.2.2/hatch_build.py +0 -92
  165. stenograf-0.2.2/native/helper/main.swift +0 -464
  166. stenograf-0.2.2/native/stenodiar/build.sh +0 -14
  167. stenograf-0.2.2/src/stenograf/asr/parakeet.py +0 -128
  168. stenograf-0.2.2/src/stenograf/asr/tokens.py +0 -47
  169. stenograf-0.2.2/src/stenograf/shortcut.py +0 -106
  170. stenograf-0.2.2/src/stenograf/ui/__init__.py +0 -21
  171. stenograf-0.2.2/src/stenograf/ui/flow.py +0 -200
  172. stenograf-0.2.2/tests/fake_stenocap.py +0 -56
  173. stenograf-0.2.2/tests/test_output.py +0 -55
  174. stenograf-0.2.2/tests/test_shortcut.py +0 -140
  175. {stenograf-0.2.2 → stenograf-0.4.0}/.gitignore +0 -0
  176. {stenograf-0.2.2 → stenograf-0.4.0}/LICENSE +0 -0
  177. {stenograf-0.2.2 → stenograf-0.4.0}/eval/rttm.py +0 -0
  178. {stenograf-0.2.2 → stenograf-0.4.0}/eval/score.py +0 -0
  179. {stenograf-0.2.2 → stenograf-0.4.0}/install.ps1 +0 -0
  180. {stenograf-0.2.2 → stenograf-0.4.0}/install.sh +0 -0
  181. {stenograf-0.2.2 → stenograf-0.4.0}/native/helper/Info.plist +0 -0
  182. {stenograf-0.2.2 → stenograf-0.4.0}/native/helper/build.sh +0 -0
  183. {stenograf-0.2.2 → stenograf-0.4.0}/native/spike/Info.plist +0 -0
  184. {stenograf-0.2.2 → stenograf-0.4.0}/native/spike/build.sh +0 -0
  185. {stenograf-0.2.2 → stenograf-0.4.0}/native/spike/main.swift +0 -0
  186. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/.gitignore +0 -0
  187. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/build.ps1 +0 -0
  188. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/src/main.rs +0 -0
  189. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/VENDOR.md +0 -0
  190. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/Cargo.toml +0 -0
  191. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/LICENSE +0 -0
  192. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/README.md +0 -0
  193. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/binarize.rs +0 -0
  194. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/clustering/ahc.rs +0 -0
  195. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/clustering/plda.rs +0 -0
  196. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/clustering/vbx.rs +0 -0
  197. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/clustering.rs +0 -0
  198. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/coreml/array.rs +0 -0
  199. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/coreml/path.rs +0 -0
  200. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/coreml/runtime.rs +0 -0
  201. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/coreml.rs +0 -0
  202. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/batch.rs +0 -0
  203. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/chunk.rs +0 -0
  204. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/fbank.rs +0 -0
  205. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/load/sessions.rs +0 -0
  206. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/load.rs +0 -0
  207. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/native/loaders.rs +0 -0
  208. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/native.rs +0 -0
  209. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/paths.rs +0 -0
  210. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/run.rs +0 -0
  211. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/session.rs +0 -0
  212. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/tail.rs +0 -0
  213. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding/tensor.rs +0 -0
  214. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/embedding.rs +0 -0
  215. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/native.rs +0 -0
  216. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/parallel/batch.rs +0 -0
  217. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/parallel/single.rs +0 -0
  218. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/parallel.rs +0 -0
  219. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/run.rs +0 -0
  220. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation/tensor.rs +0 -0
  221. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference/segmentation.rs +0 -0
  222. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/inference.rs +0 -0
  223. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/lib.rs +0 -0
  224. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/linalg.rs +0 -0
  225. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/metrics.rs +0 -0
  226. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/models.rs +0 -0
  227. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/builder.rs +0 -0
  228. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding/collect.rs +0 -0
  229. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding/error.rs +0 -0
  230. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding/gpu.rs +0 -0
  231. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding/orchestrate.rs +0 -0
  232. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding/prep.rs +0 -0
  233. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/chunk_embedding.rs +0 -0
  234. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/clustering.rs +0 -0
  235. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/concurrent.rs +0 -0
  236. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/config.rs +0 -0
  237. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/post_inference.rs +0 -0
  238. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/queued.rs +0 -0
  239. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/tests.rs +0 -0
  240. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/types/data.rs +0 -0
  241. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/types/error.rs +0 -0
  242. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/types/extract.rs +0 -0
  243. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/types/layout.rs +0 -0
  244. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline/types.rs +0 -0
  245. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/pipeline.rs +0 -0
  246. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/powerset.rs +0 -0
  247. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/reconstruct.rs +0 -0
  248. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/segment.rs +0 -0
  249. {stenograf-0.2.2 → stenograf-0.4.0}/native/stenodiar/vendor/speakrs/src/utils.rs +0 -0
  250. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/__main__.py +0 -0
  251. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/asr/__init__.py +0 -0
  252. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/asr/providers.py +0 -0
  253. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/audio.py +0 -0
  254. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/capture/__init__.py +0 -0
  255. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/profiles.py +0 -0
  256. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/cli/settings_cmd.py +0 -0
  257. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/diarization/__init__.py +0 -0
  258. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/diarization/base.py +0 -0
  259. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/diarization/speakrs.py +0 -0
  260. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/models.py +0 -0
  261. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/notes/backend.py +0 -0
  262. {stenograf-0.2.2 → stenograf-0.4.0}/src/stenograf/recording.py +0 -0
  263. {stenograf-0.2.2 → stenograf-0.4.0}/tests/conftest.py +0 -0
  264. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_aec.py +0 -0
  265. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_asr_parakeet.py +0 -0
  266. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_asr_providers.py +0 -0
  267. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_asr_registry.py +0 -0
  268. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_audio.py +0 -0
  269. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_capture_file.py +0 -0
  270. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_capture_streaming.py +0 -0
  271. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_cli_notes.py +0 -0
  272. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_config.py +0 -0
  273. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_diarization_sherpa.py +0 -0
  274. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_diarization_sherpa_unit.py +0 -0
  275. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_diarization_speakrs.py +0 -0
  276. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_doctor.py +0 -0
  277. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_echo_dedup.py +0 -0
  278. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_eval_der.py +0 -0
  279. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_lid.py +0 -0
  280. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_models.py +0 -0
  281. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_notes_export.py +0 -0
  282. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_notes_generate.py +0 -0
  283. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_notes_model.py +0 -0
  284. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_pipeline.py +0 -0
  285. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_profiles.py +0 -0
  286. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_recording.py +0 -0
  287. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_vad.py +0 -0
  288. {stenograf-0.2.2 → stenograf-0.4.0}/tests/test_view.py +0 -0
@@ -88,3 +88,8 @@ remote-only scenario. TTS reads continuously — good stand-in for a monologue.
88
88
  audio time to wall time.
89
89
  - A user's real `steno start` (installed via uv tool) may be running — check
90
90
  `pgrep -fl steno` before killing anything.
91
+ - Backgrounded runs cannot be stopped with `kill -INT`: POSIX non-interactive
92
+ shells start `&` children with SIGINT *ignored*, and Python inherits that
93
+ disposition — the signal is a silent no-op and the meeting runs forever
94
+ (SIGTERM kills without finalizing). Use `--max-seconds N` to end a scripted
95
+ run; it stops capture by itself and runs the full finalize.
@@ -0,0 +1,5 @@
1
+ # The app bundle's bytes ARE the microphone grant (PLAN.md Phase 8 step 5): TCC
2
+ # pins the app to the cdhash of these exact files, so any end-of-line or
3
+ # encoding conversion on a checkout would silently revoke it for that user.
4
+ src/stenograf/assets/Stenograf.app/** binary
5
+ src/stenograf/assets/icon.png binary
@@ -26,6 +26,12 @@ jobs:
26
26
  - uses: astral-sh/setup-uv@v8.3.2
27
27
  with:
28
28
  enable-cache: true
29
+ # PySide6 links libEGL even under QT_QPA_PLATFORM=offscreen, and it is
30
+ # the one Qt runtime library the Linux runner image does not ship — so
31
+ # importing tests/test_gui.py fails at collection without it. Everything
32
+ # else Qt needs is already there; macOS and Windows need nothing.
33
+ - run: sudo apt-get install -y libegl1
34
+ if: runner.os == 'Linux'
29
35
  - run: uv sync
30
36
  - run: uv run ruff check .
31
37
  # macOS only: the platform-marker deps (mlx-lm, parakeet-mlx) are only
@@ -62,7 +68,7 @@ jobs:
62
68
  - run: cargo check --locked
63
69
  - run: cargo check --locked --features ${{ matrix.features }}
64
70
 
65
- # Functional live capture on the stable-distro reference (PLAN.md §5
71
+ # Functional live capture on the stable-distro reference (Phase 5
66
72
  # dev-environment plan): a real PulseAudio server, a null sink as the
67
73
  # default output, TTS speech played into it, `steno start` capturing the
68
74
  # monitor through LinuxCaptureProvider, and the transcript asserted on
@@ -0,0 +1,303 @@
1
+ name: release
2
+
3
+ # Tag v<version> → build the wheel matrix, smoke-test a clean install on every
4
+ # supported OS, publish to PyPI (Trusted Publishing/OIDC — no token secrets) and
5
+ # attach the artifacts to a GitHub release. workflow_dispatch runs everything
6
+ # except the publish step, as a dry run.
7
+
8
+ on:
9
+ push:
10
+ tags: ["v*"]
11
+ workflow_dispatch:
12
+
13
+ jobs:
14
+ build-macos:
15
+ # arm64 wheel with the compiled+signed stenocap (hatch_build.py)
16
+ runs-on: macos-15
17
+ timeout-minutes: 20
18
+ steps:
19
+ - uses: actions/checkout@v7
20
+ - uses: astral-sh/setup-uv@v8.3.2
21
+ # The runner image ships Rust (stenodiar); fail early and loudly if that
22
+ # ever changes rather than in the wheel-verify step.
23
+ - run: cargo --version
24
+ - run: uv build --wheel
25
+ - name: Verify the wheel bundles a signed helper for macOS 14.4+
26
+ run: |
27
+ ls dist/*macosx_14_0_arm64.whl
28
+ unzip -o dist/*.whl 'stenograf/bin/stenocap' -d /tmp/whl
29
+ otool -l /tmp/whl/stenograf/bin/stenocap | grep -q 'minos 14.4'
30
+ codesign -v /tmp/whl/stenograf/bin/stenocap
31
+ - name: Verify the wheel bundles the stenodiar diarization helper
32
+ # The build hook skips stenodiar when the runner lacks Rust rather
33
+ # than failing every source install — but a *published* wheel without
34
+ # it silently degrades estimated speaker counts, so refuse it here.
35
+ run: |
36
+ unzip -o dist/*.whl 'stenograf/bin/stenodiar' -d /tmp/whl
37
+ test -x /tmp/whl/stenograf/bin/stenodiar
38
+ /tmp/whl/stenograf/bin/stenodiar --help
39
+ - uses: actions/upload-artifact@v7
40
+ with:
41
+ name: dist-macos
42
+ path: dist/
43
+
44
+ build-pure:
45
+ # pure py3-none-any wheel + the sdist — what every platform without a
46
+ # specific wheel below installs (musl, Linux arm64, …): no helpers, and
47
+ # estimated speaker counts fall back to sherpa there.
48
+ runs-on: ubuntu-latest
49
+ timeout-minutes: 20
50
+ steps:
51
+ - uses: actions/checkout@v7
52
+ - uses: astral-sh/setup-uv@v8.3.2
53
+ - run: uv build
54
+ - name: Verify the pure wheel carries no helpers
55
+ # No STENOGRAF_BUNDLE_STENODIAR here, so the hook must stay a no-op.
56
+ run: |
57
+ ls dist/*py3-none-any.whl dist/*.tar.gz
58
+ if unzip -l dist/*.whl | grep -qE 'stenocap|stenodiar'; then
59
+ echo "pure wheel must not contain native helpers" >&2
60
+ exit 1
61
+ fi
62
+ - uses: actions/upload-artifact@v7
63
+ with:
64
+ name: dist-pure
65
+ path: dist/
66
+
67
+ build-linux-x86_64:
68
+ # manylinux wheel bundling stenodiar, pinned to the oldest runner whose
69
+ # glibc the build can actually use. That floor is not ours to choose: the
70
+ # onnxruntime static library ort-sys downloads references __isoc23_strtol
71
+ # and friends, glibc 2.38 symbols, so the link fails outright in an older
72
+ # image (manylinux_2_28 was tried and cannot build this at all). Ubuntu
73
+ # 24.04 is glibc 2.39, hence the tag; anything older installs the pure
74
+ # wheel and keeps sherpa-only diarization. Pin the version rather than
75
+ # ubuntu-latest — when that label moves, the floor must move deliberately,
76
+ # with the tag in hatch_build.py, not silently under users.
77
+ runs-on: ubuntu-24.04
78
+ timeout-minutes: 60
79
+ env:
80
+ STENOGRAF_BUNDLE_STENODIAR: "1"
81
+ steps:
82
+ - uses: actions/checkout@v7
83
+ # Both named rather than assumed from the runner image, because both
84
+ # failure modes are silent until the link step.
85
+ # libssl-dev is for the *build scripts*, not for us: ort-sys downloads
86
+ # onnxruntime over TLS at build time, and cargo resolves build-deps with
87
+ # their own feature set, so stenodiar's vendored-OpenSSL flag never
88
+ # reaches that copy of openssl-sys. The system OpenSSL links into a
89
+ # throwaway build script; the shipped helper carries the vendored one, as
90
+ # the ldd check asserts. perl (not perl-base) is what *builds* that
91
+ # vendored OpenSSL — its Configure wants FindBin, IPC::Cmd and Time::Piece.
92
+ - run: |
93
+ sudo apt-get update
94
+ sudo apt-get install -y libssl-dev perl
95
+ # The runner image ships Rust; fail early and loudly if that ever
96
+ # changes rather than inside the build hook.
97
+ - run: cargo --version
98
+ - uses: astral-sh/setup-uv@v8.3.2
99
+ - run: uv build --wheel
100
+ - name: Verify the wheel bundles a portable stenodiar
101
+ run: |
102
+ ls dist/*manylinux_2_39_x86_64.whl
103
+ unzip -o dist/*.whl 'stenograf/bin/stenodiar' -d /tmp/whl
104
+ test -x /tmp/whl/stenograf/bin/stenodiar
105
+ ldd /tmp/whl/stenograf/bin/stenodiar
106
+ # Three ways a helper built here dies on a user's machine.
107
+ # 1. A glibc symbol newer than the tag promises.
108
+ max=$(objdump -T /tmp/whl/stenograf/bin/stenodiar |
109
+ grep -o 'GLIBC_[0-9.]*' | sort -uV | tail -1)
110
+ echo "highest glibc symbol: $max"
111
+ test "$(printf '%s\n%s\n' "$max" GLIBC_2.39 | sort -V | tail -1)" = GLIBC_2.39
112
+ # 2. A libstdc++ newer than this runner's — measured rather than
113
+ # hardcoded, so the claim is "runs anywhere with a libstdc++ at
114
+ # least as new as the one we built against".
115
+ needed=$(objdump -T /tmp/whl/stenograf/bin/stenodiar |
116
+ grep -o 'GLIBCXX_[0-9.]*' | sort -uV | tail -1)
117
+ have=$(objdump -T /usr/lib/x86_64-linux-gnu/libstdc++.so.6 |
118
+ grep -o 'GLIBCXX_[0-9.]*' | sort -uV | tail -1)
119
+ echo "libstdc++: needs $needed, runner provides $have"
120
+ test "$(printf '%s\n%s\n' "$needed" "$have" | sort -V | tail -1)" = "$have"
121
+ # 3. The build machine's OpenSSL — stenodiar vendors it statically
122
+ # precisely so a user's OpenSSL version is never in the picture.
123
+ if ldd /tmp/whl/stenograf/bin/stenodiar | grep -qE 'libssl|libcrypto'; then
124
+ echo "stenodiar must not depend on the build machine's OpenSSL" >&2
125
+ exit 1
126
+ fi
127
+ /tmp/whl/stenograf/bin/stenodiar --help
128
+ - uses: actions/upload-artifact@v7
129
+ with:
130
+ name: dist-linux-x86_64
131
+ path: dist/
132
+
133
+ build-windows:
134
+ # win_amd64 wheel bundling stenodiar (build.ps1: ORT CPU, MSVC).
135
+ runs-on: windows-latest
136
+ timeout-minutes: 60
137
+ env:
138
+ STENOGRAF_BUNDLE_STENODIAR: "1"
139
+ steps:
140
+ - uses: actions/checkout@v7
141
+ - uses: astral-sh/setup-uv@v8.3.2
142
+ # The runner image ships Rust; fail early and loudly if that ever
143
+ # changes rather than inside the build hook.
144
+ - run: cargo --version
145
+ - run: uv build --wheel
146
+ - name: Verify the wheel bundles the stenodiar diarization helper
147
+ shell: bash
148
+ run: |
149
+ ls dist/*win_amd64.whl
150
+ unzip -o dist/*.whl 'stenograf/bin/stenodiar.exe' -d /tmp/whl
151
+ /tmp/whl/stenograf/bin/stenodiar.exe --help
152
+ - uses: actions/upload-artifact@v7
153
+ with:
154
+ name: dist-windows
155
+ path: dist/
156
+
157
+ smoke-macos:
158
+ # The acceptance the wheel exists for: a clean machine's `uv tool install`
159
+ # yields a green doctor and a working pipeline (capture itself needs TCC
160
+ # prompts no headless runner can answer; --replay drives the same pipeline
161
+ # from a file).
162
+ needs: build-macos
163
+ runs-on: macos-15
164
+ timeout-minutes: 45
165
+ steps:
166
+ - uses: astral-sh/setup-uv@v8.3.2
167
+ - uses: actions/download-artifact@v8
168
+ with:
169
+ name: dist-macos
170
+ path: dist
171
+ - run: echo "$HOME/.local/bin" >> "$GITHUB_PATH"
172
+ - run: brew install ffmpeg
173
+ - run: uv tool install -p 3.13 ./dist/stenograf-*.whl
174
+ - run: steno setup --models-only
175
+ - run: steno doctor
176
+ - name: Pipeline smoke on a synthetic WAV
177
+ run: |
178
+ python3 - <<'EOF'
179
+ import math, struct, wave
180
+ with wave.open("smoke.wav", "wb") as w:
181
+ w.setnchannels(1); w.setsampwidth(2); w.setframerate(16000)
182
+ w.writeframes(b"".join(
183
+ struct.pack("<h", int(8000 * math.sin(2 * math.pi * 440 * i / 16000)))
184
+ for i in range(16000 * 3)))
185
+ EOF
186
+ steno start --replay smoke.wav --local 1 --remote 0 --lang en --out smoke-out
187
+ test -f smoke-out/transcript.json
188
+
189
+ smoke-linux:
190
+ # Installs the manylinux wheel the way a user does — `uv tool install`,
191
+ # not a checkout — and makes the helper reach the network: the statically
192
+ # vendored OpenSSL has to find this machine's CA bundle before the model
193
+ # download can work at all, and nothing earlier in the pipeline proves it.
194
+ needs: build-linux-x86_64
195
+ runs-on: ubuntu-latest
196
+ timeout-minutes: 30
197
+ steps:
198
+ - uses: astral-sh/setup-uv@v8.3.2
199
+ - uses: actions/download-artifact@v8
200
+ with:
201
+ name: dist-linux-x86_64
202
+ path: dist
203
+ - run: echo "$HOME/.local/bin" >> "$GITHUB_PATH"
204
+ - run: uv tool install -p 3.13 ./dist/stenograf-*manylinux_2_39_x86_64.whl
205
+ - run: steno --version
206
+ # Linux capture/ASR land in Phase 5; today the smoke is: the wheel
207
+ # installs, the CLI runs, and the headless model download works.
208
+ - run: steno setup --models-only
209
+ - name: The installed helper is found and its TLS stack reaches HuggingFace
210
+ # --warmup downloads the diarization models and nothing else, so it is
211
+ # the cheapest end-to-end proof that the vendored OpenSSL build talks
212
+ # to the network on a foreign distro. doctor exits 1 on a runner (no
213
+ # audio endpoint); what is asserted here is the helper line.
214
+ run: |
215
+ steno doctor > doctor.txt 2>&1 || true
216
+ cat doctor.txt
217
+ grep -q "stenograf/bin/stenodiar" doctor.txt
218
+ unzip -o dist/*.whl 'stenograf/bin/stenodiar' -d /tmp/whl
219
+ /tmp/whl/stenograf/bin/stenodiar --warmup
220
+
221
+ smoke-windows:
222
+ # Nothing verified a clean Windows install before publish until 0.2.1
223
+ # shipped a launcher that died on every meeting start. The launcher/TUI
224
+ # itself is covered by the headless real-stack smoke in ci.yml's windows
225
+ # unit job; this leg is the *installed artifact* check: the wheel installs,
226
+ # carries its helper, renders through a redirected stdout, and runs the
227
+ # pipeline end to end from a file.
228
+ needs: build-windows
229
+ runs-on: windows-latest
230
+ timeout-minutes: 45
231
+ defaults:
232
+ run:
233
+ shell: bash # wheel globs + $HOME; the runner ships Git bash
234
+ steps:
235
+ - uses: astral-sh/setup-uv@v8.3.2
236
+ - uses: actions/download-artifact@v8
237
+ with:
238
+ name: dist-windows
239
+ path: dist
240
+ # uv installs tool executables to ~/.local/bin on Windows too.
241
+ - run: echo "$HOME/.local/bin" >> "$GITHUB_PATH"
242
+ - run: uv tool install -p 3.13 ./dist/stenograf-*win_amd64.whl
243
+ - run: steno --version
244
+ # ffmpeg is the bundled imageio-ffmpeg binary here — nothing to install.
245
+ - run: steno setup --models-only
246
+ - name: The report renders through a redirected stdout
247
+ # doctor *exits 1* on a runner by design: it has no audio endpoint, so
248
+ # the (non-optional) capture check fails. What this asserts is that the
249
+ # report renders at all — piped Windows stdout uses the legacy code page,
250
+ # and click.echo once crashed outright on the ✓/✗ glyphs (fixed by
251
+ # reconfiguring the streams with errors="replace"; this pins it down).
252
+ run: |
253
+ steno doctor > doctor.txt 2>&1 || true
254
+ cat doctor.txt
255
+ grep -q "ASR backend" doctor.txt
256
+ grep -q "ffmpeg" doctor.txt
257
+ # The installed wheel's own helper, not a stray build in the checkout.
258
+ grep -qi "stenodiar.exe" doctor.txt
259
+ - name: Pipeline smoke on a synthetic WAV
260
+ # Live WASAPI capture needs hardware no runner has; --replay drives the
261
+ # same pipeline from a file.
262
+ run: |
263
+ uv run --no-project --python 3.13 python - <<'EOF'
264
+ import math, struct, wave
265
+ with wave.open("smoke.wav", "wb") as w:
266
+ w.setnchannels(1); w.setsampwidth(2); w.setframerate(16000)
267
+ w.writeframes(b"".join(
268
+ struct.pack("<h", int(8000 * math.sin(2 * math.pi * 440 * i / 16000)))
269
+ for i in range(16000 * 3)))
270
+ EOF
271
+ steno start --replay smoke.wav --local 1 --remote 0 --lang en --out smoke-out
272
+ test -f smoke-out/transcript.json
273
+
274
+ publish:
275
+ # build-pure is listed explicitly: no smoke leg installs the pure wheel any
276
+ # more (each platform now smokes its own), but PyPI still needs it and the
277
+ # sdist, and download-artifact below collects whatever has finished.
278
+ needs: [build-pure, smoke-macos, smoke-linux, smoke-windows]
279
+ if: github.ref_type == 'tag'
280
+ runs-on: ubuntu-latest
281
+ timeout-minutes: 15
282
+ environment: pypi
283
+ permissions:
284
+ id-token: write # PyPI Trusted Publishing (OIDC)
285
+ contents: write # GitHub release
286
+ steps:
287
+ - uses: actions/checkout@v7
288
+ - uses: actions/download-artifact@v8
289
+ with:
290
+ path: dist
291
+ merge-multiple: true
292
+ - name: Verify the tag matches the project version
293
+ run: |
294
+ version=$(python3 -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')
295
+ test "${GITHUB_REF_NAME}" = "v${version}" || {
296
+ echo "tag ${GITHUB_REF_NAME} != project version v${version}" >&2
297
+ exit 1
298
+ }
299
+ - uses: pypa/gh-action-pypi-publish@release/v1
300
+ - name: Attach artifacts to the GitHub release
301
+ env:
302
+ GH_TOKEN: ${{ github.token }}
303
+ run: gh release create "$GITHUB_REF_NAME" dist/* --title "$GITHUB_REF_NAME" --generate-notes
@@ -0,0 +1,83 @@
1
+ # stenograf — instructions for Claude Code
2
+
3
+ Meeting transcription pipeline: capture → live captions (TUI) → finalize
4
+ (diarized transcript) → notes. Shipped on PyPI as `stenograf`.
5
+
6
+ **Three front-ends, one library.** The CLI (`cli/`), the Textual launcher
7
+ (`ui/`) and the Qt desktop app (`gui/`, `steno --gui`) are all thin: they gather
8
+ inputs and call library entry points. The workflows they share live in
9
+ `flow.py` (meeting request → run, transcribe, notes, settings report) and
10
+ `captions.py` (live-caption line rules). Logic a screen needs that the library
11
+ lacks goes into the library — never into one front-end, or the two UIs drift.
12
+
13
+ `PLAN.md` holds **only unbuilt work** — the active plan is Phase 8's remainder
14
+ (the app is built, opt-in, installed as `~/Applications/Stenograf.app` by
15
+ `steno setup`, and lives in the menu bar; **only step 7 — the default flip — is
16
+ left, and it is gated on real use, not on code**. Step 5's bundle is FROZEN:
17
+ its bytes are every user's microphone grant, so read
18
+ `native/appbundle/README.md` before touching anything under it or under
19
+ `src/stenograf/assets/` — new sibling files there are fine, the `.app` tree is
20
+ not. Step 1's per-process profile is done and its watt half is deferred to a
21
+ quiet machine), plus the open platform items and the declined list. Everything
22
+ shipped, including the architecture and model-choice research, the AEC design
23
+ and the code-cleanup backlog, was pruned on 2026-07-25 and lives in git
24
+ history (`git log --follow -p PLAN.md`, and the deleted `PLAN-AEC.md` /
25
+ `PLAN-CLEANUP.md`). **`PLAN-LINUX.md` is the one live side-plan**: the desktop
26
+ app measured on a real KDE/Wayland session on 2026-07-25, and the six problems
27
+ that found fixed the same day — it now holds no open work, only what was
28
+ measured (do not re-verify it), the decisions, the desktops it has never run on
29
+ plus the container ladder for reaching them (never a VM), and the recipe for
30
+ observing a running GUI on that machine. Measured evidence for the shipped defaults is in
31
+ `eval/README.md`; design rationale lives in the code's own docstrings. Use the
32
+ `verify` skill to run/observe the tool without live capture hardware.
33
+
34
+ ## Product philosophy (LOCKED — don't re-litigate)
35
+
36
+ The tool ends at **transcript + notes in a visible folder**
37
+ (`~/Documents/Meetings`). No meeting management, browsing, playback, index,
38
+ or web UI — ever. Obsidian/Finder/audio players do that; the filesystem is
39
+ the index.
40
+
41
+ ## Workflow conventions
42
+
43
+ - Commit straight to `main` for planned work; branch only for large
44
+ unplanned multi-commit refactors.
45
+ - Before committing, the CI triple must pass locally: `uv run ruff check .`,
46
+ `uv run --with pyright pyright` (macOS only — the mlx deps install there
47
+ only, so it is the only place types resolve as CI sees them), and
48
+ `uv run pytest -q`. `scripts/hooks/pre-commit` runs all three; enable it
49
+ per clone with `git config core.hooksPath scripts/hooks`.
50
+ - Never mention Claude or AI assistance in commit messages or PR bodies —
51
+ no `Co-Authored-By: Claude`, no "Generated with" trailers.
52
+ - Delegate token-heavy research fan-outs to cheaper Opus subagents rather
53
+ than running them in the main loop.
54
+ - Release = version bump + tag (CI publishes to PyPI).
55
+
56
+ ## Current focus: Phase 5 — Linux (ACTIVE since 2026-07-10)
57
+
58
+ Two machines, sequenced: ONNX ASR backend on the Mac first (only place the MLX↔ONNX parity
59
+ harness runs), then capture work moves to the CachyOS notebook (x86_64,
60
+ real PipeWire); GitHub Actions Ubuntu is the stable-distro CI reference.
61
+
62
+ ## Platform decisions
63
+
64
+ - **Notes backends per platform** (researched 2026-07-10): macOS = mlx-lm,
65
+ pinned to the 0.29 line (0.30+ requires transformers>=5 which is
66
+ import-broken, and Voxtral needs 4.x); generation must stay bound to the
67
+ thread that imported `mlx_lm` (guarded in code). **Linux CPU fallback =
68
+ llama-cpp-python — its wheels are OFF-PyPI** (extra index URL required);
69
+ Ollama stays the default when a GPU box is available. **Windows (decided
70
+ 2026-07-12): Ollama-default, no in-process backend unless Ollama proves
71
+ insufficient — then llama-cpp-python CPU GGUF (Phi-4-mini), same off-PyPI
72
+ wheel friction as Linux.** onnxruntime-genai-directml was rejected
73
+ (DX12-GPU-only on the EOL DirectML EP; coexistence with our
74
+ onnxruntime-directml would actually have been fine — it depends on the
75
+ same flavor).
76
+ - **MLX on background threads**: materialize weights on the load thread or
77
+ inference dies with "no Stream(gpu, 0)"; verify MLX-threading changes
78
+ against the real backend, not mocks.
79
+ - **Diarization licensing**: DiariZen is CC-BY-NC — unshippable here.
80
+ speakrs (cross-platform: CoreML on mac, ORT elsewhere) is the chosen
81
+ auto-count estimator, still immature at v0.5.0 — **vendored with two
82
+ CPU-throughput patches** in `native/stenodiar/vendor/` (see VENDOR.md;
83
+ upstream candidates, re-check on every speakrs release).
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: stenograf
3
- Version: 0.2.2
3
+ Version: 0.4.0
4
4
  Summary: Accuracy-first local meeting transcription for German and English. Audio stays in RAM; only text is written.
5
5
  Project-URL: Repository, https://github.com/daniel-om-weber/stenograf
6
6
  Project-URL: Issues, https://github.com/daniel-om-weber/stenograf/issues
@@ -26,11 +26,14 @@ Requires-Dist: onnx-asr[hub]>=0.11
26
26
  Requires-Dist: onnxruntime-directml>=1.24; sys_platform == 'win32'
27
27
  Requires-Dist: onnxruntime>=1.18.1; sys_platform != 'win32'
28
28
  Requires-Dist: parakeet-mlx>=0.5.2; sys_platform == 'darwin' and platform_machine == 'arm64'
29
+ Requires-Dist: sentencepiece>=0.2
29
30
  Requires-Dist: sherpa-onnx-core<1.13,>=1.12.40
30
31
  Requires-Dist: sherpa-onnx<1.13,>=1.12.40
31
32
  Requires-Dist: soundcard>=0.4.4; sys_platform == 'win32'
32
33
  Requires-Dist: textual>=8.2.8
33
34
  Requires-Dist: transformers<5,>=4.55.2; sys_platform == 'darwin' and platform_machine == 'arm64'
35
+ Provides-Extra: gui
36
+ Requires-Dist: pyside6-essentials>=6.8; extra == 'gui'
34
37
  Provides-Extra: ollama
35
38
  Description-Content-Type: text/markdown
36
39
 
@@ -47,7 +50,7 @@ in from the start.
47
50
  > **Status: early release.** On macOS and Linux the pipeline is complete end
48
51
  > to end: live system-audio + microphone capture, live captions, and the
49
52
  > high-accuracy speaker-labelled finalize pass, plus meeting notes. Windows
50
- > support is in progress. See [PLAN.md](PLAN.md).
53
+ > support is in progress.
51
54
 
52
55
  ## Why another transcription tool?
53
56
 
@@ -146,6 +149,46 @@ launcher opens:
146
149
  Everything the launcher does is also a plain CLI command — the rest of this
147
150
  document — so terminal users and scripts lose nothing.
148
151
 
152
+ ### The desktop app (preview)
153
+
154
+ The same five workflows also exist as a real native window, built on Qt Quick.
155
+ It is opt-in while it settles; the terminal launcher above stays the default.
156
+
157
+ ```sh
158
+ uv tool install --force 'stenograf[gui]' # adds Qt (~110 MB); one time
159
+ steno setup # points the desktop launcher at the app
160
+ steno --gui # …or just open the app
161
+ ```
162
+
163
+ The launcher follows the extra on every platform: once Qt is installed,
164
+ `steno setup` rewrites the shortcut it already made so that double-clicking it
165
+ opens the app instead of a terminal window — on Linux the application-menu
166
+ entry, on Windows the Desktop `Stenograf.cmd`. Uninstall the extra, re-run
167
+ setup, and they turn back into the terminal launcher.
168
+
169
+ On macOS it goes further and replaces the Desktop shortcut with a real
170
+ **Stenograf.app** — its own icon, Dock tile and Spotlight entry. It asks for
171
+ microphone access once, under its own name rather than your terminal's, and
172
+ keeps that permission across every later upgrade.
173
+
174
+ The app also lives in the **menu bar** (system tray on Windows and Linux),
175
+ which is where it belongs for most of a meeting: the icon turns red while
176
+ you are recording, and its menu can start, stop and finish a meeting without
177
+ a window. Closing the window puts the app there rather than quitting it — a
178
+ meeting in progress keeps running — and re-opening the app brings the window
179
+ back. Start that way with:
180
+
181
+ ```sh
182
+ steno --gui --tray # menu bar only, no window
183
+ ```
184
+
185
+ Desktops with no tray host (stock GNOME, unless the AppIndicator extension is
186
+ installed) simply get a window, as before.
187
+
188
+ It runs the same library the CLI does — same meeting folders, same
189
+ settings.toml, same transcripts — so you can switch between the two freely, or
190
+ never use it at all.
191
+
149
192
  ## Usage
150
193
 
151
194
  ```sh
@@ -195,7 +238,9 @@ downmixes to mono. Force either way with `--channels split|mix`.
195
238
 
196
239
  ## Where your files land
197
240
 
198
- Every run writes its own date-named folder into `~/Documents/Meetings`:
241
+ Every run writes its own date-named folder into `Meetings` inside your
242
+ documents folder — `~/Documents/Meetings`, or your desktop's localised name for
243
+ it on Linux (`~/Dokumente/Meetings` on a German one):
199
244
 
200
245
  ```
201
246
  ~/Documents/Meetings/meeting-20260710-091500/
@@ -206,7 +251,8 @@ Every run writes its own date-named folder into `~/Documents/Meetings`:
206
251
 
207
252
  That's it — there is no separate library or index to manage. Browse with
208
253
  Finder or `ls`, read with anything that opens markdown, delete with `rm`.
209
- Change the standing location with `[output] dir` in settings.toml, or give one
254
+ `steno settings show` prints the folder it resolved. Change the standing
255
+ location with `[output] dir` in settings.toml, or give one
210
256
  run its own folder with `--out DIR` (files land directly in it; if DIR already
211
257
  holds a transcript, stenograf refuses to replace it unless you add `--force`).
212
258
  Audio is stored only when you passed `--record-audio`; without it a meeting
@@ -287,16 +333,40 @@ dir (not the model cache) and are never uploaded.
287
333
 
288
334
  ## Vocabulary
289
335
 
290
- Domain terms and attendee names are corrected in the finalized transcript
291
- (the ASR has no decode-time biasing, so this is a post-correction pass):
336
+ Domain terms and attendee names steer the transcript twice: they boost the
337
+ decoder toward those spellings *while* it transcribes, and then correct the
338
+ near-misses it still got wrong in the finalized text.
292
339
 
293
340
  ```sh
294
341
  steno transcribe rec.mov --attendee "Anja Müller" --glossary Kubernetes,gRPC
295
342
  steno transcribe rec.mov --glossary-file terms.txt
296
343
  ```
297
344
 
298
- A term and its transcription must share a word count — `gRPC` can fix `G R P C`
299
- spoken as one word, but not a term split across word boundaries.
345
+ Write a term the way it appears in a sentence. A capitalized term (`Kubernetes`,
346
+ `iOS`) is imposed verbatim; an all-lowercase one asserts the spelling but leaves
347
+ the model's capitalization alone. In the correction pass a term and its
348
+ transcription must share a word count — `gRPC` can fix `G R P C` spoken as one
349
+ word, but not a term split across word boundaries.
350
+
351
+ **An acronym you pronounce as a word needs both spellings.** Biasing rewards the
352
+ exact token path you write, so `NIRS` only ever rewards `N-I-R-S` — a spelling
353
+ the acoustics never take when you say "nirs". List `NIRS` *and* `Nirs`: the
354
+ decoder can reach the second, and the correction pass snaps it back to the first,
355
+ since the two normalize to the same word. Only case variants of the same letters
356
+ work — a respelling (`Ekmo` for `ECMO`) is reachable but never snaps back.
357
+
358
+ Both layers are on whenever there are terms. `[asr] boost` scales the decoder
359
+ biasing (default 1.0; `0` turns it off, and much above ~3 it starts rewriting
360
+ words that were never in your list), and `[vocab] glossary_threshold` is the
361
+ similarity a word must reach before the correction pass touches it (default
362
+ 0.95 — deliberately strict, because a loose threshold corrupts words the model
363
+ already had right).
364
+
365
+ Reach for the spellings before the knobs. On an 85-minute German meeting, adding
366
+ the pronounceable twins fixed three more terms for four extra changed words in
367
+ the rest of the transcript, where raising `boost` to 1.5 bought two and disturbed
368
+ forty-six — at 2.0 the correct compound "Medizintechnikgruppe" decayed into
369
+ "Medizinischechnikgruppe", pulled apart by a listed term it half-matched.
300
370
 
301
371
  ## Settings
302
372
 
@@ -321,10 +391,11 @@ formats = ["md", "json", "txt"] # default --format list (srt/vtt for subtitles
321
391
  [vocab] # standing vocabulary — MERGED with per-run
322
392
  glossary_file = "~/steno/glossary.txt" # --glossary/--attendee flags
323
393
  attendees = ["Anja Müller"]
324
- glossary_threshold = 0.82
394
+ glossary_threshold = 0.95
325
395
 
326
396
  [output]
327
- dir = "~/Documents/Meetings" # where meeting folders are created
397
+ dir = "~/Documents/Meetings" # where meeting folders are created (default:
398
+ # Meetings/ in your documents folder)
328
399
 
329
400
  [speakers]
330
401
  diarization = true # separate speakers within a channel (off by
@@ -356,10 +427,16 @@ uv run steno doctor
356
427
  ```
357
428
 
358
429
  The test suite is label-free and runs without a meeting: model-gated and
359
- real-audio tests self-skip when their assets are absent.
430
+ real-audio tests self-skip when their assets are absent. The desktop app's
431
+ tests run headless (`QT_QPA_PLATFORM=offscreen`, no window is ever shown) and
432
+ skip entirely where PySide6 is not installed.
433
+
434
+ Three front-ends share one library: the CLI (`stenograf/cli/`), the terminal
435
+ launcher (`stenograf/ui/`) and the desktop app (`stenograf/gui/`). None of them
436
+ holds pipeline logic — the workflows they drive live in `stenograf/flow.py`, so
437
+ a behaviour change lands in all three at once.
360
438
 
361
- See [PLAN.md](PLAN.md) for the full architecture, model choices, and roadmap;
362
- [PLAN-AEC.md](PLAN-AEC.md) for the echo-cancellation design and its measurements;
439
+ See [PLAN.md](PLAN.md) for the remaining roadmap;
363
440
  `native/README.md` for the capture helper and its wire protocol; `eval/README.md`
364
441
  for the model-evaluation and AEC-scoring harnesses.
365
442