@mokoconsulting/mokoabs-mcp 0.0.0-stage → 4.0.2

package/.mokogit/ISSUE_TEMPLATE/rfc.md

@@ -0,0 +1,126 @@
+---
+name: Request for Comments (RFC)
+about: Propose a significant change for community discussion
+title: '[RFC] '
+labels: 'rfc, discussion'
+assignees: ''
+
+---
+
+
+## RFC Summary
+One-paragraph summary of the proposal.
+
+## Motivation
+Why are we doing this? What use cases does it support? What is the expected outcome?
+
+## Detailed Design
+### Overview
+Provide a detailed explanation of the proposed change.
+
+### API Changes (if applicable)
+```php
+// Before
+function oldApi($param1) { }
+
+// After
+function newApi($param1, $param2) { }
+```
+
+### User Experience Changes
+Describe how users will interact with this change.
+
+### Implementation Approach
+High-level implementation strategy.
+
+## Drawbacks
+Why should we *not* do this?
+
+## Alternatives
+What other designs have been considered? What is the impact of not doing this?
+
+### Alternative 1
+- Description
+- Trade-offs
+
+### Alternative 2
+- Description
+- Trade-offs
+
+## Adoption Strategy
+How will existing users adopt this? Is this a breaking change?
+
+### Migration Guide
+```bash
+# Steps to migrate
+```
+
+### Deprecation Timeline
+- **Announcement**:
+- **Deprecation**:
+- **Removal**:
+
+## Unresolved Questions
+- Question 1
+- Question 2
+
+## Future Possibilities
+What future work does this enable?
+
+## Impact Assessment
+### Performance
+Expected performance impact.
+
+### Security
+Security considerations and implications.
+
+### Compatibility
+- **Backward Compatible**: [Yes / No]
+- **Breaking Changes**: [List]
+
+### Maintenance
+Long-term maintenance considerations.
+
+## Community Input
+### Stakeholders
+- [ ] Core team
+- [ ] Module developers
+- [ ] End users
+- [ ] Enterprise customers
+
+### Feedback Period
+**Duration**: [e.g., 2 weeks]
+**Deadline**: [date]
+
+## Implementation Timeline
+### Phase 1: Design
+- [ ] RFC discussion
+- [ ] Design finalization
+- [ ] Approval
+
+### Phase 2: Implementation
+- [ ] Core implementation
+- [ ] Tests
+- [ ] Documentation
+
+### Phase 3: Release
+- [ ] Beta release
+- [ ] Feedback collection
+- [ ] Stable release
+
+## Success Metrics
+How will we measure success?
+- Metric 1
+- Metric 2
+
+## References
+- Related RFCs:
+- External documentation:
+- Prior art:
+
+## Open Questions for Community
+1. Question 1?
+2. Question 2?
+
+---
+**Note**: This RFC is open for community discussion. Please provide feedback in the comments below.

package/.mokogit/ISSUE_TEMPLATE/security.md

