Changelog#
All notable changes to Sourdough are recorded here. The format follows Keep a Changelog; the project follows Semantic Versioning once 1.0 is out.
Unreleased#
Changed#
-
Fixed: the Squire copy docs name the
^0.11dev dependency (they said^0.10), and StackPinsTest's comments name PROCTOR 0.16, the line the templates pin. Content only. -
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, and
waynestate/squireis^0.11(the exported copy intemplates/squire/moves with it). -
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). -
Every generated app requires SESAME
^0.8, Pinstripe^0.4and PROCTOR^0.16(was^0.7,^0.3and^0.15, which do not allow the current releases), and Sourdough's own dev dependency is Pinstripe^0.4. -
Docs: each generated README says how to turn on the nightly run (a GitLab pipeline schedule reruns the full PHP test matrix); a test keeps scheduled pipelines from being skipped.
-
CI pins Preflight 0.9.0 (components and the a11y checker copy).
-
Every shape and the GitHub workflow pin Preflight 0.9.0 (commit fb73b53), like Sourdough's own pipeline.
-
Added:
sourdough check [dir] [--json], the baker's poke test: one read-only run that says whether an app is fed and supported. It prints theSupport:line (the shape's status and owner and its Laravel major's or PHP floor's end-of-security date from CREED's policy), the manifest drift and whether a feed is due, thenOKor aNeeds attention:list. Exit0fed and supported,1behind the template, a deprecated shape or a line past security support,2the tool errorsfeed --dry-runstops on. The app's own edits are listed and never fail it. It writes nothing and needs no clean tree. BEST_PRACTICES 3.2 and backlog item 2 are done;tests/CheckCommandTest.phpcovers it. -
Changed: Sourdough's own GitLab pipeline gains a blocking
smoke-floorjob that bakes the raw and Inertia shapes on PHP 8.3, the floor every shape pins inconfig.platform.php; the other smoke jobs bake on 8.5, so a template that quietly needed a newer PHP would have passed them.tests/SmokeFloorTest.phpkeeps the job's image on the templates' pin. No change to what a bake writes. -
Docs: the front page and the README name Preflight 0.8.0, the release every pipeline pins (they still said 0.6.0), and
tests/PreflightPinTest.phpnow fails when a sentence that names the pin on the front page, the README, MAINTAINING, BEST_PRACTICES or a docs page (not the changelog or upgrading notes) names another release. -
CI pins Preflight 0.8.0.
-
Fixed: the front page's "Adopt an existing app" prompt asked the agent to run
sourdough adoptwith the values of--shapeand--namemissing: the<shape>and<name>placeholders sat in the HTML unescaped, so browsers read them as unknown elements and the copied prompt,index.mdandllms-full.txtlost them. They are escaped now, as is a raw<name>in an old changelog entry, andtests/SitePlaceholdersTest.phpfails on any element the page does not really use and on any flag left without its value. -
Site: the order ticket has "Copy a link to this order", a link such as
https://sourdough.apps.wayne.edu/#order?loaf=laravel-inertia&oven=docker&name=Parking%20Permits&advisor=nothat opens the counter with the same loaf, oven, name and ADVISOR choice, so a lead can send a new developer the exact order. A loaf or oven that is not on the menu is ignored and the name goes through the usual rule, so a mangled link still lands on a good ticket. The button appears only once the script has opened the counter. -
Docs: the every-OS guide says what to do when Windows will not run a script ("running scripts is disabled on this system"): on a Windows client with no execution policy set, PowerShell runs no script files at all, so it shows how to check the policy, set
RemoteSignedfor your own account, unblock a downloaded copy, or run one script with its own policy. It no longer says the generator's scripts are never affected. BEST_PRACTICES 5.3 says the same. -
Docs: BEST_PRACTICES says what the code does today: 1.6 (each shape baked into a temp directory, the Laravel ones offline from the fixture skeleton) is
Checked, 5.1 (.gitattributespins in every shape,GitattributesPinsTest) isEnforced, 5.3 (Squire'sparity.shandparity.ps1in every shape) isChecked, and each line of the gap list says whether it is done (and where) or what is still open. -
Site: the front page has an order counter (
#order), the command half of the "new app" page (BEST_PRACTICES 1.8). Pick a loaf, an oven and a name and its ticket writes thesourdough newcommand, the bake and the next steps to copy, read fromsite/assets/order-menu.json, whichcomposer site:order-menubuilds from the same plan code assourdough new --dry-run --json.composer cifails when the menu is stale, andtests/OrderMenuTest.phpruns every order the ticket can write through the real command. It checks names with the generator's rule and offers only the ovens a shape takes. -
Added:
sourdough new --dry-run --jsoncarriesnext_steps, the lines a real bake prints under "Next steps:" for that shape and oven (Sail, Docker or the bench, with or without ADVISOR). The plan now owns them (Plan::$nextSteps), so the printed list and the JSON can never disagree; the printed output is unchanged. -
Docs: the maintaining guide, the troubleshooting page and the README name Preflight 0.6.0, the release CI and the templates pin (they still said 0.1.4 or 0.5.0).
-
Added: the Laravel shapes include Preflight's
mysql56-migratecomponent, so every pipeline runs the migrations against MySQL 5.6.51 (D-078); every Preflight pin moves to 0.6.0. -
Changed: new bakes require PROCTOR
^0.15(was^0.12) in the rawcomposer.jsonand both Laravel overlays, and the front page's deploy layer requires^0.15(locked 0.15.0). PROCTOR 0.13 checks the release cooldown against the CREED policy and 0.14 addsscript-pair; 0.15 addsmysql56-ci; all of these only warn, nothing breaks. -
Docs: the shapes guide's quick start says each
sourdough newline runs the same in Windows PowerShell as in sh (one PHP command, no bash or WSL needed). -
Docs: MAINTAINING no longer says "in 0.1" for the shapes; three BEST_PRACTICES backlog lines carry a status, and the one that named a
sourdough checkcommand says it is not built yet. -
Changed: the GitHub workflow calls Preflight 0.5.0's reusable workflow (pinned to its release commit), the same release as the GitLab pipeline; it was on 0.1.4 because GitHub's copy of Preflight had no later tag.
-
Fixed: the manifest line-ending test normalises the kit's
parity.ps1before it starts, so it passes on a Windows checkout, where.gitattributeswrites.ps1files with CRLF. -
Docs: the README and templates reference name the Squire 0.10.7 kit and PROCTOR
^0.12(was 0.10.6 and^0.11). -
Changed: new bakes require PROCTOR
^0.12(was^0.11) in the rawcomposer.jsonand both Laravel overlays, and the front page's deploy layer requires^0.12(locked 0.12.0). PROCTOR 0.12 adds two warning-only checks (composer-cooldown,lock-tracked); nothing breaks. -
Added: sourdough feed prints the Support: line (owner, status and the framework's end-of-security date from CREED's policy) on every run, so the app's sourdough-feed CI job keeps showing when its framework stops getting security fixes; --json carries it as support.
-
Site: the front page's stale facts are current (every shape answers
/ready, not only the Laravel ones, and the "Also in the kitchen" shelf links Parity's site instead of its repository, without the "coming soon" tag). -
Added: generated Laravel apps turn on HELMET's fixed 4xx page (
helmet.error_pages, envHELMET_ERROR_PAGES, default true in the app'sconfig/helmet.php), so anabort()message never reaches a visitor; the raw shapes already had HELMET's neutral error page. -
Added: every app shape's
composer.jsonsets Composer's release cooldown (config.policy.cooldown.period:"3 days"), CREED's 2026-11-03 decision; Composer 2.11 waits that long before it installs a newly published version. -
Changed: every app shape's root
.gitattributespins*.ps1,*.batand*.cmdto CRLF and*.shto LF (CREED every-OS rule); the Laravel shapes append the pins to the skeleton's file. -
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. The templates' Squire copy (templates/squire/) is 0.10.7 too. -
Added: raw and raw + Vue apps answer GET /ready through HELMET's readiness option, and in production an uncaught exception gets HELMET's neutral error page (the full detail goes to the log). Locally, PHP still shows the error.
-
Docs: the templates reference's rules table, the Squire kit version (0.10.6) in the README and the templates reference, and BEST_PRACTICES 2.1 and backlog item 6 say what the generator does today.
-
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. The
templates/squire/copy and the lock move to 0.10.6 with them. -
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. -
Version mentions: ADVISOR ^0.3 in the templates and generator, Squire kit 0.10.5 re-export, docs stamps current.
Fixed#
- Fixed: a fresh app installs again right after a stack release; the Composer cooldown now exempts the stack's own packages (
policy.cooldown.ignore:["waynestate/*"]), which the templates require at their newest versions.
0.4.2 (2026-11-09)#
Added#
- Added: every shape's README gains "Run it like Citadel" at the end of "Run it locally": the Parity commands that run the app on Citadel's PHP image, Apache,
php.ini, proxy and MySQL 5.6.51, beside the everyday bench (composer serveorphp artisan serve), which stays. Parity is a separate install, so Sourdough bakes noparity.json:parity init --from-squirewrites it from the Squire kit every shape already ships, and that was proofed on a raw and a Blade bake (init, check, up and test). The raw shapes add--no-cron, because Parity would otherwise offer Laravel's scheduler to an app with noartisan, and say plainly that Citadel sets noAPP_ENV, so a page boots as production and asks for CAS settings Parity 0.1.0 cannot set yet. The Laravel shapes addnpm installfor the Blade lock file and twoparity shell --user citadellines that migrate MySQL 5.6.51 and cache it, because the first deployment reads only.env. README is a seeded file, so apps you already baked keep theirs; copy the section from a fresh bake if you want it. Newtests/ParityReadmeTest.phpholds all five shapes to it.
Changed#
- Docs: Parity joins the party. The README cast, the docs overview, Same kitchen, many ovens and the front page's "Also in the kitchen" shelf 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.51). It has no site yet, so it links to its repository on git.wayne.edu and hangs on the shelf with the dashed "coming soon" tag. Squire packs the loaf for the trip; Parity checks it rises the same in the home oven.
- Docs: the pages that pick a local runner say when to use Parity. Building on Laravel gains "Run it like Citadel: Parity" with a which-to-use-when list (the bench, Sail or
--dockerwhile you write code; Parity before a release, after a PHP or Laravel upgrade, or for a bug that only shows on Citadel), and Every developer, every operating system, Quick start, Commands and the README's--dockerline point at it. The--dockerand--sailREADME sections drop "swap in Squire's Citadel-parity image when it exists" and "local parity with Citadel's database is not possible": Parity runs Citadel's MySQL 5.6.51 today. They also say that those ovens point.envat their own MySQL, so setDB_CONNECTION=sqlitefor Parity runs, or the first deployment stops at the migrate step withAccess denied(proofed on a Blade bake).
0.4.1 (2026-11-09)#
Added#
- Added: the Laravel shapes (Blade, Blade + Vue islands, Inertia) carry the Pinstripe extras WELD carries. A
composer lint:gitlabscript writes Pint's findings as a GitLab Code Quality report (pint-codequality.json,[]when clean, ignored by git); thecomposer-cijob runs it inafter_script, so it still reports whencomposer cifails, and keeps it as acodequalityartifact for seven days, which puts Pint's findings in the merge request widget. Each bake also getstests/Unit/PinstripeWiringTest.php, the app's own test that Pinstripe is a dev dependency, thatphpstan.neonincludes its Laravel preset and leaves the level and the bans to it, and thatpint.jsonis Pinstripe'slaravel.jsonplus the three recorded skips for Squire's files (deploy,health.php,oracle-check.php). A fed app whosepint.jsonskips more paths fails that test until each extra skip is written into the test with its reason. The raw shapes are unchanged: they use Pinstripe's per preset and have no Laravel wiring to guard. Newtests/PinstripeLaravelTest.phpholds every Laravel overlay and pipeline to the same extras.
Changed#
- Changed: the GitHub
smokematrix blocks:continue-on-error: trueis gone, because every shape baked green there (as on GitLab, whose smoke jobs block since 0.4.0). A red shape now fails the GitHub workflow too.
Fixed#
- Fixed: Sourdough's own tests pass on a tag build. Two
ManifestTesttests expected the manifest'ssourdough_versionto bedev, but from a checkout sitting on a release tag Composer reports that tag, soManifest::packageVersion()rightly says0.4.0; the 0.4.0 tag pipelines failed on it on both GitLab and GitHub. Branch pipelines never saw it (Composer reports adev-branch there), and neither did a local Docker run, where git refuses the copied files as another user's and Composer falls back to itsno-version-setplaceholder. The tests now acceptdevor a release, and the newManifest::versionFrom()(whichpackageVersion()now calls) is tested on its own: a release stays as it is, and nothing, a branch or the placeholder becomesdev. No change to what a bake writes.
0.4.0 (2026-11-09)#
Upgrading#
- Upgrading: Pinstripe 0.3 may fail apps that build SQL by joining strings. Feed moves every shape to Pinstripe
^0.3, and PHPStan then fails a variable concatenated, interpolated orsprintf()'d into the SQL given tooci_parse(), PDO, mysqli or Laravel'sDB::select()and friends. Bind the value instead, or type your own whole-SQL helper's parameterliteral-string. The fix, with an example, is in the Upgrading page's 0.4.0 section.
Changed#
- Changed: Sourdough's own GitLab smoke jobs (
smoke-raw,smoke-raw-vue,smoke-blade,smoke-blade-vue,smoke-inertia) block the pipeline:allow_failure: trueis gone from.smoke-base, because every shape baked green on CI. The scheduledproofjob, which extends the same base, now fails a scheduled pipeline when it is red; started by hand it still only warns. The GitHubsmokematrix keepscontinue-on-error: truefor now. - Changed: every shape's
.gitlab-ci.ymlpins the Preflight CI components to the 0.5.0 release SHA (60314791565a264e97cb210813ef4f3e76512402with# 0.5.0, was 0.4.0), and Sourdough's own pipeline names the0.5.0tag. Inputs and job names are unchanged. What 0.5.0 brings a baked app: every Composer default is 2.11.1 by digest, and on PROCTOR 0.11 (which the shapes require) the raw shapes' proctor job also keeps PROCTOR's JSON report asproctor.json, the file Rollcall reads. Sourdough's own composer-audit include drops itsimageinput (acomposer:2digest), because 0.5.0's default iscomposer:2.11.1by digest. The vendored a11y checker is unchanged at 0.5.0;tests/PreflightPinTest.php,tests/A11yCheckerPinTest.phpandtests/RawGeneratorTest.phpexpect the new pin. - Changed: every shape requires Pinstripe
^0.3inrequire-dev(was^0.1; the raw shapes'composer.jsonand both Laravel overlays), and so does Sourdough itself (locked 0.3.0, was 0.1.4, withspaze/phpstan-disallowed-calls4.15.0 new in the lock). This crosses two 0.x minors, and both break code that uses what they ban: 0.2.0 banseval(),extract(),var_dump(),dd(),dump()andHttp::withoutVerifying(), and 0.3.0 bans SQL joined from strings, TLS checks turned off, and Laravel'sdd()anddump()methods. The raw shapes'src/Oracle.phpnow typesquery()'s$sqlasliteral-string(PHPDoc only, no behavior change), so the joined-SQL ban passes the helper and checks every caller instead; on the oldstringtype a fresh raw bake failed PHPStan at itsoci_parse()call, whichtests/PinstripeRawTest.phpnow catches. - Changed: every shape requires ADVISOR
^0.2inrequire-dev(was^0.1;RawGenerator::ADVISOR_VERSION, the raw shapes'composer.jsonand both Laravel overlays), the same pin WELD carries. ADVISOR 0.2.0 is a dev-only MCP server, so no app code changes;--no-advisorstill leaves it out. - Changed: the deploy kit is Squire 0.10.3 (was 0.10.2), in the checked copy (
templates/squire/, which every bake takes) and in the front page deploy layer (deploy/); Sourdough's dev dependency is locked at 0.10.3. The kit's comments name what they used to cite by internal item ID, and nothing else changes.squire init --checkondeploy/andcomposer squire-copy:checkpass. - Changed: the proctor job on Sourdough's own deploy layer (
deploy/) blocks the pipeline: itsallow_failure: trueis gone, becauseproctor checkondeploy/passes on PROCTOR 0.11.1 (warnings only).
Docs#
- Docs: the Docker commands in the README's and the Testing guide's "From the repo root" blocks pin the CI image,
composer:2.11.1@sha256:8de2184c..., instead of the floatingcomposer:2, like MAINTAINING and thecomposer ciline already did. - Docs: the README's which-command table no longer says
rollcall reportalways exits 0: it exits 0, or 2 on a tool error (no scan yet, a bad option, an unreadable policy), the same words as WELD's table.
0.3.0 (2026-11-09)#
Added#
- Added: the
sourdough adoptcommand, sosourdough feedcan look after an app Sourdough did not make:sourdough adopt [<dir>] --shape <shape> [--name <name>] [--sail | --docker] [--no-playbook] [--no-advisor] [--dry-run] [--json] [-v]. It writes.sourdough/manifest.jsonand nothing else, and prints each template path asyours,seededormissing(matchtoo with-v); a top-level folder whose every file is missing prints as one line, and--jsonlists every path.--shapeis required (the refusal names the shape the app looks like), and the name defaults to the folder's. It refuses, with exit 1, an existing manifest, a leftover.sourdough/base/, a name the template cannot use, a folder outside git and a dirty tree; no git, a folder it cannot write and a failed bake are exit 2. A dry run writes nothing and turns the git and writable checks into notes. The wrong-name note now comes at two hinted files, not three, so a raw or laravel-blade app gets it too. Feed's "no manifest" message now sayssourdough adopt <dir> --shape <shape>. Newtests/AdoptCommandTest.php,tests/AdoptFeedTest.phpand the fixturetests/fixtures/adopt/legacy-raw/. - Added: the adopt engine's edge cases, still with no command. A template path that is a symlink, or sits under a symlinked folder, is
yours("a symlink: Sourdough never writes through links") even when the link points nowhere, and so is a file whoserealpath()leaves the app (a Windows junction). A file named in another case (readme.mdforREADME.mdon a case-insensitive disk) isyours, named as the disk has it. A file more than twice the template's size plus 1 KiB isyourswithout being read. Ayoursfile that lacks the name the template writes into it says so, and two of those add a note that the--namemay be wrong. The plan's notes also carry the deprecated-shape notice and a note when.squire.jsonrecords an older or newer Squire kit than the one Sourdough bakes. Adopt refuses a.sourdough/base/left from a manifest that is gone. Newtests/AdoptEdgeCasesTest.php. - Added: the engine behind the coming
sourdough adopt(src/Adopt/), with no command yet. Given an existing app, a shape and a name, it bakes that shape into a scratch dir through the same Bakernewandfeeduse, then looks at each template path in the app, and only those: no file ismissing(left out of the manifest, so the next feed adds it), a file the template seeds isseeded, a file equal to the template's (line endings aside) ismatchand recorded as managed, and anything else isyours. Every recorded hash is the template's, the answers are the onesnewwould record plusadopted: true, and applying writes.sourdough/manifest.jsonand nothing else. It refuses an app that already has a manifest.Permutation::flags()now gives the flags a shape implies, fornew --planand adopt alike. Newtests/AdoptTest.php: a lost manifest on every shape and oven adopts back to the bake's record, an edited app keeps its edits and its own files, a CRLF checkout matches, and feed then treats each status as the spec says. - Added: the manifest has a third file class,
yours, for the comingsourdough adopt: a template file an adopted app keeps its own version of.sourdough feednever writes, merges, removes or reports a yours file and keeps no base copy of it, so the generatedsourdough-feedjob stays green; once the app's copy equals the template's, feed records it and manages it from then on.sourdough manifest --checkskips yours files, as it skips seeded ones. Nothing writes the class yet, andschemastays 1. Newtests/FeedYoursClassTest.php. - Added: deprecations fail the tests, in Sourdough's own suite and in every shape it bakes (BEST_PRACTICES 4.13, now
Enforcedfor the suites). The phpunit config setsfailOnDeprecationandfailOnPhpunitDeprecationand skips indirect deprecations; the Laravel shapes get it on the skeleton'sphpunit.xmlat bake time, plustests/Support/ReportsDeprecationsToPhpUnit.php, because Laravel's error handler drops deprecations while testing. Template code bakes clean on PHP 8.5, and the one PHPUnit deprecation in Sourdough's own tests (a doc-comment data provider) is now an attribute. - Added: the front-end shapes (raw + Vue, Blade + Vue, Inertia) ship a
package-lock.json, seeded so npm owns it after the bake, and theirfrontendjob installs it withnpm ci --ignore-scripts, then fails on a high or criticalnpm auditfinding (BEST_PRACTICES 4.10, nowEnforced). Newtests/TemplateNpmLockTest.phpkeeps each lock in step with itspackage.json, the smoke jobs install withnpm ci, and apps already baked get the template's lock fromsourdough feedonly when they have none. - Added: the Laravel shapes (Blade, Blade with Vue, Inertia) ship
tests/Feature/JobLimitsTest.php, which fails on any queued job underapp/Jobswithout Laravel's#[Tries]and#[Timeout](the older$triesand$timeoutproperties count too) or with a timeout at or above the queue connection'sretry_after; it passes while there are no jobs and is tested on fixture jobs that break each rule (WELD W18, W20).stubs/job.queued.stubandstubs/job.batched.queued.stubmakephp artisan make:jobwrite#[Tries(3)]and#[Timeout(45)], andtests/LaravelJobLimitsTest.phpholds every Laravel shape to both. - Added: tests/KitRoutesAbsentTest.php: no Laravel shape ships Fortify, Breeze or Jetstream, a routes/auth.php, or registration, password reset, email verification or two-factor routes (BEST_PRACTICES 2.2, backlog 5).
- Added: the generated README carries a Support section with the support line
sourdough newprints (status, owner and the end-of-security date from CREED's policy), on every shape (BEST_PRACTICES 2.4). - Added: WORKER_HEARTBEAT_MAX_AGE=0 turns the scheduler heartbeat check off, so an app that runs no scheduler still answers 200 on /ready.
- Added: new bakes take the PHP floor from CREED's
policy.json(BEST_PRACTICES 4.2, nowEnforced). Sourdough requireswaynestate/creed^0.1and reads its policy, or the fileSOURDOUGH_POLICYnames. As of the policy'srefreshed_on, the floor is the oldest PHP line still supported 365 days later, bounded by the Laravel major's PHP range on the Laravel shapes. It is written intocomposer.json(require.php,config.platform.php), the.gitlab-ci.ymlmatrix and the README on all five shapes. A policy that cannot be read bakes on the pinned fallback (^8.3, tested on 8.3, 8.4 and 8.5) and says so. Today's output is unchanged.sourdough newprints aPHP:line, and--dry-run --jsongains aphpobject.tests/PhpFloorTest.phpchanges the policy's floor and checks every shape. - Added: every shape has an owner role, a support status and a sunset path (BEST_PRACTICES 3.7, now
Checked). The new "Support and sunset" guide (docs/guides/support.md) is the policy (the window lengths are a proposal), andresources/shapes.jsonholds the fields.sourdough newprints aSupport:line with the framework's end of security from CREED, and--dry-run --jsongainssupport. A deprecated shape prints a notice on everynewandfeed, and feeding a removed shape names its replacement.tests/ShapeSupportTest.phpholds the catalog to the rules. - Added: every shape's pipeline carries three gates from Preflight 0.3.1 (BEST_PRACTICES 4.15, 6.4 and 6.5, now
Enforced; 3 practices remainNot yet). Accessibility: ana11y-pagesjob boots the app with SESAME's fake driver and saves its pages (/, plus/dashboardsigned in on the Laravel shapes), and thea11ycomponent checks them at WCAG 2.2 AA, blocking. Bill of materials: thesbomcomponent keepssbom.cdx.json, and the front-end shapes'frontendjob addssbom-npm.cdx.jsonfrom CycloneDX's npm tool. Secrets: thesecret-detectioncomponent runs Gitleaks, and a hidden.deploytemplate keeps any future deploy job off merge requests and on protected refs. Each generated README's new "Pipeline" section lists the GitLab settings a file cannot hold. Newtests/TemplateCiGatesTest.php, plustestBakedPipelineCarriesTheCiGatesin every generator test, holds all five shapes to it. - Added: the Laravel + Blade + Vue islands shape has its own
.gitlab-ci.ymlwith afrontendjob (it used to inherit the Blade pipeline, which never built its front end). - Added: the Laravel shapes (Blade, Blade with Vue, Inertia) ship Laravel Boost ^2.10 in require-dev, the stack's guidelines in
.ai/guidelines/wayne-state.md(managed) and starter rules in.ai/rules/(seeded), a.gitignoreblock for whatboost:installwrites (/.mcp.json,/boost.json,/AGENTS.md,/CLAUDE.md,/.claude/skills/,/.junie/;.agents/stays tracked for Booster), a guardedcomposer boost-updateappended to Laravel'spost-update-cmd, a README section, andtests/Feature/BoostDevOnlyTest.php, which fails when Boost leaves require-dev or packages-dev.tests/BoostWiringTest.phpholds the wiring; BEST_PRACTICES 2.3 isEnforced. - Added: every app with a front end ships an
.npmrcwith a one-day npm cooldown (min-release-age=1), a.nvmrcandengines.node >=22in itspackage.json; the shapes without a front end get none of it (BEST_PRACTICES 4.9 and 4.11 areCheckedby the generator tests). - Added: the Laravel shapes schedule a heartbeat each minute and register HELMET's readiness route at /ready with a scheduler check; while the cache stamp is missing or older than WORKER_HEARTBEAT_MAX_AGE seconds (default 180) /ready answers 503, so a stopped scheduler shows up instead of quietly dropping jobs. /up stays the liveness answer and never looks at the cache (WELD W23).
- Added: the Laravel shapes can run the queue from the scheduler, for Citadel where nothing supervises a worker: with QUEUE_WORKER_MODE=scheduler (the new .env.example default) routes/console.php starts queue:work --stop-when-empty --max-time=50 --tries=3 every minute with withoutOverlapping(10); QUEUE_WORKER_MODE=none leaves the queue to a supervisor. QueueWorkerScheduleTest covers both (WELD W19).
- Added: the two Laravel shapes ship tests/Feature/SchedulerNamingTest.php, which fails on any scheduled closure without ->name() (WELD W21).
- 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.
- Added: the Laravel shapes (Blade, Blade with Vue, Inertia) test that a POST without a CSRF token gets 419, and that a matching token or a same-origin request passes (CsrfTest, WELD W27).
- Added: Laravel apps (Blade, Blade with Vue, Inertia) refuse to boot in production with APP_DEBUG on (ProductionDebug, beside the dummy-key guard).
- Added: every shape's
.gitlab-ci.ymlruns asourdough-feedjob (BEST_PRACTICES 3.2, nowChecked): on the shape'scomposerimage, through${IMAGE_PREFIX}and the Composer cache, it installs the newest Sourdough release and runssourdough manifest --checkandsourdough feed --dry-run. Drift in managed files is listed and never fails (feed merges it); a template release the app has not fed exits 1, whichallow_failure: exit_codes: [1]shows as a warning, so it never blocks a deploy; exit 2 (no manifest, a newer manifest, leftover conflict markers, a failed bake) fails the job. Apps already baked get the job with their nextsourdough feed. Newtests/TemplateFeedJobTest.phpholds every shape to the same job and runs its lines on fresh, edited, older and broken bakes of all five shapes and both ovens. BEST_PRACTICES 1.1, 1.2 and 1.3 areEnforcedand name the tests that hold them.
Changed#
- Changed: new bakes require HELMET
^1.3(was^1.0), SESAME^0.7(was^0.6) and PROCTOR^0.11(was^0.8) in the rawcomposer.jsonand both Laravel overlays, and the Laravel overlays CREED^0.1.8(was^0.1). SESAME 0.7 and PROCTOR 0.11 are minor moves across a 0.x line: SESAME'sNativeSessionnow warns once per request when the session cookie lacks HttpOnly, Secure or a Lax or Strict SameSite (the raw shapes callhelmet_boot()beforesession_start(), and the kit'sphp.inisets Lax, so a baked app stays quiet), and PROCTOR 0.9 to 0.11 add checks that mostly warn (case-clashand Boost or Debugbar inrequirefail). The front page's deploy layer moves to CREED^0.1.8, HELMET^1.3and PROCTOR^0.11(locked 0.1.8, 1.3.0 and 0.11.1; were 0.1.7, 1.0.0 and 0.8.0), and Sourdough's own CREED requirement to^0.1.8(Pinstripe locked 0.1.4, was 0.1.0). BEST_PRACTICES 4.4, 4.6 and 5.2 name the new constraint, and 4.6 and 5.2 lose the gaps that waited for it. - Changed: every shape bakes Squire 0.10.2's kit (was 0.10.0), and the front page's deploy layer runs it too (
squire update;squire init --checkpasses; the dev dependency stays^0.10, locked 0.10.2)..squire/php.inisetssession.cookie_samesite = Lax(it was empty), so a raw app's session cookie gives SESAME 0.7 nothing to warn about; the kit's Dockerfiles name every image in full (docker.io/library/...) so Buildah and Podman build them, the fallback base copies Composer 2.11.1 from aCOMPOSER_IMAGEstage, and the portable image dropsnode_modules/after the frontend build. A fed app takes the three files on its nextsourdough feed, like any kit move. - Changed: Composer 2.11.1 everywhere a pipeline, Dockerfile or documented command names it (was 2.10.3, which Squire calls unmaintained; 2.11.1 fixes GHSA-c968-33g3-wh7p and GHSA-fm2w-xgf2-f9fh), pinned by its multi-arch list digest (
sha256:8de2184c..., arm64 included): every shape'scomposer-ci,sourdough-feedanda11y-pagesjobs, the Docker oven'scomposer-binstage, Sourdough's owncomposer-ciandwayneui-copiesjobs, the smoke image and the smoke jobs' checksummed phar (cache keysmoke-tools-composer-2.11.1-node-22.23.4). A fresh bake picks it up; an existing app takes it on its nextsourdough feed. - Changed: the deploy kit is Squire 0.10.0 (was 0.9.0): no kit file changed, so the record moves to 0.10.0, and the dev dependency on waynestate/squire is now ^0.10 (locked 0.10.0). The README, the templates reference and the docs index name the 0.10.0 kit too.
- Changed: the Laravel shapes' SESAME config defaults the CAS protocol to 2.0, as SESAME does, because WSU's CAS is believed to refuse the cookieless /p3/ validation CAS 3.0 uses; set SESAME_CAS_PROTOCOL=3.0 for a CAS server that answers it.
- Changed: BEST_PRACTICES.md closes backlog 6, now that PROCTOR has all four checks it asked for: 4.6 is
Checkedon PROCTOR main (vite-secretswarns on secret-lookingVITE_names, not released yet), 4.4 namesapp-keyandenv-outside-configfor a committed.envandenv()outside config, and 5.2 names 0.9.0'scase-clash. Baked apps getvite-secretsandcase-clashonce the shapes move past PROCTOR^0.8. - Changed: every shape bakes Squire 0.9.0 (was 0.8.0; the dev dependency is
^0.9), and the front page's deploy layer moves from kit 0.7.1 to 0.9.0, gaining the portable image files. A Laravel release now stops before anything installs whenAPP_KEYis unset orAPP_DEBUGis true in production and warns whenAPP_ENVis not production (BEST_PRACTICES 4.14,Checkedfor the release half; every Laravel shape's generator test pins it), and the release gate grades the PHP that runs it (SQUIRE_PHP_RUNTIME). - Changed: the Vue shapes' npm audit blocks on high or critical advisories in runtime dependencies only (--omit=dev); a second run lists dev-only findings without failing.
- Changed: in the Laravel shapes (Blade, Blade with Vue, Inertia),
/readychecks the database and the cache as well as the scheduler heartbeat (app/Health/DatabaseReady.php,app/Health/CacheReady.php), and answers 503 when one fails while/upstays liveness and never asks (WELD W11). The route moves fromroutes/web.phptobootstrap/app.php, outside the web group, as HELMET's readiness guide asks, so a probe no longer writes a session row or sets a cookie.tests/Feature/ReadyChecksTest.phpbreaks each dependency in turn, andtests/LaravelReadyChecksTest.phpholds every Laravel shape to it. - Changed: the front-end templates floor Vite at ^6.4.1, the CVE-2025-62522 fix line, and ignore *.local, where Vite keeps local secrets (BEST_PRACTICES 4.12).
- Changed: every app shape and Sourdough's own CI pin Preflight 0.4.0 (87d9b6f; the proctor job clones the full history, so the override-approver check can read git blame).
- Changed: the Laravel shapes'
config/helmet.phpholds only the app'spolicy_pathoverride, and HELMET's provider merges the rest from the package (BEST_PRACTICES 3.6). The old 403-line copy had fallen behind HELMET: it had no Playbook lookup forHELMET_PRESET, and nosession.secure, metrics storage or warn settings. Feed replaces an unchanged copy, and an edited one gets a conflict to keep your own keys. 3.6 lists the template code still waiting for a library, starting withconfig/sesame.php, which skips Playbook's CAS URL and defaults CAS to protocol 3.0. - Changed: a Laravel bake drops the skeleton's
CLAUDE.mdandAGENTS.mdwhen they hold only Laravel's Boost bootstrap block (boost:installwrites them again); a file with other guidance is kept and stays in git. The overlay merge appendspre-andpost-Composer hooks to the skeleton's instead of replacing them, and a newgitignore-additions.txtcontrol file adds ignore lines once. - Changed:
--no-advisorremoves only ADVISOR's own.mcp.jsonline; the Laravel shapes keep/.mcp.jsonignored for Boost. - Changed: BEST_PRACTICES.md marks 18 practices with their true status on main (exit codes, output, kit features off, Boost, the Laravel window, MySQL 5.6, env config, VITE_ secrets, Composer in CI, npm ci, Vite on localhost, the PHP matrix, APP_KEY, CRLF, Docker images, three OSes, templates as archives, boring startup); 9 remain Not yet.
- Changed: every image in the baked CI files is pinned by digest: composer:2.10.3 now carries its multi-arch list digest, like the Node image already did.
- Changed: the smoke jobs download Composer 2.10.3 and Node 22.23.4 once into a CI cache, check each sha256, and reuse them, instead of fetching both from the internet in every job.
- Changed: the deploy layer and the templates/squire copy run Squire's kit 0.7.1 (was 0.7.0): .squire/php.ini no longer sets the deprecated session.sid_* lines.
- Changed: the scheduled queue worker in the Laravel shapes sets --timeout=45, below the connection's retry_after (Laravel's default 90), and QueueWorkerScheduleTest checks the two (WELD W20).
- Changed: every shape bakes Squire 0.8.0 (was 0.7.1): generated apps get the portable image (
.squire/portable.Dockerfileand.squire/portable/), one image that runs as web, worker, scheduler or migrate for OpenShift, Coolify and raw Docker, and the READMEs say how to build it. - Changed: the local a11y scripts run Preflight's own checker (vendored from 0.3.1 and pinned by a test), so they check what CI checks: axe-core 4.14.0, 320 and 1280 px, and the reflow check.
- Changed: every app shape and Sourdough's own CI pin Preflight 0.3.1 (b90323b; fixed cache keys, and caches saved even when a job fails).
- Changed: every app shape's 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: new bakes require SESAME ^0.6 (was ^0.5); SESAME 0.6.0 has no breaking change for an app that keeps its driver.
- Changed: new bakes start on the Squire 0.7.0 deploy kit: the release script restarts queue workers and the scheduler after optimize (report only; SQUIRE_ARTISAN_RESTART=0 turns it off), and the image drops shell functions from the web's PHP (SQUIRE_PHP_DISABLE_FUNCTIONS), turns on production opcache (SQUIRE_OPCACHE_VALIDATE) and reads secrets from /run/secrets. Sourdough's own deploy layer moves too.
- Changed: every app shape's 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. - Changed: every shape requires PROCTOR ^0.8 (was ^0.7): the raw
composer.jsonand both Laravel overlays. Breaking for apps you feed whose deploy scripts have Windows line endings, which PROCTOR 0.8'scrlf-deploy-scriptfails; the upgrading page has the steps. The deploy layer requires PROCTOR ^0.8 (locked 0.8.0).
Fixed#
- Fixed: the raw and raw + Vue pipelines' header comment says the components are pinned to the Preflight 0.4.0 release commit (it said 0.3.0; the pin was already 0.4.0), and the comment on Sourdough's own deploy-layer PROCTOR job no longer lists findings PROCTOR 0.11 does not report. Comments only.
- Fixed: the manifest leaves out database/database.sqlite, so sourdough feed never treats an app's database as a template file and WELD's regen gate does not see it as drift.
- Fixed: Laravel bakes (blade, blade-vue, inertia) create an empty database/database.sqlite when .env.example uses sqlite, as Laravel's own installer does, so the printed php artisan migrate runs without a prompt.
- Fixed: the Laravel shapes' ProductionDebugTest passes the app's own Pint check and every case asserts something.
- Fixed: the docs menu closes with Escape and hands focus back to its button (docs kit synced from Squire).
- Fixed: scripts/a11y.ps1 works on a Windows checkout with CRLF line endings; it strips the carriage returns from the shell command it hands to Docker, which sh rejected with a syntax error.
- 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:
sourdough manifest --checkforgives line endings, assourdough feeddoes. The raw shapes'.gitattributeschecks*.ps1out with CRLF, so every clone of a fresh raw app reportedscripts/parity.ps1as changed.tests/ManifestCommandTest.phpcovers it. - Fixed: BEST_PRACTICES.md practice 3.4 counts the 0.2.0 tag among the releases that follow the release steps.
Docs#
- Docs: the upgrading guide's 0.3.0 section says what a feed brings an app baked with 0.2.0 (the HELMET, SESAME, PROCTOR and CREED moves, Composer 2.11.1, the Squire 0.10.2 kit), the five breaking cases with a fix for each, what SESAME 0.7's cookie check means for a raw app, and the steps and checks, with
sourdough adoptat the top for apps Sourdough did not make. The README gains a status line, and the install guide, docs index and front page ticket say 0.3.0. - Docs: MAINTAINING's "Who maintains it" names the stack maintainer as a role, not a person, and says to open an issue on git.wayne.edu to reach them; a CI comment, a test comment and BEST_PRACTICES 4.3 stop citing internal decision numbers.
- Docs:
sourdough adoptis documented. A new guide, Adopt an existing app (docs/guides/adopt.md, in the nav after The manifest), joins asourdough adoptsection in the commands reference, theyoursclass in the manifest guide, a troubleshooting entry for each refusal, and updates to the README, MAINTAINING, BEST_PRACTICES, keeping-current, CI, upgrading and docs index pages. On the front page, the feeding schedule gains an Adoption day row with a real adopt report and a Yours jar, a fourth agent prompt adopts an existing app, and the chalk rows now write themselves on even when a jump or a quick scroll skips past their edge. - Docs: the README, docs pages and front page catch up with main. Preflight 0.4.0 replaces 0.3.1 and 0.3.0 in the CI guide, MAINTAINING, troubleshooting (the 0.4.0 SHA), BEST_PRACTICES and the vendored a11y checker line; the templates reference names Squire 0.9.0's kit (
^0.9) and SESAME^0.6; the front-end pages show the runtime-onlynpm audit --omit=dev; the CI guide names the Laravel shapes'proctor-rootjob; "in 0.1" claims are gone, and--describeis said to stop at the plan. The README says Sourdough starts every shape and that the Laravel shapes keepoci8ready. The front page no longer says the generated CI skipssourdough manifest --check, listspackage-lock.jsonas seeded, adds CREED and ADVISOR to the recipe card and the CI gates to the proofing log, names the release that first baked each loaf, and its footer links the docs and git.wayne.edu.site/llms.txtandllms-full.txtare titled Sourdough again (they said# .): the README's title moves out of the centered HTML block the agent-ready kit drops. - Docs: the CI guide, MAINTAINING and BEST_PRACTICES name Preflight 0.3.1 (the release the templates pin), and the --no-input help no longer names Sourdough 0.1.
0.2.0 (2026-11-08)#
Added#
- Added:
tests/PreflightPinTest.php: one Preflight version across every shape's pipeline and Sourdough's own GitLab pipeline; no componentimageinput with a registry prefix; every Docker Hub component in a shape takes the shape'sIMAGE_PREFIX. BEST_PRACTICES 4.3 isEnforcedby it.tests/TemplateCiCacheTest.phpnow checks the${IMAGE_PREFIX}/rule on the app's own jobs only. - Added: a third agent recipe on the front page, for the Laravel shapes (Blade, Blade with Vue islands and Inertia/Vue), and the stale "join the rack" line is gone.
- Added: every bake saves its plan in the app as
.sourdough/plan.yaml(ADR-0014, decision 3), after the bake succeeds: a--planbake saves that plan with the name the app got, a bake from flags saves the shape, the name and all four parts. The file is not in the manifest, so it is neither managed nor seeded:sourdough feedandsourdough manifest --checknever read, rewrite or flag it, and feed writes none for apps baked before.--plannow reads YAML plans (.yamlor.yml) as well as JSON, through the same schema, so the saved plan bakes the same loaf again. Sourdough requiressymfony/yaml^7.4.tests/SavedPlanTest.phpandtests/FeedCommandTest.phpcover it.
Changed#
- Changed: every shape's
.gitlab-ci.ymlpins the Preflight CI components to the 0.3.0 release SHA (23038dfe767f6ef60e3b2efca1128f53d9acdff7with# 0.3.0, was 0.1.4; Preflight 0.2.0 and later need GitLab 18.7 or later). From Preflight 0.3.0 each Docker Hub component adds the registry prefix itself (image_prefix, D-054), so the includes passimage_prefix: "${IMAGE_PREFIX}"and drop theirimageinputs, which only carried the prefix in front of the components' own defaults: the components and the app's own jobs follow one proxy rule. Apps already baked take it withsourdough feed; a Preflight include an owner added with a prefixedimagekeeps the plain name (docs/upgrading.md). - Changed: Sourdough's own GitLab pipeline pins the Preflight components to the
0.3.0release tag (was 0.1.4), and theirimageinputs are plain names (the components add the proxy prefix); the jobs Sourdough defines itself keep${CI_DEPENDENCY_PROXY_GROUP_IMAGE_PREFIX}/. The GitHub workflow stays on Preflight 0.1.4: GitHub's copy of Preflight has no tag after 0.1.4 yet (D-069). - Changed: the
--dockersetup publishes its ports on 127.0.0.1 only, so the dev server and Vite are not reachable from the network (SOURDOUGH-25). - 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. - Changed: apps start on the Squire 0.6.0 deploy kit (was 0.4.0). The copy in
templates/squire/comes from Squire 0.6.0, and the dev dependency is^0.6. - Changed: a baked app's
scripts/release.shasks PROCTOR's deploy gate (proctor gate) for a go or no-go instead of runningproctor check, right aftercomposer auditand before the frontend build and the migrations, soSQUIRE_PROCTOR=enforcestops a no-go before it touches the database. The verdict goes tostorage/squire/proctor-gate.json(new settingSQUIRE_PROCTOR_RECORD_DIR, listed in.env.squire.example; the folder ignores itself) and becomes the baseline the next release is ratcheted against, so a failure that is already live is held and only a new one blocks. With a PROCTOR that has nogatethe step warns and runsproctor checkas before. - Changed: new apps in every shape require HELMET
^0.4(was^0.3), SESAME^0.5(was^0.4) and PROCTOR^0.7(was^0.6); CREED stays^0.1(0.1.7 today). PROCTOR 0.7 bringsproctor gate, which the kit's release script now asks; HELMET 0.4's request metrics stay off untilHELMET_METRICS_STORAGEis set.tests/StackPinsTest.phpchecks all three in every template composer file. - Changed: the Laravel shapes'
config/sesame.phpnames SESAME 0.5'scas.require_pending_login(envSESAME_CAS_REQUIRE_PENDING_LOGIN, default on), with a note to leave it on; the Laravel adapter already hands the cas driver the session. - Changed: every shape's
.gitlab-ci.ymlcaches its downloads. Docker Hub images in the app's own jobs are${IMAGE_PREFIX}/<image>, digest pins kept, and the Preflight components get the same prefix as theirimage_prefixinput;IMAGE_PREFIXdefaults todocker.io, and aworkflow:rule sets it to the group's GitLab Dependency Proxy when the GitLab has one. Composer and npm installs extend.composer-cache(keyed oncomposer.lock) and.npm-cache(keyed onpackage-lock.jsonandpackage.json). A project variableIMAGE_PREFIX=docker.ioskips the proxy. Newtests/TemplateCiCacheTest.phpkeeps every shape that way. Apps already baked take it withsourdough feed.
Fixed#
- 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. - Fixed: BEST_PRACTICES.md's "Keeping generated apps current" tags match the code, each naming the file that holds it: 3.1 (record where the app came from) and 3.3 (merge, not overwrite) are
Enforcedby the manifest andsourdough feed, 3.2 (a check that fails CI) isPartly enforced(feed --dry-runandmanifest --checkexist; no template runs them in CI yet), 3.4 (tags and migration notes) isDocumentedin the release steps, and 3.5 (compatibility CI) isCheckedby the smoke gate, which still only warns. They all saidNot yetorDocumented. 4.3 keepsPartly enforcedand now names its templates and test. - Fixed: BEST_PRACTICES.md describes Sourdough as it is (0.1.7, all five shapes bake,
manifestandfeedship) instead of a tool with no code on main, and practice 6.1 (wire the stack in by default) isEnforcedby the generator tests in every shape; it said only the raw shape generated. - Fixed: the local parity fallback image builds when the host's uid or gid already belongs to an account in the image (a host gid of 1001, like GitHub's runners, collided with the container user's default).
- Fixed:
scripts/parity.ps1builds the fallback image with the host's uid and gid (1000 on Windows, the current user's ids on Linux and macOS) instead of a fixed 1000, so the app container starts when the bind-mounted source belongs to another user. - Fixed: the raw shapes (
--raw,--raw --vue) sign in with CAS in production.public/index.phpcalledDriverFactory::make($config)with no HTTP client, so withAPP_ENV=productionthe cas driver refused to boot; it now passes a Guzzle client (10 second timeout, no redirects, TLS verification on), anyholm/psr7request factory and the app'sNativeSession, which SESAME 0.5's cas driver needs for its pending-login marker (a ticket is accepted only for a sign-in this browser started). The raw template requiresguzzlehttp/guzzle^7.9 || ^8.0andnyholm/psr7^1.8.
0.1.7 (2026-11-07)#
Added#
- Added:
sourdough feedbrings template updates into an app made withsourdough new, without clobbering what the app changed (ADR-0014, decision 4). It bakes the app's shape again with the answers in its manifest and goes file by file: files the template did not change are left alone, untouched managed files take the new version, files both sides changed are three-way merged bygit merge-file, same-line changes get git's conflict markers (<<<<<<< app...>>>>>>> sourdough <version>) and never a silent overwrite, new template files are added, dropped ones are removed only when untouched, binary files are never merged (the template's copy lands as<file>.sourdough-new), and seeded files are never touched. The base for a merge is found by its manifest hash, in.sourdough/base/(the template's version of each changed managed file, kept by the previous feed) or anywhere in the app's git history; with no base, both versions are marked. Feed then moves the manifest to the new base. It runs only on a clean git tree, refuses while the last feed's markers are unresolved, and refuses a manifest from a newer Sourdough.--dry-runprints the plan and writes nothing (exit0fresh,1feeding would change files, so it works as a CI gate),--jsonprints the plan for machines; a real feed exits0fed cleanly,1fed with conflicts,2tool error. It needs git and nothing else. Every shape is covered bytests/FeedCommandTest.php, and the smoke gate now checks that a fresh bake of each shape has nothing to feed. - Added: the proof harness,
scripts/proof.sh(Linux, macOS) andscripts/proof.ps1(Windows), and the Proof page (docs/reference/proof.md) with its dated Last run table. In Docker, one after another, it runs the smoke gate on all five shapes and on every Laravel shape with--sailand with--docker(eleven runs), and feeds a bake of the last release (read from this changelog) forward in each. It writesproof-out/last-run.md, a summary and every step log, and exits1when any run fails. A GitLabproofjob runs it by hand or on a schedule that setsSOURDOUGH_PROOFto1, never on a push, and keeps the results as an artifact.tests/ProofHarnessTest.phpkeeps the two scripts, the gate, the CI job and the table listing the same runs. - Added: the smoke gate checks more of every loaf. Right after the bake,
sourdough manifest --checkmust be clean. Every shape runs its own suite as its own step (the count goes in the proof table) andcomposer proctor. The Laravel shapes now boot too, on Laravel's own router:/must answer with the shape's home page (the Blade page, the built Vue islands, or the InertiaHomepage),/dashboardafter SESAME's fake sign-in,/nope404 and/up200; the raw shape's/must carry its home page in WayneUI's shell. A second argument,--sailor--docker, proves a Laravel shape's oven (the scaffold's files, install, suite, PROCTOR), andSMOKE_FEED_FROM=<version>bakes that release from Packagist and feeds it forward.scripts/smoke-shape.ps1takes-Ovenand-FeedFromto match. - Added: the Laravel shapes ship skeleton feature tests (
tests/Feature/SkeletonTest.php, Pest, next to the starter's example tests):/upanswers 200, the home page answers 200 for a guest (the Blade page, the built Vue island, or the InertiaHomecomponent), a guest at/dashboardgoes to the sign-in flow, the dashboard renders for a signed-in user after SESAME's fake sign-in (with the islands view'sdata-vue-island="counter"island and the InertiaDashboardcomponent checked too), a missing page answers 404, andUserResolver::refreshUser()turns a stored user array back into theUserby username, ornullwhen the username no longer exists. Each baked Laravel suite grows from two tests to nine, and the proof table quotes the new counts.
Changed#
- Changed: the front page's deploy layer (
deploy/) runs Squire's kit 0.5.0 (was 0.4.0):.squire/base-fallback.Dockerfileandscripts/parity.ps1take the new templates, 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 (ADR-0021); docs, links and package metadata no longer point at the archived nougat copy.
- Changed: the Inertia shape bakes on Inertia 3:
inertiajs/inertia-laravel^3.0and@inertiajs/vue3^3.0(PHP 8.2+, Laravel 11+, ESM only, no bundled Axios). The root view marks its titledata-inertiainstead of the bareinertiaattribute, and Inertia now hands the first page to Vue in a<script type="application/json">element instead of the root div'sdata-pageattribute (HELMET's CSP is untouched: a JSON data block never runs). The template never used Axios,Inertia::lazy(),router.cancel()or thefutureoptions, so the rest of it bakes as before (one fix rides along: the progress bar's nonce, below). Apps already baked: the Upgrading page's Unreleased section has the steps (sourdough feed, thencomposer updateandnpm install). - Changed: new apps in every shape require PROCTOR
^0.6(was^0.4). The Laravel shapes'composer proctorscript is now plainproctor check: PROCTOR 0.6 refuses--policyin CI unless the job setsPROCTOR_ALLOW_OVERRIDES=1, and without the option it still reads CREED's released policy fromvendor/waynestate/creedon its own. PROCTOR 0.6 also failscomposer-auditwhen the app has nocomposer.lockor Composer is not onPATH; every baked pipeline installs first, so a baked app passes as before. - Changed: the smoke gate reads the Inertia
HomeandDashboardpages from Inertia 3's JSON page element, andtests/StackPinsTest.phpkeeps the PROCTOR and Inertia lines, the plainproctor checkscript and thedata-inertiatitle from slipping back.
Fixed#
-
Fixed: the Inertia shape's progress bar wears its styles again. Inertia injects them in an inline
<style>, and HELMET's CSP admits one only with the request's nonce, so the browser refused it on every page ("Refused to apply inline style") and the bar ran unstyled.resources/js/app.tsnow reads the nonce from the pre-paint script'snonceproperty and hands it to Inertia 3's newnonceoption, which stamps it on everything Inertia injects; no CSP is loosened. -
Fixed: the Laravel templates'
UserResolverlists its interfaces in Pint's order (RefreshesUserbeforeUserResolverContract), so a freshly baked app passes its ownpint --teston the first run instead of failingcomposer ci. -
Fixed: Baked apps pin
config.platform.phpto their PHP floor, so PROCTOR no longer flags the lock. -
Fixed: Baked Laravel apps read the signed-in user again on every request, so Laravel 13's JSON sessions no longer sign everyone out after the first page.
-
Fixed:
sourdough feedbrings an app baked by 0.1.6 with--sailor--dockerforward with its oven. 0.1.6 wrote the manifest before the oven's scaffold ran, so the answers named no oven, the oven's files were not in it, andcomposer.jsonwas hashed before the scaffold edited it: feed baked the plain shape, found it "Fresh", and leftsourdough manifest --checkreportingcomposer.jsonchanged for good. Feed now reads the oven from the app's files when a 0.1.6 manifest names none (aDockerfile,compose.yamland thedev-upscript for Docker;laravel/sailand Sail'scompose.yamlfor Sail) and says so in anote:line. The proof harness found it. -
Fixed:
sourdough feedrecords a managed file that already holds the template's new version (a newrecordaction) instead of passing over it in silence. Nothing in the file is written, but the manifest moves to the new hash, sosourdough manifest --checkstops calling it changed. A plan of onlyrecordlines is a change:--dry-runexits1, and the real feed writes the manifest. -
Fixed: a 0.1.6 oven bake feeds forward without a
composer.jsonconflict: the manifest hashed the file before the scaffold edited it, so feed undoes the scaffold's edit to recover the pre-scaffold composer data, verifies it against the recorded hash, reapplies the scaffold and uses the result as the merge base; an app that never touched the file takes the template'scomposer.jsonas an update, and a real app edit still merges or conflicts as before. -
Fixed: the manifest of an app baked with
--sailor--dockerlists the scaffold's files (Dockerfile,compose.yaml,.dockerignore, thedocker/ini files) and the composer.json the scaffold edited, and recordssailordockerin its answers again, sosourdough manifest --checkis clean right after the bake. It was written before the scaffold ran, so the check reportedcomposer.jsonas changed on a fresh app.newandfeednow bake through oneBaker. -
Fixed: the front page's feeding schedule shows its rows again for visitors who allow motion. Each row is clipped until it wipes in, and Chromium counts a clipped row as 0 % visible, so the reveal's 20 % threshold never fired and the rows stayed blank. The reveal now trips on the row's first edge, 15 % above the bottom of the screen.
-
Fixed: the docs pages reflow at 320 px (WCAG 1.4.10). The version ticket in the shared header carried
flex-shrink: 0, so the header row could not give up ground and every docs page measured 328 px wide in a 320 px viewport. The ticket now shrinks and wraps to its version number instead of holding its width. The front page's five crumb buttons are named by their visible words too: eacharia-labelstarts with "Score it", the words the hint shows, so the accessible name contains the visible text (axelabel-content-name-mismatch).
0.1.6 (2026-11-06)#
Added#
- Added: the site accessibility gate:
scripts/a11y.sh(Git Bash, Linux, macOS) andscripts/a11y.ps1(Windows) run axe-core (WCAG 2.2 AA) in Docker over every committed HTML page undersite/, in light and dark at 360 px and 1280 px. - Added:
sourdough new --raw --vuebakes a raw PHP + Vue SPA over JSON app, the fifth and last shape. The raw template comes first (HELMET, the session and SESAME boot the same way, Squire's deploy files, Pinstripe, PROCTOR, Playbook and ADVISOR wiring), thentemplates/raw-vue/over it: a front controller that answers JSON under/api/(/api/mereturns the signed-in user, or401instead of sending afetch()to CAS) and sends the Vue page for/(and for any other path, with a404); Vue 3 and Vite with WayneUI's Vue components and its layered dist stylesheet from@waynestate/wayne-ui-vueand@waynestate/wayne-ui-css2.0.8, pinned exactly as in the Inertia shape; andsrc/Vite.php, a small tested reader for Vite's manifest that prints the tags with HELMET's CSP nonce, or points at the dev server whilenpm run devruns (and adds it to the CSP, never in production). Its Next steps:composer install,npm install,npm run build,composer serve. The--raw --vueplan no longer ends in "not available in this release", and asmoke-raw-vueCI job bakes the shape and checks/,/api/meand/upon a live server. All five loaves bake now. - Added: the Laravel shapes refuse to boot production on the tests' dummy APP_KEY (
app/Support/DummyAppKey.php, called fromAppServiceProvider::boot()), andtests/Support/SkipEnvFile.phphands the tests that one dummy key (base64 of 32 zero bytes) when nothing else sets one. WELD ships the same files. - Added: the docs site in
site/docs/is built by the shared Squire docs-site builder (bin/docs-site.php) from the pages indocs/, andcomposer cichecks it with@docs:check. - Added: the smoke gate proves a live baked raw app serves: it fetches the pinned WayneUI release once into
public/wayne-ui.php, starts the app withAPP_ENV=localon127.0.0.1:8099and expects/200,/nope404 and/up200. Every shape now bakes with--no-playbook, because Playbook is required by default and its private package cannot be installed credential-free. - Added:
--dockergenerates the app's own Docker setup for the Laravel shapes (--laravel,--laravel --vueand--inertia): a two-targetDockerfile(dev and prod) whose base images are pinned by manifest-list digest, so one pin resolves natively on amd64 and arm64, acompose.yamlwith a MySQL 8.4 service (and a vite service for the Vue and Inertia shapes), a.dockerignore, the PHP ini files the image copies in, thecomposer dev-up,dev-downanddev-shellscripts, the database settings in.env.example, and a "Run it locally with Docker" README section. It works natively on Windows, macOS and Linux (no WSL2 needed). Playbook credentials reach a production build only as a BuildKit secret, never a build arg, and theFROMlines are the single place to swap in SQUIRE's Citadel-parity image when it exists. - Added:
--sailgenerates a Sail setup (compose.yaml, laravel/sail) for the Laravel shapes. - Added: the raw template's
.gitlab-ci.ymlruns an explicitcomposer-cijob (composer install, thencomposer ci), mirroring the Laravel overlay, so PROCTOR sees acomposer ciin the pipeline instead of warning that no job runs it. - Added: generated apps in Require mode get a
composer playbookscript (@composer show waynestate/playbook --no-interaction) with itsscripts-descriptionsentry, so you can check any time whether Playbook (WSU shared values) is installed. Existing scripts keep their order andplaybookis appended last; an existingplaybookscript is left alone. - Added: the raw template ships Pinstripe's coding standard:
pint.json(the per preset, with the fetchedpublic/wayne-ui.phpkept out andvendorexcluded) andphpstan.neon(Pinstripe's raw preset, level 8 oversrc/andpublic/),waynestate/pinstripein require-dev with the extension-installer plugin allowed, andlint,fixandanalysescripts, socomposer ciruns test, lint, analyse, proctor and audit in that order. - Added: the front page's main nav links the docs site.
Changed#
- Changed: the Inertia shape draws with WayneUI instead of the Tailwind starter kit, the same wiring WELD ships.
@waynestate/wayne-ui-cssand@waynestate/wayne-ui-vue2.0.8 are pinned exactly; every page wears WayneUI's app bar (shield, theme toggle), the sidebar that becomes a focus-trapping drawer on phones, breadcrumbs, cards and footer; a pre-paint script under HELMET's nonce stops the dark-mode flash; Ziggy's client comes from theziggy-jsnpm package. The home page and the dashboard are new, in WayneUI's components and tokens.eslint.config.jsrefusescomponents/uiimports and the kit's helper packages,.prettierrcis the stack's, and afrontendCI job runs lint, Prettier, vue-tsc and the build. - Changed: the Laravel shapes (Blade, Blade + Vue, Inertia) generate apps on Pest 4 (
tests/Pest.php, a Pest example test,composer testandcomposer cirun Pest, PHPUnit tests unchanged, tests read.env, or.env.examplewhen there is no.env); the raw shape is unchanged. - Changed: the docs site wears Sourdough's own look: the front page header and menu (Docs marked current), the gold version ticket, Caprasimo titles, the baker's Kalam hand for labels, the recipe terminal with its gold Copy pill for commands, recipe-card tables, baker's-note callouts and the deep green footer, with a derived chalkboard dark mode. Source:
docs/_header.html,docs/theme/sourdough.cssand athemekey indocs/docs.json; the kit'sdocs.cssis unchanged. - Changed:
sourdough newnow requireswaynestate/playbookin every app it bakes: the VCS repository, the package inrequire,config.gitlab-domainsso Composer sends the token to git.wayne.edu, the.env.exampleblock, and a README section with the access how-to. The command checks read access before writing anything (a Composer credential, then a direct git probe) and refuses with exit1until the developer can read the package; an unreachable git.wayne.edu generates with a warning, and non-interactive and CI runs skip the check.--playbookstays as a no-op for old scripts, and--no-playbookis for CI and automated tests only. - Changed: the raw template's code passes both of Pinstripe's tools: per-preset style fixes in
Oracle,OracleException,public/index.phpandOracleTest, precise closure and binds types inOracle, a false guard foroci_error()results, and the connect-failure branch reporting the last driver error instead of passing the failed connection as its source. A freshly baked raw app passes its own checks. - 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 at its tag commit); the deploy layer sets minimum-stability to stable.
- Changed: new apps now get HELMET
^0.3, SESAME^0.4and PROCTOR^0.4, and their.gitlab-ci.ymlpins the Preflight CI components to the 0.1.4 release SHA (79029cc2300702d0d450c42cc699e12af1b731f8, with the tag in a trailing comment) because PROCTOR 0.4'spreflight-pinnedcheck wants a 40-hex SHA. - Changed: the smoke gate runs
php artisan migratelike the Next steps, and the Laravel template READMEs showmigratefor local andmigrate --forcefor deploys.
Removed#
- Removed: from the Inertia shape,
tailwind.config.js,cn()(resources/js/lib/utils.ts),tailwindcss,autoprefixer,tailwind-merge,clsx,lucide-vue-next,@vueuse/core,prettier-plugin-tailwindcss, the Bunny Fonts link and the ten kit components they served.
Fixed#
- Fixed:
--sailapps answer 200 on/and/upwhen the checkout is one Sail'ssailuser cannot write (a Windows drive under Docker Desktop, or files a root container wrote). Every page was a 500 namingtempnam(), because Blade could not writestorage/framework/views. The compose file's entrypoint now gives thesailuser itsWWWUSERuid first (so asail artisanrun the momentsail up -dreturns no longer runs as the image's uid 1337 and leaves a log file the server cannot append to), opens the app's files to that user only when it cannot write them (vendor/,node_modules/and.gituntouched), then starts Sail as usual. - Fixed:
--dockerapps with a vite service (Blade + Vue, Inertia) serve/on the firstcomposer dev-up. Nothing installednode_modules, so the vite service exited withvite: not foundand/was a 500 (Vite manifest not found). The service now runsnpm installwhen Vite is missing, thennpm run dev. - Fixed: the Laravel shapes' (Blade, Blade + Vue, Inertia)
.gitlab-ci.ymlruns the php-test matrix withvendor/bin/pest. The Preflight component defaults tovendor/bin/phpunit, which refuses the Pest example tests ("Please run ./vendor/bin/pest instead"), so every job in the matrix crashed with exit 255. Pest runs the PHPUnit class tests too. - Fixed:
--dockerapps with a vite service (Blade + Vue, Inertia) load their pages. The service rannpm run dev -- --host 0.0.0.0, so laravel-vite-plugin wrotehttp://0.0.0.0:5173topublic/hotand the browser got a blank page; it now runsnpm run devwithLARAVEL_SAIL=1, which listens on every address and writeshttp://localhost:5173. - Fixed: the GitLab smoke jobs (raw, Blade, Blade + Vue, Inertia) failed before they started: the Composer installer's options were handed to
phpitself (no argument for option -). They now go after--, with Composer pinned to 2.10.3, and the image getsunzipso Composer can unpack the locked packages. - Fixed: a freshly baked Laravel app passes its own
pint --testagain: the Pest example tests are written out over several lines andtests/Support/SkipEnvFile.phpuses imports and Laravel's operator order, socomposer cino longer fails on the template's own style. - Fixed: raw apps start with
composer serve. The oldphp -S localhost:8000 -t publicline booted the app as production, because the raw front controller defaultsAPP_ENVto production when it is unset. The raw template's newservescript disables Composer's process timeout, setsAPP_ENV=localcross-platform with@putenv, then startsphp -S localhost:8000 -t public, so SESAME signs in with its fake driver; the raw Next steps, the raw README and the site recipe all point atcomposer servenow. - Fixed: the raw front controller answers
404for any path but/(a short not-found page that keeps WayneUI's layout and links home) instead of rendering the home page for every URL./upstays HELMET's and answers first. - Fixed: the GitHub CI workflow was rejected as invalid (every run failed with "workflow file issue") because the smoke job used GitLab's
allow_failure; it now usescontinue-on-error. - Fixed: the sourdough command now works after composer global require (bin/sourdough also looks for the autoloader three folders up, where a dependency install keeps it).
- Fixed: the Laravel Next steps now run
php artisan migrateafterphp artisan key:generate(all three Laravel shapes), so a freshly baked app has its database before the first request instead of answering 500 until someone migrates by hand. - Fixed: the Blade and Blade + Vue islands views read the signed-in user as an array (
$user['name']), because SESAME'sSesame::user()returns an array, not an object; the dashboard and the layout no longer crash after sign-in. - Fixed: the laravel-blade template ships
app/Providers/AppServiceProvider.phpwithSchema::defaultStringLength(191)like the laravel-inertia one, so string columns stay inside Citadel's MySQL 5.6 index limit (PROCTORmysql56-string-default). - Fixed: the Oracle check command in the laravel-blade and laravel-inertia templates compares in Pint's non-Yoda order (
$script === null), so a freshly baked app passes its owncomposer cion the first run. - Fixed: the laravel-blade-vue template ships
tests/Feature/ExampleTest.phpwith$this->withoutVite(), socomposer ciin a freshly baked islands app no longer fails on the missing Vite manifest beforenpm run buildhas run. - Fixed: the Playbook wiring no longer drops a template's own composer config keys.
- Fixed: the raw template ships
stubs/wayne-ui.php, a static-analysis stub for the run-time WayneUI functions (wsu_shell_start,wsu_shell_end) thatphpstan.neonscans throughscanFiles, socomposer ciin a freshly baked raw app no longer fails with function-not-found errors for functions that arrive only with the fetchedpublic/wayne-ui.php.
Security#
- Security: the front-page deploy layer moves to Symfony 7.4.23 (symfony/http-foundation and symfony/yaml advisories, including CVE-2026-118514).
0.1.5 (2026-11-03)#
Added#
- Added:
sourdough new --laravelbakes a Laravel + Blade app: a fresh Laravel skeleton from Composer, the laravel-blade overlay, the stack packages, Squire's laravel deploy files and the manifest. Its Next steps suit the shape:composer install,cp .env.example .env,php artisan key:generate,php artisan serve. One more loaf on the bench. - Added:
sourdough new --inertiabakes a Laravel + Inertia/Vue app: the same Laravel skeleton, the laravel-inertia overlay (Inertia pages rendered by Vue, Ziggy routes, the stack packages), Squire's laravel deploy files and the manifest. Its Next steps suit the shape:composer install,cp .env.example .env,php artisan key:generate,npm install,npm run build,php artisan serve. Three of the five loaves bake now. - Added:
sourdough new --laravel --vuebakes a Laravel + Blade + Vue islands app: the Laravel + Blade bake under a front-end layer (Vite with the Vue plugin, aresources/js/app.jsregistry that mounts a Vue 3 app on every[data-vue-island]element, and a Counter island live on the dashboard view). Its Next steps suit the shape:composer install,cp .env.example .env,php artisan key:generate,npm install,npm run build,php artisan serve. Four of the five loaves bake now. - Added: the raw template ships
scripts(test,proctor,ci) andscripts-descriptions, so a generated raw app can run its own gate locally withcomposer ci. - Added: generated apps ship ADVISOR by default.
waynestate/advisorlands inrequire-dev(raw template and the laravel-blade overlay),.mcp.jsonis git-ignored, the README gains an "ADVISOR" section, and the Next steps printphp vendor/bin/advisor install --client=claude --write.--no-advisorskips all of it and records the choice in the manifest. - Added: the smoke gate (
scripts/smoke-shape.sh,scripts/smoke-shape.ps1,scripts/smoke.Dockerfile) bakes a shape with this checkout's own CLI and runs the generated app's own checks; CI runs one job per shape, allallow_failure: trueuntil seen green once.
Changed#
- Changed:
--nameon the Laravel bakes reaches every place WELD applies it by hand:composer.json'snamebecomesapp/<slug>(an application is not a published package) with the description reading"<name>, a Wayne State app baked from Sourdough.",.env.example'sAPP_NAMEcarries the app name (quoted when it holds a space), and theconfig/app.phpdefault follows it. - Changed: the raw template pins WayneUI 2.0.8 (
https://wayneui.apps.wayne.edu/v2/releases/2.0.8/wayne-ui.php) instead of fetching the floatingmainbranch copy. - Changed: the raw template's
.gitlab-ci.ymlpins the Preflight components to released Preflight tags; the "not cut yet" note is gone. - Changed: the Squire copy comes from Squire 0.4.0 (adds oracle-check.php to every target; the dev dependency is now ^0.4).
- 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).
- Changed: the deploy layer's Squire kit is refreshed to 0.4.0 (deploy/oracle-check.php arrives; release.sh runs it without failing the release).
- 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: the laravel-inertia template ships AppServiceProvider (string length 191 for Citadel's MySQL 5.6) and a tests/TestCase.php that writes a stub Vite manifest, so view tests boot without a build. WELD had both; now every Inertia app does.
- Changed: the laravel-inertia template's
.gitlab-ci.ymlgains theziggyjob WELD carries by hand: it regeneratesresources/js/ziggy.*and fails on any diff, so the route list that ships inside the Vite bundle always matches the routes. - 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.
- Changed: the front page tells the truth about the shapes. The Laravel + Blade, Laravel + Blade + Vue islands and Laravel + Inertia/Vue loaves come out of the oven with their real commands; the hero, the rack note and the two agent prompts name the four that bake in 0.1; and WELD reads as the Inertia/Vue shape already built from Sourdough, not the other starter. Only raw PHP with Vue stays proofing.
Fixed#
- Fixed: the laravel-inertia bake drops the skeleton leftovers before the manifest is written:
vite.config.js(next to the overlay'svite.config.tsit breaksnpm run build), the deadresources/js/app.jsstub, andresources/views/welcome.blade.php(no route renders it); the manifest no longer lists a file that is gone. - Fixed:
php artisan oracle:checkfinds the kit where it lives, in both the laravel-blade and the laravel-inertia templates:oracle-check.phpat the app root (Squire's Laravel layout) first, thendeploy/oracle-check.php(WELD's home). - Fixed:
composer installin a freshly baked Laravel + Blade app no longer stops at the plugin gate; the overlay allowsphpstan/extension-installernext to the pinnedext-oci8. - Fixed: the laravel-inertia overlay now passes a real run of a generated app. The overlay allows
phpstan/extension-installerin composer config socomposer installsucceeds, the appended SESAME and HELMET env keys ship commented out (exceptSESAME_DRIVER=fake) so package defaults hold instead of being overridden by empty values, the generator removes the skeleton'svite.config.jsso it no longer sits next to the overlay'svite.config.tsand breaksnpm run build, and the Oracle command, Oracle error helper and bootstrap are Pint-clean like their Blade twins. - Fixed: a fresh Laravel + Blade app boots with nothing in its environment.
config/sesame.phpdefaultsSESAME_FAKE_USERNAMEtojane.doe(SESAME wants a non-empty fake username), and the appended SESAME and HELMET env keys ship commented out so their defaults hold instead of being overridden by empty values. - Fixed: the plan printed after
sourdough new --laravelno longer carries the "(not available in this release)" suffix; only the permutations that really refuse keep it. - Fixed: the generated Laravel + Blade app passes its own
composer ci. The template's Oracle command, Oracle error helper and bootstrap are Pint-clean, and Pint skips the two Squire-owned root scripts (health.php,oracle-check.php) throughnotPath. - Fixed: the agent-ready site twins (
site/index.md,site/llms-full.txt) are resynced with the README, so thesite:agent-ready-checkstep ofcomposer cipasses. - Fixed: the laravel-inertia template boots a fresh app out of the box:
config/sesame.phpdefaultsSESAME_FAKE_USERNAMEtojane.doeso the fake driver has a non-empty username, and Pint skips the two verbatim Squire files (health.php,oracle-check.php) throughnotPath.
0.1.4 (2026-10-29)#
Added#
- Added: agent-ready site (prompt blocks, Markdown twins, llms.txt), from Squire's kit.
Changed#
- The Squire template copy in
templates/squire/now comes from thewaynestate/squireComposer package (new dev dependency,^0.2) instead of a Squire checkout.composer squire-copy:syncrewrites the copy fromvendor/waynestate/squire, andcomposer squire-copy:check(now part ofcomposer ci) exits 1 when the committed copy has drifted. The refresh brings Squire 0.2.0's deploy files:scripts/release.shgains theSQUIRE_PROCTOR=enforcehandling, and thestatictarget joins the catalog. Fresh flour, straight from the mill. - Changed: project names written as words except acronyms.
- Changed: generated apps require SESAME ^0.2 (Entra sign-in).
- Changed: the Squire copy comes from Squire 0.3.0.
Fixed#
- Fixed:
--laravel --inertiais accepted. - Fixed: stale capability claims in the site and README.
0.1.3 (2026-10-29)#
Added#
sourdough newwires PLAYBOOK into generated apps. By default the app'scomposer.jsongets asuggestforwaynestate/playbook,.env.examplelists the seven WSU shared setting names, the README gains a "WSU values (PLAYBOOK)" section, and the command prints a hint line pointing at it.--playbookadds the VCS repository and requireswaynestate/playbook^0.1;--no-playbookskips all of it; the two flags together are refused with exit 1.
0.1.2 (2026-10-29)#
Added#
sourdough newvalidates the app name before writing anything: it must start with a letter or number and use only letters, numbers, spaces, dots, dashes and underscores, at most 63 characters (RawGenerator::assertValidName). Hostile names (quotes, backslashes, newlines, NUL bytes, placeholders, path traversal, overlong or empty names) are refused with exit 1 and write nothing.
Changed#
- The raw template now requires HELMET
^0.2and PROCTOR^0.2, sosourdough newinstalls the current stack releases instead of the 0.1 line. SESAME stays at^0.1until it cuts 0.2.
0.1.1 (2026-10-29)#
Changed#
- PHPStan and Pint now take their settings from Pinstripe (
waynestate/pinstripe^0.1) instead of a hand copy:phpstan.neonincludes the raw preset, andpint.jsonextends the per preset. Same cut, off the rack.
0.1.0 (2026-10-29)#
Added#
- The raw app now installs SQUIRE's deploy files from a checked copy at
templates/squire/:build.sh,deployments/001-first-release.sh,scripts/release.sh,scripts/parity.sh,scripts/parity.ps1,health.php,public/up.php,docker-compose.squire.yml,.env.squire.example, and the.squire/build context. SQUIRE owns them; Sourdough copies them as-is and records them in the manifest. composer squire-copy:check: verify thattemplates/squire/still matches a fresh export from the SQUIRE checkout (SQUIRE_PATH, default/squire). Skips with exit 0 when no checkout is mounted.
Changed#
- Refreshed the SQUIRE template copy in
templates/squire/from e66f07b to 2a893c0: the Vue layer's.npmrcanddocker-compose.squire.ymljoined the batch. Fresh flour, same recipe.
Removed#
- The raw template's own
deployments/release.shanddeployments/release.ps1; the release steps now come from SQUIRE.