specweave 0.33.5 → 0.34.0

package/plugins/specweave-github/commands/sync.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:sync
+name: sw-github:sync
 description: Synchronize SpecWeave increment with GitHub issue (Multi-Project Support). Select profile, configure time range, and sync with rate limit protection.
 ---
 
@@ -67,7 +67,7 @@ Synchronize the current state of a SpecWeave increment with its GitHub issue acr
 ## Usage
 
 ```bash
-/specweave-github:sync <increment-id> [options]
+/sw-github:sync <increment-id> [options]
 ```
 
 ## Arguments
@@ -112,36 +112,36 @@ SpecWeave syncs changes in **both directions** by default:
 **Override if needed:**
 ```bash
 # Push only (one-way to GitHub)
-/specweave-github:sync 0004 --direction to-github
+/sw-github:sync 0004 --direction to-github
 
 # Pull only (one-way from GitHub)
-/specweave-github:sync 0004 --direction from-github
+/sw-github:sync 0004 --direction from-github
 ```
 
 ## Examples
 
 ```bash
 # Interactive two-way sync (default - both directions)
-/specweave-github:sync 0004
+/sw-github:sync 0004
 
 # Use specific profile (still two-way by default)
-/specweave-github:sync 0004 --profile specweave-dev
+/sw-github:sync 0004 --profile specweave-dev
 
 # Specify time range (two-way)
-/specweave-github:sync 0004 --time-range 1M
+/sw-github:sync 0004 --time-range 1M
 
 # Full two-way sync with all options
-/specweave-github:sync 0004 --profile main --time-range 1M --tasks --labels
+/sw-github:sync 0004 --profile main --time-range 1M --tasks --labels
 
 # One-way sync examples (override default)
-/specweave-github:sync 0004 --direction to-github     # Push only
-/specweave-github:sync 0004 --direction from-github   # Pull only
+/sw-github:sync 0004 --direction to-github     # Push only
+/sw-github:sync 0004 --direction from-github   # Pull only
 
 # Dry run to preview changes
-/specweave-github:sync 0004 --dry-run
+/sw-github:sync 0004 --dry-run
 
 # Force sync all increments (two-way)
-/specweave-github:sync --all --force
+/sw-github:sync --all --force
 ```
 
 ## Interactive Workflow
@@ -431,8 +431,8 @@ Available profiles:
   • specweave-dev (GitHub: anton-abyzov/specweave)
   • another-repo (GitHub: myorg/another-project)
 
-Create profile: /specweave:sync-profile create
-List profiles: /specweave:sync-profile list
+Create profile: /sw:sync-profile create
+List profiles: /sw:sync-profile list
 ```
 
 ### No Profiles Configured
@@ -441,7 +441,7 @@ List profiles: /specweave:sync-profile list
 ❌ Error: No GitHub sync profiles configured
 
 Create your first profile:
-  /specweave:sync-profile create
+  /sw:sync-profile create
 
 Or migrate from old configuration:
   specweave migrate-to-profiles
@@ -459,7 +459,7 @@ Rate limit resets: 2025-11-04 15:00:00 (12 minutes)
 What would you like to do?
 
   1. Wait and resume (auto-resume in 12 min)
-  2. Resume manually later (/specweave-github:sync 0004 --resume)
+  2. Resume manually later (/sw-github:sync 0004 --resume)
   3. Cancel sync (partial data saved)
 
 Your choice: [1]
@@ -518,8 +518,8 @@ Output:
 ✅ Migration completed successfully!
 
 Next steps:
-  1. Review profiles: /specweave:sync-profile list
-  2. Test sync: /specweave-github:sync 0004
+  1. Review profiles: /sw:sync-profile list
+  2. Test sync: /sw-github:sync 0004
   3. Keep backup: .specweave/config.json.backup (until confirmed working)
 ```
 
@@ -529,7 +529,7 @@ If automatic profile creation fails:
 
 1. Create profile manually:
    ```bash
-   /specweave:sync-profile create
+   /sw:sync-profile create
    ```
 
 2. Update increment metadata:
@@ -544,7 +544,7 @@ If automatic profile creation fails:
 
 3. Test sync:
    ```bash
-   /specweave-github:sync 0004
+   /sw-github:sync 0004
    ```
 
 ## Simpler Alternatives