@@ -0,0 +1,51 @@
+---
+name: Security Vulnerability Report
+about: Report a security vulnerability (use only for non-critical issues)
+title: '[SECURITY] '
+labels: 'security'
+assignees: ''
+
+---
+
+
+## ⚠️ IMPORTANT: Private Disclosure Required
+
+**For critical security vulnerabilities, DO NOT use this template.**
+Follow the process in [SECURITY.md](../SECURITY.md) for responsible disclosure.
+
+Use this template only for:
+- Security improvements
+- Non-critical security suggestions
+- Security documentation updates
+
+---
+
+## Security Issue
+
+**Severity**: 
+<!-- Low, Medium, or informational only -->
+
+## Description
+<!-- Describe the security concern or improvement suggestion -->
+
+## Affected Components
+<!-- List the affected files, features, or components -->
+
+## Suggested Mitigation
+<!-- Describe how this could be addressed -->
+
+## Standards Reference
+Does this relate to security standards in [MokoCLI](https://git.mokoconsulting.tech/MokoConsulting/mokocli)?
+- [ ] SPDX license identifiers
+- [ ] Secret management
+- [ ] Dependency security
+- [ ] Access control
+- [ ] Other: [specify]
+
+## Additional Context
+<!-- Add any other context about the security concern -->
+
+## Checklist
+- [ ] This is NOT a critical vulnerability requiring private disclosure
+- [ ] I have reviewed the SECURITY.md policy
+- [ ] I have provided sufficient detail for evaluation

package/.mokogit/ISSUE_TEMPLATE/version.md

@@ -0,0 +1,24 @@
+---
+name: Version Bump
+about: Request or track a version change
+title: '[VERSION] '
+labels: 'version, type: version'
+assignees: 'jmiller'
+---
+
+## Version Change
+
+**Current version**: <!-- e.g., 01.02.03 -->
+**Requested version**: <!-- e.g., 01.03.00 -->
+**Change type**: <!-- patch / minor / major -->
+
+## Reason
+
+<!-- Why is this version bump needed? -->
+
+## Checklist
+
+- [ ] README.md `VERSION:` field updated
+- [ ] CHANGELOG.md entry added
+- [ ] Manifest/descriptor version updated (Joomla: `<version>`, NPM/MCP: `package.json`, client: theme manifest)
+- [ ] All file headers will be auto-propagated by `sync-version-on-merge` workflow

package/.mokogit/actions/resolve-source-dir/action.yml

@@ -0,0 +1,72 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+name: "Resolve source dir"
+description: >-
+  Resolve the repository source directory from the Makefile SRC_DIR (the repo's
+  single source of truth), falling back to source/ when the Makefile is absent
+  or does not declare SRC_DIR. The per-repo metadata API is no longer consulted.
+
+inputs:
+  mokogit_token:
+    description: "Deprecated/ignored. Retained for caller compatibility; the metadata API is no longer used."
+    required: false
+    default: ""
+  strict:
+    description: "Deprecated/ignored. Retained for caller compatibility."
+    required: false
+    default: "false"
+
+outputs:
+  source_dir:
+    description: "Resolved source directory with trailing slash (e.g. source/)"
+    value: ${{ steps.resolve.outputs.source_dir }}
+  source_glob:
+    description: "Recursive glob for the source directory (e.g. source/**)"
+    value: ${{ steps.resolve.outputs.source_glob }}
+
+runs:
+  using: "composite"
+  steps:
+    - id: resolve
+      shell: bash
+      run: |
+        set -euo pipefail
+
+        normalize() {
+          # Trim whitespace, strip surrounding quotes, ensure single trailing slash.
+          # A resolved value of "." / "./" (repo root) is treated as invalid -> empty.
+          local v="$1"
+          v="$(printf '%s' "$v" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+          v="${v%\"}"; v="${v#\"}"
+          v="${v%\'}"; v="${v#\'}"
+          v="$(printf '%s' "$v" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
+          [ -z "$v" ] && { printf ''; return; }
+          v="${v%/}/"
+          if [ "$v" = "./" ] || [ "$v" = "." ]; then
+            printf ''
+            return
+          fi
+          printf '%s' "$v"
+        }
+
+        # --- Makefile SRC_DIR (single source of truth) -----------------------
+        MAKE_DIR=""
+        if [ -f Makefile ]; then
+          RAW=$(awk -F':= *' '/^SRC_DIR[[:space:]]*:=/{print $2}' Makefile | head -n1)
+          if [ -z "$RAW" ]; then
+            RAW=$(awk -F'\?= *' '/^SRC_DIR[[:space:]]*\?=/{print $2}' Makefile | head -n1)
+          fi
+          MAKE_DIR="$(normalize "$RAW")"
+        fi
+
+        # --- Resolve (Makefile SRC_DIR, else source/ default) ----------------
+        if [ -n "$MAKE_DIR" ]; then
+          SOURCE_DIR="$MAKE_DIR"
+        else
+          SOURCE_DIR="source/"
+        fi
+
+        echo "Resolved source_dir: ${SOURCE_DIR}"
+        echo "source_dir=${SOURCE_DIR}" >> "$GITHUB_OUTPUT"
+        echo "source_glob=${SOURCE_DIR}**" >> "$GITHUB_OUTPUT"

package/.mokogit/workflows/apidocs.yml

@@ -0,0 +1,132 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: MokoGIT.Workflow
+# INGROUP: MokoCLI.Universal
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Generic
+# PATH: /.mokogit/workflows/apidocs.yml
+#
+# apidocs.yml — UNIVERSAL API-docs → wiki (synced to every repo via the universal
+# profile). One platform-detecting workflow that generates an API reference from the
+# repo's own source and publishes it to the repo's OWN wiki:
+#   - joomla / php / library / module / component / package  -> `docs:php-reference` -> "PHP-Reference"
+#   - go                                                      -> `docs:go-reference`  -> "Go-Reference"
+#   - mcp                                                     -> `docs:mcp-reference` -> "MCP-Reference"
+#   - npm / electron (TS/JS)                                  -> `docs:ts-reference`  -> "TS-Reference"
+# Platform + source dir are read from the repo Makefile (PLATFORM / SRC_DIR), with
+# content/file heuristics as a fallback. Fully fail-open (no MokoCLI / no source / no
+# token / no wiki -> warn + skip; never blocks). Manual `workflow_dispatch` — a
+# release-time auto-trigger can be layered later.
+name: "Universal: API Docs -> Wiki"
+
+on:
+  workflow_dispatch: {}
+
+concurrency:
+  group: apidocs-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  apidocs:
+    name: Generate & publish API reference
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup PHP + git
+        run: |
+          if ! command -v php >/dev/null 2>&1; then
+            sudo apt-get update -qq && sudo apt-get install -y -qq php-cli php-mbstring php-xml >/dev/null 2>&1 || true
+          fi
+          php -v | head -1
+          git --version
+
+      - name: Setup MokoCLI tools
+        run: |
+          # Install mokocli FRESH from the MokoGIT Composer registry (PRIMARY); /opt
+          # is a FAILSAFE only. Registry /api/packages/** is anon-allowlisted (no
+          # token) and serves a dist zip (no git clone). The docs handlers ship in
+          # mokocli stable, so the registry copy has them.
+          if ! command -v composer >/dev/null 2>&1; then
+            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 || true
+          fi
+          rm -rf /tmp/mokocli
+          REG='{"type":"composer","url":"https://git.mokoconsulting.tech/api/packages/MokoConsulting/composer"}'
+          if composer create-project --no-install --no-interaction --no-progress --quiet \
+               --repository="${REG}" mokoconsulting/mokocli /tmp/mokocli >/dev/null 2>&1 \
+             && [ -f /tmp/mokocli/cli/docs_php_reference.php ]; then
+            echo "MOKO_CLI=/tmp/mokocli/cli" >> "$GITHUB_ENV"
+            echo "Installed mokocli fresh from the Composer registry."
+          elif [ -f /opt/mokocli/cli/docs_php_reference.php ]; then
+            echo "::warning::Registry install failed — using /opt/mokocli FAILSAFE (may be stale)"
+            echo "MOKO_CLI=/opt/mokocli/cli" >> "$GITHUB_ENV"
+          else
+            echo "::warning::mokocli docs handlers unavailable — skipping API docs"
+            echo "MOKO_CLI=" >> "$GITHUB_ENV"
+          fi
+
+      - name: Generate reference
+        id: gen
+        run: |
+          set +e
+          [ -z "$MOKO_CLI" ] && { echo "no mokocli — skipping"; exit 0; }
+          NAME="${{ github.event.repository.name }}"
+
+          PLATFORM=""; SRC=""; VER=""
+          if [ -f Makefile ]; then
+            PLATFORM="$(grep -m1 -E '^PLATFORM[[:space:]]*:?=' Makefile | sed -E 's/.*:?=[[:space:]]*//' | tr -d '[:space:]')"
+            SRC="$(grep -m1 -E '^SRC_DIR[[:space:]]*:?=' Makefile | sed -E 's/.*:?=[[:space:]]*//' | tr -d '[:space:]')"
+            VER="$(grep -m1 -E '^PROJECT_VERSION[[:space:]]*:?=' Makefile | sed -E 's/.*:?=[[:space:]]*//' | tr -d '[:space:]')"
+          fi
+          [ -z "$VER" ] && VER="$(date -u +%Y.%m.%d)"
+          if [ -z "$SRC" ]; then for d in source src htdocs; do [ -d "$d" ] && SRC="$d" && break; done; fi
+          [ -z "$SRC" ] && SRC="src"
+
+          # MCP servers are PLATFORM=npm, so the MCP content check MUST run before the
+          # npm->ts branch, else an MCP server gets a TS reference instead of a tools one.
+          KIND="php"
+          if [ "$PLATFORM" = "go" ] || { [ -z "$PLATFORM" ] && [ -f go.mod ]; }; then
+            KIND="go"
+          elif [ "$PLATFORM" = "mcp" ] || grep -rqsE 'new[[:space:]]+McpServer|server\.tool\(' "$SRC" 2>/dev/null; then
+            KIND="mcp"
+          elif [ "$PLATFORM" = "npm" ] || [ "$PLATFORM" = "electron" ] || { [ -z "$PLATFORM" ] && [ -f package.json ]; }; then
+            KIND="ts"
+          fi
+
+          mkdir -p build
+          case "$KIND" in
+            mcp) php "$MOKO_CLI/docs_mcp_reference.php" --path . --src "$SRC" --name "$NAME" --output build/MCP-Reference.md
+                 echo "page=MCP-Reference" >> "$GITHUB_OUTPUT"; echo "file=build/MCP-Reference.md" >> "$GITHUB_OUTPUT" ;;
+            go)  php "$MOKO_CLI/docs_go_reference.php" --path . --src . --name "$NAME" --version "$VER" --output build/Go-Reference.md
+                 echo "page=Go-Reference" >> "$GITHUB_OUTPUT"; echo "file=build/Go-Reference.md" >> "$GITHUB_OUTPUT" ;;
+            ts)  php "$MOKO_CLI/docs_ts_reference.php" --path . --src "$SRC" --name "$NAME" --version "$VER" --output build/TS-Reference.md
+                 echo "page=TS-Reference" >> "$GITHUB_OUTPUT"; echo "file=build/TS-Reference.md" >> "$GITHUB_OUTPUT" ;;
+            *)   php "$MOKO_CLI/docs_php_reference.php" --path . --src "$SRC" --name "$NAME" --version "$VER" --output build/PHP-Reference.md
+                 echo "page=PHP-Reference" >> "$GITHUB_OUTPUT"; echo "file=build/PHP-Reference.md" >> "$GITHUB_OUTPUT" ;;
+          esac
+          echo "kind=$KIND" >> "$GITHUB_OUTPUT"
+          echo "Generated $KIND reference from $SRC/."
+
+      - name: Publish to wiki
+        env:
+          TOKEN: ${{ github.token }}
+        run: |
+          set -e
+          FILE="${{ steps.gen.outputs.file }}"; PAGE="${{ steps.gen.outputs.page }}"
+          [ -n "$FILE" ] && [ -f "$FILE" ] || { echo "::warning::no reference generated — skipping publish"; exit 0; }
+          if [ -z "$TOKEN" ]; then echo "::warning::no MOKOGIT_TOKEN — skipping wiki publish"; exit 0; fi
+          REPO="${{ github.event.repository.name }}"; OWNER="${{ github.repository_owner }}"
+          rm -rf /tmp/wiki
+          if ! git clone -q "https://x-access-token:${TOKEN}@git.mokoconsulting.tech/${OWNER}/${REPO}.wiki.git" /tmp/wiki 2>/dev/null; then
+            echo "::warning::wiki clone failed (wiki may not be initialised) — skipping"; exit 0
+          fi
+          cp "$FILE" "/tmp/wiki/${PAGE}.md"
+          cd /tmp/wiki
+          git config user.name "Moko Consulting"; git config user.email "hello@mokoconsulting.tech"
+          git add -A
+          if git diff --cached --quiet; then echo "wiki already up to date"; exit 0; fi
+          git commit -q -m "docs(wiki): update ${PAGE} (moko ${{ steps.gen.outputs.kind }} docs) [skip ci]"
+          git push -q origin HEAD:main
+          echo "Published ${PAGE} to ${OWNER}/${REPO} wiki."

