From b33877d6e78d44001eddf9b2ea2e596e322a171a Mon Sep 17 00:00:00 2001 From: Igor Pugachevsky Date: Sat, 16 May 2026 02:33:04 +0700 Subject: [PATCH 1/3] docs: align public repo naming with v95 surfaces --- AGENTS.md | 2 +- docs/llms.txt | 2 +- docs/open-core-boundary.md | 6 +++--- scripts/public_readiness_gate.sh | 24 ++++++++++++++++++++++++ 4 files changed, 29 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3be97f9..835cfbb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -77,7 +77,7 @@ asked: - history, cohorts, webhooks, exports, redistribution rights, support, SLAs - hosted ingestion and commercial reliability infrastructure -Do not make the open runtime depend on a ZERO-hosted control plane. +Do not make the open runtime depend on a ZERO-hosted app. ## Machine-Readable Surfaces diff --git a/docs/llms.txt b/docs/llms.txt index 76c0853..4d9c468 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -69,7 +69,7 @@ - [Hyperliquid Read-only](hyperliquid-readonly.md) - [Live Evidence](live-evidence.md) - [Live Canary Operator](live-canary-operator.md) -- [Live Cockpit](live-cockpit.md) +- [Live Control](live-cockpit.md) - [Operator Context](operator-context.md) - [Operator Isolation](operator-isolation.md) - [Immune System](immune-system.md) diff --git a/docs/open-core-boundary.md b/docs/open-core-boundary.md index 968d8da..da4aa95 100644 --- a/docs/open-core-boundary.md +++ b/docs/open-core-boundary.md @@ -15,7 +15,7 @@ benchmarks, reliability commitments, and enterprise support. ## Open Source -- Local engine runtime +- Local ZERO Runtime - Paper-trading adapter - Safety and risk primitives - Operator CLI @@ -47,12 +47,12 @@ benchmarks, reliability commitments, and enterprise support. - Public examples must run without real funds. - Public docs must not reference private infrastructure, direct host details, or private legal material. -- Public code must not require a ZERO-hosted control plane to run paper mode. +- Public code must not require a ZERO-hosted app to run paper mode. - Railway deployment must be optional, reproducible, and self-custodial. - Runtime telemetry and profile publication must be opt-in. - Public profiles and leaderboards are part of the public product surface. - ZERO Network publication must use redacted proof packets and must not require - a ZERO-hosted control plane. + a ZERO-hosted app. - Delayed ZERO Intelligence snapshots, realtime growth-mode access, and the local intelligence export contract are public-facing; future higher-scale history, cohorts, bulk exports, redistribution, and SLAs remain commercial. diff --git a/scripts/public_readiness_gate.sh b/scripts/public_readiness_gate.sh index 46627db..6d15480 100755 --- a/scripts/public_readiness_gate.sh +++ b/scripts/public_readiness_gate.sh @@ -28,6 +28,25 @@ repo_search() { -print0 | xargs -0 grep -InE "$pattern" } +current_surface_search() { + local pattern="$1" + local paths=( + README.md + AGENTS.md + docs/positioning.md + docs/open-core-boundary.md + docs/llms.txt + docs/llms-full.txt + ) + + if command -v rg >/dev/null 2>&1; then + rg -n "$pattern" "${paths[@]}" + return + fi + + grep -InE "$pattern" "${paths[@]}" +} + file_contains() { local pattern="$1" local path="$2" @@ -170,7 +189,12 @@ fi echo "-- public product honesty" file_contains "Autonomous operating system for self-custodial onchain operations" README.md +file_contains "https://getzero.dev/developers" README.md +file_contains "https://getzero.dev/proof" README.md file_contains "paper mode" README.md +if current_surface_search 'public product page|ZERO-hosted control plane|hosted ZERO control plane|The engine is open source'; then + status=1 +fi file_contains "Self-evolution" docs/private-engine-capability-gap-audit.md file_contains "Full ZERO operating-system contract readiness: 100/100" docs/production-readiness.md file_contains "Autonomous trust readiness: 100/100" docs/production-readiness.md From b6a1a9194e278e0ba3886191415f8b683fbfc13a Mon Sep 17 00:00:00 2001 From: Igor Pugachevsky Date: Sat, 16 May 2026 04:25:46 +0700 Subject: [PATCH 2/3] Address v95 docs review comments --- cli/crates/zero-tui/src/widgets/pane.rs | 4 ++-- cli/crates/zero-tui/tests/snapshots.rs | 2 +- scripts/public_readiness_gate.sh | 30 ++++++++++++++++++++++--- 3 files changed, 30 insertions(+), 6 deletions(-) diff --git a/cli/crates/zero-tui/src/widgets/pane.rs b/cli/crates/zero-tui/src/widgets/pane.rs index 7acb7e6..f465063 100644 --- a/cli/crates/zero-tui/src/widgets/pane.rs +++ b/cli/crates/zero-tui/src/widgets/pane.rs @@ -159,7 +159,7 @@ impl Widget for CockpitPane<'_> { fn render(self, area: Rect, buf: &mut Buffer) { clear(area, buf); Line::from(vec![Span::styled( - " live cockpit ", + " live control ", Style::default() .fg(self.theme.primary) .add_modifier(Modifier::BOLD), @@ -168,7 +168,7 @@ impl Widget for CockpitPane<'_> { let Some(stat) = &self.engine.live_cockpit else { Line::from(vec![Span::styled( - " (no cockpit packet yet — waiting for /live/cockpit poll)", + " (no live Control packet yet — waiting for /live/cockpit poll)", Style::default().fg(self.theme.metadata), )]) .render(subrect(area, 2, 1), buf); diff --git a/cli/crates/zero-tui/tests/snapshots.rs b/cli/crates/zero-tui/tests/snapshots.rs index 62a6d62..1c03ad4 100644 --- a/cli/crates/zero-tui/tests/snapshots.rs +++ b/cli/crates/zero-tui/tests/snapshots.rs @@ -207,7 +207,7 @@ fn cockpit_mode_renders_live_readiness_board() { term.draw(|f| render_at(f, &state, frozen())).unwrap(); let snap = grid_to_text(&term); for needle in [ - "live cockpit", + "live control", "live_mode=refused", "risk_allowed=false", "operator: handle=mock-operator", diff --git a/scripts/public_readiness_gate.sh b/scripts/public_readiness_gate.sh index 6d15480..65afd56 100755 --- a/scripts/public_readiness_gate.sh +++ b/scripts/public_readiness_gate.sh @@ -38,13 +38,32 @@ current_surface_search() { docs/llms.txt docs/llms-full.txt ) + local existing=() + local path + + for path in "${paths[@]}"; do + if [[ -f "$path" ]]; then + existing+=("$path") + else + echo "current_surface_search: missing target file $path" >&2 + return 2 + fi + done + + local rc=0 if command -v rg >/dev/null 2>&1; then - rg -n "$pattern" "${paths[@]}" - return + rg -n "$pattern" "${existing[@]}" || rc=$? + else + grep -InE "$pattern" "${existing[@]}" || rc=$? + fi + + if [[ "$rc" -gt 1 ]]; then + echo "current_surface_search: search failed for pattern $pattern" >&2 + return "$rc" fi - grep -InE "$pattern" "${paths[@]}" + return "$rc" } file_contains() { @@ -194,6 +213,11 @@ file_contains "https://getzero.dev/proof" README.md file_contains "paper mode" README.md if current_surface_search 'public product page|ZERO-hosted control plane|hosted ZERO control plane|The engine is open source'; then status=1 +else + rc=$? + if [[ "$rc" -gt 1 ]]; then + status=1 + fi fi file_contains "Self-evolution" docs/private-engine-capability-gap-audit.md file_contains "Full ZERO operating-system contract readiness: 100/100" docs/production-readiness.md From 93830da7da2c8adb535e82f8594b92f96736d33d Mon Sep 17 00:00:00 2001 From: Igor Pugachevsky Date: Sat, 16 May 2026 12:33:50 +0700 Subject: [PATCH 3/3] docs: refresh v95 public repo context after rebase --- README.md | 4 ++-- docs/llms-full.txt | 14 +++++++------- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 7057ccd..34d0b7d 100644 --- a/README.md +++ b/README.md @@ -547,9 +547,9 @@ not basic operator access while ZERO needs more verified operators. | Open | Commercial | | --- | --- | -| Runtime engine, safety gates, paper mode, local API, CLI, Docker/Railway deployment, public profile contracts, leaderboards, delayed snapshots, growth-mode realtime Intelligence access, docs, tests, and release tooling. | Future higher limits, deeper history, cohorts, benchmarks, commercial connectors, bulk exports, redistribution rights, support, reliability commitments, and SLAs. | +| ZERO Runtime, safety gates, paper mode, local API, CLI, Docker/Railway deployment, public profile contracts, leaderboards, delayed snapshots, growth-mode realtime Intelligence access, docs, tests, and release tooling. | Future higher limits, deeper history, cohorts, benchmarks, commercial connectors, bulk exports, redistribution rights, support, reliability commitments, and SLAs. | -The open repository must stay useful without a ZERO-hosted control plane. The +The open repository must stay useful without a ZERO-hosted app. The commercial product sells speed, scale, history, reliability, and intelligence access, not custody or basic runtime operation. diff --git a/docs/llms-full.txt b/docs/llms-full.txt index 487ed9e..e116ddb 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -611,9 +611,9 @@ not basic operator access while ZERO needs more verified operators. | Open | Commercial | | --- | --- | -| Runtime engine, safety gates, paper mode, local API, CLI, Docker/Railway deployment, public profile contracts, leaderboards, delayed snapshots, growth-mode realtime Intelligence access, docs, tests, and release tooling. | Future higher limits, deeper history, cohorts, benchmarks, commercial connectors, bulk exports, redistribution rights, support, reliability commitments, and SLAs. | +| ZERO Runtime, safety gates, paper mode, local API, CLI, Docker/Railway deployment, public profile contracts, leaderboards, delayed snapshots, growth-mode realtime Intelligence access, docs, tests, and release tooling. | Future higher limits, deeper history, cohorts, benchmarks, commercial connectors, bulk exports, redistribution rights, support, reliability commitments, and SLAs. | -The open repository must stay useful without a ZERO-hosted control plane. The +The open repository must stay useful without a ZERO-hosted app. The commercial product sells speed, scale, history, reliability, and intelligence access, not custody or basic runtime operation. @@ -840,7 +840,7 @@ asked: - history, cohorts, webhooks, exports, redistribution rights, support, SLAs - hosted ingestion and commercial reliability infrastructure -Do not make the open runtime depend on a ZERO-hosted control plane. +Do not make the open runtime depend on a ZERO-hosted app. ## Machine-Readable Surfaces @@ -1275,7 +1275,7 @@ Out of scope: - [Hyperliquid Read-only](hyperliquid-readonly.md) - [Live Evidence](live-evidence.md) - [Live Canary Operator](live-canary-operator.md) -- [Live Cockpit](live-cockpit.md) +- [Live Control](live-cockpit.md) - [Operator Context](operator-context.md) - [Operator Isolation](operator-isolation.md) - [Immune System](immune-system.md) @@ -4739,7 +4739,7 @@ benchmarks, reliability commitments, and enterprise support. ## Open Source -- Local engine runtime +- Local ZERO Runtime - Paper-trading adapter - Safety and risk primitives - Operator CLI @@ -4771,12 +4771,12 @@ benchmarks, reliability commitments, and enterprise support. - Public examples must run without real funds. - Public docs must not reference private infrastructure, direct host details, or private legal material. -- Public code must not require a ZERO-hosted control plane to run paper mode. +- Public code must not require a ZERO-hosted app to run paper mode. - Railway deployment must be optional, reproducible, and self-custodial. - Runtime telemetry and profile publication must be opt-in. - Public profiles and leaderboards are part of the public product surface. - ZERO Network publication must use redacted proof packets and must not require - a ZERO-hosted control plane. + a ZERO-hosted app. - Delayed ZERO Intelligence snapshots, realtime growth-mode access, and the local intelligence export contract are public-facing; future higher-scale history, cohorts, bulk exports, redistribution, and SLAs remain commercial.