Design sources and decisions
August 19, 2026 ยท View on GitHub
dsh-showcase deliberately builds on documented community contracts.
DeepSeek Harness
- Event-sourced session types
- Packed chunk codec
- JSONL persistence format
- Concatenated Zstandard framing
- Official export ZIP layout
The Zstandard frame scanner is adapted from the MIT-licensed upstream implementation; attribution is retained in source and in ../THIRD_PARTY_NOTICES.md.
CLI and documentation conventions
- Command Line Interface Guidelines informed stdout/stderr separation, composable stdin, examples-first help, and stable exit status.
- Prettier CLI informed explicit write/overwrite behavior.
- Wrangler informed quick-start-first documentation and precise runtime requirements.
- Vercel ai-cli informed machine-clean
--jsonoutput and agent-oriented examples. - AGENTS.md and llms.txt define the two agent entry points used here.
Visual storytelling references
- VHS demonstrates deterministic, code-defined demo rendering.
- Terminalizer demonstrates editable event timing and README-oriented animation output.
- asciinema demonstrates a small event-stream model; no GPL code is used.
Unlike terminal recorders, dsh-showcase renders semantic DSH events. Unlike replay/debugging viewers, it selects a small launch-ready narrative and produces fixed artifacts suitable for GitHub.