@vibescope/mcp-server 0.4.7 → 0.4.9

package/dist/api-client/project.d.ts

@@ -96,7 +96,8 @@ export interface ProjectMethods {
         require_time_estimates?: boolean;
         fallback_activities_enabled?: boolean;
         preferred_fallback_activities?: string[];
-        allow_agent_task_creation?: boolean;
+        allow_local_agent_task_creation?: boolean;
+        allow_cloud_agent_task_creation?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;
         project_id: string;

package/dist/api-client.d.ts

@@ -247,7 +247,8 @@ export declare class VibescopeApiClient {
         require_time_estimates?: boolean;
         fallback_activities_enabled?: boolean;
         preferred_fallback_activities?: string[];
-        allow_agent_task_creation?: boolean;
+        allow_local_agent_task_creation?: boolean;
+        allow_cloud_agent_task_creation?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;
         project_id: string;
@@ -486,6 +487,12 @@ export declare class VibescopeApiClient {
     completeTask(taskId: string, params: {
         summary?: string;
         session_id?: string;
+        commit_hash?: string;
+        check_results?: Array<{
+            command: string;
+            passed: boolean;
+            output?: string;
+        }>;
     }): Promise<ApiResponse<{
         success: boolean;
         directive: string;

package/dist/api-client.js

@@ -285,6 +285,8 @@ export class VibescopeApiClient {
         return this.proxy('complete_task', {
             task_id: taskId,
             summary: params.summary,
+            ...(params.commit_hash ? { commit_hash: params.commit_hash } : {}),
+            ...(params.check_results ? { check_results: params.check_results } : {}),
         }, params.session_id ? { session_id: params.session_id, persona: null, instance_id: '' } : undefined);
     }
     async deleteTask(taskId) {

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/project.js

@@ -50,7 +50,8 @@ const updateProjectSchema = {
     require_time_estimates: { type: 'boolean' },
     fallback_activities_enabled: { type: 'boolean' },
     preferred_fallback_activities: { type: 'array' },
-    allow_agent_task_creation: { type: 'boolean' },
+    allow_local_agent_task_creation: { type: 'boolean' },
+    allow_cloud_agent_task_creation: { type: 'boolean' },
 };
 const updateProjectReadmeSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
@@ -112,7 +113,7 @@ export const createProject = async (args, _ctx) => {
 export const updateProject = async (args, _ctx) => {
     const { project_id, name, description, goal, git_url, tech_stack, status, git_workflow, git_main_branch, git_develop_branch, git_auto_branch, git_auto_tag, deployment_instructions, 
     // New project settings
-    git_delete_branch_on_merge, require_pr_for_validation, auto_merge_on_approval, validation_required, default_task_priority, require_time_estimates, fallback_activities_enabled, preferred_fallback_activities, allow_agent_task_creation } = parseArgs(args, updateProjectSchema);
+    git_delete_branch_on_merge, require_pr_for_validation, auto_merge_on_approval, validation_required, default_task_priority, require_time_estimates, fallback_activities_enabled, preferred_fallback_activities, allow_local_agent_task_creation, allow_cloud_agent_task_creation } = parseArgs(args, updateProjectSchema);
     const apiClient = getApiClient();
     const response = await apiClient.updateProject(project_id, {
         name,
@@ -136,7 +137,8 @@ export const updateProject = async (args, _ctx) => {
         require_time_estimates,
         fallback_activities_enabled,
         preferred_fallback_activities: preferred_fallback_activities,
-        allow_agent_task_creation: allow_agent_task_creation
+        allow_local_agent_task_creation: allow_local_agent_task_creation,
+        allow_cloud_agent_task_creation: allow_cloud_agent_task_creation
     });
     if (!response.ok) {
         return { result: { error: response.error || 'Failed to update project' }, isError: true };

package/dist/handlers/tasks.js

@@ -67,6 +67,8 @@ const completeTaskSchema = {
     task_id: { type: 'string', required: true, validate: uuidValidator },
     summary: { type: 'string' },
     session_id: { type: 'string' },
+    commit_hash: { type: 'string' },
+    check_results: { type: 'object' },
 };
 const deleteTaskSchema = {
     task_id: { type: 'string', required: true, validate: uuidValidator },
@@ -429,11 +431,13 @@ export const updateTask = async (args, ctx) => {
     return { result };
 };
 export const completeTask = async (args, ctx) => {
-    const { task_id, summary, session_id: explicit_session_id } = parseArgs(args, completeTaskSchema);
+    const { task_id, summary, session_id: explicit_session_id, commit_hash, check_results } = parseArgs(args, completeTaskSchema);
     const api = getApiClient();
     const response = await api.completeTask(task_id, {
         summary,
         session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
+        commit_hash,
+        check_results: check_results,
     });
     if (!response.ok) {
         return { result: { error: response.error || 'Failed to complete task' }, isError: true };

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/project.js

@@ -160,9 +160,13 @@ export const projectTools = [
                     items: { type: 'string' },
                     description: 'Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed.',
                 },
-                allow_agent_task_creation: {
+                allow_local_agent_task_creation: {
                     type: 'boolean',
-                    description: 'Allow agents to create tasks via add_task (default: false). When disabled, agents receive a helpful error directing them to log suggestions in their completion summary instead.',
+                    description: 'Allow local agents (running on developer machine) to create tasks via add_task (default: true).',
+                },
+                allow_cloud_agent_task_creation: {
+                    type: 'boolean',
+                    description: 'Allow cloud/remote agents to create tasks via add_task (default: false).',
                 },
             },
             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',
@@ -334,6 +342,23 @@ The auto_continue: true flag in the response means you are expected to continue
                     type: 'string',
                     description: 'Session ID from start_work_session. Required for cloud agents using mcporter.',
                 },
+                commit_hash: {
+                    type: 'string',
+                    description: 'Git commit hash (7-40 hex chars) of your last commit. Stored on the task for verification.',
+                },
+                check_results: {
+                    type: 'array',
+                    description: 'Results of pre-completion checks (required if project has pre_completion_commands configured). Each item: { command, passed, output? }',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            command: { type: 'string', description: 'The command that was run' },
+                            passed: { type: 'boolean', description: 'Whether the command succeeded' },
+                            output: { type: 'string', description: 'First 500 chars of output if failed' },
+                        },
+                        required: ['command', 'passed'],
+                    },
+                },
             },
             required: ['task_id'],
         },

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-03-04
+> Generated: 2026-03-10
 >
-> 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
@@ -245,7 +246,8 @@ Update project details (name, description, goal, settings).
 | `require_time_estimates` | `boolean` | No | Require estimated_minutes when creating tasks (default: false) |
 | `fallback_activities_enabled` | `boolean` | No | Allow agents to perform background activities when no tasks available (default: true) |
 | `preferred_fallback_activities` | `string[]` | No | Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed. |
-| `allow_agent_task_creation` | `boolean` | No | Allow agents to create tasks via add_task (default: false). When disabled, agents receive a helpful error directing them to log suggestions in their completion summary instead. |
+| `allow_local_agent_task_creation` | `boolean` | No | Allow local agents (running on developer machine) to create tasks via add_task (default: true). |
+| `allow_cloud_agent_task_creation` | `boolean` | No | Allow cloud/remote agents to create tasks via add_task (default: false). |
 
 ---
 
@@ -380,6 +382,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 +420,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. |
 
@@ -451,6 +455,8 @@ The auto_continue: true flag in the response means you are expected to continue
 | `task_id` | `string` | Yes | Task UUID |
 | `summary` | `string` | No | Brief summary of what was done. This is stored on the task as completion_summary and displayed when reviewing completed tasks. |
 | `session_id` | `string` | No | Session ID from start_work_session. Required for cloud agents using mcporter. |
+| `commit_hash` | `string` | No | Git commit hash (7-40 hex chars) of your last commit. Stored on the task for verification. |
+| `check_results` | `object[]` | No | Results of pre-completion checks (required if project has pre_completion_commands configured). Each item: { command, passed, output? } |
 
 ---
 
@@ -2574,6 +2580,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.9",
   "description": "MCP server for Vibescope - AI project tracking tools",
   "type": "module",
   "main": "dist/index.js",

package/src/api-client/project.ts

@@ -101,7 +101,8 @@ export interface ProjectMethods {
 		require_time_estimates?: boolean;
 		fallback_activities_enabled?: boolean;
 		preferred_fallback_activities?: string[];
-		allow_agent_task_creation?: boolean;
+		allow_local_agent_task_creation?: boolean;
+		allow_cloud_agent_task_creation?: boolean;
 	}): Promise<ApiResponse<{
 		success: boolean;
 		project_id: string;

package/src/api-client.ts

@@ -449,7 +449,8 @@ export class VibescopeApiClient {
 		require_time_estimates?: boolean;
 		fallback_activities_enabled?: boolean;
 		preferred_fallback_activities?: string[];
-		allow_agent_task_creation?: boolean;
+		allow_local_agent_task_creation?: boolean;
+		allow_cloud_agent_task_creation?: boolean;
 	}): Promise<ApiResponse<{
 		success: boolean;
 		project_id: string;
@@ -754,6 +755,8 @@ export class VibescopeApiClient {
 	async completeTask(taskId: string, params: {
 		summary?: string;
 		session_id?: string;
+		commit_hash?: string;
+		check_results?: Array<{ command: string; passed: boolean; output?: string }>;
 	}): Promise<ApiResponse<{
 		success: boolean;
 		directive: string;
@@ -778,6 +781,8 @@ export class VibescopeApiClient {
 		return this.proxy('complete_task', {
 			task_id: taskId,
 			summary: params.summary,
+			...(params.commit_hash ? { commit_hash: params.commit_hash } : {}),
+			...(params.check_results ? { check_results: params.check_results } : {}),
 		}, params.session_id ? { session_id: params.session_id, persona: null, instance_id: '' } : undefined);
 	}
 

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/project.ts

@@ -64,7 +64,8 @@ const updateProjectSchema = {
 	require_time_estimates: { type: 'boolean' as const },
 	fallback_activities_enabled: { type: 'boolean' as const },
 	preferred_fallback_activities: { type: 'array' as const },
-	allow_agent_task_creation: { type: 'boolean' as const },
+	allow_local_agent_task_creation: { type: 'boolean' as const },
+	allow_cloud_agent_task_creation: { type: 'boolean' as const },
 };
 
 const updateProjectReadmeSchema = {
@@ -167,7 +168,8 @@ export const updateProject: Handler = async (args, _ctx) => {
 		require_time_estimates,
 		fallback_activities_enabled,
 		preferred_fallback_activities,
-		allow_agent_task_creation
+		allow_local_agent_task_creation,
+		allow_cloud_agent_task_creation
 	} = parseArgs(args, updateProjectSchema);
 
 	const apiClient = getApiClient();
@@ -193,7 +195,8 @@ export const updateProject: Handler = async (args, _ctx) => {
 		require_time_estimates,
 		fallback_activities_enabled,
 		preferred_fallback_activities: preferred_fallback_activities as string[] | undefined,
-		allow_agent_task_creation: allow_agent_task_creation as boolean | undefined
+		allow_local_agent_task_creation: allow_local_agent_task_creation as boolean | undefined,
+		allow_cloud_agent_task_creation: allow_cloud_agent_task_creation as boolean | undefined
 	});
 
 	if (!response.ok) {

package/src/handlers/tasks.ts

@@ -85,6 +85,8 @@ const completeTaskSchema = {
 	task_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
 	summary: { type: 'string' as const },
 	session_id: { type: 'string' as const },
+	commit_hash: { type: 'string' as const },
+	check_results: { type: 'object' as const },
 };
 
 const deleteTaskSchema = {
@@ -529,12 +531,14 @@ export const updateTask: Handler = async (args, ctx) => {
 };
 
 export const completeTask: Handler = async (args, ctx) => {
-	const { task_id, summary, session_id: explicit_session_id } = parseArgs(args, completeTaskSchema);
+	const { task_id, summary, session_id: explicit_session_id, commit_hash, check_results } = parseArgs(args, completeTaskSchema);
 
 	const api = getApiClient();
 	const response = await api.completeTask(task_id, {
 		summary,
 		session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
+		commit_hash,
+		check_results: check_results as unknown as Array<{ command: string; passed: boolean; output?: string }>,
 	});
 
 	if (!response.ok) {

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/project.ts

@@ -163,9 +163,13 @@ export const projectTools: Tool[] = [
 					items: { type: 'string' },
 					description: 'Array of preferred fallback activities (e.g., ["code_review", "security_review"]). Null means all allowed.',
 				},
-				allow_agent_task_creation: {
+				allow_local_agent_task_creation: {
 					type: 'boolean',
-					description: 'Allow agents to create tasks via add_task (default: false). When disabled, agents receive a helpful error directing them to log suggestions in their completion summary instead.',
+					description: 'Allow local agents (running on developer machine) to create tasks via add_task (default: true).',
+				},
+				allow_cloud_agent_task_creation: {
+					type: 'boolean',
+					description: 'Allow cloud/remote agents to create tasks via add_task (default: false).',
 				},
 			},
 			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',
@@ -337,6 +345,23 @@ The auto_continue: true flag in the response means you are expected to continue
 					type: 'string',
 					description: 'Session ID from start_work_session. Required for cloud agents using mcporter.',
 				},
+				commit_hash: {
+					type: 'string',
+					description: 'Git commit hash (7-40 hex chars) of your last commit. Stored on the task for verification.',
+				},
+				check_results: {
+					type: 'array',
+					description: 'Results of pre-completion checks (required if project has pre_completion_commands configured). Each item: { command, passed, output? }',
+					items: {
+						type: 'object',
+						properties: {
+							command: { type: 'string', description: 'The command that was run' },
+							passed: { type: 'boolean', description: 'Whether the command succeeded' },
+							output: { type: 'string', description: 'First 500 chars of output if failed' },
+						},
+						required: ['command', 'passed'],
+					},
+				},
 			},
 			required: ['task_id'],
 		},

package/dist/tools.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const tools: Tool[];