specweave 0.11.0 → 0.12.0

package/dist/plugins/specweave/lib/hooks/types/reflection-types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Type definitions for AI Self-Reflection System
+ * @module reflection-types
+ */
+/**
+ * Severity levels for identified issues
+ */
+export declare enum IssueSeverity {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW"
+}
+/**
+ * Issue categories
+ */
+export declare enum IssueCategory {
+    SECURITY = "SECURITY",
+    QUALITY = "QUALITY",
+    TESTING = "TESTING",
+    PERFORMANCE = "PERFORMANCE",
+    TECHNICAL_DEBT = "TECHNICAL_DEBT"
+}
+/**
+ * Reflection depth modes
+ */
+export declare enum ReflectionDepth {
+    QUICK = "quick",// <15s, critical issues only
+    STANDARD = "standard",// <30s, full analysis (default)
+    DEEP = "deep"
+}
+/**
+ * AI model selection for reflection
+ */
+export declare enum ReflectionModel {
+    HAIKU = "haiku",// Fast, cheap (~$0.01/task)
+    SONNET = "sonnet",// Balanced (~$0.05/task)
+    OPUS = "opus"
+}
+/**
+ * Reflection execution mode
+ */
+export declare enum ReflectionMode {
+    AUTO = "auto",// Automatic after task completion
+    MANUAL = "manual",// User-triggered only
+    DISABLED = "disabled"
+}
+/**
+ * Issue identified during reflection
+ */
+export interface ReflectionIssue {
+    severity: IssueSeverity;
+    category: IssueCategory;
+    description: string;
+    impact: string;
+    recommendation: string;
+    location?: {
+        file: string;
+        line?: number;
+        snippet?: string;
+    };
+}
+/**
+ * Lesson learned from task execution
+ */
+export interface LessonLearned {
+    whatWentWell: string[];
+    whatCouldImprove: string[];
+    forNextTime: string[];
+}
+/**
+ * Quality metrics from reflection
+ */
+export interface ReflectionMetrics {
+    codeQuality: number;
+    security: number;
+    testCoverage?: number;
+    technicalDebt: 'LOW' | 'MEDIUM' | 'HIGH';
+    performance: 'GOOD' | 'ACCEPTABLE' | 'NEEDS_WORK';
+}
+/**
+ * Complete reflection result
+ */
+export interface ReflectionResult {
+    taskName: string;
+    completed: string;
+    duration?: string;
+    filesModified: {
+        count: number;
+        linesAdded: number;
+        linesRemoved: number;
+    };
+    accomplishments: string[];
+    strengths: string[];
+    issues: ReflectionIssue[];
+    recommendedActions: {
+        priority1: string[];
+        priority2: string[];
+        priority3: string[];
+    };
+    lessonsLearned: LessonLearned;
+    metrics: ReflectionMetrics;
+    relatedTasks?: string[];
+    metadata: {
+        model: ReflectionModel;
+        reflectionTime: number;
+        estimatedCost: number;
+    };
+}
+/**
+ * Configuration for reflection system
+ */
+export interface ReflectionConfig {
+    enabled: boolean;
+    mode: ReflectionMode;
+    depth: ReflectionDepth;
+    model: ReflectionModel;
+    categories: {
+        security: boolean;
+        quality: boolean;
+        testing: boolean;
+        performance: boolean;
+        technicalDebt: boolean;
+    };
+    criticalThreshold: IssueSeverity;
+    storeReflections: boolean;
+    autoCreateFollowUpTasks: boolean;
+    soundNotifications?: boolean;
+}
+/**
+ * Git diff information for modified files
+ */
+export interface GitDiffInfo {
+    file: string;
+    linesAdded: number;
+    linesRemoved: number;
+    content: string;
+}
+/**
+ * Context for reflection execution
+ */
+export interface ReflectionContext {
+    incrementId: string;
+    taskId: string;
+    modifiedFiles: GitDiffInfo[];
+    config: ReflectionConfig;
+}
+/**
+ * Reflection execution result (success or failure)
+ */
+export interface ReflectionExecutionResult {
+    success: boolean;
+    result?: ReflectionResult;
+    error?: {
+        message: string;
+        code: string;
+        details?: any;
+    };
+}
+/**
+ * Default reflection configuration
+ */
+export declare const DEFAULT_REFLECTION_CONFIG: ReflectionConfig;
+//# sourceMappingURL=reflection-types.d.ts.map

