Compare commits

...

37 Commits

Author SHA1 Message Date
jmiller 88acf57278 feat(client): accept client-mokosuite-* prefix (backward-compat with client-waas-)
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 21s
Discovery (client_dashboard, client_inventory) matches BOTH client-waas- and
client-mokosuite-; provisioning emits client-mokosuite-. Enables the live client
repo renames without breaking discovery. Refs Template-Client#59.

Authored-by: Moko Consulting
2026-07-05 23:56:36 +00:00
jmiller ac293fd038 Merge chore/normalize-docs: normalize doc/config refs
Cascade Main -> Dev / Cascade main -> dev (push) Successful in 15s
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Universal: PR Check / Require Docs Update (pull_request) Has been skipped
Universal: PR Check / Wiki Update Reminder (pull_request) Has been skipped
Generic: Project CI / Lint & Validate (pull_request) Successful in 1m11s
Universal: PR Check / Secret Scan (pull_request) Successful in 23s
Universal: PR Check / Validate PR (pull_request) Failing after 11s
Platform: mokocli CI / Gate 1: Code Quality (pull_request) Successful in 2m31s
Generic: Project CI / Tests (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.1) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.2) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 2: Unit Tests (8.3) (pull_request) Has been cancelled
Platform: mokocli CI / Gate 3: Self-Health Check (pull_request) Has been cancelled
Platform: mokocli CI / Gate 4: Governance (pull_request) Has been cancelled
Platform: mokocli CI / Gate 5: Template Integrity (pull_request) Has been cancelled
Platform: mokocli CI / CI Summary (pull_request) Has been cancelled
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
2026-07-05 22:50:14 +00:00
jmiller 20c036f913 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
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
2026-07-05 22:50:13 +00:00
jmiller 062b33b395 chore: sync workflow-sync-trigger.yml from Template-Generic [skip ci] 2026-07-05 21:31:17 +00:00
jmiller 2d8bb5e967 chore: sync version-set.yml from Template-Generic [skip ci] 2026-07-05 21:31:16 +00:00
jmiller a172b21b9b chore: sync repo-health.yml from Template-Generic [skip ci] 2026-07-05 21:31:14 +00:00
jmiller 2ce8caad88 chore: sync rc-revert.yml from Template-Generic [skip ci] 2026-07-05 21:31:12 +00:00
jmiller 0b97aa06c9 chore: sync pre-release.yml from Template-Generic [skip ci] 2026-07-05 21:31:10 +00:00
jmiller f2fb64ec5a chore: sync pr-check.yml from Template-Generic [skip ci] 2026-07-05 21:31:08 +00:00
jmiller eabc96b506 chore: sync notify.yml from Template-Generic [skip ci] 2026-07-05 21:31:07 +00:00
jmiller ed54dd5153 chore: sync gitleaks.yml from Template-Generic [skip ci] 2026-07-05 21:28:53 +00:00
jmiller 40ebb4774c chore: sync cleanup.yml from Template-Generic [skip ci] 2026-07-05 21:28:52 +00:00
jmiller bb2c34abbb chore: sync ci-issue-reporter.yml from Template-Generic [skip ci] 2026-07-05 21:28:51 +00:00
jmiller 5680b32e31 chore: sync ci-generic.yml from Template-Generic [skip ci] 2026-07-05 21:28:50 +00:00
jmiller 88fa860080 chore: sync cascade-dev.yml from Template-Generic [skip ci] 2026-07-05 21:28:49 +00:00
jmiller 0d9c64cd28 chore: sync branch-cleanup.yml from Template-Generic [skip ci] 2026-07-05 21:28:47 +00:00
jmiller 3dbd221c69 chore: sync auto-release.yml from Template-Generic [skip ci] 2026-07-05 21:28:46 +00:00
jmiller 2cedc0b94e chore: sync auto-bump.yml from Template-Generic [skip ci] 2026-07-05 21:28:45 +00:00
jmiller 94fde481d2 chore: sync workflow-sync-trigger.yml from Template-Generic [skip ci] 2026-07-05 21:08:00 +00:00
jmiller b5c38d76e8 chore: sync pr-check.yml from Template-Generic [skip ci] 2026-07-05 21:07:58 +00:00
jmiller ce0502e788 chore: sync version-set.yml from Template-Generic [skip ci] 2026-07-05 20:39:20 +00:00
jmiller cf29777daa chore: sync sync-on-merge.yml from Template-Generic [skip ci] 2026-07-05 20:39:19 +00:00
jmiller 61d52ce1cb chore: sync rc-revert.yml from Template-Generic [skip ci] 2026-07-05 20:39:17 +00:00
jmiller 16305623cc chore: sync pre-release.yml from Template-Generic [skip ci] 2026-07-05 20:39:16 +00:00
jmiller e5768d5e44 chore: sync gitleaks.yml from Template-Generic [skip ci] 2026-07-05 20:39:13 +00:00
jmiller 9342bdf373 chore: sync auto-bump.yml from Template-Generic [skip ci] 2026-07-05 20:39:09 +00:00
jmiller dad002cc08 chore: sync repo-health.yml from Template-Generic [skip ci] 2026-07-05 20:34:02 +00:00
jmiller 37fdef1323 chore: sync rc-revert.yml from Template-Generic [skip ci] 2026-07-05 20:34:00 +00:00
jmiller 845a377045 chore: sync pre-release.yml from Template-Generic [skip ci] 2026-07-05 20:33:58 +00:00
jmiller 1a83a2abd5 chore: sync pr-check.yml from Template-Generic [skip ci] 2026-07-05 20:33:55 +00:00
jmiller 9577ea6058 chore: sync issue-branch.yml from Template-Generic [skip ci] 2026-07-05 20:33:53 +00:00
jmiller c113f0437e chore: sync gitleaks.yml from Template-Generic [skip ci] 2026-07-05 20:33:51 +00:00
jmiller bfaab8a79e chore: sync ci-issue-reporter.yml from Template-Generic [skip ci] 2026-07-05 20:33:48 +00:00
jmiller 84e54c7567 chore: sync cascade-dev.yml from Template-Generic [skip ci] 2026-07-05 20:33:45 +00:00
jmiller f270ce6a78 chore: sync branch-cleanup.yml from Template-Generic [skip ci] 2026-07-05 20:33:43 +00:00
jmiller 7b45f7d92b chore: sync auto-release.yml from Template-Generic [skip ci] 2026-07-05 20:33:41 +00:00
jmiller 9859a06a09 chore: sync auto-bump.yml from Template-Generic [skip ci] 2026-07-05 20:33:39 +00:00
52 changed files with 324 additions and 157 deletions
+2 -2
View File
@@ -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)
+5 -4
View File
@@ -3,9 +3,9 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Release
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/auto-bump.yml
# VERSION: 09.02.00
# BRIEF: Auto patch-bump version on every push to dev (skips merge commits)
@@ -34,7 +34,8 @@ jobs:
if: >-
!contains(github.event.head_commit.message, '[skip ci]') &&
!contains(github.event.head_commit.message, '[skip bump]') &&
!startsWith(github.event.head_commit.message, 'Merge pull request')
!startsWith(github.event.head_commit.message, 'Merge pull request') &&
!startsWith(github.event.repository.name, 'Template-')
steps:
- name: Checkout
@@ -52,7 +53,7 @@ jobs:
echo "MOKO_CLI=/opt/mokocli/cli" >> "$GITHUB_ENV"
else
git clone --depth 1 --branch main --quiet \
"https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/mokocli.git" \
"https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/MokoConsulting/MokoCLI.git" \
/tmp/mokocli
cd /tmp/mokocli && composer install --no-dev --no-interaction --quiet
echo "MOKO_CLI=/tmp/mokocli/cli" >> "$GITHUB_ENV"
+11 -19
View File
@@ -3,10 +3,10 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Release
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
# PATH: /templates/workflows/universal/auto-release.yml.template
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/auto-release.yml
# VERSION: 05.01.00
# BRIEF: Universal build & release detects platform from manifest.xml
#
@@ -142,8 +142,8 @@ jobs:
run: |
git fetch origin rc
git checkout rc
git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "gitea-actions[bot]"
git config --local user.email "mokogitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "mokogitea-actions[bot]"
git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
- name: Publish RC release
@@ -214,8 +214,8 @@ jobs:
- name: Configure git for bot pushes
run: |
git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "gitea-actions[bot]"
git config --local user.email "mokogitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "mokogitea-actions[bot]"
git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
- name: Check for merge conflict markers
@@ -426,7 +426,7 @@ jobs:
&& echo "main branch pushed to GitHub mirror" \
|| echo "WARNING: GitHub mirror push failed"
- name: "Step 11: Delete rc branch and recreate dev from main"
- name: "Step 11: Delete rc branch (dev reset moved to cascade-dev.yml)"
if: steps.version.outputs.skip != 'true'
continue-on-error: true
run: |
@@ -438,17 +438,9 @@ jobs:
"${API_BASE}/branches/rc" 2>/dev/null \
&& echo "Deleted rc branch" || echo "rc branch not found"
# Delete dev branch
curl -sf -X DELETE -H "Authorization: token ${TOKEN}" \
"${API_BASE}/branches/dev" 2>/dev/null && echo "Deleted dev branch"
# Recreate dev from main (now includes version bump + changelog promotion)
curl -sf -X POST -H "Authorization: token ${TOKEN}" \
-H "Content-Type: application/json" \
"${API_BASE}/branches" \
-d '{"new_branch_name":"dev","old_branch_name":"main"}' 2>/dev/null && echo "Recreated dev from main"
echo "Pre-release branches cleaned, dev reset from main" >> $GITHUB_STEP_SUMMARY
# dev is reset from main by the dedicated "Cascade Main -> Dev" workflow
# (cascade-dev.yml), which runs after this release completes.
echo "rc cleaned; dev reset handled by cascade-dev.yml" >> $GITHUB_STEP_SUMMARY
- name: "Step 12: Create version branch from main"
if: steps.version.outputs.skip != 'true'
+2 -2
View File
@@ -3,9 +3,9 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/branch-cleanup.yml
# VERSION: 01.00.00
# BRIEF: Delete feature branches after PR merge
+103 -7
View File
@@ -1,10 +1,106 @@
# DISABLED — auto-release Step 11 recreates dev from main after every release.
# Cascade-dev is redundant and causes version conflicts when both main and dev
# have different version numbers in templateDetails.xml / manifest.xml.
name: "Cascade Main → Dev (DISABLED)"
on: workflow_dispatch
# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
#
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.Cascade
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/cascade-dev.yml
# VERSION: 02.00.00
# BRIEF: Cascade main -> dev via PR; auto-merge only if conflict-free, else notify
name: "Cascade Main -> Dev"
on:
push:
branches:
- main
workflow_dispatch:
permissions:
contents: write
pull-requests: write
env:
MOKOGITEA_URL: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
# ntfy destination is configured via repo or org variables (org vars are inherited).
NTFY_URL: ${{ vars.NTFY_URL || 'https://ntfy.mokoconsulting.tech' }}
NTFY_TOPIC: ${{ vars.CASCADE_NTFY_TOPIC || vars.NTFY_TOPIC || 'gitea-releases' }}
jobs:
noop:
cascade:
name: Cascade main -> dev
runs-on: ubuntu-latest
steps:
- run: echo "Cascade disabled — auto-release handles dev recreation"
- name: Open main -> dev PR (auto-merge if clean, else notify)
env:
TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
REPO: ${{ github.repository }}
run: |
set -uo pipefail
API="${MOKOGITEA_URL}/api/v1/repos/${REPO}"
AUTH="Authorization: token ${TOKEN}"
jqnum() { python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('$1',''))" 2>/dev/null; }
# 0. dev must exist
if ! curl -sf -H "$AUTH" "${API}/branches/dev" >/dev/null 2>&1; then
echo "No dev branch - nothing to cascade."; exit 0
fi
# 1. is main ahead of dev?
AHEAD=$(curl -sf -H "$AUTH" "${API}/compare/dev...main" \
| python3 -c "import sys,json; print(json.load(sys.stdin).get('total_commits',0))" 2>/dev/null || echo 0)
if [ "${AHEAD:-0}" -eq 0 ]; then
echo "dev already up to date with main."; exit 0
fi
echo "main is ${AHEAD} commit(s) ahead of dev."
# 2. reuse an open main->dev PR, else create one
PR=$(curl -sf -H "$AUTH" "${API}/pulls?state=open&base=dev" \
| python3 -c "import sys,json; d=json.load(sys.stdin); print(next((str(p['number']) for p in d if p.get('head',{}).get('ref')=='main'), ''))" 2>/dev/null || echo "")
if [ -z "$PR" ]; then
RESP=$(curl -s -H "$AUTH" -H "Content-Type: application/json" -X POST "${API}/pulls" \
-d '{"head":"main","base":"dev","title":"chore(sync): cascade main -> dev","body":"Automated cascade of main into dev. Auto-merges only if conflict-free; otherwise left open for manual resolution."}')
PR=$(printf '%s' "$RESP" | jqnum number)
if [ -z "$PR" ]; then
echo "::warning::Could not open cascade PR: $RESP"; exit 0
fi
echo "Opened cascade PR #${PR}"
else
echo "Reusing open cascade PR #${PR}"
fi
# 3. wait for MokoGitea to compute mergeability (conflict detection)
MERGEABLE=""
for _ in 1 2 3 4 5 6; do
MERGEABLE=$(curl -sf -H "$AUTH" "${API}/pulls/${PR}" | jqnum mergeable)
case "$MERGEABLE" in True|False) break ;; esac
sleep 3
done
echo "mergeable=${MERGEABLE}"
notify() {
curl -sS \
-H "Title: ${REPO}: dev cascade needs manual merge" \
-H "Tags: warning,twisted_rightwards_arrows" \
-H "Priority: high" \
-H "Click: ${MOKOGITEA_URL}/${REPO}/pulls/${PR}" \
-d "main -> dev cascade PR #${PR} $1 It was NOT auto-merged; resolve it manually." \
"${NTFY_URL}/${NTFY_TOPIC}" || true
}
# 4. auto-merge only if conflict-free; otherwise notify
if [ "$MERGEABLE" = "True" ]; then
CODE=$(curl -s -o /tmp/merge.json -w "%{http_code}" -H "$AUTH" -H "Content-Type: application/json" \
-X POST "${API}/pulls/${PR}/merge" -d '{"Do":"merge","merge_when_checks_succeed":true}')
if [ "$CODE" -ge 200 ] && [ "$CODE" -lt 300 ]; then
echo "Cascade PR #${PR} merged (or scheduled to merge when checks pass)."
else
echo "::warning::Auto-merge returned HTTP ${CODE}: $(cat /tmp/merge.json)"
notify "could not be auto-merged (HTTP ${CODE})."
fi
else
echo "::warning::Cascade PR #${PR} has conflicts (mergeable=${MERGEABLE}); sending notification."
notify "has conflicts and cannot be merged automatically."
fi
+1 -1
View File
@@ -3,7 +3,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.CI
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/ci-generic.yml
+3 -3
View File
@@ -3,12 +3,12 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/ci-issue-reporter.yml
# VERSION: 01.00.00
# BRIEF: Reusable workflow — creates/updates a Gitea issue when a CI gate fails.
# BRIEF: Reusable workflow — creates/updates a MokoGitea issue when a CI gate fails.
# Clones MokoCLI and runs cli/ci_issue_reporter.sh.
name: "Universal: CI Issue Reporter"
+1 -1
View File
@@ -3,7 +3,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.Maintenance
# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
# PATH: /.mokogitea/workflows/cleanup.yml
+3 -3
View File
@@ -3,10 +3,10 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.Security
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/MokoStandards-API
# PATH: /templates/workflows/gitleaks.yml.template
# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards-API
# PATH: /.mokogitea/workflows/gitleaks.yml
# VERSION: 01.00.00
# BRIEF: Secret scanning — detect leaked credentials, API keys, and tokens
#
+1 -1
View File
@@ -5,7 +5,7 @@
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# INGROUP: mokocli.Automation
# VERSION: 09.43.00
# VERSION: 01.00.00
# BRIEF: Auto-create feature branch when an issue is opened
name: "Universal: Issue Branch"
+1 -1
View File
@@ -3,7 +3,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: MokoStandards.Notifications
# REPO: https://git.mokoconsulting.tech/MokoConsulting/MokoStandards
# PATH: /.mokogitea/workflows/notify.yml
+79 -5
View File
@@ -3,10 +3,10 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.CI
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
# PATH: /templates/workflows/universal/pr-check.yml.template
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/pr-check.yml
# VERSION: 09.23.00
# BRIEF: PR gate — branch policy + code validation before merge
@@ -97,6 +97,80 @@ jobs:
echo "Branch policy: OK (${HEAD} → ${BASE})"
echo "## Branch Policy: Passed" >> $GITHUB_STEP_SUMMARY
# ── Docs Update Gate (main PRs) ─────────────────────────────────────────
require-docs:
name: Require Docs Update
runs-on: ubuntu-latest
# Enforce only on PRs merging into main: README.md + CHANGELOG.md must both be updated.
if: ${{ github.base_ref == 'main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Require README.md and CHANGELOG.md in the PR diff
run: |
BASE="${{ github.event.pull_request.base.sha }}"
HEAD="${{ github.event.pull_request.head.sha }}"
CHANGED="$(git diff --name-only "$BASE" "$HEAD" 2>/dev/null || true)"
if [ -z "$CHANGED" ]; then
git fetch -q origin "${{ github.base_ref }}" 2>/dev/null || true
CHANGED="$(git diff --name-only "origin/${{ github.base_ref }}...HEAD" 2>/dev/null || true)"
fi
echo "Changed files in PR:"
echo "$CHANGED"
MISSING=""
echo "$CHANGED" | grep -qxE 'README\.md' || MISSING="README.md"
echo "$CHANGED" | grep -qxE 'CHANGELOG\.md' || MISSING="${MISSING:+$MISSING, }CHANGELOG.md"
if [ -n "$MISSING" ]; then
echo "::error::PRs into main must update: ${MISSING}"
{
echo "## Docs Update Required"
echo ""
echo "PRs merging into \`main\` must update both **README.md** and **CHANGELOG.md**."
echo ""
echo "Not updated in this PR: **${MISSING}**"
} >> "$GITHUB_STEP_SUMMARY"
exit 1
fi
echo "Docs update present (README.md + CHANGELOG.md)"
echo "## Docs Update: Passed" >> "$GITHUB_STEP_SUMMARY"
# ── Wiki Update Reminder (main PRs, non-blocking) ───────────────────────
wiki-reminder:
name: Wiki Update Reminder
runs-on: ubuntu-latest
if: ${{ github.base_ref == 'main' }}
steps:
- name: Remind to update the wiki
env:
TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
SERVER: ${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}
REPO: ${{ github.repository }}
PR: ${{ github.event.pull_request.number }}
run: |
set -uo pipefail
{
echo "## Wiki Update Reminder"
echo ""
echo "Docs are **wiki-first** at MokoConsulting. If this change affects behavior, usage, configuration, or standards, update the repo wiki:"
echo ""
echo "- ${SERVER}/${REPO}/wiki"
echo ""
echo "_Non-blocking reminder._"
} >> "$GITHUB_STEP_SUMMARY"
# Post a single PR comment (idempotent via hidden marker); best-effort, never fails.
API="${SERVER}/api/v1/repos/${REPO}/issues/${PR}/comments"
if [ -n "${TOKEN:-}" ] && [ -n "${PR:-}" ]; then
existing="$(curl -sf -H "Authorization: token ${TOKEN}" "$API" 2>/dev/null | grep -c 'wiki-reminder' || true)"
if [ "${existing:-0}" -eq 0 ]; then
curl -sf -H "Authorization: token ${TOKEN}" -H "Content-Type: application/json" -X POST "$API" \
-d '{"body":"<!-- wiki-reminder -->\n\n**Wiki reminder:** docs are wiki-first -- if this PR changes behavior, usage, config, or standards, please update the repo wiki before/after merge. _(non-blocking)_"}' >/dev/null 2>&1 || true
fi
fi
echo "Wiki reminder emitted (non-blocking)."
# ── Secret Scanning ──────────────────────────────────────────────────
gitleaks:
name: Secret Scan
@@ -276,7 +350,7 @@ jobs:
joomla)
MANIFEST=$(find . -maxdepth 3 -name "*.xml" ! -path "./.git/*" -exec grep -l '<extension' {} \; 2>/dev/null | head -1)
if [ -z "$MANIFEST" ]; then
echo "::warning::No Joomla manifest found (WaaS site)"
echo "::warning::No Joomla manifest found (MokoSuite site)"
exit 0
fi
echo "Manifest: ${MANIFEST}"
@@ -289,7 +363,7 @@ jobs:
# Block legacy raw/branch update server URLs on MokoGitea
RAW_URLS=$(grep -n 'raw/branch' "$MANIFEST" | grep -i 'mokoconsulting\|mokogitea\|git\.mokoconsulting\.tech' || true)
if [ -n "$RAW_URLS" ]; then
echo "::error::Manifest contains legacy raw/branch update server URL on MokoGitea. Use the Gitea Pages URL instead (e.g. /{REPO}/updates.xml not /{REPO}/raw/branch/main/updates.xml)"
echo "::error::Manifest contains legacy raw/branch update server URL on MokoGitea. Use the MokoGitea Pages URL instead (e.g. /{REPO}/updates.xml not /{REPO}/raw/branch/main/updates.xml)"
echo "$RAW_URLS"
exit 1
fi
+6 -6
View File
@@ -3,10 +3,10 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Release
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# PATH: /templates/workflows/universal/pre-release.yml.template
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/pre-release.yml
# VERSION: 05.02.00
# BRIEF: Auto pre-release on push to dev/alpha/beta/rc branches
@@ -84,7 +84,7 @@ jobs:
sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml php-zip php-curl composer > /dev/null 2>&1
fi
rm -rf /tmp/mokocli
CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/mokocli.git
CLONE_URL=https://x-access-token:${MOKO_CLONE_TOKEN}@${MOKO_CLONE_HOST}/MokoCLI.git
git clone --depth 1 --branch main --quiet $CLONE_URL /tmp/mokocli
cd /tmp/mokocli && composer install --no-dev --no-interaction --quiet
echo MOKO_CLI=/tmp/mokocli/cli >> $GITHUB_ENV
@@ -156,8 +156,8 @@ jobs:
fi
# Commit version bump
git config --local user.email "gitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "gitea-actions[bot]"
git config --local user.email "mokogitea-actions[bot]@mokoconsulting.tech"
git config --local user.name "mokogitea-actions[bot]"
git remote set-url origin "https://x-access-token:${{ secrets.MOKOGITEA_TOKEN }}@git.mokoconsulting.tech/${{ github.repository }}.git"
git add -A
git diff --cached --quiet || {
+4 -3
View File
@@ -3,9 +3,9 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/rc-revert.yml
# VERSION: 09.23.00
# BRIEF: Rename rc/ branch back to dev/ when PR is closed without merge
@@ -25,7 +25,8 @@ jobs:
runs-on: ubuntu-latest
if: >-
github.event.pull_request.merged == false &&
startsWith(github.event.pull_request.head.ref, 'rc/')
startsWith(github.event.pull_request.head.ref, 'rc/') &&
!startsWith(github.event.repository.name, 'Template-')
steps:
- name: Rename branch
+4 -4
View File
@@ -6,10 +6,10 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Validation
# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
# PATH: /templates/workflows/joomla/repo_health.yml.template
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/repo-health.yml
# VERSION: 09.23.00
# BRIEF: Enforces repository guardrails by validating scripts governance, tooling availability, and core repository health artifacts.
# ============================================================================
@@ -88,7 +88,7 @@ jobs:
# Hardcoded authorized users — always allowed
case "$ACTOR" in
jmiller|gitea-actions[bot])
jmiller|mokogitea-actions[bot])
ALLOWED=true
PERMISSION=admin
METHOD="hardcoded allowlist"
+2 -1
View File
@@ -10,11 +10,12 @@ on:
jobs:
sync:
runs-on: ubuntu-latest
if: ${{ startsWith(github.event.repository.name, 'Template-') }}
steps:
- name: Checkout mokocli
uses: actions/checkout@v4
with:
repository: MokoConsulting/mokocli
repository: MokoConsulting/MokoCLI
token: ${{ secrets.MOKOGITEA_TOKEN }}
- name: Setup PHP
+2 -1
View File
@@ -3,7 +3,7 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow.Template
# DEFGROUP: MokoGitea.Workflow.Template
# INGROUP: MokoStandards.CI
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Joomla
# PATH: /.mokogitea/workflows/version-set.yml
@@ -34,6 +34,7 @@ jobs:
set-version:
name: Set Version to ${{ inputs.version }}
runs-on: ubuntu-latest
if: ${{ !startsWith(github.event.repository.name, 'Template-') }}
steps:
- name: Validate version format
@@ -3,9 +3,9 @@
# SPDX-License-Identifier: GPL-3.0-or-later
#
# FILE INFORMATION
# DEFGROUP: Gitea.Workflow
# DEFGROUP: MokoGitea.Workflow
# INGROUP: mokocli.Universal
# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
# PATH: /.mokogitea/workflows/workflow-sync-trigger.yml
# VERSION: 01.01.00
# BRIEF: Trigger workflow sync to live repos when a PR is merged to main
@@ -27,9 +27,10 @@ jobs:
name: Sync workflows to live repos
runs-on: ubuntu-latest
if: >-
github.event_name == 'workflow_dispatch' ||
startsWith(github.event.repository.name, 'Template-') &&
(github.event_name == 'workflow_dispatch' ||
(github.event.pull_request.merged == true &&
!contains(github.event.pull_request.title, '[skip sync]'))
!contains(github.event.pull_request.title, '[skip sync]')))
steps:
- name: Determine platform from repo name
@@ -52,7 +53,7 @@ jobs:
MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
run: |
MOKOGITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
git clone --depth 1 "${MOKOGITEA_URL}/MokoConsulting/mokocli.git" /tmp/mokocli
git clone --depth 1 "${MOKOGITEA_URL}/MokoConsulting/MokoCLI.git" /tmp/mokocli
- name: Install PHP
run: |
+1 -1
View File
@@ -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`
+6 -6
View File
@@ -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
+2 -2
View File
@@ -127,7 +127,7 @@ class ClientDashboardCli extends CliFramework
$name = $repo['name'] ?? '';
if (
!str_starts_with($name, 'client-waas-')
!str_starts_with($name, 'client-waas-') && !str_starts_with($name, 'client-mokosuite-')
|| !empty($repo['archived'])
) {
continue;
@@ -135,7 +135,7 @@ class ClientDashboardCli extends CliFramework
$clients[] = [
'repo' => $repo['full_name'] ?? '',
'name' => str_replace('client-waas-', '', $name),
'name' => str_replace(['client-waas-', 'client-mokosuite-'], '', $name),
'description' => $repo['description'] ?? '',
'updated' => $repo['updated_at'] ?? '',
'url' => $repo['html_url'] ?? '',
+1 -1
View File
@@ -79,7 +79,7 @@ class ClientInventoryCli extends CliFramework
foreach ($repos as $repo) {
$repoName = $repo['name'] ?? '';
if (strpos($repoName, 'client-waas') === false) {
if (strpos($repoName, 'client-waas') === false && strpos($repoName, 'client-mokosuite') === false) {
continue;
}
+1 -1
View File
@@ -87,7 +87,7 @@ class ClientProvisionCli extends CliFramework
return 1;
}
$this->repoName = 'client-waas-' . $clientName;
$this->repoName = 'client-mokosuite-' . $clientName;
$this->log('INFO', "=== Client Provisioning: {$clientName} ===");
$this->log('INFO', " Org: {$this->org}");
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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)
+1 -1
View File
@@ -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) |
---
+1 -1
View File
@@ -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)
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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
+1 -1
View File
@@ -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 |
+1 -1
View File
@@ -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
+2 -2
View File
@@ -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]
+1 -1
View File
@@ -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)
@@ -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]
+3 -3
View File
@@ -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]
+1 -1
View File
@@ -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)
+2 -2
View File
@@ -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
+1 -1
View File
@@ -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) |
---
+1 -1
View File
@@ -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
+1 -1
View File
@@ -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]