specweave 0.18.0 → 0.20.0

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

@@ -0,0 +1,87 @@
+/**
+ * GitHub Feature Sync - Universal Hierarchy Implementation
+ *
+ * Architecture (CORRECT):
+ * - Feature (FS-033) → GitHub Milestone (Container)
+ * - User Story (US-001, US-002, etc.) → GitHub Issue (Trackable item)
+ * - Tasks (T-001, T-002, etc.) → Checkboxes in User Story issue body
+ *
+ * This implements the TRUE Universal Hierarchy architecture for GitHub.
+ *
+ * Key Differences from old github-epic-sync.ts:
+ * - ❌ OLD: Feature/Increment → GitHub Issue (WRONG!)
+ * - ✅ NEW: User Story → GitHub Issue (CORRECT!)
+ * - ✅ Creates ONE issue PER user story file (not one per increment)
+ * - ✅ Reads us-*.md files from specs/{project}/FS-XXX/
+ */
+import { GitHubClientV2 } from './github-client-v2.js';
+export declare class GitHubFeatureSync {
+    private client;
+    private specsDir;
+    private projectRoot;
+    private calculator;
+    constructor(client: GitHubClientV2, specsDir: string, projectRoot: string);
+    /**
+     * Sync Feature folder to GitHub (Milestone + User Story Issues)
+     *
+     * Process:
+     * 1. Create/update GitHub Milestone for Feature
+     * 2. Find all us-*.md files across all projects
+     * 3. Create/update GitHub Issue for EACH user story
+     * 4. Update frontmatter with GitHub issue links
+     */
+    syncFeatureToGitHub(featureId: string): Promise<{
+        milestoneNumber: number;
+        milestoneUrl: string;
+        issuesCreated: number;
+        issuesUpdated: number;
+        userStoriesProcessed: number;
+    }>;
+    /**
+     * Find Feature folder in specs directory
+     */
+    private findFeatureFolder;
+    /**
+     * Parse FEATURE.md frontmatter
+     */
+    private parseFeatureMd;
+    /**
+     * Find all User Story files for this feature across all projects
+     */
+    private findUserStories;
+    /**
+     * Find all project folders (default, backend, frontend, etc.)
+     */
+    private findProjectFolders;
+    /**
+     * Create GitHub Milestone for Feature
+     */
+    private createMilestone;
+    /**
+     * Create GitHub Issue for User Story with AC/Task Verification
+     *
+     * ✅ VERIFICATION GATE FIX:
+     * - Verifies actual completion before closing
+     * - Prevents premature closure on creation
+     */
+    private createUserStoryIssue;
+    /**
+     * Update existing GitHub Issue for User Story with AC/Task Verification
+     *
+     * ✅ VERIFICATION GATE FIX:
+     * - OLD: Closed based on frontmatter `status: complete`
+     * - NEW: Closes ONLY if all ACs and tasks are [x]
+     *
+     * This prevents Issue #574 type bugs (premature closure)
+     */
+    private updateUserStoryIssue;
+    /**
+     * Update FEATURE.md with GitHub Milestone link
+     */
+    private updateFeatureMd;
+    /**
+     * Update User Story frontmatter with GitHub issue link
+     */
+    private updateUserStoryFrontmatter;
+}
+//# sourceMappingURL=github-feature-sync.d.ts.map

package/dist/plugins/specweave-github/lib/github-feature-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-feature-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-feature-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA+BvD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAuB;gBAE7B,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAOzE;;;;;;;;OAQG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QACpD,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IAsIF;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,cAAc;IAW5B;;OAEG;YACW,eAAe;IA4C7B;;OAEG;YACW,kBAAkB;IAgBhC;;OAEG;YACW,eAAe;IA+B7B;;;;;;OAMG;YACW,oBAAoB;IAoElC;;;;;;;;OAQG;YACW,oBAAoB;IA2ElC;;OAEG;YACW,eAAe;IA+B7B;;OAEG;YACW,0BAA0B;CA8BzC"}

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

