specweave 0.24.6 → 0.24.8

package/dist/src/core/repo-structure/providers/github-provider.js

@@ -0,0 +1,239 @@
+/**
+ * GitHub Provider Implementation
+ *
+ * Implements GitProvider interface for GitHub.com and GitHub Enterprise.
+ * Handles repository validation, creation, and management via GitHub API.
+ *
+ * @module providers/github-provider
+ */
+import { BaseGitProvider } from '../git-provider.js';
+import { getActionableError, formatActionableError } from '../git-error-handler.js';
+/**
+ * GitHub Provider
+ *
+ * Implements Git operations for GitHub platform.
+ */
+export class GitHubProvider extends BaseGitProvider {
+    constructor(config) {
+        super({
+            type: 'github',
+            name: 'GitHub',
+            host: config?.host || 'github.com',
+            apiBaseUrl: config?.apiBaseUrl || 'https://api.github.com',
+            selfHosted: config?.selfHosted || false,
+            customDomain: config?.customDomain
+        });
+    }
+    /**
+     * Validate if a repository exists on GitHub
+     */
+    async validateRepository(owner, repo, token) {
+        try {
+            const headers = {
+                'Accept': 'application/vnd.github.v3+json'
+            };
+            if (token) {
+                headers['Authorization'] = `token ${token}`;
+            }
+            const response = await fetch(this.getApiUrl(`/repos/${owner}/${repo}`), { headers });
+            if (response.status === 404) {
+                // Repository does not exist (good for creation)
+                return { exists: false, valid: true };
+            }
+            if (response.status === 200) {
+                // Repository already exists
+                const data = await response.json();
+                return {
+                    exists: true,
+                    valid: true,
+                    url: data.html_url
+                };
+            }
+            if (response.status === 401 || response.status === 403) {
+                // Authentication or permission error
+                const apiError = {
+                    status: response.status,
+                    message: response.statusText,
+                    platform: 'github',
+                    operation: 'validate_repo',
+                    resourceType: 'repository',
+                    resourceName: `${owner}/${repo}`
+                };
+                const actionable = getActionableError(apiError);
+                return { exists: false, valid: false, error: formatActionableError(actionable) };
+            }
+            // Other error
+            const apiError = {
+                status: response.status,
+                message: response.statusText,
+                platform: 'github',
+                operation: 'validate_repo',
+                resourceType: 'repository',
+                resourceName: `${owner}/${repo}`
+            };
+            const actionable = getActionableError(apiError);
+            return {
+                exists: false,
+                valid: false,
+                error: formatActionableError(actionable)
+            };
+        }
+        catch (error) {
+            return {
+                exists: false,
+                valid: false,
+                error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Validate if a GitHub owner (user or organization) exists
+     */
+    async validateOwner(owner, token) {
+        const headers = {
+            'Accept': 'application/vnd.github.v3+json'
+        };
+        if (token) {
+            headers['Authorization'] = `token ${token}`;
+        }
+        try {
+            // Try as user first
+            const userResponse = await fetch(this.getApiUrl(`/users/${owner}`), { headers });
+            if (userResponse.status === 200) {
+                const data = await userResponse.json();
+                const type = data.type === 'Organization' ? 'organization' : 'user';
+                return { valid: true, type };
+            }
+            // Try as organization
+            const orgResponse = await fetch(this.getApiUrl(`/orgs/${owner}`), { headers });
+            if (orgResponse.status === 200) {
+                return { valid: true, type: 'organization' };
+            }
+            // Not found
+            const apiError = {
+                status: 404,
+                message: 'Not Found',
+                platform: 'github',
+                operation: 'validate_owner',
+                resourceType: 'user',
+                resourceName: owner
+            };
+            const actionable = getActionableError(apiError);
+            return { valid: false, error: formatActionableError(actionable) };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Create a new repository on GitHub
+     */
+    async createRepository(options, token) {
+        // Check if it's an organization or user
+        const isOrg = await this.isOrganization(options.owner, token);
+        const endpoint = isOrg
+            ? this.getApiUrl(`/orgs/${options.owner}/repos`)
+            : this.getApiUrl('/user/repos');
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Authorization': `token ${token}`,
+                'Accept': 'application/vnd.github.v3+json',
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                name: options.name,
+                description: options.description,
+                private: options.visibility === 'private',
+                auto_init: options.autoInit || false,
+                has_issues: options.hasIssues !== false,
+                has_wiki: options.hasWiki || false
+            })
+        });
+        if (!response.ok) {
+            const error = await response.json();
+            // Handle "already exists" error
+            if (error.errors?.[0]?.message?.includes('already exists')) {
+                // Repository already exists, return URL
+                return `https://${this.config.host}/${options.owner}/${options.name}`;
+            }
+            // Handle other errors with actionable messages
+            const apiError = {
+                status: response.status,
+                message: error.message || response.statusText,
+                platform: 'github',
+                operation: 'create_repo',
+                resourceType: 'repository',
+                resourceName: `${options.owner}/${options.name}`
+            };
+            const actionable = getActionableError(apiError);
+            throw new Error(formatActionableError(actionable));
+        }
+        const data = await response.json();
+        return data.html_url;
+    }
+    /**
+     * Check if an account is an organization
+     */
+    async isOrganization(account, token) {
+        try {
+            const headers = {
+                'Accept': 'application/vnd.github.v3+json'
+            };
+            if (token) {
+                headers['Authorization'] = `token ${token}`;
+            }
+            const response = await fetch(this.getApiUrl(`/users/${account}`), { headers });
+            if (response.ok) {
+                const data = await response.json();
+                return data.type === 'Organization';
+            }
+        }
+        catch {
+            // Assume user if we can't determine
+        }
+        return false;
+    }
+    /**
+     * Get token creation URL
+     */
+    getTokenUrl() {
+        if (this.config.selfHosted) {
+            return `https://${this.config.customDomain || this.config.host}/settings/tokens/new`;
+        }
+        return 'https://github.com/settings/tokens/new';
+    }
+    /**
+     * Get required token scopes
+     */
+    getRequiredScopes(isOrganization) {
+        const scopes = ['repo'];
+        if (isOrganization) {
+            scopes.push('admin:org');
+        }
+        return scopes;
+    }
+    /**
+     * Override getAuthHeaders for GitHub-specific auth
+     */
+    getAuthHeaders(token) {
+        return {
+            'Authorization': `token ${token}`,
+            'Accept': 'application/vnd.github.v3+json',
+            'Content-Type': 'application/json'
+        };
+    }
+}
+/**
+ * Create a GitHub provider instance
+ *
+ * @param config - Optional platform configuration
+ * @returns GitHub provider instance
+ */
+export function createGitHubProvider(config) {
+    return new GitHubProvider(config);
+}
+//# sourceMappingURL=github-provider.js.map

package/dist/src/core/repo-structure/providers/github-provider.js.map

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

package/dist/src/core/repo-structure/providers/gitlab-provider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * GitLab Provider Implementation (STUB)
+ *
+ * Stub implementation for GitLab.com and self-hosted GitLab instances.
+ * Full implementation coming soon!
+ *
+ * @module providers/gitlab-provider
+ */
+import { BaseGitProvider, type PlatformConfig, type RepoValidationResult, type OwnerValidationResult, type CreateRepoOptions } from '../git-provider.js';
+/**
+ * GitLab Provider (Stub)
+ *
+ * Placeholder implementation for GitLab support.
+ */
+export declare class GitLabProvider extends BaseGitProvider {
+    constructor(config?: Partial<PlatformConfig>);
+    /**
+     * Validate repository (stub)
+     */
+    validateRepository(owner: string, repo: string, token?: string): Promise<RepoValidationResult>;
+    /**
+     * Validate owner (stub)
+     */
+    validateOwner(owner: string, token?: string): Promise<OwnerValidationResult>;
+    /**
+     * Create repository (stub)
+     */
+    createRepository(options: CreateRepoOptions, token: string): Promise<string>;
+    /**
+     * Check if organization (stub)
+     */
+    isOrganization(account: string, token?: string): Promise<boolean>;
+    /**
+     * Get token creation URL
+     */
+    getTokenUrl(): string;
+    /**
+     * Get required token scopes
+     */
+    getRequiredScopes(isOrganization?: boolean): string[];
+    /**
+     * Override getAuthHeaders for GitLab-specific auth (PRIVATE-TOKEN)
+     */
+    protected getAuthHeaders(token: string): Record<string, string>;
+}
+/**
+ * Create a GitLab provider instance
+ */
+export declare function createGitLabProvider(config?: Partial<PlatformConfig>): GitLabProvider;
+//# sourceMappingURL=gitlab-provider.d.ts.map

package/dist/src/core/repo-structure/providers/gitlab-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-provider.d.ts","sourceRoot":"","sources":["../../../../../src/core/repo-structure/providers/gitlab-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEzJ;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,eAAe;gBACrC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAW5C;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAmBhC;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;IAIjC;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC;IAIlB;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE;;OAEG;IACH,WAAW,IAAI,MAAM;IAOrB;;OAEG;IACH,iBAAiB,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE;IAIrD;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAOhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAErF"}

package/dist/src/core/repo-structure/providers/gitlab-provider.js

@@ -0,0 +1,97 @@
+/**
+ * GitLab Provider Implementation (STUB)
+ *
+ * Stub implementation for GitLab.com and self-hosted GitLab instances.
+ * Full implementation coming soon!
+ *
+ * @module providers/gitlab-provider
+ */
+import { BaseGitProvider } from '../git-provider.js';
+/**
+ * GitLab Provider (Stub)
+ *
+ * Placeholder implementation for GitLab support.
+ */
+export class GitLabProvider extends BaseGitProvider {
+    constructor(config) {
+        super({
+            type: 'gitlab',
+            name: 'GitLab',
+            host: config?.host || 'gitlab.com',
+            apiBaseUrl: config?.apiBaseUrl || 'https://gitlab.com/api/v4',
+            selfHosted: config?.selfHosted || false,
+            customDomain: config?.customDomain
+        });
+    }
+    /**
+     * Validate repository (stub)
+     */
+    async validateRepository(owner, repo, token) {
+        throw new Error(`
+❌ GitLab Support Coming Soon!
+
+GitLab integration is not yet implemented.
+Currently, only GitHub is fully supported.
+
+🔜 What's coming:
+   • GitLab.com and self-hosted GitLab support
+   • Project validation and creation
+   • Group/namespace support
+   • SSH and HTTPS remote URLs
+
+For now, please use GitHub or wait for the next SpecWeave release.
+
+📖 Track progress: https://github.com/anton-abyzov/specweave/issues
+    `.trim());
+    }
+    /**
+     * Validate owner (stub)
+     */
+    async validateOwner(owner, token) {
+        throw new Error('GitLab support coming soon! Please use GitHub for now.');
+    }
+    /**
+     * Create repository (stub)
+     */
+    async createRepository(options, token) {
+        throw new Error('GitLab support coming soon! Please use GitHub for now.');
+    }
+    /**
+     * Check if organization (stub)
+     */
+    async isOrganization(account, token) {
+        return false;
+    }
+    /**
+     * Get token creation URL
+     */
+    getTokenUrl() {
+        if (this.config.selfHosted) {
+            return `https://${this.config.customDomain || this.config.host}/-/profile/personal_access_tokens`;
+        }
+        return 'https://gitlab.com/-/profile/personal_access_tokens';
+    }
+    /**
+     * Get required token scopes
+     */
+    getRequiredScopes(isOrganization) {
+        return ['api', 'read_repository', 'write_repository'];
+    }
+    /**
+     * Override getAuthHeaders for GitLab-specific auth (PRIVATE-TOKEN)
+     */
+    getAuthHeaders(token) {
+        return {
+            'PRIVATE-TOKEN': token,
+            'Accept': 'application/json',
+            'Content-Type': 'application/json'
+        };
+    }
+}
+/**
+ * Create a GitLab provider instance
+ */
+export function createGitLabProvider(config) {
+    return new GitLabProvider(config);
+}
+//# sourceMappingURL=gitlab-provider.js.map

package/dist/src/core/repo-structure/providers/gitlab-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlab-provider.js","sourceRoot":"","sources":["../../../../../src/core/repo-structure/providers/gitlab-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAsG,MAAM,oBAAoB,CAAC;AAEzJ;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,YAAY,MAAgC;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,YAAY;YAClC,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,2BAA2B;YAC7D,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,KAAK;YACvC,YAAY,EAAE,MAAM,EAAE,YAAY;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,KAAa,EACb,IAAY,EACZ,KAAc;QAEd,MAAM,IAAI,KAAK,CAAC;;;;;;;;;;;;;;;KAef,CAAC,IAAI,EAAE,CAAC,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,KAAc;QAEd,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAA0B,EAC1B,KAAa;QAEb,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,KAAc;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3B,OAAO,WAAW,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,mCAAmC,CAAC;QACpG,CAAC;QACD,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,cAAwB;QACxC,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,KAAa;QACpC,OAAO;YACL,eAAe,EAAE,KAAK;YACtB,QAAQ,EAAE,kBAAkB;YAC5B,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/core/repo-structure/providers/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Git Providers Index
+ *
+ * Exports all Git provider implementations and provides
+ * initialization functions.
+ *
+ * @module providers
+ */
+export { GitHubProvider, createGitHubProvider } from './github-provider.js';
+export { GitLabProvider, createGitLabProvider } from './gitlab-provider.js';
+export { BitbucketProvider, createBitbucketProvider } from './bitbucket-provider.js';
+/**
+ * Initialize and register all Git providers
+ *
+ * Call this once during application initialization to make
+ * all providers available through the platform registry.
+ *
+ * Idempotent: Safe to call multiple times - only initializes once.
+ */
+export declare function initializeProviders(): void;
+/**
+ * Reset provider initialization state (for testing only)
+ * @internal
+ */
+export declare function resetProviders(): void;
+/**
+ * Get provider by platform type (convenience function)
+ *
+ * @param platform - Platform type
+ * @returns Provider instance or undefined
+ */
+export declare function getProvider(platform: 'github' | 'gitlab' | 'bitbucket'): import("../git-provider.js").GitProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/repo-structure/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/repo-structure/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAarF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAkB1C;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,4CAGtE"}

package/dist/src/core/repo-structure/providers/index.js

@@ -0,0 +1,60 @@
+/**
+ * Git Providers Index
+ *
+ * Exports all Git provider implementations and provides
+ * initialization functions.
+ *
+ * @module providers
+ */
+export { GitHubProvider, createGitHubProvider } from './github-provider.js';
+export { GitLabProvider, createGitLabProvider } from './gitlab-provider.js';
+export { BitbucketProvider, createBitbucketProvider } from './bitbucket-provider.js';
+import { getPlatformRegistry } from '../platform-registry.js';
+import { createGitHubProvider } from './github-provider.js';
+import { createGitLabProvider } from './gitlab-provider.js';
+import { createBitbucketProvider } from './bitbucket-provider.js';
+/**
+ * Track whether providers have been initialized
+ * Prevents re-initialization in long-running sessions (Issue #2 fix)
+ */
+let providersInitialized = false;
+/**
+ * Initialize and register all Git providers
+ *
+ * Call this once during application initialization to make
+ * all providers available through the platform registry.
+ *
+ * Idempotent: Safe to call multiple times - only initializes once.
+ */
+export function initializeProviders() {
+    // Idempotency guard: prevent re-initialization (Issue #2 fix)
+    if (providersInitialized) {
+        return;
+    }
+    const registry = getPlatformRegistry();
+    // Register GitHub provider (fully supported)
+    registry.registerProvider('github', createGitHubProvider());
+    // Register GitLab provider (stub - coming soon)
+    registry.registerProvider('gitlab', createGitLabProvider());
+    // Register Bitbucket provider (stub - coming soon)
+    registry.registerProvider('bitbucket', createBitbucketProvider());
+    providersInitialized = true;
+}
+/**
+ * Reset provider initialization state (for testing only)
+ * @internal
+ */
+export function resetProviders() {
+    providersInitialized = false;
+}
+/**
+ * Get provider by platform type (convenience function)
+ *
+ * @param platform - Platform type
+ * @returns Provider instance or undefined
+ */
+export function getProvider(platform) {
+    const registry = getPlatformRegistry();
+    return registry.getProvider(platform);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/core/repo-structure/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/repo-structure/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;GAGG;AACH,IAAI,oBAAoB,GAAG,KAAK,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,8DAA8D;IAC9D,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,6CAA6C;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAE5D,gDAAgD;IAChD,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAE5D,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,uBAAuB,EAAE,CAAC,CAAC;IAElE,oBAAoB,GAAG,IAAI,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,oBAAoB,GAAG,KAAK,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAA2C;IACrE,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,OAAO,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/core/repo-structure/repo-structure-manager.d.ts

@@ -14,9 +14,13 @@
  * - Organize specs per project/team
  * - Split tasks between repositories
  */
+import type { GitProvider, GitPlatformType } from './git-provider.js';
 export type RepoArchitecture = 'single' | 'multi-repo' | 'monorepo' | 'parent';
 export interface RepoStructureConfig {
     architecture: RepoArchitecture;
+    urlType: 'ssh' | 'https';
+    platform: GitPlatformType;
+    provider: GitProvider;
     parentRepo?: {
         name: string;
         owner: string;
@@ -61,6 +65,9 @@ export declare class RepoStructureManager {
      * Configure multi-repository architecture
      * @param useParent - Whether to use parent repository/folder
      * @param isLocalParent - If true, parent folder is local only (NOT pushed to GitHub)
+     * @param urlType - Git remote URL format (ssh or https)
+     * @param platform - Git hosting platform type
+     * @param provider - Git provider instance for API operations
      *
      * NOTE: This is primarily user-facing output (console.log/console.error).
      * All console.* calls in this method are legitimate user-facing exceptions
@@ -76,9 +83,9 @@ export declare class RepoStructureManager {
      */
     private configureMonorepo;
     /**
-     * Create repositories on GitHub via API
+     * Create repositories on Git hosting platform via API
      */
-    createGitHubRepositories(config: RepoStructureConfig): Promise<void>;
+    createRepositories(config: RepoStructureConfig): Promise<void>;
     /**
      * Generate .env file with GitHub configuration
      */
@@ -101,7 +108,7 @@ export declare class RepoStructureManager {
     private repositoryExistsOnGitHub;
     /**
      * Clone or initialize a repository
-     * If the repo exists on GitHub, clone it; otherwise, init + add remote
+     * If the repo exists on the platform, clone it; otherwise, init + add remote
      */
     private cloneOrInitRepository;
     /**

package/dist/src/core/repo-structure/repo-structure-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-structure-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-structure-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAyBH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAoB;gBAE5B,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAMrD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsDrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,mBAAmB;IAoIjC;;;;;;;;OAQG;YACW,kBAAkB;IAkiBhC;;OAEG;YACW,cAAc;IAQ5B;;OAEG;YACW,iBAAiB;IAgF/B;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF1E;;OAEG;YACW,eAAe;IA8C7B;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;YACW,wBAAwB;IAmBtC;;;OAGG;YACW,qBAAqB;IAiEnC;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEtE;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;;OAKG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC3E"}
+{"version":3,"file":"repo-structure-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-structure-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA4BH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAoB;gBAE5B,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IASrD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAoGrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;YACW,WAAW;IAgCzB;;OAEG;YACW,mBAAmB;IA8IjC;;;;;;;;;;;OAWG;YACW,kBAAkB;IAijBhC;;OAEG;YACW,cAAc;IAQ5B;;OAEG;YACW,iBAAiB;IAuF/B;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFpE;;OAEG;YACW,eAAe;IA8C7B;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;YACW,wBAAwB;IAmBtC;;;OAGG;YACW,qBAAqB;IAmEnC;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEtE;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;;OAKG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC3E"}