Skip to content

fix(onboard): advance declared commands without obsolete stamps - #796

Merged
thewrz merged 2 commits into
mainfrom
feat/issue-787
Sep 17, 2026
Merged

thewrz merged 2 commits into
mainfrom
feat/issue-787

Conversation

@thewrz

@thewrz thewrz commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator

This was written agentically; verify its assertions:

Why

Onboarding still required stamp files from the removed Stop hook, leaving repositories stuck at the declared stage even when their verification or test command was configured.

What

  • Advance onboarding when a command is declared, without obsolete stamp files.
  • Preserve the later tracked-declaration and base-branch gates.
  • Pin the no-stamp transition with onboarding and bootstrap regressions.

Decisions

This uses the issue’s simplest authorized option: a declared command is sufficient to advance the onboarding stage. The stage describes setup progress and does not certify that the command passed; command success remains a separate agent-run.sh and CI concern.

The one adversarial review raised a P2 request to require verification evidence before advancing. It was declined because that would restore the retired marker dependency that #787 explicitly permits this change to remove. The published schema-2 terminal evidence records decision: rejected and the same rationale. The three-file PR patch is byte-identical against its original base and integrated main at d60cdfd5c2cf98d88d35c3e8996544ef14349235, and none of those paths changed while main advanced. The declined adjudication therefore remains unchanged; review-ledger lineage coverage is extended to the integrated head. Per the operator’s instruction, the existing CodeRabbit approval is retained without a repeat full-review request.

Final integration metadata:

  • Integrated main commit: d60cdfd5c2cf98d88d35c3e8996544ef14349235
  • Final head: f1ad65932840347b59f02d3710ff7949f4eb921f
  • Review-ledger coverage: existing adversarial and CodeRabbit entries extended over the clean integration; final gate rechecks both

Testing

  • Onboarding regression failed before implementation and passed afterward: RED log 20260916T182921Z-test.log; GREEN log 20260916T183121Z-test.log.
  • Focused onboarding/bootstrap verification passed: log 20260916T183339Z-test.log.
  • OpenCode focused verification passed with the supported timeout scale: log 20260916T184740Z-test.log.
  • The initial full run’s sole failure was the unchanged compose-worker-prompt timeout, recorded as baseline-red in log 20260916T185138Z-test.log; this was not claimed as a full-suite pass.
  • The pre-integration head 4463b3c67e4ff7d2029cbc8fb62fa74ab0b30a7f had all four hosted checks green and CodeRabbit approval with no actionable findings.
  • Fresh local full suite passed on f1ad65932840347b59f02d3710ff7949f4eb921f: log 20260917T223828Z-test.log, duration 139 suites in 247 seconds, SHA-256 67a30b24ca60c5939da362f4f9e09eea54079b5b15c9838ea89e920284aba16e.
  • Final hosted CI for f1ad65932840347b59f02d3710ff7949f4eb921f: run 35283412531, all four checks green.
  • Record adversarial review lineage coverage after the clean main integration: existing adversarial and CodeRabbit entries extended over the clean integration; final gate rechecks both.

Summary by CodeRabbit

  • Bug Fixes
    • Onboarding state transitions now rely on command declarations rather than verification or test cache markers.
    • Verification can advance a declared repository without requiring a legacy verification stamp.
    • Feature-branch onboarding artifacts are committed correctly without a verification stamp.

Closes #787

🤖 Co-authored by Codex.

Remove the retired Stop-hook stamp requirement from onboarding state. Focused onboarding/bootstrap regressions passed; full-suite failure is disclosed as unchanged compose-worker-prompt baseline timing evidence.

Co-Authored-By: Codex <noreply@openai.com>
@coderabbitai

coderabbitai Bot commented Sep 16, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 5384c8de-ab86-4d8f-a630-812f3707bca9

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: 111069cd-c10f-43d5-b2b1-05a8e4387c44

📥 Commits

Reviewing files that changed from the base of the PR and between 6b3cd1f and 4463b3c.

📒 Files selected for processing (3)
  • agentkit/skills/.shared/scripts/onboard-state.sh
  • tests/test-bootstrap-repo.sh
  • tests/test-onboard-state.sh

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

The onboarding state gate no longer checks legacy verification or test stamp files. Tests now verify declared-command progression and use the onboarding-stage fixture.

Changes

Onboarding state transition

Layer / File(s) Summary
Remove legacy stamp gate
agentkit/skills/.shared/scripts/onboard-state.sh
The declared state is selected when no AGENT_CMD_* declaration exists, without checking verification or test stamp files.
Update onboarding state tests
tests/test-onboard-state.sh, tests/test-bootstrap-repo.sh
Verification tests use AGENT_CMD_VERIFY=true without stamp-verify. The bootstrap fixture uses onboarding-stage with discovered.

Priority: ➖ Normal

Change: Bug fix · Severity of issue fixed: Medium

Merge Risk: ⚪ Minimal · up to 4463b

The onboarding transition and regression fixtures match the intended removal of the obsolete stamp-file dependency, with no merge-blocking risk identified.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Issue #787 requires removal of the obsolete stamp gate, a declared command to advance onboarding, and a regression test. onboard-state.sh now uses command declaration as the declared to verified
Out of Scope Changes check ✅ Passed The changes stay within Issue #787. The bootstrap fixture replaces the obsolete stamp file with the current onboarding-stage marker. The onboarding-state tests remove legacy stamp setup and cover the …
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 3…
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the main change: onboarding now advances declared commands without relying on obsolete stamp files.

Comment @coderabbitai help to get the list of available commands.

