@orboto/mcp 0.209.1 → 0.210.1

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/dist/tools/knowledge.js

@@ -1,6 +1,7 @@
 /** ORB-2225 - the wiki as the agents' knowledge base: ask it first, file durable facts in it. */
 import { z } from 'zod';
 import { mcpInstanceToken } from './shared.js';
+import { droppedLines } from './wiki.js';
 export const knowledgeAskToolConfig = {
     title: 'Ask the wiki',
     description: 'Ask your session\'s project wikis and the Operations wiki before asking a person; cite docs by key.',
@@ -30,6 +31,6 @@ export const knowledgeAddToolConfig = {
 export function makeKnowledgeAddHandler(client) {
     return async (input, extra) => {
         const res = await client.post('/knowledge/add', input, { instanceToken: mcpInstanceToken(undefined, extra) });
-        return { content: [{ type: 'text', text: res.text }], structuredContent: res };
+        return { content: [{ type: 'text', text: `${res.text}${droppedLines(res.droppedOps ?? [])}` }], structuredContent: res };
     };
 }

package/dist/tools/knowledge.test.js

@@ -26,6 +26,14 @@ describe('ORB-2225 orboto_knowledge_ask and orboto_knowledge_add', () => {
         expect(textOf(result)).toContain('ACME-D7');
         expect(result.structuredContent).toMatchObject({ action: 'recorded' });
     });
+    it('files a fact and lists the ops the wiki agent dropped, as wiki record does', async () => {
+        const droppedOps = [{ title: 'Runner', target: 'ACME-D99', reason: 'unknown_target' }];
+        const post = vi.fn().mockResolvedValue({ action: 'recorded', text: 'Recorded in the ACME-S1 wiki: ACME-D7 "Build host". Cite it by key.', pages: [], source: null, droppedOps });
+        const result = await makeKnowledgeAddHandler({ post })({ title: 'Build host', content: 'build.example.org', projectKey: 'ACME' });
+        expect(textOf(result)).toContain('Ops dropped: 1');
+        expect(textOf(result)).toContain('- Runner (target ACME-D99): unknown_target');
+        expect(result.structuredContent).toMatchObject({ droppedOps });
+    });
     it('both tools carry a title and annotations; ask is read-only, add is not', () => {
         expect(knowledgeAskToolConfig.title).toBeTruthy();
         expect(knowledgeAskToolConfig.annotations.readOnlyHint).toBe(true);
@@ -71,4 +79,9 @@ describe('ORB-2225 orboto_wiki_runs', () => {
         expect(textOf(await handler({ spaceId: 'ACME-S1', action: 'retry', runId: '11111111-0000-4000-8000-000000000000' }))).toContain('ran again: applied');
         expect(post).toHaveBeenCalledWith('/spaces/ACME-S1/llm-wiki/ingest-runs/11111111-0000-4000-8000-000000000000/retry', {});
     });
+    it('ORB-2226 - a run that left planner ops out says how many', async () => {
+        const get = vi.fn().mockResolvedValue({ runs: [{ id: 'r2', sourceKey: 'ACME-D10', sourceTitle: 'Deploy notes', status: 'applied', error: null, droppedOps: [{ title: 'Deploy', target: 'ACME-D99', reason: 'unknown_target' }], createdAt: '2026-09-27T09:00:00Z' }] });
+        const handler = makeWikiRunsHandler({ get, post: vi.fn() });
+        expect(textOf(await handler({ spaceId: 'ACME-S1' }))).toContain('r2 applied ACME-D10 "Deploy notes" 2026-09-27T09:00:00Z (ops dropped: 1)');
+    });
 });

package/dist/tools/wiki.js

@@ -69,9 +69,15 @@ export function makeWikiLintHandler(client) {
         return text(`Lint complete: ${res.issues.length} open issue(s), ${res.resolved} auto-resolved.\n${lines.join('\n')}`, { issues: res.issues, detected: res.detected, resolved: res.resolved });
     };
 }
+/** ORB-2226 - planner ops whose target page matched no docId, doc key or title. */
+export function droppedLines(dropped) {
+    if (dropped.length === 0)
+        return '';
+    return `\nOps dropped: ${dropped.length}\n${dropped.map((d) => `- ${d.title}${d.target ? ` (target ${d.target})` : ''}: ${d.reason}`).join('\n')}`;
+}
 export const wikiPlanUpdateToolConfig = {
     title: 'Plan a wiki edit (dry-run, no writes)',
-    description: 'Turn a natural-language instruction into page operations (create/patch/append) WITHOUT writing anything. Returns a planId valid for 15 minutes plus the proposed ops. Review the ops, then call orboto_wiki_apply_plan to commit. Wraps POST /spaces/:id/docs/plan-update.',
+    description: 'Turn a natural-language instruction into page operations (create/patch/append) WITHOUT writing anything. Returns a planId valid for 15 minutes plus the proposed ops, and droppedOps: ops whose target page matched no docId, doc key or title. Review the ops, then call orboto_wiki_apply_plan to commit. Wraps POST /spaces/:id/docs/plan-update.',
     inputSchema: z.object({
         spaceId: z.string().uuid().describe('The wiki space to edit.'),
         instruction: z.string().min(1).max(4000).describe('What to change, in plain language.'),
@@ -86,7 +92,8 @@ export function makeWikiPlanUpdateHandler(client) {
             body.sourceDocId = input.sourceDocId;
         const res = await client.post(`/spaces/${input.spaceId}/docs/plan-update`, body);
         const ops = res.ops.map((o, i) => `${i + 1}. ${o.op} ${o.title ?? ''} - ${o.summary}`).join('\n');
-        return text(`Plan ${res.planId} (expires ${res.expiresAt}):\n${ops}\n\nApply with orboto_wiki_apply_plan(planId).`, { planId: res.planId, ops: res.ops, expiresAt: res.expiresAt });
+        const droppedOps = res.droppedOps ?? [];
+        return text(`Plan ${res.planId} (expires ${res.expiresAt}):\n${ops}${droppedLines(droppedOps)}\n\nApply with orboto_wiki_apply_plan(planId).`, { planId: res.planId, ops: res.ops, droppedOps, expiresAt: res.expiresAt });
     };
 }
 export const wikiApplyPlanToolConfig = {
@@ -121,7 +128,8 @@ export function makeWikiRecordHandler(client) {
             planBody.sourceDocId = input.sourceDocId;
         const plan = await client.post(`/spaces/${input.spaceId}/docs/plan-update`, planBody);
         const applied = await client.post(`/spaces/${input.spaceId}/docs/apply-plan`, { planId: plan.planId });
-        return text(`Recorded: ${applied.touchedDocs.length} page(s) updated.`, { planId: plan.planId, touchedDocs: applied.touchedDocs });
+        const droppedOps = plan.droppedOps ?? [];
+        return text(`Recorded: ${applied.touchedDocs.length} page(s) updated.${droppedLines(droppedOps)}`, { planId: plan.planId, touchedDocs: applied.touchedDocs, droppedOps });
     };
 }
 export const wikiAppendSectionToolConfig = {
@@ -196,7 +204,7 @@ export function makeWikiRunsHandler(client) {
         }
         const qs = input.status ? `?status=${input.status}` : '';
         const res = await client.get(`/spaces/${encodeURIComponent(input.spaceId)}/llm-wiki/ingest-runs${qs}`);
-        const lines = res.runs.map((r) => `- ${r.id} ${r.status} ${r.sourceKey ?? ''} "${r.sourceTitle}" ${r.createdAt}${r.error ? ` - ${r.error}` : ''}`);
+        const lines = res.runs.map((r) => `- ${r.id} ${r.status} ${r.sourceKey ?? ''} "${r.sourceTitle}" ${r.createdAt}${r.droppedOps?.length ? ` (ops dropped: ${r.droppedOps.length})` : ''}${r.error ? ` - ${r.error}` : ''}`);
         return text(lines.length ? lines.join('\n') : 'No ingest runs.', res);
     };
 }

package/dist/tools/wiki.test.js

@@ -57,6 +57,13 @@ describe('orboto_wiki_plan_update + apply_plan', () => {
         expect(calls[0].url).toBe(`https://orboto.example.com/spaces/${SPACE}/docs/plan-update`);
         expect(res.content[0].text).toContain('Plan p1');
     });
+    it('ORB-2226 - plan-update names the ops the planner target could not be resolved for', async () => {
+        stubJSON([{ json: { planId: 'p1', ops: [], droppedOps: [{ title: 'Runbook', target: 'ghost page', reason: 'unknown_target' }], expiresAt: '2026-01-01T00:15:00Z' } }]);
+        const res = await makeWikiPlanUpdateHandler(client)({ spaceId: SPACE, instruction: 'update the runbook' });
+        const out = res.content[0].text;
+        expect(out).toContain('Ops dropped: 1');
+        expect(out).toContain('- Runbook (target ghost page): unknown_target');
+    });
     it('apply-plan reports touched docs', async () => {
         stubJSON([{ json: { touchedDocs: [DOC] } }]);
         const res = await makeWikiApplyPlanHandler(client)({ spaceId: SPACE, planId: 'p1' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orboto/mcp",
-  "version": "0.209.1",
+  "version": "0.210.1",
   "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",