Architecture

System design and directory layout for mokoplatform.

Directory Structure

mokoplatform/
bin/moko                     # CLI entry point
cli/                         # 54 command scripts
lib/
  CliBase.php                # Simple base class
  Common.php                 # Shared utilities
  Enterprise/
    CliFramework.php         # Full enterprise framework
    AuditLogger.php          # Audit trail
    CheckpointManager.php    # Resumable operations
    Config.php               # Configuration
    ErrorRecovery.php        # Error recovery
    ManifestReader.php       # manifest.xml parser
    MetricsCollector.php     # Metrics
    MokoGiteaAdapter.php     # Gitea API client
    PackageBuilder.php       # ZIP builder
    PluginRegistry.php       # Plugin system
    RetryHelper.php          # Retry with backoff
    SecurityValidator.php    # Security checks
    TransactionManager.php   # Transaction support
    UnifiedValidation.php    # Validation framework
validate/                    # 20+ validators
automation/                  # Bulk automation
deploy/                      # Deployment tools
fix/                         # Auto-fix scripts
maintenance/                 # Maintenance tools
release/                     # Release helpers
templates/                   # Boilerplate (joomla, makefiles, configs, schemas)
wrappers/                    # Thin wrappers for CI
mcp/servers/                 # 7 MCP servers
tests/                       # PHPUnit (19 tests)

Two-Tier CLI Framework

CliBase (Simple)

For standalone scripts needing basic CLI features:

class MyTool extends CliBase
{
    protected function run(): int
    {
        if ($this->dryRun) {
            $this->info('Dry run - no changes');
            return 0;
        }
        return 0;
    }
}

Provides: argument parsing, --dry-run, --verbose, colored output, exit codes.

Enterprise/CliFramework (Full)

For complex tools with plugins, checkpoints, metrics, and transactions:

class MyComplexTool extends CliFramework
{
    protected function configure(): void
    {
        $this->addPlugin(new ManifestPlugin());
        $this->enableCheckpoints();
        $this->enableMetrics();
    }

    protected function execute(): int
    {
        $this->transaction(function () {
            // transactional operations
        });
        return 0;
    }
}

Provides: plugin system, checkpoint/resume, metrics, audit logging, error recovery, retry logic, transactions, config validation.

Plugin System

Plugins implement ProjectPluginInterface:

ManifestPlugin - reads .mokogitea/manifest.xml
MokoStandardsPlugin - reads .moko-standards
SecurityPlugin - security validators
MetricsPlugin - operation metrics

Configuration

templates/configs/ - default config templates
governance.yml - org-level rules
Env vars: GA_TOKEN, GH_TOKEN, GRAFANA_URL, GRAFANA_TOKEN

Pages