Changelog#
All notable changes to Preflight are recorded here. Entries follow Keep a Changelog; released versions are Git tags.
Unreleased#
- Changed: the
proctorandmysql56-migratecomponents default to PHP 8.5 (php:8.5-cli-trixie, pinned by digest), the stack's default PHP line (D-113); both still run on PHP 8.3 or later through theimageinput. - Changed: the
a11ycomponent's default Playwright image is the new v1.65.0-noble digest; the README, the a11y guide and the components reference show it. - Changed: the
renovatecomponent's default Renovate image is 44.251.0 (pinned by digest); the README, the renovate guide and the components reference show it. - Changed:
deploy/requires PROCTOR^0.16(was^0.15, which does not allow 0.16), whoseci-pipelinescheck no longer asks for a GitHub workflow (D-069). - Docs: three gap-list citations in BEST_PRACTICES point at the lines they name again.
- Changed: the deploy kit is Squire 0.11.1 (was 0.10.7): the release script, parity scripts, HAProxy pin and fallback base follow the new templates; the
squire-kitfixture keeps its own track. - Docs: the README, guides and examples pin 0.9.0 (commit fb73b53).
- Site: the front page and README art pin 0.9.0. The quick start, every placard, the flight plan and the GitHub workflow pin the 0.9.0 tag commit (they still pinned 0.8.0's), the placards say "in 0.9.0", and the components note names what is new in 0.9.0 in one line.
composer-cigets the tenth placard ("Ten checks, one include each"), besidephp-package.yml, its GitHub twin, and the flight plan's first box says when to add it;proctor's placard listscheck_path. The type certificate data sheet moves toproctorand is amended to 0.9.0: the change bar markscheck_path, the log lists everyproctorrevision, a continuation table carries the two widened patterns (config_pathtakes.gitleaks.toml,php_advisory_versiontakes8.6-rc), and the terminal shows the realgit diff -U0 0.8.0 0.9.0for those lines. The README art kit'sCOMPONENT_TAGis 0.9.0 (the checklist panel lists sixteen components, the badge reads 16, the hero is a fresh capture), and the three phone crops the gallery uses are recaptured: they still showed the 0.1.0 page. - Added:
tests/FrontPagePinsTest.php(incomposer ci) holds the front page to the release: every Preflight pin onsite/index.htmlnames one commit and one tag, the same pair the README pins; every placard and the README art kit'sCOMPONENT_TAGname that tag; and the tag is the newest## x.y.zin this file (or the one before, on the release commit itself, which cannot pin its own SHA). Where git can see the tags it also checks the commit is the tag's and fails a page still on the old release once HEAD has moved past the new tag. The page went a whole release on 0.8.0 because nothing checked; the tail number now has to match the logbook. - Fixed: tests/PipelineInputsTest.php now runs in composer ci; phpunit.xml lists test files one by one and had left it out, so the 0.9.0 promise that it was in composer ci did not hold.
- Fixed: tests/PipelineInputsTest.php builds each spec regex with a delimiter the regex does not contain; with a slash, every path-shaped regex failed to compile and read as a mismatch.
0.9.0 (2026-11-12)#
One new component, composer-ci, the install-and-ci job nine stack repos wrote by hand; a check_path input on
proctor; the consumer a11y kit every stack repo copies; and two input regexes that refused values their own docs
recommend (config_path: .gitleaks.toml and php_advisory_version: 8.6-rc). No input or job was renamed or removed.
- Added: the consumer a11y kit (
templates/a11y/consumer/: one runner pair, its pin manifest and the checker), the single local a11y runner every stack repo copies (D-110). - Added: the
composer-cicomponent (sixteenth): the hand-written install-and-ci job nine stack repos carry, as one include. It runs the Composer image by digest with the shared Composer cache (fixed keypreflight-composer-ci),composer install --no-interaction --no-progress --prefer-dist, thencomposer ci; that command's exit code decides the job, and there is noallow_failureinput, because a failingcomposer cimust fail the pipeline. No input was renamed or removed. - Added: the
composer-cimust-fail check (tests/check-composer-ci-fails.shand its.ps1twin) and the two Preflight jobs that prove it: the pipeline includes the component ontests/ci-fixtures/pass(must pass), andmust-fail-composer-ciruns the check in the template's own image, proving the pass fixture passes namingci-fixture-passed, the fail fixture fails namingci-fixture-failed, and a broken copy of the pass fixture (invalidcomposer.json) fails, so an install that cannot run never skips to green. The fixtures carry no packages, so the check needs no network (BEST_PRACTICES 7.2). - Added: the proctor component's
check_pathinput (default empty) changes the command's working directory after the install, so a repo that installs PROCTOR indeploycan rundeploy/vendor/bin/proctor check --path=.from the project root and have thewayneui.copiesscan seesite/assets/wayne-uiat the root. Empty keeps today's behaviour (the command runs inworking_dir); no input was renamed or removed. - Added:
tests/TemplateJobsTest.php, part ofcomposer ci, holds two practices that were only written down. Every job a consumer gets must keepinterruptible: trueand a timeout of 1 hour or less, directly or through the hidden job it extends (BEST_PRACTICES 2.9), and no template may gain a credential: a password, token, secret or key input defaults to empty or a variable name, a script reads no credential variable butCI_JOB_TOKENandCI_DEPENDENCY_PROXY_PASSWORD, and no token or private key appears (5.1).mysql56-migrate's throwawaydb_passwordis the one named exception. Both practices move toChecked - Added:
tests/check-a11y-runner(sh and PowerShell) pins the local a11y runner to the component's own image and versions. - Changed: Preflight's own pipeline runs
php-test-advisoryon8.6-rc, the newest PHP 8.6 release candidate, sophp_advisory_versionis proven in a real pipeline (BEST_PRACTICES 6.4 isChecked). Its first look found the 8.6 candidate image built withoutmbstring, which PHPUnit needs: the job fails, allowed, and nothing else changes. The php-test guide says which tags the input takes (8.6-rcfollows the newest candidate,8.6.0RC5stays put). - Fixed:
tests/check-component-version.ps1followsextends:like its.shtwin, so it passes php-test's real template on Windows again (its two visible jobs take their script from a hidden base job, and the PowerShell twin reported both as having no script). Found by running all thirtycontracttwins in PowerShell; the other twenty-nine pass, and so do the README's PowerShellcomposer installandcomposer cilines. BEST_PRACTICES 7.4 records the run; MAINTAINING loses a stray`nin the portability paragraph. - Fixed: the main pipeline refused the
8.6-rcvalue forphp_advisory_versionthat its own docs recommend: the input's regex only allowed dots between parts, so the floating candidate tag failed at pipeline creation. The regex now allows a dot or a hyphen between parts (8.6-rcand8.6.0RC5both pass), andtests/PipelineInputsTest.php(incomposer ci) checks every input of Preflight's own pipeline against its component's spec, so this cannot ship again. - Fixed: secret-detection's
config_pathnow accepts a leading-dot path such as.gitleaks.toml, the file name Gitleaks itself uses and the one the input's description names: the regex forbade a leading dot, so a consumer passingconfig_path: .gitleaks.tomlhad GitLab refuse the whole pipeline config at creation. It still refuses absolute paths, parent references, spaces, semicolons and command substitution, andtests/check-path-input-regex(sh and PowerShell) pins the new line and the accept and reject samples. - Docs: MAINTAINING says how to run the
mysql56-migratemust-fail check on your own computer: a MySQL 5.6.51 container on a Docker network and the check inphp:8.3-cli-trixie, the same three cases CI runs (cleanpasses,json-columnandlong-indexfail with 1064 and 1071), inshand PowerShell, both tried on Windows. - Docs: the README and Local checks run the fixture app's PHPUnit in
php:8.4-cli-trixie(they said the barephp:8.4-cli), the Debian-named tag the components use (BEST_PRACTICES 4.10); both lines were run as written. - Docs: the README art flies 0.8.0. The checklist card panel says "15 components, in 0.8.0" (it still said 0.7.0) and the hero shows the 0.8.0 pin; the art kit checks every placard against the new tag.
- Docs: BEST_PRACTICES matches 0.8.0. It counted fourteen components and called 0.5.0 the latest tag; it now lists fifteen with
mysql56-migrate, counts thirteen tags, hasmysql56-migratein 7.1 (eleven components tested at the commit under review) and 7.2 (fourteen of fifteen carry a must-fail fixture), says PROCTOR and CREED flyproctor@0.8.0, and marks backlog items 17, 22 and 43 Done. - Site: the front page pins 0.8.0. The quick start, every placard, the flight plan and the GitHub workflow pin the 0.8.0 tag commit (they still pinned 0.7.0's), the placards say "in 0.8.0", the components note says what is new in 0.8.0 (
session_header, andpackage-publishrefusing a moved version on GitLab) and keeps 0.7.0 and 0.6.0 as "Since" notes, and the type certificate data sheet is amended to 0.8.0: the change bar moves tosession_header, the log of amendments gains its 0.8.0 line, and the diff example readsgit diff 0.7.0 0.8.0.
0.8.0 (2026-11-10)#
One new portability input. session_header sends one Name: $VARIABLE header on every session-hop request, so a
probe sign-in route can require a per-job secret, and package-publish now really refuses a moved version on
GitLab. No input or job was renamed or removed, and nothing changes for an include that leaves session_header empty.
-
Docs: the Upgrading page has a 0.8.0 section.
-
Added: the portability component's
session_headerinput sends oneName: $VARIABLEheader on every session-hop request, read from the job's environment and never printed, so a probe sign-in route can require a per-job secret. -
Docs: a new guide, Which hosts the jobs reach (
docs/guides/network-egress.md), lists every host a Preflight job downloads from, by component, keeps the runner's image pulls apart from the job's own requests, and ends with the deduplicated list a firewall or proxy needs (BEST_PRACTICES 5.4; agreeing and enforcing it stays with ops).tests/DocsEgressTest.php(incomposer ci) fails when a component has no row, a template fetches from anhttps://host the page does not name, or a default image comes from a registry it does not name. The README links it next to Dependency caching. -
Fixed:
package-publishreally refuses a moved version on GitLab. It looked for the package under the index'spackageskey (GitLab sends"packages": []and ametadata-url) and for versions under aversionskey (GitLab keys them underpackages, then the package name), so it never found a published version and would have let GitLab overwrite one quietly. The job now followsmetadata-url(falling back to GitLab's documentedp2path), reads the version keyed or listed, takes the commit fromsource.referenceordist.reference, treats a404for the package as no versions yet, and refuses a version it cannot tie to a commit.tests/check-package-publish-fails(sh and ps1,must-fail-package-publish) now runs the whole job against a fake registry on GitLab's documented shapes: a moved version fails with no publish request, the same commit exits 0, a new version publishes once. That closes the last component path without a failing fixture (BEST_PRACTICES 7.2). Checking the tail number before the plane leaves the gate, not after. -
Added:
tests/DocsInputTablesTest.php(incomposer ci) holds the docs tocontract/inputs.json: the input table for every component in the README, the components reference and the component's guide must list each input with its contract type and default, and nothing else. A checklist is only as good as the airplane it was written for. -
Docs: the README and the components reference get a
mysql56-migratesection (it shipped in 0.6.0 with only a guide), php-test'sphp_advisory_versionrow, and portability'ssetup_command,servicesandrequire_healthcheckrows with thehealthcheckcheck in the defaultchecks; the README's opening line names npm audit, MySQL 5.6 migrations and the portability probe. Found by the new test. -
Docs: the README art is current again. The checklist card's panel lists all fifteen components in two columns with the 0.7.0 tag said once in its header (fourteen in one column no longer fit), its description says freshness "is" coming soon, the components badge reads 15, the hero is a fresh capture of the 0.7.0 page, and the cast picks up the stack's newer marks. The art kit takes 0.7.0 as the tag every component ships in (it still read 0.5.0, so it refused the 0.7.0 placards), and it now allows Citadel by name in captured text, as the public docs do, while still refusing internal host names. The components reference lists the seven components with no card row in one table, with the release each arrived in.
0.7.0 (2026-11-10)#
One new portability input. setup_command runs a command once, in its own container of the built image, before
either replica starts, so an app can migrate the services database before session-hop runs. No input or job was
renamed or removed, and nothing changes for an include that leaves it empty.
- Docs: the Upgrading page has a 0.7.0 section.
- Added: the portability component takes a
setup_commandinput (default empty): a command run once, in its own container of the built image, before either replica starts, so an app can migrate the database inservicesbeforesession-hopruns (WELD W15). A non-zero exit fails the job; must-fail casesetup-fails. - Changed: the deploy layer requires PROCTOR ^0.15 (locked 0.15.0, was ^0.12): 0.13 checks the release cooldown against the CREED policy, 0.14 adds
script-pairand 0.15 addsmysql56-ci; all only warn, nothing breaks.
0.6.0 (2026-11-10)#
A new component and a portability probe that checks more of what a platform checks. mysql56-migrate runs an app's
migrations against MySQL 5.6.51, the version of Citadel's shared server, on the runner tagged amd64. The portability
job runs the image's own HEALTHCHECK inside a replica (a new healthcheck check, in the default checks), and its
new services input starts a database or cache both replicas share, so session-hop can pass for an app that keeps
sessions there. No input or job was renamed or removed.
- Docs: the Upgrading page has a 0.6.0 section.
- Added: the portability component takes a
servicesinput (default none), sosession-hopcan run against a database or cache both replicas share (WELD W15). - Added: the portability component runs the image's own HEALTHCHECK inside a replica (
healthcheckcheck, newrequire_healthcheckinput, default false), and builds with--format dockerso the HEALTHCHECK survives; must-fail fixturebad-healthcheck. - Added:
mysql56-migratecomponent: runs the app's migrations against MySQL 5.6.51 (Citadel's shared server) on the runner taggedamd64, on the default branch and tags, manual on merge requests; must-fail fixtures for a JSON column and a too-long utf8mb4 index; installs Composer 2.11.1 when the image has none (D-078). - Changed:
scripts/a11y-container.shcarries the# proctor-ignore script-pair:marker: it runs only inside the container its two OS twins start, so PROCTOR'sscript-pairreports it as an info note, not a missing twin. - Added:
must-fail-a11yrunstests/check-a11y.shin CI, in the a11y component's own Playwright image, so the a11y check's bad fixture is proven to fail on every pipeline like the other components'.scripts/a11y.shgains an in-image mode (A11Y_IN_IMAGE=1) for that job. - Changed: the deploy layer requires PROCTOR ^0.12 (locked 0.12.0, was ^0.11): two new warning-only checks, nothing breaks.
- Added:
must-fail-proctor-lockandmust-warn-preflight-gatesjobs run the real PROCTOR on fixture-app copies: PROCTOR fails a copy whose lock is gone (removed after the install, since Composer writes one during it; BEST_PRACTICES 4.5 records that gap), and a pipeline without Preflight, withallow_failureon the proctor gate or pinned to@mainwarns without failing. - Added: must-fail proofs for the contract check (
tests/check-contract-failsin thecontractjob, and a PHPUnit case): a changed default or a renamed input now has to fail both comparisons. - Fixed:
tests/check-contract.ps1names php-test's jobs from thejob_nameinput like the.shtwin and the PHPUnit contract test, so it passes the real templates again on Windows. - Added: must-fail proofs for the image-input, cache-key and PHP-matrix guards (
tests/check-image-inputs-fails,tests/check-cache-fails,tests/check-php-matrix-fails), and acheck-php-matrixguard that keeps php-test'sparallel: matrix:wiring, all run by thecontractjob. - Site: the front page's stale facts are current (the
proctorplacard says it keepsproctor.jsonfor Rollcall since 0.5.0). - Changed: the deploy kit is Squire 0.10.7 (was 0.10.6): it ships a
.gitattributesthat pins line endings, so the deploy layer clears PROCTOR's line-ending warnings. - Changed: the docs, agent-ready and deploy kits are Squire 0.10.6 (was 0.10.5 for the deploy kit, Squire a7a40ab of 2026-11-08 for the docs and agent-ready files): the docs builder and agent-ready generator see every file on Docker Desktop mounts, and each heading keeps its "#" link with its last word.
- Changed: the docs, agent-ready and deploy kits are Squire 0.10.6 (was 0.10.5 for the deploy kit; the docs and agent-ready files were Squire a7a40ab, between 0.10.2 and 0.10.3 in name only): the docs builder and agent-ready generator see every file on Docker Desktop mounts, and each heading keeps its "#" link with its last word.
- Fixed: secret detection really blocks now. GitLab's template marks the job allow_failure: true, so dropping the old override left it advisory (pipeline 5392).
.gitlab-ci.ymlsets allow_failure: false on secret_detection, and both check scripts now require it. - Added: a must-fail fixture for squire-kit.
must-fail-squire-kitproves the component fails on a kit with a drifted file and on a folder with no .squire.json. Every component that runs as a job now has a must-fail fixture. - Docs: BEST_PRACTICES matches the code before 1.0. The component version line (2.11) is
Enforcedby the contract job, the proctor default command (6.1) isCheckedon every pipeline, and the counts are real again: ten components in Preflight's own pipeline, eightworking_dirinputs, ten tags through 0.5.0, four components that takeallow_failure. The must-fail list names npm-audit and package-publish and says squire-kit still has none, and thirteen finished backlog items are marked Done with the file that proves each. A preflight checklist that finally matches the airplane. - Site:
assets/stack-env.jsknows Parity, so a pre-production page links Parity's pre-production site and a dev page links its localsite/folder. Until now Parity, of all parts, was the one link that ignored its environment. - Changed: Preflight's own secret detection job now blocks the pipeline (a week of green runs since 2026-11-02 ended its advisory spell), and the README badge's alt text counts 14 components like the badge does.
- Site: Parity is out; the party list links its site.
- Deploy kit refreshed to Squire 0.10.5.
- Docs: Parity joins the party. The README cast ("Fifteen on the manifest") and the front page's Departures board carry Parity next to Squire, with its spirit-level mark: the stack's new tool that runs Citadel on your computer (its PHP image, its proxy and MySQL 5.6). 0.1.0 is coming and it has no site yet, so its row links nowhere. Every pilot logs simulator hours before the real runway; now apps can too.
- Changed: refreshed version mentions. BEST_PRACTICES says PROCTOR's and CREED's pipelines include
preflight/proctor@0.5.0(both pipelines fly 0.5.0; the checklist still read 0.4.0); the dev dependency Pinstripe moves to ^0.3 (locked 0.3.0, was ^0.1 at 0.1.4), and the front page deploy layer requires HELMET ^1.3 (locked 1.3.0, was ^1.2 at 1.2.0). - Docs: README, the guides, the docs pages, the examples and the front page pin the 0.5.0 tag commit; the Upgrading page and the npm-audit examples name it in place of the full commit SHA placeholder, and the front page placards say "in 0.5.0" and count npm-audit among the components that ship in the tag.
- Docs: the front page's type certificate data sheet is amended to 0.5.0 (the AMDT 0.5.0 stamp, a change bar on php-test's
composer_versiondefault, now 2.11.1, and a new log of amendments that says in a line what 0.4.0 and 0.5.0 changed), its diff example and those in the README, the components reference, the inputs contract guide and Upgrading readgit diff 0.4.0 0.5.0, the guide says what that diff shows, the 0.5.0 Upgrading section notes the renovatedry_runpattern now on record, the deferred-items note says the contract suite shipped in 0.5.0, and the README checklist art lists all fourteen components in 0.5.0 with npm-audit's row (its components badge reads 14; the art kit closes the list up to 18 units a row so it fits).
0.5.0 (2026-11-09)#
Tag commit: 60314791565a264e97cb210813ef4f3e76512402 (pin this SHA, with # 0.5.0 in a trailing comment).
A new component and a probe that boots Apache the way a container runtime does: npm-audit fails on npm advisories
at or above audit_level (default high), the portability job starts each replica with stdio its uid owns and a
session of its own (delete any start_command setsid shim in the same change as the bump, or health fails), the
proctor job keeps PROCTOR's JSON report as proctor.json for Rollcall, and every Composer default is 2.11.1. The
deploy layer moves to Squire's kit 0.10.2, HELMET ^1.2 and PROCTOR ^0.11.
- Docs: the Upgrading page has a 0.5.0 section; the npm-audit guide, the components reference and the README name 0.5.0 as the first tag with npm-audit (their include examples said "the first tag with npm-audit"); the docs home names 0.5.0.
- Docs: MAINTAINING's "Who maintains it" names a role, the stack maintainer, instead of a person, and says to reach them with an issue on git.wayne.edu.
- Changed: the front page deploy layer requires HELMET ^1.2, PROCTOR ^0.11 and CREED ^0.1.8 (locked 1.2.0, 0.11.0 and 0.1.8; were 1.0.1, 0.8.0 and 0.1.7). The fixture app requires PROCTOR ^0.11 (locked 0.11.0, was 0.8.0), so Preflight's own proctor job now runs a PROCTOR that writes
proctor.jsonand the artifact keeps it; the fixture still passes every check and itscomposer ci. Preflight's dev tools take Pinstripe 0.1.4 (was 0.1.0), the newest release on Packagist. - Changed: the deploy kit is Squire 0.10.2 (was 0.10.0), and so is the squire-kit fixture (
tests/squire-kit-fixture, was 0.5.0): the kit names every image in full (docker.io/library/...) and takes the fallback base's Composer from aCOMPOSER_IMAGEstage,.squire/php.inisetssession.cookie_samesite = Lax, and the portable image dropsnode_modules/after the frontend build. The fixture also takes the files Squire added since 0.5.0 (Apache hardening,php-web.ini, the portable image).squire init --checkpasses on both. - Docs: the Docker-only commands in the README, MAINTAINING, Local checks and Proof pin the CI image,
composer:2.11.1@sha256:8de2184c...(they said the floatingcomposer:2), the front page's commands and composer-audit placard saycomposer:2.11.1, and the composer-audit pages and template comment stop calling its imagecomposer:2. - Fixed: the portability probe starts each replica the way a container runtime would, so an Apache image (Squire's portable image, WELD) passes with an empty
start_command. On its own,buildah runhands the app root-owned stdout and stderr, which Apache running as the uid cannot reopen (could not open error log file /proc/self/fd/2), and starts no session, so Apache's graceful stop signalsbuildah-chroot-exectoo, which SIGKILLs the app and failedsigterm. Each replica now starts through a launcher that pipes stdout and stderr throughcaton a pipe the uid owns and execs the app throughsetsid, keeping its pid; it runs the Buildah image's ownbash,setsidandcatfrom its/usr, bind-mounted read-only at/.preflight/usrfor the run, so the app image needs none of them. The checks are unchanged. Remove anystart_commandshim that callssetsid(WELD'sexec setsid bash -c '...'): inside the launcher it forks the app away from the replica's main process andhealthfails. Proof: two new fixture builds intests/check-portability.sh,reopens-stderrandsignals-group, must pass every check and fail on the 0.4.0 probe; WELD's portable image, run locally with WELD's inputs and an emptystart_command, passes all five of its checks. Docs: the portability page (What the job emulates) and a troubleshooting entry. - Added: the
npm-auditcomponent, the front-end half ofcomposer-audit(CREED backlog 23, practice 41). It runsnpm audit --omit=dev --audit-level=<audit_level>on the app'spackage-lock.jsonin theeslintcomponent's Node image and fails at or above the level (defaulthigh), then prints a full report with dev dependencies that never fails. Inputs:stage,job_name,image,image_prefix,working_dir,audit_level(low,moderate,high,critical; CREED'smediumruns as npm'smoderate) andomit_dev(defaulttrue). No lock file passes with a "nothing to audit" line; an unreachable registry fails with a message;--audit=true --offline=falsestop an.npmrcfrom faking a pass. It reads the app's npm cache (fixed keynpm,.cache/npm/, pull only, D-072). Proof:tests/check-npm-audit-fails.sh(and its.ps1twin), thetests/npm-audit-failslock (lodash 4.17.20, GHSA-35jh-r3h4-6jhm) andtests/npm-audit-fixtures, run by the newmust-fail-npm-auditjob; Preflight's pipeline also includes the component on the clean fixture. New docs page: The npm-audit component. - Added: the proctor job keeps PROCTOR's JSON report as
proctor.jsonin its artifact (paths: [proctor.json],expire_in: 30 days, stillwhen: alwaysnext to the Code Quality report), the file Rollcall reads withROLLCALL_PROCTOR_SOURCE=gitlab. A guard adds--record "$CI_PROJECT_DIR/proctor.json"only whenproctor_commandis a plainproctor checkline (no quotes,$or shell operators, no--recordof its own) and the app's PROCTOR lists--recordin its help (0.11.0 and later); PROCTOR 0.10.0 and older run exactly as before and the runner only warns thatproctor.jsonmatched no files. The proctor line alone still decides the job.tests/check-proctor-fails(sh and ps1) now runs the template's own guard and command line on three fakes: no--record(tests/fixture-app), a clean one with it (newtests/proctor-record) and the must-fail one with it (tests/proctor-fails), plus a gate command and a quoted one that must not get the flag. - Changed: every component default, Preflight's own CI and the docs move from Composer 2.10.3 to 2.11.1 (
composer:2.11.1@sha256:8de2184c..., the multi-arch list digest; php-test's and proctor'scomposer_versiondefault is2.11.1). Composer 2.11.0 fixed GHSA-c968-33g3-wh7p (package names that could escape the vendor directory) and GHSA-fm2w-xgf2-f9fh (inline repository headers written intocomposer.lock), and 2.10.x is no longer maintained. 2.11 removedsource-fallback; no component sets it, and no component setspolicy.cooldown. An app that overrides theimageinput (or setscomposer_version) keeps its own pin and is unaffected. - Changed: the deploy kit is Squire 0.10.0 (was 0.7.1): release.sh keeps Composer and npm download caches in the app folder and the gate takes SQUIRE_PHP_RUNTIME; the compose file, health.php and .env.squire.example follow the template, and the portable image files are added.
- Added: a must-fail check for composer-audit (
tests/check-composer-audit-fails.sh, its .ps1 twin, themust-fail-composer-auditjob and a malware fixture intests/audit-fixtures/malware): Preflight's pipeline now runs the template's own lines and proves a known advisory and a malware-flagged version fail in everyabandonedmode, an abandoned package fails only infailmode, and a clean app passes.tests/check-abandoned-inputkeeps only its offline half and joins the contract job. - Changed: every template default and doc pins composer 2.10.3 by one digest (sha256:2cf27542...), the same build the rest of the stack uses; composer-audit's default names 2.10.3 instead of the floating 2 tag.
- Added: a must-fail check for package-publish (
tests/check-package-publish-fails.sh, its .ps1 twin and themust-fail-package-publishjob): a non-semver tag and a missing composer.json still stop the release before any registry contact. - Docs: README, the guides, the docs pages and the examples pin the 0.4.0 tag commit, and the upgrading page has a 0.4.0 section.
- Added: a PHPUnit suite (
tests/ComponentsContractTest.php, run ascomposer testinsidecomposer ci) that parses every template and fails when a component no longer matchescontract/inputs.json, naming the component and the added, removed or changed input or job and saying a rename is a breaking change;composer contract:updaterewrites the contract from the templates when the change was made on purpose, and this run records the renovatedry_runregex the template already carries. - Docs: the inputs contract is documented where component users look: a new guide (
docs/guides/inputs-contract.md, in the docs menu), sections in the README and the components reference, a diff-the-contract step in Upgrading, a link from Install, and a "Type certificate" section on the front page whose data sheet marks the lines 0.4.0 revised; the CONTRACT lamp is live, the "New in" line and the README checklist art speak for 0.4.0, and BEST_PRACTICES marks backlog item 6.1 (theproctordefault command, now in PROCTOR's and CREED's pipelines) done.
0.4.0 (2026-11-08)#
Tag commit: 87d9b6fc6b0ed302dd729986525282cd7b567ebd (pin this SHA, with # 0.4.0 in a trailing comment).
Two new inputs and a Composer floor: the proctor component's git_depth clones the full history so PROCTOR's
override-approver check can read git blame, php-test's php_advisory_version runs the next PHP in a job that may fail,
and php-test and proctor refuse a composer_version older than 2.9.6. Preflight's own pipeline now proves ten
components fail a bad app (eslint, secret-detection and sbom are new), runs the real PROCTOR, and the deploy layer moves
to Squire's kit 0.7.1 and HELMET ^1.0.
- Docs: BEST_PRACTICES 3.3 is tagged
Partly, notNot yet: PROCTOR'sci-pipelinescheck reads.gitlab-ci.ymland.github/workflows/ci.yml, and the entry names the four flags still missing. - Added: a must-fail fixture for the secret-detection component (
tests/secret-detection-clean,tests/check-secret-detection-fails.shand its Windows twin, themust-fail-secret-detectionjob): Preflight's pipeline proves Gitleaks fails on a token in the app's code, skips vendor/ and node_modules/, and redacts the value. - Added: a must-fail fixture for the sbom component (
tests/sbom-clean,tests/sbom-fails,tests/check-sbom-fails.shand its Windows twin, themust-fail-sbomjob): Preflight's pipeline proves the job fails when Composer fails and that the SBOM leaves dev packages out. - Added: a must-fail fixture for the eslint component (
tests/eslint-fails,tests/check-eslint-fails.shand its Windows twin, themust-fail-eslintjob): Preflight's pipeline proves the job fails on an ESLint error and passes a clean app. - Changed: php-test's and proctor's
composer_versionrefuses a Composer older than 2.9.6 (the floor with the 2026 security fixes); the pattern is held bytests/check-composer-floor.sh(and its Windows twin,tests/check-composer-floor.ps1) in the contract job. - Changed: Preflight's own pipeline runs the real PROCTOR (
waynestate/proctor^0.8 in the fixture app) on the proctor component's default command, instead of a fake that printed an empty report; the fake stays only for the offlinecheck-proctor-failswiring check. - Added: the proctor component's
git_depthinput (default"0", the full history), so PROCTOR's override-approver check can read git blame on every override line instead of reporting could-not-run past the 20-commit default clone. - Added: php-test's php_advisory_version input runs one more PHP version (a release candidate) in a separate job that may fail, so an app hears about the next PHP before it is supported (BEST_PRACTICES 6.4).
- Fixed: the contract check resolves job names that contain the job_name input (php-test-advisory) and skips hidden template jobs, so main is green again.
- Fixed: the component-version check follows
extends:to a hidden base job, so php-test's jobs pass when their script comes from.php-test-base. - Docs: a deprecation and removal policy for components (docs/guides/deprecation.md): tags never move, one release of notice, six months before removal, and the Catalog toggle stays on while any version is pinned.
- Changed: the deploy layer runs Squire's kit 0.7.1 (was 0.6.0):
.squire/php.inino longer sets the deprecatedsession.sid_*lines, web requests get adisable_functionslist and Apache hardening (.squire/php-web.ini,.squire/apache-hardening.conf), and opcache gets production settings withSQUIRE_OPCACHE_VALIDATEas the one switch. - Docs: the docs home footer names 0.3.1 (it still said 0.3.0).
- Changed: the front page deploy layer requires HELMET ^1.0 (lock at 1.0.1, was 0.4.0), like the rest of the stack; its shared front controller already runs on HELMET 1.0 in Squire, Sourdough and Pinstripe.
- Docs: README, the guides, the docs pages and the examples pin the 0.3.1 tag commit, and the upgrading page has a 0.3.1 section.
0.3.1 (2026-11-08)#
Tag commit: b90323b5823287a7840095d0d5f0682aaeedf327 (pin this SHA, with # 0.3.1 in a trailing comment).
Fixed CI cache keys (D-072): every component that installs packages caches under a fixed key instead of a lock-file hash, and saves its cache even when the job fails, so a lock change or a dropped GitHub download refetches only what is missing. Inputs and job names are unchanged, so moving a pin from 0.3.0 is a one-line change.
- Changed: every component saves its dependency cache even when the job fails (when: always), so a retry after a dropped download fetches only what is missing (D-072).
- Fixed: README, BEST_PRACTICES 4.8 and the caching guides describe the fixed cache keys (D-072).
- Changed: php-test, phpstan, pint, proctor, sbom and eslint cache under a fixed key per job instead of a lock-file hash (D-072), so a lock change downloads only the packages that changed.
- Fixed: the docs menu closes with Escape and hands focus back to its button (docs kit synced from Squire).
- Fixed: the docs kit's copy button no longer covers the first line of code when it says Copied or Failed: over the code it keeps its resting width and shows a check or a cross when the word does not fit (docs kit synced from Squire).
- Changed: the front page's version chip carries
data-docs-version, so the docs builder (synced from Squire) keeps it on the docs stamp at every release andcomposer docs:checkfails while it is stale. - Changed: the deploy layer requires PROCTOR ^0.8 (locked 0.8.0).
- Docs: the README, docs, front page and examples pin the 0.3.0 tag's commit SHA, and the GitHub workflow example moves from 0.1.1 to 0.3.0.
- Fixed: the front page said a11y and squire-kit were coming in the next tag; both shipped in 0.2.0. The checklist card gains an eighth check, a11y, which lights the A11Y lamp (it was a hatched "next tag" lamp), the placards add an a11y placard and name the five other components in 0.3.0, and "Deferred items" keeps only the contract suite and site freshness, with no date for the next tag. The README's checklist art is rebuilt to match: nine rows, all thirteen components in 0.3.0, and a components badge that reads 13 (it read 9).
- Fixed: the README art kit (
scripts/readme-art) reads job names from thejob_nameinput every template now uses, puts the stage list on its own line (it ran past the panel), closes up the component list when it grows, and labels the license badge in US spelling.
0.3.0 (2026-11-08)#
Tag commit: 23038dfe767f6ef60e3b2efca1128f53d9acdff7 (pin this SHA, with # 0.3.0 in a trailing comment).
- Changed (breaking for apps that pass a proxied
image): every component whose image comes from Docker Hub (proctor,php-test,composer-audit,sbom,pint,phpstan,eslint,secret-detection,package-publish,renovate,squire-kit) has a newimage_prefixinput, default${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}, and pullsimage_prefix/image, so Docker Hub is asked once and GitLab's Dependency Proxy serves the cached copy.imagekeeps its default and is now the path after the prefix. On a GitLab or group without the proxy, setimage_prefix: docker.io. An app that passedimage: ${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/...only to reach the proxy drops that input when it moves to this version.a11y(mcr.microsoft.com) andportability(quay.io) are unchanged: the proxy serves Docker Hub only.contract/inputs.jsonlists the new input. - Changed: the front page's deploy layer (
deploy/) runs Squire's kit 0.6.0 (was 0.5.0):scripts/release.shasks PROCTOR's deploy gate for a go or no-go on each release (a report, not a stop, unlessSQUIRE_PROCTOR=enforce), and.env.squire.examplelists the new setting. The layer's pins move to HELMET^0.4(locked 0.4.0) and PROCTOR^0.7(locked 0.7.0). - Docs: the Docker commands in the README and docs mount the shared
stack-composer-cachevolume, so Composer downloads are cached between runs. - Fixed: the README and docs describe the
portabilityhealth check'sHostas a bare IP address and the port (Host: <ip>:<port>) instead of printing a literal private address. - Fixed: the front page's "Same instance only" caution says git.wayne.edu has an instance runner and the stack's CI runs on it (it said git.wayne.edu had no runner yet), and its cast says Sourdough starts all five app shapes.
- Fixed:
tests/check-sha-pins.ps1runs again on Windows. PowerShell read"$rel:"in its failure message as a scope-qualified variable and refused to parse the script. - Added: Composer caches on
pint,phpstan,sbom(keyed oncomposer.lock) andsquire-kit(fixed key), and an npm cache ona11y(fixed key), the same shape asphp-test,proctorandeslintalready had. - Added:
tests/check-dependency-cache(sh and ps1), run in thecontractjob. It fails when a Docker Hub component skipsimage_prefix, when a component installs Composer or npm packages without a cache, or when Preflight's own.gitlab-ci.ymlpulls from Docker Hub without the proxy or passes a component an image that already carries it. Preflight's own includes no longer passimage. - Added: docs page Dependency caching (Guides), and an
image_prefixrow in every Docker Hub component's input table. - Docs: the component pins in the README, the docs, the front page and the Renovate runner example point at 0.3.0, and the upgrading page has the 0.3.0 steps.
- Added:
scripts/a11y.sh --base-urlandscripts/a11y.ps1 -BaseUrl(orA11Y_BASE_URL) check a running site locally, as the component'sbase_urlinput does in CI.
0.2.0 (2026-11-07)#
- Changed (breaking for 0.1.4 includes of
portability): theportabilitycomponent is one job that runs the six checks of ADR-0010 decision 5 instead of goss. It builds the image with Buildah (vfs storage, chroot isolation: no Docker daemon, no privileged runner, no registry push), boots it twice side by side as an arbitrary uid in group 0 with no capabilities and no passwd entry, and probes it with curl: the strict boot (app root not writable, writable paths writable by group 0, the port variable honored, no writes outsidewritable_pathsandruntime_paths), thenhealth(200 toHost: 10.1.2.3:<port>),env-only(no.envor config cache in the image),forwarded-headers(forgedX-Forwarded-*and identity headers change nothing),logs(stdout or stderr, nothing underlogs_path),session-hop(a sign-in survives a hop to the second replica) andsigterm(the main process handles SIGTERM and exits withinstop_timeout). Oneportability: <check>: pass|FAIL|skippedline per check. The probe istemplates/portability/probe.sh, inlined in the template byte for byte; new contract testtests/check-portability-inline(sh and ps1, with a write mode) keeps the two in step. - Changed:
portabilityinputs.buildah_imageis renamedimage(same default); the app-imageimageinput is gone;start_commandis optional (empty runs the image'sENTRYPOINTandCMD); newjob_name(defaultportability),build_args,runtime_paths,port_env,env,stop_timeout,probe_path,identity_header,session_login_path,session_check_path,logs_pathandchecks.contract/inputs.jsonlists the new set and the one job;tests/check-job-namesnow coversportability, andtests/check-image-inputshas no exemptions left. - Added: a must-fail proof for
portability: one fixture app,tests/portability/app, built clean and once per flaw (ARG FLAW: needs-root, writes-root, fixed-port, host-bound, dotenv, trusts-proxy, file-logs, file-sessions, no-term-handler).tests/check-portability(sh, run inside the Buildah image, and a ps1 wrapper that runs it with Docker andseccomp=unconfined, never--privileged) passes only when the clean build passes and each flaw fails the check it targets. Preflight's pipeline includes the component on the clean fixture and runs the check asmust-fail-portability. - Removed:
templates/portability/goss.yaml, the goss download, the registry push and thetests/portability/good,bad-needs-rootandbad-writes-rootfixtures. - Changed: The canonical repository is git.wayne.edu (ADR-0021); docs, links and package metadata no longer point at the archived nougat copy.
- Added: must-fail fixtures for the php-test, phpstan and pint components:
tests/php-test-failscarries a failing test,tests/phpstan-failscarries a type error, andtests/pint-failsis not formatted to the standard, while the clean case intests/fixture-apppasses all three; new checkstests/check-php-test-fails,tests/check-phpstan-failsandtests/check-pint-fails(sh and ps1) assert each template keeps the job line that lets the tool's exit code be the job result, then run the component's own commands from its template, in the component's own image, against both cases, and pass only when the clean case passes and the bad case fails with the expected finding. Themust-fail-php-testandmust-fail-phpstan-pintjobs run them in CI, in the templates' own images, and they still run locally with Docker. - Added: the
squire-kitcomponent (templates/squire-kit/template.yml), which fails the pipeline when a Squire deploy kit drifts from the Squire release its.squire.jsonrecords. It installs that release from Packagist into a temporary folder (--no-dev --no-scripts) and runssquire init --checkonworking_dir; exit 0 the kit matches, 1 it drifted, 2 the check could not run. Inputs:stage,job_name,image,working_dir,squire_version(empty orx.y.z) andallow_failure(defaultfalse). It checks the recorded version, so a new Squire never turns main red by itself. Preflight's own pipeline runs it ontests/squire-kit-fixture, a kit written bysquire init --target=raw. New contract testtests/check-squire-kit(sh and ps1). New docs page: The squire-kit component. - Added: the preset's
waynestate/squirerule runspostUpgradeTasks: it installs the new Squire into a folder under/tmpand runssquire updateon the kit folder, so the merge request for a new Squire carries the refreshed kit. The renovate component gains asquire_kit_tasksinput (boolean, defaultfalse) that writes the two allowed command patterns into the runner'sconfig.js(allowedCommands); with it off the merge request bumps the version only and shows an artifact error. No shell executor is turned on. New contract testtests/check-renovate-squire-kit(sh and ps1) pins the commands, the patterns and 22 hostile variants they must refuse;tests/check-renovate-reviewno longer forbidspostUpgradeTasks. - Fixed: Renovate no longer updates files inside a Squire kit (
docker-compose.squire.ymland.squire/**, outside Squire's owntemplates/). Its digest and tag bumps edited files Squire owns, which left every stack kit drifted from its recorded release and madesquire updaterefuse to refresh them. Change those images in Squire's templates instead. - Added: a must-fail fixture for the proctor component:
tests/proctor-failsis a fake proctor that prints one blocker finding and exits 1, while the clean case intests/fixture-appprints[]and exits 0; new checktests/check-proctor-fails(sh and ps1) runs both cases and keeps the template's plain redirect, so the tool's exit code stays the job result, and the contract job runs it. - Added: the
a11ycomponent (templates/a11y/template.yml), accessibility as a gate with one include. It opens a site's pages in Chromium with Playwright and runs axe-core through@axe-core/playwrightin light and dark mode at 320 px and 1280 px, and fails on any violation; at 320 px or less it also checks WCAG 1.4.10 Reflow, which axe-core cannot. The default tags are WCAG 2.1 AA (the ADA Title II level);wcag22aaadds 2.2 AA. It servessite_diron a local port or checks a running site atbase_url, takes paths or globs inpages(a glob that matches nothing is a configuration error, a missing page fails with HTTP 404), and writesgl-a11y-junit.xml(the merge request's test summary) andgl-a11y-report.json(every finding, plus the count axe-core left for a person to review). The image is the multi-arch Playwright image pinned by index digest; the playwright npm version comes from its tag, axe-core and @axe-core/playwright are pinned inputs, and the job fails if a different axe-core ran.allow_failure(defaultfalse) lets a site adopt it while fixing its first findings. The checker istemplates/a11y/check.mjs, inlined in the template; new contract testtests/check-a11y-inline(sh and ps1) keeps the two byte for byte, andtests/check-a11y(sh and ps1, Docker) proves it passes a clean fixture site and fails a known-bad one with each flaw named (tests/a11y-fixtures). Preflight's own pipeline includes it at WCAG 2.2 AA.renovate/default.jsonbumps the two axe-core packages as one group, waiting for review. New docs page: The a11y component. - Added: a site accessibility gate:
scripts/a11y.shon Linux and macOS andscripts/a11y.ps1on Windows run thea11ycomponent's checker in Docker (same image and versions as the template, so no host browser is needed) on the front page and every docs page at WCAG 2.2 AA, in light and dark mode at 320 px and 1280 px with the reflow check, and fail on any violation; all pages pass clean. Options pick the folder, pages, tags and a report folder. The earlier copy undertools/a11y/is gone. - Added: a secret-detection component (Gitleaks over the checked-out tree with
--redact, agitleaks.jsonreport artifact uploaded even on failure,config_pathandallow_failureinputs), so every stack repo gets committed-secret scanning from one include line; the first release carrying it is 0.2.0. - Fixed: the portability component's writable-path checks now run. The
portability-runjob readwritable_pathsthrough$([[ inputs.writable_paths ]]), which GitLab does not interpolate, so the value reached the job's shell as a failing command substitution, the variable came out empty, and nowritable-*goss check was ever appended; the line now interpolates the input as a literal string. New testtests/check-input-interpolation(sh and ps1) fails on any template that keeps a$([[form or aninputs.reference outside$[[ ... ]]. - Fixed: the proctor and sbom jobs install the app with
--ignore-platform-reqs. Both only read the app, yet a lock built for an older PHP or one needing gd, oci8 or ldap stopped them before PROCTOR or CycloneDX ran, so the oldest apps got no report. The sbom job also passes--no-scripts, so the app's Composer scripts no longer run in it. Found by the 2026-11-05 proof run;tests/check-proctor-install-flags(sh and ps1) now checks both lines. - Added: a public Proof page (
docs/reference/proof.md, under Reference): the components run against 82 Wayne State applications, what held, what the run caught in Preflight, and what it does not prove. Local checks and the README link to it. - Added: troubleshooting entries for an install that stops on another PHP or a missing extension, a private package with no credential, and
npm ciwithout apackage-lock.json. - Security: the front-page deploy layer moves to Symfony 7.4.23 (symfony/http-foundation and symfony/yaml advisories, including CVE-2026-118514).
- Changed: the docs theme carries the hero's sectional chart (its grid and contour rings) faintly under the top of every page, frames the overview's picture of the front page like the hero's instrument, and sets the badges in a row. Dark mode now really is the instrument panel: the kit's dark block had been winning for the page and inline code backgrounds, which left WayneUI's dark green surface everywhere; titles are panel light and the lit green is kept to links, the current page and focus.
- Changed: the docs pages wear the front page's look: its top bar and main menu (Docs marked current), B612 and B612 Mono, the cream chart page, commands on the quickstart's slab with its Copy key, callouts as the handbook's NOTE, CAUTION and WARNING boxes, tables and the pager as flight-plan forms, and the green runway footer; dark mode follows the instrument panel. New
docs/_header.htmlanddocs/theme/preflight.css, named underthemeindocs/docs.json. - Changed: the docs builder and kit are Squire's 0778fed: the theme hook, callouts, code tabs, task-list checkbox labels (fixes the axe
labelfailures on the protection checklist) and a keyboard-reachable scrolling code block. - Fixed: the contract job's Buildah pin check no longer needs git, which the mikefarah/yq image does not have; when git is missing or fails it scans regular files with find instead, skipping .git, vendor/ and node_modules/.
- Added: a Composer cache on the proctor component, keyed on composer.lock (BEST_PRACTICES 4.8); new test tests/check-proctor-cache.
- Added: every component job prints a
Preflight component <name> <version> (ref <reference>, sha <sha>)line as its first command, so a job log says which Preflight release produced it; each template declaresspec: component: [name, version, sha, reference]. New teststests/check-component-version.shandtests/check-component-version.ps1;tests/check-spec-keysand the template lint allowcomponentunderspec:. - Changed: Preflight now needs GitLab 18.7 or later:
spec: component:is generally available from 18.7, and pipeline creation fails on the unknown key on older instances. - Added: the docs site at
site/docs/, built fromdocs/by Squire's shared docs builder (bin/docs-site.php), starting with the overview page. New composer scripts:docsbuilds it,docs:checkfails when it is stale, andcinow runs the check. - Docs: component pins in the README and site examples now point at 0.1.4.
- Changed: the front-page deploy layer pins HELMET ^0.3, PROCTOR ^0.4 and CREED ^0.1 (lock: HELMET 0.3.0, PROCTOR 0.4.0, CREED 0.1.6).
- Changed: the deploy layer sets minimum-stability to stable.
- Changed: phpstan config and memory_limit, pint config and sbom output now carry an input regex (relative paths and PHP sizes only); a value outside it stops the pipeline at creation. New test tests/check-path-input-regex.
- Added: a tag-triggered
releasejob in the repository's own pipeline: pushing a protected tag creates the GitLab Release through the Releases API with curl, and the release notes carry the tag's commit SHA so consumers can pin it (BEST_PRACTICES 1.3, 1.6); new test tests/check-release-job. - Added: a packageRule in
renovate/default.jsonthat restrictsquay.io/buildah/stableto-immutabletags (regex versioning), so Renovate never moves a pin back to a mutable tag after Red Hat re-pushed one and garbage-collected the old digest; new test tests/check-renovate-buildah. - Changed: the portability component's
buildah_imagedefault moves to the immutable tagquay.io/buildah/stable:v1.43.5-immutable@sha256:7c2b605262748ace2c5c57c5550942d0adad57aec82ede3070927722306c0ffb; Red Hat re-pushed the plain version tag and garbage-collected the old digest, so pipelines pinned to the mutable tag broke. New test tests/check-buildah-pin. - Added: an
abandonedinput on the composer-audit component (fail,reportorignore, defaultfail) so an app can relax howcomposer audittreats abandoned packages on purpose; the job now runscomposer audit --locked --abandoned=$[[ inputs.abandoned ]]. New test tests/check-abandoned-input (and its.ps1twin) with the fixtures in tests/audit-fixtures. - Fixed: the
portabilityprobe'ssigtermcheck no longer fails, now and then, an app that stops at once. It checked whether the main process was still running in two steps (is its status file there, then is it a zombie), and a process reaped between the two read as running, so a clean exit could be reported as "still running 10s after SIGTERM" without any wait. It now reads the status once, takes its verdict from the same check that ended the wait, and no longer prints a stray/proc/<pid>/cmdlineerror when a process ends while the probe looks at it.
0.1.4 (2026-11-03)#
Changed#
- Changed: the README explains which jobs may be allowed to fail (only
proctor) and that the contract check rejects global keys; BEST_PRACTICES 2.3 is now Enforced. - Changed: check-image-inputs allows
portability-buildto takebuildah_image(the only exemption from 2.10). - Changed: docs and package metadata name nougat as the canonical repository, with git.wayne.edu and GitHub as read-only mirrors, until git.wayne.edu has CI runners.
Added#
- Added: README example for an advisory job on the next PHP release (a second
php-testinclude withjob_name), and PowerShell forms of the local Docker commands. - Added: a
job_nameinput on every component exceptportability(default is the usual job name), so one project can include a component more than once;tests/check-job-namesenforces it andtests/check-contractresolves the key. - Added: portability component (Buildah build, arbitrary-uid boot, goss checks, fixtures).
- Added: a Squire kit version rule in
renovate/default.json: a custom regex manager reads theversionline of.squire.json, and thewaynestate/squirebump carries thesquire-kitlabel and never auto-merges; a person runssquire updateto refresh the kit files.
Fixed#
- Fixed: the component-rule manager name in
renovate/default.json(gitlabci, matching repository deps), so component version bumps really wait for review instead of auto-merging; the contract test now checks the new rule and the Squire kit rule. - Fixed: the portability goss health check uses
method: GET; goss sends the method as written, and a lower-case one makes the server close the connection, so the good fixture failed with EOF. - Fixed: the portability fixtures make their temp dir mode 0777 and the goss files in it mode 0644, because the app user is not the host user that owns the dir and goss is downloaded into it.
0.1.3 (2026-11-03)#
Added#
- Added: advisory secret detection in the repository's own pipeline.
- Added:
tests/check-renovate-review.sh(and its.ps1twin), a contract test that keeps the reviewed-bump rules inrenovate/default.json. - Added: README "Protection checklist": protected default branch, protected release tags, merge request approvals,
no_one_allowedpipeline variables and no protected variables in fork pipelines. - Added: README "Set up (the user does this)": the private runner project, the
RENOVATE_TOKENand optionalGITHUB_COM_TOKENCI variables, and a pipeline schedule; this repository creates none of them.
Changed#
- Changed: README and examples show SHA pins with the tag in a trailing comment.
- Changed:
renovate/default.jsonno longer auto-merges updates insidetemplates/**,contract/**and.gitlab-ci.yml, or component include version bumps: they carry theneeds-reviewlabel and wait for a person. - Changed: the deploy layer's Squire kit is refreshed to 0.3.3 (release options can now live in ./.env.squire).
- Changed: the deploy layer's Squire kit is refreshed to 0.3.4 (the local .env.squire file is now git-ignored).
- Documented: running the composer-audit component on a weekly pipeline schedule.
- Documented: the job token allowlist rule and the runner request wording (non-privileged, ephemeral Docker executor).
- Changed: the repository's own pipeline pulls Docker Hub images through the GitLab Dependency Proxy (component defaults are unchanged).
- Changed: the proctor component installs the app with --no-plugins --no-scripts.
Fixed#
- Fixed: stale 0.1.0 and next-tag wording in the best practices, the GitHub example and the checklist art.
- Fixed: the readme art script handles all nine components, including package-publish and renovate.
- Fixed: BEST_PRACTICES 2.2, 2.9 and 6.2 match the templates.
- Fixed: BEST_PRACTICES statements match the repo; README no longer claims Renovate bumps component pins.
- Fixed: the renovate component no longer sets
RENOVATE_TOKENandGITHUB_COM_TOKENfrom themselves in the jobvariables:; on GitLab 19.5 that self-reference arrived as literal text and shadowed the masked project CI/CD variables, so the job now reads both tokens straight from the project.
0.1.2 (2026-10-29)#
Added#
- Added: agent-ready site (prompt blocks, Markdown twins, llms.txt), from Squire's kit.
Fixed#
- Fixed: stale capability claims in the site and README.
Changed#
- Docs: README.md, MAINTAINING.md and site/index.html pin components at
@0.1.1, and the notes about components arriving in a later tag are gone, because 0.1.1 contains every component. - Changed: the proof page moves to a private site that needs a Wayne State sign-in.
- Changed: project names written as words except acronyms.
0.1.1 (2026-10-29)#
Added#
package-publishcomponent: publishes a semantic version tag to the GitLab group's built-in Composer registry. The job reads the registry before publishing, so republishing from the same commit is a no-op and republishing from a different commit fails instead of overwriting the version.renovatecomponent and shared presetrenovate/default.json: Renovate runs as a scheduled GitLab pipeline in a private runner project and bumps image digests, GitHub action SHAs and package versions across the stack. Bumps ofcomponent:include pins are not covered yet: the preset carries no manager for them. Digest, pin and patch/minor updates auto-merge when CI is green; majors open a merge request and wait for a person.
Changed#
- PHPStan:
phpstan.neonnow includes Pinstripe'sraw.neonpreset from the newwaynestate/pinstripedev dependency instead of carrying a hand copy of its settings. The repo keeps only its own paths, excluded fixture app and PHP version range. Strict rules stay off as before, and deprecation checks now run on every analysis.
0.1.0 (2026-10-27)#
- First tagged release.