Skip to content

docs: [LAU-1073] describe the manual scenario run and the release evidence - #53

Merged
sherwinski merged 2 commits into
mainfrom
sherwin/lau-1073
Sep 17, 2026
Merged

sherwinski merged 2 commits into
mainfrom
sherwin/lau-1073

Conversation

@sherwinski

Copy link
Copy Markdown
Collaborator

Summary

No shared eval harness exists. AGENT.md pointed at an internal repository and asked for 2 eval runs per release. This PR replaces that text with what a maintainer can do today:

  • How to verify a change: names the untracked evals/ directory (spec, fixtures, checkpoint-transport-test.sh) and adds check 7, the manual scenario run: fixture working copy, loopback mock with GET + 202, one Claude Code session per scenario, grade against the must and must-not columns, reset the fixture.
  • Releases step 2: the release PR records 3 results: the scenario subset against the repository tree (minimum setup_web_happy, ckpt_dirty_tree, ckpt_refusal), the Codex bundle smoke from a clean CODEX_HOME, and a green checkpoint-transport-test.sh. An automated runner replaces the first item when it exists.

Ticket

LAU-1073

Verification

  • Docs only. The 3 minimum scenarios ran by hand against main today and passed; the record is on chore: Release 1.1.0 #52.
  • bash evals/checkpoint-transport-test.sh: 195 passed, 0 failed.

Note

If this merges before #52, rerun Create Release PR so rel/1.1.0 rebases onto it.

…dence

No shared eval harness exists. AGENT.md pointed at an internal repository
and asked for 2 eval runs per release. Replace that with what a maintainer
can do today: the scenario spec and fixtures in the untracked evals/
directory, a loopback mock, one Claude Code session per scenario, and the
Codex bundle smoke. Name the minimum scenario subset for a release PR.
@sherwinski

Copy link
Copy Markdown
Collaborator Author

Updated: the eval material now lives in the separate repository sherwinski/onesignal-agent-plugin-evals. AGENT.md names it, tells the reader to clone it as evals/ and to send eval changes there, and defers the run procedure and the release subset to that repository's README so this file does not track harness details.

@kalley kalley left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Reviewed the full diff against the repository tree. The referenced paths and interfaces all check out: evals/ is gitignored, package_directory_bundle.py has both --out and --check, scripts/checkpoint.sh honors ONESIGNAL_SKILL_ENDPOINT, and the three workflow files exist. No stale references to the old internal-repo eval process remain in AGENT.md. The new check 7 and the rewritten Releases step 2 read clearly and match the code they describe.

Clean docs change. LGTM.

@sherwinski
sherwinski merged commit 75c08e9 into main Sep 17, 2026
5 checks passed
@sherwinski
sherwinski deleted the sherwin/lau-1073 branch September 17, 2026 00:23
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