overlord-cli 0.2608191441.0 → 0.2608191554.0

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

@@ -85,9 +85,12 @@ 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.',
+      "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.'
       )
@@ -117,7 +120,12 @@ const tools = [
       "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: 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.'
+        )
       },
       ['projectId']
     )
@@ -133,12 +141,17 @@ const tools = [
         '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.'
+        "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 or updatedAt.'),
+      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: {
@@ -422,17 +435,6 @@ 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
@@ -459,6 +461,9 @@ function callOverlordTool(name, args) {
       ...(optionalString(args, 'projectId')
         ? { 'project-id': requiredString(args, 'projectId') }
         : {}),
+      ...(optionalString(args, 'workspaceId')
+        ? { 'workspace-id': requiredString(args, 'workspaceId') }
+        : {}),
       ...(optionalString(args, 'directory') ? { directory: requiredString(args, 'directory') } : {})
     });
   }
@@ -476,7 +481,10 @@ function callOverlordTool(name, args) {
   }
   if (name === 'overlord_list_project_statuses') {
     return runProtocol('statuses', {
-      'project-id': requiredString(args, 'projectId')
+      'project-id': requiredString(args, 'projectId'),
+      ...(optionalString(args, 'workspaceId')
+        ? { 'workspace-id': requiredString(args, 'workspaceId') }
+        : {})
     });
   }
   if (name === 'overlord_search_missions') {
@@ -484,7 +492,12 @@ function callOverlordTool(name, args) {
       'response-version': '2',
       ...(optionalString(args, 'query') ? { query: requiredString(args, 'query') } : {}),
       ...(optionalString(args, 'status') ? { status: requiredString(args, 'status') } : {}),
-      ...(optionalProjectUuid(args) ? { 'project-id': optionalProjectUuid(args) } : {}),
+      ...(optionalString(args, 'projectId')
+        ? { 'project-id': requiredString(args, 'projectId') }
+        : {}),
+      ...(optionalString(args, 'workspaceId')
+        ? { 'workspace-id': requiredString(args, 'workspaceId') }
+        : {}),
       ...(optionalString(args, 'resourceKey')
         ? { 'resource-key': requiredString(args, 'resourceKey') }
         : {}),

package/dist/index.js

@@ -6676,6 +6676,7 @@ var init_resource_paths = __esm({
 });
 
 // ../packages/contract/dist/index.js
+var MY_MISSIONS_COLUMNS, MY_MISSIONS_COLUMN_TYPES;
 var init_dist2 = __esm({
   "../packages/contract/dist/index.js"() {
     "use strict";
@@ -6683,6 +6684,13 @@ var init_dist2 = __esm({
     init_launch_variables();
     init_objective_ref();
     init_resource_paths();
+    MY_MISSIONS_COLUMNS = [
+      { type: "next", label: "Next" },
+      { type: "execute", label: "Executing" },
+      { type: "review", label: "Review" },
+      { type: "complete", label: "Completed" }
+    ];
+    MY_MISSIONS_COLUMN_TYPES = MY_MISSIONS_COLUMNS.map((column) => column.type);
   }
 });
 
@@ -19496,7 +19504,8 @@ function discoverProjectJsonFromFilesystem({
 }
 async function resolveProjectByIdOrName({
   backend,
-  projectRef
+  projectRef,
+  workspaceRef
 }) {
   const trimmed8 = projectRef.trim();
   try {
@@ -19505,11 +19514,45 @@ async function resolveProjectByIdOrName({
     if (!(error instanceof CliError) || !/project not found/i.test(error.message)) throw error;
   }
   const projects = await listAccessibleProjects({ backend });
-  const match = projects.find((project) => project.name === trimmed8) ?? projects.find((project) => project.slug === trimmed8);
-  if (!match) {
+  const needle = trimmed8.toLowerCase();
+  const byName = projects.filter((project) => project.name.toLowerCase() === needle);
+  const matches = byName.length > 0 ? byName : projects.filter((project) => project.slug.toLowerCase() === needle);
+  if (matches.length === 0) {
     throw new CliError({ message: `Project not found: ${trimmed8}` });
   }
-  return match;
+  const narrowed = await narrowByWorkspace({ backend, matches, workspaceRef });
+  if (narrowed.length === 1) return narrowed[0];
+  const workspaces = await workspaceLabels({ backend });
+  const candidates = narrowed.map(
+    (project) => `  ${project.id}  (workspace: ${workspaces.get(project.workspaceId) ?? project.workspaceId})`
+  ).join("\n");
+  throw new CliError({
+    message: `Project reference matches ${narrowed.length} projects: ${trimmed8}
+${candidates}
+Re-run with --workspace-id <id|slug|name>, or pass the project id directly.`
+  });
+}
+async function workspaceLabels({
+  backend
+}) {
+  const workspaces = await backend.get("/api/workspaces");
+  return new Map(workspaces.map((workspace) => [workspace.id, workspace.name]));
+}
+async function narrowByWorkspace({
+  backend,
+  matches,
+  workspaceRef
+}) {
+  const hint = workspaceRef?.trim().toLowerCase();
+  if (!hint || matches.length <= 1) return matches;
+  const workspaces = await backend.get("/api/workspaces");
+  const targets = new Set(
+    workspaces.filter(
+      (workspace) => workspace.id.toLowerCase() === hint || workspace.slug.toLowerCase() === hint || workspace.name.toLowerCase() === hint
+    ).map((workspace) => workspace.id)
+  );
+  const narrowed = matches.filter((project) => targets.has(project.workspaceId));
+  return narrowed.length > 0 ? narrowed : matches;
 }
 async function tryResolveProjectByIdOrName({
   backend,
@@ -20985,10 +21028,17 @@ search-missions:
                                 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)
+    --project-id <id|slug|name> Restrict to one project. Names are matched
+                                case-insensitively across the workspaces you can reach;
+                                a name matching in two workspaces returns
+                                project_selection_required listing the candidates.
+    --workspace-id <id|slug|name>
+                                Narrow an ambiguous --project-id
     --resource-key <csv>        Restrict to logical resource key names
-    --date-field <createdAt|updatedAt>
-                                Date column for explicit range filtering
+    --date-field <createdAt|updatedAt|dueDatetime>
+                                Date column for explicit range filtering. Use dueDatetime
+                                for "scheduled"/"due" questions; missions with no due date
+                                are excluded from a dueDatetime range.
     --from <ISO-8601>           Inclusive date/time lower bound
     --to <ISO-8601>             Exclusive date/time upper bound
     --limit <n>                 Max results (default: 25)
@@ -24021,12 +24071,17 @@ async function runManagementCommand({
       const sub = parsed.positional[0];
       if (sub !== "list") {
         throw new CliError({
-          message: "Usage: ovld missions list [--status <csv>] [--project-id <id>] [--json]"
+          message: "Usage: ovld missions list [--status <csv>] [--project-id <id|slug|name>] [--workspace-id <id|slug|name>] [--json]"
         });
       }
       const params = new URLSearchParams();
       const query = flagValue(parsed.flags, "--query");
-      const projectId = flagValue(parsed.flags, "--project-id");
+      const projectRef = flagValue(parsed.flags, "--project-id");
+      const projectId = projectRef ? (await resolveProjectByIdOrName({
+        backend: runtime.backend,
+        projectRef,
+        workspaceRef: flagValue(parsed.flags, "--workspace-id")
+      })).id : void 0;
       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);
@@ -24068,7 +24123,8 @@ async function runManagementCommand({
       }
       const project = await resolveProjectByIdOrName({
         backend: runtime.backend,
-        projectRef
+        projectRef,
+        workspaceRef: flagValue(parsed.flags, "--workspace-id")
       });
       const statuses = await runtime.backend.get(
         `/api/projects/${encodeURIComponent(project.id)}/statuses`