Fork scaffold: substrate subtree, provenance register, dual-license notice (ADR-011/012/013/018, task fork-substrate-scaffold)

alkstore-sqlite/src/substrate/mod.rs

@@ -0,0 +1,40 @@
+//! The substrate: the SQLite storage machinery forked from honker-core
+//! (dual-licensed MIT OR Apache-2.0, third-party upstream —
+//! github.com/russellromney/honker), carried in-tree as a bounded
+//! module subtree of `alkstore-sqlite` per
+//! ADR-013 (docs/architecture/decisions/013-fold-substrate-into-sqlite.md).
+//!
+//! Fork point: honker-core @ `f4e53c6` (`/workspace/honker`, package
+//! `node-v0.5.1-10-gf4e53c6`; full commit
+//! `f4e53c6b83ad2d6979c04098d576db024ce7e98d`). The reference checkout
+//! remains the source for cherry-pick candidates and differential
+//! testing — no dependency, no wiring (ADR-012 §6).
+//!
+//! Boundary (ADR-012 §2): this module is contract-blind storage
+//! machinery. It depends on nothing of ours — no `alkstore` core
+//! types, no contract traits, no error taxonomy. Its API takes and
+//! returns primitives; the engine layer above resolves contract
+//! semantics into primitive arguments and maps substrate outcomes into
+//! the contract taxonomy. Nothing here is re-exported through the
+//! engine crate's public API. The fork point, every deliberate
+//! divergence, and any future cherry-pick are recorded in the
+//! provenance register (`PROVENANCE.md`, this directory; ADR-018).
+//!
+//! Fidelity posture (ADR-012 §3): where scope *keeps* upstream
+//! machinery, upstream's module structure and internal function names
+//! survive — lineage tokens included — so future cherry-picks from the
+//! upstream fix train stay diffable. The re-derived half (the queue
+//! ops) is new code with contract-derived names.
+//!
+//! Runtime posture (ADR-012 §4): the substrate stays sync. The bridged
+//! seam at the engine layer remains the async story.
+//!
+//! License: upstream MIT OR Apache-2.0 — the bundled notice (`LICENSE`,
+//! this directory) is the preservation obligation's carrier;
+//! provenance register: [`PROVENANCE.md`](PROVENANCE.md).
+//!
+//! Scaffold state: this module is intentionally empty of machinery.
+//! The port tasks (`fork-port-connection-watcher`,
+//! `fork-rederive-queue-ops`) land the forked lineage and the
+//! re-derived queue ops here; the register and the license notice are
+//! already in place so the ports land into a finished frame.