@damper/mcp 0.3.4 → 0.3.6

package/README.md

@@ -259,6 +259,32 @@ When you start a task, it's locked to prevent other agents from working on it si
 - Different agent starting → fails with 409 (use `force: true` to take over)
 - Complete or abandon → releases lock
 
+### Recommended Workflow
+
+When working on tasks, follow this workflow for best results:
+
+1. **Start**: `start_task` → locks the task and returns project context
+2. **Log start**: `add_note` with "Session started: <your goal>"
+3. **Work**: Make changes, logging commits and decisions with `add_note`
+4. **Log end**: `add_note` with "Session end: <summary, next steps>"
+5. **Finish**: `complete_task` (done) or `abandon_task` (stopping)
+
+**Note types to log:**
+- Session start: `"Session started: implementing dark mode"`
+- Commits: `"Committed abc123: Added theme provider"`
+- Decisions: `"Decision: Using CSS variables because..."`
+- Session end: `"Session end: Done theme provider, remaining: toggle UI"`
+
+**Before completing:**
+- Push all commits
+- Log session end note
+- Check if project context docs need updating
+
+**Before abandoning:**
+- Push any WIP commits
+- Log session end with progress, blockers, next steps
+- Provide summary for handoff
+
 ## Usage Examples
 
 ### Tasks

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.4",
+  "version": "0.3.6",
   "description": "MCP server for Damper task management",
   "author": "Damper <hello@usedamper.com>",
   "repository": {