forked from fa/breadcrumb-the-shire
fs
0e86925464
Rename the top-level lib/ directory to core/ so the project root immediately communicates which code is core platform and which lives in modules/. PHP namespaces (MintyPHP\*) are unchanged — only the Composer PSR-4 path mapping moves from lib/ to core/. Module-internal lib/ directories (modules/*/lib/) are untouched. Updated across the full stack: - composer.json PSR-4 mapping - bootstrap entry points (web/index.php, bin/*, tests/bootstrap.php) - tooling configs (phpstan.neon, phpunit.xml, php-cs-fixer) - 26 architecture contract tests - enforcement-policy, guard-catalog, quality-gates - all documentation (CLAUDE.md, README, 25 docs/, .agents/skills/) - bin/qa-extended.sh search paths - .claude/settings.local.json permission paths Workflow: .agents/runs/CORE-LIB-RENAME-001/ (Analyst → Planner → Executor → Code Review (4 findings fixed) → Security Review → Acceptance Test → Finalizer) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
62 lines
1.8 KiB
PHP
62 lines
1.8 KiB
PHP
<?php
|
|
|
|
namespace MintyPHP\Console;
|
|
|
|
use MintyPHP\Console\Support\CliAppBootstrap;
|
|
use MintyPHP\Console\Support\ModuleCliRuntime;
|
|
|
|
/**
|
|
* Base class for CLI commands.
|
|
*
|
|
* Subclasses define a name (e.g. 'module:sync') and implement execute().
|
|
* Bootstrap helpers provide a stable way to initialize the app without
|
|
* fragile relative paths.
|
|
*/
|
|
abstract class Command
|
|
{
|
|
abstract public function name(): string;
|
|
|
|
abstract public function description(): string;
|
|
|
|
/**
|
|
* Optional usage text shown when --help is passed for this command.
|
|
* Override in subclasses that accept arguments or options.
|
|
*/
|
|
public function usage(): string
|
|
{
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* @param list<string> $args Positional arguments (after the command name)
|
|
* @param array<string, string|bool> $options Parsed --key=value and --flag options
|
|
* @return int Exit code (0 = success)
|
|
*/
|
|
abstract public function execute(array $args, array $options): int;
|
|
|
|
// ─── Bootstrap helpers ──────────────────────────────────────────
|
|
|
|
protected function projectRoot(): string
|
|
{
|
|
return dirname(__DIR__, 2);
|
|
}
|
|
|
|
/**
|
|
* Bootstrap the app for non-module CLI commands.
|
|
* Uses the centralized CLI bootstrap runtime.
|
|
*/
|
|
protected function bootstrapApp(string $channel = 'cli', ?string $path = null): void
|
|
{
|
|
CliAppBootstrap::bootstrap($channel, $path ?? 'bin/console ' . $this->name());
|
|
}
|
|
|
|
/**
|
|
* Bootstrap the app for module CLI commands.
|
|
* Loads the module CLI infrastructure (error policy, locking, app container).
|
|
*/
|
|
protected function bootstrapModuleApp(): void
|
|
{
|
|
ModuleCliRuntime::bootstrap();
|
|
}
|
|
}
|