docs: the 2026-10-28 drift review; the plan, status and docs brought to date
check / check (push) Canceled after 0s
two-user / two-user (push) Canceled after 0s

The planning session read plan/served.md, every design document and the
five branches the owner paused on 2026-10-27 against main (44ee4083),
with dry-run merges touching no branch. plan/2026-10-28_DRIFT_REPORT.md
lists every divergence and judges every recorded departure (all kept;
three owed back; one needs a decision: P6 made ledger-store depend on
ledger-import).

The plan: section 0 "What changed on 2026-10-28"; 8.0.1 and the unit
Status lines name S4.4, S5, S6, S7 and P6 as built but unmerged; 8.0.2
records the destination (D-56: the installed app, P11a starts now) and
the resume order with the known conflicts (the shared documents.rs
test file, the types.rs appends, P6 retaking schema 18, the law numbers
34 to 37); 8.0.3 lists the names the EM approved during the wave; P11a
gains step 0 (the macOS and Windows keyring stores, the Windows data
root and pipes, a cross-platform CI build: today the agent path runs on
Linux alone); Q-5 is due and Q-8 asks whether D-47 to D-54 stand; the
Landlock sentences in section 2 and server.toml are struck.

STATUS.md and HANDOFF.md say where things stand and how to resume;
roadmap.md and gui.md are rewritten to today. The docs lose their
stale facts: 122 tools, 2,700 tests, the parity floor at 21 with the
P4b notes the slices never wrote, the ten crates and their dependency
graph (jiff added to the core's allowed list), the cutover of
2026-10-20 recorded in capability-parity.md and parallel-run.md, the
P4b S1 law and its two Kani harnesses added to verification.md (law
34), the proof counts (51 and 9), and README, the site and install.sh
honest about macOS (the viewer runs; connecting an agent waits for
P11a's keyring store, and the installer now says so instead of failing).

just check on main at 44ee4083: exit 0 (167 suites, 2,871 passed, 0
failed, 7 ignored, the server-only build clean). No code changed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HS8WZziDnyxunC23MUxrLp
This commit is contained in:
swaitsandClaude Fable 5.1 committed 2026-10-28 18:26:23 -06:00
1 parent 44ee408312
commit af553a3706
21 files changed
+662 -220

No files matched your search

+42 -2
View File
@@ -479,6 +479,44 @@ one kernel function, `kernel::unrecovered_cost`:
`unrecovered_cost_only_for_on_spec_and_never_negative`. No Lean model:
the function is one subtraction and a `max`.
### Documents and their control accounts (P4b S1, D-45)
**Law 34. A control account is its documents.** For a receivables or
payables account A and any day D, the account's balance on D equals the
sum over documents of `outstanding(d, D)` (the signed sum of the lines
tagged with d and dated on or before D, whatever their entries' standing:
a reversal's mirror carries the same tag and cancels) plus the legacy
untagged lines that still stand. A document never owes less than nothing
or more than its total on any day a payment path or a reversal touches
it. Rule: `docs/spec/rules.md` B-38.
- Kernel: `kernel::running_bounds(total, deltas)` and
`kernel::bounds_kept(total, before, after)` decide, at every date in
date order, whether 0 ≤ outstanding ≤ total holds; `Ledger::
check_item_bounds` runs them on the documents a step touches. Kani:
`bounds_check_matches_definition` (the check equals the definition on a
symbolic sequence of deltas) and
`bounds_kept_is_the_definition_on_books_in_bounds` (on books already
within bounds, `bounds_kept` is exactly the definition over the new
deltas), both with covers reaching a refused and an accepted sequence.
Bridge: `crates/ledger-store/tests/bounds.rs` and the properties in
`crates/ledger-store/tests/arap_props.rs` (`subledger_equals_control`
after every operation, at every date; `status_is_a_function_of_journal
_and_date`; `reversal_twice_restores_state`).
- Lean, `verify/lean/Wanderbooks/Documents.lean`: `control_agrees` and
`control_agrees_through` (the identity, for every account and through
every day), `Step.document_unattached` (an untagged legacy line only
grows `unattached`, never a document), `Step.reverse_moves` and
`reverse_twice` (a reversal moves exactly the opposite of its tagged
lines from its date; reversing it restores them),
`Reachable.control_is_documents` (the identity on every reachable
book). Listed in `Audit.lean`; standard axioms only.
- Laws 35 to 37 are taken, in the order the paused branches merge, by
S5 (`Step.markSent`: a send changes no figure), S6
(`settle_is_exact`: a settlement's cash, discounts and fee are exact)
and S7 (`writeOff_within_bounds`); the branches wrote 34 and are
renumbered at merge (`plan/served.md` 8.0.2).
### Payment terms and document lines (P4b S4.1)
Payment terms (rules.md B-39) give a due date and a discount date by
@@ -660,8 +698,8 @@ Lean carrying any weights.
```sh
mise install # once: Kani, Lean, and the rest, pinned in mise.toml
just prove # 48 Kani harnesses and Lean
just prove-slow # the other 8: the justfile's kani_slow
just prove # 51 Kani harnesses and Lean
just prove-slow # the other 9: the justfile's kani_slow
just prove-all # both
```
@@ -766,4 +804,6 @@ each harness's whole run, its compile of about 50 s included):
| `unrecovered_cost_laws` | 32 | prove | 0 |
| `discount_max_is_bounded` | 33 | prove-slow | 163 |
| `line_amount_is_exact` | 33 | prove | 6 |
| `bounds_check_matches_definition` | 34 | prove | (not in the 2026-10-22 run; P4b S1, 2026-10-24) |
| `bounds_kept_is_the_definition_on_books_in_bounds` | 34 | prove | (as above) |
| `kani_symbolic_copy_canary` | (the checker: "Trusting the checker") | prove | 3 |