specweave 0.29.2 → 0.30.0

package/dist/src/cli/helpers/issue-tracker/sync-config-writer.js

@@ -0,0 +1,306 @@
+/**
+ * Sync Config Writer
+ *
+ * Writes sync configuration to .specweave/config.json for different trackers.
+ * Extracted from issue-tracker/index.ts to reduce file size and improve maintainability.
+ *
+ * @module cli/helpers/issue-tracker/sync-config-writer
+ */
+import chalk from 'chalk';
+import { execSync } from 'child_process';
+import * as path from 'path';
+import { getConfigManager } from '../../../core/config/index.js';
+/**
+ * Write sync config to .specweave/config.json
+ *
+ * This is CRITICAL for hooks to fire! Without this, the post-task-completion hook
+ * won't sync to GitHub/Jira/ADO.
+ *
+ * @param projectPath - Path to project root
+ * @param tracker - Issue tracker type (github, jira, ado)
+ * @param credentials - Tracker credentials
+ * @param syncSettings - Sync settings (status sync, auto-labels)
+ * @param syncPermissions - Permission flags for sync operations
+ * @param repositoryProfiles - Optional multi-repo profiles (GitHub only)
+ * @param monorepoProjects - Optional monorepo projects (GitHub only)
+ */
+export async function writeSyncConfig(projectPath, tracker, credentials, syncSettings, syncPermissions, repositoryProfiles, monorepoProjects) {
+    const configManager = getConfigManager(projectPath);
+    // Read existing config
+    const config = await configManager.read();
+    // Add hooks configuration (enables auto-sync!)
+    config.hooks = {
+        post_task_completion: {
+            sync_living_docs: true,
+            sync_tasks_md: true,
+            external_tracker_sync: true
+        },
+        post_increment_planning: {
+            auto_create_github_issue: tracker === 'github' // Only for GitHub
+        }
+    };
+    // Build profiles and config based on tracker type
+    const profiles = {};
+    switch (tracker) {
+        case 'github':
+            await buildGitHubSyncConfig(config, profiles, projectPath, credentials, syncSettings, syncPermissions, repositoryProfiles, monorepoProjects);
+            break;
+        case 'jira':
+            buildJiraSyncConfig(config, profiles, credentials, syncSettings, syncPermissions);
+            break;
+        case 'ado':
+            buildAdoSyncConfig(config, profiles, credentials, syncSettings, syncPermissions);
+            break;
+    }
+    // Write config using ConfigManager
+    await configManager.write(config);
+    console.log(chalk.green(`✓ Sync config written to .specweave/config.json`));
+    console.log(chalk.gray(`   Provider: ${tracker}`));
+    console.log(chalk.gray(`   Auto-sync: enabled`));
+    console.log(chalk.gray(`   Status sync: ${syncSettings.includeStatus ? 'enabled' : 'disabled'}`));
+    console.log(chalk.gray(`   Auto-labeling: ${syncSettings.autoApplyLabels ? 'enabled' : 'disabled'}`));
+    console.log(chalk.gray(`   Hooks: post_task_completion, post_increment_planning`));
+}
+/**
+ * Build GitHub sync configuration
+ */
+async function buildGitHubSyncConfig(config, profiles, projectPath, credentials, syncSettings, syncPermissions, repositoryProfiles, monorepoProjects) {
+    let owner = '';
+    let repo = '';
+    // Try to detect from git remote
+    try {
+        const remote = execSync('git remote get-url origin', {
+            cwd: projectPath,
+            encoding: 'utf-8',
+            stdio: 'pipe'
+        }).trim();
+        // Parse owner/repo from: https://github.com/owner/repo.git or git@github.com:owner/repo.git
+        const match = remote.match(/github\.com[:/]([^/]+)\/(.+?)(\.git)?$/);
+        if (match) {
+            owner = match[1];
+            repo = match[2];
+        }
+    }
+    catch {
+        // Fallback to current directory name
+        repo = path.basename(projectPath);
+        owner = 'YOUR_GITHUB_USERNAME'; // User must update manually
+    }
+    // Handle multiple repository profiles
+    if (repositoryProfiles && repositoryProfiles.length > 0) {
+        for (const profile of repositoryProfiles) {
+            profiles[profile.id] = {
+                provider: 'github',
+                displayName: profile.displayName,
+                config: {
+                    owner: profile.owner,
+                    repo: profile.repo
+                },
+                timeRange: {
+                    default: '1M',
+                    max: '6M'
+                },
+                rateLimits: {
+                    maxItemsPerSync: 500,
+                    warnThreshold: 100
+                }
+            };
+        }
+        // Handle monorepo projects if present
+        if (monorepoProjects && monorepoProjects.length > 0) {
+            const mainProfile = Object.values(profiles)[0];
+            if (mainProfile) {
+                mainProfile.config.monorepoProjects = monorepoProjects;
+            }
+        }
+        const defaultProfile = repositoryProfiles.find(p => p.isDefault) || repositoryProfiles[0];
+        config.sync = {
+            enabled: true,
+            direction: 'bidirectional',
+            autoSync: false,
+            provider: 'github',
+            includeStatus: syncSettings.includeStatus,
+            autoApplyLabels: syncSettings.autoApplyLabels,
+            activeProfile: defaultProfile?.id || 'main',
+            settings: {
+                canUpsertInternalItems: syncPermissions.canUpsertInternalItems,
+                canUpdateExternalItems: syncPermissions.canUpdateExternalItems,
+                canUpdateStatus: syncPermissions.canUpdateStatus
+            },
+            profiles
+        };
+    }
+    else {
+        // Fallback for legacy single-repo configuration
+        profiles['github-default'] = {
+            provider: 'github',
+            displayName: 'GitHub Default',
+            config: {
+                owner,
+                repo
+            },
+            timeRange: {
+                default: '1M',
+                max: '6M'
+            },
+            rateLimits: {
+                maxItemsPerSync: 500,
+                warnThreshold: 100
+            }
+        };
+        config.sync = {
+            enabled: true,
+            direction: 'bidirectional',
+            autoSync: false,
+            provider: 'github',
+            includeStatus: syncSettings.includeStatus,
+            autoApplyLabels: syncSettings.autoApplyLabels,
+            activeProfile: 'github-default',
+            settings: {
+                canUpsertInternalItems: syncPermissions.canUpsertInternalItems,
+                canUpdateExternalItems: syncPermissions.canUpdateExternalItems,
+                canUpdateStatus: syncPermissions.canUpdateStatus
+            },
+            profiles
+        };
+    }
+}
+/**
+ * Build JIRA sync configuration
+ */
+function buildJiraSyncConfig(config, profiles, credentials, syncSettings, syncPermissions) {
+    const jiraCreds = credentials;
+    const domain = jiraCreds.domain || '';
+    // Handle different Jira strategies
+    let project = '';
+    if (jiraCreds.strategy === 'project-per-team' && jiraCreds.projects) {
+        project = jiraCreds.projects; // Array of project keys
+    }
+    else {
+        project = jiraCreds.projectKey || jiraCreds.project || '';
+    }
+    profiles['jira-default'] = {
+        provider: 'jira',
+        displayName: 'Jira Default',
+        config: {
+            domain,
+            // Handle both single project (string) and multiple projects (array)
+            ...(Array.isArray(project)
+                ? { projects: project }
+                : { projectKey: project })
+        },
+        timeRange: {
+            default: '1M',
+            max: '6M'
+        }
+    };
+    config.sync = {
+        enabled: true,
+        direction: 'bidirectional',
+        autoSync: false,
+        provider: 'jira',
+        includeStatus: syncSettings.includeStatus,
+        autoApplyLabels: syncSettings.autoApplyLabels,
+        activeProfile: 'jira-default',
+        settings: {
+            canUpsertInternalItems: syncPermissions.canUpsertInternalItems,
+            canUpdateExternalItems: syncPermissions.canUpdateExternalItems,
+            canUpdateStatus: syncPermissions.canUpdateStatus
+        },
+        profiles
+    };
+}
+/**
+ * Build ADO sync configuration
+ */
+function buildAdoSyncConfig(config, profiles, credentials, syncSettings, syncPermissions) {
+    const adoCreds = credentials;
+    const organization = adoCreds.org || '';
+    const project = adoCreds.project || '';
+    // Handle multi-project configuration (v0.28.x+)
+    if (adoCreds.projects && adoCreds.projects.length > 0) {
+        let activeProfile = '';
+        for (const proj of adoCreds.projects) {
+            const profileId = `ado-${proj.name.toLowerCase().replace(/[^a-z0-9]/g, '-')}`;
+            profiles[profileId] = {
+                provider: 'ado',
+                displayName: `Azure DevOps - ${proj.name}`,
+                config: {
+                    organization,
+                    project: proj.name,
+                    ...(proj.areaPaths?.length ? { areaPaths: proj.areaPaths } : {}),
+                    ...(adoCreds.strategy ? { strategy: adoCreds.strategy } : {}),
+                    ...(proj.isUmbrella ? { isUmbrella: true } : {})
+                },
+                timeRange: {
+                    default: '1M',
+                    max: '6M'
+                }
+            };
+            // Set default profile (skip umbrella projects)
+            if (proj.isDefault && !proj.isUmbrella) {
+                activeProfile = profileId;
+            }
+        }
+        // Fallback to first profile if no default set
+        if (!activeProfile) {
+            activeProfile = Object.keys(profiles)[0];
+        }
+        config.sync = {
+            enabled: true,
+            direction: 'bidirectional',
+            autoSync: false,
+            provider: 'ado',
+            includeStatus: syncSettings.includeStatus,
+            autoApplyLabels: syncSettings.autoApplyLabels,
+            activeProfile,
+            settings: {
+                canUpsertInternalItems: syncPermissions.canUpsertInternalItems,
+                canUpdateExternalItems: syncPermissions.canUpdateExternalItems,
+                canUpdateStatus: syncPermissions.canUpdateStatus
+            },
+            profiles
+        };
+        // Set multiProject.enabled for ADO multi-project setups
+        const defaultProject = adoCreds.projects.find((p) => p.isDefault && !p.isUmbrella) || adoCreds.projects[0];
+        config.multiProject = {
+            enabled: true,
+            activeProject: defaultProject.name.toLowerCase().replace(/\s+/g, '-')
+        };
+    }
+    else {
+        // Single project configuration (backward compatibility)
+        profiles['ado-default'] = {
+            provider: 'ado',
+            displayName: 'Azure DevOps Default',
+            config: {
+                organization,
+                project,
+                ...(adoCreds.team ? { team: adoCreds.team } : {}),
+                ...(adoCreds.teams?.length ? { teams: adoCreds.teams } : {}),
+                ...(adoCreds.areaPaths?.length ? { areaPaths: adoCreds.areaPaths } : {}),
+                ...(adoCreds.strategy ? { strategy: adoCreds.strategy } : {})
+            },
+            timeRange: {
+                default: '1M',
+                max: '6M'
+            }
+        };
+        config.sync = {
+            enabled: true,
+            direction: 'bidirectional',
+            autoSync: false,
+            provider: 'ado',
+            includeStatus: syncSettings.includeStatus,
+            autoApplyLabels: syncSettings.autoApplyLabels,
+            activeProfile: 'ado-default',
+            settings: {
+                canUpsertInternalItems: syncPermissions.canUpsertInternalItems,
+                canUpdateExternalItems: syncPermissions.canUpdateExternalItems,
+                canUpdateStatus: syncPermissions.canUpdateStatus
+            },
+            profiles
+        };
+    }
+}
+//# sourceMappingURL=sync-config-writer.js.map

