chief-clancy 0.2.0-beta.3 → 0.3.0

package/src/workflows/scaffold.md

@@ -290,1044 +290,33 @@ node_modules/
 
 ---
 
-## Shell scripts
+## JS shim scripts
 
 Write these scripts exactly as shown — do not generate, summarise, or modify the content. Write the file contents byte-for-byte.
 
-### `.clancy/clancy-once.sh` — Jira
-
-Write this file when the chosen board is **Jira**:
+The shims are **board-agnostic** — the same files are used for all boards. Board detection happens at runtime from `.clancy/.env`.
 
+**Prerequisite:** Ensure `chief-clancy` is installed as a devDependency before writing these shims:
 ```bash
-#!/usr/bin/env bash
-# Strict mode: exit on error (-e), undefined variables (-u), pipe failures (-o pipefail).
-# This means any command that fails will stop the script immediately rather than silently continuing.
-set -euo pipefail
-
-# Parse flags — must happen before preflight so --dry-run works without side effects.
-DRY_RUN=false
-for arg in "$@"; do
-  case "$arg" in
-    --dry-run) DRY_RUN=true ;;
-  esac
-done
-readonly DRY_RUN
-
-# ─── WHAT THIS SCRIPT DOES ─────────────────────────────────────────────────────
-#
-# Board: Jira
-#
-# 1. Preflight — checks all required tools, credentials, and board reachability
-# 2. Fetch    — pulls the next assigned "To Do" ticket from Jira (maxResults: 1)
-# 3. Branch   — creates a feature branch from the ticket's epic branch (or base branch)
-# 4. Implement — passes the ticket to Claude Code, which reads .clancy/docs/ and implements it
-# 5. Merge    — squash-merges the feature branch back into the target branch
-# 6. Log      — appends a completion entry to .clancy/progress.txt
-#
-# This script is run once per ticket. The loop is handled by clancy-afk.sh.
-#
-# NOTE: This file has no -jira suffix by design. /clancy:init copies the correct
-# board variant into the user's .clancy/ directory as clancy-once.sh regardless
-# of board. The board is determined by which template was copied, not the filename.
-#
-# NOTE: Failures use exit 0, not exit 1. This is intentional — clancy-afk.sh
-# detects stop conditions by reading script output rather than exit codes, so a
-# non-zero exit would be treated as an unexpected crash rather than a clean stop.
-#
-# ───────────────────────────────────────────────────────────────────────────────
-
-# ─── PREFLIGHT ─────────────────────────────────────────────────────────────────
-
-command -v claude >/dev/null 2>&1 || {
-  echo "✗ claude CLI not found."
-  echo "  Install it: https://claude.ai/code"
-  exit 0
-}
-command -v jq >/dev/null 2>&1 || {
-  echo "✗ jq not found."
-  echo "  Install: brew install jq  (mac) | apt install jq  (linux)"
-  exit 0
-}
-command -v curl >/dev/null 2>&1 || {
-  echo "✗ curl not found. Install curl for your OS."
-  exit 0
-}
-
-[ -f .clancy/.env ] || {
-  echo "✗ .clancy/.env not found."
-  echo "  Copy .clancy/.env.example to .clancy/.env and fill in your credentials."
-  echo "  Then run: /clancy:init"
-  exit 0
-}
-# shellcheck source=/dev/null
-source .clancy/.env
-
-git rev-parse --git-dir >/dev/null 2>&1 || {
-  echo "✗ Not a git repository."
-  echo "  Clancy must be run from the root of a git project."
-  exit 0
-}
-
-if ! git diff --quiet || ! git diff --cached --quiet; then
-  echo "⚠ Working directory has uncommitted changes."
-  echo "  Consider stashing or committing first to avoid confusion."
-fi
-
-[ -n "${JIRA_BASE_URL:-}"    ] || { echo "✗ JIRA_BASE_URL is not set in .clancy/.env";    exit 0; }
-[ -n "${JIRA_USER:-}"        ] || { echo "✗ JIRA_USER is not set in .clancy/.env";        exit 0; }
-[ -n "${JIRA_API_TOKEN:-}"   ] || { echo "✗ JIRA_API_TOKEN is not set in .clancy/.env";   exit 0; }
-[ -n "${JIRA_PROJECT_KEY:-}" ] || { echo "✗ JIRA_PROJECT_KEY is not set in .clancy/.env"; exit 0; }
-if ! echo "$JIRA_PROJECT_KEY" | grep -qE '^[A-Z][A-Z0-9]+$'; then
-  echo "✗ JIRA_PROJECT_KEY format is invalid. Expected uppercase letters and numbers only (e.g. PROJ, ENG2). Check JIRA_PROJECT_KEY in .clancy/.env."
-  exit 0
-fi
-
-PING=$(curl -s -o /dev/null -w "%{http_code}" \
-  -u "$JIRA_USER:$JIRA_API_TOKEN" \
-  "$JIRA_BASE_URL/rest/api/3/project/$JIRA_PROJECT_KEY")
-
-case "$PING" in
-  200) ;;
-  401) echo "✗ Jira authentication failed. Check JIRA_USER and JIRA_API_TOKEN in .clancy/.env."; exit 0 ;;
-  403) echo "✗ Jira access denied. Your token may lack Browse Projects permission."; exit 0 ;;
-  404) echo "✗ Jira project '$JIRA_PROJECT_KEY' not found. Check JIRA_PROJECT_KEY in .clancy/.env."; exit 0 ;;
-  000) echo "✗ Could not reach Jira at $JIRA_BASE_URL. Check JIRA_BASE_URL and your network."; exit 0 ;;
-  *)   echo "✗ Jira returned unexpected status $PING. Check your config."; exit 0 ;;
-esac
-
-if [ "${PLAYWRIGHT_ENABLED:-}" = "true" ]; then
-  if lsof -ti:"${PLAYWRIGHT_DEV_PORT:-5173}" >/dev/null 2>&1; then
-    echo "⚠ Port ${PLAYWRIGHT_DEV_PORT:-5173} is already in use."
-    echo "  Clancy will attempt to start the dev server on this port."
-    echo "  If visual checks fail, stop whatever is using the port first."
-  fi
-fi
-
-echo "✓ Preflight passed. Starting Clancy..."
-
-# ─── END PREFLIGHT ─────────────────────────────────────────────────────────────
-
-# ─── FETCH TICKET ──────────────────────────────────────────────────────────────
-
-# Validate user-controlled values to prevent JQL injection.
-# JQL does not support parameterised queries, so we restrict to safe characters.
-if [ -n "${CLANCY_LABEL:-}" ] && ! echo "$CLANCY_LABEL" | grep -qE '^[a-zA-Z0-9 _-]+$'; then
-  echo "✗ CLANCY_LABEL contains invalid characters. Use only letters, numbers, spaces, hyphens, and underscores."
-  exit 0
-fi
-if ! echo "${CLANCY_JQL_STATUS:-To Do}" | grep -qE '^[a-zA-Z0-9 _-]+$'; then
-  echo "✗ CLANCY_JQL_STATUS contains invalid characters. Use only letters, numbers, spaces, hyphens, and underscores."
-  exit 0
-fi
-
-# Build JQL — sprint filter is optional (requires Jira Software license).
-# Uses the /rest/api/3/search/jql POST endpoint — the old GET /search was removed Aug 2025.
-# maxResults:1 is intentional — pick one ticket per run, never paginate.
-if [ -n "${CLANCY_JQL_SPRINT:-}" ]; then
-  SPRINT_CLAUSE="AND sprint in openSprints()"
-else
-  SPRINT_CLAUSE=""
-fi
-
-# Optional label filter — set CLANCY_LABEL in .env to only pick up tickets with that label.
-# Useful for mixed backlogs where not every ticket is suitable for autonomous implementation.
-if [ -n "${CLANCY_LABEL:-}" ]; then
-  LABEL_CLAUSE="AND labels = \"$CLANCY_LABEL\""
-else
-  LABEL_CLAUSE=""
-fi
-
-RESPONSE=$(curl -s \
-  -u "$JIRA_USER:$JIRA_API_TOKEN" \
-  -X POST \
-  -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
-  "$JIRA_BASE_URL/rest/api/3/search/jql" \
-  -d "{
-    \"jql\": \"project=$JIRA_PROJECT_KEY $SPRINT_CLAUSE $LABEL_CLAUSE AND assignee=currentUser() AND status=\\\"${CLANCY_JQL_STATUS:-To Do}\\\" ORDER BY priority ASC\",
-    \"maxResults\": 1,
-    \"fields\": [\"summary\", \"description\", \"issuelinks\", \"parent\", \"customfield_10014\"]
-  }")
-
-# New endpoint returns { "issues": [...], "isLast": bool } — no .total field
-ISSUE_COUNT=$(echo "$RESPONSE" | jq '.issues | length')
-if [ "$ISSUE_COUNT" -eq 0 ]; then
-  echo "No tickets found. All done!"
-  exit 0
-fi
-
-TICKET_KEY=$(echo "$RESPONSE" | jq -r '.issues[0].key')
-SUMMARY=$(echo "$RESPONSE" | jq -r '.issues[0].fields.summary')
-
-# Extract description via recursive ADF walk
-DESCRIPTION=$(echo "$RESPONSE" | jq -r '
-  .issues[0].fields.description
-  | .. | strings
-  | select(length > 0)
-  | . + "\n"
-' 2>/dev/null || echo "No description")
-
-# Extract epic — try parent first (next-gen), fall back to customfield_10014 (classic)
-EPIC_INFO=$(echo "$RESPONSE" | jq -r '
-  .issues[0].fields.parent.key // .issues[0].fields.customfield_10014 // "none"
-')
-
-# Extract blocking issue links
-BLOCKERS=$(echo "$RESPONSE" | jq -r '
-  [.issues[0].fields.issuelinks[]?
-    | select(.type.name == "Blocks" and .inwardIssue?)
-    | .inwardIssue.key]
-  | if length > 0 then "Blocked by: " + join(", ") else "None" end
-' 2>/dev/null || echo "None")
-
-BASE_BRANCH="${CLANCY_BASE_BRANCH:-main}"
-TICKET_BRANCH="feature/$(echo "$TICKET_KEY" | tr '[:upper:]' '[:lower:]')"
-
-# Auto-detect target branch from ticket's parent epic.
-# If the ticket has a parent epic, branch from epic/{epic-key} (creating it from
-# BASE_BRANCH if it doesn't exist yet). Otherwise branch from BASE_BRANCH directly.
-if [ "$EPIC_INFO" != "none" ]; then
-  TARGET_BRANCH="epic/$(echo "$EPIC_INFO" | tr '[:upper:]' '[:lower:]')"
-else
-  TARGET_BRANCH="$BASE_BRANCH"
-fi
-
-# ─── DRY RUN ───────────────────────────────────────────────────────────────────
-
-if [ "$DRY_RUN" = "true" ]; then
-  echo ""
-  echo "── Dry run ──────────────────────────────────────"
-  echo "  Ticket:         [$TICKET_KEY] $SUMMARY"
-  echo "  Epic:           $EPIC_INFO"
-  echo "  Blockers:       $BLOCKERS"
-  echo "  Target branch:  $TARGET_BRANCH"
-  echo "  Feature branch: $TICKET_BRANCH"
-  echo "─────────────────────────────────────────────────"
-  echo "  No changes made. Remove --dry-run to run for real."
-  exit 0
-fi
-
-# ─── IMPLEMENT ─────────────────────────────────────────────────────────────────
-
-echo "Picking up: [$TICKET_KEY] $SUMMARY"
-echo "Epic: $EPIC_INFO | Target branch: $TARGET_BRANCH | Blockers: $BLOCKERS"
-
-git show-ref --verify --quiet "refs/heads/$TARGET_BRANCH" \
-  || git checkout -b "$TARGET_BRANCH" "$BASE_BRANCH"
-git checkout "$TARGET_BRANCH"
-# -B creates the branch if it doesn't exist, or resets it to HEAD if it does.
-# This handles retries cleanly without failing on an already-existing branch.
-git checkout -B "$TICKET_BRANCH"
-
-# Transition ticket to In Progress (best-effort — never fails the run)
-if [ -n "${CLANCY_STATUS_IN_PROGRESS:-}" ]; then
-  TRANSITIONS=$(curl -s \
-    -u "$JIRA_USER:$JIRA_API_TOKEN" \
-    -H "Accept: application/json" \
-    "$JIRA_BASE_URL/rest/api/3/issue/$TICKET_KEY/transitions")
-  IN_PROGRESS_ID=$(echo "$TRANSITIONS" | jq -r \
-    --arg name "$CLANCY_STATUS_IN_PROGRESS" \
-    '.transitions[] | select(.name == $name) | .id' | head -1)
-  if [ -n "$IN_PROGRESS_ID" ]; then
-    curl -s -X POST \
-      -u "$JIRA_USER:$JIRA_API_TOKEN" \
-      -H "Content-Type: application/json" \
-      "$JIRA_BASE_URL/rest/api/3/issue/$TICKET_KEY/transitions" \
-      -d "$(jq -n --arg id "$IN_PROGRESS_ID" '{"transition":{"id":$id}}')" >/dev/null 2>&1 || true
-    echo "  → Transitioned to $CLANCY_STATUS_IN_PROGRESS"
-  fi
-fi
-
-PROMPT="You are implementing Jira ticket $TICKET_KEY.
-
-Summary: $SUMMARY
-Epic: $EPIC_INFO
-Blockers: $BLOCKERS
-
-Description:
-$DESCRIPTION
-
-Step 0 — Executability check (do this before any git or file operation):
-Read the ticket summary and description above. Can this ticket be implemented entirely
-as a code change committed to this repo? Consult the 'Executability check' section of
-CLAUDE.md for the full list of skip conditions.
-
-If you must SKIP this ticket:
-1. Output: ⚠ Skipping [$TICKET_KEY]: {one-line reason}
-2. Output: Ticket skipped — update it to be codebase-only work, then re-run.
-3. Append to .clancy/progress.txt: YYYY-MM-DD HH:MM | $TICKET_KEY | SKIPPED | {reason}
-4. Stop — no branches, no file changes, no git operations.
-
-If the ticket IS implementable, continue:
-1. Read core docs in .clancy/docs/: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, GIT.md, DEFINITION-OF-DONE.md, CONCERNS.md
-   Also read if relevant to this ticket: INTEGRATIONS.md (external APIs/services/auth), TESTING.md (tests/specs/coverage), DESIGN-SYSTEM.md (UI/components/styles), ACCESSIBILITY.md (accessibility/ARIA/WCAG)
-2. Follow the conventions in GIT.md exactly
-3. Implement the ticket fully
-4. Commit your work following the conventions in GIT.md
-5. When done, confirm you are finished."
-
-CLAUDE_ARGS=(--dangerously-skip-permissions)
-[ -n "${CLANCY_MODEL:-}" ] && CLAUDE_ARGS+=(--model "$CLANCY_MODEL")
-echo "$PROMPT" | claude "${CLAUDE_ARGS[@]}"
-
-# ─── MERGE & LOG ───────────────────────────────────────────────────────────────
-
-# Squash all commits from the feature branch into a single commit on the target branch.
-git checkout "$TARGET_BRANCH"
-git merge --squash "$TICKET_BRANCH"
-if git diff --cached --quiet; then
-  echo "⚠ No changes staged after squash merge. Claude may not have committed any work."
-else
-  git commit -m "feat($TICKET_KEY): $SUMMARY"
-fi
-
-# Delete ticket branch locally (never push deletes)
-git branch -d "$TICKET_BRANCH"
-
-# Transition ticket to Done (best-effort — never fails the run)
-if [ -n "${CLANCY_STATUS_DONE:-}" ]; then
-  TRANSITIONS=$(curl -s \
-    -u "$JIRA_USER:$JIRA_API_TOKEN" \
-    -H "Accept: application/json" \
-    "$JIRA_BASE_URL/rest/api/3/issue/$TICKET_KEY/transitions")
-  DONE_ID=$(echo "$TRANSITIONS" | jq -r \
-    --arg name "$CLANCY_STATUS_DONE" \
-    '.transitions[] | select(.name == $name) | .id' | head -1)
-  if [ -n "$DONE_ID" ]; then
-    curl -s -X POST \
-      -u "$JIRA_USER:$JIRA_API_TOKEN" \
-      -H "Content-Type: application/json" \
-      "$JIRA_BASE_URL/rest/api/3/issue/$TICKET_KEY/transitions" \
-      -d "$(jq -n --arg id "$DONE_ID" '{"transition":{"id":$id}}')" >/dev/null 2>&1 || true
-    echo "  → Transitioned to $CLANCY_STATUS_DONE"
-  fi
-fi
-
-# Log progress
-echo "$(date '+%Y-%m-%d %H:%M') | $TICKET_KEY | $SUMMARY | DONE" >> .clancy/progress.txt
-
-echo "✓ $TICKET_KEY complete."
-
-# Send completion notification if webhook is configured
-if [ -n "${CLANCY_NOTIFY_WEBHOOK:-}" ]; then
-  NOTIFY_MSG="✓ Clancy completed [$TICKET_KEY] $SUMMARY"
-  if echo "$CLANCY_NOTIFY_WEBHOOK" | grep -q "hooks.slack.com"; then
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"text": $text}')" >/dev/null 2>&1 || true
-  else
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","body":[{"type":"TextBlock","text":$text}]}}]}')" >/dev/null 2>&1 || true
-  fi
-fi
+npm install --save-dev chief-clancy
 ```
 