@@ -0,0 +1,412 @@
+/**
+ * GitHub Feature Sync - Universal Hierarchy Implementation
+ *
+ * Architecture (CORRECT):
+ * - Feature (FS-033) → GitHub Milestone (Container)
+ * - User Story (US-001, US-002, etc.) → GitHub Issue (Trackable item)
+ * - Tasks (T-001, T-002, etc.) → Checkboxes in User Story issue body
+ *
+ * This implements the TRUE Universal Hierarchy architecture for GitHub.
+ *
+ * Key Differences from old github-epic-sync.ts:
+ * - ❌ OLD: Feature/Increment → GitHub Issue (WRONG!)
+ * - ✅ NEW: User Story → GitHub Issue (CORRECT!)
+ * - ✅ Creates ONE issue PER user story file (not one per increment)
+ * - ✅ Reads us-*.md files from specs/{project}/FS-XXX/
+ */
+import { readdir, readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { UserStoryIssueBuilder } from './user-story-issue-builder.js';
+import { CompletionCalculator } from './completion-calculator.js';
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+export class GitHubFeatureSync {
+    constructor(client, specsDir, projectRoot) {
+        this.client = client;
+        this.specsDir = specsDir;
+        this.projectRoot = projectRoot;
+        this.calculator = new CompletionCalculator(projectRoot);
+    }
+    /**
+     * Sync Feature folder to GitHub (Milestone + User Story Issues)
+     *
+     * Process:
+     * 1. Create/update GitHub Milestone for Feature
+     * 2. Find all us-*.md files across all projects
+     * 3. Create/update GitHub Issue for EACH user story
+     * 4. Update frontmatter with GitHub issue links
+     */
+    async syncFeatureToGitHub(featureId) {
+        console.log(`\n🔄 Syncing Feature ${featureId} to GitHub...`);
+        // 1. Load Feature FEATURE.md
+        const featureFolder = await this.findFeatureFolder(featureId);
+        if (!featureFolder) {
+            throw new Error(`Feature ${featureId} not found in ${this.specsDir}`);
+        }
+        const featurePath = path.join(featureFolder, 'FEATURE.md');
+        const featureData = await this.parseFeatureMd(featurePath);
+        console.log(`   📦 Feature: ${featureData.title}`);
+        console.log(`   📊 Status: ${featureData.status}`);
+        // 2. Create or update GitHub Milestone
+        let milestoneNumber = featureData.external_tools?.github?.id;
+        let milestoneUrl = featureData.external_tools?.github?.url;
+        if (!milestoneNumber) {
+            console.log(`   🚀 Creating GitHub Milestone...`);
+            const milestone = await this.createMilestone(featureData);
+            milestoneNumber = milestone.number;
+            milestoneUrl = milestone.url;
+            console.log(`   ✅ Created Milestone #${milestoneNumber}`);
+            // Update FEATURE.md with Milestone ID
+            await this.updateFeatureMd(featurePath, {
+                type: 'milestone',
+                id: milestoneNumber,
+                url: milestoneUrl,
+            });
+        }
+        else {
+            console.log(`   ♻️  Using existing Milestone #${milestoneNumber}`);
+            milestoneUrl = featureData.external_tools?.github?.url || milestoneUrl;
+        }
+        // 3. Find all User Story files across all projects
+        const userStories = await this.findUserStories(featureId);
+        console.log(`\n   📝 Found ${userStories.length} User Stories to sync...`);
+        // 4. Sync each User Story as GitHub Issue
+        let issuesCreated = 0;
+        let issuesUpdated = 0;
+        for (const userStory of userStories) {
+            console.log(`\n   🔹 Processing ${userStory.id}: ${userStory.title}`);
+            // Build issue content using UserStoryIssueBuilder
+            const repoInfo = {
+                owner: this.client.getOwner(),
+                repo: this.client.getRepo(),
+                branch: 'develop' // TODO: detect from git
+            };
+            const builder = new UserStoryIssueBuilder(userStory.filePath, this.projectRoot, featureId, repoInfo);
+            const issueContent = await builder.buildIssueBody();
+            // ✅ FIX: Add status to issue content for sync
+            issueContent.status = userStory.status;
+            // ✅ TRIPLE IDEMPOTENCY CHECK
+            // This ensures 100% safety when running sync multiple times
+            // Check 1: User Story frontmatter has issue number
+            if (userStory.existingIssue) {
+                console.log(`      ♻️  Issue #${userStory.existingIssue} exists in frontmatter`);
+                try {
+                    // Verify issue still exists on GitHub
+                    await this.client.getIssue(userStory.existingIssue);
+                    // Issue exists, update it with verification
+                    await this.updateUserStoryIssue(userStory.existingIssue, issueContent, userStory.filePath);
+                    issuesUpdated++;
+                    console.log(`      ✅ Updated Issue #${userStory.existingIssue}`);
+                    continue;
+                }
+                catch (err) {
+                    // Issue deleted on GitHub, fall through to create new
+                    console.log(`      ⚠️  Issue #${userStory.existingIssue} deleted on GitHub, creating new`);
+                }
+            }
+            // Check 2: Search GitHub for issue by title
+            const existingByTitle = await this.client.searchIssueByTitle(issueContent.title);
+            if (existingByTitle) {
+                console.log(`      ♻️  Found existing issue by title: #${existingByTitle.number}`);
+                // Link it in frontmatter
+                await this.updateUserStoryFrontmatter(userStory.filePath, existingByTitle.number);
+                // Update content with verification
+                await this.updateUserStoryIssue(existingByTitle.number, issueContent, userStory.filePath);
+                issuesUpdated++;
+                console.log(`      ✅ Linked and updated Issue #${existingByTitle.number}`);
+                continue;
+            }
+            // Check 3: No existing issue found, create new
+            console.log(`      🚀 Creating new issue: ${issueContent.title}`);
+            const milestoneTitle = `${featureData.id}: ${featureData.title}`;
+            const issueNumber = await this.createUserStoryIssue(issueContent, milestoneTitle, userStory.filePath);
+            issuesCreated++;
+            console.log(`      ✅ Created Issue #${issueNumber}`);
+            // Update User Story frontmatter
+            await this.updateUserStoryFrontmatter(userStory.filePath, issueNumber);
+        }
+        console.log(`\n✅ Feature sync complete!`);
+        console.log(`   Milestone: ${milestoneUrl}`);
+        console.log(`   User Stories: ${userStories.length}`);
+        console.log(`   Issues created: ${issuesCreated}`);
+        console.log(`   Issues updated: ${issuesUpdated}`);
+        return {
+            milestoneNumber: milestoneNumber,
+            milestoneUrl: milestoneUrl,
+            issuesCreated,
+            issuesUpdated,
+            userStoriesProcessed: userStories.length,
+        };
+    }
+    /**
+     * Find Feature folder in specs directory
+     */
+    async findFeatureFolder(featureId) {
+        // Check _features folder first
+        const featuresFolder = path.join(this.specsDir, '_features', featureId);
+        if (existsSync(featuresFolder)) {
+            return featuresFolder;
+        }
+        return null;
+    }
+    /**
+     * Parse FEATURE.md frontmatter
+     */
+    async parseFeatureMd(featurePath) {
+        const content = await readFile(featurePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error(`${featurePath}: Missing YAML frontmatter`);
+        }
+        return yaml.parse(match[1]);
+    }
+    /**
+     * Find all User Story files for this feature across all projects
+     */
+    async findUserStories(featureId) {
+        const userStories = [];
+        // Find all project folders
+        const projectFolders = await this.findProjectFolders();
+        for (const projectFolder of projectFolders) {
+            const featureSpecsFolder = path.join(projectFolder, featureId);
+            if (!existsSync(featureSpecsFolder)) {
+                continue; // Feature not present in this project
+            }
+            // Read all us-*.md files
+            const files = await readdir(featureSpecsFolder);
+            const usFiles = files.filter((f) => f.startsWith('us-') && f.endsWith('.md'));
+            for (const file of usFiles.sort()) {
+                const filePath = path.join(featureSpecsFolder, file);
+                const content = await readFile(filePath, 'utf-8');
+                const match = content.match(/^---\n([\s\S]*?)\n---/);
+                if (!match) {
+                    console.warn(`   ⚠️  ${file}: Missing frontmatter, skipping`);
+                    continue;
+                }
+                const frontmatter = yaml.parse(match[1]);
+                const projectName = path.basename(projectFolder);
+                userStories.push({
+                    id: frontmatter.id || file.match(/us-(\d+)/)?.[0]?.toUpperCase() || 'UNKNOWN',
+                    title: frontmatter.title || 'Untitled User Story',
+                    filePath,
+                    project: projectName,
+                    status: frontmatter.status || 'not-started',
+                    existingIssue: frontmatter.external?.github?.issue || null,
+                });
+            }
+        }
+        return userStories;
+    }
+    /**
+     * Find all project folders (default, backend, frontend, etc.)
+     */
+    async findProjectFolders() {
+        const folders = [];
+        const specsRoot = this.specsDir;
+        // Read all directories in specs root
+        const entries = await readdir(specsRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && !entry.name.startsWith('_')) {
+                folders.push(path.join(specsRoot, entry.name));
+            }
+        }
+        return folders;
+    }
+    /**
+     * Create GitHub Milestone for Feature
+     */
+    async createMilestone(featureData) {
+        const title = `${featureData.id}: ${featureData.title}`;
+        const description = `Feature ${featureData.id}\n\nStatus: ${featureData.status}\nCreated: ${featureData.created}`;
+        const result = await execFileNoThrow('gh', [
+            'api',
+            'repos/:owner/:repo/milestones',
+            '-X',
+            'POST',
+            '-f',
+            `title=${title}`,
+            '-f',
+            `description=${description}`,
+            '-f',
+            'state=open',
+        ]);
+        if (result.exitCode !== 0) {
+            throw new Error(`Failed to create Milestone: ${result.stderr || result.stdout}`);
+        }
+        const milestone = JSON.parse(result.stdout);
+        return {
+            number: milestone.number,
+            url: milestone.html_url,
+        };
+    }
+    /**
+     * Create GitHub Issue for User Story with AC/Task Verification
+     *
+     * ✅ VERIFICATION GATE FIX:
+     * - Verifies actual completion before closing
+     * - Prevents premature closure on creation
+     */
+    async createUserStoryIssue(issueContent, milestoneTitle, userStoryPath) {
+        // Step 1: Create issue (always open initially - gh CLI limitation)
+        const result = await execFileNoThrow('gh', [
+            'issue',
+            'create',
+            '--title',
+            issueContent.title,
+            '--body',
+            issueContent.body,
+            '--milestone',
+            milestoneTitle,
+            ...issueContent.labels.flatMap((label) => ['--label', label]),
+        ]);
+        if (result.exitCode !== 0) {
+            throw new Error(`Failed to create GitHub Issue: ${result.stderr || result.stdout}`);
+        }
+        // Parse issue number from output
+        // Format: "https://github.com/owner/repo/issues/123"
+        const match = result.stdout.match(/issues\/(\d+)/);
+        if (!match) {
+            throw new Error(`Failed to parse issue number from: ${result.stdout}`);
+        }
+        const issueNumber = parseInt(match[1], 10);
+        // Step 2: VERIFICATION GATE - Close only if ACs/tasks verified
+        const completion = await this.calculator.calculateCompletion(userStoryPath);
+        if (completion.overallComplete) {
+            // ✅ SAFE TO CLOSE - All ACs and tasks verified [x]
+            await execFileNoThrow('gh', [
+                'issue',
+                'close',
+                issueNumber.toString(),
+                '--comment',
+                this.calculator.buildCompletionComment(completion),
+            ]);
+            console.log(`      ✅ Created and verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`);
+        }
+        else {
+            // ⚠️ INCOMPLETE - Leave open with progress comment
+            await execFileNoThrow('gh', [
+                'issue',
+                'comment',
+                issueNumber.toString(),
+                '--body',
+                this.calculator.buildProgressComment(completion),
+            ]);
+            console.log(`      📊 Created: ${completion.acsPercentage.toFixed(0)}% ACs, ${completion.tasksPercentage.toFixed(0)}% tasks`);
+        }
+        return issueNumber;
+    }
+    /**
+     * Update existing GitHub Issue for User Story with AC/Task Verification
+     *
+     * ✅ VERIFICATION GATE FIX:
+     * - OLD: Closed based on frontmatter `status: complete`
+     * - NEW: Closes ONLY if all ACs and tasks are [x]
+     *
+     * This prevents Issue #574 type bugs (premature closure)
+     */
+    async updateUserStoryIssue(issueNumber, issueContent, userStoryPath) {
+        // Update issue body
+        await execFileNoThrow('gh', [
+            'issue',
+            'edit',
+            issueNumber.toString(),
+            '--title',
+            issueContent.title,
+            '--body',
+            issueContent.body,
+        ]);
+        // ✅ VERIFICATION GATE: Calculate ACTUAL completion from checkboxes
+        const completion = await this.calculator.calculateCompletion(userStoryPath);
+        // Get current issue state
+        const issueData = await this.client.getIssue(issueNumber);
+        const currentlyClosed = issueData.state === 'closed';
+        // DECISION LOGIC: Close/Reopen/Update based on VERIFIED completion
+        if (completion.overallComplete) {
+            // ✅ SAFE TO CLOSE - All ACs and tasks verified [x]
+            if (!currentlyClosed) {
+                await execFileNoThrow('gh', [
+                    'issue',
+                    'close',
+                    issueNumber.toString(),
+                    '--comment',
+                    this.calculator.buildCompletionComment(completion),
+                ]);
+                console.log(`      ✅ Verified complete: ${completion.acsCompleted}/${completion.acsTotal} ACs, ${completion.tasksCompleted}/${completion.tasksTotal} tasks`);
+            }
+        }
+        else {
+            // ⚠️ INCOMPLETE - Keep open or reopen if needed
+            if (currentlyClosed) {
+                // Issue was closed prematurely - REOPEN
+                await execFileNoThrow('gh', [
+                    'issue',
+                    'reopen',
+                    issueNumber.toString(),
+                    '--comment',
+                    this.calculator.buildReopenComment(completion, 'Work verification failed'),
+                ]);
+                console.log(`      ⚠️ Reopened: ${completion.blockingAcs.length + completion.blockingTasks.length} items incomplete`);
+            }
+            else {
+                // Update progress comment
+                await execFileNoThrow('gh', [
+                    'issue',
+                    'comment',
+                    issueNumber.toString(),
+                    '--body',
+                    this.calculator.buildProgressComment(completion),
+                ]);
+                console.log(`      📊 Progress: ${completion.acsPercentage.toFixed(0)}% ACs, ${completion.tasksPercentage.toFixed(0)}% tasks`);
+            }
+        }
+        // Note: Labels are not updated to avoid overwriting manually added labels
+    }
+    /**
+     * Update FEATURE.md with GitHub Milestone link
+     */
+    async updateFeatureMd(featurePath, milestone) {
+        const content = await readFile(featurePath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error(`${featurePath}: Missing YAML frontmatter`);
+        }
+        const frontmatter = yaml.parse(match[1]);
+        // Update external_tools.github
+        if (!frontmatter.external_tools) {
+            frontmatter.external_tools = {};
+        }
+        frontmatter.external_tools.github = milestone;
+        // Rebuild content
+        const newFrontmatter = yaml.stringify(frontmatter);
+        const bodyContent = content.slice(match[0].length);
+        const newContent = `---\n${newFrontmatter}---${bodyContent}`;
+        await writeFile(featurePath, newContent, 'utf-8');
+    }
+    /**
+     * Update User Story frontmatter with GitHub issue link
+     */
+    async updateUserStoryFrontmatter(userStoryPath, issueNumber) {
+        const content = await readFile(userStoryPath, 'utf-8');
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match) {
+            throw new Error(`${userStoryPath}: Missing YAML frontmatter`);
+        }
+        const frontmatter = yaml.parse(match[1]);
+        // Update external.github
+        if (!frontmatter.external) {
+            frontmatter.external = {};
+        }
+        if (!frontmatter.external.github) {
+            frontmatter.external.github = {};
+        }
+        frontmatter.external.github.issue = issueNumber;
+        frontmatter.external.github.url = `https://github.com/anton-abyzov/specweave/issues/${issueNumber}`;
+        // Rebuild content
+        const newFrontmatter = yaml.stringify(frontmatter);
+        const bodyContent = content.slice(match[0].length);
+        const newContent = `---\n${newFrontmatter}---${bodyContent}`;
+        await writeFile(userStoryPath, newContent, 'utf-8');
+    }
+}
+//# sourceMappingURL=github-feature-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-feature-sync.js","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-feature-sync.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-spec-content-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-spec-content-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-content-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAQL,iBAAiB,EAClB,MAAM,wCAAwC,CAAC;AAIhD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4CD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA4D5B;AA6KD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF"}
+{"version":3,"file":"github-spec-content-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-content-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAQL,iBAAiB,EAClB,MAAM,wCAAwC,CAAC;AAKhD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4CD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA4D5B;AAgPD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF"}

