From 20c036f9137e4838f8338db6d010de46ecd72c73 Mon Sep 17 00:00:00 2001 From: Jonathan Miller Date: Sun, 5 Jul 2026 22:50:13 +0000 Subject: [PATCH] =?UTF-8?q?chore(docs):=20normalize=20refs=20=E2=80=94=20M?= =?UTF-8?q?okoStandards->org=20wiki,=20moko-platform->mokocli,=20residual?= =?UTF-8?q?=20MokoGitea/MokoSuite?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Non-workflow docs/config only (CLAUDE.md, README, branch-protection, ISSUE_TEMPLATE/config.yml, ci-issue-reporter). Workflow files, manifest schema, and Makefile install paths left for the forge-rebrand gate. Authored-by: Moko Consulting --- .mokogitea/CLAUDE.md | 4 +- CONTRIBUTING.md | 2 +- README.md | 12 ++--- index.md | 2 +- mcp/servers/mokobackup/.mokogitea/CLAUDE.md | 4 +- mcp/servers/mokobackup/README.md | 2 +- mcp/servers/mokocrm_api/.mokogitea/CLAUDE.md | 2 +- mcp/servers/mokocrm_api/CHANGELOG.md | 2 +- mcp/servers/mokocrm_api/CONTRIBUTING.md | 4 +- mcp/servers/mokocrm_api/README.md | 2 +- mcp/servers/mokocrm_api/SECURITY.md | 2 +- .../mokodreamhost/.mokogitea/CLAUDE.md | 2 +- .../mokogitea_skill/commands/deploy.md | 8 ++-- .../mokogitea_skill/commands/mcp-rebuild.md | 2 +- .../mokogitea_skill/commands/new-client.md | 20 ++++---- .../mokogitea_skill/commands/release.md | 6 +-- .../mokogitea_skill/commands/server-health.md | 8 ++-- .../mokogitea_skill/skills/mokogitea/SKILL.md | 48 +++++++++---------- mcp/servers/mokomonitor/.mokogitea/CLAUDE.md | 4 +- .../ISSUE_TEMPLATE/mcp_connection_issue.md | 2 +- mcp/servers/mokomonitor/README.md | 2 +- .../mcp_mokomonitor/.mokogitea/CLAUDE.md | 4 +- .../ISSUE_TEMPLATE/mcp_connection_issue.md | 2 +- mcp/servers/mokossh/.mokogitea/CLAUDE.md | 6 +-- .../ISSUE_TEMPLATE/mcp_connection_issue.md | 2 +- mcp/servers/mokossh/README.md | 2 +- .../mokosuite_api/.mokogitea/CLAUDE.md | 4 +- mcp/servers/mokosuite_api/CONTRIBUTING.md | 4 +- mcp/servers/mokosuite_api/README.md | 2 +- mcp/servers/mokosuite_api/SECURITY.md | 2 +- mcp/servers/windows/.mokogitea/CLAUDE.md | 2 +- .../ISSUE_TEMPLATE/mcp_connection_issue.md | 2 +- 32 files changed, 86 insertions(+), 86 deletions(-) diff --git a/.mokogitea/CLAUDE.md b/.mokogitea/CLAUDE.md index 4694270..e719206 100644 --- a/.mokogitea/CLAUDE.md +++ b/.mokogitea/CLAUDE.md @@ -38,7 +38,7 @@ composer check # Run all checks | `lib/Enterprise/Plugins/` | 11 platform plugins (Joomla, Dolibarr, Node.js, Python, etc.) | | `deploy/` | SFTP deployment scripts (Joomla, Dolibarr, health checks) | | `templates/` | Universal templates, configs, governance schema | -| `.mokogitea/workflows/` | CI/CD workflows (Gitea Actions) | +| `.mokogitea/workflows/` | CI/CD workflows (MokoGitea Actions) | | `bin/moko` | Unified CLI dispatcher — `php bin/moko ` | | `monitoring/sites.json` | Sites list for mcp_mokomonitor | @@ -71,6 +71,6 @@ PHPStan runs with `--memory-limit=512M`. CI enforces PHPCS errors; PHPStan is `c - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **New CLI tools**: extend `CliFramework`, not `CLIApp` (legacy) - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c0b4858..d7df945 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -34,7 +34,7 @@ feature/* ──PR──> dev ──draft PR──> (renamed to rc) ──merge 7. **Merging to main** triggers the stable release pipeline: - Minor version bump (e.g., `02.09.xx` → `02.10.00`) - Stability suffix stripped (clean version) - - Gitea release created with ZIP/tar.gz packages + - MokoGitea release created with ZIP/tar.gz packages - `updates.xml` updated (Joomla extensions) - `dev` branch recreated from `main` diff --git a/README.md b/README.md index cbc462b..26ff4ce 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ BRIEF: Project overview and documentation PHP implementation of mokocli — enterprise standards, automation framework, workflow templates, and bulk sync tooling. -> **Primary platform**: [Gitea — git.mokoconsulting.tech](https://git.mokoconsulting.tech/MokoConsulting/MokoCli-API) +> **Primary platform**: [MokoGitea — git.mokoconsulting.tech](https://git.mokoconsulting.tech/MokoConsulting/MokoCli-API) > **Backup mirror**: [GitHub](https://github.com/MokoConsulting/MokoCli-API) *(read-only mirror)* ## What Lives Here @@ -25,7 +25,7 @@ PHP implementation of mokocli — enterprise standards, automation framework, wo |-----------|---------| | `lib/Enterprise/` | 38 PHP enterprise library classes (platform adapters, sync, validation, plugins) | | `cli/` | CLI scripts (archive, create, release, sync rulesets, version management) | -| `automation/` | Bulk sync, push files, repo cleanup, Gitea migration | +| `automation/` | Bulk sync, push files, repo cleanup, MokoGitea migration | | `validate/` | 18 validation scripts (health, structure, secrets, syntax, drift) | | `templates/` | **Workflow templates** and config templates synced to governed repos | | `definitions/` | Repository structure definitions (`.tf` format) | @@ -42,7 +42,7 @@ composer require mokoconsulting-tech/enterprise ### Composer Registry -This package is served from Gitea package registry. Add this to your `composer.json`: +This package is served from MokoGitea package registry. Add this to your `composer.json`: ```json { @@ -73,10 +73,10 @@ vendor/bin/moko inventory -- --path . | Variable | Purpose | |----------|---------| | `GIT_PLATFORM` | `gitea` (default) or `github` | -| `GA_TOKEN` | Gitea API / Gitea Actions token | +| `GA_TOKEN` | MokoGitea API / MokoGitea Actions token | | `GH_TOKEN` | GitHub API token (for mirror sync) | -| `GITEA_URL` | Gitea instance URL (default: `https://git.mokoconsulting.tech`) | -| `GITEA_ORG` | Gitea organization (default: `MokoConsulting`) | +| `GITEA_URL` | MokoGitea instance URL (default: `https://git.mokoconsulting.tech`) | +| `GITEA_ORG` | MokoGitea organization (default: `MokoConsulting`) | ## License diff --git a/index.md b/index.md index 5829d21..abba0bb 100644 --- a/index.md +++ b/index.md @@ -61,7 +61,7 @@ Shared library code - GitHub client ### [Wiki](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki) -All documentation lives in the Gitea wiki. +All documentation lives in the MokoGitea wiki. ### [Tests](tests/) Test scripts diff --git a/mcp/servers/mokobackup/.mokogitea/CLAUDE.md b/mcp/servers/mokobackup/.mokogitea/CLAUDE.md index 7b51297..6184835 100644 --- a/mcp/servers/mokobackup/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokobackup/.mokogitea/CLAUDE.md @@ -1,6 +1,6 @@ # mcp_mokobackup -MCP server for database and file backups across Dolibarr, Joomla/Akeeba, Gitea, and file-based environments. +MCP server for database and file backups across Dolibarr, Joomla/Akeeba, MokoGitea, and file-based environments. ## Quick Reference @@ -45,5 +45,5 @@ Default config at `~/.mcp_mokobackup.json`. Client repos override via `BACKUP_MC - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokobackup/README.md b/mcp/servers/mokobackup/README.md index 73c6de4..992d8a2 100644 --- a/mcp/servers/mokobackup/README.md +++ b/mcp/servers/mokobackup/README.md @@ -15,7 +15,7 @@ Model Context Protocol server for database dumps, file backups, and Akeeba Backu | **Language** | Node.js | | **Tools** | 11 tools (6 SSH-based + 5 Akeeba API) | | **License** | GPL-3.0-or-later | -| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/backup-mcp) (primary) | +| **Platform** | [MokoGitea](https://git.mokoconsulting.tech/MokoConsulting/backup-mcp) (primary) | --- diff --git a/mcp/servers/mokocrm_api/.mokogitea/CLAUDE.md b/mcp/servers/mokocrm_api/.mokogitea/CLAUDE.md index 56a3168..a951bc9 100644 --- a/mcp/servers/mokocrm_api/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokocrm_api/.mokogitea/CLAUDE.md @@ -40,5 +40,5 @@ src/ - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokocrm_api/CHANGELOG.md b/mcp/servers/mokocrm_api/CHANGELOG.md index 16f075c..a122524 100644 --- a/mcp/servers/mokocrm_api/CHANGELOG.md +++ b/mcp/servers/mokocrm_api/CHANGELOG.md @@ -53,7 +53,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - SQL filter builder (`buildSqlFilter`, `searchFilter`) for safe query construction - Full documentation: README, INSTALLATION, ARCHITECTURE, API reference - MokoCli-compliant project structure -- 12 Gitea Actions CI/CD workflows +- 12 MokoGitea Actions CI/CD workflows ## Revision History diff --git a/mcp/servers/mokocrm_api/CONTRIBUTING.md b/mcp/servers/mokocrm_api/CONTRIBUTING.md index 0edb7ba..78d7b88 100644 --- a/mcp/servers/mokocrm_api/CONTRIBUTING.md +++ b/mcp/servers/mokocrm_api/CONTRIBUTING.md @@ -48,7 +48,7 @@ This project adheres to the Contributor Covenant Code of Conduct. By participati ### Reporting Bugs -- Use the Gitea issue tracker +- Use the MokoGitea issue tracker - Describe the bug clearly with steps to reproduce - Include the Dolibarr version you're connecting to - Include relevant logs or error messages @@ -143,7 +143,7 @@ Every repo maintains 5 standard release channel tags: ### CI/CD -- Gitea Actions runs all CI workflows +- MokoGitea Actions runs all CI workflows - Workflows live in `.gitea/workflows/` ### Secrets diff --git a/mcp/servers/mokocrm_api/README.md b/mcp/servers/mokocrm_api/README.md index 2eda4be..236e7fc 100644 --- a/mcp/servers/mokocrm_api/README.md +++ b/mcp/servers/mokocrm_api/README.md @@ -8,7 +8,7 @@ MCP server for Dolibarr ERP/CRM REST API operations |---|---| | **Language** | TypeScript | | **License** | GPL-3.0-or-later | -| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp) | +| **Platform** | [MokoGitea](https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp) | | **Node.js** | >= 20.0.0 | | **MCP SDK** | @modelcontextprotocol/sdk ^1.12.1 | diff --git a/mcp/servers/mokocrm_api/SECURITY.md b/mcp/servers/mokocrm_api/SECURITY.md index dd684d3..9155c64 100644 --- a/mcp/servers/mokocrm_api/SECURITY.md +++ b/mcp/servers/mokocrm_api/SECURITY.md @@ -31,7 +31,7 @@ Only the current major version receives security updates. ## Reporting a Vulnerability -Report security vulnerabilities via Gitea issue (preferred): +Report security vulnerabilities via MokoGitea issue (preferred): https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp/issues/new?template=security.yaml Or email: hello@mokoconsulting.tech diff --git a/mcp/servers/mokodreamhost/.mokogitea/CLAUDE.md b/mcp/servers/mokodreamhost/.mokogitea/CLAUDE.md index 5383398..2a8013a 100644 --- a/mcp/servers/mokodreamhost/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokodreamhost/.mokogitea/CLAUDE.md @@ -38,5 +38,5 @@ src/ - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokogitea_skill/commands/deploy.md b/mcp/servers/mokogitea_skill/commands/deploy.md index c080ca6..35c0f4e 100644 --- a/mcp/servers/mokogitea_skill/commands/deploy.md +++ b/mcp/servers/mokogitea_skill/commands/deploy.md @@ -18,10 +18,10 @@ Build the current project and deploy to a target server. | Name | Host | Joomla Path | Dolibarr Path | |---|---|---|---| -| WAAS_DEV | waas.dev.mokoconsulting.tech | /home/mokoconsulting_dev/waas.dev.mokoconsulting.tech/ | — | -| WAAS_DEMO | waas.demo.mokoconsulting.tech | /home/mokoconsulting_demo/waas.demo.mokoconsulting.tech/ | — | +| WAAS_DEV | mokosuite.dev.mokoconsulting.tech | /home/mokoconsulting_dev/mokosuite.dev.mokoconsulting.tech/ | — | +| WAAS_DEMO | mokosuite.demo.mokoconsulting.tech | /home/mokoconsulting_demo/mokosuite.demo.mokoconsulting.tech/ | — | | WAAS_LIVE | mokoconsulting.tech | /home/mokoconsulting/mokoconsulting.tech/ | — | -| CRM_DEV | waas.dev.mokoconsulting.tech | — | /home/mokoconsulting_dev/crm.dev.mokoconsulting.tech/htdocs/custom/ | +| CRM_DEV | mokosuite.dev.mokoconsulting.tech | — | /home/mokoconsulting_dev/crm.dev.mokoconsulting.tech/htdocs/custom/ | | CRM_LIVE | crm.mokoconsulting.tech | — | /home/mokoconsulting_crm/crm.mokoconsulting.tech/htdocs/custom/ | ## Instructions @@ -39,7 +39,7 @@ Build the current project and deploy to a target server. - Verify build output exists 4. **Deploy:** - - **Joomla**: Use `mcp_mokowaas` tool to install ZIP via Joomla API, OR use `mcp_mokossh` to SFTP + run CLI installer + - **Joomla**: Use `mcp_mokosuite` tool to install ZIP via Joomla API, OR use `mcp_mokossh` to SFTP + run CLI installer - **Dolibarr**: Use `mcp_mokossh` to rsync/scp module directory to `htdocs/custom/` 5. **Post-deploy:** diff --git a/mcp/servers/mokogitea_skill/commands/mcp-rebuild.md b/mcp/servers/mokogitea_skill/commands/mcp-rebuild.md index 32e31bf..1c9e716 100644 --- a/mcp/servers/mokogitea_skill/commands/mcp-rebuild.md +++ b/mcp/servers/mokogitea_skill/commands/mcp-rebuild.md @@ -23,7 +23,7 @@ Rebuild MCP server(s) by running `npm install` and `npm run build`. | mcp_mokogitea_api | A:/MCP/mcp_mokogitea_api | Yes (TypeScript) | | mcp_mokomonitor | A:/MCP/mcp_mokomonitor | Yes (TypeScript) | | mcp_mokossh | A:/MCP/mcp_mokossh | No (plain JS) | -| mcp_mokowaas | A:/MCP/mcp_mokowaas | Yes (TypeScript) | +| mcp_mokosuite | A:/MCP/mcp_mokosuite | Yes (TypeScript) | | mcp_windows | A:/MCP/mcp_windows | Yes (TypeScript) | ## Instructions diff --git a/mcp/servers/mokogitea_skill/commands/new-client.md b/mcp/servers/mokogitea_skill/commands/new-client.md index 1580686..46e72d2 100644 --- a/mcp/servers/mokogitea_skill/commands/new-client.md +++ b/mcp/servers/mokogitea_skill/commands/new-client.md @@ -1,17 +1,17 @@ --- name: new-client -description: Scaffold a new WaaS client — Gitea org, theme repo, MCP config, wiki, SSH key +description: Scaffold a new MokoSuite client — MokoGitea org, theme repo, MCP config, wiki, SSH key allowed-tools: Bash, Read, Write, Edit, Glob, Grep --- -# New WaaS Client Setup +# New MokoSuite Client Setup -Scaffold everything needed for a new WaaS client deployment. +Scaffold everything needed for a new MokoSuite client deployment. ## Context - Current directory: !`pwd` -- Template repo: A:/Templates/Template-Client-WaaS/ +- Template repo: A:/Templates/Template-Client-MokoSuite/ ## Instructions @@ -22,19 +22,19 @@ Ask the user for: Then execute these steps: -### 1. Create Gitea Organization +### 1. Create MokoGitea Organization - Use `mcp_mokogitea_api` tool `gitea_org_create` - Org name: PascalCase of slug (e.g. "AcmeCorp") -- Description: "WaaS client: {Client name}" +- Description: "MokoSuite client: {Client name}" ### 2. Create Client Repository - Use `mcp_mokogitea_api` tool `gitea_repo_create` in the new org -- Repo name: `client-waas-{slug}` -- Initialize from Template-Client-WaaS if possible, otherwise create empty and copy files +- Repo name: `client-mokosuite-{slug}` +- Initialize from Template-Client-MokoSuite if possible, otherwise create empty and copy files ### 3. Clone and Scaffold Locally - Clone to `A:/client-{slug}/` -- Copy template files from `A:/Templates/Template-Client-WaaS/` +- Copy template files from `A:/Templates/Template-Client-MokoSuite/` - Update `src/*.xml` manifest: - `MokoOnyx Theme — {Client Name}` - `file_mokoonyx_{slug}` @@ -44,7 +44,7 @@ Then execute these steps: ### 4. Create SSH Key - Generate key pair at `C:/Users/jmill/OneDrive/Documents/Keys/repos/client-{slug}` -- Add public key as deploy key on the Gitea repo +- Add public key as deploy key on the MokoGitea repo ### 5. Setup GitHub Mirror - Use `gitea_repo_mirror_setup_github_backup_full` to create GitHub backup mirror diff --git a/mcp/servers/mokogitea_skill/commands/release.md b/mcp/servers/mokogitea_skill/commands/release.md index 9a8812d..adc240b 100644 --- a/mcp/servers/mokogitea_skill/commands/release.md +++ b/mcp/servers/mokogitea_skill/commands/release.md @@ -1,6 +1,6 @@ --- name: release -description: Create a release — build ZIP, tag, update updates.xml, create Gitea release +description: Create a release — build ZIP, tag, update updates.xml, create MokoGitea release allowed-tools: Bash, Read, Write, Edit, Glob, Grep --- @@ -42,12 +42,12 @@ Create a release for the current repository. - Create annotated tag: `git tag -a vX.Y.Z -m "Release X.Y.Z"` - Push commits and tags: `git push origin && git push origin --tags` -6. **Create Gitea release:** +6. **Create MokoGitea release:** - Use `mcp_mokogitea_api` tool `gitea_release_create` with the tag - Upload the built ZIP as a release asset via `gitea_release_upload_asset` 7. **Joomla-specific: update updates.xml:** - - Prepend new `` block with version, download URL pointing to Gitea release asset + - Prepend new `` block with version, download URL pointing to MokoGitea release asset - ZIP filename follows Joomla convention from feedback_joomla_release_naming memory - Commit and push the updates.xml change diff --git a/mcp/servers/mokogitea_skill/commands/server-health.md b/mcp/servers/mokogitea_skill/commands/server-health.md index 1f8d042..5812734 100644 --- a/mcp/servers/mokogitea_skill/commands/server-health.md +++ b/mcp/servers/mokogitea_skill/commands/server-health.md @@ -17,23 +17,23 @@ Run health checks across all infrastructure servers using SSH. Use `mcp_mokossh` MCP tools to run health checks on each server: ### 1. GIT Server (git.mokoconsulting.tech) -- `systemctl status gitea` — is Gitea running? +- `systemctl status gitea` — is MokoGitea running? - `systemctl status act_runner` — is the Actions runner running? - `df -h /` — disk space -- `du -sh /var/lib/gitea/repositories/ /var/lib/gitea/data/ /var/lib/gitea/log/` — Gitea storage breakdown +- `du -sh /var/lib/gitea/repositories/ /var/lib/gitea/data/ /var/lib/gitea/log/` — MokoGitea storage breakdown - `uptime` — load average - `free -h` — memory usage - `certbot certificates 2>/dev/null | grep -E "Expiry|Domains"` — SSL cert expiry - `fail2ban-client status sshd 2>/dev/null | grep "Total banned"` — banned IPs -### 2. WAAS_DEV (waas.dev.mokoconsulting.tech) +### 2. WAAS_DEV (mokosuite.dev.mokoconsulting.tech) - `df -h /` — disk space - `uptime` — load average - `free -h` — memory - `php -v | head -1` — PHP version - Check Joomla health endpoint if available -### 3. WAAS_DEMO (waas.demo.mokoconsulting.tech) +### 3. WAAS_DEMO (mokosuite.demo.mokoconsulting.tech) - Same checks as WAAS_DEV ### 4. WAAS_LIVE (mokoconsulting.tech) diff --git a/mcp/servers/mokogitea_skill/skills/mokogitea/SKILL.md b/mcp/servers/mokogitea_skill/skills/mokogitea/SKILL.md index f4af8ee..ee28db1 100644 --- a/mcp/servers/mokogitea_skill/skills/mokogitea/SKILL.md +++ b/mcp/servers/mokogitea_skill/skills/mokogitea/SKILL.md @@ -1,29 +1,29 @@ --- name: mokogitea -description: "MokoGitea server infrastructure, SSH commands, deployment, backup, and administration. Use when the user mentions: gitea, mokogitea, git server, deploy, deployment, restart gitea, ssh into, server status, backup gitea, restore, mirror, github backup, update server, gitea actions, CI/CD, runner, waas server, crm server, server health, disk space, systemctl, nginx, certbot, fail2ban, firewall, server logs, gitea logs, or any remote server operation." -when_to_use: "Auto-trigger when discussing: server management, SSH operations, Gitea administration, deployments, backups, mirrors, CI runners, or any infrastructure task involving git.mokoconsulting.tech or the MokoGitea instance." +description: "MokoGitea server infrastructure, SSH commands, deployment, backup, and administration. Use when the user mentions: gitea, mokogitea, git server, deploy, deployment, restart gitea, ssh into, server status, backup gitea, restore, mirror, github backup, update server, gitea actions, CI/CD, runner, mokosuite server, crm server, server health, disk space, systemctl, nginx, certbot, fail2ban, firewall, server logs, gitea logs, or any remote server operation." +when_to_use: "Auto-trigger when discussing: server management, SSH operations, MokoGitea administration, deployments, backups, mirrors, CI runners, or any infrastructure task involving git.mokoconsulting.tech or the MokoGitea instance." --- # MokoGitea Infrastructure Reference -You are helping with MokoGitea server infrastructure. Use the `mcp_mokossh` MCP tools for SSH commands and `mcp_mokogitea_api` tools for Gitea API operations. +You are helping with MokoGitea server infrastructure. Use the `mcp_mokossh` MCP tools for SSH commands and `mcp_mokogitea_api` tools for MokoGitea API operations. ## Server Map | Name | Host | User | Port | Purpose | |---|---|---|---|---| -| GIT | git.mokoconsulting.tech | mokoconsulting | 2918 | MokoGitea instance (Gitea fork) | -| WAAS_DEV | waas.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | WaaS dev (Joomla + Dolibarr) | -| WAAS_DEMO | waas.demo.mokoconsulting.tech | mokoconsulting_demo | 22 | WaaS demo | -| WAAS_LIVE | mokoconsulting.tech | mokoconsulting | 22 | WaaS production | -| CRM_DEV | waas.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | CRM dev (shared host with WAAS_DEV) | +| GIT | git.mokoconsulting.tech | mokoconsulting | 2918 | MokoGitea instance (MokoGitea fork) | +| WAAS_DEV | mokosuite.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | MokoSuite dev (Joomla + Dolibarr) | +| WAAS_DEMO | mokosuite.demo.mokoconsulting.tech | mokoconsulting_demo | 22 | MokoSuite demo | +| WAAS_LIVE | mokoconsulting.tech | mokoconsulting | 22 | MokoSuite production | +| CRM_DEV | mokosuite.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | CRM dev (shared host with WAAS_DEV) | | CRM_LIVE | crm.mokoconsulting.tech | mokoconsulting_crm | 22 | CRM production | SSH key: `jmiller_private.openssh` (all MCP connections) ## Common SSH Commands -### Gitea Server (GIT) +### MokoGitea Server (GIT) ```bash # Service management @@ -35,12 +35,12 @@ sudo systemctl stop gitea sudo journalctl -u gitea -f # Follow live logs sudo journalctl -u gitea --since "1 hour ago" # Recent logs -# Gitea CLI (run as git user) +# MokoGitea CLI (run as git user) sudo -u git /usr/local/bin/gitea admin user list sudo -u git /usr/local/bin/gitea admin auth list sudo -u git /usr/local/bin/gitea doctor check -# Gitea Actions runner +# MokoGitea Actions runner sudo systemctl status act_runner sudo systemctl restart act_runner sudo journalctl -u act_runner -f @@ -73,12 +73,12 @@ sudo fail2ban-client status sudo fail2ban-client status sshd ``` -### WaaS Servers (WAAS_DEV / WAAS_DEMO / WAAS_LIVE) +### MokoSuite Servers (WAAS_DEV / WAAS_DEMO / WAAS_LIVE) ```bash # Joomla paths -# Dev: /home/mokoconsulting_dev/waas.dev.mokoconsulting.tech/ -# Demo: /home/mokoconsulting_demo/waas.demo.mokoconsulting.tech/ +# Dev: /home/mokoconsulting_dev/mokosuite.dev.mokoconsulting.tech/ +# Demo: /home/mokoconsulting_demo/mokosuite.demo.mokoconsulting.tech/ # Live: /home/mokoconsulting/mokoconsulting.tech/ # Check Joomla version @@ -125,7 +125,7 @@ ls htdocs/custom/ mysql -u root dolibarr -e "SELECT name, value FROM llx_const WHERE name LIKE '%VERSION%';" ``` -## Gitea API Operations +## MokoGitea API Operations Use `mcp_mokogitea_api` MCP tools for API operations: @@ -144,17 +144,17 @@ Use `mcp_mokobackup` MCP tools: | Target | Type | What it backs up | |---|---|---| -| gitea-db | mysql | Gitea MySQL database | +| gitea-db | mysql | MokoGitea MySQL database | | gitea-files | files | `/var/lib/gitea/` (repos, data, avatars) | -| waas-dev | akeeba | Joomla dev site via Akeeba API | -| waas-demo | akeeba | Joomla demo site | -| waas-live | akeeba | Joomla production site | +| mokosuite-dev | akeeba | Joomla dev site via Akeeba API | +| mokosuite-demo | akeeba | Joomla demo site | +| mokosuite-live | akeeba | Joomla production site | | crm-live | dolibarr | Dolibarr production (DB + documents + custom) | | crm-dev | dolibarr | Dolibarr dev | ## Deployment -Deployments are handled by **Gitea Actions workflows** (not manual SSH): +Deployments are handled by **MokoGitea Actions workflows** (not manual SSH): - Push to `dev` → CI runs (lint, build, validate) - Merge PR to `main` → release workflow builds ZIP, creates release, deploys via SFTP - Client sites: `client-release.yml` workflow handles theme package deployment @@ -171,12 +171,12 @@ All repos mirror to GitHub (mokoconsulting-tech org) as backup: | Path | Contents | |---|---| -| `/usr/local/bin/gitea` | Gitea binary | +| `/usr/local/bin/gitea` | MokoGitea binary | | `/etc/gitea/app.ini` | Main configuration | -| `/var/lib/gitea/` | All Gitea data | +| `/var/lib/gitea/` | All MokoGitea data | | `/var/lib/gitea/repositories/` | Git bare repos | | `/var/lib/gitea/data/` | Attachments, avatars, LFS | -| `/var/lib/gitea/log/` | Gitea logs | +| `/var/lib/gitea/log/` | MokoGitea logs | | `/var/lib/gitea/custom/` | Custom templates, public files | | `/etc/nginx/sites-enabled/gitea.conf` | Nginx reverse proxy config | | `/home/git/.act_runner/` | Actions runner config | @@ -184,7 +184,7 @@ All repos mirror to GitHub (mokoconsulting-tech org) as backup: ## Important Notes - Port 2918 on GIT server is **shell SSH** (not just git protocol) — full command execution -- Gitea repo names on server use **hyphens** (e.g. `mcp-mokobackup`), local dirs use **underscores** +- MokoGitea repo names on server use **hyphens** (e.g. `mcp-mokobackup`), local dirs use **underscores** - `mokocli` CLI tools handle CI checks — don't inline bash in workflows - All infra docs live in **mokogitea-private wiki**, not public repos - Two master SSH keys (jmiller + moko) on all servers diff --git a/mcp/servers/mokomonitor/.mokogitea/CLAUDE.md b/mcp/servers/mokomonitor/.mokogitea/CLAUDE.md index de7166d..cf6f36a 100644 --- a/mcp/servers/mokomonitor/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokomonitor/.mokogitea/CLAUDE.md @@ -33,12 +33,12 @@ src/ - Config defines **connections** for health checks + optional **Grafana** config - Sites list at `A:/mokocli/monitoring/sites.json` for bulk monitoring -- Grafana at bench.mokoconsulting.tech — WaaS dashboard for uptime/performance +- Grafana at bench.mokoconsulting.tech — MokoSuite dashboard for uptime/performance ## Rules - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md b/mcp/servers/mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md index e7031a8..7f77801 100644 --- a/mcp/servers/mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/mcp/servers/mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -18,7 +18,7 @@ assignees: '' - [ ] API response error (4xx / 5xx) ### MCP Server -- **Server Name**: [e.g., mcp_mokowaas] +- **Server Name**: [e.g., mcp_mokosuite] - **Server Version**: [e.g., 1.0.0] - **Node.js Version**: [e.g., 20.x] diff --git a/mcp/servers/mokomonitor/README.md b/mcp/servers/mokomonitor/README.md index 44eba64..2e19890 100644 --- a/mcp/servers/mokomonitor/README.md +++ b/mcp/servers/mokomonitor/README.md @@ -15,7 +15,7 @@ MCP server for infrastructure monitoring -- server health, Grafana dashboards, a | **Language** | Node.js | | **License** | GPL-3.0-or-later | | **Config** | `~/.monitor-mcp.json` | -| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/monitor-mcp) (primary) | +| **Platform** | [MokoGitea](https://git.mokoconsulting.tech/MokoConsulting/monitor-mcp) (primary) | --- diff --git a/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/CLAUDE.md b/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/CLAUDE.md index de7166d..cf6f36a 100644 --- a/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/CLAUDE.md @@ -33,12 +33,12 @@ src/ - Config defines **connections** for health checks + optional **Grafana** config - Sites list at `A:/mokocli/monitoring/sites.json` for bulk monitoring -- Grafana at bench.mokoconsulting.tech — WaaS dashboard for uptime/performance +- Grafana at bench.mokoconsulting.tech — MokoSuite dashboard for uptime/performance ## Rules - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md b/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md index e7031a8..7f77801 100644 --- a/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/mcp/servers/mokomonitor/mcp_mokomonitor/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -18,7 +18,7 @@ assignees: '' - [ ] API response error (4xx / 5xx) ### MCP Server -- **Server Name**: [e.g., mcp_mokowaas] +- **Server Name**: [e.g., mcp_mokosuite] - **Server Version**: [e.g., 1.0.0] - **Node.js Version**: [e.g., 20.x] diff --git a/mcp/servers/mokossh/.mokogitea/CLAUDE.md b/mcp/servers/mokossh/.mokogitea/CLAUDE.md index b53d270..3660b71 100644 --- a/mcp/servers/mokossh/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokossh/.mokogitea/CLAUDE.md @@ -52,10 +52,10 @@ src/ | Name | Host | User | Port | |---|---|---|---| | GIT | git.mokoconsulting.tech | mokoconsulting | 2918 | -| WAAS_DEV | waas.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | -| WAAS_DEMO | waas.demo.mokoconsulting.tech | mokoconsulting_demo | 22 | +| WAAS_DEV | mokosuite.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | +| WAAS_DEMO | mokosuite.demo.mokoconsulting.tech | mokoconsulting_demo | 22 | | WAAS_LIVE | mokoconsulting.tech | mokoconsulting | 22 | -| CRM_DEV | waas.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | +| CRM_DEV | mokosuite.dev.mokoconsulting.tech | mokoconsulting_dev | 22 | | CRM_LIVE | crm.mokoconsulting.tech | mokoconsulting_crm | 22 | SSH key: `jmiller_private.openssh` diff --git a/mcp/servers/mokossh/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md b/mcp/servers/mokossh/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md index e7031a8..7f77801 100644 --- a/mcp/servers/mokossh/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/mcp/servers/mokossh/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -18,7 +18,7 @@ assignees: '' - [ ] API response error (4xx / 5xx) ### MCP Server -- **Server Name**: [e.g., mcp_mokowaas] +- **Server Name**: [e.g., mcp_mokosuite] - **Server Version**: [e.g., 1.0.0] - **Node.js Version**: [e.g., 20.x] diff --git a/mcp/servers/mokossh/README.md b/mcp/servers/mokossh/README.md index d51cfb9..5bdd34f 100644 --- a/mcp/servers/mokossh/README.md +++ b/mcp/servers/mokossh/README.md @@ -16,7 +16,7 @@ Model Context Protocol server for SSH remote server management -- execute comman | **Tools** | 37 tools across 6 groups | | **License** | MIT | | **Upstream** | [bvisible/mcp-ssh-manager](https://github.com/bvisible/mcp-ssh-manager) v3.4.0 | -| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/ssh-mcp) (primary) | +| **Platform** | [MokoGitea](https://git.mokoconsulting.tech/MokoConsulting/ssh-mcp) (primary) | --- diff --git a/mcp/servers/mokosuite_api/.mokogitea/CLAUDE.md b/mcp/servers/mokosuite_api/.mokogitea/CLAUDE.md index 2548604..c59f11f 100644 --- a/mcp/servers/mokosuite_api/.mokogitea/CLAUDE.md +++ b/mcp/servers/mokosuite_api/.mokogitea/CLAUDE.md @@ -31,7 +31,7 @@ src/ ``` - Config defines **connections** — each is a Joomla site with URL + API token -- Default connections: moko-live (mokoconsulting.tech), moko-dev (waas.dev), moko-demo (waas.demo) +- Default connections: moko-live (mokoconsulting.tech), moko-dev (mokosuite.dev), moko-demo (mokosuite.demo) - Client sites added via client repo config overrides ## Rules @@ -39,5 +39,5 @@ src/ - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/mokosuite_api/CONTRIBUTING.md b/mcp/servers/mokosuite_api/CONTRIBUTING.md index 6d84ce6..18f45db 100644 --- a/mcp/servers/mokosuite_api/CONTRIBUTING.md +++ b/mcp/servers/mokosuite_api/CONTRIBUTING.md @@ -148,13 +148,13 @@ Every repo maintains 5 standard release channel tags: ### CI/CD -- Gitea Actions runs all CI workflows +- MokoGitea Actions runs all CI workflows - GitHub Actions are disabled on mirrored repos - Workflows live in both `.github/workflows/` and `.gitea/workflows/` ### Update Servers (Joomla) -In manifest ``, Gitea must be priority 1, GitHub priority 2. +In manifest ``, MokoGitea must be priority 1, GitHub priority 2. ### Secrets diff --git a/mcp/servers/mokosuite_api/README.md b/mcp/servers/mokosuite_api/README.md index 4e6041c..a36f143 100644 --- a/mcp/servers/mokosuite_api/README.md +++ b/mcp/servers/mokosuite_api/README.md @@ -15,7 +15,7 @@ Model Context Protocol server for the Joomla Web Services API -- full CRUD for a | **Language** | Node.js | | **Tools** | 67 tools across 15 resource groups | | **License** | GPL-3.0-or-later | -| **Platform** | [Gitea](https://git.mokoconsulting.tech/MokoConsulting/joomla-api-mcp) (primary) | +| **Platform** | [MokoGitea](https://git.mokoconsulting.tech/MokoConsulting/joomla-api-mcp) (primary) | --- diff --git a/mcp/servers/mokosuite_api/SECURITY.md b/mcp/servers/mokosuite_api/SECURITY.md index 37778f7..0b677e6 100644 --- a/mcp/servers/mokosuite_api/SECURITY.md +++ b/mcp/servers/mokosuite_api/SECURITY.md @@ -46,7 +46,7 @@ Only the current major version receives security updates. Users should upgrade t ## Reporting a Vulnerability -Report security vulnerabilities via Gitea issue (preferred): +Report security vulnerabilities via MokoGitea issue (preferred): https://git.mokoconsulting.tech/MokoConsulting/MokoCli-Template-Generic/issues/new?template=security.yaml Or email: hello@mokoconsulting.tech diff --git a/mcp/servers/windows/.mokogitea/CLAUDE.md b/mcp/servers/windows/.mokogitea/CLAUDE.md index 8e557f0..fe7480d 100644 --- a/mcp/servers/windows/.mokogitea/CLAUDE.md +++ b/mcp/servers/windows/.mokogitea/CLAUDE.md @@ -40,5 +40,5 @@ src/ - **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js` - **Attribution**: `Authored-by: Moko Consulting` - **Workflow directory**: `.mokogitea/` (not `.gitea/` or `.github/`) -- **Wiki**: documentation lives in the Gitea wiki, not `docs/` files +- **Wiki**: documentation lives in the MokoGitea wiki, not `docs/` files - **Standards**: [MokoCli](https://git.mokoconsulting.tech/MokoConsulting/mokocli/wiki/Home) diff --git a/mcp/servers/windows/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md b/mcp/servers/windows/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md index e7031a8..7f77801 100644 --- a/mcp/servers/windows/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md +++ b/mcp/servers/windows/.mokogitea/ISSUE_TEMPLATE/mcp_connection_issue.md @@ -18,7 +18,7 @@ assignees: '' - [ ] API response error (4xx / 5xx) ### MCP Server -- **Server Name**: [e.g., mcp_mokowaas] +- **Server Name**: [e.g., mcp_mokosuite] - **Server Version**: [e.g., 1.0.0] - **Node.js Version**: [e.g., 20.x]