feat: Add tool annotations for improved LLM tool understanding

src/tools/approvals.ts

@@ -78,6 +78,10 @@ CRITICAL: Only provide filePath parameter for requests - the dashboard reads fil
       }
     },
     required: ['action']
+  },
+  annotations: {
+    title: 'Approvals',
+    destructiveHint: true,
   }
 };
 

src/tools/log-implementation.ts

@@ -283,6 +283,10 @@ Task: "Implemented logs dashboard with real-time updates"
       }
     },
     required: ['specName', 'taskId', 'summary', 'filesModified', 'filesCreated', 'statistics', 'artifacts']
+  },
+  annotations: {
+    title: 'Log Implementation',
+    destructiveHint: true,
   }
 };
 

src/tools/spec-status.ts

@@ -12,16 +12,20 @@ Call when resuming work on a spec or checking overall completion status. Shows w
   inputSchema: {
     type: 'object',
     properties: {
-      projectPath: { 
+      projectPath: {
         type: 'string',
         description: 'Absolute path to the project root (optional - uses server context path if not provided)'
       },
-      specName: { 
+      specName: {
         type: 'string',
         description: 'Name of the specification'
       }
     },
     required: ['specName']
+  },
+  annotations: {
+    title: 'Spec Status',
+    readOnlyHint: true,
   }
 };
 

src/tools/spec-workflow-guide.ts

@@ -11,6 +11,10 @@ Call this tool FIRST when users request spec creation, feature development, or m
     type: 'object',
     properties: {},
     additionalProperties: false
+  },
+  annotations: {
+    title: 'Spec Workflow Guide',
+    readOnlyHint: true,
   }
 };
 

src/tools/steering-guide.ts

@@ -11,6 +11,10 @@ Call ONLY when user explicitly requests steering document creation or asks about
     type: 'object',
     properties: {},
     additionalProperties: false
+  },
+  annotations: {
+    title: 'Steering Guide',
+    readOnlyHint: true,
   }
 };