package/.mokogit/workflows/auto-assign.yml

@@ -0,0 +1,76 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: GitHub.Workflow
+# INGROUP: MokoStandards.Workflows.Shared
+# REPO: https://github.com/mokoconsulting-tech/MokoStandards
+# PATH: /.mokogit/workflows/auto-assign.yml
+# VERSION: 04.06.00
+# BRIEF: Auto-assign jmiller to unassigned issues and PRs every 15 minutes
+
+name: "Universal: Auto-Assign"
+
+on:
+  issues:
+    types: [opened]
+  pull_request_target:
+    types: [opened]
+  schedule:
+    - cron: '0 */12 * * *'
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  auto-assign:
+    name: Assign unassigned issues and PRs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Assign unassigned issues
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
+        run: |
+          REPO="${{ github.repository }}"
+          ASSIGNEE="jmiller"
+
+          echo "## 🏷️ Auto-Assign Report" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          ASSIGNED_ISSUES=0
+          ASSIGNED_PRS=0
+
+          # Assign unassigned open issues
+          ISSUES=$(gh api "repos/$REPO/issues?state=open&per_page=100&assignee=none" --jq '.[].number' 2>/dev/null || true)
+          for NUM in $ISSUES; do
+            # Skip PRs (the issues endpoint returns PRs too)
+            IS_PR=$(gh api "repos/$REPO/issues/$NUM" --jq '.pull_request // empty' 2>/dev/null || true)
+            if [ -z "$IS_PR" ]; then
+              gh api "repos/$REPO/issues/$NUM/assignees" -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
+                ASSIGNED_ISSUES=$((ASSIGNED_ISSUES + 1))
+                echo "  Assigned issue #$NUM"
+              } || true
+            fi
+          done
+
+          # Assign unassigned open PRs
+          PRS=$(gh api "repos/$REPO/pulls?state=open&per_page=100" --jq '.[] | select(.assignees | length == 0) | .number' 2>/dev/null || true)
+          for NUM in $PRS; do
+            gh api "repos/$REPO/issues/$NUM/assignees" -X POST -f "assignees[]=$ASSIGNEE" --silent 2>/dev/null && {
+              ASSIGNED_PRS=$((ASSIGNED_PRS + 1))
+              echo "  Assigned PR #$NUM"
+            } || true
+          done
+
+          echo "| Type | Assigned |" >> $GITHUB_STEP_SUMMARY
+          echo "|------|----------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Issues | $ASSIGNED_ISSUES |" >> $GITHUB_STEP_SUMMARY
+          echo "| Pull Requests | $ASSIGNED_PRS |" >> $GITHUB_STEP_SUMMARY
+
+          if [ "$ASSIGNED_ISSUES" -eq 0 ] && [ "$ASSIGNED_PRS" -eq 0 ]; then
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "✅ All issues and PRs already have assignees" >> $GITHUB_STEP_SUMMARY
+          fi