Skip to content

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.yml names no package, and _package-ci.yml is gone. actionlint passes.
  • sonar-project.properties lists no package.
  • A pull request run shows verify for each selected package, postgres and smoke for rn-forge-django, suite (scaffold), release building without tagging, and ci-ok passing.
  • The first push to main after the merge tags only packages whose version changed. external-install and docs handle 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.py replaces changed_packages.py and check_django_extra.py, with plan, releasable and smoke behaving as Design states (S14.1.2).
  • main.yml and sonar-project.properties name no package, _package-ci.yml is gone, and a pull request and a push to main run the plan-driven jobs and tag correctly (S14.1.3).
  • .github/workspace-ci-handoff.md lists 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-sqlalchemy declares [tool.workspace-ci.integration.postgres] and exposes a bare postgresql:// DSN as RN_FORGE_TEST_POSTGRES_DSN. Its conftest.py swaps in the asyncpg driver, so no URL scheme is needed. The integration (rn-forge-sqlalchemy) job runs its postgres-marked tests: on main at c3a16a4 it passed 167 tests to the plain test job's 99.