Skip to content

docs: explain Boatstack's supervisory runtime - #203

Merged
bigboateng merged 3 commits into
mainfrom
docs/supervisory-runtime-readme
Aug 12, 2026
Merged

docs: explain Boatstack's supervisory runtime#203
bigboateng merged 3 commits into
mainfrom
docs/supervisory-runtime-readme

Conversation

@bigboateng

Copy link
Copy Markdown
Contributor

Summary

  • explain the operator, kernel, Control Program, and Flow boundaries
  • separate the general kernel from the software-delivery domain and developer surfaces
  • document objective bindings and the state-and-receipt control loop
  • state the current alpha scope without presenting unfinished Flow ergonomics as shipped

Verification

  • python3 .github/scripts/release_notes.py validate
  • python3 -m unittest discover -s .github/tests -p 'test_*.py' -q (34 tests)
  • git diff --check

@cursor

cursor Bot commented Aug 12, 2026

Copy link
Copy Markdown

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.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Codex automated review

Verdict: patch is incorrect
Confidence: 0.98

The documentation incorrectly attributes delivery-engine idempotent replay to the generic kernel. Model-level verification is not recommended; this is directly established from the runtime and Store interfaces.

Comment thread README.md Outdated

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Codex automated review

Verdict: patch is incorrect
Confidence: 0.97

The README's new domain split incorrectly attributes software-delivery authority classes to the general kernel. Model-level verification is not recommended; correcting the documented ownership boundary and its contract test is sufficient.

Comment thread README.md Outdated

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Codex automated review

Verdict: patch is correct
Confidence: 0.98

The patch only reorganizes and clarifies README documentation, adds a matching release note, and enforces the intended kernel/domain wording boundary in the repository contract test. No actionable behavioral defect was established. Model-level verification is not recommended because no runtime control behavior changes.

@bigboateng
bigboateng merged commit 405cc98 into main Aug 12, 2026
16 checks passed
@bigboateng
bigboateng deleted the docs/supervisory-runtime-readme branch August 12, 2026 12:07
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