package/dist/plugins/specweave-github/lib/github-spec-content-sync.js

@@ -10,6 +10,7 @@
  */
 import { GitHubClientV2 } from './github-client-v2.js';
 import { parseSpecContent, detectContentChanges, buildExternalDescription, hasExternalLink, updateSpecWithExternalLink, } from '../../../src/core/spec-content-sync.js';
+import { ProgressCommentBuilder } from './progress-comment-builder.js';
 import path from 'path';
 import fs from 'fs/promises';
 /**
@@ -161,6 +162,11 @@ async function createGitHubIssue(client, spec, options) {
 }
 /**
  * Update existing GitHub issue with spec content
+ *
+ * ARCHITECTURE: IMMUTABLE DESCRIPTIONS (Phase 4)
+ * - Issue description is NEVER edited after creation
+ * - All content updates communicated via progress comments
+ * - Metadata updates only (labels, milestone, assignees)
  */
 async function updateGitHubIssue(client, spec, issueNumber, options) {
     const { specPath, dryRun, verbose } = options;
@@ -195,30 +201,34 @@ async function updateGitHubIssue(client, spec, issueNumber, options) {
                 console.log(`      - ${change}`);
             }
         }
-        // Build updated content using compact format
-        const newTitle = `[${spec.identifier.compact}] ${spec.title}`;
-        const newBody = buildExternalDescription(spec);
         if (dryRun) {
-            console.log('\n🔍 Dry run - would update issue:');
-            console.log(`   Title: ${newTitle}`);
-            console.log(`   Body:\n${newBody}`);
+            console.log('\n🔍 Dry run - would post progress comment');
             return {
                 success: true,
-                action: 'updated',
+                action: 'updated-via-comment',
                 externalId: issueNumber.toString(),
                 externalUrl: issue.html_url,
             };
         }
