specweave 0.17.0 → 0.17.1

package/dist/src/core/sync/bidirectional-engine.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Bidirectional Sync Engine
+ *
+ * Handles synchronization between SpecWeave increments and external systems
+ * (GitHub, Jira, ADO) in both directions with conflict detection and resolution.
+ *
+ * Features:
+ * - Bidirectional sync (to-external, from-external, both)
+ * - Conflict detection (field-level granularity)
+ * - Interactive conflict resolution
+ * - Change tracking (detect what changed since last sync)
+ * - Reorganization detection (moved issues, split/merged stories)
+ */
+import { SyncProvider } from '../types/sync-profile';
+export type SyncDirection = 'to-external' | 'from-external' | 'bidirectional';
+export type ConflictResolution = 'prefer-local' | 'prefer-external' | 'manual' | 'prompt';
+export interface SyncState {
+    /** Increment metadata */
+    incrementId: string;
+    title: string;
+    status: string;
+    /** External metadata */
+    externalId?: string;
+    externalKey?: string;
+    externalUrl?: string;
+    /** Sync state */
+    lastSyncAt?: string;
+    lastLocalChange?: string;
+    lastExternalChange?: string;
+    /** Content hashes (for change detection) */
+    localHash?: string;
+    externalHash?: string;
+    /** Linked items (user stories, tasks, etc.) */
+    linkedItems?: Record<string, string>;
+}
+export interface FieldChange {
+    field: string;
+    localValue: any;
+    externalValue: any;
+    lastSyncValue?: any;
+}
+export interface Conflict extends FieldChange {
+    resolution?: 'local' | 'external' | 'merged';
+    mergedValue?: any;
+}
+export interface ChangeSet {
+    /** Changes to sync to external */
+    toExternal: FieldChange[];
+    /** Changes to sync from external */
+    fromExternal: FieldChange[];
+    /** Conflicts (both sides changed) */
+    conflicts: Conflict[];
+}
+export interface SyncResult {
+    success: boolean;
+    direction: SyncDirection;
+    changes: ChangeSet;
+    conflictsResolved: number;
+    errors: string[];
+}
+export declare class BidirectionalSyncEngine {
+    private provider;
+    private projectRoot;
+    constructor(provider: SyncProvider, projectRoot?: string);
+    /**
+     * Main sync orchestrator
+     */
+    sync(incrementId: string, direction: SyncDirection, conflictResolution?: ConflictResolution): Promise<SyncResult>;
+    /**
+     * Detect changes in both local and external state
+     */
+    private detectChanges;
+    /**
+     * Fetch local state from increment files
+     */
+    private fetchLocalState;
+    /**
+     * Fetch external state from Jira/GitHub/ADO
+     */
+    private fetchExternalState;
+    /**
+     * Resolve conflicts interactively or automatically
+     */
+    private resolveConflicts;
+    /**
+     * Interactive conflict resolution prompt
+     */
+    private promptConflictResolution;
+    /**
+     * Apply changes to external system
+     */
+    private applyToExternal;
+    /**
+     * Apply changes to local increment
+     */
+    private applyToLocal;
+    /**
+     * Load sync state from metadata
+     */
+    private loadSyncState;
+    /**
+     * Update sync state in metadata
+     */
+    private updateSyncState;
+    /**
+     * Print sync summary
+     */
+    private printSyncSummary;
+}
+//# sourceMappingURL=bidirectional-engine.d.ts.map

package/dist/src/core/sync/bidirectional-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidirectional-engine.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/bidirectional-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMrD,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,GAAG,CAAC;IAChB,aAAa,EAAE,GAAG,CAAC;IACnB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7C,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,UAAU,EAAE,WAAW,EAAE,CAAC;IAE1B,oCAAoC;IACpC,YAAY,EAAE,WAAW,EAAE,CAAC;IAE5B,qCAAqC;IACrC,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;gBADX,QAAQ,EAAE,YAAY,EACtB,WAAW,GAAE,MAAsB;IAG7C;;OAEG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,aAAa,EACxB,kBAAkB,GAAE,kBAA6B,GAChD,OAAO,CAAC,UAAU,CAAC;IA2FtB;;OAEG;YACW,aAAa;IAuD3B;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,kBAAkB;IAuBhC;;OAEG;YACW,gBAAgB;IAqB9B;;OAEG;YACW,wBAAwB;IAiDtC;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,YAAY;IA2C1B;;OAEG;YACW,aAAa;IA6B3B;;OAEG;YACW,eAAe;IAmC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/src/core/sync/bidirectional-engine.js

