@vheins/local-memory-mcp 0.8.30 → 0.8.32

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.
@@ -1,60 +1,42 @@
1
1
  ---
2
2
  name: task-memory-executor
3
- description: Execute all pending tasks for the current repository, updating status and storing handoffs in the task backlog.
3
+ description: Sequentially execute pending tasks for current repository.
4
4
  arguments: []
5
5
  agent: Task Executor
6
6
  ---
7
7
  # Skill: task-memory-executor
8
8
 
9
- ## Purpose
10
-
11
- You are tasked with executing all available tasks for the current repository.
12
-
13
- ## Instructions
14
-
15
- ---
16
- description: Execute all pending tasks for the current repository
17
- ---
18
-
19
- Please follow this strict execution flow:
20
-
21
- 1. **Identify Repository**: Determine the current repository name (e.g., from git config or workspace context).
22
- 2. **Fetch Active Tasks**: Call `local-memory-mcp` MCP tools `task-list` for the identified repository (defaults to active tasks).
23
- - This returns a compact table: `columns = [id, task_code, title, status, priority, comments_count]`, `rows` = task pointers.
24
- - DO NOT call task-list in a loop. Call it ONCE.
25
- 3. **Filter Stale**: From the in_progress rows, identify tasks that are **stale** (stale = no update for > 30 minutes, often because an agent stopped or crashed). Fetch their full data via `task-detail` tool to inspect timestamps.
26
- 4. **Task Execution Loop**: You MUST process tasks EXACTLY ONE AT A TIME (STRICT). You are STRICTLY FORBIDDEN from spinning up parallel sub-agents or using parallel execution. For each task you select:
27
- - **Hydrate**: Fetch full task context via `task-detail` tool before starting work.
28
- - **Start**: Call `local-memory-mcp` MCP tools `task-update` to set status='in_progress' for this task ONLY. Provide current agent/role information in the metadata.
29
- - **Transition Safety (MANDATORY)**: You are FORBIDDEN from transitioning a task straight to `completed`. You MUST set it to `in_progress` first.
30
- - **Execute**: Perform the work described in the task title and description.
31
- - **Context Gathering**: Utilize Hybrid Search (70% Vector, 30% FTS5) for all repository research.
32
- - **Inspect Codebase Logic & Documentation First (MANDATORY)**: Before marking anything done, inspect the relevant code paths, call sites, configs, tests, and affected modules in the repository. Also read the relevant documentation, as it might need to be updated or fixed. Do not infer correctness from file presence alone.
33
- - **Validate Behavior (MANDATORY)**: Ensure the implementation logic satisfies the task intent and follows project standards. Validation must focus on behavior, control flow, data flow, and integration points, not just whether a file/class/function exists.
34
- - **Complete Only With Evidence**: Call `local-memory-mcp` MCP tools `task-update` to set status='completed' only after recording concrete evidence in the 'comment' field. The comment must include: files inspected, logic verified, checks/tests run (or why they could not run), and the exact reason the task is considered complete.
35
- - **Compact Context**: Summarize key learnings, decisions, and patterns discovered during task execution. Store critical insights as memory entries (type: 'code_fact' or 'pattern') using `local-memory-mcp` MCP tools `memory-store`.
36
- - **Retrospective**: Invoke the `learning-retrospective` skill. If the skill is unavailable, use the `learning-retrospective` prompt from `local-memory-mcp` to extract and store durable knowledge (mistakes, decisions, patterns) from this task.
37
- - **Commit**: Perform an atomic git commit and push for the changes made in the task.
38
- - **Handoff**: Use `local-memory-mcp` MCP tools `task-update` to document **detailed fix steps**, milestones, project-specific knowledge gained during execution, and validation evidence. If complex, decompose into smaller tasks using `local-memory-mcp` MCP tools `task-create`.
39
- - **Next**: Call `task-list` once more (optionally with `status='in_progress,pending'`) to get the next actionable task and repeat this loop.
40
- 5. **Backlog Migration**: Once all 'pending' and 'in_progress' tasks are completed or blocked, call `local-memory-mcp` MCP tools `task-list` with status='backlog'. If any exist, select up to 20 tasks (prioritizing by priority field) and update their status to 'pending' using `local-memory-mcp` MCP tools `task-update` to ensure the next agent has work ready.
41
- 6. **Report**: After processing all tasks, provide a summary of your progress.
42
-
43
- ## Mandatory Validation Rules
44
-
45
- Before a task can be marked `completed`, the agent **must** satisfy all applicable rules below:
46
-
47
- 1. **Read the implementation, not just the filesystem**
48
- - Inspect the actual source files related to the task.
49
- - Trace the relevant logic path end-to-end using code search and file reads.
50
- - Verify how the changed code is invoked, not just that it exists.
51
-
52
- 2. **Confirm behavior against task intent**
53
- - Compare the implementation against the task title, description, acceptance criteria, or bug report.
54
- - Check that the business logic is actually implemented and wired correctly.
55
- - If the task affects existing behavior, inspect adjacent modules and integration points for regressions.
56
-
57
- 3. **Use concrete verification**
58
- - Run targeted tests, linters, type checks, or validation scripts if available.
59
- - If automated tests cannot be run, perform a manual logic audit of all affected paths.
60
- - Document the specific verification method used in the task completion comment.
9
+ ## 1. SYNC & FILTER
10
+ 1. **Identify**: Get repo name (git/context).
11
+ 2. **List**: Call `task-list` ONCE for active tasks.
12
+ 3. **Audit**: Identify stale `in_progress` tasks (>30m no update). Hydrate via `task-detail` to check timestamps.
13
+
14
+ ## 2. EXECUTION LOOP
15
+ 1. **Parallelism & Sub-Agents**:
16
+ - **MANDATORY**: Tasks MUST be delegated to sub-agents if the current agent has sub-agent capabilities.
17
+ - **Concurrency**: Use up to 4 parallel sub-agents. Each sub-agent executes EXACTLY ONE task at a time.
18
+ - **Fallback**: If the current agent CANNOT spawn sub-agents, it MUST execute tasks sequentially (exactly ONE concurrent task) until the queue is clear.
19
+ 2. **Hydrate**: Fetch full context via `task-detail` for the assigned task.
20
+ 3. **Start**: `task-update` status to `in_progress` (MUST transition: `pending` → `in_progress`). Add agent/role metadata.
21
+ 4. **Research**: Call `memory-search` (Hybrid Search).
22
+ 5. **Execute**:
23
+ - **Trace**: Inspect logic, call sites, and docs. DO NOT infer from file presence.
24
+ - **Logic**: Implement per description/intent.
25
+ 6. **Validate**:
26
+ - Trace path end-to-end.
27
+ - Run tests/linters/type-checks.
28
+ - Logic audit for all affected paths.
29
+ 7. **Finalize**:
30
+ - **Evidence**: `task-update` status to `completed` with detailed 'comment' (inspected files, verified logic, test results).
31
+ - **Memory**: Store insights as `code_fact`/`pattern` via `memory-store`.
32
+ - **Retrospective**: Invoke `learning-retrospective`.
33
+ - **Commit**: Atomic git commit/push.
34
+ 8. **Repeat**: Claim next task from `task-list`.
35
+
36
+ ## 3. BACKLOG MAINTENANCE
37
+ If active queue is empty:
38
+ 1. Call `task-list` (status: `backlog`).
39
+ 2. Move up to 20 high-priority tasks to `pending` via `task-update`.
40
+
41
+ ## 4. REPORT
42
+ Provide progress summary.
@@ -1,15 +1,15 @@
1
1
  ---
