overlord-cli 0.2610201032.0 → 0.2610231436.0

package/dist/connectors/core/scripts/overlord-mcp.mjs

@@ -63,45 +63,6 @@ async function runProtocol(subcommand, args = {}) {
   }
 }
 
-function objectSchema(properties, required = []) {
-  return {
-    type: 'object',
-    properties,
-    required,
-    additionalProperties: false
-  };
-}
-
-function stringProperty(description) {
-  return { type: 'string', description };
-}
-
-function booleanProperty(description) {
-  return { type: 'boolean', description };
-}
-
-function changeRationalesProperty(description) {
-  return {
-    type: 'array',
-    description,
-    items: objectSchema(
-      {
-        filePath: stringProperty('Repository-relative path of the changed file.'),
-        label: stringProperty('Short reviewer title for the change.'),
-        summary: stringProperty('What changed in this file.'),
-        why: stringProperty('Why the change was made.'),
-        impact: stringProperty('Behavioral impact of the change.'),
-        hunks: {
-          type: 'array',
-          description: 'Optional diff-hunk headers only; file contents and diffs are prohibited.',
-          items: objectSchema({ header: stringProperty('Unified-diff hunk header.') }, ['header'])
-        }
-      },
-      ['filePath', 'label', 'summary', 'why', 'impact']
-    )
-  };
-}
-
 function compactSearchResponse(response) {
   const value = response?.structuredContent;
   if (!value || value.version !== 3 || !Array.isArray(value.results)) return response;
@@ -156,502 +117,1009 @@ function compactRunQueueResponse(response) {
   };
 }
 
+// BEGIN GENERATED MCP TOOL CATALOG
+// Generated from packages/contract/src/mcp-tools.ts — do not edit.
+// Regenerate with `yarn connectors:mcp-tools`.
 const tools = [
   {
     name: 'overlord_resolve_project',
     title: 'Resolve Overlord project',
     description:
-      "Resolve a project by id, slug, name, or linked repository directory metadata exposed to the MCP client. Names are matched case-insensitively across every workspace the caller can reach; a name matching in more than one returns a 'project_selection_required' result listing the candidates with their workspaces — ask the user, then retry with workspaceId.",
-    inputSchema: objectSchema({
-      projectId: stringProperty('Explicit Overlord project id, slug, or project name.'),
-      workspaceId: stringProperty(
-        "Optional workspace (id, slug, or name) narrowing an ambiguous projectId. Use this to retry after a 'project_selection_required' result."
-      ),
-      directory: stringProperty(
-        'Optional repository directory path when the MCP client can expose one with .overlord/project.json.'
-      )
-    })
+      "Use this when the user identifies an Overlord project by id, slug, name, or exposed repository metadata. Names are matched case-insensitively across every workspace the caller can reach; when a name matches in more than one, this returns a 'project_selection_required' result listing the candidates with their workspaces — ask the user which one, then retry with workspaceId set. When resolving from .overlord/project.json, the result is the isPrimary project if the checkout is linked to more than one project; linkedProjects lists every linked project.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Explicit Overlord project id, slug, or project name.'
+        },
+        workspaceId: {
+          type: 'string',
+          description:
+            "Optional workspace (id, slug, or name) that narrows an ambiguous projectId. Use this to retry after a 'project_selection_required' result."
+        },
+        directory: {
+          type: 'string',
+          description:
+            'Optional repository directory path when the MCP client can expose one with .overlord/project.json.'
+        }
+      },
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_create_project',
     title: 'Create Overlord project',
     description:
-      'Create a new Overlord project. If the caller belongs to more than one workspace and none is given, returns a workspace_selection_required result listing the workspaces for the user to choose.',
-    inputSchema: objectSchema(
-      {
-        name: stringProperty('New project name.'),
-        workspaceId: stringProperty(
-          'Workspace to create the project in (id, slug, or name). Required only when the caller belongs to multiple workspaces.'
-        ),
-        description: stringProperty('Optional project description.'),
-        slug: stringProperty('Optional project slug; defaults to a slug derived from the name.')
+      "Use this only when the user explicitly asks to create a new Overlord project (workspace project). If the user belongs to more than one workspace and none is specified, this returns a 'workspace_selection_required' result listing the workspaces — ask the user which one, then call again with workspaceId set to the chosen id, slug, or name.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'New project name.'
+        },
+        workspaceId: {
+          type: 'string',
+          description:
+            'Workspace to create the project in (id, slug, or name). Required only when the caller belongs to multiple workspaces.'
+        },
+        description: {
+          type: 'string',
+          description: 'Optional project description.'
+        },
+        slug: {
+          type: 'string',
+          description: 'Optional project slug; defaults to a slug derived from the name.'
+        }
       },
