npm - @vheins/local-memory-mcp - Versions diffs - 0.9.8 → 0.9.10 - Mend

@vheins/local-memory-mcp 0.9.8 → 0.9.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/dist/{chunk-CSEGUZWJ.js → chunk-GAZNK32C.js} +297 -46
package/dist/dashboard/public/assets/index-C2cM-UXM.css +1 -0
package/dist/dashboard/public/assets/index-D-xKLFFr.js +86 -0
package/dist/dashboard/public/index.html +2 -2
package/dist/dashboard/server.js +109 -53
package/dist/mcp/server.js +112 -3
package/dist/prompts/create-task.md +7 -1
package/dist/prompts/memory-agent-core.md +1 -1
package/dist/prompts/project-briefing.md +2 -1
package/dist/prompts/review-and-audit.md +1 -0
package/dist/prompts/session-planner.md +2 -1
package/dist/prompts/task-management-guidelines.md +5 -2
package/dist/prompts/task-memory-executor.md +2 -1
package/dist/prompts/tool-usage-guidelines.md +4 -2
package/package.json +1 -1
package/dist/dashboard/public/assets/index-C9M1BD7U.js +0 -86
package/dist/dashboard/public/assets/index-CNE1bKgp.css +0 -1

package/dist/dashboard/public/index.html CHANGED Viewed

@@ -8,8 +8,8 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <script type="module" crossorigin src="/assets/index-C9M1BD7U.js"></script>
-  <link rel="stylesheet" crossorigin href="/assets/index-CNE1bKgp.css">
+  <script type="module" crossorigin src="/assets/index-D-xKLFFr.js"></script>
+  <link rel="stylesheet" crossorigin href="/assets/index-C2cM-UXM.css">
 </head>
 <body>
   <div id="app"></div>

package/dist/dashboard/server.js CHANGED Viewed

@@ -10,7 +10,7 @@ import {
   createFileSink,
   listResources,
   logger
-} from "../chunk-CSEGUZWJ.js";
+} from "../chunk-GAZNK32C.js";
 // src/dashboard/server.ts
 import express from "express";
@@ -215,7 +215,7 @@ vectors.initialize().catch((err) => {
 });
 // src/dashboard/routes/index.ts
-import { Router as Router5 } from "express";
+import { Router as Router6 } from "express";
 // src/dashboard/routes/system.routes.ts
 import { Router } from "express";
@@ -297,6 +297,7 @@ var SystemController = class {
       uptime: Math.floor((Date.now() - startTime) / 1e3),
       version: pkg.version,
       memoryCount: stats.totalMemories,
+      repoCount: stats.totalRepos,
       pendingRequests: mcpClient.getPendingCount(),
       dbPath: db.getDbPath()
     };
