@orboto/mcp 0.228.1 → 0.229.0

package/dist/tools/knowledge.test.js

@@ -92,4 +92,15 @@ describe('ORB-2225 orboto_wiki_runs', () => {
         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)');
     });
+    it('ORB-2611 - a queued run says how long it waits or runs and whether it stalled', async () => {
+        const get = vi.fn().mockResolvedValue({ runs: [
+                { id: 'r3', sourceKey: 'ACME-D11', sourceTitle: 'AGENTS.md study', status: 'queued', error: null, createdAt: '2026-10-20T15:53:33Z', startedAt: null, ageSeconds: 1260, stalled: true },
+                { id: 'r4', sourceKey: 'ACME-D12', sourceTitle: 'Context rules', status: 'queued', error: null, createdAt: '2026-10-20T15:53:33Z', queuedAt: '2026-10-20T15:53:33Z', startedAt: '2026-10-20T16:03:33Z', ageSeconds: 780, stalled: false },
+            ] });
+        const handler = makeWikiRunsHandler({ get, post: vi.fn() });
+        const text = textOf(await handler({ spaceId: 'ACME-S1', status: 'queued' }));
+        expect(get).toHaveBeenCalledWith('/spaces/ACME-S1/llm-wiki/ingest-runs?status=queued');
+        expect(text).toContain('r3 queued (waiting 21 min, stalled) ACME-D11');
+        expect(text).toContain('r4 queued (running 3 min) ACME-D12');
+    });
 });

package/dist/tools/wiki.js

@@ -189,14 +189,22 @@ export function makeWikiFlagStaleHandler(client) {
         return text(res.staleFlagged ? 'Page flagged as possibly outdated.' : 'Stale flag cleared.', { staleFlagged: res.staleFlagged });
     };
 }
+/** ORB-2611 - the wait or run time of a queued run, and its stall. */
+function queuedNote(r) {
+    if (r.status !== 'queued')
+        return '';
+    const waited = r.startedAt ? (Date.parse(r.startedAt) - Date.parse(r.queuedAt ?? r.createdAt)) / 1000 : 0;
+    const minutes = Math.max(1, Math.round(Math.max(0, (r.ageSeconds ?? 0) - waited) / 60));
+    return ` (${r.startedAt ? 'running' : 'waiting'} ${minutes} min${r.stalled ? ', stalled' : ''})`;
+}
 export const wikiRunsToolConfig = {
     title: 'Wiki ingest runs',
-    description: 'List the ingest runs of a wiki space (status failed shows each error) or retry a failed run.',
+    description: 'List the ingest runs of a wiki space (queued shows the wait and a stall, failed each error) or retry a failed or stalled run.',
     inputSchema: z.object({
         spaceId: z.string().min(1),
         action: z.enum(['list', 'retry']).optional(),
         runId: z.string().uuid().optional(),
-        status: z.enum(['pending_review', 'applied', 'failed', 'skipped']).optional(),
+        status: z.enum(['pending_review', 'applied', 'failed', 'skipped', 'queued']).optional(),
     }).shape,
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
 };
@@ -204,13 +212,13 @@ export function makeWikiRunsHandler(client) {
     return async (input) => {
         if (input.action === 'retry') {
             if (!input.runId)
-                return { isError: true, content: [{ type: 'text', text: 'action retry needs the runId of a failed run (action list, status failed).' }] };
+                return { isError: true, content: [{ type: 'text', text: 'action retry needs the runId of a failed or stalled run (action list, status failed or queued).' }] };
             const res = await client.post(`/spaces/${encodeURIComponent(input.spaceId)}/llm-wiki/ingest-runs/${input.runId}/retry`, {});
             return text(res.queued ? `Run ${res.runId} is queued for the ingest worker again.` : `Run ${res.runId} ran again: ${res.status}${res.error ? ` - ${res.error}` : ''}.`, res);
         }
         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.droppedOps?.length ? ` (ops dropped: ${r.droppedOps.length})` : ''}${r.error ? ` - ${r.error}` : ''}`);
+        const lines = res.runs.map((r) => `- ${r.id} ${r.status}${queuedNote(r)} ${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/package.json

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