@orboto/mcp 0.192.0 → 0.194.0

package/dist/tools/get-project.js

@@ -1,14 +1,5 @@
 /**
  * ORB-244 Phase B - `orboto_get_project`.
- *
- * Returns metadata + milestones + labels + members for a project.
- * Accepts the human-readable project key (`ACME`), case-insensitive
- * - the API's `GET /projects/by-key/:key` does the lookup, the rest
- * of the hydration (milestones + labels + members) comes from the
- * `/projects/:id/*` endpoints that take the resolved UUID.
- *
- * Members endpoint returns a nested `{user: {...}, role: {...}}`
- * shape; we flatten here into a card-friendly line.
  */
 import { z } from 'zod';
 import { resolveProjectByKey } from './shared.js';
@@ -23,9 +14,6 @@ export const getProjectToolConfig = {
 export function makeGetProjectHandler(client) {
     return async ({ projectKey }) => {
         const project = await resolveProjectByKey(client, projectKey);
-        // Parallel fan-out - the API doesn't have a single aggregate route
-        // for milestones+labels+members, and three parallel fetches beat a
-        // chain on the default Node HTTP pool.
         const [milestones, labels, members] = await Promise.all([
             client.get(`/projects/${project.id}/milestones`),
             client.get(`/projects/${project.id}/labels`),
@@ -39,7 +27,6 @@ export function makeGetProjectHandler(client) {
             ...milestones.map((m) => `  - ${m.milestoneKey ? `${m.milestoneKey} · ` : ''}${m.name} [${m.status}]${m.endDate ? ` due ${m.endDate}` : ''}`),
             '',
             `Labels: ${labels.map((l) => l.name).join(', ') || '(none)'}`,
-            // ORB-1040 - only mention RACI when the project opted in.
             project.raciEnabled ? 'RACI: enabled' : null,
             '',
             `Members (${members.length}):`,
@@ -52,15 +39,11 @@ export function makeGetProjectHandler(client) {
             content: [{ type: 'text', text: lines.join('\n') }],
             structuredContent: {
                 project: {
-                    // ORB-1042 - surface the UUID for the rare APIs that still need it
-                    // (most agent surfaces accept the key).
                     id: project.id,
                     key: project.key,
                     name: project.name,
                     status: project.status,
                     description: project.description,
-                    // ORB-1040 - RACI is opt-in; agents must not raise/set RACI here
-                    // unless this is true.
                     raciEnabled: project.raciEnabled ?? false,
                 },
                 milestones,

package/dist/tools/get-ticket.js

@@ -1,17 +1,7 @@
 /**
  * ORB-244 Phase B - `orboto_get_ticket`.
  *
- * Returns a ticket's full context - description, comments, assignees,
- * labels, checklists, git activity - in a shape the model can
- * reason about without follow-up calls. Comments and checklists are
- * fetched in parallel with the ticket payload; git activity is
- * skipped when the ticket's `gitActivityCount` is 0 so we don't waste
- * a round-trip on the common case.
- *
- * ORB-272: `/tickets/:id/comments` is cursor-paginated. We pull the
- * first page (50 by default) - if the ticket has more, a footer line
- * nudges the user to open it in the UI. AI agents asking "give me
- * the full history" beyond 50 is a rare enough case not to fan out.
+ * @see ORB-272
  */
 import { z } from 'zod';
 import { OrbotoApiError } from '../orboto-client.js';
@@ -33,29 +23,12 @@ export function makeGetTicketHandler(client) {
         const ticket = await resolveTicketByKey(client, ticketKey);
         const inc = new Set(include ?? []);
         const parentId = ticket.parentTicketId ?? null;
-        // ORB-1698 - the default response is the decision CARD: identity +
-        // description + progress + counts. The heavy blocks (comment bodies,
-        // git rows, checklist items) are fetched only when asked for via
-        // `include` - measured, they were the bulk of a 1.02 Mtok carry cost.
-        // Children + attachments have no count on the enriched row, so their
-        // (cheap, metadata-only) fetches stay - the RESPONSE carries only the
-        // count unless included.
         const [enriched, parent, childrenPage, attachments, commentsPage, checklists, gitActivity] = await Promise.all([
-            // ORB-1023 - `resolveTicketByKey` hits the by-key endpoint, which
-            // returns a BARE ticket row (no statusCategory, assignees, labels,
-            // milestoneName, counts). Re-fetch the enriched by-id shape; falls
-            // back to the bare row on a 404.
             client.get(`/projects/${ticket.projectId}/tickets/${ticket.id}`).catch(swallow404(null)),
-            // Parent ticket - only fetched when set. Lets the model say
-            // "this is sub-ticket of [ACME-10]" without a second tool call.
             parentId
                 ? client.get(`/projects/${ticket.projectId}/tickets/${parentId}`).catch(swallow404(null))
                 : Promise.resolve(null),
-            // Children via the parentTicketId filter (API-side, O(children)).
-            // Cap at 50; anything bigger should use `orboto_list_tickets
-            // --parentTicketKey` and paginate explicitly.
             client.get(`/projects/${ticket.projectId}/tickets?parentTicketId=${ticket.id}&limit=50`).catch(swallow404({ items: [], nextCursor: null })),
-            // ORB-1455 - attachments metadata so the agent knows files exist.
             client.get(`/tickets/${ticket.id}/attachments`).catch(swallow404([])),
             inc.has('comments')
                 ? client.get(`/tickets/${ticket.id}/comments?limit=${COMMENT_PAGE_SIZE}`).catch(swallow404({ items: [], nextCursor: null }))
@@ -70,8 +43,6 @@ export function makeGetTicketHandler(client) {
         const comments = commentsPage.items;
         const hasMoreComments = !!commentsPage.nextCursor;
         const children = childrenPage.items;
-        // ORB-1023 - prefer the enriched by-id row (statusCategory, assignees,
-        // labels, milestoneName); fall back to the bare resolver row.
         const full = enriched ?? ticket;
         const commentCount = full.commentCount ?? (inc.has('comments') ? comments.length : 0);
         const gitCount = full.gitActivityCount ?? (inc.has('git') ? gitActivity.length : 0);
@@ -92,7 +63,6 @@ export function makeGetTicketHandler(client) {
         return {
             content: [{ type: 'text', text: formatTicket(full, inc, comments, hasMoreComments, checklists, gitActivity, parent, children, attachments, includeHint) }],
             structuredContent: {
-                // ORB-1179 - surface the uuid alongside the key.
                 id: full.id,
                 key: full.ticketKey,
                 title: full.title,
@@ -103,22 +73,14 @@ export function makeGetTicketHandler(client) {
                     : null,
                 priority: full.priority,
                 type: full.type,
-                // ORB-1608 - role-aware commit policy. The API defaults unset
-                // rows to 'implementation'.
                 deliveryMode: full.deliveryMode ?? 'implementation',
                 dueDate: full.dueDate,
                 startDate: full.startDate,
                 isPrivate: full.isPrivate,
                 estimatedTimeMinutes: full.estimatedTimeMinutes,
                 loggedMinutes: full.loggedMinutes ?? 0,
-                // ORB-1605 - true when in_review, zero ingested git_activities,
-                // but the project HAS an active git connection: closing
-                // verification may be blocked on stalled ingestion.
                 waitingForGitIngestion: full.waitingForGitIngestion ?? false,
                 description: full.description ?? null,
-                // Hierarchy - null when no parent, array of summary rows for
-                // children (empty array when none). Sub-ticket consumers can
-                // decide to call orboto_get_ticket on each for the full detail.
                 parentTicket: parent ? {
                     key: parent.ticketKey,
                     title: parent.title,
@@ -135,14 +97,10 @@ export function makeGetTicketHandler(client) {
                     })),
                 } : {}),
                 assignees: full.assignees ?? [],
-                // ORB-1034 - RACI roster (R/A/C/I); opt-in via include: ["raci"]
-                // (assignees above stay the always-on Responsible+Accountable set).
                 ...(inc.has('raci') ? {
                     raci: (full.raci ?? []).map((r) => ({ userId: r.userId, fullName: r.fullName, role: r.role })),
                 } : {}),
                 labels: (full.labels ?? []).map((l) => l.name),
-                // ORB-1698 - counts always; bodies opt-in. checklistProgress is the
-                // aggregate from the enriched row (items via include).
                 commentCount,
                 gitActivityCount: gitCount,
                 attachmentCount: attachments.length,
@@ -167,10 +125,6 @@ export function makeGetTicketHandler(client) {
                         items: cl.items.map((i) => ({
                             content: i.content,
                             done: i.effectiveCompleted,
-                            // When the item links to another ticket, `effectiveCompleted`
-                            // mirrors that ticket's status-category instead of this item's
-                            // own checkbox. Surface the link so the model can explain
-                            // why the item is/isn't done.
                             linkedTicket: i.linkedTicketKey ? {
                                 key: i.linkedTicketKey,
                                 title: i.linkedTicketTitle,
@@ -189,8 +143,6 @@ export function makeGetTicketHandler(client) {
                         createdAt: g.createdAt,
                     })),
                 } : {}),
-                // ORB-1455 - attachments (id + metadata). Feed an id to
-                // orboto_get_attachment to view an image or fetch the bytes.
                 ...(inc.has('attachments') ? {
                     attachments: attachments.map((a) => ({
                         id: a.id,
@@ -215,18 +167,12 @@ function formatTicket(ticket, inc, comments, hasMoreComments, checklists, gitAct
     const header = [
         `[${ticket.ticketKey}] ${ticket.title}`,
         `Status: ${ticket.statusName ?? ticket.status}  Priority: ${ticket.priority}  Type: ${ticket.type}`,
-        // ORB-1608 - only shown when it deviates from the 'implementation'
-        // default, so a fresh ticket's card stays uncluttered.
         ticket.deliveryMode && ticket.deliveryMode !== 'implementation'
             ? `Delivery mode: ${ticket.deliveryMode}`
             : null,
-        // ORB-1605 - surface the stalled-ingestion signal right in the
-        // header so an agent checking "is this really done?" sees it
-        // before reading the (currently empty) git-activity section.
         ticket.waitingForGitIngestion
             ? '⏳ Waiting for Git ingestion - this project has an active git connection but no commits/PRs have landed for this ticket yet. Closing verification may be blocked on stalled ingestion, not on unfinished work - check manually before assuming it is unlinked.'
             : null,
-        // ORB-1023 - show the milestone name (not the UUID) when set.
         ticket.milestoneId ? `Milestone: ${ticket.milestoneName ?? '(unnamed)'}` : null,
         ticket.dueDate ? `Due: ${ticket.dueDate}` : null,
         parent ? `Parent: [${parent.ticketKey}] ${parent.title} (${parent.statusName ?? parent.status})` : null,
@@ -236,8 +182,6 @@ function formatTicket(ticket, inc, comments, hasMoreComments, checklists, gitAct
         ticket.assignees && ticket.assignees.length > 0
             ? `Assignees: ${ticket.assignees.map((a) => a.fullName || a.email).join(', ')}`
             : 'Assignees: (unassigned)',
-        // ORB-1034 - RACI summary, shown only when the project uses RACI and
-        // someone holds a non-Responsible role (Accountable / Consulted / Informed).
         ticket.raci && ticket.raci.some((r) => r.role !== 'R')
             ? `RACI: ${['A', 'R', 'C', 'I']
                 .map((role) => {
@@ -270,8 +214,6 @@ function formatTicket(ticket, inc, comments, hasMoreComments, checklists, gitAct
             const progressLabel = `${cl.progress.done}/${cl.progress.total}`;
             checklistLines.push(`### ${cl.title} (${progressLabel})${cl.triggersDone ? ' · triggers done' : ''}`);
             for (const i of cl.items) {
-                // Linked-ticket suffix on items that track another ticket - 
-                // lets the model say "item X is done because [ACME-42] shipped".
                 const link = i.linkedTicketKey
                     ? ` ↪ [${i.linkedTicketKey}] ${i.linkedTicketTitle ?? ''} (${i.linkedTicketStatusCategory ?? 'unknown'})`
                     : '';
@@ -302,8 +244,6 @@ function formatTicket(ticket, inc, comments, hasMoreComments, checklists, gitAct
             gitLines.push(`- ${g.type} ${g.state ? `[${g.state}]` : ''} ${g.title}${g.url ? ` - ${g.url}` : ''}`);
         }
     }
-    // ORB-1455 - attachments so the agent knows files exist. Feed an id to
-    // orboto_get_attachment to view an image or fetch the bytes.
     const attachmentLines = [];
     if (!inc.has('attachments') && attachments.length > 0) {
         attachmentLines.push('', `Attachments: ${attachments.length}`);

package/dist/tools/get-timer.js

@@ -1,15 +1,5 @@
 /**
  * ORB-244 Phase B - `orboto_get_timer`.
- *
- * Returns the caller's active stopwatch (or `null` when none is
- * running). Useful for the model to answer "am I still tracking
- * time on that bug from earlier?" without guessing.
- *
- * API shape: `GET /time/timer` returns `ActiveTimer | null` directly
- * (not wrapped). ActiveTimer carries `ticketTitle` and `projectId`
- * as joined fields but no `ticketKey` - so the ticket identifier is
- * resolved the cheap way: first 8 chars of the UUID when no title
- * is available, just the title otherwise.
  */
 import { z } from 'zod';
 export const getTimerToolConfig = {
@@ -20,7 +10,6 @@ export const getTimerToolConfig = {
 };
 export function makeGetTimerHandler(client) {
     return async () => {
-        // `/time/timer` returns the timer row directly, or `null`.
         const timer = await client.get('/time/timer');
         if (!timer) {
             return {

package/dist/tools/git-health-reasons.js

@@ -1,4 +1,3 @@
-// Shared rendering vocabulary for session-start and work-session bundles.
 export const GIT_HEALTH_REASON_TEXT = {
     connection_inactive: 'connection is deactivated',
     app_installation_suspended: 'GitHub App installation is suspended',

package/dist/tools/identity.js

@@ -1,15 +1,5 @@
 /**
  * ORB-799 - identity / debug tools.
- *
- * `orboto_whoami` - return the authenticated principal as `{id, email,
- * fullName, isBot}`. Mirrors `orboto.mjs whoami`. The wrapper hits the
- * existing `/users/me` route directly; we do the same so a stale-token
- * 401 surfaces the same way it does for every other tool.
- *
- * Useful for debugging "which API key is this session actually using?",
- * which is the most common confusion when an agent has multiple MCP
- * configs (`claude-desktop`, `cursor`, `gemini-cli`) wired to different
- * `orb_*` keys.
  */
 import { z } from 'zod';
 export const whoamiToolConfig = {
@@ -22,7 +12,6 @@ export const whoamiToolConfig = {
         fullName: z.string().nullable(),
         isBot: z.boolean(),
         workspaceLocale: z.string().nullable(),
-        // ORB-1671 - both identities of a delegated act-as connection.
         actingAuthorizedBy: z.object({ id: z.string(), email: z.string(), fullName: z.string() }).nullable(),
     }).shape,
     annotations: { readOnlyHint: true, idempotentHint: true },
@@ -40,8 +29,6 @@ export function makeWhoamiHandler(client) {
         if (workspaceLocale) {
             lines.push(`  workspace language: ${workspaceLocale} (write tickets in this language)`);
         }
-        // ORB-1671 - an act-as connection reports BOTH identities so the agent
-        // (and a human debugging it) can see who it acts as and who authorised it.
         if (me.actingAuthorizedBy) {
             lines.push(`  acting as this bot, authorised by: ${me.actingAuthorizedBy.fullName} <${me.actingAuthorizedBy.email}>`);
         }

package/dist/tools/list-projects.js

@@ -1,14 +1,5 @@
 /**
  * ORB-244 Phase A reference tool - `orboto_list_projects`.
- *
- * Maps to `GET /projects` in the orboto API, which already filters by
- * the caller's visibility via the PBAC cascade. The MCP server is a
- * transport adapter - it doesn't re-implement the ACL.
- *
- * Rest of the read-tool suite follows the same shape (see
- * ticket ORB-244 Phase B). Keeping this first tool narrow on
- * purpose - it's the one we wire + verify end-to-end before
- * scaling out.
  */
 import { z } from 'zod';
 export const listProjectsToolConfig = {
@@ -17,19 +8,12 @@ export const listProjectsToolConfig = {
         + 'If you are after one project, pass `query` to filter by key/name instead of pulling the whole list - '
         + 'and note you can usually use a project key directly with other tools without listing at all. '
         + 'When the result says it is partial, refine with `query` rather than re-calling.',
-    // ORB-1109 - query + limit so a small-context agent (self-hosted /
-    // local 32k models over MCP) can narrow instead of ingesting every
-    // project.
     inputSchema: z.object({
         query: z.string().optional().describe('Substring matched against key or name.'),
         limit: z.number().int().min(1).max(200).optional().describe('Max projects. Default 50.'),
     }).shape,
-    // Well-formed output schema so MCP clients that honour it can
-    // surface structured data. Adding fields is safe; removing them is a
-    // breaking change for pinned client configs.
     outputSchema: z.object({
         projects: z.array(z.object({
-            // ORB-1179 - uuid alongside the key for downstream write tools.
             id: z.string(),
             key: z.string(),
             name: z.string(),
@@ -52,10 +36,6 @@ export function makeListProjectsHandler(client) {
         const cap = Math.min(limit ?? 50, 200);
         const shown = matched.slice(0, cap);
         const rows = shown.map((p) => ({ id: p.id, key: p.key, name: p.name, status: p.status, description: p.description }));
-        // Text content is what the model reads; structured content is what
-        // the client UI renders. The text stays description-free (compact)
-        // and ends with a count line so a small model knows whether it has
-        // the whole set.
         const lines = rows.map((r) => `- ${r.key} - ${r.name} (${r.status})`);
         const partial = shown.length < matched.length;
         const footer = matched.length === 0

package/dist/tools/list-projects.test.js

@@ -32,7 +32,6 @@ describe('tools/list-projects', () => {
         });
         expect(result.structuredContent).toEqual({
             projects: [
-                // ORB-1179 - uuid surfaced alongside the key
                 { id: 'p1', key: 'ACME', name: 'Acme', status: 'active', description: 'Customer portal' },
                 { id: 'p2', key: 'TOOL', name: 'Internal Tools', status: 'draft', description: null },
             ],

package/dist/tools/list-tickets.js

@@ -12,7 +12,7 @@ import { resolveProjectByKey, resolveTicketByKey, ticketLine, agentTicketListRow
 import { resolveMilestoneByNameOrId } from './milestones.js';
 export const listTicketsToolConfig = {
     title: 'List tickets',
-    description: 'List tickets in a project, optionally filtered by status category, milestone name, or assignee email. Returns up to 50 tickets per call.',
+    description: 'List tickets in a project, optionally filtered by status category, milestone name, or assignee email. Set unscheduled=true for the product backlog (everything not planned into a milestone yet). Returns up to 50 tickets per call.',
     inputSchema: z.object({
         projectKey: z.string().min(1).describe('Project key (e.g. "ACME").'),
         statusCategory: z
@@ -23,6 +23,10 @@ export const listTicketsToolConfig = {
             .string()
             .optional()
             .describe('Key (ORB-M3), name, or UUID. Omit for all, backlog included.'),
+        unscheduled: z
+            .boolean()
+            .optional()
+            .describe('true = only the backlog: tickets with no milestone. Cannot be combined with `milestone`.'),
         assigneeEmail: z
             .string()
             .optional()
@@ -43,18 +47,16 @@ export function makeListTicketsHandler(client) {
         qs.set('limit', String(input.limit ?? 25));
         if (input.statusCategory)
             qs.set('statusCategory', input.statusCategory);
-        // Milestone + assignee need a UUID on the API; resolve them here
-        // from the project payload instead of forcing the caller to paste
-        // a UUID.
+        if (input.unscheduled && input.milestone) {
+            throw new Error('Pass either `milestone` or `unscheduled: true`, not both.');
+        }
+        if (input.unscheduled)
+            qs.set('unscheduled', 'true');
         if (input.milestone) {
-            // ORB-1696 - shared resolver: key (ORB-M3), name or UUID, ambiguous
-            // name -> explicit error. Matches create_ticket/set_milestone/OQL.
             const m = await resolveMilestoneByNameOrId(client, project.id, input.milestone);
             qs.set('milestoneId', m.id);
         }
         if (input.assigneeEmail) {
-            // Members endpoint returns `{userId, user: {email, ...}, role: {...}}`;
-            // we need to peek inside `user` to match by email.
             const members = await client.get(`/projects/${project.id}/members`);
             const member = members.find((x) => x.user.email.toLowerCase() === input.assigneeEmail.toLowerCase());
             if (!member)
@@ -78,7 +80,6 @@ export function makeListTicketsHandler(client) {
                 project: { key: project.key },
                 count: page.items.length,
                 hasMore: !!page.nextCursor,
-                // ORB-1699 - shared lean row; verbose restores uuid/labels/minutes.
                 tickets: page.items.map((t) => agentTicketListRow(t, input.verbose ?? false)),
             },
         };

package/dist/tools/milestones-crud.test.js

@@ -46,9 +46,6 @@ describe('orboto_create_milestone', () => {
         const res = await makeCreateMilestoneHandler(client)({
             projectKey: 'ACME', name: 'v2.0',
         });
-        // ORB-1825 - startDate/endDate are nullable().optional() on the API's
-        // create body now; an absent key means the same thing as null, so the
-        // tool no longer forces `?? null` and the wire body simply omits them.
         expect(calls[1]).toMatchObject({
             method: 'POST',
             url: 'https://orboto.example.com/projects/p1/milestones',
@@ -118,7 +115,6 @@ describe('orboto_close_milestone', () => {
         await makeCloseMilestoneHandler(client)({
             projectKey: 'ACME', milestone: '11111111-2222-3333-4444-555555555555',
         });
-        // PATCH URL should hit the UUID, not the first row.
         expect(calls[2].url).toContain('/milestones/11111111-2222-3333-4444-555555555555');
     });
     it('throws a clear error when milestone is not found', async () => {

package/dist/tools/milestones.js

@@ -1,21 +1,5 @@
 /**
  * ORB-244 Phase B - milestone tools, expanded in ORB-799 with CRUD.
- *
- * `orboto_list_milestones` and `orboto_get_milestone` share this file
- * because they're cheap neighbours (same API root, same resolution
- * chain). The `get` tool also pulls the `/progress` endpoint so the
- * model sees ticket-count breakdowns alongside the metadata.
- *
- * ORB-799 added the write half of the surface to close wrapper-parity:
- *
- *   - orboto_create_milestone - mirrors `orboto.mjs create-milestone`.
- *     `startDate`/`endDate` are both optional; a milestone without dates
- *     is a legitimate object (analytics/Gantt/templates treat null dates
- *     as "no dates").
- * - orboto_close_milestone - close + optional archive. Resolves the
- *     milestone by name OR UUID against the includeClosed=true list so
- *     re-closing an already-closed milestone is idempotent.
- * - orboto_update_milestone - patch name / dates / private flag.
  */
 import { z } from 'zod';
 import { OrbotoApiError } from '../orboto-client.js';
@@ -24,9 +8,6 @@ const UUID_RE = /^[0-9a-f-]{36}$/i;
 const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 /** ORB-1059 - a milestone key looks like `ORB-M3`. */
 const MILESTONE_KEY_RE = /^[A-Za-z0-9]+-M\d+$/i;
-// ---------------------------------------------------------------------------
-// orboto_list_milestones
-// ---------------------------------------------------------------------------
 export const listMilestonesToolConfig = {
     title: 'List milestones',
     description: 'List milestones in a project, newest first.',
@@ -51,7 +32,6 @@ export function makeListMilestonesHandler(client) {
             structuredContent: {
                 project: { key: project.key },
                 milestones: milestones.map((m) => ({
-                    // ORB-1179 - surface the uuid alongside the milestone key.
                     id: m.id,
                     milestoneKey: m.milestoneKey ?? null,
                     name: m.name,
@@ -64,9 +44,6 @@ export function makeListMilestonesHandler(client) {
         };
     };
 }
-// ---------------------------------------------------------------------------
-// orboto_get_milestone
-// ---------------------------------------------------------------------------
 export const getMilestoneToolConfig = {
     title: 'Get milestone details',
     description: 'Return milestone metadata plus ticket-count breakdown by status (to do / in progress / done / …).',
@@ -79,12 +56,7 @@ export const getMilestoneToolConfig = {
 export function makeGetMilestoneHandler(client) {
     return async ({ projectKey, milestone }) => {
         const project = await resolveProjectByKey(client, projectKey);
-        // ORB-1068 - resolve key / name / UUID through the shared resolver
-        // instead of an exact-name find, so `ORB-M19` works here too.
         const m = await resolveMilestoneByNameOrId(client, project.id, milestone);
-        // Progress comes from a separate endpoint; tolerate 404 gracefully
-        // in case a future API rename drops it so the tool still returns
-        // the metadata half.
         const progress = await client.get(`/projects/${project.id}/milestones/${m.id}/progress`).catch((err) => {
             if (err instanceof OrbotoApiError && err.status === 404)
                 return null;
@@ -121,9 +93,6 @@ export function makeGetMilestoneHandler(client) {
         };
     };
 }
-// ---------------------------------------------------------------------------
-// orboto_create_milestone - ORB-799
-// ---------------------------------------------------------------------------
 export const createMilestoneToolConfig = {
     title: 'Create a milestone',
     description: 'Create a milestone in a project. `startDate` + `endDate` are optional - omit them (or pass null) for a milestone with no dates. The caller must have `milestone:create`.',
@@ -163,9 +132,6 @@ export function makeCreateMilestoneHandler(client) {
         };
     };
 }
-// ---------------------------------------------------------------------------
-// orboto_close_milestone - ORB-799
-// ---------------------------------------------------------------------------
 /** Resolve a milestone by name OR UUID against the includeClosed list,
  *  so closing an already-completed milestone (re-close), archiving a
  *  completed milestone, and re-pointing a ticket onto any milestone all
@@ -183,7 +149,6 @@ export async function resolveMilestoneByNameOrId(client, projectId, nameOrId) {
         }
         return byId;
     }
-    // ORB-1059 - accept the human-readable key (`ORB-M3`), case-insensitive.
     if (MILESTONE_KEY_RE.test(nameOrId)) {
         const byKey = all.find((x) => x.milestoneKey?.toLowerCase() === nameOrId.toLowerCase());
         if (!byKey) {
@@ -191,11 +156,6 @@ export async function resolveMilestoneByNameOrId(client, projectId, nameOrId) {
         }
         return byKey;
     }
-    // ORB-1826 - exact (raw) name match wins first; falls back to a unique
-    // normalised match (HTML-entity-decoded, trimmed, whitespace-collapsed,
-    // casefolded) so `"QA & Testing"` resolves against a milestone
-    // literally named `"QA & Testing"`. Ambiguous either way still errors,
-    // listing the candidates.
     const { match, ambiguous } = resolveByName(all, nameOrId, (m) => m.name);
     if (ambiguous) {
         const list = ambiguous.map((m) => `"${m.name}" (${m.id})`).join(', ');
@@ -236,9 +196,6 @@ export function makeCloseMilestoneHandler(client) {
         };
     };
 }
-// ---------------------------------------------------------------------------
-// orboto_update_milestone - ORB-799
-// ---------------------------------------------------------------------------
 export const updateMilestoneToolConfig = {
     title: 'Update a milestone\'s fields',
     description: 'Patch a milestone (`name`, `customerSummary`, `startDate`, `endDate`, `isPrivate`). At least one field must be set. `customerSummary` is the customer-facing text shown in the customer project report instead of any internal text. Use `orboto_close_milestone` to flip status to completed/archived - this tool intentionally does NOT touch the status field so closing remains a clear semantic operation.',

package/dist/tools/my-tickets.js

@@ -21,10 +21,6 @@ export const myTicketsToolConfig = {
     }).shape,
     annotations: { readOnlyHint: true, idempotentHint: true },
 };
-// The API route's `statuses` param is the uppercase LEGACY status
-// enum (TODO/IN_PROGRESS/IN_REVIEW/DONE/WONT_FIX). The MCP tool
-// accepts the lower-case category enum the rest of the surface uses;
-// map here.
 const CATEGORY_TO_LEGACY = {
     todo: 'TODO',
     in_progress: 'IN_PROGRESS',
@@ -40,8 +36,6 @@ export function makeMyTicketsHandler(client) {
             qs.set('statuses', CATEGORY_TO_LEGACY[input.statusCategory]);
         }
         else {
-            // Default: exclude done + wont_fix so "what am I working on?"
-            // returns open work rather than a lifetime history.
             qs.set('statuses', 'TODO,IN_PROGRESS,IN_REVIEW');
         }
         const page = await client.get(`/users/me/assigned-tickets?${qs}`);
@@ -57,7 +51,6 @@ export function makeMyTicketsHandler(client) {
             structuredContent: {
                 count: page.items.length,
                 hasMore: !!page.nextCursor,
-                // ORB-1699 - shared lean row; verbose restores uuid/labels/minutes.
                 tickets: page.items.map((t) => agentTicketListRow(t, input.verbose ?? false)),
             },
         };