discovery: L1 packages vs standalone php-* modules – summary #7

New issue

Open

opened 2026-02-21 00:17:10 +00:00 by Clotho · 0 comments

Clotho commented

2026-02-21 00:17:10 +00:00

Member

Summary of discovery for issue #3

This issue maps all L1 packages (Boot.php files under src/Core/) against the known standalone core/php-* repos, and documents their relationship.

L1 Packages in `src/Core/` (with Boot.php)

Root / Framework

Package	Path	Notes
Framework root	`src/Core/Boot.php`	Top-level module scanner bootstrap

Core Packages (no standalone counterpart)

Package	Path	Status
Activity	`src/Core/Activity/`	Framework-owned; wraps `spatie/laravel-activitylog`
Bouncer	`src/Core/Bouncer/`	Framework-owned; honeypot + IP blocklist
Bouncer/Gate	`src/Core/Bouncer/Gate/`	Framework-owned; Laravel Gate wiring
Cdn	`src/Core/Cdn/`	Framework-owned; CDN integration
Config	`src/Core/Config/`	Framework-owned; dynamic config
Console	`src/Core/Console/`	Framework-owned; Artisan bootstrap
Headers	`src/Core/Headers/`	Framework-owned; security headers
Helpers	`src/Core/Helpers/`	Framework-owned; global helpers
Lang	`src/Core/Lang/`	Framework-owned; i18n + locale chain
Mail	`src/Core/Mail/`	Framework-owned; mail helpers
Media	`src/Core/Media/`	Framework-owned; lazy thumbnails + image processing
Search	`src/Core/Search/`	Framework-owned; unified site-wide search
Seo	`src/Core/Seo/`	Framework-owned; schema.org, OG images, canonical URLs

Frontage Sub-packages (all in `src/Core/Front/`)

Package	Path	Notes
Front	`src/Core/Front/`	Frontage system root
Front/Admin	`src/Core/Front/Admin/`	Admin middleware + UI component primitives
Front/Api	`src/Core/Front/Api/`	API middleware + versioning
Front/Cli	`src/Core/Front/Cli/`	CLI/Artisan frontage
Front/Client	`src/Core/Front/Client/`	Authenticated SaaS frontage
Front/Components	`src/Core/Front/Components/`	HLCRF layout system
Front/Mcp	`src/Core/Front/Mcp/`	MCP protocol frontage shell
Front/Stdio	`src/Core/Front/Stdio/`	Stdio transport frontage
Front/Web	`src/Core/Front/Web/`	Public web frontage

Standalone `core/php-*` Repos

Repo	Package	Namespace	Depends on Framework	Relationship
`core/php-tenant`	`host-uk/core-tenant`	`Core\Tenant\`	Yes (`dev-main`)	Extension – workspace/team/invitation/entitlement management
`core/php-admin`	`host-uk/core-admin`	`Core\Admin\`, `Website\Hub\`	Yes (`@dev`)	Extends Front/Admin – Hub dashboard, form components, admin search
`core/php-api`	`host-uk/core-api`	`Core\Api\`, `Core\Website\Api\`	Yes (`@dev`)	Extends Front/Api – API keys, webhooks, scopes, rate limiting
`core/php-content`	`host-uk/core-content`	`Core\Mod\Content\`	Yes (`dev-main`)	Extension – headless CMS, content items, MCP handlers
`core/php-commerce`	`host-uk/core-commerce`	`Core\Mod\Commerce\`	Yes (`dev-main`)	Extension – subscriptions, payments, Stripe
`core/php-agentic`	`host-uk/core-agentic`	`Core\Mod\Agentic\`	Yes (`dev-main`)	Extension – AI agent orchestration, plans, tasks
`core/php-mcp`	`host-uk/core-mcp`	`Core\Mcp\`, `Core\Website\Mcp\`	Yes (`@dev`)	Fills Front/Mcp shell – auth, quota, audit, tool registry
`core/php-developer`	`host-uk/core-developer`	`Core\Developer\`	Yes + `core-admin`	Extension – route inspector, DB explorer, logs, cache panel
`core/php-devops`	(DevOps tooling)	N/A	N/A	Not a PHP module – repos.yaml, scripts, workspace setup

Overlaps Found

Three issues were filed for the overlaps discovered:

#4 – Front/Api rate limiting overlaps with core/php-api RateLimitApi middleware
#5 – Core\Search overlaps with core/php-admin search subsystem (dual registries)
#6 – Core\Activity UI duplicated in core/php-admin and core/php-developer

Key Observations

All standalone repos correctly declare host-uk/core as a dependency – the framework is always the foundation layer
The Frontage system (Front/*) cleanly separates HTTP contexts; standalone modules fill those contexts without modifying them
core/php-mcp explicitly fills the Front/Mcp shell (the Boot.php comment says “Authentication middleware should be added by the core-mcp package”) – this is the intended design pattern
core/php-developer is the only standalone repo that depends on another standalone repo (host-uk/core-admin), making it a second-tier module
No standalone repo was found for: Bouncer, Cdn, Config, Console, Headers, Helpers, Lang, Mail, Media, Seo – these are framework primitives only

Closes #3

## Summary of discovery for issue #3 This issue maps all L1 packages (Boot.php files under `src/Core/`) against the known standalone `core/php-*` repos, and documents their relationship. --- ## L1 Packages in `src/Core/` (with Boot.php) ### Root / Framework | Package | Path | Notes | |---------|------|-------| | Framework root | `src/Core/Boot.php` | Top-level module scanner bootstrap | ### Core Packages (no standalone counterpart) | Package | Path | Status | |---------|------|--------| | Activity | `src/Core/Activity/` | Framework-owned; wraps `spatie/laravel-activitylog` | | Bouncer | `src/Core/Bouncer/` | Framework-owned; honeypot + IP blocklist | | Bouncer/Gate | `src/Core/Bouncer/Gate/` | Framework-owned; Laravel Gate wiring | | Cdn | `src/Core/Cdn/` | Framework-owned; CDN integration | | Config | `src/Core/Config/` | Framework-owned; dynamic config | | Console | `src/Core/Console/` | Framework-owned; Artisan bootstrap | | Headers | `src/Core/Headers/` | Framework-owned; security headers | | Helpers | `src/Core/Helpers/` | Framework-owned; global helpers | | Lang | `src/Core/Lang/` | Framework-owned; i18n + locale chain | | Mail | `src/Core/Mail/` | Framework-owned; mail helpers | | Media | `src/Core/Media/` | Framework-owned; lazy thumbnails + image processing | | Search | `src/Core/Search/` | Framework-owned; unified site-wide search | | Seo | `src/Core/Seo/` | Framework-owned; schema.org, OG images, canonical URLs | ### Frontage Sub-packages (all in `src/Core/Front/`) | Package | Path | Notes | |---------|------|-------| | Front | `src/Core/Front/` | Frontage system root | | Front/Admin | `src/Core/Front/Admin/` | Admin middleware + UI component primitives | | Front/Api | `src/Core/Front/Api/` | API middleware + versioning | | Front/Cli | `src/Core/Front/Cli/` | CLI/Artisan frontage | | Front/Client | `src/Core/Front/Client/` | Authenticated SaaS frontage | | Front/Components | `src/Core/Front/Components/` | HLCRF layout system | | Front/Mcp | `src/Core/Front/Mcp/` | MCP protocol frontage shell | | Front/Stdio | `src/Core/Front/Stdio/` | Stdio transport frontage | | Front/Web | `src/Core/Front/Web/` | Public web frontage | --- ## Standalone `core/php-*` Repos | Repo | Package | Namespace | Depends on Framework | Relationship | |------|---------|-----------|---------------------|---------------| | `core/php-tenant` | `host-uk/core-tenant` | `Core\Tenant\` | Yes (`dev-main`) | **Extension** – workspace/team/invitation/entitlement management | | `core/php-admin` | `host-uk/core-admin` | `Core\Admin\`, `Website\Hub\` | Yes (`@dev`) | **Extends Front/Admin** – Hub dashboard, form components, admin search | | `core/php-api` | `host-uk/core-api` | `Core\Api\`, `Core\Website\Api\` | Yes (`@dev`) | **Extends Front/Api** – API keys, webhooks, scopes, rate limiting | | `core/php-content` | `host-uk/core-content` | `Core\Mod\Content\` | Yes (`dev-main`) | **Extension** – headless CMS, content items, MCP handlers | | `core/php-commerce` | `host-uk/core-commerce` | `Core\Mod\Commerce\` | Yes (`dev-main`) | **Extension** – subscriptions, payments, Stripe | | `core/php-agentic` | `host-uk/core-agentic` | `Core\Mod\Agentic\` | Yes (`dev-main`) | **Extension** – AI agent orchestration, plans, tasks | | `core/php-mcp` | `host-uk/core-mcp` | `Core\Mcp\`, `Core\Website\Mcp\` | Yes (`@dev`) | **Fills Front/Mcp shell** – auth, quota, audit, tool registry | | `core/php-developer` | `host-uk/core-developer` | `Core\Developer\` | Yes + `core-admin` | **Extension** – route inspector, DB explorer, logs, cache panel | | `core/php-devops` | _(DevOps tooling)_ | N/A | N/A | **Not a PHP module** – repos.yaml, scripts, workspace setup | --- ## Overlaps Found Three issues were filed for the overlaps discovered: 1. **#4** – `Front/Api` rate limiting overlaps with `core/php-api RateLimitApi` middleware 2. **#5** – `Core\Search` overlaps with `core/php-admin` search subsystem (dual registries) 3. **#6** – `Core\Activity` UI duplicated in `core/php-admin` and `core/php-developer` --- ## Key Observations - All standalone repos correctly declare `host-uk/core` as a dependency – the framework is always the foundation layer - The Frontage system (Front/*) cleanly separates HTTP contexts; standalone modules fill those contexts without modifying them - `core/php-mcp` explicitly fills the `Front/Mcp` shell (the Boot.php comment says “Authentication middleware should be added by the core-mcp package”) – this is the intended design pattern - `core/php-developer` is the only standalone repo that depends on another standalone repo (`host-uk/core-admin`), making it a second-tier module - No standalone repo was found for: Bouncer, Cdn, Config, Console, Headers, Helpers, Lang, Mail, Media, Seo – these are framework primitives only Closes #3