overlord-cli 0.2608181615.0 → 0.2608191441.0

package/dist/connectors/VERSION

@@ -1 +1 @@
-0.3.28
+0.3.29

package/dist/connectors/adapters/antigravity/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "overlord",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Chat-driven access to Overlord mission protocol workflows through skills and MCP.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Overlord mission protocol workflow for Claude Code — attach/update/ask/deliver, slash commands, and hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Chat-driven access to Overlord mission protocol workflows with hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/cursor/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.3.28",
+  "version": "0.3.29",
   "description": "Overlord mission protocol workflow for Cursor — attach/update/ask/deliver, slash commands, MCP bridge, and follow-up capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/core/overlord-mission/SKILL.md

@@ -84,7 +84,7 @@ Use this mode when the conversation starts normally and the user asks the agent
    When you open or discuss an existing mission that has a draft objective, submit it with `ovld protocol discuss-objective --mission-id <mission_id>`.
 4. If the user wants to route the current session onto an existing mission by ID, run `ovld protocol connect --mission-id <mission_id>` (add `--objective-id <objective_id>` to pin the session to a specific objective).
 5. If the user wants to establish a persistent session with a mission by ID, run `ovld protocol attach --mission-id <mission_id>`.
-6. If the user wants to find a mission but does not know the ID, run `ovld protocol search-missions --query "..." --status next-up,execute` and ask the user to confirm.
+6. If the user wants to find a mission but does not know the ID, run `ovld protocol search-missions --query "..." --status execute,review` and ask the user to confirm.
 7. If you need to understand project routing before prompting, use `ovld protocol discover-project`.
 8. If the user wants to **record work that is already finished** in this chat (for example, something you just built in a chat app) as a completed mission, run `ovld protocol record-work` (or the hosted `overlord_record_work` MCP tool). This creates a mission with one completed objective, records the file changes with rationales, lands it in the review column, and runs the standard Gemini delivery summary — all in one call, with no `attach`/`deliver`. Do **not** use it for in-progress work. The exact submission format is in [reference/record-work.md](reference/record-work.md).
 9. If you need other lifecycle commands or flags, run `ovld protocol help` and use the real subcommand list instead of guessing.

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

@@ -110,14 +110,37 @@ const tools = [
       ['name']
     )
   },
