specweave 0.22.14 → 0.23.0

package/dist/src/sync/external-item-sync-service.js

@@ -0,0 +1,241 @@
+/**
+ * External Item Sync Service
+ *
+ * Handles synchronization with external tools (GitHub, JIRA, ADO) while
+ * preserving original item format and preventing unintended modifications.
+ *
+ * Key Features:
+ * - Comment-based updates for external items (format preservation)
+ * - Full sync for internal items (title, description, ACs)
+ * - Format preservation validation
+ * - External title immutability
+ *
+ * Part of increment 0047-us-task-linkage (T-034B)
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import matter from 'gray-matter';
+import { consoleLogger } from '../utils/logger.js';
+import { FormatPreservationValidator } from '../validators/format-preservation-validator.js';
+/**
+ * External Item Sync Service
+ *
+ * Routes sync operations based on format_preservation flag.
+ * External items (format_preservation=true) → comment-only sync
+ * Internal items (format_preservation=false) → full sync
+ */
+export class ExternalItemSyncService {
+    constructor(options = {}) {
+        this.logger = options.logger ?? consoleLogger;
+        this.validator = new FormatPreservationValidator({ logger: this.logger });
+    }
+    /**
+     * Sync task completion to external tool
+     *
+     * Routes to comment-only or full sync based on format_preservation flag
+     *
+     * @param completionData - Task completion data
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    async syncTaskCompletion(completionData, options) {
+        try {
+            this.logger.log(`   🔄 Syncing task ${completionData.taskId} completion for ${completionData.usId}...`);
+            // Read format preservation flag from living docs
+            const formatPreservation = await this.getFormatPreservation(completionData.usId, completionData.featureId, options.projectRoot);
+            // Force full sync if requested (e.g., for internal items or testing)
+            if (options.forceFullSync) {
+                this.logger.log(`   📝 Full sync mode (force flag enabled)`);
+                return await this.fullSync(completionData, options);
+            }
+            // Route based on format_preservation flag
+            if (formatPreservation) {
+                this.logger.log(`   💬 Comment-only mode (format preservation enabled)`);
+                return await this.commentOnlySync(completionData, options);
+            }
+            else {
+                this.logger.log(`   📝 Full sync mode (format preservation disabled)`);
+                return await this.fullSync(completionData, options);
+            }
+        }
+        catch (error) {
+            this.logger.error(`   ❌ Sync failed for ${completionData.taskId}:`, error);
+            return {
+                success: false,
+                mode: 'skipped',
+                reason: 'Error during sync',
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Get format_preservation flag from living docs User Story file
+     *
+     * @param usId - User Story ID (e.g., "US-009")
+     * @param featureId - Feature ID (e.g., "FS-047")
+     * @param projectRoot - Project root directory
+     * @returns True if format preservation enabled
+     */
+    async getFormatPreservation(usId, featureId, projectRoot) {
+        try {
+            // Find US file in living docs
+            const usFilePath = await this.findUSFile(projectRoot, featureId, usId);
+            if (!usFilePath) {
+                this.logger.warn(`   ⚠️  Living docs file not found for ${usId}, defaulting to full sync`);
+                return false;
+            }
+            // Parse frontmatter
+            const content = await fs.readFile(usFilePath, 'utf-8');
+            const parsed = matter(content);
+            const frontmatter = parsed.data;
+            // Default to false (full sync) if not specified
+            return frontmatter.format_preservation === true;
+        }
+        catch (error) {
+            this.logger.warn(`   ⚠️  Failed to read format_preservation for ${usId}: ${error.message}`);
+            return false; // Default to full sync on error
+        }
+    }
+    /**
+     * Find User Story file in living docs
+     *
+     * @param projectRoot - Project root
+     * @param featureId - Feature ID (e.g., "FS-047")
+     * @param usId - User Story ID (e.g., "US-009")
+     * @returns Path to US file or null if not found
+     */
+    async findUSFile(projectRoot, featureId, usId) {
+        // Pattern: .specweave/docs/internal/specs/{project}/{feature}/us-{id}-*.md
+        const specsDir = path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs');
+        // Search in all projects (default and multi-project)
+        const projectDirs = await this.getProjectDirs(specsDir);
+        for (const projectDir of projectDirs) {
+            const featureDir = path.join(projectDir, featureId);
+            if (!await fs.pathExists(featureDir))
+                continue;
+            const files = await fs.readdir(featureDir);
+            const usFile = files.find(f => f.toLowerCase().startsWith(`${usId.toLowerCase()}-`));
+            if (usFile) {
+                return path.join(featureDir, usFile);
+            }
+        }
+        return null;
+    }
+    /**
+     * Get all project directories in specs
+     *
+     * @param specsDir - Specs directory
+     * @returns Array of project directory paths
+     */
+    async getProjectDirs(specsDir) {
+        if (!await fs.pathExists(specsDir)) {
+            return [];
+        }
+        const entries = await fs.readdir(specsDir, { withFileTypes: true });
+        const projectDirs = entries
+            .filter(e => e.isDirectory() && !e.name.startsWith('_'))
+            .map(e => path.join(specsDir, e.name));
+        return projectDirs;
+    }
+    /**
+     * Comment-only sync: Post completion update as comment
+     *
+     * Does NOT modify external item title, description, or acceptance criteria.
+     * Only posts a comment with task completion status.
+     *
+     * @param completionData - Task completion data
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    async commentOnlySync(completionData, options) {
+        // Format completion comment
+        const comment = this.formatCompletionComment(completionData);
+        if (options.dryRun) {
+            this.logger.log(`   🔍 [DRY RUN] Would post comment:\n${comment}`);
+            return {
+                success: true,
+                mode: 'comment-only',
+                reason: 'Format preservation enabled (external item)',
+                comment
+            };
+        }
+        // TODO: Integrate with external tool APIs (GitHub, JIRA, ADO)
+        // For now, just log the comment that would be posted
+        this.logger.log(`   💬 Comment to post:\n${comment}`);
+        return {
+            success: true,
+            mode: 'comment-only',
+            reason: 'Format preservation enabled (external item)',
+            comment
+        };
+    }
+    /**
+     * Full sync: Update external item title, description, ACs
+     *
+     * Used for internal items or when format preservation disabled.
+     *
+     * @param completionData - Task completion data
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    async fullSync(completionData, options) {
+        const updatedFields = [];
+        // Validate sync operation (NEW - T-034C)
+        const formatPreservation = await this.getFormatPreservation(completionData.usId, completionData.featureId, options.projectRoot);
+        const syncOperation = {
+            usId: completionData.usId,
+            formatPreservation,
+            updates: ['title', 'description', 'acceptance_criteria'],
+            origin: formatPreservation ? 'external' : 'internal'
+        };
+        const validation = this.validator.validate(syncOperation);
+        if (!validation.valid) {
+            this.logger.error(`   ❌ Full sync blocked by format preservation validation:`, validation.errors?.join(', '));
+            return {
+                success: false,
+                mode: 'skipped',
+                reason: 'Format preservation validation failed',
+                error: validation.errors?.join('; ')
+            };
+        }
+        if (options.dryRun) {
+            this.logger.log(`   🔍 [DRY RUN] Would perform full sync for ${completionData.usId}`);
+            return {
+                success: true,
+                mode: 'full-sync',
+                reason: 'Format preservation disabled (internal item)',
+                updatedFields: validation.allowedFields
+            };
+        }
+        // TODO: Implement full sync logic
+        // - Update external item title
+        // - Update external item description
+        // - Update acceptance criteria checkboxes
+        this.logger.log(`   📝 Full sync for ${completionData.usId} (not yet implemented)`);
+        return {
+            success: true,
+            mode: 'full-sync',
+            reason: 'Format preservation disabled (internal item)',
+            updatedFields: validation.allowedFields
+        };
+    }
+    /**
+     * Format completion comment for external tool
+     *
+     * @param data - Task completion data
+     * @returns Formatted comment
+     */
+    formatCompletionComment(data) {
+        const statusEmoji = data.status === 'completed' ? '✅' : '🔄';
+        return `${statusEmoji} **[${data.featureId}][${data.taskId}]** ${data.taskTitle}
+
+**Status**: ${data.status}
+**Acceptance Criteria Satisfied**: ${data.satisfiesACs.length > 0 ? data.satisfiesACs.join(', ') : 'None'}
+**Progress**: ${data.completedTasks}/${data.totalTasks} tasks (${data.percentage}%)
+${data.livingDocsUrl ? `**Living Docs**: [View spec](${data.livingDocsUrl})` : ''}
+
+---
+*Auto-posted by SpecWeave format preservation sync*`;
+    }
+}
+//# sourceMappingURL=external-item-sync-service.js.map

