opentasks 0.1.3 → 0.2.0

package/dist/materialization/snapshot.js

@@ -4,7 +4,7 @@
  * Builds self-contained MaterializationSnapshots from GraphStore nodes and edges.
  * Snapshots contain everything needed to reconstruct the node in a fresh graph.
  */
-import { resolveGitDir, getGitRemoteUrl, getGitBranch, getGitHead, } from './graph-id.js';
+import { resolveGitDir, getGitRemoteUrl, getGitBranch, getGitHead } from './graph-id.js';
 // ============================================================================
 // Provenance Resolution
 // ============================================================================

package/dist/materialization/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/materialization/snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/materialization/snapshot.ts"],"names":[],"mappings":"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"}

package/dist/materialization/types.d.ts

@@ -4,6 +4,8 @@
  * Type definitions for the pluggable archival layer that captures
  * materialized external node snapshots to durable storage.
  */
+import type { GraphStore } from '../graph/store.js';
+import type { ExternalNode } from '../schema/nodes.js';
 /**
  * Provenance — where a snapshot's data originated
  */
@@ -253,13 +255,13 @@ export interface RematerializeAllResult {
  */
 export interface MaterializationArchiver {
     /** Called by the auto-linker when a session lifecycle event occurs */
-    onSessionEvent(eventType: string, sessionUri: string, store: import('../graph/store.js').GraphStore): Promise<ArchiveEventResult>;
+    onSessionEvent(eventType: string, sessionUri: string, store: GraphStore): Promise<ArchiveEventResult>;
     /** Manually archive a specific node by URI */
-    archiveNode(uri: string, store: import('../graph/store.js').GraphStore): Promise<ArchiveEventResult>;
+    archiveNode(uri: string, store: GraphStore): Promise<ArchiveEventResult>;
     /** Rematerialize a node from the archive into the graph */
-    rematerialize(uri: string, store: import('../graph/store.js').GraphStore): Promise<boolean>;
+    rematerialize(uri: string, store: GraphStore): Promise<boolean>;
     /** Rematerialize all missing nodes */
-    rematerializeAll(store: import('../graph/store.js').GraphStore): Promise<RematerializeAllResult>;
+    rematerializeAll(store: GraphStore): Promise<RematerializeAllResult>;
     /** List all archived sessions */
     listArchived(filter?: ArchiveFilter): Promise<ArchiveListEntry[]>;
     /** Set the materialization provider (for materializeBeforeArchive) */
@@ -274,7 +276,7 @@ export interface MaterializationArchiver {
  * Matches the materializeNode method on ProviderAwareStore.
  */
 export interface MaterializationProvider {
-    materializeNode(uri: string): Promise<import('../schema/nodes.js').ExternalNode>;
+    materializeNode(uri: string): Promise<ExternalNode>;
 }
 /**
  * Configuration for the MaterializationArchiver

package/dist/materialization/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/materialization/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,OAAO,EAAE,CAAC,CAAC;IAEX,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IAEZ,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IAEF,6CAA6C;IAC7C,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,UAAU,EAAE,SAAS,CAAC;IAEtB,oCAAoC;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB,iDAAiD;IACjD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,UAAU,EAAE,YAAY,CAAC;IAEzB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,cAAc,EAAE,OAAO,CAAC;IAExB,4DAA4D;IAC5D,mBAAmB,EAAE,OAAO,CAAC;IAE7B,kDAAkD;IAClD,YAAY,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,wBAAwB,EAAE,OAAO,CAAC;CACnC;AAED,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,UAAU,EAAE,WAAW,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAEtD,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,0BAA0B,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAGpF,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,gCAAgC;IAChC,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnE,iCAAiC;IACjC,YAAY,CAAC,SAAS,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEhF,iCAAiC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IAE/D,+BAA+B;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE1D,2BAA2B;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,mBAAmB;IACnB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,0DAA0D;IAC1D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAExE,qDAAqD;IACrD,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEnC,iDAAiD;IACjD,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhC,+DAA+D;IAC/D,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CACR,KAAK,CAAC;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CACH,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,oBAAoB;IACvD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,mBAAmB,EAAE,UAAU,GAC5C,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B,8CAA8C;IAC9C,WAAW,CACT,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,mBAAmB,EAAE,UAAU,GAC5C,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B,2DAA2D;IAC3D,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,mBAAmB,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5F,sCAAsC;IACtC,gBAAgB,CAAC,KAAK,EAAE,OAAO,mBAAmB,EAAE,UAAU,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEjG,iCAAiC;IACjC,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAElE,sEAAsE;IACtE,0BAA0B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAEpE,4BAA4B;IAC5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,oBAAoB,EAAE,YAAY,CAAC,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,QAAQ,EAAE,oBAAoB,CAAC;IAE/B,+BAA+B;IAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qBAAqB;IACrB,MAAM,EAAE,aAAa,CAAC;IAEtB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/materialization/types.ts"],"names":[],"mappings":"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"}

package/dist/materialization/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/materialization/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4HH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,IAAI;IAClB,wBAAwB,EAAE,IAAI;CAC/B,CAAC;AA6BF,MAAM,CAAC,MAAM,0BAA0B,GAAkD;IACvF,MAAM,EAAE,mBAAmB;IAC3B,UAAU,EAAE,gBAAgB;CAC7B,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/materialization/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+HH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,IAAI;IAClB,wBAAwB,EAAE,IAAI;CAC/B,CAAC;AA6BF,MAAM,CAAC,MAAM,0BAA0B,GAAkD;IACvF,MAAM,EAAE,mBAAmB;IAC3B,UAAU,EAAE,gBAAgB;CAC7B,CAAC"}

package/dist/mcp/server.d.ts

@@ -11,11 +11,12 @@
  *   - graph: Full graph operations — link, query (all node types, edges, blockers)
  *   - annotate: Feedback lifecycle — create, resolve, dismiss, reopen
  *   - context: Context/spec CRUD — create, get, update, list
+ *   - attempts: Attempt/verify coordination — record_attempt, list_attempts (verifies edges via link)
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { type ClientOptions } from '../client/client.js';
 /** Available MCP scopes */
-export type MCPScope = 'tasks' | 'graph' | 'annotate' | 'context';
+export type MCPScope = 'tasks' | 'graph' | 'annotate' | 'context' | 'attempts';
 export interface MCPServerOptions {
     /** Options for the OpenTasks client */
     clientOptions?: ClientOptions;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAM1E,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,EAA8C,CAAC;AAEhF,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CA2BrE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgB1E,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;CACrB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,EAA0D,CAAC;AAE5F,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CA+BrE"}

package/dist/mcp/server.js

@@ -11,10 +11,14 @@
  *   - graph: Full graph operations — link, query (all node types, edges, blockers)
  *   - annotate: Feedback lifecycle — create, resolve, dismiss, reopen
  *   - context: Context/spec CRUD — create, get, update, list
+ *   - attempts: Attempt/verify coordination — record_attempt, list_attempts (verifies edges via link)
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { OpenTasksClient } from '../client/client.js';
+import { VERSION } from '../version.js';
+import { TASK_ACTIONS } from '../providers/traits/TaskManageable.js';
+import { attemptOutcome, isUnevidencedCompletion, } from '../graph/attempts.js';
 // ============================================================================
 // Server Factory
 // ============================================================================
@@ -27,13 +31,13 @@ import { OpenTasksClient } from '../client/client.js';
  * Additional scopes can be opted in:
  *   --scope tasks,graph,annotate,context
  */
-export const ALL_SCOPES = ['tasks', 'graph', 'annotate', 'context'];
+export const ALL_SCOPES = ['tasks', 'graph', 'annotate', 'context', 'attempts'];
 export function createMCPServer(options) {
     const client = new OpenTasksClient(options?.clientOptions);
     const scopes = new Set(options?.scopes ?? ['tasks']);
     const server = new McpServer({
         name: 'opentasks',
-        version: '0.0.5',
+        version: VERSION,
     });
     // Always register tasks scope
     if (scopes.has('tasks')) {
@@ -48,6 +52,9 @@ export function createMCPServer(options) {
     if (scopes.has('context')) {
         registerContextTools(server, client);
     }
+    if (scopes.has('attempts')) {
+        registerAttemptTools(server, client);
+    }
     return server;
 }
 // ============================================================================
@@ -64,10 +71,11 @@ function registerTaskTools(server, client) {
         parent_id: z.string().optional().describe('Parent node ID'),
         metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata'),
         scheme: z.string().optional().describe('Provider scheme to route creation to (e.g. beads, sudocode)'),
+        idempotency_key: z.string().optional().describe('Dedup key: retrying create with the same key returns the original task instead of a duplicate'),
     }, async (args) => {
         try {
-            const { scheme, ...params } = args;
-            const result = await client.createNode({ type: 'task', ...params }, scheme ? { scheme } : undefined);
+            const { scheme, idempotency_key, status = 'open', ...params } = args;
+            const result = await client.createNode({ type: 'task', status, ...params }, scheme || idempotency_key ? { scheme, idempotencyKey: idempotency_key } : undefined);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
@@ -103,8 +111,8 @@ function registerTaskTools(server, client) {
         archived: z.boolean().optional().describe('Archive/unarchive'),
         metadata: z.record(z.string(), z.unknown()).optional().describe('Update metadata (merged)'),
         // Semantic transitions
-        transition: z.enum(['start', 'complete', 'block', 'reopen', 'close']).optional()
-            .describe('Semantic status transition (alternative to setting status directly)'),
+        transition: z.enum(TASK_ACTIONS).optional()
+            .describe('Semantic status transition (alternative to setting status directly). fail/abandon are terminal outcomes distinct from complete/close.'),
         // Blocker management
         addBlockedBy: z.array(z.string()).optional().describe('Add blocker task IDs (these block this task)'),
         removeBlockedBy: z.array(z.string()).optional().describe('Remove blocker task IDs'),
@@ -112,7 +120,7 @@ function registerTaskTools(server, client) {
         removeBlocks: z.array(z.string()).optional().describe('Remove task IDs that this task blocks'),
     }, async (args) => {
         const results = [];
-        const { id, transition, addBlockedBy, removeBlockedBy, addBlocks, removeBlocks, tags, ...fieldUpdates } = args;
+        const { id, transition, addBlockedBy, removeBlockedBy, addBlocks, removeBlocks, tags: _tags, ...fieldUpdates } = args;
         const hasFieldUpdates = Object.values(fieldUpdates).some((v) => v !== undefined);
         // 1. Apply field updates if any
         if (hasFieldUpdates) {
@@ -262,21 +270,74 @@ function registerTaskTools(server, client) {
                         priority: typeof filters.priority === 'number' ? filters.priority : undefined,
                     },
                 });
-                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                return { content: [{ type: 'text', text: JSON.stringify(withTaskListHints(result), null, 2) }] };
             }
             // Blocker queries
             if (blockersOf) {
                 const result = await client.query({ blockers: { nodeId: blockersOf } });
-                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                return { content: [{ type: 'text', text: JSON.stringify(withTaskListHints(result), null, 2) }] };
             }
             if (blockedBy) {
                 const result = await client.query({ blocking: { nodeId: blockedBy } });
-                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                return { content: [{ type: 'text', text: JSON.stringify(withTaskListHints(result), null, 2) }] };
             }
             // General task list
             const result = await client.query({
                 nodes: { type: 'task', ...filters },
             });
+            return { content: [{ type: 'text', text: JSON.stringify(withTaskListHints(result), null, 2) }] };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool('claim_task', 'Atomically claim a task for an agent (lease-based, race-free). Returns claimed:false (not an error) when another agent already holds it. Use the returned fence with release_task/renew_claim.', {
+        id: z.string().describe('Task ID (native tasks only)'),
+        agentId: z.string().describe('Agent acquiring the claim'),
+        durationMs: z.number().optional().describe('Lease duration in ms (default: 30 min)'),
+        force: z.boolean().optional().describe('Claim even if held by another, unexpired agent'),
+    }, async (args) => {
+        try {
+            const result = await client.task({ claim: args });
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool('claim_next', 'Atomically claim the next ready, unclaimed task for an agent (fused ready-query + claim). Returns claimed:false when nothing is available.', {
+        agentId: z.string().describe('Agent acquiring the claim'),
+        durationMs: z.number().optional().describe('Lease duration in ms (default: 30 min)'),
+    }, async (args) => {
+        try {
+            const result = await client.task({ claimNext: args });
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool('release_task', 'Release a claim on a task. Pass the fence from claim_task to reject a stale/superseded release.', {
+        id: z.string().describe('Task ID (native tasks only)'),
+        agentId: z.string().describe('Agent that holds the claim'),
+        fence: z.number().optional().describe('Fence token from the claim'),
+    }, async (args) => {
+        try {
+            const result = await client.task({ release: args });
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool('renew_claim', "Renew/extend a claim's lease (heartbeat). Pass the fence from claim_task to reject a stale/superseded renew.", {
+        id: z.string().describe('Task ID (native tasks only)'),
+        agentId: z.string().describe('Agent that holds the claim'),
+        durationMs: z.number().optional().describe('New lease duration in ms (default: 30 min)'),
+        fence: z.number().optional().describe('Fence token from the claim'),
+    }, async (args) => {
+        try {
+            const result = await client.task({ renew: args });
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
@@ -291,7 +352,7 @@ function registerGraphTools(server, client) {
     server.tool('link', 'Create or remove an edge between two nodes. Supports local IDs (e.g. t-abc1) and provider URIs (e.g. beads://project/i-123).', {
         fromId: z.string().describe('Source node ID or provider URI'),
         toId: z.string().describe('Target node ID or provider URI'),
-        type: z.string().describe('Relationship type: blocks, implements, references, depends-on, related, parent-of, child-of, duplicates, supersedes, discovered-from'),
+        type: z.string().describe('Relationship type: blocks, implements, references, depends-on, related, parent-of, child-of, duplicates, supersedes, discovered-from, verifies, reproduces'),
         remove: z.boolean().optional().describe('Remove the edge instead of creating (default: false)'),
         metadata: z.record(z.string(), z.unknown()).optional().describe('Additional metadata'),
     }, async (args) => {
@@ -341,6 +402,7 @@ function registerGraphTools(server, client) {
             priority: z.union([z.number(), z.object({ min: z.number().optional(), max: z.number().optional() })]).optional(),
             assignee: z.string().optional(),
             limit: z.number().optional(),
+            excludeClaimed: z.boolean().optional().describe('Exclude tasks under a live claim (lease). Off by default; set when dispatching directly off ready.'),
         }).optional(),
         blockers: z.object({
             nodeId: z.string(),
@@ -399,6 +461,55 @@ function registerGraphTools(server, client) {
             return errorResult(error);
         }
     });
+    server.tool('events_since', `Pull graph change events since a cursor (token-cheap polling — get just what changed instead of re-querying the world).
+Pass back the { epoch, seq } cursor from a previous call; omit both to get a baseline cursor from the current head (no events).
+Returns { events, nextCursor }. If the cursor is too old or the daemon restarted, returns { resync: true, nextCursor } — re-query state and adopt nextCursor.`, {
+        epoch: z.string().optional().describe('Cursor epoch from a prior call (omit for a baseline)'),
+        seq: z.number().optional().describe('Cursor seq from a prior call (omit for a baseline)'),
+    }, async (args) => {
+        try {
+            // No cursor → hand back the current head as a baseline to poll from.
+            if (args.epoch === undefined || args.seq === undefined) {
+                const cursor = await client.eventsCurrent();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ events: [], nextCursor: cursor }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const result = await client.eventsSince({ epoch: args.epoch, seq: args.seq });
+            if ('resync' in result && result.resync) {
+                const cursor = await client.eventsCurrent();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ resync: true, nextCursor: cursor }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const events = result.events;
+            const last = events.length > 0 ? events[events.length - 1] : null;
+            const nextCursor = last
+                ? { epoch: last.epoch, seq: last.seq }
+                : { epoch: args.epoch, seq: args.seq };
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ events, nextCursor }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
 }
 // ============================================================================
 // Scope: annotate (opt-in)
@@ -687,11 +798,197 @@ By default returns the node metadata (lightweight). Use resolve: true to include
     });
 }
 // ============================================================================
+// Scope: attempts (opt-in)
+// ============================================================================
+const ATTEMPT_OUTCOMES = ['pending', 'success', 'failure', 'abandoned', 'inconclusive'];
+const TERMINAL_OUTCOMES = new Set(['success', 'failure', 'abandoned', 'inconclusive']);
+function registerAttemptTools(server, client) {
+    const evidenceSchema = z
+        .object({
+        kind: z.enum(['test', 'command', 'commit', 'context', 'external', 'url']),
+        ref: z.string().describe('test-suite id / command / git sha / context node id / uri'),
+        detail: z.string().optional().describe('exit code, "12/12 passed", metric value'),
+        hash: z.string().optional().describe('content hash for tamper-evidence'),
+    })
+        .describe('Pointer to an independently checkable artifact — the Commitment lever');
+    server.tool('record_attempt', "Record (create or update) an attempt at a task — one agent's effort, with outcome + evidence. " +
+        'Omit `id` to start a new attempt; pass `id` to update. A terminal outcome ' +
+        '(success/failure/abandoned/inconclusive) closes the attempt; the parent task is left open ' +
+        '(a retry is a new attempt). Claiming for exclusivity is separate — use claim_task.', {
+        taskId: z.string().describe('The task being attempted (the attempt target)'),
+        agent: z.string().describe('Agent making the attempt'),
+        id: z.string().optional().describe('Existing attempt ID to update; omit to create'),
+        outcome: z
+            .enum(ATTEMPT_OUTCOMES)
+            .optional()
+            .describe('Result (default: pending on create). Terminal values close the attempt.'),
+        summary: z
+            .string()
+            .optional()
+            .describe('What was tried / what happened — name files or areas touched so partners see overlap'),
+        evidence: evidenceSchema.optional(),
+        failureReason: z
+            .string()
+            .optional()
+            .describe('Why it failed / was abandoned — the negative-result record'),
+        fromId: z
+            .string()
+            .optional()
+            .describe('Prior attempt this follows (creates a discovered-from link)'),
+    }, async (args) => {
+        try {
+            const { taskId, agent, id, outcome, summary, evidence: ev, failureReason, fromId } = args;
+            // Build the metadata.attempt patch from the provided fields only.
+            const patch = {};
+            if (outcome !== undefined)
+                patch.outcome = outcome;
+            if (summary !== undefined)
+                patch.summary = summary;
+            if (ev !== undefined)
+                patch.evidence = ev;
+            if (failureReason !== undefined)
+                patch.failureReason = failureReason;
+            // CREATE
+            if (!id) {
+                const oc = outcome ?? 'pending';
+                const node = await client.createNode({
+                    type: 'attempt',
+                    title: summary ? summary.slice(0, 120) : `Attempt at ${taskId} by ${agent}`,
+                    target_id: taskId,
+                    assignee: agent,
+                    status: TERMINAL_OUTCOMES.has(oc) ? 'closed' : 'in_progress',
+                    metadata: { attempt: { outcome: oc, ...patch } },
+                });
+                const createdId = node.id;
+                if (fromId && createdId) {
+                    await client.link({ fromId: createdId, toId: fromId, type: 'discovered-from' });
+                }
+                return { content: [{ type: 'text', text: JSON.stringify(node, null, 2) }] };
+            }
+            // UPDATE — merge into the existing metadata.attempt (the tool is its sole writer).
+            const existing = (await client.getNode(id));
+            if (!existing) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'Attempt not found', id }) }],
+                    isError: true,
+                };
+            }
+            const mergedAttempt = { ...(existing.metadata?.attempt ?? {}), ...patch };
+            const updates = { metadata: { attempt: mergedAttempt } };
+            if (outcome !== undefined) {
+                updates.status = TERMINAL_OUTCOMES.has(outcome) ? 'closed' : 'in_progress';
+            }
+            if (fromId) {
+                await client.link({ fromId: id, toId: fromId, type: 'discovered-from' });
+            }
+            const node = await client.updateNode(id, updates);
+            return { content: [{ type: 'text', text: JSON.stringify(node, null, 2) }] };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    server.tool('list_attempts', 'List attempts and their verification state — the coordination read: what every agent is doing ' +
+        "now, and which completions are unevidenced. Verification edges are created via `link` (type 'verifies').", {
+        taskId: z.string().optional().describe('Only attempts of this task'),
+        agent: z.string().optional().describe("Only this agent's attempts"),
+        status: z.enum(['in_progress', 'closed']).optional(),
+        outcome: z.enum(ATTEMPT_OUTCOMES).optional(),
+        inProgress: z
+            .boolean()
+            .optional()
+            .describe('Shortcut for status=in_progress — "what is everyone doing right now"'),
+        unverified: z
+            .boolean()
+            .optional()
+            .describe('Only success attempts that are unevidenced (no checkable evidence, no passing verifies edge)'),
+        includeVerifications: z
+            .boolean()
+            .optional()
+            .describe("Attach each attempt's verifies edges (default: true)"),
+    }, async (args) => {
+        try {
+            const { taskId, agent, status, outcome, inProgress, unverified, includeVerifications } = args;
+            const effStatus = inProgress ? 'in_progress' : status;
+            const nodeResult = await client.query({
+                nodes: { type: 'attempt', ...(effStatus ? { status: effStatus } : {}) },
+                verbose: true,
+            });
+            let items = (nodeResult.items ?? []).filter((n) => n.type === 'attempt');
+            if (taskId)
+                items = items.filter((n) => n.target_id === taskId);
+            if (agent)
+                items = items.filter((n) => n.assignee === agent);
+            if (outcome)
+                items = items.filter((n) => attemptOutcome(n) === outcome);
+            // Verification edges are needed for the unverified filter or to attach them.
+            const needEdges = Boolean(unverified) || includeVerifications !== false;
+            let edges = [];
+            if (needEdges) {
+                const edgeResult = await client.query({ edges: { type: 'verifies' }, verbose: true });
+                edges = edgeResult.items ?? [];
+            }
+            if (unverified)
+                items = items.filter((n) => isUnevidencedCompletion(n, edges));
+            const out = includeVerifications === false
+                ? items
+                : items.map((n) => ({ ...n, verifications: edges.filter((e) => e.to_id === n.id) }));
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ items: out, count: out.length }, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+// ============================================================================
 // Helpers
 // ============================================================================
 function errorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }
+function withTaskListHints(result) {
+    if (!isRecord(result))
+        return result;
+    const output = { ...result };
+    if (Array.isArray(output.items)) {
+        output.items = output.items.map(withTaskItemHints);
+        output.listHint =
+            'list_tasks returns summaries. If a task may have more instructions than the title shows, call get_task with the id and read content before acting.';
+    }
+    const data = output.data;
+    if (isRecord(data) && Array.isArray(data.items)) {
+        output.data = {
+            ...data,
+            items: data.items.map(withTaskItemHints),
+            listHint: 'list_tasks returns summaries. If a task may have more instructions than the title shows, call get_task with the id and read content before acting.',
+        };
+    }
+    return output;
+}
+function withTaskItemHints(item) {
+    if (!isRecord(item))
+        return item;
+    const id = typeof item.id === 'string' ? item.id : undefined;
+    const content = typeof item.content === 'string' ? item.content : undefined;
+    return {
+        ...item,
+        contentPreview: content ? previewText(content, 360) : undefined,
+        contentLength: content?.length ?? undefined,
+        fullContentAvailableViaGetTask: Boolean(id),
+        getTaskHint: id ? `Call get_task with id "${id}" to read the full task content before acting.` : undefined,
+    };
+}
+function previewText(text, max) {
+    const compact = text.replace(/\s+/g, ' ').trim();
+    return compact.length <= max ? compact : `${compact.slice(0, max - 1).trimEnd()}…`;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 function errorResult(error) {
     return {
         content: [{ type: 'text', text: JSON.stringify({ error: errorMessage(error) }) }],