Skip to content

docs: correct current provider and planning semantics - #72

Merged
christopherjnelson merged 1 commit into
mainfrom
docs/correct-provider-and-planning-semantics
Sep 22, 2026
Merged

christopherjnelson merged 1 commit into
mainfrom
docs/correct-provider-and-planning-semantics

Conversation

@christopherjnelson

Copy link
Copy Markdown
Member

Summary

Documentation-only corrections left after the zero-swarm migration:

  • Planner cadence: Agent Zero makes an OpenRouter planning call only when strategic replanning is required; otherwise the last valid directive set is reused (directive-reuse). Workers make reflex decisions each active worker tick. Fixed in README, AGENTS.md, ARCHITECTURE.md, SECURITY.md, GAMEPLAY_FOUNDATION.md.
  • Provider routing: Jev runs via the TypeSafe API, not OpenRouter (Agent Zero → OpenRouter; Workers → TypeSafe Jev API).
  • Credentials: README local-dev now documents TYPESAFE_API_KEY alongside OPENROUTER_API_KEY; pnpm compare:live requires both.
  • Workspace table: packages/agent-runtime described as OpenRouter planner, TypeSafe Jev reflex provider, model catalog, and scripted testing seams.
  • Worker dispatch: GAMEPLAY_FOUNDATION no longer claims concurrent Jev calls; executeNextTick resolves workers sequentially from the frozen pre-tick state.

ADRs and ROADMAP history untouched. No code changes.

Validation

Owner-authorized local run: pnpm validate (226 tests, lint/typecheck/build clean) and pnpm test:e2e (2/2).

🤖 Generated with Claude Code

- Agent Zero plans only when strategic replanning is required, not every
  tick; otherwise the last directive set is reused with no planner call.
- jev-reflex routes to the TypeSafe API directly, not via OpenRouter.
- Document TYPESAFE_API_KEY as a required credential alongside
  OPENROUTER_API_KEY.
- Update agent-runtime workspace description to reflect both providers.
- Fix charge language so OpenRouter and TypeSafe costs are not conflated.
- Apply consistent cadence wording across README, AGENTS, ARCHITECTURE,
  SECURITY, and GAMEPLAY_FOUNDATION.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@christopherjnelson
christopherjnelson marked this pull request as ready for review September 22, 2026 22:20
@christopherjnelson
christopherjnelson merged commit fcb38d4 into main Sep 22, 2026
2 checks passed
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