----
-
-### `.clancy/clancy-once.sh` — GitHub Issues
-
-Write this file when the chosen board is **GitHub Issues**:
-
-```bash
-#!/usr/bin/env bash
-# Strict mode: exit on error (-e), undefined variables (-u), pipe failures (-o pipefail).
-# This means any command that fails will stop the script immediately rather than silently continuing.
-set -euo pipefail
-
-# Parse flags — must happen before preflight so --dry-run works without side effects.
-DRY_RUN=false
-for arg in "$@"; do
-  case "$arg" in
-    --dry-run) DRY_RUN=true ;;
-  esac
-done
-readonly DRY_RUN
-
-# ─── WHAT THIS SCRIPT DOES ─────────────────────────────────────────────────────
-#
-# Board: GitHub Issues
-#
-# 1. Preflight  — checks all required tools, credentials, and repo reachability
-# 2. Fetch      — pulls the next open issue with the 'clancy' label assigned to you
-# 3. Branch     — creates a feature branch from the issue's milestone branch (or base branch)
-# 4. Implement  — passes the issue to Claude Code, which reads .clancy/docs/ and implements it
-# 5. Merge      — squash-merges the feature branch back into the target branch
-# 6. Close      — marks the GitHub issue as closed via the API
-# 7. Log        — appends a completion entry to .clancy/progress.txt
-#
-# This script is run once per issue. The loop is handled by clancy-afk.sh.
-#
-# NOTE: GitHub's /issues endpoint returns pull requests too. This script filters
-# them out by checking for the presence of the 'pull_request' key in each result.
-#
-# NOTE: Failures use exit 0, not exit 1. This is intentional — clancy-afk.sh
-# detects stop conditions by reading script output rather than exit codes, so a
-# non-zero exit would be treated as an unexpected crash rather than a clean stop.
-#
-# ───────────────────────────────────────────────────────────────────────────────
-
-# ─── PREFLIGHT ─────────────────────────────────────────────────────────────────
-
-command -v claude >/dev/null 2>&1 || {
-  echo "✗ claude CLI not found."
-  echo "  Install it: https://claude.ai/code"
-  exit 0
-}
-command -v jq >/dev/null 2>&1 || {
-  echo "✗ jq not found."
-  echo "  Install: brew install jq  (mac) | apt install jq  (linux)"
-  exit 0
-}
-command -v curl >/dev/null 2>&1 || {
-  echo "✗ curl not found. Install curl for your OS."
-  exit 0
-}
-
-[ -f .clancy/.env ] || {
-  echo "✗ .clancy/.env not found."
-  echo "  Copy .clancy/.env.example to .clancy/.env and fill in your credentials."
-  echo "  Then run: /clancy:init"
-  exit 0
-}
-# shellcheck source=/dev/null
-source .clancy/.env
-
-git rev-parse --git-dir >/dev/null 2>&1 || {
-  echo "✗ Not a git repository."
-  echo "  Clancy must be run from the root of a git project."
-  exit 0
-}
-
-if ! git diff --quiet || ! git diff --cached --quiet; then
-  echo "⚠ Working directory has uncommitted changes."
-  echo "  Consider stashing or committing first to avoid confusion."
-fi
-
-[ -n "${GITHUB_TOKEN:-}"  ] || { echo "✗ GITHUB_TOKEN is not set in .clancy/.env";  exit 0; }
-[ -n "${GITHUB_REPO:-}"   ] || { echo "✗ GITHUB_REPO is not set in .clancy/.env";   exit 0; }
-
-# Validate GITHUB_REPO format — must be owner/repo with safe characters only
-if ! echo "$GITHUB_REPO" | grep -qE '^[a-zA-Z0-9_.-]+/[a-zA-Z0-9_.-]+$'; then
-  echo "✗ GITHUB_REPO format is invalid. Expected owner/repo (e.g. acme/my-app). Check GITHUB_REPO in .clancy/.env."
-  exit 0
-fi
-
-PING=$(curl -s -o /dev/null -w "%{http_code}" \
-  -H "Authorization: Bearer $GITHUB_TOKEN" \
-  -H "X-GitHub-Api-Version: 2022-11-28" \
-  "https://api.github.com/repos/$GITHUB_REPO")
-
-case "$PING" in
-  200) ;;
-  401) echo "✗ GitHub authentication failed. Check GITHUB_TOKEN in .clancy/.env."; exit 0 ;;
-  403) echo "✗ GitHub access denied. Your token may lack the repo scope."; exit 0 ;;
-  404) echo "✗ GitHub repo '$GITHUB_REPO' not found. Check GITHUB_REPO in .clancy/.env."; exit 0 ;;
-  000) echo "✗ Could not reach GitHub. Check your network."; exit 0 ;;
-  *)   echo "✗ GitHub returned unexpected status $PING. Check your config."; exit 0 ;;
-esac
-
-if [ "${PLAYWRIGHT_ENABLED:-}" = "true" ]; then
-  if lsof -ti:"${PLAYWRIGHT_DEV_PORT:-5173}" >/dev/null 2>&1; then
-    echo "⚠ Port ${PLAYWRIGHT_DEV_PORT:-5173} is already in use."
-    echo "  If visual checks fail, stop whatever is using the port first."
-  fi
-fi
-
-echo "✓ Preflight passed. Starting Clancy..."
-
-# ─── END PREFLIGHT ─────────────────────────────────────────────────────────────
-
-# ─── FETCH ISSUE ───────────────────────────────────────────────────────────────
-
-# Fetch open issues assigned to the authenticated user with the 'clancy' label.
-# GitHub's issues endpoint returns PRs too — filter them out by checking for pull_request key.
-# per_page=3 so we can find one real issue even if the first result(s) are PRs.
-RESPONSE=$(curl -s \
-  -H "Authorization: Bearer $GITHUB_TOKEN" \
-  -H "X-GitHub-Api-Version: 2022-11-28" \
-  "https://api.github.com/repos/$GITHUB_REPO/issues?state=open&assignee=@me&labels=clancy&per_page=3")
-
-# Verify response is an array before parsing (guards against error objects on rate limit / transient failure)
-if ! echo "$RESPONSE" | jq -e 'type == "array"' >/dev/null 2>&1; then
-  ERR_MSG=$(echo "$RESPONSE" | jq -r '.message // "Unexpected response"' 2>/dev/null || echo "Unexpected response")
-  echo "✗ GitHub API error: $ERR_MSG. Check GITHUB_TOKEN in .clancy/.env."
-  exit 0
-fi
-
-# Filter out PRs and take first real issue
-ISSUE=$(echo "$RESPONSE" | jq 'map(select(has("pull_request") | not)) | .[0]')
-
-if [ "$(echo "$ISSUE" | jq 'type')" = '"null"' ] || [ -z "$(echo "$ISSUE" | jq -r '.number // empty')" ]; then
-  echo "No issues found. All done!"
-  exit 0
-fi
-
-ISSUE_NUMBER=$(echo "$ISSUE" | jq -r '.number')
-TITLE=$(echo "$ISSUE" | jq -r '.title')
-BODY=$(echo "$ISSUE" | jq -r '.body // "No description"')
-MILESTONE=$(echo "$ISSUE" | jq -r '.milestone.title // "none"')
-
-BASE_BRANCH="${CLANCY_BASE_BRANCH:-main}"
-TICKET_BRANCH="feature/issue-${ISSUE_NUMBER}"
-
-# GitHub has no native epic concept — use milestone as the grouping signal.
-# If the issue has a milestone, branch from milestone/{slug} (creating it from
-# BASE_BRANCH if it doesn't exist yet). Otherwise branch from BASE_BRANCH directly.
-if [ "$MILESTONE" != "none" ]; then
-  MILESTONE_SLUG=$(echo "$MILESTONE" | tr '[:upper:]' '[:lower:]' | tr ' ' '-' | tr -cd '[:alnum:]-')
-  TARGET_BRANCH="milestone/${MILESTONE_SLUG}"
-else
-  TARGET_BRANCH="$BASE_BRANCH"
-fi
-
-# ─── DRY RUN ───────────────────────────────────────────────────────────────────
-
-if [ "$DRY_RUN" = "true" ]; then
-  echo ""
-  echo "── Dry run ──────────────────────────────────────"
-  echo "  Issue:          [#${ISSUE_NUMBER}] $TITLE"
-  echo "  Milestone:      $MILESTONE"
-  echo "  Target branch:  $TARGET_BRANCH"
-  echo "  Feature branch: $TICKET_BRANCH"
-  echo "─────────────────────────────────────────────────"
-  echo "  No changes made. Remove --dry-run to run for real."
-  exit 0
-fi
-
-# ─── IMPLEMENT ─────────────────────────────────────────────────────────────────
-
-echo "Picking up: [#${ISSUE_NUMBER}] $TITLE"
-echo "Milestone: $MILESTONE | Target branch: $TARGET_BRANCH"
-
-git show-ref --verify --quiet "refs/heads/$TARGET_BRANCH" \
-  || git checkout -b "$TARGET_BRANCH" "$BASE_BRANCH"
-git checkout "$TARGET_BRANCH"
-# -B creates the branch if it doesn't exist, or resets it to HEAD if it does.
-# This handles retries cleanly without failing on an already-existing branch.
-git checkout -B "$TICKET_BRANCH"
-
-PROMPT="You are implementing GitHub Issue #${ISSUE_NUMBER}.
-
-Title: $TITLE
-Milestone: $MILESTONE
-
-Description:
-$BODY
-
-Step 0 — Executability check (do this before any git or file operation):
-Read the issue title and description above. Can this issue be implemented entirely
-as a code change committed to this repo? Consult the 'Executability check' section of
-CLAUDE.md for the full list of skip conditions.
-
-If you must SKIP this issue:
-1. Output: ⚠ Skipping [#${ISSUE_NUMBER}]: {one-line reason}
-2. Output: Ticket skipped — update it to be codebase-only work, then re-run.
-3. Append to .clancy/progress.txt: YYYY-MM-DD HH:MM | #${ISSUE_NUMBER} | SKIPPED | {reason}
-4. Stop — no branches, no file changes, no git operations.
-
-If the issue IS implementable, continue:
-1. Read core docs in .clancy/docs/: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, GIT.md, DEFINITION-OF-DONE.md, CONCERNS.md
-   Also read if relevant to this ticket: INTEGRATIONS.md (external APIs/services/auth), TESTING.md (tests/specs/coverage), DESIGN-SYSTEM.md (UI/components/styles), ACCESSIBILITY.md (accessibility/ARIA/WCAG)
-2. Follow the conventions in GIT.md exactly
-3. Implement the issue fully
-4. Commit your work following the conventions in GIT.md
-5. When done, confirm you are finished."
-
-CLAUDE_ARGS=(--dangerously-skip-permissions)
-[ -n "${CLANCY_MODEL:-}" ] && CLAUDE_ARGS+=(--model "$CLANCY_MODEL")
-echo "$PROMPT" | claude "${CLAUDE_ARGS[@]}"
-
-# ─── MERGE, CLOSE & LOG ────────────────────────────────────────────────────────
-
-# Squash all commits from the feature branch into a single commit on the target branch.
-git checkout "$TARGET_BRANCH"
-git merge --squash "$TICKET_BRANCH"
-if git diff --cached --quiet; then
-  echo "⚠ No changes staged after squash merge. Claude may not have committed any work."
-else
-  git commit -m "feat(#${ISSUE_NUMBER}): $TITLE"
-fi
-
-# Delete ticket branch locally
-git branch -d "$TICKET_BRANCH"
-
-# Close the issue — warn but don't fail if this doesn't go through
-CLOSE_HTTP=$(curl -s -o /dev/null -w "%{http_code}" -X PATCH \
-  -H "Authorization: Bearer $GITHUB_TOKEN" \
-  -H "X-GitHub-Api-Version: 2022-11-28" \
-  -H "Content-Type: application/json" \
-  "https://api.github.com/repos/$GITHUB_REPO/issues/${ISSUE_NUMBER}" \
-  -d '{"state": "closed"}')
-[ "$CLOSE_HTTP" = "200" ] || echo "⚠ Could not close issue #${ISSUE_NUMBER} (HTTP $CLOSE_HTTP). Close it manually on GitHub."
-
-# Log progress
-echo "$(date '+%Y-%m-%d %H:%M') | #${ISSUE_NUMBER} | $TITLE | DONE" >> .clancy/progress.txt
-
-echo "✓ #${ISSUE_NUMBER} complete."
-
-# Send completion notification if webhook is configured
-if [ -n "${CLANCY_NOTIFY_WEBHOOK:-}" ]; then
-  NOTIFY_MSG="✓ Clancy completed [#${ISSUE_NUMBER}] $TITLE"
-  if echo "$CLANCY_NOTIFY_WEBHOOK" | grep -q "hooks.slack.com"; then
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"text": $text}')" >/dev/null 2>&1 || true
-  else
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","body":[{"type":"TextBlock","text":$text}]}}]}')" >/dev/null 2>&1 || true
-  fi
-fi
-```
-
----
-
-### `.clancy/clancy-once.sh` — Linear
+### `.clancy/clancy-once.js` — all boards
 
