@madeinoz67/voice-server 0.1.10 → 0.1.12

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.
package/CHANGELOG.md CHANGED
@@ -5,117 +5,104 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
5
5
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
  ## [Unreleased]
7
7
 
8
- ### Documentation
9
-
10
- - Update CHANGELOG.md for v0.1.7 [skip ci] ([f3e287c](f3e287c418545806619a39ac49404844681b8b7e))
11
-
12
- - Update CHANGELOG.md [skip ci] ([e3d8e74](e3d8e74620518f9f5eaeea7cd5d793d05740cf51))
13
-
14
- - Update CHANGELOG.md for v0.1.8 [skip ci] ([b22b945](b22b9454b1f3015937916ccbfa06c4f4009193f1))
8
+ ### Bug Fixes
15
9
 
16
- - Fix repository URL in mkdocs.yml ([60a5fee](60a5feecbcbf8bbe3b91443a3ce86ce9bc796fc3))
10
+ - Allow empty/missing voice_id in notifications ([2479428](247942826cc9262dc1402b8e299c02bb5275c94b))
17
11
 
18
- - Update CHANGELOG.md [skip ci] ([7f6e640](7f6e6409937dc5cddebcb4d34f1226a13d80e963))
19
12
 
20
- - Update CHANGELOG.md [skip ci] ([37698ca](37698ca1e4884990731657c54d6b99e8d72291dd))
13
+ ### Documentation
21
14
 
22
- - Update CHANGELOG.md for v0.1.9 [skip ci] ([046a02e](046a02e74637afdf771d7e7cc2f954efe588aed8))
15
+ - Add queue diagrams and agent reports ([d4be95d](d4be95df90e396d2bf182e1b900da289049da1eb))
23
16
 
24
- - FIFO queue documentation with visual diagrams ([53f4dd8](53f4dd8118c55f10dcbe55d42b054cd803731d4f))
17
+ - Ban `codanna index .` in agent guidance ([2650a51](2650a51c8c0799deb48b83fa47e54ad6fb76cf12))
25
18
 
26
19
 
27
20
  ### Miscellaneous Tasks
28
21
 
29
- - Remove recursive changelog entries from CHANGELOG.md ([f3d836f](f3d836f11b0b72fcb4e059f802b769fc70f6f53b))
22
+ - Bump eslint from 10.0.0 to 10.0.1 ([ff97687](ff97687b3acb15158be44dd21e449a36b18515c4))
30
23
 
31
- - Skip version bump commits in changelog ([6fc8a2d](6fc8a2dc9913ee5fdb1394d15432fd326b61a1e3))
24
+ - Bump @types/node from 25.2.3 to 25.3.0 ([b930f7b](b930f7bc5a788295b73c09430e291d3ffc218a94))
32
25
 
26
+ - Bump @typescript-eslint/parser from 8.56.0 to 8.56.1 ([f8f2c69](f8f2c6904395f213990a61f5bbc9a074d3171531))
33
27
 
28
+ - Add GitHub MCP permissions to local settings ([1641ec3](1641ec3581e763149da2035b3ca91c5f599dcba6))
34
29
 
35
- [Unreleased]: https://github.com/madeinoz67/madeinoz-voice-server/compare/trunk...HEAD
36
- ## [0.1.7] - 2026-02-09
30
+ - Prune dead python paths, drop stale pyproject ref, rebuild index for 0.17.1 ([9e1497f](9e1497f8804ed33d36449051994b3fef8ca0eb71))
37
31
 
38
- ### Documentation
32
+ - Install hooks, agents, MCP binding, orca setup, worktree-safe config ([d6d3cf8](d6d3cf8114dd0c34dd44d01d0bc48226cb8bde63))
39
33
 
40
- - Update CHANGELOG.md for v0.1.4 [skip ci] ([fe76674](fe76674036f7e7b1decf152ef6ca294ab93da10a))
34
+ - Bump flatted ([9ea0207](9ea0207f25c59d8561381a7d59f689a77cd873b1))
41
35
 
