@getarbiter/cli 0.5.0

package/dist/templates/github/issue-templates/task-brief.yml.ejs

@@ -0,0 +1,125 @@
+name: Task Brief
+description: Structured implementation task for AI-assisted development
+labels: ["task"]
+body:
+  - type: textarea
+    id: context
+    attributes:
+      label: "1. Context & Rationale"
+      description: |
+        Why are we doing this task?
+        - What problem does it solve or what value does it deliver?
+        - What must already be in place before starting?
+      placeholder: |
+        This task implements...
+
+        **Pre-conditions:**
+        - [ ] Prerequisite task completed
+    validations:
+      required: true
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: "2. Technical Scope"
+      description: |
+        Detailed breakdown of what needs to change:
+        - Files, modules, APIs, components
+        - Schema or contract changes
+      placeholder: |
+        - Module: `auth`
+        - New file: `src/auth/token-refresh.ts`
+        - Contract: add `refresh_token` field to AuthResponse
+    validations:
+      required: true
+<%_ if (governanceLevel !== 'L1') { _%>
+
+  - type: checkboxes
+    id: invariants
+    attributes:
+      label: "3. Engineering Invariants"
+      description: Confirm which invariants apply to this task
+      options:
+        - label: "Input validation enforced at all boundaries"
+        - label: "No direct coupling to infrastructure (use abstractions)"
+        - label: "TDD followed — tests written before implementation"
+        - label: "No new `any` types introduced (TypeScript projects)"
+        - label: "Error paths handled and tested"
+<%_ } _%>
+
+  - type: checkboxes
+    id: dod
+    attributes:
+      label: "<%- governanceLevel !== 'L1' ? '4.' : '3.' %> Definition of Done"
+      description: Non-negotiable quality gates
+      options:
+        - label: "All tests pass"
+        - label: "Lint and format clean"
+        - label: "CI pipeline green"
+        - label: "Documentation updated if public API changed"
+        - label: "Gate L1 passes locally"
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: "<%- governanceLevel !== 'L1' ? '5.' : '4.' %> Acceptance Criteria"
+      description: |
+        Explicit, stable `AC-N:` ids — acceptance tests and the review FIT rubric cite these verbatim.
+        Use EARS format for precision, or plain prose for simple tasks.
+        - Event-driven: `When <trigger>, the system shall <response>`
+        - Conditional: `If <condition>, then the system shall <response>`
+      placeholder: |
+        - [ ] AC-1: When the user submits the form, the system shall validate all required fields.
+        - [ ] AC-2: If validation fails, the system shall return a 400 with field-level errors.
+    validations:
+      required: true
+
+  - type: textarea
+    id: nongoals
+    attributes:
+      label: "<%- governanceLevel !== 'L1' ? '6.' : '5.' %> Non-Goals"
+      description: What this task deliberately leaves out — the scope-creep guard the reviewer enforces.
+      placeholder: |
+        - No refactor of the adjacent module
+        - No schema migration in this task
+    validations:
+      required: true
+
+  - type: textarea
+    id: testplan
+    attributes:
+      label: "<%- governanceLevel !== 'L1' ? '7.' : '6.' %> Test Plan"
+      description: |
+        Describe scenarios to verify:
+        - Happy path: normal success case
+        - Edge cases: boundaries, errors, failure modes
+      placeholder: |
+        **Happy path:** User provides valid input → success response
+
+        **Edge case:** Missing required field → 400 with field error
+    validations:
+      required: true
+<%_ if (governanceLevel !== 'L1') { _%>
+
+  - type: textarea
+    id: forbidden
+    attributes:
+      label: "8. Forbidden Patterns"
+      description: Explicit rules this task must NOT violate.
+      placeholder: |
+        - Must NOT introduce global state
+        - Must NOT bypass the existing auth middleware
+        - Must NOT use raw SQL (use the query builder)
+<%_ } _%>
+
+  - type: dropdown
+    id: size
+    attributes:
+      label: Estimated Size
+      options:
+        - "XS (< 30 min)"
+        - "S (30 min — 2 hours)"
+        - "M (2 — 8 hours)"
+        - "L (1 — 3 days)"
+    validations:
+      required: true

package/dist/templates/github/labels.yml.ejs

