Simplify documentation and add scoring parameter guide #4
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
workflow auto runs
- Introduced `AGENTS.md` to outline project structure, build commands, coding style, testing guidelines, and commit practices. - Updated `OPTIMIZED_USAGE_EXAMPLES.md` with new usage examples reflecting recent changes in work item queries. - Added `user_email_mapping.json` for mapping user names to emails. - Created `workitemsoctober.json` to store work item data for October. - Enhanced `efficiency_calculator.py` and `WorkItemOperations.py` to preserve exact Logic App estimates by disabling certain adjustments. - Updated `IMPLEMENTATION_ANALYSIS.md` to document intentional changes and their impact on efficiency metrics.
…tion - Introduced `.env.example` to provide a template for environment variables, including Azure DevOps organization and Logic App URL. - Added `LOGIC_APP_MIGRATION.md` to document the migration from WIQL/Analytics API to Azure Logic App for work item data retrieval. - Implemented `LogicAppClient` for fetching work items based on date ranges and user emails, enhancing the efficiency of data retrieval. - Updated `WorkItemOperations` to utilize the Logic App client, removing legacy WIQL methods and simplifying the querying process. - Enhanced efficiency calculations to incorporate Logic App estimates directly, improving accuracy in productivity metrics. - Added email mapping utilities to resolve user names to email addresses for querying work items. - Updated main entry point to reflect new command structure and required arguments for Logic App integration.
Bug fix/estimate hours
- Introduced a new command `--daily-snapshot` to generate simplified daily work item snapshots in CSV format. - Implemented `get_daily_snapshot_from_logic_app` method in `WorkItemOperations` for efficient data retrieval without complex calculations. - Added support for various snapshot modes (yesterday, today, month-to-date, custom) and customizable output filenames. - Enhanced command-line interface with detailed help documentation for snapshot generation options. - Optimized performance for automated workflows, reducing processing time by 40-60% compared to previous methods.
…pshot Add daily snapshot generation for automated tracking
- Introduced a new GitHub Actions workflow (`daily-snapshot.yml`) for automated daily work item snapshots. - The workflow runs daily at 01:00 UTC, generating cumulative month-to-date CSV reports. - Supports manual triggering with customizable snapshot modes and developer filtering. - Outputs are uploaded to GitHub Actions artifacts with a 30-day retention policy. - Updated README to document the new workflow and its usage.
Add daily snapshot workflow
- Changed the scheduled run time to 09:00 Mexico City time. - Updated input descriptions for clarity and consistency. - Standardized quotes in the YAML file for better readability.
- Updated the daily snapshot workflow to use a more appropriate content type and header for file uploads. - Enhanced the work item query construction in `WorkItemOperations` by improving string handling for work item types, ensuring better readability and maintainability.
Feature/git action yml
- Moved the SharePoint upload step from a commented section to an active step in the daily snapshot workflow. - Ensured the upload only occurs on successful completion of previous steps, maintaining workflow integrity.
Refactor SharePoint upload step in daily snapshot workflow
- Improved error handling in the SharePoint upload step to ensure failures are logged and the process exits gracefully. - Updated `WorkItemOperations` to clarify that active and blocked time calculations reflect total accumulated hours from the entire work item history, not limited to the specified date range. - Revised documentation in `main.py` to emphasize the implications of total accumulated time in reports and how date ranges are utilized for filtering work items.
…t workflow - Changed the content type header to include charset=utf-8 for improved compatibility during file uploads.
Feature/active time filtering
Updated the cron schedule to run daily at 09:00 Mexico City time.
Change cron schedule for daily snapshot workflow
Optimized flag removal
Fixed file naming for workflow detection
- Added AZURE_LOGIC_APP_URL environment variable to the monthly developer report workflow. - Improved handling of empty work item exports in WorkItemOperations by creating an empty CSV with headers when no work items are available. - Updated error handling in main.py to exit the program if the AZURE_LOGIC_APP_URL is not set.
Add AZURE_LOGIC_APP_URL to workflow and enhance CSV export handling
- Improved datetime parsing in EfficiencyCalculator to handle naive and aware datetimes, ensuring proper timezone normalization to Mexico City time. - Updated WorkItemOperations to enrich target and closed dates from multiple potential fields, enhancing data retrieval robustness.
Enhance date handling in EfficiencyCalculator and WorkItemOperations
…racking - Updated WorkItemOperations to include new fields for target date, due date, planned date, closed date, and resolved date, enhancing historical estimate retrieval and date tracking capabilities.
Enhance WorkItemOperations with additional date fields for improved t…
added fernando agredano to list
Fixed file naming for workflow detection
Add Fernando Agredano to user email mapping
- Add QUICKSTART.md for 5-minute setup guide - Add SCORING_PARAMETERS.md for adjusting developer score weights - Add SCORING_EXAMPLES.md with configuration examples - Simplify README.md to focus on essentials - Simplify WORK_ITEM_QUERYING_GUIDE.md (English only, reduced from 727 to ~280 lines) - Update CLAUDE.md with new project structure - Fix config export_settings to match actual CSV output columns - Fix work_item_types typo: "Bugs" -> "Bug" - Delete deprecated IMPLEMENTATION_ANALYSIS.md - Delete redundant CONFIGURATION_USAGE.md (merged into other docs) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Test plan
python run.py --explainto confirm help still works🤖 Generated with Claude Code