package/dist/plugins/specweave/lib/hooks/types/reflection-types.d.ts.map

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

package/dist/plugins/specweave/lib/hooks/types/reflection-types.js

@@ -0,0 +1,73 @@
+/**
+ * Type definitions for AI Self-Reflection System
+ * @module reflection-types
+ */
+/**
+ * Severity levels for identified issues
+ */
+export var IssueSeverity;
+(function (IssueSeverity) {
+    IssueSeverity["CRITICAL"] = "CRITICAL";
+    IssueSeverity["HIGH"] = "HIGH";
+    IssueSeverity["MEDIUM"] = "MEDIUM";
+    IssueSeverity["LOW"] = "LOW";
+})(IssueSeverity || (IssueSeverity = {}));
+/**
+ * Issue categories
+ */
+export var IssueCategory;
+(function (IssueCategory) {
+    IssueCategory["SECURITY"] = "SECURITY";
+    IssueCategory["QUALITY"] = "QUALITY";
+    IssueCategory["TESTING"] = "TESTING";
+    IssueCategory["PERFORMANCE"] = "PERFORMANCE";
+    IssueCategory["TECHNICAL_DEBT"] = "TECHNICAL_DEBT";
+})(IssueCategory || (IssueCategory = {}));
+/**
+ * Reflection depth modes
+ */
+export var ReflectionDepth;
+(function (ReflectionDepth) {
+    ReflectionDepth["QUICK"] = "quick";
+    ReflectionDepth["STANDARD"] = "standard";
+    ReflectionDepth["DEEP"] = "deep"; // <60s, detailed + architectural
+})(ReflectionDepth || (ReflectionDepth = {}));
+/**
+ * AI model selection for reflection
+ */
+export var ReflectionModel;
+(function (ReflectionModel) {
+    ReflectionModel["HAIKU"] = "haiku";
+    ReflectionModel["SONNET"] = "sonnet";
+    ReflectionModel["OPUS"] = "opus"; // Deep analysis (~$0.15/task)
+})(ReflectionModel || (ReflectionModel = {}));
+/**
+ * Reflection execution mode
+ */
+export var ReflectionMode;
+(function (ReflectionMode) {
+    ReflectionMode["AUTO"] = "auto";
+    ReflectionMode["MANUAL"] = "manual";
+    ReflectionMode["DISABLED"] = "disabled"; // Reflection disabled
+})(ReflectionMode || (ReflectionMode = {}));
+/**
+ * Default reflection configuration
+ */
+export const DEFAULT_REFLECTION_CONFIG = {
+    enabled: true,
+    mode: ReflectionMode.AUTO,
+    depth: ReflectionDepth.STANDARD,
+    model: ReflectionModel.HAIKU,
+    categories: {
+        security: true,
+        quality: true,
+        testing: true,
+        performance: true,
+        technicalDebt: true
+    },
+    criticalThreshold: IssueSeverity.MEDIUM,
+    storeReflections: true,
+    autoCreateFollowUpTasks: false,
+    soundNotifications: false
+};
+//# sourceMappingURL=reflection-types.js.map

package/dist/plugins/specweave/lib/hooks/types/reflection-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-types.js","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/hooks/types/reflection-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACb,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,sCAAqB,CAAA;IACrB,oCAAmB,CAAA;IACnB,oCAAmB,CAAA;IACnB,4CAA2B,CAAA;IAC3B,kDAAiC,CAAA;AACnC,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IACrB,gCAAa,CAAA,CAAU,iCAAiC;AAC1D,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,oCAAiB,CAAA;IACjB,gCAAa,CAAA,CAAQ,8BAA8B;AACrD,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,+BAAa,CAAA;IACb,mCAAiB,CAAA;IACjB,uCAAqB,CAAA,CAAC,sBAAsB;AAC9C,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AA0HD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,cAAc,CAAC,IAAI;IACzB,KAAK,EAAE,eAAe,CAAC,QAAQ;IAC/B,KAAK,EAAE,eAAe,CAAC,KAAK;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;KACpB;IACD,iBAAiB,EAAE,aAAa,CAAC,MAAM;IACvC,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,KAAK;IAC9B,kBAAkB,EAAE,KAAK;CAC1B,CAAC"}

