@vibescope/mcp-server 0.3.9 → 0.3.11

package/dist/handlers/session.js

@@ -151,6 +151,23 @@ export const startWorkSession = async (args, ctx) => {
     result.persona = data.persona;
     result.role = data.role;
     result.project = data.project;
+    // For cloud agents: include workspace setup instructions if repo not yet cloned
+    // Cloud agents pass git_url; check if workspace needs setup
+    if (git_url && data.project?.git_url) {
+        result.workspace_setup = {
+            message: 'If the project repo is NOT already cloned to your workspace, follow these steps:',
+            steps: [
+                `git clone ${data.project.git_url} ~/workspace/project`,
+                'cd ~/workspace/project',
+                ...(data.project.git_workflow === 'git-flow'
+                    ? [`git checkout ${data.project.git_develop_branch || 'develop'}`]
+                    : []),
+                'Install dependencies (check for pnpm-lock.yaml, package-lock.json, etc.)',
+                'If using SvelteKit: run `pnpm exec svelte-kit sync` or equivalent',
+            ],
+            note: 'Skip these steps if ~/workspace/project already exists and has the repo.',
+        };
+    }
     // Inform agent if git_url was normalized (helps explain URL matching behavior)
     if (gitUrlWasNormalized) {
         result.git_url_normalized = {

package/dist/handlers/tasks.js

@@ -60,10 +60,12 @@ const updateTaskSchema = {
     worktree_path: { type: 'string' },
     task_type: { type: 'string', validate: createEnumValidator(VALID_TASK_TYPES) },
     skip_worktree_requirement: { type: 'boolean', default: false },
+    session_id: { type: 'string' },
 };
 const completeTaskSchema = {
     task_id: { type: 'string', required: true, validate: uuidValidator },
     summary: { type: 'string' },
+    session_id: { type: 'string' },
 };
 const deleteTaskSchema = {
     task_id: { type: 'string', required: true, validate: uuidValidator },
@@ -278,7 +280,7 @@ export const addTask = async (args, ctx) => {
     return { result };
 };
 export const updateTask = async (args, ctx) => {
-    const { task_id, title, description, priority, status, progress_percentage, progress_note, estimated_minutes, git_branch, worktree_path, task_type, skip_worktree_requirement } = parseArgs(args, updateTaskSchema);
+    const { task_id, title, description, priority, status, progress_percentage, progress_note, estimated_minutes, git_branch, worktree_path, task_type, skip_worktree_requirement, session_id: explicit_session_id } = parseArgs(args, updateTaskSchema);
     const updates = { title, description, priority, status, progress_percentage, estimated_minutes, git_branch, worktree_path, task_type };
     // Enforce worktree creation: require git_branch when marking task as in_progress
     // This ensures multi-agent collaboration works properly with isolated worktrees
@@ -300,7 +302,7 @@ export const updateTask = async (args, ctx) => {
     const response = await api.updateTask(task_id, {
         ...updates,
         progress_note,
-        session_id: ctx.session.currentSessionId || undefined,
+        session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
     });
     if (!response.ok) {
         // Check for specific error types
@@ -426,11 +428,11 @@ export const updateTask = async (args, ctx) => {
     return { result };
 };
 export const completeTask = async (args, ctx) => {
-    const { task_id, summary } = parseArgs(args, completeTaskSchema);
+    const { task_id, summary, session_id: explicit_session_id } = parseArgs(args, completeTaskSchema);
     const api = getApiClient();
     const response = await api.completeTask(task_id, {
         summary,
-        session_id: ctx.session.currentSessionId || undefined,
+        session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
     });
     if (!response.ok) {
         return { result: { error: response.error || 'Failed to complete task' }, isError: true };

package/dist/tools/tasks.js

@@ -296,6 +296,10 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
                     type: 'boolean',
                     description: 'Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false',
                 },
+                session_id: {
+                    type: 'string',
+                    description: '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.',
+                },
             },
             required: ['task_id'],
         },
@@ -326,6 +330,10 @@ The auto_continue: true flag in the response means you are expected to continue
                     type: 'string',
                     description: 'Brief summary of what was done. This is stored on the task as completion_summary and displayed when reviewing completed tasks.',
                 },
+                session_id: {
+                    type: 'string',
+                    description: 'Session ID from start_work_session. Required for cloud agents using mcporter.',
+                },
             },
             required: ['task_id'],
         },

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-02-13
+> Generated: 2026-02-15
 >
-> Total tools: 158
+> Total tools: 159
 
 ## Table of Contents
 
@@ -2513,3 +2513,35 @@ Update the Vibescope MCP server to the latest version. Runs npm install to fetch
 | `global` | `boolean` | No | If true, update the global installation (npm install -g). If false, update locally. Default: true. |
 
 ---
+
+## Uncategorized
+
+*Tools not yet assigned to a category*
+
+### update_agent_status
+
+Report what you're currently doing. This updates the status message shown on the dashboard.
+
+Call this at key milestones during boot and work:
+
+- "Installing dependencies..."
+
+- "Running start_work_session..."
+
+- "Working on: <task title>"
+
+- "Running tests..."
+
+- "Committing changes..."
+
+Keep messages short (under 80 chars). The dashboard shows this in real-time.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `status_message` | `string` | Yes | Short status message to display on dashboard (max 80 chars) |
+| `project_id` | `string` | No | Project UUID (optional if session has project context) |
+| `agent_name` | `string` | No | Agent name (used to find the spawned_agents record) |
+
+---

package/package.json

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

package/src/handlers/session.ts

@@ -183,6 +183,24 @@ export const startWorkSession: Handler = async (args, ctx) => {
 	result.role = data.role;
 	result.project = data.project;
 
+	// For cloud agents: include workspace setup instructions if repo not yet cloned
+	// Cloud agents pass git_url; check if workspace needs setup
+	if (git_url && data.project?.git_url) {
+		result.workspace_setup = {
+			message: 'If the project repo is NOT already cloned to your workspace, follow these steps:',
+			steps: [
+				`git clone ${data.project.git_url} ~/workspace/project`,
+				'cd ~/workspace/project',
+				...(data.project.git_workflow === 'git-flow'
+					? [`git checkout ${data.project.git_develop_branch || 'develop'}`]
+					: []),
+				'Install dependencies (check for pnpm-lock.yaml, package-lock.json, etc.)',
+				'If using SvelteKit: run `pnpm exec svelte-kit sync` or equivalent',
+			],
+			note: 'Skip these steps if ~/workspace/project already exists and has the repo.',
+		};
+	}
+
 	// Inform agent if git_url was normalized (helps explain URL matching behavior)
 	if (gitUrlWasNormalized) {
 		result.git_url_normalized = {

package/src/handlers/tasks.ts

@@ -77,11 +77,13 @@ const updateTaskSchema = {
 	worktree_path: { type: 'string' as const },
 	task_type: { type: 'string' as const, validate: createEnumValidator(VALID_TASK_TYPES) },
 	skip_worktree_requirement: { type: 'boolean' as const, default: false },
+	session_id: { type: 'string' as const },
 };
 
 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 },
 };
 
 const deleteTaskSchema = {
@@ -367,7 +369,7 @@ export const addTask: Handler = async (args, ctx) => {
 };
 
 export const updateTask: Handler = async (args, ctx) => {
-	const { task_id, title, description, priority, status, progress_percentage, progress_note, estimated_minutes, git_branch, worktree_path, task_type, skip_worktree_requirement } = parseArgs(args, updateTaskSchema);
+	const { task_id, title, description, priority, status, progress_percentage, progress_note, estimated_minutes, git_branch, worktree_path, task_type, skip_worktree_requirement, session_id: explicit_session_id } = parseArgs(args, updateTaskSchema);
 	const updates = { title, description, priority, status, progress_percentage, estimated_minutes, git_branch, worktree_path, task_type };
 
 	// Enforce worktree creation: require git_branch when marking task as in_progress
@@ -391,7 +393,7 @@ export const updateTask: Handler = async (args, ctx) => {
 	const response = await api.updateTask(task_id, {
 		...updates,
 		progress_note,
-		session_id: ctx.session.currentSessionId || undefined,
+		session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
 	});
 
 	if (!response.ok) {
@@ -526,12 +528,12 @@ export const updateTask: Handler = async (args, ctx) => {
 };
 
 export const completeTask: Handler = async (args, ctx) => {
-	const { task_id, summary } = parseArgs(args, completeTaskSchema);
+	const { task_id, summary, session_id: explicit_session_id } = parseArgs(args, completeTaskSchema);
 
 	const api = getApiClient();
 	const response = await api.completeTask(task_id, {
 		summary,
-		session_id: ctx.session.currentSessionId || undefined,
+		session_id: explicit_session_id || ctx.session.currentSessionId || undefined,
 	});
 
 	if (!response.ok) {

package/src/tools/tasks.ts

@@ -299,6 +299,10 @@ For projects without git branching (trunk-based or none), use skip_worktree_requ
 					type: 'boolean',
 					description: 'Skip git_branch requirement for projects without branching workflows (trunk-based or none). Default: false',
 				},
+				session_id: {
+					type: 'string',
+					description: '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.',
+				},
 			},
 			required: ['task_id'],
 		},
@@ -329,6 +333,10 @@ The auto_continue: true flag in the response means you are expected to continue
 					type: 'string',
 					description: 'Brief summary of what was done. This is stored on the task as completion_summary and displayed when reviewing completed tasks.',
 				},
+				session_id: {
+					type: 'string',
+					description: 'Session ID from start_work_session. Required for cloud agents using mcporter.',
+				},
 			},
 			required: ['task_id'],
 		},