overlord-cli 0.2607191132.0 → 0.2607191710.0

package/dist/connectors/VERSION

@@ -1 +1 @@
-0.3.3
+0.3.4

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

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "overlord",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Chat-driven access to Overlord mission protocol workflows with hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/antigravity/scripts/overlord-mcp.mjs

@@ -188,7 +188,7 @@ const tools = [
     name: 'overlord_deliver_session',
     title: 'Deliver mission session',
     description:
-      'Deliver an attached session with explicit summary and optional change rationales.',
+      '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.'),
@@ -201,7 +201,19 @@ const tools = [
         changeRationales: {
           type: 'array',
           description: 'Explicit change rationale objects, if files were changed.'
-        }
+        },
+        humanActions: {
+          type: 'array',
+          description:
+            'Concrete actions a human must perform; exclude Git operations and routine review/testing.'
+        },
+        tradeoffsMade: {
+          type: 'array',
+          description: 'Implementation decisions, alternatives considered, and rationale.'
+        },
+        knownRisks: { type: 'array', description: 'Residual risks or limitations.' },
+        deferredWork: { type: 'array', description: 'Intentionally deferred work.' },
+        assumptions: { type: 'array', description: 'Material implementation assumptions.' }
       },
       ['missionId', 'sessionKey', 'summary']
     )
@@ -294,6 +306,28 @@ function callOverlordTool(name, args) {
       ...(args.noFileChanges === true ? { 'no-file-changes': true } : {}),
       ...(Array.isArray(args.changeRationales)
         ? { 'change-rationales-json': args.changeRationales }
+        : {}),
+      ...(Array.isArray(args.humanActions) ||
+      Array.isArray(args.tradeoffsMade) ||
+      Array.isArray(args.knownRisks) ||
+      Array.isArray(args.deferredWork) ||
+      Array.isArray(args.assumptions)
+        ? {
+            payload: {
+              deliveryReport: {
+                schemaVersion: 1,
+                agentReport: {
+                  ...(Array.isArray(args.humanActions) ? { humanActions: args.humanActions } : {}),
+                  ...(Array.isArray(args.tradeoffsMade)
+                    ? { tradeoffsMade: args.tradeoffsMade }
+                    : {}),
+                  ...(Array.isArray(args.knownRisks) ? { knownRisks: args.knownRisks } : {}),
+                  ...(Array.isArray(args.deferredWork) ? { deferredWork: args.deferredWork } : {}),
+                  ...(Array.isArray(args.assumptions) ? { assumptions: args.assumptions } : {})
+                }
+              }
+            }
+          }
         : {})
     });
   }
@@ -328,7 +362,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-antigravity', version: '0.3.3' }
+          serverInfo: { name: 'overlord-antigravity', version: '0.3.4' }
         }
       });
       continue;

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

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "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.3",
+  "version": "0.3.4",
   "description": "Chat-driven access to Overlord mission protocol workflows with hook-driven activity capture.",
   "author": {
     "name": "Cooperativ",

package/dist/connectors/adapters/codex/scripts/overlord-mcp.mjs

@@ -188,7 +188,7 @@ const tools = [
     name: 'overlord_deliver_session',
     title: 'Deliver mission session',
     description:
-      'Deliver an attached session with explicit summary and optional change rationales.',
+      '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.'),
@@ -201,7 +201,19 @@ const tools = [
         changeRationales: {
           type: 'array',
           description: 'Explicit change rationale objects, if files were changed.'
-        }
+        },
+        humanActions: {
+          type: 'array',
+          description:
+            'Concrete actions a human must perform; exclude Git operations and routine review/testing.'
+        },
+        tradeoffsMade: {
+          type: 'array',
+          description: 'Implementation decisions, alternatives considered, and rationale.'
+        },
+        knownRisks: { type: 'array', description: 'Residual risks or limitations.' },
+        deferredWork: { type: 'array', description: 'Intentionally deferred work.' },
+        assumptions: { type: 'array', description: 'Material implementation assumptions.' }
       },
       ['missionId', 'sessionKey', 'summary']
     )