@thewrz

thewrz commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator Author

This was written agentically; verify its assertions:

Adversarial review receipt

  • Reviewer: provider=anthropic; model=claude-opus-5; effort=xhigh; mode=cross-provider (reason: n/a)
  • Launcher: adversarial-run.sh sha256=4d1fc623db1b387d5d6dc0792b56ea5fcc25bf1297a77b9aca4dab243902bd50; attempt=55504c8f-3f48-467b-a204-3e981b1ae192
  • Procedure: one-shot diff review; no contract-blind or two-pass attestation
  • Counts: P1=0; P2=1; total=1
  • Reviewed head: 4463b3c
  • Diff payload: wrzonance/agent-kit:796:6dad119cc8e956914e10b73e0b100e9342aca40949dc3f87e0398ea77f4d9141
  • Confirmed finding: Require verification evidence before onboarding state advances — verdict=declined; decline rationale=Declining as contrary to the selected issue contract: issue787 explicitly offers dropping the retired stamp check as its simplest intended solution, with a declared command sufficient for advancement. This PR implements that option. Onboarding stage reports declaration/setup completion; it is not verification evidence and does not certify a passing command. Reintroducing a marker prerequisite would restore the dependency the issue intentionally removes. Relevant command success remains independently checked by agent-run and CI.
  • Execution: performed; adjudication=recorded
  • Remediation: complete

🤖 Co-authored by Codex.

@thewrz

thewrz commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator Author

This was written agentically; verify its assertions:

Review ledger

Machine-readable record of every review already performed on this PR.

{
  "version": 1,
  "pr": 796,
  "repo": "wrzonance/agent-kit",
  "reviews": [
    {
      "kind": "adversarial",
      "provider": "anthropic",
      "model": "claude-opus-5",
      "effort": "xhigh",
      "mode": "cross-provider",
      "attemptId": "55504c8f-3f48-467b-a204-3e981b1ae192",
      "launcherSha256": "4d1fc623db1b387d5d6dc0792b56ea5fcc25bf1297a77b9aca4dab243902bd50",
      "procedure": "one-shot diff review; no contract-blind or two-pass attestation",
      "reviewerOverride": "",
      "head_sha": "4463b3c67e4ff7d2029cbc8fb62fa74ab0b30a7f",
      "covered_heads": [
        "4463b3c67e4ff7d2029cbc8fb62fa74ab0b30a7f",
        "f1ad65932840347b59f02d3710ff7949f4eb921f"
      ],
      "diff_payload": "wrzonance/agent-kit:796:6dad119cc8e956914e10b73e0b100e9342aca40949dc3f87e0398ea77f4d9141",
      "findings": [
        {
          "title": "Require verification evidence before onboarding state advances",
          "severity": "P2",
          "verdict": "declined",
          "rationale": "Declining as contrary to the selected issue contract: issue787 explicitly offers dropping the retired stamp check as its simplest intended solution, with a declared command sufficient for advancement. This PR implements that option. Onboarding stage reports declaration/setup completion; it is not verification evidence and does not certify a passing command. Reintroducing a marker prerequisite would restore the dependency the issue intentionally removes. Relevant command success remains independently checked by agent-run and CI.",
          "schemaVersion": 2,
          "evidence": {
            "finding": "Require verification evidence before onboarding state advances",
            "decision": "rejected",
            "rationale": "Declining as contrary to the selected issue contract: issue787 explicitly offers dropping the retired stamp check as its simplest intended solution, with a declared command sufficient for advancement. This PR implements that option. Onboarding stage reports declaration/setup completion; it is not verification evidence and does not certify a passing command. Reintroducing a marker prerequisite would restore the dependency the issue intentionally removes. Relevant command success remains independently checked by agent-run and CI."
          }
        }
      ],
      "counts": {
        "p1": 0,
        "p2": 1
      },
      "reviewed_at": "2026-09-16T20:36:03Z",
      "coverage": [
        {
          "sha": "f1ad65932840347b59f02d3710ff7949f4eb921f",
          "reason": "merge-down:d60cdfd5c2cf98d88d35c3e8996544ef14349235",
          "covered_at": "2026-09-17T22:43:32Z"
        }
      ]
    },
    {
      "kind": "bot",
      "provider": "coderabbit",
      "head_sha": "4463b3c67e4ff7d2029cbc8fb62fa74ab0b30a7f",
      "state": "APPROVED",
      "review_id": 5228054907,
      "submitted_at": "2026-09-16T20:39:07Z",
      "covered_heads": [
        "f1ad65932840347b59f02d3710ff7949f4eb921f"
      ],
      "coverage": [
        {
          "sha": "f1ad65932840347b59f02d3710ff7949f4eb921f",
          "reason": "merge-down:d60cdfd5c2cf98d88d35c3e8996544ef14349235",
          "covered_at": "2026-09-17T22:43:34Z"
        }
      ]
    }
  ]
}

🤖 Co-authored by Codex.

@thewrz

thewrz commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator Author

@coderabbitai full review

@coderabbitai

coderabbitai Bot commented Sep 16, 2026

Copy link
Copy Markdown
✅ Action performed

Full review finished.

Carry the completed queue base into the onboarding stamp fix before final verification.

Co-Authored-By: Codex <noreply@openai.com>
@thewrz
thewrz marked this pull request as ready for review September 17, 2026 22:52
@thewrz
thewrz merged commit 8cc5f16 into main Sep 17, 2026
4 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.

fix(onboard-repo): onboard-state.sh gates declared→verify on stamp files nothing writes since the Stop hook was removed

1 participant