specweave 0.12.7 → 0.13.0

package/dist/src/core/project-manager.js

@@ -0,0 +1,524 @@
+/**
+ * ProjectManager - Multi-project support for SpecWeave
+ *
+ * Handles project context, path resolution, and project switching.
+ * Key principle: Single project = multi-project with 1 project (no special cases)
+ */
+import path from 'path';
+import fs from 'fs-extra';
+import { ConfigManager } from './config-manager';
+import { autoDetectProjectIdSync, formatProjectName } from '../utils/project-detection';
+export class ProjectManager {
+    constructor(projectRoot) {
+        this.cachedProject = null;
+        this.projectRoot = projectRoot;
+        this.configManager = new ConfigManager(projectRoot);
+    }
+    /**
+     * Get current active project
+     * Auto-detects project ID from git remote or sync config
+     *
+     * @returns ProjectContext
+     */
+    getActiveProject() {
+        // Return cached project if available
+        if (this.cachedProject) {
+            return this.cachedProject;
+        }
+        const config = this.configManager.load();
+        // Single project mode → return auto-detected project
+        if (!config.multiProject?.enabled) {
+            // Auto-detect project ID (git remote, sync config, or "default")
+            const projectId = autoDetectProjectIdSync(this.projectRoot, { silent: true });
+            this.cachedProject = {
+                id: projectId,
+                name: config.project?.name || formatProjectName(projectId),
+                description: config.project?.description || `${formatProjectName(projectId)} project`,
+                techStack: config.project?.techStack || [],
+                team: config.project?.team || 'Engineering Team'
+            };
+            return this.cachedProject;
+        }
+        // Multi-project mode → return active project
+        const activeProjectId = config.multiProject.activeProject;
+        if (!activeProjectId) {
+            throw new Error('Multi-project mode enabled but no active project set in config');
+        }
+        const project = config.multiProject.projects.find((p) => p.id === activeProjectId);
+        if (!project) {
+            throw new Error(`Active project '${activeProjectId}' not found in config. Available projects: ${config.multiProject.projects.map((p) => p.id).join(', ')}`);
+        }
+        this.cachedProject = project;
+        return project;
+    }
+    /**
+     * Get all projects
+     *
+     * @returns ProjectContext[]
+     */
+    getAllProjects() {
+        const config = this.configManager.load();
+        if (!config.multiProject?.enabled) {
+            // Auto-detect project ID for single project mode
+            const projectId = autoDetectProjectIdSync(this.projectRoot, { silent: true });
+            return [{
+                    id: projectId,
+                    name: config.project?.name || formatProjectName(projectId),
+                    description: config.project?.description || `${formatProjectName(projectId)} project`,
+                    techStack: config.project?.techStack || [],
+                    team: config.project?.team || 'Engineering Team'
+                }];
+        }
+        return config.multiProject.projects;
+    }
+    /**
+     * Get project by ID
+     *
+     * @param projectId - Project identifier
+     * @returns ProjectContext or null
+     */
+    getProjectById(projectId) {
+        const projects = this.getAllProjects();
+        return projects.find(p => p.id === projectId) || null;
+    }
+    /**
+     * Get base path for active project
+     * Example: .specweave/docs/internal/projects/default/
+     *
+     * @returns string
+     */
+    getProjectBasePath(projectId) {
+        const project = projectId ? this.getProjectById(projectId) : this.getActiveProject();
+        if (!project) {
+            throw new Error(`Project '${projectId}' not found`);
+        }
+        return path.join(this.projectRoot, '.specweave/docs/internal/projects', project.id);
+    }
+    /**
+     * Get specs path for active project
+     * Example: .specweave/docs/internal/projects/default/specs/
+     *
+     * @returns string
+     */
+    getSpecsPath(projectId) {
+        return path.join(this.getProjectBasePath(projectId), 'specs');
+    }
+    /**
+     * Get modules path for active project
+     * Example: .specweave/docs/internal/projects/default/modules/
+     *
+     * @returns string
+     */
+    getModulesPath(projectId) {
+        return path.join(this.getProjectBasePath(projectId), 'modules');
+    }
+    /**
+     * Get team docs path for active project
+     * Example: .specweave/docs/internal/projects/default/team/
+     *
+     * @returns string
+     */
+    getTeamPath(projectId) {
+        return path.join(this.getProjectBasePath(projectId), 'team');
+    }
+    /**
+     * Get architecture path for active project
+     * Example: .specweave/docs/internal/projects/default/architecture/
+     *
+     * @returns string
+     */
+    getArchitecturePath(projectId) {
+        return path.join(this.getProjectBasePath(projectId), 'architecture');
+    }
+    /**
+     * Get legacy docs path for active project
+     * Example: .specweave/docs/internal/projects/default/legacy/
+     * Or with source: .specweave/docs/internal/projects/default/legacy/notion/
+     *
+     * @param source - Optional source type (notion, confluence, wiki, custom)
+     * @returns string
+     */
+    getLegacyPath(source, projectId) {
+        const basePath = path.join(this.getProjectBasePath(projectId), 'legacy');
+        return source ? path.join(basePath, source) : basePath;
+    }
+    /**
+     * Switch active project
+     *
+     * @param projectId - Project identifier
+     */
+    async switchProject(projectId) {
+        const config = this.configManager.load();
+        if (!config.multiProject?.enabled) {
+            throw new Error('Multi-project mode not enabled. Run /specweave:init-multiproject first.');
+        }
+        const project = config.multiProject.projects.find((p) => p.id === projectId);
+        if (!project) {
+            const availableProjects = config.multiProject.projects.map((p) => p.id).join(', ');
+            throw new Error(`Project '${projectId}' not found. Available projects: ${availableProjects}`);
+        }
+        // Update config
+        config.multiProject.activeProject = projectId;
+        await this.configManager.save(config);
+        // Clear cache
+        this.cachedProject = null;
+        console.log(`✅ Switched to project: ${project.name} (${projectId})`);
+    }
+    /**
+     * Create project structure with all folders
+     *
+     * @param projectId - Project identifier
+     */
+    async createProjectStructure(projectId) {
+        const basePath = this.getProjectBasePath(projectId);
+        // Create folders
+        await fs.ensureDir(path.join(basePath, 'specs'));
+        await fs.ensureDir(path.join(basePath, 'modules'));
+        await fs.ensureDir(path.join(basePath, 'team'));
+        await fs.ensureDir(path.join(basePath, 'architecture/adr'));
+        await fs.ensureDir(path.join(basePath, 'legacy'));
+        // Create README files
+        const project = this.getProjectById(projectId);
+        if (project) {
+            await this.createProjectREADME(project, basePath);
+            await this.createModulesREADME(basePath);
+            await this.createTeamREADME(basePath);
+            await this.createArchitectureREADME(basePath);
+            await this.createLegacyREADME(basePath);
+        }
+        console.log(`📁 Created project structure: ${basePath}`);
+    }
+    /**
+     * Add new project to config
+     *
+     * @param project - Project context
+     */
+    async addProject(project) {
+        const config = this.configManager.load();
+        // Initialize multiProject if not present
+        if (!config.multiProject) {
+            config.multiProject = {
+                enabled: false,
+                activeProject: 'default',
+                projects: []
+            };
+        }
+        // Check for duplicate ID
+        const existingProject = config.multiProject.projects.find((p) => p.id === project.id);
+        if (existingProject) {
+            throw new Error(`Project with ID '${project.id}' already exists`);
+        }
+        // Validate project ID (kebab-case)
+        const kebabCaseRegex = /^[a-z0-9-]+$/;
+        if (!kebabCaseRegex.test(project.id)) {
+            throw new Error(`Project ID '${project.id}' is invalid. Must be kebab-case (lowercase, hyphens only)`);
+        }
+        // Add project
+        config.multiProject.projects.push(project);
+        await this.configManager.save(config);
+        // Create structure
+        await this.createProjectStructure(project.id);
+        console.log(`✅ Added project: ${project.name} (${project.id})`);
+    }
+    /**
+     * Remove project from config
+     *
+     * @param projectId - Project identifier
+     */
+    async removeProject(projectId) {
+        const config = this.configManager.load();
+        if (!config.multiProject?.enabled) {
+            throw new Error('Multi-project mode not enabled');
+        }
+        if (projectId === 'default') {
+            throw new Error('Cannot remove default project');
+        }
+        if (config.multiProject.activeProject === projectId) {
+            throw new Error('Cannot remove active project. Switch to another project first.');
+        }
+        const projectIndex = config.multiProject.projects.findIndex((p) => p.id === projectId);
+        if (projectIndex === -1) {
+            throw new Error(`Project '${projectId}' not found`);
+        }
+        // Remove from config
+        config.multiProject.projects.splice(projectIndex, 1);
+        await this.configManager.save(config);
+        console.log(`✅ Removed project: ${projectId}`);
+        console.log('⚠️  Project files not deleted. Remove manually if needed.');
+    }
+    /**
+     * Clear cached project (force reload)
+     */
+    clearCache() {
+        this.cachedProject = null;
+    }
+    // README creation methods
+    async createProjectREADME(project, basePath) {
+        const content = `# ${project.name}
+
+${project.description}
+
+## Project Information
+
+- **Team**: ${project.team}
+- **Tech Stack**: ${project.techStack.length > 0 ? project.techStack.join(', ') : 'Not specified'}
+${project.contacts?.lead ? `- **Tech Lead**: ${project.contacts.lead}` : ''}
+${project.contacts?.pm ? `- **Product Manager**: ${project.contacts.pm}` : ''}
+
+## Folder Structure
+
+- \`specs/\` - Living documentation specs (spec-001, spec-002, ...)
+- \`modules/\` - Module-level documentation (auth, payments, etc.)
+- \`team/\` - Team playbooks (onboarding, conventions, workflows)
+- \`architecture/\` - Project-specific architecture (optional)
+- \`legacy/\` - Brownfield imported documentation
+
+## Documentation
+
+### Specs
+Living documentation for features and requirements. Each spec follows the format:
+- \`spec-NNN-feature-name.md\`
+
+### Modules
+Module-level documentation for components, services, and domains. Examples:
+- \`auth-module.md\` - Authentication domain
+- \`payment-module.md\` - Payment processing
+- \`ml-pipeline-module.md\` - Machine learning pipeline
+
+### Team Playbooks
+Team-specific conventions, workflows, and processes:
+- \`onboarding.md\` - How to join this team
+- \`conventions.md\` - Coding conventions, naming standards
+- \`workflows.md\` - PR process, deployment, incident handling
+
+## External Sync
+
+${project.syncProfiles && project.syncProfiles.length > 0 ?
+            `This project syncs with external tools:
+${project.syncProfiles.map(profile => `- ${profile}`).join('\n')}` :
+            'No external sync profiles configured yet.'}
+
+---
+
+**Created**: ${new Date().toISOString().split('T')[0]}
+**Last Updated**: ${new Date().toISOString().split('T')[0]}
+`;
+        await fs.writeFile(path.join(basePath, 'README.md'), content);
+    }
+    async createModulesREADME(basePath) {
+        const content = `# Module Documentation
+
+Module-level documentation for components, services, and domains.
+
+## What Goes Here
+
+- **Module architecture** - How the module is structured
+- **Key components** - Main classes, services, controllers
+- **Integration points** - How it connects to other modules
+- **Security considerations** - Auth, permissions, data handling
+- **Performance notes** - Caching, optimization, scalability
+
+## Module Examples
+
+### Example: \`auth-module.md\`
+
+\`\`\`markdown
+# Authentication Module
+
+## Overview
+Handles user authentication, session management, OAuth2 integration.
+
+## Architecture
+- AuthService.ts - Core authentication logic
+- SessionManager.ts - Session persistence
+- OAuth2Provider.ts - OAuth2 integration
+
+## Integration Points
+- Uses Redis for session storage
+- Integrates with user-service for profile data
+- Publishes auth events to message bus
+
+## Security Considerations
+- All passwords hashed with bcrypt (cost: 12)
+- JWT tokens expire after 15 minutes
+- Refresh tokens expire after 7 days
+\`\`\`
+
+## When to Create Module Docs
+
+- **Large codebase** with distinct modules (auth, payments, notifications)
+- **Domain-specific knowledge** (payment processing, ML pipeline)
+- **Design system components** (button, modal, form)
+- **Microservices** with complex interactions
+
+## Module vs Architecture Docs
+
+| Aspect | Module Docs | Architecture Docs |
+|--------|-------------|-------------------|
+| **Scope** | Component-level | System-level |
+| **Location** | \`projects/{id}/modules/\` | \`architecture/\` (shared) or \`projects/{id}/architecture/\` (project-specific) |
+| **Audience** | Developers working on module | All technical stakeholders |
+| **Examples** | auth-module.md, payment-module.md | HLD, ADR, system diagrams |
+
+---
+
+**See**: [../README.md](../README.md) for project overview
+`;
+        await fs.writeFile(path.join(basePath, 'modules', 'README.md'), content);
+    }
+    async createTeamREADME(basePath) {
+        const content = `# Team Playbook
+
+Team-specific conventions, workflows, and processes.
+
+## What Goes Here
+
+- **Onboarding** - How to join this team
+- **Conventions** - Coding conventions, naming standards
+- **Workflows** - PR process, deployment, incident handling
+- **Contacts** - Team members, on-call rotation
+
+## Typical Team Docs
+
+### 1. \`onboarding.md\`
+- Development environment setup
+- Required accounts and permissions
+- Codebase walkthrough
+- First tasks for new team members
+
+### 2. \`conventions.md\`
+- Naming conventions (files, functions, variables)
+- Code patterns and best practices
+- Tech stack preferences
+- Testing approach
+
+### 3. \`workflows.md\`
+- Git workflow and branching strategy
+- PR review process
+- Deployment procedures
+- Incident response
+
+### 4. \`contacts.md\`
+- Team members and roles
+- On-call rotation
+- Escalation paths
+
+## Example: \`conventions.md\`
+
+\`\`\`markdown
+# Team Conventions
+
+## Naming Conventions
+- React components: PascalCase (UserProfile.tsx)
+- Hooks: camelCase with "use" prefix (useAuth.ts)
+- Test files: *.test.ts (not *.spec.ts)
+
+## Code Patterns
+- Always use TypeScript strict mode
+- Prefer functional components over class components
+- Use React Query for API calls (not Redux)
+
+## Tech Stack
+- Frontend: React 18, TypeScript, Tailwind CSS
+- Backend: Node.js, Express, PostgreSQL
+- Testing: Vitest, Playwright
+\`\`\`
+
+---
+
+**See**: [../README.md](../README.md) for project overview
+`;
+        await fs.writeFile(path.join(basePath, 'team', 'README.md'), content);
+    }
+    async createArchitectureREADME(basePath) {
+        const content = `# Project-Specific Architecture
+
+Project-specific architecture documentation and ADRs.
+
+## When to Use This vs Shared Architecture
+
+### Project-Specific Architecture (\`projects/{id}/architecture/\`)
+- Decisions specific to this project/team
+- Component-level design
+- Project-specific ADRs
+
+### Shared Architecture (\`.specweave/docs/internal/architecture/\`)
+- System-wide architecture
+- Cross-cutting concerns
+- Shared ADRs affecting all projects
+
+## ADR Naming Convention
+
+\`NNNN-decision-title.md\`
+
+Example: \`0001-use-postgres-for-user-data.md\`
+
+## ADR Template
+
+\`\`\`markdown
+# ADR-NNNN: Decision Title
+
+**Status**: Accepted | Proposed | Deprecated
+**Date**: YYYY-MM-DD
+**Deciders**: Who made this decision
+
+## Context
+What is the issue we're addressing?
+
+## Decision
+What decision did we make?
+
+## Consequences
+What are the trade-offs?
+- ✅ Positive consequences
+- ❌ Negative consequences
+
+## Alternatives Considered
+What other options did we evaluate?
+\`\`\`
+
+---
+
+**See**: [../README.md](../README.md) for project overview
+`;
+        await fs.writeFile(path.join(basePath, 'architecture', 'README.md'), content);
+    }
+    async createLegacyREADME(basePath) {
+        const content = `# Legacy Documentation
+
+Brownfield documentation imported from external sources.
+
+## Purpose
+
+This folder contains documentation imported from:
+- Notion exports
+- Confluence exports
+- GitHub Wiki
+- Other markdown sources
+
+## Organization
+
+- \`notion/\` - Imported from Notion workspace
+- \`confluence/\` - Imported from Confluence space
+- \`wiki/\` - Imported from GitHub Wiki or other wikis
+- \`custom/\` - Other imported documentation
+
+## Migration Strategy
+
+1. **Review imported files** for accuracy
+2. **Manually move misclassified files** if needed
+3. **Update spec numbers** to follow SpecWeave conventions
+4. **Delete this folder** when migration is complete
+
+## Import History
+
+See \`.specweave/config.json\` → \`brownfield.importHistory\` for import details.
+
+---
+
+**See**: [../README.md](../README.md) for project overview
+`;
+        await fs.writeFile(path.join(basePath, 'legacy', 'README.md'), content);
+    }
+}
+//# sourceMappingURL=project-manager.js.map

package/dist/src/core/project-manager.js.map

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

package/dist/src/core/project-structure-detector.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Project Structure Detector
+ *
+ * Automatically detects project management structure from:
+ * - Existing increments and work items
+ * - Source system metadata (Jira, ADO, GitHub)
+ * - Environment variables
+ *
+ * Supports various hierarchies:
+ * - Jira: Epic → Story → Sub-task
+ * - ADO: Epic → Feature → User Story → Task
+ * - GitHub: Milestone → Issue (or flat Issues)
+ * - Custom: Detected from patterns
+ */
+/**
+ * Hierarchy levels:
+ * - FLAT: No hierarchy (GitHub issues, flat ADO)
+ * - SINGLE_PARENT: Milestone/Feature → Items
+ * - TWO_LEVEL: Epic → Stories → Tasks
+ * - THREE_LEVEL: Initiative → Epic → Feature → Stories
+ */
+export type HierarchyLevel = 'flat' | 'single_parent' | 'two_level' | 'three_level';
+/**
+ * Work item types vary by system
+ */
+export interface WorkItemTypes {
+    topLevel?: string;
+    parentLevel?: string;
+    itemLevel: string;
+    subItemLevel?: string;
+}
+/**
+ * Grouping strategy for RFC organization
+ */
+export type GroupingStrategy = 'by_type' | 'by_parent' | 'by_priority' | 'by_label' | 'flat' | 'custom';
+/**
+ * Project structure configuration
+ */
+export interface ProjectStructure {
+    source: 'jira' | 'ado' | 'github' | 'manual';
+    hierarchyLevel: HierarchyLevel;
+    workItemTypes: WorkItemTypes;
+    groupingStrategy: GroupingStrategy;
+    customGrouping?: (items: any[]) => Record<string, any[]>;
+    epicFieldName?: string;
+    featureFieldName?: string;
+    milestoneFieldName?: string;
+}
+/**
+ * Detected structure from analysis
+ */
+export interface DetectedStructure {
+    structure: ProjectStructure;
+    confidence: number;
+    evidence: string[];
+    sampleIncrements: string[];
+}
+export declare class ProjectStructureDetector {
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Detect project structure with pure auto-detection
+     */
+    detectStructure(): Promise<ProjectStructure>;
+    /**
+     * Auto-detect structure from existing increments
+     */
+    private autoDetectStructure;
+    /**
+     * Analyze increments to detect structure
+     */
+    private analyzeIncrements;
+    /**
+     * Infer work item types from source and hierarchy
+     */
+    private inferWorkItemTypes;
+    /**
+     * Infer grouping strategy from source and hierarchy
+     */
+    private inferGroupingStrategy;
+    /**
+     * Get default structure when no increments exist
+     */
+    private getDefaultStructure;
+    /**
+     * Get structure summary for display
+     */
+    getStructureSummary(structure: ProjectStructure): string;
+    private getHierarchyDescription;
+    private getGroupingDescription;
+}
+//# sourceMappingURL=project-structure-detector.d.ts.map

package/dist/src/core/project-structure-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-structure-detector.d.ts","sourceRoot":"","sources":["../../../src/core/project-structure-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,aAAa,GACb,UAAU,GACV,MAAM,GACN,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAGzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAI/C;;OAEG;IACU,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAMzD;;OAEG;YACW,mBAAmB;IA2BjC;;OAEG;YACW,iBAAiB;IA2G/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwD3B;;OAEG;IACI,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM;IAO/D,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,sBAAsB;CAY/B"}