Files
tai/research/terminal-screenshot-rendering/github-charmbracelet-freeze.md
T
retoorandClaude Opus 4.8 115e403e67 whatsapp: native C++ client + terminal-screenshot tool
Native WhatsApp Web multi-device client in C++ (src/whatsapp/, namespace
detz::wa), built on OpenSSL plus a vendored public-domain ed25519 ref10
(third_party/ed25519, zlib) for XEdDSA and the nayuki QR generator
(third_party/qrcodegen, MIT); no new runtime dependency.

- WaCrypto, WaBinary, WaProto, WaNoise, WaSignal, WaDevice, WaSocket,
  WaClient, WaStore, WaQr, WaWizard.
- Verified offline against golden vectors captured from the real Baileys
  client (tests/whatsapp_data, from jfelipesjc/wa-go, MIT): HKDF/PBKDF2 RFC
  vectors, XEdDSA roundtrips, codec battery 19/19, ClientPayload byte-exact,
  the Noise handshake, and a 4-exchange Signal session byte-exact. Unit test
  build/whatsapp_test (16/16), run_all step whatsapp.unit.
- Verified live against web.whatsapp.com: `detz --whatsapp-link` connects,
  completes the Noise handshake, receives pair-device, renders a scannable QR
  in the terminal, and persists the device to the vault (whatsapp/<profile>.db).
  Also --whatsapp-status / --whatsapp-unlink.
- Agent tools whatsapp_send and whatsapp_contacts (detz-only, in DetzTools).
- Pairing completion after the phone scans, and the message send path
  (usync + prekey fetch + Signal encrypt + send node), are ported faithfully
  from whatsmeow but unverified in-tree (no linked account in development).
  send_image and own-device fan-out are not wired yet. See docs/whatsapp.md.

Also in this snapshot: the terminal-screenshot tool (src/termshot/,
terminal_screenshot, docs/termshot.md, research/terminal-screenshot-rendering)
and a concurrent session's in-progress llm/muse failover changes carried along
in the shared files.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-27 18:22:24 +01:00

50 lines
1.8 KiB
Markdown

# charmbracelet/freeze README
## Metadata
| Field | Value |
|---|---|
| Institute | Molodetz Institute — Research & Retrieval Division |
| Subject | terminal-screenshot-rendering |
| Document type | Source Dossier |
| Tier | 1 |
| Source title | charmbracelet/freeze README |
| Source URL | https://github.com/charmbracelet/freeze |
| Source publisher / author | Charmbracelet |
| Source type | repository |
| Source date (published) | Unknown — not stated |
| Date researched | 2026-10-27 |
| Researched by | tai (agent), model: Claude Opus 5.5, on behalf of retoor |
| Research method | direct page fetch |
| Confidence | Medium |
| Status | Active |
## Summary
Freeze is a Go CLI that turns code and terminal output into SVG, PNG or WebP images. The README documents capturing ANSI output with `--execute` and piping `tmux capture-pane -pet 1 | freeze -c full`; it does not explain how PNG rasterization works.
## Key findings
- Captures ANSI output with `--execute "cmd"`; TUI example `tmux capture-pane -pet 1 | freeze -c full`.
- Output format follows the file extension: .svg, .png, .webp; default out.svg.
- Default font JetBrains Mono 14 px, line height 1.2; `--font.file` embeds a TTF/WOFF/WOFF2 into the SVG.
- MIT license; repository contains ansi.go, font.go, png.go (not read).
## Pros / strengths
Confirms the industry pattern this design copies: tmux capture-pane with escapes as the input.
## Cons / limitations / caveats
README only; PNG pipeline and whether a system font or rasterizer library is required were not stated. A Go binary dependency for detz.
## Relevance to tai
Rejected as a dependency (external Go binary, outline fonts); its `capture-pane -pet` input pattern was adopted.
## Changelog
| Date | Change |
|---|---|
| 2026-10-27 | Initial dossier created. |