@@ -0,0 +1,161 @@
+# Canonical label list — managed by arbiter
+# Sync to repo: push to main triggers _label-sync workflow
+labels:
+  # Task size
+  - name: "size: XS"
+    color: "ededed"
+    description: "Extra small: trivial change (< 30 min)"
+  - name: "size: S"
+    color: "ededed"
+    description: "Small: straightforward task (< 2 h)"
+  - name: "size: Standard"
+    color: "ededed"
+    description: "Standard: typical task (< 1 day)"
+  # AI governance
+  - name: approved-by-human
+    color: "0e8a16"
+    description: "PR approved by a human reviewer distinct from the author"
+  # CI tier
+  - name: "tier: T2"
+    color: "e4e669"
+    description: "Affects T2 PR gate workflows"
+  - name: "tier: T3"
+    color: "e4e669"
+    description: "Affects T3 release workflows"
+  - name: "tier: T4"
+    color: "e4e669"
+    description: "Affects T4/T5 nightly/weekly/heartbeat workflows"
+  # Heartbeat alerts
+  - name: heartbeat-nightly-missed
+    color: "d93f0b"
+    description: "Nightly workflow missed its freshness window"
+  - name: heartbeat-weekly-missed
+    color: "d93f0b"
+    description: "Weekly workflow missed its freshness window"
+  - name: heartbeat-monthly-missed
+    color: "d93f0b"
+    description: "Monthly workflow missed its freshness window"
+  # Regression issues filed by scheduled workflows
+  - name: kit-drift
+    color: "0075ca"
+    description: "KIT self-canary failure detected"
+  - name: probe-writer-drift
+    color: "b60205"
+    description: "probe≠writer alignment mismatch detected by the weekly audit (#1707)"
+  - name: nightly-regression
+    color: "b60205"
+    description: "Nightly (T4) workflow detected a regression"
+  - name: weekly-regression
+    color: "b60205"
+    description: "Weekly (T5) workflow detected a regression"
+  - name: monthly-regression
+    color: "b60205"
+    description: "Monthly (T5b) workflow detected a regression"
+  - name: generator-matrix-regression
+    color: "b60205"
+    description: "Generator Matrix workflow detected a regression (#1840 F4 tranche 2)"
+  # Tracks (track model — docs/internal/METHOD/PROCESS.md)
+  - name: "track: core"
+    color: "cccccc"
+    description: "Track: TypeScript sources under src/ shipped in the built CLI"
+  - name: "track: templates"
+    color: "cccccc"
+    description: "Track: EJS templates and materialized .claude/.github/.agents/.codex/ outputs"
+  - name: "track: kit"
+    color: "cccccc"
+    description: "Track: tool catalog, archetype manifests, language matrices, adapter coverage"
+  - name: "track: docs"
+    color: "cccccc"
+    description: "Track: hand-authored Markdown under docs/ and root-level docs"
+  - name: "track: ci"
+    color: "cccccc"
+    description: "Track: GitHub Actions workflows, composite actions, CI-tier templates"
+  - name: "track: meta"
+    color: "cccccc"
+    description: "Track: scripts, hooks, gate script, evidence bundles, repo-level config"
+  # Lifecycle
+  - name: tech-debt
+    color: "d93f0b"
+    description: "Tracked technical debt item"
+  - name: follow-up
+    color: "fbca04"
+    description: "Requires follow-up in a subsequent issue"
+  - name: blocked
+    color: "e11d48"
+    description: "Blocked on external dependency or decision"
+  # Issue & PR state (consumed by issue-state.yml + _pr-staleness.yml automation, #1131)
+  - name: in-progress
+    color: "1d76db"
+    description: "Work in progress; set manually, removed by issue-state on PR open"
+  - name: in-review
+    color: "fbca04"
+    description: "PR open and under review; set by issue-state on PR open, removed on close"
+  - name: stale
+    color: "795548"
+    description: "No activity within the staleness window; managed by _pr-staleness"
+  - name: no-stale
+    color: "0e8a16"
+    description: "Exempts a PR from staleness sweeps; read as a gate by _pr-staleness"
+  - name: governance
+    color: "5319e7"
+    description: "Governance/compliance tracking; applied by the compliance-item issue template"
+<% if (locals.kitEnabled) { -%>
+  # Quality program (kit-install)
+  - name: quality
+    color: "7057ff"
+    description: "Quality program item"
+  - name: deferred
+    color: "fbca04"
+    description: "Deferred to future wave"
+  - name: needs-info
+    color: "d876e3"
+    description: "Needs more information"
+  - name: bug
+    color: "d73a4a"
+    description: "Something isn't working"
+  - name: enhancement
+    color: "a2eeef"
+    description: "New feature or request"
+  - name: chore
+    color: "ededed"
+    description: "Maintenance task"
+  - name: documentation
+    color: "0075ca"
+    description: "Documentation improvements"
+  - name: compliance
+    color: "5319e7"
+    description: "ISO/regulatory compliance"
+  - name: security
+    color: "b60205"
+    description: "Security issue or improvement"
+  - name: performance
+    color: "ff6600"
+    description: "Performance improvement"
+  - name: breaking-change
+    color: "e11d48"
+    description: "Breaking change"
+  - name: P0
+    color: "b60205"
+    description: "Critical priority"
+  - name: P1
+    color: "d93f0b"
+    description: "High priority"
+  - name: P2
+    color: "fbca04"
+    description: "Medium priority"
+  - name: duplicate
+    color: "cfd3d7"
+    description: "Duplicate issue"
+  - name: wontfix
+    color: "ffffff"
+    description: "Will not fix"
+  - name: good first issue
+    color: "7057ff"
+    description: "Good for newcomers"
+  - name: help wanted
+    color: "008672"
+    description: "Extra attention needed"
+  - name: invalid
+    color: "e4e669"
+    description: "Not valid"
+<% } -%>

