@structured-world/gitlab-mcp 6.41.1 → 6.41.2

package/dist/src/cli/inject-tool-refs.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+interface JsonSchemaProperty {
+    type?: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    oneOf?: JsonSchemaProperty[];
+    enum?: unknown[];
+    const?: unknown;
+    description?: string;
+    [key: string]: unknown;
+}
+interface ActionInfo {
+    name: string;
+    description: string;
+}
+interface MarkerMatch {
+    toolName: string;
+    startIdx: number;
+    endIdx: number;
+}
+declare function extractActions(schema: JsonSchemaProperty): ActionInfo[];
+declare function generateActionsTable(actions: ActionInfo[]): string;
+declare function findMarkers(content: string): MarkerMatch[];
+declare function processFile(filePath: string, toolSchemas: Map<string, JsonSchemaProperty>, content?: string): boolean;
+export declare function main(): void;
+export { extractActions, generateActionsTable, findMarkers, processFile };
+export type { JsonSchemaProperty, ActionInfo, MarkerMatch };

package/dist/src/cli/inject-tool-refs.js

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+exports.extractActions = extractActions;
+exports.generateActionsTable = generateActionsTable;
+exports.findMarkers = findMarkers;
+exports.processFile = processFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const registry_manager_js_1 = require("../registry-manager.js");
+const ACTION_DESCRIPTIONS = {
+    list: "List items with filtering and pagination",
+    get: "Get a single item by ID",
+    create: "Create a new item",
+    update: "Update an existing item",
+    delete: "Delete an item",
+    search: "Search for items",
+    diffs: "Get file changes/diffs",
+    compare: "Compare two branches or commits",
+    merge: "Merge a merge request",
+    approve: "Approve a merge request",
+    unapprove: "Remove approval from a merge request",
+    cancel: "Cancel a running operation",
+    retry: "Retry a failed operation",
+    play: "Run a manual job",
+    publish: "Publish draft notes",
+    resolve: "Resolve a discussion thread",
+    disable: "Disable the integration",
+    test: "Test a webhook",
+};
+function extractActions(schema) {
+    const actions = [];
+    if (schema.oneOf && Array.isArray(schema.oneOf)) {
+        for (const branch of schema.oneOf) {
+            const actionProp = branch.properties?.action;
+            const actionName = actionProp?.const;
+            if (actionName) {
+                const description = actionProp?.description ??
+                    ACTION_DESCRIPTIONS[actionName] ??
+                    `Perform ${actionName} operation`;
+                actions.push({ name: actionName, description });
+            }
+        }
+        return actions;
+    }
+    const actionProp = schema.properties?.action;
+    if (actionProp?.enum && Array.isArray(actionProp.enum)) {
+        for (const actionName of actionProp.enum) {
+            if (typeof actionName === "string") {
+                const description = ACTION_DESCRIPTIONS[actionName] ?? `Perform ${actionName} operation`;
+                actions.push({ name: actionName, description });
+            }
+        }
+    }
+    return actions;
+}
+function generateActionsTable(actions) {
+    const lines = [];
+    lines.push("| Action | Description |");
+    lines.push("|--------|-------------|");
+    for (const action of actions) {
+        const desc = action.description.replace(/\\/g, "\\\\").replace(/\|/g, "\\|");
+        lines.push(`| \`${action.name}\` | ${desc} |`);
+    }
+    return lines.join("\n");
+}
+function findMarkers(content) {
+    const markers = [];
+    const startPattern = /<!-- @autogen:tool (\S+) -->/g;
+    const endPattern = "<!-- @autogen:end -->";
+    let match;
+    while ((match = startPattern.exec(content)) !== null) {
+        const toolName = match[1];
+        const startIdx = match.index;
+        const afterStart = startIdx + match[0].length;
+        const endIdx = content.indexOf(endPattern, afterStart);
+        if (endIdx === -1) {
+            throw new Error(`Missing <!-- @autogen:end --> for tool "${toolName}"`);
+        }
+        markers.push({
+            toolName,
+            startIdx,
+            endIdx: endIdx + endPattern.length,
+        });
+    }
+    return markers;
+}
+function processFile(filePath, toolSchemas, content) {
+    const fileContent = content ?? fs.readFileSync(filePath, "utf8");
+    const markers = findMarkers(fileContent);
+    if (markers.length === 0)
+        return false;
+    let result = fileContent;
+    for (let i = markers.length - 1; i >= 0; i--) {
+        const marker = markers[i];
+        const schema = toolSchemas.get(marker.toolName);
+        if (!schema) {
+            throw new Error(`Unknown tool "${marker.toolName}" in ${filePath}. ` +
+                `Available tools: ${Array.from(toolSchemas.keys()).sort().join(", ")}`);
+        }
+        const actions = extractActions(schema);
+        if (actions.length === 0) {
+            throw new Error(`Tool "${marker.toolName}" has no extractable actions in ${filePath}`);
+        }
+        const table = generateActionsTable(actions);
+        const startTag = `<!-- @autogen:tool ${marker.toolName} -->`;
+        const endTag = "<!-- @autogen:end -->";
+        const replacement = `${startTag}\n${table}\n${endTag}`;
+        result = result.slice(0, marker.startIdx) + replacement + result.slice(marker.endIdx);
+    }
+    if (result !== fileContent) {
+        fs.writeFileSync(filePath, result, "utf8");
+        return true;
+    }
+    return false;
+}
+function main() {
+    let projectRoot = process.cwd();
+    while (!fs.existsSync(path.join(projectRoot, "package.json"))) {
+        const parent = path.dirname(projectRoot);
+        if (parent === projectRoot)
+            break;
+        projectRoot = parent;
+    }
+    const docsToolsDir = path.join(projectRoot, "docs", "tools");
+    if (!fs.existsSync(docsToolsDir)) {
+        console.error(`Error: docs/tools/ directory not found at ${docsToolsDir}`);
+        process.exit(1);
+    }
+    const registryManager = registry_manager_js_1.RegistryManager.getInstance();
+    const allTools = registryManager.getAllToolDefinitionsUnfiltered();
+    const toolSchemas = new Map();
+    for (const tool of allTools) {
+        toolSchemas.set(tool.name, tool.inputSchema);
+    }
+    const mdFiles = fs
+        .readdirSync(docsToolsDir)
+        .filter(f => f.endsWith(".md"))
+        .map(f => path.join(docsToolsDir, f));
+    let modifiedCount = 0;
+    let markerCount = 0;
+    for (const filePath of mdFiles) {
+        const content = fs.readFileSync(filePath, "utf8");
+        const markers = findMarkers(content);
+        markerCount += markers.length;
+        if (markers.length > 0) {
+            const modified = processFile(filePath, toolSchemas, content);
+            if (modified) {
+                modifiedCount++;
+                const relPath = path.relative(projectRoot, filePath);
+                console.log(`  Updated: ${relPath} (${markers.length} marker(s))`);
+            }
+        }
+    }
+    console.log(`inject-tool-refs: ${markerCount} marker(s) in ${mdFiles.length} file(s), ${modifiedCount} updated.`);
+}
+if (process.env.NODE_ENV !== "test") {
+    main();
+}
+//# sourceMappingURL=inject-tool-refs.js.map

package/dist/src/cli/inject-tool-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-tool-refs.js","sourceRoot":"","sources":["../../../src/cli/inject-tool-refs.ts"],"names":[],"mappings":"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"}