@vibescope/mcp-server 0.4.4 → 0.4.6

package/src/tools/discovery.ts

@@ -1,76 +1,76 @@
-/**
- * Discovery Tool Definitions
- *
- * Tools for discovering and querying project knowledge:
- * - query_knowledge_base
- * - discover_tools
- * - get_tool_info
- */
-
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-
-export const discoveryTools: Tool[] = [
-	{
-		name: 'query_knowledge_base',
-		description: `Query aggregated project knowledge in a single call. Returns findings, Q&A, decisions, completed tasks, and resolved blockers. Use this instead of multiple separate tool calls to reduce token usage.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				scope: {
-					type: 'string',
-					enum: ['summary', 'detailed'],
-					description: 'Response detail level: summary (default) or detailed (includes rationales)',
-				},
-				categories: {
-					type: 'array',
-					items: {
-						type: 'string',
-						enum: ['findings', 'qa', 'decisions', 'completed_tasks', 'blockers', 'progress'],
-					},
-					description: 'Categories to include (default: all). Filter to reduce response size.',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max items per category (default: 5, max: 20)',
-				},
-				search_query: {
-					type: 'string',
-					description: 'Optional text search across all knowledge',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'discover_tools',
-		description: 'List tools by category. Use get_tool_info for details.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				category: {
-					type: 'string',
-					enum: ['session', 'project', 'tasks', 'milestones', 'progress', 'blockers', 'decisions', 'ideas', 'findings', 'validation', 'deployment', 'fallback', 'bodies_of_work', 'sprints', 'requests', 'organizations', 'cost', 'git_issues', 'knowledge', 'discovery', 'subtasks', 'worktrees', 'roles', 'file_locks'],
-					description: 'Category to list (omit for all categories)',
-				},
-			},
-		},
-	},
-	{
-		name: 'get_tool_info',
-		description: 'Get detailed tool documentation.',
-		inputSchema: {
-			type: 'object',
-			properties: {
-				tool_name: {
-					type: 'string',
-					description: 'Tool name',
-				},
-			},
-			required: ['tool_name'],
-		},
-	},
-];
+/**
+ * Discovery Tool Definitions
+ *
+ * Tools for discovering and querying project knowledge:
+ * - query_knowledge_base
+ * - discover_tools
+ * - get_tool_info
+ */
+
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+export const discoveryTools: Tool[] = [
+	{
+		name: 'query_knowledge_base',
+		description: `Query aggregated project knowledge in a single call. Returns findings, Q&A, decisions, completed tasks, and resolved blockers. Use this instead of multiple separate tool calls to reduce token usage.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				scope: {
+					type: 'string',
+					enum: ['summary', 'detailed'],
+					description: 'Response detail level: summary (default) or detailed (includes rationales)',
+				},
+				categories: {
+					type: 'array',
+					items: {
+						type: 'string',
+						enum: ['findings', 'qa', 'decisions', 'completed_tasks', 'blockers', 'progress'],
+					},
+					description: 'Categories to include (default: all). Filter to reduce response size.',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max items per category (default: 5, max: 20)',
+				},
+				search_query: {
+					type: 'string',
+					description: 'Optional text search across all knowledge',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'discover_tools',
+		description: 'List tools by category. Use get_tool_info for details.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				category: {
+					type: 'string',
+					enum: ['session', 'project', 'tasks', 'milestones', 'progress', 'blockers', 'decisions', 'ideas', 'findings', 'validation', 'deployment', 'fallback', 'bodies_of_work', 'sprints', 'requests', 'organizations', 'cost', 'git_issues', 'knowledge', 'discovery', 'subtasks', 'worktrees', 'roles', 'file_locks'],
+					description: 'Category to list (omit for all categories)',
+				},
+			},
+		},
+	},
+	{
+		name: 'get_tool_info',
+		description: 'Get detailed tool documentation.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				tool_name: {
+					type: 'string',
+					description: 'Tool name',
+				},
+			},
+			required: ['tool_name'],
+		},
+	},
+];

package/src/tools/fallback.ts