-Write this file when the chosen board is **Linear**:
+Write this file regardless of which board is chosen:
 
-```bash
-#!/usr/bin/env bash
-# Strict mode: exit on error (-e), undefined variables (-u), pipe failures (-o pipefail).
-# This means any command that fails will stop the script immediately rather than silently continuing.
-set -euo pipefail
-
-# Parse flags — must happen before preflight so --dry-run works without side effects.
-DRY_RUN=false
-for arg in "$@"; do
-  case "$arg" in
-    --dry-run) DRY_RUN=true ;;
-  esac
-done
-readonly DRY_RUN
-
-# ─── WHAT THIS SCRIPT DOES ─────────────────────────────────────────────────────
-#
-# Board: Linear
-#
-# 1. Preflight  — checks all required tools, credentials, and API reachability
-# 2. Fetch      — pulls the next unstarted issue assigned to you via GraphQL
-# 3. Branch     — creates a feature branch from the issue's parent branch (or base branch)
-# 4. Implement  — passes the issue to Claude Code, which reads .clancy/docs/ and implements it
-# 5. Merge      — squash-merges the feature branch back into the target branch
-# 6. Log        — appends a completion entry to .clancy/progress.txt
-#
-# This script is run once per issue. The loop is handled by clancy-afk.sh.
-#
-# NOTE: Linear personal API keys do NOT use a "Bearer" prefix in the Authorization
-# header. OAuth access tokens do. This is correct per Linear's documentation.
-#
-# NOTE: state.type "unstarted" is a fixed enum value — it filters by state category,
-# not state name. This works regardless of what your team named their backlog column.
-#
-# NOTE: Failures use exit 0, not exit 1. This is intentional — clancy-afk.sh
-# detects stop conditions by reading script output rather than exit codes, so a
-# non-zero exit would be treated as an unexpected crash rather than a clean stop.
-#
-# ───────────────────────────────────────────────────────────────────────────────
-
-# ─── PREFLIGHT ─────────────────────────────────────────────────────────────────
-
-command -v claude >/dev/null 2>&1 || {
-  echo "✗ claude CLI not found."
-  echo "  Install it: https://claude.ai/code"
-  exit 0
-}
-command -v jq >/dev/null 2>&1 || {
-  echo "✗ jq not found."
-  echo "  Install: brew install jq  (mac) | apt install jq  (linux)"
-  exit 0
-}
-command -v curl >/dev/null 2>&1 || {
-  echo "✗ curl not found. Install curl for your OS."
-  exit 0
-}
-
-[ -f .clancy/.env ] || {
-  echo "✗ .clancy/.env not found."
-  echo "  Copy .clancy/.env.example to .clancy/.env and fill in your credentials."
-  echo "  Then run: /clancy:init"
-  exit 0
-}
-# shellcheck source=/dev/null
-source .clancy/.env
-
-git rev-parse --git-dir >/dev/null 2>&1 || {
-  echo "✗ Not a git repository."
-  echo "  Clancy must be run from the root of a git project."
-  exit 0
-}
-
-if ! git diff --quiet || ! git diff --cached --quiet; then
-  echo "⚠ Working directory has uncommitted changes."
-  echo "  Consider stashing or committing first to avoid confusion."
-fi
-
-[ -n "${LINEAR_API_KEY:-}"  ] || { echo "✗ LINEAR_API_KEY is not set in .clancy/.env";  exit 0; }
-[ -n "${LINEAR_TEAM_ID:-}"  ] || { echo "✗ LINEAR_TEAM_ID is not set in .clancy/.env";  exit 0; }
-
-# Linear ping — verify API key with a minimal query
-# Note: personal API keys do NOT use a "Bearer" prefix — this is correct per Linear docs.
-# OAuth access tokens use "Bearer". Do not change this.
-PING_BODY=$(curl -s -X POST https://api.linear.app/graphql \
-  -H "Content-Type: application/json" \
-  -H "Authorization: $LINEAR_API_KEY" \
-  -d '{"query": "{ viewer { id } }"}')
-
-echo "$PING_BODY" | jq -e '.data.viewer.id' >/dev/null 2>&1 || {
-  echo "✗ Linear authentication failed. Check LINEAR_API_KEY in .clancy/.env."; exit 0
-}
-
-if [ "${PLAYWRIGHT_ENABLED:-}" = "true" ]; then
-  if lsof -ti:"${PLAYWRIGHT_DEV_PORT:-5173}" >/dev/null 2>&1; then
-    echo "⚠ Port ${PLAYWRIGHT_DEV_PORT:-5173} is already in use."
-    echo "  If visual checks fail, stop whatever is using the port first."
-  fi
-fi
-
-echo "✓ Preflight passed. Starting Clancy..."
-
-# ─── END PREFLIGHT ─────────────────────────────────────────────────────────────
-
-# ─── FETCH ISSUE ───────────────────────────────────────────────────────────────
-
-# Fetch one unstarted issue assigned to the current user on the configured team.
-# Note: personal API keys do NOT use "Bearer" prefix — this is intentional.
-#
-# GraphQL query (expanded for readability):
-#   viewer {
-#     assignedIssues(
-#       filter: {
-#         state: { type: { eq: "unstarted" } }   ← fixed enum, works regardless of column name
-#         team: { id: { eq: "$LINEAR_TEAM_ID" } }
-#         labels: { name: { eq: "$CLANCY_LABEL" } }  ← only if CLANCY_LABEL is set
-#       }
-#       first: 1
-#       orderBy: priority
-#     ) {
-#       nodes { id identifier title description parent { identifier title } }
-#     }
-#   }
-
-# Validate user-controlled values to prevent GraphQL injection.
-# Values are passed via GraphQL variables (JSON-encoded by jq) rather than string-interpolated.
-if ! echo "$LINEAR_TEAM_ID" | grep -qE '^[a-zA-Z0-9_-]+$'; then
-  echo "✗ LINEAR_TEAM_ID contains invalid characters. Check .clancy/.env."
-  exit 0
-fi
-if [ -n "${CLANCY_LABEL:-}" ] && ! echo "$CLANCY_LABEL" | grep -qE '^[a-zA-Z0-9 _-]+$'; then
-  echo "✗ CLANCY_LABEL contains invalid characters. Use only letters, numbers, spaces, hyphens, and underscores."
-  exit 0
-fi
-
-# Build request using GraphQL variables — values are JSON-encoded by jq, never interpolated into the query string.
-# The label filter clause is only added to the query when CLANCY_LABEL is set, since passing null would match nothing.
-if [ -n "${CLANCY_LABEL:-}" ]; then
-  REQUEST_BODY=$(jq -n \
-    --arg teamId "$LINEAR_TEAM_ID" \
-    --arg label "$CLANCY_LABEL" \
-    '{"query": "query($teamId: String!, $label: String) { viewer { assignedIssues(filter: { state: { type: { eq: \"unstarted\" } } team: { id: { eq: $teamId } } labels: { name: { eq: $label } } } first: 1 orderBy: priority) { nodes { id identifier title description parent { identifier title } } } } }", "variables": {"teamId": $teamId, "label": $label}}')
-else
-  REQUEST_BODY=$(jq -n \
-    --arg teamId "$LINEAR_TEAM_ID" \
-    '{"query": "query($teamId: String!) { viewer { assignedIssues(filter: { state: { type: { eq: \"unstarted\" } } team: { id: { eq: $teamId } } } first: 1 orderBy: priority) { nodes { id identifier title description parent { identifier title } } } } }", "variables": {"teamId": $teamId}}')
-fi
-
-RESPONSE=$(curl -s -X POST https://api.linear.app/graphql \
-  -H "Content-Type: application/json" \
-  -H "Authorization: $LINEAR_API_KEY" \
-  -d "$REQUEST_BODY")
-
-# Check for API errors before parsing (rate limit, permission error, etc.)
-if ! echo "$RESPONSE" | jq -e '.data.viewer.assignedIssues' >/dev/null 2>&1; then
-  ERR_MSG=$(echo "$RESPONSE" | jq -r '.errors[0].message // "Unexpected response"' 2>/dev/null || echo "Unexpected response")
-  echo "✗ Linear API error: $ERR_MSG. Check LINEAR_API_KEY in .clancy/.env."
-  exit 0
-fi
-
-NODE_COUNT=$(echo "$RESPONSE" | jq '.data.viewer.assignedIssues.nodes | length')
-if [ "$NODE_COUNT" -eq 0 ]; then
-  echo "No issues found. All done!"
-  exit 0
-fi
-
-ISSUE_ID=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].id')
-IDENTIFIER=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].identifier')
-TITLE=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].title')
-DESCRIPTION=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].description // "No description"')
-PARENT_ID=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].parent.identifier // "none"')
-PARENT_TITLE=$(echo "$RESPONSE" | jq -r '.data.viewer.assignedIssues.nodes[0].parent.title // ""')
-
-EPIC_INFO="${PARENT_ID}"
-if [ -n "$PARENT_TITLE" ] && [ "$PARENT_TITLE" != "null" ]; then
-  EPIC_INFO="${PARENT_ID} — ${PARENT_TITLE}"
-fi
-
-BASE_BRANCH="${CLANCY_BASE_BRANCH:-main}"
-TICKET_BRANCH="feature/$(echo "$IDENTIFIER" | tr '[:upper:]' '[:lower:]')"
-
-# Auto-detect target branch from ticket's parent.
-# If the issue has a parent, branch from epic/{parent-id} (creating it from
-# BASE_BRANCH if it doesn't exist yet). Otherwise branch from BASE_BRANCH directly.
-if [ "$PARENT_ID" != "none" ]; then
-  TARGET_BRANCH="epic/$(echo "$PARENT_ID" | tr '[:upper:]' '[:lower:]')"
-else
-  TARGET_BRANCH="$BASE_BRANCH"
-fi
-
-# ─── DRY RUN ───────────────────────────────────────────────────────────────────
-
-if [ "$DRY_RUN" = "true" ]; then
-  echo ""
-  echo "── Dry run ──────────────────────────────────────"
-  echo "  Issue:          [$IDENTIFIER] $TITLE"
-  echo "  Epic:           $EPIC_INFO"
-  echo "  Target branch:  $TARGET_BRANCH"
-  echo "  Feature branch: $TICKET_BRANCH"
-  echo "─────────────────────────────────────────────────"
-  echo "  No changes made. Remove --dry-run to run for real."
-  exit 0
-fi
-
-# ─── IMPLEMENT ─────────────────────────────────────────────────────────────────
-
-echo "Picking up: [$IDENTIFIER] $TITLE"
-echo "Epic: $EPIC_INFO | Target branch: $TARGET_BRANCH"
-
-git show-ref --verify --quiet "refs/heads/$TARGET_BRANCH" \
-  || git checkout -b "$TARGET_BRANCH" "$BASE_BRANCH"
-git checkout "$TARGET_BRANCH"
-# -B creates the branch if it doesn't exist, or resets it to HEAD if it does.
-# This handles retries cleanly without failing on an already-existing branch.
-git checkout -B "$TICKET_BRANCH"
-
-# Transition issue to In Progress (best-effort — never fails the run).
-# Queries team workflow states by type "started", picks the first match.
-if [ -n "${CLANCY_STATUS_IN_PROGRESS:-}" ]; then
-  STATE_RESP=$(curl -s -X POST https://api.linear.app/graphql \
-    -H "Content-Type: application/json" \
-    -H "Authorization: $LINEAR_API_KEY" \
-    -d "$(jq -n --arg teamId "$LINEAR_TEAM_ID" --arg name "$CLANCY_STATUS_IN_PROGRESS" \
-      '{"query": "query($teamId: String!, $name: String!) { workflowStates(filter: { team: { id: { eq: $teamId } } name: { eq: $name } }) { nodes { id } } }", "variables": {"teamId": $teamId, "name": $name}}')")
-  IN_PROGRESS_STATE_ID=$(echo "$STATE_RESP" | jq -r '.data.workflowStates.nodes[0].id // empty')
-  if [ -n "$IN_PROGRESS_STATE_ID" ]; then
-    curl -s -X POST https://api.linear.app/graphql \
-      -H "Content-Type: application/json" \
-      -H "Authorization: $LINEAR_API_KEY" \
-      -d "$(jq -n --arg issueId "$ISSUE_ID" --arg stateId "$IN_PROGRESS_STATE_ID" \
-        '{"query": "mutation($issueId: String!, $stateId: String!) { issueUpdate(id: $issueId, input: { stateId: $stateId }) { success } }", "variables": {"issueId": $issueId, "stateId": $stateId}}')" \
-      >/dev/null 2>&1 || true
-    echo "  → Transitioned to $CLANCY_STATUS_IN_PROGRESS"
-  else
-    echo "  ⚠ Workflow state '$CLANCY_STATUS_IN_PROGRESS' not found — check CLANCY_STATUS_IN_PROGRESS in .clancy/.env."
-  fi
-fi
-
-PROMPT="You are implementing Linear issue $IDENTIFIER.
-
-Title: $TITLE
-Epic: $EPIC_INFO
-
-Description:
-$DESCRIPTION
-
-Step 0 — Executability check (do this before any git or file operation):
-Read the issue title and description above. Can this issue be implemented entirely
-as a code change committed to this repo? Consult the 'Executability check' section of
-CLAUDE.md for the full list of skip conditions.
-
-If you must SKIP this issue:
-1. Output: ⚠ Skipping [$IDENTIFIER]: {one-line reason}
-2. Output: Ticket skipped — update it to be codebase-only work, then re-run.
-3. Append to .clancy/progress.txt: YYYY-MM-DD HH:MM | $IDENTIFIER | SKIPPED | {reason}
-4. Stop — no branches, no file changes, no git operations.
-
-If the issue IS implementable, continue:
-1. Read core docs in .clancy/docs/: STACK.md, ARCHITECTURE.md, CONVENTIONS.md, GIT.md, DEFINITION-OF-DONE.md, CONCERNS.md
-   Also read if relevant to this ticket: INTEGRATIONS.md (external APIs/services/auth), TESTING.md (tests/specs/coverage), DESIGN-SYSTEM.md (UI/components/styles), ACCESSIBILITY.md (accessibility/ARIA/WCAG)
-2. Follow the conventions in GIT.md exactly
-3. Implement the issue fully
-4. Commit your work following the conventions in GIT.md
-5. When done, confirm you are finished."
-
-CLAUDE_ARGS=(--dangerously-skip-permissions)
-[ -n "${CLANCY_MODEL:-}" ] && CLAUDE_ARGS+=(--model "$CLANCY_MODEL")
-echo "$PROMPT" | claude "${CLAUDE_ARGS[@]}"
-
-# ─── MERGE & LOG ───────────────────────────────────────────────────────────────
-
-# Squash all commits from the feature branch into a single commit on the target branch.
-git checkout "$TARGET_BRANCH"
-git merge --squash "$TICKET_BRANCH"
-if git diff --cached --quiet; then
-  echo "⚠ No changes staged after squash merge. Claude may not have committed any work."
-else
-  git commit -m "feat($IDENTIFIER): $TITLE"
-fi
-
-# Delete ticket branch locally
-git branch -d "$TICKET_BRANCH"
-
-# Transition issue to Done (best-effort — never fails the run).
-if [ -n "${CLANCY_STATUS_DONE:-}" ]; then
-  STATE_RESP=$(curl -s -X POST https://api.linear.app/graphql \
-    -H "Content-Type: application/json" \
-    -H "Authorization: $LINEAR_API_KEY" \
-    -d "$(jq -n --arg teamId "$LINEAR_TEAM_ID" --arg name "$CLANCY_STATUS_DONE" \
-      '{"query": "query($teamId: String!, $name: String!) { workflowStates(filter: { team: { id: { eq: $teamId } } name: { eq: $name } }) { nodes { id } } }", "variables": {"teamId": $teamId, "name": $name}}')")
-  DONE_STATE_ID=$(echo "$STATE_RESP" | jq -r '.data.workflowStates.nodes[0].id // empty')
-  if [ -n "$DONE_STATE_ID" ]; then
-    curl -s -X POST https://api.linear.app/graphql \
-      -H "Content-Type: application/json" \
-      -H "Authorization: $LINEAR_API_KEY" \
-      -d "$(jq -n --arg issueId "$ISSUE_ID" --arg stateId "$DONE_STATE_ID" \
-        '{"query": "mutation($issueId: String!, $stateId: String!) { issueUpdate(id: $issueId, input: { stateId: $stateId }) { success } }", "variables": {"issueId": $issueId, "stateId": $stateId}}')" \
-      >/dev/null 2>&1 || true
-    echo "  → Transitioned to $CLANCY_STATUS_DONE"
-  else
-    echo "  ⚠ Workflow state '$CLANCY_STATUS_DONE' not found — check CLANCY_STATUS_DONE in .clancy/.env."
-  fi
-fi
-
-# Log progress
-echo "$(date '+%Y-%m-%d %H:%M') | $IDENTIFIER | $TITLE | DONE" >> .clancy/progress.txt
-
-echo "✓ $IDENTIFIER complete."
-
-# Send completion notification if webhook is configured
-if [ -n "${CLANCY_NOTIFY_WEBHOOK:-}" ]; then
-  NOTIFY_MSG="✓ Clancy completed [$IDENTIFIER] $TITLE"
-  if echo "$CLANCY_NOTIFY_WEBHOOK" | grep -q "hooks.slack.com"; then
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"text": $text}')" >/dev/null 2>&1 || true
-  else
-    curl -s -X POST "$CLANCY_NOTIFY_WEBHOOK" \
-      -H "Content-Type: application/json" \
-      -d "$(jq -n --arg text "$NOTIFY_MSG" '{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","body":[{"type":"TextBlock","text":$text}]}}]}')" >/dev/null 2>&1 || true
-  fi
-fi
+```js
+import('chief-clancy/scripts/once').then(m => m.run(process.argv));
 ```
 
 ---
 
-### `.clancy/clancy-afk.sh` — all boards
+### `.clancy/clancy-afk.js` — all boards
 
-Write this file regardless of board choice:
-
-```bash
-#!/usr/bin/env bash
-# Strict mode: exit on error (-e), undefined variables (-u), pipe failures (-o pipefail).
-# This means any command that fails will stop the script immediately rather than silently continuing.
-set -euo pipefail
-
-# ─── WHAT THIS SCRIPT DOES ─────────────────────────────────────────────────────
-#
-# Loop runner for Clancy. Calls clancy-once.sh repeatedly until:
-#   - No more tickets are found ("No tickets found", "All done", etc.)
-#   - A preflight check fails (output line starting with ✗)
-#   - MAX_ITERATIONS is reached
-#   - The user presses Ctrl+C
-#
-# This script does not know about boards. All board logic lives in clancy-once.sh,
-# which is always the runtime filename regardless of which board is configured.
-# /clancy:init copies the correct board variant as clancy-once.sh during setup.
-#
-# ───────────────────────────────────────────────────────────────────────────────
-
-# ─── PREFLIGHT ─────────────────────────────────────────────────────────────────
-
-command -v claude >/dev/null 2>&1 || {
-  echo "✗ claude CLI not found."
-  echo "  Install it: https://claude.ai/code"
-  exit 0
-}
-command -v jq >/dev/null 2>&1 || {
-  echo "✗ jq not found."
-  echo "  Install: brew install jq  (mac) | apt install jq  (linux)"
-  exit 0
-}
-command -v curl >/dev/null 2>&1 || {
-  echo "✗ curl not found. Install curl for your OS."
-  exit 0
-}
-
-[ -f .clancy/.env ] || {
-  echo "✗ .clancy/.env not found."
-  echo "  Copy .clancy/.env.example to .clancy/.env and fill in your credentials."
-  exit 0
-}
-# shellcheck source=/dev/null
-source .clancy/.env
-
-git rev-parse --git-dir >/dev/null 2>&1 || {
-  echo "✗ Not a git repository."
-  echo "  Clancy must be run from the root of a git project."
-  exit 0
-}
-
-# ─── END PREFLIGHT ─────────────────────────────────────────────────────────────
-
-MAX_ITERATIONS=${MAX_ITERATIONS:-5}
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# clancy-once.sh is always the runtime filename regardless of board.
-# /clancy:init copies the correct board variant as clancy-once.sh.
-ONCE_SCRIPT="$SCRIPT_DIR/clancy-once.sh"
-
-if [ ! -f "$ONCE_SCRIPT" ]; then
-  echo "✗ Script not found: $ONCE_SCRIPT"
-  echo "  Run /clancy:init to scaffold scripts."
-  exit 0
-fi
-
-echo "Starting Clancy — will process up to $MAX_ITERATIONS ticket(s). Ctrl+C to stop early."
-echo ""
-
-i=0
-while [ "$i" -lt "$MAX_ITERATIONS" ]; do
-  i=$((i + 1))
-  echo ""
-  echo "=== Iteration $i of $MAX_ITERATIONS ==="
-
-  # Run clancy-once.sh and stream its output live via tee.
-  # tee writes to both stdout (visible to user) and a temp file (for stop-condition checks).
-  # Without tee, output would be buffered in a variable and hidden during implementation.
-  TMPFILE=$(mktemp)
-  bash "$ONCE_SCRIPT" 2>&1 | tee "$TMPFILE"
-  OUTPUT=$(cat "$TMPFILE")
-  rm -f "$TMPFILE"
-
-  # Stop if no tickets remain
-  if echo "$OUTPUT" | grep -qE "No tickets found|No issues found|All done"; then
-    echo ""
-    echo "✓ Clancy finished — no more tickets."
-    exit 0
-  fi
-
-  # Stop if Claude skipped the ticket (not implementable from the codebase).
-  # Re-running would just fetch and skip the same ticket again — stop and let
-  # the user update the ticket or remove it from the queue before continuing.
-  if echo "$OUTPUT" | grep -q "Ticket skipped"; then
-    echo ""
-    echo "⚠ Clancy stopped — ticket was skipped (not implementable from the codebase)."
-    echo "  Update the ticket to focus on codebase work, then re-run."
-    exit 0
-  fi
-
-  # Stop if a preflight check failed (lines starting with ✗)
-  if echo "$OUTPUT" | grep -qE "^✗ "; then
-    echo ""
-    echo "✗ Clancy stopped — preflight check failed. See output above."
-    exit 0
-  fi
-
-  sleep 2
-done
+Write this file regardless of which board is chosen:
 
-echo ""
-echo "Reached max iterations ($MAX_ITERATIONS). Run clancy-afk.sh again to continue."
+```js
+import('chief-clancy/scripts/afk').then(m => m.runAfkLoop(process.cwd(), parseInt(process.env.MAX_ITERATIONS || '5')));
 ```
 
 ---