specweave 0.13.5 → 0.14.0

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

@@ -1,524 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,92 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}