From 535fea8aa2c3686d184976c1d08f701c25ce92bd Mon Sep 17 00:00:00 2001 From: Vader Yang Date: Tue, 16 Jun 2026 17:26:51 +0800 Subject: [PATCH] docs(release): pin README + examples to the first post-rename tag v0.4.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The examples used the post-rename inputs (olympus_ref) + .olympus.json but still pinned @v0.2.0 — a pre-rename tag that has no olympus_ref input and reads .agent-ops.json. So a consumer copying the examples got silent config fallback, not a working loop. Bump every "current release" reference v0.2.0 → v0.4.0 (README mechanism row + quick-start, docs/setup.md, the 6 examples/consumer wrappers). v0.4.0 is the first Olympus-named release (cut next from this commit); it reads .olympus.json and takes the olympus_ref input, so the examples are now self-consistent. docs/migration.md is intentionally left referencing v0.2.0/v0.3.1 — those are heron's real pre-rename pins and the historical migration story. Co-Authored-By: Claude Fable 5 --- README.md | 8 ++++---- docs/setup.md | 2 +- examples/consumer/.github/workflows/guard.yml | 4 ++-- examples/consumer/.github/workflows/implement.yml | 4 ++-- examples/consumer/.github/workflows/observe.yml | 4 ++-- examples/consumer/.github/workflows/pr-review.yml | 4 ++-- examples/consumer/.github/workflows/pr-revise.yml | 4 ++-- examples/consumer/.github/workflows/triage.yml | 4 ++-- 8 files changed, 17 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index eca61f8..4bc6463 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ The whole point of the extraction: | | Lives in | Versioned | Example | |---|---|---|---| -| **Mechanism** | this repo (`Netis/olympus`) | yes — tag `v0.2.0` | the triage gate logic, the warm-reply composer, the auto-merge gate, the observer's confirm-debounce, the hygiene linters | +| **Mechanism** | this repo (`Netis/olympus`) | yes — tag `v0.4.0` | the triage gate logic, the warm-reply composer, the auto-merge gate, the observer's confirm-debounce, the hygiene linters | | **Policy** | the consumer's `.olympus.json` | with the consumer | gate thresholds, label names, build command, reply language, the review bot's login, the service health URL | Upgrade the mechanism once (bump the pinned tag) and every consuming repo @@ -91,10 +91,10 @@ config-driven. field is optional ([schema](schema/olympus.schema.json)). 3. **Add the thin wrappers** from [`examples/consumer/.github/workflows/`](examples/consumer/.github/workflows/) (`triage`, `implement`, `pr-review`, `pr-revise`, `guard`, `observe`). Each - is ~15 lines that `uses: Netis/olympus/.github/workflows/.yml@v0.2.0` + is ~15 lines that `uses: Netis/olympus/.github/workflows/.yml@v0.4.0` and passes your runner labels. -4. **Pin the version**: keep the `@v0.2.0` on the `uses:` and the - `olympus_ref: v0.2.0` input in lockstep, so the workflow YAML and the +4. **Pin the version**: keep the `@v0.4.0` on the `uses:` and the + `olympus_ref: v0.4.0` input in lockstep, so the workflow YAML and the scripts it clones are the same release. See [docs/setup.md](docs/setup.md) for the full walkthrough and diff --git a/docs/setup.md b/docs/setup.md index c65449c..508989a 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -40,7 +40,7 @@ into your repo's `.github/workflows/`: | `observe.yml` | schedule (prod repos only) | self-hosted runner | Edit each wrapper's `runner_labels` to match your pool, and keep both the -`uses: ...@v0.2.0` and `olympus_ref: v0.2.0` on the **same** release. +`uses: ...@v0.4.0` and `olympus_ref: v0.4.0` on the **same** release. > `pr-review.yml` keys off a workflow named **`ci`** completing. If your CI > workflow has a different name, change `workflows: [ci]` in the wrapper. diff --git a/examples/consumer/.github/workflows/guard.yml b/examples/consumer/.github/workflows/guard.yml index 0b19275..1902407 100644 --- a/examples/consumer/.github/workflows/guard.yml +++ b/examples/consumer/.github/workflows/guard.yml @@ -8,9 +8,9 @@ on: jobs: guard: - uses: Netis/olympus/.github/workflows/guard.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/guard.yml@v0.4.0 with: - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 # Flip on once AGENT_GH_TOKEN is set, to also verify referenced # secrets are provisioned + sane: run_secret_checks: false diff --git a/examples/consumer/.github/workflows/implement.yml b/examples/consumer/.github/workflows/implement.yml index d88438c..ff9ec07 100644 --- a/examples/consumer/.github/workflows/implement.yml +++ b/examples/consumer/.github/workflows/implement.yml @@ -13,8 +13,8 @@ permissions: jobs: implement: if: ${{ github.event.label.name == 'agent:try' }} - uses: Netis/olympus/.github/workflows/implement.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/implement.yml@v0.4.0 with: - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 runner_labels: '["self-hosted","my-runner"]' secrets: inherit # + AUTO_MERGE_TEAM (optional) diff --git a/examples/consumer/.github/workflows/observe.yml b/examples/consumer/.github/workflows/observe.yml index 64343df..f46c17d 100644 --- a/examples/consumer/.github/workflows/observe.yml +++ b/examples/consumer/.github/workflows/observe.yml @@ -18,9 +18,9 @@ permissions: jobs: observe: - uses: Netis/olympus/.github/workflows/observe.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/observe.yml@v0.4.0 with: - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 runner_labels: '["self-hosted","my-runner"]' dry_run: ${{ github.event.inputs.dry_run == 'true' }} secrets: inherit diff --git a/examples/consumer/.github/workflows/pr-review.yml b/examples/consumer/.github/workflows/pr-review.yml index ceaf7f3..8257a48 100644 --- a/examples/consumer/.github/workflows/pr-review.yml +++ b/examples/consumer/.github/workflows/pr-review.yml @@ -22,9 +22,9 @@ permissions: jobs: review: - uses: Netis/olympus/.github/workflows/review.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/review.yml@v0.4.0 with: - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 runner_labels: '["self-hosted","my-runner"]' # Empty string on the workflow_run path (resolved from the run event); # the PR number you typed on a manual workflow_dispatch re-review. diff --git a/examples/consumer/.github/workflows/pr-revise.yml b/examples/consumer/.github/workflows/pr-revise.yml index 6ee8103..5cacd62 100644 --- a/examples/consumer/.github/workflows/pr-revise.yml +++ b/examples/consumer/.github/workflows/pr-revise.yml @@ -17,9 +17,9 @@ permissions: jobs: revise: - uses: Netis/olympus/.github/workflows/revise.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/revise.yml@v0.4.0 with: pr_number: ${{ inputs.pr_number }} - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 runner_labels: '["self-hosted","my-runner"]' secrets: inherit diff --git a/examples/consumer/.github/workflows/triage.yml b/examples/consumer/.github/workflows/triage.yml index 2fcc9b4..a6acca9 100644 --- a/examples/consumer/.github/workflows/triage.yml +++ b/examples/consumer/.github/workflows/triage.yml @@ -12,8 +12,8 @@ permissions: jobs: triage: - uses: Netis/olympus/.github/workflows/triage.yml@v0.2.0 + uses: Netis/olympus/.github/workflows/triage.yml@v0.4.0 with: - olympus_ref: v0.2.0 + olympus_ref: v0.4.0 runner_labels: '["self-hosted","my-runner"]' secrets: inherit # LITELLM_BASE_URL/API_KEY/NO_PROXY + AGENT_GH_TOKEN