Skip to content

Commit 32a921d

Browse files
Document external AD proof backend setup
1 parent fdece52 commit 32a921d

3 files changed

Lines changed: 57 additions & 1 deletion

File tree

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,3 +105,8 @@ named command. The activation gate opens only when the boundary manifest is
105105
valid, the backend probe is production-ready, and the probed command matches
106106
the manifest `commandRef`. This repo still does not execute proof jobs or hold
107107
proof credentials.
108+
109+
`gatl-ad-proof-backend` is now the standalone v0.1 command that satisfies this
110+
external command boundary. It validates derivative golden fixture intake and
111+
emits an external AD proof result, but it reports `validated-not-proved` until
112+
real proof-term checking is implemented.

docs/architecture.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,11 @@ make that external boundary explicit:
5050
The gate is a deployment handoff artifact. It does not execute proof jobs,
5151
manage proof credentials, start workers, or modify `gatl-core`.
5252

53+
The standalone `gatl-ad-proof-backend` repo now provides the external command
54+
referenced by `cmd://gatl-ad-proof-backend`. In v0.1 it validates derivative
55+
golden fixture intake and emits a result artifact, but it deliberately does not
56+
claim formal AD proof success.
57+
5358
## Primitive Semantics
5459

5560
Supported scalar primitives:
@@ -72,7 +77,7 @@ Non-smooth or nondeterministic primitives remain outside this lab.
7277
- No production AD engine.
7378
- No TensorFlow, PyTorch, JAX, ONNX, or autograd integration.
7479
- No proof assistant integration.
75-
- No production formal proof backend.
80+
- No production formal proof backend execution in this repo.
7681
- No proof backend execution in this repo.
7782
- No network access.
7883
- No secret handling.
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# Production Proof Backend Setup
2+
3+
`gatl-ad-lab` expects the AD proof backend to remain external. The production
4+
boundary manifest names:
5+
6+
```text
7+
cmd://gatl-ad-proof-backend
8+
```
9+
10+
## Local Activation Probe
11+
12+
Install the standalone backend:
13+
14+
```bash
15+
cd /home/jisheng-yang/projects/gatl-ad-proof-backend
16+
cargo install --path . --force
17+
gatl-ad-proof-backend --version
18+
```
19+
20+
Then run the `gatl-ad-lab` gate:
21+
22+
```bash
23+
cd /home/jisheng-yang/projects/gatl-ad-lab
24+
cargo run -- validate-proof-boundary examples/proof-backend-boundary.valid.json \
25+
--out target/production-probes/proof-backend-boundary-validation.after-backend.json
26+
cargo run -- doctor-proof-backend \
27+
--checked-at 2026-06-14T00:00:00Z \
28+
--out target/production-probes/proof-backend-environment.after-backend.json
29+
cargo run -- gate-proof-backend \
30+
examples/proof-backend-boundary.valid.json \
31+
target/production-probes/proof-backend-environment.after-backend.json \
32+
--out target/production-probes/proof-backend-activation-gate.after-backend.json
33+
```
34+
35+
Expected result:
36+
37+
- boundary validation is valid;
38+
- backend environment is production-ready;
39+
- activation gate is open.
40+
41+
## Boundary
42+
43+
This setup only proves that the external backend command exists and satisfies
44+
the v0.1 command boundary. It does not move proof execution into `gatl-ad-lab`.
45+
The v0.1 backend result remains `validated-not-proved` until real proof-term
46+
checking is added.

0 commit comments

Comments
 (0)