docs: the 2026-10-28 drift review; the plan, status and docs brought to date
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 at44ee4083: 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:
1 parent
44ee408312
commit
af553a3706
21 files changed
+662
-220
No files matched your search
+42
-2
@@ -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 |
|
||||
Reference in new issue
Block a user