core/php

Snider 1d8a202bdf feat: add CLAUDE.md to all 21 CorePHP subsystems

Agent-readable documentation for every Core subsystem, extracted
from 530 PHP source files. Each CLAUDE.md documents key classes,
public API, patterns, and integration points.

Highlights discovered:
- Actions: #[Scheduled] attribute system wires to Laravel scheduler
- Bouncer Gate: training mode with #[Action] attributes (CoreGO pattern)
- Config: hierarchical scope (global→workspace→user) with version diffs
- Crypt: LthnHash = QuasiSalt from dAppServer, ported to PHP
- Database: Kahn's algorithm topological seeder sorting via attributes
- Events: 12 lifecycle events with HasEventVersion forward compat
- Front: 78 blade components + programmatic Component for MCP/agent UI
- Headers: DetectDevice identifies 14 in-app browser platforms
- Input: 9-step pre-boot sanitisation pipeline
- Lang: TranslationMemory with fuzzy matching + TMX import/export
- Mail: EmailShield with 100k+ disposable domain blocking
- Search: 7-source unified search with privacy-aware IP hashing
- Storage: Redis circuit breaker (Closed/Open/Half-Open)

Co-Authored-By: Virgil <virgil@lethean.io>

2026-03-29 13:24:07 +01:00

2.8 KiB

Raw Blame History

Database/Seeders

Auto-discovering, dependency-aware seeder orchestration.

What It Does

Replaces Laravel's manual seeder ordering with automatic discovery and topological sorting. Seeders declare their dependencies via attributes or properties, and the framework figures out the correct execution order using Kahn's algorithm.

Key Classes

Class	Purpose
`CoreDatabaseSeeder`	Base seeder class. Extends Laravel's `Seeder`. Auto-discovers seeders from configured paths, applies `--exclude` and `--only` filters, runs them in dependency order
`SeederDiscovery`	Scans directories for `*Seeder.php` files, reads priority/dependency metadata from attributes or properties, produces topologically sorted list
`SeederRegistry`	Manual registration alternative: `register(Class, priority: 10, after: [...])`. Fluent API with `registerMany()`, `merge()`, `getOrdered()`

Attributes

Attribute	Target	Purpose
`#[SeederPriority(10)]`	Class	Lower values run first (default: 50)
`#[SeederAfter(FeatureSeeder::class)]`	Class	Must run after specified seeders (repeatable)
`#[SeederBefore(PackageSeeder::class)]`	Class	Must run before specified seeders (repeatable)

Priority Guidelines

0-20: Foundation (features, configuration)
20-40: Core data (packages, workspaces)
40-60: Default (general seeders)
60-80: Content (pages, posts)
80-100: Demo/test data

Ordering Rules

Dependencies take precedence over priority. Within the same dependency level, lower priority numbers run first. Circular dependencies throw CircularDependencyException with the full cycle path.

Usage

// Auto-discovery (default)
class DatabaseSeeder extends CoreDatabaseSeeder {
    protected function getSeederPaths(): array {
        return [app_path('Core'), app_path('Mod')];
    }
}

// Manual registration
class DatabaseSeeder extends CoreDatabaseSeeder {
    protected bool $autoDiscover = false;
    protected function registerSeeders(SeederRegistry $registry): void {
        $registry->register(FeatureSeeder::class, priority: 10)
                 ->register(PackageSeeder::class, after: [FeatureSeeder::class]);
    }
}

// CLI filtering
php artisan db:seed --exclude=DemoSeeder --only=FeatureSeeder

Discovery Paths

Scans {path}/*/Database/Seeders/*Seeder.php (module subdirs) and {path}/Database/Seeders/*Seeder.php (direct). Configured via core.seeders.paths or defaults to app/Core, app/Mod, app/Website.

Integration

Properties alternative to attributes: public int $priority = 10;, public array $after = [...], public array $before = [...]
Pattern matching for --exclude/--only: full class name, short name, or partial match
Config: core.seeders.auto_discover, core.seeders.paths, core.seeders.exclude

2.8 KiB Raw Blame History