@@ -321,8 +322,7 @@ var SystemController = class {
     try {
       await db.refresh();
       const repo = req.query.repo;
-      if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
-      const stats = db.system.getDashboardStats(repo);
+      const stats = repo ? db.system.getDashboardStats(repo) : db.system.getGlobalDashboardStats();
       res.json(jsonApiRes(stats, "system-stats"));
     } catch (err) {
       const message = err instanceof Error ? err.message : "Internal server error";
@@ -723,41 +723,33 @@ var TasksController = class {
       const attributes = getAttributes(req);
       const existingTask = db.tasks.getTaskById(id);
       if (!existingTask) return res.status(404).json(jsonApiError("Task not found", 404));
-      await db.withWrite(() => {
-        db.tasks.updateTask(id, attributes);
-        if (attributes.status && attributes.status !== existingTask.status) {
-          db.actions.logAction("update", existingTask.repo, {
-            taskId: id,
-            query: `Status changed to ${attributes.status}`
-          });
-          db.tasks.insertTaskComment({
-            id: randomUUID2(),
-            task_id: id,
-            repo: existingTask.repo,
-            comment: attributes.comment || `Status updated via dashboard`,
-            agent: "dashboard",
-            role: "user",
-            model: "web-ui",
-            previous_status: existingTask.status,
-            next_status: attributes.status,
-            created_at: (/* @__PURE__ */ new Date()).toISOString()
-          });
-        } else if (attributes.comment) {
-          db.tasks.insertTaskComment({
-            id: randomUUID2(),
-            task_id: id,
-            repo: existingTask.repo,
-            comment: attributes.comment,
-            agent: "dashboard",
-            role: "user",
-            model: "web-ui",
-            previous_status: null,
-            next_status: null,
-            created_at: (/* @__PURE__ */ new Date()).toISOString()
-          });
+      if (!mcpClient.isConnected()) await mcpClient.start();
+      const toolArgs = {
+        repo: existingTask.repo,
+        id,
+        agent: "dashboard",
+        role: "user",
+        model: "web-ui",
+        structured: true
+      };
+      for (const [key, value] of Object.entries(attributes)) {
+        if (value !== void 0) {
+          toolArgs[key] = value;
         }
-      });
-      res.json(jsonApiRes({ message: "Updated" }, "status"));
+      }
+      if (attributes.status && attributes.status !== existingTask.status && !toolArgs.comment) {
+        toolArgs.comment = `Status updated via dashboard to ${attributes.status}`;
+      }
+      if (attributes.status === "completed" && toolArgs.est_tokens === void 0) {
+        toolArgs.est_tokens = existingTask.est_tokens || 0;
+      }
+      await mcpClient.callTool("task-update", toolArgs);
+      await db.refresh();
+      const updatedTask = db.tasks.getTaskById(id);
+      if (!updatedTask) {
+        return res.status(500).json(jsonApiError("Task updated but could not be reloaded", 500));
+      }
+      res.json(jsonApiRes(updatedTask, "task"));
     } catch (err) {
       const message = err instanceof Error ? err.message : "Internal server error";
       res.status(500).json(jsonApiError(message));
@@ -808,23 +800,23 @@ var TasksController = class {
     try {
       await db.refresh();
       const { repo } = req.query;
-      if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
+      const targetRepo = typeof repo === "string" && repo.length > 0 ? repo : null;
       const stats = {
         daily: {
-          ...db.tasks.getTaskTimeStats(repo, "daily"),
-          history: db.tasks.getTaskComparisonSeries(repo, "daily")
+          ...db.tasks.getTaskTimeStats(targetRepo, "daily"),
+          history: db.tasks.getTaskComparisonSeries(targetRepo, "daily")
         },
         weekly: {
-          ...db.tasks.getTaskTimeStats(repo, "weekly"),
-          history: db.tasks.getTaskComparisonSeries(repo, "weekly")
+          ...db.tasks.getTaskTimeStats(targetRepo, "weekly"),
+          history: db.tasks.getTaskComparisonSeries(targetRepo, "weekly")
         },
         monthly: {
-          ...db.tasks.getTaskTimeStats(repo, "monthly"),
-          history: db.tasks.getTaskComparisonSeries(repo, "monthly")
+          ...db.tasks.getTaskTimeStats(targetRepo, "monthly"),
+          history: db.tasks.getTaskComparisonSeries(targetRepo, "monthly")
         },
         overall: {
-          ...db.tasks.getTaskTimeStats(repo, "overall"),
-          history: db.tasks.getTaskComparisonSeries(repo, "overall")
+          ...db.tasks.getTaskTimeStats(targetRepo, "overall"),
+          history: db.tasks.getTaskComparisonSeries(targetRepo, "overall")
         }
       };
       res.json(jsonApiRes(stats, "performance-stats"));
@@ -1039,13 +1031,77 @@ router4.put("/:id", StandardsController.update);
 router4.delete("/:id", StandardsController.delete);
 var standard_routes_default = router4;
-// src/dashboard/routes/index.ts
+// src/dashboard/routes/coordination.routes.ts
+import { Router as Router5 } from "express";
+// src/dashboard/controllers/CoordinationController.ts
+var CoordinationController = class {
+  static async listClaims(req, res) {
+    try {
+      await db.refresh();
+      const { repo, agent, active_only } = req.query;
+      const page = Math.max(1, parseInt(req.query.page || "1", 10));
+      const pageSize = Math.min(100, Math.max(1, parseInt(req.query.pageSize || "20", 10)));
+      if (!repo) return res.status(400).json(jsonApiError("repo is required", 400));
+      const claims = db.handoffs.listClaims({
+        repo,
+        agent: typeof agent === "string" ? agent : void 0,
+        active_only: active_only === void 0 ? true : String(active_only) === "true",
+        limit: pageSize,
+        offset: (page - 1) * pageSize
+      });
+      const total = db.handoffs.listClaims({
+        repo,
+        agent: typeof agent === "string" ? agent : void 0,
+        active_only: active_only === void 0 ? true : String(active_only) === "true",
+        limit: 1e5,
+        offset: 0
+      }).length;
+      res.json(
+        jsonApiRes(claims, "claim", {
+          meta: {
+            page,
+            pageSize,
+            totalItems: total,
+            totalPages: Math.ceil(total / pageSize)
+          }
+        })
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Internal server error";
+      res.status(500).json(jsonApiError(message));
+    }
+  }
+  static async releaseClaim(req, res) {
+    try {
+      const attributes = getAttributes(req);
+      if (!mcpClient.isConnected()) await mcpClient.start();
+      const result = await mcpClient.callTool("claim-release", {
+        ...attributes,
+        structured: true
+      });
+      res.json(jsonApiRes(result.structuredContent || result, "claim-release"));
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Internal server error";
+      res.status(500).json(jsonApiError(message));
+    }
+  }
+};
+// src/dashboard/routes/coordination.routes.ts
 var router5 = Router5();
-router5.use("/", system_routes_default);
-router5.use("/memories", memory_routes_default);
-router5.use("/tasks", task_routes_default);
-router5.use("/standards", standard_routes_default);
-var routes_default = router5;
+router5.get("/claims", CoordinationController.listClaims);
+router5.post("/claims/release", CoordinationController.releaseClaim);
+var coordination_routes_default = router5;
+// src/dashboard/routes/index.ts
+var router6 = Router6();
+router6.use("/", system_routes_default);
+router6.use("/memories", memory_routes_default);
+router6.use("/tasks", task_routes_default);
+router6.use("/standards", standard_routes_default);
+router6.use("/coordination", coordination_routes_default);
+var routes_default = router6;
 // src/dashboard/server.ts
 var __dirname3 = path3.dirname(fileURLToPath3(import.meta.url));

package/dist/mcp/server.js CHANGED Viewed

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import {
   CAPABILITIES,
+  ClaimListSchema,
+  ClaimReleaseSchema,
   HandoffCreateSchema,
   HandoffListSchema,
   HandoffUpdateSchema,
@@ -55,7 +57,7 @@ import {
   toContextSlug,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-CSEGUZWJ.js";
+} from "../chunk-GAZNK32C.js";
 // src/mcp/server.ts
 import readline from "readline";
@@ -1663,6 +1665,16 @@ function buildHandoffListSummary(repo, count, status, fromAgent, toAgent) {
   }
   return parts.join("\n");
 }
+function buildClaimListSummary(repo, count, agent, activeOnly) {
+  const parts = [`Found ${count} claim${count === 1 ? "" : "s"} in repo "${repo}".`];
+  if (agent) {
+    parts.push(`Agent filter: ${agent}.`);
+  }
+  if (activeOnly) {
+    parts.push("Showing active claims only.");
+  }
+  return parts.join("\n");
+}
 async function handleHandoffCreate(args, storage) {
   const validated = HandoffCreateSchema.parse(args);
   const { repo, from_agent, to_agent, task_id, task_code, summary, context, expires_at, structured } = validated;
@@ -1708,15 +1720,31 @@ async function handleHandoffList(args, storage) {
     limit,
     offset
   });
-  const COLUMNS = ["id", "from_agent", "to_agent", "task_id", "status", "created_at", "summary"];
+  const COLUMNS = [
+    "id",
+    "from_agent",
+    "to_agent",
+    "task_id",
+    "task_code",
+    "status",
+    "created_at",
+    "updated_at",
+    "expires_at",
+    "summary",
+    "context"
+  ];
   const rows = handoffs.map((handoff) => [
     handoff.id,
     handoff.from_agent,
     handoff.to_agent,
     handoff.task_id,
+    handoff.task_code ?? null,
     handoff.status,
     handoff.created_at,
-    handoff.summary
+    handoff.updated_at,
+    handoff.expires_at,
+    handoff.summary,
+    handoff.context
   ]);
   const structuredData = {
     schema: "handoff-list",
@@ -1806,6 +1834,82 @@ async function handleTaskClaim(args, storage) {
   }
   return response;
 }
+async function handleClaimList(args, storage) {
+  const validated = ClaimListSchema.parse(args);
+  const { repo, agent, active_only, limit, offset, structured } = validated;
+  const claims = storage.handoffs.listClaims({
+    repo,
+    agent,
+    active_only,
+    limit,
+    offset
+  });
+  const COLUMNS = ["id", "task_id", "task_code", "agent", "role", "claimed_at", "released_at", "metadata"];
+  const rows = claims.map((claim) => [
+    claim.id,
+    claim.task_id,
+    claim.task_code ?? null,
+    claim.agent,
+    claim.role,
+    claim.claimed_at,
+    claim.released_at,
+    claim.metadata
+  ]);
+  const structuredData = {
+    schema: "claim-list",
+    claims: {
+      columns: [...COLUMNS],
+      rows
+    },
+    count: rows.length,
+    offset
+  };
+  const contentSummary = buildClaimListSummary(repo, rows.length, agent, active_only);
+  return createMcpResponse(structuredData, contentSummary, {
+    contentSummary,
+    includeSerializedStructuredContent: structured
+  });
+}
+async function handleClaimRelease(args, storage) {
+  const validated = ClaimReleaseSchema.parse(args);
+  const { repo, task_id, task_code, agent, structured } = validated;
+  let resolvedTaskId = task_id;
+  let resolvedTaskCode = task_code ?? null;
+  if (resolvedTaskId) {
+    const task = storage.tasks.getTaskById(resolvedTaskId);
+    if (!task || task.repo !== repo) {
+      throw new Error(`Task not found: ${resolvedTaskId} in repo ${repo}`);
+    }
+    resolvedTaskCode = task.task_code;
+  } else if (task_code) {
+    const task = storage.tasks.getTaskByCode(repo, task_code);
+    if (!task) {
+      throw new Error(`Task not found: ${task_code} in repo ${repo}`);
+    }
+    resolvedTaskId = task.id;
+    resolvedTaskCode = task.task_code;
+  }
+  const success = storage.handoffs.releaseClaim(resolvedTaskId, agent);
+  if (!success) {
+    throw new Error(`No active claim found for task ${resolvedTaskCode || resolvedTaskId}`);
+  }
+  const result = {
+    success,
+    repo,
+    task_id: resolvedTaskId,
+    task_code: resolvedTaskCode,
+    agent: agent ?? null
+  };
+  const contentSummary = [
+    `Released claim for task ${resolvedTaskCode || resolvedTaskId}.`,
+    `Repo: ${repo}`,
+    agent ? `Agent: ${agent}` : "Agent: any active claimant"
+  ].join("\n");
+  return createMcpResponse(result, contentSummary, {
+    contentSummary,
+    includeSerializedStructuredContent: structured
+  });
+}
 // src/mcp/tools/standard.store.ts
 import { randomUUID as randomUUID3 } from "crypto";
@@ -2359,6 +2463,7 @@ function createRouter(db2, vectors2, options) {
     "task-create",
     "task-create-interactive",
     "task-claim",
+    "claim-release",
     "task-update",
     "task-delete"
   ]);
@@ -2403,6 +2508,10 @@ function createRouter(db2, vectors2, options) {
           return await handleHandoffUpdate(args, db2);
         case "task-claim":
           return await handleTaskClaim(args, db2);
+        case "claim-list":
+          return await handleClaimList(args, db2);
+        case "claim-release":
+          return await handleClaimRelease(args, db2);
         case "standard-store":
           return await handleStandardStore(args, db2, vectors2);
         case "standard-update":

package/dist/prompts/create-task.md CHANGED Viewed

@@ -32,7 +32,13 @@ ONLY call MCP tools. No prose, no code, no plans outside MCP.
 ## 3. ATTRIBUTES & FORMAT
 - `task_code`: FEAT/FIX/REFACTOR-XXX.
 - `phase`: Discovery/Implementation/Testing.
-- `priority`: 1-5.
+- `priority`: 1-5 using this exact scale:
+  - `1 = Low`
+  - `2 = Normal`
+  - `3 = Medium`
+  - `4 = High`
+  - `5 = Critical`
+- `priority` is ascending by urgency. `5` is the highest urgency and `1` is the lowest. Never encode `Critical` as `1`.
 - `description` (STRICT FORMAT):
   ### 1. Context & Analysis
   - **Trigger**: Instruction/finding.

package/dist/prompts/memory-agent-core.md CHANGED Viewed

@@ -18,7 +18,7 @@ You are a memory-aware agent. Memory is project truth, not a suggestion.
 ## Execution Policy
 1. **Orient**: Call `task-list` for active work and `handoff-list` for pending transfers when starting a repository session. Close stale pending handoffs with `handoff-update` when they no longer describe unfinished work.
-2. **Claim**: Use `task-claim` before taking ownership of a concrete task.
+2. **Claim**: Use `task-claim` before taking ownership of a concrete task. Use `claim-list` when ownership is unclear and `claim-release` to clear stale claims during reassignment.
 3. **Search**: Call `memory-search` with `current_file_path` and `current_tags` before coding.
 4. **Standards**: Call `standard-search` when implementation may be governed by coding standards.
 5. **Retrieve**: Use `memory-detail` for full content if search pointer rows are insufficient.

package/dist/prompts/project-briefing.md CHANGED Viewed

@@ -13,4 +13,5 @@ Briefing Steps:
 4. **Memory**: Call `memory-search` or `memory-recap` for recent decisions, patterns, and mistakes; hydrate important entries with `memory-detail`.
 5. **Standards**: Call `standard-search` with current repo/stack when implementation guidance is needed.
 6. **Core Context**: Summarize active task, pending handoffs, applicable standards, and top architectural decisions.
-7. **Action**: Propose next steps based on the active queue.
+7. **Priority Reminder**: Treat task priority with MCP semantics: `1=Low`, `2=Normal`, `3=Medium`, `4=High`, `5=Critical`.
+8. **Action**: Propose next steps based on the active queue.

package/dist/prompts/review-and-audit.md CHANGED Viewed

@@ -31,6 +31,7 @@ ONLY call MCP tools. No prose, code, or external plans.
 ## 3. TASK DESIGN & FORMAT
 - **Atomic**: One change per task.
 - **Attributes**: `task_code`, `phase`, `priority`, `agent`, `model`.
+- **Priority Scale**: Use MCP ordering exactly: `1=Low`, `2=Normal`, `3=Medium`, `4=High`, `5=Critical`. `5` is the highest urgency.
 - **Description** (STRICT FORMAT):
   ### 1. Context & Analysis
   - **Finding**: Gap trigger.

package/dist/prompts/session-planner.md CHANGED Viewed

@@ -16,6 +16,7 @@ Steps:
 4. **Analyze**: Break into 3-7 atomic, verifiable tasks.
 5. **Phase**: Group into `research`, `implementation`, and `validation`.
 6. **Hierarchy**: Use `parent_id` / `depends_on` for sequencing.
-7. **Create**: Use `task-create` in current repo with stable `task_code`, tags, and acceptance criteria.
+7. **Priority Scale**: When creating tasks, use the exact MCP scale `1=Low`, `2=Normal`, `3=Medium`, `4=High`, `5=Critical`. Higher number means higher urgency.
+8. **Create**: Use `task-create` in current repo with stable `task_code`, tags, and acceptance criteria.
 Display final plan to user.

package/dist/prompts/task-management-guidelines.md CHANGED Viewed

@@ -9,8 +9,9 @@ agent: Project Manager
 ## 1. NAVIGATION (`task-list`)
 -   **Sync**: Call `task-list` at every session start (default: `in_progress,pending`).
 -   **Format**: Compact pointer table: `id`, `task_code`, `title`, `status`, `priority`, `updated_at`, `comments_count`. Use `query` for keyword search.
--   **Retrieve**: Fetch full context via `task-detail` AFTER selecting a task.
--   **Coordination**: Check active ownership with task metadata and `task-claim`. NEVER work on tasks claimed by others. Focus on ONE task at a time.
+-   **Priority Scale**: Interpret `priority` with MCP semantics: `1=Low`, `2=Normal`, `3=Medium`, `4=High`, `5=Critical`.
+-   **Retrieve**: Fetch full context via `task-detail` AFTER selecting a task. The hydrated task includes current coordination state such as active claims and pending handoffs.
+-   **Coordination**: Check active ownership with task coordination metadata, `task-claim`, and `claim-list`. NEVER work on tasks claimed by others. Focus on ONE task at a time.
 ## 2. DETAIL TOOLS
 -   **Tasks**: Call `task-detail` for history/comments (ID or `task_code`).
@@ -23,6 +24,8 @@ agent: Project Manager
 -   **Transition Safety**: MUST move from `backlog/pending` → `in_progress` → `completed`. Skipping `in_progress` is forbidden.
 -   **Automatic Cleanup**: `task-update` to `completed` or `canceled` automatically releases active claims and expires pending handoffs linked to that task.
 -   **Claiming**: Use `task-claim` when taking ownership of a task, with `task_code` when working from human-visible queues.
+-   **Claim Inspection**: Use `claim-list` when ownership is unclear or when triaging stale work.
+-   **Claim Release**: Use `claim-release` to clear stale ownership explicitly when a task is being handed back or reassigned.
 -   **Handoff**: Use `handoff-create` only when pausing or transferring unfinished work. Do not use pending handoffs for completion summaries; close consumed/stale handoffs with `handoff-update`.
 -   **Validation**: Only mark `completed` after passing tests or explicitly documenting why verification could not run.
 -   **Archiving**: Completion triggers auto-archive to `task_archive` memory with token reporting.

package/dist/prompts/task-memory-executor.md CHANGED Viewed

@@ -51,7 +51,8 @@ agent: Task Executor
 ## 3. BACKLOG MAINTENANCE
 If active queue is empty:
 1. Call `task-list` (status: `backlog`).
-2. Move up to 20 high-priority tasks to `pending` via `task-update`.
+2. Move up to 20 highest-priority tasks to `pending` via `task-update`.
+3. Interpret priority using MCP ordering: `5=Critical`, `4=High`, `3=Medium`, `2=Normal`, `1=Low`.
 ## 4. REPORT
 Provide progress summary.

package/dist/prompts/tool-usage-guidelines.md CHANGED Viewed

@@ -18,7 +18,7 @@ Use the tools in the same flow exposed by the dashboard: navigate with compact l
 ## 2. Task Flow
 - **Navigate**: Start with `task-list` using active statuses (`in_progress,pending`) or explicit filters.
-- **Hydrate**: Use `task-detail` after selecting a task from the list. Do not treat list rows as full task context.
+- **Hydrate**: Use `task-detail` after selecting a task from the list. Full task detail includes comments plus current coordination state such as active claims and pending handoffs.
 - **Mutate**: Use `task-create`, `task-update`, and `task-delete` for lifecycle changes.
 - **Transitions**: Move `backlog/pending/blocked` to `in_progress` before `completed`; include validation evidence and token estimate on completion.
 - **Automatic cleanup**: Moving a task to `completed` or `canceled` automatically releases active claims and expires pending handoffs linked to that task.
@@ -30,11 +30,13 @@ Use the tools in the same flow exposed by the dashboard: navigate with compact l
 - **Scope**: Prefer repo-specific standards for local conventions; use global standards only for cross-repo rules.
 ## 4. Handoff & Claim Flow
-- **Queue**: Use `handoff-list` as the handoff navigation layer. Filter by `status`, `from_agent`, or `to_agent`.
+- **Queue**: Use `handoff-list` as the handoff navigation layer. Filter by `status`, `from_agent`, or `to_agent`. Hydrated handoff rows include `task_code`, `updated_at`, `expires_at`, and structured `context`.
 - **Create handoff**: Use `handoff-create` only when unfinished work needs context transfer. Include `from_agent`, optional `to_agent`, optional `task_code` or `task_id`, concise `summary`, and structured `context` with `next_steps`, `blockers`, or `remaining_work`.
 - **Close handoff**: Use `handoff-update` to move stale or consumed handoffs out of `pending`. Use `accepted` when consumed, `rejected` when declined, and `expired` when obsolete or only a completed-work summary.
 - **No completion handoff**: Do not create pending handoffs for completed-work summaries, release notes, validation notes, or archive records. Put those on `task-update` comments or durable memory.
 - **Claim task**: Use `task-claim` for task ownership. Do not encode claims in memory metadata.
+- **Inspect claims**: Use `claim-list` to inspect active ownership by repo or agent before reassigning work.
+- **Release claims**: Use `claim-release` to explicitly clear stale ownership when work is transferred or abandoned.
 - **Linkage**: Prefer `task_code` for human workflows and `task_id` when already hydrated.
 ## 5. Reference Flow

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.9.8",
+	"version": "0.9.10",
 	"description": "MCP Local Memory Service for coding copilot agents",
 	"mcpName": "io.github.vheins/local-memory-mcp",
 	"type": "module",