@@ -553,21 +553,21 @@ For most use cases, use the git-style commands:
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-github:pull` | Pull changes from GitHub (read-only) |
-| `/specweave-github:push` | Push progress to GitHub |
+| `/sw-github:pull` | Pull changes from GitHub (read-only) |
+| `/sw-github:push` | Push progress to GitHub |
 
-Use `/specweave-github:sync` for advanced operations with time ranges and rate limit control.
+Use `/sw-github:sync` for advanced operations with time ranges and rate limit control.
 
 ## Related Commands
 
 | Command | Purpose |
 |---------|---------|
-| `/specweave-github:pull` | Pull from GitHub (git-style) |
-| `/specweave-github:push` | Push to GitHub (git-style) |
-| `/specweave-github:create` | Create GitHub issue |
-| `/specweave-github:close` | Close GitHub issue |
-| `/specweave-github:status` | Check sync status |
-| `/specweave:sync-profile create` | Create new sync profile |
+| `/sw-github:pull` | Pull from GitHub (git-style) |
+| `/sw-github:push` | Push to GitHub (git-style) |
+| `/sw-github:create` | Create GitHub issue |
+| `/sw-github:close` | Close GitHub issue |
+| `/sw-github:status` | Check sync status |
+| `/sw:sync-profile create` | Create new sync profile |
 
 ## Tips & Best Practices
 
@@ -632,7 +632,7 @@ For active development:
 
 Before large syncs:
 ```bash
-/specweave-github:sync 0004 --dry-run --time-range 6M
+/sw-github:sync 0004 --dry-run --time-range 6M
 ```
 
 This shows what would happen without actually executing.
@@ -643,10 +643,10 @@ This shows what would happen without actually executing.
 
 ```bash
 # Sync all active increments (respects rate limits)
-/specweave-github:sync --all --time-range 1M
+/sw-github:sync --all --time-range 1M
 
 # Sync specific increments
-/specweave-github:sync 0001,0002,0003 --time-range 2W
+/sw-github:sync 0001,0002,0003 --time-range 2W
 ```
 
 ### Custom Rate Limit Thresholds
@@ -671,7 +671,7 @@ Override default thresholds:
 
 If sync fails mid-operation:
 ```bash
-/specweave-github:sync 0004 --resume
+/sw-github:sync 0004 --resume
 ```
 
 System will:
@@ -681,7 +681,7 @@ System will:
 
 ---
 
-**Command**: `/specweave-github:sync`
+**Command**: `/sw-github:sync`
 **Plugin**: specweave-github
 **Version**: 1.0.0 (Multi-Project)
 **Last Updated**: 2025-11-05

package/plugins/specweave-github/commands/update-user-story.md

@@ -1,5 +1,5 @@
 ---
-name: specweave-github:update-user-story
+name: sw-github:update-user-story
 description: Update GitHub issue for user story with proper ACs and tasks
 ---
 
@@ -12,7 +12,7 @@ description: Update GitHub issue for user story with proper ACs and tasks
 
 **Usage**:
 ```bash
-/specweave-github:update-user-story FS-031 US-004
+/sw-github:update-user-story FS-031 US-004
 ```
 
 **What It Does**:
@@ -35,7 +35,7 @@ description: Update GitHub issue for user story with proper ACs and tasks
 **Example**:
 ```bash
 # Update US-004 in FS-031
-/specweave-github:update-user-story FS-031 US-004
+/sw-github:update-user-story FS-031 US-004
 
 # Output:
 # 🔍 Finding user story: FS-031/US-004
@@ -109,9 +109,9 @@ Progress: 3/6 tasks complete (50%)
 - ✅ When you want to refresh issue content from living docs
 
 **Related Commands**:
-- `/specweave-github:sync-epic FS-031` - Sync entire epic (all user stories)
-- `/specweave-github:create-issue 0031` - Create issue for increment
-- `/specweave-github:sync 0031` - Two-way sync for increment
+- `/sw-github:sync-epic FS-031` - Sync entire epic (all user stories)
+- `/sw-github:create-issue 0031` - Create issue for increment
+- `/sw-github:sync 0031` - Two-way sync for increment
 
 ---
 

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

@@ -71,7 +71,7 @@ Log: "[GitHub] ✅ GitHub sync complete"
 - Created performance overhead and duplicate executions
 
 **New behavior (v0.26.0+)**:
-- Hook must be invoked manually via `/specweave-github:sync`
+- Hook must be invoked manually via `/sw-github:sync`
 - OR triggered on increment completion (not task completion)
 - Reduces API calls by 90%+
 - Eliminates duplicate hook executions
@@ -81,16 +81,16 @@ Log: "[GitHub] ✅ GitHub sync complete"
 **Manual Sync** (recommended workflow):
 ```bash
 # After completing several tasks, sync progress to GitHub
-/specweave-github:sync
+/sw-github:sync
 
 # Or sync specific feature
-/specweave-github:sync FS-048
+/sw-github:sync FS-048
 ```
 
 **Automatic Sync Options**:
 1. **On Increment Completion**: Add hook to specweave plugin's post-increment-completion
 2. **Periodic Sync**: Set up cron job or CI/CD trigger
-3. **On Demand**: Call `/specweave-github:sync` when needed
+3. **On Demand**: Call `/sw-github:sync` when needed
 
 ### Metadata Format
 
@@ -149,10 +149,10 @@ bash -n 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`
+1. Create increment: `/sw:increment "test feature"`
+2. Create GitHub issue: `/sw-github:create-issue 0001`
 3. Complete several tasks via TodoWrite
-4. **Manually trigger sync**: `/specweave-github:sync`
+4. **Manually trigger sync**: `/sw-github:sync`
 5. Check GitHub issue for updates
 
 ---
@@ -258,7 +258,7 @@ tail -f .specweave/logs/hooks-debug.log | grep '\[GitHub\]'
 ```
 
 **Common issues**:
-- ❌ No `metadata.json`: Create GitHub issue via `/specweave-github:create-issue`
+- ❌ No `metadata.json`: Create GitHub issue via `/sw-github:create-issue`
 - ❌ Not authenticated: Run `gh auth login`
 - ❌ Invalid issue number: Check `metadata.json` has correct issue ID
 - ❌ Network error: Check internet connection

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

@@ -259,7 +259,7 @@ fi
 # ⚠️  DEPRECATED: SpecWeave now syncs ONLY at User Story level.
 #
 # Feature/Epic-level issues are no longer updated.
-# Use /specweave-github:sync instead to sync User Story issues.
+# Use /sw-github:sync instead to sync User Story issues.
 #
 # To re-enable (NOT recommended):
 #   export SPECWEAVE_ENABLE_EPIC_SYNC=true
@@ -288,7 +288,7 @@ if [ "$SPECWEAVE_ENABLE_EPIC_SYNC" = "true" ]; then
     if [ -f "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" ]; then
       echo "[$(date)] [GitHub] 🚀 Updating Epic GitHub issue (DEPRECATED)..." >> "$DEBUG_LOG" 2>/dev/null || true
       "$PROJECT_ROOT/scripts/update-epic-github-issue.sh" "$ACTIVE_INCREMENT" >> "$DEBUG_LOG" 2>&1 || true
-      echo "[$(date)] [GitHub] ⚠️  Epic sync is deprecated. Use /specweave-github:sync instead." >> "$DEBUG_LOG" 2>/dev/null || true
+      echo "[$(date)] [GitHub] ⚠️  Epic sync is deprecated. Use /sw-github:sync instead." >> "$DEBUG_LOG" 2>/dev/null || true
     else
       echo "[$(date)] [GitHub] ⚠️  Epic sync script not found, skipping" >> "$DEBUG_LOG" 2>/dev/null || true
     fi

package/plugins/specweave-github/lib/ThreeLayerSyncManager.js