@@ -0,0 +1,356 @@
+/**
+ * Bidirectional Sync Engine
+ *
+ * Handles synchronization between SpecWeave increments and external systems
+ * (GitHub, Jira, ADO) in both directions with conflict detection and resolution.
+ *
+ * Features:
+ * - Bidirectional sync (to-external, from-external, both)
+ * - Conflict detection (field-level granularity)
+ * - Interactive conflict resolution
+ * - Change tracking (detect what changed since last sync)
+ * - Reorganization detection (moved issues, split/merged stories)
+ */
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import inquirer from 'inquirer';
+// ============================================================================
+// Bidirectional Sync Engine
+// ============================================================================
+export class BidirectionalSyncEngine {
+    constructor(provider, projectRoot = process.cwd()) {
+        this.provider = provider;
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Main sync orchestrator
+     */
+    async sync(incrementId, direction, conflictResolution = 'prompt') {
+        console.log(`\n🔄 Starting ${direction} sync for increment ${incrementId}...\n`);
+        const result = {
+            success: false,
+            direction,
+            changes: { toExternal: [], fromExternal: [], conflicts: [] },
+            conflictsResolved: 0,
+            errors: [],
+        };
+        try {
+            // Step 1: Load current state
+            const currentState = await this.loadSyncState(incrementId);
+            // Step 2: Detect changes
+            const changes = await this.detectChanges(incrementId, currentState);
+            result.changes = changes;
+            // Step 3: Handle conflicts (if bidirectional)
+            if (direction === 'bidirectional' && changes.conflicts.length > 0) {
+                console.log(`\n⚠️  Detected ${changes.conflicts.length} conflicts\n`);
+                const resolved = await this.resolveConflicts(changes.conflicts, conflictResolution);
+                result.conflictsResolved = resolved.length;
+                // Apply resolutions
+                for (const conflict of resolved) {
+                    if (conflict.resolution === 'local') {
+                        changes.toExternal.push(conflict);
+                    }
+                    else if (conflict.resolution === 'external') {
+                        changes.fromExternal.push(conflict);
+                    }
+                    else if (conflict.resolution === 'merged' && conflict.mergedValue !== undefined) {
+                        // Apply merged value to both sides
+                        changes.toExternal.push({
+                            ...conflict,
+                            localValue: conflict.mergedValue,
+                        });
+                        changes.fromExternal.push({
+                            ...conflict,
+                            externalValue: conflict.mergedValue,
+                        });
+                    }
+                }
+            }
+            // Step 4: Apply changes based on direction
+            if (direction === 'to-external' || direction === 'bidirectional') {
+                if (changes.toExternal.length > 0) {
+                    console.log(`\n📤 Syncing ${changes.toExternal.length} changes to ${this.provider}...`);
+                    await this.applyToExternal(incrementId, changes.toExternal);
+                }
+            }
+            if (direction === 'from-external' || direction === 'bidirectional') {
+                if (changes.fromExternal.length > 0) {
+                    console.log(`\n📥 Syncing ${changes.fromExternal.length} changes from ${this.provider}...`);
+                    await this.applyToLocal(incrementId, changes.fromExternal);
+                }
+            }
+            // Step 5: Update sync state
+            await this.updateSyncState(incrementId, {
+                ...currentState,
+                lastSyncAt: new Date().toISOString(),
+                lastLocalChange: new Date().toISOString(),
+                lastExternalChange: new Date().toISOString(),
+            });
+            result.success = true;
+            console.log(`\n✅ Sync complete!\n`);
+            this.printSyncSummary(result);
+            return result;
+        }
+        catch (error) {
+            result.success = false;
+            result.errors.push(error.message);
+            console.error(`\n❌ Sync failed:`, error.message);
+            return result;
+        }
+    }
+    // ==========================================================================
+    // Change Detection
+    // ==========================================================================
+    /**
+     * Detect changes in both local and external state
+     */
+    async detectChanges(incrementId, currentState) {
+        const localState = await this.fetchLocalState(incrementId);
+        const externalState = await this.fetchExternalState(incrementId, currentState);
+        const toExternal = [];
+        const fromExternal = [];
+        const conflicts = [];
+        // Compare common fields
+        const fields = ['title', 'description', 'status', 'priority', 'assignee'];
+        for (const field of fields) {
+            const localValue = localState[field];
+            const externalValue = externalState[field];
+            const lastSyncValue = currentState.lastSyncAt
+                ? currentState[field]
+                : undefined;
+            // Detect changes
+            const localChanged = localValue !== lastSyncValue;
+            const externalChanged = externalValue !== lastSyncValue;
+            if (localChanged && externalChanged && localValue !== externalValue) {
+                // CONFLICT: Both changed to different values
+                conflicts.push({
+                    field,
+                    localValue,
+                    externalValue,
+                    lastSyncValue,
+                });
+            }
+            else if (localChanged) {
+                // Local changed, external didn't
+                toExternal.push({
+                    field,
+                    localValue,
+                    externalValue,
+                    lastSyncValue,
+                });
+            }
+            else if (externalChanged) {
+                // External changed, local didn't
+                fromExternal.push({
+                    field,
+                    localValue,
+                    externalValue,
+                    lastSyncValue,
+                });
+            }
+        }
+        return { toExternal, fromExternal, conflicts };
+    }
+    /**
+     * Fetch local state from increment files
+     */
+    async fetchLocalState(incrementId) {
+        const incrementPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId);
+        // Read spec.md
+        const specPath = path.join(incrementPath, 'spec.md');
+        const specContent = await fs.readFile(specPath, 'utf-8');
+        // Parse frontmatter and content
+        const titleMatch = specContent.match(/^#\s+(.+)$/m);
+        const statusMatch = specContent.match(/Status:\s*(.+)$/m);
+        const priorityMatch = specContent.match(/Priority:\s*(.+)$/m);
+        return {
+            title: titleMatch ? titleMatch[1] : '',
+            description: specContent.substring(0, 500), // First 500 chars
+            status: statusMatch ? statusMatch[1].trim() : 'in-progress',
+            priority: priorityMatch ? priorityMatch[1].trim() : 'medium',
+            assignee: null,
+        };
+    }
+    /**
+     * Fetch external state from Jira/GitHub/ADO
+     */
+    async fetchExternalState(incrementId, currentState) {
+        if (!currentState.externalKey) {
+            return {}; // No external issue yet
+        }
+        // This will be implemented by provider-specific adapters
+        // For now, return placeholder
+        return {
+            title: '',
+            description: '',
+            status: '',
+            priority: '',
+            assignee: null,
+        };
+    }
+    // ==========================================================================
+    // Conflict Resolution
+    // ==========================================================================
+    /**
+     * Resolve conflicts interactively or automatically
+     */
+    async resolveConflicts(conflicts, strategy) {
+        const resolved = [];
+        for (const conflict of conflicts) {
+            if (strategy === 'prefer-local') {
+                conflict.resolution = 'local';
+            }
+            else if (strategy === 'prefer-external') {
+                conflict.resolution = 'external';
+            }
+            else if (strategy === 'manual' || strategy === 'prompt') {
+                await this.promptConflictResolution(conflict);
+            }
+            resolved.push(conflict);
+        }
+        return resolved;
+    }
+    /**
+     * Interactive conflict resolution prompt
+     */
+    async promptConflictResolution(conflict) {
+        console.log(`\n⚠️  Conflict in field: ${conflict.field}`);
+        console.log(`   Local value:    ${conflict.localValue}`);
+        console.log(`   ${this.provider} value: ${conflict.externalValue}`);
+        console.log(`   Last sync value: ${conflict.lastSyncValue || '(unknown)'}\n`);
+        const { resolution } = await inquirer.prompt([
+            {
+                type: 'list',
+                name: 'resolution',
+                message: `How should this conflict be resolved?`,
+                choices: [
+                    {
+                        name: `Use local value: "${conflict.localValue}"`,
+                        value: 'local',
+                    },
+                    {
+                        name: `Use ${this.provider} value: "${conflict.externalValue}"`,
+                        value: 'external',
+                    },
+                    {
+                        name: 'Enter custom value (merge)',
+                        value: 'merge',
+                    },
+                ],
+            },
+        ]);
+        if (resolution === 'merge') {
+            const { mergedValue } = await inquirer.prompt([
+                {
+                    type: 'input',
+                    name: 'mergedValue',
+                    message: `Enter merged value for ${conflict.field}:`,
+                    default: conflict.localValue,
+                },
+            ]);
+            conflict.resolution = 'merged';
+            conflict.mergedValue = mergedValue;
+        }
+        else {
+            conflict.resolution = resolution;
+        }
+    }
+    // ==========================================================================
+    // Apply Changes
+    // ==========================================================================
+    /**
+     * Apply changes to external system
+     */
+    async applyToExternal(incrementId, changes) {
+        // Implementation will be provider-specific
+        // This is a placeholder
+        for (const change of changes) {
+            console.log(`   ✓ ${change.field}: ${change.localValue}`);
+        }
+    }
+    /**
+     * Apply changes to local increment
+     */
+    async applyToLocal(incrementId, changes) {
+        const incrementPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId);
+        const specPath = path.join(incrementPath, 'spec.md');
+        let specContent = await fs.readFile(specPath, 'utf-8');
+        // Apply changes to spec.md
+        for (const change of changes) {
+            if (change.field === 'title') {
+                specContent = specContent.replace(/^#\s+.+$/m, `# ${change.externalValue}`);
+            }
+            else if (change.field === 'status') {
+                specContent = specContent.replace(/Status:\s*.+$/m, `Status: ${change.externalValue}`);
+            }
+            else if (change.field === 'priority') {
+                specContent = specContent.replace(/Priority:\s*.+$/m, `Priority: ${change.externalValue}`);
+            }
+            console.log(`   ✓ ${change.field}: ${change.externalValue}`);
+        }
+        await fs.writeFile(specPath, specContent, 'utf-8');
+    }
+    // ==========================================================================
+    // Sync State Management
+    // ==========================================================================
+    /**
+     * Load sync state from metadata
+     */
+    async loadSyncState(incrementId) {
+        const metadataPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId, 'metadata.json');
+        if (!fs.existsSync(metadataPath)) {
+            return { incrementId, title: '', status: '' };
+        }
+        const metadata = await fs.readJSON(metadataPath);
+        return {
+            incrementId,
+            title: metadata.title || '',
+            status: metadata.status || '',
+            externalId: metadata.sync?.externalId,
+            externalKey: metadata.sync?.externalKey,
+            externalUrl: metadata.sync?.externalUrl,
+            lastSyncAt: metadata.sync?.lastSyncAt,
+            lastLocalChange: metadata.sync?.lastLocalChange,
+            lastExternalChange: metadata.sync?.lastExternalChange,
+            linkedItems: metadata.sync?.linkedItems || {},
+        };
+    }
+    /**
+     * Update sync state in metadata
+     */
+    async updateSyncState(incrementId, state) {
+        const metadataPath = path.join(this.projectRoot, '.specweave', 'increments', incrementId, 'metadata.json');
+        let metadata = {};
+        if (fs.existsSync(metadataPath)) {
+            metadata = await fs.readJSON(metadataPath);
+        }
+        metadata.sync = {
+            ...metadata.sync,
+            externalId: state.externalId,
+            externalKey: state.externalKey,
+            externalUrl: state.externalUrl,
+            lastSyncAt: state.lastSyncAt,
+            lastLocalChange: state.lastLocalChange,
+            lastExternalChange: state.lastExternalChange,
+            linkedItems: state.linkedItems,
+        };
+        await fs.writeJSON(metadataPath, metadata, { spaces: 2 });
+    }
+    // ==========================================================================
+    // Helpers
+    // ==========================================================================
+    /**
+     * Print sync summary
+     */
+    printSyncSummary(result) {
+        console.log('📊 Sync Summary:\n');
+        console.log(`   Direction: ${result.direction}`);
+        console.log(`   Changes to external: ${result.changes.toExternal.length}`);
+        console.log(`   Changes from external: ${result.changes.fromExternal.length}`);
+        console.log(`   Conflicts detected: ${result.changes.conflicts.length}`);
+        console.log(`   Conflicts resolved: ${result.conflictsResolved}`);
+        console.log(`   Errors: ${result.errors.length}`);
+        console.log('');
+    }
+}
+//# sourceMappingURL=bidirectional-engine.js.map

