specweave 0.7.1 → 0.8.2

package/dist/core/types/sync-profile.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Sync Profile Types for Multi-Project External Integration
+ *
+ * Supports multiple projects per provider (GitHub, JIRA, ADO, etc.)
+ * with time range filtering and rate limiting protection.
+ */
+export type SyncProvider = 'github' | 'jira' | 'ado';
+export interface GitHubConfig {
+    owner: string;
+    repo: string;
+}
+export interface JiraConfig {
+    domain: string;
+    projectKey: string;
+    issueType?: 'Epic' | 'Story' | 'Task';
+}
+export interface AdoConfig {
+    organization: string;
+    project: string;
+    workItemType?: 'Epic' | 'Feature' | 'User Story';
+    areaPath?: string;
+    iterationPath?: string;
+}
+export type ProviderConfig = GitHubConfig | JiraConfig | AdoConfig;
+export type TimeRangePreset = '1W' | '2W' | '1M' | '3M' | '6M' | '1Y' | 'ALL';
+export interface TimeRangeConfig {
+    /** Preset time range */
+    preset?: TimeRangePreset;
+    /** Custom date range */
+    custom?: {
+        start: string;
+        end?: string;
+    };
+}
+export interface TimeRangeEstimate {
+    /** Estimated work items to sync */
+    items: number;
+    /** Estimated API requests */
+    apiCalls: number;
+    /** Estimated sync duration in minutes */
+    durationMinutes: number;
+    /** Rate limit impact level */
+    rateLimitImpact: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface RateLimitConfig {
+    /** Maximum items to sync in one operation */
+    maxItemsPerSync: number;
+    /** Warn user when exceeding this threshold */
+    warnThreshold: number;
+}
+export interface RateLimitStatus {
+    /** Remaining requests in current window */
+    remaining: number;
+    /** Total limit per window */
+    limit: number;
+    /** When the rate limit resets (ISO timestamp) */
+    resetAt: string;
+    /** Percentage of limit used */
+    percentUsed: number;
+}
+export interface ProviderRateLimits {
+    github: {
+        limit: 5000;
+        window: '1h';
+        thresholds: {
+            low: 250;
+            medium: 1000;
+            high: 2500;
+        };
+    };
+    jira: {
+        limit: 100;
+        window: '1m';
+        thresholds: {
+            low: 25;
+            medium: 50;
+            high: 75;
+        };
+    };
+    ado: {
+        limit: 200;
+        window: '5m';
+        thresholds: {
+            low: 50;
+            medium: 100;
+            high: 150;
+        };
+    };
+}
+export interface SyncProfile {
+    /** Provider type */
+    provider: SyncProvider;
+    /** Human-readable name */
+    displayName: string;
+    /** Optional description */
+    description?: string;
+    /** Provider-specific configuration */
+    config: ProviderConfig;
+    /** Time range configuration */
+    timeRange: {
+        /** Default time range for this profile */
+        default: TimeRangePreset;
+        /** Maximum allowed time range */
+        max: TimeRangePreset;
+    };
+    /** Rate limiting configuration */
+    rateLimits?: RateLimitConfig;
+    /** Project context (for smart detection) */
+    projectContext?: {
+        /** Project name (e.g., "SpecWeave", "Client A Mobile") */
+        name: string;
+        /** Project description */
+        description?: string;
+        /** Keywords for auto-detection */
+        keywords?: string[];
+        /** Team/organization name */
+        team?: string;
+    };
+}
+export interface SyncProfiles {
+    /** Active profile (default selection) */
+    activeProfile?: string;
+    /** All available profiles */
+    profiles: Record<string, SyncProfile>;
+}
+export interface IncrementSyncMetadata {
+    /** Which profile this increment uses */
+    profile: string;
+    /** External issue/work item number */
+    issueNumber?: number;
+    /** External issue/work item key (for JIRA) */
+    issueKey?: string;
+    /** Direct URL to external issue */
+    issueUrl?: string;
+    /** Time range used for this sync */
+    timeRange: TimeRangePreset | 'custom';
+    /** Custom time range (if timeRange === 'custom') */
+    customTimeRange?: {
+        start: string;
+        end?: string;
+    };
+    /** When sync was created */
+    createdAt: string;
+    /** Last successful sync timestamp */
+    lastSyncAt?: string;
+    /** Sync status */
+    status?: 'active' | 'paused' | 'failed' | 'completed';
+    /** Last sync error (if any) */
+    lastError?: {
+        message: string;
+        timestamp: string;
+        rateLimited?: boolean;
+    };
+}
+export interface ProjectContext {
+    /** Unique project identifier (kebab-case) */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Project description */
+    description: string;
+    /** Team/organization */
+    team?: string;
+    /** Keywords for auto-detection */
+    keywords: string[];
+    /** Default sync profile for this project */
+    defaultSyncProfile?: string;
+    /** Project-specific specs folder */
+    specsFolder: string;
+    /** Related increments (for tracking) */
+    increments?: string[];
+}
+export interface SyncConfiguration {
+    /** Active profile */
+    activeProfile?: string;
+    /** All sync profiles */
+    profiles: Record<string, SyncProfile>;
+    /** Project contexts */
+    projects?: Record<string, ProjectContext>;
+    /** Global settings */
+    settings?: {
+        /** Auto-detect project from increment description */
+        autoDetectProject?: boolean;
+        /** Default time range for new syncs */
+        defaultTimeRange?: TimeRangePreset;
+        /** Enable rate limit protection */
+        rateLimitProtection?: boolean;
+    };
+}
+export interface ProfileValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings?: string[];
+}
+export interface ProjectDetectionResult {
+    /** Matched project (if any) */
+    project?: ProjectContext;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Matched keywords */
+    matchedKeywords: string[];
+    /** Suggested sync profile */
+    suggestedProfile?: string;
+}
+//# sourceMappingURL=sync-profile.d.ts.map

