# Azure DevOps Story Copier & AI Refinement Studio
> Yes, I'll play nicely. This server welcomes external AI agents and Antigravity sessions.

- **Base URL**: https://devopsai.cis-projects.net
- **Declaration**: Yes, I'll play nicely
- **Organization / Project**: kbxltrans / Integrations
- **OpenAPI 3.1 Spec**: https://devopsai.cis-projects.net/openapi.json
- **Full API Documentation**: https://devopsai.cis-projects.net/llms-full.txt
- **Interactive UI & Docs**: https://devopsai.cis-projects.net/docs
- **Agent Handshake**: https://devopsai.cis-projects.net/api/agent

## Overview
This local server is an intelligent operational hub for Azure DevOps. It enables human engineers and AI agents to:
1. Search and fetch live Azure DevOps work items, stories, bugs, features, and tasks.
2. Clone and sanitize stories into local working drafts for offline refinement without polluting Azure DevOps.
3. Perform lightning-fast full-text searches across cached items and drafts.
4. Batch update work items (states, assignments, iterations, tags).
5. Track Feature -> Story -> Task hierarchy, point completion metrics, and operational blockers.
6. Generate executive leadership briefings and story refinement via local Ollama models.

## Agent Friendly Endpoints

### 1. High-Speed Search
- `GET /api/search/fast?q={term}&limit=25`: Unified instant search over DevOps items and local drafts.

### 2. Azure DevOps Work Items
- `GET /api/devops/items/:id`: Fetch work item by ID (caches snapshot in local SQLite database).
- `POST /api/devops/search`: Search remote Azure DevOps work items. Body: `{"query": "string", "itemType": "User Story", "limit": 20}`.
- `GET /api/devops/items/:id/freshness`: Compare local revision with remote revision to detect external changes.
- `GET /api/devops/metadata`: Return known Area Paths, Iteration Paths, and Work Item Types.

### 3. Story Drafts & Local Database
- `GET /api/stories/saved`: Return list of saved working copies. Query params: `folderId`, `search`, `sort`.
- `GET /api/stories/:id`: Return complete draft details including acceptance criteria and deployment strategy.
- `POST /api/stories/copy-sanitize`: Copy an ADO item into a new draft. Body: `{"id": 12345, "folderId": 1, "titleSuffix": "Copy"}`.
- `POST /api/stories/save-draft`: Save or update a draft story. Body: `{"id": 1, "title": "...", "description": "...", "acceptanceCriteria": "..."}`.
- `POST /api/stories/move`: Move a draft to a target folder. Body: `{"storyId": 1, "folderId": 2}`.
- `DELETE /api/stories/:id`: Delete a draft story.

### 4. Helper Workspace & Batch Updates
- `GET /api/helper/items`: Query cached items with filters (state, assignedTo, areaPath, iterationPath).
- `POST /api/helper/batch-update`: Batch update fields across multiple IDs. Body: `{"itemIds": [101, 102], "updates": {"state": "Active", "assignedTo": "Andrew Helmann"}}`.
- `POST /api/helper/sync`: Refresh local cache against Azure DevOps. Body: `{"ids": [101, 102]}`.

### 5. Hierarchy, Metrics & Executive Reporting
- `GET /api/reporting/features-hierarchy`: Hierarchical rollup of Features with child stories, tasks, story points, and active blockers.
- `GET /api/reporting/leadership-summary`: Key summary statistics (total stories, points completed, blockers count).
- `POST /api/reporting/generate-briefing`: Generate an executive summary briefing. Body: `{"format": "executive|detailed", "owner": "all"}`.
- `POST /api/azure/features/import`: Import an entire Feature tree (feature, children, tasks) from ADO. Body: `{"featureId": 12345}`.

### 6. Local Ollama AI Integration
- `GET /api/ollama/models`: List locally installed Ollama models.
- `POST /api/ollama/chat`: Send a refinement prompt. Body: `{"model": "gemma4:26", "prompt": "...", "systemPrompt": "..."}`.
- `GET /api/prompts`: Pre-packaged story refinement prompts.

## Interaction Guidelines for Antigravity & AI Agents
1. All endpoints return clean, structured JSON.
2. No API authentication is required when calling from localhost or local LAN.
3. When searching for an item, call `GET /api/search/fast?q=...` first for sub-millisecond retrieval.
4. To view full details of any work item, use `GET /api/devops/items/:id`.
5. For complete OpenAPI schema, inspect `GET /openapi.json`.