# VTT Prototype

A visual mock-up of every way to build a voice-to-text tool for Windows 10: push a hotkey, speak, and the words land in the page you are working in. It lays out the pathways (fully offline on one PC, a second PC on your network, the cloud, or a mix) and every building block, so you can choose a build before any real code is written. Nothing on the page is connected: it never uses the microphone and never makes a network request.

It lives at `/vtt-prototype` on app.austinpranger.com and is a self-contained static app (plain JavaScript modules, no build step), so it can move to its own repository as a plain copy.

## What is on the page

- **Signal chain**: six steps from trigger to inserted text. Pick a type and each step is tagged with the machine it runs on (this PC, a network PC, the cloud). Below it is a scripted demo of eight live-versus-on-stop strategies.
- **Types**: 16 pathways, T1a to T4d, in a comparison table and cards.
- **Options**: 137 options in 14 categories (C1 to C14), each with an ID, an effort rating, an upside and a downside.
- **My build**: pick a type and options, see clashes, copy a request.
- **Full list**: the whole catalog as a plain outline.

## IDs

A type is T plus a group digit and a letter (T2b). A category is C plus a number (C5). An option is its category plus a letter (C5a). Asking for "T2b, 2 from C5, 3 from C8" is a valid request.

## Files

- `assets/js/data.js`: the catalog, the rules and the helpers. Pure data, no DOM. Edit this to change the content.
- `assets/js/sim.js`: the scripted demos (no microphone).
- `assets/js/app.js`: the views. `assets/app.css`: the styles.
- `CATALOG.md`: the catalog as Markdown. Generated; do not edit by hand.
- `dev/make-catalog.mjs`: regenerates `CATALOG.md`.
- `tests/unit/data.test.mjs`: checks the data.

## Commands

```
node --test tools/public/vtt-prototype/tests/unit/*.test.mjs
node tools/public/vtt-prototype/dev/make-catalog.mjs
```

Read `CLAUDE.md` for the rules, then `TASKS.md` and `DECISIONS.md` before changing anything.
