Skip to content
This repository was archived by the owner on Jul 13, 2026. It is now read-only.

docs(api-ref): add 8 newly-surfaced live a11oy endpoints to API reference#10

Merged
Lutar, Stephen P. (stephenlutar2-hash) merged 1 commit into
mainfrom
devd/wire-api-reference
Jun 30, 2026
Merged

docs(api-ref): add 8 newly-surfaced live a11oy endpoints to API reference#10
Lutar, Stephen P. (stephenlutar2-hash) merged 1 commit into
mainfrom
devd/wire-api-reference

Conversation

@stephenlutar2-hash

Copy link
Copy Markdown
Member

What

Adds a new section "a11oy governance, provenance & lake endpoints" to API_REFERENCE.md documenting 8 live endpoints that were previously missing from the public API reference.

Endpoints Added

All verified 200 at https://a-11-oy.com on 2026-06-30:

Endpoint Live?
GET /api/a11oy/v1/honest ✓ 200
GET /api/a11oy/v1/signing-status ✓ 200
GET /api/a11oy/v1/frontier/manifest ✓ 200
GET /api/a11oy/v1/energy/ledger ✓ 200
GET /api/a11oy/v1/energy/sci ✓ 200
GET /api/a11oy/v1/verify/intoto ✓ 200
GET /khipu/intoto/{receipt_id} ✓ 200 (404 for unknown IDs — correct)
GET /api/lake/v1/log ✓ 200

Not added: /api/a11oy/v1/functor/receipt returns 404 — not live, not documented (half-state is the only unacceptable outcome).

Why

Per FRONTIER_VISION.md: "8 live frontier endpoints had ZERO cookbook recipes" and the API reference did not surface the governance/provenance/lake endpoints making them invisible to developers.

Doctrine compliance

  • Additive only — no existing content modified
  • Honest labels throughout (UNAVAILABLE, ephemeral, MODELED, etc.)
  • Λ = Conjecture 1 noted in honest section
  • 8 locked-proven {F1,F4,F7,F11,F12,F18,F19,F22} at kernel c7c0ba17

Signed-off-by: Stephen Lutar stephenlutar2@gmail.com

Adds a new section 'a11oy governance, provenance & lake endpoints' covering:
- /api/a11oy/v1/honest (doctrine status)
- /api/a11oy/v1/signing-status (receipt signing posture)
- /api/a11oy/v1/frontier/manifest (8-capability live roll-up)
- /api/a11oy/v1/energy/ledger (NVML joule receipt chain)
- /api/a11oy/v1/energy/sci (GSF SCI / ISO 21031:2024 score)
- /api/a11oy/v1/verify/intoto (in-toto verification guide)
- /khipu/intoto/{receipt_id} (receipt as in-toto Statement v1)
- /api/lake/v1/log (szl-lake Merkle log head)

All verified live (HTTP 200) at a-11-oy.com on 2026-06-30.
Doctrine v11 LOCKED. 8 locked-proven. Λ = Conjecture 1.
Additive only — no existing content modified.

Signed-off-by: Stephen Lutar <stephenlutar2@gmail.com>
@stephenlutar2-hash
Lutar, Stephen P. (stephenlutar2-hash) merged commit ac916ef into main Jun 30, 2026
1 check passed
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant