forge-workflow 0.0.10 → 0.1.0-beta.2

package/.github/prompts/verify.prompt.md

@@ -1,271 +0,0 @@
----
-name: verify
-description: Post-merge health check — confirm merge landed, CI is clean, deployments are up
-tools: []
----
-
-Verify that the merge landed correctly and everything is running properly after merge.
-
-# Verify
-
-This command runs AFTER the user has merged the PR. It checks system health — not documentation (that was handled in `/premerge`).
-
-## Usage
-
-```bash
-/verify
-```
-
-## What This Command Does
-
-### Step 1: Switch to Main and Pull
-
-```bash
-git checkout master
-git pull
-```
-
-Confirm the merge actually landed on main. If the PR isn't merged yet, stop and tell the user to merge first.
-
-### Step 2: Confirm PR Is Merged
-
-Detect the most recently merged PR from the current HEAD commit:
-
-```bash
-gh pr list --state merged --base master --limit 1 --json number,state,mergedAt,mergedBy
-```
-
-- `state` should be `MERGED`
-- If no PR found: the merge may not have landed yet — stop and tell the user to merge first
-- If the wrong PR appears: user can specify the number directly with `gh pr view <number> --json state,mergedAt,mergedBy`
-
-### Step 3: Check CI on Main After Merge
-
-```bash
-gh run list --branch master --limit 5
-```
-
-Check the most recent workflow runs on `master`:
-- All should be passing or in progress
-- If any failed: identify which workflow and what failed
-- Failed CI on main after merge may need a hotfix PR
-
-### Step 4: Check Deployments (if applicable)
-
-Check if the project has a deployment target:
-
-```bash
-# Check deployment status from latest run
-gh run list --branch master --limit 1
-
-# Check Vercel deployments for the merged PR (use number from Step 2)
-gh pr view <number> --json deployments
-```
-
-If deployments exist:
-- Are they showing as successful?
-- Is the production/preview URL responding?
-
-### Step 5: Report Status
-
-**If everything is clean**:
-```
-✅ Merge verified — everything is healthy
-
-  PR: #<number> merged by <user> at <time>
-  CI on master: ✓ All passing
-  Deployments: ✓ Up (if applicable)
-
-  Ready for next feature → run /status
-```
-
-**If issues found**:
-```
-⚠️  Post-merge issues detected
-
-  PR: #<number> merged ✓
-  CI on master: ✗ <workflow-name> failing
-    - Error: <description>
-    - Action needed: <hotfix or investigation>
-
-  Deployments: ✗ <deployment> not responding
-
-  Next: Create hotfix branch or investigate root cause
-```
-
-### Step 6: Clean Up Worktree and Branch
-
-Only run this step after CI is confirmed healthy (Step 3 passed).
-
-Get the merged branch name:
-
-```bash
-gh pr view <number> --json headRefName --jq '.headRefName'
-```
-
-If the branch name cannot be determined (empty output or error), skip cleanup and tell the user to run `git worktree list` and clean up manually.
-
-Find and remove the matching worktree (if it exists):
-
-```bash
-# Get the worktree path for this exact branch
-WORKTREE_PATH=$(git worktree list --porcelain \
-  | awk -v branch="refs/heads/<branch>" '
-      /^worktree / { path=substr($0, 10) }
-      $0 == "branch " branch { print path }
-    ')
-
-if [ -n "$WORKTREE_PATH" ]; then
-  git worktree remove "$WORKTREE_PATH" --force
-  echo "Worktree: removed ✓ ($WORKTREE_PATH)"
-else
-  echo "Worktree: not found (already removed or never created) — skipping"
-fi
-```
-
-If no worktree is found for that branch, skip gracefully with a note: "Worktree: not found (already removed or never created)".
-
-Delete the local branch (safe delete only):
-
-```bash
-git branch -d <branch> 2>/dev/null || echo "Branch: already deleted — skipping"
-```
-
-The `|| echo` fallback handles the case where the branch is already gone (e.g., deleted by a previous run or the remote), so the command never fails the verify step.
-
-Report cleanup in output:
-```
-Worktree: removed ✓
-Branch: <branch-name> deleted ✓
-```
-
-### Step 7: If Issues Found — Create Beads Issue
-
-**Never commit inline.** If something is wrong, create a tracking issue:
-
-```bash
-bd create --title="Post-merge: <description of issue>" --type=bug --priority=1
-```
-
-### Step 8: Close Beads Issues (if healthy)
-
-If everything is clean, close all Beads issues referenced in the merged PR.
-
-**Auto-detect beads issues from PR body and branch name:**
-
-```bash
-# Get PR body and branch name
-PR_BODY=$(gh pr view <number> --json body --jq '.body')
-PR_BRANCH=$(gh pr view <number> --json headRefName --jq '.headRefName')
-
-# Extract beads IDs from PR body (matches "Closes beads-xxx", "closes forge-xxx", etc.)
-# Patterns: "Closes <prefix>-<id>", "Fixes <prefix>-<id>", "Resolves <prefix>-<id>"
-BEADS_IDS=$(echo "$PR_BODY" | grep -oiE '(closes|fixes|resolves):?\s+[a-z]+-[a-z0-9]+' | grep -oiE '[a-z]+-[a-z0-9]{3,6}$')
-
-# Validate each ID exists in beads
-VALID_IDS=""
-for id in $BEADS_IDS; do
-  if bd show "$id" >/dev/null 2>&1; then
-    VALID_IDS="$VALID_IDS $id"
-  fi
-done
-BEADS_IDS="$VALID_IDS"
-
-# Also check branch name for beads ID — extract segment after last /
-# then validate with bd show to avoid false matches like "pr-templa"
-BRANCH_SLUG=$(echo "$PR_BRANCH" | sed 's|.*/||')
-BRANCH_ID=$(echo "$BRANCH_SLUG" | grep -oE '[a-z]+-[a-z0-9]{3,6}' | head -1)
-if [ -n "$BRANCH_ID" ] && ! bd show "$BRANCH_ID" >/dev/null 2>&1; then
-  BRANCH_ID=""  # Not a valid beads ID — discard
-fi
-```
-
-**Close each matched issue:**
-
-```bash
-# Close issues found in PR body
-for id in $BEADS_IDS; do
-  bd close "$id" --reason="Merged and verified on master (PR #<number>)" 2>&1 || echo "Warning: could not close $id"
-done
-
-# If no issues found in body, try branch name match (skip if already closed above)
-if [ -z "$BEADS_IDS" ] && [ -n "$BRANCH_ID" ]; then
-  bd close "$BRANCH_ID" --reason="Merged and verified on master (PR #<number>)" 2>&1 || echo "Warning: could not close $BRANCH_ID"
-elif [ -n "$BRANCH_ID" ] && ! echo "$BEADS_IDS" | grep -qw "$BRANCH_ID"; then
-  bd close "$BRANCH_ID" --reason="Merged and verified on master (PR #<number>)" 2>&1 || echo "Warning: could not close $BRANCH_ID"
-fi
-```
-
-**If no beads issues detected at all**, prompt the user:
-```
-⚠ No beads issue ID found in PR body or branch name.
-  If this PR closes a beads issue, run: bd close <id> --reason="Merged and verified on master (PR #<number>)"
-```
-
-```
-<HARD-GATE: /verify exit>
-Do NOT declare /verify complete until:
-1. gh run list --branch master --limit 3 shows actual CI output (not "should be fine")
-2. If healthy: Beads issues extracted from PR body/branch and closed (bd close run and confirmed)
-   - If no beads ID found: user was warned and given manual close command
-3. If issues found: Beads tracking issue created for every problem
-4. Worktree removed (or confirmed already gone) — OR Step 6 was intentionally skipped because CI was unhealthy; if skipped, state explicitly: "cleanup deferred, CI was not healthy"
-"It should be fine" is not evidence. Run the command. Show the output.
-</HARD-GATE>
-```
-
-## Rules
-
-- **Never commits** — this command is read-only
-- **Never creates PRs** — if fixes are needed, that's a new /dev cycle
-- **Runs after user confirms merge** — not before
-- **Reports honestly** — if CI is broken on main, say so clearly
-
-## Example Output (Healthy)
-
-```
-✅ Merge verified — everything is healthy
-
-  PR: #89 merged by harshanandak at 2026-02-24T14:30:00Z
-  Branch: feat/auth-refresh deleted ✓
-  CI on master:
-    ✓ Test Suite (ubuntu, node 20): passing
-    ✓ Test Suite (windows, node 22): passing
-    ✓ ESLint: passing
-    ✓ SonarCloud: passing
-    ✓ CodeQL: passing
-  Deployments: N/A (no deployment configured)
-
-  Ready for next feature → run /status
-```
-
-## Example Output (Issues Found)
-
-```
-⚠️  Post-merge issues detected
-
-  PR: #89 merged ✓
-  CI on master:
-    ✓ Test Suite: passing
-    ✗ SonarCloud: quality gate failing
-      - 2 new code smells introduced
-      - Action: investigate or create hotfix
-
-  Created Beads issue: forge-xyz
-  "Post-merge: SonarCloud quality gate failing on master after PR #89"
-
-  Run /status to assess next steps
-```
-
-## Integration with Workflow
-
-```
-Utility: /status     → Understand current context before starting
-Stage 1: /plan       → Design intent → research → branch + worktree + task list
-Stage 2: /dev        → Implement each task with subagent-driven TDD
-Stage 3: /validate      → Type check, lint, tests, security — all fresh output
-Stage 4: /ship       → Push + create PR
-Stage 5: /review     → Address GitHub Actions, Greptile, SonarCloud
-Stage 6: /premerge   → Update docs, hand off PR to user
-Stage 7: /verify     → Post-merge CI check on main (you are here) ✓
-```

package/.github/workflows/beads-to-github.yml

@@ -1,89 +0,0 @@
-name: Beads → GitHub Issue Sync
-
-on:
-  push:
-    branches: [master]
-    paths:
-      - '.beads/**'
-      - '.github/beads-snapshots/issues.jsonl'
-
-# Serialize with forward-sync to prevent race conditions
-concurrency:
-  group: beads-sync
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-  issues: write
-
-jobs:
-  reverse-sync:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Guard — skip loop commits
-        env:
-          COMMIT_MSG: ${{ github.event.head_commit.message }}
-        run: |
-          if [[ "$COMMIT_MSG" == chore\(beads\):* ]]; then
-            echo "Loop guard: skipping chore(beads): commit"
-            echo "SKIP=true" >> "$GITHUB_ENV"
-          fi
-
-      - name: Checkout current
-        if: env.SKIP != 'true'
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4
-        with:
-          fetch-depth: 0
-
-      - name: Install Beads CLI (pinned to v1.0.0)
-        if: env.SKIP != 'true'
-        run: |
-          BD_VERSION="1.0.0"
-          BD_URL="https://github.com/steveyegge/beads/releases/download/v${BD_VERSION}/beads_${BD_VERSION}_linux_amd64.tar.gz"
-          mkdir -p "$HOME/.local/bin"
-          curl -fsSL "$BD_URL" | tar -xz -C "$HOME/.local/bin" bd
-          chmod +x "$HOME/.local/bin/bd"
-          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
-
-      - name: Detect and close
-        if: env.SKIP != 'true'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          BEFORE_SHA: ${{ github.event.before }}
-        run: |
-          OLD_SNAPSHOT_PATH="$RUNNER_TEMP/old-issues.jsonl"
-          NEW_SNAPSHOT_PATH="$RUNNER_TEMP/new-issues.jsonl"
-          BEFORE_WORKTREE="$RUNNER_TEMP/beads-before"
-
-          generate_snapshot() {
-            local repo_root="$1"
-            local output_path="$2"
-
-            BEADS_DIR="$repo_root/.beads" bd init 2>/dev/null || true
-            if BEADS_DIR="$repo_root/.beads" bd backup --force 2>/dev/null; then
-              cp "$repo_root/.beads/backup/issues.jsonl" "$output_path"
-            else
-              : > "$output_path"
-            fi
-          }
-
-          # Rebuild the current snapshot from the pushed Beads state so local bd close
-          # transitions are reflected even when the tracked snapshot file was not updated.
-          generate_snapshot "$GITHUB_WORKSPACE" "$NEW_SNAPSHOT_PATH"
-
-          # Use github.event.before (pre-push SHA) to catch multi-commit pushes.
-          # Rebuild the previous snapshot from that tree's Beads state when possible.
-          if [ "$BEFORE_SHA" = "0000000000000000000000000000000000000000" ] || [ -z "$BEFORE_SHA" ]; then
-            : > "$OLD_SNAPSHOT_PATH"
-          elif git cat-file -e "$BEFORE_SHA:.beads" 2>/dev/null; then
-            rm -rf "$BEFORE_WORKTREE"
-            mkdir -p "$BEFORE_WORKTREE"
-            git archive "$BEFORE_SHA" .beads | tar -x -C "$BEFORE_WORKTREE"
-            generate_snapshot "$BEFORE_WORKTREE" "$OLD_SNAPSHOT_PATH"
-          else
-            # Fallback for historical commits that predate tracked .beads state.
-            OLD_CONTENT=$(git show "$BEFORE_SHA":.github/beads-snapshots/issues.jsonl 2>/dev/null || echo "")
-            printf '%s' "$OLD_CONTENT" > "$OLD_SNAPSHOT_PATH"
-          fi
-
-          node scripts/github-beads-sync/reverse-sync-cli.mjs "$OLD_SNAPSHOT_PATH" "$NEW_SNAPSHOT_PATH"

