@damper/mcp 0.3.5 → 0.3.7

package/README.md

@@ -310,6 +310,36 @@ When working on tasks, follow this workflow for best results:
 > Sync all my documentation to Damper
 ```
 
+## Agent Instructions (CLAUDE.md)
+
+Add this to your project's `CLAUDE.md` (or `.cursorrules` for Cursor) to ensure AI agents use Damper consistently:
+
+```markdown
+## Task Management with Damper MCP
+
+This project uses Damper MCP for task tracking. **You MUST follow this workflow.**
+
+### At Session Start
+1. `get_project_context` - Read available project documentation
+2. `list_tasks` - Check for existing tasks to work on
+3. If working on a task: `start_task` to lock it
+
+### While Working
+- `add_note` after each commit: "Committed abc123: description"
+- `add_note` for decisions: "Decision: chose X because Y"
+- `update_subtask` to mark subtask progress
+
+### At Session End (MANDATORY)
+- ALWAYS call `add_note` with session summary before stopping
+- ALWAYS call `complete_task` (if done) or `abandon_task` (if stopping early)
+- NEVER leave a started task without completing or abandoning it
+
+### Why This Matters
+- Locked tasks block other agents from working on them
+- Notes help the next agent (or you) continue the work
+- Project context saves future agents from re-analyzing the codebase
+```
+
 ## Environment
 
 | Variable | Required | Default |

package/dist/index.js

@@ -635,7 +635,10 @@ server.registerTool('get_context_section', {
         openWorldHint: false,
     },
 }, async ({ section }) => {
-    const data = await api('GET', `/api/agent/context/${encodeURIComponent(section)}`);
+    // Encode section for URL path - encodeURIComponent doesn't encode * which can cause
+    // issues with some proxies/CDNs that interpret * as a wildcard
+    const encodedSection = encodeURIComponent(section).replace(/\*/g, '%2A');
+    const data = await api('GET', `/api/agent/context/${encodedSection}`);
     // Handle glob pattern response (multiple sections)
     if (data.pattern && data.sections) {
         const lines = [`**Sections matching "${data.pattern}":**\n`];
@@ -704,6 +707,33 @@ server.registerTool('update_context_section', {
         structuredContent: result,
     };
 });
+// Tool: Delete context section
+server.registerTool('delete_context_section', {
+    title: 'Delete Context Section',
+    description: 'Delete a project context section. Use when documentation is outdated or no longer relevant.',
+    inputSchema: z.object({
+        section: z.string()
+            .regex(/^[a-z][a-z0-9-]{0,49}(\/[a-z][a-z0-9-]{0,49}){0,2}$/)
+            .describe('Section name or path to delete (e.g., "overview", "api/architecture")'),
+    }),
+    outputSchema: z.object({
+        success: z.boolean(),
+        section: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ section }) => {
+    const encodedSection = encodeURIComponent(section).replace(/\*/g, '%2A');
+    const result = await api('DELETE', `/api/agent/context/${encodedSection}`);
+    return {
+        content: [{ type: 'text', text: `🗑️ Deleted context section: ${result.section}` }],
+        structuredContent: result,
+    };
+});
 // Tool: Sync project context (bulk upload)
 server.registerTool('sync_project_context', {
     title: 'Sync Project Context',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/mcp",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {