pipeline-tracker

Files (1)

• SKILL.md

SKILL.md (first lines)

# Pipeline Tracker

Tracks ticket-to-PR pipeline runs, syncs status to Notion, and provides a dashboard view.

## Commands

Parse the user's request to determine which command to run:

- `status` (default) - Show dashboard of all tickets
- `sync` - Queue Notion updates for current status
- `resume {ticket-id}` - Resume a paused run
- `check-merged` - Check for merged PRs and update to Done

## Configuration

The skill uses the **production API** by default. No configuration needed for read-only operations.

**Defaults (no setup required):**

- API URL: `https://api-gateway-856475788601.us-central1.run.app`
- Read-only endpoints at `/public/*` require no authentication

**For write operations** (transitions, sync), set:

```bash
export PIPELINE_API_KEY="..."  # Get from GCP Secret Manager or ask admin
```

## Command: status (default)

1. **Query tickets from public API (no auth required):**

   ```bash
   # Use the public endpoint directly - no auth needed
   curl -s "https://api-gateway-856475788601.us-central1.run.app/public/tickets" | jq
   ```

   Or fetch with standard HTTP request:

   ```typescript
   const API_URL = process.env.PIPELINE_API_URL || 'https://api-gateway-856475788601.us-central1.run.app'
   const response = await fetch(`${API_URL}/public/tickets`)
   const { tickets } = await response.json()
   ```

2. **Present dashboard:**

   ```markdown
   # Pipeline Dashboard

   ## Active Tickets

   | Ticket  | State         | PR   | Last Updated |
   | ------- | ------------- | ---- | ------------ |
   | {title} | 🟢 RESEARCH   | -    | 2h ago       |
   | {title} | 🟡 PR_CREATED | #123 | 1d ago       |
   | {title} | 🔴 BLOCKED    | -    | 3d ago       |

   ## Details

   ### {Ticket Title}

   - **URL:** {ticketUrl}
   - **State:** {state}
   - **Started:** {created_at}
   - **Last Updated:** {updated_at}
   - **PR:** {pr_url or "not created"}
   ```

3. **Offer options:**
   ```
   Options:
   A) Sync all to Notion
   B) View details for specific ticket
   C) Resume a ticket
   ```

### State Icons

- 🟢 Active: INTAKE, RESEARCH, PLANNING, IMPLEMENTATION
- 🟡 Review: PR_CREATED, CI_PASSED
- 🔴 Blocked: BLOCKED
- ✅ Done: DONE

## Command: sync

Queue Notion updates for all tickets via the sync queue.

**Requires `PIPELINE_API_KEY` for authentication.**

1. **List tickets from public API:**

   ```typescript
   const API_URL = process.env.PIPELINE_API_URL || 'https://api-gateway-856475788601.us-central1.run.app'
   const response = await fetch(`${API_URL}/public/tickets`)
   const { tickets } = await response.json()
   ```

2. **Map state to Notion Status:**
   | Pipeline State | Notion Status |
   |---------------|---------------|
   | INTAKE, RESEARCH, PLANNING, IMPLEMENTATION | In Progress |
   | PR_CREATED, CI_PASSED | In Review |
   | DONE | Done |
   | BLOCKED | (keep current) |

3. **Queue sync for each ticket:**

   ```typescript
   for (const ticket of tickets) {
     const notionStatus = mapStateToNotionStatus(ticket.state)
     await client.queueSync(ticket.id, 'update_notion', {
       status: notionStatus,
       prUrl: ticket.pr_url,
     })
   }
   ```

4. **Report results:**

From DrJKL/ticket-to-pr-pipeline, MIT.

More from DrJKL/ticket-to-pr-pipeline