specweave 0.29.2 → 0.30.0

package/dist/plugins/specweave-ado/lib/conflict-resolver.js

@@ -0,0 +1,423 @@
+/**
+ * Conflict Resolver for Living Docs Synchronization
+ *
+ * CRITICAL PRINCIPLE: External tool status ALWAYS wins in conflicts!
+ * This ensures that QA and stakeholder decisions in external tools
+ * take precedence over local development status.
+ */
+import * as fs from '../../../src/utils/fs-native.js';
+import * as path from 'path';
+import * as yaml from 'yaml';
+// ============================================================================
+// Status Mapping
+// ============================================================================
+const STATUS_MAPPING = {
+    ado: {
+        'New': 'draft',
+        'Active': 'in-progress',
+        'Resolved': 'implemented',
+        'Closed': 'complete',
+        'In Review': 'in-qa',
+        'In QA': 'in-qa',
+        'Blocked': 'blocked',
+        'Removed': 'cancelled'
+    },
+    jira: {
+        'To Do': 'draft',
+        'In Progress': 'in-progress',
+        'Code Review': 'implemented',
+        'In Review': 'implemented',
+        'QA': 'in-qa',
+        'Testing': 'in-qa',
+        'Done': 'complete',
+        'Closed': 'complete',
+        'Blocked': 'blocked',
+        'Cancelled': 'cancelled'
+    },
+    github: {
+        'open': 'in-progress',
+        'closed': 'complete'
+    }
+};
+const REVERSE_STATUS_MAPPING = {
+    ado: {
+        'draft': 'New',
+        'in-progress': 'Active',
+        'implemented': 'Resolved',
+        'in-qa': 'In QA',
+        'complete': 'Closed',
+        'blocked': 'Blocked',
+        'cancelled': 'Removed'
+    },
+    jira: {
+        'draft': 'To Do',
+        'in-progress': 'In Progress',
+        'implemented': 'Code Review',
+        'in-qa': 'QA',
+        'complete': 'Done',
+        'blocked': 'Blocked',
+        'cancelled': 'Cancelled'
+    },
+    github: {
+        'draft': 'open',
+        'in-progress': 'open',
+        'implemented': 'open',
+        'in-qa': 'open',
+        'complete': 'closed',
+        'blocked': 'open',
+        'cancelled': 'closed'
+    }
+};
+// ============================================================================
+// Conflict Resolver Class
+// ============================================================================
+export class ConflictResolver {
+    constructor() {
+        this.resolutionLog = [];
+    }
+    /**
+     * Map external status to local SpecWeave status
+     */
+    mapExternalStatus(tool, externalStatus) {
+        const mapping = STATUS_MAPPING[tool];
+        return mapping[externalStatus] || 'unknown';
+    }
+    /**
+     * Map local status to external tool status
+     */
+    mapLocalStatus(tool, localStatus) {
+        const mapping = REVERSE_STATUS_MAPPING[tool];
+        return mapping[localStatus] || 'Active';
+    }
+    /**
+     * CRITICAL: Resolve status conflict - EXTERNAL ALWAYS WINS
+     */
+    resolveStatusConflict(localStatus, externalStatus) {
+        const resolution = {
+            field: 'status',
+            localValue: localStatus,
+            externalValue: externalStatus.status,
+            resolution: 'external', // ALWAYS external for status
+            resolvedValue: externalStatus.mappedStatus,
+            reason: 'External tool reflects QA and stakeholder decisions',
+            timestamp: new Date().toISOString()
+        };
+        // Log the resolution
+        console.log(`📊 Status Conflict Detected:`);
+        console.log(`   Local: ${localStatus}`);
+        console.log(`   External: ${externalStatus.status} (${externalStatus.tool})`);
+        console.log(`   ✅ Resolution: EXTERNAL WINS - ${externalStatus.mappedStatus}`);
+        this.resolutionLog.push(resolution);
+        return resolution;
+    }
+    /**
+     * Compare timestamps to determine winner (Increment 0089)
+     *
+     * For pull sync, we compare local lastModified vs external ChangedDate.
+     * The more recent timestamp wins.
+     *
+     * @param localTimestamp - Local file lastModified timestamp (ISO string or null)
+     * @param externalTimestamp - External tool ChangedDate (ISO string)
+     * @returns Comparison result with winner and reasoning
+     */
+    compareTimestamps(localTimestamp, externalTimestamp) {
+        const externalDate = new Date(externalTimestamp);
+        // If no local timestamp, external wins by default
+        if (!localTimestamp) {
+            return {
+                winner: 'external',
+                localTimestamp: null,
+                externalTimestamp,
+                timeDiffMs: 0,
+                reason: 'No local timestamp available, external wins by default',
+            };
+        }
+        const localDate = new Date(localTimestamp);
+        const timeDiffMs = externalDate.getTime() - localDate.getTime();
+        // External is more recent → external wins
+        if (timeDiffMs > 0) {
+            console.log(`📊 Timestamp Comparison:`);
+            console.log(`   Local:    ${localTimestamp}`);
+            console.log(`   External: ${externalTimestamp}`);
+            console.log(`   ✅ Winner: EXTERNAL (${Math.round(timeDiffMs / 60000)}min newer)`);
+            return {
+                winner: 'external',
+                localTimestamp,
+                externalTimestamp,
+                timeDiffMs,
+                reason: `External is ${Math.round(timeDiffMs / 60000)} minutes newer`,
+            };
+        }
+        // Local is more recent → local wins (don't overwrite local changes)
+        if (timeDiffMs < 0) {
+            console.log(`📊 Timestamp Comparison:`);
+            console.log(`   Local:    ${localTimestamp}`);
+            console.log(`   External: ${externalTimestamp}`);
+            console.log(`   ✅ Winner: LOCAL (${Math.round(Math.abs(timeDiffMs) / 60000)}min newer)`);
+            return {
+                winner: 'local',
+                localTimestamp,
+                externalTimestamp,
+                timeDiffMs,
+                reason: `Local is ${Math.round(Math.abs(timeDiffMs) / 60000)} minutes newer`,
+            };
+        }
+        // Same timestamp → no conflict
+        return {
+            winner: 'none',
+            localTimestamp,
+            externalTimestamp,
+            timeDiffMs: 0,
+            reason: 'Timestamps are identical, no conflict',
+        };
+    }
+    /**
+     * Resolve conflict using timestamp comparison (Increment 0089)
+     *
+     * Combines timestamp comparison with status conflict resolution.
+     * Used by ExternalChangePuller for pull sync.
+     *
+     * @param field - The field being compared (e.g., 'status')
+     * @param localValue - Current local value
+     * @param externalValue - Value from external tool
+     * @param localTimestamp - Local lastModified timestamp
+     * @param externalTimestamp - External ChangedDate
+     * @returns Conflict resolution result
+     */
+    resolveWithTimestamp(field, localValue, externalValue, localTimestamp, externalTimestamp) {
+        const comparison = this.compareTimestamps(localTimestamp, externalTimestamp);
+        const resolution = {
+            field,
+            localValue,
+            externalValue,
+            resolution: comparison.winner === 'local' ? 'local' : 'external',
+            resolvedValue: comparison.winner === 'local' ? localValue : externalValue,
+            reason: comparison.reason,
+            timestamp: new Date().toISOString(),
+        };
+        // Log the resolution
+        console.log(`📊 Conflict Resolved (${field}):`);
+        console.log(`   Winner: ${comparison.winner.toUpperCase()}`);
+        console.log(`   Reason: ${comparison.reason}`);
+        this.resolutionLog.push(resolution);
+        return resolution;
+    }
+    /**
+     * Resolve priority conflict - EXTERNAL WINS
+     */
+    resolvePriorityConflict(localPriority, externalPriority) {
+        const resolution = {
+            field: 'priority',
+            localValue: localPriority,
+            externalValue: externalPriority,
+            resolution: 'external',
+            resolvedValue: externalPriority || localPriority,
+            reason: 'External tool reflects stakeholder prioritization',
+            timestamp: new Date().toISOString()
+        };
+        if (localPriority !== externalPriority && externalPriority) {
+            console.log(`📊 Priority Conflict Detected:`);
+            console.log(`   Local: ${localPriority}`);
+            console.log(`   External: ${externalPriority}`);
+            console.log(`   ✅ Resolution: EXTERNAL WINS - ${externalPriority}`);
+            this.resolutionLog.push(resolution);
+        }
+        return resolution;
+    }
+    /**
+     * Apply conflict resolutions to spec
+     */
+    async applyResolutions(specPath, resolutions) {
+        const content = await fs.readFile(specPath, 'utf-8');
+        const lines = content.split('\n');
+        let inFrontmatter = false;
+        let frontmatterEnd = -1;
+        // Find frontmatter boundaries
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i] === '---') {
+                if (!inFrontmatter) {
+                    inFrontmatter = true;
+                }
+                else {
+                    frontmatterEnd = i;
+                    break;
+                }
+            }
+        }
+        // Apply resolutions
+        for (const resolution of resolutions) {
+            if (resolution.field === 'status') {
+                // Update status in frontmatter
+                for (let i = 1; i < frontmatterEnd; i++) {
+                    if (lines[i].startsWith('status:')) {
+                        lines[i] = `status: ${resolution.resolvedValue}`;
+                        console.log(`✅ Applied status resolution: ${resolution.resolvedValue}`);
+                        break;
+                    }
+                }
+                // Add sync metadata
+                const syncTimestamp = new Date().toISOString();
+                let syncedAtFound = false;
+                for (let i = 1; i < frontmatterEnd; i++) {
+                    if (lines[i].includes('syncedAt:')) {
+                        lines[i] = `    syncedAt: "${syncTimestamp}"`;
+                        syncedAtFound = true;
+                        break;
+                    }
+                }
+                if (!syncedAtFound) {
+                    // Add syncedAt after externalLinks
+                    for (let i = 1; i < frontmatterEnd; i++) {
+                        if (lines[i].includes('externalLinks:')) {
+                            // Find the external tool section
+                            for (let j = i + 1; j < frontmatterEnd; j++) {
+                                if (lines[j].includes('ado:') || lines[j].includes('jira:') || lines[j].includes('github:')) {
+                                    // Insert after the URL line
+                                    for (let k = j + 1; k < frontmatterEnd; k++) {
+                                        if (lines[k].includes('Url:')) {
+                                            lines.splice(k + 1, 0, `    syncedAt: "${syncTimestamp}"`);
+                                            frontmatterEnd++; // Adjust for inserted line
+                                            syncedAtFound = true;
+                                            break;
+                                        }
+                                    }
+                                    if (syncedAtFound)
+                                        break;
+                                }
+                            }
+                            if (syncedAtFound)
+                                break;
+                        }
+                    }
+                }
+            }
+            else if (resolution.field === 'priority' && resolution.resolvedValue) {
+                // Update priority in frontmatter
+                for (let i = 1; i < frontmatterEnd; i++) {
+                    if (lines[i].startsWith('priority:')) {
+                        lines[i] = `priority: ${resolution.resolvedValue}`;
+                        console.log(`✅ Applied priority resolution: ${resolution.resolvedValue}`);
+                        break;
+                    }
+                }
+            }
+        }
+        // Write updated content
+        await fs.writeFile(specPath, lines.join('\n'));
+        console.log(`✅ Resolutions applied to ${path.basename(specPath)}`);
+    }
+    /**
+     * Validate that external status wins in implementation
+     */
+    validateImplementation(implementationCode) {
+        const violations = [];
+        // Check for incorrect patterns
+        const incorrectPatterns = [
+            {
+                pattern: /if.*conflict.*\{[^}]*spec\.status\s*=\s*localStatus/,
+                message: 'Local status should never win in conflicts'
+            },
+            {
+                pattern: /resolution\s*:\s*['"]local['"]/,
+                message: 'Resolution should be "external" for status conflicts'
+            },
+            {
+                pattern: /prefer.*local.*status/i,
+                message: 'Should prefer external status'
+            }
+        ];
+        for (const { pattern, message } of incorrectPatterns) {
+            if (pattern.test(implementationCode)) {
+                violations.push(message);
+            }
+        }
+        // Check for correct patterns
+        const requiredPatterns = [
+            {
+                pattern: /external.*wins|EXTERNAL.*WINS|externalStatus.*applied/i,
+                message: 'Missing confirmation that external wins'
+            }
+        ];
+        for (const { pattern, message } of requiredPatterns) {
+            if (!pattern.test(implementationCode)) {
+                violations.push(message);
+            }
+        }
+        return {
+            valid: violations.length === 0,
+            violations
+        };
+    }
+    /**
+     * Get resolution history
+     */
+    getResolutionLog() {
+        return this.resolutionLog;
+    }
+    /**
+     * Generate resolution report
+     */
+    generateReport() {
+        const report = [];
+        report.push('# Conflict Resolution Report');
+        report.push(`\n**Generated**: ${new Date().toISOString()}`);
+        report.push(`**Total Resolutions**: ${this.resolutionLog.length}`);
+        report.push('\n## Resolutions\n');
+        for (const resolution of this.resolutionLog) {
+            report.push(`### ${resolution.field}`);
+            report.push(`- **Local Value**: ${resolution.localValue}`);
+            report.push(`- **External Value**: ${resolution.externalValue}`);
+            report.push(`- **Resolution**: ${resolution.resolution.toUpperCase()} WINS`);
+            report.push(`- **Resolved To**: ${resolution.resolvedValue}`);
+            report.push(`- **Reason**: ${resolution.reason}`);
+            report.push(`- **Time**: ${resolution.timestamp}\n`);
+        }
+        report.push('## Validation');
+        report.push('✅ All conflicts resolved with external tool priority');
+        return report.join('\n');
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Load spec metadata from file
+ */
+export async function loadSpecMetadata(specPath) {
+    const content = await fs.readFile(specPath, 'utf-8');
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        throw new Error(`No frontmatter found in ${specPath}`);
+    }
+    return yaml.parse(frontmatterMatch[1]);
+}
+/**
+ * Perform three-permission sync with conflict resolution
+ */
+export async function performBidirectionalSync(specPath, externalStatus) {
+    const resolver = new ConflictResolver();
+    const spec = await loadSpecMetadata(specPath);
+    const resolutions = [];
+    // Check for status conflict
+    if (spec.status !== externalStatus.mappedStatus) {
+        const statusResolution = resolver.resolveStatusConflict(spec.status, externalStatus);
+        resolutions.push(statusResolution);
+    }
+    // Apply resolutions if any conflicts found
+    if (resolutions.length > 0) {
+        await resolver.applyResolutions(specPath, resolutions);
+        // Generate and save report
+        const report = resolver.generateReport();
+        const reportPath = specPath.replace('.md', '-sync-report.md');
+        await fs.writeFile(reportPath, report);
+        console.log(`📄 Sync report saved to ${path.basename(reportPath)}`);
+    }
+    else {
+        console.log('✅ No conflicts detected - spec in sync with external tool');
+    }
+}
+// ============================================================================
+// Export for testing
+// ============================================================================
+export default ConflictResolver;
+//# sourceMappingURL=conflict-resolver.js.map

package/dist/plugins/specweave-ado/lib/conflict-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.js","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/conflict-resolver.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-client-v2.d.ts

@@ -7,7 +7,7 @@
  * - Rate limiting protection
  * - Secure command execution (no shell injection)
  */
-import { GitHubIssue, GitHubMilestone } from './types';
+import { GitHubIssue, GitHubMilestone, GitHubExternalChange } from './types';
 import { SyncProfile, TimeRangePreset } from '../../../src/core/types/sync-profile';
 export declare class GitHubClientV2 {
     private owner;
@@ -170,5 +170,27 @@ export declare class GitHubClientV2 {
         delayMs?: number;
     }): Promise<GitHubIssue[]>;
     private sleep;
+    /**
+     * Fetch recently changed issues for pull sync
+     *
+     * Uses GitHub Issues API with `since` parameter to find issues
+     * that have been updated since a given timestamp.
+     *
+     * @param since - Timestamp to query changes from
+     * @param linkedIssueNumbers - Optional list of issue numbers to filter (linked items only)
+     * @returns Array of external changes with changedAt, changedBy, and current values
+     */
+    fetchRecentChanges(since: Date, linkedIssueNumbers?: number[]): Promise<GitHubExternalChange[]>;
+    /**
+     * Get issue events for detailed change tracking
+     *
+     * Use this for detailed changelog when needed.
+     * GET /repos/{owner}/{repo}/issues/{issue_number}/events
+     *
+     * @param issueNumber - Issue number
+     * @param perPage - Limit number of events
+     * @returns Array of events with action details
+     */
+    getIssueEvents(issueNumber: number, perPage?: number): Promise<any[]>;
 }
 //# sourceMappingURL=github-client-v2.d.ts.map