package/dist/plugins/specweave/lib/hooks/update-tasks-md.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * SpecWeave Tasks.md Auto-Updater
+ *
+ * Automatically updates tasks.md completion status after TodoWrite completes tasks.
+ *
+ * Usage:
+ *   node dist/hooks/lib/update-tasks-md.js <incrementId>
+ *
+ * Example:
+ *   node dist/hooks/lib/update-tasks-md.js 0006-llm-native-i18n
+ *
+ * What it does:
+ * 1. Reads tasks.md for the given increment
+ * 2. Finds recently completed tasks from TodoWrite
+ * 3. Updates "[ ]" to "[x]" for completed tasks
+ * 4. Updates "Status: ⏳ Pending" to "Status: [x] Completed"
+ * 5. Recalculates progress percentage
+ * 6. Writes back to tasks.md
+ *
+ * @author SpecWeave Team
+ * @version 1.0.0
+ */
+/**
+ * Main function - update tasks.md for given increment
+ */
+declare function updateTasksMd(incrementId: string): Promise<void>;
+export { updateTasksMd };
+//# sourceMappingURL=update-tasks-md.d.ts.map

package/dist/plugins/specweave/lib/hooks/update-tasks-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-tasks-md.d.ts","sourceRoot":"","sources":["../../../../../plugins/specweave/lib/hooks/update-tasks-md.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH;;GAEG;AACH,iBAAe,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE/D;AAsJD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/plugins/specweave/lib/hooks/update-tasks-md.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+/**
+ * SpecWeave Tasks.md Auto-Updater
+ *
+ * Automatically updates tasks.md completion status after TodoWrite completes tasks.
+ *
+ * Usage:
+ *   node dist/hooks/lib/update-tasks-md.js <incrementId>
+ *
+ * Example:
+ *   node dist/hooks/lib/update-tasks-md.js 0006-llm-native-i18n
+ *
+ * What it does:
+ * 1. Reads tasks.md for the given increment
+ * 2. Finds recently completed tasks from TodoWrite
+ * 3. Updates "[ ]" to "[x]" for completed tasks
+ * 4. Updates "Status: ⏳ Pending" to "Status: [x] Completed"
+ * 5. Recalculates progress percentage
+ * 6. Writes back to tasks.md
+ *
+ * @author SpecWeave Team
+ * @version 1.0.0
+ */
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Main function - update tasks.md for given increment
+ */
+async function updateTasksMd(incrementId) {
+    try {
+        console.log(`\n🔄 Updating tasks.md for increment: ${incrementId}`);
+        // 1. Validate increment exists
+        const incrementDir = path.join(process.cwd(), '.specweave', 'increments', incrementId);
+        if (!fs.existsSync(incrementDir)) {
+            console.error(`❌ Increment directory not found: ${incrementDir}`);
+            process.exit(1);
+        }
+        const tasksPath = path.join(incrementDir, 'tasks.md');
+        if (!fs.existsSync(tasksPath)) {
+            console.error(`❌ tasks.md not found: ${tasksPath}`);
+            process.exit(1);
+        }
+        // 2. Read tasks.md
+        const originalContent = await fs.readFile(tasksPath, 'utf-8');
+        const lines = originalContent.split('\n');
+        console.log(`📖 Read tasks.md (${lines.length} lines)`);
+        // 3. Parse task completion status
+        const tasks = parseTaskStatus(lines);
+        console.log(`📋 Found ${tasks.length} tasks`);
+        // 4. Get recently completed tasks from environment (passed by hook)
+        // For now, we'll mark tasks as complete if they match a heuristic
+        // TODO: In future, hook will pass completed task IDs via env var
+        const completedTasks = detectCompletedTasks(lines);
+        if (completedTasks.length === 0) {
+            console.log('✅ No new task completions detected');
+            return;
+        }
+        console.log(`🎯 Detected ${completedTasks.length} completed task(s):`, completedTasks);
+        // 5. Update task status in content
+        let updatedContent = originalContent;
+        for (const taskId of completedTasks) {
+            updatedContent = markTaskComplete(updatedContent, taskId);
+        }
+        // 6. Recalculate progress
+        const updatedLines = updatedContent.split('\n');
+        const totalTasks = countTotalTasks(updatedLines);
+        const completedCount = countCompletedTasks(updatedLines);
+        const progress = Math.round((completedCount / totalTasks) * 100);
+        console.log(`📊 Progress: ${completedCount}/${totalTasks} (${progress}%)`);
+        // 7. Update header with new progress
+        updatedContent = updateProgressHeader(updatedContent, completedCount, totalTasks, progress);
+        // 8. Write back to tasks.md
+        await fs.writeFile(tasksPath, updatedContent, 'utf-8');
+        console.log(`✅ Updated ${tasksPath}`);
+        console.log(`   Completed: ${completedCount}/${totalTasks}`);
+        console.log(`   Progress: ${progress}%\n`);
+    }
+    catch (error) {
+        console.error('❌ Error updating tasks.md:', error);
+        process.exit(1);
+    }
+}
+/**
+ * Parse task status from lines
+ */
+function parseTaskStatus(lines) {
+    const tasks = [];
+    const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+(.+)/; // Matches "### T-001: Task Name" or "### T-001-DISCIPLINE:"
+    lines.forEach((line, index) => {
+        const match = line.match(taskPattern);
+        if (match) {
+            const taskId = match[1];
+            // Look ahead for status line
+            let status = 'pending';
+            for (let i = index + 1; i < Math.min(index + 5, lines.length); i++) {
+                const nextLine = lines[i];
+                if (nextLine.includes('**Status**:')) {
+                    if (nextLine.includes('[x] Completed')) {
+                        status = 'completed';
+                    }
+                    else if (nextLine.includes('⏳ Pending') || nextLine.includes('[ ] Pending')) {
+                        status = 'pending';
+                    }
+                    else if (nextLine.includes('🔄 In Progress') || nextLine.includes('in_progress')) {
+                        status = 'in_progress';
+                    }
+                    break;
+                }
+            }
+            tasks.push({
+                taskId,
+                lineNumber: index,
+                currentStatus: status,
+            });
+        }
+    });
+    return tasks;
+}
+/**
+ * Detect which tasks are completed (heuristic-based for now)
+ * TODO: In future, hook will pass completed task IDs via env var
+ */
+function detectCompletedTasks(lines) {
+    // For now, this is a placeholder - we'll mark tasks as complete
+    // if they have implementation sections or "COMPLETE" markers
+    const completedTasks = [];
+    // This function will be enhanced in future versions
+    // For MVP, we'll rely on manual marking in tasks.md
+    return completedTasks;
+}
+/**
+ * Mark a specific task as complete
+ */
+function markTaskComplete(content, taskId) {
+    let updated = content;
+    // Pattern: "**Status**: [ ] Pending" or "**Status**: ⏳ Pending"
+    const statusPattern = new RegExp(`(###\\s+${taskId.replace(/[-]/g, '\\-')}[^\\n]*[\\s\\S]*?\\*\\*Status\\*\\*:)\\s*\\[?\\s*\\]?\\s*⏳?\\s*Pending`, 'i');
+    updated = updated.replace(statusPattern, '$1 [x] Completed');
+    return updated;
+}
+/**
+ * Count total tasks
+ */
+function countTotalTasks(lines) {
+    let count = 0;
+    const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+/;
+    for (const line of lines) {
+        if (taskPattern.test(line)) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Count completed tasks
+ */
+function countCompletedTasks(lines) {
+    let count = 0;
+    const taskPattern = /^###\s+(T-?\d+[-A-Z]*):?\s+/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (taskPattern.test(line)) {
+            // Look ahead for status line
+            for (let j = i + 1; j < Math.min(i + 5, lines.length); j++) {
+                const nextLine = lines[j];
+                if (nextLine.includes('**Status**:') && nextLine.includes('[x] Completed')) {
+                    count++;
+                    break;
+                }
+            }
+        }
+    }
+    return count;
+}
+/**
+ * Update progress header
+ */
+function updateProgressHeader(content, completed, total, progress) {
+    let updated = content;
+    // Update "**Completed**: X"
+    updated = updated.replace(/\*\*Completed\*\*:\s*\d+/, `**Completed**: ${completed}`);
+    // Update "**Progress**: X%"
+    updated = updated.replace(/\*\*Progress\*\*:\s*\d+%/, `**Progress**: ${progress}%`);
+    // Update "**Total Tasks**: X"
+    updated = updated.replace(/\*\*Total Tasks\*\*:\s*\d+/, `**Total Tasks**: ${total}`);
+    return updated;
+}
+// CLI entry point
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+    const incrementId = process.argv[2];
+    if (!incrementId) {
+        console.error('❌ Usage: update-tasks-md <incrementId>');
+        console.error('   Example: update-tasks-md 0006-llm-native-i18n');
+        process.exit(1);
+    }
+    updateTasksMd(incrementId).catch((error) => {
+        console.error('❌ Fatal error:', error);
+        process.exit(1);
+    });
+}
+export { updateTasksMd };
+//# sourceMappingURL=update-tasks-md.js.map

