@vheins/local-memory-mcp 0.16.1 → 0.16.3

package/dist/{chunk-C5MOQQAU.js → chunk-MSP4MIT7.js}

@@ -81,8 +81,8 @@ function loadServerInstructions() {
 // src/mcp/capabilities.ts
 var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
 var pkgVersion = "0.1.0";
-if ("0.16.1") {
-  pkgVersion = "0.16.1";
+if ("0.16.3") {
+  pkgVersion = "0.16.3";
 } else {
   let searchDir = __dirname2;
   for (let i = 0; i < 5; i++) {
@@ -1908,6 +1908,18 @@ var TaskEntity = class extends BaseEntity {
     const row = this.get(query, params);
     return (row?.count ?? 0) > 0;
   }
+  getChildrenByParentId(id) {
+    return this.all(
+      "SELECT task_code, title, status FROM tasks WHERE parent_id = ? ORDER BY created_at ASC",
+      [id]
+    );
+  }
+  getDependedByTaskId(id) {
+    return this.all(
+      "SELECT task_code, title, status FROM tasks WHERE depends_on = ? ORDER BY created_at ASC",
+      [id]
+    );
+  }
   getExistingTaskCodes(repo, codes) {
     if (codes.length === 0) return /* @__PURE__ */ new Set();
     const placeholders = codes.map(() => "?").join(",");
@@ -3463,6 +3475,27 @@ var MemorySynthesizeSchema = z.object({
 });
 var TaskStatusSchema = z.enum(["backlog", "pending", "in_progress", "completed", "canceled", "blocked"]);
 var TaskPrioritySchema = z.number().min(1).max(5);
+var TaskMetadataSchema = z.record(z.string(), z.any()).optional().superRefine((metadata, ctx) => {
+  if (!metadata) return;
+  if (metadata.required_skills !== void 0) {
+    if (!Array.isArray(metadata.required_skills)) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.required_skills must be an array of strings", path: ["metadata", "required_skills"] });
+    } else if (metadata.required_skills.length === 0) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.required_skills must not be empty when present", path: ["metadata", "required_skills"] });
+    } else if (!metadata.required_skills.every((s) => typeof s === "string" && s.length > 0)) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.required_skills must be an array of non-empty strings", path: ["metadata", "required_skills"] });
+    }
+  }
+  if (metadata.fsm_gates !== void 0) {
+    if (!Array.isArray(metadata.fsm_gates)) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.fsm_gates must be an array of strings", path: ["metadata", "fsm_gates"] });
+    } else if (metadata.fsm_gates.length === 0) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.fsm_gates must not be empty when present", path: ["metadata", "fsm_gates"] });
+    } else if (!metadata.fsm_gates.every((s) => typeof s === "string" && s.length > 0)) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: "metadata.fsm_gates must be an array of non-empty strings", path: ["metadata", "fsm_gates"] });
+    }
+  }
+});
 var SingleTaskCreateSchema = z.object({
   task_code: z.string().min(1).optional(),
   phase: z.string().min(1),
@@ -3475,7 +3508,7 @@ var SingleTaskCreateSchema = z.object({
   doc_path: z.string().optional(),
   tags: z.array(z.string()).optional(),
   suggested_skills: z.array(z.string()).optional(),
-  metadata: z.record(z.string(), z.any()).optional(),
+  metadata: TaskMetadataSchema,
   parent_id: z.string().optional(),
   depends_on: z.string().optional(),
   est_tokens: z.number().int().min(0).optional()
@@ -5737,6 +5770,9 @@ async function completePromptArgument(name, argName, value, contextArguments, da
   return [];
 }
 
+// src/mcp/tools/handoff.manage.ts
+import { randomUUID as randomUUID2 } from "crypto";
+
 // src/mcp/utils/mcp-response.ts
 import { z as z2 } from "zod";
 var McpAnnotationsSchema = z2.object({
@@ -5982,14 +6018,15 @@ async function handleTaskClaim(args, storage) {
   const { repo, task_id, task_code, agent, role, metadata, structured } = validated;
   let taskId = task_id;
   let resolvedTaskCode;
+  let task = null;
   if (taskId) {
-    const task = storage.tasks.getTaskById(taskId);
+    task = storage.tasks.getTaskById(taskId);
     if (!task || task.repo !== repo) {
       throw new Error(`Task not found: ${taskId} in repo ${repo}`);
     }
     resolvedTaskCode = task.task_code;
   } else if (task_code) {
-    const task = storage.tasks.getTaskByCode(repo, task_code);
+    task = storage.tasks.getTaskByCode(repo, task_code);
     if (!task) {
       throw new Error(`Task not found: ${task_code} in repo ${repo}`);
     }
@@ -6005,6 +6042,22 @@ async function handleTaskClaim(args, storage) {
     role,
     metadata
   });
+  if (task && task.status !== "completed") {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    storage.tasks.updateTask(task.id, { status: "in_progress", in_progress_at: now });
+    storage.taskComments.insertTaskComment({
+      id: randomUUID2(),
+      task_id: task.id,
+      repo,
+      comment: `Claimed by ${agent} \u2014 auto-promoted to in_progress`,
+      agent,
+      role: role || "unknown",
+      model: "system",
+      previous_status: task.status,
+      next_status: "in_progress",
+      created_at: now
+    });
+  }
   const responseData = {
     ...claim,
     task_code: resolvedTaskCode

package/dist/dashboard/server.js

@@ -16,7 +16,7 @@ import {
   handleTaskClaim,
   listResources,
   logger
-} from "../chunk-C5MOQQAU.js";
+} from "../chunk-MSP4MIT7.js";
 
 // src/dashboard/server.ts
 import express from "express";

package/dist/mcp/server.js

@@ -60,7 +60,7 @@ import {
   toContextSlug,
   updateSessionFromInitialize,
   updateSessionRoots
-} from "../chunk-C5MOQQAU.js";
+} from "../chunk-MSP4MIT7.js";
 
 // src/mcp/server.ts
 import readline from "readline";
@@ -2370,24 +2370,57 @@ async function handleTaskGet(args, storage) {
     throw new Error(`Task not found: ${id || task_code} in repo ${repo}`);
   }
   const comments = storage.taskComments.getTaskCommentsByTaskId(task.id);
+  const children = storage.tasks.getChildrenByParentId(task.id);
+  const depended_by = storage.tasks.getDependedByTaskId(task.id);
   let contentSummary;
   if (!isStructuredRequest) {
     const lines = [
       `Task: ${task.title}`,
       `Code: ${task.task_code}`,
+      `Repo: ${task.repo}`,
       `Status: ${task.status}`,
       `Priority: ${task.priority}`,
       `ID: ${task.id}`
     ];
     if (task.phase) lines.push(`Phase: ${task.phase}`);
+    if (task.parent_code) lines.push(`Parent: ${task.parent_code} (${task.parent_id || ""})`);
+    if (task.depends_on_code) lines.push(`Depends On: ${task.depends_on_code} (${task.depends_on || ""})`);
+    if (task.doc_path) lines.push(`Doc Path: ${task.doc_path}`);
     if (task.description) lines.push(`Description: ${task.description}`);
+    if (task.tags && task.tags.length > 0) lines.push(`Tags: ${task.tags.join(", ")}`);
     if (task.suggested_skills && task.suggested_skills.length > 0)
       lines.push(`Suggested Skills: ${task.suggested_skills.join(", ")}`);
+    if (task.est_tokens) lines.push(`Est Tokens: ${task.est_tokens}`);
+    if (task.commit_id) lines.push(`Commit: ${task.commit_id}`);
+    if (task.changed_files && task.changed_files.length > 0)
+      lines.push(`Changed Files: ${task.changed_files.join(", ")}`);
     if (task.metadata) lines.push(`Metadata: ${JSON.stringify(task.metadata)}`);
+    if (task.comments_count !== void 0) lines.push(`Comments: ${task.comments_count}`);
+    if (task.coordination) {
+      if (task.coordination.active_claim_count > 0) {
+        lines.push(`Claim: ${task.coordination.active_claim_agent || "?"} (${task.coordination.active_claim_role || ""}) since ${task.coordination.active_claim_claimed_at || ""}`);
+      }
+      if (task.coordination.pending_handoff_count > 0) {
+        lines.push(`Handoff: ${task.coordination.pending_handoff_summary || ""} \u2192 ${task.coordination.pending_handoff_to_agent || "?"}`);
+      }
+    }
     lines.push(`Created: ${task.created_at}`);
     if (task.updated_at) lines.push(`Updated: ${task.updated_at}`);
     if (task.in_progress_at) lines.push(`Started: ${task.in_progress_at}`);
     if (task.finished_at) lines.push(`Finished: ${task.finished_at}`);
+    if (task.canceled_at) lines.push(`Canceled: ${task.canceled_at}`);
+    if (children.length > 0) {
+      lines.push("", "--- Children ---");
+      for (const c of children) {
+        lines.push(`- ${c.task_code}: ${c.title} (${c.status})`);
+      }
+    }
+    if (depended_by.length > 0) {
+      lines.push("", "--- Depended By ---");
+      for (const d of depended_by) {
+        lines.push(`- ${d.task_code}: ${d.title} (${d.status})`);
+      }
+    }
     if (comments.length > 0) {
       lines.push("", "--- History ---");
       for (const c of comments) {
@@ -2400,7 +2433,9 @@ async function handleTaskGet(args, storage) {
   }
   const structuredData = {
     ...task,
-    comments
+    comments,
+    children,
+    depended_by
   };
   return createMcpResponse(structuredData, contentSummary || "", {
     contentSummary,

package/dist/prompts/create-task.md

@@ -42,6 +42,14 @@ G2 | sprint? | src=.agents/documents/tasks/sprints/ | → route sprint flow |
 
 `1=Low` `2=Normal` `3=Medium` `4=High` `5=Critical` (ascending urgency)
 
+## 3B. SKILL TRACKING METADATA
+When a task's description references specific skills (e.g., "Load feature-decomposition skill"), set `metadata.required_skills` and `metadata.fsm_gates`:
+
+- `metadata.required_skills`: `["skill-name-1", "skill-name-2"]` — array of skill names the task depends on.
+- `metadata.fsm_gates`: `["S0", "S1", "G0"]` — array of FSM step/gate identifiers the skill requires.
+- **Optional**: Only set when the task explicitly references a skill. Most tasks do NOT need skill tracking.
+- **Enforcement**: The `task-memory-executor` G0.5 gate checks `metadata.required_skills` before execution. If a skill is listed but wasn't loaded, the executor blocks the task.
+
 ## Blueprint Flow (G1→)
 
 Root parent → phase parents P0..P10 → child tasks per breakdown row

package/dist/prompts/server/instructions.md

@@ -21,7 +21,7 @@ S2 | continue to task or respond | S1✅ | ready | —
 - memory-acknowledge after code gen from memory
 - Global scope = cross-repo only; prefer repo-specific
 
-**Tasks**: task-list → task-claim → task-update(in_progress) → task-update(completed)
+**Tasks**: task-list → task-claim(auto → in_progress) → task-update(completed)
 
 - Register via task-create before execution
 - NEVER skip in_progress

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

@@ -19,8 +19,9 @@ Guard: S(N) req S(N-1)✅; dependency-ready filter (depends_on+parent_id done)
 S0 | sync: resolve identity (arg→auto `<runner>-<randomName>`, 1x reuse all loop) + task-list(ONCE) + handoff-list(pending, close stale) + audit stale in_progress(>30m, hydrate via task-detail) | — | filtered queue | —
 S1 | hydrate: task-detail ONCE per task — MUST cache, MUST reuse all steps, NO re-fetch | S0✅ | full task | —
 G0 | readiness: depends_on✅ AND parent_id✅? if all blocked → report blockers + pause | S1✅ | → S2 / skip+pick next | —
-S2 | claim: task-claim(with identity metadata) + task-update→in_progress(agent, role, identity) | G0✅ | ownership | —
-S3 | research: check task-detail for suggested_skills — load each via skill() tool; then memory-search + standard-search(MANDATORY per task — even sub-agents/decomposed) + hydrate relevant | S2✅ | context | —
+S2 | claim: task-claim(with identity metadata) [auto → in_progress] | G0✅ | ownership | —
+G0.5 | skill readiness: check task.metadata.required_skills — if present, load each via skill() and verify FSM completed (all gates passed). If skill not loaded or FSM incomplete → ⛔ block with reason. If absent → skip (most tasks don't use skills). Check task-detail for suggested_skills too — if present, load each. | S2✅ | → S3 / ⛔ → blocker | —
+S3 | research: memory-search + standard-search(MANDATORY per task — even sub-agents/decomposed) + hydrate relevant | G0.5✅ | context | —
 S4 | execute: trace logic+callsites+docs — DO NOT infer from file presence; decompose if too broad | S3✅ | changes | —
 S5 | validate: tests + linters + type-check + browser(if UI — MANDATORY: console errors, overflow, responsive, core interactions) + logic audit all paths | S4✅ | verification | —
 S6 | finalize: task-update→completed(evidence: inspected files, verified logic, test results) + memory-store(insights) + standard-store(rules) + handoff(if work remains — with identity) + retrospective + report | S5✅ | completion | —

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vheins/local-memory-mcp",
-	"version": "0.16.1",
+	"version": "0.16.3",
 	"description": "MCP Local Memory Service for coding copilot agents",
 	"mcpName": "io.github.vheins/local-memory-mcp",
 	"type": "module",
@@ -50,6 +50,7 @@
 		"better-sqlite3": "^12.9.0",
 		"chart.js": "^4.5.1",
 		"dompurify": "^3.3.3",
+		"esbuild": "0.28.1",
 		"express": "^5.2.1",
 		"gray-matter": "^4.0.3",
 		"marked": "^18.0.0",
@@ -91,6 +92,7 @@
 	},
 	"overrides": {
 		"protobufjs": "^7.5.8",
-		"brace-expansion": "^5.0.6"
+		"brace-expansion": "^5.0.6",
+		"esbuild": "0.28.1"
 	}
 }