Skip to content

Reset public Runtime doctrine#46

Merged
squaeragent merged 1 commit into
mainfrom
codex/public-runtime-doctrine-reset
May 21, 2026
Merged

Reset public Runtime doctrine#46
squaeragent merged 1 commit into
mainfrom
codex/public-runtime-doctrine-reset

Conversation

@squaeragent
Copy link
Copy Markdown
Contributor

@squaeragent squaeragent commented May 21, 2026

Summary

  • reframe the public repo around current ZERO truth: operating intelligence between humans and capital
  • clarify that this repo is the open Runtime, Protocol, and Proof substrate, not the whole hosted product
  • update README, positioning, architecture, Railway, launch scorecard, package/MCP metadata, and agent-facing context
  • harden public-readiness and hardening_gate so stale Autonomous Capital OS / autonomous operating-system category language cannot pass current public surfaces

Live metadata already updated

  • GitHub description: Open ZERO Runtime, Protocol, and Proof for self-custodial capital operations.
  • removed stale topics: trading-bot, capital-os, autonomous-capital, zero-os, algotrading, paper-trading
  • added current topics: runtime, protocol, proof, operator-intelligence, risk-operations

Verification

  • just public-readiness
  • just docs-check
  • just registry-readiness
  • just package-dry-run
  • just fresh-clone-rehearsal
  • scripts/hardening_gate.sh
  • git diff --check
  • focused stale-framing search over current public surfaces

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 21, 2026

Warning

Rate limit exceeded

@squaeragent has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 35 minutes and 39 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: affad2a0-1c2a-449b-b352-d62f04375b20

📥 Commits

Reviewing files that changed from the base of the PR and between 6d86029 and 728b94f.

📒 Files selected for processing (21)
  • .github/copilot-instructions.md
  • AGENTS.md
  • README.md
  • contracts/distribution/mcp-registry.json
  • docs/agent-architecture.md
  • docs/architecture.md
  • docs/launch-scorecard.md
  • docs/llms-full.txt
  • docs/llms.txt
  • docs/open-core-boundary.md
  • docs/positioning.md
  • docs/production-readiness.md
  • docs/public-upgrade.md
  • docs/railway-partner.md
  • docs/railway-template.md
  • engine/pyproject.toml
  • llms.txt
  • scripts/hardening_gate.sh
  • scripts/mcp_registry_packet.py
  • scripts/public_readiness_gate.sh
  • server.json
📝 Walkthrough

Walkthrough

This PR comprehensively repositions ZERO's public messaging and documentation from an "autonomous operating system for self-custodial onchain operations" to an "operating intelligence layer between humans and capital," including updates to architecture descriptions, product surface naming (Runtime/Protocol/Proof), deployment documentation, readiness tracking, and validation enforcement across 27 files.

Changes

Operating Intelligence Messaging Rebrand

Layer / File(s) Summary
Core ZERO narrative redefinition
.github/copilot-instructions.md, AGENTS.md, README.md, docs/agent-architecture.md, docs/llms.txt, docs/llms-full.txt, llms.txt
Foundational reframing of what ZERO is across introductory documentation, changing core positioning from autonomous operating system to operating intelligence layer between humans and capital, while preserving paper-first, local-first, and Apache-2.0 characteristics.
Architecture and system layer documentation
docs/architecture.md, docs/positioning.md, docs/llms-full.txt
Updates architecture overview and system layers list to reflect the new operating intelligence framing with explicit Protocol and Proof layers, replacing prior ZERO Network surface and autonomous OS terminology with structured product surface organization.
Production readiness and public launch tracking
docs/launch-scorecard.md, docs/production-readiness.md, docs/public-upgrade.md, docs/llms-full.txt
Updates launch scorecard, production readiness checklist, and public upgrade plan to track operating intelligence layer narrative, including scorecard headings, readiness gates, cycle goals, and forecast language aligned with the new positioning.
Deployment and operational documentation
docs/railway-partner.md, docs/railway-template.md, docs/llms-full.txt
Updates Railway partner and template documentation to describe operating intelligence layer, paper-first runtime behavior, journal persistence, fail-closed endpoints, and operational boundaries for new operators.
Open-source substrate boundary clarification
docs/open-core-boundary.md, docs/llms-full.txt
Clarifies distinction between open ZERO Runtime/Protocol/Proof substrate and hosted commercial ZERO product, updates adapter naming from paper-trading to paper-execution, and expands scope descriptions for contributors.
Package metadata and keyword updates
cli/Cargo.toml, engine/pyproject.toml, contracts/distribution/mcp-registry.json, server.json, scripts/mcp_registry_packet.py
Updates workspace and package metadata keywords from automation/trading to runtime/proof, updates MCP server registry descriptions to reflect new operating intelligence and Runtime/Protocol/Proof positioning.
Validation script and readiness gate updates
scripts/public_readiness_gate.sh
Expands public readiness gate to search additional documentation surfaces, strengthens README content verification, and updates readiness markers from operating-system to operating-intelligence terminology aligned with scorecard and production readiness documentation.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • zero-intel/zero#42: Updates the same scripts/public_readiness_gate.sh enforcement path and high-visibility documentation surfaces to align operating-intelligence/control-plane terminology.
  • zero-intel/zero#41: Simultaneously updates the same public documentation surfaces (README.md, docs/architecture.md, docs/llms*.txt) to reframe ZERO around Runtime/Protocol/Proof and operating intelligence terminology.