@@ -294,6 +306,28 @@ function callOverlordTool(name, args) {
       ...(args.noFileChanges === true ? { 'no-file-changes': true } : {}),
       ...(Array.isArray(args.changeRationales)
         ? { 'change-rationales-json': args.changeRationales }
+        : {}),
+      ...(Array.isArray(args.humanActions) ||
+      Array.isArray(args.tradeoffsMade) ||
+      Array.isArray(args.knownRisks) ||
+      Array.isArray(args.deferredWork) ||
+      Array.isArray(args.assumptions)
+        ? {
+            payload: {
+              deliveryReport: {
+                schemaVersion: 1,
+                agentReport: {
+                  ...(Array.isArray(args.humanActions) ? { humanActions: args.humanActions } : {}),
+                  ...(Array.isArray(args.tradeoffsMade)
+                    ? { tradeoffsMade: args.tradeoffsMade }
+                    : {}),
+                  ...(Array.isArray(args.knownRisks) ? { knownRisks: args.knownRisks } : {}),
+                  ...(Array.isArray(args.deferredWork) ? { deferredWork: args.deferredWork } : {}),
+                  ...(Array.isArray(args.assumptions) ? { assumptions: args.assumptions } : {})
+                }
+              }
+            }
+          }
         : {})
     });
   }
@@ -328,7 +362,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-codex', version: '0.3.3' }
+          serverInfo: { name: 'overlord-codex', version: '0.3.4' }
         }
       });
       continue;

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

@@ -1,6 +1,6 @@
 {
   "name": "overlord",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "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/adapters/cursor/scripts/overlord-mcp.mjs

@@ -188,7 +188,7 @@ const tools = [
     name: 'overlord_deliver_session',
     title: 'Deliver mission session',
     description:
-      'Deliver an attached session with explicit summary and optional change rationales.',
+      '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.'),
@@ -201,7 +201,19 @@ const tools = [
         changeRationales: {
           type: 'array',
           description: 'Explicit change rationale objects, if files were changed.'
-        }
+        },
+        humanActions: {
+          type: 'array',
+          description:
+            'Concrete actions a human must perform; exclude Git operations and routine review/testing.'
+        },
+        tradeoffsMade: {
+          type: 'array',
+          description: 'Implementation decisions, alternatives considered, and rationale.'
+        },
+        knownRisks: { type: 'array', description: 'Residual risks or limitations.' },
+        deferredWork: { type: 'array', description: 'Intentionally deferred work.' },
+        assumptions: { type: 'array', description: 'Material implementation assumptions.' }
       },
       ['missionId', 'sessionKey', 'summary']
     )
@@ -294,6 +306,28 @@ function callOverlordTool(name, args) {
       ...(args.noFileChanges === true ? { 'no-file-changes': true } : {}),
       ...(Array.isArray(args.changeRationales)
         ? { 'change-rationales-json': args.changeRationales }
+        : {}),
+      ...(Array.isArray(args.humanActions) ||
+      Array.isArray(args.tradeoffsMade) ||
+      Array.isArray(args.knownRisks) ||
+      Array.isArray(args.deferredWork) ||
+      Array.isArray(args.assumptions)
+        ? {
+            payload: {
+              deliveryReport: {
+                schemaVersion: 1,
+                agentReport: {
+                  ...(Array.isArray(args.humanActions) ? { humanActions: args.humanActions } : {}),
+                  ...(Array.isArray(args.tradeoffsMade)
+                    ? { tradeoffsMade: args.tradeoffsMade }
+                    : {}),
+                  ...(Array.isArray(args.knownRisks) ? { knownRisks: args.knownRisks } : {}),
+                  ...(Array.isArray(args.deferredWork) ? { deferredWork: args.deferredWork } : {}),
+                  ...(Array.isArray(args.assumptions) ? { assumptions: args.assumptions } : {})
+                }
+              }
+            }
+          }
         : {})
     });
   }
