docs: the Windows port, its inventory struck, its test record and the As built block (P11c)
packaging.md: each row of the Unix-only inventory is struck with where it landed. architecture.md: the local transport and the Windows arms. testing.md: the P11c record with its For-P12 paragraph (R-G); every Windows test is marked unrun until the first Windows job. README.md: the Windows caveat is now "from a source build, not packaged". served.md: the unit's As built block (field 8). 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
1c3a48899d
commit
2baadb7482
5 files changed
+121
-15
No files matched your search
@@ -248,6 +248,29 @@ request (its task, or while it holds the guard) sets `stopped`, and every
|
||||
later request, on every session, is refused until a restart, which
|
||||
re-verifies the journal.
|
||||
|
||||
## The local transport and the Windows arms (`ledger-mcp::ipc`, `ledger-store::winsec`, P11c, D-62)
|
||||
|
||||
The books server, the host and everything that talks to them meet on
|
||||
channels only this account can open (plan 3.9). `ledger_mcp::ipc` is the
|
||||
one seam: `Endpoint` (a socket in the root's `run/` on Unix; the pipe
|
||||
`\\.\pipe\wanderbooks-<hash of run/>-<name>` on Windows), `Listener`
|
||||
(`bind`, `accept`), `connect` and `connect_std` (blocking, with a read
|
||||
limit), the `Peer` trait (`peer_is_us`: the effective uid on Unix; the
|
||||
user SID of the process at the other end of the pipe on Windows), and
|
||||
`stop_signals`. No other file names a socket or a pipe, a peer check or a
|
||||
signal. HTTP to the server goes through `ledger_host::channel::http_builder`
|
||||
(reqwest's Unix socket or named pipe).
|
||||
|
||||
`ledger_store::winsec` (Windows only) holds the rest of the Windows FFI:
|
||||
the owner-only DACL (`set_owner_only`, `is_private`), the account's SID,
|
||||
the shell's known folders, `MoveFileExW` for the move that must not
|
||||
replace, and the pipe process ids. `ledger_store::lock` is the one file
|
||||
lock seam (std's, which is `flock` and `LockFileEx`). `seccomp` and
|
||||
`close_range` remain Linux-only, doing nothing elsewhere (D-32). Windows
|
||||
CI is the evidence for every arm that cannot run on the Linux machines
|
||||
that wrote it; `cargo check --target x86_64-pc-windows-msvc` (the target is
|
||||
pinned in `mise.toml`) type-checks them, clippy included.
|
||||
|
||||
## bookspec (`bookspec/`, P13)
|
||||
|
||||
bookspec is the formal accounting specification (D-34): every rule stated
|
||||
|
||||
Reference in new issue
Block a user