Windsurf

# Issue Tracking with tk

This project uses **tk (ticket-rs)** for dependency-aware issue tracking.
Issues are stored as Markdown files in `.tickets/`.

## Quick Commands

- `tk ready` - Find work with no blockers
- `tk triage` - AI-powered recommendations
- `tk create "Title" -t task -p 2` - Create issue
- `tk show <id>` - View issue details
- `tk close <id>` - Complete work
- `tk dep add <blocked> <blocker>` - Add dependency
- `tk dep tree <id>` - Visualize dependencies

## Issue Format

Issues are Markdown files with YAML frontmatter:

```markdown
---
status: open
type: feature
priority: 1
deps: [tk-abc123]
labels: [backend]
---
# Issue Title

Description here.
```

## Status Values

- `open` - Ready to be worked on
- `in_progress` - Currently being worked on
- `blocked` - Waiting on dependencies
- `closed` - Completed

## Priority Levels

- P0 (0) - Critical
- P1 (1) - High
- P2 (2) - Medium (default)
- P3 (3) - Low
- P4 (4) - Lowest

## Graph Analytics

tk provides PageRank-based priority scoring, betweenness centrality for bottleneck detection, and critical path analysis. Use `tk insights` for detailed metrics.

## Workflow

1. Start session: `tk triage` for AI recommendations
2. Find work: `tk ready` for unblocked issues
3. Create issues: `tk create "Title" -t type -p priority`
4. Manage deps: `tk dep add <blocked> <blocker>`
5. Complete work: `tk close <id>`

{
  "mcpServers": {
    "ticket-mcp": {
      "command": "uvx",
      "args": ["ticket-mcp"],
      "env": {}
    }
  }
}

tk create "Fix login timeout" -t bug -p 1