specweave 0.33.5 → 0.34.0

package/plugins/specweave-github/lib/github-client-v2.js

@@ -11,6 +11,17 @@ class GitHubClientV2 {
     this.owner = config.owner;
     this.repo = config.repo;
     this.fullRepo = `${this.owner}/${this.repo}`;
+    this.token = config.token;
+  }
+  /**
+   * 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.
+   *
+   * @returns Environment object with GH_TOKEN set if token available
+   */
+  getGhEnv() {
+    return this.token ? { ...process.env, GH_TOKEN: this.token } : process.env;
   }
   /**
    * Create client from owner/repo directly
@@ -110,7 +121,7 @@ class GitHubClientV2 {
     if (description) {
       args.splice(4, 0, "-f", `description=${description}`);
     }
-    const result = await execFileNoThrow("gh", args);
+    const result = await execFileNoThrow("gh", args, { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create milestone: ${result.stderr || result.stdout}`);
     }
@@ -125,7 +136,7 @@ class GitHubClientV2 {
       `repos/${this.fullRepo}/milestones`,
       "--jq",
       `.[] | select(.title=="${title}") | {number: .number, title: .title, description: .description, state: .state}`
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0 || !result.stdout.trim()) {
       return null;
     }
@@ -160,7 +171,7 @@ GitHub issues MUST use living docs format:
 WHY: Correct data flow is: Increment \u2192 Living Docs \u2192 GitHub
       Living docs are the source of truth for GitHub sync.
 
-FIX: Use /specweave:sync-docs to generate living docs, then sync to GitHub.`
+FIX: Use /sw:sync-docs to generate living docs, then sync to GitHub.`
       );
     }
     const typePrefixPattern = /^\[(BUG|HOTFIX|FEATURE|DOCS|REFACTOR|CHORE|EXPERIMENT|Bug|Hotfix|Feature|Docs|Refactor|Chore|Experiment)\]/i;
@@ -232,7 +243,7 @@ FIX:
           `repos/${this.fullRepo}/milestones/${milestone}`,
           "--jq",
           ".title"
-        ]);
+        ], { env: this.getGhEnv() });
         if (msResult.exitCode === 0 && msResult.stdout.trim()) {
           args.push("--milestone", msResult.stdout.trim());
         }
@@ -240,7 +251,7 @@ FIX:
         args.push("--milestone", milestone);
       }
     }
-    const createResult = await execFileNoThrow("gh", args);
+    const createResult = await execFileNoThrow("gh", args, { env: this.getGhEnv() });
     if (createResult.exitCode !== 0) {
       throw new Error(
         `Failed to create epic issue: ${createResult.stderr || createResult.stdout}`
@@ -274,7 +285,7 @@ ${body}`;
       this.fullRepo,
       "--json",
       "number,title,body,state,url,labels,milestone"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to get issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -313,7 +324,7 @@ ${body}`;
     if (includeClosedIssues) {
       args.push("--state", "all");
     }
-    const result = await execFileNoThrow("gh", args);
+    const result = await execFileNoThrow("gh", args, { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       return null;
     }
@@ -344,7 +355,7 @@ ${body}`;
       this.fullRepo,
       "--body",
       newBody
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to update issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -364,7 +375,7 @@ ${body}`;
       String(issueNumber),
       "--repo",
       this.fullRepo
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to close issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -387,7 +398,7 @@ ${body}`;
       String(issueNumber),
       "--repo",
       this.fullRepo
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to reopen issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -406,7 +417,7 @@ ${body}`;
       this.fullRepo,
       "--body",
       comment
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to add comment to issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -425,7 +436,7 @@ ${body}`;
       "--jq",
       ".[-1] | {body: .body, author: .user.login}"
       // Get last comment only
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       return null;
     }
@@ -453,7 +464,7 @@ ${body}`;
     for (const label of labels) {
       args.push("--add-label", label);
     }
-    const result = await execFileNoThrow("gh", args);
+    const result = await execFileNoThrow("gh", args, { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to add labels to issue #${issueNumber}: ${result.stderr || result.stdout}`
@@ -482,7 +493,7 @@ ${body}`;
       // Include both open and closed
       "--limit",
       "100"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0 || !result.stdout) {
       return [];
     }
@@ -510,7 +521,7 @@ ${body}`;
       "--limit",
       "1000"
       // Max results
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to list issues: ${result.stderr || result.stdout}`
@@ -578,7 +589,7 @@ ${body}`;
       "rate_limit",
       "--jq",
       ".rate | {remaining: .remaining, limit: .limit, reset: .reset}"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to check rate limit: ${result.stderr || result.stdout}`
@@ -669,7 +680,7 @@ ${body}`;
       "per_page=100",
       "--jq",
       jqFilter
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to fetch recent changes: ${result.stderr || result.stdout}`
@@ -717,7 +728,7 @@ ${body}`;
       `per_page=${perPage}`,
       "--jq",
       ".[].{event, created_at, actor: .actor.login}"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(
         `Failed to get issue events: ${result.stderr || result.stdout}`

package/plugins/specweave-github/lib/github-client-v2.ts

@@ -16,6 +16,7 @@ export class GitHubClientV2 {
   private owner: string;
   private repo: string;
   private fullRepo: string;
+  private token?: string;
 
   /**
    * Create GitHub client from sync profile
@@ -29,6 +30,20 @@ export class GitHubClientV2 {
     this.owner = config.owner;
     this.repo = config.repo;
     this.fullRepo = `${this.owner}/${this.repo}`;
+    this.token = config.token;
+  }
+
+  /**
+   * 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.
+   *
+   * @returns Environment object with GH_TOKEN set if token available
+   */
+  private getGhEnv(): NodeJS.ProcessEnv {
+    return this.token
+      ? { ...process.env, GH_TOKEN: this.token }
+      : process.env;
   }
 
   /**
@@ -159,7 +174,7 @@ export class GitHubClientV2 {
       args.splice(4, 0, '-f', `description=${description}`);
     }
 
-    const result = await execFileNoThrow('gh', args);
+    const result = await execFileNoThrow('gh', args, { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create milestone: ${result.stderr || result.stdout}`);
@@ -179,7 +194,7 @@ export class GitHubClientV2 {
       `repos/${this.fullRepo}/milestones`,
       '--jq',
       `.[] | select(.title=="${title}") | {number: .number, title: .title, description: .description, state: .state}`,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0 || !result.stdout.trim()) {
       return null;
@@ -216,7 +231,7 @@ export class GitHubClientV2 {
         `  ❌ WRONG: "[Increment XXXX] Title" (old format)\n\n` +
         `WHY: Correct data flow is: Increment → Living Docs → GitHub\n` +
         `      Living docs are the source of truth for GitHub sync.\n\n` +
-        `FIX: Use /specweave:sync-docs to generate living docs, then sync to GitHub.`
+        `FIX: Use /sw:sync-docs to generate living docs, then sync to GitHub.`
       );
     }
 
@@ -313,7 +328,7 @@ export class GitHubClientV2 {
           `repos/${this.fullRepo}/milestones/${milestone}`,
           '--jq',
           '.title'
-        ]);
+        ], { env: this.getGhEnv() });
 
         if (msResult.exitCode === 0 && msResult.stdout.trim()) {
           args.push('--milestone', msResult.stdout.trim());
@@ -325,7 +340,7 @@ export class GitHubClientV2 {
     }
 
     // Create issue (returns URL)
-    const createResult = await execFileNoThrow('gh', args);
+    const createResult = await execFileNoThrow('gh', args, { env: this.getGhEnv() });
 
     if (createResult.exitCode !== 0) {
       throw new Error(
@@ -372,7 +387,7 @@ export class GitHubClientV2 {
       this.fullRepo,
       '--json',
       'number,title,body,state,url,labels,milestone',
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -420,7 +435,7 @@ export class GitHubClientV2 {
       args.push('--state', 'all');
     }
 
-    const result = await execFileNoThrow('gh', args);
+    const result = await execFileNoThrow('gh', args, { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       // Search failed, return null (treat as not found)
@@ -457,7 +472,7 @@ export class GitHubClientV2 {
       this.fullRepo,
       '--body',
       newBody,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -480,7 +495,7 @@ export class GitHubClientV2 {
       String(issueNumber),
       '--repo',
       this.fullRepo,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -506,7 +521,7 @@ export class GitHubClientV2 {
       String(issueNumber),
       '--repo',
       this.fullRepo,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -527,7 +542,7 @@ export class GitHubClientV2 {
       this.fullRepo,
       '--body',
       comment,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -548,7 +563,7 @@ export class GitHubClientV2 {
       `repos/${this.fullRepo}/issues/${issueNumber}/comments`,
       '--jq',
       '.[-1] | {body: .body, author: .user.login}',  // Get last comment only
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       // If error, return null (no comments or API error)
@@ -585,7 +600,7 @@ export class GitHubClientV2 {
       args.push('--add-label', label);
     }
 
-    const result = await execFileNoThrow('gh', args);
+    const result = await execFileNoThrow('gh', args, { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -623,7 +638,7 @@ export class GitHubClientV2 {
       'all',  // Include both open and closed
       '--limit',
       '100',
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0 || !result.stdout) {
       return [];
@@ -661,7 +676,7 @@ export class GitHubClientV2 {
       'number,title,body,state,url,labels,milestone',
       '--limit',
       '1000', // Max results
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -747,7 +762,7 @@ export class GitHubClientV2 {
       'rate_limit',
       '--jq',
       '.rate | {remaining: .remaining, limit: .limit, reset: .reset}',
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -862,7 +877,7 @@ export class GitHubClientV2 {
       '-f', 'direction=desc',
       '-f', 'per_page=100',
       '--jq', jqFilter,
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(
@@ -916,7 +931,7 @@ export class GitHubClientV2 {
       `repos/${this.fullRepo}/issues/${issueNumber}/events`,
       '-f', `per_page=${perPage}`,
       '--jq', '.[].{event, created_at, actor: .actor.login}',
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(

package/plugins/specweave-github/lib/github-feature-sync.js

@@ -6,6 +6,7 @@ import { UserStoryIssueBuilder } from "./user-story-issue-builder.js";
 import { CompletionCalculator } from "./completion-calculator.js";
 import { DuplicateDetector } from "./duplicate-detector.js";
 import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
 const _GitHubFeatureSync = class _GitHubFeatureSync {
   // 30 seconds
   constructor(client, specsDir, projectRoot) {
@@ -13,6 +14,15 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
     this.specsDir = specsDir;
     this.projectRoot = projectRoot;
     this.calculator = new CompletionCalculator(projectRoot);
+    this.token = getGitHubAuthFromProject(projectRoot).token;
+  }
+  /**
+   * 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.
+   */
+  getGhEnv() {
+    return this.token ? { ...process.env, GH_TOKEN: this.token } : process.env;
   }
   /**
    * Sync Feature folder to GitHub (Milestone + User Story Issues)
@@ -236,7 +246,7 @@ const _GitHubFeatureSync = class _GitHubFeatureSync {
       "repos/:owner/:repo/milestones",
       "--jq",
       `.[] | select(.title == "${title}") | {number, html_url}`
-    ]);
+    ], { env: this.getGhEnv() });
     console.log(`   \u{1F50D} Milestone detection: exitCode=${existingResult.exitCode}, stdout length=${existingResult.stdout.length}`);
     if (existingResult.exitCode !== 0) {
       console.log(`   \u26A0\uFE0F  Detection failed: ${existingResult.stderr}`);
@@ -265,7 +275,7 @@ Created: ${featureData.created}`;
       `description=${description}`,
       "-f",
       "state=open"
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create Milestone: ${result.stderr || result.stdout}`);
     }
@@ -293,7 +303,7 @@ Created: ${featureData.created}`;
       "--milestone",
       milestoneTitle,
       ...issueContent.labels.flatMap((label) => ["--label", label])
-    ]);
+    ], { env: this.getGhEnv() });
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create GitHub Issue: ${result.stderr || result.stdout}`);
     }
@@ -310,7 +320,7 @@ Created: ${featureData.created}`;
         issueNumber.toString(),
         "--comment",
         this.calculator.buildCompletionComment(completion)
-      ]);
+      ], { env: this.getGhEnv() });
       console.log(
         `      \u2705 Created and verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`
       );
@@ -337,7 +347,7 @@ Created: ${featureData.created}`;
       issueContent.title,
       "--body",
       issueContent.body
-    ]);
+    ], { env: this.getGhEnv() });
     const completion = await this.calculator.calculateCompletion(userStoryPath);
     const issueData = await this.client.getIssue(issueNumber);
     const currentlyClosed = issueData.state === "closed";
@@ -349,7 +359,7 @@ Created: ${featureData.created}`;
           issueNumber.toString(),
           "--comment",
           this.calculator.buildCompletionComment(completion)
-        ]);
+        ], { env: this.getGhEnv() });
         console.log(
           `      \u2705 Verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`
         );
@@ -362,7 +372,7 @@ Created: ${featureData.created}`;
           issueNumber.toString(),
           "--comment",
           this.calculator.buildReopenComment(completion, "Work verification failed")
-        ]);
+        ], { env: this.getGhEnv() });
         console.log(
           `      \u26A0\uFE0F Reopened: ${completion.blockingAcs.length + completion.blockingTasks.length} items incomplete`
         );
@@ -391,6 +401,26 @@ Created: ${featureData.created}`;
         newStatusLabel = "status:complete";
       } else if (completion.acsPercentage > 0 || completion.tasksPercentage > 0) {
         newStatusLabel = "status:active";
+      } else if (
+        // v0.35.1 FIX: For external-origin USs without ACs/tasks, use frontmatter status
+        // This fixes issue #889 where external USs always showed "not_started"
+        (completion.acsTotal === 0 || completion.acsTotal === void 0) && (completion.tasksTotal === 0 || completion.tasksTotal === void 0) && completion.frontmatterStatus
+      ) {
+        switch (completion.frontmatterStatus) {
+          case "complete":
+          case "completed":
+            newStatusLabel = "status:complete";
+            break;
+          case "active":
+          case "in-progress":
+            newStatusLabel = "status:active";
+            break;
+          case "planning":
+          case "not-started":
+          default:
+            newStatusLabel = "status:not_started";
+        }
+        console.log(`      \u2139\uFE0F  Using frontmatter status (no ACs/tasks): ${completion.frontmatterStatus} \u2192 ${newStatusLabel}`);
       } else {
         newStatusLabel = "status:not_started";
       }
@@ -405,7 +435,7 @@ Created: ${featureData.created}`;
           issueNumber.toString(),
           "--remove-label",
           ...statusLabels
-        ]);
+        ], { env: this.getGhEnv() });
       }
       const result = await execFileNoThrow("gh", [
         "issue",
@@ -413,7 +443,7 @@ Created: ${featureData.created}`;
         issueNumber.toString(),
         "--add-label",
         newStatusLabel
-      ]);
+      ], { env: this.getGhEnv() });
       if (result.exitCode === 0) {
         console.log(`      \u{1F3F7}\uFE0F  Updated label: ${newStatusLabel}`);
       } else {
@@ -446,7 +476,7 @@ Created: ${featureData.created}`;
         "--jq",
         ".[-1] | {body: .body, created_at: .created_at}"
         // Get last comment only
-      ]);
+      ], { env: this.getGhEnv() });
       let lastCommentBody = "";
       if (commentsResult.exitCode === 0 && commentsResult.stdout.trim()) {
         try {
@@ -473,7 +503,7 @@ Created: ${featureData.created}`;
         issueNumber.toString(),
         "--body",
         newCommentBody
-      ]);
+      ], { env: this.getGhEnv() });
       console.log(
         `      \u{1F4CA} Progress: ${completion.acsPercentage.toFixed(0)}% ACs, ${completion.tasksPercentage.toFixed(0)}% tasks (updated)`
       );

package/plugins/specweave-github/lib/github-feature-sync.ts

@@ -19,6 +19,7 @@ import { UserStoryIssueBuilder } from './user-story-issue-builder.js';
 import { CompletionCalculator } from './completion-calculator.js';
 import { DuplicateDetector } from './duplicate-detector.js';
 import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
 
 interface FeatureFrontmatter {
   id: string;
@@ -51,6 +52,7 @@ export class GitHubFeatureSync {
   private specsDir: string;
   private projectRoot: string;
   private calculator: CompletionCalculator;
+  private token?: string;
 
   // SYNC LOCK: Prevent concurrent syncs of the same feature
   // Maps featureId → last sync timestamp
@@ -62,6 +64,19 @@ export class GitHubFeatureSync {
     this.specsDir = specsDir;
     this.projectRoot = projectRoot;
     this.calculator = new CompletionCalculator(projectRoot);
+    // Get token from .env for gh CLI passthrough
+    this.token = getGitHubAuthFromProject(projectRoot).token;
+  }
+
+  /**
+   * 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.
+   */
+  private getGhEnv(): NodeJS.ProcessEnv {
+    return this.token
+      ? { ...process.env, GH_TOKEN: this.token }
+      : process.env;
   }
 
   /**
@@ -393,7 +408,7 @@ export class GitHubFeatureSync {
       'repos/:owner/:repo/milestones',
       '--jq',
       `.[] | select(.title == "${title}") | {number, html_url}`,
-    ]);
+    ], { env: this.getGhEnv() });
 
     // DEBUG: Log detection result
     console.log(`   🔍 Milestone detection: exitCode=${existingResult.exitCode}, stdout length=${existingResult.stdout.length}`);
@@ -426,7 +441,7 @@ export class GitHubFeatureSync {
       `description=${description}`,
       '-f',
       'state=open',
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create Milestone: ${result.stderr || result.stdout}`);
@@ -467,7 +482,7 @@ export class GitHubFeatureSync {
       '--milestone',
       milestoneTitle,
       ...issueContent.labels.flatMap((label) => ['--label', label]),
-    ]);
+    ], { env: this.getGhEnv() });
 
     if (result.exitCode !== 0) {
       throw new Error(`Failed to create GitHub Issue: ${result.stderr || result.stdout}`);
@@ -493,7 +508,7 @@ export class GitHubFeatureSync {
         issueNumber.toString(),
         '--comment',
         this.calculator.buildCompletionComment(completion),
-      ]);
+      ], { env: this.getGhEnv() });
       console.log(
         `      ✅ Created and verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`
       );
@@ -535,7 +550,7 @@ export class GitHubFeatureSync {
       issueContent.title,
       '--body',
       issueContent.body,
-    ]);
+    ], { env: this.getGhEnv() });
 
     // ✅ VERIFICATION GATE: Calculate ACTUAL completion from checkboxes
     const completion = await this.calculator.calculateCompletion(userStoryPath);
@@ -554,7 +569,7 @@ export class GitHubFeatureSync {
           issueNumber.toString(),
           '--comment',
           this.calculator.buildCompletionComment(completion),
-        ]);
+        ], { env: this.getGhEnv() });
         console.log(
           `      ✅ Verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`
         );
@@ -569,7 +584,7 @@ export class GitHubFeatureSync {
           issueNumber.toString(),
           '--comment',
           this.calculator.buildReopenComment(completion, 'Work verification failed'),
-        ]);
+        ], { env: this.getGhEnv() });
         console.log(
           `      ⚠️ Reopened: ${completion.blockingAcs.length + completion.blockingTasks.length} items incomplete`
         );
@@ -597,6 +612,9 @@ export class GitHubFeatureSync {
       overallComplete: boolean;
       acsPercentage: number;
       tasksPercentage: number;
+      acsTotal?: number;
+      tasksTotal?: number;
+      frontmatterStatus?: string;
     }
   ): Promise<void> {
     try {
@@ -615,6 +633,29 @@ export class GitHubFeatureSync {
         newStatusLabel = 'status:complete'; // Repository uses "complete" not "completed"
       } else if (completion.acsPercentage > 0 || completion.tasksPercentage > 0) {
         newStatusLabel = 'status:active'; // Repository uses "active" not "in-progress"
+      } else if (
+        // v0.35.1 FIX: For external-origin USs without ACs/tasks, use frontmatter status
+        // This fixes issue #889 where external USs always showed "not_started"
+        (completion.acsTotal === 0 || completion.acsTotal === undefined) &&
+        (completion.tasksTotal === 0 || completion.tasksTotal === undefined) &&
+        completion.frontmatterStatus
+      ) {
+        // Map frontmatter status to GitHub label
+        switch (completion.frontmatterStatus) {
+          case 'complete':
+          case 'completed':
+            newStatusLabel = 'status:complete';
+            break;
+          case 'active':
+          case 'in-progress':
+            newStatusLabel = 'status:active';
+            break;
+          case 'planning':
+          case 'not-started':
+          default:
+            newStatusLabel = 'status:not_started';
+        }
+        console.log(`      ℹ️  Using frontmatter status (no ACs/tasks): ${completion.frontmatterStatus} → ${newStatusLabel}`);
       } else {
         newStatusLabel = 'status:not_started';
       }
@@ -637,7 +678,7 @@ export class GitHubFeatureSync {
           issueNumber.toString(),
           '--remove-label',
           ...statusLabels,
-        ]);
+        ], { env: this.getGhEnv() });
       }
 
       // Step 2: Add new status label
@@ -647,7 +688,7 @@ export class GitHubFeatureSync {
         issueNumber.toString(),
         '--add-label',
         newStatusLabel,
-      ]);
+      ], { env: this.getGhEnv() });
 
       if (result.exitCode === 0) {
         console.log(`      🏷️  Updated label: ${newStatusLabel}`);
@@ -686,7 +727,7 @@ export class GitHubFeatureSync {
         'repos/:owner/:repo/issues/' + issueNumber + '/comments',
         '--jq',
         '.[-1] | {body: .body, created_at: .created_at}',  // Get last comment only
-      ]);
+      ], { env: this.getGhEnv() });
 
       let lastCommentBody = '';
       if (commentsResult.exitCode === 0 && commentsResult.stdout.trim()) {
@@ -727,7 +768,7 @@ export class GitHubFeatureSync {
         issueNumber.toString(),
         '--body',
         newCommentBody,
-      ]);
+      ], { env: this.getGhEnv() });
       console.log(
         `      📊 Progress: ${completion.acsPercentage.toFixed(0)}% ACs, ${completion.tasksPercentage.toFixed(0)}% tasks (updated)`
       );