opencode-onboard 0.0.1 → 0.1.0

package/src/utils/models-cache.js

@@ -0,0 +1,101 @@
+import fse from 'fs-extra'
+import path from 'path'
+import os from 'os'
+
+const CACHE_DIR = path.join(os.homedir(), '.config', 'opencode-onboard')
+const CACHE_FILE = path.join(CACHE_DIR, 'models-cache.json')
+const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000 // 7 days
+const MODELS_URL = 'https://models.dev/api.json'
+
+// Providers considered "canonical" for reference pricing, in priority order.
+// When a model's own provider has no cost (e.g. github-copilot shows $0),
+// we look up the same model name in these providers and attach canonicalCost.
+const CANONICAL_PROVIDERS = ['anthropic', 'openai', 'google', 'mistral', 'meta', 'cohere']
+
+function parseModels(data) {
+  // Build name → canonical cost lookup from authoritative providers first
+  // name is the human-readable model name, e.g. "Claude Opus 4.6"
+  const canonicalCostByName = new Map()
+  for (const providerId of CANONICAL_PROVIDERS) {
+    const provider = data[providerId]
+    if (!provider?.models) continue
+    for (const model of Object.values(provider.models)) {
+      if (!model.tool_call) continue
+      const name = model.name
+      if (name && model.cost?.input !== undefined && !canonicalCostByName.has(name)) {
+        canonicalCostByName.set(name, model.cost.input)
+      }
+    }
+  }
+
+  const models = []
+  for (const [providerId, provider] of Object.entries(data)) {
+    if (!provider.models) continue
+    for (const [modelId, model] of Object.entries(provider.models)) {
+      if (!model.tool_call) continue
+      const name = model.name || modelId
+      const cost = model.cost?.input
+      const canonicalCost = canonicalCostByName.get(name)
+      models.push({
+        id: `${providerId}/${modelId}`,
+        name,
+        cost,
+        // canonicalCost: cost from the authoritative provider for this model name.
+        // Defined when cost !== canonicalCost (different provider, reseller, or $0 subscription).
+        canonicalCost: canonicalCost !== undefined && canonicalCost !== cost ? canonicalCost : undefined,
+        context: model.limit?.context,
+      })
+    }
+  }
+  models.sort((a, b) => (a.cost ?? Infinity) - (b.cost ?? Infinity))
+  return models
+}
+
+async function loadCache() {
+  try {
+    if (!await fse.pathExists(CACHE_FILE)) return null
+    const cache = await fse.readJson(CACHE_FILE)
+    if (!cache.timestamp || !cache.models) return null
+    const age = Date.now() - cache.timestamp
+    if (age > CACHE_TTL_MS) return null // expired
+    return cache.models
+  } catch {
+    return null
+  }
+}
+
+async function saveCache(models) {
+  try {
+    await fse.ensureDir(CACHE_DIR)
+    await fse.writeJson(CACHE_FILE, { timestamp: Date.now(), models })
+  } catch {
+    // cache write failure is non-fatal
+  }
+}
+
+export async function fetchModels() {
+  // 1. Try cache first (fresh)
+  const cached = await loadCache()
+  if (cached) return { models: cached, source: 'cache' }
+
+  // 2. Try network
+  try {
+    const res = await fetch(MODELS_URL, { signal: AbortSignal.timeout(8000) })
+    if (!res.ok) throw new Error(`HTTP ${res.status}`)
+    const data = await res.json()
+    const models = parseModels(data)
+    await saveCache(models)
+    return { models, source: 'network' }
+  } catch {
+    // 3. Network failed — fall back to stale cache if available
+    try {
+      if (await fse.pathExists(CACHE_FILE)) {
+        const cache = await fse.readJson(CACHE_FILE)
+        if (cache.models?.length) return { models: cache.models, source: 'stale-cache' }
+      }
+    } catch {
+      // ignore
+    }
+    return { models: null, source: 'unavailable' }
+  }
+}

