specweave 0.17.0 → 0.17.2

package/dist/plugins/specweave-github/lib/github-issue-updater.js

@@ -0,0 +1,327 @@
+/**
+ * GitHub Issue Updater for Living Docs Sync
+ *
+ * Handles updating GitHub issues with living documentation links and content.
+ * Used by post-task-completion hook to keep GitHub issues in sync with SpecWeave docs.
+ *
+ * @module github-issue-updater
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+/**
+ * Update GitHub issue with living docs section
+ */
+export async function updateIssueLivingDocs(issueNumber, livingDocs, owner, repo) {
+    console.log(`📝 Updating GitHub issue #${issueNumber} with living docs...`);
+    // 1. Get current issue body
+    const currentBody = await getIssueBody(issueNumber, owner, repo);
+    // 2. Build living docs section
+    const livingDocsSection = buildLivingDocsSection(livingDocs, owner, repo);
+    // 3. Update or append living docs section
+    const updatedBody = updateBodyWithLivingDocs(currentBody, livingDocsSection);
+    // 4. Update issue
+    await updateIssueBody(issueNumber, updatedBody, owner, repo);
+    console.log(`✅ Living docs section updated in issue #${issueNumber}`);
+}
+/**
+ * Post comment about ADR/HLD/diagram creation
+ */
+export async function postArchitectureComment(issueNumber, docPath, owner, repo) {
+    const docType = getDocType(docPath);
+    const docName = path.basename(docPath, '.md');
+    const docUrl = `https://github.com/${owner}/${repo}/blob/develop/${docPath}`;
+    const comment = `
+🏗️ **${docType} Created**
+
+**Document**: [${docName}](${docUrl})
+
+**Path**: \`${docPath}\`
+
+---
+🤖 Auto-updated by SpecWeave
+`.trim();
+    await postComment(issueNumber, comment, owner, repo);
+    console.log(`✅ Posted ${docType} comment to issue #${issueNumber}`);
+}
+/**
+ * Post scope change comment
+ */
+export async function postScopeChangeComment(issueNumber, changes, owner, repo) {
+    const parts = ['**Scope Change Detected**', ''];
+    if (changes.added && changes.added.length > 0) {
+        parts.push('**Added**:');
+        changes.added.forEach(item => parts.push(`- ✅ ${item}`));
+        parts.push('');
+    }
+    if (changes.removed && changes.removed.length > 0) {
+        parts.push('**Removed**:');
+        changes.removed.forEach(item => parts.push(`- ❌ ${item}`));
+        parts.push('');
+    }
+    if (changes.modified && changes.modified.length > 0) {
+        parts.push('**Modified**:');
+        changes.modified.forEach(item => parts.push(`- 🔄 ${item}`));
+        parts.push('');
+    }
+    if (changes.reason) {
+        parts.push(`**Reason**: ${changes.reason}`);
+        parts.push('');
+    }
+    if (changes.impact) {
+        parts.push(`**Impact**: ${changes.impact}`);
+        parts.push('');
+    }
+    parts.push('---');
+    parts.push('🤖 Auto-updated by SpecWeave');
+    await postComment(issueNumber, parts.join('\n'), owner, repo);
+    console.log(`✅ Posted scope change comment to issue #${issueNumber}`);
+}
+/**
+ * Post status change comment (pause/resume/abandon)
+ */
+export async function postStatusChangeComment(issueNumber, status, reason, owner, repo) {
+    const emoji = {
+        paused: '⏸️',
+        resumed: '▶️',
+        abandoned: '🗑️'
+    }[status];
+    const title = {
+        paused: 'Increment Paused',
+        resumed: 'Increment Resumed',
+        abandoned: 'Increment Abandoned'
+    }[status];
+    const comment = `
+${emoji} **${title}**
+
+**Reason**: ${reason}
+
+**Timestamp**: ${new Date().toISOString()}
+
+---
+🤖 Auto-updated by SpecWeave
+`.trim();
+    await postComment(issueNumber, comment, owner, repo);
+    console.log(`✅ Posted ${status} comment to issue #${issueNumber}`);
+}
+/**
+ * Collect living docs for an increment
+ */
+export async function collectLivingDocs(incrementId) {
+    const livingDocs = {
+        specs: [],
+        architecture: [],
+        diagrams: []
+    };
+    // 1. Find specs
+    const specsDir = path.join(process.cwd(), '.specweave/docs/internal/specs');
+    if (await fs.pathExists(specsDir)) {
+        const specFiles = await fs.readdir(specsDir);
+        for (const file of specFiles) {
+            if (file.endsWith('.md') && !file.startsWith('README')) {
+                livingDocs.specs.push(path.join('.specweave/docs/internal/specs', file));
+            }
+        }
+    }
+    // 2. Find architecture docs (ADRs, HLDs)
+    const archDir = path.join(process.cwd(), '.specweave/docs/internal/architecture');
+    if (await fs.pathExists(archDir)) {
+        // ADRs
+        const adrDir = path.join(archDir, 'adr');
+        if (await fs.pathExists(adrDir)) {
+            const adrFiles = await fs.readdir(adrDir);
+            for (const file of adrFiles) {
+                if (file.endsWith('.md')) {
+                    livingDocs.architecture.push(path.join('.specweave/docs/internal/architecture/adr', file));
+                }
+            }
+        }
+        // HLDs
+        const hldFiles = await fs.readdir(archDir);
+        for (const file of hldFiles) {
+            if (file.startsWith('hld-') && file.endsWith('.md')) {
+                livingDocs.architecture.push(path.join('.specweave/docs/internal/architecture', file));
+            }
+        }
+    }
+    // 3. Find diagrams
+    const diagramsDir = path.join(process.cwd(), '.specweave/docs/internal/architecture/diagrams');
+    if (await fs.pathExists(diagramsDir)) {
+        const diagramFiles = await fs.readdir(diagramsDir);
+        for (const file of diagramFiles) {
+            if (file.endsWith('.mmd') || file.endsWith('.svg')) {
+                livingDocs.diagrams.push(path.join('.specweave/docs/internal/architecture/diagrams', file));
+            }
+        }
+    }
+    return livingDocs;
+}
+/**
+ * Load increment metadata
+ */
+export async function loadIncrementMetadata(incrementId) {
+    const metadataPath = path.join(process.cwd(), '.specweave/increments', incrementId, 'metadata.json');
+    if (!await fs.pathExists(metadataPath)) {
+        return null;
+    }
+    return await fs.readJson(metadataPath);
+}
+/**
+ * Detect repository owner and name from git remote
+ */
+export async function detectRepo() {
+    try {
+        const result = await execFileNoThrow('git', ['remote', 'get-url', 'origin']);
+        if (result.exitCode !== 0) {
+            return null;
+        }
+        const remote = result.stdout.trim();
+        const match = remote.match(/github\.com[:/](.+)\/(.+?)(?:\.git)?$/);
+        if (!match) {
+            return null;
+        }
+        return {
+            owner: match[1],
+            repo: match[2]
+        };
+    }
+    catch (error) {
+        return null;
+    }
+}
+// =============================================================================
+// PRIVATE HELPERS
+// =============================================================================
+/**
+ * Get current issue body
+ */
+async function getIssueBody(issueNumber, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'view',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--json',
+        'body',
+        '-q',
+        '.body'
+    ]);
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to get issue body: ${result.stderr}`);
+    }
+    return result.stdout.trim();
+}
+/**
+ * Update issue body
+ */
+async function updateIssueBody(issueNumber, body, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'edit',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--body',
+        body
+    ]);
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to update issue body: ${result.stderr}`);
+    }
+}
+/**
+ * Post comment to issue
+ */
+async function postComment(issueNumber, comment, owner, repo) {
+    const result = await execFileNoThrow('gh', [
+        'issue',
+        'comment',
+        String(issueNumber),
+        '--repo',
+        `${owner}/${repo}`,
+        '--body',
+        comment
+    ]);
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to post comment: ${result.stderr}`);
+    }
+}
+/**
+ * Build living docs section for issue body
+ */
+function buildLivingDocsSection(livingDocs, owner, repo) {
+    const parts = ['## 📚 Living Documentation', ''];
+    // Specs
+    if (livingDocs.specs.length > 0) {
+        parts.push('**Specifications**:');
+        livingDocs.specs.forEach(spec => {
+            const name = path.basename(spec, '.md');
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${spec}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    // Architecture
+    if (livingDocs.architecture.length > 0) {
+        parts.push('**Architecture**:');
+        livingDocs.architecture.forEach(doc => {
+            const name = path.basename(doc, '.md');
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${doc}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    // Diagrams
+    if (livingDocs.diagrams.length > 0) {
+        parts.push('**Diagrams**:');
+        livingDocs.diagrams.forEach(diagram => {
+            const name = path.basename(diagram);
+            const url = `https://github.com/${owner}/${repo}/blob/develop/${diagram}`;
+            parts.push(`- [${name}](${url})`);
+        });
+        parts.push('');
+    }
+    parts.push('---');
+    return parts.join('\n');
+}
+/**
+ * Update body with living docs section
+ */
+function updateBodyWithLivingDocs(currentBody, livingDocsSection) {
+    // Check if living docs section already exists
+    const marker = '## 📚 Living Documentation';
+    if (currentBody.includes(marker)) {
+        // Replace existing section
+        const beforeMarker = currentBody.substring(0, currentBody.indexOf(marker));
+        const afterMarker = currentBody.substring(currentBody.indexOf(marker));
+        // Find end of section (next ## header or end of body)
+        const nextSection = afterMarker.indexOf('\n## ', 1);
+        const replacement = nextSection > 0
+            ? afterMarker.substring(0, nextSection)
+            : afterMarker;
+        return beforeMarker + livingDocsSection + (nextSection > 0 ? afterMarker.substring(nextSection) : '');
+    }
+    else {
+        // Append at end
+        return currentBody + '\n\n' + livingDocsSection;
+    }
+}
+/**
+ * Determine document type from path
+ */
+function getDocType(docPath) {
+    if (docPath.includes('/adr/')) {
+        return 'Architecture Decision Record (ADR)';
+    }
+    if (docPath.includes('/diagrams/')) {
+        return 'Architecture Diagram';
+    }
+    if (docPath.startsWith('hld-')) {
+        return 'High-Level Design (HLD)';
+    }
+    if (docPath.includes('/specs/')) {
+        return 'Specification';
+    }
+    return 'Documentation';
+}
+//# sourceMappingURL=github-issue-updater.js.map

