seshy wrapped: local, deterministic stats cards from your agent logs

[buddyh]

What

seshy wrapped / npx seshy-wrapped — a year-in-review (or week-in-review) card generated entirely from the session logs coding agents already keep on disk. Claude Code, Codex, Gemini CLI, and OpenCode sources; six themes, four cuts; ANSI summary box for screenshots; a ready-to-paste post line.

Why it can be trusted

• One canonical single-pass pipeline (collect()) — every card, theme, and cut renders from the same stats object; nothing downstream recounts anything.
• Deterministic by construction: stable file ordering, sorted-key serialization, no wall-clock fields. CI diffs two full runs byte-for-byte.
• Every stat's exact pattern is documented in STATS.md for auditors.
• 100% local: no network calls, no telemetry, no account.

Test surface

14 tests across golden fixtures (hand-verified counts, byte-exact against committed golden), a determinism suite, and edge cases (zero sessions, corrupt lines, model filter misses, sqlite-backed OpenCode, unknown-flag rejection). Node 20/22/24 matrix in CI plus the double-run diff gate.

Also here

• Go shim: seshy wrapped execs npx seshy-wrapped.
• Launch playbook (MARKETING.md) — kept on the branch deliberately.
• Demo renders from synthetic fixtures only (demo/demo.sh).