Poem

A rabbit hops through docs with glee, 🐰
Trading "operating systems" for "intelligence" see—
From capital and humans, a layer between,
Runtime, Protocol, Proof: the cleanest we've seen!
Paper-first, proof-safe, the story now sings. ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Reset public Runtime doctrine' accurately reflects the primary change: a comprehensive repositioning of public-facing messaging from 'autonomous operating system' to 'operating intelligence layer between humans and capital.'
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.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ 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/public-runtime-doctrine-reset

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

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

@squaeragent squaeragent force-pushed the codex/public-runtime-doctrine-reset branch from 6d86029 to 17803fa Compare May 21, 2026 12:07
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/architecture.md (1)

90-92: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Tighten the sentence to remove duplicated conjunction.

“public profiles, and public leaderboards, and delayed...” reads awkwardly and may confuse readers. Consider removing one “and” for clarity.

🤖 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/architecture.md` around lines 90 - 92, Summary: The sentence contains a
duplicated conjunction ("and") making it awkward. Fix: Locate the sentence
containing the phrase "public profiles, and public leaderboards, and delayed
public intelligence snapshots" in docs/architecture.md and remove the extra
"and" so it reads naturally (e.g., "public profiles, public leaderboards, and
delayed public intelligence snapshots"); ensure spacing and punctuation remain
correct.
🤖 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 `@docs/architecture.md`:
- Around line 9-24: Update the architecture heading text that currently reads
"ZERO has five system layers:" to match the actual list of six layers;
specifically change that heading to "ZERO has six system layers:" so it aligns
with the listed layers ZERO Runtime, ZERO Protocol, ZERO Proof, ZERO CLI, ZERO
Evolution, and ZERO Intelligence.

In `@docs/llms-full.txt`:
- Around line 1788-1803: The header incorrectly states "ZERO has five system
layers:" while six layers are listed (ZERO Runtime, ZERO Protocol, ZERO Proof,
ZERO CLI, ZERO Evolution, ZERO Intelligence); update the header to read "ZERO
has six system layers:" (or alternatively remove/merge one of the listed
entries) so the count matches the listed items, ensuring the phrase that names
the layer count is changed wherever "ZERO has five system layers:" appears and
leaving the six layer names unchanged.

In `@docs/open-core-boundary.md`:
- Around line 7-9: The sentence "Deployment should be Railway-first" conflicts
with the project's rule that Railway is optional; change this wording in
docs/open-core-boundary.md so it recommends Railway rather than mandates it —
e.g., replace the phrase with something like "Deployment is Railway-recommended
(preferred) but optional" and add a clarifying clause that the public Runtime,
Protocol, and Proof substrate remain paper-first and locally usable without
hosted ZERO infrastructure; ensure the updated line preserves intent but
explicitly states Railway is recommended, not required.

In `@scripts/public_readiness_gate.sh`:
- Around line 36-38: The readiness gate in scripts/public_readiness_gate.sh
currently allows CLAUDE.md and GEMINI.md as regular files; update the script to
validate that both CLAUDE.md and GEMINI.md are symlinks whose resolved target
equals AGENTS.md (use readlink/readlink -f or realpath) and fail the gate
(non-zero exit and error message) if either is not a symlink or does not point
to AGENTS.md; locate the checks for required files (the block that lists
CLAUDE.md and GEMINI.md) and add a symlink-target assertion for those filenames.

---

Outside diff comments:
In `@docs/architecture.md`:
- Around line 90-92: Summary: The sentence contains a duplicated conjunction
("and") making it awkward. Fix: Locate the sentence containing the phrase
"public profiles, and public leaderboards, and delayed public intelligence
snapshots" in docs/architecture.md and remove the extra "and" so it reads
naturally (e.g., "public profiles, public leaderboards, and delayed public
intelligence snapshots"); ensure spacing and punctuation remain correct.
🪄 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: 8df42881-91df-45aa-aa27-0d22549482a2

📥 Commits

Reviewing files that changed from the base of the PR and between 2dcae2d and 6d86029.

📒 Files selected for processing (21)
  • .github/copilot-instructions.md
  • AGENTS.md
  • README.md
  • cli/Cargo.toml
  • contracts/distribution/mcp-registry.json
  • docs/agent-architecture.md
  • docs/architecture.md
  • docs/launch-scorecard.md
  • docs/llms-full.txt
  • docs/llms.txt
  • docs/open-core-boundary.md
  • docs/positioning.md
  • docs/production-readiness.md
  • docs/public-upgrade.md
  • docs/railway-partner.md
  • docs/railway-template.md
  • engine/pyproject.toml
  • llms.txt
  • scripts/mcp_registry_packet.py
  • scripts/public_readiness_gate.sh
  • server.json

Comment thread docs/architecture.md Outdated
Comment thread docs/llms-full.txt Outdated
Comment thread docs/open-core-boundary.md Outdated
Comment thread scripts/public_readiness_gate.sh
@squaeragent squaeragent force-pushed the codex/public-runtime-doctrine-reset branch from 17803fa to 95c962d Compare May 21, 2026 12:13
@squaeragent squaeragent force-pushed the codex/public-runtime-doctrine-reset branch from 95c962d to 728b94f Compare May 21, 2026 12:28
@squaeragent squaeragent merged commit 7fe7731 into main May 21, 2026
29 checks passed
@squaeragent squaeragent deleted the codex/public-runtime-doctrine-reset branch May 21, 2026 12:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant