@vibescope/mcp-server 0.4.7 → 0.4.8

package/dist/handlers/discovery.js

@@ -340,6 +340,12 @@ export const TOOL_CATEGORIES = {
             { name: 'update_mcp_server', brief: 'Self-update the MCP server' },
         ],
     },
+    persona_templates: {
+        description: 'Persona templates — behavioral archetypes that shape agent behavior',
+        tools: [
+            { name: 'get_persona_templates', brief: 'List available persona templates for a project' },
+        ],
+    },
     features: {
         description: 'Feature specs — flesh out ideas into full specs before breaking into tasks',
         tools: [

package/dist/handlers/tool-docs.js

@@ -1300,6 +1300,17 @@ Read recent project chat messages to stay informed about project communication.
 - count: Number of messages returned
 
 **Example:** get_project_messages(project_id: "123e4567-e89b-12d3-a456-426614174000", limit: 10)`,
+    post_progress: `# post_progress
+Post a structured progress update to the project chat. Use at key milestones: starting a task, creating a PR, hitting a blocker, or completing work.
+
+**Parameters:**
+- project_id (required): Project UUID
+- message (required): Progress update message (supports markdown)
+- type (optional): Update type — info (general), milestone (key achievement), blocker (blocking issue), question (asking for input). Default: info
+
+**Returns:** Confirmation with message_id and timestamp.
+
+**Example:** post_progress(project_id: "123e4567-e89b-12d3-a456-426614174000", message: "PR #42 created for auth feature", type: "milestone")`,
     // Version management tools  
     check_mcp_version: `# check_mcp_version
 Check for available MCP server updates and version information.
@@ -1331,6 +1342,17 @@ Self-update the MCP server to the latest available version.
 **Example:** update_mcp_server()
 
 **Note:** This operation may temporarily disconnect active sessions during restart.`,
+    // Persona template tools
+    get_persona_templates: `# get_persona_templates
+List available persona templates for a project. Returns both global defaults and project-specific templates.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:**
+- templates: Array of persona templates with id, name, description, focus_areas, icon, is_default, scope (global/project)
+
+**Example:** get_persona_templates(project_id: "123e4567-e89b-12d3-a456-426614174000")`,
     add_feature: `# add_feature
 Create a draft feature spec. Features sit between ideas (quick thoughts) and tasks (actionable work).
 

package/dist/tools/index.d.ts

@@ -32,6 +32,7 @@ import { connectorTools } from './connectors.js';
 import { cloudAgentTools } from './cloud-agents.js';
 import { versionTools } from './version.js';
 import { featureTools } from './features.js';
+import { personaTemplateTools } from './persona-templates.js';
 /**
  * All MCP tool definitions combined
  */
@@ -71,5 +72,6 @@ export declare const toolCategories: {
     readonly cloudAgents: string[];
     readonly version: string[];
     readonly features: string[];
+    readonly personaTemplates: string[];
 };
-export { sessionTools, costTools, discoveryTools, worktreeTools, projectTools, taskTools, progressTools, blockerTools, decisionTools, ideaTools, findingTools, validationTools, deploymentTools, fallbackTools, requestTools, milestoneTools, bodiesOfWorkTools, organizationTools, fileCheckoutTools, roleTools, sprintTools, gitIssueTools, connectorTools, cloudAgentTools, versionTools, featureTools, };
+export { sessionTools, costTools, discoveryTools, worktreeTools, projectTools, taskTools, progressTools, blockerTools, decisionTools, ideaTools, findingTools, validationTools, deploymentTools, fallbackTools, requestTools, milestoneTools, bodiesOfWorkTools, organizationTools, fileCheckoutTools, roleTools, sprintTools, gitIssueTools, connectorTools, cloudAgentTools, versionTools, featureTools, personaTemplateTools, };

package/dist/tools/index.js

@@ -32,6 +32,7 @@ import { cloudAgentTools } from './cloud-agents.js';
 import { versionTools } from './version.js';
 import { chatTools } from './chat.js';
 import { featureTools } from './features.js';
+import { personaTemplateTools } from './persona-templates.js';
 /**
  * All MCP tool definitions combined
  */
@@ -63,6 +64,7 @@ export const tools = [
     ...versionTools,
     ...chatTools,
     ...featureTools,
+    ...personaTemplateTools,
 ];
 /**
  * Build the complete tool list from all domain modules
@@ -101,6 +103,7 @@ export const toolCategories = {
     cloudAgents: cloudAgentTools.map((t) => t.name),
     version: versionTools.map((t) => t.name),
     features: featureTools.map((t) => t.name),
+    personaTemplates: personaTemplateTools.map((t) => t.name),
 };
 // Re-export domain tools for selective imports
-export { sessionTools, costTools, discoveryTools, worktreeTools, projectTools, taskTools, progressTools, blockerTools, decisionTools, ideaTools, findingTools, validationTools, deploymentTools, fallbackTools, requestTools, milestoneTools, bodiesOfWorkTools, organizationTools, fileCheckoutTools, roleTools, sprintTools, gitIssueTools, connectorTools, cloudAgentTools, versionTools, featureTools, };
+export { sessionTools, costTools, discoveryTools, worktreeTools, projectTools, taskTools, progressTools, blockerTools, decisionTools, ideaTools, findingTools, validationTools, deploymentTools, fallbackTools, requestTools, milestoneTools, bodiesOfWorkTools, organizationTools, fileCheckoutTools, roleTools, sprintTools, gitIssueTools, connectorTools, cloudAgentTools, versionTools, featureTools, personaTemplateTools, };

package/dist/tools/persona-templates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Persona Template Tool Definitions
+ *
+ * Tools for managing persona templates:
+ * - get_persona_templates
+ */
+import type { Tool } from './types.js';
+export declare const personaTemplateTools: Tool[];

package/dist/tools/persona-templates.js

@@ -0,0 +1,22 @@
+/**
+ * Persona Template Tool Definitions
+ *
+ * Tools for managing persona templates:
+ * - get_persona_templates
+ */
+export const personaTemplateTools = [
+    {
+        name: 'get_persona_templates',
+        description: 'List available persona templates for a project. Returns both global defaults and project-specific templates. Persona templates define behavioral archetypes (e.g., Code Reviewer, QA Engineer) that shape agent behavior.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Project UUID',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+];

package/dist/tools/tasks.js

@@ -222,6 +222,10 @@ WHEN TO USE: If the user gives you work directly (e.g., "implement feature X", "
                     enum: ['haiku', 'sonnet', 'opus'],
                     description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
                 },
+                assigned_agent_name: {
+                    type: 'string',
+                    description: 'Pre-assign this task to a specific agent by persona name. Only that agent will pick it up via get_next_task.',
+                },
             },
             required: ['project_id', 'title'],
         },
@@ -292,6 +296,10 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
                     enum: ['haiku', 'sonnet', 'opus'],
                     description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
                 },