-      ['name']
-    )
+      required: ['name'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_list_project_statuses',
     title: 'List Overlord project statuses',
     description:
-      "Read one project's board columns. Status names and order are defined per project, so two projects in the same workspace can label the same lifecycle differently; each status also carries a stable type (draft, next, execute, review, complete, blocked, cancelled) that does not vary by project.",
-    inputSchema: objectSchema(
-      {
-        projectId: stringProperty(
-          "Overlord project id, slug, or name. An ambiguous name returns 'project_selection_required'; retry with workspaceId."
-        ),
-        workspaceId: stringProperty(
-          'Optional workspace (id, slug, or name) narrowing an ambiguous projectId.'
-        )
+      "Use this to read one project's board columns. Status names and order are defined per project, so two projects in the same workspace can label the same lifecycle differently; this is the only way to discover a specific board’s columns. Each status carries a stable type (draft, next, execute, review, complete, blocked, cancelled) that does not vary by project — use the type for filtering and the name only for display.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description:
+            "Overlord project id, slug, or name. An ambiguous name returns 'project_selection_required'; retry with workspaceId."
+        },
+        workspaceId: {
+          type: 'string',
+          description: 'Optional workspace (id, slug, or name) that narrows an ambiguous projectId.'
+        }
       },
-      ['projectId']
-    )
+      required: ['projectId'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_search_missions',
     title: 'Search Overlord missions',
     description:
-      "Search mission anchors with their matching objectives and deliveries across authorized workspaces. An objective displayId can be passed directly to overlord_load_mission_context; matches are matched-only, not the full objective list. Artifacts are not indexed. Use absolute ISO from/to bounds (no relative dates or implicit window), inspect workspaceCounts, entityCounts, and truncatedCandidates before claiming completeness, and treat appliedFilters.mode 'fallback' as a recency listing. Compact detail is default; request full for child snippets and metadata. Ranked results never prove absence: to check an exact token such as a canonical kb-feature: Knowledgebase Feature reference, pass reference with projectId (only workspaceId, limit 1-100 and cursor may accompany it) and follow nextCursor until complete is true.",
-    inputSchema: objectSchema({
-      query: stringProperty('Search query text.'),
-      reference: stringProperty(
-        'Exact-reference mode: case-sensitive whole token (8-512 characters, no whitespace) in live objective text. Requires projectId; cannot be combined with ranked filters. Returns { results (with statusType and matching objectives), nextCursor, complete }.'
-      ),
-      cursor: stringProperty(
-        'Exact-reference mode only: nextCursor from the previous page for the same reference and projectId.'
-      ),
-      status: stringProperty(
-        'Comma-separated status TYPES, such as draft,next,execute,review. Types are workspace-invariant (draft, next, execute, review, complete, blocked, cancelled). Project-defined status names are not accepted here.'
-      ),
-      projectId: stringProperty(
-        "Optional project reference: a stable UUID, a slug, or the project name as the user said it. Names are matched case-insensitively against the projects the caller can reach. If the name matches in more than one workspace the call returns a 'project_selection_required' result listing the candidates with their workspaces — ask the user which one, then retry with workspaceId set."
-      ),
-      workspaceId: stringProperty(
-        "Optional workspace (id, slug, or name) narrowing an ambiguous projectId. Use this to retry after a 'project_selection_required' result."
-      ),
-      resourceKey: stringProperty(
-        'Optional logical resource key, matched by name within selected projects.'
-      ),
-      dateField: stringProperty(
-        'Date column for an explicit range: createdAt, updatedAt, or dueDatetime. Use dueDatetime for questions about what is scheduled or due; missions with no due date are excluded from a dueDatetime range.'
-      ),
-      from: stringProperty('Optional inclusive ISO-8601 date/time lower bound.'),
-      to: stringProperty('Optional exclusive ISO-8601 date/time upper bound.'),
-      limit: {
-        type: 'number',
-        description: 'Maximum result count. Defaults to 25.'
-      },
-      entityTypes: stringProperty(
-        'Optional comma-separated v3 entity types: mission, objective, delivery.'
-      ),
-      objectiveStates: stringProperty(
-        'Optional comma-separated v3 objective states for matching objectives.'
-      ),
-      matchesPerResult: {
-        type: 'number',
-        description:
-          'Optional v3 child-match cap per mission (default 3, max 10; compact returns at most 2).'
+      "Use this to find missions across the caller's authorized workspaces. Results are mission anchors with only the matching objectives and deliveries in matches; an objective displayId (for example coo:789.2nnh) can be passed directly to overlord_load_mission_context. matches is never the mission's complete objective list. Artifacts are not indexed; load mission context after locating the mission to read them. There is no relative-date parsing or implicit time window: compute absolute ISO bounds and pass from/to. Raise limit for broad questions and inspect workspaceCounts, entityCounts, and truncatedCandidates before claiming a list is complete. appliedFilters.mode 'fallback' means the query contributed nothing and results are a recency listing, not an answer. Compact detail is the default and retains navigation identity while reducing child payload; request full for snippets and child metadata. Ranked results can never prove that no mission mentions something. To prove absence or presence of an exact token (for example a canonical kb-feature: Knowledgebase Feature reference), pass reference with projectId instead: that mode is exhaustive, returns every mission in the project whose live objective text contains the exact token with its statusType, and pages with cursor until complete is true; it accepts only projectId, workspaceId, limit (1-100, default 50) and cursor.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'Search query text.'
+        },
+        reference: {
+          type: 'string',
+          description:
+            'Exact-reference mode: a case-sensitive token of 8-512 characters with no whitespace, matched as a whole token in live objective instruction text. Requires projectId; cannot be combined with query or other ranked filters. Returns MissionReferenceSearchResponse { results, nextCursor, complete }. Absence is proven only after following nextCursor to a page with complete: true.'
+        },
+        cursor: {
+          type: 'string',
+          description:
+            'Exact-reference mode only: the nextCursor from the previous page for the same reference and projectId.'
+        },
+        status: {
+          type: 'string',
+          description:
+            'Comma-separated status TYPES, such as draft,execute,review. Types are workspace-invariant (draft, next, execute, review, complete, blocked, cancelled). Project-defined status names — the board column labels read by overlord_list_project_statuses — are not accepted here.'
+        },
+        projectId: {
+          type: 'string',
+          description:
+            "Optional project reference: a stable UUID, a slug, or the project name as the user said it. Names are matched case-insensitively against the projects the caller can reach. If the name matches in more than one workspace the call returns a 'project_selection_required' result listing the candidates with their workspaces — ask the user which one, then retry with workspaceId set."
+        },
+        workspaceId: {
+          type: 'string',
+          description:
+            "Optional workspace (id, slug, or name) that narrows an ambiguous projectId. Use this to retry after a 'project_selection_required' result."
+        },
+        resourceKey: {
+          type: 'string',
+          description:
+            'Optional logical resource key. Keys are matched by name within every selected project.'
+        },
+        dateField: {
+          type: 'string',
+          enum: ['createdAt', 'updatedAt', 'dueDatetime'],
+          description:
+            'Date column for an explicit range: createdAt, updatedAt, or dueDatetime. Defaults to updatedAt only when from or to is supplied. Use dueDatetime for questions about what is scheduled or due — a mission is scheduled by its due date, not by an execution timer. Missions with no due date are excluded from a dueDatetime range.'
+        },
+        from: {
+          type: 'string',
+          description: 'Optional inclusive ISO-8601 date/time lower bound.'
+        },
+        to: {
+          type: 'string',
+          description: 'Optional exclusive ISO-8601 date/time upper bound.'
+        },
+        limit: {
+          type: 'number',
+          description: 'Maximum result count. Defaults to 25.'
+        },
+        entityTypes: {
+          type: 'string',
+          description: 'Optional comma-separated v3 entity types: mission, objective, delivery.'
+        },
+        objectiveStates: {
+          type: 'string',
+          description: 'Optional comma-separated v3 objective states for matching objectives.'
+        },
+        matchesPerResult: {
+          type: 'number',
+          description:
+            'Optional v3 child-match cap per mission (default 3, max 10; compact returns at most 2).'
+        },
+        detail: {
+          type: 'string',
+          enum: ['compact', 'full'],
+          description:
+            'Result detail: compact (default) keeps child navigation fields and removes child snippets/metadata; full returns the complete v3 child matches.'
+        }
       },
-      detail: {
-        type: 'string',
-        enum: ['compact', 'full'],
-        description:
-          'Result detail: compact (default) keeps child navigation fields and removes child snippets/metadata; full returns complete v3 child matches.'
-      }
-    })
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_create_mission',
     title: 'Create Overlord mission',
     description:
