feat(protocol): add universal agent session entrypoint - #167
Merged
Conversation
FOLLOWING_AGENTS_PROTOCOL Assisted-by: Codex:gpt-5 [Codex]
Route every session through a non-interactive, state-aware entrypoint before preflight. Keep the compact welcome source-owned and first-time-only, project real role branch/worktree state, and bind the ordering across protocol surfaces with mutation coverage. FOLLOWING_AGENTS_PROTOCOL Assisted-by: Codex:gpt-5 [Codex]
FOLLOWING_AGENTS_PROTOCOL Assisted-by: Codex:gpt-5 [Codex]
Record the approved review-until-PASS contract, synchronize its public checkpoint and project positioning, and restore the landing-page size ratchet without changing benchmark claims. FOLLOWING_AGENTS_PROTOCOL Following-Agents-Protocol: true AI-Assisted: true Assisted-by: Codex:GPT-5 [Codex]
Point strict trailer enforcement at the committed review-continuation spec so the cutover remains fail-closed and reachable after the policy-history squash. FOLLOWING_AGENTS_PROTOCOL Following-Agents-Protocol: true AI-Assisted: true Assisted-by: Codex:GPT-5 [Codex]
Bind actionable reviewer failures to fresh implementation, both gates, and fresh scoped review until PASS. Close generic retry-budget and blocker escapes in the operator contract. FOLLOWING_AGENTS_PROTOCOL Following-Agents-Protocol: true AI-Assisted: true Assisted-by: Codex:GPT-5 [Codex]
localai-bot
marked this pull request as ready for review
August 8, 2026 21:45
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Row
SESSION-ONBOARDING-UX— governance/session-entrypoint row.Before starting
SESSION-ONBOARDING-UXin this worktree.scripts/ready-for-helper.pyresult when applicable: governance-only protocol work specified by.agents/specs/session-onboarding.md;python3 scripts/ready-for-helper.py --check-localreturnedOK: LOCAL_ONLY readiness structure validated; live claims were not verified and no helper queue was advertised.scripts/agent-role.py,scripts/agent-onboard.py,scripts/agent-preflight.sh,.agents/workflow.md,.agents/prompts/operator.md, and their mutation suites undertests/scripts/.What changed
Adds a universal, non-interactive
scripts/agent-start.pysession entrypoint. It emits a source-owned ASCII welcome only when no role and no explicit intent exist, explains Helper/Operator/Looking roles, reports truthful inherited state, and routes the agent through declaration, rerun, preflight, and resume. It also strengthensPOL-REVIEW-NO-REPAIR: every actionable in-scope review failure must return to a fresh implementer, run focused and full gates, and receive a fresh scoped review until PASS; retry budgets cannot terminate correctable findings.Evidence
scripts/agent-preflight.sh && git push -u origin row/SESSION-ONBOARDING-UX-IMPLexited 0 withAll gates green; the push executed only after the gate passed.python3 -m unittest tests.scripts.test_agent_start tests.scripts.test_agent_onboard tests.scripts.test_policy_contract tests.scripts.test_check_prompt_contract tests.scripts.test_check_protocol_consistencyran 156 tests:OK.3337bda3, ran eight targeted scratch mutations plus one full preflight, and returnedPASSwith no findings.docs/STATUS.mdanddocs/BENCHMARKS.md;docs/FEATURES.mdis unchanged because no feature/model/backend/quantization surface moved.Speed claims
${GPU_LOCK}and they are recorded indocs/BENCHMARKS.mdwith the repro recipe.Honest gaps
.sdd-state.json,docs/spec/) is intentionally excluded from the branch.