@@ -1,111 +1,111 @@
-/**
- * Fallback Activity Tool Definitions
- *
- * Tools for managing background activities when no tasks available:
- * - start_fallback_activity
- * - stop_fallback_activity
- * - get_activity_history
- * - get_activity_schedules
- */
-
-import type { Tool } from './types.js';
-
-export const fallbackTools: Tool[] = [
-	{
-		name: 'start_fallback_activity',
-		description: `Start a background activity when no tasks available.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				activity: {
-					type: 'string',
-					description: 'The fallback activity type (e.g., code_review, security_review)',
-					enum: [
-						'feature_ideation',
-						'code_review',
-						'performance_audit',
-						'ux_review',
-						'cost_analysis',
-						'security_review',
-						'test_coverage',
-						'documentation_review',
-						'dependency_audit',
-						'validate_completed_tasks',
-						'worktree_cleanup',
-					],
-				},
-			},
-			required: ['project_id', 'activity'],
-		},
-	},
-	{
-		name: 'stop_fallback_activity',
-		description: `Stop current fallback activity. Auto-clears when starting a regular task.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				summary: {
-					type: 'string',
-					description: 'Optional summary of what was accomplished during this activity',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'get_activity_history',
-		description: `Get background activity completion history.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				activity_type: {
-					type: 'string',
-					description: 'Optional: filter to a specific activity type',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max number of history entries to return (default 50)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of entries to skip for pagination (default 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-	{
-		name: 'get_activity_schedules',
-		description: `Get background activity schedules.`,
-		inputSchema: {
-			type: 'object',
-			properties: {
-				project_id: {
-					type: 'string',
-					description: 'Project UUID',
-				},
-				limit: {
-					type: 'number',
-					description: 'Max schedules to return (default: 50)',
-				},
-				offset: {
-					type: 'number',
-					description: 'Number of schedules to skip for pagination (default: 0)',
-				},
-			},
-			required: ['project_id'],
-		},
-	},
-];
+/**
+ * Fallback Activity Tool Definitions
+ *
+ * Tools for managing background activities when no tasks available:
+ * - start_fallback_activity
+ * - stop_fallback_activity
+ * - get_activity_history
+ * - get_activity_schedules
+ */
+
+import type { Tool } from './types.js';
+
+export const fallbackTools: Tool[] = [
+	{
+		name: 'start_fallback_activity',
+		description: `Start a background activity when no tasks available.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				activity: {
+					type: 'string',
+					description: 'The fallback activity type (e.g., code_review, security_review)',
+					enum: [
+						'feature_ideation',
+						'code_review',
+						'performance_audit',
+						'ux_review',
+						'cost_analysis',
+						'security_review',
+						'test_coverage',
+						'documentation_review',
+						'dependency_audit',
+						'validate_completed_tasks',
+						'worktree_cleanup',
+					],
+				},
+			},
+			required: ['project_id', 'activity'],
+		},
+	},
+	{
+		name: 'stop_fallback_activity',
+		description: `Stop current fallback activity. Auto-clears when starting a regular task.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				summary: {
+					type: 'string',
+					description: 'Optional summary of what was accomplished during this activity',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_activity_history',
+		description: `Get background activity completion history.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				activity_type: {
+					type: 'string',
+					description: 'Optional: filter to a specific activity type',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of history entries to return (default 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of entries to skip for pagination (default 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'get_activity_schedules',
+		description: `Get background activity schedules.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max schedules to return (default: 50)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of schedules to skip for pagination (default: 0)',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/features.ts

@@ -0,0 +1,154 @@
+/**
+ * Feature Tool Definitions
+ *
+ * Tools for managing feature specs (between ideas and tasks):
+ * - add_feature
+ * - update_feature
+ * - get_feature
+ * - get_features
+ * - delete_feature
+ * - link_idea_to_feature
+ */
+
+import type { Tool } from './types.js';
+
+export const featureTools: Tool[] = [
+	{
+		name: 'add_feature',
+		description: `Create a new feature spec. Features sit between ideas (quick thoughts) and tasks (actionable work). Use features to flesh out a concept into a full spec before breaking it into tasks. Starts as 'draft'.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Feature title',
+				},
+				body: {
+					type: 'string',
+					description: 'Markdown spec content — requirements, user stories, acceptance criteria, technical approach',
+				},
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+					description: 'Priority 1-5 (1 = highest, default: 2)',
+				},
+			},
+			required: ['project_id', 'title'],
+		},
+	},
+	{
+		name: 'update_feature',
+		description: `Update a feature's title, body, status, or priority.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				feature_id: {
+					type: 'string',
+					description: 'Feature UUID',
+				},
+				title: {
+					type: 'string',
+					description: 'Updated title',
+				},
+				body: {
+					type: 'string',
+					description: 'Updated markdown spec content',
+				},
+				status: {
+					type: 'string',
+					enum: ['draft', 'refining', 'specced', 'ready', 'building', 'shipped'],
+					description: 'New status',
+				},
+				priority: {
+					type: 'number',
+					minimum: 1,
+					maximum: 5,
+					description: 'Updated priority (1 = highest)',
+				},
+			},
+			required: ['feature_id'],
+		},
+	},
+	{
+		name: 'get_feature',
+		description: `Get a single feature by ID. More token-efficient than get_features when you need details for a specific feature.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				feature_id: {
+					type: 'string',
+					description: 'Feature UUID',
+				},
+			},
+			required: ['feature_id'],
+		},
+	},
+	{
+		name: 'get_features',
+		description: `Get features for a project, optionally filtered by status. Features represent fleshed-out specs between ideas and tasks.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+				status: {
+					type: 'string',
+					enum: ['draft', 'refining', 'specced', 'ready', 'building', 'shipped'],
+					description: 'Filter by status (optional)',
+				},
+				limit: {
+					type: 'number',
+					description: 'Max number of features to return (default 20, max 100)',
+				},
+				offset: {
+					type: 'number',
+					description: 'Number of features to skip for pagination (default 0)',
+				},
+				search_query: {
+					type: 'string',
+					description: 'Search features by title or body content',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+	{
+		name: 'delete_feature',
+		description: `Delete a feature spec. This also removes all linked idea and task associations.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				feature_id: {
+					type: 'string',
+					description: 'Feature UUID',
+				},
+			},
+			required: ['feature_id'],
+		},
+	},
+	{
+		name: 'link_idea_to_feature',
+		description: `Link an existing idea to a feature spec. This associates the idea as inspiration for the feature.`,
+		inputSchema: {
+			type: 'object',
+			properties: {
+				feature_id: {
+					type: 'string',
+					description: 'Feature UUID',
+				},
+				idea_id: {
+					type: 'string',
+					description: 'Idea UUID to link',
+				},
+			},
+			required: ['feature_id', 'idea_id'],
+		},
+	},
+];