@braingrid/cli 0.1.0 → 0.1.2

package/dist/utils/projects.d.ts

@@ -0,0 +1,23 @@
+import { Project } from '../types/project.js';
+/**
+ * Format a project with friendly PROJ-<number> format
+ * Note: short_id already contains "PROJ-123" format
+ */
+export declare function formatProjectId(project: Project): string;
+/**
+ * Normalize project ID from various formats to API-compatible format:
+ * - "PROJ-123" -> "PROJ-123" (already normalized)
+ * - "proj-123" -> "PROJ-123" (uppercase)
+ * - "PROJ 123" -> "PROJ-123" (add dash, uppercase)
+ * - "proj 123" -> "PROJ-123" (add dash, uppercase)
+ * - "123" -> "PROJ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function parseProjectId(input: string): string;
+/**
+ * Find a project by either short_id or UUID
+ */
+export declare function findProjectById(projects: Project[], identifier: string): Project | undefined;
+//# sourceMappingURL=projects.d.ts.map

package/dist/utils/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/utils/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG9C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAW5F"}

package/dist/utils/projects.js

@@ -0,0 +1,36 @@
+import { normalizeId } from './id-normalization.js';
+/**
+ * Format a project with friendly PROJ-<number> format
+ * Note: short_id already contains "PROJ-123" format
+ */
+export function formatProjectId(project) {
+    return project.short_id;
+}
+/**
+ * Normalize project ID from various formats to API-compatible format:
+ * - "PROJ-123" -> "PROJ-123" (already normalized)
+ * - "proj-123" -> "PROJ-123" (uppercase)
+ * - "PROJ 123" -> "PROJ-123" (add dash, uppercase)
+ * - "proj 123" -> "PROJ-123" (add dash, uppercase)
+ * - "123" -> "PROJ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function parseProjectId(input) {
+    return normalizeId('PROJ', input);
+}
+/**
+ * Find a project by either short_id or UUID
+ */
+export function findProjectById(projects, identifier) {
+    const normalized = parseProjectId(identifier);
+    // Try to find by short_id first (handles PROJ-X format)
+    const byShortId = projects.find(proj => proj.short_id === normalized);
+    if (byShortId) {
+        return byShortId;
+    }
+    // Try to find by UUID
+    return projects.find(proj => proj.id === normalized);
+}
+//# sourceMappingURL=projects.js.map

package/dist/utils/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/utils/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAmB,EAAE,UAAkB;IACtE,MAAM,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE9C,wDAAwD;IACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACtE,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,sBAAsB;IACtB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;AACtD,CAAC"}

package/dist/utils/repository-access.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Repository Access Utility
+ *
+ * Helpers for checking GitHub installation and repository access during project initialization.
+ * Handles detection of owner-specific installations and repository visibility in BrainGrid.
+ */
+import { GitHubInstallation } from '../types/github.js';
+import { RepositoryService } from '../services/internal/repository-service.js';
+/**
+ * Find a GitHub installation for a specific repository owner
+ *
+ * @param owner - The GitHub repository owner (org or user)
+ * @param installations - List of GitHub installations to search
+ * @returns The matching installation or null if not found
+ *
+ * @example
+ * ```typescript
+ * const installation = findInstallationForOwner('myorg', installations);
+ * if (installation) {
+ *   console.log(`Found installation for ${installation.account_name}`);
+ * }
+ * ```
+ */
+export declare function findInstallationForOwner(owner: string, installations: GitHubInstallation[]): GitHubInstallation | null;
+/**
+ * Check if a repository is accessible in BrainGrid
+ *
+ * Queries the repository API to see if the specific owner/name combination
+ * is visible to the authenticated user's organization.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @returns True if repository is accessible, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const hasAccess = await checkRepositoryAccess(repoService, 'myorg', 'myrepo');
+ * if (hasAccess) {
+ *   console.log('Repository is accessible in BrainGrid');
+ * }
+ * ```
+ */
+export declare function checkRepositoryAccess(repositoryService: RepositoryService, owner: string, name: string): Promise<boolean>;
+/**
+ * Poll for repository access with timeout
+ *
+ * Continuously checks if a repository becomes accessible in BrainGrid.
+ * Useful when waiting for a user to grant access through the web UI.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @param intervalMs - Polling interval in milliseconds (default: 3000)
+ * @param maxAttempts - Maximum number of polling attempts (default: 60 = 3 minutes at 3s interval)
+ * @returns Promise that resolves to true if access is granted, false if timeout
+ *
+ * @example
+ * ```typescript
+ * const granted = await pollForRepositoryAccess(repoService, 'myorg', 'myrepo');
+ * if (granted) {
+ *   console.log('Access granted!');
+ * } else {
+ *   console.log('Timeout - access not granted within 3 minutes');
+ * }
+ * ```
+ */
+export declare function pollForRepositoryAccess(repositoryService: RepositoryService, owner: string, name: string, intervalMs?: number, maxAttempts?: number): Promise<boolean>;
+/**
+ * Get repository ID from BrainGrid API
+ *
+ * Fetches the repository details to get its BrainGrid UUID, which is needed
+ * for linking repositories to projects.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @returns Repository UUID or null if not found
+ *
+ * @example
+ * ```typescript
+ * const repoId = await getRepositoryId(repoService, 'myorg', 'myrepo');
+ * if (repoId) {
+ *   await projectService.createProject({ name: 'My Project', repository_ids: [repoId] });
+ * }
+ * ```
+ */
+export declare function getRepositoryId(repositoryService: RepositoryService, owner: string, name: string): Promise<string | null>;
+//# sourceMappingURL=repository-access.d.ts.map