-      'Create a draft mission with projectId. To intentionally create an account-owned inbox item, set unassignedToProject to true; omission of both is rejected.',
-    inputSchema: objectSchema(
-      {
-        projectId: stringProperty(
-          'Overlord project id, slug, or name. Required unless unassignedToProject is true.'
-        ),
-        unassignedToProject: booleanProperty(
-          'Set true only to intentionally create an account-owned inbox item instead of a project mission. Cannot be combined with projectId.'
-        ),
-        objective: stringProperty('Initial objective text.'),
-        title: stringProperty('Optional mission title.'),
-        resourceKey: stringProperty('Optional logical project resource key for the objective.'),
-        agent: stringProperty(
-          'Optional agent identifier to assign to the initial objective, such as codex or claude. Omitted leaves the project launch-preference default; set it here instead of appending a second objective just to name an agent.'
-        ),
-        model: stringProperty(
-          'Optional model identifier for the assigned agent. Requires agent; rejected without it.'
-        ),
-        assignedTo: stringProperty(
-          'Optional workspace member to own the mission (workspace_users.id, profile UUID, orgid:username, bare username, or email). Rejected when the member is not in the workspace; meaningless for an unassigned inbox item.'
-        ),
-        autoAdvance: booleanProperty(
-          'When true, Overlord queues the next objective for execution after this one is delivered. Defaults to false.'
-        )
+      'Use this to create a draft mission with projectId. To intentionally create an account-owned inbox item, set unassignedToProject to true; omission of both is rejected.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description:
+            'Overlord project id, slug, or name. Required unless unassignedToProject is true.'
+        },
+        unassignedToProject: {
+          type: 'boolean',
+          description:
+            'Set true only to intentionally create an account-owned inbox item instead of a project mission. Cannot be combined with projectId.'
+        },
+        objective: {
+          type: 'string',
+          description: 'Initial objective text.'
+        },
+        title: {
+          type: 'string',
+          description: 'Optional mission title.'
+        },
+        resourceKey: {
+          type: 'string',
+          description: 'Optional logical project resource key for the objective.'
+        },
+        agent: {
+          type: 'string',
+          description:
+            'Optional agent identifier to assign to the initial objective, such as codex or claude. Omitted leaves the project launch-preference default; set it here instead of appending a second objective just to name an agent.'
+        },
+        model: {
+          type: 'string',
+          description:
+            'Optional model identifier for the assigned agent. Requires agent; rejected without it.'
+        },
+        assignedTo: {
+          type: 'string',
+          description:
+            'Optional workspace member to own the mission (workspace_users.id, profile UUID, orgid:username, bare username, or email). Rejected when the member is not in the workspace; meaningless for an unassigned inbox item.'
+        },
+        autoAdvance: {
+          type: 'boolean',
+          description:
+            'When true, Overlord queues the next objective for execution after this one is delivered. Defaults to false.'
+        }
       },
-      ['objective']
-    )
+      required: ['objective'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_create_inbox_item',
     title: 'Create inbox item',
-    description: 'Create a private, account-owned unassigned task capture.',
-    inputSchema: objectSchema(
-      {
-        title: stringProperty('Inbox item title.'),
-        objective: stringProperty('The one objective captured in v1.')
+    description: 'Use this to create a private, account-owned unassigned task capture.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: {
+          type: 'string',
+          description: 'Inbox item title.'
+        },
+        objective: {
+          type: 'string',
+          description: 'The one objective captured in v1.'
+        }
       },
-      ['title', 'objective']
-    )
+      required: ['title', 'objective'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_load_mission_context',
     title: 'Load mission context',
     description:
-      'Load structured mission context, objectives, history, artifacts, and shared context.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Returns that objective as the current one instead of rediscovering the mission active objective.'
-        ),
-        executionTargetId: stringProperty(
-          'Optional local execution target id for resolving sibling project resource paths.'
-        )
+      'Use this when the user wants to inspect one mission, its objectives, history, artifacts, or shared context.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Returns that objective as the current one instead of rediscovering the mission active objective — required on a mission running objectives in parallel.'
+        },
+        executionTargetId: {
+          type: 'string',
+          description:
+            'Optional local execution target id for resolving sibling project resource paths.'
+        }
       },
-      []
-    )
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_list_deliveries',
     title: 'List mission deliveries',
     description:
-      "Use this to read a mission's delivered work after locating it. Returns newest-first normalized delivery records including summary, verification, follow-up notes, and authoritative delivery evidence; it never exposes raw delivery payloads.",
-    inputSchema: objectSchema({
-      missionId: stringProperty(
-        'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-      ),
-      objectiveId: stringProperty(
-        'Objective UUID or display id such as coo:756.k7xm. Use a display id when that is the only identifier available.'
-      )
-    })
+      "Use this to read a mission's delivered work after locating it. Returns a newest-first MissionDeliveriesDto page { items, total, limit } of normalized delivery records including summary, verification, follow-up notes, and authoritative human-action, tradeoff, risk, deferred-work, and assumption evidence; items are capped at 200 and total is the matching count before that cap. It never exposes raw delivery payloads.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Use a display id when that is the only identifier available.'
+        }
+      },
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_launch_objective',
     title: 'Launch objective execution',
     description:
-      'Use this only when the user explicitly asks to start a particular objective. It queues the normal Overlord execution request; it does not attach this MCP agent to perform the work. An existing active request is returned instead of duplicated.',
-    inputSchema: objectSchema(
-      {
-        objectiveId: stringProperty('Objective UUID or display id such as coo:756.k7xm.'),
-        agent: stringProperty('Agent identifier to launch, such as codex or claude.'),
-        model: stringProperty('Optional model identifier to snapshot onto the execution request.'),
-        reasoningEffort: stringProperty(
-          'Optional reasoning-effort setting to snapshot onto the execution request.'
-        ),
-        executionTargetId: stringProperty(
-          "Optional eligible execution target id. Omit to use the project's normal target selection."
-        )
+      'Use this only when the user explicitly asks to start a particular objective. It queues the normal Overlord execution request; it does not attach this MCP agent to perform the work. The objective must be launchable, its workspace must authorize execution, and an existing active request is returned instead of duplicated.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        objectiveId: {
+          type: 'string',
+          description: 'Objective UUID or display id such as coo:756.k7xm.'
+        },
+        agent: {
+          type: 'string',
+          description: 'Agent identifier to launch, such as codex or claude.'
+        },
+        model: {
+          type: 'string',
+          description: 'Optional model identifier to snapshot onto the execution request.'
+        },
+        reasoningEffort: {
+          type: 'string',
+          description: 'Optional reasoning-effort setting to snapshot onto the execution request.'
+        },
+        executionTargetId: {
+          type: 'string',
+          description:
+            "Optional eligible execution target id. Omit to use the project's normal target selection."
+        }
       },
