Skip to content

Architectural Decisions

ADRs (Architecture Decision Records) capture the rationale behind binoc's design — including alternatives that were considered and rejected. They are the canonical long-form record of the project's reasoning.

Newer entries appear first. Each entry shows its date and current status. Create a new ADR with just adr <title>. See the Documentation platform ADR for how this index is produced and how ADRs fit into the docs site.

Date Title Status
2026-04-17 Documentation Platform and Information Design Proposed
2026-04-16 Transient Fields Are Wire-Visible; Output Stripping Is a Boundary Concern Implemented
2026-04-16 Transformer dispatch: bottom-up by default, Root for tree-wide walkers Implemented
2026-04-16 Test vector materialization: plugin trait, not a runtime plugin point Implemented
2026-04-16 Opportunistic ItemRef Metadata, Transformer-Hydrated for Correlation Implemented
2026-04-10 Security posture and how to audit Binoc (core and plugins) Accepted
2026-04-10 Rust MSRV and dependency update policy Implemented
2026-04-10 Independent release tags and published version policy Implemented
2026-04-08 Release Surface And Automated Publishing Implemented
2026-03-20 Transformer Dispatch Refinement Implemented
2026-03-20 Transformer Composition and Artifact Flow Implemented
2026-03-19 Published artifacts for cross-plugin composition Implemented
2026-03-18 Terminology Accepted
2026-03-12 Plugin SDK, ABI Safety, and Native Plugin Loading Implemented
2026-03-09 Test Vector Root Defaults and Plugin Test Vectors Implemented
2026-03-09 Standard Library Boundary Policy Accepted
2026-03-09 Shared Test-Vector Harness for Plugins Implemented
2026-03-09 Per-Renderer Config and Significance as a Renderer Concern Decided (implemented)
2026-03-09 Output Routing and CLI UX Implemented
2026-03-09 Deferred Performance Optimizations Decided (not pursuing)
2026-03-06 just as the Canonical Task Runner Implemented
2026-03-06 Tutorial Regeneration Is a Build Step, Not a Test Implemented
2026-03-06 Plugin Discovery and the Rust/Python Boundary Implemented
2026-03-05 Snapshot Testing for Test Vectors Implemented
2026-03-05 Provenance Tracking and the Extract Chain Implemented
2026-03-05 Media Type Detection and Content-Aware Dispatch Implemented (phase 1)
2026-03-05 Full Comparison Tree and Content Hash Propagation Implemented
2026-03-05 Cross-Phase Data Cache in CompareContext Superseded by Published artifacts for cross-plugin composition