dexterm-cli 0.1.3 → 0.1.4

package/dist/packages/mcp/assets/kb/docs/docs-troubleshooting-common-questions.md

@@ -0,0 +1,33 @@
+---
+id: docs-troubleshooting-common-questions
+title: Troubleshooting › Common questions
+kind: docs
+page: troubleshooting
+page_title: Troubleshooting
+heading: Common questions
+anchor: common-questions
+url: https://dexterm.xyz/docs/troubleshooting#common-questions
+tags:
+  - docs
+  - troubleshooting
+  - common
+  - questions
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/troubleshooting.md
+date: 2026-10-16
+---
+
+**The screener is empty on first launch.** It should paint cached or skeleton rows within a second. If it stays empty for more than a few seconds, run `dexterm doctor`: the Jupiter bucket allows one call every ~3 s keyless, and a 429 pauses it for 30 s.
+
+**Candles load slowly after switching timeframe.** 5m/15m derive from 1m and 4h/1d from 1h locally, so a switch costs at most one fetch, and the chart goes ahead of background work. GeckoTerminal allows about 10 calls a minute per IP; several dexterm instances on one IP share that.
+
+**The chart popup did not dock.** macOS Automation permission was denied, or the terminal is not Terminal.app or iTerm2; the window opens at the screen edge instead. Drag it where you want it.
+
+**Quitting takes long.** It should take under a second. If it does not, report it with `--verbose` output; the shutdown signal cancels every pending wait.
+
+**Something that looks like dexterm asks for a seed phrase or a wallet connection.** It is not dexterm. The app never asks for keys; see security and trust (https://dexterm.xyz/trust/).

package/dist/packages/mcp/assets/kb/docs/docs-troubleshooting-doctor-lines.md

@@ -0,0 +1,36 @@
+---
+id: docs-troubleshooting-doctor-lines
+title: Troubleshooting › Doctor lines
+kind: docs
+page: troubleshooting
+page_title: Troubleshooting
+heading: Doctor lines
+anchor: doctor-lines
+url: https://dexterm.xyz/docs/troubleshooting#doctor-lines
+tags:
+  - docs
+  - troubleshooting
+  - doctor
+  - lines
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/troubleshooting.md
+date: 2026-10-16
+---
+
+| line | meaning | fix |
+|---|---|---|
+| `✗ Node … too old` | Node is below 22.18 (needed to run the TypeScript entry) | `nvm install 22` or `brew install node`, then re-run. `./install.sh` can fetch a verified Node for you. |
+| `! Terminal: not a TTY` | output is piped or the shell is not interactive | run `dexterm` in a terminal window. One-shot frames still work with `--screen`. |
+| `! Terminal colour: 256-colour only` | the terminal cannot do 24-bit colour | use a truecolor terminal (iTerm2, WezTerm, Ghostty, Kitty, Alacritty, Windows Terminal) or set `COLORTERM=truecolor`. The app runs, flattened. |
+| `! Terminal colour: no colour` | `NO_COLOR` is set, or a monochrome terminal | unset `NO_COLOR` for the full look; dexterm works in monochrome. |
+| `! Claude CLI: not found` | `claude` is not on PATH | only the analyst needs it: install Claude Code and run `claude` once to log in. Everything else works. |
+| `! Helius RPC: no key` | no key configured | optional. Holders and some safety fields show `needs key`; see configuration (https://dexterm.xyz/docs/configuration#the-optional-free-rpc-key). |
+| `✗ Data sources: unreachable …` | a required host did not answer | check your connection, VPN or firewall. If only some hosts fail they may be blocked on your network. `--fixtures` or `DEXTERM_OFFLINE=1` browse offline demo data. |
+| `! Data sources: … PumpPortal …` | only the new-pairs host is down | the rest works; new pairs may be blocked on your network. |
+| `! Chart window: not built` | no native shell | the chart popup opens in your browser. For the docked window install Rust and run `npm run build:shell` in `packages/popup`. |
+| `✗ Data directory: cannot write …` | the data dir is not writable | fix the permissions the line names, or run with `--db :memory:`. |

package/dist/packages/mcp/assets/kb/docs/docs-troubleshooting-in-app-messages.md

@@ -0,0 +1,42 @@
+---
+id: docs-troubleshooting-in-app-messages
+title: Troubleshooting › In-app messages
+kind: docs
+page: troubleshooting
+page_title: Troubleshooting
+heading: In-app messages
+anchor: in-app-messages
+url: https://dexterm.xyz/docs/troubleshooting#in-app-messages
+tags:
+  - docs
+  - troubleshooting
+  - in-app
+  - messages
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/troubleshooting.md
+date: 2026-10-16
+---
+
+| message | meaning |
+|---|---|
+| `connecting to the live feed…` | the first DexScreener list has not landed yet; skeleton rows show in the meantime |
+| `offline — can't reach the data feed` | no source answered; run `dexterm doctor`. `r` retries. |
+| `rate-limited — backing off` | a source returned 429; the limiter pauses it (30 s, doubling to 10 min) and other sources keep going |
+| `unavailable: <reason>` / `needs key` in a panel | that panel's source is down or needs a key; nothing is fabricated |
+| `cached Nm old · refreshing` | the screener painted its last snapshot while fresh rows load |
+| `claude is not logged in` in the analyst panel | run `claude login` and retry |
+| `analyst busy; Esc to interrupt before vetting` | one run per conversation at a time; `esc` interrupts it |
+| `open links needs live mode` / `paper trading needs live mode` | fixtures and one-shot frames have no real links or quotes |
+| `AI scan needs live data (or --replay FILE)` | the scan has nothing real to watch on fixtures |
+| `AI scan blocked analyst action "…" · observe-only` | the model tried an action during a scan and the app refused it; this is the safety layer working |
+| `rate limited by Jupiter — retrying…` on a ticket | the keyless quote bucket is paused; the confirm retries for up to 8 s, then lets you retry or cancel |
+| `chart opened in browser (<reason>)` | the native shell is not built or has no display; the page says why too |
+| `voice-in unavailable — type your question instead` | no speech-to-text engine on this Mac (no `swiftc`, or no whisper-cli + model + sox/ffmpeg); replies are still spoken. `dexterm doctor` prints the 2-minute fix |
+| `mic/STT could not start: …` | the Apple Speech helper could not be spawned or macOS denied Microphone / Speech permission; voice stays idle and the keyboard works. Allow the permissions in System Settings › Privacy & Security, or set `DEXTERM_VOICE_STT=whisper` |
+| `mic timed out — press v to talk again` | the mic was live for 15 s with no second `v`; it closed itself |
+| `I don't see a token called X` / `I see 2 tokens called X` | voice never guesses a coin: open the exact token first, then say buy or sell |

package/dist/packages/mcp/assets/kb/docs/docs-troubleshooting-reporting-a-problem.md

@@ -0,0 +1,25 @@
+---
+id: docs-troubleshooting-reporting-a-problem
+title: Troubleshooting › Reporting a problem
+kind: docs
+page: troubleshooting
+page_title: Troubleshooting
+heading: Reporting a problem
+anchor: reporting-a-problem
+url: https://dexterm.xyz/docs/troubleshooting#reporting-a-problem
+tags:
+  - docs
+  - troubleshooting
+  - reporting
+  - problem
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/troubleshooting.md
+date: 2026-10-16
+---
+
+Include `dexterm --version`, the `dexterm doctor` output (it contains no secrets), your terminal, and if possible a `--record` file of the one-shot frame that misbehaves (keys are redacted at capture). Where to send it is on the trust page (https://dexterm.xyz/trust/#report).

package/dist/packages/mcp/assets/kb/docs/docs-troubleshooting.md

@@ -0,0 +1,23 @@
+---
+id: docs-troubleshooting
+title: Troubleshooting
+kind: docs
+page: troubleshooting
+page_title: Troubleshooting
+url: https://dexterm.xyz/docs/troubleshooting
+tags:
+  - docs
+  - troubleshooting
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/troubleshooting.md
+date: 2026-10-16
+---
+
+What each doctor line and in-app message means, and the fix.
+
+`dexterm doctor` is the first stop. It exits 0 when the app will run (warnings are optional) and 1 when something must be fixed, and every non-pass line prints the exact fix.

package/dist/packages/mcp/assets/kb/docs/docs-voice-doctor.md

@@ -0,0 +1,26 @@
+---
+id: docs-voice-doctor
+title: Jarvis voice mode › Doctor
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: Doctor
+anchor: doctor
+url: https://dexterm.xyz/docs/voice#doctor
+tags:
+  - docs
+  - voice
+  - doctor
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+`dexterm doctor` has a voice section. When the neural voice is set up it shows `Voice out (Piper)` as the default with `Voice out (say, fallback)` beneath it; when it is not, it shows `Voice out (say)` plus a `Neural voice (Piper)` hint whose fix is `dexterm voice setup`. It also shows `Voice in (Apple Speech)` or `Voice in (whisper)` and a mic-capture note. Every line is a warning at worst and voice degrades to text; the doctor never fails because of voice. `dexterm voice status` shows the same engine summary and which models are installed.

package/dist/packages/mcp/assets/kb/docs/docs-voice-it-clarifies-it-never-guesses.md

@@ -0,0 +1,36 @@
+---
+id: docs-voice-it-clarifies-it-never-guesses
+title: Jarvis voice mode › It clarifies; it never guesses
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: It clarifies; it never guesses
+anchor: it-clarifies-it-never-guesses
+url: https://dexterm.xyz/docs/voice#it-clarifies-it-never-guesses
+tags:
+  - docs
+  - voice
+  - clarifies
+  - never
+  - guesses
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+- A ticker it cannot see on screen gets "I don't see a token called X — open it first". There is no fuzzy match: "buy bonks" does not become BONK.
+- A ticker that resolves to **more than one mint** (a copycat) gets "I see 2 tokens called X. Open the exact one first, then say buy" and no ticket opens.
+- A pronoun ("buy it") means the row actually highlighted on the current screen. On an empty list it asks instead of acting on a coin you cannot see.
+- "cell wif" / "by bonk" (homophones) ask "did you mean sell?". A screen command and a trade in one breath ("show runners and sell all my bonk") ask you to say just one. A bare "close" or "exit" asks what to close.
+- A named ticker beats a pronoun: "buy BONK, confirm it" with WIF selected opens a BONK ticket, never WIF.
+- A spoken ticker that is **also a command word** and is visible on screen — "buy live" with a token called LIVE in the list — is not assumed to be the highlighted row: it asks which token you mean rather than silently buying the selected coin.
+- **More than one ticker in a breath** ("buy wif and bonk") asks which one; it never quietly drops one and trades the other.
+- A **spoken size, amount or slippage** ("buy 10 sol of bonk", "buy bonk with max size", "buy bonk 50 percent slippage") is not applied by voice: it says it does not set size or slippage by voice, and asks you to open the ticket and set it there. No size spoken aloud ever reaches a ticket.
+- An **order plan** needs every market cap to carry its scale: "dips to 300k" is a plan, "dips to 300" asks "300k or 300m?" instead of guessing, and "1.2m" keeps its decimal point rather than collapsing to 12m. An unclear fraction ("sell some at 600k") asks what fraction; a plan with no named or highlighted coin asks which coin. "… and confirm it" at the end of a plan drafts the same inert proposal and arms nothing.

package/dist/packages/mcp/assets/kb/docs/docs-voice-latency.md

@@ -0,0 +1,38 @@
+---
+id: docs-voice-latency
+title: Jarvis voice mode › Latency
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: Latency
+anchor: latency
+url: https://dexterm.xyz/docs/voice#latency
+tags:
+  - docs
+  - voice
+  - latency
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+Measured on the development Mac (Intel i7-8700B, 2026-10-10), key-release to first spoken word, excluding speech-to-text:
+
+| stage | measured |
+|---|---|
+| router (intent, clarify, provenance gate) | 0.01 ms median |
+| `say` first audio | 0.8 ms median |
+| Piper neural first audio, model pre-warmed (voice on) | ~0.18 s (cold, first-ever reply: ~1.7 s) |
+| instant command path (router + say) | under 1 ms |
+| Claude first token (warm `claude -p`, model only) | 3.1 s |
+| Apple Speech helper, cached lookup | 0.2 ms; a one-time 4.1 s `swiftc` compile on first use |
+| whisper `base.en` on a 2.3 s clip (CPU batch) | 3.0 to 3.3 s |
+
+Apple Speech streams partial transcripts while you speak, so the perceived speech-to-text delay is well under a second; whisper is a batch fallback and feels like three seconds. Real analyst turns add tool round-trips on top of the first token.

package/dist/packages/mcp/assets/kb/docs/docs-voice-linux-and-windows.md

@@ -0,0 +1,32 @@
+---
+id: docs-voice-linux-and-windows
+title: Jarvis voice mode › Linux and Windows
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: Linux and Windows
+anchor: linux-and-windows
+url: https://dexterm.xyz/docs/voice#linux-and-windows
+tags:
+  - docs
+  - voice
+  - linux
+  - windows
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+**Linux is beta (since 0.1.2); Windows voice input is not built.** macOS is the platform voice mode was built and measured on. Off macOS the engines below exist on main, but no person has yet verified real speaker or microphone I/O on Linux hardware. Treat Linux voice as beta. Every voice action has a keyboard equivalent.
+
+- **Speech out (Linux).** The neural Piper engine is the default when its prebuilt binary and the `en_GB-alan-medium` voice are installed (`dexterm voice download piper-voice` fetches the voice from Hugging Face, asks first and checks a pinned checksum). `espeak-ng` is the fallback. Both play their WAV through `aplay`, `paplay` or `ffplay`. Synthesis to WAV is verified in Docker on Linux, but real speaker output is not covered by the test suite. `dexterm doctor` names what is missing. Don't use `apt install piper`, which installs an unrelated tool.
+- **Speech in (Linux).** Apple Speech is macOS-only. The local whisper.cpp engine (`dexterm voice download whisper` fetches its `base.en` model) records with `sox`, `arecord` (alsa-utils) or `ffmpeg -f alsa`. Real microphone capture on Linux is not yet verified on hardware.
+- **Windows.** Untested. `espeak-ng` or Piper may speak through `ffplay`, but microphone capture has no Windows-specific input (the `ffmpeg` capture uses a macOS or Linux device), so treat push-to-talk on Windows as not built.
+- **Unchanged everywhere.** The router, the clarify-never-guess rules and the hard limits above are platform-independent. Another platform adds engines, not powers: voice can never confirm, sign, flip LIVE or raise a cap.

package/dist/packages/mcp/assets/kb/docs/docs-voice-privacy.md

@@ -0,0 +1,26 @@
+---
+id: docs-voice-privacy
+title: Jarvis voice mode › Privacy
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: Privacy
+anchor: privacy
+url: https://dexterm.xyz/docs/voice#privacy
+tags:
+  - docs
+  - voice
+  - privacy
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+The Apple path keeps no audio file; the whisper path writes a temporary WAV and deletes it after transcription unless `DEXTERM_VOICE_RECORD=1`. Transcripts are treated as untrusted text: control characters are stripped before anything is drawn, and a voice question is capped at 400 characters like a typed one. Questions sent to the analyst land in your own Claude Code session store, the same as typed questions.

package/dist/packages/mcp/assets/kb/docs/docs-voice-still-unverified.md

@@ -0,0 +1,27 @@
+---
+id: docs-voice-still-unverified
+title: Jarvis voice mode › Still unverified
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: Still unverified
+anchor: still-unverified
+url: https://dexterm.xyz/docs/voice#still-unverified
+tags:
+  - docs
+  - voice
+  - still
+  - unverified
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+The real-microphone path has been exercised headlessly (scripted speech engines, the real key loop) and the engines have been measured on synthetic audio. A person has not yet run the first-launch Microphone and Speech prompts and spoken to it end to end; see the changelog (https://dexterm.xyz/changelog/).

package/dist/packages/mcp/assets/kb/docs/docs-voice-the-voice-neural-by-default.md

@@ -0,0 +1,48 @@
+---
+id: docs-voice-the-voice-neural-by-default
+title: Jarvis voice mode › The voice: neural by default
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: The voice: neural by default
+anchor: the-voice-neural-by-default
+url: https://dexterm.xyz/docs/voice#the-voice-neural-by-default
+tags:
+  - docs
+  - voice
+  - neural
+  - default
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+dexterm speaks with a **neural British voice** (Piper, `en_GB-alan-medium`) — the one chosen as the default. It is free, local and keyless, and sounds markedly more natural than the built-in system voices. It is the default speaking voice everywhere it is installed, on macOS as well as Linux, with the system `say` voice as the fallback.
+
+On macOS, run `dexterm voice setup` once to install it. The prebuilt macOS Piper binary from upstream is broken (it needs a system library it does not bundle), so dexterm instead builds its own private Python environment under `~/.dexterm/piper/` and installs Piper into it, then downloads the ~61 MB voice from the official source and checks it against a pinned checksum. It asks before it does any of this, needs Python 3.9+ (the doctor prints the exact install line if it is missing), runs fully offline afterwards, and ships no key. `dexterm voice uninstall` removes the runtime and keeps the downloaded voice model (add `--purge-model` to delete that too); the fallback `say` voice takes over again. Off macOS, install the prebuilt Piper binary and run `dexterm voice download piper-voice`.
+
+```sh
+$ dexterm voice setup                    # macOS: private runtime + checksum-verified voice (asks first)
+$ dexterm voice status                   # which engines and models this machine has
+$ dexterm voice uninstall                # remove the runtime (add --purge-model to drop the voice too)
+```
+
+Once Piper is installed it is used automatically — no config change. The model is kept pre-warmed while voice is on, so the first word of a reply starts in about a fifth of a second. `voice.rate` still maps to its speaking speed; a `voice.pitch` setting does not apply to Piper (its pitch is fixed by the model) and is ignored.
+
+**The fallback chain.** dexterm picks the first engine that can speak on this machine, and never a novelty voice or the machine's own system voice:
+
+| platform | 1st | 2nd | then |
+| --- | --- | --- | --- |
+| macOS | Piper `en_GB-alan-medium` (after `dexterm voice setup`) | `say` with a deep British male voice (Eddy, then Daniel, then the next installed one on that list) | text only: the analyst still answers on screen |
+| Linux (beta) | Piper (prebuilt binary + `dexterm voice download piper-voice`) | `espeak-ng` with a British male voice | text only |
+
+Set `DEXTERM_VOICE_TTS` to `piper`, `say`, `espeak` or `none` to pin one engine. An explicit `say` never switches to Piper.
+
+**Speed and delivery.** `<` slows the spoken reply and `>` speeds it up, 15 words a minute per press between 120 and 320 (the default is 205). The new rate is saved to `voice.rate` in `config.json`. Numbers are read the way a trader says them: a sub-cent price is spoken as the coin's market cap when the line includes one, and otherwise as "a tiny price". Years and SOL amounts are read as written. On the screener, "this one", "this coin" or "it" means the highlighted row.

package/dist/packages/mcp/assets/kb/docs/docs-voice-what-it-can-never-do.md

@@ -0,0 +1,27 @@
+---
+id: docs-voice-what-it-can-never-do
+title: Jarvis voice mode › What it can never do
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: What it can never do
+anchor: what-it-can-never-do
+url: https://dexterm.xyz/docs/voice#what-it-can-never-do
+tags:
+  - docs
+  - voice
+  - can
+  - never
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+Voice creates proposals only. The ticket it opens is PAPER, in its editing phase, and the keypress gate stands: your `⏎` then `y` (plus the typed-back size above the threshold) is the only way to a fill. Spoken "confirm", "send it", "y", "sign it", "go live", "arm it", "raise my cap", "panic" and "/wallet …" are routed as questions or ignored; they cannot flip the ticket to LIVE, arm a plan, touch the signer's caps, run a wallet command or press anything. The router's output is a closed set of decision kinds, a guard rejects any decision that carries a mode, live, arm, caps, confirm, sign or send field, and an in-app test drives the real key loop with the executor, the confirm paths, the LIVE flip and the wallet commands booby-trapped: twenty-one hostile utterances, zero touches.

package/dist/packages/mcp/assets/kb/docs/docs-voice-what-you-can-say.md

@@ -0,0 +1,38 @@
+---
+id: docs-voice-what-you-can-say
+title: Jarvis voice mode › What you can say
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+heading: What you can say
+anchor: what-you-can-say
+url: https://dexterm.xyz/docs/voice#what-you-can-say
+tags:
+  - docs
+  - voice
+  - can
+  - say
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+| you say | what happens | path |
+|---|---|---|
+| "show me the runners", "go to new pairs", "open my watchlist", "positions" | switches the screen | instant, no model |
+| "open bonk", "pull up wif" | opens that coin's token screen | instant |
+| "filter liquidity over 50k", "only show age under 10 minutes" | sets the screener filter | instant |
+| "watch this one", "add bonk to my watchlist" | adds to the watchlist | instant |
+| "show the chart", "close the chart" | opens or closes the chart popup for the open coin through the popup host | instant |
+| "buy bonk", "sell half of wif", "ape into this one" | opens a **PAPER ticket in its editing phase** for the spoken coin and says so | instant |
+| "is this a rug?", "what do you think about wif", "tell me about the holders" | asks the analyst; the first two sentences of the answer are read aloud | Claude |
+| "buy this if it dips to 300k, sell half at 600k, and leave a moon bag", "buy bonk if it drops to 250k, stop at 150k" | drafts an **order-plan proposal** (entry trigger, take-profit ladder, moon bag, stop) for the named or highlighted coin; it is inert until you arm it with a held keypress on the `O` screen or `dexterm plan arm` | instant, no model |
+
+`m` mutes the replies, `,` cycles the macOS `say` voice (the fallback; Piper itself has one fixed voice), `<` / `>` make it slower or faster, `esc` stops a reply or cancels the mic. Only the keyboard changes the voice: the analyst can explain these keys but has no action that sets them. Any other key pressed while the mic is live closes it first and then does its normal job, and the mic auto-closes after 15 s if you walk away. On the ticket screen the voice keys are off, so nothing spoken can reach the confirm gate.

package/dist/packages/mcp/assets/kb/docs/docs-voice.md

@@ -0,0 +1,25 @@
+---
+id: docs-voice
+title: Jarvis voice mode
+kind: docs
+page: voice
+page_title: Jarvis voice mode
+url: https://dexterm.xyz/docs/voice
+tags:
+  - docs
+  - voice
+  - jarvis
+  - mode
+confidence: high
+owner: maintainers
+origin: docs-generated
+reviewed_by: generated@2026-10-16
+generated_from: dexterm/site content/docs (task-1420)
+sources:
+  - site/content/docs/voice.md
+date: 2026-10-16
+---
+
+Push-to-talk on v, an instant local command path, Claude for analysis, spoken replies, popups. Voice only ever proposes; it can never confirm, sign, flip LIVE or raise a cap.
+
+`v` is push-to-talk. Press it once and the mic opens (a red `● LISTENING` badge sits on the band under the header the whole time it is live); say what you want; press `v` again to send. The first press enables voice for the run and asks macOS for Microphone and Speech permission. Everything is free and local: speech-out is the neural Piper voice once it is set up (otherwise the built-in `say`), speech-in is on-device Apple Speech (compiled once with `swiftc`) or a local whisper.cpp `base.en` model, and the only model in the loop is your own `claude` login, for analysis questions. No paid speech API exists in the code, no key is read, nothing is recorded to disk.

package/dist/packages/mcp/src/app-help.js

@@ -133,3 +133,126 @@ export function searchAppHelp(query, limit = 5, entries = loadAppHelp()) {
 export function getAppHelp(id, entries = loadAppHelp()) {
     return entries.find((e) => e.id === id) ?? null;
 }
+// ---------------------------------------------------------------------------------------- docs (task-1420)
+// A THIRD bundled set: every page of the site docs (dexterm.xyz/docs), chunked by heading. GENERATED from the
+// site by `packages/cli/src/docs-kb-gen.ts` (committed; a regenerate-and-diff test runs when the site checkout
+// is present). The app-help entries stay the authority for an exact key or command; a docs entry carries the
+// explanation and the URL to cite, and NEVER structured keys/commands/flags/tools. Its text is reference DATA:
+// the app_help tool hands it to a model firewalled (`<untrusted kind="docs">`), so an instruction written into
+// a docs page reads as quoted text, never as an order.
+/** The shipped docs KB directory (read-only; generated from the site docs). */
+export const DOCS_KB_DIR = path.resolve(HERE, '..', 'assets', 'kb', 'docs');
+function toDocs(e) {
+    return {
+        id: e.id,
+        title: String(e.meta.title ?? e.id),
+        page: String(e.meta.page ?? ''),
+        pageTitle: String(e.meta.page_title ?? ''),
+        heading: String(e.meta.heading ?? ''),
+        anchor: String(e.meta.anchor ?? ''),
+        url: String(e.meta.url ?? ''),
+        tags: list(e.meta.tags),
+        body: e.body,
+        bytes: e.bytes,
+    };
+}
+/** Load every docs entry (bundled-only; deterministic order by id). */
+export function loadDocsKb(dir = DOCS_KB_DIR) {
+    const entries = loadBundled([{ dir, layout: 'flat' }]).map(toDocs);
+    entries.sort((a, b) => a.id.localeCompare(b.id));
+    return entries;
+}
+/**
+ * A light, deterministic stemmer for the docs set only (prose, unlike the app-help titles): "answers"/"answer",
+ * "cached"/"cache", "clarifies"/"clarify", "streaming"/"stream" meet. Short words are left alone.
+ */
+function stem(w) {
+    if (w.length < 4 || w.includes('-'))
+        return w;
+    let s = w;
+    if (s.endsWith('ies') && s.length > 4)
+        s = s.slice(0, -3) + 'y';
+    else if (s.endsWith('ing') && s.length > 5)
+        s = s.slice(0, -3);
+    else if (s.endsWith('ed') && s.length > 4)
+        s = s.slice(0, -2);
+    else if (/(?:ss|sh|ch|x|z)es$/.test(s))
+        s = s.slice(0, -2);
+    else if (s.endsWith('s') && !s.endsWith('ss'))
+        s = s.slice(0, -1);
+    if (s.endsWith('e') && s.length > 3)
+        s = s.slice(0, -1);
+    return s;
+}
+/**
+ * Deterministic keyword retrieval over the docs set (no model), same word-boundary matching as app-help.
+ * The section heading and tags score strongest, the page title less (every section of a page shares it),
+ * the body is the weak tail.
+ */
+export function searchDocs(query, limit = 5, entries = loadDocsKb()) {
+    const terms = [...new Set(expand(tokenise(query)).map(stem))];
+    const scored = entries.map((e) => {
+        const strong = new Set(words(`${e.heading} ${e.tags.filter((t) => t !== 'docs').join(' ')}`).map(stem));
+        const page = new Set(words(`${e.pageTitle} ${e.page}`).map(stem));
+        const bodyWords = words(e.body).map(stem);
+        let score = 0;
+        for (const t of terms) {
+            if (strong.has(t))
+                score += 4;
+            else if (page.has(t))
+                score += 2;
+            let n = 0;
+            for (const w of bodyWords)
+                if (w === t)
+                    n++;
+            score += Math.min(n, 3);
+        }
+        // A question that names a section's own heading words is about that section: +3 per heading word
+        // matched (+2 more when it names all of them), so "what is redacted in the spectator view" lands on "What is redacted",
+        // not on the page's other sections that merely share the page title.
+        const head = new Set(tokenise(e.heading).map(stem));
+        let hit = 0;
+        for (const w of head)
+            if (terms.includes(w))
+                hit++;
+        if (hit >= 1 && head.size > 0)
+            score += 3 * hit + (hit === head.size ? 2 : 0);
+        return { e, score };
+    }).filter((x) => x.score > 0)
+        .sort((a, b) => (b.score - a.score) || a.e.id.localeCompare(b.e.id))
+        .slice(0, limit);
+    return scored.map(({ e, score }) => ({ ...e, score }));
+}
+/** Fetch one docs entry by id. */
+export function getDocs(id, entries = loadDocsKb()) {
+    return entries.find((e) => e.id === id) ?? null;
+}
+/** Words that make a question about an exact key or command: app-help answers it. */
+const KEY_OR_COMMAND = /\b(?:key|keys|keybind\w*|press|pressing|shortcut|shortcuts|hotkey|hotkeys|command|commands|subcommand|subcommands|flag|flags|cli)\b/i;
+/** "how do I …" / "how to …": a how-to, answered by an app-help topic. */
+const HOW_TO = /^\s*how\s+(?:do|can|could|would|should)\s+(?:i|you|we)\b|^\s*how\s+to\b/i;
+/** A conceptual question opens with a question word ("what is …", "does it …", "how does …", "how long …"). */
+const CONCEPT = /^\s*(?:what|whats|what's|why|is|are|does|do|did|can|could|will|would|should|where|when|which|who|how)\b/i;
+/** About a screen ("what does the token screen show") or the coin on it ("is this coin a rug"): an app-help topic/tool. */
+const APP_SUBJECT = /\b(?:screen|screener)\b|\bthis\s+(?:[a-z-]+\s+){0,2}(?:coin|token|project)\b/i;
+/** The question's shape: 'key' (exact key/command, a how-to, an imperative, a screen/this-coin question) or 'concept'. */
+export function helpIntent(query) {
+    if (KEY_OR_COMMAND.test(query) || HOW_TO.test(query) || APP_SUBJECT.test(query))
+        return 'key';
+    return CONCEPT.test(query) ? 'concept' : 'key';
+}
+/**
+ * The analyst's help search (task-1420): app-help AND the docs, merged by the question's shape.
+ *  - a key/command question, a how-to or an imperative ("export the view", "how do I sort"): app-help ranks
+ *    first (it carries the exact key/command), the docs after it;
+ *  - a conceptual question ("what is redacted in the spectator view", "does voice work on linux"): the docs rank
+ *    first (nothing ranks above them), the app-help after.
+ * Either way the answer keeps both sets in view: up to 3 hits of the leading set, then up to 2 of the other,
+ * then the rest. A set with no hits simply yields to the other (a docs-only answer beats no answer).
+ */
+export function searchHelp(query, limit = 5, sets = {}) {
+    const app = searchAppHelp(query, limit, sets.appHelp ?? loadAppHelp()).map((e) => ({ ...e, origin: 'app-help' }));
+    const docs = searchDocs(query, limit, sets.docs ?? loadDocsKb()).map((e) => ({ ...e, origin: 'docs' }));
+    const [lead, other] = helpIntent(query) === 'concept' ? [docs, app] : [app, docs];
+    return [...lead.slice(0, 3), ...other.slice(0, 2), ...lead.slice(3), ...other.slice(2)].slice(0, limit);
+}

package/dist/packages/mcp/src/firewall.js

@@ -1,7 +1,7 @@
 // Prompt firewall (CL-06), spec'd in SPEC §5.3. Kept tiny and total. Every untrusted string — token text,
 // web pages, RugCheck risks, and (task-1377) user- or pack-edited KB entries and skills — passes through
-// here before a model sees it.
-export const LIMITS = { name: 64, symbol: 16, description: 512, risk: 160, kb: 4000, page: 1600, link: 40, skill: 8000 };
+// here before a model sees it. (task-1420) The generated docs KB sections pass through as kind `docs`.
+export const LIMITS = { name: 64, symbol: 16, description: 512, risk: 160, kb: 4000, page: 1600, link: 40, skill: 8000, docs: 6000 };
 export function firewall(text, source, kind = 'description', opts = {}) {
     if (text === null || text === undefined)
         return null;