overlord-cli 0.2608181528.0 → 0.2608181615.0

package/dist/connectors/VERSION

@@ -1 +1 @@
-0.3.27
+0.3.28

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "overlord",
-  "version": "0.3.27",
+  "version": "0.3.28",
   "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.27",
+  "version": "0.3.28",
   "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.27",
+  "version": "0.3.28",
   "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.27",
+  "version": "0.3.28",
   "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/reference/context.md

@@ -12,7 +12,7 @@ ovld protocol attachment-upload-file --session-key <sessionKey> --objective-id <
 ovld protocol attachment-download-url --session-key <sessionKey> --attachment-id <attachment-id>
 ```
 
-The `attach` and `load-context` responses already include an `attachments` array plus `previousObjectives` and `futureObjectives` arrays — use those for `<attachment-id>` and `<objective-id>` values. The objective currently being executed is not repeated in those arrays; it is the top-level `objective`. `previousObjectives` are the objectives already worked (before the current one) and `futureObjectives` are the ones queued after it. Run `attachment-list` mid-session if new files have been uploaded since attach. `--mission-id` is optional for attachment calls when `--objective-id` or `--attachment-id` lets the server derive the mission.
+The `attach` and `load-context` responses already include an `attachments` array plus `previousObjectives` and `futureObjectives` arrays — use those for `<attachment-id>` and `<objective-id>` values. The objective currently being executed is not repeated in those arrays; it is the top-level `objective`. `previousObjectives` are the objectives already worked (before the current one) and `futureObjectives` are the ones queued after it. Run `attachment-list` mid-session if new files have been uploaded since attach. `--mission-id` is optional for attachment calls when `--objective-id` is a full display ID that lets the server derive the mission; an attachment ID alone does not carry mission scope.
 
 ## Creating artifacts during a turn
 
@@ -31,4 +31,3 @@ For large artifacts such as planning documents, architecture decisions, research
 - Prefer `add-artifact` mid-turn (or a delivery artifact) with a `note` or `decision` type, a concise summary, and the repository file path — not the full document content.
 
 This keeps the mission feed readable while preserving the full document in version control where it can be reviewed, diffed, and referenced later. If that summary artifact already exists on the mission, revise it with `update-artifact` rather than creating another copy.
-

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

@@ -164,7 +164,9 @@ const tools = [
       '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.'),
+        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.'
         ),
@@ -181,7 +183,9 @@ const tools = [
     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.'),
+        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.'
         ),
@@ -227,7 +231,9 @@ const tools = [
       '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.'),
+        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.'
         ),
@@ -246,7 +252,9 @@ const tools = [
     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.'),
+        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.'
         ),
@@ -265,7 +273,9 @@ const tools = [
       '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.'),
+        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.'
         ),
@@ -306,7 +316,9 @@ const tools = [
       '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.'),
+        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.'
         ),
@@ -328,7 +340,9 @@ const tools = [
       '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.'),
+        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.'
         ),
@@ -357,7 +371,8 @@ const tools = [
         title: stringProperty('Optional mission title.'),
         changeRationales: {
           type: 'array',
-          description: 'One entry per meaningful file change (filePath, label, summary, why, impact).'
+          description:
+            'One entry per meaningful file change (filePath, label, summary, why, impact).'
         },
         changedFiles: {
           type: 'array',
@@ -384,28 +399,22 @@ function requiredString(args, name) {
   return value;
 }
 
-/** Mission display id spelled inside an objective display id (`coo:756.k7xm`). */
-function missionFromObjectiveRef(ref) {
-  const match =
-    typeof ref === 'string' ? /^(.+:\d+)\.[0-9a-hjkmnp-tv-z]{4,5}$/i.exec(ref.trim()) : null;
-  return match ? match[1] : null;
-}
-
 /**
- * Mission/objective addressing shared by every mission-scoped tool: an objective
- * display id already names its mission, so a caller holding only that identifier
- * can address the tool with it. Mirrors `missionScopeFlags` in mcp/server.ts.
+ * 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
+ * performs local bookkeeping or calls the backend, so this standalone shim
+ * does not carry a second copy of the public-id regex.
  */
 function missionScopeFlags(args) {
   const objectiveId = optionalString(args, 'objectiveId');
-  const missionId = optionalString(args, 'missionId') ?? missionFromObjectiveRef(objectiveId);
-  if (!missionId) {
+  const missionId = optionalString(args, 'missionId');
+  if (!missionId && !objectiveId) {
     throw new Error(
       'Missing required argument: missionId (pass it, or an objective display id such as coo:756.k7xm as objectiveId)'
     );
   }
   return {
-    'mission-id': missionId,
+    ...(missionId ? { 'mission-id': missionId } : {}),
     ...(objectiveId ? { 'objective-id': objectiveId } : {})
   };
 }
@@ -478,8 +487,7 @@ function callOverlordTool(name, args) {
   if (name === 'overlord_add_objectives') {
     if (!Array.isArray(args.objectives)) throw new Error('objectives must be an array');
     return runProtocol('add-objectives', {
-      // objectiveId here only names the mission; the new objectives are appended.
-      'mission-id': missionScopeFlags(args)['mission-id'],
+      ...missionScopeFlags(args),
       'objectives-json': args.objectives
     });
   }
@@ -491,7 +499,11 @@ function callOverlordTool(name, args) {
     }
     return runProtocol('update-objective', {
       'objective-id': requiredString(args, 'objectiveId'),
-      ...(hasAutoAdvance ? (args.autoAdvance ? { 'auto-advance': true } : { 'no-auto-advance': true }) : {}),
+      ...(hasAutoAdvance
+        ? args.autoAdvance
+          ? { 'auto-advance': true }
+          : { 'no-auto-advance': true }
+        : {}),
       ...(hasInstructionText ? { 'instruction-text': requiredString(args, 'instructionText') } : {})
     });
   }
@@ -578,8 +590,7 @@ function callOverlordTool(name, args) {
       throw new Error('Provide at least one of label, contentText, or externalUrl');
     }
     return runProtocol('update-artifact', {
-      // The artifact is addressed by its own id; objectiveId only scopes the mission.
-      'mission-id': missionScopeFlags(args)['mission-id'],
+      ...missionScopeFlags(args),
       'artifact-id': requiredString(args, 'artifactId'),
       'expected-revision': String(Math.trunc(args.expectedRevision)),
       ...(hasLabel ? { label: args.label } : {}),
@@ -633,7 +644,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.27' }
+          serverInfo: { name: 'overlord-__OVERLORD_ADAPTER_KEY__', version: '0.3.28' }
         }
       });
       continue;

package/dist/index.js

@@ -20806,7 +20806,8 @@ function printProtocolHelp({ primaryCommand }) {
 Use this for mission lifecycle work from an agent runtime: create a standalone
 draft with \`${primaryCommand} protocol create\`, create-and-attach with
 \`${primaryCommand} protocol prompt\`, or attach to an existing mission with
-\`${primaryCommand} protocol attach --mission-id <mission_id>\`.
+\`${primaryCommand} protocol attach --mission-id <mission_id>\` or
+\`${primaryCommand} protocol attach --objective-id <mission_id.objective_key>\`.
 
 Backend and auth:
   Configure the REST backend before protocol calls:
@@ -20831,7 +20832,8 @@ Project discovery:
   projects with \`${primaryCommand} create-project --name "<name>"\`.
 
 Agent workflow (required):
-  1. Attach first with \`${primaryCommand} protocol attach --mission-id <id> [--objective-id <id>]\`.
+  1. Attach first with \`${primaryCommand} protocol attach --mission-id <id>\` or a full
+     objective display id via \`--objective-id <id>\`.
   2. Post progress with \`${primaryCommand} protocol update\` or liveness with
      \`${primaryCommand} protocol heartbeat\`.
   3. Ask blocking questions with \`${primaryCommand} protocol ask\` and stop work.
@@ -22784,7 +22786,7 @@ var init_select_prompt = __esm({
 
 // src/session-key.ts
 import { createHash as createHash10 } from "node:crypto";
-import { existsSync as existsSync28, mkdirSync as mkdirSync15, readFileSync as readFileSync23, rmSync as rmSync7, writeFileSync as writeFileSync14 } from "node:fs";
+import { existsSync as existsSync28, mkdirSync as mkdirSync15, readdirSync as readdirSync6, readFileSync as readFileSync23, rmSync as rmSync7, writeFileSync as writeFileSync14 } from "node:fs";
 import path32 from "node:path";
 function sessionKeyCachePath({
   missionId,
@@ -22811,10 +22813,7 @@ function readCachedSessionKey({
   objectiveId
 }) {
   if (objectiveId?.trim()) {
-    const keyed = readSessionKeyFile(
-      sessionKeyCachePath({ missionId, workingDirectory, objectiveId })
-    );
-    if (keyed) return keyed;
+    return readSessionKeyFile(sessionKeyCachePath({ missionId, workingDirectory, objectiveId }));
   }
   return readSessionKeyFile(sessionKeyCachePath({ missionId, workingDirectory }));
 }
@@ -22852,12 +22851,25 @@ function writeCachedSessionKey({
 function clearCachedSessionKey({
   missionId,
   workingDirectory,
-  objectiveId
+  objectiveId,
+  sessionKey
 }) {
   try {
-    const files = [sessionKeyCachePath({ missionId, workingDirectory })];
-    if (objectiveId?.trim()) {
-      files.push(sessionKeyCachePath({ missionId, workingDirectory, objectiveId }));
+    const files = /* @__PURE__ */ new Set();
+    const trimmedSessionKey = sessionKey?.trim();
+    if (trimmedSessionKey) {
+      const cacheDir = path32.join(resolveGlobalDataDir(), "protocol-session-keys");
+      if (existsSync28(cacheDir)) {
+        for (const name of readdirSync6(cacheDir)) {
+          const filePath = path32.join(cacheDir, name);
+          if (readSessionKeyFile(filePath) === trimmedSessionKey) files.add(filePath);
+        }
+      }
+    } else {
+      files.add(sessionKeyCachePath({ missionId, workingDirectory }));
+      if (objectiveId?.trim()) {
+        files.add(sessionKeyCachePath({ missionId, workingDirectory, objectiveId }));
+      }
     }
     for (const filePath of files) {
       if (existsSync28(filePath)) rmSync7(filePath);
@@ -23536,12 +23548,30 @@ async function runProtocolCommand({
       const attachedObjective = asRecord5(resultRecord.objective);
       const attachedObjectiveId = typeof attachedObjective.displayId === "string" && attachedObjective.displayId.trim() || typeof attachedObjective.id === "string" && attachedObjective.id.trim() || // `connect` returns a flat result rather than the full objective record.
       typeof resultRecord.objectiveDisplayId === "string" && resultRecord.objectiveDisplayId.trim() || typeof resultRecord.objectiveId === "string" && resultRecord.objectiveId.trim() || objectiveRef || null;
-      writeCachedSessionKey({
-        missionId,
-        workingDirectory,
-        sessionKey: resultRecord.sessionKey,
-        objectiveId: attachedObjectiveId
-      });
+      const objectiveAliases = new Set(
+        [
+          attachedObjectiveId,
+          typeof attachedObjective.id === "string" ? attachedObjective.id.trim() : null,
+          typeof attachedObjective.displayId === "string" ? attachedObjective.displayId.trim() : null,
+          objectiveRef ?? null
+        ].filter((value) => Boolean(value))
+      );
+      if (objectiveAliases.size === 0) {
+        writeCachedSessionKey({
+          missionId,
+          workingDirectory,
+          sessionKey: resultRecord.sessionKey
+        });
+      } else {
+        for (const objectiveAlias of objectiveAliases) {
+          writeCachedSessionKey({
+            missionId,
+            workingDirectory,
+            sessionKey: resultRecord.sessionKey,
+            objectiveId: objectiveAlias
+          });
+        }
+      }
       if (subcommand === "attach" || subcommand === "resume-follow-up") {
         writeActiveSession({
           workingDirectory,
@@ -23566,7 +23596,12 @@ async function runProtocolCommand({
     }
   }
   if (subcommand === "deliver" && missionId) {
-    clearCachedSessionKey({ missionId, workingDirectory });
+    clearCachedSessionKey({
+      missionId,
+      workingDirectory,
+      objectiveId: objectiveRef,
+      sessionKey: typeof flags["--session-key"] === "string" ? flags["--session-key"] : null
+    });
     removeActiveSession({ workingDirectory, missionId });
     clearActiveMissionPointer(workingDirectory);
     const connectorInstallsEditHook = existsSync29(path33.join(os6.homedir(), ".claude")) || existsSync29(
@@ -23975,7 +24010,15 @@ async function runManagementCommand({
     case "requests": {
       const sub = parsed.positional[0];
       if (!sub) {
-        const result2 = await runtime.backend.get("/api/agent-requests");
+        const objectiveRef = flagValue(parsed.flags, "--objective-id");
+        const missionId = flagValue(parsed.flags, "--mission-id") ?? missionDisplayIdFromObjectiveRef(objectiveRef);
+        const params = new URLSearchParams();
+        if (missionId) params.set("missionId", missionId);
+        if (objectiveRef) params.set("objectiveId", objectiveRef);
+        const query = params.size > 0 ? `?${params.toString()}` : "";
+        const result2 = await runtime.backend.get(
+          `/api/agent-requests${query}`
+        );
         if (json) printJson(result2);
         else {
           for (const item of result2.requests) {
@@ -24026,8 +24069,11 @@ async function runManagementCommand({
             message: "Usage: ovld inputs list --mission-id <id> [--json] | ovld inputs send --channel-id <id> --body <text> [--json]"
           });
         }
+        const objectiveRef = flagValue(parsed.flags, "--objective-id");
+        const params = new URLSearchParams({ missionId });
+        if (objectiveRef) params.set("objectiveId", objectiveRef);
         const result = await runtime.backend.get(
-          `/api/agent-session-inputs?missionId=${encodeURIComponent(missionId)}`
+          `/api/agent-session-inputs?${params.toString()}`
         );
         if (json) printJson(result);
         else {
@@ -24692,7 +24738,7 @@ var COMMAND_FLAGS = {
     "--no-start"
   ],
   missions: ["--status", "--query", "--project-id", "--limit"],
-  requests: ["--revision", "--decision", "--text"],
+  requests: ["--mission-id", "--objective-id", "--revision", "--decision", "--text"],
   inputs: ["--mission-id", "--objective-id", "--channel-id", "--body", "--kind"],
   mission: [],
   changes: ["--mission-id", "--objective-id"]
@@ -24812,8 +24858,11 @@ Missions:
   ${primaryCommand} attach <missionId> [agent] [--json]
   ${primaryCommand} missions list [--status <csv>] [--project-id <id>] [--json]
   ${primaryCommand} mission context|events|deliveries|artifacts|rationales <missionId> [--json]
-  ${primaryCommand} requests [--json]             List open and recent agent decisions
+  ${primaryCommand} requests [--mission-id <id>] [--objective-id <id>] [--json]
+                                               List open and recent agent decisions
   ${primaryCommand} requests resolve <id> --revision <n> --decision allow|deny|ask [--text <text>]
+  ${primaryCommand} inputs list [--mission-id <id>] [--objective-id <id>] [--json]
+                                               List instructions for one mission or objective
 
 Launch and runner:
   ${primaryCommand} launch <agent> --mission-id <missionId> [--branch <name>] [--no-worktree] [--dry-run] [--json]
@@ -24832,8 +24881,8 @@ Agents:
   connect, load-context, update, heartbeat, ask, deliver.
 
 Protocol (JSON output by default):
-  ${primaryCommand} protocol attach --mission-id <id> [--objective-id <id>]
-  ${primaryCommand} protocol update --mission-id <id> --session-key <key> --summary "..."
+  ${primaryCommand} protocol attach --mission-id <id> | --objective-id <display-id>
+  ${primaryCommand} protocol update --objective-id <display-id> --session-key <key> --summary "..."
   ${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 "..."