Contributing

Who This Is For

cochranblock is the production site of The Cochran Block, LLC. External contributions are welcome but narrowly scoped — bug fixes, documentation, and improvements that align with the zero-cloud, single-binary philosophy.

Before You Start

Read Proof of Artifacts and Timeline of Invention first. They tell you what exists and why decisions were made.

Code Style

All handlers follow the token-optimized pattern documented in Code Style. New handlers get the next available fNN number. No exceptions.

Provenance Requirement

Every substantive contribution requires a Timeline of Invention entry with:

• Date
• What was built
• AI Role field (none / assisted / generated / reviewed)
• Commit hash

This is a legal requirement, not a preference. See Provenance.

Supply Chain

Run cargo audit before any PR. Zero unignored advisories required.

cargo audit

Header Protocol

All .rs, .toml, .md, .sh files must have the Unlicense + Contributors header. After editing, run:

cargo run -p header-writer -- cochranblock

Contributors

See CONTRIBUTORS.md.

_{▸ THE COCHRAN BLOCK, LLC · CAGE 1CQ66 · UEI W7X3HAQL9CF9 · UNLICENSE · cochranblock.org}