Align public repo with Runtime, Protocol, and Proof surfaces

[squaeragent]

Summary

• reframe the public repo as ZERO Runtime, ZERO Protocol, and ZERO Proof substrate
• move hosted product language toward getzero.dev and app.getzero.dev ownership
• regenerate docs/llms-full.txt from the updated docs source

Safety

• docs-only public repo cleanup
• no live Runtime behavior changes
• no trading, order placement, or cancel behavior changes
• no secrets, env vars, infrastructure, or deploy actions

Validation

• just docs-check
• just public-proof
• git diff --check

Summary by CodeRabbit

• Documentation
  • Reframed product positioning to emphasize Runtime, Protocol, and Proof.
  • Replaced “live cockpit/terminal” wording with “Runtime control packet/drill” and renamed Terminal → CLI.
  • Restructured product surfaces, capability boundary, and public launch/upgrades to the new terminology.
  • Updated operator examples, demo outputs, and contributor guidance; added a non‑negotiable public boundary for commercial data.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3cf1bb7a-f8ae-437d-9832-af6af9e5dda3

📥 Commits

Reviewing files that changed from the base of the PR and between 57df51b and bbbc650.

📒 Files selected for processing (5)

• README.md
• docs/architecture.md
• docs/autonomous-os-plan.md
• docs/llms-full.txt
• docs/positioning.md

✅ Files skipped from review due to trivial changes (4)

• docs/architecture.md
• docs/autonomous-os-plan.md
• docs/positioning.md
• docs/llms-full.txt

---

📝 Walkthrough

Walkthrough

Three documentation files—README.md, docs/llms-full.txt, and docs/public-upgrade.md—are updated to adopt consistent "Runtime, Protocol, and Proof" terminology. Product positioning, surfaces, operator guidance, and contributor resources are revised throughout to frame ZERO's open offering as inspectable, self-custodial runtime and proof artifacts without hosted dependencies.

Changes

Runtime, Protocol, and Proof terminology alignment

Layer / File(s)	Summary
Core positioning and product rules README.md, docs/llms-full.txt, docs/public-upgrade.md	Opening tagline, product rules, launch status, and why-ZERO-exists bullets reframed around Runtime, Protocol, and Proof as inspectable, open-source surfaces without hosted accounts or private doctrine.
Product surfaces and capability boundary mapping README.md, docs/llms-full.txt, docs/public-upgrade.md	Product Surfaces and Capability Boundary tables restructured to show ZERO Protocol, ZERO Proof, ZERO CLI, and ZERO Evolution; mermaid diagram updated to route through Proof and Public verification.
Operator and user-facing walkthrough README.md, docs/llms-full.txt	Quickstart terminal, What-You-Can-Run-Today bullets, Operator Proof Path steps, and demo output examples updated to consistently use Runtime control packet, drill bundle, and proof-path terminology.
Contributor resources and upgrade planning README.md, docs/llms-full.txt, docs/public-upgrade.md	Good first contribution areas and documentation links updated to reference Proof, Protocol, and CLI topics; Public Upgrade Plan and Cycle B renamed from Engine to Runtime with refined launch surface requirements.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A rabbit hops through docs with glee,
Swapping words for clarity—
Runtime, Proof, and Protocol shine,
No terminals, just truth divine!
Open surfaces, pure and free,
ZERO's future, plain to see. 🌙

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The pull request title clearly and concisely summarizes the main change: reframing the public repository around Runtime, Protocol, and Proof surfaces, which is the primary focus of all documentation updates across multiple files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/v95-public-repo-surface-cleanup

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (2)

README.md (1)

180-181: ⚡ Quick win

Align the Mermaid surface label with the new terminology.

The updated flow points to Proof/Public verification, but Line 178 still uses ZERO Terminal, which conflicts with the Runtime/Protocol/Proof framing in this PR. Consider renaming that node to ZERO CLI (or ZERO Control) for consistency.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 180 - 181, The Mermaid diagram currently labels the
node referenced by symbol F as "ZERO Terminal" which conflicts with the PR's
Runtime/Protocol/Proof terminology; update F's label to "ZERO CLI" (or "ZERO
Control") and ensure any edges or references (e.g., F --> G and subsequent G -->
H) remain unchanged so the flow from F to G["ZERO Proof"] to H["Public
verification"] reads consistently.

docs/llms-full.txt (1)

244-245: ⚡ Quick win

Align the mermaid node label with the new surface naming.

The flow now routes through Proof/Public verification, but the upstream node still says ZERO Terminal, which conflicts with the updated ZERO CLI surface naming in the same section. Renaming that node keeps the taxonomy consistent.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/llms-full.txt` around lines 244 - 245, The mermaid flow uses node labels
F -> G -> H but the upstream node label still references "ZERO Terminal"; update
the node label for F (the node currently named "ZERO Terminal") to match the new
surface naming "ZERO CLI" (or otherwise rename it to "ZERO CLI") so the sequence
F --> G["ZERO Proof"] --> H["Public verification"] is consistent with the
updated surface taxonomy.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Around line 679-680: Remove the duplicate documentation links in the README
docs list by deleting the repeated entries "- [ZERO
Proof](docs/proof/README.md)" and "- [MCP Server](docs/mcp.md)" (they already
appear earlier), leaving only the original links to avoid redundancy in
navigation.

---

Nitpick comments:
In `@docs/llms-full.txt`:
- Around line 244-245: The mermaid flow uses node labels F -> G -> H but the
upstream node label still references "ZERO Terminal"; update the node label for
F (the node currently named "ZERO Terminal") to match the new surface naming
"ZERO CLI" (or otherwise rename it to "ZERO CLI") so the sequence F --> G["ZERO
Proof"] --> H["Public verification"] is consistent with the updated surface
taxonomy.

In `@README.md`:
- Around line 180-181: The Mermaid diagram currently labels the node referenced
by symbol F as "ZERO Terminal" which conflicts with the PR's
Runtime/Protocol/Proof terminology; update F's label to "ZERO CLI" (or "ZERO
Control") and ensure any edges or references (e.g., F --> G and subsequent G -->
H) remain unchanged so the flow from F to G["ZERO Proof"] to H["Public
verification"] reads consistently.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 024e8ac8-26f1-482a-928f-f1ae2d46f62b

📥 Commits

Reviewing files that changed from the base of the PR and between c23232b and 57df51b.

📒 Files selected for processing (3)

• README.md
• docs/llms-full.txt
• docs/public-upgrade.md