package/.github/workflows/github-to-beads.yml

@@ -1,100 +0,0 @@
-name: GitHub Issue → Beads Sync
-
-on:
-  issues:
-    types: [opened, closed]
-
-# CRITICAL: Serialize all beads writes to prevent mapping file corruption
-concurrency:
-  group: beads-sync
-  cancel-in-progress: false
-
-permissions:
-  contents: write   # push .beads/ and mapping file
-  issues: write     # post/edit bot comments
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    # Skip if triggered by the bot itself (loop prevention)
-    if: github.actor != 'github-actions[bot]'
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v4
-        with:
-          # Need full history for push
-          fetch-depth: 0
-          # PAT bypasses branch protection for pushing .beads/ changes
-          token: ${{ secrets.BEADS_SYNC_TOKEN }}
-
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5 # v2
-
-      - name: Install Beads CLI (pinned to v1.0.0)
-        run: |
-          BD_VERSION="1.0.0"
-          BD_URL="https://github.com/steveyegge/beads/releases/download/v${BD_VERSION}/beads_${BD_VERSION}_linux_amd64.tar.gz"
-          mkdir -p "$HOME/.local/bin"
-          curl -fsSL "$BD_URL" | tar -xz -C "$HOME/.local/bin" bd
-          chmod +x "$HOME/.local/bin/bd"
-          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
-      - name: Verify and initialize Beads
-        env:
-          BEADS_DIR: ${{ github.workspace }}/.beads
-        run: |
-          bd --version
-          # Initialize the current Dolt-backed layout on fresh checkout
-          bd init 2>/dev/null || true
-
-      - name: Run sync
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITHUB_EVENT_PATH: ${{ github.event_path }}
-          GITHUB_REPOSITORY: ${{ github.repository }}
-          SYNC_ACTION: ${{ github.event.action }}
-          BEADS_SYNC_CONFIG: scripts/github-beads-sync.config.json
-          BEADS_DIR: ${{ github.workspace }}/.beads
-        run: |
-          node scripts/github-beads-sync/index.mjs "$SYNC_ACTION"
-
-      - name: Export backup snapshot
-        env:
-          BEADS_DIR: ${{ github.workspace }}/.beads
-        run: |
-          bd backup --force
-          mkdir -p .github/beads-snapshots
-          cp .beads/backup/issues.jsonl .github/beads-snapshots/issues.jsonl
-
-      - name: Commit and push changes
-        env:
-          ISSUE_NUM: ${{ github.event.issue.number }}
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-          # Stage beads state, mapping changes, and the tracked issue snapshot
-          git add .beads/ .github/beads-mapping.json .github/beads-snapshots/issues.jsonl || true
-
-          # Only commit if there are changes
-          if git diff --cached --quiet; then
-            echo "No changes to commit"
-          else
-            git commit -m "chore(beads): sync from GitHub issue #${ISSUE_NUM}"
-
-            # Push with retry (handles concurrent runs)
-            push_success=false
-            for i in 1 2 3; do
-              if git push; then
-                echo "Push succeeded on attempt $i"
-                push_success=true
-                break
-              fi
-              echo "Push failed, attempt $i/3 — pulling with rebase..."
-              git rebase --abort 2>/dev/null || true
-              git pull --rebase
-            done
-            if [ "$push_success" = false ]; then
-              echo "::error::All 3 push attempts failed"
-              exit 1
-            fi
-          fi