diff --git a/CHANGELOG.md b/CHANGELOG.md index 5296875..fa71ac6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,14 @@ trace, study, receipt, API and database schema versions. ## [Unreleased] +### Documentation + +- The README points to the Codex and Claude Code runners, and its standalone + executable download examples use 0.2.5. +- npm release instructions require allowing direct `npm publish` for the + trusted publisher and explain the `E404` that npm returns when no trusted + publisher matches the workflow run. + ## [0.2.5] - 2026-11-18 ### Added diff --git a/README.md b/README.md index cb57564..236da5a 100644 --- a/README.md +++ b/README.md @@ -107,6 +107,10 @@ baseline, the frozen session, an interleaved before/after capture and the verdict in one command. Pass the unchanged runner as repeated `--before-arg` values and the changed runner after `--`. See [comparing two versions in one command](https://dipeshbabu.github.io/agentloop/GUIDED_OPTIMIZATION/#compare-two-versions-in-one-command). +Example runners for [OpenAI Codex CLI](https://dipeshbabu.github.io/agentloop/CODEX/) +and [Claude Code](https://dipeshbabu.github.io/agentloop/CLAUDE_CODE/) turn each +coding-agent run into a native trace, so the same workflow compares models, +instructions or settings for those agents. To connect your application, run `agentloop improve init --agent my_agent:answer` in its project directory. The generated adapter supports synchronous and async @@ -397,13 +401,13 @@ where the examples show `agentloop`. Download and verify a standalone executable Download the executable and `SHA256SUMS` from the same release. These examples use -version 0.2.0. Change the version when choosing another release. +version 0.2.5. Change the version when choosing another release. Linux (Bash): ```bash set -euo pipefail -version=0.2.0 +version=0.2.5 asset="agentloop-v${version}-linux-x86_64" curl --fail --location --remote-name "https://github.com/dipeshbabu/agentloop/releases/download/v${version}/${asset}" curl --fail --location --remote-name "https://github.com/dipeshbabu/agentloop/releases/download/v${version}/SHA256SUMS" @@ -420,7 +424,7 @@ chmod +x "$asset" Windows PowerShell: ```powershell -$Version = "0.2.0" +$Version = "0.2.5" $Asset = "agentloop-v$Version-windows-x86_64.exe" Invoke-WebRequest "https://github.com/dipeshbabu/agentloop/releases/download/v$Version/$Asset" -OutFile agentloop.exe Invoke-WebRequest "https://github.com/dipeshbabu/agentloop/releases/download/v$Version/SHA256SUMS" -OutFile SHA256SUMS diff --git a/docs/RELEASING.md b/docs/RELEASING.md index b1b5d27..986f3f6 100644 --- a/docs/RELEASING.md +++ b/docs/RELEASING.md @@ -150,7 +150,11 @@ One-time setup, after the first publish exists on npm: 1. On npmjs.com, open the package's **Settings → Trusted publishing** and add GitHub Actions with repository `dipeshbabu/agentloop`, workflow - `release-npm.yml` and environment `npm`. + `release-npm.yml` and environment `npm`. Tick **Allow npm publish**: without + it the publisher may only stage versions, and the workflow's direct + `npm publish` is refused. Saving asks for two-factor authentication; if npm + asks partway through, the form is discarded, so check that the publisher is + listed afterwards. It shows **Pending validation** until the first publish. 2. In the GitHub repository, create the `npm` environment and set the repository variable `NPM_PUBLISH_ENABLED` to `true`. @@ -165,6 +169,12 @@ npm pack --dry-run npm publish --access public ``` +If the workflow signs provenance and then fails with `E404 Not Found - PUT +https://registry.npmjs.org/agentloop-profiler`, npm found no trusted publisher +matching the run. Check the repository, workflow filename and environment on +the package's settings page, then re-run the failed job; the tag does not need +to change. + npm versions are immutable: a published version cannot be re-uploaded, and unpublishing is restricted after 72 hours. Fix mistakes with a new patch version. Verify publication in a fresh directory: diff --git a/docs/TYPESCRIPT_RELEASE_PROPOSAL.md b/docs/TYPESCRIPT_RELEASE_PROPOSAL.md index 3f7ef4c..57fb3f0 100644 --- a/docs/TYPESCRIPT_RELEASE_PROPOSAL.md +++ b/docs/TYPESCRIPT_RELEASE_PROPOSAL.md @@ -1,5 +1,9 @@ # TypeScript SDK: first npm release proposal +> **Status:** completed. `agentloop-profiler@0.1.0` was first published on +> 2026-11-14, and 0.1.1 was published on 2026-11-19 by `release-npm.yml` through +> npm trusted publishing with provenance. This page is kept as the review record. + Proposed package: `agentloop-profiler@0.1.0`. This proposal does not publish it. The maintainer approved the first publication on 2026-11-14; see [Releasing](RELEASING.md#typescript-sdk-on-npm) for the npm release flow.