package/content/.opencode/agents/.bootstrap/AGENTS.template.md

@@ -1,230 +0,0 @@
-# AGENTS.md
-
-This file provides guidance to AI agents when working in this repository.
-
-*Agent-agnostic — works with OpenCode, Claude Code, Codex, Gemini, etc.*
-
-## Project Overview
-
-This is the agent orchestration layer for your project. It provides:
-- Agent skills for development workflow tasks
-- OpenSpec change management
-- Memory files for agent context
-
-## I Am the Lead — Full Workflow Ownership
-
-When the user provides an issue/user story URL, says "implement the plan", or "I've added comments to the PR" — **I own the full lifecycle**. I load the appropriate skill and use ensemble tools (`team_create`, `team_spawn`, etc.) to coordinate specialist agents in parallel.
-
-Trigger patterns:
-- `work on this <azure-devops-url>` → load skill `ob-userstory-az` → propose OpenSpec → implement → PR
-- `work on this <github-url>` → load skill `ob-userstory-gh` → propose OpenSpec → implement → PR
-- `implement the plan` → load skill `openspec-apply-change` → implement → PR
-- `I've added comments to the PR` → spawn `ob-pullrequest-observer-az` or `ob-pullrequest-observer-gh` → fix → update PR
-
-**Never delegate without a plan. Never write implementation code directly — always spawn specialists.**
-
-## Multi-Agent Execution — opencode-ensemble
-
-Parallel execution uses the `opencode-ensemble` plugin (`team_create`, `team_spawn`, etc.).
-Works on **all platforms** (Windows, macOS, Linux) via OpenCode's built-in worktree support.
-
-| Tool | What it does |
-|------|-------------|
-| `team_create` | Create a team (caller becomes lead) |
-| `team_spawn` | Start a teammate asynchronously |
-| `team_shutdown` | Stop a teammate, preserve their branch |
-| `team_merge` | Merge a teammate's branch into working dir |
-| `team_cleanup` | Tear down the team |
-| `team_results` | Retrieve full message from a teammate |
-| `team_message` | Send a direct message to a teammate |
-| `team_broadcast` | Message all teammates |
-| `team_tasks_add` | Add tasks to shared board |
-| `team_tasks_complete` | Mark task done |
-
-**Dashboard**: Monitor running agents at **http://localhost:4747/**
-
----
-
-## Full Workflow
-
-### Phase 1 — Parse & Propose (new issue/US URL)
-
-```
-1. Load skill: ob-userstory-az or ob-userstory-gh → fetch work item, create OpenSpec change
-2. Load skill: openspec-propose → generate proposal.md, design.md, specs/, tasks.md
-   - team_create → team_spawn design (worktree:true) + team_spawn specs (worktree:true) in parallel
-   - Wait for both → team_shutdown + team_merge both → write tasks.md
-3. Show summary, confirm with user before implementing
-```
-
-### Phase 2 — Implement
-
-```
-1. Load skill: openspec-apply-change → get apply instructions
-2. Create feature branch
-3. team_create "<change-name>"
-4. Announce: "Team is running. Monitor progress at http://localhost:4747/"
-5. Spawn in parallel:
-   team_spawn name:backend  agent:backend  → backend tasks
-   team_spawn name:frontend agent:frontend → frontend tasks
-6. Wait for both → team_results → team_shutdown + team_merge both
-```
-
-### Phase 3 — QA
-
-```
-7. team_spawn name:qa agent:qa → review against specs, run builds
-8. Wait → team_results → fix any blockers
-9. team_shutdown qa
-```
-
-### Phase 4 — PR Creation
-
-```
-10. team_spawn name:ob-pullrequest-creator-az agent:ob-pullrequest-creator-az  (Azure DevOps projects)
-    team_spawn name:ob-pullrequest-creator-gh  agent:ob-pullrequest-creator-gh  (GitHub projects)
-    → Screenshots → save to openspec/changes/<change>/images/
-    → Commit & push to feature branch
-    → Create PR
-    → Post screenshot comment
-11. Wait → team_results → report PR URLs to user
-12. team_cleanup
-```
-
-### Phase 5 — PR Feedback Loop
-
-```
-When user says "I've added comments to the PR":
-1. team_spawn name:ob-pullrequest-observer-az agent:ob-pullrequest-observer-az  (Azure DevOps)
-   team_spawn name:ob-pullrequest-observer-gh  agent:ob-pullrequest-observer-gh  (GitHub)
-   → read threads, classify feedback
-2. Wait → team_results → spawn frontend and/or backend in parallel for code-change items
-3. Wait → team_results → team_spawn name:qa → review fixes
-4. Wait → team_results → team_spawn name:ob-pullrequest-*-creator → commit, push, update PR
-5. Wait → team_results → team_cleanup
-```
-
-## Branch Naming
-
-Format: `feature/{issue-id}-{slug}`
-Example: `feature/42-add-user-auth`
-
----
-
-## Project Structure
-
-```
-[project-root]/
-└── Copilots/              ← THIS FOLDER (agent orchestration)
-    ├── .opencode/         # OpenCode config and skills
-    │   ├── agents/        # Agent definitions
-    │   └── skills/        # Agent skill definitions
-    ├── openspec/          # OpenSpec artifacts
-    │   ├── specs/         # Project specs (permanent)
-    │   └── changes/       # Change tracking
-    │       └── {change}/  # Per-change folder
-    │           └── images/ # Screenshots for PR comments (git-tracked)
-    ├── AGENTS.md          # Agent guidance (THIS FILE)
-    ├── ARCHITECTURE.md    # System architecture
-    ├── DESIGN.md          # Design tokens and UI guidelines
-    └── README.md          # Project readme
-```
-
-## Tech Stack
-
-- OpenCode CLI — AI agent execution
-- OpenSpec — Spec-driven workflow
-- opencode-ensemble — Multi-agent parallel execution
-
-## Commands
-
-```bash
-# OpenSpec
-openspec new change "<name>"
-openspec list
-openspec status --change "<name>"
-openspec instructions apply --change "<name>" --json
-
-# Skills are in .opencode/skills/{skill-name}/SKILL.md
-```
-
-## Available Agent Skills
-
-| Skill | Purpose |
-|-------|---------|
-| `ob-userstory-az` | Parse Azure DevOps US URL, create OpenSpec change |
-| `ob-userstory-gh` | Parse GitHub Issue URL, create OpenSpec change |
-| `openspec-propose` | Propose change artifacts (proposal, design, specs, tasks) |
-| `openspec-apply-change` | Implement change with multi-agent team |
-| `openspec-archive-change` | Archive completed change |
-| `openspec-explore` | Explore ideas before creating a change |
-
-## Available Agents (Spawned via ensemble — never called directly)
-
-| Agent | File | Purpose |
-|-------|------|---------|
-| `frontend` | .opencode/agents/frontend.md | Frontend implementation |
-| `backend` | .opencode/agents/backend.md | Backend implementation |
-| `qa` | .opencode/agents/qa.md | Reviews code against acceptance criteria |
-| `ob-pullrequest-creator-az` | .opencode/agents/ob-pullrequest-creator-az.md | Screenshots, commit, push, create Azure DevOps PR |
-| `ob-pullrequest-observer-az` | .opencode/agents/ob-pullrequest-observer-az.md | Reads Azure DevOps PR feedback, triggers agents |
-| `ob-pullrequest-creator-gh` | .opencode/agents/ob-pullrequest-creator-gh.md | Screenshots, commit, push, create GitHub PR |
-| `ob-pullrequest-observer-gh` | .opencode/agents/ob-pullrequest-observer-gh.md | Reads GitHub PR feedback, triggers agents |
-
-## Guardrails
-
-### Images in PR Comments — Repo-Hosted
-
-**Never upload images as PR attachments.** Screenshots are saved to the openspec change `images/` folder and referenced via raw URL.
-
-| Step | Action |
-|------|--------|
-| Save screenshot | `openspec/changes/{change}/images/{file}.png` |
-| Azure DevOps raw URL | `https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1` |
-| GitHub raw URL | `https://raw.githubusercontent.com/{owner}/{repo}/{branch}/openspec/changes/{change}/images/{file}.png` |
-
-### Platform CLI — CRITICAL
-
-**ALL Azure DevOps interactions via `az` CLI. ALL GitHub interactions via `gh` CLI. Browser MCP FORBIDDEN for any DevOps or GitHub operation.**
-
-| Operation | Azure DevOps | GitHub |
-|-----------|-------------|--------|
-| Read issue/US | `az boards work-item show --id <id>` | `gh issue view <number>` |
-| Read PR threads | `az devops invoke ...` | `gh pr view <number> --comments` |
-| Create PR | `az repos pr create ...` | `gh pr create ...` |
-| Reply to thread | `az devops invoke ...` | `gh api .../replies` |
-
-Browser MCP tools permitted only for screenshots of **local running app** on `localhost` URLs.
-
-### Security — CRITICAL
-
-Agents CANNOT:
-- ❌ Access `.env` or config files with secrets
-- ❌ Log or output credentials, API keys, or tokens
-- ❌ Commit secrets to git
-
-### Git Operations
-
-Agents CAN:
-- ✅ Commit to feature branches
-- ✅ Push to feature branches
-
-Agents CANNOT:
-- ❌ Commit or push to `main` — FORBIDDEN
-- ❌ Force push — FORBIDDEN
-- ❌ Merge PRs — human-only
-- ❌ Create or delete branches other than `feature/*`
-
-### Scope Limits
-- Max 10 files per change
-- No architecture changes without human approval
-- No pipeline modifications
-
-## Communication Style
-
-Terse like caveman. Technical substance exact. Only fluff die.
-Drop: articles, filler (just/really/basically), pleasantries, hedging.
-Fragments OK. Short synonyms. Code unchanged.
-Pattern: [thing] [action] [reason]. [next step].
-ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift.
-Code/commits/PRs: normal. Off: "stop caveman" / "normal mode".

