specweave 0.16.7 → 0.16.12

package/dist/src/utils/env-multi-project-parser.js

@@ -0,0 +1,401 @@
+/**
+ * Environment Multi-Project Parser
+ *
+ * Parses comma-separated project lists from .env:
+ * - JIRA_PROJECT_KEYS=BACKEND,FRONTEND,MOBILE (multiple projects)
+ * - GITHUB_REPOS=owner/backend-api,owner/frontend-web (multiple repos)
+ * - AZURE_DEVOPS_PROJECT=myproject (single project only)
+ * - AZURE_DEVOPS_TEAMS=Frontend,Backend,Mobile (multiple teams within project)
+ *
+ * Auto-creates sync profiles for each project/repo.
+ *
+ * NOTE: Azure DevOps uses ONE project per organization with multiple teams.
+ * Multi-project support is for Jira and GitHub only.
+ */
+// ============================================================================
+// Parsing Functions
+// ============================================================================
+/**
+ * Parse comma-separated list from environment variable
+ *
+ * Handles:
+ * - Comma separation
+ * - Whitespace trimming
+ * - Empty values filtering
+ *
+ * @example
+ * parseCommaSeparated("BACKEND, FRONTEND, MOBILE")
+ * // Returns: ["BACKEND", "FRONTEND", "MOBILE"]
+ */
+export function parseCommaSeparated(value) {
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/**
+ * Parse JIRA project keys from .env
+ *
+ * Reads:
+ * - JIRA_PROJECT_KEYS (comma-separated, NEW format)
+ * - JIRA_PROJECT_KEY (single, legacy format)
+ * - JIRA_DOMAIN, JIRA_EMAIL, JIRA_API_TOKEN (shared credentials)
+ *
+ * @returns Array of JIRA project configurations
+ *
+ * @example
+ * // .env:
+ * // JIRA_PROJECT_KEYS=BACKEND,FRONTEND,MOBILE
+ * // JIRA_DOMAIN=mycompany.atlassian.net
+ * // JIRA_EMAIL=user@example.com
+ * // JIRA_API_TOKEN=abc123
+ *
+ * parseJiraProjects()
+ * // Returns: [
+ * //   { projectKey: "BACKEND", domain: "...", email: "...", apiToken: "..." },
+ * //   { projectKey: "FRONTEND", ... },
+ * //   { projectKey: "MOBILE", ... }
+ * // ]
+ */
+export function parseJiraProjects() {
+    const domain = process.env.JIRA_DOMAIN;
+    const email = process.env.JIRA_EMAIL;
+    const apiToken = process.env.JIRA_API_TOKEN;
+    // Missing credentials → return empty array
+    if (!domain || !email || !apiToken) {
+        return [];
+    }
+    // Try new format (JIRA_PROJECT_KEYS - plural)
+    const projectKeysStr = process.env.JIRA_PROJECT_KEYS;
+    if (projectKeysStr) {
+        const projectKeys = parseCommaSeparated(projectKeysStr);
+        return projectKeys.map((projectKey) => ({
+            projectKey,
+            domain,
+            email,
+            apiToken,
+        }));
+    }
+    // Fallback to legacy format (JIRA_PROJECT_KEY - singular)
+    const legacyProjectKey = process.env.JIRA_PROJECT_KEY;
+    if (legacyProjectKey) {
+        return [
+            {
+                projectKey: legacyProjectKey.trim(),
+                domain,
+                email,
+                apiToken,
+            },
+        ];
+    }
+    return [];
+}
+/**
+ * Parse GitHub repositories from .env
+ *
+ * Reads:
+ * - GITHUB_REPOS (comma-separated, format: "owner/repo,owner2/repo2")
+ * - GITHUB_TOKEN (shared credential)
+ *
+ * @returns Array of GitHub repository configurations
+ *
+ * @example
+ * // .env:
+ * // GITHUB_REPOS=myorg/backend-api,myorg/frontend-web
+ * // GITHUB_TOKEN=ghp_abc123
+ *
+ * parseGitHubRepos()
+ * // Returns: [
+ * //   { owner: "myorg", repo: "backend-api", token: "..." },
+ * //   { owner: "myorg", repo: "frontend-web", token: "..." }
+ * // ]
+ */
+export function parseGitHubRepos() {
+    const token = process.env.GITHUB_TOKEN;
+    // Missing token → return empty array
+    if (!token) {
+        return [];
+    }
+    // Parse GITHUB_REPOS (comma-separated "owner/repo" format)
+    const reposStr = process.env.GITHUB_REPOS;
+    if (!reposStr) {
+        return [];
+    }
+    const repos = parseCommaSeparated(reposStr);
+    const configs = [];
+    for (const repo of repos) {
+        // Format: "owner/repo"
+        const parts = repo.split('/');
+        if (parts.length === 2) {
+            configs.push({
+                owner: parts[0].trim(),
+                repo: parts[1].trim(),
+                token,
+            });
+        }
+    }
+    return configs;
+}
+/**
+ * Parse Azure DevOps project from .env
+ *
+ * NOTE: Azure DevOps supports ONE project per organization with multiple teams.
+ * For multi-team support, use AZURE_DEVOPS_TEAMS (comma-separated).
+ *
+ * Reads:
+ * - AZURE_DEVOPS_PROJECT (single project, required)
+ * - AZURE_DEVOPS_ORG (organization)
+ * - AZURE_DEVOPS_PAT (credential)
+ * - AZURE_DEVOPS_TEAMS (comma-separated teams, optional)
+ *
+ * @returns Array with single ADO project configuration
+ *
+ * @example
+ * // .env:
+ * // AZURE_DEVOPS_PROJECT=myproject
+ * // AZURE_DEVOPS_ORG=easychamp
+ * // AZURE_DEVOPS_PAT=xyz789
+ * // AZURE_DEVOPS_TEAMS=Frontend,Backend,Mobile
+ *
+ * parseAdoProjects()
+ * // Returns: [
+ * //   { organization: "easychamp", project: "myproject", pat: "..." }
+ * // ]
+ */
+export function parseAdoProjects() {
+    const organization = process.env.AZURE_DEVOPS_ORG;
+    const pat = process.env.AZURE_DEVOPS_PAT;
+    const project = process.env.AZURE_DEVOPS_PROJECT;
+    // Missing credentials → return empty array
+    if (!organization || !pat || !project) {
+        return [];
+    }
+    // ADO only supports ONE project per organization
+    return [
+        {
+            organization,
+            project: project.trim(),
+            pat,
+        },
+    ];
+}
+/**
+ * Parse all multi-project configurations from .env
+ *
+ * @returns All detected project configurations
+ */
+export function parseMultiProjectEnv() {
+    return {
+        jira: parseJiraProjects(),
+        github: parseGitHubRepos(),
+        ado: parseAdoProjects(),
+    };
+}
+// ============================================================================
+// Sync Profile Generation
+// ============================================================================
+/**
+ * Generate sync profile ID from project identifier
+ *
+ * Format: "{provider}-{project-id}"
+ *
+ * @example
+ * generateProfileId("jira", "BACKEND")
+ * // Returns: "jira-backend"
+ *
+ * @example
+ * generateProfileId("github", "backend-api")
+ * // Returns: "github-backend-api"
+ */
+export function generateProfileId(provider, projectId) {
+    return `${provider}-${projectId.toLowerCase().replace(/[^a-z0-9-]/g, '-')}`;
+}
+/**
+ * Create JIRA sync profile from project configuration
+ */
+export function createJiraSyncProfile(config) {
+    const profileId = generateProfileId('jira', config.projectKey);
+    return {
+        id: profileId,
+        profile: {
+            provider: 'jira',
+            displayName: `JIRA ${config.projectKey}`,
+            description: `Auto-created from JIRA_PROJECT_KEYS (project: ${config.projectKey})`,
+            config: {
+                domain: config.domain,
+                projectKey: config.projectKey,
+            },
+            timeRange: {
+                default: '1M',
+                max: '3M',
+            },
+            rateLimits: {
+                maxItemsPerSync: 200,
+                warnThreshold: 50,
+            },
+        },
+    };
+}
+/**
+ * Create GitHub sync profile from repository configuration
+ */
+export function createGitHubSyncProfile(config) {
+    const profileId = generateProfileId('github', config.repo);
+    return {
+        id: profileId,
+        profile: {
+            provider: 'github',
+            displayName: `${config.owner}/${config.repo}`,
+            description: `Auto-created from GITHUB_REPOS`,
+            config: {
+                owner: config.owner,
+                repo: config.repo,
+            },
+            timeRange: {
+                default: '1M',
+                max: '6M',
+            },
+            rateLimits: {
+                maxItemsPerSync: 500,
+                warnThreshold: 100,
+            },
+        },
+    };
+}
+/**
+ * Create Azure DevOps sync profile from project configuration
+ *
+ * NOTE: Creates ONE profile per organization. Teams are managed within the project.
+ */
+export function createAdoSyncProfile(config) {
+    const profileId = generateProfileId('ado', config.project);
+    return {
+        id: profileId,
+        profile: {
+            provider: 'ado',
+            displayName: `${config.organization}/${config.project}`,
+            description: `Auto-created from AZURE_DEVOPS_PROJECT (single project with teams)`,
+            config: {
+                organization: config.organization,
+                project: config.project,
+            },
+            timeRange: {
+                default: '1M',
+                max: '1Y',
+            },
+            rateLimits: {
+                maxItemsPerSync: 500,
+                warnThreshold: 100,
+            },
+        },
+    };
+}
+/**
+ * Generate all sync profiles from environment variables
+ *
+ * @returns Array of { id, profile } objects ready to be created
+ *
+ * @example
+ * // .env:
+ * // JIRA_PROJECT_KEYS=BACKEND,FRONTEND
+ * // GITHUB_REPOS=myorg/backend-api
+ *
+ * const profiles = generateSyncProfilesFromEnv();
+ * // Returns: [
+ * //   { id: "jira-backend", profile: { ... } },
+ * //   { id: "jira-frontend", profile: { ... } },
+ * //   { id: "github-backend-api", profile: { ... } }
+ * // ]
+ */
+export function generateSyncProfilesFromEnv() {
+    const envConfig = parseMultiProjectEnv();
+    const profiles = [];
+    // JIRA profiles
+    for (const jiraConfig of envConfig.jira) {
+        profiles.push(createJiraSyncProfile(jiraConfig));
+    }
+    // GitHub profiles
+    for (const githubConfig of envConfig.github) {
+        profiles.push(createGitHubSyncProfile(githubConfig));
+    }
+    // Azure DevOps profiles
+    for (const adoConfig of envConfig.ado) {
+        profiles.push(createAdoSyncProfile(adoConfig));
+    }
+    return profiles;
+}
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate JIRA project key format
+ *
+ * Rules:
+ * - 2-10 characters
+ * - Uppercase letters only
+ * - No special characters
+ *
+ * @example
+ * validateJiraProjectKey("BACKEND")  // → true
+ * validateJiraProjectKey("backend")  // → "Must be uppercase"
+ * validateJiraProjectKey("BACK")     // → true
+ * validateJiraProjectKey("B")        // → "Must be 2-10 characters"
+ */
+export function validateJiraProjectKey(key) {
+    if (!key) {
+        return 'Project key is required';
+    }
+    if (!/^[A-Z0-9]+$/.test(key)) {
+        return 'Project key must be uppercase letters and numbers only (e.g., BACKEND, PROJ1)';
+    }
+    if (key.length < 2 || key.length > 10) {
+        return 'Project key must be 2-10 characters';
+    }
+    return true;
+}
+/**
+ * Validate GitHub repo format
+ *
+ * Format: "owner/repo"
+ *
+ * @example
+ * validateGitHubRepo("myorg/backend-api")  // → true
+ * validateGitHubRepo("backend-api")        // → "Must be owner/repo format"
+ */
+export function validateGitHubRepo(repo) {
+    if (!repo) {
+        return 'Repository is required';
+    }
+    const parts = repo.split('/');
+    if (parts.length !== 2) {
+        return 'Repository must be in "owner/repo" format (e.g., myorg/backend-api)';
+    }
+    const [owner, repoName] = parts;
+    if (!owner || !repoName) {
+        return 'Both owner and repo name are required';
+    }
+    if (!/^[a-zA-Z0-9-_.]+$/.test(owner) || !/^[a-zA-Z0-9-_.]+$/.test(repoName)) {
+        return 'Owner and repo name can only contain letters, numbers, hyphens, underscores, and dots';
+    }
+    return true;
+}
+/**
+ * Validate Azure DevOps project name
+ *
+ * @example
+ * validateAdoProject("backend-api")  // → true
+ * validateAdoProject("")             // → "Project name is required"
+ */
+export function validateAdoProject(project) {
+    if (!project) {
+        return 'Project name is required';
+    }
+    if (project.length < 2 || project.length > 64) {
+        return 'Project name must be 2-64 characters';
+    }
+    return true;
+}
+//# sourceMappingURL=env-multi-project-parser.js.map

package/dist/src/utils/env-multi-project-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-multi-project-parser.js","sourceRoot":"","sources":["../../../src/utils/env-multi-project-parser.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/esm-helpers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ESM Helpers
+ *
+ * Provides __dirname and __filename equivalents for ES modules.
+ * In ESM, these CommonJS globals are not available, so we need to derive them
+ * from import.meta.url.
+ */
+/**
+ * Get __dirname equivalent in ESM
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns The directory path of the calling module
+ *
+ * @example
+ * ```ts
+ * import { getDirname } from './utils/esm-helpers.js';
+ * const __dirname = getDirname(import.meta.url);
+ * ```
+ */
+export declare function getDirname(importMetaUrl: string): string;
+/**
+ * Get __filename equivalent in ESM
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns The file path of the calling module
+ *
+ * @example
+ * ```ts
+ * import { getFilename } from './utils/esm-helpers.js';
+ * const __filename = getFilename(import.meta.url);
+ * ```
+ */
+export declare function getFilename(importMetaUrl: string): string;
+/**
+ * Get both __dirname and __filename at once
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns Object with __dirname and __filename
+ *
+ * @example
+ * ```ts
+ * import { getFilePaths } from './utils/esm-helpers.js';
+ * const { __dirname, __filename } = getFilePaths(import.meta.url);
+ * ```
+ */
+export declare function getFilePaths(importMetaUrl: string): {
+    __dirname: string;
+    __filename: string;
+};
+//# sourceMappingURL=esm-helpers.d.ts.map

package/dist/src/utils/esm-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/esm-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAIA"}

package/dist/src/utils/esm-helpers.js

@@ -0,0 +1,57 @@
+/**
+ * ESM Helpers
+ *
+ * Provides __dirname and __filename equivalents for ES modules.
+ * In ESM, these CommonJS globals are not available, so we need to derive them
+ * from import.meta.url.
+ */
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+/**
+ * Get __dirname equivalent in ESM
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns The directory path of the calling module
+ *
+ * @example
+ * ```ts
+ * import { getDirname } from './utils/esm-helpers.js';
+ * const __dirname = getDirname(import.meta.url);
+ * ```
+ */
+export function getDirname(importMetaUrl) {
+    return dirname(fileURLToPath(importMetaUrl));
+}
+/**
+ * Get __filename equivalent in ESM
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns The file path of the calling module
+ *
+ * @example
+ * ```ts
+ * import { getFilename } from './utils/esm-helpers.js';
+ * const __filename = getFilename(import.meta.url);
+ * ```
+ */
+export function getFilename(importMetaUrl) {
+    return fileURLToPath(importMetaUrl);
+}
+/**
+ * Get both __dirname and __filename at once
+ *
+ * @param importMetaUrl - Pass import.meta.url from the calling module
+ * @returns Object with __dirname and __filename
+ *
+ * @example
+ * ```ts
+ * import { getFilePaths } from './utils/esm-helpers.js';
+ * const { __dirname, __filename } = getFilePaths(import.meta.url);
+ * ```
+ */
+export function getFilePaths(importMetaUrl) {
+    const __filename = fileURLToPath(importMetaUrl);
+    const __dirname = dirname(__filename);
+    return { __dirname, __filename };
+}
+//# sourceMappingURL=esm-helpers.js.map

package/dist/src/utils/esm-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esm-helpers.js","sourceRoot":"","sources":["../../../src/utils/esm-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,aAAqB;IAC9C,OAAO,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,aAAqB;IAC/C,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB;IAIhD,MAAM,UAAU,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC"}

package/dist/src/utils/execFileNoThrow.d.ts

@@ -0,0 +1,99 @@
+import { ExecFileException } from 'child_process';
+/**
+ * Result from command execution
+ */
+export interface ExecResult {
+    /** Standard output from command */
+    stdout: string;
+    /** Standard error from command */
+    stderr: string;
+    /** Exit code (0 = success) */
+    exitCode: number;
+    /** Whether command succeeded (exitCode === 0) */
+    success: boolean;
+    /** Error object if command failed */
+    error?: ExecFileException;
+}
+/**
+ * Safely execute a command without throwing errors
+ *
+ * This utility uses child_process.execFile instead of exec/execSync:
+ * - ✅ Prevents command injection vulnerabilities (no shell interpolation)
+ * - ✅ Cross-platform compatible (Windows, Mac, Linux)
+ * - ✅ Proper error handling (returns result instead of throwing)
+ * - ✅ Structured output (stdout, stderr, exitCode)
+ *
+ * @param command - Command to execute (must be in PATH or absolute path)
+ * @param args - Array of arguments (safely escaped automatically)
+ * @param options - Additional execution options
+ * @returns Promise resolving to execution result
+ *
+ * @example
+ * ```typescript
+ * // ✅ Safe: Arguments automatically escaped
+ * const result = await execFileNoThrow('git', ['add', userProvidedFilename]);
+ * if (result.success) {
+ *   console.log('Git add succeeded:', result.stdout);
+ * } else {
+ *   console.error('Git add failed:', result.stderr);
+ * }
+ *
+ * // ✅ Check if command exists
+ * const which = process.platform === 'win32' ? 'where' : 'which';
+ * const checkResult = await execFileNoThrow(which, ['claude']);
+ * if (checkResult.success) {
+ *   console.log('Claude CLI found at:', checkResult.stdout.trim());
+ * }
+ * ```
+ */
+export declare function execFileNoThrow(command: string, args?: string[], options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    maxBuffer?: number;
+    shell?: boolean;
+}): Promise<ExecResult>;
+/**
+ * Synchronous version of execFileNoThrow
+ *
+ * Use sparingly - prefer async version when possible.
+ * Useful for initialization code that needs to be synchronous.
+ *
+ * @example
+ * ```typescript
+ * const result = execFileNoThrowSync('claude', ['--version']);
+ * if (result.success) {
+ *   console.log('Claude version:', result.stdout.trim());
+ * }
+ * ```
+ */
+export declare function execFileNoThrowSync(command: string, args?: string[], options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    maxBuffer?: number;
+    shell?: boolean;
+}): ExecResult;
+/**
+ * Check if a command is available in PATH
+ *
+ * Cross-platform helper that uses 'which' (Unix) or 'where' (Windows)
+ *
+ * @param command - Command name to check (e.g., 'claude', 'git', 'node')
+ * @returns Promise resolving to true if command exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * if (await isCommandAvailable('claude')) {
+ *   console.log('Claude CLI is installed');
+ * } else {
+ *   console.log('Claude CLI not found - install from https://claude.com/code');
+ * }
+ * ```
+ */
+export declare function isCommandAvailable(command: string): Promise<boolean>;
+/**
+ * Synchronous version of isCommandAvailable
+ */
+export declare function isCommandAvailableSync(command: string): boolean;
+//# sourceMappingURL=execFileNoThrow.d.ts.map

package/dist/src/utils/execFileNoThrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execFileNoThrow.d.ts","sourceRoot":"","sources":["../../../src/utils/execFileNoThrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAK1E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,UAAU,CA4BZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI/D"}