-      ['objectiveId', 'agent']
-    )
+      required: ['objectiveId', 'agent'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_reorder_future_objectives',
     title: 'Reorder future objectives',
     description:
-      'Use this only when the user explicitly asks to change future-objective order in one mission. Supply every future objective UUID in its complete desired top-to-bottom order; draft, active, and completed objectives cannot be moved by this tool.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty('Mission UUID.'),
+      'Use this only when the user explicitly asks to change the order of future objectives in one mission. Supply every future objective UUID in its complete desired top-to-bottom order; draft, active, and completed objectives cannot be moved by this tool.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description: 'Mission UUID.'
+        },
         orderedObjectiveIds: {
           type: 'array',
           description:
             'Complete desired top-to-bottom UUID order of every objective currently in the future state.',
-          items: stringProperty('Future objective UUID.')
+          items: {
+            type: 'string',
+            description: 'Future objective UUID.'
+          }
         }
       },
-      ['missionId', 'orderedObjectiveIds']
-    )
+      required: ['missionId', 'orderedObjectiveIds'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_add_objectives',
     title: 'Add objectives',
-    description: 'Append one or more draft objectives to an existing mission.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Used only to supply missionId when it is omitted.'
-        ),
+    description:
+      'Use this only when the user explicitly asks to append draft objectives to an existing mission.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Used only to supply missionId when it is omitted; the new objectives are appended to that objective mission.'
+        },
         objectives: {
           type: 'array',
           description:
-            'Objective objects with objective text and optional title, resourceKey, and autoAdvance.',
-          items: objectSchema({
-            objective: stringProperty('Objective text.'),
-            title: stringProperty('Optional objective title.'),
-            resourceKey: stringProperty('Optional logical project resource key.'),
-            autoAdvance: booleanProperty(
-              'When true, Overlord queues the next objective for execution after this one is delivered. Defaults to false.'
-            )
-          })
+            'Objective objects with objective text and optional title, agent/model launch selection, resourceKey, and autoAdvance.',
+          items: {
+            type: 'object',
+            properties: {
+              objective: {
+                type: 'string',
+                description: 'Objective text.'
+              },
+              title: {
+                type: 'string',
+                description: 'Optional objective title.'
+              },
+              agent: {
+                type: 'string',
+                description:
+                  'Optional agent identifier to assign to this objective, such as codex or claude.'
+              },
+              model: {
+                type: 'string',
+                description: 'Optional model identifier for this objective. Requires agent.'
+              },
+              resourceKey: {
+                type: 'string',
+                description: 'Optional logical project resource key.'
+              },
+              autoAdvance: {
+                type: 'boolean',
+                description:
+                  'When true, Overlord queues the next objective for execution after this one is delivered. Defaults to false.'
+              }
+            },
+            required: [],
+            additionalProperties: false
+          }
         }
       },
