specweave 1.0.506 → 1.0.508

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

@@ -0,0 +1,209 @@
+/**
+ * GitHub Spec Commit Sync
+ *
+ * Posts commit/PR comments to GitHub issues linked to living docs specs.
+ * This enables traceability from spec user stories to actual code changes.
+ */
+import { GitHubClientV2 } from './github-client-v2.js';
+import { getRecentCommits, detectRepository, getCommitUrl, findPRForCommit, getLastSyncCommit, updateLastSyncCommit, } from '../../../../../src/utils/git-utils.js';
+import { getSpecTaskMapping, getCompletedUserStories, } from '../../../../../src/core/specs/spec-task-mapper.js';
+import { buildUserStoryComment, buildCommitBatchComment, buildShortComment, generateSmartSummary, } from '../../../../../src/core/comment-builder.js';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Sync commits for completed user stories to GitHub issue
+ */
+export async function syncSpecCommitsToGitHub(options) {
+    const { incrementPath, dryRun = false, verbose = false } = options;
+    const result = {
+        success: true,
+        commentsPosted: 0,
+        errors: [],
+        commits: [],
+        userStories: [],
+    };
+    try {
+        // 1. Check if increment has GitHub issue linked
+        const metadataPath = path.join(incrementPath, 'metadata.json');
+        let metadata;
+        try {
+            metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
+        }
+        catch {
+            result.errors.push('No metadata.json found');
+            return result;
+        }
+        const githubIssue = metadata.github?.issue;
+        if (!githubIssue) {
+            if (verbose) {
+                console.log('No GitHub issue linked to increment');
+            }
+            return result;
+        }
+        // 2. Detect repository
+        const repo = await detectRepository('origin', incrementPath);
+        if (!repo || repo.provider !== 'github') {
+            result.errors.push('Not a GitHub repository or remote not found');
+            result.success = false;
+            return result;
+        }
+        // 3. Get spec-task mapping
+        const mapping = await getSpecTaskMapping(incrementPath);
+        if (!mapping) {
+            if (verbose) {
+                console.log('No spec mapping found for increment');
+            }
+            return result;
+        }
+        // 4. Get completed user stories
+        const completedUserStories = getCompletedUserStories(mapping);
+        if (completedUserStories.length === 0) {
+            if (verbose) {
+                console.log('No completed user stories');
+            }
+            return result;
+        }
+        result.userStories = completedUserStories;
+        // 5. Get recent commits (since last sync)
+        const lastSyncCommit = await getLastSyncCommit(metadataPath);
+        const commits = lastSyncCommit
+            ? await getRecentCommits(undefined, lastSyncCommit, incrementPath)
+            : await getRecentCommits('7.days', undefined, incrementPath);
+        if (commits.length === 0) {
+            if (verbose) {
+                console.log('No new commits since last sync');
+            }
+            return result;
+        }
+        result.commits = commits;
+        // Add commit URLs
+        for (const commit of commits) {
+            commit.url = getCommitUrl(commit, repo);
+        }
+        // 6. Initialize GitHub client
+        const client = GitHubClientV2.fromRepo(repo.owner, repo.repo);
+        // 7. Post comments for each completed user story
+        for (const userStory of completedUserStories) {
+            try {
+                // Get tasks for this user story
+                const relatedTasks = mapping.tasks.filter(t => t.userStories.includes(userStory.id));
+                // Find PRs for commits (optional, best effort)
+                const pullRequests = [];
+                for (const commit of commits.slice(0, 3)) { // Check first 3 commits only
+                    const pr = await findPRForCommit(commit.sha, repo.owner, repo.repo);
+                    if (pr && !pullRequests.find(p => p.number === pr.number)) {
+                        pullRequests.push(pr);
+                    }
+                }
+                // Build comment
+                const summary = generateSmartSummary(commits, relatedTasks);
+                const commentContent = {
+                    userStory,
+                    tasks: relatedTasks,
+                    commits,
+                    pullRequests,
+                    summary,
+                };
+                const formattedComment = buildUserStoryComment(commentContent, repo);
+                if (verbose) {
+                    console.log(`\nComment for ${userStory.id}:`);
+                    console.log(formattedComment.markdown);
+                    console.log('\n---\n');
+                }
+                // Post comment
+                if (!dryRun) {
+                    await client.addComment(githubIssue, formattedComment.markdown);
+                    result.commentsPosted++;
+                }
+                else {
+                    result.commentsPosted++; // Count as "would post"
+                }
+            }
+            catch (error) {
+                result.errors.push(`Failed to post comment for ${userStory.id}: ${error.message}`);
+            }
+        }
+        // 8. If no user stories completed but there are commits, post a simple update
+        if (completedUserStories.length === 0 && commits.length > 0) {
+            try {
+                const summary = `Work in progress: ${commits.length} commit${commits.length > 1 ? 's' : ''}`;
+                const formattedComment = buildShortComment(commits, repo, summary);
+                if (verbose) {
+                    console.log(`\nShort update comment:`);
+                    console.log(formattedComment.markdown);
+                    console.log('\n---\n');
+                }
+                if (!dryRun) {
+                    await client.addComment(githubIssue, formattedComment.markdown);
+                    result.commentsPosted++;
+                }
+                else {
+                    result.commentsPosted++;
+                }
+            }
+            catch (error) {
+                result.errors.push(`Failed to post short update: ${error.message}`);
+            }
+        }
+        // 9. Update last sync commit
+        if (!dryRun && commits.length > 0) {
+            await updateLastSyncCommit(metadataPath, commits[0].sha);
+        }
+    }
+    catch (error) {
+        result.success = false;
+        result.errors.push(error.message);
+    }
+    return result;
+}
+/**
+ * Post batch commit update to GitHub issue (for multiple commits)
+ */
+export async function postCommitBatchUpdate(incrementPath, commits, issueNumber, repo, dryRun = false) {
+    try {
+        const client = GitHubClientV2.fromRepo(repo.owner, repo.repo);
+        // Add commit URLs
+        for (const commit of commits) {
+            commit.url = getCommitUrl(commit, repo);
+        }
+        // Build and post comment
+        const formattedComment = buildCommitBatchComment(commits, repo, true);
+        if (!dryRun) {
+            await client.addComment(issueNumber, formattedComment.markdown);
+        }
+        return true;
+    }
+    catch (error) {
+        console.error(`Failed to post batch update: ${error.message}`);
+        return false;
+    }
+}
+/**
+ * Check if spec commit sync is enabled in config
+ */
+export async function isSpecCommitSyncEnabled(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.specweave', 'config.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        return config.sync?.settings?.postCommitComments !== false;
+    }
+    catch {
+        return true; // Default: enabled
+    }
+}
+/**
+ * Get GitHub issue number from spec metadata
+ */
+export async function getGitHubIssueForSpec(specPath) {
+    try {
+        const content = await fs.readFile(specPath, 'utf-8');
+        // Extract GitHub issue from frontmatter or body
+        // Pattern: **GitHub Project**: https://github.com/owner/repo/issues/123
+        const match = content.match(/github\.com\/[\w-]+\/[\w-]+\/issues\/(\d+)/);
+        return match ? parseInt(match[1], 10) : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=github-spec-commit-sync.js.map

package/dist/plugins/specweave/lib/integrations/github/github-spec-commit-sync.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * GitHub Spec Content Sync
+ *
+ * Syncs spec CONTENT (title, description, user stories) to GitHub Issues.
+ * Does NOT sync STATUS - that's managed in GitHub.
+ *
+ * Sync Direction:
+ * - Title/Description: SpecWeave → GitHub (we update)
+ * - Status (open/closed): GitHub → SpecWeave (we read)
+ */
+import { ContentSyncResult } from '../../../../../src/core/specs/spec-content-sync.js';
+export interface GitHubContentSyncOptions {
+    specPath: string;
+    owner?: string;
+    repo?: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Sync spec content to GitHub issue
+ * Creates issue if it doesn't exist, updates if it does
+ */
+export declare function syncSpecContentToGitHub(options: GitHubContentSyncOptions): Promise<ContentSyncResult>;
+/**
+ * Check if spec content sync is enabled
+ */
+export declare function isContentSyncEnabled(projectRoot: string): Promise<boolean>;
+//# sourceMappingURL=github-spec-content-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-content-sync.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/github-spec-content-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAQL,iBAAiB,EAClB,MAAM,oDAAoD,CAAC;AAK5D,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;AAsTD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF"}

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

@@ -0,0 +1,365 @@
+/**
+ * GitHub Spec Content Sync
+ *
+ * Syncs spec CONTENT (title, description, user stories) to GitHub Issues.
+ * Does NOT sync STATUS - that's managed in GitHub.
+ *
+ * Sync Direction:
+ * - Title/Description: SpecWeave → GitHub (we update)
+ * - Status (open/closed): GitHub → SpecWeave (we read)
+ */
+import { GitHubClientV2 } from './github-client-v2.js';
+import { parseSpecContent, detectContentChanges, buildExternalDescription, hasExternalLink, updateSpecWithExternalLink, } from '../../../../../src/core/specs/spec-content-sync.js';
+import { ProgressCommentBuilder } from './progress-comment-builder.js';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Get GitHub owner/repo from project config
+ */
+async function getGitHubRepoForProject(project, specPath) {
+    try {
+        // Find project root
+        let currentDir = path.dirname(specPath);
+        let configPath = path.join(currentDir, '.specweave', 'config.json');
+        // Search upward for .specweave/config.json
+        while (!await fs.access(configPath).then(() => true).catch(() => false)) {
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                return null; // Reached root
+            }
+            currentDir = parentDir;
+            configPath = path.join(currentDir, '.specweave', 'config.json');
+        }
+        // Read config
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(configContent);
+        // Get project config
+        const projectConfig = config.specs?.projects?.[project];
+        if (!projectConfig?.github) {
+            return null;
+        }
+        return {
+            owner: projectConfig.github.owner,
+            repo: projectConfig.github.repo
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Sync spec content to GitHub issue
+ * Creates issue if it doesn't exist, updates if it does
+ */
+export async function syncSpecContentToGitHub(options) {
+    let { specPath, owner, repo, dryRun = false, verbose = false } = options;
+    try {
+        // 1. Parse spec content
+        const spec = await parseSpecContent(specPath);
+        if (!spec) {
+            return {
+                success: false,
+                action: 'error',
+                error: 'Failed to parse spec content',
+            };
+        }
+        if (verbose) {
+            console.log(`📄 Parsed spec: ${spec.identifier.compact}`);
+            console.log(`   Project: ${spec.project}`);
+            console.log(`   Title: ${spec.title}`);
+            console.log(`   User Stories: ${spec.userStories.length}`);
+        }
+        // 2. Auto-detect owner/repo from project config if not provided
+        if (!owner || !repo) {
+            const repoConfig = await getGitHubRepoForProject(spec.project, specPath);
+            if (!repoConfig) {
+                return {
+                    success: false,
+                    action: 'error',
+                    error: `No GitHub repository configured for project "${spec.project}". Add specs.projects.${spec.project}.github in config.json`,
+                };
+            }
+            owner = repoConfig.owner;
+            repo = repoConfig.repo;
+            if (verbose) {
+                console.log(`   Auto-detected repo: ${owner}/${repo}`);
+            }
+        }
+        // 3. Check if issue already exists
+        const existingIssueNumber = await hasExternalLink(specPath, 'github');
+        const client = GitHubClientV2.fromRepo(owner, repo);
+        if (existingIssueNumber) {
+            // UPDATE existing issue
+            return await updateGitHubIssue(client, spec, parseInt(existingIssueNumber), options);
+        }
+        else {
+            // CREATE new issue
+            return await createGitHubIssue(client, spec, options);
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: error.message,
+        };
+    }
+}
+/**
+ * Create new GitHub issue from spec
+ */
+async function createGitHubIssue(client, spec, options) {
+    const { specPath, dryRun, verbose } = options;
+    try {
+        // Check permission: canUpsertInternalItems (CREATE permission)
+        const permissions = await loadSyncPermissions(specPath);
+        if (!permissions.canCreate) {
+            if (verbose) {
+                console.log('   ⚠️  Skipping create - canUpsertInternalItems is disabled in config');
+            }
+            return {
+                success: false,
+                action: 'skipped',
+                error: 'canUpsertInternalItems is disabled in .specweave/config.json',
+            };
+        }
+        // Build issue title and body using compact format
+        // Examples: [BE-JIRA-AUTH-123] User Authentication, [FE-user-login-ui] Login UI
+        // Use display ID for cleaner titles (FS-043 instead of _F-FS-043)
+        // For _features project, display is "FS-043", compact is "_F-FS-043"
+        const titleId = spec.project === '_features' ? spec.identifier.display : spec.identifier.compact;
+        const title = `[${titleId}] ${spec.title}`;
+        const body = buildExternalDescription(spec);
+        if (verbose) {
+            console.log(`\n📝 Creating GitHub issue:`);
+            console.log(`   Title: ${title}`);
+            console.log(`   Body length: ${body.length} chars`);
+        }
+        if (dryRun) {
+            console.log('\n🔍 Dry run - would create issue:');
+            console.log(`   Title: ${title}`);
+            console.log(`   Body:\n${body}`);
+            return {
+                success: true,
+                action: 'created',
+                externalId: 'DRY-RUN',
+                externalUrl: 'https://github.com/DRY-RUN',
+            };
+        }
+        // Create issue with project-specific labels
+        const labels = [
+            'specweave',
+            'spec',
+            spec.project, // backend, frontend, mobile, etc.
+            spec.metadata.priority || 'P2'
+        ].filter(Boolean);
+        const issue = await client.createEpicIssue(title, body, undefined, labels);
+        if (verbose) {
+            console.log(`✅ Created issue #${issue.number}`);
+            console.log(`   URL: ${issue.html_url}`);
+        }
+        // Update spec with GitHub link
+        await updateSpecWithExternalLink(specPath, 'github', issue.number.toString(), issue.html_url);
+        return {
+            success: true,
+            action: 'created',
+            externalId: issue.number.toString(),
+            externalUrl: issue.html_url,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: `Failed to create GitHub issue: ${error.message}`,
+        };
+    }
+}
+/**
+ * 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;
+    try {
+        // Check permission: canUpdateExternalItems (UPDATE permission)
+        const permissions = await loadSyncPermissions(specPath);
+        if (!permissions.canUpdate) {
+            if (verbose) {
+                console.log('   ⚠️  Skipping update - canUpdateExternalItems is disabled in config');
+            }
+            return {
+                success: false,
+                action: 'skipped',
+                error: 'canUpdateExternalItems is disabled in .specweave/config.json',
+            };
+        }
+        // Get current issue
+        const issue = await client.getIssue(issueNumber);
+        if (verbose) {
+            console.log(`\n🔄 Checking for changes in issue #${issueNumber}`);
+        }
+        // Detect changes
+        // Strip any ID prefix from title (flexible format: [BE-JIRA-123], [FE-login-ui], etc.)
+        const cleanTitle = issue.title.replace(/^\[[A-Z]{2,4}-[A-Z0-9-]+\]\s*/, '');
+        const changes = detectContentChanges(spec, {
+            title: cleanTitle,
+            description: issue.body || '',
+            userStoryCount: countUserStoriesInBody(issue.body || ''),
+        });
+        if (!changes.hasChanges) {
+            if (verbose) {
+                console.log('   ℹ️  No changes detected');
+            }
+            return {
+                success: true,
+                action: 'no-change',
+                externalId: issueNumber.toString(),
+                externalUrl: issue.html_url,
+            };
+        }
+        if (verbose) {
+            console.log('   📝 Changes detected:');
+            for (const change of changes.changes) {
+                console.log(`      - ${change}`);
+            }
+        }
+        if (dryRun) {
+            console.log('\n🔍 Dry run - would post progress comment');
+            return {
+                success: true,
+                action: 'updated-via-comment',
+                externalId: issueNumber.toString(),
+                externalUrl: issue.html_url,
+            };
+        }
+        // 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(`✅ Posted progress comment to issue #${issueNumber}`);
+        }
+        return {
+            success: true,
+            action: 'updated-via-comment',
+            externalId: issueNumber.toString(),
+            externalUrl: issue.html_url,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            error: `Failed to update GitHub issue: ${error.message}`,
+        };
+    }
+}
+/**
+ * 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
+ */
+function countUserStoriesInBody(body) {
+    const matches = body.match(/###\s+US-\d+:/g);
+    return matches ? matches.length : 0;
+}
+/**
+ * Load sync permissions from config
+ */
+async function loadSyncPermissions(specPath) {
+    try {
+        // Find project root
+        let currentDir = path.dirname(specPath);
+        let configPath = path.join(currentDir, '.specweave', 'config.json');
+        // Search upward for .specweave/config.json
+        while (!await fs.access(configPath).then(() => true).catch(() => false)) {
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                // Default: all enabled
+                return { canCreate: true, canUpdate: true, canUpdateStatus: true };
+            }
+            currentDir = parentDir;
+            configPath = path.join(currentDir, '.specweave', 'config.json');
+        }
+        // Read config
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(configContent);
+        const settings = config.sync?.settings || {};
+        return {
+            canCreate: settings.canUpsertInternalItems !== false, // Default: true
+            canUpdate: settings.canUpdateExternalItems !== false, // Default: true
+            canUpdateStatus: settings.canUpdateStatus !== false // Default: true
+        };
+    }
+    catch {
+        // Default: all enabled
+        return { canCreate: true, canUpdate: true, canUpdateStatus: true };
+    }
+}
+/**
+ * Check if spec content sync is enabled
+ */
+export async function isContentSyncEnabled(projectRoot) {
+    try {
+        const configPath = path.join(projectRoot, '.specweave', 'config.json');
+        const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+        return config.sync?.settings?.syncSpecContent !== false;
+    }
+    catch {
+        return true; // Default: enabled
+    }
+}
+//# sourceMappingURL=github-spec-content-sync.js.map

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

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

package/dist/plugins/specweave/lib/integrations/github/github-spec-frontmatter-updater.d.ts

@@ -0,0 +1,21 @@
+/**
+ * GitHub Spec Frontmatter Updater
+ *
+ * Updates spec.md YAML frontmatter after push sync to record
+ * GitHub issue links for each user story.
+ *
+ * @module github-spec-frontmatter-updater
+ */
+import type { PushSyncResult } from './github-push-sync.js';
+import type { GitHubSyncMetadata } from '../../../../../src/core/types/sync-profile.js';
+/**
+ * Update spec.md frontmatter with GitHub sync results.
+ *
+ * Reads the spec file, parses YAML frontmatter, merges sync results
+ * into the externalLinks.github section, and writes back.
+ */
+export declare function updateSpecFrontmatter(specPath: string, syncResult: PushSyncResult, options?: {
+    projectV2Id?: string;
+    projectV2Number?: number;
+}): Promise<GitHubSyncMetadata>;
+//# sourceMappingURL=github-spec-frontmatter-updater.d.ts.map

package/dist/plugins/specweave/lib/integrations/github/github-spec-frontmatter-updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-frontmatter-updater.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/github/github-spec-frontmatter-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,+CAA+C,CAAC;AAE7G;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,kBAAkB,CAAC,CA4E7B"}