Skip to content

Commit f271f7a

Browse files
claudehyperpolymath
authored andcommitted
docs(readme): add Status section, de-dupe Architecture heading, align framework framing with D1
Status section points to docs/PROOFS.adoc + the crypto-integrity caveat (issue #39). Rename the stray duplicate '== Architecture' (after License) to 'Topology & Dashboard'. Reframe the ochrance-framework relationship per D1 (ochrance = canonical core; framework's earlier duplicate core retired), dropping the inaccurate 'not duplicates' line and the stale completion percentages. https://claude.ai/code/session_011z2t8zAxfcCNLJzU7YdpBQ
1 parent 3183b22 commit f271f7a

1 file changed

Lines changed: 14 additions & 4 deletions

File tree

README.adoc

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,16 @@ v0.1.0, 2026-02-06
1414
* **Linear type repair** - Filesystem repair operations that prevent use-after-repair bugs
1515
* **ECHIDNA integration** - Neural proof synthesis for automated verification
1616

17+
== Status
18+
19+
Formal verification is **in progress** — see link:docs/PROOFS.adoc[`docs/PROOFS.adoc`]
20+
for the authoritative, dependency-sorted plan and the currently-proven surface
21+
(combiner-generic Merkle soundness, A2ML parser totality, manifest round-trip,
22+
progressive assurance). *Cryptographic integrity is not yet claimed*: the real
23+
BLAKE3 / SHA-256 / SHA3-256 / Ed25519 lives in the Zig FFI, but the Idris-side
24+
stub fallbacks must be removed and `libochrance.so` linked into the verification
25+
flow first (issue #39).
26+
1727
== Architecture
1828

1929
[source]
@@ -70,10 +80,10 @@ The framework defines the broader `VerifiedSubsystem` interface and four planned
7080
modules (Filesystem, Memory, Network, Crypto). This repo (`ochrance`) provides the concrete,
7181
working implementation of the Filesystem module using Idris2 dependent types and Zig FFI.
7282

73-
The two repos are **complementary**, not duplicates:
83+
The two repos are **complementary**:
7484

75-
* **ochrance** (this repo) — concrete filesystem verification implementation (~80% complete)
76-
* **ochrance-framework** — abstract modular framework for all four subsystems (~10% complete)
85+
* **ochrance** (this repo) — the canonical core: concrete filesystem verification with the machine-checked proofs and the Zig crypto FFI.
86+
* **ochrance-framework** — the architecture / specification layer (the `VerifiedSubsystem` interface and the four planned subsystem modules). Its earlier duplicate core is retired in favour of this repo's (decision D1).
7787

7888
=== valence-shell & echo-types (Reversibility Stack neighbours)
7989

@@ -94,6 +104,6 @@ SPDX-License-Identifier: MPL-2.0
94104
Copyright (C) 2026 Jonathan D.A. Jewell. All rights reserved.
95105

96106

97-
== Architecture
107+
== Topology & Dashboard
98108

99109
See link:TOPOLOGY.md[TOPOLOGY.md] for a visual architecture map and completion dashboard.

0 commit comments

Comments
 (0)