Changelog#
All notable changes to Pinstripe are documented here.
Unreleased#
- Fixed: the contributing guide names Preflight 0.9.0, the tag CI pins, where it still said 0.8.0. Content only.
- Changed: the deploy kit is Squire 0.11.1 (was 0.10.7): the release script fetches PROCTOR when
--no-devleft it out and installs the frontend from ayarn.lock, the HAProxy pin is current, the fallback base follows the app's PHP line, and the parity scripts carry the deprecation note. - Changed: CI pins Preflight 0.9.0 (components and the a11y checker copy).
- Changed:
deploy/requires PROCTOR^0.16, whoseci-pipelinescheck no longer asks for a GitHub workflow (D-069);^0.15failed thewayneui-copiesjob. - Removed: the GitHub Actions workflow; CI runs on git.wayne.edu only (the GitHub copy is a mirror).
- Site: the line under the hero's buttons says "Version 0.4.0 is cut" (it still said 0.3, with 0.3.0's news). The number carries
data-docs-versionlike the hang tag, so the docs builder rewrites it at every release andcomposer docs:checkfails while it is stale; the words name no feature and link to the "Just off the cutting table" note, which the release steps already rewrite. NewFrontPageTest::testTheHeroNoteWearsTheVersionStampfailscomposer ciif the number is typed by hand again. - Docs: the README shows the Docker command for
composer ci, so the checks run with no local PHP.
0.4.0 (2026-11-11)#
-
Docs: every install line says
^0.4(README, front page, its agent prompts, the Raw PHP, Laravel and Proof pages), since^0.3does not allow 0.4.0, and the Upgrading section's steps say to move the constraint rather thancomposer update. The front page's "Just off the cutting table" note names 0.4.0 and its two opt-in Rector presets. -
CI pins Preflight 0.8.0 on GitLab; MAINTAINING.md and the contributing guide say so (the GitHub workflow stays on 0.5.0, the newest tag on the mirror it can call).
-
Added:
rector/strict-types.php, an opt-in Rector preset for the careful route to strict types on an old app. It runs Rector'sSafeDeclareStrictTypesRectorand nothing else, so it addsdeclare(strict_types=1)only to files whose calls, returns and property assignments already pass the types they ask for, and leaves the rest for a later run. Opt-in, so no app sees a change until it points a config at it. New fixturetests/fixtures/rector-strict-typeswithPresetsTest::testRectorStrictTypesPresetDeclaresOnlyTheSafeFileandtestRectorStrictTypesPresetLeavesTheCoercingFileAlone; the README, Require strict types and Rector guides show it, and BEST_PRACTICES.md gains the row (24 rows, 24 Enforced). -
Added:
rector/levels.php, an opt-in Rector preset for an app that has never met Rector. It returns a function:$levels(deadCode: 0)runs only the first dead-code rule, and you raise the number one merge request at a time, then starttypeCoverage,codeQualityorphpthe same way (each family stays off until named, and naming none throws). It wraps Rector's ownwithDeadCodeLevel,withTypeCoverageLevel,withCodeQualityLevelandwithPhpLevel, and leaves out the import tidying and Laravel rules that touch every file. Opt-in, so no app sees a change until it points a config at it. New fixturetests/fixtures/rector-levelswith fourPresetsTest::testRectorLevelsPreset*tests; the README and Rector guide show the climb, and BEST_PRACTICES.md gains the row (25 rows, 25 Enforced). -
Site: the front page's "Just off the cutting table" note says what 0.3.2 brought (it still led with 0.3.0), and new
tests/FrontPageTest.phpfailscomposer ciwhile the note names anything but the newest CHANGELOG release, so it cannot fall behind again. The release steps in MAINTAINING.md and on the Releasing page say to rewrite it in the release commit. -
Site: the install card's "
^0.3gets you" line names 0.3.2, the current release (it still said 0.3.1). The version carriesdata-docs-versionlike the hang tag, so the docs builder rewrites it at every release andcomposer docs:checkfails while it is stale. -
Docs: Banned calls gains "Type the connection, or the ban cannot see it": the PDO and mysqli bans match by the connection's type, so a joined query on an untyped
global $dbpasses, and one@var \PDO(or a typed property) gets it reported. It was one line under "Other ways out"; now it is its own section with both halves proven by new fixtureUntypedConnection.phpandPresetsTest::testPhpStanSeesJoinedSqlOnlyOnATypedConnection(raw and strict cuts). No rule changed. -
Docs: the Upgrading page has a draft section for the next release (the two opt-in Rector presets, no breaking change), and its three oldest headings carry their dates. New
tests/UpgradingTest.phpfailscomposer ciwhile a CHANGELOG release has no Upgrading section, or the two disagree on a date or the order, so a release cannot ship without its fitting notes. The release steps in MAINTAINING.md and on the Releasing page say to rename the draft in the release commit. -
Tests: the TypeScript preset's typed linting is proven, not only claimed. New fixtures in
tests/js/typed(atsconfig.json, a clean.tsfile, and asave()nobody awaits infloating.tsandFloatingSave.vue) and threenpm testcases: the clean file has no findings, and each floating promise fails with@typescript-eslint/no-floating-promisesas an error. The README and Vue guide gain "Typed linting" (what it catches, that it reads the app'stsconfig.json, and to run it in CI), and the front page's mirror gains the pair. No preset changed. -
Site: the front page's mirror ("Every piece has a mirror") names every fixture the tests run, not half of them. "It fits" gains
BoundSqlandSecureTransport(the clean ways past the bans), "It catches" gainsLeftoversandJoinedSql, and a new row of size labels sews on one per app shape Sourdough starts (raw PHP, raw PHP with Vue, Laravel with Blade, Blade with Vue, Inertia and Vue), each with its fixture's name. The labels drop in and their running stitch sews round one after another; under reduced motion they are simply there. -
Site: Parity's hanger on the front page's rail links its site, parity.apps.wayne.edu, like every other part's. It hung there unlinked while Parity had no site; now it has one, and the stack's environment script already points a pre-production page at Parity's pre-production site.
-
Site: the hero's hang tag can be read on a phone. Its handwriting was 12px and its labels 7px at 390 px wide; now the writing never drops below 17px (with a hairline stroke behind the thin hand), the labels never below 9px, and the labels and values line up in two columns like a real ticket. The tag is wider, and the extra width hangs out past the cloth into the margin, so it covers no more of the label than before. The README hero is rebuilt to match.
0.3.2 (2026-11-10)#
- 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. - Docs: the Proof page says its 82-app run used the presets as they were on
mainon 2026-11-05, not "as they are on main". - Added:
node scripts/readme-art/build.mjs --checkrebuilds the README art in a temp folder and fails whendocs/readme/is stale (SVGs byte for byte, images by pixels within a small tolerance), and thereadme-artCI job runs it. The license badge sayslicense, notlicence. - Changed: the deploy layer requires PROCTOR ^0.12 (locked 0.12.0, was ^0.11): two new warning-only checks, nothing breaks.
- Docs: the proof page's last run is 2026-11-10 at e42cf2f (113 PHP tests, 36 npm tests with the raw-vue and laravel-inertia fixtures).
- 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 Vue presets let Inertia page components under
Pages/orpages/have one-word names such asIndexandShow(vue/multi-word-component-namesis off there only). - Tests: a Laravel plus Inertia plus Vue fixture (tests/fixtures/laravel-inertia) proves the presets on WELD's app shape, so every stack app shape now has a fixture.
- Docs: the ban tables in the README and on the Banned calls page name the OWASP ASVS 5.0 requirement each ban enforces (V1.2.4, V1.3.2, V12.3.2, V13.4.2, and V15.3.3 as the closest fit for
extract()). The messages keep their OWASP Top 10 tags. - Tests: a raw PHP plus Vue fixture (tests/fixtures/raw-vue) proves the presets on that app shape too, with one planted PHP error and two planted Vue defects.
- Changed: the GitHub workflow calls Preflight 0.5.0 (was 0.1.4), now that GitHub's copy of Preflight has the tag; MAINTAINING.md and the contributing guide name the 0.5.0 pins.
- Changed: the docs, agent-ready and deploy kits are Squire 0.10.6 (was 0.10.5): the docs builder and agent-ready generator see every file on Docker Desktop mounts.
- 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: Deploy kit refreshed to Squire 0.10.5 (was 0.10.2).
0.3.1 (2026-11-09)#
A patch: no preset passes or fails anything it did not in 0.3.0. It adds proof and docs (PHPStan findings in the merge request, the fix for SQL kept in .sql files), keeps Code Quality reports when a lint job fails, and brings the deploy kit and CI pins up to date.
-
Docs: Parity joins the party. The README cast ("Fifteen parts, one fitting room") and the front page's rail 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 tag links nowhere. With fifteen parts the rail hangs three rows of five on wide screens, so no part is left hanging alone at the end. Every good suit gets a fitting at home before the big day, and the hem comes out level.
-
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 (build.sh keeps its deliberate SQUIRE_BUILD_REVISION=2 marker).
-
Docs: every install line says
^0.3(it said^0.1, which stops at 0.1.4), with the onecomposer config repositoriesline that installs 0.3.0 from git.wayne.edu while Packagist's GitHub mirror trails the release; the npm notes say the ESLint and Prettier presets have not changed since 0.1.4. The front page drops its "0.1.4 on Packagist and npm" note and a "coming soon" chip for the CREED PHP floor (built in 0.2.0), keeps a Docs link in the header at phone width, and gains House rules: a notice of the banned call families with their OWASP tags, struck through in chalk and stamped as they scroll in (already struck and stamped with reduced motion). -
Docs: truth pass. The
laravel-vuefixture's Vue side runs undernpm test, notcomposer ci(README, Laravel guide); MAINTAINING.md and Contributing list all fivecomposer cisteps, the Node 22, 24 and 26 matrix, every CI component and job, andspaze/phpstan-disallowed-callsamong the runtime dependencies; the release steps no longer say to set the version twice, andnpm packlistsLICENSEtoo; Banned calls saysociparse()is reported as deprecated on every supported PHP, not only 8.4 and newer; the Baselines guide gains thelegacyopt-in and--composer=<path>; the Vue guide covers the error-level presets and their-warntwins; Upgrading 0.1.3 no longer lists the docs site (it shipped in 0.1.4); and BEST_PRACTICES.md marks three rows proven in one direction only (pint/laravel.json,pint/laravel-strict.json, ESLint GitLab output) as Checked, a status it now defines. -
Changed: CI's
composer-ciandwayneui-copiesjobs, and the Docker-only command in MAINTAINING.md and Contributing, use Composer 2.11.1 pinned by its multi-arch list digest (was 2.10.3, which is no longer maintained; 2.11 fixes GHSA-c968-33g3-wh7p and GHSA-fm2w-xgf2-f9fh). -
Changed: the deploy kit is Squire 0.10.2 (was 0.10.0): the fallback base names its images in full and copies Composer 2.11.1 from a
COMPOSER_IMAGEbuild argument,.squire/php.inisetssession.cookie_samesite = Lax, and the portable image dropsnode_modules/after the build; build.sh takes the template's note on what a Citadel Update runs and keeps its deliberate SQUIRE_BUILD_REVISION=2 marker. -
Changed: the front-page deploy layer requires HELMET
^1.3(was^1.0, locked 1.3.0, was 1.0.0), PROCTOR^0.11(was^0.8, locked 0.11.1, was 0.8.0) and CREED^0.1.8(was^0.1, locked 0.1.8, was 0.1.7).proctor checkstill passes ondeploy/. -
Docs: MAINTAINING.md names the maintainer as a role (the stack maintainer), reached through an issue on git.wayne.edu, not a person; the CI file's cache comment drops an internal decision number.
-
Added: the three presets the truth pass marked Checked are Enforced again, each now proven in both directions:
PresetsTest::testPintLaravelPresetRejectsTheMessyFixture(pint/laravel.jsonfails the messy fixture),PresetsTest::testPintLaravelStrictPresetAcceptsTheStrictTypesLaravelCleanFixture(pint/laravel-strict.jsonpasses a new Laravel-style clean fixture,tests/fixtures/strict-types/laravel-clean), and agitlab-formatter.test.mjscase where the clean Vue fixture gives an empty Code Quality report. Two stale comments are fixed: the GitHub workflow names its real Preflight pin (0.1.4, not 0.1.2), andPresetsTestsays theociparse()deprecation is expected on every PHP version, not only 8.4 and newer. -
Added: BEST_PRACTICES.md (and its docs page) ends the table with a tally, today 22 rows, 22 Enforced, 0 Checked, and
BestPracticesTest::testTheTallyCountsTheTablerecounts it on every run, so a new row or one slipping back to Checked moves the tally in the same change. -
Docs: Banned calls shows the fix for the joined-SQL report older apps meet most: SQL kept in
.sqlfiles, read by one helper typed@return literal-stringwith a single reasoned ignore (its file name isliteral-stringtoo, so a request value cannot pick the file). It also says to type a wrapper's SQL parameterliteral-stringand never baseline it, because a plain-stringwrapper is reported once, inside, and hides every caller. Both are proven: new fixturesSqlFiles.php(green in the raw and strict cuts) andJoinedThroughAWrapper.php(each joined caller reported asargument.type, the loose wrapper once), withPresetsTest::testPhpStanAcceptsSqlReadFromFilesThroughATypedWrapperandPresetsTest::testPhpStanReportsSqlJoinedThroughAWrapperAtTheCaller. No rule changed. -
Added: "Show PHPStan findings in the merge request" (README and the Raw PHP guide): an
analyse:gitlabscript with PHPStan's own--error-format=gitlab, each finding named by its identifier. NewPresetsTest::testPhpStanGitlabFormatReportsTheNullBugAsCodeQualityJsonandtestPhpStanGitlabFormatIsAnEmptyArrayForTheCleanFixtureprove both sides, and BEST_PRACTICES.md gains the row (23 rows, 23 Enforced). -
Fixed: the Pint, PHPStan and ESLint Code Quality snippets set
artifacts: when: always. Without it GitLab keeps a job's artifacts only when the job passes, so a lint job that found something, the one time the report matters, uploaded nothing. -
Docs: no internal decision numbers in public text. This changelog's 0.2.0 and 0.1.5 entries, the CI file, the deploy layer's composer.json and a comment on the front page drop numbers that pointed into a private repository, and the old entries say "an internal GitLab" instead of naming it.
-
Fixed: the Composer package's description (what Packagist shows) names the Rector preset and the banned calls; it said "shared Pint and PHPStan presets".
0.3.0 (2026-11-09)#
- Added: every cut bans SQL joined from strings (
pinstripe.banned.joinedSql, OWASP A05:2025): a variable concatenated, interpolated orsprintf()'d into the SQL given toPDO::query(),prepare()orexec(), mysqli'squery(),prepare(),mysqli_query()and the rest,oci_parse()(and the old aliasociparse()), or Laravel'sDB::select(),insert(),update(),delete(),statement(),scalar(),cursor()andfromQuery(). No taint rule: spaze/phpstan-disallowed-calls asks for PHPStan's ownliteral-stringtype, so literal SQL with bindings, class constants and literal pieces joined together pass; Laravel already typesDB::raw(),DB::unprepared()and the*Raw()builder methods that way, and a test now holds it to that. Breaking for apps that build SQL from variables. New fixturesJoinedSql.php,BoundSql.php,JoinedQueries.phpandBoundQueries.php. - Docs: the Best practices docs page carries BEST_PRACTICES.md word for word again (it had fallen behind: no ESLint GitLab output row, no banned-call rows), and BEST_PRACTICES.md gains rows for
phpstan/strict.neonandphpstan/disallowed.neon. Newtests/BestPracticesTest.phpkeeps them in step: every test and file the table names exists, each row has one known status, an Enforced row names its proof, and the docs page matches. - Fixed: the
Http::withoutVerifying()ban (the static entry) carries the same tip as the others, linking to the Banned calls page and the CREED rule;BannedCallLinksTest::testEveryBanCarriesAnIdentifierAndATipnow readsphpstan/disallowed.neonand fails on any entry without a message, identifier or tip. - Added: every cut bans TLS checks turned off:
curl_setopt()andcurl_setopt_array()withCURLOPT_SSL_VERIFYPEERfalse orCURLOPT_SSL_VERIFYHOST0 (pinstripe.banned.curlVerifyOff),stream_context_create()withsslverify_peerorverify_peer_namefalse orallow_self_signedtrue (pinstripe.banned.streamVerifyOff), and Guzzle'sverifyoption set to false through Laravel'swithOptions(),new GuzzleHttp\Client()or a request's options (pinstripe.banned.verifyFalse), each tagged OWASP A02:2025. Thecurl_setopt()ban is Pinstripe's first PHPStan rule of its own (src/PHPStan/CurlVerifyOffRule.php), since it needs the option and the value together; the rest are spaze/phpstan-disallowed-calls entries. Breaking for apps that skip the certificate check. New fixturesInsecureTransport.php,SecureTransport.php,VerifyFalse.php,VerifiedHttp.phpand the Laravel app'sbanned/InsecureCurl.php. - Added: Laravel's own
dd()anddump()methods are banned too ($users->dd(),DB::table('users')->dumpRawSql(),$request->dump(),Http::get($url)->dd(),Http::dump()and the rest of the family), under the functions' identifierspinstripe.banned.ddandpinstripe.banned.dump; only methods Laravel declares match, so an app's owndump()and the schema dump behindphp artisan schema:dumppass. Breaking for Laravel apps with one left in. New fixturestests/fixtures/laravel/src/LeftoverDebugMethods.phpandSchemaDump.php. - Changed: CI pins the Preflight components to 0.4.0 (the proctor job clones the full history, so the override-approver check can read git blame).
0.2.0 (2026-11-08)#
- Changed: every banned call's tip links to the CREED rule it enforces (code handbook, Banned patterns) as well as to Pinstripe's banned-calls page;
tests/BannedCallLinksTest.phpkeeps it that way. - Docs: the README says how CREED's PHP floor reaches the tools (PROCTOR's php-floor check, then Booster; the presets keep reading composer.json); "Coming next" is empty for now, since both items it named are built.
- 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. - Added: CI runs Preflight's a11y component (0.3.1) on site/, every page in light and dark at 320 and 1280 px with the WCAG 1.4.10 reflow check, blocking.
- Changed: CI pins the Preflight components to 0.3.1 (fixed cache keys, and caches saved even when a job fails).
- Changed: CI saves its Composer and npm caches even when a job fails, so a retry after a dropped download fetches only what is missing.
- Changed: CI caches Composer and npm downloads under a fixed key, so a lock change downloads only what changed.
- Changed: HELMET moves to
^1.0, its first stable release, wherever this repo requires it. - 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).
- Fixed: the front page's version chip shows the full version the docs show (size 0.1.4, was size 0.1). It carries
data-docs-versionnow, so the docs builder (synced from Squire) rewrites it at every release andcomposer docs:checkfails while it is stale. - Changed: the deploy layer requires PROCTOR ^0.8 (locked 0.8.0).
- Changed: the pipeline pins every Preflight CI component to 0.3.0 (preflight@0.3.0); component image inputs are plain image names, since Preflight adds the Dependency Proxy prefix itself.
- Added: a test that proves
npm install --ignore-scriptsstops a postinstall script, and the eslint-config-prettier floor is ^10.1.8, past the releases hit by CVE-2025-54313. - Added: banned calls. Every PHPStan cut includes the new
phpstan/disallowed.neon, which banseval(),extract(),var_dump(),dd(),dump()and Laravel'sPendingRequest::withoutVerifying()(theHttp::withoutVerifying()facade call too) throughspaze/phpstan-disallowed-calls^4.15(now inrequire, locked 4.15.0, loaded by the extension installer). Each message says why and what to use instead, ends with its OWASP Top 10:2025 tag (A05 Injection or A02 Security Misconfiguration), and has a stable identifier (pinstripe.banned.*) for a reasoned ignore. Breaking for apps with one left in: a leftoverdd()now fails the pipeline.md5(),sha1(),rand()andmt_rand()are not banned; that call is open. New README section and docs page, Banned calls; new fixturestests/fixtures/raw-disallowed,tests/fixtures/laravel/src/InsecureHttp.phpandtests/fixtures/laravel-app/banned. - Added: the Rector preset turns on the composer-based Laravel sets (
withComposerBased(laravel: true)); apps that install driftingly/rector-laravel get the Laravel upgrade rules for their installed version, and apps without it see no change. - Changed: the front page's
deploy/build.shrevision marker is 2, for a Citadel build-cache test (does a full Update run the editedbuild.sh?). - Fixed: the pipeline's PROCTOR jobs no longer pass
--policy, which PROCTOR 0.7 refuses in CI; PROCTOR checks against the CREED policy it bundles. - 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). - Fixed: the front page says Sourdough starts all five app shapes and that every app it makes comes with Pinstripe on; it said raw PHP only, and that Sourdough apps did not include Pinstripe yet.
- Changed: CI caches Composer and npm downloads per lock file (
.composer-cache, keyed oncomposer.lockanddeploy/composer.lock, and.npm-cache), so a pipeline stops fetching every package from Packagist and npm on every run. Images already come through the Dependency Proxy. - Changed: the front page's deploy layer (
deploy/) runs Squire's kit 0.5.0 (was 0.3.4):oracle-check.phparrives,scripts/release.sh,scripts/parity.ps1and.squire/base-fallback.Dockerfiletake the new templates, anddocker-compose.squire.yml, which Renovate had edited, is Squire's template again, sosquire init --checkpasses.site/assets/stack-env.jstakes the stack's one copy, with bindingless catch blocks. - Changed: The canonical repository is git.wayne.edu; docs, links and package metadata no longer point at the archived internal copy.
- Added: The Proof page records its last run.
0.1.5 (2026-11-09)#
A patch on the 0.1 line, cut from 0.1.4 on the 0.1.x branch, for consumers that pin ^0.1 (Booster among them). It changes no preset; 0.2.0 and 0.3.0 already carry the same fix.
- Fixed: the deploy kit's lock (
deploy/composer.lock) names git.wayne.edu and GitHub for CREED, HELMET and PROCTOR instead of the archived internal host. - Changed: The canonical repository is git.wayne.edu; docs, links and package metadata no longer point at the archived internal copy.
0.1.4 (2026-11-06)#
- Fixed:
pinstripe-baselinemutes deprecations while it loads the app's autoloader, so an old package in the app no longer prints PHP warnings ahead of the count a script reads (found by the 2026-11-05 proof run; new test in tests/BaselineTest.php). - Added: a public Proof page (
docs/reference/proof.md, under Reference): the presets run against 82 Wayne State applications, what held, what the run caught in Pinstripe, and what it does not prove. - Docs: the install steps say to rerun
composer requirewith-Wwhen a package the app already locks blocks it; Adopting on an existing app covers errors PHPStan cannot baseline and keeping Pint off bundled third-party code. - 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, README and front page say the npm package,
@waynestate/pinstripe, is at 0.1.3 (published); the docs pages' dark mode is now charcoal suiting instead of the green cloth, and wide tables shade the edge they scroll toward. - Changed: the docs pages wear the front page's look: its header and main menu (Docs marked current), Bodoni titles with the gold chalk line, pattern-piece callouts and pager, the gold Copy pill and the green footer, plus a dark mode cut from the green cloth. The theme lives in
docs/_header.htmlanddocs/theme/pinstripe.css, named by thethemekey indocs/docs.json; the vendored docs builder and kit are synced from Squire's unified builder (theme hook, callouts, copy button and keyboard fixes). - Added:
min-release-age=3to the repo.npmrcbeside the existingignore-scripts=true, with a comment naming the unit (days) and the agreeing RenovateminimumReleaseAgerule, so npm waits 3 days before installing a freshly published release and never runs dependency lifecycle scripts; the README gains a "Supply chain" section that explains both settings and tells apps to copy both lines into their own.npmrc. - Changed:
pinstripe-baselinenow requires the app's composer.json to carry"extra": { "pinstripe": { "legacy": true } }before it counts or checks a baseline; this is breaking for existing baseline users, who must add the flag, because a baseline is only for apps adopting Pinstripe late and new apps never set it. - Added:
--composer=<path>topinstripe-baseline countandcheck(defaultcomposer.jsonin the current working directory), so tests and monorepos can point at another composer.json. - Changed: the ESLint presets (
eslint/javascript.jsandeslint/typescript.js) fail lint on every Vue and accessibility finding: rules the plugins' recommended configs report as warnings are raised to errors, so the editor, a localnpm run lintand CI agree on what fails. Pre-1.0 break: apps that keep the old behavior (those findings as warnings) spread the new-warnexport instead. - Added:
eslint/javascript-warn.jsandeslint/typescript-warn.js, exported as@waynestate/pinstripe/eslint/javascript-warnand@waynestate/pinstripe/eslint/typescript-warn, which keep the exact previous behavior (the plugins' plain recommended configs, warnings stay warnings) for apps adopting the stricter presets gradually;tests/js/presets.test.mjsgains four tests around atests/js/warn-tierfixture whose only findings (vue/attributes-order,vue/no-v-html) were warnings before, proving the strict presets report them as errors and the-warnpresets keep them as warnings. - Added: a docs site (site/docs/) built by the shared docs builder from docs/, checked in composer ci.
- Added:
eslint-formatter-gitlabas a dependency andtests/js/gitlab-formatter.test.mjs, which lints the bad Vue fixture with the javascript preset, runs the results through ESLint'sgitlabformatter, and asserts the Code Quality report is a non-empty JSON array whose findings each carry a description, fingerprint, severity and location, soeslint --format gitlabshows ESLint findings in GitLab merge requests; the README gains a "Show ESLint findings in the merge request" note for the Vue section. - Added:
prettier-plugin-blade(pinned to 3.3.3, no caret) as a dependency and a*.blade.phpoverride inprettier/index.json(parserblade, 4-space tab width), so the Prettier preset formats Blade views;tests/js/blade.test.mjschecks a clean and a messy Blade fixture through Prettier's Node API, and the README gains a "Format Blade views" section with the one-time reformat command and an adopting note. - Changed: Blade files now format with prettier-plugin-blade; the first run rewrites every Blade file (4-space indent, a space after directive names such as
@vite (, void tags self-closed), so reformat in its own commit.
0.1.3 (2026-11-03)#
- Added:
docs/adr/0001-phpstan-level-and-baseline-policy.md, the ADR recording the PHPStan level 8 cut, the baseline policy (generated once for an existing app, never for new code, and only ever shrunk), and thecomposer ci/composer-cipipeline enforcement point, plus a README note that apps adopting Oxlint keep ESLint for.vuefiles because the Vue and accessibility plugins run only in ESLint. - Changed: the install instructions now include
composer config allow-plugins.phpstan/extension-installer true, so a non-interactive install works. - Added: a Node matrix to the
npm-testjobs on GitLab and GitHub (Node 22, 24 and 26), so the ESLint and Prettier presets are proven on all three majors; the floor stays 22.13. - 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: CI pins Preflight 0.1.4 (GitLab component includes and the GitHub reusable workflow tag).
- Added:
tests/fixtures/laravel-vue, a combined Laravel + Vue fixture withresources/jsbesideapp/, so one app tree is linted by Pint and PHPStan (PHP side) and ESLint and Prettier (Vue side) on every run; it carries one planted PHP error (bad/BrokenGreeting.php) and two planted Vue defects (resources/js/bad/Broken.vuemissing av-forkey,resources/js/bad/NoAlt.vuemissing analt), andtests/js/presets.test.mjsgains five tests for the Vue side.
0.1.2 (2026-11-03)#
- Added: PHPUnit tests for the PHPStan ignore rules in
phpstan/base.neon, which run the raw preset against three one-class fixtures intests/fixtures/raw-ignoresand prove an@phpstan-ignorewithout a comment fails, an ignore that matches no error fails, and a commented ignore passes. - Added: PHPUnit tests for Pint's
--format=gitlaboutput, which prove the messyperfixture becomes a non-empty GitLab Code Quality JSON array and the clean fixture becomes[]. - Added: a "Tool floors" section in the README with the PHP or Node floor of each locked tool, read verbatim from
composer.lockandpackage-lock.jsonand checked bytests/ToolFloorsTest.php, so a dependency bump failscomposer ciuntil the table is re-cut. - Added:
phpstan/laravel.neonpins Larastan'snoEnvCallsOutsideOfConfigrule on, withtests/fixtures/laravel/src/EnvLeak.phpandtests/fixtures/laravel/src/ConfigRead.phpproving the Laravel preset reports anenv()call outsideconfig/and accepts aconfig()call there. - Added: PHPUnit tests for the opt-in strict-types Pint presets, which run the real Pint against clean and missing fixtures for
pint/per-strict.jsonandpint/laravel-strict.jsonand assert each strict config declares its preset and thedeclare_strict_typesrule. - Added:
tests/js/prettier.test.mjs, which runs the Prettier preset through Prettier's Node API on clean and messy JS and Vue fixtures and on the preset's own options, sonpm testenforces the preset like the ESLint ones. - Added: PHPUnit tests for
pinstripe-baseline check --against=<git-ref>, which build a throwaway git repository in a temp dir and assert the count at the ref and the exit codes. - Added:
npm-testCI jobs on GitLab and GitHub that runnpm cithennpm teston Node 22, so the ESLint and Prettier presets are covered in CI. - Changed: the GitHub workflow pins Preflight's reusable workflow by tag (0.1.2) instead of a SHA, as its comment intended.
- Added: agent-ready site (prompt blocks, Markdown twins, llms.txt), from Squire's kit.
- Pinned symfony/mime v7.4.22 in composer.lock, the fixed version for CVE-2026-45070 (PKSA-wtxr-p26d-nn42, GHSA-vqc8-7275-q272), so the audit step of
composer cipasses. - Changed: project names written as words except acronyms.
- 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).
- Fixed: stale capability claims in the site and README.
- Added:
tests/PackageVersionTest.php, which failscomposer ciwhen theversioninpackage.jsondoes not match the newest## X.Y.Z (date)heading inCHANGELOG.mdor, on a tag pipeline, the tag itself, so npm can always publish from the tag;package.jsonis now 0.1.1, the version the 0.1.1 tag shipped without. - Changed: CI pulls its Docker Hub images through the GitLab Dependency Proxy (the group's CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX), so pipelines no longer hit Docker Hub's anonymous pull limit.
- Changed:
deploy/composer.jsondropsminimum-stability: dev(every constraint resolves at stable), and the PROCTOR job fordeploy/in.gitlab-ci.ymldropsallow_failure, since PROCTOR now passes ondeploy/. - Changed: docs and package metadata name an internal GitLab as the canonical repository, with git.wayne.edu and GitHub as read-only mirrors, until git.wayne.edu has CI runners.
0.1.1 (2026-10-29)#
- Fixed the raw and Laravel PHPStan cuts inheriting
reportMaybesInMethodSignaturesandreportStaticMethodSignaturesfromphpstan/phpstan-strict-rules, which made them report phpdoc method signature issues they should not;base.neonnow pins both to false andstrict.neonkeeps them on. - Pinned the other eight parameters
phpstan/phpstan-strict-rulesforces on: four low-noise ones stay on in every cut, andcheckDynamicProperties,reportMaybesInPropertyPhpDocTypes,reportWrongPhpDocTypeInVarTagandreportNonIntStringArrayKeyare off inbase.neonand on instrict.neon; the README lists each decision.
0.1.0 (2026-10-29)#
- Added
bin/pinstripe-baseline, which counts a PHPStan baseline's ignored errors (count) and fails when the baseline grows (check --max=<n>orcheck --against=<git-ref>), so baselines only shrink. - Added
phpstan/strict.neon, an opt-in PHPStan preset for new apps that turns onphpstan/phpstan-strict-rules. - Added
tests/fixtures/per, a Pint fixture proving theperpreset is the PER Coding Style.