Skip to content

feat: add analytics tools for flow metrics, WIP analysis, and aging reports#1

Merged
viamus merged 5 commits intomainfrom
feature/analytics
Feb 3, 2026
Merged

feat: add analytics tools for flow metrics, WIP analysis, and aging reports#1
viamus merged 5 commits intomainfrom
feature/analytics

Conversation

@viamus
Copy link
Copy Markdown
Owner

@viamus viamus commented Jan 31, 2026

Description

Add analytics tools to transform the MCP server from a data access layer into an analytical and management tool. These tools enable answering strategic questions about delivery performance, bottlenecks, team
workload, and work health.

Type of Change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Documentation update
  • Refactoring (no functional changes)

Related Issues

Closes #(analytics-feature)

Changes Made

  • Add get_flow_metrics tool - calculates Lead Time, Cycle Time, and Throughput with statistical analysis (average, median, percentiles 85/95, std dev)
  • Add compare_flow_metrics tool - compares metrics between two periods to identify delivery trends
  • Add get_wip_analysis tool - analyzes Work in Progress by state, area, and person with insights
  • Add get_bottlenecks tool - identifies workflow bottlenecks with severity scores and actionable recommendations
  • Add get_team_workload tool - analyzes workload distribution across team members (overloaded/balanced/has capacity)
  • Add get_aging_report tool - reports aging work items with urgency classification (Critical/High/Medium/Low) and specific recommendations
  • Add FlowMetricsDto.cs with DTOs for flow metrics, statistics, and throughput periods
  • Add WipAnalysisDto.cs with DTOs for WIP analysis, bottlenecks, and aging reports
  • Add AnalyticsTools.cs with all 6 MCP tool implementations
  • Add comprehensive unit tests for all new DTOs (22 new tests)
  • Update README with analytics tools documentation, usage examples, and API reference
  • Bump version to 1.2.0

Testing

  • I have tested these changes locally
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

Test Results: 267 tests passing (22 new analytics tests added)

Checklist

  • My code follows the project's coding style
  • I have performed a self-review of my code
  • I have commented my code, particularly in hard-to-understand areas
  • My changes generate no new warnings
  • I have updated the documentation accordingly

Screenshots (if applicable)

N/A - Backend MCP tools

Additional Notes

New Analytics Capabilities

Question Tool
"Are we delivering faster or slower?" compare_flow_metrics
"Where is work piling up?" get_bottlenecks
"Who is overloaded?" get_team_workload
"What needs attention now?" get_aging_report
"What's our average delivery time?" get_flow_metrics
"How many items did we complete?" get_wip_analysis

Key Metrics Provided

  • Lead Time: Creation → Completion (total delivery time)
  • Cycle Time: Started → Completion (active work time)
  • Throughput: Items completed per period
  • WIP Distribution: By state, area, person, type
  • Aging Analysis: Urgency scoring based on priority, time, and state

Files Added

src/Viamus.Azure.Devops.Mcp.Server/
├── Models/
│ ├── FlowMetricsDto.cs (139 lines)
│ └── WipAnalysisDto.cs (254 lines)
└── Tools/
└── AnalyticsTools.cs (1,200+ lines)

tests/Viamus.Azure.Devops.Mcp.Server.Tests/Models/
├── FlowMetricsDtoTests.cs (180 lines)
└── WipAnalysisDtoTests.cs (280 lines)

viamus and others added 4 commits January 30, 2026 22:37
…eports

Add 6 new MCP tools for project analytics:

Flow Metrics:
- get_flow_metrics: Calculate Lead Time, Cycle Time, Throughput with statistics
- compare_flow_metrics: Compare metrics between two periods to identify trends

WIP Analysis:
- get_wip_analysis: Analyze Work in Progress by state, area, and person
- get_bottlenecks: Identify workflow bottlenecks with recommendations
- get_team_workload: Analyze workload distribution across team members

Aging Report:
- get_aging_report: Report aging items with urgency classification and recommendations

These tools enable answering management questions like:
- Are we delivering faster or slower?
- Where is work piling up?
- Who is overloaded?
- What needs attention now?

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Document the 6 new analytics MCP tools in README:
- Available Tools section with Analytics Tools table
- Usage Examples with analytics-related questions
- API Reference with Analytics DTOs documentation
- Updated Project Structure with new files

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Release 1.2.0 includes analytics tools for flow metrics, WIP analysis,
and aging reports.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@viamus viamus self-assigned this Jan 31, 2026
@viamus viamus added documentation Improvements or additions to documentation enhancement New feature or request labels Jan 31, 2026
@viamus viamus merged commit d52fc67 into main Feb 3, 2026
2 checks passed
@viamus viamus deleted the feature/analytics branch February 10, 2026 17:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant