azdo-daily 1.0.0__tar.gz

azdo_daily-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shakila
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

azdo_daily-1.0.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: azdo-daily
+Version: 1.0.0
+Summary: Azure DevOps daily task automation with AI task breakdown
+Author-email: Shakila <shadikari012@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://github.com/yourusername/azdo-daily
+Project-URL: Issues, https://github.com/yourusername/azdo-daily/issues
+Keywords: azure-devops,task-automation,ai,claude
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Dynamic: license-file
+
+# Azure DevOps Daily Task Automation
+
+🤖 Automate daily task creation, activation, and completion logging in Azure DevOps with AI-powered task breakdown via Claude.
+
+- **AI Task Breakdown** — Claude reads user stories and generates concrete development tasks
+- **Interactive Workflow** — `create` → `start` → `update` → `end` pipeline
+- **Auto-linking** — Tasks linked to parent stories, related across multiple stories
+- **Progress Tracking** — Log hours, remaining estimates, completion notes
+- **Global CLI** — Install once, use anywhere: `azdo-daily configure`
+
+## Installation
+
+Install globally from this repository:
+
+```bash
+pip install .
+```
+
+Or install in development mode:
+
+```bash
+pip install -e .
+```
+
+Then use from anywhere:
+
+```bash
+azdo-daily configure
+azdo-daily status
+```
+
+## Configuration
+
+On first run, configure your settings:
+
+```bash
+azdo-daily configure
+```
+
+Configuration stored in `.config/settings.json` (project-local, excluded from git).
+
+Interactive prompts for:
+| Field | Description |
+|---|---|
+| `org` | Your Azure DevOps organisation name |
+| `project` | Project name |
+| `pat` | Personal Access Token — needs **Work Items (Read & Write)** scope |
+| `anthropic_api_key` | From console.anthropic.com — for AI task breakdown |
+| `assigned_to` | Your email/display name — used to filter stories |
+| `close_state` | `Done` / `Closed` / `Resolved` (depends on your process template) |
+
+---
+
+## Project Structure
+
+```
+azdo_daily/
+├── main.py       — Entry point: argument parsing + command dispatch
+├── config.py     — Configuration: load/save/validate settings
+├── state.py      — Daily state: load/save work items per day
+├── ui.py         — Terminal UI: colors, prompts, formatters, selection helpers
+├── azdo.py       — Azure DevOps API client: work item operations
+├── ai.py         — Claude AI: task breakdown from stories
+└── commands.py   — Command handlers: configure, create, start, update, end, status
+```
+
+### Key Modules
+
+**`azdo.py`** — Azure DevOps API client
+- `session()` — authenticated HTTP session
+- `wit_base()` — Work Item Tracking API base URL
+- `get_my_stories()` — fetch assigned stories via WIQL
+- `create_task()` — create new task linked to stories
+- `set_workitem_state()` — change work item state
+- `resolve_task()` — mark task complete with hours + comment
+- `partial_task()` — log progress, keep task open
+- `_patch_workitem()` — internal: apply JSON Patch operations
+- `add_comment()` — internal: append work item comment
+
+**`commands.py`** — CLI command handlers
+- `cmd_configure()` — interactive setup
+- `cmd_create()` — select stories → generate tasks → create in Azure DevOps
+- `cmd_start()` — activate tasks (mark In Progress)
+- `cmd_update()` — log progress on tasks
+- `cmd_end()` — mark tasks done + auto-resolve stories
+- `cmd_status()` — show today's stories and tasks
+
+**`ui.py`** — Terminal UI helpers
+- Color constants: `R`, `B`, `DIM`, `GR`, `YL`, `BL`, `CY`, `RD`, `MG`
+- Output: `ok()`, `err()`, `info()`, `warn()`, `hdr()`, `sep()`
+- Input: `ask()` (prompt with optional default)
+- Formatters: `print_stories()`, `print_tasks()`
+- Selection: `parse_selection()`, `select_from_list()` (handles "all")
+- Conversion: `float_or_none()`
+
+---
+
+## Daily Workflow
+
+### Setup (once)
+
+```bash
+azdo-daily configure
+```
+
+### Morning — Create tasks
+
+```bash
+azdo-daily create
+```
+
+1. Fetches all active User Stories assigned to you
+2. You select stories to work on (e.g. `1` or `1,3` or `2-4`)
+3. Choose task creation method:
+   - **AI auto-breakdown** — Claude reads story and generates tasks
+   - **Manual entry** — type tasks yourself
+   - **Both** — AI suggests, you review/add/remove
+4. If multiple stories: tasks created once, linked to all (child of #1, related to rest)
+5. Tasks appear in Azure DevOps immediately
+
+### Activate tasks
+
+```bash
+azdo-daily start
+```
+
+Marks selected new tasks as "In Progress" and auto-activates linked stories.
+
+### Anytime — Check status
+
+```bash
+azdo-daily status
+```
+
+Shows active stories and all tasks with open/resolved counts.
+
+### Throughout day — Log progress (optional)
+
+```bash
+azdo-daily update
+```
+
+Log hours spent and remaining estimates on open tasks (keeps them "In Progress").
+
+### Evening — Mark complete
+
+```bash
+azdo-daily end
+```
+
+1. Lists all open tasks for today
+2. You select which to complete (e.g. `1,3` or `all`)
+3. For each: enter hours spent + optional closing note
+4. Task marked done + hours logged
+5. If all tasks for a story are done → story auto-resolved
+
+---
+
+## State Files
+
+Each day's data in `state/YYYY-MM-DD.json`:
+
+```json
+{
+  "stories": [
+    {"id": 42, "title": "Implement auth"}
+  ],
+  "tasks": [
+    {
+      "id": 101,
+      "title": "Add login endpoint",
+      "url": "https://...",
+      "active": true,
+      "closed": false,
+      "completed_hours": 2.5,
+      "remaining_hours": 1.0,
+      "story_ids": [42]
+    }
+  ]
+}
+```
+
+---
+
+## Cron (optional)
+
+Status reminder at 9 AM weekdays:
+
+```cron
+0 9 * * 1-5 azdo-daily status
+```
+
+> `start`, `update`, and `end` commands are interactive — use cron for `status` only.
+
+---
+
+## Troubleshooting
+
+### "Work item X does not exist"
+
+Task IDs in state file no longer exist in Azure DevOps. Reset today's state:
+
+```bash
+rm ~/.config/azdo_daily/state/2026-04-29.json  # or today's date
+azdo-daily create
+```
+
+### "anthropic_api_key not set"
+
+Run configure and enter Anthropic API key from [console.anthropic.com](https://console.anthropic.com):
+
+```bash
+azdo-daily configure
+```
+
+### "Personal Access Token (PAT) invalid"
+
+Regenerate PAT in Azure DevOps → User Settings → Personal Access Tokens.
+Must have **Work Items (Read & Write)** scope.
+
+### ModuleNotFoundError after install
+
+Reinstall in development mode:
+
+```bash
+pip install -e .
+```
+
+---
+
+## Development
+
+Install with dev tools:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Format code:
+
+```bash
+black azdo_daily/
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)

azdo_daily-1.0.0/README.md

@@ -0,0 +1,249 @@
+# Azure DevOps Daily Task Automation
+
+🤖 Automate daily task creation, activation, and completion logging in Azure DevOps with AI-powered task breakdown via Claude.
+
+- **AI Task Breakdown** — Claude reads user stories and generates concrete development tasks
+- **Interactive Workflow** — `create` → `start` → `update` → `end` pipeline
+- **Auto-linking** — Tasks linked to parent stories, related across multiple stories
+- **Progress Tracking** — Log hours, remaining estimates, completion notes
+- **Global CLI** — Install once, use anywhere: `azdo-daily configure`
+
+## Installation
+
+Install globally from this repository:
+
+```bash
+pip install .
+```
+
+Or install in development mode:
+
+```bash
+pip install -e .
+```
+
+Then use from anywhere:
+
+```bash
+azdo-daily configure
+azdo-daily status
+```
+
+## Configuration
+
+On first run, configure your settings:
+
+```bash
+azdo-daily configure
+```
+
+Configuration stored in `.config/settings.json` (project-local, excluded from git).
+
+Interactive prompts for:
+| Field | Description |
+|---|---|
+| `org` | Your Azure DevOps organisation name |
+| `project` | Project name |
+| `pat` | Personal Access Token — needs **Work Items (Read & Write)** scope |
+| `anthropic_api_key` | From console.anthropic.com — for AI task breakdown |
+| `assigned_to` | Your email/display name — used to filter stories |
+| `close_state` | `Done` / `Closed` / `Resolved` (depends on your process template) |
+
+---
+
+## Project Structure
+
+```
+azdo_daily/
+├── main.py       — Entry point: argument parsing + command dispatch
+├── config.py     — Configuration: load/save/validate settings
+├── state.py      — Daily state: load/save work items per day
+├── ui.py         — Terminal UI: colors, prompts, formatters, selection helpers
+├── azdo.py       — Azure DevOps API client: work item operations
+├── ai.py         — Claude AI: task breakdown from stories
+└── commands.py   — Command handlers: configure, create, start, update, end, status
+```
+
+### Key Modules
+
+**`azdo.py`** — Azure DevOps API client
+- `session()` — authenticated HTTP session
+- `wit_base()` — Work Item Tracking API base URL
+- `get_my_stories()` — fetch assigned stories via WIQL
+- `create_task()` — create new task linked to stories
+- `set_workitem_state()` — change work item state
+- `resolve_task()` — mark task complete with hours + comment
+- `partial_task()` — log progress, keep task open
+- `_patch_workitem()` — internal: apply JSON Patch operations
+- `add_comment()` — internal: append work item comment
+
+**`commands.py`** — CLI command handlers
+- `cmd_configure()` — interactive setup
+- `cmd_create()` — select stories → generate tasks → create in Azure DevOps
+- `cmd_start()` — activate tasks (mark In Progress)
+- `cmd_update()` — log progress on tasks
+- `cmd_end()` — mark tasks done + auto-resolve stories
+- `cmd_status()` — show today's stories and tasks
+
+**`ui.py`** — Terminal UI helpers
+- Color constants: `R`, `B`, `DIM`, `GR`, `YL`, `BL`, `CY`, `RD`, `MG`
+- Output: `ok()`, `err()`, `info()`, `warn()`, `hdr()`, `sep()`
+- Input: `ask()` (prompt with optional default)
+- Formatters: `print_stories()`, `print_tasks()`
+- Selection: `parse_selection()`, `select_from_list()` (handles "all")
+- Conversion: `float_or_none()`
+
+---
+
+## Daily Workflow
+
+### Setup (once)
+
+```bash
+azdo-daily configure
+```
+
+### Morning — Create tasks
+
+```bash
+azdo-daily create
+```
+
+1. Fetches all active User Stories assigned to you
+2. You select stories to work on (e.g. `1` or `1,3` or `2-4`)
+3. Choose task creation method:
+   - **AI auto-breakdown** — Claude reads story and generates tasks
+   - **Manual entry** — type tasks yourself
+   - **Both** — AI suggests, you review/add/remove
+4. If multiple stories: tasks created once, linked to all (child of #1, related to rest)
+5. Tasks appear in Azure DevOps immediately
+
+### Activate tasks
+
+```bash
+azdo-daily start
+```
+
+Marks selected new tasks as "In Progress" and auto-activates linked stories.
+
+### Anytime — Check status
+
+```bash
+azdo-daily status
+```
+
+Shows active stories and all tasks with open/resolved counts.
+
+### Throughout day — Log progress (optional)
+
+```bash
+azdo-daily update
+```
+
+Log hours spent and remaining estimates on open tasks (keeps them "In Progress").
+
+### Evening — Mark complete
+
+```bash
+azdo-daily end
+```
+
+1. Lists all open tasks for today
+2. You select which to complete (e.g. `1,3` or `all`)
+3. For each: enter hours spent + optional closing note
+4. Task marked done + hours logged
+5. If all tasks for a story are done → story auto-resolved
+
+---
+
+## State Files
+
+Each day's data in `state/YYYY-MM-DD.json`:
+
+```json
+{
+  "stories": [
+    {"id": 42, "title": "Implement auth"}
+  ],
+  "tasks": [
+    {
+      "id": 101,
+      "title": "Add login endpoint",
+      "url": "https://...",
+      "active": true,
+      "closed": false,
+      "completed_hours": 2.5,
+      "remaining_hours": 1.0,
+      "story_ids": [42]
+    }
+  ]
+}
+```
+
+---
+
+## Cron (optional)
+
+Status reminder at 9 AM weekdays:
+
+```cron
+0 9 * * 1-5 azdo-daily status
+```
+
+> `start`, `update`, and `end` commands are interactive — use cron for `status` only.
+
+---
+
+## Troubleshooting
+
+### "Work item X does not exist"
+
+Task IDs in state file no longer exist in Azure DevOps. Reset today's state:
+
+```bash
+rm ~/.config/azdo_daily/state/2026-04-29.json  # or today's date
+azdo-daily create
+```
+
+### "anthropic_api_key not set"
+
+Run configure and enter Anthropic API key from [console.anthropic.com](https://console.anthropic.com):
+
+```bash
+azdo-daily configure
+```
+
+### "Personal Access Token (PAT) invalid"
+
+Regenerate PAT in Azure DevOps → User Settings → Personal Access Tokens.
+Must have **Work Items (Read & Write)** scope.
+
+### ModuleNotFoundError after install
+
+Reinstall in development mode:
+
+```bash
+pip install -e .
+```
+
+---
+
+## Development
+
+Install with dev tools:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Format code:
+
+```bash
+black azdo_daily/
+```
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE)

azdo_daily-1.0.0/azdo_daily/__init__.py

@@ -0,0 +1,9 @@
+"""Azure DevOps Daily Task Automation with AI task breakdown."""
+
+__version__ = "1.0.0"
+__author__ = "Shakila"
+__email__ = "shadikari012@gmail.com"
+
+from azdo_daily.main import main
+
+__all__ = ["main"]

azdo_daily-1.0.0/azdo_daily/ai.py

@@ -0,0 +1,43 @@
+"""Claude AI task breakdown for user stories."""
+
+import json
+import re
+
+import requests
+
+SYSTEM_PROMPT = """You are a senior agile software engineer.
+Given a user story, decompose it into concrete development tasks.
+
+Return ONLY a valid JSON array — no markdown, no explanation.
+Each element:
+  "title"       — short imperative phrase (e.g. "Add login endpoint")
+  "description" — 1-2 sentences on what to implement or verify
+  "priority"    — 1=Critical  2=High  3=Medium  4=Low
+  "effort"      — estimated hours (number)
+  "tags"        — semicolon-separated (e.g. "backend;api")
+
+Cover: backend, frontend, DB, tests, docs, DevOps as appropriate.
+Aim for 4–8 focused tasks."""
+
+
+def ai_breakdown(story_text: str, api_key: str) -> list[dict]:
+    """Call Claude to break down story into tasks."""
+    r = requests.post(
+        "https://api.anthropic.com/v1/messages",
+        headers={
+            "x-api-key": api_key,
+            "anthropic-version": "2023-06-01",
+            "content-type": "application/json",
+        },
+        json={
+            "model": "claude-sonnet-4-20250514",
+            "max_tokens": 2048,
+            "system": SYSTEM_PROMPT,
+            "messages": [{"role": "user", "content": f"User story:\n\n{story_text}"}],
+        },
+        timeout=60,
+    )
+    r.raise_for_status()
+    raw = r.json()["content"][0]["text"].strip()
+    raw = re.sub(r"^```(?:json)?", "", raw).rstrip("`").strip()
+    return json.loads(raw)