Skip to content

docs: document readiness and surveillance semantics - #413

Merged
seonghobae merged 3 commits into
mainfrom
cursor/readme-buyer-operator-2445
Aug 17, 2026
Merged

docs: document readiness and surveillance semantics#413
seonghobae merged 3 commits into
mainfrom
cursor/readme-buyer-operator-2445

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Preserves the unique operator/readiness documentation from the earlier buyer-README branch after PR #415 became the canonical customer-facing README implementation.

The branch was non-destructively reconstructed on protected main 58af7cfcb8f171bcef7bf0b7e3d6d9bd3090ef7a; README, CONTRIBUTING and CHANGELOG now come from protected main rather than competing with #415.

Current bounded delta

  • docs/api-spec.md documents /health as liveness-only and adds the public GET/HEAD /ready contract, including 200 ready, 503 ERR_SERVICE_NOT_READY, Retry-After, method and readiness headers while preserving newer protected repository-path validation text.
  • docs/deployment-guide.md requires /ready before /exchange traffic and includes readiness in smoke verification.
  • docs/onboarding.md includes standalone readiness verification and explicitly does not require Naruon.
  • docs/acquisition-readiness-2b.md distinguishes scheduled acquisition surveillance (NOT_READY evidence) from fail-closed manual/local audit.
  • docs/saleable-program-goal-registry.md documents the same surveillance boundary and the security-validation checklist gate.
  • docs/saleable-program-readiness.md records that buyer README procedure moved to CONTRIBUTING.md/docs/.

Supersession / ownership

PR #415 already integrated the customer-facing README and relocated agent procedure. This PR no longer modifies README, CONTRIBUTING or CHANGELOG and does not race canonical architecture/documentation PR #71.

No runtime, workflow, release, deployment, legal-rights or acquisition-ready claim is introduced.

Current exact head

ee2b1c1800c0fa7c8b1ede097e76f5ab42bd52a4

Fresh exact-head CI/reviewer/Security evidence must pass on this unchanged head before Ready/merge classification. Predecessor evidence does not transfer.

Move exact-head, hourly commercial, and acquisition-audit procedure out of
the product README into CONTRIBUTING and existing docs. Keep MSA: Noema
runs alone without Naruon; siblings call /exchange and the review runtime
uses the contextual-orchestrator gateway.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 17, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@seonghobae, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 29 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 25e4030b-9f38-4e60-a5f4-07c072caf19b

📥 Commits

Reviewing files that changed from the base of the PR and between 58af7cf and ee2b1c1.

📒 Files selected for processing (6)
  • docs/acquisition-readiness-2b.md
  • docs/api-spec.md
  • docs/deployment-guide.md
  • docs/onboarding.md
  • docs/saleable-program-goal-registry.md
  • docs/saleable-program-readiness.md

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.

@seonghobae seonghobae changed the title docs: rewrite README for independent buyer/operator run docs: document readiness and surveillance semantics Aug 17, 2026
@seonghobae
seonghobae marked this pull request as ready for review August 17, 2026 19:15
@cursor

cursor Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@seonghobae
seonghobae merged commit acf16c1 into main Aug 17, 2026
16 checks passed
@seonghobae
seonghobae deleted the cursor/readme-buyer-operator-2445 branch August 17, 2026 19:15
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.

2 participants