specweave 0.23.8 → 0.23.12

package/dist/src/integrations/jira/jira-dependency-loader.js

@@ -0,0 +1,200 @@
+/**
+ * JiraDependencyLoader - Three-Tier Dependency Loading for JIRA
+ *
+ * Architecture (ADR-0056):
+ * - Tier 1 (Init): Metadata only (< 5 seconds, 1 API call)
+ * - Tier 2 (On-Demand): Lazy loading per project (2-5 seconds, 4-7 API calls)
+ * - Tier 3 (Bulk): Optional pre-load command (1-2 minutes for 50 projects)
+ *
+ * Features:
+ * - 24-hour TTL caching via CacheManager
+ * - Rate limit detection and stale cache fallback
+ * - Per-project dependency caching
+ * - Automatic cache invalidation on 404 errors
+ *
+ * @module integrations/jira/jira-dependency-loader
+ */
+import { RateLimitChecker } from '../../core/cache/rate-limit-checker.js';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * JiraDependencyLoader - Three-tier dependency loading with smart caching
+ */
+export class JiraDependencyLoader {
+    constructor(options) {
+        this.jiraClient = options.jiraClient;
+        this.cacheManager = options.cacheManager;
+        this.rateLimitChecker = options.rateLimitChecker ?? new RateLimitChecker();
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Tier 1: Load project metadata only (init)
+     *
+     * Performance: < 5 seconds for 50 projects (1 API call)
+     * Cache: 24-hour TTL in `jira-projects.json`
+     *
+     * @param maxProjects Maximum projects to load (default: 50)
+     * @returns Array of project metadata
+     */
+    async loadProjectMetadata(maxProjects = 50) {
+        const cacheKey = 'jira-projects';
+        // Check cache first
+        const cached = await this.cacheManager.get(cacheKey);
+        if (cached) {
+            this.logger.log(`Cache hit: ${cacheKey} (${cached.projects.length} projects)`);
+            return cached.projects;
+        }
+        // Cache miss - fetch from API
+        this.logger.log(`Cache miss: ${cacheKey}, fetching from JIRA API...`);
+        try {
+            // Use JIRA search API for batch loading
+            const response = await this.jiraClient.searchProjects({
+                maxResults: maxProjects,
+                orderBy: 'name',
+            });
+            // Extract rate limit headers
+            const rateLimitHeaders = this.rateLimitChecker.extractHeaders(response);
+            const rateLimitCheck = this.rateLimitChecker.shouldProceed(rateLimitHeaders);
+            if (!rateLimitCheck.canProceed) {
+                this.logger.warn(`Rate limit warning: ${rateLimitCheck.reason}. Consider using cached data.`);
+            }
+            // Parse projects
+            const projects = response.values.map((project) => ({
+                key: project.key,
+                name: project.name,
+                type: project.projectTypeKey || 'software',
+                lead: project.lead
+                    ? {
+                        displayName: project.lead.displayName,
+                    }
+                    : undefined,
+            }));
+            // Cache result
+            await this.cacheManager.set(cacheKey, { projects });
+            this.logger.log(`Cached ${projects.length} projects with 24-hour TTL`);
+            return projects;
+        }
+        catch (error) {
+            // Check for rate limit error (429)
+            if (this.rateLimitChecker.isRateLimitError(error)) {
+                await this.rateLimitChecker.handleRateLimitError(error);
+                // Try to use stale cache
+                const staleCache = await this.cacheManager.getStale(cacheKey);
+                if (staleCache) {
+                    return staleCache.projects;
+                }
+            }
+            // Re-throw if not rate limit or no stale cache available
+            throw error;
+        }
+    }
+    /**
+     * Tier 2: Load dependencies for specific project (on-demand)
+     *
+     * Performance: 2-5 seconds per project (4-7 API calls, cached)
+     * Cache: 24-hour TTL in `jira-{PROJECT}-deps.json`
+     *
+     * @param projectKey Project key (e.g., "BACKEND")
+     * @returns Project dependencies
+     */
+    async loadProjectDependencies(projectKey) {
+        const cacheKey = `jira-${projectKey}-deps`;
+        // Check cache first
+        const cached = await this.cacheManager.get(cacheKey);
+        if (cached) {
+            this.logger.log(`Cache hit: ${cacheKey}`);
+            return cached;
+        }
+        // Cache miss - fetch from API
+        this.logger.log(`Cache miss: ${cacheKey}, fetching from JIRA API...`);
+        try {
+            // Fetch boards, components, versions in parallel
+            const [boardsResponse, componentsResponse, versionsResponse] = await Promise.all([
+                this.jiraClient.getBoards(projectKey),
+                this.jiraClient.getComponents(projectKey),
+                this.jiraClient.getVersions(projectKey),
+            ]);
+            // Build dependencies object
+            const dependencies = {
+                projectKey,
+                boards: boardsResponse.values?.map((board) => ({
+                    id: board.id,
+                    name: board.name,
+                    type: board.type,
+                })) || [],
+                components: componentsResponse.map((component) => ({
+                    id: component.id,
+                    name: component.name,
+                })),
+                versions: versionsResponse.map((version) => ({
+                    id: version.id,
+                    name: version.name,
+                    released: version.released,
+                })),
+                lastUpdated: new Date().toISOString(),
+            };
+            // Cache result
+            await this.cacheManager.set(cacheKey, dependencies);
+            this.logger.log(`Cached dependencies for ${projectKey}: ${dependencies.boards.length} boards, ${dependencies.components.length} components, ${dependencies.versions.length} versions`);
+            return dependencies;
+        }
+        catch (error) {
+            // Handle 404 (project not found) - invalidate cache
+            if (error.response?.status === 404) {
+                this.logger.warn(`Project ${projectKey} not found (404), invalidating cache...`);
+                await this.cacheManager.delete(cacheKey);
+                throw new Error(`Project ${projectKey} not found`);
+            }
+            // Handle rate limit errors
+            if (this.rateLimitChecker.isRateLimitError(error)) {
+                await this.rateLimitChecker.handleRateLimitError(error);
+                // Try to use stale cache
+                const staleCache = await this.cacheManager.getStale(cacheKey);
+                if (staleCache) {
+                    return staleCache;
+                }
+            }
+            // Re-throw if not handled
+            throw error;
+        }
+    }
+    /**
+     * Tier 3: Bulk pre-load all dependencies (optional command)
+     *
+     * Performance: 1-2 minutes for 50 projects (200-350 API calls, batched)
+     * Progress: Real-time progress tracking, cancelation support
+     *
+     * @param projectKeys Array of project keys to preload
+     * @returns void (results cached)
+     */
+    async preloadAllDependencies(projectKeys, options = {}) {
+        const { onProgress, signal } = options;
+        const total = projectKeys.length;
+        this.logger.log(`Preloading dependencies for ${total} projects...`);
+        for (let i = 0; i < total; i++) {
+            // Check for cancelation
+            if (signal?.aborted) {
+                this.logger.warn('Preload canceled by user');
+                throw new Error('Preload canceled');
+            }
+            const projectKey = projectKeys[i];
+            this.logger.log(`[${i + 1}/${total}] Preloading ${projectKey}...`);
+            try {
+                await this.loadProjectDependencies(projectKey);
+                // Report progress
+                if (onProgress) {
+                    onProgress(i + 1, total);
+                }
+            }
+            catch (error) {
+                this.logger.error(`Failed to preload ${projectKey}: ${error.message}`);
+                // Continue with next project (don't fail entire batch)
+            }
+            // Add delay to avoid rate limiting (200ms between requests)
+            if (i < total - 1) {
+                await new Promise((resolve) => setTimeout(resolve, 200));
+            }
+        }
+        this.logger.log('Preload complete!');
+    }
+}
+//# sourceMappingURL=jira-dependency-loader.js.map

package/dist/src/integrations/jira/jira-dependency-loader.js.map

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

package/dist/src/integrations/jira/jira-hierarchy-mapper.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Jira Hierarchy Mapper
+ *
+ * Maps SpecWeave universal hierarchy to Jira issue types
+ *
+ * Supports:
+ * - Jira Agile: Initiative → Epic → Story → Sub-task
+ * - Jira CMMI: Epic → Feature → Requirement → Task
+ * - Jira SAFe: Strategic Theme → Capability → User Story → Task
+ *
+ * @module integrations/jira/jira-hierarchy-mapper
+ */
+import { JiraClient } from './jira-client.js';
+/**
+ * Jira hierarchy mapping for different project types
+ */
+export interface JiraHierarchyMapping {
+    epic: string;
+    feature: string;
+    userStory: string;
+    task: string;
+}
+/**
+ * SpecWeave Epic metadata
+ */
+export interface SpecWeaveEpic {
+    id: string;
+    title: string;
+    description: string;
+    status: string;
+    priority: string;
+}
+/**
+ * SpecWeave Feature metadata
+ */
+export interface SpecWeaveFeature {
+    id: string;
+    title: string;
+    description: string;
+    status: string;
+    priority: string;
+    epic?: string;
+}
+/**
+ * SpecWeave User Story metadata
+ */
+export interface SpecWeaveUserStory {
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: string[];
+    status: string;
+    priority: string;
+    feature?: string;
+}
+/**
+ * Maps SpecWeave universal hierarchy to Jira issue types
+ */
+export declare class JiraHierarchyMapper {
+    private jiraClient;
+    constructor(jiraClient: JiraClient);
+    /**
+     * Detect Jira project type based on available issue types
+     *
+     * @param projectKey - Jira project key
+     * @returns Detected hierarchy mapping
+     */
+    detectProjectType(projectKey: string): Promise<JiraHierarchyMapping>;
+    /**
+     * Map SpecWeave work item to Jira issue type
+     *
+     * @param level - SpecWeave hierarchy level
+     * @param mapping - Jira hierarchy mapping
+     * @returns Jira issue type name
+     */
+    mapToJiraIssueType(level: 'epic' | 'feature' | 'userStory' | 'task', mapping: JiraHierarchyMapping): string;
+    /**
+     * Create SpecWeave Epic in Jira
+     *
+     * @param epic - SpecWeave epic metadata
+     * @param projectKey - Jira project key
+     * @returns Created Jira issue key
+     */
+    syncEpicToJira(epic: SpecWeaveEpic, projectKey: string): Promise<string>;
+    /**
+     * Create SpecWeave Feature in Jira
+     *
+     * @param feature - SpecWeave feature metadata
+     * @param projectKey - Jira project key
+     * @param epicKey - Parent epic key (optional)
+     * @returns Created Jira issue key
+     */
+    syncFeatureToJira(feature: SpecWeaveFeature, projectKey: string, epicKey?: string): Promise<string>;
+    /**
+     * Create SpecWeave User Story in Jira
+     *
+     * @param userStory - SpecWeave user story metadata
+     * @param projectKey - Jira project key
+     * @param featureKey - Parent feature key (optional)
+     * @returns Created Jira issue key
+     */
+    syncUserStoryToJira(userStory: SpecWeaveUserStory, projectKey: string, featureKey?: string): Promise<string>;
+}
+//# sourceMappingURL=jira-hierarchy-mapper.d.ts.map

package/dist/src/integrations/jira/jira-hierarchy-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-hierarchy-mapper.d.ts","sourceRoot":"","sources":["../../../../src/integrations/jira/jira-hierarchy-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,EAAE,UAAU;IAIlC;;;;;OAKG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiE1E;;;;;;OAMG;IACH,kBAAkB,CAChB,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,EAChD,OAAO,EAAE,oBAAoB,GAC5B,MAAM;IAIT;;;;;;OAMG;IACG,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB9E;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAoBlB;;;;;;;OAOG;IACG,mBAAmB,CACvB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;CA4BnB"}

package/dist/src/integrations/jira/jira-hierarchy-mapper.js

@@ -0,0 +1,178 @@
+/**
+ * Jira Hierarchy Mapper
+ *
+ * Maps SpecWeave universal hierarchy to Jira issue types
+ *
+ * Supports:
+ * - Jira Agile: Initiative → Epic → Story → Sub-task
+ * - Jira CMMI: Epic → Feature → Requirement → Task
+ * - Jira SAFe: Strategic Theme → Capability → User Story → Task
+ *
+ * @module integrations/jira/jira-hierarchy-mapper
+ */
+import chalk from 'chalk';
+/**
+ * Maps SpecWeave universal hierarchy to Jira issue types
+ */
+export class JiraHierarchyMapper {
+    constructor(jiraClient) {
+        this.jiraClient = jiraClient;
+    }
+    /**
+     * Detect Jira project type based on available issue types
+     *
+     * @param projectKey - Jira project key
+     * @returns Detected hierarchy mapping
+     */
+    async detectProjectType(projectKey) {
+        try {
+            // Fetch issue types for project
+            // Note: This requires implementing getIssueTypes in JiraClient
+            // For now, we'll use a default Agile mapping
+            // TODO: Implement getIssueTypes in JiraClient
+            // Default: Agile (has "Story" and "Sub-task")
+            console.log(chalk.cyan(`📊 Using Jira Agile hierarchy for project: ${projectKey}`));
+            return {
+                epic: 'Initiative',
+                feature: 'Epic',
+                userStory: 'Story',
+                task: 'Sub-task'
+            };
+            /* Future implementation:
+            const issueTypes = await this.jiraClient.getIssueTypes(projectKey);
+            const typeNames = issueTypes.map(t => t.name.toLowerCase());
+      
+            // Detect SAFe (has "Capability" or "Strategic Theme")
+            if (typeNames.includes('capability') || typeNames.includes('strategic theme')) {
+              console.log(chalk.cyan(`📊 Detected Jira SAFe project: ${projectKey}`));
+              return {
+                epic: 'Strategic Theme',
+                feature: 'Capability',
+                userStory: 'User Story',
+                task: 'Task'
+              };
+            }
+      
+            // Detect CMMI (has "Requirement")
+            if (typeNames.includes('requirement')) {
+              console.log(chalk.cyan(`📊 Detected Jira CMMI project: ${projectKey}`));
+              return {
+                epic: 'Epic',
+                feature: 'Feature',
+                userStory: 'Requirement',
+                task: 'Task'
+              };
+            }
+      
+            // Default: Agile
+            console.log(chalk.cyan(`📊 Detected Jira Agile project: ${projectKey}`));
+            return {
+              epic: 'Initiative',
+              feature: 'Epic',
+              userStory: 'Story',
+              task: 'Sub-task'
+            };
+            */
+        }
+        catch (error) {
+            console.error(chalk.red(`⚠️  Failed to detect Jira project type: ${error.message}`));
+            console.log(chalk.gray('   Using default Agile hierarchy\n'));
+            // Fallback to Agile
+            return {
+                epic: 'Initiative',
+                feature: 'Epic',
+                userStory: 'Story',
+                task: 'Sub-task'
+            };
+        }
+    }
+    /**
+     * Map SpecWeave work item to Jira issue type
+     *
+     * @param level - SpecWeave hierarchy level
+     * @param mapping - Jira hierarchy mapping
+     * @returns Jira issue type name
+     */
+    mapToJiraIssueType(level, mapping) {
+        return mapping[level];
+    }
+    /**
+     * Create SpecWeave Epic in Jira
+     *
+     * @param epic - SpecWeave epic metadata
+     * @param projectKey - Jira project key
+     * @returns Created Jira issue key
+     */
+    async syncEpicToJira(epic, projectKey) {
+        const mapping = await this.detectProjectType(projectKey);
+        const jiraIssueType = this.mapToJiraIssueType('epic', mapping);
+        console.log(chalk.cyan(`📝 Creating ${jiraIssueType} in Jira: ${epic.title}`));
+        // Create Initiative/Theme/Epic in Jira
+        const issue = await this.jiraClient.createIssue({
+            issueType: jiraIssueType,
+            summary: epic.title,
+            description: epic.description,
+            priority: epic.priority,
+            labels: [`specweave-epic-${epic.id}`]
+        }, projectKey);
+        console.log(chalk.green(`✅ Created ${jiraIssueType}: ${issue.key}\n`));
+        return issue.key;
+    }
+    /**
+     * Create SpecWeave Feature in Jira
+     *
+     * @param feature - SpecWeave feature metadata
+     * @param projectKey - Jira project key
+     * @param epicKey - Parent epic key (optional)
+     * @returns Created Jira issue key
+     */
+    async syncFeatureToJira(feature, projectKey, epicKey) {
+        const mapping = await this.detectProjectType(projectKey);
+        const jiraIssueType = this.mapToJiraIssueType('feature', mapping);
+        console.log(chalk.cyan(`📝 Creating ${jiraIssueType} in Jira: ${feature.title}`));
+        // Create Epic/Capability/Feature in Jira
+        const issue = await this.jiraClient.createIssue({
+            issueType: jiraIssueType,
+            summary: feature.title,
+            description: feature.description,
+            priority: feature.priority,
+            labels: [`specweave-feature-${feature.id}`],
+            epicKey // Link to parent epic (if exists)
+        }, projectKey);
+        console.log(chalk.green(`✅ Created ${jiraIssueType}: ${issue.key}\n`));
+        return issue.key;
+    }
+    /**
+     * Create SpecWeave User Story in Jira
+     *
+     * @param userStory - SpecWeave user story metadata
+     * @param projectKey - Jira project key
+     * @param featureKey - Parent feature key (optional)
+     * @returns Created Jira issue key
+     */
+    async syncUserStoryToJira(userStory, projectKey, featureKey) {
+        const mapping = await this.detectProjectType(projectKey);
+        const jiraIssueType = this.mapToJiraIssueType('userStory', mapping);
+        console.log(chalk.cyan(`📝 Creating ${jiraIssueType} in Jira: ${userStory.title}`));
+        // Build description with acceptance criteria
+        let description = userStory.description;
+        if (userStory.acceptanceCriteria && userStory.acceptanceCriteria.length > 0) {
+            description += '\n\n**Acceptance Criteria:**\n';
+            userStory.acceptanceCriteria.forEach((ac, index) => {
+                description += `\n${index + 1}. ${ac}`;
+            });
+        }
+        // Create Story/User Story/Requirement in Jira
+        const issue = await this.jiraClient.createIssue({
+            issueType: jiraIssueType,
+            summary: userStory.title,
+            description,
+            priority: userStory.priority,
+            labels: [`specweave-us-${userStory.id}`],
+            epicKey: featureKey // Link to parent feature
+        }, projectKey);
+        console.log(chalk.green(`✅ Created ${jiraIssueType}: ${issue.key}\n`));
+        return issue.key;
+    }
+}
+//# sourceMappingURL=jira-hierarchy-mapper.js.map

package/dist/src/integrations/jira/jira-hierarchy-mapper.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.23.8",
+  "version": "0.23.12",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/.claude-plugin/plugin.json

@@ -30,6 +30,26 @@
             "timeout": 60
           }
         ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-edit-spec.sh",
+            "timeout": 2
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-write-spec.sh",
+            "timeout": 2
+          }
+        ]
       }
     ],
     "PostToolUse": [