Skip to content

docs: System One / Jev typed review layer (M11, proposed) - #38

Draft
dancingteeth wants to merge 1 commit into
mainfrom
cursor/system-one-jev-review-docs-5b2c
Draft

dancingteeth wants to merge 1 commit into
mainfrom
cursor/system-one-jev-review-docs-5b2c

Conversation

@dancingteeth

Copy link
Copy Markdown
Owner

Summary

Documents an optional third review layer for Agent Looper: OpenRouter System One / TypeSafe Jev as typed decisions (noul / choice / score) over fenced loop state — not a reviewRuntime or chat judge.

Locked product decision: generative judges remain responsible for review.md, reviewGate prose, Guide packets, and agent-loop-prompt scaffold authorship. Jev complements verify + generative review; it does not replace them.

Changes

File What
docs/loop-review-patterns.md Backbone note + pattern 9 (typed layer beside generative review)
docs/loop-review-roadmap.md M11 milestone (Proposed): problem, config sketch, gates, acceptance, file touch list; priority row #6; proposed TW row (no UUID)
docs/system-one-review.md API/config sibling: models typesafe/jev-1.13 / ~typesafe/jev-latest, decisions endpoint, systemOne.gate, non-goals, contrast with shipped reviewSecondaryRuntime
docs/runtime-map.md Short pointer that Jev is not a runtime table row

No TypeScript implementation in this PR.

Alignment with shipped behavior

  • Documents that reviewSecondaryRuntime (M3) is still generative markdown merge.
  • Notes reviewGate: true → secondary runs even on primary PASS (per current harness); System One is orthogonal.

Test plan

  • Docs review: product decision (not reviewRuntime) is consistent across all four files
  • Model ids exact: typesafe/jev-1.13, ~typesafe/jev-latest
  • systemOne.gate semantics: advisory fail-open vs block fail-closed on API/parse errors
  • Non-goals: minmax, scaffold author, chat reviewModel
  • Cross-links resolve (system-one-review.md, patterns §9, roadmap M11)
Open in Web Open in Cursor 

Document optional systemOne config beside verify and generative review.
Clarify Jev is not reviewRuntime; OpenRouter decisions API and gate modes.
Extend loop-review patterns/roadmap; add system-one-review.md sibling.

Co-authored-by: Paul Zgordan <dancingteeth@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Sep 21, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

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.

This branch has not been deployed

No deployments
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