overlord-cli 0.2608191554.0 → 0.2608191901.0

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

@@ -80,6 +80,34 @@ function booleanProperty(description) {
   return { type: 'boolean', description };
 }
 
+function compactSearchResponse(response) {
+  const value = response?.structuredContent;
+  if (!value || value.version !== 3 || !Array.isArray(value.results)) return response;
+  const compact = {
+    ...value,
+    results: value.results.map(result => ({
+      ...result,
+      matches: Array.isArray(result.matches)
+        ? result.matches
+            .slice(0, 2)
+            .map(match => {
+              const compactMatch = { ...match };
+              delete compactMatch.snippet;
+              delete compactMatch.matchedTerms;
+              delete compactMatch.createdAt;
+              delete compactMatch.updatedAt;
+              return compactMatch;
+            })
+        : result.matches
+    }))
+  };
+  return {
+    ...response,
+    content: [{ type: 'text', text: JSON.stringify(compact, null, 2) }],
+    structuredContent: compact
+  };
+}
+
 const tools = [
   {
     name: 'overlord_resolve_project',
@@ -134,7 +162,7 @@ const tools = [
     name: 'overlord_search_missions',
     title: 'Search Overlord missions',
     description:
-      "Search missions across the caller's authorized workspaces in one organization. Returns applied filters and truncation metadata; complete and cancelled missions remain eligible by default.",
+      "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.",
     inputSchema: objectSchema({
       query: stringProperty('Search query text.'),
       status: stringProperty(
@@ -157,6 +185,23 @@ const tools = [
       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).'
+      },
+      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.'
       }
     })
   },
@@ -455,7 +500,7 @@ function missionScopeFlags(args) {
   };
 }
 
-function callOverlordTool(name, args) {
+async function callOverlordTool(name, args) {
   if (name === 'overlord_resolve_project') {
     return runProtocol('discover-project', {
       ...(optionalString(args, 'projectId')
@@ -488,8 +533,12 @@ function callOverlordTool(name, args) {
     });
   }
   if (name === 'overlord_search_missions') {
-    return runProtocol('search-missions', {
-      'response-version': '2',
+    const detail = optionalString(args, 'detail') || 'compact';
+    if (detail !== 'compact' && detail !== 'full') {
+      throw new Error("detail must be 'compact' or 'full'");
+    }
+    const response = await runProtocol('search', {
+      'response-version': '3',
       ...(optionalString(args, 'query') ? { query: requiredString(args, 'query') } : {}),
       ...(optionalString(args, 'status') ? { status: requiredString(args, 'status') } : {}),
       ...(optionalString(args, 'projectId')
@@ -508,8 +557,18 @@ function callOverlordTool(name, args) {
       ...(optionalString(args, 'to') ? { to: requiredString(args, 'to') } : {}),
       ...(typeof args.limit === 'number' && Number.isFinite(args.limit)
         ? { limit: String(Math.trunc(args.limit)) }
+        : {}),
+      ...(optionalString(args, 'entityTypes')
+        ? { 'entity-types': requiredString(args, 'entityTypes') }
+        : {}),
+      ...(optionalString(args, 'objectiveStates')
+        ? { 'objective-states': requiredString(args, 'objectiveStates') }
+        : {}),
+      ...(typeof args.matchesPerResult === 'number' && Number.isFinite(args.matchesPerResult)
+        ? { 'matches-per-result': String(Math.trunc(args.matchesPerResult)) }
         : {})
     });
+    return detail === 'compact' ? compactSearchResponse(response) : response;
   }
   if (name === 'overlord_create_mission') {
     return runProtocol('create', {

package/dist/index.js

@@ -6675,6 +6675,13 @@ var init_resource_paths = __esm({
   }
 });
 
+// ../packages/contract/dist/search.js
+var init_search = __esm({
+  "../packages/contract/dist/search.js"() {
+    "use strict";
+  }
+});
+
 // ../packages/contract/dist/index.js
 var MY_MISSIONS_COLUMNS, MY_MISSIONS_COLUMN_TYPES;
 var init_dist2 = __esm({
@@ -6684,6 +6691,7 @@ var init_dist2 = __esm({
     init_launch_variables();
     init_objective_ref();
     init_resource_paths();
+    init_search();
     MY_MISSIONS_COLUMNS = [
       { type: "next", label: "Next" },
       { type: "execute", label: "Executing" },
@@ -20909,7 +20917,8 @@ Subcommands:
   attach                 Start a mission session and return full working context
   connect                Start a lightweight session without full context assembly
   load-context           Read mission context without creating a session
-  search-missions         Find missions by keyword, status, or project
+  search                  Find grouped mission/objective/delivery matches (canonical)
+  search-missions         Compatibility alias for search
   discuss-objective      Mark a draft objective as submitted (does not start execution)
   add-objectives         Append ordered objectives to an existing mission
   update-objective       Set auto-advance and/or instruction text on an objective
@@ -21018,9 +21027,9 @@ load-context:
                                 rediscovering the mission's active objective. Required
                                 on a mission running objectives in parallel.
 
-search-missions:
+search:
   Purpose:
-    Find missions by keyword, status type, or project.
+    Find grouped mission, objective, and delivery matches by keyword, status type, or project.
   Optional:
     --query <text>              Free-text search
     --status <csv>              Comma-separated status TYPES (e.g. execute,review).
@@ -21042,11 +21051,16 @@ search-missions:
     --from <ISO-8601>           Inclusive date/time lower bound
     --to <ISO-8601>             Exclusive date/time upper bound
     --limit <n>                 Max results (default: 25)
-    --response-version <1|2>    1 (default) returns the legacy array; 2 returns
+    --response-version <1|2|3>  1 (default) returns the legacy array; 2 returns
                                 SearchMissionsResponseV2 with snippets, match
-                                evidence, appliedFilters, and truncation counts
+                                evidence, appliedFilters, and truncation counts;
+                                3 returns SearchResponseV3 with grouped objective
+                                and delivery matches
+    --entity-types <csv>        V3 only: mission,objective,delivery (default all)
+    --objective-states <csv>    V3 only: restrict matching objective states
+    --matches-per-result <n>    V3 only: child matches per mission (default 3, max 10)
   Returns:
-    JSON with matching missions (v1) or the versioned search envelope (v2).
+    JSON with matching missions (v1) or the versioned search envelope (v2/v3).
 
 statuses:
   Purpose:
@@ -21402,6 +21416,7 @@ var init_protocol_help = __esm({
       "record-touched",
       "record-work",
       "resume-follow-up",
+      "search",
       "search-missions",
       "update",
       "update-artifact",
@@ -25031,7 +25046,7 @@ Protocol (JSON output by default):
   ${primaryCommand} protocol heartbeat --mission-id <id> --session-key <key>
   ${primaryCommand} protocol ask --mission-id <id> --session-key <key> --question "..."
   ${primaryCommand} protocol deliver --mission-id <id> --session-key <key> --summary "..."
-  ${primaryCommand} protocol search-missions --query "<text>" --status execute,review
+  ${primaryCommand} protocol search --query "<text>" --status execute,review
   ${primaryCommand} protocol statuses --project-id <id|slug|name>
   ${primaryCommand} protocol load-context --mission-id <id>
   ${primaryCommand} protocol help