writeonce/reference/README.md

reference/ — archived for reference

Source material preserved alongside the active codebase. Nothing here is on the build path of the root workspace.

reference/crates/ — v1 writeonce blog

The original writeonce blog engine: 13 Rust crates implementing a flat-file content store, three sidecar indexes, a minimal HTTP server, and an .htmlx template layer.

Crate	Responsibility
wo-model	Article domain type + content loader
wo-seg	Append-only .seg binary file format (~475 LOC)
wo-index	title.idx, date.idx, tags.idx sidecar indexes
wo-store	Composes seg + indexes, exposes the query API
wo-watch	inotify-driven content ingest
wo-event	Domain event type
wo-sub	Subscription layer (pre-engine-native LIVE)
wo-rt	v1 runtime glue
wo-http, wo-route, wo-serve	HTTP server
wo-htmlx	.htmlx template engine
wo-md	Markdown rendering

It is a nested workspace. Build or test it standalone:

cd reference/crates
cargo build
cargo test

See docs/runtime/database/07-wo-seg-migration.md for the plan to replace these crates with the new .wo runtime at crates/wo-rt/ via phased coexistence. The v1 codebase is the source that migration reads from.

reference/writeonce-api/ and reference/writeonce-app/

Earlier exploration snapshots that predate the v1 crates. Self-contained; no active build wiring.