42
- - Update CHANGELOG.md [skip ci] ([552c173](552c173acbd7ca4902fc0921a3cf7f4a468cdbff))
36
+ - Bump @types/node from 25.3.0 to 25.6.0 ([b9a5f72](b9a5f72ffada0f0a00760292d721596f97640900))
43
37
 
44
- - Update CHANGELOG.md [skip ci] ([b6be863](b6be863a69534d7aa3512cad62d9dad86f195116))
38
+ - Bump eslint from 10.0.1 to 10.2.0 ([a18acb9](a18acb9b2ce93acdd88ebbe0d00d62f931bb6c06))
45
39
 
46
- - Update CHANGELOG.md for v0.1.5 [skip ci] ([f872586](f8725862357f7720e6055026955f699b7538916c))
40
+ - Bump @typescript-eslint/eslint-plugin ([e46bc7d](e46bc7db99c423a1a416d8799cea3e55beb62ea6))
47
41
 
48
- - Update CHANGELOG.md [skip ci] ([c3b7430](c3b74305c6238f94089a4552a4b151e566c84f75))
42
+ - Bump typescript-eslint from 8.56.0 to 8.58.1 ([ec2887e](ec2887e2f1bb10c90536b9713ce8c49d457bd435))
49
43
 
50
- - Update CHANGELOG.md for v0.1.6 [skip ci] ([31657f8](31657f8de48c41e721c8400f9d0e22da155aea27))
44
+ - Bump bun-types from 1.3.9 to 1.3.12 ([75cdd0b](75cdd0b53b84bbade97b347596eea66f4a32a4ff))
51
45
 
46
+ - Bump the npm_and_yarn group across 1 directory with 3 updates ([494a67b](494a67b3028d4b3d6312d94375955a1a6a36137d))
52
47
 
53
- ### Ci
48
+ - Sync ProjectSetup update (grep nudge, safe index, doc collections) ([7522f4d](7522f4da18195aa0d0c2ee4b9e54e637a6599a06))
54
49
 
55
- - Use npm OIDC for publish instead of token ([5476714](54767141475c4783d9c4ea1c54e29ba6b6a79ed9))
56
-
57
- - Upgrade npm for OIDC support ([5d6aade](5d6aade1727b1e731031ec728537abc629aaa84f))
58
50
 
59
51
 
52
+ [Unreleased]: https://github.com/madeinoz67/madeinoz-voice-server/compare/trunk...HEAD
53
+ ## [0.1.11] - 2026-02-17
60
54
 
61
- [0.1.4]: https://github.com/madeinoz67/madeinoz-voice-server/compare/v0.1.4...v0.1.7
62
- ## [0.1.4] - 2026-02-09
55
+ ### Documentation
63
56
 
64
- ### Bug Fixes
57
+ - FIFO queue documentation with visual diagrams ([53f4dd8](53f4dd8118c55f10dcbe55d42b054cd803731d4f))
65
58
 
66
- - Use correct CodeQL config format to exclude tests ([e66b020](e66b02060506b0a4c181211576c54f02e517d989))
67
59
 
68
- - Exclude tests from CodeQL and skip CI on changelog changes ([7ba9d9c](7ba9d9c62721d291f4fcc584b3eccdb799904055))
60
+ ### Features
69
61
 
70
- - Avoid template literal property keys for CodeQL compatibility ([66b1738](66b1738a5fb18061ad77a43ede1acc9f67e70707))
62
+ - Add Homebrew launchd plist for voice-server service ([8320799](83207990c29d3080d6d8f85e9fe2f61de7605e06))
71
63
 
72
64
 
73
- ### Documentation
65
+ ### Miscellaneous Tasks
74
66
 
75
- - Update CHANGELOG.md for v0.1.0 [skip ci] ([1d91e3d](1d91e3d5e18e65b30080c74dae7ecf70a506f021))
67
+ - Bump @types/node from 25.2.2 to 25.2.3 ([7d07d72](7d07d725d251b8bcdc54accdddab91a776ff4713))
76
68
 
77
- - Update CHANGELOG.md [skip ci] ([4e77dae](4e77dae378f41f4df76a60cdffacb56e1920f31c))
69
+ - Bump @typescript-eslint/eslint-plugin ([d8bf7ef](d8bf7ef16649ec199402eef0d044e2bb3744c78b))
78
70
 
79
- - Add visual assets and architecture diagram ([afeb22c](afeb22c9461924e8767a57a24b0dbfb83ed5ce56))
71
+ - Bump typescript-eslint from 8.54.0 to 8.55.0 ([c28e5ea](c28e5ea3ebdf28d046bcc72e41dec653954ada3c))
80
72
 
81
- - Update CHANGELOG.md [skip ci] ([7dc28a7](7dc28a7bb9ae20986fa134721b4526b30ab3cfe9))
73
+ - Bump @typescript-eslint/parser from 8.54.0 to 8.55.0 ([872c91e](872c91eb0c426c70777edd6a98d806e0cbf2d9af))
82
74
 
83
- - Update CHANGELOG.md [skip ci] ([ef68568](ef685683a582bdf59e9b52f152bd3c103942fa4f))
84
75
 
85
- - Update CHANGELOG.md [skip ci] ([1c1a663](1c1a6634ecfd932cc642601ebbb38f9d03e2cfc3))
86
76
 
87
- - Update CHANGELOG.md [skip ci] ([40eee80](40eee80333ba6dddc3ed6e80e23f2853a9a2f31f))
77
+ [0.1.7]: https://github.com/madeinoz67/madeinoz-voice-server/compare/v0.1.7...v0.1.11
78
+ ## [0.1.7] - 2026-02-09
88
79
 
89
- - Update CHANGELOG.md [skip ci] ([0788bb3](0788bb3923be7230d8bd5695f6dec3f5634cb656))
80
+ ### Ci
90
81
 
91
- - Update CHANGELOG.md [skip ci] ([262b9f7](262b9f7c66830ecd11ecad93fc19d0da86212387))
82
+ - Use npm OIDC for publish instead of token ([5476714](54767141475c4783d9c4ea1c54e29ba6b6a79ed9))
92
83
 
93
- - Update CHANGELOG.md [skip ci] ([d9bb5e6](d9bb5e6bef8060c8e34c6201540e04a32beef6a3))
84
+ - Upgrade npm for OIDC support ([5d6aade](5d6aade1727b1e731031ec728537abc629aaa84f))
94
85
 
95
- - Update CHANGELOG.md [skip ci] ([dcec442](dcec44218dec3bd74912add4a354f7cc7e43534a))
96
86
 
97
- - Update CHANGELOG.md [skip ci] ([92ac66c](92ac66c15f86cb020ff005b1ad3d29cd87fcf83a))
98
87
 
99
- - Update CHANGELOG.md [skip ci] ([8203d0f](8203d0f85b0979bda76719b6d4545f84b5b0705c))
88
+ [0.1.4]: https://github.com/madeinoz67/madeinoz-voice-server/compare/v0.1.4...v0.1.7
89
+ ## [0.1.4] - 2026-02-09
100
90
 
101
- - Update CHANGELOG.md [skip ci] ([f292411](f292411624150bf259ade7fe74e8235e0e0fcb24))
91
+ ### Bug Fixes
102
92
 
103
- - Update CHANGELOG.md [skip ci] ([e6a7556](e6a75562c61fcd21eaeef5e1a46071b0b386c2cd))
93
+ - Use correct CodeQL config format to exclude tests ([e66b020](e66b02060506b0a4c181211576c54f02e517d989))
104
94
 
105
- - Rename project to voice-server ([c7e9209](c7e9209b2eeee1ac2af152f55b01045043cab2b9))
95
+ - Exclude tests from CodeQL and skip CI on changelog changes ([7ba9d9c](7ba9d9c62721d291f4fcc584b3eccdb799904055))
106
96
 
107
- - Update CHANGELOG.md [skip ci] ([485f47e](485f47e3001035af7f8a3c39c1a271373d93b675))
97
+ - Avoid template literal property keys for CodeQL compatibility ([66b1738](66b1738a5fb18061ad77a43ede1acc9f67e70707))
108
98
 
