Files
MokoCLI/PLUGIN_SCRIPTS.md
T
jmiller 4009d68a7a
Universal: PR Check / Branch Policy (pull_request) Failing after 2s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (pull_request) Successful in 3s
Universal: PR Check / Validate PR (pull_request) Failing after 14s
Universal: PR Check / Secret Scan (pull_request) Successful in 15s
Generic: Project CI / Lint & Validate (pull_request) Successful in 57s
Platform: mokocli CI / Gate 1: Code Quality (pull_request) Successful in 2m4s
Universal: Build & Release / Promote to RC (pull_request) Has been skipped
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
Branch Cleanup / Delete merged branch (pull_request) Successful in 2s
Universal: Build & Release / Build & Release Pipeline (pull_request) Successful in 35s
Universal: Workflow Sync Trigger / Sync workflows to live repos (pull_request) Failing after 28m16s
Generic: Project CI / Tests (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.1) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.2) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.3) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 3: Self-Health Check (pull_request) Has been cancelled
Platform: mokocli CI / Gate 4: Governance (pull_request) Has been cancelled
Platform: mokocli CI / Gate 5: Template Integrity (pull_request) Has been cancelled
Platform: mokocli CI / CI Summary (pull_request) Has been cancelled
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
Generic: Repo Health / Scripts governance (pull_request) Has been cancelled
Generic: Repo Health / Repository health (pull_request) Has been cancelled
Generic: Repo Health / Report: Scripts Governance (pull_request) Has been cancelled
Generic: Repo Health / Report: Repository Health (pull_request) Has been cancelled
chore: rename all mokoplatform -> mokocli references
The repo was renamed mokoplatform -> mokocli; this rewrites every stale
reference across the tree (case-sensitive):

  MokoPlatform  -> MokoCLI   (DEFGROUP/INGROUP doc tags)
  mokoplatform  -> mokocli   (repo URLs, /opt & /tmp paths, clone URLs,
                              EXCLUDE lists, XML xmlns + <root> namespace)
  moko-platform -> moko-cli  (marker files)

XML namespace URIs and ManifestParser::NAMESPACE_URI are changed in
lockstep so local manifest-vs-parser validation stays consistent. The
external standards.mokoconsulting.tech namespace endpoint must be updated
to match separately (tracked in #336).

Refs #336

Claude-Session: https://claude.ai/code/session_01WbGBN9VyRK61zczYWcCQ2i
2026-07-05 15:25:45 -05:00

2.6 KiB

Plugin System CLI Scripts

Command-line scripts for validating, health checking, and managing projects using the mokocli plugin system.

Available Scripts

Script Purpose
plugin_validate.php Validate project structure and configuration
plugin_health_check.php Run comprehensive health checks
plugin_metrics.php Collect project metrics
plugin_readiness.php Check release readiness
plugin_list.php List all available plugins

Quick Examples

# List all available plugins
php api/plugin_list.php

# Validate a project (auto-detect type)
php api/plugin_validate.php --project-path /path/to/project

# Run health check
php api/plugin_health_check.php --project-path /path/to/project

# Collect metrics
php api/plugin_metrics.php --project-path /path/to/project --format table

# Check release readiness
php api/plugin_readiness.php --project-path /path/to/project

Supported Project Types

  • joomla - Joomla CMS projects and extensions
  • wordpress - WordPress themes and plugins
  • nodejs - Node.js applications and packages
  • python - Python applications and packages
  • terraform - Infrastructure as Code
  • mobile - Mobile applications (iOS/Android)
  • api - REST API and GraphQL services
  • dolibarr - Dolibarr ERP/CRM modules
  • documentation - Documentation projects
  • generic - Generic project types

Exit Codes

  • 0 - Success
  • 1 - Validation/check failed
  • 2 - Script error (invalid arguments, plugin not found)

Documentation

For detailed documentation, see:

Integration

These scripts integrate with:

  • GitHub Actions workflows (see templates/workflows/)
  • Plugin system (see lib/Enterprise/)
  • CI/CD pipelines (GitLab CI, Jenkins, etc.)

Usage in CI/CD

# GitHub Actions example
- name: Validate project
  run: |
    php api/plugin_validate.php --project-path . --json > validation.json
    if jq -e '.valid == false' validation.json > /dev/null; then
      exit 1
    fi

For complete usage examples and documentation, run any script with --help:

php api/plugin_validate.php --help