-      ['objectives']
-    )
+      required: ['objectives'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_update_objective',
     title: 'Update objective',
     description:
-      'Turn auto-advance on or off and/or edit instruction text on a draft or future objective.',
-    inputSchema: objectSchema(
-      {
-        objectiveId: stringProperty('Objective UUID or display id.'),
-        autoAdvance: booleanProperty(
-          'When true, Overlord queues the next objective after this one is delivered. When false, delivery waits for approval.'
-        ),
-        instructionText: stringProperty(
-          'Replacement instruction text. Allowed only when the objective is in draft or future state; blank clears the text in those states.'
-        )
+      'Use this to rewrite an objective title in any state, turn auto-advance on or off, and/or edit instruction text on a draft or future objective.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        objectiveId: {
+          type: 'string',
+          description: 'Objective UUID or display id.'
+        },
+        title: {
+          type: 'string',
+          description:
+            'Replacement objective title. An empty string clears the custom title and restores instruction-derived presentation.'
+        },
+        autoAdvance: {
+          type: 'boolean',
+          description:
+            'When true, Overlord queues the next objective after this one is delivered. When false, delivery waits for approval.'
+        },
+        instructionText: {
+          type: 'string',
+          description:
+            'Replacement instruction text. Allowed only when the objective is in draft or future state; blank clears the text in those states.'
+        }
       },
-      ['objectiveId']
-    )
+      required: ['objectiveId'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_delete_missions',
     title: 'Delete missions',
     description:
       'Use this only after showing the resolved mission list to the user and receiving an affirmative response. Soft-deletes one to 100 missions atomically; any missing, duplicate, deleted, or unauthorized target rejects the entire request. Deleting a mission also soft-deletes its live objectives.',
-    inputSchema: objectSchema(
-      {
+    inputSchema: {
+      type: 'object',
+      properties: {
         missionIds: {
           type: 'array',
           description: 'One to 100 unique mission UUIDs or display IDs to delete.',
-          items: stringProperty('Mission UUID or workspace display ID.')
+          items: {
+            type: 'string',
+            description: 'Mission UUID or workspace display ID.'
+          }
         },
-        confirm: booleanProperty(
-          'Must be true only after the user has reviewed the resolved mission list and affirmatively approved deletion.'
-        )
+        confirm: {
+          type: 'boolean',
+          description:
+            'Must be true only after the user has reviewed the resolved mission list and affirmatively approved deletion.'
+        }
       },
-      ['missionIds', 'confirm']
-    )
+      required: ['missionIds', 'confirm'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_delete_objectives',
     title: 'Delete objectives',
     description:
       'Use this only after showing the resolved objective list to the user and receiving an affirmative response. Soft-deletes one to 100 objectives atomically; any missing, duplicate, deleted, or unauthorized target rejects the entire request. Deleting an objective also removes its live Run Queue membership.',
-    inputSchema: objectSchema(
-      {
+    inputSchema: {
+      type: 'object',
+      properties: {
         objectiveIds: {
           type: 'array',
           description: 'One to 100 unique objective UUIDs or display IDs to delete.',
-          items: stringProperty('Objective UUID or display ID.')
+          items: {
+            type: 'string',
+            description: 'Objective UUID or display ID.'
+          }
         },
-        confirm: booleanProperty(
-          'Must be true only after the user has reviewed the resolved objective list and affirmatively approved deletion.'
-        )
+        confirm: {
+          type: 'boolean',
+          description:
+            'Must be true only after the user has reviewed the resolved objective list and affirmatively approved deletion.'
+        }
       },
-      ['objectiveIds', 'confirm']
-    )
+      required: ['objectiveIds', 'confirm'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_list_run_queues',
     title: 'List Run Queues',
     description:
       "Use this to read a project's authoritative Run Queues before adding, moving, removing, or bulk-reordering entries. Compact detail is the default and includes ordering and blocking state; request full for the complete ProjectRunQueuesDto.",
-    inputSchema: objectSchema({
-      projectId: stringProperty('Optional project UUID, slug, or name.'),
-      objectiveId: stringProperty(
-        'Optional objective UUID or display id; derives the project when projectId is omitted.'
-      ),
-      missionId: stringProperty(
-        'Optional mission UUID or display id; derives the project when projectId is omitted.'
-      ),
-      queue: stringProperty('Optional Run Queue UUID or unambiguous name to return by itself.'),
-      detail: {
-        type: 'string',
-        enum: ['compact', 'full'],
-        description:
-          'Result detail: compact (default) returns queue ordering state; full returns the raw ProjectRunQueuesDto.'
-      }
-    })
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Optional project UUID, slug, or name.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Optional objective UUID or display id; derives the project when projectId is omitted.'
+        },
+        missionId: {
+          type: 'string',
+          description:
+            'Optional mission UUID or display id; derives the project when projectId is omitted.'
+        },
+        queue: {
+          type: 'string',
+          description: 'Optional Run Queue UUID or unambiguous name to return by itself.'
+        },
+        detail: {
+          type: 'string',
+          enum: ['compact', 'full'],
+          description:
+            'Result detail: compact (default) returns queue ordering state; full returns the raw ProjectRunQueuesDto.'
+        }
+      },
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_reorder_run_queue',
     title: 'Reorder Run Queue entries',
     description:
       'Use this only when the user explicitly asks to reorder every entry in one Run Queue. Supply every live entry exactly once, using entry UUIDs, objective UUIDs, or objective display ids. Running and dispatched entries cannot move. On a mismatch, the error returns the current order; re-read the queue and retry.',
-    inputSchema: objectSchema(
-      {
-        queue: stringProperty('Run Queue UUID or unambiguous name.'),
+    inputSchema: {
+      type: 'object',
+      properties: {
+        queue: {
+          type: 'string',
+          description: 'Run Queue UUID or unambiguous name.'
+        },
         orderedObjectives: {
           type: 'array',
           description:
             'Complete desired top-to-bottom entry order. Each item may be an entry UUID, objective UUID, or objective display id.',
-          items: stringProperty('Run Queue entry UUID, objective UUID, or objective display id.')
+          items: {
+            type: 'string',
+            description: 'Run Queue entry UUID, objective UUID, or objective display id.'
+          }
         },
-        projectId: stringProperty(
-          'Optional project UUID, slug, or name; disambiguates queue names.'
-        )
+        projectId: {
+          type: 'string',
+          description: 'Optional project UUID, slug, or name; disambiguates queue names.'
+        }
       },
-      ['queue', 'orderedObjectives']
-    )
+      required: ['queue', 'orderedObjectives'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_queue_objective',
     title: 'Queue objective',
     description:
       'Use this only when the user explicitly asks to add, move, or remove an objective in the project Run Queue. Queue membership is target-neutral and sequences delivery-driven launches; it does not directly launch the objective. Adding an objective also queues every not-yet-started objective after it in the mission; a removed objective moves to the end of its mission.',
-    inputSchema: objectSchema(
-      {
-        objectiveId: stringProperty('Objective UUID or display id such as coo:756.k7xm.'),
-        queue: stringProperty('Optional Run Queue UUID or unambiguous queue name.'),
-        after: stringProperty(
-          'Optional queued predecessor entry id, objective UUID, or objective display id. Its queue is used when queue is omitted.'
-        ),
-        front: booleanProperty('When true, place this objective first in the selected queue.'),
+    inputSchema: {
+      type: 'object',
+      properties: {
+        objectiveId: {
+          type: 'string',
+          description: 'Objective UUID or display id such as coo:756.k7xm.'
+        },
+        queue: {
+          type: 'string',
+          description: 'Optional Run Queue UUID or unambiguous queue name.'
+        },
+        after: {
+          type: 'string',
+          description:
+            'Optional queued predecessor entry id, objective UUID, or objective display id. Its queue is used when queue is omitted.'
+        },
+        front: {
+          type: 'boolean',
+          description: 'When true, place this objective first in the selected queue.'
+        },
         position: {
           type: 'number',
           description: 'Optional one-based insertion position in the selected queue.'
         },
-        remove: booleanProperty(
-          'When true, remove this objective from the Run Queue instead of adding or moving it.'
-        )
+        remove: {
+          type: 'boolean',
+          description:
+            'When true, remove this objective from the Run Queue instead of adding or moving it.'
+        }
       },
-      ['objectiveId']
-    )
+      required: ['objectiveId'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_manage_run_queue',
     title: 'Manage Run Queues',
     description:
       "Use this only when the user explicitly asks to create, rename, pause, resume, delete, or reorder the project's Run Queue definitions, or to retry one held queue entry. The queue-definition actions are administrative project-configuration and require a full-scope token; adding, moving, or removing objectives inside a queue uses overlord_queue_objective and overlord_reorder_run_queue instead.",
-    inputSchema: objectSchema(
-      {
+    inputSchema: {
+      type: 'object',
+      properties: {
         action: {
           type: 'string',
           enum: ['create', 'update', 'delete', 'reorder_queues', 'retry_entry'],
           description:
             "create a queue, update (rename/pause/resume) one, delete one, reorder the queue definitions, or retry_entry to clear one held entry's hold and attempt budget so the dispatcher tries it again."
         },
-        projectId: stringProperty(
-          'Project UUID, slug, or name. Required for create and reorder_queues.'
-        ),
-        queue: stringProperty(
-          'Run Queue UUID or unambiguous name. Required for update and delete.'
-        ),
-        name: stringProperty('New queue name for create, or the replacement name for update.'),
-        paused: booleanProperty(
-          'update only: true pauses dispatching from the queue, false resumes it.'
-        ),
-        moveEntriesTo: stringProperty(
-          'delete only: destination queue UUID or unambiguous name. Required when the queue still holds entries.'
-        ),
-        entry: stringProperty(
-          'retry_entry only: entry UUID, objective UUID, or objective display id. One of entry or objectiveId is required.'
-        ),
-        objectiveId: stringProperty(
-          'retry_entry only: objective UUID or display id whose live entry should be retried.'
-        ),
+        projectId: {
+          type: 'string',
+          description: 'Project UUID, slug, or name. Required for create and reorder_queues.'
+        },
+        queue: {
+          type: 'string',
+          description: 'Run Queue UUID or unambiguous name. Required for update and delete.'
+        },
+        name: {
+          type: 'string',
+          description: 'New queue name for create, or the replacement name for update.'
+        },
+        paused: {
+          type: 'boolean',
+          description: 'update only: true pauses dispatching from the queue, false resumes it.'
+        },
+        moveEntriesTo: {
+          type: 'string',
+          description:
+            'delete only: destination queue UUID or unambiguous name. Required when the queue still holds entries.'
+        },
+        entry: {
+          type: 'string',
+          description:
+            'retry_entry only: entry UUID, objective UUID, or objective display id. One of entry or objectiveId is required.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'retry_entry only: objective UUID or display id whose live entry should be retried.'
+        },
         orderedQueues: {
           type: 'array',
           description:
             'reorder_queues only: every live queue exactly once, top to bottom, by UUID or unambiguous name. The default queue must stay first.',
-          items: stringProperty('Run Queue UUID or unambiguous name.')
+          items: {
+            type: 'string',
+            description: 'Run Queue UUID or unambiguous name.'
+          }
         }
       },
-      ['action']
-    )
+      required: ['action'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_attach_session',
     title: 'Attach to mission',
     description:
-      'Attach an MCP-hosted agent session to a mission before update/ask/deliver. Pass objectiveId when the caller already knows which objective to execute.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Optional objective UUID or display id (e.g. coo:756.k7xm). Pins attach to that objective.'
-        ),
-        agent: stringProperty(`Agent identifier. Defaults to ${DEFAULT_AGENT}.`),
-        model: stringProperty('Optional model identifier.'),
-        executionTargetId: stringProperty(
-          'Optional local execution target id for resolving sibling project resource paths.'
-        )
+      'Use this only after the user asks the connected agent to begin work on a mission. It opens an MCP-hosted session for later updates and delivery. Pass objectiveId when the caller already knows which objective to execute so attach does not rediscover another one.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Pins attach to that objective, and supplies missionId when it is omitted.'
+        },
+        agent: {
+          type: 'string',
+          description: 'Agent identifier. Defaults to __OVERLORD_ADAPTER_KEY__.'
+        },
+        model: {
+          type: 'string',
+          description: 'Optional model identifier.'
+        },
+        executionTargetId: {
+          type: 'string',
+          description:
+            'Optional local execution target id for resolving sibling project resource paths.'
+        }
       },
-      []
-    )
+      required: [],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_update_session',
     title: 'Update mission session',
-    description: 'Post an update, alert, decision, or discussion summary for an attached session.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Supplies missionId when it is omitted; the session key still determines which objective the event lands on.'
-        ),
-        sessionKey: stringProperty('Session key returned by overlord_attach_session.'),
-        summary: stringProperty('Update text.'),
-        phase: stringProperty('Optional protocol phase.'),
-        eventType: stringProperty('Optional event type. Defaults to update.'),
-        changeRationales: changeRationalesProperty(
-          'Optional reviewer-facing annotations for objective-ledger file evidence.'
-        )
+    description:
+      'Use this only to post the user-requested work update, alert, decision, or discussion summary to an attached mission session.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Supplies missionId when it is omitted; the session key still determines which objective the event lands on.'
+        },
+        sessionKey: {
+          type: 'string',
+          description: 'Session key returned by overlord_attach_session.'
+        },
+        summary: {
+          type: 'string',
+          description: 'Update text.'
+        },
+        phase: {
+          type: 'string',
+          description: 'Optional protocol phase.'
+        },
+        eventType: {
+          type: 'string',
+          description: 'Optional event type. Defaults to update.'
+        },
+        changeRationales: {
+          type: 'array',
+          description: 'Optional reviewer-facing annotations for objective-ledger file evidence.',
+          items: {
+            type: 'object',
+            properties: {
+              filePath: {
+                type: 'string',
+                description: 'Repository-relative path of the changed file.'
+              },
+              label: {
+                type: 'string',
+                description: 'Short reviewer title for the change.'
+              },
+              summary: {
+                type: 'string',
+                description: 'What changed in this file.'
+              },
+              why: {
+                type: 'string',
+                description: 'Why the change was made.'
+              },
+              impact: {
+                type: 'string',
+                description: 'Behavioral impact of the change.'
+              },
+              hunks: {
+                type: 'array',
+                description:
+                  'Optional diff-hunk headers only; file contents and diffs are prohibited.',
+                items: {
+                  type: 'object',
+                  properties: {
+                    header: {
+                      type: 'string',
+                      description: 'Unified-diff hunk header.'
+                    }
+                  },
+                  required: ['header'],
+                  additionalProperties: false
+                }
+              }
+            },
+            required: ['filePath', 'label', 'summary', 'why', 'impact'],
+            additionalProperties: false
+          }
+        }
       },
-      ['sessionKey', 'summary']
-    )
+      required: ['sessionKey', 'summary'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_deliver_session',
     title: 'Deliver mission session',
     description:
-      'Deliver an attached session with explicit summary, optional change rationales, and optional human-action/tradeoff evidence.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Supplies missionId when it is omitted; the session key still determines which objective is delivered.'
-        ),
-        sessionKey: stringProperty('Session key returned by overlord_attach_session.'),
-        summary: stringProperty('Delivery summary.'),
+      'Use this only when the user-requested mission work is complete. It delivers the attached session with an explicit summary, optional file-change rationales, and optional authoritative human-action/tradeoff evidence.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Supplies missionId when it is omitted; the session key still determines which objective is delivered.'
+        },
+        sessionKey: {
+          type: 'string',
+          description: 'Session key returned by overlord_attach_session.'
+        },
+        summary: {
+          type: 'string',
+          description: 'Delivery summary.'
+        },
         artifacts: {
           type: 'array',
-          description: 'Optional mission artifacts to persist with this delivery.'
+          description:
+            'Optional mission artifacts to persist with this delivery. Each artifact has type, label, optional content, and optional HTTP(S) url.',
+          items: {
+            type: 'object',
+            properties: {
+              type: {
+                type: 'string',
+                description:
+                  'Artifact type, such as note, next_steps, test_results, decision, migration, or url.'
+              },
+              label: {
+                type: 'string',
+                description: 'Human-facing artifact label.'
+              },
+              content: {
+                type: 'string',
+                description: 'Optional text or Markdown content.'
+              },
+              url: {
+                type: 'string',
+                description: 'Optional HTTP(S) URL.'
+              }
+            },
+            required: ['type', 'label'],
+            additionalProperties: false
+          }
+        },
+        changeRationales: {
+          type: 'array',
+          description: 'Optional reviewer-facing annotations for objective-ledger file evidence.',
+          items: {
+            type: 'object',
+            properties: {
+              filePath: {
+                type: 'string',
+                description: 'Repository-relative path of the changed file.'
+              },
+              label: {
+                type: 'string',
+                description: 'Short reviewer title for the change.'
+              },
+              summary: {
+                type: 'string',
+                description: 'What changed in this file.'
+              },
+              why: {
+                type: 'string',
+                description: 'Why the change was made.'
+              },
+              impact: {
+                type: 'string',
+                description: 'Behavioral impact of the change.'
+              },
+              hunks: {
+                type: 'array',
+                description:
+                  'Optional diff-hunk headers only; file contents and diffs are prohibited.',
+                items: {
+                  type: 'object',
+                  properties: {
+                    header: {
+                      type: 'string',
+                      description: 'Unified-diff hunk header.'
+                    }
+                  },
+                  required: ['header'],
+                  additionalProperties: false
+                }
+              }
+            },
+            required: ['filePath', 'label', 'summary', 'why', 'impact'],
+            additionalProperties: false
+          }
         },
-        changeRationales: changeRationalesProperty(
-          'Optional reviewer-facing annotations for objective-ledger file evidence.'
-        ),
         humanActions: {
           type: 'array',
           description:
-            'Concrete actions a human must perform; exclude Git operations and routine review/testing. ' +
-            'Each item needs action, reason, and category, plus command (exact command or setting), verify (how to confirm it worked), and link (HTTP(S) URL or repo-relative path) whenever they exist. ' +
-            'Vague: { action: "Set up the env var for Gemini." }. Good: { action: "Add GEMINI_API_KEY to the production backend service on Railway.", reason: "Compose falls back to the raw summary without it.", category: "environment", command: "railway variables set GEMINI_API_KEY=<key> --service backend", verify: "The next delivery card shows a composed presentation.", link: ".env.example" }.',
+            'Concrete actions a human must perform outside completed agent work. Exclude Git operations and routine review/testing. Each item is read on its own from the delivery card, so give every one an action, reason, and category, plus command, verify, and link whenever they exist. Vague: { action: "Set up the env var for Gemini." }. Good: { action: "Add GEMINI_API_KEY to the production backend service on Railway.", reason: "Compose falls back to the raw summary without it.", category: "environment", command: "railway variables set GEMINI_API_KEY=<key> --service backend", verify: "The next delivery card shows a composed presentation.", link: ".env.example" }.',
           items: {
             type: 'object',
             properties: {
               action: {
                 type: 'string',
-                description: 'Required. One imperative sentence: what, where, which value.'
+                description:
+                  'Required. One imperative sentence naming what to do, where, and with which value.'
               },
               reason: {
                 type: 'string',
-                description: 'Expected. Why it is needed and what stays broken until done.'
+                description:
+                  'Expected. Why the step is needed and what stays broken until it is done.'
               },
               category: {
                 type: 'string',
@@ -664,112 +1132,291 @@ const tools = [
               },
               command: {
                 type: 'string',
-                description: 'Exact command, setting, or value to apply, verbatim.'
+                description:
+                  'The exact command, setting name, or value to apply, verbatim; placeholders in <angle brackets>.'
               },
-              verify: { type: 'string', description: 'How the operator confirms it worked.' },
-              link: { type: 'string', description: 'HTTP(S) URL or repository-relative file path.' }
+              verify: {
+                type: 'string',
+                description:
+                  'How the operator confirms it worked: a command, a URL, or the state to observe.'
+              },
+              link: {
+                type: 'string',
+                description:
+                  'An HTTP(S) URL or repository-relative file path relevant to the action. No other URI schemes.'
+              }
             },
-            required: ['action']
+            required: ['action'],
+            additionalProperties: false
           }
         },
         tradeoffsMade: {
           type: 'array',
-          description: 'Implementation decisions, alternatives considered, and rationale.'
+          description: 'Implementation decisions and why the chosen approach was preferred.',
+          items: {
+            type: 'object',
+            properties: {
+              decision: {
+                type: 'string',
+                description: 'The chosen implementation decision.'
+              },
+              alternativesConsidered: {
+                type: 'array',
+                items: {
+                  type: 'string',
+                  description: 'Alternative considered.'
+                }
+              },
+              rationale: {
+                type: 'string',
+                description: 'Why this approach was chosen.'
+              },
+              impact: {
+                type: 'string',
+                description: 'Resulting limitation or consequence.'
+              }
+            },
+            required: [],
+            additionalProperties: false
+          }
+        },
+        knownRisks: {
+          type: 'array',
+          items: {
+            type: 'string',
+            description: 'Residual risk or limitation.'
+          }
         },
-        knownRisks: { type: 'array', description: 'Residual risks or limitations.' },
         deferredWork: {
           type: 'array',
-          description:
-            'Recommended new objective outside this mission (for example an out-of-scope bug). Name the component or file and why it was left. Omit queued future objectives, leftover current-objective work, and human follow-up (those belong in humanActions).'
+          items: {
+            type: 'string',
+            description:
+              'Recommended new objective outside this mission (for example an out-of-scope bug). Name the component or file and why it was left. Omit queued future objectives, leftover current-objective work, and human follow-up (those belong in humanActions).'
+          }
         },
-        assumptions: { type: 'array', description: 'Material implementation assumptions.' }
+        assumptions: {
+          type: 'array',
+          items: {
+            type: 'string',
+            description: 'Material implementation assumption.'
+          }
+        }
       },
-      ['sessionKey', 'summary']
-    )
+      required: ['sessionKey', 'summary'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_add_artifact',
     title: 'Add mission artifact',
     description:
-      'Create a mission artifact during a turn without delivering (plan, notes, decision, URL). Provide type, label, and at least one of contentText or externalUrl. Optional sessionKey stamps provenance. Revise later with overlord_update_artifact.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Stamps objective provenance when no live sessionKey is available.'
-        ),
-        type: stringProperty(
-          'Artifact type: test_results, next_steps, note, url, decision, or migration.'
-        ),
-        label: stringProperty('Human-facing label.'),
-        contentText: stringProperty('Optional Markdown/text content.'),
-        externalUrl: stringProperty('Optional HTTP(S) URL.'),
-        sessionKey: stringProperty('Optional live session key from attach.')
+      'Use this to create a mission artifact during a turn without delivering — for example a plan, notes, decision, or URL the reviewer should see while work continues. Provide type, label, and at least one of contentText or externalUrl. Optional sessionKey stamps session/objective provenance. Revise later with overlord_update_artifact. Delivery may still attach more artifacts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Stamps objective provenance when no live sessionKey is available; sessionKey wins when both are given.'
+        },
+        type: {
+          type: 'string',
+          description: 'Artifact type: test_results, next_steps, note, url, decision, or migration.'
+        },
+        label: {
+          type: 'string',
+          description: 'Human-facing label for the artifact.'
+        },
+        contentText: {
+          type: 'string',
+          description: 'Optional Markdown/text content.'
+        },
+        externalUrl: {
+          type: 'string',
+          description: 'Optional HTTP(S) URL.'
+        },
+        sessionKey: {
+          type: 'string',
+          description:
+            'Optional live session key from attach; stamps session/objective provenance when present.'
+        }
       },
-      ['type', 'label']
-    )
+      required: ['type', 'label'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_update_artifact',
     title: 'Update mission artifact',
     description:
-      'Revise an existing mission artifact in place (label, Markdown content, and/or URL) using optimistic concurrency via expectedRevision.',
-    inputSchema: objectSchema(
-      {
-        missionId: stringProperty(
-          'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
-        ),
-        objectiveId: stringProperty(
-          'Objective UUID or display id such as coo:756.k7xm. Used only to supply missionId when it is omitted.'
-        ),
-        artifactId: stringProperty('Artifact id from mission context.'),
+      'Use this when an existing mission artifact must be revised in place (for example a plan written in an earlier objective) rather than delivering a duplicate. Requires the current artifact revision for optimistic concurrency. Provide at least one of label, contentText, or externalUrl.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        missionId: {
+          type: 'string',
+          description:
+            'Mission UUID or workspace display id. Optional when objectiveId is a display id such as coo:756.k7xm, which already names its mission.'
+        },
+        objectiveId: {
+          type: 'string',
+          description:
+            'Objective UUID or display id such as coo:756.k7xm. Used only to supply missionId when it is omitted.'
+        },
+        artifactId: {
+          type: 'string',
+          description: 'Artifact id from mission context or load-context artifacts.'
+        },
         expectedRevision: {
           type: 'number',
           description: 'Current artifact.revision. Stale values return a conflict error.'
         },
-        label: stringProperty('Optional new human-facing label.'),
-        contentText: stringProperty('Optional new Markdown/text content.'),
-        externalUrl: stringProperty('Optional HTTP(S) URL.')
+        label: {
+          type: 'string',
+          description: 'Optional new human-facing label.'
+        },
+        contentText: {
+          type: 'string',
+          description:
+            'Optional new Markdown/text content. Pass an empty string to clear text content.'
+        },
+        externalUrl: {
+          type: 'string',
+          description: 'Optional HTTP(S) URL. Pass an empty string to clear the external URL.'
+        }
       },
-      ['artifactId', 'expectedRevision']
-    )
+      required: ['artifactId', 'expectedRevision'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   },
   {
     name: 'overlord_record_work',
     title: 'Record completed work as a mission',
     description:
-      'Record work already completed in this chat as a mission that lands in review — one call, no attach/deliver cycle. Accepts optional file-change rationales and runs the delivery through the standard Gemini summarizer.',
-    inputSchema: objectSchema(
-      {
-        projectId: stringProperty('Overlord project id, slug, or name.'),
-        objective: stringProperty('What was asked and done, phrased as a completed objective.'),
-        summary: stringProperty('Reviewer-facing narrative of what changed and why.'),
-        title: stringProperty('Optional mission title.'),
-        changeRationales: changeRationalesProperty(
-          'One optional reviewer annotation per meaningful file change.'
-        ),
+      'Use this to log work already finished in this chat as a completed Overlord mission — one call, no attach/deliver cycle. It creates a mission and a single completed objective, records the file changes and their rationales, lands the mission in the review column, and runs the delivery through the standard Gemini summarizer so it reads like any other delivered mission. Provide an objective (what was asked/done) and a reviewer-facing summary; optional changeRationales may annotate meaningful file changes. Only use this when the work is genuinely complete; use overlord_create_mission for work still to be done.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description:
+            'Overlord project id, slug, or name. Overlord never chooses a project implicitly.'
+        },
+        objective: {
+          type: 'string',
+          description: 'What was asked and done, phrased as a completed objective (1-3 sentences).'
+        },
+        summary: {
+          type: 'string',
+          description: 'Reviewer-facing narrative of what changed and why.'
+        },
+        title: {
+          type: 'string',
+          description: 'Optional mission title; defaults to a title derived from the objective.'
+        },
+        changeRationales: {
+          type: 'array',
+          description: 'One optional reviewer annotation per meaningful file change.',
+          items: {
+            type: 'object',
+            properties: {
+              filePath: {
+                type: 'string',
+                description: 'Repository-relative path of the changed file.'
+              },
+              label: {
+                type: 'string',
+                description: 'Short reviewer title for the change.'
+              },
+              summary: {
+                type: 'string',
+                description: 'What changed in this file.'
+              },
+              why: {
+                type: 'string',
+                description: 'Why the change was made.'
+              },
+              impact: {
+                type: 'string',
+                description: 'Behavioral impact of the change.'
+              },
+              hunks: {
+                type: 'array',
+                description:
+                  'Optional diff-hunk headers only; file contents and diffs are prohibited.',
+                items: {
+                  type: 'object',
+                  properties: {
+                    header: {
+                      type: 'string',
+                      description: 'Unified-diff hunk header.'
+                    }
+                  },
+                  required: ['header'],
+                  additionalProperties: false
+                }
+              }
+            },
+            required: ['filePath', 'label', 'summary', 'why', 'impact'],
+            additionalProperties: false
+          }
+        },
         changedFiles: {
           type: 'array',
           description: 'Optional explicit file observations for this sessionless record.',
-          items: objectSchema(
-            {
-              filePath: stringProperty('Repository-relative path.'),
-              vcsStatus: stringProperty('Optional VCS status such as M, A, or D.')
+          items: {
+            type: 'object',
+            properties: {
+              filePath: {
+                type: 'string',
+                description: 'Repository-relative path.'
+              },
+              vcsStatus: {
+                type: 'string',
+                description: 'Optional VCS status such as M, A, or D.'
+              }
             },
-            ['filePath']
-          )
+            required: ['filePath'],
+            additionalProperties: false
+          }
         },
         artifacts: {
           type: 'array',
           description: 'Optional artifacts: next_steps, test_results, decision, note, or url.'
         }
       },
-      ['projectId', 'objective', 'summary']
-    )
+      required: ['projectId', 'objective', 'summary'],
+      additionalProperties: false
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      openWorldHint: false
+    }
   }
 ];
+// END GENERATED MCP TOOL CATALOG
 
 function optionalString(args, name) {
   const value = args?.[name];
@@ -981,13 +1628,15 @@ async function callOverlordTool(name, args) {
     });
   }
   if (name === 'overlord_update_objective') {
+    const hasTitle = typeof args.title === 'string';
     const hasAutoAdvance = typeof args.autoAdvance === 'boolean';
     const hasInstructionText = typeof args.instructionText === 'string';
-    if (!hasAutoAdvance && !hasInstructionText) {
-      throw new Error('Provide autoAdvance and/or instructionText');
+    if (!hasTitle && !hasAutoAdvance && !hasInstructionText) {
+      throw new Error('Provide title, autoAdvance, and/or instructionText');
     }
     return runProtocol('update-objective', {
       'objective-id': requiredString(args, 'objectiveId'),
+      ...(hasTitle ? { title: args.title } : {}),
       ...(hasAutoAdvance
         ? args.autoAdvance
           ? { 'auto-advance': true }
@@ -1271,7 +1920,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.51' }
+          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.53' }
         }
       });
       continue;