package/dist/src/core/sync/bidirectional-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidirectional-engine.js","sourceRoot":"","sources":["../../../../src/core/sync/bidirectional-engine.ts"],"names":[],"mappings":"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"}

package/dist/src/core/sync/folder-mapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Folder Mapper for Multi-Team Sync
+ *
+ * Maps sync profiles (ADO teams, Jira projects/components) to SpecWeave folder structure
+ */
+import { SyncProfile } from '../types/sync-profile.js';
+/**
+ * Get specs folders for a sync profile
+ *
+ * Returns array of folders for multi-team profiles:
+ * - ADO with teams: Multiple folders (one per team)
+ * - Jira project-per-team: Multiple folders (one per project)
+ * - Jira shared-project-with-components: Multiple folders (one per component)
+ * - GitHub: Single folder (repo name)
+ *
+ * @param profile - Sync profile
+ * @returns Array of folder paths relative to project root
+ */
+export declare function getSpecsFoldersForProfile(profile: SyncProfile): string[];
+/**
+ * Get Area Path for ADO team
+ *
+ * ADO Area Path format: "Project\\Team Name"
+ * Special case: If team name matches project name, use just project name
+ *
+ * Examples:
+ * - getAreaPathForTeam("League Scheduler", "League Scheduler Team") → "League Scheduler"
+ * - getAreaPathForTeam("League Scheduler", "Platform Engineering Team") → "League Scheduler\\Platform Engineering Team"
+ *
+ * @param project - ADO project name
+ * @param team - Team name
+ * @returns Area Path string
+ */
+export declare function getAreaPathForTeam(project: string, team: string): string;
+/**
+ * Generate Area Paths map for ADO profile
+ *
+ * Creates mapping from team folder names to ADO Area Paths
+ *
+ * Example:
+ * Input: project="League Scheduler", teams=["Platform Engineering Team", "QA Team"]
+ * Output: {
+ *   "platform-engineering-team": "League Scheduler\\Platform Engineering Team",
+ *   "qa-team": "League Scheduler\\QA Team"
+ * }
+ *
+ * @param project - ADO project name
+ * @param teams - Array of team names
+ * @returns Map of folder names to Area Paths
+ */
+export declare function generateAreaPaths(project: string, teams: string[]): Record<string, string>;
+/**
+ * Get team folder name from Area Path
+ *
+ * Reverse mapping: "League Scheduler\\Platform Engineering Team" → "platform-engineering-team"
+ *
+ * @param areaPath - ADO Area Path
+ * @returns Folder name (kebab-case)
+ */
+export declare function getFolderNameFromAreaPath(areaPath: string): string;
+/**
+ * Get team/project identifier from folder name
+ *
+ * Maps folder name back to original team/project name
+ *
+ * @param profile - Sync profile
+ * @param folderName - Folder name (kebab-case)
+ * @returns Original team/project name, or null if not found
+ */
+export declare function getTeamFromFolder(profile: SyncProfile, folderName: string): string | null;
+//# sourceMappingURL=folder-mapper.d.ts.map

package/dist/src/core/sync/folder-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/folder-mapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EAIZ,MAAM,0BAA0B,CAAC;AAGlC;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAyDxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAoDf"}