package/dist/plugins/specweave-github/lib/github-client-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-client-v2.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client-v2.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"github-client-v2.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client-v2.ts"],"names":[],"mappings":"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"}

package/dist/plugins/specweave-github/lib/github-client-v2.js

@@ -621,5 +621,100 @@ export class GitHubClientV2 {
     sleep(ms) {
         return new Promise((resolve) => setTimeout(resolve, ms));
     }
+    // ==========================================================================
+    // Pull Sync - External Change Detection (Increment 0089)
+    // ==========================================================================
+    /**
+     * Fetch recently changed issues for pull sync
+     *
+     * Uses GitHub Issues API with `since` parameter to find issues
+     * that have been updated since a given timestamp.
+     *
+     * @param since - Timestamp to query changes from
+     * @param linkedIssueNumbers - Optional list of issue numbers to filter (linked items only)
+     * @returns Array of external changes with changedAt, changedBy, and current values
+     */
+    async fetchRecentChanges(since, linkedIssueNumbers) {
+        // Build JQ filter for issues updated since timestamp
+        const sinceISO = since.toISOString();
+        // Query parameters - MUST use .[] to iterate array from GitHub API
+        const jqFilter = linkedIssueNumbers && linkedIssueNumbers.length > 0
+            ? `.[] | select(.number | IN(${linkedIssueNumbers.join(',')})) | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}`
+            : `.[] | {number, title, state, updated_at, user: .user.login, assignee: .assignee.login, labels: [.labels[].name]}`;
+        // Use GitHub API to fetch issues updated since timestamp
+        const result = await execFileNoThrow('gh', [
+            'api',
+            `repos/${this.fullRepo}/issues`,
+            '--method', 'GET',
+            '-f', `since=${sinceISO}`,
+            '-f', 'state=all',
+            '-f', 'sort=updated',
+            '-f', 'direction=desc',
+            '-f', 'per_page=100',
+            '--jq', jqFilter,
+        ]);
+        if (result.exitCode !== 0) {
+            throw new Error(`Failed to fetch recent changes: ${result.stderr || result.stdout}`);
+        }
+        // Parse NDJSON output (one JSON object per line)
+        const lines = result.stdout.trim().split('\n').filter(l => l.trim());
+        const issues = [];
+        for (const line of lines) {
+            try {
+                issues.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        // Map to GitHubExternalChange format
+        const changes = issues.map(issue => ({
+            platform: 'github',
+            externalId: `GH-${issue.number}`,
+            issueNumber: issue.number,
+            changedAt: issue.updated_at || new Date().toISOString(),
+            changedBy: issue.user || 'unknown',
+            changedFields: [], // GitHub doesn't provide changelog in list API
+            currentState: {
+                status: issue.state,
+                labels: issue.labels || [],
+                assignee: issue.assignee || null,
+            },
+        }));
+        return changes;
+    }
+    /**
+     * Get issue events for detailed change tracking
+     *
+     * Use this for detailed changelog when needed.
+     * GET /repos/{owner}/{repo}/issues/{issue_number}/events
+     *
+     * @param issueNumber - Issue number
+     * @param perPage - Limit number of events
+     * @returns Array of events with action details
+     */
+    async getIssueEvents(issueNumber, perPage = 30) {
+        const result = await execFileNoThrow('gh', [
+            'api',
+            `repos/${this.fullRepo}/issues/${issueNumber}/events`,
+            '-f', `per_page=${perPage}`,
+            '--jq', '.[].{event, created_at, actor: .actor.login}',
+        ]);
+        if (result.exitCode !== 0) {
+            throw new Error(`Failed to get issue events: ${result.stderr || result.stdout}`);
+        }
+        // Parse NDJSON output
+        const lines = result.stdout.trim().split('\n').filter(l => l.trim());
+        const events = [];
+        for (const line of lines) {
+            try {
+                events.push(JSON.parse(line));
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return events;
+    }
 }
 //# sourceMappingURL=github-client-v2.js.map