@@ -328,7 +362,7 @@ process.stdin.on('data', async chunk => {
         result: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: { tools: { listChanged: false } },
-          serverInfo: { name: 'overlord-cursor', version: '0.3.3' }
+          serverInfo: { name: 'overlord-cursor', version: '0.3.4' }
         }
       });
       continue;

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

@@ -22,6 +22,12 @@ Use this mode when the prompt already contains a mission ID or explicitly says t
 6. If blocked, call `ovld protocol ask --session-key <sessionKey> --mission-id <mission_id> --question "..."` and stop.
 7. Deliver last with `ovld protocol deliver --session-key <sessionKey> --mission-id <mission_id> --summary "..."`, including `changeRationales` only for meaningful behavioral file changes made as part of this mission.
 
+At delivery, provide `deliveryReport.agentReport` through `--payload-json` / `--payload-file`: use
+`humanActions`, `tradeoffsMade`, `knownRisks`, `deferredWork`, and `assumptions`, with empty arrays
+when none apply. Human actions are concrete work a user must perform outside completed agent work;
+never include Git operations or routine review/testing. Tradeoffs record the implementation decision,
+alternatives considered, and rationale. These fields improve review visibility but never block delivery.
+
 For full command syntax, flags, phase values, and event types see **CLI Command Reference** below.
 
 ## Missions vs Objectives
@@ -164,6 +170,33 @@ EOF
 
 If `heartbeat` succeeds but `deliver` or `update` fails, the session is likely fine — retry with large JSON on stdin instead of inline `--*-json`.
 
+### Delivery Evidence
+
+Send agent-authored facts in the delivery payload; Overlord stores an immediate deterministic
+presentation, so do not wait for or invoke an AI provider.
+
+```json
+{
+  "deliveryReport": {
+    "schemaVersion": 1,
+    "agentReport": {
+      "humanActions": [],
+      "tradeoffsMade": [],
+      "knownRisks": [],
+      "deferredWork": [],
+      "assumptions": []
+    }
+  }
+}
+```
+
+Only list a human action when a person must perform a concrete non-Git step outside the
+agent's completed work (for example, add a secret, run a production migration, deploy, or
+configure an external integration). Never list committing, pushing, opening a pull request,
+reviewing code, or ordinary tests. A tradeoff must state the decision, alternatives considered,
+and rationale. Missing evidence is normalized to empty arrays for compatibility, but agents
+should report it when applicable.
+
 ### Preflight: check your changes before delivering
 
 Never hand-triage `git status` to figure out which dirty files are yours. Run the preflight first:

package/dist/index.js

@@ -14673,6 +14673,9 @@ deliver:
     --mission-id <id>
     --summary or --summary-file <path|->
     or: --payload-json / --payload-file <path|-> with { summary, artifacts, changeRationales }
+    The payload may also include deliveryReport: { schemaVersion: 1, agentReport: {
+      humanActions, tradeoffsMade, knownRisks, deferredWork, assumptions } }. Use empty arrays
+    when none apply. Human actions exclude Git operations and routine review/testing.
   Optional:
     --artifacts-json / --artifacts-file <path|->
     --change-rationales-json / --change-rationales-file <path|->
@@ -17171,7 +17174,7 @@ async function runManagementCommand({
         events: `/api/missions/${encodeURIComponent(missionId)}/events`,
         artifacts: `/api/missions/${encodeURIComponent(missionId)}/artifacts`,
         rationales: `/api/missions/${encodeURIComponent(missionId)}/file-changes`,
-        deliveries: `/api/missions/${encodeURIComponent(missionId)}/events`
+        deliveries: `/api/missions/${encodeURIComponent(missionId)}/deliveries`
       };
       const path27 = sub ? pathBySub[sub] : void 0;
       if (!path27) {