specweave 0.21.3 → 0.22.0

package/dist/plugins/specweave-github/lib/ThreeLayerSyncManager.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Three-Layer Bidirectional Sync Manager
+ *
+ * Handles synchronization across three layers:
+ * - Layer 1: GitHub Issue (stakeholder UI)
+ * - Layer 2: Living Docs User Story files (intermediate representation)
+ * - Layer 3: Increment spec.md + tasks.md (source of truth)
+ *
+ * Supports two sync flows:
+ * 1. GitHub → Living Docs → Increment (stakeholder checks checkbox)
+ * 2. Increment → Living Docs → GitHub (developer completes work)
+ *
+ * Features:
+ * - Code validation (reopen tasks if code doesn't exist)
+ * - Completion propagation (Tasks → ACs → User Stories)
+ * - Conflict resolution (Increment always wins)
+ *
+ * @module ThreeLayerSyncManager
+ */
+/**
+ * Acceptance Criterion with completion state
+ */
+export interface AcceptanceCriterion {
+    id: string;
+    userStoryId: string;
+    description: string;
+    completed: boolean;
+    projects: string[];
+    rawLine: string;
+}
+/**
+ * Task with completion state and AC references
+ */
+export interface Task {
+    id: string;
+    title: string;
+    completed: boolean;
+    completedDate?: string;
+    acIds: string[];
+    filePaths?: string[];
+}
+/**
+ * Change detected during sync
+ */
+export interface SyncChange {
+    type: 'ac' | 'task';
+    id: string;
+    completed: boolean;
+    layer: 'github' | 'living-docs' | 'increment';
+    userStoryPath?: string;
+    incrementPath?: string;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    acsUpdated: number;
+    tasksUpdated: number;
+    tasksReopened: number;
+    conflicts: string[];
+    errors: string[];
+}
+export declare class ThreeLayerSyncManager {
+    private codeValidator;
+    private userStoryFileCache;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Clear User Story file cache
+     * Call this when file structure changes or for testing
+     */
+    clearCache(): void;
+    /**
+     * Sync from GitHub to Increment (Flow 1: GitHub → Living Docs → Increment)
+     *
+     * Triggered when stakeholder checks AC/Task checkbox in GitHub issue.
+     */
+    syncGitHubToIncrement(issueNumber: number, incrementPath: string, livingDocsPath: string): Promise<SyncResult>;
+    /**
+     * Sync from Increment to GitHub (Flow 2: Increment → Living Docs → GitHub)
+     *
+     * Triggered when developer completes work and updates increment files.
+     */
+    syncIncrementToGitHub(incrementPath: string, livingDocsPath: string, issueNumber: number): Promise<SyncResult>;
+    /**
+     * Validate that code exists for completed task
+     * Uses CodeValidator for comprehensive validation
+     */
+    private validateCodeExists;
+    /**
+     * Reopen task if code validation fails
+     */
+    private reopenTask;
+    /**
+     * Propagate completion from Tasks → ACs → User Stories (bottom-up)
+     */
+    propagateCompletion(incrementPath: string, livingDocsPath: string): Promise<void>;
+    /**
+     * Fetch GitHub issue state
+     */
+    private fetchGitHubIssueState;
+    /**
+     * Extract ACs from GitHub issue body
+     */
+    private extractAcsFromIssue;
+    /**
+     * Extract Tasks from GitHub issue body
+     */
+    private extractTasksFromIssue;
+    /**
+     * Parse ACs from spec.md
+     */
+    private parseAcceptanceCriteria;
+    /**
+     * Parse Tasks from tasks.md
+     */
+    private parseTasks;
+    /**
+     * Group ACs by User Story ID
+     */
+    private groupAcsByUserStory;
+    /**
+     * Filter tasks by AC IDs
+     */
+    private filterTasksByAcIds;
+    /**
+     * Find User Story file by ID (with caching for performance)
+     */
+    private findUserStoryFile;
+    /**
+     * Find User Story file that contains specific task
+     */
+    private findUserStoryFileForTask;
+    /**
+     * Update AC in User Story file
+     */
+    private updateUserStoryAc;
+    /**
+     * Update Task in User Story file
+     */
+    private updateUserStoryTask;
+    /**
+     * Update multiple ACs in User Story file
+     */
+    private updateUserStoryAcs;
+    /**
+     * Update multiple Tasks in User Story file
+     */
+    private updateUserStoryTasks;
+    /**
+     * Update AC in increment spec.md
+     */
+    private updateIncrementAc;
+    /**
+     * Update multiple ACs in increment spec.md
+     */
+    private updateIncrementAcs;
+    /**
+     * Update multiple Tasks in increment tasks.md
+     */
+    private updateIncrementTasks;
+    /**
+     * Update ACs in increment with conflict resolution (Increment wins)
+     *
+     * If GitHub and Increment disagree, Increment state wins as it's the source of truth.
+     * Conflicts are logged for transparency.
+     */
+    private updateIncrementAcsWithConflictResolution;
+    /**
+     * Update Tasks in increment with conflict resolution (Increment wins)
+     */
+    private updateIncrementTasksWithConflictResolution;
+    /**
+     * Update GitHub issue with ACs and Tasks
+     */
+    private updateGitHubIssue;
+    /**
+     * Add comment to GitHub issue
+     */
+    private addGitHubComment;
+}
+//# sourceMappingURL=ThreeLayerSyncManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreeLayerSyncManager.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/ThreeLayerSyncManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAK/C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACG,qBAAqB,CACzB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,UAAU,CAAC;IAuEtB;;;;OAIG;IACG,qBAAqB,CACzB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC;IAuDtB;;;OAGG;YACW,kBAAkB;IAMhC;;OAEG;YACW,UAAU;IA6BxB;;OAEG;IACG,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IA4ChB;;OAEG;YACW,qBAAqB;IAgBnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,UAAU;IA6ClB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;YACW,wBAAwB;IAgBtC;;OAEG;YACW,iBAAiB;IAW/B;;OAEG;YACW,mBAAmB;IAWjC;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,oBAAoB;IAYlC;;OAEG;YACW,iBAAiB;IAW/B;;OAEG;YACW,kBAAkB;IAahC;;OAEG;YACW,oBAAoB;IAqBlC;;;;;OAKG;YACW,wCAAwC;IAmCtD;;OAEG;YACW,0CAA0C;IAyCxD;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;YACW,gBAAgB;CAS/B"}