F14.1 — Discovered pipeline
| State | Closed |
| Parent | E14 |
| Iteration | Release 2 |
| Start Date | 2026-09-28 |
| Closed Date | 2026-10-03 |
| Predecessors | F9.3 (change scoping and partial-run handling), F9.5, F9.9 |
Stories: 5 Closed
| Story | State | Depends on |
|---|---|---|
| S14.1.1 — Decide discovery and configuration | Closed (2026-09-28) | — |
| S14.1.2 — Planner script | Closed (2026-09-28) | — |
| S14.1.3 — Workflow on the plan | Closed (2026-10-03) | — |
| S14.1.4 — Kiln handoff | Closed (2026-09-28) | — |
| S14.1.5 — Runbooks | Closed (2026-09-28) | — |
Outcome: main.yml and sonar-project.properties stopped naming packages;
one planner script read the workspace and drove every CI job (closed
2026-10-03).
Design
Outcome: the planner began as .github/scripts/workspace_ci.py and moved
into the rn-forge-devops package
(F16.1). Release gating kept the
S9.3.2 decision: a failed check blocks only its package and the selected
packages that depend on it.
Considered and rejected
- Generating the YAML from a template (kiln codegen). This keeps a named job per package in the Actions UI. But the file goes stale until it is regenerated, which is the drift this feature removes.
- A reusable workflow in a shared repository. This is the eventual home once more than pykit uses it. Until then, pykit carries the reference copy and kiln's templates copy it (S14.1.4).
- Releasing only when every check passes. This is simpler, but it reverses the owner's S9.3.2 decision that a failure blocks only its dependents.
S14.1.1 — Decide discovery and configuration
State: Closed (2026-09-28)
Acceptance: this feature's Design records the source of each package list,
the [tool.workspace-ci] tables and the release gating.
S14.1.2 — Planner script
State: Closed (2026-09-28)
Acceptance: workspace_ci.py replaces changed_packages.py and
check_django_extra.py. plan selects the same packages as
changed_packages.py for each of the last 40 commits. releasable withholds a
package whose marker is missing, and every selected dependent of it. smoke
passes for rn-forge-django's extras and exits non-zero when a module fails to
import.
S14.1.3 — Workflow on the plan
State: Closed (2026-10-03)
Acceptance:
main.ymlnames no package, and_package-ci.ymlis gone.actionlintpasses.sonar-project.propertieslists no package.- A pull request run shows
verifyfor each selected package,postgresandsmokeforrn-forge-django,suite (scaffold),releasebuilding without tagging, andci-okpassing. - The first push to
mainafter the merge tags only packages whose version changed.external-installanddocshandle those tags as before.
set -euo pipefail
absent() { local rc=0; rg -q --hidden --glob '!.git' "$@" </dev/null || rc=$?; [ "$rc" -eq 1 ]; }
absent 'rn-forge-|rn_forge' .github/workflows/ci.yml
test ! -e .github/workflows/_package-ci.yml
actionlint .github/workflows/ci.yml
The pull-request and main runs are checked on GitHub.
Amended 2026-10-03: making ci-ok the required check is repository
configuration, not repo content, and moved to ideas, and was done on 2026-10-03.
GitHub reported main as not protected until then.
Outcome: PR 4's rerun at 8d62729 passed every job and the push to main
at ca04bca tagged nothing, as no version changed (2026-10-03).
S14.1.4 — Kiln handoff
State: Closed (2026-09-28)
Acceptance: .github/workspace-ci-handoff.md lists the files kiln's golden
templates copy, the [tool.workspace-ci] settings a generated repository
declares, and the assumptions the workflow makes. Kiln's adoption is kiln's work
and does not gate this feature (ADR-0008).
S14.1.5 — Runbooks
State: Closed (2026-09-28)
Acceptance: the release runbook describes the plan, the matrices and release gating. Step 5 of adding a package no longer asks for workflow edits.
Acceptance
- This feature's Design records the source of each package list, the
[tool.workspace-ci]tables and the release gating (S14.1.1). workspace_ci.pyreplaceschanged_packages.pyandcheck_django_extra.py, withplan,releasableandsmokebehaving as Design states (S14.1.2).main.ymlandsonar-project.propertiesname no package,_package-ci.ymlis gone, and a pull request and a push tomainrun the plan-driven jobs and tag correctly (S14.1.3)..github/workspace-ci-handoff.mdlists the files, settings and assumptions kiln's templates need (S14.1.4).- The release and adding-a-package runbooks describe the new pipeline and no longer ask for hand-written workflow edits (S14.1.5).
Open questions
- Answered (S16.3.1):
rn-forge-sqlalchemydeclares[tool.workspace-ci.integration.postgres]and exposes a barepostgresql://DSN asRN_FORGE_TEST_POSTGRES_DSN. Itsconftest.pyswaps in theasyncpgdriver, so no URL scheme is needed. Theintegration (rn-forge-sqlalchemy)job runs itspostgres-marked tests: onmainatc3a16a4it passed 167 tests to the plain test job's 99.