@@ -2,11 +2,19 @@ import * as fs from "../../../src/utils/fs-native.js";
 import path from "path";
 import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
 import { CodeValidator } from "./CodeValidator.js";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
 class ThreeLayerSyncManager {
   constructor(projectRoot = process.cwd()) {
     this.userStoryFileCache = /* @__PURE__ */ new Map();
     this.projectRoot = projectRoot;
     this.codeValidator = new CodeValidator({ projectRoot });
+    this.token = getGitHubAuthFromProject(projectRoot).token;
+  }
+  /**
+   * Get environment object with GH_TOKEN for gh CLI commands.
+   */
+  getGhEnv() {
+    return this.token ? { ...process.env, GH_TOKEN: this.token } : process.env;
   }
   /**
    * Clear User Story file cache
@@ -180,7 +188,7 @@ class ThreeLayerSyncManager {
       String(issueNumber),
       "--json",
       "body,state"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.stderr) {
       throw new Error(`Failed to fetch GitHub issue: ${result.stderr}`);
     }
@@ -506,7 +514,7 @@ $2`);
       String(issueNumber),
       "--json",
       "body"
-    ]);
+    ], { env: this.getGhEnv() });
     const { body } = JSON.parse(result.stdout);
     let updatedBody = body;
     for (const ac of acs) {
@@ -525,7 +533,7 @@ $2`);
       String(issueNumber),
       "--body",
       updatedBody
-    ]);
+    ], { env: this.getGhEnv() });
   }
   /**
    * Add comment to GitHub issue
@@ -537,7 +545,7 @@ $2`);
       String(issueNumber),
       "--body",
       comment
-    ]);
+    ], { env: this.getGhEnv() });
   }
 }
 export {

package/plugins/specweave-github/lib/ThreeLayerSyncManager.ts

@@ -22,6 +22,7 @@ import * as fs from '../../../src/utils/fs-native.js';
 import path from 'path';
 import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
 import { CodeValidator, type TaskValidationResult } from './CodeValidator.js';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
 
 /**
  * Acceptance Criterion with completion state
@@ -74,10 +75,21 @@ export class ThreeLayerSyncManager {
   private codeValidator: CodeValidator;
   private userStoryFileCache: Map<string, string | null> = new Map();
   private projectRoot: string;
+  private token?: string;
 
   constructor(projectRoot: string = process.cwd()) {
     this.projectRoot = projectRoot;
     this.codeValidator = new CodeValidator({ projectRoot });
+    this.token = getGitHubAuthFromProject(projectRoot).token;
+  }
+
+  /**
+   * Get environment object with GH_TOKEN for gh CLI commands.
+   */
+  private getGhEnv(): NodeJS.ProcessEnv {
+    return this.token
+      ? { ...process.env, GH_TOKEN: this.token }
+      : process.env;
   }
 
   /**
@@ -334,7 +346,7 @@ export class ThreeLayerSyncManager {
       String(issueNumber),
       '--json',
       'body,state'
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.stderr) {
       throw new Error(`Failed to fetch GitHub issue: ${result.stderr}`);
@@ -765,7 +777,7 @@ export class ThreeLayerSyncManager {
       String(issueNumber),
       '--json',
       'body'
-    ]);
+    ], { env: this.getGhEnv() });
 
     const { body } = JSON.parse(result.stdout);
 
@@ -791,7 +803,7 @@ export class ThreeLayerSyncManager {
       String(issueNumber),
       '--body',
       updatedBody
-    ]);
+    ], { env: this.getGhEnv() });
   }
 
   /**
@@ -804,6 +816,6 @@ export class ThreeLayerSyncManager {
       String(issueNumber),
       '--body',
       comment
-    ]);
+    ], { env: this.getGhEnv() });
   }
 }

package/plugins/specweave-github/lib/completion-calculator.js

@@ -34,7 +34,9 @@ class CompletionCalculator {
       tasksPercentage: tasks.length > 0 ? tasksCompleted / tasks.length * 100 : 0,
       overallComplete,
       blockingAcs: acs.filter((ac) => !ac.completed).map((ac) => ac.id),
-      blockingTasks: tasks.filter((t) => !t.completed).map((t) => t.id)
+      blockingTasks: tasks.filter((t) => !t.completed).map((t) => t.id),
+      // v0.35.1: Include frontmatter status for external-origin USs fallback
+      frontmatterStatus: frontmatter.status
     };
   }
   /**

package/plugins/specweave-github/lib/completion-calculator.ts

@@ -62,6 +62,10 @@ export interface CompletionStatus {
   // Blocking items (for reopen)
   blockingAcs: string[]; // List of incomplete AC-IDs
   blockingTasks: string[]; // List of incomplete Task-IDs
+
+  // Frontmatter status (fallback for external-origin USs without ACs/tasks)
+  // v0.35.1: Used when acsTotal=0 AND tasksTotal=0 to determine label
+  frontmatterStatus?: 'complete' | 'completed' | 'active' | 'planning' | 'not-started' | string;
 }
 
 /**
@@ -128,6 +132,8 @@ export class CompletionCalculator {
       overallComplete,
       blockingAcs: acs.filter((ac) => !ac.completed).map((ac) => ac.id),
       blockingTasks: tasks.filter((t) => !t.completed).map((t) => t.id),
+      // v0.35.1: Include frontmatter status for external-origin USs fallback
+      frontmatterStatus: frontmatter.status,
     };
   }
 

package/plugins/specweave-github/lib/duplicate-detector.js

@@ -1,4 +1,9 @@
 import { execFileSync } from "child_process";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
+function getGhEnv() {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token ? { ...process.env, GH_TOKEN: token } : process.env;
+}
 class DuplicateDetector {
   /**
    * PHASE 1: Detection (Before Creating Issue)
@@ -30,7 +35,7 @@ class DuplicateDetector {
       if (repo) {
         args.push("--repo", repo);
       }
-      const output = execFileSync("gh", args, { encoding: "utf-8" });
+      const output = execFileSync("gh", args, { encoding: "utf-8", env: getGhEnv() });
       const issues = JSON.parse(output);
       if (issues.length === 0) {
         console.log("   \u2705 No existing issues found (safe to create)");
@@ -76,6 +81,7 @@ class DuplicateDetector {
   static async verifyAfterCreate(titlePattern, expectedCount = 1, repo) {
     console.log(`
 \u{1F50D} VERIFICATION: Checking issue count for pattern: ${titlePattern}`);
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
     try {
       const args = [
         "issue",
@@ -92,7 +98,7 @@ class DuplicateDetector {
       if (repo) {
         args.push("--repo", repo);
       }
-      const output = execFileSync("gh", args, { encoding: "utf-8" });
+      const output = execFileSync("gh", args, { encoding: "utf-8", env: getGhEnv() });
       const issues = JSON.parse(output);
       const exactMatches = issues.filter(
         (issue) => issue.title.includes(titlePattern)
@@ -193,7 +199,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
         if (repo) {
           commentArgs.push("--repo", repo);
         }
-        execFileSync("gh", commentArgs, { encoding: "utf-8" });
+        execFileSync("gh", commentArgs, { encoding: "utf-8", env: getGhEnv() });
         const closeArgs = [
           "issue",
           "close",
@@ -202,7 +208,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
         if (repo) {
           closeArgs.push("--repo", repo);
         }
-        execFileSync("gh", closeArgs, { encoding: "utf-8" });
+        execFileSync("gh", closeArgs, { encoding: "utf-8", env: getGhEnv() });
         console.log(`      \u2705 Closed #${duplicate.number}`);
         closed++;
       } catch (error) {
@@ -286,7 +292,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
         assignees.forEach((assignee) => {
           args.push("--assignee", assignee);
         });
-        const output = execFileSync("gh", args, { encoding: "utf-8" });
+        const output = execFileSync("gh", args, { encoding: "utf-8", env: getGhEnv() });
         const match = output.match(/\/issues\/(\d+)/);
         if (!match) {
           throw new Error("Could not extract issue number from gh CLI output");
@@ -358,7 +364,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
    */
   static checkGitHubCLI() {
     try {
-      execFileSync("gh", ["auth", "status"], { encoding: "utf-8" });
+      execFileSync("gh", ["auth", "status"], { encoding: "utf-8", env: getGhEnv() });
       return true;
     } catch {
       return false;

package/plugins/specweave-github/lib/duplicate-detector.ts

@@ -31,6 +31,19 @@
  */
 
 import { execFileSync } from 'child_process';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
+
+/**
+ * Get environment object with GH_TOKEN for gh CLI commands.
+ * This ensures the token from .env is passed to all gh operations,
+ * regardless of `gh auth` status.
+ */
+function getGhEnv(): NodeJS.ProcessEnv {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token
+    ? { ...process.env, GH_TOKEN: token }
+    : process.env;
+}
 
 // ============================================================================
 // TYPE DEFINITIONS
@@ -115,7 +128,7 @@ export class DuplicateDetector {
         args.push('--repo', repo);
       }
 
-      const output = execFileSync('gh', args, { encoding: 'utf-8' });
+      const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
       const issues = JSON.parse(output) as GitHubIssue[];
 
       if (issues.length === 0) {
@@ -179,6 +192,9 @@ export class DuplicateDetector {
   ): Promise<VerificationResult> {
     console.log(`\n🔍 VERIFICATION: Checking issue count for pattern: ${titlePattern}`);
 
+    // ✅ GitHub API indexing delay: Wait 2 seconds for issue to be indexed
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
     try {
       const args = [
         'issue',
@@ -193,7 +209,7 @@ export class DuplicateDetector {
         args.push('--repo', repo);
       }
 
-      const output = execFileSync('gh', args, { encoding: 'utf-8' });
+      const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
       const issues = JSON.parse(output) as GitHubIssue[];
 
       // Filter exact matches only
@@ -318,7 +334,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
         }
 
         // Add comment explaining closure
-        execFileSync('gh', commentArgs, { encoding: 'utf-8' });
+        execFileSync('gh', commentArgs, { encoding: 'utf-8', env: getGhEnv() });
 
         const closeArgs = [
           'issue',
@@ -331,7 +347,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
         }
 
         // Close the issue
-        execFileSync('gh', closeArgs, { encoding: 'utf-8' });
+        execFileSync('gh', closeArgs, { encoding: 'utf-8', env: getGhEnv() });
 
         console.log(`      ✅ Closed #${duplicate.number}`);
         closed++;
@@ -429,7 +445,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
           args.push('--assignee', assignee);
         });
 
-        const output = execFileSync('gh', args, { encoding: 'utf-8' });
+        const output = execFileSync('gh', args, { encoding: 'utf-8', env: getGhEnv() });
 
         // Extract issue number from output (format: "https://github.com/owner/repo/issues/123")
         const match = output.match(/\/issues\/(\d+)/);
@@ -516,7 +532,7 @@ The original issue (#${keepIssueNumber}) should be used for tracking instead.
    */
   static checkGitHubCLI(): boolean {
     try {
-      execFileSync('gh', ['auth', 'status'], { encoding: 'utf-8' });
+      execFileSync('gh', ['auth', 'status'], { encoding: 'utf-8', env: getGhEnv() });
       return true;
     } catch {
       return false;

package/plugins/specweave-github/lib/github-board-resolver.js

@@ -1,4 +1,9 @@
 import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
+function getGhEnv() {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token ? { ...process.env, GH_TOKEN: token } : process.env;
+}
 async function fetchBoardsForRepo(owner, repo) {
   console.log(`\u{1F50D} Fetching project boards for repo: ${owner}/${repo}`);
   try {
@@ -9,7 +14,7 @@ async function fetchBoardsForRepo(owner, repo) {
       ".[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}",
       "-H",
       "Accept: application/vnd.github+json"
-    ]);
+    ], { env: getGhEnv() });
     if (result.status !== 0) {
       console.error(`\u274C Failed to fetch boards for ${owner}/${repo}:`, result.stderr);
       throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);
@@ -32,7 +37,7 @@ async function fetchBoardsForOrg(org) {
       ".[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}",
       "-H",
       "Accept: application/vnd.github+json"
-    ]);
+    ], { env: getGhEnv() });
     if (result.status !== 0) {
       console.error(`\u274C Failed to fetch boards for org ${org}:`, result.stderr);
       throw new Error(`GitHub API error: ${result.status} ${result.stderr}`);

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

@@ -6,6 +6,17 @@
  */
 
 import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
+
+/**
+ * Get environment object with GH_TOKEN for gh CLI commands.
+ */
+function getGhEnv(): NodeJS.ProcessEnv {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token
+    ? { ...process.env, GH_TOKEN: token }
+    : process.env;
+}
 
 /**
  * GitHub Project Board (Classic Projects)
@@ -41,7 +52,7 @@ export async function fetchBoardsForRepo(
       '.[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}',
       '-H',
       'Accept: application/vnd.github+json',
-    ]);
+    ], { env: getGhEnv() });
 
     if (result.status !== 0) {
       console.error(`❌ Failed to fetch boards for ${owner}/${repo}:`, result.stderr);
@@ -85,7 +96,7 @@ export async function fetchBoardsForOrg(
       '.[] | {id: .id, name: .name, number: .number, state: .state, html_url: .html_url}',
       '-H',
       'Accept: application/vnd.github+json',
-    ]);
+    ], { env: getGhEnv() });
 
     if (result.status !== 0) {
       console.error(`❌ Failed to fetch boards for org ${org}:`, result.stderr);