specweave 1.0.506 → 1.0.508

package/dist/plugins/specweave/lib/integrations/ado/ado-spec-sync.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Azure DevOps Spec Sync
+ *
+ * CORRECT ARCHITECTURE:
+ * - Syncs .specweave/docs/internal/specs/spec-*.md ↔ ADO Features
+ * - NOT increments ↔ ADO Work Items (that was wrong!)
+ *
+ * Mapping:
+ * - Spec → ADO Feature
+ * - User Story → ADO User Story (child of feature)
+ * - Acceptance Criteria → Checklist in User Story description
+ *
+ * @module ado-spec-sync
+ */
+import { SpecSyncResult } from '../../../../../src/core/types/spec-metadata.js';
+import { SyncCircuitBreaker } from '../../../../../src/core/increment/sync-circuit-breaker.js';
+export interface AdoFeature {
+    id: number;
+    url: string;
+    fields: {
+        'System.Title': string;
+        'System.Description': string;
+        'System.State': string;
+        'System.Tags': string;
+    };
+}
+export interface AdoUserStory {
+    id: number;
+    url: string;
+    fields: {
+        'System.Title': string;
+        'System.Description': string;
+        'System.State': string;
+        'System.Parent': number;
+        'System.Tags': string;
+    };
+}
+export interface AdoConfig {
+    organization: string;
+    project: string;
+    personalAccessToken: string;
+}
+export declare class AdoSpecSync {
+    private specManager;
+    private client;
+    private config;
+    private projectRoot;
+    private availableTypes;
+    private breaker;
+    constructor(config: AdoConfig, projectRoot?: string, projectId?: string, breaker?: SyncCircuitBreaker);
+    /**
+     * Detect available work item types for this ADO project.
+     * Basic process has Epic/Issue/Task; Agile/Scrum has Feature/User Story/Bug/Task.
+     */
+    private detectAvailableTypes;
+    /**
+     * Resolve a work item type, falling back if not available in the project.
+     * Feature → Epic (Basic process), User Story → Issue (Basic process)
+     */
+    private resolveWorkItemType;
+    /**
+     * Resolve a work item state name for the given type.
+     * Basic process (Issue type) uses: "To Do", "Doing", "Done"
+     * Agile/Scrum process uses: "New", "Active", "Closed" / "Resolved" / "Done"
+     *
+     * Maps canonical states: 'New' → todo, 'Active' → in-progress, 'Closed' → done
+     */
+    private stateCache;
+    private resolveWorkItemState;
+    /**
+     * Sync spec to ADO Feature (CREATE or UPDATE)
+     */
+    syncSpecToAdo(specId: string): Promise<SpecSyncResult>;
+    /**
+     * Sync FROM ADO Feature to spec (bidirectional)
+     */
+    syncFromAdo(specId: string): Promise<SpecSyncResult>;
+    /**
+     * Create new ADO Feature for spec
+     */
+    private createAdoFeature;
+    /**
+     * Update existing ADO Feature (conditional — only writes changed fields)
+     */
+    private updateAdoFeature;
+    /**
+     * Sync user stories as ADO User Stories
+     */
+    private syncUserStories;
+    /**
+     * Write ADO work item ID back to living doc US file frontmatter.
+     */
+    private writeAdoIdToUSFile;
+    /**
+     * Generate feature description from spec
+     */
+    private generateFeatureDescription;
+    /**
+     * Generate story description from user story
+     */
+    private generateStoryDescription;
+    /**
+     * Detect conflicts between spec and ADO
+     */
+    private detectConflicts;
+    /**
+     * Resolve conflicts
+     */
+    private resolveConflicts;
+    /**
+     * Fetch ADO Feature details
+     */
+    private fetchAdoFeature;
+    /**
+     * Find story by title pattern
+     */
+    private findStoryByTitle;
+    /**
+     * Create ADO User Story
+     */
+    private createStory;
+    /**
+     * Update ADO User Story
+     */
+    private updateStory;
+    /**
+     * Map SpecWeave priority to ADO priority value
+     *
+     * ADO Priority field uses 1-4 scale:
+     * - 1 = Highest (P0)
+     * - 2 = High (P1)
+     * - 3 = Medium (P2)
+     * - 4 = Low (P3)
+     */
+    private mapPriorityToAdo;
+    /**
+     * Map SpecWeave type to ADO work item type
+     *
+     * Supports: Feature, User Story, Bug, Task
+     */
+    private mapTypeToAdo;
+    /**
+     * Check whether the circuit is closed (sync allowed).
+     */
+    canSync(): boolean;
+}
+//# sourceMappingURL=ado-spec-sync.d.ts.map

package/dist/plugins/specweave/lib/integrations/ado/ado-spec-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-spec-sync.d.ts","sourceRoot":"","sources":["../../../../../../plugins/specweave/lib/integrations/ado/ado-spec-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAGL,cAAc,EAEf,MAAM,gDAAgD,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2DAA2D,CAAC;AAQ/F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,SAAS,EAAE,WAAW,GAAE,MAAsB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAsBpH;;;OAGG;YACW,oBAAoB;IAYlC;;;OAGG;YACW,mBAAmB;IAiBjC;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAAkC;YACtC,oBAAoB;IA+BlC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwE5D;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA+E1D;;OAEG;YACW,gBAAgB;IAqD9B;;OAEG;YACW,gBAAgB;IAkD9B;;OAEG;YACW,eAAe;IA4E7B;;OAEG;YACW,kBAAkB;IAqChC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4BlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,eAAe;IAW7B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,WAAW;IAiEzB;;OAEG;YACW,WAAW;IA2DzB;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,IAAI,OAAO;CAGnB"}