109
- - Update CHANGELOG.md for v0.1.1 [skip ci] ([6828e7d](6828e7dde9203622acd031cb7c70f2f1220c105e))
110
99
 
111
- - Update CHANGELOG.md for v0.1.2 [skip ci] ([9dd2c2f](9dd2c2fe6a9b74117fbb2185e98704f506433ae4))
100
+ ### Documentation
112
101
 
113
- - Update CHANGELOG.md for v0.1.3 [skip ci] ([6894e0d](6894e0d647bfbcc92a4ed631626186421038a35a))
102
+ - Rename project to voice-server ([c7e9209](c7e9209b2eeee1ac2af152f55b01045043cab2b9))
114
103
 
115
104
  - Update npm package name and CI changelog ignore ([3cee42e](3cee42e74e4c5ef9fe9c456c5941036c5a210403))
116
105
 
117
- - Update CHANGELOG.md [skip ci] ([369d7c4](369d7c417032169bc77ab3bf30956c961059b72f))
118
-
119
106
 
120
107
  ### Features
121
108
 
@@ -146,15 +133,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
146
133
  - Add NPM_TOKEN to npm publish job ([a4f219b](a4f219b6449e8853783814fa0f02089ecb9d012a))
147
134
 
148
135
 
149
- ### Documentation
150
-
151
- - Update CHANGELOG.md [skip ci] ([8b6de06](8b6de06bf64564a68dab8dd0297d0c755f885de5))
152
-
153
- - Update CHANGELOG.md [skip ci] ([b0b380e](b0b380e0be8b43e9e00873ebe642e0bd9c6b31b9))
154
-
155
- - Update CHANGELOG.md for v0.1.0 [skip ci] ([3d47e3d](3d47e3d6d3693fcf01712928e431c03e46d8809a))
156
-
157
-
158
136
  ### Features
159
137
 
160
138
  - MLX-audio Kokoro Voice Server - Drop-in ElevenLabs Replacement ([f5bff4e](f5bff4e3123a31d0bb4d6aa2a3c86aed3000ecb9))
package/CLAUDE.md CHANGED
@@ -42,10 +42,60 @@ bun run typecheck # Type check only
42
42
 
43
43
  ## Notes
44
44
 
45
- - Codanna indexing is enabled for `src/` directory
45
+ - Codanna indexing is enabled for `src/ts` and `tests/ts` directories
46
46
  - Semantic search is available for code queries
47
47
  - Documentation is built with MkDocs Material theme
48
48
 
