specweave 0.12.7 → 0.13.1

package/plugins/specweave-github/hooks/README.md

@@ -0,0 +1,280 @@
+# SpecWeave GitHub Plugin Hooks
+
+**Plugin**: `specweave-github`
+**Location**: `plugins/specweave-github/hooks/`
+
+---
+
+## Purpose
+
+This hook automatically syncs SpecWeave increment progress to GitHub Issues after each task completion.
+
+**Key Features**:
+- ✅ Updates GitHub issue checkboxes based on `tasks.md` completion status
+- ✅ Posts progress comments with percentage completion
+- ✅ Bidirectional sync (local → GitHub)
+- ✅ Non-blocking (failures don't stop core workflow)
+- ✅ Self-contained (no dependencies on core plugin)
+
+---
+
+## Available Hooks
+
+### 1. `post-task-completion.sh`
+
+**Triggers**: After ANY task is marked complete (via TodoWrite tool)
+
+**Preconditions**:
+- ✅ Active increment exists (`.specweave/increments/####/`)
+- ✅ `metadata.json` has `.github.issue` field
+- ✅ GitHub CLI (`gh`) installed and authenticated
+- ✅ `tasks.md` file exists in increment
+
+**Actions**:
+1. Reads completed tasks from `tasks.md`
+2. Fetches GitHub issue body
+3. Updates checkboxes for completed tasks
+4. Posts progress comment with percentage
+5. Logs all actions to `.specweave/logs/hooks-debug.log`
+
+**Example Flow**:
+```
+Task T-003 completed in tasks.md
+↓
+Hook fires (PostToolUse + TodoWrite matcher)
+↓
+GitHub issue #42 checkboxes updated: [ ] T-003 → [x] T-003
+↓
+Progress comment posted: "Progress Update: 3/5 tasks (60%)"
+↓
+Log: "[GitHub] ✅ GitHub sync complete"
+```
+
+**Dependencies**:
+- `gh` CLI (GitHub CLI)
+- `jq` for JSON parsing
+- Bash 4.0+
+
+---
+
+## Configuration
+
+### Hook Registration (`hooks.json`)
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Key Points**:
+- Uses `${CLAUDE_PLUGIN_ROOT}` to reference plugin directory
+- Matches `TodoWrite` tool (fires when tasks complete)
+- Runs as `command` type (shell script)
+
+### Metadata Format
+
+Increments must have `metadata.json` with GitHub issue link:
+
+```json
+{
+  "github": {
+    "issue": 42,
+    "url": "https://github.com/owner/repo/issues/42",
+    "repo": "owner/repo"
+  }
+}
+```
+
+---
+
+## Installation
+
+### Automatic (Recommended)
+
+When `specweave init` runs, all plugin hooks are automatically installed:
+
+```bash
+npx specweave init my-project
+# Installs all plugins including specweave-github
+# Hooks auto-register via hooks.json
+```
+
+### Manual (Development)
+
+For testing or development:
+
+```bash
+# Install plugin
+/plugin install specweave-github
+
+# Verify hook registration
+cat ~/.claude/settings.json
+# Should show specweave-github hooks registered
+```
+
+---
+
+## Testing
+
+### Test Hook Independently
+
+```bash
+# Test syntax
+bash -n plugins/specweave-github/hooks/post-task-completion.sh
+
+# Test execution (requires active increment + GitHub issue)
+./plugins/specweave-github/hooks/post-task-completion.sh
+```
+
+### Test with GitHub Issue
+
+1. Create increment: `/specweave:increment "test feature"`
+2. Create GitHub issue: `/specweave-github:create-issue 0001`
+3. Complete a task (TodoWrite)
+4. Hook fires → Check GitHub issue for updates
+
+---
+
+## Logging
+
+All GitHub sync actions are logged to:
+
+```
+.specweave/logs/hooks-debug.log
+```
+
+**Example Log Output**:
+```
+[2025-11-10] [GitHub] 🔗 GitHub sync hook fired
+[2025-11-10] [GitHub] 🔄 Syncing to GitHub issue #42
+[2025-11-10] [GitHub] 📊 Syncing task checkboxes to GitHub issue #42
+[2025-11-10] [GitHub] Completed tasks found: T-001 T-002 T-003
+[2025-11-10] [GitHub] Updated checkbox for task: T-001
+[2025-11-10] [GitHub] Updated checkbox for task: T-002
+[2025-11-10] [GitHub] Updated checkbox for task: T-003
+[2025-11-10] [GitHub] ✅ Issue description checkboxes updated
+[2025-11-10] [GitHub] ✅ Progress comment posted (60%)
+[2025-11-10] [GitHub] ✅ GitHub sync complete
+```
+
+**Log Prefixes**:
+- `[GitHub]` - All messages from this hook
+- `🔗` - Hook fired
+- `🔄` - Syncing started
+- `📊` - Syncing task data
+- `✅` - Success
+- `⚠️` - Warning (non-blocking failure)
+- `ℹ️` - Info (skipped due to precondition)
+
+---
+
+## Architecture
+
+### How It Works with Core Plugin
+
+**Before (v0.12.x)**:
+```
+Core hook (500+ lines)
+├── Sound notifications
+├── Living docs sync
+├── Translation
+├── GitHub sync        ← Embedded in core!
+├── JIRA sync          ← Embedded in core!
+└── ADO sync           ← Embedded in core!
+```
+
+**After (v0.13.0+)**:
+```
+Core hook (330 lines)         GitHub plugin hook (241 lines)
+├── Sound notifications       ├── Check for GitHub issue
+├── Living docs sync          ├── Update checkboxes
+├── Translation               ├── Post progress comment
+└── Self-reflection           └── Log actions
+```
+
+**Key Benefits**:
+- ✅ **Separation of concerns**: Core plugin has NO external tool dependencies
+- ✅ **Optional plugin**: GitHub sync only runs if `specweave-github` installed
+- ✅ **Independent testing**: Test GitHub sync in isolation
+- ✅ **Cleaner code**: Each hook <250 lines, single responsibility
+- ✅ **Parallel execution**: Claude Code runs all hooks concurrently
+
+---
+
+## Troubleshooting
+
+### Hook Not Firing
+
+**Check**:
+1. Plugin installed: `/plugin list --installed | grep specweave-github`
+2. Hook registered: `cat ~/.claude/settings.json | grep specweave-github`
+3. Active increment: `cat .specweave/logs/current-increment`
+4. GitHub issue linked: `cat .specweave/increments/####/metadata.json | jq .github`
+
+### GitHub CLI Not Found
+
+**Fix**:
+```bash
+# macOS
+brew install gh
+
+# Linux
+curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
+echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
+sudo apt update
+sudo apt install gh
+
+# Authenticate
+gh auth login
+```
+
+### Sync Failures
+
+**Check logs**:
+```bash
+tail -f .specweave/logs/hooks-debug.log | grep '\[GitHub\]'
+```
+
+**Common issues**:
+- ❌ No `metadata.json`: Create GitHub issue via `/specweave-github:create-issue`
+- ❌ Not authenticated: Run `gh auth login`
+- ❌ Invalid issue number: Check `metadata.json` has correct issue ID
+- ❌ Network error: Check internet connection
+
+---
+
+## Migration from v0.12.x
+
+If upgrading from SpecWeave v0.12.x or earlier:
+
+1. **Automatic**: Run `specweave init` (re-installs all hooks)
+2. **Manual**: Copy `plugins/specweave-github/hooks/` to `.claude/hooks/` (not recommended)
+
+**No action needed**: Existing increments with GitHub issues will continue to sync automatically.
+
+---
+
+## Related Documentation
+
+- **Core Plugin Hooks**: `plugins/specweave/hooks/README.md`
+- **Architecture Analysis**: `.specweave/increments/0018-strict-increment-discipline-enforcement/reports/HOOKS-ARCHITECTURE-ANALYSIS.md`
+- **Claude Code Hooks Guide**: https://code.claude.com/docs/en/hooks-guide
+- **GitHub Sync Command**: `plugins/specweave-github/commands/specweave-github-sync.md`
+
+---
+
+**Version**: v0.13.0+
+**Last Updated**: 2025-11-10

package/plugins/specweave-github/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "TodoWrite",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/post-task-completion.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/specweave-github/hooks/post-task-completion.sh

@@ -0,0 +1,241 @@
+#!/bin/bash
+
+# SpecWeave GitHub Sync Hook
+# Runs after task completion to sync progress to GitHub Issues
+#
+# This hook is part of the specweave-github plugin and handles:
+# - Updating GitHub issue checkboxes based on tasks.md completion status
+# - Posting progress comments to GitHub issues
+# - Syncing task completion state bidirectionally
+#
+# Dependencies:
+# - gh CLI (GitHub CLI) must be installed and authenticated
+# - jq for JSON parsing
+# - metadata.json must have .github.issue field
+
+set -e
+
+# ============================================================================
+# PROJECT ROOT DETECTION
+# ============================================================================
+
+# Find project root by searching upward for .specweave/ directory
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
+cd "$PROJECT_ROOT" 2>/dev/null || true
+
+# ============================================================================
+# CONFIGURATION
+# ============================================================================
+
+LOGS_DIR=".specweave/logs"
+DEBUG_LOG="$LOGS_DIR/hooks-debug.log"
+
+mkdir -p "$LOGS_DIR" 2>/dev/null || true
+
+# ============================================================================
+# PRECONDITIONS CHECK
+# ============================================================================
+
+echo "[$(date)] [GitHub] 🔗 GitHub sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Detect current increment
+CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
+
+if [ -z "$CURRENT_INCREMENT" ]; then
+  echo "[$(date)] [GitHub] ℹ️  No active increment, skipping GitHub sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for metadata.json
+METADATA_FILE=".specweave/increments/$CURRENT_INCREMENT/metadata.json"
+
+if [ ! -f "$METADATA_FILE" ]; then
+  echo "[$(date)] [GitHub] ℹ️  No metadata.json for $CURRENT_INCREMENT, skipping GitHub sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for GitHub issue link
+if ! command -v jq &> /dev/null; then
+  echo "[$(date)] [GitHub] ⚠️  jq not found, skipping GitHub sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+GITHUB_ISSUE=$(jq -r '.github.issue // empty' "$METADATA_FILE" 2>/dev/null)
+
+if [ -z "$GITHUB_ISSUE" ]; then
+  echo "[$(date)] [GitHub] ℹ️  No GitHub issue linked to $CURRENT_INCREMENT, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Check for gh CLI
+if ! command -v gh &> /dev/null; then
+  echo "[$(date)] [GitHub] ⚠️  GitHub CLI (gh) not found, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# ============================================================================
+# GITHUB SYNC LOGIC
+# ============================================================================
+
+echo "[$(date)] [GitHub] 🔄 Syncing to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+TASKS_FILE=".specweave/increments/$CURRENT_INCREMENT/tasks.md"
+
+if [ ! -f "$TASKS_FILE" ]; then
+  echo "[$(date)] [GitHub] ℹ️  tasks.md not found for $CURRENT_INCREMENT, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+echo "[$(date)] [GitHub] 📊 Syncing task checkboxes to GitHub issue #$GITHUB_ISSUE" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Get list of completed tasks from tasks.md
+# Find all "## T-XXX:" headers where the task has "[x]" checkbox
+COMPLETED_TASK_IDS=$(awk '
+  /^## T-[0-9]+:/ {
+    task_id = $2
+    gsub(/:/, "", task_id)
+    current_task = task_id
+    task_title = substr($0, index($0, $3))
+    next
+  }
+  /^- \[x\]/ && current_task != "" {
+    # Found a completed checkbox under a task
+    print current_task
+    current_task = ""
+  }
+' "$TASKS_FILE" 2>/dev/null)
+
+echo "[$(date)] [GitHub] Completed tasks found: $COMPLETED_TASK_IDS" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Read current issue body
+ISSUE_BODY=$(gh issue view "$GITHUB_ISSUE" --json body -q .body 2>/dev/null || echo "")
+
+if [ -z "$ISSUE_BODY" ]; then
+  echo "[$(date)] [GitHub] ⚠️  Failed to read issue body, skipping sync" >> "$DEBUG_LOG" 2>/dev/null || true
+  cat <<EOF
+{
+  "continue": true
+}
+EOF
+  exit 0
+fi
+
+# Create temporary file for updated body
+TEMP_BODY=$(mktemp)
+echo "$ISSUE_BODY" > "$TEMP_BODY"
+
+# Update checkboxes for completed tasks
+# Pattern: "- [ ] task-name" -> "- [x] task-name"
+for task_id in $COMPLETED_TASK_IDS; do
+  # Update checkbox for this task ID
+  # Look for patterns like "[ ] T-013:" or "[ ] CLAUDE.md updates" etc.
+  sed -i.bak "s/- \[ \] \(.*${task_id}.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+  sed -i.bak "s/- \[ \] \(.*T-0*${task_id#T-}[: ].*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+
+  echo "[$(date)] [GitHub] Updated checkbox for task: $task_id" >> "$DEBUG_LOG" 2>/dev/null || true
+done
+
+# Also update based on task names (more reliable)
+# Check for common patterns in issue body
+if grep -q "test-aware-planner" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
+  sed -i.bak "s/- \[ \] \(.*test-aware-planner.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+fi
+if grep -q "PM.*increment-planner" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
+  sed -i.bak "s/- \[ \] \(.*PM.*increment-planner.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+  sed -i.bak "s/- \[ \] \(.*Enhanced PM.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+fi
+if grep -q "CLAUDE.md" "$TASKS_FILE" && grep -q "\[x\]" "$TASKS_FILE"; then
+  sed -i.bak "s/- \[ \] \(.*CLAUDE\.md.*\)/- [x] \1/g" "$TEMP_BODY" 2>/dev/null || true
+fi
+
+# Read updated body
+UPDATED_BODY=$(cat "$TEMP_BODY")
+
+# Update issue with new body
+gh issue edit "$GITHUB_ISSUE" --body "$UPDATED_BODY" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+  echo "[$(date)] [GitHub] ⚠️  Failed to update issue description (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+}
+
+# Cleanup
+rm -f "$TEMP_BODY" "$TEMP_BODY.bak"
+
+echo "[$(date)] [GitHub] ✅ Issue description checkboxes updated" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# Calculate progress for comment
+TOTAL_TASKS=$(grep -c "^## T-[0-9]" "$TASKS_FILE" 2>/dev/null || echo "0")
+COMPLETED_TASKS=$(echo "$COMPLETED_TASK_IDS" | wc -w | tr -d ' ')
+
+if [ "$TOTAL_TASKS" -gt 0 ]; then
+  PROGRESS_PCT=$((COMPLETED_TASKS * 100 / TOTAL_TASKS))
+
+  # Post progress comment
+  gh issue comment "$GITHUB_ISSUE" --body "**Progress Update**: $COMPLETED_TASKS/$TOTAL_TASKS tasks ($PROGRESS_PCT%)
+
+Increment: \`$CURRENT_INCREMENT\`
+
+---
+🤖 Auto-updated by SpecWeave GitHub plugin" 2>&1 | tee -a "$DEBUG_LOG" >/dev/null || {
+    echo "[$(date)] [GitHub] ⚠️  Failed to comment on GitHub issue (non-blocking)" >> "$DEBUG_LOG" 2>/dev/null || true
+  }
+
+  echo "[$(date)] [GitHub] ✅ Progress comment posted ($PROGRESS_PCT%)" >> "$DEBUG_LOG" 2>/dev/null || true
+fi
+
+echo "[$(date)] [GitHub] ✅ GitHub sync complete" >> "$DEBUG_LOG" 2>/dev/null || true
+
+# ============================================================================
+# OUTPUT TO CLAUDE
+# ============================================================================
+
+cat <<EOF
+{
+  "continue": true
+}
+EOF

package/plugins/specweave-github/lib/cli-sync-increment-changes.d.js

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/plugins/specweave-github/lib/cli-sync-increment-changes.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * CLI wrapper for syncing increment changes to GitHub
+ *
+ * Usage:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js <incrementId> <changedFile>
+ *
+ * Example:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js 0015-hierarchical-sync spec.md
+ */
+export {};
+//# sourceMappingURL=cli-sync-increment-changes.d.ts.map

package/plugins/specweave-github/lib/cli-sync-increment-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-sync-increment-changes.d.ts","sourceRoot":"","sources":["cli-sync-increment-changes.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}

package/plugins/specweave-github/lib/cli-sync-increment-changes.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * CLI wrapper for syncing increment changes to GitHub
+ *
+ * Usage:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js <incrementId> <changedFile>
+ *
+ * Example:
+ *   node dist/plugins/specweave-github/lib/cli-sync-increment-changes.js 0015-hierarchical-sync spec.md
+ */
+import { syncIncrementChanges } from './github-sync-increment-changes.js';
+const incrementId = process.argv[2];
+const changedFile = process.argv[3];
+if (!incrementId || !changedFile) {
+    console.error('❌ Usage: cli-sync-increment-changes <incrementId> <changedFile>');
+    console.error('   Example: cli-sync-increment-changes 0015-hierarchical-sync spec.md');
+    process.exit(1);
+}
+if (!['spec.md', 'plan.md', 'tasks.md'].includes(changedFile)) {
+    console.error(`❌ Invalid file: ${changedFile}`);
+    console.error('   Must be one of: spec.md, plan.md, tasks.md');
+    process.exit(1);
+}
+syncIncrementChanges(incrementId, changedFile).catch((error) => {
+    console.error('❌ Fatal error:', error);
+    // Don't exit with error code - best-effort sync
+});
+//# sourceMappingURL=cli-sync-increment-changes.js.map

package/plugins/specweave-github/lib/cli-sync-increment-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-sync-increment-changes.js","sourceRoot":"","sources":["cli-sync-increment-changes.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE1E,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAuC,CAAC;AAE1E,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IAC9D,OAAO,CAAC,KAAK,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,oBAAoB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7D,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACvC,gDAAgD;AAClD,CAAC,CAAC,CAAC"}

package/plugins/specweave-github/lib/github-board-resolver.d.ts

@@ -0,0 +1,54 @@
+/**
+ * GitHub Project Board Resolution for Hierarchical Sync
+ *
+ * Resolves project board names to board IDs for use in search queries.
+ * Supports both GitHub Classic Projects (v1) and Projects v2 (beta).
+ */
+/**
+ * GitHub Project Board (Classic Projects)
+ */
+export interface GitHubProjectBoard {
+    id: number;
+    name: string;
+    number: number;
+    state: 'open' | 'closed';
+    html_url: string;
+}
+/**
+ * Fetch all project boards for a GitHub repository
+ *
+ * Uses GitHub CLI: gh api repos/{owner}/{repo}/projects
+ *
+ * @param owner Repository owner
+ * @param repo Repository name
+ * @returns Array of project boards
+ */
+export declare function fetchBoardsForRepo(owner: string, repo: string): Promise<GitHubProjectBoard[]>;
+/**
+ * Fetch organization-level project boards
+ *
+ * Uses GitHub CLI: gh api orgs/{org}/projects
+ *
+ * @param org Organization name
+ * @returns Array of organization project boards
+ */
+export declare function fetchBoardsForOrg(org: string): Promise<GitHubProjectBoard[]>;
+/**
+ * Resolve board names to board numbers (for repo-level projects)
+ *
+ * @param owner Repository owner
+ * @param repo Repository name
+ * @param boardNames Array of board names to resolve
+ * @returns Map of board name → board number
+ */
+export declare function resolveBoardNames(owner: string, repo: string, boardNames: string[]): Promise<Map<string, number>>;
+/**
+ * Get board numbers for a list of board names (helper function)
+ *
+ * @param owner Repository owner
+ * @param repo Repository name
+ * @param boardNames Array of board names
+ * @returns Array of board numbers (skips boards not found)
+ */
+export declare function getBoardNumbers(owner: string, repo: string, boardNames: string[]): Promise<number[]>;
+//# sourceMappingURL=github-board-resolver.d.ts.map

package/plugins/specweave-github/lib/github-board-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-board-resolver.d.ts","sourceRoot":"","sources":["github-board-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAgC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB9B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}