Page Scanner Laravel Package

Agents

Start in the package named by the task; search its src/ and tests/ before widening scope. Read only when relevant: packages/docs/content/architecture.md for repository-wide architecture, extensions.md for extension discovery, Page.php or Media.php for those entities, and...

claude-code

cursor

code-simplifier

Mandatory final simplification pass for Pushword changes. Use after is-it-well-tested on every task that modifies repository files and before the final response, refining only the current task's code without changing behaviour.

claude-code

is-it-well-tested

Mandatory Pushword post-change test audit. Use after every task that modifies repository files, before code-simplifier and before the final response, to assess coverage, add clear missing tests, and run the relevant targeted tests.

claude-code

site-audit

Browse the Pushword site and admin to identify bugs, then propose fixes. Use when asked to audit, test, find bugs, or QA the site.

claude-code

test-triage

Decide whether a failing Pushword test is a real regression or a known pre-existing flake. Use when composer test, composer test-mariadb, or CI goes red and you need to know if your change caused it.

claude-code

ui-debug

Log into the Pushword dev-app admin with dev-browser and take screenshots. Use when validating admin UI or frontend changes in a real browser.

claude-code

Admin Ui

templates extending @EasyAdmin/page/content.html.twig, a wrongly-named block is silently dropped: no error, route still 200, buttons simply absent. Assert on rendered HTML, never on status alone.

cursor

Flat

pw:flat:sync with no arguments is bidirectional and destructive in this repo. It imports packages/docs/content/.md into the DB, then exports the DB back over those files — treating the dev-app DB as authoritative. The DB is a dev artifact; the content directory is source-of-truth checked into git.

cursor

Media

(MediaExtension::transformStringToMedia()) calls setAlt($caption, true) whenever content containing caption renders, mutating alt in memory only — the DB still holds the previous value, and the render runs before AfterEntityUpdatedEvent. Any rename or diff heuristic must read the persisted alt...

cursor

Release

split-monorepo.yaml mirrors each packages/<pkg> to its own pushword/<pkg> repo. It triggers on tag pushes only (on: push: tags: [""]), so one release produces exactly one race-free split run.

cursor

Testing

The suite runs under ParaTest with per-worker SQLite DBs. Sequential runs (--no-parallel) share one DB and surface pre-existing isolation failures that are not real bugs.

cursor