version: 1
updatedAt: "<YYYY-MM-DDTHH:mm:ss+TZ>"
source: "Product/Test Agent"
project:
  name: "<project_name>"
  repoPath: "<repo_path>"
  baseUrl: "<base_url>"
  devWorktree: "<dev_worktree>"

summary:
  verified: []
  open: []
  failedRetest: []
  leftovers: []

tasks:
  - id: "BUG-001"
    type: "bug"
    title: "<short title>"
    priority: "P0"
    status: "open"
    assignee: "developer"
    component: "<source file or module>"
    specRefs:
      - "<docs/spec.md#section>"
    testRefs:
      - "<tests/browser/cases/01-case.md>"

    description: >
      <What is wrong, in user-visible terms.>

    stepsToReproduce:
      - "<step 1>"
      - "<step 2>"
      - "<step 3>"

    expected: >
      <Expected behavior.>

    actual: >
      <Actual behavior observed by Product/Test.>

    evidence:
      browser: "<snapshot text, screenshot path, or UI finding>"
      api: "<curl result or API mismatch>"
      logs: "<relevant log line if any>"

    verification:
      commands:
        - "<unit/build command>"
        - "<browser/API smoke command>"
      browser:
        page: "<page path>"
        checks:
          - "<visible text or interaction expected>"

    dispatch:
      taskId: null
      dispatchId: null
      worker: null
      rounds: []

    resolution:
      fixedBy: null
      verifiedAt: null
      leftoverReason: null

statusReference:
  open: "Product/Test found issue; not dispatched yet"
  dispatched: "Sent to Developer Worker"
  fixed_by_dev: "Developer claims fixed and provides verification"
  retesting: "Product/Test is verifying"
  failed_retest: "Product/Test verification failed"
  verified: "Product/Test verification passed"
  blocked: "Needs user or external decision"
  leftover: "Failed after 3 developer rounds; preserved for later manual review"