Skip to content

Docs workspace on the current satellites, rector in CI, two generator fixes - #115

Merged
rasuvaeff merged 1 commit into
masterfrom
docs/workspace-0.9
Sep 5, 2026
Merged

Docs workspace on the current satellites, rector in CI, two generator fixes#115
rasuvaeff merged 1 commit into
masterfrom
docs/workspace-0.9

Conversation

@rasuvaeff

Copy link
Copy Markdown
Owner

What

  • R-3 of the 1.0-readiness review. docs/.api-workspace/composer.json pinned the satellites to ^0.2/^0.1 — a caret on 0.x pins a minor — so the site documented understudy-psalm 0.2.0 while 0.8.x was out. Pins move to -psalm ^0.8, -phpstan ^0.5, -phpunit ^0.3, -testo ^0.3 (engine path version 0.9.0), the lock is committed (.gitignore negation) so the committed pages and the deployed site come from one install, and docs.yml runs composer outdated --direct --strict in the workspace — a satellite release the pins do not reach is a red build now. The workflow comments that promised «never more than a week behind» say what actually happens.
  • Rector in CI: composer rector as a step of the existing Psalm job in static-analysis.yml (same job → the required check keeps its name). Same change merged in the four satellites.
  • Two generator defects the refresh exposed: reflect-rules.php matched any literal starting with understudy., so the php-parser attribute understudy.receiverOfCall (ClosureShape) became a sixth "identifier" on /api/rules; it counts only constants named *IDENTIFIER now. generate-api.mjs had no label for a trait, so the PHPUnit adapter's page was headed «undefined».
  • docs/src/api/** regenerated: satellites at v0.3.1 / v0.3.0 / v0.8.1 / v0.5.1, engine v0.9.0, five identifiers.

Verification

npm run docs:check passed (34 @api types, 5 identifiers, every page reachable), composer outdated --direct --strict in the workspace exits 0.

… fixes

- docs/.api-workspace pins move to the lines that exist (-psalm ^0.8,
  -phpstan ^0.5, -phpunit ^0.3, -testo ^0.3, engine 0.9.0) and the lock is
  committed, so the pages in the repository and on the site come from one
  install. docs.yml runs `composer outdated --direct --strict` there: a
  satellite release the pins do not reach is a red build, not a stale page.
- static-analysis.yml runs `composer rector` in the Psalm job (part of
  release-check, checked by nobody before a tag until now).
- reflect-rules.php counts only constants named *IDENTIFIER — the php-parser
  attribute `understudy.receiverOfCall` was rendered as a sixth rule;
  generate-api.mjs labels a trait as "Trait" instead of "undefined".
- API pages regenerated from the new workspace (satellites at v0.3.1 /
  v0.3.0 / v0.8.1 / v0.5.1, engine v0.9.0).
@coderabbitai

coderabbitai Bot commented Sep 5, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Team

Run ID: 6568d311-fd1e-43f3-be8a-048eabb2d5c6

Warning

Your free Security trial is over. An organization admin can upgrade to Advanced for continuous pull request security review or dismiss this notice.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@rasuvaeff
rasuvaeff merged commit 3934b83 into master Sep 5, 2026
23 of 24 checks passed
@rasuvaeff
rasuvaeff deleted the docs/workspace-0.9 branch September 5, 2026 13:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant