@orboto/mcp 0.210.0 → 0.210.1

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.210.0",
+  "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",