specweave 0.17.0 → 0.17.2

package/dist/src/core/repo-structure/repo-id-generator.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Repository ID Generator
+ *
+ * Auto-generates clean, unique repository IDs from repository names.
+ * Strips common suffixes and takes last segment for readable IDs.
+ *
+ * Examples:
+ *   "my-saas-frontend-app" → "frontend"
+ *   "acme-api-gateway-service" → "gateway"
+ *   "backend-service" → "backend"
+ *
+ * @module repo-id-generator
+ */
+/**
+ * Validation result for repository IDs
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Result of ensuring unique ID
+ */
+export interface UniqueIdResult {
+    id: string;
+    wasModified: boolean;
+}
+/**
+ * Generate a clean repository ID from a repository name.
+ *
+ * Algorithm:
+ * 1. Convert to lowercase
+ * 2. Strip one common suffix from the end (if exists): -app, -service, etc.
+ * 3. Split by hyphens
+ * 4. Take the last segment
+ *
+ * @param repoName - Full repository name (e.g., "my-saas-frontend-app")
+ * @returns Clean repository ID (e.g., "frontend")
+ *
+ * @example
+ * generateRepoId("my-saas-frontend-app") // "frontend" (strips "-app", then takes "frontend")
+ * generateRepoId("acme-api-gateway-service") // "gateway" (strips "-service", then takes "gateway")
+ * generateRepoId("backend-service") // "backend" (strips "-service", then takes "backend")
+ * generateRepoId("acme-saas-mobile") // "mobile" (no suffix to strip, takes "mobile")
+ */
+export declare function generateRepoId(repoName: string): string;
+/**
+ * Ensure repository ID is unique by appending numeric suffix if needed.
+ *
+ * @param baseId - Base repository ID to make unique
+ * @param existingIds - Set of already-used IDs
+ * @returns Unique ID with modification flag
+ *
+ * @example
+ * ensureUniqueId("frontend", new Set()) // { id: "frontend", wasModified: false }
+ * ensureUniqueId("frontend", new Set(["frontend"])) // { id: "frontend-2", wasModified: true }
+ * ensureUniqueId("frontend", new Set(["frontend", "frontend-2"])) // { id: "frontend-3", wasModified: true }
+ */
+export declare function ensureUniqueId(baseId: string, existingIds: Set<string>): UniqueIdResult;
+/**
+ * Validate a repository ID against naming rules.
+ *
+ * Rules:
+ * - No commas (prevents "parent,fe,be" input error)
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must start with a letter
+ * - Length 1-50 characters
+ * - No spaces or special characters
+ *
+ * @param id - Repository ID to validate
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * validateRepoId("frontend-app") // { valid: true }
+ * validateRepoId("parent,fe,be") // { valid: false, error: "..." }
+ * validateRepoId("MyRepo") // { valid: false, error: "..." }
+ */
+export declare function validateRepoId(id: string): ValidationResult;
+//# sourceMappingURL=repo-id-generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,cAAc,CAYvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAqC3D"}

package/dist/src/core/repo-structure/repo-id-generator.js

