@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.
- package/dist/{chunk-U2NZ5E3P.js → chunk-76IHLGKG.js} +2 -2
- package/dist/dashboard/server.js +1 -1
- package/dist/mcp/server.js +1 -1
- package/dist/prompts/sentinel-issue-resolver.md +42 -0
- package/dist/prompts/server/instructions.md +6 -0
- package/dist/prompts/task-memory-executor.md +26 -11
- package/package.json +1 -1
|
@@ -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.
|
|
85
|
-
pkgVersion = "0.10.
|
|
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++) {
|
package/dist/dashboard/server.js
CHANGED
package/dist/mcp/server.js
CHANGED
|
@@ -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. **
|
|
12
|
-
|
|
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. **
|
|
27
|
-
4. **
|
|
28
|
-
5. **
|
|
29
|
-
6. **
|
|
30
|
-
7. **
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
63
|
+
11. **Repeat**: Claim next task from `task-list`.
|
|
49
64
|
|
|
50
65
|
## 3. BACKLOG MAINTENANCE
|
|
51
66
|
If active queue is empty:
|