@mokoconsulting/mcp-mokogitea-api 1.4.0 → 1.4.2

package/.mokogitea/workflows/rc-revert.yml

@@ -0,0 +1,66 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: Gitea.Workflow
+# INGROUP: MokoPlatform.Universal
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
+# PATH: /.mokogitea/workflows/rc-revert.yml
+# VERSION: 09.23.00
+# BRIEF: Rename rc/ branch back to dev/ when PR is closed without merge
+
+name: "RC Revert"
+
+on:
+  pull_request:
+    types: [closed]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  revert:
+    name: Rename rc/ back to dev/
+    runs-on: ubuntu-latest
+    if: >-
+      github.event.pull_request.merged == false &&
+      startsWith(github.event.pull_request.head.ref, 'rc/')
+
+    steps:
+      - name: Rename branch
+        run: |
+          BRANCH="${{ github.event.pull_request.head.ref }}"
+          SUFFIX="${BRANCH#rc/}"
+          DEV_BRANCH="dev/${SUFFIX}"
+          API="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}/api/v1/repos/${{ github.repository }}/branches"
+          TOKEN="${{ secrets.MOKOGITEA_TOKEN }}"
+
+          # Create dev/ branch from rc/ branch
+          STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X POST \
+            -H "Authorization: token ${TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"new_branch_name\": \"${DEV_BRANCH}\", \"old_branch_name\": \"${BRANCH}\"}" \
+            "${API}" 2>/dev/null || true)
+
+          if [ "$STATUS" = "201" ]; then
+            echo "Created branch: ${DEV_BRANCH}" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "::error::Failed to create ${DEV_BRANCH} from ${BRANCH} (HTTP ${STATUS})"
+            exit 1
+          fi
+
+          # Delete rc/ branch
+          ENCODED=$(php -r "echo rawurlencode('${BRANCH}');")
+          STATUS=$(curl -sf -o /dev/null -w "%{http_code}" -X DELETE \
+            -H "Authorization: token ${TOKEN}" \
+            "${API}/${ENCODED}" 2>/dev/null || true)
+
+          if [ "$STATUS" = "204" ]; then
+            echo "Deleted branch: ${BRANCH}" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "::warning::Failed to delete ${BRANCH} (HTTP ${STATUS})"
+          fi
+
+          echo "### RC Reverted" >> $GITHUB_STEP_SUMMARY
+          echo "${BRANCH} → ${DEV_BRANCH}" >> $GITHUB_STEP_SUMMARY

package/.mokogitea/workflows/repo-health.yml

@@ -7,8 +7,8 @@
 #
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
-# INGROUP: moko-platform.Validation
-# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/moko-platform
+# INGROUP: mokocli.Validation
+# REPO: https://git.mokoconsulting.tech/mokoconsulting-tech/mokocli
 # PATH: /templates/workflows/joomla/repo_health.yml.template
 # VERSION: 09.23.00
 # BRIEF: Enforces repository guardrails by validating scripts governance, tooling availability, and core repository health artifacts.
@@ -33,7 +33,8 @@ on:
           - scripts
           - repo
   pull_request:
-  push:
+    branches:
+      - main
 
 permissions:
   contents: read

package/.mokogitea/workflows/workflow-sync-trigger.yml

@@ -0,0 +1,73 @@
+# Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# FILE INFORMATION
+# DEFGROUP: Gitea.Workflow
+# INGROUP: MokoPlatform.Universal
+# REPO: https://git.mokoconsulting.tech/MokoConsulting/mokoplatform
+# 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
+
+name: "Universal: Workflow Sync Trigger"
+
+on:
+  pull_request:
+    types: [closed]
+    branches:
+      - main
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  sync:
+    name: Sync workflows to live repos
+    runs-on: ubuntu-latest
+    if: >-
+      github.event.pull_request.merged == true &&
+      !contains(github.event.pull_request.title, '[skip sync]')
+
+    steps:
+      - name: Determine platform from repo name
+        id: platform
+        run: |
+          REPO="${{ github.event.repository.name }}"
+          case "$REPO" in
+            Template-Joomla)   PLATFORM="joomla" ;;
+            Template-Dolibarr) PLATFORM="dolibarr" ;;
+            Template-Go)       PLATFORM="go" ;;
+            Template-MCP)      PLATFORM="mcp" ;;
+            Template-Generic)  PLATFORM="" ;;
+            *)                 PLATFORM="" ;;
+          esac
+          echo "platform=$PLATFORM" >> "$GITHUB_OUTPUT"
+          echo "Platform: ${PLATFORM:-all}"
+
+      - name: Clone mokoplatform
+        env:
+          MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+        run: |
+          GITEA_URL="${{ vars.GITEA_URL || 'https://git.mokoconsulting.tech' }}"
+          git clone --depth 1 "${GITEA_URL}/MokoConsulting/mokoplatform.git" /tmp/mokoplatform
+
+      - name: Install dependencies
+        run: |
+          cd /tmp/mokoplatform
+          composer install --no-dev --no-interaction --quiet 2>/dev/null || true
+
+      - name: Run workflow sync
+        env:
+          MOKOGITEA_TOKEN: ${{ secrets.MOKOGITEA_TOKEN }}
+        run: |
+          ARGS="--token ${MOKOGITEA_TOKEN}"
+          ARGS="${ARGS} --org ${{ vars.GITEA_ORG || github.repository_owner }}"
+          ARGS="${ARGS} --phase repos"
+
+          PLATFORM="${{ steps.platform.outputs.platform }}"
+          if [ -n "$PLATFORM" ]; then
+            ARGS="${ARGS} --platform-filter ${PLATFORM}"
+          fi
+
+          php /tmp/mokoplatform/cli/workflow_sync.php ${ARGS}

package/dist/client.js

