Split detail page contracts

lib/Console/Commands/DoctorCommand.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace MintyPHP\Console\Commands;
+
+use MintyPHP\Console\Command;
+
+final class DoctorCommand extends Command
+{
+    public function name(): string
+    {
+        return 'doctor';
+    }
+
+    public function description(): string
+    {
+        return 'Run system health checks';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        // doctor.php is self-contained — include and let it run
+        $scriptPath = __DIR__ . '/../../../bin/doctor.php';
+
+        // Capture the exit code by running as a subprocess to avoid
+        // the script's own exit() call terminating our process.
+        $command = PHP_BINARY . ' ' . escapeshellarg($scriptPath);
+        passthru($command, $exitCode);
+
+        return $exitCode;
+    }
+}

lib/Console/Commands/Module/AssetsSyncCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class AssetsSyncCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:assets-sync';
+    }
+
+    public function description(): string
+    {
+        return 'Publish module web assets to web/modules/';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/module-cli-bootstrap.php';
+        require_once __DIR__ . '/../../../../bin/module-assets-sync.php';
+
+        return moduleAssetsSyncRun();
+    }
+}

lib/Console/Commands/Module/BuildCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class BuildCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:build';
+    }
+
+    public function description(): string
+    {
+        return 'Build runtime page root with module symlinks';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/module-cli-bootstrap.php';
+        require_once __DIR__ . '/../../../../bin/module-build.php';
+
+        return moduleBuildRun();
+    }
+}

lib/Console/Commands/Module/DeactivateCommand.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class DeactivateCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:deactivate';
+    }
+
+    public function description(): string
+    {
+        return 'Run a module\'s deactivation handler (--confirm or --dry-run)';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        $moduleId = $args[0] ?? '';
+        if ($moduleId === '') {
+            fwrite(STDERR, "Usage: php bin/console module:deactivate <module-id> --confirm|--dry-run\n");
+            return 1;
+        }
+
+        // Rebuild global argv for the underlying script
+        global $argv;
+        $argv = ['module-deactivate.php', $moduleId];
+        if ($options['confirm'] ?? false) {
+            $argv[] = '--confirm';
+        }
+        if ($options['dry-run'] ?? false) {
+            $argv[] = '--dry-run';
+        }
+
+        require_once __DIR__ . '/../../../../bin/module-deactivate.php';
+
+        return moduleDeactivateRun();
+    }
+}

lib/Console/Commands/Module/MigrateCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class MigrateCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:migrate';
+    }
+
+    public function description(): string
+    {
+        return 'Apply pending module SQL migrations';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/module-cli-bootstrap.php';
+        require_once __DIR__ . '/../../../../bin/module-migrate.php';
+
+        return moduleMigrateRun();
+    }
+}

lib/Console/Commands/Module/PermissionsSyncCommand.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class PermissionsSyncCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:permissions-sync';
+    }
+
+    public function description(): string
+    {
+        return 'Sync module permissions to DB and deactivate orphaned ones';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/module-cli-bootstrap.php';
+        require_once __DIR__ . '/../../../../bin/module-permissions-sync.php';
+
+        return modulePermissionsSyncRun();
+    }
+}

lib/Console/Commands/Module/RuntimeSyncCommand.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Module;
+
+use MintyPHP\Console\Command;
+
+final class RuntimeSyncCommand extends Command
+{
+    public function name(): string
+    {
+        return 'module:sync';
+    }
+
+    public function description(): string
+    {
+        return 'Run full module runtime sync (migrate, permissions, build, assets)';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/module-runtime-sync.php';
+
+        return moduleRuntimeSyncRun();
+    }
+}

lib/Console/Commands/Scheduler/RunCommand.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace MintyPHP\Console\Commands\Scheduler;
+
+use MintyPHP\Console\Command;
+use MintyPHP\DB;
+use MintyPHP\Service\Audit\SystemAuditService;
+use MintyPHP\Service\Scheduler\SchedulerServicesFactory;
+
+final class RunCommand extends Command
+{
+    public function name(): string
+    {
+        return 'scheduler:run';
+    }
+
+    public function description(): string
+    {
+        return 'Execute due scheduled jobs';
+    }
+
+    public function execute(array $args, array $options): int
+    {
+        require_once __DIR__ . '/../../../../bin/cli-bootstrap.php';
+
+        $exitCode = 0;
+        $startedAt = microtime(true);
+        try {
+            cliBootstrapApp('scheduler', 'bin/console scheduler:run');
+            $factory = app(SchedulerServicesFactory::class);
+            $result = $factory->createSchedulerRunService()->runDueJobs();
+            if (!($result['ok'] ?? false)) {
+                $error = (string) ($result['error'] ?? 'unexpected_error');
+                fwrite(STDERR, sprintf("scheduler run failed: %s\n", $error));
+                $exitCode = 1;
+            } else {
+                fwrite(STDOUT, sprintf(
+                    "scheduler completed: processed=%d success=%d failed=%d skipped=%d duration_ms=%d\n",
+                    (int) ($result['processed'] ?? 0),
+                    (int) ($result['success'] ?? 0),
+                    (int) ($result['failed'] ?? 0),
+                    (int) ($result['skipped'] ?? 0),
+                    (int) ($result['duration_ms'] ?? 0)
+                ));
+            }
+        } catch (\Throwable $exception) {
+            try {
+                app(SystemAuditService::class)->record('scheduler.run', 'failed', [
+                    'error_code' => 'unexpected_error',
+                    'metadata' => [
+                        'trigger_type' => 'scheduler',
+                        'run_status' => 'failed',
+                        'processed' => 0,
+                        'success_count' => 0,
+                        'failed_count' => 0,
+                        'skipped_count' => 0,
+                        'duration_ms' => max(0, (int) round((microtime(true) - $startedAt) * 1000)),
+                        'bootstrap_error' => true,
+                    ],
+                ]);
+            } catch (\Throwable) {
+                // fail-open
+            }
+
+            fwrite(STDERR, sprintf("scheduler run failed: unexpected_error: %s\n", $exception->getMessage()));
+            $exitCode = 1;
+        } finally {
+            DB::close();
+        }
+
+        return $exitCode;
+    }
+}