-        // Update issue (ONLY title and description, NOT status!)
-        await client.updateIssueBody(issueNumber, newBody);
-        // Note: We do NOT update status/state - that's managed in GitHub
-        // We also do NOT close/reopen issues - that's done by humans/automation in GitHub
+        // IMMUTABLE DESCRIPTION PATTERN:
+        // ❌ OLD: Update issue body (overwrites description)
+        // ✅ NEW: Post progress comment (preserves description)
+        // Update metadata only (labels via GitHub CLI - no direct API method)
+        const labels = [
+            'specweave',
+            'spec',
+            spec.project,
+            spec.metadata.priority || 'P2'
+        ].filter(Boolean);
+        await client.addLabels(issueNumber, labels);
+        // Post progress comment (NOT edit body)
+        await postProgressComment(client, specPath, issueNumber, spec, verbose);
         if (verbose) {
-            console.log(`✅ Updated issue #${issueNumber}`);
+            console.log(`✅ Posted progress comment to issue #${issueNumber}`);
         }
         return {
             success: true,
-            action: 'updated',
+            action: 'updated-via-comment',
             externalId: issueNumber.toString(),
             externalUrl: issue.html_url,
         };
@@ -231,6 +241,47 @@ async function updateGitHubIssue(client, spec, issueNumber, options) {
         };
     }
 }
