MokoConsulting/mokoplatform
Public Access
1
0
Fork 0
Code Issues 21 Pull Requests 2 Releases 8 Wiki Activity

feat: joomla_metadata_validate CLI command (#257) #258

Merged
jmiller merged 2 commits from feature/257-joomla-metadata-validate into main 2026-06-18 20:55:12 +00:00
Conversation 0 Commits 2 Files Changed 57
+572 -57
jmiller commented 2026-06-18 20:54:02 +00:00
Owner
Copy Link
Copy Source

Summary

New CLI command that validates MokoGitea repo metadata against the actual Joomla extension manifest XML to catch update delivery mismatches before production.

What it checks

Field Comparison Severity
package_type metadata vs <extension type> Error
element Derived name vs Joomla convention Error
display_name metadata vs <name> tag Warning
version Base version match (ignores -dev/-rc) Warning
php_minimum metadata vs composer.json Warning
description metadata vs manifest (skips lang keys) Info

Usage

# Local validation
php cli/joomla_metadata_validate.php --path /path/to/repo

# CI mode (exit 1 on errors)
php cli/joomla_metadata_validate.php --path . --ci

# JSON output for workflow parsing
php cli/joomla_metadata_validate.php --path . --ci --json

# Remote mode via API
php cli/joomla_metadata_validate.php --repo MokoSuiteBackup --token $GITEA_TOKEN

Tested against MokoSuiteBackup — all 4 checks pass

Refs #257

## Summary New CLI command that validates MokoGitea repo metadata against the actual Joomla extension manifest XML to catch update delivery mismatches before production. ### What it checks | Field | Comparison | Severity | |-------|-----------|----------| | `package_type` | metadata vs `<extension type>` | Error | | `element` | Derived name vs Joomla convention | Error | | `display_name` | metadata vs `<name>` tag | Warning | | `version` | Base version match (ignores -dev/-rc) | Warning | | `php_minimum` | metadata vs composer.json | Warning | | `description` | metadata vs manifest (skips lang keys) | Info | ### Usage ```bash # Local validation php cli/joomla_metadata_validate.php --path /path/to/repo # CI mode (exit 1 on errors) php cli/joomla_metadata_validate.php --path . --ci # JSON output for workflow parsing php cli/joomla_metadata_validate.php --path . --ci --json # Remote mode via API php cli/joomla_metadata_validate.php --repo MokoSuiteBackup --token $GITEA_TOKEN ``` ### Tested against MokoSuiteBackup — all 4 checks pass Refs #257
jmiller added 2 commits 2026-06-18 20:54:02 +00:00
feat: add joomla_metadata_validate CLI command (#257)
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Details
Generic: Repo Health / Repository health (push) Blocked by required conditions
Details
Generic: Repo Health / Report Issues (push) Blocked by required conditions
Details
Generic: Repo Health / Access control (push) Successful in 1s
Details
Generic: Repo Health / Site Health (push) Has been skipped
Details
Universal: Auto Version Bump / Version Bump (push) Successful in 8s
Details
2a3e733d8c 
Validates MokoGitea repo metadata against the actual Joomla extension
manifest XML to catch update delivery mismatches before production.

Checks:
- package_type matches <extension type>
- Element name derived correctly (prefix + lowercase + clean)
- Display name matches <name> tag
- Version consistency (ignoring -dev/-rc suffixes)
- PHP minimum matches composer.json
- Description match (informational)

Supports:
- Local mode: reads .mokogitea/manifest.xml + Joomla XML from disk
- API mode: fetches metadata via Gitea API (--token)
- CI mode: --ci flag exits 1 on errors
- JSON output: --json for workflow integration

Handles all Joomla types: package, component, module, plugin,
template, library, file. Replicates Joomla's InputFilter::clean('cmd')
for element name derivation.

Refs mokoplatform #257
chore(version): auto-bump patch 09.29.01-dev [skip ci]
RC Revert / Rename rc/ back to dev/ (pull_request) Has been skipped
Details
Branch Cleanup / Delete merged branch (pull_request) Failing after 1s
Details
Universal: Build & Release / Promote to RC (pull_request) Has been skipped
Details
7ac196e4a8
jmiller merged commit 78fa142342 into main 2026-06-18 20:55:12 +00:00
jmiller deleted branch feature/257-joomla-metadata-validate 2026-06-18 20:55:13 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
automation
Automated processes or scripts
 breaking-change
Breaking API or functionality change
 build
Build system changes
 ci-cd
CI/CD pipeline changes
 config
Configuration file changes
 css
CSS/styling changes
 dependencies
Dependency updates
 deploy-failure
Automated deploy failure tracking
 docker
Docker configuration changes
 documentation
Documentation changes
 dolibarr
Dolibarr module or extension
 generic
Generic project or library
 good first issue
Good for newcomers
 health-check
Repository health check results
 health: excellent
Health score 90-100
 health: fair
Health score 50-69
 health: good
Health score 70-89
 health: poor
Health score below 50
 help wanted
Extra attention needed
 html
HTML template changes
 javascript
JavaScript code changes
 joomla
Joomla extension or component
 mokostandards
MokoStandards compliance
 needs-review
Awaiting code review
 php
PHP code changes
 push-failure
File push failure requiring attention
 python
Python code changes
 security
Security-related changes
 size/l
Large change (101-300 lines)
 size/m
Medium change (31-100 lines)
 size/s
Small change (11-30 lines)
 size/xl
Extra large change (301-1000 lines)
 size/xs
Extra small change (1-10 lines)
 size/xxl
Extremely large change (1000+ lines)
 standards-drift
Repository drifted from MokoStandards
 standards-update
MokoStandards sync update
 sync-failure
Bulk sync failure requiring attention
 sync-report
Bulk sync run report
 template-validation-failure
Template workflow validation failure
 tests
Test suite changes
 type: bug
Something isn't working
 type: chore
Maintenance tasks
 type: enhancement
Enhancement to existing feature
 type: feature
New feature or request
 type: refactor
Code refactoring
 type: version
Version-related change
 typescript
TypeScript code changes
 version
Version bump or release
 version-drift
Version mismatch detected
 work-in-progress
Work in progress, not ready for merge
No labels
Priority -
Type -
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/mokoplatform#258
Delete Branch "feature/257-joomla-metadata-validate"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?