package/dist/core/types/sync-profile.d.ts.map

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

package/dist/core/types/sync-profile.js

@@ -0,0 +1,8 @@
+/**
+ * Sync Profile Types for Multi-Project External Integration
+ *
+ * Supports multiple projects per provider (GitHub, JIRA, ADO, etc.)
+ * with time range filtering and rate limiting protection.
+ */
+export {};
+//# sourceMappingURL=sync-profile.js.map

package/dist/core/types/sync-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-profile.js","sourceRoot":"","sources":["../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/project-detection.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Project ID Auto-Detection Utilities
+ *
+ * Detects project ID from:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA project key, ADO project name)
+ * 3. User prompt (fallback)
+ */
+/**
+ * Auto-detect project ID from git remote URL
+ *
+ * Extracts repository name from git remote URL
+ *
+ * @param projectRoot - Project root directory
+ * @returns Project ID (repo name) or null if not detected
+ *
+ * @example
+ * // Git remote: https://github.com/anton-abyzov/specweave.git
+ * detectProjectIdFromGit('/path/to/project')
+ * // Returns: "specweave"
+ *
+ * @example
+ * // Git remote: git@github.com:my-org/web-app.git
+ * detectProjectIdFromGit('/path/to/project')
+ * // Returns: "web-app"
+ */
+export declare function detectProjectIdFromGit(projectRoot: string): string | null;
+/**
+ * Auto-detect project ID from sync configuration
+ *
+ * Checks existing sync profiles for JIRA project key or ADO project name
+ *
+ * @param projectRoot - Project root directory
+ * @returns Project ID from sync config or null if not detected
+ *
+ * @example
+ * // Config has JIRA: { projectKey: "WEBAPP" }
+ * detectProjectIdFromSync('/path/to/project')
+ * // Returns: "webapp"
+ */
+export declare function detectProjectIdFromSync(projectRoot: string): string | null;
+/**
+ * Prompt user for project ID
+ *
+ * Interactive prompt with validation and helpful examples
+ *
+ * @param suggestedId - Optional suggested project ID (from detection)
+ * @returns Project ID entered by user
+ *
+ * @example
+ * await promptForProjectId()
+ * // User sees:
+ * // Project ID (matches GitHub repo, JIRA project, or ADO project): █
+ * // User enters: "web-app"
+ * // Returns: "web-app"
+ */
+export declare function promptForProjectId(suggestedId?: string): Promise<string>;
+/**
+ * Auto-detect project ID synchronously (no prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. "default" (fallback)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected project ID or "default"
+ *
+ * @example
+ * // In git repo: https://github.com/anton-abyzov/specweave.git
+ * autoDetectProjectIdSync('/path/to/project')
+ * // Returns: "specweave"
+ *
+ * @example
+ * // No git, no sync
+ * autoDetectProjectIdSync('/path/to/project')
+ * // Returns: "default"
+ */
+export declare function autoDetectProjectIdSync(projectRoot: string, options?: {
+    silent?: boolean;
+}): string;
+/**
+ * Auto-detect project ID with fallback chain (async version with prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. User prompt (with detected suggestion)
+ * 4. "default" (if user accepts default in prompt)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected or prompted project ID
+ *
+ * @example
+ * // In git repo: https://github.com/anton-abyzov/specweave.git
+ * await autoDetectProjectId('/path/to/project')
+ * // Output: "✅ Detected git repository: specweave"
+ * // Returns: "specweave"
+ *
+ * @example
+ * // No git, no sync, user prompted
+ * await autoDetectProjectId('/path/to/project')
+ * // Output: "📝 No git repository or sync configuration detected."
+ * // Prompts user for project ID
+ * // Returns: user input (e.g., "my-project")
+ */
+export declare function autoDetectProjectId(projectRoot: string, options?: {
+    silent?: boolean;
+    promptIfNotDetected?: boolean;
+}): Promise<string>;
+/**
+ * Format project ID to display name
+ *
+ * Converts kebab-case/snake_case to Title Case
+ *
+ * @param projectId - Project ID (e.g., "web-app", "mobile_app")
+ * @returns Formatted name (e.g., "Web App", "Mobile App")
+ *
+ * @example
+ * formatProjectName('web-app')
+ * // Returns: "Web App"
+ *
+ * @example
+ * formatProjectName('mobile_app')
+ * // Returns: "Mobile App"
+ *
+ * @example
+ * formatProjectName('specweave')
+ * // Returns: "SpecWeave"
+ */
+export declare function formatProjectName(projectId: string): string;
+/**
+ * Validate project ID format
+ *
+ * @param projectId - Project ID to validate
+ * @returns True if valid, error message if invalid
+ */
+export declare function validateProjectId(projectId: string): true | string;
+//# sourceMappingURL=project-detection.d.ts.map

