paperclip/scripts
Dotta af8439a70b
feat(runner): restore direct live eval campaigns and reports (#12909)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - The Runner executes agents through native and managed provider
drivers.
> - The direct live eval layer had drifted from the current Runner
contracts.
> - The old local workflow did not provide a complete parallel campaign
or durable report history.
> - The Runner also needed current native OpenCode and OpenRouter
qualification.
> - This pull request restores the direct campaign, corrects the runtime
gaps that the campaign found, and adds safe hosted Evalbook history.
> - The benefit is repeatable model comparison against an immutable
Runner and eval source revision.

## Linked Issues or Issue Description

Refs #11297
Refs #11634

**What existing behavior does this improve?**

This improves the direct live `paperclip-runner` eval workflow, provider
execution contract, and static Evalbook reporting path.

**Current behavior**

The direct evals do not have one maintained full campaign on current
`master`. OpenCode has no qualified multi-model OpenRouter roster.
Parallel provider bursts can compact committed events before the
transport observes them. Local reports do not have a separate safe S3
history index.

**Proposed behavior**

Run one immutable roster-plus-case matrix. Use the shared paid AWS
runner fleet. Keep raw artifacts access-controlled. Publish a sanitized
canonical Evalbook report under the separate `runner-protocol-evals` S3
prefix. Keep immutable campaign directories plus root history, latest,
and latest-green pointers.

**Reason and benefit**

Maintainers can compare native Codex, native OpenCode, ACPX, Claude
Managed, and AWS AgentCore behavior over time. They can inspect failures
without mixing this direct protocol layer with browser full-stack E2E.

**Breaking changes**

None. The new workflow and S3 prefix are additive. The existing Runner
full-stack E2E workflow and report remain separate.

## What Changed

- Added a trusted two-shard direct live workflow for up to 393
roster-plus-case cells.
- Reused the numeric actor allowlist, protected paid environment, and
RunsOn fleet controls from Runner full-stack E2E.
- Added immutable Runner and eval revision resolution, exact credential
boundaries, bounded retries, and cost ceilings.
- Added a public report projection that removes sessions, transcripts,
tool payloads, state, traces, raw failures, remote profile identities,
and credential-shaped values.
- Added additive S3 history under `runner-protocol-evals`, with
immutable campaigns and mutable root index pointers.
- Added native OpenCode model injection and current OpenRouter pricing
contracts.
- Fixed direct eval completion, workflow execution, semantic discovery,
warm-attach state reset, executable binding, and event-burst handling.
- Kept Runner browser full-stack E2E behavior and publication separate.
- Documented local and hosted direct eval operation.

## Verification

- `pnpm --filter @paperclipai/paperclip-runner
test:runner-protocol-eval-publish` — 15 passed.
- `pnpm --filter @paperclipai/paperclip-runner build:typescript` —
passed.
- `actionlint .github/workflows/runner-protocol-live-evals.yml
.github/workflows/runner-full-stack-e2e.yml` — passed.
- Local current matrix at the revision in
[paperclip-evals#17](https://github.com/paperclipai/paperclip-evals/pull/17)
— 323 cells across 10 enabled configurations completed.
- Final local current matrix — 269 passed, 11 behavior failures, and 43
expected macOS-only ACPX platform failures.
- Targeted Runner checks — 13/13 eval-session tests, 15/15
publisher/security tests, and package typecheck passed; complete PR CI
is green, including all browser E2E shards.

## Risks

- Paid live campaigns can consume provider budget. Actor authorization,
exact per-cell ceilings, protected environments, and explicit schedule
enablement bound this risk.
- Public reports can leak provider data. The workflow publishes only a
separately projected report and validates every file before upload.
- The new workflow cannot publish until it is present on the default
branch. This pull request does not change the existing
`runner-full-stack-e2e` publication path.
- The campaign is large. It uses two GitHub matrices and caps combined
concurrency at the shared fleet limit.

> For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and
discuss it in `#dev` before opening the PR. Feature PRs that overlap
with planned core work may need to be redirected — check the roadmap
first. See `CONTRIBUTING.md`.

## Model Used

OpenAI Codex on GPT-5. The exact deployment ID and context-window size
are not exposed. The model used reasoning, code editing, browser
inspection, repository tools, and live provider execution.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] All Paperclip CI gates are green
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge
2026-09-05 20:18:11 -05:00
..
__tests__ feat(runner): restore direct live eval campaigns and reports (#12909) 2026-09-05 20:18:11 -05:00
install-sh-fixtures
mcp-fixtures
smoke feat(apps): unify permissions and action testing (#12802) 2026-09-03 21:23:26 -05:00
acpx-patch-packaging.test.mjs feat(runner): add SDK and developer tooling (#12608) 2026-08-31 21:33:11 -05:00
assert-cloud-image-sentry.mjs Install the declared Sentry server package into the hosted image (#12330) 2026-08-27 19:10:49 -07:00
assert-orphan-reaping.sh
backfill-issue-reference-mentions.ts
backup-db.sh
bootstrap-npm-package.mjs
bootstrap-npm-package.test.mjs
build-npm.sh
build-standalone-public-packages.mjs
capture-pap-2351-binding-picker.mjs
check-docker-deps-stage.mjs
check-forbidden-tokens.mjs
check-module-boundaries.mjs refactor(server): extract the active-run output watchdog into a feature module (#12853) 2026-09-05 09:15:59 -07:00
check-module-boundaries.test.mjs refactor(server): extract the active-run output watchdog into a feature module (#12853) 2026-09-05 09:15:59 -07:00
check-no-git-push.mjs
check-no-git-push.test.mjs
check-node-version-policy.mjs
check-release-package-bootstrap.mjs
check-release-package-bootstrap.test.mjs
check-task-chat-motion.mjs
check-token-gates.mjs
clean-install-git.sh
clean-install-npm.sh
clean-onboard-git.sh
clean-onboard-npm.sh
clean-onboard-ref.sh
cli-bundled-npm-dependencies.mjs
codemod-extract-colors.mjs
codemod-extract-misc.mjs
codemod-extract-sizes.mjs
codemod-extract-type.mjs
codemod-type-ladder.mjs
create-github-release.sh
dev-both.mjs
dev-runner-native-binary.mjs feat(runner): integrate Codex native execution (#12616) 2026-08-31 22:51:17 -05:00
dev-runner-options.ts
dev-runner-output.mjs
dev-runner-output.ts
dev-runner-paths.mjs
dev-runner-snapshot.mjs
dev-runner.mjs
dev-runner.ts fix(runner): recover native sessions across restarts (#12845) 2026-09-04 15:03:53 -05:00
dev-service-profile.ts
dev-service.ts
discord-daily-digest.sh
docker-build-test.sh
docker-entrypoint.sh
docker-onboard-smoke.sh Follow the current onboarding arc in the release smoke (#12423) 2026-08-28 07:21:08 -07:00
docker-onboard-smoke.test.mjs Follow the current onboarding arc in the release smoke (#12423) 2026-08-28 07:21:08 -07:00
draft-stable-notes.sh
draft-stable-notes.test.mjs
e2e-install-lifecycle.sh
e2e-mcp-user-stories.mjs
e2e-shard-durations.json test(e2e): shorten and split Smoke Lab coverage (#12506) 2026-08-31 10:15:39 -05:00
e2e-shard.mjs
e2e-update-migrations.sh
ensure-plugin-build-deps.mjs
ensure-workspace-package-links.ts
extract-proposed-events.mjs
extract-proposed-events.test.mjs
general-server-shard-durations.json feat: add Grok device login to the sandbox login panel (#12469) 2026-08-28 21:48:34 -07:00
general-server-shard.mjs
generate-company-assets.ts
generate-feature-catalog.ts
generate-npm-package-json.mjs
generate-org-chart-images.ts
generate-org-chart-satori-comparison.ts
generate-plugin-package-json.mjs
generate-ui-package-json.mjs
ingest-app-definitions.mjs feat(apps): refine Postman and Shopify setup (#12357) 2026-08-29 12:08:35 -05:00
install.sh
kill-agent-browsers.sh
kill-dev.sh
kill-vitest.sh
kill-workspaces.sh
link-plugin-dev-sdk.mjs
link-plugin-dev-sdk.test.js
measure-issue-chat-long-thread.mjs
migrate-inline-env-secrets.ts
paperclip-commit-metrics.ts
paperclip-issue-update.sh
prepare-bundled-package.mjs fix(release): omit dev dependencies from bundle staging (#12584) 2026-08-31 08:52:40 -05:00
prepare-server-ui-dist.sh
provision-worktree-runtime.sh fix(scripts): silence pnpm DEP0169 at provisioning install call sites (#12228) 2026-08-26 10:42:13 -07:00
provision-worktree.sh fix(scripts): silence pnpm DEP0169 at provisioning install call sites (#12228) 2026-08-26 10:42:13 -07:00
release-lib.sh fix(release): skip lifecycle scripts for bundle staging (#12585) 2026-08-31 09:14:08 -05:00
release-lib.test.mjs fix(release): skip lifecycle scripts for bundle staging (#12585) 2026-08-31 09:14:08 -05:00
release-package-manifest.json
release-package-map.mjs
release-package-map.test.mjs
release-registry-versions.mjs
release-registry-versions.test.mjs
release.sh
repair-pr-prep-workspace-attachment.mjs
request-hot-restart.ts
rollback-latest.sh
run-typecheck-build-gaps.mjs
run-vitest-stable.mjs feat: add Grok device login to the sandbox login panel (#12469) 2026-08-28 21:48:34 -07:00
screenshot-blocked-inbox.mjs
screenshot-file-viewer.mjs
screenshot-fork-flow.mjs
screenshot-notion-connect-flow.mjs
screenshot-one.mjs
screenshot-pap2373.mjs
screenshot-recovery-card.cjs
screenshot-subissues.mjs
screenshot-verdicts.mjs
screenshot.cjs
serialized-shard-durations.json
serve-storybook-static.mjs
service-onboard-smoke.sh
service-onboard-smoke.test.mjs
storybook-visual-baseline.mjs
test-install-sh-docker.sh
verify-release-registry-state.mjs
verify-release-registry-state.test.mjs