package/dist/src/sync/external-item-sync-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-item-sync-service.js","sourceRoot":"","sources":["../../../src/sync/external-item-sync-service.ts"],"names":[],"mappings":"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"}

package/dist/src/sync/format-preservation-sync.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Format Preservation Sync Service (T-034B)
+ *
+ * Routes sync to comment-only mode for external items (preserves original format)
+ * and full sync mode for internal items (allows title/description updates).
+ *
+ * Architecture:
+ * - External US (origin=external): Comment-only sync (no title/description changes)
+ * - Internal US (origin=internal): Full sync (title, description, status, comments)
+ */
+import { LivingDocsUSFile } from '../types/living-docs-us-file.js';
+import { GitHubClientV2 } from '../../plugins/specweave-github/lib/github-client-v2.js';
+import { JiraClient } from '../integrations/jira/jira-client.js';
+import { AdoClient } from '../integrations/ado/ado-client.js';
+import { Logger } from '../utils/logger.js';
+export interface SyncConfig {
+    /** Allow updating external items from SpecWeave (Internal → External) */
+    canUpdateExternalItems?: boolean;
+    /** Allow upserting internal items from external tools (External → Internal) */
+    canUpsertInternalItems?: boolean;
+    /** Allow status updates (both directions) */
+    canUpdateStatus?: boolean;
+}
+export interface TaskCompletionInfo {
+    taskId: string;
+    title: string;
+    completed: boolean;
+}
+export interface ACCompletionInfo {
+    acId: string;
+    description: string;
+    satisfied: boolean;
+}
+export interface CompletionCommentData {
+    tasks: TaskCompletionInfo[];
+    acceptanceCriteria: ACCompletionInfo[];
+    progressPercentage: number;
+    livingDocsUrl?: string;
+}
+export declare class FormatPreservationSyncService {
+    private logger;
+    private config;
+    constructor(config?: SyncConfig, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Sync User Story to external tool with origin-based routing
+     *
+     * - External US (origin=external) → Comment-only sync
+     * - Internal US (origin=internal) → Full sync
+     */
+    syncUserStory(usFile: LivingDocsUSFile, completionData: CompletionCommentData, externalClient: GitHubClientV2 | JiraClient | AdoClient): Promise<void>;
+    /**
+     * Sync External US (Comment-only mode)
+     *
+     * Preserves original title/description, only adds completion comments
+     */
+    private syncExternalUS;
+    /**
+     * Sync Internal US (Full sync mode)
+     *
+     * Allows updating title, description, status, and comments
+     */
+    private syncInternalUS;
+    /**
+     * Build completion comment with task/AC progress
+     *
+     * Format:
+     * ## Progress Update
+     *
+     * ### Completed Tasks
+     * - ✅ [T-001] Task title
+     * - ✅ [T-002] Another task
+     *
+     * ### Acceptance Criteria
+     * - ✅ **AC-US1-01**: Criteria description
+     * - ✅ **AC-US1-02**: Another criteria
+     *
+     * **Progress**: 8/11 tasks completed (73%)
+     *
+     * [View Living Docs](url)
+     */
+    buildCompletionComment(data: CompletionCommentData): string;
+    /**
+     * Extract issue number from external_id
+     * Examples: "GH-#123" → 123, "#456" → 456
+     */
+    private extractIssueNumber;
+}
+//# sourceMappingURL=format-preservation-sync.d.ts.map

package/dist/src/sync/format-preservation-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-preservation-sync.d.ts","sourceRoot":"","sources":["../../../src/sync/format-preservation-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAa,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,6BAA6B;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAa;gBAGzB,MAAM,GAAE,UAAe,EACvB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAUnC;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,qBAAqB,EACrC,cAAc,EAAE,cAAc,GAAG,UAAU,GAAG,SAAS,GACtD,OAAO,CAAC,IAAI,CAAC;IAchB;;;;OAIG;YACW,cAAc;IA+B5B;;;;OAIG;YACW,cAAc;IAuC5B;;;;;;;;;;;;;;;;;OAiBG;IACH,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM;IA0C3D;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAI3B"}

package/dist/src/sync/format-preservation-sync.js

@@ -0,0 +1,173 @@
+/**
+ * Format Preservation Sync Service (T-034B)
+ *
+ * Routes sync to comment-only mode for external items (preserves original format)
+ * and full sync mode for internal items (allows title/description updates).
+ *
+ * Architecture:
+ * - External US (origin=external): Comment-only sync (no title/description changes)
+ * - Internal US (origin=internal): Full sync (title, description, status, comments)
+ */
+import { getOrigin } from '../types/living-docs-us-file.js';
+import { GitHubClientV2 } from '../../plugins/specweave-github/lib/github-client-v2.js';
+import { JiraClient } from '../integrations/jira/jira-client.js';
+import { AdoClient } from '../integrations/ado/ado-client.js';
+import { consoleLogger } from '../utils/logger.js';
+export class FormatPreservationSyncService {
+    constructor(config = {}, options = {}) {
+        this.config = {
+            canUpdateExternalItems: config.canUpdateExternalItems ?? false,
+            canUpsertInternalItems: config.canUpsertInternalItems ?? false,
+            canUpdateStatus: config.canUpdateStatus ?? false
+        };
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Sync User Story to external tool with origin-based routing
+     *
+     * - External US (origin=external) → Comment-only sync
+     * - Internal US (origin=internal) → Full sync
+     */
+    async syncUserStory(usFile, completionData, externalClient) {
+        const origin = getOrigin(usFile);
+        this.logger.log(`📊 Syncing ${usFile.id} (origin: ${origin})`);
+        if (origin === 'external') {
+            // External US: Comment-only sync (preserves format)
+            await this.syncExternalUS(usFile, completionData, externalClient);
+        }
+        else {
+            // Internal US: Full sync (allows updates)
+            await this.syncInternalUS(usFile, completionData, externalClient);
+        }
+    }
+    /**
+     * Sync External US (Comment-only mode)
+     *
+     * Preserves original title/description, only adds completion comments
+     */
+    async syncExternalUS(usFile, completionData, externalClient) {
+        this.logger.log(`  💬 External US: Comment-only sync (format preserved)`);
+        // Build completion comment
+        const comment = this.buildCompletionComment(completionData);
+        // Post comment to external tool
+        if (externalClient instanceof GitHubClientV2) {
+            const issueNumber = this.extractIssueNumber(usFile.external_id || '');
+            await externalClient.addComment(issueNumber, comment);
+        }
+        else if (externalClient instanceof JiraClient) {
+            const issueKey = usFile.external_id || '';
+            await externalClient.addComment(issueKey, comment);
+        }
+        else if (externalClient instanceof AdoClient) {
+            const workItemId = parseInt(usFile.external_id || '0', 10);
+            await externalClient.addComment(workItemId, comment);
+        }
+        // Conditional status update (only if config allows)
+        if (this.config.canUpdateStatus) {
+            this.logger.log(`  ✅ Status update enabled`);
+            // TODO: Implement status update logic
+        }
+        else {
+            this.logger.log(`  ⏭️  Status update skipped (canUpdateStatus=false)`);
+        }
+    }
+    /**
+     * Sync Internal US (Full sync mode)
+     *
+     * Allows updating title, description, status, and comments
+     */
+    async syncInternalUS(usFile, completionData, externalClient) {
+        this.logger.log(`  🔄 Internal US: Full sync (updates allowed)`);
+        // Full sync: Update title, description, comments, status
+        if (this.config.canUpdateExternalItems) {
+            this.logger.log(`  ✅ External updates enabled`);
+            // Build completion comment
+            const comment = this.buildCompletionComment(completionData);
+            // Post comment
+            if (externalClient instanceof GitHubClientV2) {
+                const issueNumber = this.extractIssueNumber(usFile.external_id || '');
+                await externalClient.addComment(issueNumber, comment);
+                // Update title/description if needed
+                // TODO: Implement title/description update logic
+            }
+            else if (externalClient instanceof JiraClient) {
+                const issueKey = usFile.external_id || '';
+                await externalClient.addComment(issueKey, comment);
+            }
+            else if (externalClient instanceof AdoClient) {
+                const workItemId = parseInt(usFile.external_id || '0', 10);
+                await externalClient.addComment(workItemId, comment);
+            }
+            // Update status if allowed
+            if (this.config.canUpdateStatus) {
+                this.logger.log(`  ✅ Status update enabled`);
+                // TODO: Implement status update logic
+            }
+        }
+        else {
+            this.logger.log(`  ⏭️  External updates skipped (canUpdateExternalItems=false)`);
+        }
+    }
+    /**
+     * Build completion comment with task/AC progress
+     *
+     * Format:
+     * ## Progress Update
+     *
+     * ### Completed Tasks
+     * - ✅ [T-001] Task title
+     * - ✅ [T-002] Another task
+     *
+     * ### Acceptance Criteria
+     * - ✅ **AC-US1-01**: Criteria description
+     * - ✅ **AC-US1-02**: Another criteria
+     *
+     * **Progress**: 8/11 tasks completed (73%)
+     *
+     * [View Living Docs](url)
+     */
+    buildCompletionComment(data) {
+        const lines = [];
+        lines.push('## Progress Update');
+        lines.push('');
+        // Completed tasks
+        const completedTasks = data.tasks.filter(t => t.completed);
+        if (completedTasks.length > 0) {
+            lines.push('### Completed Tasks');
+            lines.push('');
+            for (const task of completedTasks) {
+                lines.push(`- ✅ [${task.taskId}] ${task.title}`);
+            }
+            lines.push('');
+        }
+        // Acceptance criteria
+        const satisfiedACs = data.acceptanceCriteria.filter(ac => ac.satisfied);
+        if (satisfiedACs.length > 0) {
+            lines.push('### Acceptance Criteria');
+            lines.push('');
+            for (const ac of satisfiedACs) {
+                lines.push(`- ✅ **${ac.acId}**: ${ac.description}`);
+            }
+            lines.push('');
+        }
+        // Progress summary
+        const totalTasks = data.tasks.length;
+        const completed = completedTasks.length;
+        lines.push(`**Progress**: ${completed}/${totalTasks} tasks completed (${data.progressPercentage}%)`);
+        lines.push('');
+        // Living docs link
+        if (data.livingDocsUrl) {
+            lines.push(`[View Living Docs](${data.livingDocsUrl})`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Extract issue number from external_id
+     * Examples: "GH-#123" → 123, "#456" → 456
+     */
+    extractIssueNumber(externalId) {
+        const match = externalId.match(/#(\d+)/);
+        return match ? parseInt(match[1], 10) : 0;
+    }
+}
+//# sourceMappingURL=format-preservation-sync.js.map

package/dist/src/sync/format-preservation-sync.js.map

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

package/dist/src/sync/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Sync Module Exports
+ */
+export { FormatPreservationSyncService } from './format-preservation-sync.js';
+export { SyncCoordinator } from './sync-coordinator.js';
+export type { SyncConfig, CompletionCommentData } from './format-preservation-sync.js';
+export type { SyncCoordinatorOptions, SyncResult } from './sync-coordinator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/sync/index.js

@@ -0,0 +1,6 @@
+/**
+ * Sync Module Exports
+ */
+export { FormatPreservationSyncService } from './format-preservation-sync.js';
+export { SyncCoordinator } from './sync-coordinator.js';
+//# sourceMappingURL=index.js.map

package/dist/src/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/sync/sync-coordinator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Sync Coordinator (T-034E)
+ *
+ * High-level coordinator that integrates FormatPreservationSyncService
+ * with living docs sync workflow. Called by post-task-completion hook.
+ */
+import { Logger } from '../utils/logger.js';
+export interface SyncCoordinatorOptions {
+    projectRoot: string;
+    incrementId: string;
+    logger?: Logger;
+}
+export interface SyncResult {
+    success: boolean;
+    userStoriesSynced: number;
+    syncMode: 'comment-only' | 'full-sync' | 'read-only';
+    errors: string[];
+}
+export declare class SyncCoordinator {
+    private projectRoot;
+    private incrementId;
+    private logger;
+    constructor(options: SyncCoordinatorOptions);
+    /**
+     * Sync increment completion to external tools using format preservation
+     */
+    syncIncrementCompletion(): Promise<SyncResult>;
+    /**
+     * Sync individual user story
+     */
+    private syncUserStory;
+    /**
+     * Load completion data for user story
+     */
+    private loadCompletionData;
+    /**
+     * Load user stories affected by this increment
+     */
+    private loadUserStoriesForIncrement;
+    /**
+     * Load config
+     */
+    private loadConfig;
+    /**
+     * Detect GitHub repository from config or git
+     */
+    private detectGitHubRepo;
+}
+//# sourceMappingURL=sync-coordinator.d.ts.map

package/dist/src/sync/sync-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-coordinator.d.ts","sourceRoot":"","sources":["../../../src/sync/sync-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,sBAAsB;IAM3C;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,UAAU,CAAC;IA4EpD;;OAEG;YACW,aAAa;IA8B3B;;OAEG;YACW,kBAAkB;IAmEhC;;OAEG;YACW,2BAA2B;IAqEzC;;OAEG;YACW,UAAU;IAWxB;;OAEG;YACW,gBAAgB;CAyB/B"}