@remogram/mcp 0.1.0-beta.1 → 0.1.0-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remogram/mcp",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.10",
   "description": "Remogram MCP server delegating to CLI",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.0",
-    "@remogram/cli": "0.1.0-beta.1",
+    "@remogram/cli": "0.1.0-beta.10",
     "zod": "^3.25.76"
   }
 }

package/register-tools.mjs

@@ -1,13 +1,28 @@
 import { z } from 'zod';
+import { normalizeAllowedPaths } from '@remogram/core';
 import { runRemogramCli, packetToMcpContent } from './run-cli.mjs';
 
+/** @internal Build CLI argv for merge_plan MCP tool (exported for transport tests). */
+export function mergePlanMcpCliArgs(input) {
+  const a = ['merge', 'plan', '--number', String(input.number)];
+  for (const glob of normalizeAllowedPaths(input.allowed_paths ?? []) ?? []) {
+    a.push('--allowed-path', glob);
+  }
+  return a;
+}
+
 export function registerTools(server) {
   const tools = [
     {
       name: 'doctor',
       description: 'Read-only provider readiness diagnostics for config, remote trust, auth, capabilities, and checks.',
-      inputSchema: z.object({}),
-      args: ['doctor'],
+      inputSchema: z.object({
+        live: z
+          .boolean()
+          .optional()
+          .describe('When true, perform a bounded live forge API reachability probe'),
+      }),
+      args: (input) => (input.live ? ['doctor', '--live'] : ['doctor']),
     },
     {
       name: 'provider_capabilities',
@@ -30,6 +45,108 @@ export function registerTools(server) {
       }),
       args: (input) => ['refs', 'compare', '--base', input.base, '--head', input.head],
     },
+    {
+      name: 'ref_inventory',
+      description: 'List repository refs with SHAs, default branch hint, and optional ancestry hints.',
+      inputSchema: z.object({}),
+      args: ['refs', 'inventory'],
+    },
+    {
+      name: 'cr_inventory',
+      description: 'Aggregate open change requests with checks and merge-plan facts into a semantic-diff slice.',
+      inputSchema: z.object({
+        slice_ref: z.string().optional().describe('Optional slice ref label for consumers'),
+        limit: z.number().int().positive().optional().describe('Max open CR entries (default 3)'),
+        sort: z
+          .enum(['number_asc', 'number_desc', 'recent_update', 'recent_created'])
+          .optional()
+          .describe('Open-list slice sort preset (default number_asc)'),
+        cursor: z.string().optional().describe('Opaque cursor from prior cr_inventory next_cursor'),
+      }),
+      args: (input) => {
+        const a = ['cr', 'inventory'];
+        if (input.slice_ref) a.push('--slice-ref', input.slice_ref);
+        if (input.limit != null) a.push('--limit', String(input.limit));
+        if (input.sort) a.push('--sort', input.sort);
+        if (input.cursor) a.push('--cursor', input.cursor);
+        return a;
+      },
+    },
+    {
+      name: 'cr_open',
+      description: 'Open a change request (pull request) on the configured forge.',
+      inputSchema: z.object({
+        head: z.string().describe('Head branch ref'),
+        base: z.string().describe('Base branch ref'),
+        title: z.string().describe('Change request title'),
+        body: z.string().optional().describe('Optional change request body'),
+        idempotency_key: z
+          .string()
+          .optional()
+          .describe('Optional agent idempotency key for retry-safe writes'),
+      }),
+      args: (input) => {
+        const a = ['cr', 'open', '--head', input.head, '--base', input.base, '--title', input.title];
+        if (input.body) a.push('--body', input.body);
+        if (input.idempotency_key) a.push('--idempotency-key', input.idempotency_key);
+        return a;
+      },
+      readOnlyHint: false,
+      destructiveHint: true,
+    },
+    {
+      name: 'status_set',
+      description: 'Set a commit status (check context) on the configured forge.',
+      inputSchema: z.object({
+        sha: z.string().describe('40-character commit SHA'),
+        context: z.string().describe('Status context name'),
+        state: z.enum(['pending', 'success', 'failure', 'error']).describe('Status state'),
+        target_url: z.string().optional().describe('Optional target URL for the status'),
+        description: z.string().optional().describe('Optional status description'),
+        idempotency_key: z
+          .string()
+          .optional()
+          .describe('Optional agent idempotency key for retry-safe writes'),
+      }),
+      args: (input) => {
+        const a = [
+          'status',
+          'set',
+          '--sha',
+          input.sha,
+          '--context',
+          input.context,
+          '--state',
+          input.state,
+        ];
+        if (input.target_url) a.push('--target-url', input.target_url);
+        if (input.description) a.push('--description', input.description);
+        if (input.idempotency_key) a.push('--idempotency-key', input.idempotency_key);
+        return a;
+      },
+      readOnlyHint: false,
+      destructiveHint: true,
+    },
+    {
+      name: 'issue_open',
+      description: 'Open a forge issue on the configured repository (Gitea v1).',
+      inputSchema: z.object({
+        title: z.string().describe('Issue title'),
+        body: z.string().optional().describe('Optional issue body'),
+        idempotency_key: z
+          .string()
+          .optional()
+          .describe('Optional agent idempotency key for retry-safe writes'),
+      }),
+      args: (input) => {
+        const a = ['issue', 'open', '--title', input.title];
+        if (input.body) a.push('--body', input.body);
+        if (input.idempotency_key) a.push('--idempotency-key', input.idempotency_key);
+        return a;
+      },
+      readOnlyHint: false,
+      destructiveHint: true,
+    },
     {
       name: 'pr_status',
       description: 'PR metadata and mergeability facts.',
@@ -60,10 +177,85 @@ export function registerTools(server) {
     {
       name: 'merge_plan',
       description: 'Merge readiness facts: mergeability, checks, blockers.',
+      inputSchema: z.object({
+        number: z.number().int().positive(),
+        allowed_paths: z.array(z.string()).optional(),
+      }),
+      args: mergePlanMcpCliArgs,
+    },
+    {
+      name: 'whoami',
+      description: 'Authenticated forge identity facts (login, can_write, token scope/expiry signals).',
+      inputSchema: z.object({}),
+      args: ['whoami'],
+    },
+    {
+      name: 'branch_protection',
+      description:
+        'Branch protection policy facts: required status contexts, protected rules, approvals signal.',
+      inputSchema: z.object({
+        branch_ref: z.string(),
+      }),
+      args: (input) => ['branch', 'protection', '--branch-ref', input.branch_ref],
+    },
+    {
+      name: 'cr_files',
+      description: 'Changed file paths for a change request (bounded, truncation-aware).',
+      inputSchema: z.object({
+        number: z.number().int().positive(),
+      }),
+      args: (input) => ['cr', 'files', '--number', String(input.number)],
+    },
+    {
+      name: 'cr_comments',
+      description: 'Review comments for a change request (sanitized bodies, truncation-aware).',
       inputSchema: z.object({
         number: z.number().int().positive(),
       }),
-      args: (input) => ['merge', 'plan', '--number', String(input.number)],
+      args: (input) => ['cr', 'comments', '--number', String(input.number)],
+    },
+    {
+      name: 'forge_changes',
+      description:
+        'Forge activity events since an observed_at boundary (PR lifecycle, head SHA moves, check conclusions).',
+      inputSchema: z.object({
+        since: z.string().optional().describe('ISO-8601 observed_at boundary (required on first page)'),
+        cursor: z.string().optional().describe('Opaque cursor from prior forge_changes next_cursor'),
+        limit: z.number().int().positive().optional().describe('Events per page (default 64)'),
+      }),
+      args: (input) => {
+        const a = ['forge', 'changes'];
+        if (input.since) a.push('--since', input.since);
+        if (input.cursor) a.push('--cursor', input.cursor);
+        if (input.limit != null) a.push('--limit', String(input.limit));
+        return a;
+      },
+    },
+    {
+      name: 'merge_execute',
+      description: 'Execute a forge merge for an open change request after SHA-bound preflight.',
+      inputSchema: z.object({
+        number: z.number().int().positive(),
+        expected_base_sha: z.string().describe('Expected base SHA (40 hex chars)'),
+        expected_head_sha: z.string().describe('Expected head SHA (40 hex chars)'),
+        method: z.enum(['merge']).optional().describe('Merge method (v1: merge only)'),
+      }),
+      args: (input) => {
+        const a = [
+          'merge',
+          'execute',
+          '--number',
+          String(input.number),
+          '--expected-base-sha',
+          input.expected_base_sha,
+          '--expected-head-sha',
+          input.expected_head_sha,
+        ];
+        if (input.method) a.push('--method', input.method);
+        return a;
+      },
+      readOnlyHint: false,
+      destructiveHint: true,
     },
     {
       name: 'sync_plan',
@@ -85,7 +277,10 @@ export function registerTools(server) {
       {
         description: tool.description,
         inputSchema: tool.inputSchema,
-        annotations: { readOnlyHint: true, destructiveHint: false },
+        annotations: {
+          readOnlyHint: tool.readOnlyHint !== false,
+          destructiveHint: tool.destructiveHint === true,
+        },
       },
       async (input) => {
         const args = typeof tool.args === 'function' ? tool.args(input) : tool.args;