Skip to content

Commit 589d3cd

Browse files
authored
Align public repo with Runtime, Protocol, and Proof boundary
Docs/metadata/gates only. Aligns public repository framing to ZERO Runtime, Protocol, and Proof boundary; no Runtime/live/trading behavior changes.
1 parent 2dcae2d commit 589d3cd

13 files changed

Lines changed: 239 additions & 144 deletions

README.md

Lines changed: 38 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,18 @@
44
[![OpenSSF Scorecard](https://github.com/zero-intel/zero/actions/workflows/scorecard.yml/badge.svg)](https://github.com/zero-intel/zero/actions/workflows/scorecard.yml)
55
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
66

7-
**Autonomous operating system for self-custodial onchain operations: open ZERO
8-
Runtime, Protocol, and Proof.**
9-
10-
This repository is the open Runtime, Protocol, and Proof substrate for ZERO.
11-
The hosted product surfaces live at [getzero.dev](https://getzero.dev),
12-
[app.getzero.dev](https://app.getzero.dev), and the public developer entrypoint
13-
at [getzero.dev/developers](https://getzero.dev/developers). This repo stays
7+
**Open ZERO Runtime, Protocol, and Proof for self-custodial onchain
8+
operations.**
9+
10+
This repository is the open ZERO Runtime, ZERO Protocol, and ZERO Proof
11+
substrate. The hosted product surfaces live at
12+
[getzero.dev](https://getzero.dev), [app.getzero.dev](https://app.getzero.dev),
13+
and the public developer entrypoint at
14+
[getzero.dev/developers](https://getzero.dev/developers). This repo stays
1415
focused on runnable software: paper-first execution, safety gates, local
1516
journals, Hyperliquid read-only/live boundaries, MCP-compatible readouts,
16-
public proof packets, and verification contracts.
17+
public proof packets, and verification contracts. It does not host the
18+
customer app, founder admin, doctrine portal, or internal design system.
1719

1820
> Not another trading bot. ZERO is Runtime plus Proof for autonomous onchain
1921
> operations that must stay inspectable, interruptible, and self-custodial.
@@ -83,9 +85,9 @@ cargo run -q -p zero-os -- --api http://127.0.0.1:8765
8385
```
8486

8587
Inside the terminal, press `Ctrl+5` or run `/cockpit-mode` for the read-only
86-
Runtime control packet. The command name is legacy CLI language; public product
87-
copy should call the surface ZERO Control. In paper/default mode it should
88-
refuse live risk and show the reason:
88+
Runtime control packet. The `/cockpit-mode` command remains supported, but the
89+
preferred product term is Runtime control packet. In paper/default mode it
90+
should refuse live risk and show the reason:
8991

9092
```text
9193
runtime control
@@ -148,15 +150,25 @@ ZERO turns that workflow into an explicit operating system:
148150
The default mode is paper. Live operation is self-custodial, explicit, and
149151
guarded by preflight checks.
150152

151-
## Product Surfaces
153+
## Open Repository Surfaces
152154

153155
| Surface | Role | Public status |
154156
| --- | --- | --- |
155-
| ZERO Runtime | Python engine for paper execution, production-parity OODA reports, live-readiness contracts, journals, safety gates, strategy adapters, venue adapter interfaces, local evolution gates, and canary evidence. | Open source |
157+
| ZERO Runtime | Python runtime for paper execution, production-parity OODA reports, live-readiness contracts, journals, safety gates, strategy adapters, venue adapter interfaces, CLI/TUI tooling, local evolution gates, and canary evidence. | Open source |
156158
| ZERO Protocol | MCP-compatible schemas, tool permissions, mandates, evidence bundles, replay frames, audit entries, and local verification fixtures. | Open source |
157159
| ZERO Proof | Redacted proof packets, replay/export fixtures, journal roots, verification commands, and public contract schemas. | Open source |
158-
| ZERO CLI | Rust CLI/TUI for setup, diagnostics, state inspection, replay, read-only Runtime control packets, and supervised local actions. | Open source |
159-
| ZERO Evolution | Local memory, genesis proposals, research reports, decision-stack review, guardian review, red-team, paper canaries, calibration, promotion plans, local apply receipts, rollback receipts, and evolve loops that let ZERO improve under review. | Open where secret-free and human-reviewed |
160+
| Developers | Repo-local quickstarts, CLI/API docs, examples, release gates, contribution paths, and public education that starts at [getzero.dev/developers](https://getzero.dev/developers). | Open source |
161+
162+
The ZERO CLI is Runtime tooling, and ZERO Evolution is a local Runtime subsystem
163+
covering memory, genesis proposals, research reports, decision-stack review,
164+
guardian review, red-team, paper canaries, calibration, promotion plans, local
165+
apply receipts, rollback receipts, and evolve loops. They are not separate
166+
hosted public surfaces.
167+
168+
Hosted ZERO Studio, ZERO Control, and ZERO Registry are product surfaces outside
169+
this repository. This repo supplies their runnable Runtime, Protocol, and Proof
170+
contracts; it should not turn hosted UI, founder-admin, or doctrine machinery
171+
into public repo scope.
160172

161173
## Capability Boundary
162174

@@ -236,16 +248,15 @@ flowchart LR
236248
- Deploy the paper runtime on Railway or Docker.
237249
- Generate public-safe Proof profile, replay, and contract artifacts.
238250

239-
The self-evolving loop that makes ZERO a complete autonomous operating system
240-
is now implemented as a public-safe control plane: local memory, genesis
241-
proposal classification, paper-only research, public decision-stack review,
242-
production-parity OODA reports, sandbox candidate mutation, promotion/rollback
243-
evidence, explicit local apply, rollback receipts, and paper-first evolve gates
244-
exist. Protected live-code evolution remains human-reviewed. See
245-
[Memory Core](docs/memory-core.md), [Genesis](docs/genesis.md),
246-
[Research Command Chain](docs/research.md), [Decision Stack](docs/decision-stack.md),
247-
[Evolve Harness](docs/evolve.md), and
248-
[Private Engine Capability Gap Audit](docs/private-engine-capability-gap-audit.md).
251+
The public-safe self-evolution loop is part of the local Runtime: local memory,
252+
genesis proposal classification, paper-only research, public decision-stack
253+
review, production-parity OODA reports, sandbox candidate mutation,
254+
promotion/rollback evidence, explicit local apply, rollback receipts, and
255+
paper-first evolve gates exist. Protected live-code evolution remains
256+
human-reviewed. See [Memory Core](docs/memory-core.md),
257+
[Genesis](docs/genesis.md), [Research Command Chain](docs/research.md),
258+
[Decision Stack](docs/decision-stack.md), and
259+
[Evolve Harness](docs/evolve.md).
249260

250261
## Operator Proof Path
251262

@@ -680,8 +691,8 @@ Machine-readable entrypoints:
680691
- [Production Readiness](docs/production-readiness.md)
681692
- [QA Onboarding Checklist](docs/qa-onboarding-checklist.md)
682693
- [Public Upgrade Plan](docs/public-upgrade.md)
683-
- [Autonomous OS Plan](docs/autonomous-os-plan.md)
684-
- [Capability Gap Audit](docs/private-engine-capability-gap-audit.md)
694+
- [Historical Autonomous OS Plan](docs/autonomous-os-plan.md)
695+
- [Runtime Capability Boundary Audit](docs/private-engine-capability-gap-audit.md)
685696
- [Agentic Contribution](docs/agentic-contribution.md)
686697
- [Contributor Issue Board](docs/contributor-issue-board.md)
687698
- [Launch Scorecard](docs/launch-scorecard.md)

cli/Cargo.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ repository = "https://github.com/zero-intel/zero"
2323
homepage = "https://getzero.dev"
2424
documentation = "https://github.com/zero-intel/zero/tree/main/docs"
2525
authors = ["zero-intel"]
26-
keywords = ["zero", "onchain", "terminal", "automation", "trading"]
26+
keywords = ["zero", "onchain", "terminal", "runtime", "proof"]
2727
categories = ["command-line-utilities"]
2828

2929
[workspace.dependencies]

docs/architecture.md

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,24 @@
33
ZERO is an autonomous operating system for self-custodial onchain operations,
44
starting with onchain perpetual markets.
55

6-
ZERO has five product surfaces:
7-
8-
- ZERO Runtime: local autonomous operations engine with paper mode, safety
9-
gates, API, journals, and extension contracts.
10-
- ZERO CLI: operator CLI for setup, diagnostics, state inspection, replay,
11-
and supervised actions.
12-
- ZERO Evolution: local memory, genesis proposals, research reports, guardian
13-
review, red-team, paper canaries, calibration, and evolve loops that let the
14-
system improve under evidence and review.
15-
- ZERO Network: public profiles, leaderboards, verification badges, and public decision-flow proof.
16-
- ZERO Intelligence: delayed public snapshots plus a commercial API and
17-
subscription layer for realtime intelligence, history, cohorts, webhooks, and
18-
enterprise support.
6+
This public repository has four first-class open surfaces:
7+
8+
- ZERO Runtime: local autonomous operations runtime with paper mode, safety
9+
gates, API, journals, live-readiness contracts, extension contracts, and
10+
paper-first evolution loops.
11+
- ZERO Protocol: MCP-compatible schemas, read/compute tools, mandates, replay
12+
frames, evidence bundles, audit entries, permission metadata, and local
13+
verification fixtures.
14+
- ZERO Proof: redacted proof packets, proof profiles, replay/export fixtures,
15+
journal roots, verification commands, and public contract schemas.
16+
- Developers: repo-local quickstarts, CLI/API docs, examples, release gates,
17+
and contribution paths that start at
18+
[getzero.dev/developers](https://getzero.dev/developers).
19+
20+
The ZERO CLI is Runtime tooling, not a separate hosted product surface. Hosted
21+
Studio, Control, Registry, founder-admin, and doctrine surfaces live outside
22+
this repository; this repo supplies the Runtime, Protocol, and Proof substrate
23+
they can consume.
1924

2025
Deployment is Railway-first, Docker-compatible, and local-first. Operators own
2126
their deployment project, secrets, exchange credentials, and runtime state.
@@ -30,13 +35,13 @@ ZERO does not need a separate hosted deployment product to be credible.
3035
- Risk-reducing actions stay fast
3136
- Risk-increasing actions require friction
3237

33-
## Public Engine Flow
38+
## Public Runtime Flow
3439

3540
```text
3641
JSONL candles -> MarketDataAdapter -> Strategy -> OrderIntent -> PaperEngine -> RiskDecision
3742
```
3843

39-
Strategies propose. The paper engine decides. This keeps extension work
44+
Strategies propose. The paper Runtime decides. This keeps extension work
4045
deterministic and prevents examples from bypassing safety gates.
4146

4247
The runtime loop wraps that path in an explicit OODA cycle:
@@ -67,20 +72,18 @@ classification, append-only genesis journals, `/genesis`, read-only MCP
6772
genesis snapshots, fixture-backed research reports, `/research`, read-only MCP
6873
research snapshots, paper-only evolve gate runs, `/evolve`, and read-only MCP
6974
evolve status. Real mutation, promotion, and rollback are tracked as public
70-
extraction targets in
71-
[Private Engine Capability Gap Audit](private-engine-capability-gap-audit.md).
72-
Local memory, research, genesis, and evolve belong in open source because they
73-
are part of a self-custodial operator's runtime. Commercial ZERO Intelligence
74-
begins when many verified runtimes opt into aggregate realtime behavior,
75-
cohorts, history, webhooks, redistribution, or operational SLAs.
75+
extraction targets in [Evolve Harness](evolve.md). Local memory, research,
76+
genesis, and evolve belong in open source because they are part of a
77+
self-custodial operator's runtime. Future commercial data products can build on
78+
opt-in verified behavior, cohorts, history, webhooks, redistribution, or
79+
operational SLAs without gating basic Runtime use.
7680

7781
## Commercial Flow
7882

7983
```text
80-
Runtime behavior -> opt-in verification -> public network proof -> ZERO Intelligence API
84+
Runtime behavior -> opt-in verification -> ZERO Proof -> commercial data products
8185
```
8286

8387
The commercial product is advantaged access to verified autonomous behavior at
84-
speed, scale, and history. Basic runtime use, self-custody, public profiles, and
85-
public leaderboards, and delayed public intelligence snapshots remain public
86-
surfaces.
88+
speed, scale, and history. Basic runtime use, self-custody, public profiles,
89+
and public proof contracts remain open.

docs/autonomous-os-plan.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
# ZERO Autonomous OS Completion Plan
22

3+
Status: historical publicization roadmap. The canonical public repo surfaces
4+
are ZERO Runtime, ZERO Protocol, ZERO Proof, and Developers. Hosted Studio,
5+
Control, Registry, founder-admin, and doctrine surfaces live outside this
6+
repository.
7+
38
This plan defines the path from the current open-source launch repository to a
49
complete ZERO autonomous operating system for self-custodial onchain
510
operations.

0 commit comments

Comments
 (0)