docs: update manifest + EXPLAINME for CLI consumer + package

- 0-AI-MANIFEST.a2ml: status → 2026-04-14, 4 ABI modules, Julia pkg,
  CLI consumer section, updated HOW TO RUN
- EXPLAINME.adoc: mark both post-experiment items ✓, add new file
  entries (VCLProtocol.idr, Verisim.jl, vcl_server.jl, ffi/zig/),
  update run commands, add Phase 6 refactor note

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: hyperpolymath

verisim-modular-experiment/0-AI-MANIFEST.a2ml

@@ -14,13 +14,15 @@ VCL consonance guarantees.
 the paved-road deployment. This experiment is a falsifier that produced
 a positive result: the octad IS divisible.
 
-## CURRENT STATUS (2026-04-05)
+## CURRENT STATUS (2026-04-14)
 
 - **Experiment status**: CLOSED with positive result. All 5 phases complete.
 - **Path B**: runtime-confirmed. Core = {Semantic, Temporal, Provenance}.
-- **Tests**: 145/145 green across 6 Julia test suites.
-- **Idris2 ABI**: 3 modules typecheck clean in Idris2 0.8.0.
-- **Overall completion**: 100% (research prototype).
+- **Tests**: 145/145 green across 6 Julia test suites (via `just test` / `Pkg.test()`).
+- **Idris2 ABI**: 4 modules typecheck clean (Types, VerisimCore, FederationContract, VCLProtocol).
+- **Julia package**: `Verisim` — `src/Verisim.jl`, `Project.toml v0.1.0`, `test/runtests.jl`.
+- **CLI consumer**: Zig binary (`ffi/zig/`) + Julia server (`src/vcl_server.jl`). 4/4 Zig unit tests green.
+- **Overall completion**: 100% (research prototype + consumer).
 
 ## KEY FINDING
 
@@ -47,6 +49,22 @@ projection, Ed25519 attestation, coherence surface, LWW conflict resolution).
 - `Types.idr` — 8-shape enum + Core/Federable/Conditional classification
 - `VerisimCore.idr` — identity-core ABI (enrich, attest, verify)
 - `FederationContract.idr` — 5-clause contract + IsFederable predicate
+- `VCLProtocol.idr` — CLI stdio wire protocol (VCLQuery, VerdictResult, WellFormedExchange, A2ML framing constants)
+
+### Julia Package: `src/Verisim.jl`
+
+Package module. Loads impl files into `Main` via `Base.include`; exposes thin
+delegators: `prove`, `parse_vcl`, `Store`, `Manager`, `OctadId`, `SemanticBlob`,
+`enrich!`, `get_core`, all ProofClause constructors, Tropical types.
+
+### CLI Consumer: `ffi/zig/` + `src/vcl_server.jl`
+
+- `ffi/zig/src/verisim_cli.zig` — Zig 0.15 binary. Spawns Julia child process,
+  pipes queries in, reads A2ML verdicts out. Subprocess = OS process isolation.
+  No libjulia embedding. `VERISIM_PACKAGE_PATH` env override; default: 4 dirs up.
+- `src/vcl_server.jl` — Julia server script. Read by `julia --project=<pkg>`.
+  Shared `Store`+`Manager` across session. Emits `[vcl-verdict]` A2ML blocks.
+- Build: `just cli-build-release` | Test: `just cli-test` | Query: `just cli-query "..."`
 
 ### Julia Reference Implementation: `impl/`
 
@@ -81,11 +99,18 @@ projection, Ed25519 attestation, coherence surface, LWW conflict resolution).
 ## HOW TO RUN
 
 ```bash
-# Idris2 ABI
+# Idris2 ABI (4 modules)
 idris2 --build verisim-modular-experiment.ipkg
 
-# Julia test suites (6 files, 145 assertions)
-for f in test/*.jl; do julia --project=. $f; done
+# Julia package test suite (145 assertions, 6 suites)
+just test                    # or: julia --project=. -e 'using Pkg; Pkg.test()'
+
+# Zig CLI unit tests
+just cli-test
+
+# Build + run a VCL query end-to-end
+just cli-build-release
+just cli-query "PROOF INTEGRITY FOR abababababababababababababababababab"
 ```
 
 ## LIFECYCLE HOOKS

verisim-modular-experiment/EXPLAINME.adoc

@@ -48,16 +48,23 @@ the same data.
 == How do I run it?
 
 ```bash
-# Idris2 ABI — typechecks 3 modules
+# Idris2 ABI — typechecks 4 modules (includes VCLProtocol.idr)
 idris2 --build verisim-modular-experiment.ipkg
 
-# Julia reference implementation — 70 assertions across 3 suites
-julia --project=. test/test_verisim_core.jl
-julia --project=. test/test_federation_parity.jl
-julia --project=. test/test_seams.jl
+# Julia package test suite — 145 assertions across 6 suites via Pkg.test()
+just test
+
+# Zig CLI unit tests (verdict parser + protocol invariants)
+just cli-test
+
+# Build the Zig CLI binary
+just cli-build-release
+
+# Send a VCL query through the full CLI → Julia pipeline
+just cli-query "PROOF INTEGRITY FOR abababababababababababababababababab"
 ```
 
-Requirements: Julia 1.12+, Idris2 0.8.0, libsodium (auto-fetched via Sodium.jl).
+Requirements: Julia 1.10+, Idris2 0.8.0, Zig 0.15+, libsodium (auto-fetched via Sodium.jl).
 
 == Where is everything?
 
@@ -75,7 +82,16 @@ Requirements: Julia 1.12+, Idris2 0.8.0, libsodium (auto-fetched via Sodium.jl).
 |Central + subordinate proof obligations, and what's discharged.
 
 |`src/Abi/`
-|Idris2 ABI definitions — `Types.idr`, `VerisimCore.idr`, `FederationContract.idr`.
+|Idris2 ABI definitions — `Types.idr`, `VerisimCore.idr`, `FederationContract.idr`, `VCLProtocol.idr` (CLI stdio wire protocol).
+
+|`src/Verisim.jl`
+|Julia package entry point. Loads all impl modules into `Main` via `Base.include`, exposes thin delegators.
+
+|`src/vcl_server.jl`
+|Julia stdio server for the CLI consumer. Spawned by the Zig binary; reads VCL from stdin, proves via `Verisim` package, emits A2ML verdicts.
+
+|`ffi/zig/`
+|Zig CLI binary (`verisim`). Spawns `vcl_server.jl` as a subprocess; pipes queries through; forwards A2ML verdicts to stdout. `build.zig`, `build.zig.zon`, `src/verisim_cli.zig`.
 
 |`impl/`
 |Julia reference implementation — `VerisimCore.jl`, `FederationManager.jl`,
@@ -133,9 +149,10 @@ All 5 phases + 3 deferred items complete. **Experiment closed, Path B confirmed.
 
 Open post-experiment work (not blocking):
 
-* Promote `impl/` to shippable `verisim-core` sibling package.
-* Zig FFI port of VerisimCore per hyperpolymath standard.
+* ✓ **Package**: `impl/` promoted to shippable `Verisim` Julia package (`src/Verisim.jl`, `Project.toml`, `test/runtests.jl`).
+* ✓ **CLI consumer**: `ffi/zig/` — Zig binary + `src/vcl_server.jl` Julia server + `src/Abi/VCLProtocol.idr` Idris2 ABI. Subprocess architecture (OS-level isolation per estate priority order). 4/4 unit tests green.
 * Formal Idris2-type-level non-interference proof at arbitrary N.
+* **Phase 6 refactor** (optional): migrate `impl/` from flat-include scaffold to proper Julia `src/` with `using ..Sibling` — removes `Main.X` cross-references and `Base.include(Main, f)`.
 
 == What if the result had been negative?