Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
version: 2
updates:
# One grouped PR a week for every action bump. Major bumps of release-chain
# actions are reviewed and merged by hand (CORE-TOP card CR-135), never
# actions are reviewed and merged by hand, never
# auto-merged.
- package-ecosystem: github-actions
directory: /
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/facts-descriptions.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ jobs:
descriptions:
if: github.ref == 'refs/heads/main'
environment: descriptions
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
FACTS_DESCRIPTIONS_APPLY_ENABLED: ${{ vars.FACTS_DESCRIPTIONS_APPLY_ENABLED }}
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/facts-fanout.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ jobs:
web:
if: github.ref == 'refs/heads/main'
environment: release-automation
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
FACTS_WEB_DISPATCH_ENABLED: ${{ vars.FACTS_WEB_DISPATCH_ENABLED }}
Expand Down Expand Up @@ -95,7 +95,7 @@ jobs:
license:
if: github.ref == 'refs/heads/main'
environment: release-automation
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
FACTS_CONSUMER_ROLE: license
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/facts-validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ concurrency:
jobs:
authz:
name: authz
# Standard GitHub-hosted label (owner #1050); never a larger-runner label.
# Standard GitHub-hosted label; never a larger-runner label.
runs-on: ubuntu-24.04
permissions: {}
# No timeout-minutes: the owner's no-time-limits rule (check-no-time-limits refuses new ones).
Expand All @@ -33,7 +33,7 @@ jobs:
WR_HEAD_REPO: ${{ github.event.workflow_run.head_repository.full_name }}
WR_ACTOR: ${{ github.event.workflow_run.triggering_actor.login }}
GH_TOKEN: ${{ github.token }} # read-only use: one permission lookup for workflow_run
# Bot logins whose same-repository pull requests count as ours: dependabot[bot] (CI-DEPBOT A)
# Bot logins whose same-repository pull requests count as ours: dependabot[bot]
# and the org's own GitHub App bot logins by name (space-separated), nothing else.
ALLOWED_BOTS: "dependabot[bot] pineforge-app[bot]"
run: |
Expand All @@ -45,7 +45,7 @@ jobs:
# events; none of them runs pull-request code.
;;
workflow_run)
# LB-437: bind identity to the triggering run and its re-runner.
# Bind identity to the triggering run and its re-runner.
# These two App bots are fixed canon policy; ALLOWED_BOTS is PR-only.
[ -n "${WR_HEAD_REPO:-}" ] || fail "workflow_run head repository is missing"
[ -n "${WR_ACTOR:-}" ] || fail "workflow_run triggering actor is missing"
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/handle-upstream.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ permissions:

jobs:
bump:
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
steps:
Expand Down
16 changes: 8 additions & 8 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,15 +34,15 @@ concurrency:

jobs:
tag-guard:
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
permissions:
contents: read
outputs:
sha: ${{ steps.tag.outputs.sha }}
tag: ${{ steps.tag.outputs.tag }}
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down Expand Up @@ -84,7 +84,7 @@ jobs:
prepare:
needs: tag-guard
if: github.ref == 'refs/heads/main'
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
PF_CI_LABELS: '["self-hosted","pf-ci","pf-ci-x64"]'
Expand All @@ -94,7 +94,7 @@ jobs:
exists: ${{ steps.candidate.outputs.exists }}
tag: ${{ needs.tag-guard.outputs.tag }}
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand All @@ -114,7 +114,7 @@ jobs:
publish:
needs: [tag-guard, prepare]
if: needs.prepare.outputs.exists == 'false'
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
env:
Expand All @@ -125,7 +125,7 @@ jobs:
outputs:
prerelease: ${{ steps.pair.outputs.prerelease }}
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down Expand Up @@ -694,15 +694,15 @@ jobs:
failure-report:
needs: [tag-guard, prepare, publish, notify-consumers]
if: ${{ always() && !cancelled() && (needs.tag-guard.result != 'success' || contains(needs.*.result, 'failure')) }}
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
PF_CI_LABELS: '["self-hosted","pf-ci","pf-ci-x64"]'
permissions:
contents: read
issues: write
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/python-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ on:
push:
branches: [main, master]
pull_request:
# LB-387: ready_for_review starts the suites skipped on draft PRs.
# ready_for_review starts the suites skipped on draft PRs.
types: [opened, synchronize, reopened, ready_for_review]
merge_group:

Expand All @@ -23,7 +23,7 @@ concurrency:
jobs:
authz:
name: authz
# Standard GitHub-hosted label (owner #1050); never a larger-runner label.
# Standard GitHub-hosted label; never a larger-runner label.
runs-on: ubuntu-24.04
permissions: {}
# No timeout-minutes: the owner's no-time-limits rule (check-no-time-limits refuses new ones).
Expand All @@ -39,7 +39,7 @@ jobs:
WR_HEAD_REPO: ${{ github.event.workflow_run.head_repository.full_name }}
WR_ACTOR: ${{ github.event.workflow_run.triggering_actor.login }}
GH_TOKEN: ${{ github.token }} # read-only use: one permission lookup for workflow_run
# Bot logins whose same-repository pull requests count as ours: dependabot[bot] (CI-DEPBOT A)
# Bot logins whose same-repository pull requests count as ours: dependabot[bot]
# and the org's own GitHub App bot logins by name (space-separated), nothing else.
ALLOWED_BOTS: "dependabot[bot] pineforge-app[bot]"
run: |
Expand All @@ -51,7 +51,7 @@ jobs:
# events; none of them runs pull-request code.
;;
workflow_run)
# LB-437: bind identity to the triggering run and its re-runner.
# Bind identity to the triggering run and its re-runner.
# These two App bots are fixed canon policy; ALLOWED_BOTS is PR-only.
[ -n "${WR_HEAD_REPO:-}" ] || fail "workflow_run head repository is missing"
[ -n "${WR_ACTOR:-}" ] || fail "workflow_run triggering actor is missing"
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/release-finalize.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ jobs:
concurrency:
group: release-finalize
cancel-in-progress: false
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
permissions:
Expand All @@ -39,7 +39,7 @@ jobs:
deliveries: ${{ steps.delivery-output.outputs.deliveries }}
compute_configuration_error: ${{ steps.ready.outputs.compute_configuration_error }}
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down Expand Up @@ -118,7 +118,7 @@ jobs:
notify-consumers:
needs: finalize
if: ${{ needs.finalize.result == 'success' && needs.finalize.outputs.deliveries != '[]' }}
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
concurrency:
Expand All @@ -135,7 +135,7 @@ jobs:
# Private targets never enter matrix outputs, log messages or public receipts.
TARGET_REPOSITORY: ${{ matrix.consumer == 'offline' && 'pineforge-backtest-mcp' || matrix.consumer == 'hosted' && secrets.RELEASE_HOSTED_MCP_REPOSITORY || matrix.consumer == 'application' && secrets.RELEASE_APPLICATION_REPOSITORY || matrix.consumer == 'web' && secrets.FACTS_WEB_REPOSITORY || matrix.consumer == 'data' && 'pineforge-data' || matrix.consumer == 'license' && 'pineforge-license' || matrix.consumer == 'compute' && secrets.RELEASE_COMPUTE_REPOSITORY || '' }}
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/release-receipts.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ concurrency:

jobs:
plan:
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
env:
PF_CI_LABELS: '["self-hosted","pf-ci","pf-ci-x64"]'
Expand Down Expand Up @@ -45,7 +45,7 @@ jobs:
verify:
needs: plan
if: needs.plan.outputs.consumers != '[]'
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
permissions:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release-reconcile.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ concurrency:

jobs:
producers:
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
steps:
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/release-redeliver.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ permissions:
jobs:
redeliver:
if: github.ref == 'refs/heads/main'
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
# Share the normal delivery lock; two repairs cannot reuse an audit number.
Expand All @@ -37,7 +37,7 @@ jobs:
contents: write # append one neutral redelivery audit asset in this hub
issues: write
steps:
- name: Stop automatic apt upgrades (LB-504, until the release image is rebaked)
- name: Stop automatic apt upgrades (until the release image is rebaked)
shell: bash
run: |
systemctl show -p ActiveState,SubState apt-daily-upgrade.service apt-daily.service || true
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release-rollback.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ concurrency:

jobs:
restore:
# owner 10-21 (msg 1562390657274748981): pineforge-release runs on GitHub-hosted runners; R6/rule-B exception for this repo
# pineforge-release runs on GitHub-hosted runners; standing exception for this repository
runs-on: ubuntu-latest
environment: release-automation
steps:
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -197,15 +197,15 @@ Pushing a tag alone does not start publication.
The release, facts-automation and PR-CI jobs use GitHub-hosted runners.
The `authz` jobs use `runs-on: ubuntu-24.04`; the other jobs use
`runs-on: ubuntu-latest`, including candidate preparation, receipt planning and failure reporting, with these CI runner assignments: `python-test.yml` jobs `changes`, `fingerprint-canonical`, `description-renderer`, `release-ready-replay` and `release-ready` use `runs-on: ubuntu-24.04` for every configured event, including pushes to `main` and `master`. `facts-validate.yml` job `validate` uses `runs-on: ubuntu-24.04` for pull requests and pushes to `main`.
Those other jobs have the standing R6/rule-B exception (owner decision 10-21, msg 1562390657274748981).
Those other jobs use `ubuntu-latest` as a standing exception for this repository.
The [release runner policy](docs/release-chain.md#release-runner-isolation) lists
the jobs and the class boundary.

The rules live in `scripts/release_pair.py` (unit-tested in `tests/`).
`tools/release-dry-run/` replays the current handler and readiness graph offline,
including all three-component arrival orders, duplicate/lost delivery, missing
prerequisites and negative controls. Run in CI or on the approved cloud host,
never on the Mac:
never on a laptop:

```
python3 -m unittest discover -s tests -p 'test_release_*.py' # the release rules
Expand Down
24 changes: 12 additions & 12 deletions docs/release-chain.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ or deploy consumers.

## Release runner isolation

Owner decision 10-21 (msg 1562390657274748981) sets these release and facts-automation
jobs to the literal `runs-on: ubuntu-latest`, a standing R6/rule-B exception
These release and facts-automation
jobs use the literal `runs-on: ubuntu-latest`, a standing exception
for pineforge-release:

| Workflow | Jobs |
Expand All @@ -34,7 +34,7 @@ with Contents or Issues write access. The `publish.yml` reusable
`pull_request` and `pull_request_target` workflows must never use this class.
The PR jobs in `python-test.yml` and `facts-validate.yml` also use GitHub-hosted runners.
Their `authz` jobs use `runs-on: ubuntu-24.04`; the other PR jobs use
`runs-on: ubuntu-latest` per the owner decision, with these CI runner assignments:
`runs-on: ubuntu-latest` by the same standing exception, with these CI runner assignments:
`python-test.yml` jobs `changes`, `fingerprint-canonical`, `description-renderer`,
`release-ready-replay` and `release-ready` use `runs-on: ubuntu-24.04` for every
configured event, including pushes to `main` and `master`.
Expand Down Expand Up @@ -475,7 +475,7 @@ malformed entry streams are invalid evidence.

## Consumer receipt contract v1

This is the single consumer-to-hub contract for the six receipt lanes;
This is the single consumer-to-hub contract for the six receipt roles;
delivery-only compute is excluded. Implement the artifact and callback in the
consumer's trusted default-branch coordinator.
No Python knowledge is required. The hub validates both complete examples below
Expand Down Expand Up @@ -1252,7 +1252,7 @@ with a longer app default. Monitor these assets/issues, not green dispatch runs.

## Supervisor configuration

Do not enable a receipt role until its consumer lane has removed moving runtime
Do not enable a receipt role until its consumer has removed moving runtime
defaults and installed PR/CI/E2E/deploy gates; the same holds for every role.
Compute instead waits for its merged pair-validation receiver and explicit
first-pair gate. Consumer App identities must not bypass
Expand All @@ -1263,8 +1263,8 @@ suite inventory; only a verified documentation-only PR may skip suites.

The hub's `python-test.yml` and `facts-validate.yml` PR checks use GitHub-hosted
runners: `authz` uses `runs-on: ubuntu-24.04`; the other PR jobs use
`runs-on: ubuntu-latest` per owner decision 10-21 (msg 1562390657274748981),
a standing R6/rule-B exception for pineforge-release, without a `PF_CI_LABELS`
`runs-on: ubuntu-latest`,
a standing exception for pineforge-release, without a `PF_CI_LABELS`
environment variable, with these CI runner assignments:
`python-test.yml` jobs `changes`, `fingerprint-canonical`, `description-renderer`,
`release-ready-replay` and `release-ready` use `runs-on: ubuntu-24.04` for every
Expand Down Expand Up @@ -1347,7 +1347,7 @@ A member's own fork fails the canonical authz check.
The existing `merge_group` trigger remains
configured and passes the canonical authz script. macOS stays hosted
(no hardware); this repository has no macOS jobs. Credential/release jobs
use `ubuntu-latest` per owner decision 10-21, including publication workflows.
use `ubuntu-latest` by the same standing exception, including publication workflows.

| Name / setting | Scope | Purpose |
|---|---|---|
Expand Down Expand Up @@ -1470,7 +1470,7 @@ names. Do not use the example E2E/deploy inventories as production gates.
```

Supervisor must populate the **actual complete expected job names**, including
matrix expansions, from each reviewed consumer lane. A tiny example inventory
matrix expansions, from each reviewed consumer. A tiny example inventory
must never be used to omit existing required checks.

Rollout order for the application `post_merge` section: a receipt must carry
Expand Down Expand Up @@ -1565,7 +1565,7 @@ readback. Newer aliases are left alone. Fixed tags, images, source assets and
manifests are preserved. If no previous good alias exists, it reports incomplete
repair rather than deleting an alias or inventing a good target. **A hub rollback
sends no consumer signal.** Consumers may keep the rejected release while hub
aliases revert, so mixed versions are possible. Each consumer lane owns its
aliases revert, so mixed versions are possible. Each consumer owns its
explicit rollback and served-state verification; coordinate those rollbacks
separately.

Expand All @@ -1576,11 +1576,11 @@ truthful hosted receipts and red cases for source trust, binding and candidate
replacement, archive digests, PR/head/base/attempt mismatches and inventory
changes, plus regressions for the original exact-SHA path. The existing
`test_release_*.py` discovery includes it in CI. These tests are written for
CI/cloud execution and are not run on the Mac; local validation is limited to
CI/cloud execution and are not run on a laptop; local validation is limited to
Python compilation and `git diff --check` (plus YAML parsing if a workflow
changes).
No test suite, Docker runtime/build, live dispatch, publication, token mint,
credential read or deployment is needed on the Mac to implement this lane.
credential read or deployment is needed on a laptop to implement this change.

## Running the image: scratch space (engine 1.7.0)

Expand Down
Loading
Loading