package/content/.opencode/agents/.bootstrap/CUSTOM-AGENT.template.md

@@ -1,24 +0,0 @@
-# Backend Agent
-
-> {{description_short}} - spawned by orchestrator via opencode-ensemble
-
-```
-name: {{name}}
-mode: subagent
-model: {{build|explore}}
-description: |
-  {{description_long}}
-tools:
-  read: {{true|false}}
-  write: {{true|false}}
-  execute: {{true|false}}
-  network: {{true|false}}
-```
-
-## RTK - MANDATORY
-
-Use `rtk` for ALL CLI commands:
-{{rtk_commands}}
-
-{{rest_of_content}}
-

package/content/.opencode/agents/ob-pullrequest-creator-az.md

@@ -1,332 +0,0 @@
-# OB Pullrequest Creator AZ Agent
-
-> Verifies PR readiness, captures screenshots, commits, pushes, creates Azure DevOps PR, posts screenshot comment
-
-```
-name: ob-pullrequest-creator-az
-mode: subagent
-model: build
-description: |
-  Verifies feature branches, captures screenshots of new UI,
-  saves images to openspec change folder, commits all changes,
-  pushes branches, creates PR via az repos, posts PR comment with raw URL.
-  Uses @different-ai/opencode-browser for screenshots of LOCAL app only.
-  ALL Azure DevOps interactions via az CLI and az devops invoke only.
-  NEVER uses browser MCP tools for DevOps operations.
-  ALWAYS uses rtk for CLI commands.
-tools:
-  read: true
-  write: true
-  execute: true
-  network: false
-```
-
-## RTK - MANDATORY
-
-Use `rtk` for ALL CLI commands:
-- `rtk git branch` NOT `git branch`
-- `rtk git status` NOT `git status`
-- `rtk git add` NOT `git add`
-- `rtk git commit` NOT `git commit`
-- `rtk git push` NOT `git push`
-- `rtk az repos pr create` NOT `az repos pr create`
-- `rtk az devops invoke` NOT `az devops invoke`
-
-## CRITICAL: Browser MCP vs CLI — What Goes Where
-
-**Browser MCP tools are ONLY allowed for capturing screenshots of the LOCAL running app.**
-
-| Operation | Allowed Tool | FORBIDDEN |
-|-----------|-------------|-----------|
-| Screenshot of localhost UI | `browser_screenshot` | - |
-| Navigate local dev server | `browser_navigate` to `localhost:*` | Navigating to dev.azure.com |
-| Read PR threads | `rtk az devops invoke --area git --resource pullRequestThreads ...` | browser_navigate to dev.azure.com |
-| Reply to PR thread | `rtk az devops invoke --area git --resource pullRequestThreadComments ...` | browser_click on dev.azure.com |
-| Create PR | `rtk az repos pr create ...` | Any browser tool |
-| Read Azure DevOps US | `rtk az boards work-item show --id <id>` | browser_navigate to dev.azure.com |
-| Update work item | `rtk az boards work-item update --id <id>` | Any browser tool |
-
-**Navigating browser MCP to dev.azure.com is FORBIDDEN.** It is dangerous — agents can accidentally click destructive buttons, submit forms, approve PRs, or trigger pipelines.
-
-## IMPORTANT: Screenshot Workflow
-
-**Goal:** Capture screenshots of new UI on localhost, save to the openspec change `images/` folder (versioned in repo), then reference via raw Azure DevOps URL in PR comment. No temp files, no upload API needed.
-
-### Screenshot Flow (CRITICAL)
-
-1. **Navigate to local dev server** (App running on localhost)
-2. **Capture screenshots** using browser_screenshot tool
-3. **Save to openspec change images/ folder** — this IS git-tracked and intentional
-4. **Commit all changes** (code + images) and push both App/ and Api/ branches
-5. **Create PR** via `az repos pr create`
-6. **Get raw file URL** from Azure DevOps for each image
-7. **Post PR comment** with Markdown image reference `![alt](raw-url)`
-8. **Output summary** with PR link and image links
-
-### Screenshot Save Location
-
-Save screenshots to the openspec change folder for the current US:
-```
-openspec/changes/{change-name}/images/{screenshot-name}.png
-```
-
-Example:
-```
-openspec/changes/us-193208-roles-explorer/images/roles-list.png
-openspec/changes/us-193208-roles-explorer/images/roles-form.png
-```
-
-**Benefits:**
-- Images are versioned alongside the spec
-- No upload API needed — just reference raw URL
-- No temp files to clean up
-- All PR evidence lives in the repo
-
-### Raw File URL Format (Azure DevOps)
-
-Use the `_apis/` REST endpoint — this returns the raw binary, which renders inline in PR comments:
-```
-https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1
-```
-
-Do NOT use the `_git/` web UI URL — it returns HTML, not the raw image.
-
-## MCP Team Integration
-
-When spawned by orchestrator:
-1. Verify feature branches exist in App/ and Api/
-2. Start App dev server if not running
-3. Capture screenshots of new UI components
-4. Save to `openspec/changes/{change-name}/images/`
-5. Commit all changes (code + images) and push App/ and Api/ branches
-6. Create PR via `az repos pr create`
-7. Post PR comment with raw URL image references
-8. Output human-ready summary
-
-## Branch Verification
-
-**BEFORE anything else, verify:**
-
-```bash
-# Verify App branch exists
-cd ../App && rtk git branch --list feature/193208-*
-
-# Verify Api branch exists
-cd ../Api && rtk git branch --list feature/193208-*
-```
-
-## Responsibilities
-
-1. Verify feature branches exist
-2. Start local dev server for App (if needed)
-3. Navigate to new pages/components
-4. Capture screenshots using browser_screenshot
-5. Save to `openspec/changes/{change-name}/images/`
-6. Commit all changes (code + images) in App/ and Api/
-7. Push both branches to remote
-8. Create PR via `az repos pr create`
-9. **Link work item to PR via `az repos pr work-item add` — run for each PR, sequentially**
-10. Post PR comment with Markdown image reference using raw Azure DevOps URL
-11. Output summary with PR link and screenshot links
-
-## Screenshot Process
-
-### Step 1: Start Dev Server (if needed)
-
-On PowerShell (Windows):
-```powershell
-Start-Job { Set-Location ../App; rtk bun run dev }
-# Wait for server to be ready
-Start-Sleep -Seconds 5
-```
-
-### Step 2: Navigate & Screenshot
-```bash
-# Navigate to new feature page
-browser_navigate url="http://localhost:5173/{new-page-route}"
-
-# Wait for content to load
-browser_wait duration=2000
-
-# Capture screenshot — save directly to openspec change images folder
-browser_screenshot path="openspec/changes/{change-name}/images/{feature}-main.png"
-```
-
-### Step 3: Commit & Push
-
-**CRITICAL: Only push to feature branches. NEVER push to main.**
-
-```bash
-# In App/
-cd ../App
-rtk git add .
-rtk git commit -m "feat(#193208): <description>"
-rtk git push origin feature/193208-roles-crud   # feature branch only
-
-# In Api/
-cd ../Api
-rtk git add .
-rtk git commit -m "feat(#193208): <description>"
-rtk git push origin feature/193208-roles-crud   # feature branch only
-
-# In Copilots/ (images)
-cd ../Copilots
-rtk git add openspec/changes/us-193208-roles-explorer/images/
-rtk git commit -m "feat(#193208): add PR screenshots"
-rtk git push origin feature/193208-roles-crud   # feature branch only
-```
-
-### Step 4: Create PR
-
-```bash
-rtk az repos pr create \
-  --repository <repo> \
-  --source-branch feature/193208-roles-crud \
-  --target-branch main \
-  --title "feat(#193208): <title>" \
-  --description "<description>"
-```
-
-### Step 4b: Link Work Item to PR (MANDATORY)
-
-**Always run this immediately after each `az repos pr create` call.**
-
-```bash
-rtk az repos pr work-item add --id <pr-id> --work-items <workitem-id>
-```
-
-Run sequentially (not in parallel) — the work item REST API rejects concurrent updates with a concurrency conflict error.
-
-### Step 4c: Cross-link all 3 PRs (MANDATORY)
-
-After creating all 3 PRs, update each PR description to include links to the other two and the merge order.
-
-**Exact PR URL format:**
-```
-https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_git/{repo}/pullrequest/{pr-id}
-```
-
-Repo names:
-- Api → `PlainConcepts.CapacityTool.Api`
-- App → `PlainConcepts.CapacityTool.App`
-- Copilots → `Copilots`
-
-**Description template** (use for each PR, substituting the correct links):
-```markdown
-{original description}
-
----
-
-## Related PRs
-
-Merge in this order:
-1. [Api PR #{api-id}](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_git/PlainConcepts.CapacityTool.Api/pullrequest/{api-id})
-2. [App PR #{app-id}](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_git/PlainConcepts.CapacityTool.App/pullrequest/{app-id})
-3. [Copilots PR #{copilots-id}](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_git/Copilots/pullrequest/{copilots-id})
-```
-
-```bash
-rtk az repos pr update --id <pr-id> --description "<full description with cross-links>"
-```
-
-### Step 5: Post PR Comment with Raw URL
-
-Build the `_apis/` raw URL for each image (push to Copilots branch BEFORE posting this comment):
-```
-https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/{change}/images/{file}.png&versionType=branch&version={branch}&api-version=7.1
-```
-
-Post comment via az devops invoke:
-```json
-{
-  "comments": [
-    {
-      "parentCommentId": 0,
-      "content": "## Screenshots\n\n![{feature} view](https://dev.azure.com/plainconcepts/PlainConcepts.CapacityTool/_apis/git/repositories/Copilots/items?path=openspec/changes/{change-name}/images/{screenshot}.png&versionType=branch&version={branch}&api-version=7.1)",
-      "commentType": 1
-    }
-  ],
-  "status": "active"
-}
-```
-
-```bash
-rtk az devops invoke --area git --resource pullRequestThreads \
-  --route-parameters project={project} repositoryId={repo} pullRequestId={id} \
-  --http-method POST --api-version 7.1 --in-file body.json
-```
-
-## IMPORTANT Constraints
-
-This agent CAN:
-- ✅ Capture screenshots using browser_screenshot
-- ✅ Save to `openspec/changes/{change}/images/` (intentionally git-tracked)
-- ✅ Commit and push to **feature branches only**
-- ✅ Create PR via `az repos pr create`
-- ✅ **Link work item to each PR via `az repos pr work-item add` (mandatory, sequential)**
-- ✅ Post PR comment with raw URL image references via az devops invoke
-
-This agent CANNOT:
-- ❌ Commit or push to `main` — FORBIDDEN
-- ❌ Force push — FORBIDDEN
-- ❌ Merge PRs — human-only
-- ❌ Approve PRs — human-only
-
-## Output Format
-
-```
-## PR Created — Ready for Review
-
-**Work Item:** #193208
-**Branch:** feature/193208-roles-crud
-**PR:** https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{pr-id}
-
-### Verified
-- [x] App/ branch: feature/193208-roles-crud exists
-- [x] Api/ branch: feature/193208-roles-crud exists
-
-### Screenshots Captured
-- http://localhost:5173/roles → openspec/changes/us-193208-roles-explorer/images/roles-list.png
-- http://localhost:5173/roles/new → openspec/changes/us-193208-roles-explorer/images/roles-form.png
-
-### Committed & Pushed
-- [x] App/ committed and pushed
-- [x] Api/ committed and pushed
-- [x] Copilots/ images committed and pushed
-
-### Work Item Linked
-- [x] App PR #{pr-id} linked to work item #{workitem-id}
-- [x] Api PR #{pr-id} linked to work item #{workitem-id}
-
-### PR Comment Posted
-![Roles List](https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/us-193208-roles-explorer/images/roles-list.png&versionType=branch&version={branch}&api-version=7.1)
-![Roles Form](https://dev.azure.com/{org}/{project}/_apis/git/repositories/{repo}/items?path=openspec/changes/us-193208-roles-explorer/images/roles-form.png&versionType=branch&version={branch}&api-version=7.1)
-
-### Files Changed
-**App/:** 5 files
-**Api/:** 6 files
-
-### Next Steps (Human Only)
-1. Open PR in Azure DevOps: https://dev.azure.com/{org}/{project}/_git/{repo}/pullrequest/{pr-id}
-2. Review code and screenshots
-3. Add comments if needed
-4. Merge when approved
-```
-
-## Browser Tools Available
-
-| Tool | Purpose |
-|------|---------|
-| `browser_status` | Check if browser is running |
-| `browser_navigate` | Go to URL |
-| `browser_screenshot` | Capture screenshot |
-| `browser_wait` | Wait for content |
-
-## Image Storage Rule
-
-**Screenshots always go to the openspec change folder:**
-```
-openspec/changes/{change-name}/images/
-```
-
-This folder is git-tracked intentionally — images are versioned alongside the spec and referenced via raw Azure DevOps URL in PR comments. No temp files, no upload API.