@@ -0,0 +1,135 @@
+/**
+ * Repository ID Generator
+ *
+ * Auto-generates clean, unique repository IDs from repository names.
+ * Strips common suffixes and takes last segment for readable IDs.
+ *
+ * Examples:
+ *   "my-saas-frontend-app" → "frontend"
+ *   "acme-api-gateway-service" → "gateway"
+ *   "backend-service" → "backend"
+ *
+ * @module repo-id-generator
+ */
+/**
+ * Common repository name suffixes to strip
+ */
+const REPO_SUFFIXES = [
+    '-app',
+    '-service',
+    '-api',
+    '-frontend',
+    '-backend',
+    '-web',
+    '-mobile'
+];
+/**
+ * Generate a clean repository ID from a repository name.
+ *
+ * Algorithm:
+ * 1. Convert to lowercase
+ * 2. Strip one common suffix from the end (if exists): -app, -service, etc.
+ * 3. Split by hyphens
+ * 4. Take the last segment
+ *
+ * @param repoName - Full repository name (e.g., "my-saas-frontend-app")
+ * @returns Clean repository ID (e.g., "frontend")
+ *
+ * @example
+ * generateRepoId("my-saas-frontend-app") // "frontend" (strips "-app", then takes "frontend")
+ * generateRepoId("acme-api-gateway-service") // "gateway" (strips "-service", then takes "gateway")
+ * generateRepoId("backend-service") // "backend" (strips "-service", then takes "backend")
+ * generateRepoId("acme-saas-mobile") // "mobile" (no suffix to strip, takes "mobile")
+ */
+export function generateRepoId(repoName) {
+    if (!repoName) {
+        return '';
+    }
+    let cleaned = repoName.toLowerCase();
+    // Strip one suffix from the end (if exists)
+    for (const suffix of REPO_SUFFIXES) {
+        if (cleaned.endsWith(suffix)) {
+            cleaned = cleaned.slice(0, -suffix.length);
+            break; // Only strip one suffix
+        }
+    }
+    // Split by hyphen and take last segment
+    const segments = cleaned.split('-').filter(seg => seg.length > 0);
+    if (segments.length === 0) {
+        return '';
+    }
+    return segments[segments.length - 1];
+}
+/**
+ * Ensure repository ID is unique by appending numeric suffix if needed.
+ *
+ * @param baseId - Base repository ID to make unique
+ * @param existingIds - Set of already-used IDs
+ * @returns Unique ID with modification flag
+ *
+ * @example
+ * ensureUniqueId("frontend", new Set()) // { id: "frontend", wasModified: false }
+ * ensureUniqueId("frontend", new Set(["frontend"])) // { id: "frontend-2", wasModified: true }
+ * ensureUniqueId("frontend", new Set(["frontend", "frontend-2"])) // { id: "frontend-3", wasModified: true }
+ */
+export function ensureUniqueId(baseId, existingIds) {
+    if (!existingIds.has(baseId)) {
+        return { id: baseId, wasModified: false };
+    }
+    // Find first available suffix
+    let counter = 2;
+    while (existingIds.has(`${baseId}-${counter}`)) {
+        counter++;
+    }
+    return { id: `${baseId}-${counter}`, wasModified: true };
+}
+/**
+ * Validate a repository ID against naming rules.
+ *
+ * Rules:
+ * - No commas (prevents "parent,fe,be" input error)
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must start with a letter
+ * - Length 1-50 characters
+ * - No spaces or special characters
+ *
+ * @param id - Repository ID to validate
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * validateRepoId("frontend-app") // { valid: true }
+ * validateRepoId("parent,fe,be") // { valid: false, error: "..." }
+ * validateRepoId("MyRepo") // { valid: false, error: "..." }
+ */
+export function validateRepoId(id) {
+    // Check empty
+    if (!id || id.trim().length === 0) {
+        return { valid: false, error: 'Repository ID cannot be empty' };
+    }
+    // Check length
+    if (id.length > 50) {
+        return { valid: false, error: 'Repository ID exceeds maximum length (50 characters)' };
+    }
+    // Check for commas (prevents "parent,fe,be" error)
+    if (id.includes(',')) {
+        return { valid: false, error: 'Repository ID cannot contain commas' };
+    }
+    // Check for spaces
+    if (id.includes(' ')) {
+        return { valid: false, error: 'Repository ID cannot contain spaces' };
+    }
+    // Check for uppercase letters
+    if (id !== id.toLowerCase()) {
+        return { valid: false, error: 'Repository ID must be lowercase' };
+    }
+    // Check starts with letter
+    if (!/^[a-z]/.test(id)) {
+        return { valid: false, error: 'Repository ID must start with a letter' };
+    }
+    // Check alphanumeric + hyphens only
+    if (!/^[a-z][a-z0-9-]*$/.test(id)) {
+        return { valid: false, error: 'Repository ID must contain only lowercase letters, numbers, and hyphens (alphanumeric)' };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=repo-id-generator.js.map

package/dist/src/core/repo-structure/repo-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id-generator.js","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,aAAa,GAAG;IACpB,MAAM;IACN,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,MAAM;IACN,SAAS;CACD,CAAC;AAkBX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAErC,4CAA4C;IAC5C,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,CAAC,wBAAwB;QACjC,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,WAAwB;IACrE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,8BAA8B;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,IAAI,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,cAAc;IACd,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;IAClE,CAAC;IAED,eAAe;IACf,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,sDAAsD,EAAE,CAAC;IACzF,CAAC;IAED,mDAAmD;IACnD,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACxE,CAAC;IAED,mBAAmB;IACnB,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IACxE,CAAC;IAED,8BAA8B;IAC9B,IAAI,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;IACpE,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;IAC3E,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wFAAwF,EAAE,CAAC;IAC3H,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,108 @@
+/**
+ * Repository Structure Manager
+ *
+ * Handles various repository architectures for SpecWeave projects:
+ * - Single repository
+ * - Multi-repository (polyrepo/microservices)
+ * - Monorepo (single repo with multiple projects)
+ * - Parent repository approach (parent folder with .specweave + nested implementation repos)
+ *
+ * Provides capabilities to:
+ * - Create GitHub repositories via API
+ * - Initialize git repositories locally
+ * - Configure proper folder structure
+ * - Organize specs per project/team
+ * - Split tasks between repositories
+ */
+export type RepoArchitecture = 'single' | 'multi-repo' | 'monorepo' | 'parent';
+export interface RepoStructureConfig {
+    architecture: RepoArchitecture;
+    parentRepo?: {
+        name: string;
+        owner: string;
+        description: string;
+        visibility: 'private' | 'public';
+        createOnGitHub: boolean;
+    };
+    repositories: Array<{
+        id: string;
+        name: string;
+        owner: string;
+        description: string;
+        path: string;
+        visibility: 'private' | 'public';
+        createOnGitHub: boolean;
+        isNested: boolean;
+    }>;
+    monorepoProjects?: string[];
+}
+export declare class RepoStructureManager {
+    private projectPath;
+    private githubToken?;
+    private stateManager;
+    constructor(projectPath: string, githubToken?: string);
+    /**
+     * Prompt user for repository structure decisions
+     */
+    promptStructure(): Promise<RepoStructureConfig>;
+    /**
+     * Map ArchitectureChoice to internal RepoArchitecture
+     */
+    private mapArchitectureChoice;
+    /**
+     * Resume setup from saved state
+     */
+    private resumeSetup;
+    /**
+     * Configure single repository
+     */
+    private configureSingleRepo;
+    /**
+     * Configure multi-repository architecture
+     */
+    private configureMultiRepo;
+    /**
+     * Save setup state for Ctrl+C recovery
+     */
+    private saveSetupState;
+    /**
+     * Configure monorepo
+     */
+    private configureMonorepo;
+    /**
+     * Create repositories on GitHub via API
+     */
+    createGitHubRepositories(config: RepoStructureConfig): Promise<void>;
+    /**
+     * Generate .env file with GitHub configuration
+     */
+    private generateEnvFile;
+    /**
+     * Show setup completion summary
+     */
+    private showSetupSummary;
+    /**
+     * Create a single GitHub repository via API
+     */
+    private createGitHubRepo;
+    /**
+     * Check if a GitHub account is an organization
+     */
+    private isGitHubOrganization;
+    /**
+     * Initialize local git repositories
+     */
+    initializeLocalRepos(config: RepoStructureConfig): Promise<void>;
+    /**
+     * Create basic structure for a repository/project
+     */
+    private createBasicRepoStructure;
+    /**
+     * Create SpecWeave project structure (simplified - ONLY specs folders)
+     *
+     * NOTE: As of v0.X.X (increment 0026), we ONLY create specs/ folders.
+     * No modules/, team/, architecture/, legacy/ folders.
+     */
+    createSpecWeaveStructure(config: RepoStructureConfig): Promise<void>;
+}
+//# sourceMappingURL=repo-structure-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo-structure-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-structure-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuBH,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;IAwDrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,mBAAmB;IA2GjC;;OAEG;YACW,kBAAkB;IAkRhC;;OAEG;YACW,cAAc;IAQ5B;;OAEG;YACW,iBAAiB;IA4E/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;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFtE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;;;;OAKG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC3E"}