+                assigned_agent_name: {
+                    type: ['string', 'null'],
+                    description: 'Pre-assign this task to a specific agent by persona name. Set to null to unassign. Only the assigned agent will pick it up via get_next_task.',
+                },
                 skip_worktree_requirement: {
                     type: 'boolean',
                     description: 'Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false',

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-03-04
+> Generated: 2026-03-05
 >
-> Total tools: 167
+> Total tools: 168
 
 ## Table of Contents
 
@@ -36,6 +36,7 @@
 - [cloud_agents](#cloud-agents) - Cloud agent management and cleanup (3 tools)
 - [chat](#chat) - Project-wide chat channel for agent and user communication (3 tools)
 - [version](#version) - MCP server version management and updates (2 tools)
+- [persona_templates](#persona-templates) - Persona templates — behavioral archetypes that shape agent behavior (1 tools)
 - [features](#features) - Feature specs — flesh out ideas into full specs before breaking into tasks (6 tools)
 
 ## session
@@ -380,6 +381,7 @@ WHEN TO USE: If the user gives you work directly (e.g., "implement feature X", "
 | `estimated_minutes` | `number` | No | Estimated time to complete in minutes (min: 1) |
 | `blocking` | `boolean` | No | When true, this task blocks all other work until complete (used for deployment finalization) |
 | `model_capability` | `"haiku" | "sonnet" | "opus"` | No | Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning) |
+| `assigned_agent_name` | `string` | No | Pre-assign this task to a specific agent by persona name. Only that agent will pick it up via get_next_task. |
 
 ---
 
@@ -417,6 +419,7 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
 | `worktree_path` | `string` | No | Git worktree path for this task (e.g., "../project-task-abc123"). Store this for cleanup tracking across sessions. |
 | `worktree_hostname` | `string` | No | Machine hostname where worktree was created (os.hostname()). Required with worktree_path to enable machine-aware cleanup. |
 | `model_capability` | `"haiku" | "sonnet" | "opus"` | No | Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning) |
+| `assigned_agent_name` | `string,null` | No | Pre-assign this task to a specific agent by persona name. Set to null to unassign. Only the assigned agent will pick it up via get_next_task. |
 | `skip_worktree_requirement` | `boolean` | No | Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false |
 | `session_id` | `string` | No | Session ID from start_work_session. Required for cloud agents using mcporter (session context is not preserved between calls). Links the task to your agent on the dashboard. |
 
@@ -2574,6 +2577,22 @@ Update the Vibescope MCP server to the latest version. Runs npm install to fetch
 
 ---
 
+## persona_templates
+
+*Persona templates — behavioral archetypes that shape agent behavior*
+
+### get_persona_templates
+
+List available persona templates for a project. Returns both global defaults and project-specific templates. Persona templates define behavioral archetypes (e.g., Code Reviewer, QA Engineer) that shape agent behavior.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | `string` | Yes | Project UUID |
+
+---
+
 ## features
 
 *Feature specs — flesh out ideas into full specs before breaking into tasks*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescope/mcp-server",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "MCP server for Vibescope - AI project tracking tools",
   "type": "module",
   "main": "dist/index.js",

package/src/handlers/discovery.ts

@@ -348,6 +348,12 @@ export const TOOL_CATEGORIES: Record<string, { description: string; tools: Array
 			{ name: 'update_mcp_server', brief: 'Self-update the MCP server' },
 		],
 	},
+	persona_templates: {
+		description: 'Persona templates — behavioral archetypes that shape agent behavior',
+		tools: [
+			{ name: 'get_persona_templates', brief: 'List available persona templates for a project' },
+		],
+	},
 	features: {
 		description: 'Feature specs — flesh out ideas into full specs before breaking into tasks',
 		tools: [

package/src/handlers/tool-docs.ts

@@ -1464,6 +1464,18 @@ Read recent project chat messages to stay informed about project communication.
 
 **Example:** get_project_messages(project_id: "123e4567-e89b-12d3-a456-426614174000", limit: 10)`,
 
+	post_progress: `# post_progress
+Post a structured progress update to the project chat. Use at key milestones: starting a task, creating a PR, hitting a blocker, or completing work.
+
+**Parameters:**
+- project_id (required): Project UUID
+- message (required): Progress update message (supports markdown)
+- type (optional): Update type — info (general), milestone (key achievement), blocker (blocking issue), question (asking for input). Default: info
+
+**Returns:** Confirmation with message_id and timestamp.
+
+**Example:** post_progress(project_id: "123e4567-e89b-12d3-a456-426614174000", message: "PR #42 created for auth feature", type: "milestone")`,
+
 	// Version management tools  
 	check_mcp_version: `# check_mcp_version
 Check for available MCP server updates and version information.
@@ -1497,6 +1509,18 @@ Self-update the MCP server to the latest available version.
 
 **Note:** This operation may temporarily disconnect active sessions during restart.`,
 
+	// Persona template tools
+	get_persona_templates: `# get_persona_templates
+List available persona templates for a project. Returns both global defaults and project-specific templates.
+
+**Parameters:**
+- project_id (required): Project UUID
+
+**Returns:**
+- templates: Array of persona templates with id, name, description, focus_areas, icon, is_default, scope (global/project)
+
+**Example:** get_persona_templates(project_id: "123e4567-e89b-12d3-a456-426614174000")`,
+
 	add_feature: `# add_feature
 Create a draft feature spec. Features sit between ideas (quick thoughts) and tasks (actionable work).
 

package/src/tools/index.ts

@@ -36,6 +36,7 @@ import { cloudAgentTools } from './cloud-agents.js';
 import { versionTools } from './version.js';
 import { chatTools } from './chat.js';
 import { featureTools } from './features.js';
+import { personaTemplateTools } from './persona-templates.js';
 
 /**
  * All MCP tool definitions combined
@@ -68,6 +69,7 @@ export const tools: Tool[] = [
 	...versionTools,
 	...chatTools,
 	...featureTools,
+	...personaTemplateTools,
 ];
 
 /**
@@ -108,6 +110,7 @@ export const toolCategories = {
 	cloudAgents: cloudAgentTools.map((t) => t.name),
 	version: versionTools.map((t) => t.name),
 	features: featureTools.map((t) => t.name),
+	personaTemplates: personaTemplateTools.map((t) => t.name),
 } as const;
 
 // Re-export domain tools for selective imports
@@ -138,4 +141,5 @@ export {
 	cloudAgentTools,
 	versionTools,
 	featureTools,
+	personaTemplateTools,
 };

package/src/tools/persona-templates.ts

@@ -0,0 +1,25 @@
+/**
+ * Persona Template Tool Definitions
+ *
+ * Tools for managing persona templates:
+ * - get_persona_templates
+ */
+
+import type { Tool } from './types.js';
+
+export const personaTemplateTools: Tool[] = [
+	{
+		name: 'get_persona_templates',
+		description: 'List available persona templates for a project. Returns both global defaults and project-specific templates. Persona templates define behavioral archetypes (e.g., Code Reviewer, QA Engineer) that shape agent behavior.',
+		inputSchema: {
+			type: 'object',
+			properties: {
+				project_id: {
+					type: 'string',
+					description: 'Project UUID',
+				},
+			},
+			required: ['project_id'],
+		},
+	},
+];

package/src/tools/tasks.ts

@@ -225,6 +225,10 @@ WHEN TO USE: If the user gives you work directly (e.g., "implement feature X", "
 					enum: ['haiku', 'sonnet', 'opus'],
 					description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
 				},
+				assigned_agent_name: {
+					type: 'string',
+					description: 'Pre-assign this task to a specific agent by persona name. Only that agent will pick it up via get_next_task.',
+				},
 			},
 			required: ['project_id', 'title'],
 		},
@@ -295,6 +299,10 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
 					enum: ['haiku', 'sonnet', 'opus'],
 					description: 'Recommended model capability: haiku (simple tasks), sonnet (standard), opus (complex reasoning)',
 				},
+				assigned_agent_name: {
+					type: ['string', 'null'],
+					description: 'Pre-assign this task to a specific agent by persona name. Set to null to unassign. Only the assigned agent will pick it up via get_next_task.',
+				},
 				skip_worktree_requirement: {
 					type: 'boolean',
 					description: 'Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false',