+  {
+    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.')
+      },
+      ['projectId']
+    )
+  },
   {
     name: 'overlord_search_missions',
     title: 'Search Overlord missions',
-    description: 'Search missions in the OAuth-bound workspace.',
+    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.",
     inputSchema: objectSchema({
       query: stringProperty('Search query text.'),
-      status: stringProperty('Comma-separated status types, such as draft,execute,review.'),
-      projectId: stringProperty('Optional project id, slug, or name.'),
+      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 stable Overlord project UUID. Resolve a human project reference first.'
+      ),
+      resourceKey: stringProperty(
+        'Optional logical resource key, matched by name within selected projects.'
+      ),
+      dateField: stringProperty('Date column for an explicit range: createdAt or updatedAt.'),
+      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.'
@@ -399,6 +422,17 @@ function requiredString(args, name) {
   return value;
 }
 
+function optionalProjectUuid(args) {
+  const projectId = optionalString(args, 'projectId');
+  if (!projectId) return null;
+  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(projectId)) {
+    throw new Error(
+      'projectId must be a stable Overlord project UUID; resolve human references first'
+    );
+  }
+  return projectId;
+}
+
 /**
  * Forward mission/objective addressing to the CLI. The CLI owns the shared
  * `@overlord/contract` parser and derives a mission from a display id before it
@@ -440,13 +474,25 @@ function callOverlordTool(name, args) {
       ...(optionalString(args, 'slug') ? { slug: requiredString(args, 'slug') } : {})
     });
   }
+  if (name === 'overlord_list_project_statuses') {
+    return runProtocol('statuses', {
+      'project-id': requiredString(args, 'projectId')
+    });
+  }
   if (name === 'overlord_search_missions') {
     return runProtocol('search-missions', {
+      'response-version': '2',
       ...(optionalString(args, 'query') ? { query: requiredString(args, 'query') } : {}),
       ...(optionalString(args, 'status') ? { status: requiredString(args, 'status') } : {}),
-      ...(optionalString(args, 'projectId')
-        ? { 'project-id': requiredString(args, 'projectId') }
+      ...(optionalProjectUuid(args) ? { 'project-id': optionalProjectUuid(args) } : {}),
+      ...(optionalString(args, 'resourceKey')
+        ? { 'resource-key': requiredString(args, 'resourceKey') }
+        : {}),
+      ...(optionalString(args, 'dateField')
+        ? { 'date-field': requiredString(args, 'dateField') }
         : {}),
+      ...(optionalString(args, 'from') ? { from: requiredString(args, 'from') } : {}),
+      ...(optionalString(args, 'to') ? { to: requiredString(args, 'to') } : {}),
       ...(typeof args.limit === 'number' && Number.isFinite(args.limit)
         ? { limit: String(Math.trunc(args.limit)) }
         : {})
@@ -644,7 +690,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.28' }
+          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.29' }
         }
       });
       continue;

package/dist/index.js

@@ -18725,6 +18725,13 @@ var init_migration_ledger = __esm({
   }
 });
 
+// ../database/dist/next-status-type-migration-runtime.js
+var init_next_status_type_migration_runtime = __esm({
+  "../database/dist/next-status-type-migration-runtime.js"() {
+    "use strict";
+  }
+});
+
 // ../database/dist/objective-display-key.js
 var init_objective_display_key = __esm({
   "../database/dist/objective-display-key.js"() {
@@ -18749,6 +18756,13 @@ var init_project_resources_resource_key_migration_runtime = __esm({
   }
 });
 
+// ../database/dist/project-statuses-migration-runtime.js
+var init_project_statuses_migration_runtime = __esm({
+  "../database/dist/project-statuses-migration-runtime.js"() {
+    "use strict";
+  }
+});
+
 // ../database/dist/connection.js
 var init_connection = __esm({
   "../database/dist/connection.js"() {
@@ -18758,8 +18772,10 @@ var init_connection = __esm({
     init_ext_everhour_migration_runtime();
     init_local_paths();
     init_migration_ledger();
+    init_next_status_type_migration_runtime();
     init_objective_display_key_migration_runtime();
     init_project_resources_resource_key_migration_runtime();
+    init_project_statuses_migration_runtime();
   }
 });
 
@@ -18787,6 +18803,7 @@ var init_migrate_postgres = __esm({
     init_ext_everhour_migration_runtime();
     init_migration_ledger();
     init_objective_display_key_migration_runtime();
+    init_project_statuses_migration_runtime();
   }
 });
 
@@ -20960,14 +20977,37 @@ load-context:
 
 search-missions:
   Purpose:
-    Find missions by keyword, status, or project.
+    Find missions by keyword, status type, or project.
   Optional:
     --query <text>              Free-text search
-    --status <csv>              Comma-separated statuses (e.g. next-up,execute)
-    --project-id <id>           Restrict to one project
+    --status <csv>              Comma-separated status TYPES (e.g. execute,review).
+                                Types are workspace-invariant: draft, next, execute, review,
+                                complete, blocked, cancelled. Project-defined status
+                                names (board column labels) are not accepted here \u2014
+                                use \`statuses\` to read one project's names.
+    --project-id <id|slug|name> Restrict to one project (CLI resolves human references)
+    --resource-key <csv>        Restrict to logical resource key names
+    --date-field <createdAt|updatedAt>
+                                Date column for explicit range filtering
+    --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
+                                SearchMissionsResponseV2 with snippets, match
+                                evidence, appliedFilters, and truncation counts
   Returns:
-    JSON with matching missions.
+    JSON with matching missions (v1) or the versioned search envelope (v2).
+
+statuses:
+  Purpose:
+    List one project's board columns. Statuses are defined per project, so their
+    names and order vary between projects in the same workspace; the status TYPE
+    of each column does not.
+  Required:
+    --project-id <id>           Project id, slug, or name
+  Returns:
+    JSON array of statuses ordered by position, each with id, projectId, key,
+    name, type, position, isDefault, and isTerminal.
 
 discuss-objective:
   Purpose:
@@ -23988,8 +24028,10 @@ async function runManagementCommand({
       const query = flagValue(parsed.flags, "--query");
       const projectId = flagValue(parsed.flags, "--project-id");
       const limit = flagValue(parsed.flags, "--limit");
+      const statusTypes = (flagValue(parsed.flags, "--status") ?? "").split(",").map((value) => value.trim()).filter((value) => value !== "");
       if (query) params.set("q", query);
       if (projectId) params.set("projectId", projectId);
+      if (statusTypes.length > 0) params.set("statusTypes", statusTypes.join(","));
       if (limit) params.set("limit", limit);
       let missions;
       const result = await runtime.backend.get(
@@ -24007,6 +24049,45 @@ async function runManagementCommand({
       }
       return;
     }
+    // Board columns are project-scoped (coo:752): two projects in one workspace
+    // may name and order their statuses differently, so the only way to discover
+    // a board's columns is to ask the project that owns them. Read-only —
+    // status definitions are edited in project settings.
+    case "statuses": {
+      const sub = parsed.positional[0];
+      if (sub !== "list") {
+        throw new CliError({
+          message: "Usage: ovld statuses list --project-id <id|slug|name> [--json]"
+        });
+      }
+      const projectRef = flagValue(parsed.flags, "--project-id");
+      if (!projectRef) {
+        throw new CliError({
+          message: "Missing --project-id (accepts a project id, slug, or name)"
+        });
+      }
+      const project = await resolveProjectByIdOrName({
+        backend: runtime.backend,
+        projectRef
+      });
+      const statuses = await runtime.backend.get(
+        `/api/projects/${encodeURIComponent(project.id)}/statuses`
+      );
+      if (json) printJson({ projectId: project.id, statuses });
+      else {
+        for (const status of statuses) {
+          const record = asRecord5(status);
+          const flags = [
+            record.isDefault === true ? "default" : null,
+            record.isTerminal === true ? "terminal" : null
+          ].filter(Boolean).join(",");
+          console.log(
+            `${record.position ?? ""}	${record.key ?? ""}	${record.name ?? ""}	${record.type ?? ""}	${flags}`
+          );
+        }
+      }
+      return;
+    }
     case "requests": {
       const sub = parsed.positional[0];
       if (!sub) {
@@ -24738,6 +24819,7 @@ var COMMAND_FLAGS = {
     "--no-start"
   ],
   missions: ["--status", "--query", "--project-id", "--limit"],
+  statuses: ["--project-id"],
   requests: ["--mission-id", "--objective-id", "--revision", "--decision", "--text"],
   inputs: ["--mission-id", "--objective-id", "--channel-id", "--body", "--kind"],
   mission: [],
@@ -24857,6 +24939,13 @@ Missions:
   ${primaryCommand} prompt "<objective>" [--json]
   ${primaryCommand} attach <missionId> [agent] [--json]
   ${primaryCommand} missions list [--status <csv>] [--project-id <id>] [--json]
+                                               --status filters status TYPES
+                                               (draft,execute,review,complete,blocked,cancelled),
+                                               not the project-defined status names on a board
+  ${primaryCommand} statuses list --project-id <id|slug|name> [--json]
+                                               List one project's board columns (key, name, type,
+                                               position, default/terminal). Statuses are defined
+                                               per project, so they vary between projects.
   ${primaryCommand} mission context|events|deliveries|artifacts|rationales <missionId> [--json]
   ${primaryCommand} requests [--mission-id <id>] [--objective-id <id>] [--json]
                                                List open and recent agent decisions
@@ -24886,7 +24975,8 @@ 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 next-up,execute
+  ${primaryCommand} protocol search-missions --query "<text>" --status execute,review
+  ${primaryCommand} protocol statuses --project-id <id|slug|name>
   ${primaryCommand} protocol load-context --mission-id <id>
   ${primaryCommand} protocol help
 
@@ -24939,6 +25029,7 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "resume",
   "runner",
   "missions",
+  "statuses",
   "requests",
   "inputs",
   "inbox",