logicsrc/docs
Anthony Ettinger 9f42ce222a
docs: OpenStream benchmark reports, published per release (#150)
Adds a reports section to the OpenStream spec so its claims rest on a
reproducible measurement rather than an assertion. Each report is a run of
the envelope over a defined corpus on real hardware: proof that
decompression restores every byte, that an incompressible input costs only
the framing overhead, that a compressible one saves what it claims against
the complete wire size, and how long each codec takes.

- docs/openstream/reports/ holds a machine-readable <id>.json (canonical,
  with a versioned schema) and a rendered <id>.md per report, plus a README
  on the shape and on submitting one. The seed report is nixamp 0.17.1 over
  the synthetic corpus, labelled synthetic so no one reads a padded-fixture
  number as production.
- The site renders them at /docs/openstream/reports (index) and
  /docs/openstream/reports/<id> (one report), under the dynamic /docs/[slug]
  tree so the reports routes never shadow a spec's own doc page. A small
  lib/reports.ts reads the JSON at build time; REPORTED_SPECS keeps the
  route surface explicit. sitemap includes the index and every report.
- The spec doc gains a Benchmark reports section linking there, and repeats
  the honest caveats: OpenStream frames Zstandard and gzip rather than being
  a new algorithm, synthetic padding flatters a codec, an efficient real
  feed saves little, and round-trip exactness is the one pass/fail.

The report format is produced by `nixamp compression benchmark` (in the
nixamp repo); a release runs it and commits the two files here.


Claude-Session: https://claude.ai/code/session_01MxNif5tsYq4LczgG7aE8Jp

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-12 06:23:46 -07:00
..
opencontext Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
opencreds Add the LogicSRC OpenCreds specification (#140) 2026-08-29 04:11:38 -07:00
openprd Add Tech Stack and Monetization sections to OpenPRD (0.3) (#144) 2026-09-06 16:50:11 -07:00
openstream/reports docs: OpenStream benchmark reports, published per release (#150) 2026-09-12 06:23:46 -07:00
openswarm Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -07:00
agent-screening.md Add AgentByte screening plugin spec 2026-06-06 15:54:08 +00:00
agentad-marketplace.md feat(agentad): AgentAd Marketplace PRD + reference exchange (M5) 2026-07-01 10:29:36 +00:00
agentad.md feat(agentad): AgentAd Marketplace PRD + reference exchange (M5) 2026-07-01 10:29:36 +00:00
agentgit.md Add AgentGit M1: agent-native git layer over a Forgejo backend 2026-06-14 15:15:06 +00:00
agentstack.md feat(agentstack): add @logicsrc/agentstack coordination module (#5) 2026-06-10 16:39:32 -07:00
ans-sdk.md docs(ans): spec the @logicsrc/ans TypeScript SDK 2026-06-24 14:41:00 +00:00
arcade.md Add waiting arcade MVP 2026-06-06 22:09:22 +00:00
asdlc.md Add ASDLC, the Agentic Software Development Lifecycle 2026-09-06 15:02:31 +00:00
cli.md Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
communication-accounts.md Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
config.md fix(credentials): one vault per user, in the config dir (#119) 2026-07-31 22:53:17 -07:00
credential-sharing.md Add SSH keys and config to credential sharing (#139) 2026-08-13 17:03:00 -07:00
data-model.md Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
openapi.yaml Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
opencontext.md Add the LogicSRC OpenContext specification (#132) 2026-08-09 11:46:11 -07:00
opencreds.md Add the LogicSRC OpenCreds specification (#140) 2026-08-29 04:11:38 -07:00
openjob.md docs: OpenJob and OpenResume.md (#148) 2026-09-08 16:16:05 -07:00
openontology-governance.md feat(openontology): implement OpenOntology Phase 0 + local engine and CLI (#99) 2026-07-26 02:10:13 -07:00
openontology-interoperability.md feat(openontology): Phase 2 + Phase 3 — storage, REST/SSE, MCP, RDF/SHACL, adapters, TUI, explorer (#101) 2026-07-28 05:10:33 -07:00
openontology.md feat(openontology): Phase 2 + Phase 3 — storage, REST/SSE, MCP, RDF/SHACL, adapters, TUI, explorer (#101) 2026-07-28 05:10:33 -07:00
openprd.md Add Tech Stack and Monetization sections to OpenPRD (0.3) (#144) 2026-09-06 16:50:11 -07:00
openresume.md docs: OpenJob and OpenResume.md (#148) 2026-09-08 16:16:05 -07:00
openspec-comparison.md feat(agentstack): add @logicsrc/agentstack coordination module (#5) 2026-06-10 16:39:32 -07:00
openstream.md docs: OpenStream benchmark reports, published per release (#150) 2026-09-12 06:23:46 -07:00
openswarm.md Add pay2seed, paid2seed, pay2stream and paid2stream to the OpenSwarm family (#143) 2026-09-05 19:12:45 -07:00
permissions.md Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
plugins.md Add AgentGit M1: agent-native git layer over a Forgejo backend 2026-06-14 15:15:06 +00:00
positioning.md Add credential sharing openspec 2026-06-06 18:47:41 +00:00
roadmap.md Add communication account plugin scaffolds 2026-06-09 10:02:07 +00:00
tui.md Add waiting arcade MVP 2026-06-06 22:09:22 +00:00