specweave 0.17.0 → 0.17.1

package/dist/plugins/specweave-github/lib/github-issue-updater.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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
+ */
+export interface LivingDocsSection {
+    specs: string[];
+    architecture: string[];
+    diagrams: string[];
+}
+export interface IncrementMetadata {
+    id: string;
+    status: string;
+    type: string;
+    github?: {
+        issue: number;
+        url: string;
+        synced?: string;
+    };
+}
+/**
+ * Update GitHub issue with living docs section
+ */
+export declare function updateIssueLivingDocs(issueNumber: number, livingDocs: LivingDocsSection, owner: string, repo: string): Promise<void>;
+/**
+ * Post comment about ADR/HLD/diagram creation
+ */
+export declare function postArchitectureComment(issueNumber: number, docPath: string, owner: string, repo: string): Promise<void>;
+/**
+ * Post scope change comment
+ */
+export declare function postScopeChangeComment(issueNumber: number, changes: {
+    added?: string[];
+    removed?: string[];
+    modified?: string[];
+    reason?: string;
+    impact?: string;
+}, owner: string, repo: string): Promise<void>;
+/**
+ * Post status change comment (pause/resume/abandon)
+ */
+export declare function postStatusChangeComment(issueNumber: number, status: 'paused' | 'resumed' | 'abandoned', reason: string, owner: string, repo: string): Promise<void>;
+/**
+ * Collect living docs for an increment
+ */
+export declare function collectLivingDocs(incrementId: string): Promise<LivingDocsSection>;
+/**
+ * Load increment metadata
+ */
+export declare function loadIncrementMetadata(incrementId: string): Promise<IncrementMetadata | null>;
+/**
+ * Detect repository owner and name from git remote
+ */
+export declare function detectRepo(): Promise<{
+    owner: string;
+    repo: string;
+} | null>;
+//# sourceMappingURL=github-issue-updater.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-updater.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,EAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqDvF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAalG;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBlF"}

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-multi-project-sync.d.ts

@@ -0,0 +1,126 @@
+/**
+ * GitHub Multi-Project Sync
+ *
+ * Supports two patterns:
+ * 1. **Multiple Repos**: Separate repos for each project (FE, BE, MOBILE)
+ * 2. **Master + Nested**: Master repo (epics) + nested repos (detailed tasks)
+ *
+ * @module github-multi-project-sync
+ */
+export interface GitHubMultiProjectConfig {
+    owner: string;
+    token: string;
+    repos?: string[];
+    masterRepo?: string;
+    nestedRepos?: string[];
+    masterRepoLevel?: 'epic';
+    nestedRepoLevel?: 'story-task';
+    crossLinking?: boolean;
+    confidenceThreshold?: number;
+}
+export interface GitHubIssue {
+    number: number;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    html_url: string;
+    labels: Array<{
+        name: string;
+    }>;
+}
+export interface SyncResult {
+    project: string;
+    repo: string;
+    issueNumber: number;
+    url: string;
+    action: 'created' | 'updated' | 'skipped';
+}
+/**
+ * GitHub Multi-Project Sync Client
+ */
+export declare class GitHubMultiProjectSync {
+    private octokit;
+    private config;
+    constructor(config: GitHubMultiProjectConfig);
+    /**
+     * Pre-flight validation: Verify all repos exist
+     *
+     * @throws Error if any repos are missing
+     */
+    validateRepos(): Promise<void>;
+    /**
+     * Sync spec to appropriate GitHub repos based on project mapping
+     *
+     * @param specPath Path to spec file
+     * @returns Array of sync results
+     */
+    syncSpec(specPath: string): Promise<SyncResult[]>;
+    /**
+     * Pattern 1: Sync to multiple repos (simple)
+     *
+     * Each project → separate repo
+     * - FE user stories → company/frontend-web
+     * - BE user stories → company/backend-api
+     * - MOBILE user stories → company/mobile-app
+     */
+    private syncMultipleRepos;
+    /**
+     * Pattern 2: Sync to master + nested repos (advanced)
+     *
+     * - Master repo (epic-level): High-level overview
+     * - Nested repos (task-level): Detailed implementation
+     *
+     * Example:
+     * Master (company/master-project):
+     *   Epic #10: User Authentication
+     *     → Links to: frontend-web#42, backend-api#15, mobile-app#8
+     *
+     * Nested (company/frontend-web):
+     *   Issue #42: Implement Login UI
+     *     Task 1: Create login component
+     *     Task 2: Add form validation
+     */
+    private syncMasterNested;
+    /**
+     * Create epic issue in master repo
+     */
+    private createEpicInMasterRepo;
+    /**
+     * Create issue in nested repo + link to epic
+     */
+    private createIssueInNestedRepo;
+    /**
+     * Create or update issue (for simple multi-repo pattern)
+     */
+    private createOrUpdateIssue;
+    /**
+     * Update epic with links to nested issues
+     */
+    private updateEpicWithLinks;
+    /**
+     * Find GitHub repo for project ID
+     *
+     * Maps project IDs to repo names:
+     * - FE → frontend-web
+     * - BE → backend-api
+     * - MOBILE → mobile-app
+     */
+    private findRepoForProject;
+    /**
+     * Find nested repo for project ID (same logic as findRepoForProject)
+     */
+    private findNestedRepoForProject;
+}
+/**
+ * Format sync results for display
+ */
+export declare function formatSyncResults(results: SyncResult[]): string;
+/**
+ * Validate GitHub repositories exist
+ *
+ * @param config GitHub configuration
+ * @param repoNames Array of repo names to validate
+ * @returns Validation results (missing repos)
+ */
+export declare function validateGitHubRepos(config: GitHubMultiProjectConfig, repoNames: string[]): Promise<string[]>;
+//# sourceMappingURL=github-multi-project-sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-multi-project-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-multi-project-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAGvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,EAAE,wBAAwB;IAK5C;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BpC;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyBvD;;;;;;;OAOG;YACW,iBAAiB;IA2C/B;;;;;;;;;;;;;;;OAeG;YACW,gBAAgB;IAmD9B;;OAEG;YACW,sBAAsB;IA0CpC;;OAEG;YACW,uBAAuB;IA8CrC;;OAEG;YACW,mBAAmB;IA8DjC;;OAEG;YACW,mBAAmB;IA0BjC;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAQjC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CA0B/D;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,wBAAwB,EAChC,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB"}