fix: rename mokoplatform/moko-platform to MokoCLI everywhere (#262) #278

Merged
jmiller merged 14 commits from fix/262-rename-mokoplatform-to-mokocli into dev 2026-06-20 17:12:15 +00:00
Owner

Summary

Comprehensive rename of mokoplatform / moko-platform / MokoPlatform to MokoCLI across the entire codebase. Closes #262.

Sub-tasks completed

Issue Scope Files
#276 Backward-compat aliases + deprecation notices src/aliases.php, scripts/setup-mokocli-aliases.sh, dual-path CI
#263 Config files composer.json, mcp/package.json, phpcs.xml, issue templates, etc.
#264 PHP code references 205 PHP files — headers, User-Agent strings, constants, docblocks
#265 CLI help text and output bin/moko banner, bin/validate-module output
#266 CI/CD workflows 17 YAML files in .mokogitea/
#269 MCP server configs 4 TypeScript source files
#268 Documentation 49 markdown files

Backward compatibility

  • src/aliases.php provides forward aliases (mokocli_version(), mokocli_root_dir()) and backward aliases (mokoplatform_version(), mokoplatform_root_dir()) with E_USER_DEPRECATED notices
  • mokocli_resolve_install_path() checks both /opt/mokocli and /opt/mokoplatform
  • scripts/setup-mokocli-aliases.sh creates bidirectional symlinks on runners
  • auto-bump.yml checks both /opt/mokocli and /opt/mokoplatform paths
  • platform_detect.php accepts both mokocli and mokoplatform directory names
  • EXCLUDE lists in workflows include both repo names
  • NPM bin has both mokocli-mcp and moko-platform-mcp entries

Still requires separate work

  • #267 — Runner labels and registration (infrastructure change)
  • #270 — Actual Git repository rename on Gitea (do last)

Test plan

  • composer install succeeds with new package name
  • php bin/moko list shows updated banner
  • php bin/moko health --path . passes
  • CI workflows reference correct paths
  • Old function names trigger deprecation notices in logs
## Summary Comprehensive rename of `mokoplatform` / `moko-platform` / `MokoPlatform` to `MokoCLI` across the entire codebase. Closes #262. ## Sub-tasks completed | Issue | Scope | Files | |-------|-------|-------| | #276 | Backward-compat aliases + deprecation notices | `src/aliases.php`, `scripts/setup-mokocli-aliases.sh`, dual-path CI | | #263 | Config files | `composer.json`, `mcp/package.json`, `phpcs.xml`, issue templates, etc. | | #264 | PHP code references | 205 PHP files — headers, User-Agent strings, constants, docblocks | | #265 | CLI help text and output | `bin/moko` banner, `bin/validate-module` output | | #266 | CI/CD workflows | 17 YAML files in `.mokogitea/` | | #269 | MCP server configs | 4 TypeScript source files | | #268 | Documentation | 49 markdown files | ## Backward compatibility - `src/aliases.php` provides forward aliases (`mokocli_version()`, `mokocli_root_dir()`) and backward aliases (`mokoplatform_version()`, `mokoplatform_root_dir()`) with `E_USER_DEPRECATED` notices - `mokocli_resolve_install_path()` checks both `/opt/mokocli` and `/opt/mokoplatform` - `scripts/setup-mokocli-aliases.sh` creates bidirectional symlinks on runners - `auto-bump.yml` checks both `/opt/mokocli` and `/opt/mokoplatform` paths - `platform_detect.php` accepts both `mokocli` and `mokoplatform` directory names - EXCLUDE lists in workflows include both repo names - NPM `bin` has both `mokocli-mcp` and `moko-platform-mcp` entries ## Still requires separate work - #267 — Runner labels and registration (infrastructure change) - #270 — Actual Git repository rename on Gitea (do last) ## Test plan - [ ] `composer install` succeeds with new package name - [ ] `php bin/moko list` shows updated banner - [ ] `php bin/moko health --path .` passes - [ ] CI workflows reference correct paths - [ ] Old function names trigger deprecation notices in logs
jmiller added 8 commits 2026-06-20 16:41:32 +00:00
Prepare for the mokoplatform -> MokoCLI rename by introducing aliases
so both old and new names work during the transition:

- src/aliases.php: forward function aliases (mokocli_version, etc.)
  and install path resolver accepting both /opt/mokocli and /opt/mokoplatform
- scripts/setup-mokocli-aliases.sh: runner provisioning script to create
  symlinks between mokocli and mokoplatform paths
- composer.json: auto-load aliases.php
- mcp/package.json: add mokocli-mcp bin alias alongside moko-platform-mcp
- auto-bump.yml: check both /opt/mokocli and /opt/mokoplatform paths
- platform_detect.php: accept both mokocli and mokoplatform directory names
Update package names, descriptions, and references across all
configuration files: composer.json, mcp/package.json, phpcs.xml,
issue templates, script registry, and schema templates.
Bulk rename across all non-vendor PHP files:
- File header comments (DEFGROUP, INGROUP, REPO, @package)
- User-Agent strings
- Namespace URI constant in MokoStandardsParser
- Descriptive comments and docblocks
Update bin/moko banner, help text, and file headers.
Update bin/validate-module output and headers.
Update all .mokogitea/ workflow and config YAML files:
- File header comments (INGROUP, REPO, DEFGROUP)
- CI banner text in ci-platform.yml
- EXCLUDE lists accept both mokocli and mokoplatform repo names
- auto-bump.yml already updated in #276 with dual-path resolution
Old-name aliases now emit E_USER_DEPRECATED so usage appears in logs
without interrupting execution. Added mokoplatform_version() and
mokoplatform_root_dir() backward aliases with deprecation warnings.
The install path resolver also warns when falling back to /opt/mokoplatform.
Update REPO URLs and references in all MCP TypeScript source files.
fix: rename moko-platform to MokoCLI in documentation (#268)
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Universal: PR Check / Branch Policy (pull_request) Successful in 4s
Universal: PR Check / Validate PR (pull_request) Successful in 8s
Generic: Repo Health / Access control (pull_request) Successful in 2s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 1m31s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 5s
a5a16fb7e3
Update all markdown files: README, CHANGELOG, CLAUDE.md, index files,
templates, issue templates, and inline documentation.
jmiller added 1 commit 2026-06-20 17:03:40 +00:00
fix: rename moko-platform to mokocli + changelog promotion in workflows
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Generic: Repo Health / Access control (pull_request) Successful in 1s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 5s
Universal: PR Check / Validate PR (pull_request) Successful in 6s
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 1m24s
c70481b69d
jmiller added 1 commit 2026-06-20 17:03:43 +00:00
fix: rename moko-platform to mokocli + changelog promotion in workflows
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Universal: PR Check / Branch Policy (pull_request) Successful in 1s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (pull_request) Successful in 2s
Universal: PR Check / Validate PR (pull_request) Successful in 6s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 6s
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 1m19s
8741964d87
jmiller added 1 commit 2026-06-20 17:03:46 +00:00
fix: rename moko-platform to mokocli + changelog promotion in workflows
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 1s
Universal: PR Check / Branch Policy (pull_request) Successful in 1s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (pull_request) Successful in 2s
Universal: PR Check / Validate PR (pull_request) Successful in 6s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 6s
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 1m22s
f918bccf12
jmiller added 1 commit 2026-06-20 17:03:51 +00:00
fix: rename moko-platform to mokocli + changelog promotion in workflows
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Generic: Repo Health / Access control (pull_request) Successful in 1s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Universal: PR Check / Validate PR (pull_request) Successful in 6s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 5s
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 1m15s
ba6003a431
jmiller added 1 commit 2026-06-20 17:03:54 +00:00
fix: rename moko-platform to mokocli + changelog promotion in workflows
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Access control (push) Successful in 1s
Generic: Repo Health / Site Health (push) Has been skipped
Universal: PR Check / Branch Policy (pull_request) Successful in 1s
Generic: Repo Health / Access control (pull_request) Successful in 2s
Generic: Repo Health / Site Health (pull_request) Has been skipped
Universal: PR Check / Validate PR (pull_request) Successful in 5s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 5s
d5d9c4afce
jmiller added 1 commit 2026-06-20 17:11:08 +00:00
fix: address PR review findings for #262 rename
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.1) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.2) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 2: Unit Tests (8.3) (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 3: Self-Health Check (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 4: Governance (pull_request) Blocked by required conditions
Platform: MokoCLI CI / Gate 5: Template Integrity (pull_request) Blocked by required conditions
Platform: MokoCLI CI / CI Summary (pull_request) Blocked by required conditions
Universal: PR Check / Build RC Package (pull_request) Blocked by required conditions
Universal: PR Check / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Scripts governance (pull_request) Blocked by required conditions
Generic: Repo Health / Repository health (pull_request) Blocked by required conditions
Generic: Repo Health / Report Issues (pull_request) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Site Health (pull_request) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Generic: Repo Health / Access control (pull_request) Successful in 2s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Failing after 4s
Universal: PR Check / Validate PR (pull_request) Successful in 6s
Platform: MokoCLI CI / Gate 1: Code Quality (pull_request) Failing after 50s
Branch Cleanup / Delete merged branch (pull_request) Successful in 1s
908e839c30
Critical fixes:
- Standardize all workflow paths to /opt/mokocli (lowercase), not /opt/MokoCLI
- Add legacy /opt/mokoplatform fallback to auto-release.yml and pre-release.yml
- Fix inconsistent REPO header URLs to MokoConsulting/mokocli everywhere
- Fix auto-bump.yml clone URL from mokoplatform.git to mokocli.git

Alias improvements:
- Remove @ suppression from trigger_error so deprecation notices are observable
- Add dependency guard for mokostandards_* functions at top of aliases.php
- Add E_USER_NOTICE diagnostic when neither install path is found
- Improve setup-mokocli-aliases.sh with WARNING messages for edge cases

Missed files:
- Rename references in shell scripts (ci-issue-reporter, server-autoheal, sync-wikis)
- Rename references in XSD schemas and .template files
- Remove accidentally force-added bin/validate-module (gitignored)
jmiller force-pushed fix/262-rename-mokoplatform-to-mokocli from 5c48e81c59 to 908e839c30 2026-06-20 17:11:08 +00:00 Compare
jmiller merged commit 8822469761 into dev 2026-06-20 17:12:15 +00:00
jmiller deleted branch fix/262-rename-mokoplatform-to-mokocli 2026-06-20 17:12:16 +00:00
Sign in to join this conversation.
No Reviewers
No labels
Priority -
Type -
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/mokocli#278