# chip-fetcher 0.1.3 — Feature Tour

**Target duration:** 0:50–1:00
**Recorded:** 2026-05-04
**Final output:** `~/project/recordings/chip-fetcher-0.1.3-tour.webm`
**Wiki target:** `apps/chip-fetcher`
**Hero frame:** `00:04` of scene 1 (populated dashboard)

## Dependencies

- `adom-tts` — `/home/adom/project/adom-tts/target/release/adom-tts`
- `adom-desktop` — pup recording via CDP screencast
- `video-post` — `/home/adom/project/video-post/target/release/video-post`
- `ffmpeg 6+` — container-provided

## Recording config

- **Surface:** pup (`sessionId: chip-fetcher-demo`, separate from the live chip-fetcher session so we don't disturb the user's UL cookie state)
- **Voice:** `en-US-AndrewMultilingualNeural`
- **Frame rate:** 15 fps (with foreground-rebump pattern)
- **Resolution:** native pup window
- **Captions:** rendered in-page via injected `<div>` (pup doesn't support `adom-cli hydrogen caption show`)

## Pre-flight setup

1. chip-fetcher dashboard already serving at port 8780 (verify `curl HTTP 200` first).
2. UL Pro session already authenticated (john@adom.inc cookie in pup profile).
3. The 31/34 library is populated.
4. Open pup window with `adom-desktop browser_open_window` against the proxy URL.
5. **Foreground-rebump before every action** — pup paint-throttles otherwise.

## Scenes

| # | id | Caption (on-screen) | Narration (TTS, phonetics applied) | Length | Driver actions |
|---|----|---------------------|------------------------------------|--------|----------------|
| 1 | hero | `chip-fetcher 0.1.3` | `This is chip dash fetcher zero point one point three — Adom's automated chip C A D harvester. One command and a chip's full library lands in your project: step file, K I cad symbol and footprint, Altium S C H lib and P C B lib, Fusion three sixty l b r, and datasheets.` | 14s | Land on dashboard. Slow scroll cards from top. |
| 2 | library | `31 fully bundled · 3 stubs · 502 MB` | `The dashboard is your home base. Thirty one chips fully bundled, three stubs awaiting a manufacturer release, every card showing live Mouser stock and price.` | 10s | Hover a few cards, briefly zoom on badges. |
| 3 | credentials | `Credentials vault — masked by default` | `Vendor portal credentials live in a per host vault. Passwords are masked in the U I — click the dots to reveal one if you need to copy it.` | 10s | Open Credentials popover, screenshot, click-to-reveal one cred. |
| 4 | detail | `BME688 — every format, one click` | `Click any chip to see its full file inventory. The B M E six eight eight bundle: K I cad symbol, K I cad footprint, Altium S C H and P C B lib, Fusion three sixty l b r, manufacturer step, and seven data sheet PDFs.` | 14s | Close popover, click BME688 card, panel expands on right. |
| 5 | ul-pro | `UL Pro fast-path — no captcha when logged in` | `New in zero point one point three: the Ultra Librarian Pro logged in flow. Sign in once, then every fetch is captcha free. Seven chips this session, thirty seconds each.` | 12s | Show dashboard with mock activity heartbeat (POST to /api/activity). |

**Total target:** ~60s.

## TTS pronunciation overrides applied

(see `gallia/skills/tts-pronunciation/pronunciations.json` for canonical list)

- `chip-fetcher` → `chip dash fetcher`
- `0.1.3` → `zero point one point three`
- `KiCad` → `K I cad`
- `SchLib` / `PcbLib` → `S C H lib` / `P C B lib`
- `lbr` → `l b r`
- `BME688` → `B M E six eight eight`
- `MPN` / `CAD` / `UI` / `PDF` → spelled with spaces
- `Mouser` → `mouser` (TTS gets this right)
- `Fusion 360` → `Fusion three sixty`

## Reproduction

```bash
cd /home/adom/project/chip-fetcher
bash demo/record.sh                    # drives the per-scene recording
bash demo/mux.sh                       # generates TTS, muxes, registers with video-post manifest
video-post storyboard /tmp/cf-demo/manifest.json   # review (MANDATORY gate)
# after approval:
bash demo/concat.sh                    # ffmpeg concat → final.webm + hero.png
adom-wiki asset upload apps/chip-fetcher --asset-type video --file ~/project/recordings/chip-fetcher-0.1.3-tour.webm \
  --caption "chip-fetcher 0.1.3 feature tour — dashboard, masked credentials, detail panel, UL Pro fast-path"
```

## Post-publish cleanup

- `pkill -f "video-post storyboard"`
- Close `chip-fetcher-demo` pup session (`browser_close_window`).
- Restore the user's original `chip-fetcher` pup session as the visible one.