package/dist/plugins/specweave/lib/hooks/update-tasks-md.js.map

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

package/dist/plugins/specweave-ado/lib/ado-board-resolver.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Azure DevOps Team & Area Path Resolution for Hierarchical Sync
+ *
+ * Resolves team names and area paths for use in WIQL queries.
+ * Azure DevOps organizes work by:
+ * - Teams (organizational unit)
+ * - Area Paths (hierarchical work categorization)
+ * - Iteration Paths (sprints/time-based organization)
+ */
+/**
+ * ADO Team
+ */
+export interface AdoTeam {
+    id: string;
+    name: string;
+    description?: string;
+    projectName: string;
+    projectId: string;
+}
+/**
+ * ADO Area Path
+ */
+export interface AdoAreaPath {
+    id: number;
+    identifier: string;
+    name: string;
+    path: string;
+    hasChildren: boolean;
+}
+/**
+ * ADO Iteration Path
+ */
+export interface AdoIterationPath {
+    id: number;
+    identifier: string;
+    name: string;
+    path: string;
+    attributes: {
+        startDate?: string;
+        finishDate?: string;
+    };
+}
+/**
+ * Fetch all teams for an ADO project
+ *
+ * Uses Azure DevOps REST API: GET /{organization}/_apis/projects/{project}/teams
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @returns Array of teams
+ */
+export declare function fetchTeamsForProject(organization: string, project: string, pat: string): Promise<AdoTeam[]>;
+/**
+ * Fetch area paths for a project
+ *
+ * Uses Azure DevOps REST API: GET /{organization}/{project}/_apis/wit/classificationnodes/areas
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @returns Array of area paths (flattened hierarchy)
+ */
+export declare function fetchAreaPathsForProject(organization: string, project: string, pat: string): Promise<AdoAreaPath[]>;
+/**
+ * Fetch iteration paths for a project
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @returns Array of iteration paths (flattened hierarchy)
+ */
+export declare function fetchIterationPathsForProject(organization: string, project: string, pat: string): Promise<AdoIterationPath[]>;
+/**
+ * Resolve area path names to full paths
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @param areaPathNames Array of area path names (can be partial)
+ * @returns Map of area path name → full path
+ */
+export declare function resolveAreaPathNames(organization: string, project: string, pat: string, areaPathNames: string[]): Promise<Map<string, string>>;
+/**
+ * Get full area paths for a list of names (helper function)
+ *
+ * @param organization Organization name
+ * @param project Project name
+ * @param pat Personal Access Token
+ * @param areaPathNames Array of area path names
+ * @returns Array of full area paths (skips paths not found)
+ */
+export declare function getAreaPaths(organization: string, project: string, pat: string, areaPathNames: string[]): Promise<string[]>;
+//# sourceMappingURL=ado-board-resolver.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-board-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-board-resolver.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-board-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,EAAE,CAAC,CAiBpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,EAAE,CAAC,CAmBxB;AA+BD;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmB7B;AA+BD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsC9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAGnB"}