pi-braid 0.43.20 → 0.43.21

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
@@ -53,6 +53,15 @@ record; the tag scheme above applies unchanged.
53
53
 
54
54
  ---
55
55
 
56
+ ## Core — 0.43.21 (2026-11-03: a failed synthesizer falls back to text, not to a worse voice)
57
+
58
+ - **The voice skill stops offering the offline voices as a substitute for a reply.** When the primary
59
+ synthesizer fails, the reply goes out as text with the outage named in one clause, and voice is
60
+ retried on the next turn. The rule is the owner's judgement measured the hard way: a fallback voice
61
+ note was rejected by ear ("не работает так"), while the outage it was covering had already cleared
62
+ on its own. The offline paths stay documented for audio that is not the reply to a message, which is
63
+ what they were always good for.
64
+
56
65
  ## Core — 0.43.20 (2026-11-03: the gates learn to see what is being written)
57
66
 
58
67
  - **The doc gates see the file being written.** `trackedMarkdown` enumerates untracked, non-ignored
package/build-info.json CHANGED
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "name": "pi-braid",
3
- "version": "0.43.20",
4
- "sha": "b798e2c75a33ca00f83818784d8552b4ee35531f",
5
- "shaShort": "b798e2c7",
3
+ "version": "0.43.21",
4
+ "sha": "f13e588cb743121baf9c952b51dbeafd59c67f55",
5
+ "shaShort": "f13e588c",
6
6
  "branch": "detached",
7
7
  "dirty": false,
8
- "packedAt": "2026-11-03T14:31:32.266Z"
8
+ "packedAt": "2026-11-03T17:19:45.993Z"
9
9
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-braid",
3
- "version": "0.43.20",
3
+ "version": "0.43.21",
4
4
  "description": "🥨 Braid - Metacognitive extension suite for pi coding agent: Adds memory, plan tracking, structured cognitive signals and completion checks on top of pi core loop, so long sessions keep their context and stop claiming unfinished work.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -2,7 +2,7 @@
2
2
  name: voice-replies
3
3
  description: "Reply to Telegram voice messages with synthesized speech: edge-tts (RU/EN/HE voices) → ffmpeg ogg/opus → Bot API sendVoice, matching the incoming message's language. Use when a voice message arrived and the reply should be a voice note in the same language, or when asked to send a Telegram voice reply. Triggers: voice reply, voice message, sendVoice, TTS, text-to-speech, edge-tts, Telegram audio reply. Includes offline fallbacks (piper, macOS say)."
4
4
  trigger: "voice replies, voice message reply, sendVoice, TTS, text-to-speech, edge-tts, piper, Telegram audio reply, responding in voice"
5
- validated: 2026-09-09
5
+ validated: 2026-11-03
6
6
  verdict: UNVALIDATED
7
7
  ---
8
8
 
@@ -17,6 +17,14 @@ Reply in the same modality **and language** as received:
17
17
  voice message in → voice reply in the same language. Text received → text reply.
18
18
  RU voiced in → Dmitry (RU). EN voiced in → Guy (EN). HE voiced in → Avri (HE).
19
19
 
20
+ **A failed primary synthesizer falls back to TEXT, not to a worse voice.** The owner rejects the
21
+ offline voices by ear: piper's output drew "у тебя чё-то с голосом не то, не работает так" the one
22
+ time it was sent, while edge-tts failures are transient: `NoAudioReceived` on six consecutive attempts
23
+ across the in-process and manual paths, then the first attempt succeeded minutes later with no
24
+ intervention. So a synthesizer outage is a delay, not an occasion to trade quality: send the reply as
25
+ text, name the outage in one clause, and retry voice on the next turn. A degraded voice note costs the
26
+ reader more than the delay does.
27
+
20
28
  ## Install
21
29
 
22
30
  Primary: `uvx edge-tts` (ephemeral, zero install) - OR a persistent venv you
@@ -95,7 +103,9 @@ uvx edge-tts --list-voices | grep -i <lang> # voice exists
95
103
 
96
104
  ## Offline Alternatives (lower priority)
97
105
 
98
- edge-tts is the primary zero-key path for RU/EN/HE. Offline fallbacks:
106
+ edge-tts is the primary zero-key path for RU/EN/HE. These fallbacks are for audio you are not sending
107
+ as the reply to a message (drafts, local artifacts, a transcript you want to hear), or for an owner who
108
+ explicitly asks for voice during an outage. They are not the substitute for a reply (see Modality Rule).
99
109
 
100
110
  **piper** (offline, RU only):
101
111
 
@@ -113,8 +123,8 @@ say -v Milena -o out.aiff "<text>" # Milena = ru-female
113
123
  ffmpeg -y -v error -i out.aiff -c:a libopus -b:a 40k -ar 48000 -ac 1 out.ogg
114
124
  ```
115
125
 
116
- In code, `say` is emergency-only (the owner dislikes its quality) and stays
117
- behind an explicit config choice (`source: "say"` or `"edge-tts+say"`).
126
+ In code, `say` is emergency-only and both offline voices stay behind an explicit config choice
127
+ (`source: "say"` or `"edge-tts+say"`); neither is a suitable default for an owner-facing reply.
118
128
 
119
129
  ## Dependency Note
120
130