+/**
+ * Post progress comment to GitHub issue (IMMUTABLE DESCRIPTION PATTERN)
+ *
+ * This replaces the old pattern of editing issue body.
+ * Benefits:
+ * - Preserves original issue description
+ * - Creates audit trail of changes
+ * - Stakeholders get notifications on updates
+ */
+async function postProgressComment(client, specPath, issueNumber, spec, verbose = false) {
+    try {
+        // Extract increment ID from spec path or identifier
+        // Examples:
+        // - .specweave/increments/0031-external-tool-sync/spec.md → 0031
+        // - .specweave/docs/internal/specs/default/FS-031/us-001-*.md → FS-031
+        let incrementId = 'unknown';
+        // Try to extract from spec path
+        const incrementMatch = specPath.match(/increments\/([^/]+)/);
+        if (incrementMatch) {
+            incrementId = incrementMatch[1];
+        }
+        else {
+            // Fallback: use spec identifier
+            incrementId = spec.identifier.compact;
+        }
+        // Build progress comment using ProgressCommentBuilder
+        const builder = new ProgressCommentBuilder(specPath);
+        const comment = await builder.buildProgressComment(incrementId);
+        // Post comment (using addComment method)
+        await client.addComment(issueNumber, comment);
+        if (verbose) {
+            console.log(`   📊 Progress comment posted (${comment.length} chars)`);
+        }
+    }
+    catch (error) {
+        // Non-blocking: Log error but don't fail the sync
+        if (verbose) {
+            console.error(`   ⚠️  Failed to post progress comment: ${error.message}`);
+        }
+    }
+}
 /**
  * Count user stories in issue body
  */