Public Access
chore(docs): normalize refs — MokoStandards->org wiki, moko-platform->mokocli, residual MokoGitea/MokoSuite
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 19s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 19s
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
This commit is contained in:
@@ -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 <command>` |
|
||||
| `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)
|
||||
|
||||
+1
-1
@@ -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`
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 |
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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:**
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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:
|
||||
- `<name>MokoOnyx Theme — {Client Name}</name>`
|
||||
- `<element>file_mokoonyx_{slug}</element>`
|
||||
@@ -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
|
||||
|
||||
@@ -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 `<update>` block with version, download URL pointing to Gitea release asset
|
||||
- Prepend new `<update>` 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
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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]
|
||||
|
||||
|
||||
@@ -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) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
+1
-1
@@ -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]
|
||||
|
||||
|
||||
@@ -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`
|
||||
|
||||
@@ -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]
|
||||
|
||||
|
||||
@@ -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) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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 `<updateservers>`, Gitea must be priority 1, GitHub priority 2.
|
||||
In manifest `<updateservers>`, MokoGitea must be priority 1, GitHub priority 2.
|
||||
|
||||
### Secrets
|
||||
|
||||
|
||||
@@ -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) |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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]
|
||||
|
||||
|
||||
Reference in New Issue
Block a user