PR #402· chore/project-sync→4.x · he4rt / heartdevs.com

Sync conventions, tooling & tests

One housekeeping pass that realigns he4rt's guidelines, modular scaffolding, testing DX, CI and dependencies with the canonical setup — grouped into focused commits and landing fully gate-green.

10commits

97files touched

+1591 −489lines

881 ✓tests · gate green

what's inside

Seven areas, one branch

Each commit is scoped to a single concern — skim the badges to see the shape of the change.

docs01

Guidelines sync

AI guidelines retargeted to he4rt — namespace/naming, issue-tracker repo he4rt/heartdevs.com, plus typed-JSON-cast and enum-contract guidance. Dropped 3 stale docs/agents mirrors.

fix · modular02

Module scaffolding fix

make:module stubs and config/app-modules.php now place a module's ServiceProvider at src/ root, not Providers/. Migrated squads and onboarding to match.

test03

Testing DX

Tracked .env.testing.example; the per-dev .env.testing is now untracked and auto-created on setup. Feature tests run on LazilyRefreshDatabase.

ci04

CI & sharding

The Pest suite runs in 2 balanced shards (committed timings baseline), and CI is gated on canonical branch prefixes — feature/**, bugfix/**, chore/**, story/**, *.x.

chore · deps05

Dependencies

Intra-repo he4rt/* modules pinned to ^1.0.0 for predictable, SemVer-safe ranges; other dependencies bumped.

refactor06

Named-argument pass

The project's Rector named-argument convention applied across 43 models, commands, jobs and Livewire components — e.g. #[Table(name: …)].

chore07

Cleanup

Removed 24 redundant .gitkeep placeholders from directories that already track real files.

note✓

Also audited, deliberately untouched

.github/.husky, root configs, config/ and app/ were checked and left as-is — already current, or divergence that's correct for he4rt.

before it shipped

Verification

Full quality gate — clean

✓ Rector ✓ Pint ✓ PHPStan ✓ Pest · 881 passed

Rector, Pint and PHPStan report zero issues project-wide; the Pest suite is 881 passed (539 feature + 342 unit, 2515 assertions). Ready to review.