2
2
  name: tech-affinity-scout
3
- description: Find relevant best practices from other projects with similar tech for the current repository
3
+ description: Scout best practices from similar tech projects.
4
4
  arguments:
5
5
  - name: tags
6
- description: Comma-separated tech tags (e.g., 'react, tailwind')
6
+ description: CSV tech tags (e.g., 'react, tailwind').
7
7
  required: true
8
8
  agent: Tech Scout
9
9
  ---
10
- I am working on the current repository using [{{tags}}].
10
+ Scout for relevant knowledge using tags: [{{tags}}].
11
11
 
12
- Please scout for relevant knowledge from other projects:
13
- 1. **Search**: Use `local-memory-mcp` MCP tools `memory-search` with current_tags=[{{tags}}] and include_archived=false.
14
- 2. **Filter**: Look for 'patterns' or 'decisions' from other repositories that might apply here.
15
- 3. **Translate**: Explain how these external best practices can be adapted to our current project context.
12
+ Steps:
13
+ 1. **Search**: Call `memory-search` with `current_tags=[{{tags}}]`.
14
+ 2. **Filter**: Identify applicable 'patterns' or 'decisions' from other repos.
15
+ 3. **Adapt**: Explain adaptation of these practices to current project.
@@ -1,20 +1,20 @@
1
1
  ---
2
2
  name: technical-planning
3
- description: Define the technical blueprint for a new feature or product
3
+ description: Technical blueprint for new feature/product.
4
4
  arguments:
5
5
  - name: objective
6
- description: The high-level goal for the plan
6
+ description: High-level goal.
7
7
  required: true
8
8
  agent: Technical Architect
9
9
  ---
10
- You are tasked with creating a technical blueprint for the following objective in the current repository: '{{objective}}'.
10
+ Create technical blueprint for: '{{objective}}'.
11
11
 
12
- Please cover:
13
- 1. **Tech Stack**: Confirm or select the stack.
14
- 2. **Architecture**: Component layout and data flow.
15
- 3. **Domain Model**: Entities, value objects, and events.
16
- 4. **Database Schema**: Normalized tables and relationships.
17
- 5. **API Contracts**: Endpoint definitions (request/response/errors).
18
- 6. **Roadmap & Sprints**: Phased delivery plan.
12
+ Cover:
13
+ 1. **Tech Stack**: Selected/confirmed technologies.
14
+ 2. **Architecture**: Components & data flow.
15
+ 3. **Domain Model**: Entities, value objects, events.
16
+ 4. **Database**: Normalized schema & relationships.
17
+ 5. **API Contracts**: Requests, responses, errors.
18
+ 6. **Execution**: Roadmap & phased delivery.
19
19
 
20
- Present a cohesive technical design and obtain feedback before proceeding to implementation.
20
+ Present design for feedback before implementation.
@@ -1,22 +1,22 @@
1
1
  ---
2
2
  name: tool-usage-guidelines
3
- description: Prevent tool abuse and ensure data integrity
3
+ description: Tool usage standards & data integrity.
4
4
  arguments: []
5
5
  agent: System Architect
6
6
  ---
7
- Guidelines for specific tools:
7
+ # Tool Usage Standards
8
8
 
9
- 1. memory-store:
10
- - Always include 'tags' for tech-stack identification.
11
- - Use 'is_global: true' only for universal preferences (e.g., "Always use tabs").
12
- - Use 'supersedes' when overriding a previous decision.
9
+ 1. **`memory-store`**:
10
+ - Tag by tech-stack.
11
+ - `is_global` ONLY for universal rules.
12
+ - Use `supersedes` for overrides.
13
13
 
14
- 2. memory-search:
15
- - Always provide 'current_file_path' for folder-based ranking boost.
16
- - Provide 'current_tags' to pull relevant best-practices from other projects.
14
+ 2. **`memory-search`**:
15
+ - Provide `current_file_path` for scoped ranking.
16
+ - Use `current_tags` for affinity-based discovery.
17
17
 
18
- 3. memory-acknowledge:
19
- - Mandatory feedback loop. Report 'used' if the memory helped, or 'contradictory' if you found an issue.
18
+ 3. **`memory-acknowledge`**:
19
+ - **Mandatory**. Report `used` or `contradictory`.
20
20
 
21
- 4. memory-update:
22
- - Use this to keep facts current. Do not create duplicates.
21
+ 4. **`memory-update`**:
22
+ - Maintain accuracy. Avoid duplicates.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vheins/local-memory-mcp",
3
- "version": "0.8.30",
3
+ "version": "0.8.32",
4
4
  "description": "MCP Local Memory Service for coding copilot agents",
5
5
  "mcpName": "io.github.vheins/local-memory-mcp",
6
6
  "type": "module",
@@ -70,7 +70,7 @@
70
70
  "eslint": "^10.2.0",
71
71
  "eslint-config-prettier": "^10.1.8",
72
72
  "eslint-plugin-prettier": "^5.5.5",
73
- "eslint-plugin-svelte": "^2.46.1",
73
+ "eslint-plugin-svelte": "^3.17.0",
74
74
  "fast-check": "^4.6.0",
75
75
  "globals": "^17.5.0",
76
76
  "prettier": "^3.8.2",