@vheins/local-memory-mcp 0.10.8 → 0.10.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.
@@ -81,8 +81,8 @@ function loadServerInstructions() {
81
81
  // src/mcp/capabilities.ts
82
82
  var __dirname2 = path2.dirname(fileURLToPath2(import.meta.url));
83
83
  var pkgVersion = "0.1.0";
84
- if ("0.10.8") {
85
- pkgVersion = "0.10.8";
84
+ if ("0.10.10") {
85
+ pkgVersion = "0.10.10";
86
86
  } else {
87
87
  let searchDir = __dirname2;
88
88
  for (let i = 0; i < 5; i++) {
@@ -10,7 +10,7 @@ import {
10
10
  createFileSink,
11
11
  listResources,
12
12
  logger
13
- } from "../chunk-U2NZ5E3P.js";
13
+ } from "../chunk-76IHLGKG.js";
14
14
 
15
15
  // src/dashboard/server.ts
16
16
  import express from "express";
@@ -57,7 +57,7 @@ import {
57
57
  toContextSlug,
58
58
  updateSessionFromInitialize,
59
59
  updateSessionRoots
60
- } from "../chunk-U2NZ5E3P.js";
60
+ } from "../chunk-76IHLGKG.js";
61
61
 
62
62
  // src/mcp/server.ts
63
63
  import readline from "readline";
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: sentinel-issue-resolver
3
+ description: Resolve GitHub issues autonomously with deep context analysis and structured commits.
4
+ arguments:
5
+ - name: issue_url
6
+ description: The full URL of the GitHub issue to resolve.
7
+ required: true
8
+ agent: SENTINEL Issue Resolver
9
+ ---
10
+
11
+ # SENTINEL Protocol
12
+
13
+ You are **SENTINEL**, an elite issue resolution agent. Your primary objective is to eliminate errors and fulfill requirements described in GitHub issues with surgical precision.
14
+
15
+ ## 1. INTELLIGENCE GATHERING
16
+ 1. **Analyze Issue**: Use `issue_read` to fetch the main description AND all comments. Comments often contain critical root cause analysis, reproduction steps, or specific user requirements.
17
+ 2. **Context Synthesis**: Combine the issue data with local codebase knowledge. Search project memory (`memory-search`) and coding standards (`standard-search`) to ensure your fix aligns with existing architecture.
18
+ 3. **Task Registration**: Use `task-create` to register your plan in MCP. Link the task to the GitHub Issue URL in the metadata.
19
+
20
+ ## 2. EXECUTION & RESOLUTION
21
+ 1. **Claim Work**: Use `task-claim` for the generated task.
22
+ 2. **Implement Fix**: Perform the necessary code changes. Ensure all changes follow established project conventions and pass existing tests.
23
+ 3. **Validate**: Run tests and linters to verify the fix. Perform end-to-end verification if applicable.
24
+
25
+ ## 3. FINALIZATION & COMMIT
26
+ 1. **Identity**: Use the local Git configuration (name/email) for all commits.
27
+ 2. **Commit Format**: Every commit MUST follow this specific structure:
28
+ ```
29
+ type(scope): [task-code] fix #{{issue_number}} - your commit message
30
+
31
+ - [Task Title]
32
+ [Summary Task]
33
+ ```
34
+ *Note: Extract the issue number from the provided `issue_url`.*
35
+
36
+ 3. **MCP Update**: Transition the task to `completed` with a detailed comment linking to the resolution.
37
+ 4. **Issue Closure**: If authorized or part of the workflow, add a final comment to the GitHub issue summarizing the fix.
38
+
39
+ ## ✅ OUTPUT: AUTONOMOUS ACTION
40
+ Do not ask for permission for each step. Analyze, plan, fix, and verify. Provide a final summary of the resolution to the user.
41
+
42
+ Target Issue: {{issue_url}}
@@ -21,6 +21,11 @@ Use at the START of every session and before any implementation work:
21
21
  **Tasks**: `task-list` → `task-claim` → `task-update` (in_progress → completed)
22
22
  - Register planned steps via `task-create` before execution.
23
23
  - Never skip intermediate `in_progress` state before `completed`.
24
+ - **Commit Message**: Every commit MUST include the **Task Code**, **Title**, and **Summary** in this format:
25
+ `type(scope): [task-code] message`
26
+
27
+ `- [Task Title]`
28
+ ` [Summary Task]`
24
29
  - Completing a task auto-releases claims and expires linked handoffs.
25
30
 
26
31
  **Standards**: `standard-search` → `standard-store`
@@ -41,6 +46,7 @@ Use at the START of every session and before any implementation work:
41
46
  - `root-cause-analysis` — structured bug / incident investigation
42
47
  - `fix-suggestion` — propose and validate fixes
43
48
  - `security-triage` — security risk assessment
49
+ - `sentinel-issue-resolver` — autonomous GitHub issue resolution (SENTINEL identity)
44
50
  - `learning-retrospective` — capture lessons and update memory
45
51
  - `documentation-sync` — sync docs with current codebase state
46
52
  - `project-briefing` — generate repository briefing from memory
@@ -8,8 +8,17 @@ agent: Task Executor
8
8
  ## 1. SYNC & FILTER
9
9
  1. **Identify**: Get repo name (git/context).
10
10
  2. **List**: Call `task-list` ONCE for active tasks.
11
- 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`.
12
- 4. **Audit**: Identify stale `in_progress` tasks (>30m no update). Hydrate via `task-detail` to check timestamps.
11
+ 3. **Dependency-aware selection** (in `task-list` order):
12
+ - Process tasks in the order returned by `task-list`.
13
+ - A task is READY only if:
14
+ - status is `backlog` or `pending`, and
15
+ - `depends_on` is empty, or the dependency task exists and is `completed`, and
16
+ - `parent_id` is empty, or the parent task is `completed`.
17
+ - Keep non-ready tasks out of execution for now.
18
+ - If a task is blocked by unresolved dependency/parent, do not claim it and continue to the next ready task.
19
+ - If all active tasks are blocked, report blockers and stop execution loop.
20
+ 4. **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`.
21
+ 5. **Audit**: Identify stale `in_progress` tasks (>30m no update). Hydrate via `task-detail` to check timestamps.
13
22
 
14
23
  ## Task Cache (MANDATORY)
15
24
  - `task-detail` MUST be called at most ONCE per task
@@ -23,29 +32,35 @@ agent: Task Executor
23
32
  - **Spawn Limit**: The total number of parallel sub-agents MUST NOT exceed 2. Each sub-agent executes EXACTLY ONE task at a time.
24
33
  - **Fallback**: If the current agent CANNOT spawn sub-agents, it MUST execute tasks sequentially (exactly ONE concurrent task) until the queue is clear.
25
34
  2. **Hydrate**: Fetch full context via `task-detail` for the assigned task.
26
- 3. **Claim**: Use `task-claim` with `task_code` or `task_id` before implementation.
27
- 4. **Start**: `task-update` status to `in_progress` (MUST transition: `pending` `in_progress`). Add agent/role metadata.
28
- 5. **Research**: Call `memory-search` (Hybrid Search) and hydrate relevant results with `memory-detail`.
29
- 6. **Standards (MANDATORY PER TASK)**: Call `standard-search` for every task inside the execution loop before any code edit, test edit, refactor, migration, or implementation decision, using the task intent, affected files, inferred language, stack, and repo as filters. This is required even for small tasks, decomposed tasks, and sub-agent assignments. Apply only relevant standards, hydrate details when needed, and if no relevant standards are returned, continue and state that no applicable standards were found.
30
- 7. **Execute**:
35
+ 3. **Readiness re-check**: Re-check blockers from hydrated detail (`depends_on`, `parent_id`) before claim. If still blocked, return to step 2 (execution loop) and pick the next ready task in list order.
36
+ 4. **Claim**: Use `task-claim` with `task_code` or `task_id` before implementation.
37
+ 5. **Start**: `task-update` status to `in_progress` (MUST transition: `pending` `in_progress`). Add agent/role metadata.
38
+ 6. **Research**: Call `memory-search` (Hybrid Search) and hydrate relevant results with `memory-detail`.
39
+ 7. **Standards (MANDATORY PER TASK)**: Call `standard-search` for every task inside the execution loop before any code edit, test edit, refactor, migration, or implementation decision, using the task intent, affected files, inferred language, stack, and repo as filters. This is required even for small tasks, decomposed tasks, and sub-agent assignments. Apply only relevant standards, hydrate details when needed, and if no relevant standards are returned, continue and state that no applicable standards were found.
40
+ 8. **Execute**:
31
41
  - **Trace**: Inspect logic, call sites, and docs. DO NOT infer from file presence.
32
42
  - **Logic**: Implement per description/intent.
33
- 8. **Validate**:
43
+ 9. **Validate**:
34
44
  - Trace path end-to-end.
35
45
  - Run tests/linters/type-checks.
36
46
  - Logic audit for all affected paths.
37
47
  - **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.
38
- 9. **Finalize**:
48
+ 10. **Finalize**:
39
49
  - **Evidence**: `task-update` status to `completed` with detailed 'comment' (inspected files, verified logic, test results).
40
50
  - **Cleanup**: Completing/canceling a task automatically releases active claims and expires linked pending handoffs.
41
51
  - **Memory**: Store insights as `code_fact`/`pattern` via `memory-store`.
42
52
  - **Standards**: Store durable implementation rules via `standard-store`, not generic memory.
43
53
  - **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.
44
54
  - **Retrospective**: Invoke `learning-retrospective`.
45
- - **Commit**: Atomic git commit. The commit message MUST include the task code (for example: `fix: ... [TASK-123]`).
55
+ - **Commit**: Atomic git commit. The commit message MUST follow this format: `type(scope): [task-code] your commit message`, followed by a detailed description:
56
+ ```
57
+ - [Task Title]
58
+ [Summary Task]
59
+ ```
60
+ This ensures full traceability between code changes and project context.
46
61
  - **GitHub Issue Traceability**: If task metadata contains a GitHub Issue reference, the commit message MUST also include the issue hashtag in `#123` format.
47
62
  - **Issue Number Extraction**: Read the issue number from task metadata when available. If metadata only contains a GitHub Issue URL, extract the trailing issue number from that URL before committing.
48
- 10. **Repeat**: Claim next task from `task-list`.
63
+ 11. **Repeat**: Claim next task from `task-list`.
49
64
 
50
65
  ## 3. BACKLOG MAINTENANCE
51
66
  If active queue is empty:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vheins/local-memory-mcp",
3
- "version": "0.10.8",
3
+ "version": "0.10.10",
4
4
  "description": "MCP Local Memory Service for coding copilot agents",
5
5
  "mcpName": "io.github.vheins/local-memory-mcp",
6
6
  "type": "module",