get_workspace_overview
Analyze workspace performance with activity insights and productivity metrics to identify trends and improvement areas.
Instructions
Get comprehensive overview of entire workspace with analytics and insights
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_analytics | No | Whether to include detailed analytics | |
| time_range | No | Time range for activity analysis | week |
| focus_areas | No | Specific areas to focus analysis on |
Implementation Reference
- Zod input schema for validating arguments to the get_workspace_overview tool.const GetWorkspaceOverviewSchema = z.object({ include_analytics: z.boolean().default(true), time_range: z.enum(['today', 'week', 'month', 'all']).default('week'), focus_areas: z.array(z.enum(['productivity', 'collaboration', 'documentation', 'blockers'])).optional() })
- src/tools/context-aggregation.ts:153-180 (registration)MCPTool registration object defining the tool name, description, and input schema for get_workspace_overview.export const getWorkspaceOverviewTool: MCPTool = { name: 'get_workspace_overview', description: 'Get comprehensive overview of entire workspace with analytics and insights', inputSchema: { type: 'object', properties: { include_analytics: { type: 'boolean', default: true, description: 'Whether to include detailed analytics' }, time_range: { type: 'string', enum: ['today', 'week', 'month', 'all'], default: 'week', description: 'Time range for activity analysis' }, focus_areas: { type: 'array', items: { type: 'string', enum: ['productivity', 'collaboration', 'documentation', 'blockers'] }, description: 'Specific areas to focus analysis on' } } } }
- src/tools/context-aggregation.ts:182-224 (handler)Main execution handler for the get_workspace_overview tool. Parses args, fetches projects/tasks/documents, computes various metrics and insights, conditionally adds analytics, and returns workspace overview.export const getWorkspaceOverview = requireAuth(async (args: any) => { const { include_analytics, time_range, focus_areas } = GetWorkspaceOverviewSchema.parse(args) logger.info('Getting workspace overview', { time_range, focus_areas }) // Get all workspace data const [projects, tasks, documents] = await Promise.all([ supabaseService.getProjects({}, { limit: 50 }), supabaseService.getTasks({}, { limit: 100 }), supabaseService.getDocuments({}, { limit: 100 }) ]) const overview: any = { summary: { total_projects: projects.length, active_projects: projects.filter(p => p.status === 'active').length, total_tasks: tasks.length, completed_tasks: tasks.filter(t => t.status === 'done').length, total_documents: documents.length, documentation_coverage: calculateDocumentationCoverage(projects, documents) }, project_health: analyzeProjectHealth(projects, tasks, documents), productivity_metrics: calculateProductivityMetrics(tasks, time_range), collaboration_insights: analyzeCollaboration(tasks, documents), ai_readiness: assessAIReadiness(documents), recommendations: generateWorkspaceRecommendations(projects, tasks, documents) } if (include_analytics) { overview.analytics = { task_distribution: analyzeTaskDistribution(tasks), document_metrics: analyzeDocumentMetrics(documents), project_velocity: calculateProjectVelocity(projects, tasks, time_range), bottleneck_analysis: identifyBottlenecks(projects, tasks) } } if (focus_areas) { overview.focused_insights = generateFocusedInsights(overview, focus_areas) } return overview })
- src/tools/context-aggregation.ts:716-722 (registration)Export of context aggregation tools object including getWorkspaceOverviewTool for registration.export const contextAggregationTools = { getSmartContextTool, getWorkspaceOverviewTool, getProjectInsightsTool, findRelatedContentTool, generateContextSummaryTool }
- src/tools/context-aggregation.ts:724-730 (registration)Export of context aggregation handlers object mapping 'get_workspace_overview' to its handler function for registration.export const contextAggregationHandlers = { get_smart_context: getSmartContext, get_workspace_overview: getWorkspaceOverview, get_project_insights: getProjectInsights, find_related_content: findRelatedContent, generate_context_summary: generateContextSummary }