claude-autopm 2.8.1 → 2.8.3

package/autopm/.claude/scripts/azure/README.md

@@ -1,192 +0,0 @@
-# Azure DevOps Shell Scripts
-
-Automation scripts for Azure DevOps integration.
-
-## Available Scripts
-
-### setup.sh
-**Initial setup and configuration**
-```bash
-./setup.sh
-```
-- Configures Azure DevOps credentials
-- Tests connection
-- Creates directory structure
-- Generates configuration files
-
-### daily.sh
-**Daily workflow automation**
-```bash
-./daily.sh
-```
-- Shows standup summary
-- Lists active work
-- Checks for blockers
-- Suggests next task
-
-### sprint-report.sh
-**Generate sprint reports**
-```bash
-./sprint-report.sh [sprint-name]
-./sprint-report.sh current
-./sprint-report.sh "Sprint 2"
-```
-- Sprint progress and metrics
-- Burndown analysis
-- Team performance
-- Risk assessment
-
-### sync.sh
-**Synchronize with Azure DevOps**
-```bash
-./sync.sh --quick    # Recent changes only
-./sync.sh --full     # Full synchronization
-```
-- Syncs work items to local cache
-- Detects conflicts
-- Cleans old cache files
-
-## Usage Examples
-
-### Morning Routine
-```bash
-# Start your day
-./daily.sh
-
-# Get detailed sprint status
-./sprint-report.sh current
-
-# Sync recent changes
-./sync.sh --quick
-```
-
-### Weekly Tasks
-```bash
-# Full sync on Monday
-./sync.sh --full
-
-# Generate sprint report
-./sprint-report.sh > reports/week-$(date +%U).txt
-```
-
-### First Time Setup
-```bash
-# Run setup wizard
-./setup.sh
-
-# Verify connection
-./daily.sh
-```
-
-## Environment Variables
-
-Required in `.claude/.env`:
-```bash
-AZURE_DEVOPS_PAT=your_personal_access_token
-AZURE_DEVOPS_ORG=your_organization
-AZURE_DEVOPS_PROJECT=your_project
-```
-
-## Automation
-
-### Cron Jobs
-Add to crontab for automation:
-```bash
-# Daily standup at 9 AM
-0 9 * * 1-5 cd /path/to/project && ./claude/scripts/azure/daily.sh
-
-# Sync every hour during work hours
-0 9-18 * * 1-5 cd /path/to/project && ./claude/scripts/azure/sync.sh --quick
-
-# Weekly sprint report on Friday
-0 16 * * 5 cd /path/to/project && ./claude/scripts/azure/sprint-report.sh
-```
-
-### Git Hooks
-Link to git hooks for automation:
-```bash
-# .git/hooks/pre-commit
-#!/bin/bash
-# Sync before commit
-.claude/scripts/azure/sync.sh --quick
-
-# .git/hooks/post-commit
-#!/bin/bash
-# Link commit to Azure DevOps
-# (Add work item ID detection logic)
-```
-
-## Troubleshooting
-
-### Connection Issues
-```bash
-# Test API connection
-curl -u ":$AZURE_DEVOPS_PAT" \
-  "https://dev.azure.com/$AZURE_DEVOPS_ORG/_apis/projects?api-version=7.0"
-
-# Check credentials
-echo $AZURE_DEVOPS_PAT | head -c 10
-```
-
-### Permission Errors
-```bash
-# Make scripts executable
-chmod +x .claude/scripts/azure/*.sh
-
-# Check file permissions
-ls -la .claude/scripts/azure/
-```
-
-### Cache Issues
-```bash
-# Clear cache
-rm -rf .claude/azure/cache/*
-
-# Rebuild cache
-./sync.sh --full
-```
-
-## Advanced Usage
-
-### Custom Queries
-Edit scripts to add custom WIQL queries:
-```bash
-# Example: Find high priority bugs
-query='SELECT [System.Id] FROM workitems 
-       WHERE [System.WorkItemType] = "Bug" 
-       AND [Microsoft.VSTS.Common.Priority] = 1'
-```
-
-### Export Formats
-Scripts support various output formats:
-```bash
-# JSON output
-./sprint-report.sh --json > report.json
-
-# CSV export
-./daily.sh --csv > daily.csv
-```
-
-### Integration with CI/CD
-Use in CI/CD pipelines:
-```yaml
-# Azure Pipelines example
-- script: |
-    ./claude/scripts/azure/sync.sh --full
-    ./claude/scripts/azure/sprint-report.sh
-  displayName: 'Sync and Report'
-```
-
-## Contributing
-
-To add new scripts:
-1. Create script in `.claude/scripts/azure/`
-2. Make executable: `chmod +x script.sh`
-3. Add documentation here
-4. Test thoroughly
-
-## Support
-
-- Azure DevOps API: https://docs.microsoft.com/en-us/rest/api/azure/devops/
-- Script issues: Create issue in project repository
-- Command help: `/azure:help`

package/autopm/.claude/scripts/azure/active-work.js

@@ -1,524 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Azure DevOps Active Work Viewer
- * Shows all active work items across the team with full API integration
- */
-
-const path = require('path');
-const fs = require('fs');
-const chalk = require('chalk');
-const AzureDevOpsClient = require('../../providers/azure/lib/client');
-const AzureFormatter = require('../../providers/azure/lib/formatter');
-const { table } = require('table');
-
-class AzureActiveWork {
-  constructor(options = {}) {
-    this.silent = options.silent || false;
-    this.format = options.format || 'table'; // table, json, csv
-    this.groupBy = options.groupBy || 'assignee'; // assignee, state, type, priority
-    this.includeUnassigned = options.includeUnassigned !== false;
-    this.user = options.user || null; // Filter by specific user or 'me'
-    this.state = options.state || null; // Filter by specific states
-    this.type = options.type || null; // Filter by work item types
-    this.testMode = options.testMode || false;
-
-    try {
-      // Load environment variables from .env file if it exists
-      const envPath = path.join(process.cwd(), '.env');
-      if (fs.existsSync(envPath)) {
-        require('dotenv').config({ path: envPath });
-      }
-
-      // Also check .claude/.env
-      const claudeEnvPath = path.join(process.cwd(), '.claude', '.env');
-      if (fs.existsSync(claudeEnvPath)) {
-        require('dotenv').config({ path: claudeEnvPath });
-      }
-
-      // Initialize Azure DevOps client
-      this.client = new AzureDevOpsClient();
-    } catch (error) {
-      this.handleInitError(error);
-    }
-  }
-
-  handleInitError(error) {
-    if (error.message.includes('Missing required environment variables')) {
-      // Check if we should throw the error (for tests that expect it)
-      const hasNoEnvVars = !process.env.AZURE_DEVOPS_PAT &&
-                           !process.env.AZURE_DEVOPS_ORG &&
-                           !process.env.AZURE_DEVOPS_PROJECT;
-
-      if (hasNoEnvVars && !this.testMode) {
-        throw error; // Re-throw for tests that expect it
-      }
-
-      // In production mode when run directly, show error and exit
-      if (require.main === module) {
-        console.error('❌ Azure DevOps configuration missing!\n');
-        console.error('Please set the following environment variables:');
-        console.error('  - AZURE_DEVOPS_ORG: Your Azure DevOps organization');
-        console.error('  - AZURE_DEVOPS_PROJECT: Your project name');
-        console.error('  - AZURE_DEVOPS_PAT: Your Personal Access Token\n');
-        console.error('You can set these in .env or .claude/.env file\n');
-        process.exit(1);
-      }
-      // Set client to null for test mode
-      this.client = null;
-      return;
-    }
-    throw error;
-  }
-
-  async getActiveWork() {
-    try {
-      if (!this.silent && this.format !== "json") {
-        console.log(chalk.cyan.bold('\n💼 Fetching Active Work Items...\n'));
-      }
-
-      // Build WIQL query for active work items
-      const states = this.state ?
-        this.state.split(',').map(s => `'${s.trim()}'`).join(', ') :
-        "'New', 'Active', 'In Progress', 'Committed'";
-
-      const types = this.type ?
-        this.type.split(',').map(t => `'${t.trim()}'`).join(', ') :
-        "'Task', 'Bug', 'User Story', 'Feature'";
-
-      let query = `
-        SELECT [System.Id],
-               [System.Title],
-               [System.State],
-               [System.WorkItemType],
-               [System.AssignedTo],
-               [Microsoft.VSTS.Scheduling.RemainingWork],
-               [Microsoft.VSTS.Common.Priority],
-               [System.CreatedDate],
-               [System.ChangedDate],
-               [System.Tags],
-               [System.IterationPath]
-        FROM workitems
-        WHERE [System.State] IN (${states})
-        AND [System.WorkItemType] IN (${types})
-        AND [System.TeamProject] = '${this.client?.project || 'TestProject'}'
-      `;
-
-      // Add user filter if specified
-      if (this.user) {
-        const userEmail = this.user === 'me' ? '@Me' : this.user;
-        query += ` AND [System.AssignedTo] = '${userEmail}'`;
-      } else if (!this.includeUnassigned) {
-        query += ` AND [System.AssignedTo] <> ''`;
-      }
-
-      query += ` ORDER BY [Microsoft.VSTS.Common.Priority] ASC, [System.ChangedDate] DESC`;
-
-      // Execute query
-      if (!this.client) {
-        // Return mock data for testing
-        return this.getMockActiveWork();
-      }
-      const queryResult = await this.client.executeWiql(query);
-
-      if (!queryResult || !queryResult.workItems || queryResult.workItems.length === 0) {
-        if (!this.silent) {
-          console.log(chalk.yellow('No active work items found.'));
-        }
-        return { summary: { total: 0 }, items: [] };
-      }
-
-      // Get full work item details
-      const ids = queryResult.workItems.map(item => item.id);
-      const workItems = await this.client.getWorkItems(ids);
-
-      // Get current sprint info
-      const currentSprint = await this.client.getCurrentSprint();
-
-      // Process and organize work items
-      const processedData = this.processWorkItems(workItems, currentSprint);
-
-      // Mock data structure for compatibility - will be replaced with real data
-      const activeWorkData = {
-        ...processedData,
-        rawItems: workItems
-      };
-
-      if (!this.silent && this.format !== "json") {
-        this.displayActiveWork(activeWorkData);
-      }
-
-      return activeWorkData;
-    } catch (error) {
-      console.error('Error:', error.message);
-      process.exit(1);
-    }
-  }
-
-  displayActiveWork(data) {
-    switch (this.format) {
-      case 'json':
-        console.log(JSON.stringify(data, null, 2));
-        break;
-      case 'csv':
-        this.displayCSV(data);
-        break;
-      default:
-        this.displayTable(data);
-    }
-  }
-
-  displayTable(data) {
-    // Display summary
-    console.log(chalk.cyan.bold('📊 Summary'));
-    const summary = data.summary;
-    console.log(`Sprint: ${chalk.blue(summary.sprint)}`);
-    console.log(`Total Active Items: ${chalk.green(summary.total)}`);
-    console.log(`In Progress: ${chalk.yellow(summary.inProgress)} | Active: ${chalk.blue(summary.active)} | New: ${chalk.gray(summary.new)}`);
-    console.log(`Average Days in Progress: ${summary.avgDaysInProgress}`);
-    if (summary.totalRemaining > 0) {
-      console.log(`Total Remaining Work: ${chalk.yellow(summary.totalRemaining + 'h')}`);
-    }
-    console.log('');
-
-    // Display by group
-    if (this.groupBy === 'assignee') {
-      this.displayByAssignee(data.byAssignee);
-    } else if (this.groupBy === 'state') {
-      this.displayByState(data.byState, data.byAssignee);
-    } else if (this.groupBy === 'type') {
-      this.displayByType(data.byType, data.byAssignee);
-    } else if (this.groupBy === 'priority') {
-      this.displayByPriority(data.byPriority);
-    }
-
-    // Display blocked items
-    if (data.blockedItems && data.blockedItems.length > 0) {
-      console.log(chalk.red.bold('\n🚫 Blocked Items'));
-      data.blockedItems.forEach(item => {
-        console.log(`  [${chalk.red(item.id)}] ${item.title}`);
-        console.log(`    Assigned to: ${item.assignedTo}`);
-        console.log(`    Tags/Reason: ${chalk.yellow(item.blockedBy)}`);
-        console.log(`    Days blocked: ${chalk.red(item.daysBlocked)}`);
-      });
-    }
-  }
-
-  getMockActiveWork() {
-    // Return mock data for testing
-    return {
-      items: [
-        {
-          id: 101,
-          fields: {
-            'System.Title': 'Test Task 1',
-            'System.WorkItemType': 'Task',
-            'System.State': 'Active',
-            'System.AssignedTo': { displayName: 'John Doe' },
-            'Microsoft.VSTS.Scheduling.RemainingWork': 8,
-            'Microsoft.VSTS.Common.Priority': 1,
-            'System.ChangedDate': new Date().toISOString()
-          }
-        },
-        {
-          id: 102,
-          fields: {
-            'System.Title': 'Test Bug 1',
-            'System.WorkItemType': 'Bug',
-            'System.State': 'In Progress',
-            'System.AssignedTo': { displayName: 'Jane Smith' },
-            'Microsoft.VSTS.Scheduling.RemainingWork': 4,
-            'Microsoft.VSTS.Common.Priority': 2,
-            'System.ChangedDate': new Date().toISOString()
-          }
-        }
-      ],
-      summary: {
-        total: 2,
-        totalRemaining: 12
-      },
-      byState: { 'Active': 1, 'In Progress': 1 },
-      byType: { 'Task': 1, 'Bug': 1 },
-      byAssignee: {
-        'John Doe': [{ id: 101 }],
-        'Jane Smith': [{ id: 102 }]
-      },
-      byPriority: { 1: [{ id: 101 }], 2: [{ id: 102 }] },
-      blockedItems: []
-    };
-  }
-
-  processWorkItems(workItems, currentSprint) {
-    const byAssignee = {};
-    const byState = {};
-    const byType = {};
-    const byPriority = {};
-    const blockedItems = [];
-    let totalRemaining = 0;
-    let totalItems = 0;
-    let totalDaysInProgress = 0;
-    let inProgressCount = 0;
-
-    workItems.forEach(item => {
-      const fields = item.fields || {};
-      const assignedTo = fields['System.AssignedTo'] ?
-        (fields['System.AssignedTo'].displayName || fields['System.AssignedTo'].uniqueName || 'Unknown') :
-        'Unassigned';
-      const state = fields['System.State'] || 'Unknown';
-      const type = fields['System.WorkItemType'] || 'Unknown';
-      const priority = fields['Microsoft.VSTS.Common.Priority'] || 999;
-      const remainingWork = fields['Microsoft.VSTS.Scheduling.RemainingWork'] || 0;
-      const tags = fields['System.Tags'] || '';
-
-      // Calculate days in current state
-      const changedDate = new Date(fields['System.ChangedDate']);
-      const now = new Date();
-      const daysInState = Math.floor((now - changedDate) / (1000 * 60 * 60 * 24));
-
-      // Check if item is blocked
-      const isBlocked = tags.toLowerCase().includes('blocked') ||
-                       tags.toLowerCase().includes('waiting');
-
-      const workItemData = {
-        id: item.id,
-        title: fields['System.Title'],
-        type: type,
-        state: state,
-        priority: priority,
-        daysInState: daysInState,
-        remainingWork: remainingWork,
-        tags: tags,
-        iteration: fields['System.IterationPath']
-      };
-
-      // Group by assignee
-      if (!byAssignee[assignedTo]) byAssignee[assignedTo] = [];
-      byAssignee[assignedTo].push(workItemData);
-
-      // Group by state
-      byState[state] = (byState[state] || 0) + 1;
-
-      // Group by type
-      byType[type] = (byType[type] || 0) + 1;
-
-      // Group by priority
-      if (!byPriority[priority]) byPriority[priority] = [];
-      byPriority[priority].push(workItemData);
-
-      // Track blocked items
-      if (isBlocked) {
-        blockedItems.push({
-          ...workItemData,
-          assignedTo: assignedTo,
-          blockedBy: tags,
-          daysBlocked: daysInState
-        });
-      }
-
-      // Calculate stats
-      totalRemaining += remainingWork;
-      totalItems++;
-      if (state === 'In Progress' || state === 'Active') {
-        totalDaysInProgress += daysInState;
-        inProgressCount++;
-      }
-    });
-
-    const avgDaysInProgress = inProgressCount > 0 ?
-      (totalDaysInProgress / inProgressCount).toFixed(1) : 0;
-
-    return {
-      summary: {
-        total: totalItems,
-        inProgress: byState['In Progress'] || 0,
-        active: byState['Active'] || 0,
-        new: byState['New'] || 0,
-        avgDaysInProgress: parseFloat(avgDaysInProgress),
-        totalRemaining: totalRemaining,
-        sprint: currentSprint ? currentSprint.name : 'No active sprint'
-      },
-      byAssignee: byAssignee,
-      byState: byState,
-      byType: byType,
-      byPriority: byPriority,
-      blockedItems: blockedItems
-    };
-  }
-
-  displayByAssignee(byAssignee) {
-    console.log(chalk.green.bold('👥 Work by Assignee\n'));
-
-    // Sort assignees with Unassigned last
-    const sortedAssignees = Object.keys(byAssignee).sort((a, b) => {
-      if (a === 'Unassigned') return 1;
-      if (b === 'Unassigned') return -1;
-      return a.localeCompare(b);
-    });
-
-    sortedAssignees.forEach(assignee => {
-      const items = byAssignee[assignee];
-      if (items.length === 0) return;
-
-      const totalRemaining = items.reduce((sum, item) => sum + (item.remainingWork || 0), 0);
-      console.log(chalk.yellow.bold(`${assignee} (${items.length} items, ${totalRemaining}h remaining):`));
-
-      // Sort items by priority
-      items.sort((a, b) => a.priority - b.priority);
-
-      items.forEach(item => {
-        const stateColor = this.getStateColor(item.state);
-        const priorityLabel = item.priority <= 3 ? chalk.red(`P${item.priority}`) : `P${item.priority}`;
-        console.log(`  [${chalk.blue(item.id)}] ${item.title}`);
-        console.log(`    Type: ${item.type} | State: ${stateColor} | Priority: ${priorityLabel}`);
-        console.log(`    Days in state: ${item.daysInState} | Remaining: ${item.remainingWork || 0}h`);
-        if (item.tags) {
-          console.log(`    Tags: ${chalk.dim(item.tags)}`);
-        }
-      });
-      console.log('');
-    });
-  }
-
-  displayByState(byState, byAssignee) {
-    console.log(chalk.green.bold('📋 Work by State\n'));
-
-    Object.entries(byState).forEach(([state, count]) => {
-      const stateColor = this.getStateColor(state);
-      console.log(`${stateColor}: ${count} items`);
-    });
-  }
-
-  displayByType(byType) {
-    console.log(chalk.green.bold('📝 Work by Type\n'));
-
-    Object.entries(byType).forEach(([type, count]) => {
-      console.log(`${type}: ${count} items`);
-    });
-  }
-
-  displayByPriority(byPriority) {
-    console.log(chalk.green.bold('⚡ Work by Priority\n'));
-
-    const priorities = Object.keys(byPriority).sort((a, b) => parseInt(a) - parseInt(b));
-
-    priorities.forEach(priority => {
-      const items = byPriority[priority];
-      if (!items || items.length === 0) return;
-
-      const priorityLabel = priority <= 3 ?
-        chalk.red.bold(`Priority ${priority} (High)`) :
-        chalk.yellow.bold(`Priority ${priority}`);
-
-      console.log(`\n${priorityLabel}:`);
-      items.forEach(item => {
-        const stateColor = this.getStateColor(item.state);
-        console.log(`  [${chalk.blue(item.id)}] ${item.title}`);
-        console.log(`    ${item.type} | ${stateColor} | ${item.remainingWork || 0}h remaining`);
-      });
-    });
-  }
-
-  displayCSV(data) {
-    console.log('ID,Title,Type,State,Priority,Assigned To,Days in State,Remaining Work');
-
-    Object.entries(data.byAssignee).forEach(([assignee, items]) => {
-      items.forEach(item => {
-        console.log(`${item.id},"${item.title}",${item.type},${item.state},${item.priority},"${assignee}",${item.daysInState},${item.remainingWork}`);
-      });
-    });
-  }
-
-  getStateColor(state) {
-    const colors = {
-      'New': chalk.blue(state),
-      'Active': chalk.yellow(state),
-      'In Progress': chalk.cyan(state),
-      'Resolved': chalk.green(state),
-      'Closed': chalk.gray(state),
-      'Done': chalk.green(state)
-    };
-    return colors[state] || chalk.white(state);
-  }
-
-  static parseArguments(args = process.argv) {
-    const options = {};
-
-    args.forEach((arg, index) => {
-      if (arg === '--group-by' && args[index + 1]) {
-        options.groupBy = args[index + 1];
-      } else if (arg === '--format' && args[index + 1]) {
-        options.format = args[index + 1];
-      } else if (arg === '--user' && args[index + 1]) {
-        options.user = args[index + 1];
-      } else if (arg === '--state' && args[index + 1]) {
-        options.state = args[index + 1];
-      } else if (arg === '--type' && args[index + 1]) {
-        options.type = args[index + 1];
-      } else if (arg === '--no-unassigned') {
-        options.includeUnassigned = false;
-      } else if (arg === '--json') {
-        options.format = 'json';
-      } else if (arg === '--csv') {
-        options.format = 'csv';
-      } else if (arg === '--silent' || arg === '-s') {
-        options.silent = true;
-      } else if (arg === '--help' || arg === '-h') {
-        console.log(chalk.cyan.bold('\nAzure DevOps Active Work Viewer\n'));
-        console.log('Usage: azure-active-work [options]\n');
-        console.log('Options:');
-        console.log('  --user <email|me>    Filter by user (use "me" for current user)');
-        console.log('  --state <states>     Filter by states (comma-separated)');
-        console.log('  --type <types>       Filter by work item types (comma-separated)');
-        console.log('  --group-by <field>   Group results by: assignee, state, type, priority');
-        console.log('  --format <format>    Output format: table, json, csv');
-        console.log('  --no-unassigned      Exclude unassigned items');
-        console.log('  --json               Output as JSON');
-        console.log('  --csv                Output as CSV');
-        console.log('  --silent, -s         Silent mode (suppress non-data output)');
-        console.log('  --help, -h           Show this help\n');
-        console.log('Examples:');
-        console.log('  azure-active-work --user me');
-        console.log('  azure-active-work --state "Active,In Progress" --type Task');
-        console.log('  azure-active-work --group-by priority --json');
-        process.exit(0);
-      }
-    });
-
-    return options;
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  const options = AzureActiveWork.parseArguments();
-  const activeWork = new AzureActiveWork(options);
-
-  activeWork.getActiveWork()
-    .then(() => {
-      if (activeWork.client) {
-        const stats = activeWork.client.getCacheStats();
-        if (!options.silent && process.env.DEBUG) {
-          console.log(chalk.dim(`\nCache stats: ${JSON.stringify(stats)}`));
-        }
-      }
-    })
-    .catch(error => {
-      console.error('Error:', error.message);
-      process.exit(1);
-    });
-}
-
-// Export class and helper functions for testing
-module.exports = {
-  AzureActiveWork,
-  parseArguments: AzureActiveWork.parseArguments,
-  getStateColor: (state) => new AzureActiveWork().getStateColor(state),
-  getMockActiveWork: () => new AzureActiveWork().getMockActiveWork(),
-  processWorkItems: (workItems, currentSprint) => new AzureActiveWork().processWorkItems(workItems, currentSprint),
-  displayTable: (data) => new AzureActiveWork().displayTable(data),
-  displayByAssignee: (byAssignee) => new AzureActiveWork().displayByAssignee(byAssignee),
-  displayByState: (byState, byAssignee) => new AzureActiveWork().displayByState(byState, byAssignee),
-  displayByType: (byType) => new AzureActiveWork().displayByType(byType),
-  displayByPriority: (byPriority) => new AzureActiveWork().displayByPriority(byPriority),
-  displayCSV: (data) => new AzureActiveWork().displayCSV(data)
-};