49
+ ## Code navigation: Codanna
50
+
51
+ This repo is indexed by Codanna (local symbol graph + semantic search).
52
+
53
+ If the location of a symbol or the shape of a module is not already known, find it with
54
+ Codanna before reading files or grepping. A file already named in the issue or the error
55
+ is not a search: read it. A hook nudges once per session when a search starts with `rg` or `grep`
56
+ before Codanna has been used, so the rule is not something to remember.
57
+
58
+ ### Which interface
59
+ - **Main session:** use the `mcp__codanna__*` tools. The server runs `serve --watch` from the main checkout and stays current as files change.
60
+ - **Subagents:** use the `codanna` CLI through Bash (the `x-ray` skill wraps it). The CLI reads the index in its current directory, so it stays correct inside worktrees.
61
+ - **Whole-codebase shape** (module map, hubs, which modules talk to each other, history): use the `graph` skill.
62
+
63
+ ### Workflow
64
+ 1. **Rephrase first.** Search for what is meant, not the literal words (e.g. "the login stuff" → "authentication session token validation").
65
+ 2. **Locate:** semantic search with context, limit 5. Focus on results with score > 0.6. Use `find_symbol` for exact names and `search_symbols` for partial ones.
66
+ 3. **Read narrowly:** read only the returned line range (`sed -n 'A,Bp' file` or Read with offset/limit).
67
+ 4. **Expand:** follow 1–2 important relationships per result (`retrieve describe`, callers, calls). Run `analyze_impact` **before** changing any public symbol, signature, or shared function.
68
+ 5. **Docs:** `search_documents` for project docs and markdown.
69
+ 6. **Refine or fall back:** if the scores are weak, rephrase once. Use `rg` for exact strings, config keys, HTML/CSS/templates, and any language Codanna doesn't parse.
70
+
71
+ CLI equivalents:
72
+ - `codanna mcp semantic_search_with_context query:"..." limit:5 --json`
73
+ - `codanna mcp find_symbol <Name> --json`
74
+ - `codanna mcp find_callers <Name> --json`
75
+ - `codanna mcp analyze_impact <Name> --json`
76
+ - `codanna retrieve describe <Name|symbol_id:N>`
77
+ - `codanna retrieve calls <Name>`
78
+
79
+ Add `lang:<language>` to a search to narrow it by language.
80
+
81
+ ### Rules
82
+ - Codanna results are navigation hints, not ground truth. Confirm against the file before editing.
83
+ - Before renaming or changing a signature, list every caller in your plan.
84
+ - If a Codanna command exits with code 7 (stale index), run `codanna index` in the current checkout and retry.
85
+ - Never pass `.` to `codanna index`. It registers the cwd as a root and rewrites `.codanna/settings.toml` with an absolute path, double-indexing the tree (32 files/413 symbols vs 18/322 here). Bare `codanna index` or `codanna index -f` rebuild the configured roots only.
86
+ - Prefer `symbol_id:N` over names when available; it avoids ambiguity.
87
+
88
+ ### Orca worktrees
89
+ - In Orca, each agent is a full Claude Code session whose working directory is its own worktree. Orca's `scripts.setup` builds that worktree's Codanna index, and the `.mcp.json` server indexes the worktree, so `mcp__codanna__*` tools are correct there.
90
+ - If a Codanna tool reports a missing or stale index (exit code 7) right after the worktree opens, setup may still be running: wait, or run `codanna index` once.
91
+ - Never share `.codanna/` between worktrees (symlink or `sharedDirectories`).
92
+
93
+ ### Subagents and worktrees
94
+ - A subagent in `.claude/worktrees/*` must **not** use `mcp__codanna__*`. Those tools read the main checkout's index, which doesn't match the worktree's files.
95
+ - Worktree subagents build their own index first (`codanna index` from the worktree root), then use the CLI.
96
+ - Never point the CLI at the main checkout from inside a worktree (`--config ../..`, `cd` to the repo root). Worktree isolation blocks it anyway.
97
+ - Delegate read-only investigation to `codanna-explorer` and isolated edits to `codanna-implementer`.
98
+
49
99
  ## Recent Changes
50
100
  - 001-fifo-notify-queue: Added TypeScript 5.x (Bun runtime) + Bun native APIs, MLX-audio CLI (existing)
51
101
  - 001-qwen-tts: Added [if applicable, e.g., PostgreSQL, CoreData, files or N/A]
@@ -3,7 +3,7 @@
3
3
  class VoiceServer < Formula
4
4
  desc "Local-first TTS voice server using MLX-audio with Kokoro-82M model"
5
5
  homepage "https://github.com/madeinoz67/voice-server"
6
- version "0.1.8"
6
+ version "0.1.12"
7
7
  license "MIT"
8
8
 
9
9
  depends_on "bun"
package/cliff.toml CHANGED
@@ -41,6 +41,16 @@ commit_preprocessors = [
41
41
  { pattern = '#([0-9]+)', replace = "https://github.com/madeinoz67/madeinoz-voice-server/issues/$1" },
42
42
  ]