package/dist/src/cli/helpers/issue-tracker/sync-config-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-config-writer.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/sync-config-writer.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/helpers/issue-tracker/types.d.ts

@@ -56,6 +56,14 @@ export interface JiraCredentials {
  * Azure DevOps team mapping strategies
  */
 export type AzureDevOpsStrategy = 'project-per-team' | 'area-path-based' | 'team-based';
+/**
+ * ADO Process Template types
+ *
+ * Detected automatically via ADO API to determine hierarchy mapping.
+ * SAFe has 5 levels (Capability→Epic→Feature→Story→Task)
+ * Others have 4 levels or less.
+ */
+export type AdoProcessTemplate = 'Agile' | 'Scrum' | 'CMMI' | 'Basic' | 'SAFe' | 'unknown';
 /**
  * Per-project configuration for Azure DevOps
  *
@@ -66,6 +74,10 @@ export interface AzureDevOpsProjectConfig {
     areaPaths?: string[];
     isDefault?: boolean;
     isUmbrella?: boolean;
+    /** Auto-detected process template (Agile, Scrum, CMMI, SAFe, etc.) */
+    processTemplate?: AdoProcessTemplate;
+    /** True if project has Capability work item type (indicates SAFe 5-level hierarchy) */
+    hasCapability?: boolean;
 }
 /**
  * Azure DevOps credentials
@@ -142,6 +154,21 @@ export interface SetupOptions {
     /** ADO credentials from repository setup - reused when ADO is also selected for issue tracking */
     adoCredentialsFromRepoSetup?: AdoProjectSelection;
 }
+/**
+ * Sync settings for external tool integration
+ */
+export interface SyncSettings {
+    includeStatus: boolean;
+    autoApplyLabels: boolean;
+}
+/**
+ * Sync permissions for external tool operations
+ */
+export interface SyncPermissions {
+    canUpsertInternalItems: boolean;
+    canUpdateExternalItems: boolean;
+    canUpdateStatus: boolean;
+}
 /**
  * Rate limit information
  */

package/dist/src/cli/helpers/issue-tracker/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/types.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/helpers/issue-tracker/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyMH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACR,aAA4B;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,kBAAa,GAAb,aAAa,CAAe;QAGnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/cli/helpers/issue-tracker/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuOH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YACE,OAAe,EACR,aAA4B;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,kBAAa,GAAb,aAAa,CAAe;QAGnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/cli/workers/living-docs-worker.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Living Docs Builder Worker
+ *
+ * Background worker that generates living documentation from codebase analysis.
+ * Handles long-running operations (hours/days for large codebases) with:
+ * - Checkpoint/resume support
+ * - Dependency waiting (clone/import jobs)
+ * - Phase-based progress tracking
+ * - Structured logging
+ *
+ * Usage:
+ *   node living-docs-worker.js <jobId> <projectPath>
+ */
+export {};
+//# sourceMappingURL=living-docs-worker.d.ts.map

package/dist/src/cli/workers/living-docs-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"living-docs-worker.d.ts","sourceRoot":"","sources":["../../../../src/cli/workers/living-docs-worker.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}