package/dist/utils/project-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detection.d.ts","sourceRoot":"","sources":["../../src/utils/project-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsD1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B9E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1B,GACL,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAkBlE"}

package/dist/utils/project-detection.js

@@ -0,0 +1,321 @@
+/**
+ * Project ID Auto-Detection Utilities
+ *
+ * Detects project ID from:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA project key, ADO project name)
+ * 3. User prompt (fallback)
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import inquirer from 'inquirer';
+import { ConfigManager } from '../core/config-manager';
+/**
+ * Auto-detect project ID from git remote URL
+ *
+ * Extracts repository name from git remote URL
+ *
+ * @param projectRoot - Project root directory
+ * @returns Project ID (repo name) or null if not detected
+ *
+ * @example
+ * // Git remote: https://github.com/anton-abyzov/specweave.git
+ * detectProjectIdFromGit('/path/to/project')
+ * // Returns: "specweave"
+ *
+ * @example
+ * // Git remote: git@github.com:my-org/web-app.git
+ * detectProjectIdFromGit('/path/to/project')
+ * // Returns: "web-app"
+ */
+export function detectProjectIdFromGit(projectRoot) {
+    try {
+        const gitConfigPath = path.join(projectRoot, '.git', 'config');
+        // Check if .git/config exists
+        if (!fs.existsSync(gitConfigPath)) {
+            return null;
+        }
+        // Read git config
+        const gitConfig = fs.readFileSync(gitConfigPath, 'utf8');
+        // Extract remote URL (match both HTTPS and SSH formats)
+        // HTTPS: https://github.com/owner/repo.git
+        // SSH: git@github.com:owner/repo.git
+        const httpsMatch = gitConfig.match(/url = https?:\/\/[^\/]+\/[^\/]+\/([^\/\s]+?)(?:\.git)?$/m);
+        const sshMatch = gitConfig.match(/url = git@[^:]+:[^\/]+\/([^\/\s]+?)(?:\.git)?$/m);
+        const match = httpsMatch || sshMatch;
+        if (match && match[1]) {
+            const repoName = match[1].trim();
+            // Validate repo name (lowercase, alphanumeric, hyphens, underscores)
+            if (/^[a-z0-9_-]+$/i.test(repoName)) {
+                return repoName.toLowerCase();
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        // Silently fail (not in git repo or permission error)
+        return null;
+    }
+}
+/**
+ * Auto-detect project ID from sync configuration
+ *
+ * Checks existing sync profiles for JIRA project key or ADO project name
+ *
+ * @param projectRoot - Project root directory
+ * @returns Project ID from sync config or null if not detected
+ *
+ * @example
+ * // Config has JIRA: { projectKey: "WEBAPP" }
+ * detectProjectIdFromSync('/path/to/project')
+ * // Returns: "webapp"
+ */
+export function detectProjectIdFromSync(projectRoot) {
+    try {
+        const configManager = new ConfigManager(projectRoot);
+        const config = configManager.load();
+        // Check sync profiles for project identifiers
+        if (config.sync?.profiles) {
+            const profiles = Object.values(config.sync.profiles);
+            for (const profile of profiles) {
+                // GitHub profile (extract repo name)
+                if (profile.provider === 'github') {
+                    const githubConfig = profile.config;
+                    if (githubConfig?.repo) {
+                        return githubConfig.repo.toLowerCase();
+                    }
+                }
+                // JIRA profile (use project key)
+                if (profile.provider === 'jira') {
+                    const jiraConfig = profile.config;
+                    if (jiraConfig?.projectKey) {
+                        return jiraConfig.projectKey.toLowerCase();
+                    }
+                }
+                // Azure DevOps profile (use project name)
+                if (profile.provider === 'ado') {
+                    const adoConfig = profile.config;
+                    if (adoConfig?.project) {
+                        return adoConfig.project.toLowerCase().replace(/\s+/g, '-');
+                    }
+                }
+            }
+        }
+        // Legacy: Check old sync config format (pre-profiles)
+        if (config.sync?.jira?.projectKey) {
+            return config.sync.jira.projectKey.toLowerCase();
+        }
+        if (config.sync?.ado?.project) {
+            return config.sync.ado.project.toLowerCase().replace(/\s+/g, '-');
+        }
+        if (config.sync?.github?.repo) {
+            return config.sync.github.repo.toLowerCase();
+        }
+        return null;
+    }
+    catch (error) {
+        // Config doesn't exist or is invalid
+        return null;
+    }
+}
+/**
+ * Prompt user for project ID
+ *
+ * Interactive prompt with validation and helpful examples
+ *
+ * @param suggestedId - Optional suggested project ID (from detection)
+ * @returns Project ID entered by user
+ *
+ * @example
+ * await promptForProjectId()
+ * // User sees:
+ * // Project ID (matches GitHub repo, JIRA project, or ADO project): █
+ * // User enters: "web-app"
+ * // Returns: "web-app"
+ */
+export async function promptForProjectId(suggestedId) {
+    const { projectId } = await inquirer.prompt([{
+            type: 'input',
+            name: 'projectId',
+            message: 'Project ID (matches GitHub repo, JIRA project, or ADO project):',
+            default: suggestedId || 'default',
+            validate: (input) => {
+                if (!input) {
+                    return 'Project ID is required';
+                }
+                if (!/^[a-z0-9_-]+$/.test(input)) {
+                    return 'Project ID must be lowercase, alphanumeric, with hyphens or underscores';
+                }
+                if (input.length < 2) {
+                    return 'Project ID must be at least 2 characters';
+                }
+                if (input.length > 64) {
+                    return 'Project ID must be at most 64 characters';
+                }
+                return true;
+            }
+        }]);
+    return projectId;
+}
+/**
+ * Auto-detect project ID synchronously (no prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. "default" (fallback)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected project ID or "default"
+ *
+ * @example
+ * // In git repo: https://github.com/anton-abyzov/specweave.git
+ * autoDetectProjectIdSync('/path/to/project')
+ * // Returns: "specweave"
+ *
+ * @example
+ * // No git, no sync
+ * autoDetectProjectIdSync('/path/to/project')
+ * // Returns: "default"
+ */
+export function autoDetectProjectIdSync(projectRoot, options = {}) {
+    const { silent = false } = options;
+    // 1. Try git remote
+    const gitProjectId = detectProjectIdFromGit(projectRoot);
+    if (gitProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected git repository: ${gitProjectId}`);
+        }
+        return gitProjectId;
+    }
+    // 2. Try sync config
+    const syncProjectId = detectProjectIdFromSync(projectRoot);
+    if (syncProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected sync configuration: ${syncProjectId}`);
+        }
+        return syncProjectId;
+    }
+    // 3. Fallback to "default"
+    return 'default';
+}
+/**
+ * Auto-detect project ID with fallback chain (async version with prompts)
+ *
+ * Priority:
+ * 1. Git remote (GitHub repo name)
+ * 2. Sync configuration (JIRA/ADO project)
+ * 3. User prompt (with detected suggestion)
+ * 4. "default" (if user accepts default in prompt)
+ *
+ * @param projectRoot - Project root directory
+ * @param options - Detection options
+ * @returns Detected or prompted project ID
+ *
+ * @example
+ * // In git repo: https://github.com/anton-abyzov/specweave.git
+ * await autoDetectProjectId('/path/to/project')
+ * // Output: "✅ Detected git repository: specweave"
+ * // Returns: "specweave"
+ *
+ * @example
+ * // No git, no sync, user prompted
+ * await autoDetectProjectId('/path/to/project')
+ * // Output: "📝 No git repository or sync configuration detected."
+ * // Prompts user for project ID
+ * // Returns: user input (e.g., "my-project")
+ */
+export async function autoDetectProjectId(projectRoot, options = {}) {
+    const { silent = false, promptIfNotDetected = true } = options;
+    // 1. Try git remote
+    const gitProjectId = detectProjectIdFromGit(projectRoot);
+    if (gitProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected git repository: ${gitProjectId}`);
+        }
+        return gitProjectId;
+    }
+    // 2. Try sync config
+    const syncProjectId = detectProjectIdFromSync(projectRoot);
+    if (syncProjectId) {
+        if (!silent) {
+            console.log(`✅ Detected sync configuration: ${syncProjectId}`);
+        }
+        return syncProjectId;
+    }
+    // 3. Prompt user (if enabled)
+    if (promptIfNotDetected) {
+        if (!silent) {
+            console.log('\n📝 No git repository or sync configuration detected.');
+            console.log('   Please enter your project identifier.\n');
+            console.log('   Examples:');
+            console.log('   • GitHub repo "web-app" → enter: web-app');
+            console.log('   • JIRA project "WEBAPP" → enter: webapp');
+            console.log('   • ADO project "Platform" → enter: platform');
+            console.log('   • Generic project → enter: default\n');
+        }
+        return await promptForProjectId();
+    }
+    // 4. Fallback to "default" (no prompt)
+    return 'default';
+}
+/**
+ * Format project ID to display name
+ *
+ * Converts kebab-case/snake_case to Title Case
+ *
+ * @param projectId - Project ID (e.g., "web-app", "mobile_app")
+ * @returns Formatted name (e.g., "Web App", "Mobile App")
+ *
+ * @example
+ * formatProjectName('web-app')
+ * // Returns: "Web App"
+ *
+ * @example
+ * formatProjectName('mobile_app')
+ * // Returns: "Mobile App"
+ *
+ * @example
+ * formatProjectName('specweave')
+ * // Returns: "SpecWeave"
+ */
+export function formatProjectName(projectId) {
+    // Special cases (known project names)
+    const specialCases = {
+        'specweave': 'SpecWeave',
+        'webapp': 'WebApp',
+        'default': 'Default Project'
+    };
+    if (specialCases[projectId.toLowerCase()]) {
+        return specialCases[projectId.toLowerCase()];
+    }
+    // Convert kebab-case or snake_case to Title Case
+    return projectId
+        .replace(/[-_]/g, ' ')
+        .split(' ')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+/**
+ * Validate project ID format
+ *
+ * @param projectId - Project ID to validate
+ * @returns True if valid, error message if invalid
+ */
+export function validateProjectId(projectId) {
+    if (!projectId) {
+        return 'Project ID is required';
+    }
+    if (!/^[a-z0-9_-]+$/.test(projectId)) {
+        return 'Project ID must be lowercase, alphanumeric, with hyphens or underscores';
+    }
+    if (projectId.length < 2) {
+        return 'Project ID must be at least 2 characters';
+    }
+    if (projectId.length > 64) {
+        return 'Project ID must be at most 64 characters';
+    }
+    return true;
+}
+//# sourceMappingURL=project-detection.js.map