@damper/mcp 0.4.0 → 0.5.0

package/README.md

@@ -118,6 +118,26 @@ AI agents can store and retrieve project documentation to help future agents wor
 
 ⚠️ **Security:** Never include sensitive data (API keys, secrets, credentials, connection strings) in context uploads. Users can review and delete context from Settings → AI Context.
 
+### Project Settings
+
+Configure agent-relevant project settings programmatically.
+
+| Tool | Description |
+|------|-------------|
+| `get_project_settings` | View current settings (completion checklist, etc.) |
+| `update_project_settings` | Configure completion checklist and other agent-relevant settings |
+
+**Completion checklist workflow:**
+1. `update_project_settings` with `completionChecklist: ["All tests pass", "Build succeeds"]`
+2. Agents see the checklist when they call `start_task`
+3. Agents must confirm all items via `confirmations` when calling `complete_task`
+
+```
+> View project settings
+> Set completion checklist to require tests and builds
+> Clear the completion checklist
+```
+
 ### Hierarchical Sections
 
 For monorepos or large projects, organize sections hierarchically:

package/dist/index.js

@@ -41,7 +41,7 @@ async function api(method, path, body) {
 // Server
 const server = new McpServer({
     name: 'damper',
-    version: '0.4.0',
+    version: '0.5.0',
 });
 // Output schemas
 const SubtaskProgressSchema = z.object({
@@ -722,7 +722,7 @@ server.registerTool('get_agent_instructions', {
         openWorldHint: false,
     },
 }, async ({ format = 'section' }) => {
-    const lastModified = '2025-02-05';
+    const lastModified = '2025-02-06';
     const section = `## Task Management with Damper MCP
 
 > Last updated: ${lastModified}
@@ -753,6 +753,10 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
 - \`add_to_changelog\` - Manually add completed tasks to a changelog
 - \`publish_changelog\` - Publish with optional email notifications and Twitter posting
 
+### Project Settings
+- \`get_project_settings\` - View current settings (completion checklist, etc.)
+- \`update_project_settings\` - Configure completion checklist and other agent-relevant settings
+
 ### At Session End (MANDATORY)
 - ALWAYS call \`complete_task\` (if done) or \`abandon_task\` (if stopping early)
 - NEVER leave a started task without completing or abandoning it
@@ -1875,6 +1879,74 @@ server.registerTool('publish_changelog', {
         },
     };
 });
+// ==================== Project Settings Tools ====================
+// Tool: Get project settings
+server.registerTool('get_project_settings', {
+    title: 'Get Project Settings',
+    description: 'View current project settings relevant to agents (completion checklist, etc.).\n\n' +
+        '**When to use**: Check what completion checklist items are configured, or verify settings before updating them.',
+    inputSchema: z.object({}),
+    outputSchema: z.object({
+        completionChecklist: z.array(z.string()),
+    }),
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async () => {
+    const data = await api('GET', '/api/agent/project/settings');
+    if (!data.completionChecklist || data.completionChecklist.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No completion checklist configured.' }],
+            structuredContent: data,
+        };
+    }
+    const lines = data.completionChecklist.map((item, i) => `${i + 1}. ${item}`);
+    return {
+        content: [{ type: 'text', text: `Completion checklist:\n${lines.join('\n')}` }],
+        structuredContent: data,
+    };
+});
+// Tool: Update project settings
+server.registerTool('update_project_settings', {
+    title: 'Update Project Settings',
+    description: 'Configure agent-relevant project settings.\n\n' +
+        '**completionChecklist**: Items agents must confirm before completing tasks. ' +
+        'Pass an empty array to clear the checklist.\n\n' +
+        'Example items: "All tests pass", "Build succeeds", "Migration created if schema changed"',
+    inputSchema: z.object({
+        completionChecklist: z.array(z.string()).optional()
+            .describe('Checklist items agents must confirm when completing tasks. Pass [] to clear.'),
+    }),
+    outputSchema: z.object({
+        completionChecklist: z.array(z.string()),
+        message: z.string(),
+    }),
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+}, async ({ completionChecklist }) => {
+    const body = {};
+    if (completionChecklist !== undefined)
+        body.completionChecklist = completionChecklist;
+    const result = await api('PATCH', '/api/agent/project/settings', body);
+    if (result.completionChecklist.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'Completion checklist cleared.' }],
+            structuredContent: result,
+        };
+    }
+    const lines = result.completionChecklist.map((item, i) => `${i + 1}. ${item}`);
+    return {
+        content: [{ type: 'text', text: `${result.message}\n${lines.join('\n')}` }],
+        structuredContent: result,
+    };
+});
 // Start
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

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