specweave 0.23.7 → 0.23.10

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.7",
+  "version": "0.23.10",
   "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/commands/migrate-config.md

@@ -0,0 +1,104 @@
+---
+name: specweave:migrate-config
+description: Migrate .env-only configuration to split secrets/config format (v0.24.0+)
+---
+
+Migrate your project from the old .env-only format to the new split format where secrets stay in `.env` (gitignored) and configuration moves to `.specweave/config.json` (committed to git).
+
+**What this command does:**
+
+1. ✅ Analyzes your `.env` file
+2. ✅ Classifies variables as "secrets" or "config"
+3. ✅ Backs up original `.env` file
+4. ✅ Updates `.env` (keeps only secrets)
+5. ✅ Creates/updates `.specweave/config.json` (adds config)
+6. ✅ Generates `.env.example` for team onboarding
+
+**When to use:**
+
+- You're upgrading from SpecWeave v0.23.x or earlier
+- Your `.env` contains both secrets AND configuration (domain, strategy, etc.)
+- You want to share configuration with your team via git
+
+**Command:**
+
+```bash
+node -e "require('./dist/src/cli/commands/migrate-config.js').migrateConfig()"
+```
+
+**Options:**
+
+- `--dry-run`: Preview migration without making changes
+- `--yes`: Skip confirmation prompt
+- `--force`: Force migration even if not needed
+
+**Example output:**
+
+```
+🔄 SpecWeave Configuration Migration
+
+📋 Migration Preview
+
+Classification Results:
+  Secrets: 3 variables
+  Config:  5 variables
+
+📊 Detailed Breakdown:
+
+  Secrets (will stay in .env):
+    JIRA_API_TOKEN=xyzabc***456
+    └─ Contains keyword: token
+
+    JIRA_EMAIL=user@example.com
+    └─ Email address (used for authentication)
+
+  Configuration (will move to config.json):
+    JIRA_DOMAIN=company.atlassian.net
+    └─ Non-sensitive configuration data
+
+    JIRA_STRATEGY=project-per-team
+    └─ Non-sensitive configuration data
+
+✅ Migration Successful!
+
+Summary:
+  ✓ 3 secrets kept in .env
+  ✓ 5 config items moved to config.json
+  ✓ Backup created: .env.backup.1234567890
+  ✓ .env.example generated
+
+📝 Next Steps:
+
+  1. Review .specweave/config.json (commit to git)
+  2. Share .env.example with team (commit to git)
+  3. Team members: cp .env.example .env (fill in tokens)
+```
+
+**Benefits:**
+
+- ✅ Team shares configuration via git
+- ✅ Secrets stay local (never committed)
+- ✅ Type-safe configuration with validation
+- ✅ Easy onboarding for new team members
+
+**Classification logic:**
+
+Variables classified as **secrets** (stay in .env):
+- Contains keywords: `token`, `api_token`, `pat`, `secret`, `key`, `password`, `credential`, `auth`
+- Email addresses (used for authentication)
+
+Variables classified as **config** (move to config.json):
+- Everything else: domains, strategies, project keys, organizations, etc.
+
+**Safety:**
+
+- 🔒 Always creates backup before modifying `.env`
+- 🔒 Atomic operation (either completes fully or rolls back)
+- 🔒 Idempotent (can run multiple times safely)
+- 🔒 Dry-run mode available for preview
+
+**See also:**
+
+- ADR-0050: Secrets vs Configuration Separation
+- `/specweave:validate` - Validate configuration after migration
+- Documentation: `CLAUDE.md` → Configuration Management section

package/plugins/specweave/hooks/post-task-completion.sh

@@ -178,7 +178,7 @@ fi
 
 if command -v node &> /dev/null; then
   # Detect current increment (latest non-backlog increment)
-  CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
+  CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
 
   if [ -n "$CURRENT_INCREMENT" ] && [ -f ".specweave/increments/$CURRENT_INCREMENT/tasks.md" ]; then
     echo "[$(date)] 📝 Updating tasks.md for $CURRENT_INCREMENT" >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave/hooks/pre-task-completion.sh

@@ -92,7 +92,7 @@ fi
 # DETECT CURRENT INCREMENT
 # ============================================================================
 
-CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | head -1)
+CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
 
 if [ -z "$CURRENT_INCREMENT" ]; then
   echo "[$(date)] ⚠️  No active increment found, skipping validation" >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave-ado/hooks/post-task-completion.sh

@@ -56,7 +56,7 @@ mkdir -p "$LOGS_DIR" 2>/dev/null || true
 echo "[$(date)] [ADO] 🔗 Azure DevOps sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
 
 # Detect current increment
-CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
+CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
 
 if [ -z "$CURRENT_INCREMENT" ]; then
   echo "[$(date)] [ADO] ℹ️  No active increment, skipping ADO sync" >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave-github/hooks/post-task-completion.sh

@@ -102,7 +102,7 @@ fi
 # Strategy: Use multi-spec detector to find ALL specs referenced in current increment
 
 # 1. Detect current increment (temporary context)
-CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
+CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
 
 if [ -z "$CURRENT_INCREMENT" ]; then
   echo "[$(date)] [GitHub] ℹ️  No active increment, checking for spec changes..." >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave-jira/hooks/post-task-completion.sh

@@ -56,7 +56,7 @@ mkdir -p "$LOGS_DIR" 2>/dev/null || true
 echo "[$(date)] [JIRA] 🔗 JIRA sync hook fired" >> "$DEBUG_LOG" 2>/dev/null || true
 
 # Detect current increment
-CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | head -1)
+CURRENT_INCREMENT=$(ls -t .specweave/increments/ 2>/dev/null | grep -v "_backlog" | grep -v "_archive" | grep -v "_working" | head -1)
 
 if [ -z "$CURRENT_INCREMENT" ]; then
   echo "[$(date)] [JIRA] ℹ️  No active increment, skipping JIRA sync" >> "$DEBUG_LOG" 2>/dev/null || true

package/plugins/specweave-release/hooks/.specweave/logs/dora-tracking.log

@@ -6331,3 +6331,135 @@
 [2025-11-20 19:32:53] 🎯 Post-Increment-Completion Hook Triggered
 [2025-11-20 19:32:53] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
 [2025-11-20 19:32:53]    Run: npm run build
+[2025-11-21 01:14:49] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:14:49] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:14:49]    Run: npm run build
+[2025-11-21 01:14:54] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:14:54] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:14:54]    Run: npm run build
+[2025-11-21 01:15:00] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:00] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:00]    Run: npm run build
+[2025-11-21 01:15:05] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:05] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:05]    Run: npm run build
+[2025-11-21 01:15:29] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:29] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:29]    Run: npm run build
+[2025-11-21 01:15:35] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:35] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:35]    Run: npm run build
+[2025-11-21 01:15:40] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:40] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:40]    Run: npm run build
+[2025-11-21 01:15:45] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:15:45] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:15:45]    Run: npm run build
+[2025-11-21 01:16:09] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:09] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:09]    Run: npm run build
+[2025-11-21 01:16:14] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:14] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:14]    Run: npm run build
+[2025-11-21 01:16:19] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:19] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:19]    Run: npm run build
+[2025-11-21 01:16:24] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:24] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:24]    Run: npm run build
+[2025-11-21 01:16:39] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:39] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:39]    Run: npm run build
+[2025-11-21 01:16:44] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:44] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:44]    Run: npm run build
+[2025-11-21 01:16:49] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:49] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:49]    Run: npm run build
+[2025-11-21 01:16:54] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:16:54] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:16:54]    Run: npm run build
+[2025-11-21 01:25:42] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:25:42] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:25:42]    Run: npm run build
+[2025-11-21 01:25:47] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:25:47] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:25:47]    Run: npm run build
+[2025-11-21 01:25:53] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:25:53] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:25:53]    Run: npm run build
+[2025-11-21 01:25:58] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:25:58] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:25:58]    Run: npm run build
+[2025-11-21 01:29:50] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:29:50] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:29:50]    Run: npm run build
+[2025-11-21 01:29:55] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:29:55] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:29:55]    Run: npm run build
+[2025-11-21 01:30:00] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:30:00] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:30:00]    Run: npm run build
+[2025-11-21 01:30:05] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:30:05] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:30:05]    Run: npm run build
+[2025-11-21 01:31:11] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:11] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:11]    Run: npm run build
+[2025-11-21 01:31:16] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:16] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:16]    Run: npm run build
+[2025-11-21 01:31:21] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:21] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:21]    Run: npm run build
+[2025-11-21 01:31:26] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:26] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:26]    Run: npm run build
+[2025-11-21 01:31:43] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:43] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:43]    Run: npm run build
+[2025-11-21 01:31:48] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:48] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:48]    Run: npm run build
+[2025-11-21 01:31:53] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:53] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:53]    Run: npm run build
+[2025-11-21 01:31:59] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:31:59] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:31:59]    Run: npm run build
+[2025-11-21 01:32:37] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:32:37] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:32:37]    Run: npm run build
+[2025-11-21 01:32:42] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:32:42] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:32:42]    Run: npm run build
+[2025-11-21 01:32:47] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:32:47] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:32:47]    Run: npm run build
+[2025-11-21 01:32:52] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:32:52] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:32:52]    Run: npm run build
+[2025-11-21 01:33:36] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:33:36] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:33:36]    Run: npm run build
+[2025-11-21 01:33:41] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:33:41] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:33:41]    Run: npm run build
+[2025-11-21 01:33:46] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:33:46] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:33:46]    Run: npm run build
+[2025-11-21 01:33:51] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:33:51] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:33:51]    Run: npm run build
+[2025-11-21 01:35:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:35:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:35:06]    Run: npm run build
+[2025-11-21 01:35:11] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:35:11] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:35:11]    Run: npm run build
+[2025-11-21 01:35:16] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:35:16] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:35:16]    Run: npm run build
+[2025-11-21 01:35:21] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-21 01:35:21] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-21 01:35:21]    Run: npm run build