Upgrading#
This page walks through each released version of ADVISOR and what changed, so you can see whether a new version affects your app.
[0.3.0] - 2026-11-09#
A new minor line, so a ^0.2 constraint does not pick it up: move to composer require --dev waynestate/advisor:^0.3. No code in your app changes; the MCP server reports version 0.3.0.
- The parts list has fifteen projects: Parity, Citadel on your own computer, comes after Squire.
get_project_statusandread_project_docstakeparity, so an agent that validates project ids against the tool's enum sees one more. owner_ofanswers "local development" with Parity, and the deploy-files row no longer lists the parity kit under Squire.- A project whose
CHANGELOG.mdheading says unreleased no longer shows that number as its version, and a Go module counts as built. - The bundled data is resynced with the stack's 2026-11-09 night main branches, and the front page deploy layer runs Squire's kit 0.10.2 with CREED ^0.1.8 and HELMET ^1.3.
[0.2.0] - 2026-11-09#
A new minor line, so a ^0.1 constraint does not pick it up: move to composer require --dev waynestate/advisor:^0.2. ADVISOR now requires waynestate/creed (^0.1.8); if your app locks an older CREED (PROCTOR brings one), let Composer move it too with composer update waynestate/advisor --with-dependencies. The MCP server reports version 0.2.0.
policy_lookupandget_project_statusanswer through CREED's own reader, so they say exactly what PROCTOR decides. A line the policy marks current (Vue 3, Inertia 2 and 3) now readsactiveinstead of having no state, and a version older than every line the policy lists is answered as end of life with a note instead of being refused.upgrade_pathtakesfrom_php, for a project whosecomposer.jsonnames no PHP constraint (Booster's--from-php).- Only for module authors:
ContentBundle::policy()returns CREED'sWaynestate\Creed\Policy,Content\PolicyReaderonly checks the schema version, andContent\Stateis gone (useWaynestate\Creed\State). Squire's module (Waynestate\Squire\Advisor\SquireModule) uses none of these. - The bundled data is resynced with the stack's 2026-11-09 main branches, the docs gain four threat pages, and the front page deploy layer runs Squire's kit 0.10.1 with HELMET ^1.0 and PROCTOR ^0.11.
[0.1.7] - 2026-11-07#
No breaking changes are marked for this release. Update with composer update waynestate/advisor; the MCP server reports version 0.1.7.
owner_ofanswers from an ownership table rebuilt from the stack's decisions, andread_project_docstrims image boilerplate at read time as well.- The bundled data is resynced with the stack's 2026-11-07 releases, and the canonical repository is git.wayne.edu.
[0.1.6] - 2026-11-06#
No breaking changes are marked for this release. Update with composer update waynestate/advisor; the MCP server reports version 0.1.6.
- symfony/console and symfony/process accept ^8.0 as well as ^7.4, so apps on Pest 5 / PHPUnit 13 can install ADVISOR.
- The bundled data is resynced with the stack's main branches through the evening of 2026-11-06, including Booster 1.9.0, WELD 0.1.3, the accessibility gates across the stack and the Sourdough raw PHP + Vue shape.
- A docs site built from
docs/is added and checked incomposer ci, and the front page and docs pass an accessibility gate. The proof runner is dev tooling and is not part of the served product.
[0.1.5] - 2026-11-03#
No breaking changes are marked for this release.
- The deploy layer requires HELMET ^0.3 and PROCTOR ^0.4 (locked at 0.3.0 and 0.4.0) and sets minimum-stability to stable, which clears PROCTOR 0.4's new minimum-stability warning. HELMET 0.3 reads an empty
HELMET_PROXIES=as trust nobody; the front page sets only thecitadelpreset, so nothing changes for it. - The deploy layer's Squire kit is refreshed to 0.5.0 (updated
base-fallback.Dockerfile,scripts/release.shandscripts/parity.ps1). - The bundled data is resynced with the 2026-11-03 releases: Booster 1.8.0, Preflight 0.1.4, PROCTOR 0.4.0, Pinstripe 0.1.2, CREED 0.1.6, Rollcall 0.1.9, HELMET 0.3.0, SESAME 0.4.0, Drawbridge 0.1.1, Sourdough 0.1.5, Squire 0.5.0 and WELD 0.1.2, and with each project's main since the last pass.
- One Playbook settings resolver (
Waynestate\Advisor\Playbook\Settings, ADR-0018) is added.playbook_lookupnow answers from.env.playbookwhen the package is not installed (same output shape). .env.playbookis git-ignored; the agent-ready files (site/llms.txt,site/llms-full.txt) are regenerated.- 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.
[0.1.4] - 2026-11-03#
No breaking changes are marked for this release.
- 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.
[0.1.3] - 2026-11-02#
No breaking changes are marked for this release.
- Hand-written guides are bundled from
generator/guides/and served asadvisor://guide/<slug>; the first guide is "Connect to Oracle on Citadel". policy_lookupreturnslatest_patch; the bundled docs drop hero images, badges and GIFs.- WayneUI's migration guide (MIGRATING.md) is bundled as the
migratingdoc, and every project entry carries its version when it publishes one (composer.json, else package.json, else the newest CHANGELOG heading). - A one-line
claude mcp addand a Docker.mcp.jsonfor machines without PHP are documented. composer content:driftand an optional CI job fail whendata/no longer matches the sibling repos.- The deploy layer's Squire kit is refreshed to 0.3.4 (the local
.env.squirefile is now git-ignored).
[0.1.2] - 2026-10-29#
No breaking changes are marked for this release.
- An agent-ready site (prompt blocks, Markdown twins, llms.txt) is added from Squire's kit.
- The
playbook_lookuptool answers "what is the value of X?" for WSU shared values. An environment variable of the same name wins, then the privatewaynestate/playbookpackage (Playbook) supplies the rest; without it the tool says how to get it instead of failing. Keys that look like secrets (ending in SECRET, PASSWORD, TOKEN or KEY) are refused.waynestate/playbookis suggested, never required. - Docs copies are resynced; proof results now live on the proof site.
- Project names are written as words except acronyms.
- Stale capability claims in the site and docs are fixed.
[0.1.1] - 2026-10-29#
No breaking changes are marked for this release.
- The
owner_oftool answers "which project owns X?" from a new bundleddata/ownership.jsontable (sourced fromgenerator/ownership.json, verified bycontent:verify). Fuzzy match: every word of the topic must appear in a row's topic or role; a no-match answer lists every known topic. upgrade_pathmoves from thestackgroup to a newboostergroup, soADVISOR_GROUPS=stackoffers reference tools only and never starts a program.ADVISOR_GROUPSnow acceptsstack,proctorandbooster.- PHPStan includes Pinstripe's
raw.neonpreset (waynestate/pinstripe0.1.0 as a dev dependency) instead of a hand copy of its settings; two docblocks were tightened to satisfy the preset's method-signature checks. Pint already used theperpreset, sopint.jsonis unchanged.
[0.1.0] - 2026-10-29#
This is the first release, so there is nothing to break.
- Read-only MCP server over stdio (
php vendor/bin/advisor mcp) on the officialmcp/sdk0.9.0, speaking both the legacyinitializehandshake and the 2026-07-28 per-request form. - Seven tools:
list_projects,get_project_status,read_project_docs,policy_lookup,list_stack_rules,run_proctor_check,upgrade_path. Resourcesadvisor://policyandadvisor://creed/<chapter>. Promptsorient_meandplan_upgrade. upgrade_pathplans the app's PHP and/or Laravel upgrade, one supported hop at a time, by running Booster's read-onlyplan(neverrun) against the bundled policy. New settingsADVISOR_BOOSTER_TIMEOUT(default 60) andADVISOR_BOOSTER_BIN(fallback when the app has novendor/bin/boosterof its own).- Bundled, hash-verified content (CREED handbook and policy, project docs, the WayneUI markup contract) with a generator,
content:generate --checkandcontent:verify. advisor installfor Claude, WarriorGPT, Cursor, VS Code (written) and Codex (printed).- Laravel adapter on
laravel/mcp(php artisan mcp:start advisor), so ADVISOR runs beside Laravel Boost. - Safety: off unless enabled, refuses production, read-only by default, path confinement, allowlisted child environment, redaction, invisible-character stripping, manifest-only module loading, argument-hash audit log.
composer ci: validate, content verify, PHPUnit, Pint, PHPStan level 8 (Pinstripe settings), audit. CI files for GitLab (Preflight 0.1.0) and GitHub.
Taking a new version#
ADVISOR is on Packagist: composer require --dev waynestate/advisor:^0.3. No extra repository needed.
The command is then php vendor/bin/advisor. This works the same on Windows, macOS and Linux, because it is one PHP command and not a shell script.