package/dist/templates/github/scripts/sticky-failure-issue.sh.ejs

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# SPDX-License-Identifier: Apache-2.0
+# A6 (#1817): sticky failure issue — one open issue per scheduled lane tracks
+# a red streak; each failed run appends a comment + counter instead of filing
+# a new issue (the anti-pattern measured on a real project: ~20 duplicate
+# auto-filed issues, zero action taken). A green run auto-closes it.
+#
+# Usage: sticky-failure-issue.sh <record|close> <lane>
+#   record  — find-or-create the sticky issue for <lane>, append a comment
+#             with the run link and an incremented failure counter.
+#   close   — close the sticky issue for <lane> (if open), commenting the
+#             run link that went green.
+#
+# Requires: GH_TOKEN (or GITHUB_TOKEN) + RUN_URL env vars, `gh` CLI on PATH.
+set -euo pipefail
+
+MODE="${1:?usage: sticky-failure-issue.sh <record|close> <lane>}"
+LANE="${2:?usage: sticky-failure-issue.sh <record|close> <lane>}"
+RUN_URL="${RUN_URL:?RUN_URL env var required}"
+
+TITLE="chore(${LANE}): pipeline red"
+
+find_open_issue() {
+  gh issue list --search "\"${TITLE}\" in:title" --state open \
+    --json number,title --jq ".[] | select(.title == \"${TITLE}\") | .number" | head -1
+}
+
+case "$MODE" in
+  record)
+    ISSUE_NUMBER=$(find_open_issue)
+
+    if [[ -z "$ISSUE_NUMBER" ]]; then
+      BODY_TEXT=$(printf '## %s pipeline red\n\nSticky tracking issue for %s failures. Stays open while %s is red; each failed run appends a comment below with the run link and a failure counter. Auto-closed on the next green run.\n\n**First failure:** %s\n**Run:** %s\n' \
+        "$LANE" "$LANE" "$LANE" "$(date -u +%Y-%m-%d)" "$RUN_URL")
+      ISSUE_URL=$(gh issue create --title "$TITLE" --label "type:chore,scope:ci,status:ready" --body "$BODY_TEXT")
+      ISSUE_NUMBER="${ISSUE_URL##*/}"
+      echo "Created sticky issue #${ISSUE_NUMBER} for lane ${LANE}"
+    else
+      echo "Found existing sticky issue #${ISSUE_NUMBER} for lane ${LANE}"
+    fi
+
+    COUNT=$(gh issue view "$ISSUE_NUMBER" --json comments \
+      --jq '[.comments[].body | select(test("^Run: "))] | length')
+    COUNT=$((COUNT + 1))
+    COMMENT_BODY=$(printf 'Run: %s\nFailure #%s on this red streak (%s).' "$RUN_URL" "$COUNT" "$(date -u +%Y-%m-%dT%H:%M:%SZ)")
+    gh issue comment "$ISSUE_NUMBER" --body "$COMMENT_BODY"
+    ;;
+  close)
+    ISSUE_NUMBER=$(find_open_issue)
+    if [[ -n "$ISSUE_NUMBER" ]]; then
+      gh issue close "$ISSUE_NUMBER" --comment "${LANE} green again: ${RUN_URL}"
+      echo "Closed sticky issue #${ISSUE_NUMBER} for lane ${LANE}"
+    else
+      echo "No open sticky issue for lane ${LANE} to close"
+    fi
+    ;;
+  *)
+    echo "Unknown mode: $MODE (expected 'record' or 'close')" >&2
+    exit 1
+    ;;
+esac