package/dist/utils/repository-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-access.d.ts","sourceRoot":"","sources":["../../src/utils/repository-access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAE/E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,kBAAkB,EAAE,GACjC,kBAAkB,GAAG,IAAI,CAK3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CAC1C,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,uBAAuB,CAC5C,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAa,EACzB,WAAW,GAAE,MAAW,GACtB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACpC,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB"}

package/dist/utils/repository-access.js

@@ -0,0 +1,132 @@
+/**
+ * Repository Access Utility
+ *
+ * Helpers for checking GitHub installation and repository access during project initialization.
+ * Handles detection of owner-specific installations and repository visibility in BrainGrid.
+ */
+/**
+ * Find a GitHub installation for a specific repository owner
+ *
+ * @param owner - The GitHub repository owner (org or user)
+ * @param installations - List of GitHub installations to search
+ * @returns The matching installation or null if not found
+ *
+ * @example
+ * ```typescript
+ * const installation = findInstallationForOwner('myorg', installations);
+ * if (installation) {
+ *   console.log(`Found installation for ${installation.account_name}`);
+ * }
+ * ```
+ */
+export function findInstallationForOwner(owner, installations) {
+    // Case-insensitive match on account_name
+    const normalizedOwner = owner.toLowerCase();
+    return installations.find(inst => inst.account_name.toLowerCase() === normalizedOwner) || null;
+}
+/**
+ * Check if a repository is accessible in BrainGrid
+ *
+ * Queries the repository API to see if the specific owner/name combination
+ * is visible to the authenticated user's organization.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @returns True if repository is accessible, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const hasAccess = await checkRepositoryAccess(repoService, 'myorg', 'myrepo');
+ * if (hasAccess) {
+ *   console.log('Repository is accessible in BrainGrid');
+ * }
+ * ```
+ */
+export async function checkRepositoryAccess(repositoryService, owner, name) {
+    try {
+        const response = await repositoryService.listRepositories({
+            owner,
+            name,
+            limit: 1,
+        });
+        // If we get results, the repository is accessible
+        return response.repositories.length > 0;
+    }
+    catch {
+        // If the API call fails, assume no access
+        return false;
+    }
+}
+/**
+ * Poll for repository access with timeout
+ *
+ * Continuously checks if a repository becomes accessible in BrainGrid.
+ * Useful when waiting for a user to grant access through the web UI.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @param intervalMs - Polling interval in milliseconds (default: 3000)
+ * @param maxAttempts - Maximum number of polling attempts (default: 60 = 3 minutes at 3s interval)
+ * @returns Promise that resolves to true if access is granted, false if timeout
+ *
+ * @example
+ * ```typescript
+ * const granted = await pollForRepositoryAccess(repoService, 'myorg', 'myrepo');
+ * if (granted) {
+ *   console.log('Access granted!');
+ * } else {
+ *   console.log('Timeout - access not granted within 3 minutes');
+ * }
+ * ```
+ */
+export async function pollForRepositoryAccess(repositoryService, owner, name, intervalMs = 3000, maxAttempts = 60) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const hasAccess = await checkRepositoryAccess(repositoryService, owner, name);
+        if (hasAccess) {
+            return true;
+        }
+        // Wait before next attempt (unless this was the last attempt)
+        if (attempt < maxAttempts - 1) {
+            await new Promise(resolve => setTimeout(resolve, intervalMs));
+        }
+    }
+    return false;
+}
+/**
+ * Get repository ID from BrainGrid API
+ *
+ * Fetches the repository details to get its BrainGrid UUID, which is needed
+ * for linking repositories to projects.
+ *
+ * @param repositoryService - Repository service instance
+ * @param owner - GitHub repository owner
+ * @param name - GitHub repository name
+ * @returns Repository UUID or null if not found
+ *
+ * @example
+ * ```typescript
+ * const repoId = await getRepositoryId(repoService, 'myorg', 'myrepo');
+ * if (repoId) {
+ *   await projectService.createProject({ name: 'My Project', repository_ids: [repoId] });
+ * }
+ * ```
+ */
+export async function getRepositoryId(repositoryService, owner, name) {
+    try {
+        const response = await repositoryService.listRepositories({
+            owner,
+            name,
+            limit: 1,
+        });
+        if (response.repositories.length === 0) {
+            return null;
+        }
+        return response.repositories[0].id;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=repository-access.js.map

package/dist/utils/repository-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-access.js","sourceRoot":"","sources":["../../src/utils/repository-access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAa,EACb,aAAmC;IAEnC,yCAAyC;IACzC,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAE5C,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,IAAI,IAAI,CAAC;AAChG,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,iBAAoC,EACpC,KAAa,EACb,IAAY;IAEZ,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC;YACzD,KAAK;YACL,IAAI;YACJ,KAAK,EAAE,CAAC;SACR,CAAC,CAAC;QAEH,kDAAkD;QAClD,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACR,0CAA0C;QAC1C,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,iBAAoC,EACpC,KAAa,EACb,IAAY,EACZ,aAAqB,IAAI,EACzB,cAAsB,EAAE;IAExB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAE9E,IAAI,SAAS,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACb,CAAC;QAED,8DAA8D;QAC9D,IAAI,OAAO,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,iBAAoC,EACpC,KAAa,EACb,IAAY;IAEZ,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,gBAAgB,CAAC;YACzD,KAAK;YACL,IAAI;YACJ,KAAK,EAAE,CAAC;SACR,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/utils/requirements.d.ts

@@ -4,9 +4,24 @@ import { Requirement } from '../types/requirement.js';
  * Note: short_id already contains "REQ-123" format
  */
 export declare function formatRequirementId(requirement: Requirement): string;
+/**
+ * Normalize requirement ID from various formats to API-compatible format:
+ * - "REQ-123" -> "REQ-123" (already normalized)
+ * - "req-123" -> "REQ-123" (uppercase)
+ * - "REQ 123" -> "REQ-123" (add dash, uppercase)
+ * - "req 123" -> "REQ-123" (add dash, uppercase)
+ * - "123" -> "REQ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function normalizeRequirementId(input: string): string;
 /**
  * Parse a requirement ID from various formats:
  * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "req-123" -> { type: 'req_id', value: 123 }
+ * - "REQ 123" -> { type: 'req_id', value: 123 }
+ * - "req 123" -> { type: 'req_id', value: 123 }
  * - "123" -> { type: 'req_id', value: 123 }
  * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
  */

package/dist/utils/requirements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAeA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAQzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7E"}
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAClD,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB,CAwBA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,UAAU,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAQzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAS7E"}

package/dist/utils/requirements.js

@@ -1,3 +1,4 @@
+import { normalizeId } from './id-normalization.js';
 /**
  * Format a requirement with friendly REQ-<number> format
  * Note: short_id already contains "REQ-123" format
@@ -5,25 +6,49 @@
 export function formatRequirementId(requirement) {
     return requirement.short_id || `REQ-${requirement.req_id || 0}`;
 }
+/**
+ * Normalize requirement ID from various formats to API-compatible format:
+ * - "REQ-123" -> "REQ-123" (already normalized)
+ * - "req-123" -> "REQ-123" (uppercase)
+ * - "REQ 123" -> "REQ-123" (add dash, uppercase)
+ * - "req 123" -> "REQ-123" (add dash, uppercase)
+ * - "123" -> "REQ-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function normalizeRequirementId(input) {
+    return normalizeId('REQ', input);
+}
 /**
  * Parse a requirement ID from various formats:
  * - "REQ-123" -> { type: 'req_id', value: 123 }
+ * - "req-123" -> { type: 'req_id', value: 123 }
+ * - "REQ 123" -> { type: 'req_id', value: 123 }
+ * - "req 123" -> { type: 'req_id', value: 123 }
  * - "123" -> { type: 'req_id', value: 123 }
  * - "uuid-string" -> { type: 'uuid', value: 'uuid-string' }
  */
 export function parseRequirementId(input) {
-    // Handle REQ-123 format
-    const reqMatch = input.match(/^REQ-(\d+)$/i);
-    if (reqMatch) {
-        return { type: 'req_id', value: parseInt(reqMatch[1], 10) };
+    // Trim whitespace
+    const trimmed = input.trim();
+    // Handle "REQ-123" or "req-123" format (with dash)
+    const reqDashMatch = trimmed.match(/^REQ-(\d+)$/i);
+    if (reqDashMatch) {
+        return { type: 'req_id', value: parseInt(reqDashMatch[1], 10) };
+    }
+    // Handle "REQ 123" or "req 123" format (with space)
+    const reqSpaceMatch = trimmed.match(/^REQ\s+(\d+)$/i);
+    if (reqSpaceMatch) {
+        return { type: 'req_id', value: parseInt(reqSpaceMatch[1], 10) };
     }
     // Handle plain number format
-    const numberMatch = input.match(/^\d+$/);
+    const numberMatch = trimmed.match(/^\d+$/);
     if (numberMatch) {
-        return { type: 'req_id', value: parseInt(input, 10) };
+        return { type: 'req_id', value: parseInt(trimmed, 10) };
     }
     // Assume it's a UUID
-    return { type: 'uuid', value: input };
+    return { type: 'uuid', value: trimmed };
 }
 /**
  * Find a requirement by either req_id or UUID

package/dist/utils/requirements.js.map

@@ -1 +1 @@
-{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAI/C,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAA2B,EAC3B,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/utils/requirements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,QAAQ,IAAI,OAAO,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IACnD,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAI/C,kBAAkB;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,mDAAmD;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAA2B,EAC3B,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACP,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAe,EAAE,CAAC;IACvC,CAAC;SAAM,CAAC;QACP,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Spinner Utility
+ *
+ * Provides a simple polling spinner for async operations with user feedback.
+ * Shows an animated spinner while waiting for a condition to become true.
+ */
+/**
+ * Wait for a condition with animated spinner
+ *
+ * Polls an async check function and displays a spinner while waiting.
+ * Clears the spinner on completion or timeout.
+ *
+ * @param message - Message to display next to spinner
+ * @param checkFn - Async function that returns true when condition is met
+ * @param intervalMs - Polling interval in milliseconds (default: 3000)
+ * @param maxAttempts - Maximum number of attempts (default: 60 = 3 minutes at 3s interval)
+ * @returns Promise that resolves to true if condition met, false if timeout
+ *
+ * @example
+ * ```typescript
+ * const success = await waitWithSpinner(
+ *   'Waiting for repository access',
+ *   async () => await checkAccess(),
+ *   3000,
+ *   60
+ * );
+ * ```
+ */
+export declare function waitWithSpinner(message: string, checkFn: () => Promise<boolean>, intervalMs?: number, maxAttempts?: number): Promise<boolean>;
+/**
+ * Simple one-time spinner display
+ *
+ * Shows a spinner without polling. Useful for operations that manage their own timing.
+ * Returns a cleanup function to clear the spinner.
+ *
+ * @param message - Message to display
+ * @returns Cleanup function to stop and clear the spinner
+ *
+ * @example
+ * ```typescript
+ * const stop = showSpinner('Loading');
+ * await doWork();
+ * stop();
+ * ```
+ */
+export declare function showSpinner(message: string): () => void;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/utils/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,UAAU,GAAE,MAAa,EACzB,WAAW,GAAE,MAAW,GACtB,OAAO,CAAC,OAAO,CAAC,CA4ClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,IAAI,CAYvD"}

package/dist/utils/spinner.js

@@ -0,0 +1,101 @@
+/**
+ * Spinner Utility
+ *
+ * Provides a simple polling spinner for async operations with user feedback.
+ * Shows an animated spinner while waiting for a condition to become true.
+ */
+import chalk from 'chalk';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/**
+ * Wait for a condition with animated spinner
+ *
+ * Polls an async check function and displays a spinner while waiting.
+ * Clears the spinner on completion or timeout.
+ *
+ * @param message - Message to display next to spinner
+ * @param checkFn - Async function that returns true when condition is met
+ * @param intervalMs - Polling interval in milliseconds (default: 3000)
+ * @param maxAttempts - Maximum number of attempts (default: 60 = 3 minutes at 3s interval)
+ * @returns Promise that resolves to true if condition met, false if timeout
+ *
+ * @example
+ * ```typescript
+ * const success = await waitWithSpinner(
+ *   'Waiting for repository access',
+ *   async () => await checkAccess(),
+ *   3000,
+ *   60
+ * );
+ * ```
+ */
+export async function waitWithSpinner(message, checkFn, intervalMs = 3000, maxAttempts = 60) {
+    let frameIndex = 0;
+    let spinnerInterval = null;
+    // Function to update spinner
+    const updateSpinner = () => {
+        const frame = SPINNER_FRAMES[frameIndex];
+        frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+        // Clear current line and write new spinner
+        process.stdout.write(`\r${chalk.cyan(frame)} ${message}...`);
+    };
+    // Start spinner animation (update every 100ms for smooth animation)
+    spinnerInterval = setInterval(updateSpinner, 100);
+    try {
+        // Poll with the specified interval
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            const result = await checkFn();
+            if (result) {
+                // Success! Clear spinner and return
+                if (spinnerInterval)
+                    clearInterval(spinnerInterval);
+                process.stdout.write('\r' + ' '.repeat(message.length + 10) + '\r'); // Clear line
+                return true;
+            }
+            // Wait before next attempt (unless this was the last attempt)
+            if (attempt < maxAttempts - 1) {
+                await new Promise(resolve => setTimeout(resolve, intervalMs));
+            }
+        }
+        // Timeout - clear spinner and return false
+        if (spinnerInterval)
+            clearInterval(spinnerInterval);
+        process.stdout.write('\r' + ' '.repeat(message.length + 10) + '\r'); // Clear line
+        return false;
+    }
+    catch (error) {
+        // Error during polling - clean up and rethrow
+        if (spinnerInterval)
+            clearInterval(spinnerInterval);
+        process.stdout.write('\r' + ' '.repeat(message.length + 10) + '\r'); // Clear line
+        throw error;
+    }
+}
+/**
+ * Simple one-time spinner display
+ *
+ * Shows a spinner without polling. Useful for operations that manage their own timing.
+ * Returns a cleanup function to clear the spinner.
+ *
+ * @param message - Message to display
+ * @returns Cleanup function to stop and clear the spinner
+ *
+ * @example
+ * ```typescript
+ * const stop = showSpinner('Loading');
+ * await doWork();
+ * stop();
+ * ```
+ */
+export function showSpinner(message) {
+    let frameIndex = 0;
+    const interval = setInterval(() => {
+        const frame = SPINNER_FRAMES[frameIndex];
+        frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
+        process.stdout.write(`\r${chalk.cyan(frame)} ${message}...`);
+    }, 100);
+    return () => {
+        clearInterval(interval);
+        process.stdout.write('\r' + ' '.repeat(message.length + 10) + '\r');
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

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

package/dist/utils/tasks.d.ts

@@ -1,5 +1,17 @@
 import { RequirementTask as Task } from '../types/requirement.js';
 export declare function formatTaskId(task: Task): string;
+/**
+ * Normalize task ID from various formats to API-compatible format:
+ * - "TASK-123" -> "TASK-123" (already normalized)
+ * - "task-123" -> "TASK-123" (uppercase)
+ * - "TASK 123" -> "TASK-123" (add dash, uppercase)
+ * - "task 123" -> "TASK-123" (add dash, uppercase)
+ * - "123" -> "TASK-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export declare function normalizeTaskId(input: string): string;
 export declare function parseTaskId(input: string): {
     type: 'number' | 'uuid';
     value: string | number;

package/dist/utils/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAElE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAY9F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGlE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAwB9F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ3E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/utils/tasks.js

@@ -1,16 +1,41 @@
+import { normalizeId } from './id-normalization.js';
 export function formatTaskId(task) {
     return `TASK-${task.number}`;
 }
+/**
+ * Normalize task ID from various formats to API-compatible format:
+ * - "TASK-123" -> "TASK-123" (already normalized)
+ * - "task-123" -> "TASK-123" (uppercase)
+ * - "TASK 123" -> "TASK-123" (add dash, uppercase)
+ * - "task 123" -> "TASK-123" (add dash, uppercase)
+ * - "123" -> "TASK-123" (add prefix)
+ * - "uuid-string" -> "uuid-string" (UUID, return as-is)
+ *
+ * This function takes user input and returns the ID that should be used in API calls
+ */
+export function normalizeTaskId(input) {
+    return normalizeId('TASK', input);
+}
 export function parseTaskId(input) {
-    const taskMatch = input.match(/^TASK-(\d+)$/i);
-    if (taskMatch) {
-        return { type: 'number', value: parseInt(taskMatch[1], 10) };
+    // Trim whitespace
+    const trimmed = input.trim();
+    // Handle "TASK-123" or "task-123" format (with dash)
+    const taskDashMatch = trimmed.match(/^TASK-(\d+)$/i);
+    if (taskDashMatch) {
+        return { type: 'number', value: parseInt(taskDashMatch[1], 10) };
+    }
+    // Handle "TASK 123" or "task 123" format (with space)
+    const taskSpaceMatch = trimmed.match(/^TASK\s+(\d+)$/i);
+    if (taskSpaceMatch) {
+        return { type: 'number', value: parseInt(taskSpaceMatch[1], 10) };
     }
-    const numberMatch = input.match(/^\d+$/);
+    // Handle plain number format
+    const numberMatch = trimmed.match(/^\d+$/);
     if (numberMatch) {
-        return { type: 'number', value: parseInt(input, 10) };
+        return { type: 'number', value: parseInt(trimmed, 10) };
     }
-    return { type: 'uuid', value: input };
+    // Assume it's a UUID
+    return { type: 'uuid', value: trimmed };
 }
 export function findTaskById(tasks, identifier) {
     const parsed = parseTaskId(identifier);

package/dist/utils/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,IAAU;IACtC,OAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAkB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,IAAI,CAAC;QACb,KAAK,aAAa;YACjB,OAAO,IAAI,CAAC;QACb,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ;YACC,OAAO,IAAI,CAAC;IACd,CAAC;AACF,CAAC"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/utils/tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,IAAU;IACtC,OAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,kBAAkB;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,qDAAqD;IACrD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACrD,IAAI,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,sDAAsD;IACtD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACxD,IAAI,cAAc,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,qBAAqB;IACrB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,UAAkB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACjE,CAAC;SAAM,CAAC;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,SAAS;YACb,OAAO,IAAI,CAAC;QACb,KAAK,aAAa;YACjB,OAAO,IAAI,CAAC;QACb,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ,KAAK,WAAW;YACf,OAAO,GAAG,CAAC;QACZ;YACC,OAAO,IAAI,CAAC;IACd,CAAC;AACF,CAAC"}