@@ -42,7 +42,26 @@ export class GiteaClient {
         return this.request(this.buildUrl(endpoint), 'PUT', body);
     }
     async delete(endpoint, body) {
-        return this.request(this.buildUrl(endpoint), 'DELETE', body);
+        if (body === undefined) {
+            return this.request(this.buildUrl(endpoint), 'DELETE');
+        }
+        // Use fetch for DELETE+body — node:https drops the body on some
+        // proxy/TLS configurations, causing the server to see an empty request.
+        const url = this.buildUrl(endpoint);
+        const resp = await fetch(url, {
+            method: 'DELETE',
+            headers: { ...this.headers },
+            body: JSON.stringify(body),
+        });
+        const raw = await resp.text();
+        let data;
+        try {
+            data = JSON.parse(raw);
+        }
+        catch {
+            data = raw;
+        }
+        return { status: resp.status, data };
     }
     buildUrl(endpoint, params) {
         const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;

package/dist/index.js

@@ -1114,14 +1114,22 @@ server.tool('gitea_metadata_update', 'Update repo metadata settings (merges with
     repo: z.string().describe('Repository name'),
     name: z.string().optional().describe('Project name'),
     org: z.string().optional().describe('Organization'),
+    description: z.string().optional().describe('Project description'),
     version: z.string().optional().describe('Version string (e.g. 06.00.00)'),
     version_prefix: z.string().optional().describe('Tag prefix for version display (e.g. v1.26.1-moko.)'),
     license_spdx: z.string().optional().describe('SPDX license identifier'),
+    license_name: z.string().optional().describe('Human-readable license name (e.g. GNU General Public License v3)'),
+    element_name: z.string().optional().describe('Extension element name (e.g. pkg_mokosuitecrm, mod_mokojoomhero)'),
     platform: z.string().optional().describe('Platform (joomla, wordpress, dolibarr, go, mcp, platform, generic)'),
+    standards_version: z.string().optional().describe('mokoplatform standards version (e.g. 05.01.00)'),
+    standards_source: z.string().optional().describe('URL to standards repo'),
+    maintainer: z.string().optional().describe('Maintainer name (e.g. Moko Consulting)'),
+    maintainer_url: z.string().optional().describe('Maintainer website URL'),
     info_url: z.string().optional().describe('Extension info/product page URL'),
-    target_version: z.string().optional().describe('Target platform version regex (e.g. (5|6)\\.*)'),
+    target_version: z.string().optional().describe('Target platform version regex (e.g. 6..*)'),
     php_minimum: z.string().optional().describe('Minimum PHP version (e.g. 8.1)'),
-    package_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
+    language: z.string().optional().describe('Primary language (e.g. PHP, Go, TypeScript)'),
+    extension_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
     entry_point: z.string().optional().describe('Build entry point path'),
     ...ConnectionParam,
 }, async ({ owner, repo, connection, ...fields }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mokoconsulting/mcp-mokogitea-api",
-	"version": "1.4.0",
+	"version": "1.4.2",
 	"description": "MCP server for Gitea REST API v1 operations",
 	"type": "module",
 	"main": "dist/index.js",

package/src/client.ts

@@ -52,7 +52,21 @@ export class GiteaClient {
 	}
 
 	async delete(endpoint: string, body?: unknown): Promise<ApiResponse> {
-		return this.request(this.buildUrl(endpoint), 'DELETE', body);
+		if (body === undefined) {
+			return this.request(this.buildUrl(endpoint), 'DELETE');
+		}
+		// Use fetch for DELETE+body — node:https drops the body on some
+		// proxy/TLS configurations, causing the server to see an empty request.
+		const url = this.buildUrl(endpoint);
+		const resp = await fetch(url, {
+			method: 'DELETE',
+			headers: { ...this.headers },
+			body: JSON.stringify(body),
+		});
+		const raw = await resp.text();
+		let data: unknown;
+		try { data = JSON.parse(raw); } catch { data = raw; }
+		return { status: resp.status, data };
 	}
 
 	private buildUrl(endpoint: string, params?: Record<string, string>): string {

package/src/index.ts

@@ -1720,14 +1720,22 @@ server.tool(
 		repo: z.string().describe('Repository name'),
 		name: z.string().optional().describe('Project name'),
 		org: z.string().optional().describe('Organization'),
+		description: z.string().optional().describe('Project description'),
 		version: z.string().optional().describe('Version string (e.g. 06.00.00)'),
 		version_prefix: z.string().optional().describe('Tag prefix for version display (e.g. v1.26.1-moko.)'),
 		license_spdx: z.string().optional().describe('SPDX license identifier'),
+		license_name: z.string().optional().describe('Human-readable license name (e.g. GNU General Public License v3)'),
+		element_name: z.string().optional().describe('Extension element name (e.g. pkg_mokosuitecrm, mod_mokojoomhero)'),
 		platform: z.string().optional().describe('Platform (joomla, wordpress, dolibarr, go, mcp, platform, generic)'),
+		standards_version: z.string().optional().describe('mokoplatform standards version (e.g. 05.01.00)'),
+		standards_source: z.string().optional().describe('URL to standards repo'),
+		maintainer: z.string().optional().describe('Maintainer name (e.g. Moko Consulting)'),
+		maintainer_url: z.string().optional().describe('Maintainer website URL'),
 		info_url: z.string().optional().describe('Extension info/product page URL'),
-		target_version: z.string().optional().describe('Target platform version regex (e.g. (5|6)\\.*)'),
+		target_version: z.string().optional().describe('Target platform version regex (e.g. 6..*)'),
 		php_minimum: z.string().optional().describe('Minimum PHP version (e.g. 8.1)'),
-		package_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
+		language: z.string().optional().describe('Primary language (e.g. PHP, Go, TypeScript)'),
+		extension_type: z.string().optional().describe('Extension type (component, module, plugin, package, template, library, file)'),
 		entry_point: z.string().optional().describe('Build entry point path'),
 		...ConnectionParam,
 	},

package/.mokogitea/manifest.xml

@@ -1,25 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-  MokoStandards Repository Manifest
-  Auto-generated by cleanup script.
-  See: https://git.mokoconsulting.tech/MokoConsulting/moko-platform/wiki/Home
--->
-<moko-platform xmlns="https://standards.mokoconsulting.tech/moko-platform/1.0" schema-version="1.0">
-  <identity>
-    <name>gitea-api-mcp</name>
-    <org>MokoConsulting</org>
-    <description>MCP server for Gitea REST API v1 operations — 61 tools for repos, issues, PRs, releases, branches, actions, orgs, wiki, webhooks, and more</description>
-    <license spdx="GPL-3.0-or-later">GNU General Public License v3</license>
-  </identity>
-  <governance>
-    <platform>nodejs</platform>
-    <standards-version>04.07.00</standards-version>
-    <standards-source>https://git.mokoconsulting.tech/MokoConsulting/moko-platform</standards-source>
-    <last-synced>2026-05-10T19:51:11+00:00</last-synced>
-  </governance>
-  <build>
-    <language>TypeScript</language>
-    <package-type>mcp-server</package-type>
-    <entry-point>src/</entry-point>
-  </build>
-</moko-platform>

package/Dockerfile

@@ -1,18 +0,0 @@
-FROM node:20-alpine
-
-WORKDIR /app
-
-COPY package.json package-lock.json ./
-RUN npm ci --production=false
-
-COPY tsconfig.json ./
-COPY src/ ./src/
-RUN npx tsc && npm prune --production
-
-EXPOSE 3100
-
-ENV PORT=3100
-ENV NODE_ENV=production
-
-# SSE mode by default for Docker deployments
-CMD ["node", "dist/sse.js"]

package/dist/server.d.ts

@@ -1,4 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { GiteaConfig } from './types.js';
-export declare function createMcpServer(cfg: GiteaConfig): McpServer;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.js

@@ -1,12 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// Creates a configured MCP server instance for use by both stdio and SSE transports.
-// Import index.ts to register all tools on its exported `server` singleton,
-// then re-export a factory that initializes config and returns the server.
-import { server, initConfig } from './index.js';
-export function createMcpServer(cfg) {
-    initConfig(cfg);
-    return server;
-}
-//# sourceMappingURL=server.js.map

package/dist/sse.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=sse.d.ts.map

package/dist/sse.js

@@ -1,87 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// SSE transport entry point for MokoGitea MCP server.
-// Run with: node dist/sse.js
-// Or: GITEA_URL=https://gitea.example.com GITEA_TOKEN=xxx node dist/sse.js
-//
-// Listens on PORT (default 3100) and serves SSE at /sse with POST at /message.
-import { createServer } from 'node:http';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { createMcpServer } from './server.js';
-import { loadConfig } from './config.js';
-const PORT = parseInt(process.env.PORT ?? '3100', 10);
-async function main() {
-    const config = await loadConfig();
-    const transports = new Map();
-    const httpServer = createServer(async (req, res) => {
-        // CORS headers for browser clients
-        res.setHeader('Access-Control-Allow-Origin', '*');
-        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-        if (req.method === 'OPTIONS') {
-            res.writeHead(204);
-            res.end();
-            return;
-        }
-        // Health check
-        if (req.url === '/health') {
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ status: 'ok', tools: 120 }));
-            return;
-        }
-        // SSE endpoint - client connects here
-        if (req.url === '/sse' && req.method === 'GET') {
-            const transport = new SSEServerTransport('/message', res);
-            const sessionId = transport.sessionId;
-            transports.set(sessionId, transport);
-            const server = createMcpServer(config);
-            await server.connect(transport);
-            req.on('close', () => {
-                transports.delete(sessionId);
-            });
-            return;
-        }
-        // Message endpoint - client sends tool calls here
-        if (req.url?.startsWith('/message') && req.method === 'POST') {
-            const url = new URL(req.url, `http://${req.headers.host}`);
-            const sessionId = url.searchParams.get('sessionId');
-            if (!sessionId || !transports.has(sessionId)) {
-                res.writeHead(400, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify({ error: 'Invalid or missing sessionId' }));
-                return;
-            }
-            const transport = transports.get(sessionId);
-            await transport.handlePostMessage(req, res);
-            return;
-        }
-        // Root - info page
-        if (req.url === '/' || req.url === '') {
-            res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({
-                name: '@mokoconsulting/mokogitea-mcp',
-                version: '1.1.0',
-                description: 'MCP server for Gitea and MokoGitea - 120+ tools',
-                endpoints: {
-                    sse: '/sse',
-                    message: '/message',
-                    health: '/health',
-                },
-                docs: 'https://git.mokoconsulting.tech/MokoConsulting/mcp_mokogitea_api',
-            }));
-            return;
-        }
-        res.writeHead(404);
-        res.end('Not found');
-    });
-    httpServer.listen(PORT, () => {
-        process.stderr.write(`MokoGitea MCP SSE server listening on port ${PORT}\n`);
-        process.stderr.write(`  SSE: http://localhost:${PORT}/sse\n`);
-        process.stderr.write(`  Health: http://localhost:${PORT}/health\n`);
-    });
-}
-main().catch((err) => {
-    process.stderr.write(`Fatal: ${err}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=sse.js.map

package/src/server.ts

@@ -1,16 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// Creates a configured MCP server instance for use by both stdio and SSE transports.
-
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { GiteaConfig } from './types.js';
-
-// Import index.ts to register all tools on its exported `server` singleton,
-// then re-export a factory that initializes config and returns the server.
-import { server, initConfig } from './index.js';
-
-export function createMcpServer(cfg: GiteaConfig): McpServer {
-	initConfig(cfg);
-	return server;
-}

package/src/sse.ts

@@ -1,100 +0,0 @@
-// Copyright 2026 Moko Consulting <hello@mokoconsulting.tech>
-// SPDX-License-Identifier: GPL-3.0-or-later
-//
-// SSE transport entry point for MokoGitea MCP server.
-// Run with: node dist/sse.js
-// Or: GITEA_URL=https://gitea.example.com GITEA_TOKEN=xxx node dist/sse.js
-//
-// Listens on PORT (default 3100) and serves SSE at /sse with POST at /message.
-
-import { createServer } from 'node:http';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { createMcpServer } from './server.js';
-import { loadConfig } from './config.js';
-
-const PORT = parseInt(process.env.PORT ?? '3100', 10);
-
-async function main(): Promise<void> {
-	const config = await loadConfig();
-	const transports = new Map<string, SSEServerTransport>();
-
-	const httpServer = createServer(async (req, res) => {
-		// CORS headers for browser clients
-		res.setHeader('Access-Control-Allow-Origin', '*');
-		res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
-		res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-
-		if (req.method === 'OPTIONS') {
-			res.writeHead(204);
-			res.end();
-			return;
-		}
-
-		// Health check
-		if (req.url === '/health') {
-			res.writeHead(200, { 'Content-Type': 'application/json' });
-			res.end(JSON.stringify({ status: 'ok', tools: 120 }));
-			return;
-		}
-
-		// SSE endpoint - client connects here
-		if (req.url === '/sse' && req.method === 'GET') {
-			const transport = new SSEServerTransport('/message', res);
-			const sessionId = transport.sessionId;
-			transports.set(sessionId, transport);
-
-			const server = createMcpServer(config);
-			await server.connect(transport);
-
-			req.on('close', () => {
-				transports.delete(sessionId);
-			});
-			return;
-		}
-
-		// Message endpoint - client sends tool calls here
-		if (req.url?.startsWith('/message') && req.method === 'POST') {
-			const url = new URL(req.url, `http://${req.headers.host}`);
-			const sessionId = url.searchParams.get('sessionId');
-			if (!sessionId || !transports.has(sessionId)) {
-				res.writeHead(400, { 'Content-Type': 'application/json' });
-				res.end(JSON.stringify({ error: 'Invalid or missing sessionId' }));
-				return;
-			}
-			const transport = transports.get(sessionId)!;
-			await transport.handlePostMessage(req, res);
-			return;
-		}
-
-		// Root - info page
-		if (req.url === '/' || req.url === '') {
-			res.writeHead(200, { 'Content-Type': 'application/json' });
-			res.end(JSON.stringify({
-				name: '@mokoconsulting/mokogitea-mcp',
-				version: '1.1.0',
-				description: 'MCP server for Gitea and MokoGitea - 120+ tools',
-				endpoints: {
-					sse: '/sse',
-					message: '/message',
-					health: '/health',
-				},
-				docs: 'https://git.mokoconsulting.tech/MokoConsulting/mcp_mokogitea_api',
-			}));
-			return;
-		}
-
-		res.writeHead(404);
-		res.end('Not found');
-	});
-
-	httpServer.listen(PORT, () => {
-		process.stderr.write(`MokoGitea MCP SSE server listening on port ${PORT}\n`);
-		process.stderr.write(`  SSE: http://localhost:${PORT}/sse\n`);
-		process.stderr.write(`  Health: http://localhost:${PORT}/health\n`);
-	});
-}
-
-main().catch((err) => {
-	process.stderr.write(`Fatal: ${err}\n`);
-	process.exit(1);
-});