package/dist/plugins/specweave-github/lib/github-issue-updater.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * 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 { GitCommit, GitRepository } from '../../../src/utils/git-utils.js';
+import { UserStory } from '../../../src/core/spec-task-mapper.js';
+export interface SyncOptions {
+    incrementPath: string;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+export interface SyncResult {
+    success: boolean;
+    commentsPosted: number;
+    errors: string[];
+    commits: GitCommit[];
+    userStories: UserStory[];
+}
+/**
+ * Sync commits for completed user stories to GitHub issue
+ */
+export declare function syncSpecCommitsToGitHub(options: SyncOptions): Promise<SyncResult>;
+/**
+ * Post batch commit update to GitHub issue (for multiple commits)
+ */
+export declare function postCommitBatchUpdate(incrementPath: string, commits: GitCommit[], issueNumber: number, repo: GitRepository, dryRun?: boolean): Promise<boolean>;
+/**
+ * Check if spec commit sync is enabled in config
+ */
+export declare function isSpecCommitSyncEnabled(projectRoot: string): Promise<boolean>;
+/**
+ * Get GitHub issue number from spec metadata
+ */
+export declare function getGitHubIssueForSpec(specPath: string): Promise<number | null>;
+//# sourceMappingURL=github-spec-commit-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-spec-commit-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-spec-commit-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,SAAS,EACT,aAAa,EAEd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,SAAS,EACV,MAAM,uCAAuC,CAAC;AAW/C,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAmKrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYxB"}

package/dist/plugins/specweave-github/lib/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/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-github/lib/github-spec-commit-sync.js.map

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

package/dist/plugins/specweave-github/lib/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/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-github/lib/github-spec-content-sync.d.ts.map

@@ -0,0 +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,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAuC5B;AAoKD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAShF"}