alkstore/tasks/fork-substrate-scaffold.md

id, name, status, depends_on, scope, risk, impact, level, tags

id	name	status	depends_on	scope	risk	impact	level	tags
fork-substrate-scaffold	Fork scaffold — substrate subtree, provenance register, licenses	completed	scaffold-workspace	narrow	low	component	implementation	wave-2 substrate

Description

Create the fork's home and its provenance apparatus before any code moves (ADR-011, ADR-012 §1 as amended by ADR-013, ADR-018):

• alkstore-sqlite/src/substrate/ module subtree, wired into the engine crate's module tree (mod substrate; — internal, never re-exported through the engine's public API; ADR-012 §2's contract-blind boundary starts structurally).
• PROVENANCE.md at the subtree root per ADR-018: upstream identity (honker-core, checkout /workspace/honker @ f4e53c6, package node-v0.5.1-10-gf4e53c6), license (MIT OR Apache-2.0), the fork decision citation (ADR-011), and the empty delta register structure (per-delta, category-tagged entries — the categories ADR-018 pins; the port deltas of fork-port-deltas are the first entries).
• The dual-license notice carried in-tree (MIT OR Apache-2.0 text, per ADR-012 §1's scaffold-time list).
• The substrate's Cargo.toml-independent posture: the subtree compiles as engine-crate modules; its dependencies (rusqlite) come from the engine crate's manifest.

This task moves no machinery — it establishes where the fork lives, who it is, and how its lineage is tracked, so the port tasks land into a finished frame.

Acceptance Criteria

• src/substrate/ exists, wired as an internal module, empty or stub content only
• PROVENANCE.md complete per ADR-018 (identity, revision, license, decision citation, delta-register structure)
• Dual-license notice in-tree
• Engine crate still compiles; clippy/fmt clean

References

• docs/architecture/decisions/011-sqlite-substrate-fork.md
• docs/architecture/decisions/012-forked-substrate-design.md §1
• docs/architecture/decisions/013-fold-substrate-into-sqlite.md
• docs/architecture/decisions/018-provenance-register-and-cherry-picks.md

Notes

• PROVENANCE.md initial entries are pre-declared checklist rows, not verified records. ADR-018 §2 fixes the scaffold's initial entries as the retained records' deltas (ADR-011 scope register + ADR-012 §4–§5), but the machinery they describe does not exist yet — the port tasks make it. Writing "planned but verified-later" rows would misrecord the tree state, so the register carries the delta list as the port tasks' checklist (16 entries, D-01..D-16, each with category/what/where/why/lineage), and fork-provenance-and-floor completes/verifies them against the actually-ported tree at gate time. The register's header states this explicitly. Cherry-picks section: empty, append-only.
• Entry granularity decision: the standing classes of ADR-018 §2 are written in entries as port delta / re-derivation / drop / hygiene / cherry-pick. ADR-018's prose names them ("kept-half port delta", etc.); nothing pins a token format. Wave 2's later entries should match these tokens.
• W-3/W-4 recorded as rows, not prose. ADR-012 §4 records W-3 (not-actionable) and W-4 (keep-RW) as decisions-of-record; the register carries them as port delta rows whose What states the deliberateness (row D-08/D-09), so the "no unregistered divergence" audit has a row to tie them to.
• Module wiring is mod substrate; with no re-export — ADR-012 §2/§6's contract-blind boundary starts structurally (the module's contents are currently only doc text; the port adds machinery). The module docs in mod.rs carry the fork-point statement and boundary statement (the alksocks module-docs shape).
• Bundled LICENSE composition: fork-point + attribution header (alksocks src/rfc1928/LICENSE shape, adapted: dual-license upstream, copyright Russell Romney, fork decision cites ADR-011/013) followed by the verbatim upstream LICENSE-APACHE and LICENSE-MIT texts from /workspace/honker/honker-core @ f4e53c6.
• Full upstream commit hash pinned in both PROVENANCE.md and the LICENSE header: f4e53c6b83ad2d6979c04098d576db024ce7e98d (2026-10-02) — verified against the reference checkout's git log; git describe confirms the package name node-v0.5.1-10-gf4e53c6 cited in the ADRs.

Summary

Fork scaffold landed: alkstore-sqlite/src/substrate/ created with mod.rs (fork-point statement, contract-blind boundary statement, fidelity + sync runtime postures, scaffold-state note — internal module, mod substrate;, nothing re-exported through the engine's public API), PROVENANCE.md per ADR-018 (upstream identity: honker/honker-core @ f4e53c6 = f4e53c6b83ad2d6979c04098d576db024c e7e98d, package node-v0.5.1-10-gf4e53c6, published lineage 0.5.0 2026-08-23, license MIT OR Apache-2.0, fork-point git-history statement, inherited fix-train lineage facts, reference-checkout posture; delta register: 16 pre-declared checklist entries D-01..D-16 pinning the port deltas, drops, re-derivation, and hygiene deltas the port tasks will make, cherry-picks section empty) — and the bundled dual-license LICENSE (attribution header + verbatim Apache-2.0 and MIT texts). Verified: cargo build, cargo test -p alkstore-sqlite, cargo clippy --all-targets -- -D warnings, cargo fmt --check all clean.