43
43
  commit_parsers = [
44
+ # Skip patterns FIRST (before grouping)
45
+ { message = "^chore\\(release\\): prepare for", skip = true },
46
+ { message = "^chore.*[Bb]ump version", skip = true },
47
+ { message = "[Uu]pdate CHANGELOG", skip = true },
48
+ { message = "[Uu]pdated CHANGELOG", skip = true },
49
+ { message = "CHANGELOG.*\\[skip ci\\]", skip = true },
50
+ { message = "\\[skip ci\\].*CHANGELOG", skip = true },
51
+ { message = "^docs.*CHANGELOG", skip = true },
52
+ { message = "^chore.*[Cc]hangelog", skip = true },
53
+ # Grouping patterns (after skip patterns)
44
54
  { message = "^feat", group = "Features" },
45
55
  { message = "^fix", group = "Bug Fixes" },
46
56
  { message = "^docs", group = "Documentation" },
@@ -48,11 +58,6 @@ commit_parsers = [
48
58
  { message = "^refactor", group = "Refactor" },
49
59
  { message = "^style", group = "Styling" },
50
60
  { message = "^test", group = "Testing" },
51
- { message = "^chore\\(release\\): prepare for", skip = true },
52
- { message = "^chore.*[Bb]ump version", skip = true },
53
- { message = "^[Uu]pdate CHANGELOG", skip = true },
54
- { message = "^[Uu]pdated CHANGELOG", skip = true },
55
- { message = "\\[skip ci\\].*[Cc]hangelog", skip = true },
56
61
  { message = "^chore", group = "Miscellaneous Tasks" },
57
62
  { body = ".*security", group = "Security" },
58
63
  ]
@@ -0,0 +1,33 @@
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
3
+ <plist version="1.0">
4
+ <dict>
5
+ <key>Label</key>
6
+ <string>homebrew.mxcl.voice-server</string>
7
+ <key>ProgramArguments</key>
8
+ <array>
9
+ <string>/opt/homebrew/opt/bun/bin/bun</string>
10
+ <string>run</string>
11
+ <string>/opt/homebrew/opt/voice-server/dist/server.js</string>
12
+ </array>
13
+ <key>RunAtLoad</key>
14
+ <true/>
15
+ <key>KeepAlive</key>
16
+ <true/>
17
+ <key>StandardOutPath</key>
18
+ <string>/opt/homebrew/var/log/voice-server.log</string>
19
+ <key>StandardErrorPath</key>
20
+ <string>/opt/homebrew/var/log/voice-server.log</string>
21
+ <key>EnvironmentVariables</key>
22
+ <dict>
23
+ <key>PATH</key>
24
+ <string>/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
25
+ <key>PORT</key>
26
+ <string>8888</string>
27
+ </dict>
28
+ <key>WorkingDirectory</key>
29
+ <string>/opt/homebrew/opt/voice-server</string>
30
+ <key>UserName</key>
31
+ <string></string>
32
+ </dict>
33
+ </plist>
package/orca.yaml ADDED
@@ -0,0 +1,21 @@
1
+ # orca.yaml (repo root) — Orca project config with Codanna bootstrap (Bun scripts)
2
+ # author: Stephen Eaton
3
+ #
4
+ # setup runs in each new worktree right after Orca creates it.
5
+ # archive runs before Orca deletes a worktree.
6
+ # Script env: ORCA_ROOT_PATH (primary checkout), ORCA_WORKTREE_PATH, ORCA_WORKSPACE_NAME.
7
+ # Requires bun and codanna on PATH.
8
+ #
9
+ # Do NOT add .codanna (or .codanna/index) to worktree.sharedDirectories.
10
+ # Shared directories are symlinked, so every worktree would read and write ONE
11
+ # index built from the primary checkout's files, which is wrong for every branch.
12
+
13
+ scripts:
14
+ setup: |
15
+ bun "$ORCA_ROOT_PATH/.orca/codanna-setup.ts"
16
+ archive: |
17
+ bun "$ORCA_ROOT_PATH/.orca/codanna-archive.ts"
18
+
19
+ # worktree:
20
+ # sharedDirectories: # optional: share heavy, branch-independent caches only
21
+ # - node_modules
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@madeinoz67/voice-server",
3
- "version": "0.1.10",
3
+ "version": "0.1.12",
4
4
  "description": "PAI voice server using MLX-audio Kokoro TTS",
5
5
  "type": "module",
6
6
  "scripts": {