@orboto/mcp 0.209.0 → 0.210.0

package/dist/server.js

@@ -74,6 +74,7 @@ import { primerFactListToolConfig, makePrimerFactListHandler, primerFactAddToolC
 import { whoamiToolConfig, makeWhoamiHandler } from './tools/identity.js';
 import { claimToolConfig, makeClaimHandler, unclaimToolConfig, makeUnclaimHandler, } from './tools/claim.js';
 import { reportFeedbackToolConfig, makeReportFeedbackHandler } from './tools/feedback.js';
+import { feedbackReplyToolConfig, makeFeedbackReplyHandler } from './tools/feedback-reply.js';
 import { listApprovalsToolConfig, makeListApprovalsHandler, approvalDecideToolConfig, makeApprovalDecideHandler, } from './tools/approvals.js';
 import { reviewFingerprintToolConfig, makeReviewFingerprintHandler, reviewPolicyCheckToolConfig, makeReviewPolicyCheckHandler, reviewApprovalRecordToolConfig, makeReviewApprovalRecordHandler, } from './tools/review-policy.js';
 import { createMilestoneToolConfig, makeCreateMilestoneHandler, closeMilestoneToolConfig, makeCloseMilestoneHandler, updateMilestoneToolConfig, makeUpdateMilestoneHandler, } from './tools/milestones.js';
@@ -339,6 +340,7 @@ export async function buildOrbotoMcpServer(opts) {
     reg('orboto_claim', claimToolConfig, makeClaimHandler(client));
     reg('orboto_unclaim', unclaimToolConfig, makeUnclaimHandler(client));
     reg('orboto_report_feedback', reportFeedbackToolConfig, makeReportFeedbackHandler(client));
+    reg('orboto_feedback_reply', feedbackReplyToolConfig, makeFeedbackReplyHandler(client));
     reg('orboto_list_approvals', listApprovalsToolConfig, makeListApprovalsHandler(client));
     reg('orboto_approval_decide', approvalDecideToolConfig, makeApprovalDecideHandler(client));
     reg('orboto_review_fingerprint', reviewFingerprintToolConfig, makeReviewFingerprintHandler(client));

package/dist/tool-docs.js

@@ -12,12 +12,20 @@ export const SUMMARY_MAX_CHARS = 220;
  * name the key inputs.
  */
 const SUMMARY_OVERRIDES = {
-    orboto_create_full_backup: 'Start a full-workspace backup job (all projects, users, config, attachments); returns the job id to poll via orboto_list_backups.',
+    orboto_create_full_backup: 'Start a full-workspace backup job; returns the job id to poll via orboto_list_backups.',
     orboto_get_ticket: 'Fetch one ticket by key or UUID with description, status, assignees, checklists and comments.',
-    orboto_requirements_spec: 'Generate a structured requirements spec for a project or milestone from its tickets (scope, actors, functional + non-functional requirements).',
+    orboto_requirements_spec: 'Generate a structured requirements spec for a project or milestone from its tickets.',
     orboto_update_doc_space: 'Update a doc space\'s name, description, icon, project binding or access mode (open/restricted) by space id.',
     orboto_search_docs: 'Full-text search over doc/wiki pages (query, optional space or project filter); returns matching pages with snippets.',
-    orboto_critical_path: 'Compute the dependency-based critical path for a project or milestone: the blocking chain of tickets that determines the earliest finish.',
+    orboto_critical_path: 'Compute the critical path (blocking dependency chain) for a project or milestone.',
+    /** ORB-2237 - shortened summaries that pay for `orboto_feedback_reply`; each tool's full text stays in `getToolDoc`. */
+    orboto_agent_broadcast: 'Fan-out a message to every agent in a workspace, project or topic scope.',
+    orboto_api_search: 'Discover REST API endpoints on demand - the escape hatch for any orboto endpoint.',
+    orboto_get_doc: 'Return a doc\'s content (Markdown) plus its backlinks.',
+    orboto_primer_fact_list: 'List structured project facts feeding the AI primer.',
+    orboto_bulk_move_tickets: 'Move every matching ticket to the same status category.',
+    orboto_resolve_doc_smart_links: 'Resolve doc/ticket/milestone/project smart-link references to their title + URL.',
+    orboto_admin_translation_revert: 'Restore the pre-translation title + description and clear the translation marker.',
 };
 /** Runtime registry: tool name -> full guidance text, captured at
  *  registration. Module-global on purpose - the HTTP transport builds one

package/dist/tools/feedback-reply.js

@@ -0,0 +1,23 @@
+/**
+ * ORB-2237 - `orboto_feedback_reply`: the operator's public reply to a
+ * tenant report, one step (POST /tickets/:id/feedback-reply).
+ */
+import { z } from 'zod';
+export const feedbackReplyToolConfig = {
+    title: 'Reply to feedback report',
+    description: 'Post the operator\'s public reply on a feedback ticket. Synced to the tenant. Refuses secrets.',
+    inputSchema: z.object({
+        ticketKey: z.string().min(1).max(64),
+        content: z.string().min(1).max(20_000),
+    }).shape,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
+};
+export function makeFeedbackReplyHandler(client) {
+    return async (args) => {
+        const res = await client.post(`/tickets/${encodeURIComponent(args.ticketKey)}/feedback-reply`, { content: args.content });
+        return {
+            content: [{ type: 'text', text: `Reply posted on ${args.ticketKey} (comment ${res.commentId}, ${res.repliedAt}).` }],
+            structuredContent: res,
+        };
+    };
+}

package/dist/tools/feedback-reply.test.js

@@ -0,0 +1,27 @@
+/**
+ * ORB-2237 - `orboto_feedback_reply` unit test.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { OrbotoClient } from '../orboto-client.js';
+import { makeFeedbackReplyHandler } from './feedback-reply.js';
+beforeEach(() => { vi.restoreAllMocks(); });
+afterEach(() => { vi.restoreAllMocks(); });
+const client = new OrbotoClient({ baseUrl: 'http://api.test', apiKey: 'orb_test' });
+describe('orboto_feedback_reply', () => {
+    it('posts the reply to the feedback-reply route and reports the comment id', async () => {
+        const calls = [];
+        vi.spyOn(globalThis, 'fetch').mockImplementation(async (url, init) => {
+            calls.push({ url: url.toString(), body: init?.body ? JSON.parse(init.body) : undefined });
+            return {
+                ok: true, status: 200, statusText: 'OK',
+                json: async () => ({ commentId: 'c-1', repliedAt: '2026-09-28T10:00:00.000Z' }),
+                text: async () => '',
+            };
+        });
+        const result = await makeFeedbackReplyHandler(client)({ ticketKey: 'FBK-1', content: 'Fixed in the next release.' });
+        expect(calls[0].url).toContain('/tickets/FBK-1/feedback-reply');
+        expect(calls[0].body).toEqual({ content: 'Fixed in the next release.' });
+        expect(result.structuredContent).toEqual({ commentId: 'c-1', repliedAt: '2026-09-28T10:00:00.000Z' });
+        expect(result.content[0]).toMatchObject({ type: 'text' });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orboto/mcp",
-  "version": "0.209.0",
+  "version": "0.210.0",
   "description": "Model Context Protocol server for orboto - exposes tickets, projects, milestones, time, docs, primer-facts, alerts and absences as MCP tools for Claude Desktop / Cursor / Copilot Chat / any MCP-aware AI client.",
   "license": "MIT",
   "type": "module",