npm - @vheins/local-memory-mcp - Versions diffs - 0.8.45 → 0.8.47 - Mend

@vheins/local-memory-mcp 0.8.45 → 0.8.47

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-Z4FZBRE2.js → chunk-MPT4WE42.js} +1824 -1777
package/dist/dashboard/public/assets/{index-DSdSQ0sh.css → index-BaWIMG1g.css} +1 -1
package/dist/dashboard/public/assets/{index-BESxlve8.js → index-DEY6a44I.js} +2 -2
package/dist/dashboard/public/index.html +2 -2
package/dist/dashboard/server.js +1 -1
package/dist/mcp/server.js +44 -3
package/dist/prompts/create-task.md +1 -1
package/dist/prompts/csl-scrapper.md +6 -15
package/dist/prompts/memory-agent-core.md +2 -2
package/dist/prompts/memory-index-policy.md +3 -2
package/dist/prompts/project-briefing.md +1 -1
package/dist/prompts/review-and-audit.md +2 -2
package/dist/prompts/session-planner.md +1 -1
package/dist/prompts/task-management-guidelines.md +3 -2
package/dist/prompts/task-memory-executor.md +3 -2
package/dist/prompts/tool-usage-guidelines.md +4 -1
package/package.json +1 -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-BESxlve8.js"></script>
-  <link rel="stylesheet" crossorigin href="/assets/index-DSdSQ0sh.css">
+  <script type="module" crossorigin src="/assets/index-DEY6a44I.js"></script>
+  <link rel="stylesheet" crossorigin href="/assets/index-BaWIMG1g.css">
 </head>
 <body>
   <div id="app"></div>

package/dist/dashboard/server.js CHANGED Viewed

@@ -8,7 +8,7 @@ import {
   createFileSink,
   listResources,
   logger
-} from "../chunk-Z4FZBRE2.js";
+} from "../chunk-MPT4WE42.js";
 // src/dashboard/server.ts
 import express from "express";

package/dist/mcp/server.js CHANGED Viewed

@@ -3,6 +3,7 @@ import {
   CAPABILITIES,
   HandoffCreateSchema,
   HandoffListSchema,
+  HandoffUpdateSchema,
   LOG_LEVEL_VALUES,
   MCP_PROTOCOL_VERSION,
   MemoryAcknowledgeSchema,
@@ -48,7 +49,7 @@ import {
   setLogLevel,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-Z4FZBRE2.js";
+} from "../chunk-MPT4WE42.js";
 // src/mcp/server.ts
 import readline from "readline";
@@ -1165,6 +1166,8 @@ async function handleTaskUpdate(args, storage, vectors2) {
   let updatedCount = 0;
   const updatedTasks = [];
   const completedTaskIds = [];
+  let releasedClaims = 0;
+  let expiredHandoffs = 0;
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const isStatusChangingGlobal = updates.status !== void 0;
   const existingTasks = storage.tasks.getTasksByIds(targetIds);
@@ -1228,11 +1231,18 @@ async function handleTaskUpdate(args, storage, vectors2) {
     if (updates.status === "completed" && existingTask.status !== "completed") {
       completedTaskIds.push(targetId);
     }
+    if (isStatusChanging && (updates.status === "completed" || updates.status === "canceled")) {
+      releasedClaims += storage.handoffs.releaseClaimsForTask(targetId);
+      expiredHandoffs += storage.handoffs.updatePendingHandoffsForTask(targetId, "expired");
+    }
     updatedTasks.push({ id: targetId, code: updates.task_code || existingTask.task_code });
     updatedCount++;
   }
   const isCompleted = updates.status === "completed" && updatedCount > 0;
-  const summaryText = isCompleted ? `Updated ${updatedCount} task(s) in repo "${repo}". \u2705 Task marked as completed \u2014 don't forget to commit your changes!` : `Updated ${updatedCount} task(s) in repo "${repo}".`;
+  let summaryText = isCompleted ? `Updated ${updatedCount} task(s) in repo "${repo}". \u2705 Task marked as completed \u2014 don't forget to commit your changes!` : `Updated ${updatedCount} task(s) in repo "${repo}".`;
+  if (releasedClaims || expiredHandoffs) {
+    summaryText += ` Auto-closed coordination: released ${releasedClaims} claim(s), expired ${expiredHandoffs} handoff(s).`;
+  }
   const response = createMcpResponse(
     {
       success: true,
@@ -1241,7 +1251,11 @@ async function handleTaskUpdate(args, storage, vectors2) {
       repo,
       status: updates.status,
       updatedCount,
-      updatedFields: Object.keys(updates)
+      updatedFields: Object.keys(updates),
+      coordinationCleanup: {
+        releasedClaims,
+        expiredHandoffs
+      }
     },
     summaryText,
     { includeSerializedStructuredContent: updateData.structured }
@@ -1713,6 +1727,30 @@ async function handleHandoffList(args, storage) {
     includeSerializedStructuredContent: structured
   });
 }
+async function handleHandoffUpdate(args, storage) {
+  const validated = HandoffUpdateSchema.parse(args);
+  const { id, status, structured } = validated;
+  const existing = storage.handoffs.getHandoffById(id);
+  if (!existing) {
+    throw new Error(`Handoff not found: ${id}`);
+  }
+  const success = storage.handoffs.updateHandoffStatus(id, status);
+  if (!success) {
+    throw new Error(`Failed to update handoff: ${id}`);
+  }
+  const updated = storage.handoffs.getHandoffById(id);
+  const result = {
+    success,
+    id,
+    status,
+    handoff: updated
+  };
+  const contentSummary = [`Updated handoff ${id}.`, `Status: ${status}`].join("\n");
+  return createMcpResponse(result, contentSummary, {
+    contentSummary,
+    includeSerializedStructuredContent: structured
+  });
+}
 async function handleTaskClaim(args, storage) {
   const validated = TaskClaimSchema.parse(args);
   const { repo, task_id, task_code, agent, role, metadata, structured } = validated;
@@ -1972,6 +2010,7 @@ function createRouter(db2, vectors2, options) {
     "memory-bulk-delete",
     "memory-summarize",
     "handoff-create",
+    "handoff-update",
     "standard-store",
     "task-create",
     "task-create-interactive",
@@ -2016,6 +2055,8 @@ function createRouter(db2, vectors2, options) {
           return await handleHandoffCreate(args, db2);
         case "handoff-list":
           return await handleHandoffList(args, db2);
+        case "handoff-update":
+          return await handleHandoffUpdate(args, db2);
         case "task-claim":
           return await handleTaskClaim(args, db2);
         case "standard-store":

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

@@ -19,7 +19,7 @@ ONLY call MCP tools. No prose, no code, no plans outside MCP.
 ## 1. PRE-ANALYSIS
 1. **Search Memory**: Call `memory-search` (architecture/history).
 2. **Search Standards**: Call `standard-search` when coding conventions may constrain the task.
-3. **Check Handoffs**: Call `handoff-list` for pending context that may already describe the work.
+3. **Check Handoffs**: Call `handoff-list` for pending context that may already describe unfinished work. Ignore or close stale handoffs that only describe completed work.
 4. **Research Codebase**: Read relevant source files to verify current implementation and paths.
 5. **De-duplicate**: Call `task-list`. DO NOT duplicate existing tasks. Link related tasks via `parent_id`/`depends_on`.

package/dist/prompts/csl-scrapper.md CHANGED Viewed

@@ -1,28 +1,19 @@
 ---
 name: csl-scrapper
-description: Scrape trusted documentation into atomic CSL coding standards entries.
+description: Scrape trusted documentation from a URL into atomic CSL coding standards entries.
 arguments:
-  - name: source_title
-    description: Human-readable title of the documentation source.
-    required: true
   - name: source_url
-    description: Canonical URL for the documentation source.
-    required: true
-  - name: documentation_content
-    description: Documentation excerpt or page content to normalize into atomic coding standards.
+    description: Canonical URL for the documentation source to scrape.
     required: true
 agent: Documentation Scraper
 ---
-Convert trusted documentation into atomic CSL (Coding Standards Library) entries for the coding_standards entity.
+Fetch and convert trusted documentation from the provided URL into atomic CSL (Coding Standards Library) entries for the coding_standards entity.
-Source title: {{source_title}}
 Source URL: {{source_url}}
 Current repo: {{current_repo}}
-Documentation to analyze:
-{{documentation_content}}
 Goal:
+- Use the web_fetch tool (if available) to retrieve the content of the provided Source URL.
 - Extract only source-backed coding standards from the documentation.
 - Produce one atomic CSL entry per distinct rule, constraint, prohibition, or required workflow.
 - Each entry must be ready for the standard-store tool shape: name, content, context, version, language, stack, tags, metadata, repo, is_global.
@@ -34,7 +25,7 @@ Atomic entry rules:
 - Ignore navigation text, marketing copy, release notes, changelog noise, and examples that do not establish a rule.
 - Do not emit duplicates or near-duplicates.
 - Do not infer version, language, stack, or scope unless the source makes them explicit.
-- Use metadata to preserve provenance, including source_title, source_url, and a short evidence_excerpt for each entry.
+- Use metadata to preserve provenance, including the source_url and a short evidence_excerpt for each entry.
 Output contract:
 - If tool calls are available, emit one standard-store call per accepted entry.
@@ -45,7 +36,7 @@ Output contract:
 - Prefer is_global=true unless the source is clearly repo-specific.
 Refusal rules:
-- Refuse when the material is not documentation or not clearly normative reference content.
+- Refuse when the URL content is not reachable, not documentation, or not clearly normative reference content.
 - Refuse when the source is too incomplete to verify atomic rules.
 - Refuse when the request asks you to guess, invent, or fill missing guidance from prior knowledge.
 - Refuse when no source-backed coding standards can be extracted.

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

@@ -17,7 +17,7 @@ You are a memory-aware agent. Memory is project truth, not a suggestion.
 6. **Search Mechanics**: Hybrid Search (70% Cosine, 30% BM25). 0.55 similarity threshold prevents duplication.
 ## Execution Policy
-1. **Orient**: Call `task-list` for active work and `handoff-list` for pending transfers when starting a repository session.
+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.
 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.
@@ -28,6 +28,6 @@ You are a memory-aware agent. Memory is project truth, not a suggestion.
 Store memory ONLY if knowledge is durable (architecture, patterns, fixes) and affects future behavior.
 1. **Categorize**: Use technology `tags`.
 2. **Maintain**: Use `supersedes` for overrides.
-3. **Separate concerns**: Use `standard-store` for normative coding rules and `handoff-create` for agent transfer context. Do not store these as generic memories.
+3. **Separate concerns**: Use `standard-store` for normative coding rules and `handoff-create`/`handoff-update` for agent transfer context. Do not store these as generic memories.
 Protect codebase health by respecting project history.

package/dist/prompts/memory-index-policy.md CHANGED Viewed

@@ -13,14 +13,15 @@ agent: Memory Auditor
 ## ✅ MANDATORY
 Only store durable, project-specific knowledge.
-- **Types**: `code_fact`, `decision`, `mistake`, `pattern`, `file_claim`, `task_archive`.
+- **Types**: `code_fact`, `decision`, `mistake`, `pattern`, `task_archive`.
 - **Content**: Architecture, UI/UX choices, stack patterns, hard-won bug fixes.
 - **Global**: Set `is_global` only if applicable across repositories (e.g., framework anti-patterns).
 - **Categorization**: Use accurate technology tags.
 ## Operational Note
 - Do **not** store agent coordination state as memory.
-- Use `handoff-create` and `handoff-list` for agent handoffs.
+- Use `handoff-create`, `handoff-list`, and `handoff-update` for agent handoffs.
 - Use `task-claim` for task ownership instead of encoding claims in memory metadata.
+- File ownership/claims are coordination state; never store them as `file_claim` memory entries.
 - Use `standard-store` for normative coding standards; do not bury implementation rules in generic `decision` memories.
 - Use `standard-search` as the standards navigation layer before applying or creating standards.

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

@@ -9,7 +9,7 @@ Initialize session in repository.
 Briefing Steps:
 1. **Repository**: Identify current repo from context.
 2. **Tasks**: Call `task-list` for `in_progress,pending` tasks.
-3. **Handoffs**: Call `handoff-list` with `status=pending` to surface transfer context.
+3. **Handoffs**: Call `handoff-list` with `status=pending` to surface transfer context. Treat only handoffs with unfinished work, blockers, next owner, or linked task as active.
 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.

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

@@ -17,7 +17,7 @@ agent: Quality Auditor
 ## 🚫 FORBIDDEN: NON-EXECUTION
 DO NOT edit/create/delete files, run commands, or implement code.
-**Allowed**: Read code, `chrome-dev-tools`, `task-create`, `memory-store`, `task-list`, `memory-search`, `standard-search`, `handoff-list`.
+**Allowed**: Read code, `chrome-dev-tools`, `task-create`, `memory-store`, `task-list`, `memory-search`, `standard-search`, `handoff-list`, `handoff-update`.
 ## ✅ OUTPUT: MCP ONLY
 ONLY call MCP tools. No prose, code, or external plans.
@@ -25,7 +25,7 @@ ONLY call MCP tools. No prose, code, or external plans.
 ## 2. PRE-TASK ANALYSIS
 1. **Search**: Call `memory-search` (Hybrid Search). 0.55 similarity threshold.
 2. **Standards**: Call `standard-search` when implementation conventions are relevant.
-3. **Handoffs**: Call `handoff-list` for pending transfer context related to the target.
+3. **Handoffs**: Call `handoff-list` for pending transfer context related to the target. Treat handoffs as active only when they contain unfinished work, blockers, a next owner, or a linked task.
 4. **De-duplicate**: Call `task-list`. Skip existing/redundant tasks. Link via `parent_id`/`depends_on`.
 ## 3. TASK DESIGN & FORMAT

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

@@ -12,7 +12,7 @@ Plan execution for: '{{objective}}'.
 Steps:
 1. **Orient**: Call `task-list` to avoid duplicate active/backlog work.
 2. **Standards**: Call `standard-search` if the objective touches implementation conventions.
-3. **Handoffs**: Call `handoff-list` for pending context that may affect sequencing.
+3. **Handoffs**: Call `handoff-list` for pending context that may affect sequencing. Stale pending handoffs that only summarize completed work should be closed with `handoff-update`, not planned as queue work.
 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.

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

@@ -16,12 +16,13 @@ agent: Project Manager
 -   **Tasks**: Call `task-detail` for history/comments (ID or `task_code`).
 -   **Memory**: Call `memory-detail` for full entry content.
 -   **Standards**: Call `standard-search` before implementation when coding standards may apply.
--   **Handoffs**: Call `handoff-list` to discover pending context transfers before starting a task.
+-   **Handoffs**: Call `handoff-list` to discover pending context transfers before starting a task. Close stale handoffs with `handoff-update` when no concrete next owner, unfinished task, or blocker remains.
 ## 3. WORKFLOW
 -   **Planning**: Create tasks for full lifecycle (Research → Strategy → Execution → Validation).
 -   **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.
--   **Handoff**: Use `handoff-create` when pausing, transferring ownership, or leaving structured context for another agent.
+-   **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

@@ -9,7 +9,7 @@ agent: Task Executor
 ## 1. SYNC & FILTER
 1. **Identify**: Get repo name (git/context).
 2. **List**: Call `task-list` ONCE for active tasks.
-3. **Handoffs**: Call `handoff-list` with `status=pending` and inspect relevant transfer context before selecting work.
+3. **Handoffs**: Call `handoff-list` with `status=pending` and inspect relevant transfer context before selecting work. Treat a pending handoff as active only when it has unfinished work, a blocker, a next owner, or a linked task. If it is obsolete or only describes completed work, close it with `handoff-update status=expired`.
 4. **Audit**: Identify stale `in_progress` tasks (>30m no update). Hydrate via `task-detail` to check timestamps.
 ## Task Cache (MANDATORY)
@@ -38,9 +38,10 @@ agent: Task Executor
    - **Browser Verification (MANDATORY)**: If the task involves UI/UX changes, use Playwright or Chrome DevTools to verify the feature is functional and consumable by the user. Check console errors, layout overflow, responsive behavior, and core interactions.
 9. **Finalize**:
    - **Evidence**: `task-update` status to `completed` with detailed 'comment' (inspected files, verified logic, test results).
+   - **Cleanup**: Completing/canceling a task automatically releases active claims and expires linked pending handoffs.
    - **Memory**: Store insights as `code_fact`/`pattern` via `memory-store`.
    - **Standards**: Store durable implementation rules via `standard-store`, not generic memory.
-   - **Handoff**: If work remains or ownership changes, create `handoff-create` with concise summary and structured context.
+   - **Handoff**: If work remains or ownership changes, create `handoff-create` with concise summary and structured context containing next steps/blockers/remaining work. Do not create handoffs for completed-work summaries.
    - **Retrospective**: Invoke `learning-retrospective`.
    - **Commit**: Atomic git commit. The commit message MUST include the task code (for example: `fix: ... [TASK-123]`).
    - **GitHub Issue Traceability**: If task metadata contains a GitHub Issue reference, the commit message MUST also include the issue hashtag in `#123` format.

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

@@ -21,6 +21,7 @@ Use the tools in the same flow exposed by the dashboard: navigate with compact l
 - **Hydrate**: Use `task-detail` after selecting a task from the list. Do not treat list rows as full task context.
 - **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.
 ## 3. Standards Flow
 - **Search first**: Use `standard-search` to find coding standards by `query`, `language`, `stack`, `repo`, and `is_global`.
@@ -30,7 +31,9 @@ Use the tools in the same flow exposed by the dashboard: navigate with compact l
 ## 4. Handoff & Claim Flow
 - **Queue**: Use `handoff-list` as the handoff navigation layer. Filter by `status`, `from_agent`, or `to_agent`.
-- **Create handoff**: Use `handoff-create` when work needs context transfer. Include `from_agent`, optional `to_agent`, optional `task_code` or `task_id`, concise `summary`, 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.
 - **Linkage**: Prefer `task_code` for human workflows and `task_id` when already hydrated.

package/package.json CHANGED Viewed

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