specweave 1.0.17 → 1.0.19

package/dist/src/sync/external-issue-auto-creator.d.ts

@@ -0,0 +1,156 @@
+/**
+ * External Issue Auto-Creator (v1.0.19)
+ *
+ * Automatically creates external issues (GitHub/JIRA/ADO) for increments
+ * when they don't have linked issues.
+ *
+ * TRIGGER POINTS:
+ * 1. After increment creation (post-increment-planning hook)
+ * 2. During sync-progress if issue is missing
+ * 3. On status change (active → completed)
+ *
+ * SAFETY FEATURES:
+ * - 3-layer idempotency (frontmatter → metadata → API)
+ * - Duplicate detection before creation
+ * - Rate limiting (circuit breaker)
+ * - Non-blocking (failures don't crash the workflow)
+ *
+ * @see ADR-0139 (Unified Post-Increment GitHub Sync)
+ */
+import { Logger } from '../utils/logger.js';
+export interface ExternalIssueAutoCreatorOptions {
+    projectRoot: string;
+    logger?: Logger;
+}
+export interface AutoCreateResult {
+    success: boolean;
+    provider: 'github' | 'jira' | 'ado' | 'none';
+    issueNumber?: number | string;
+    issueUrl?: string;
+    error?: string;
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface IncrementInfo {
+    id: string;
+    featureId: string;
+    title: string;
+    status: string;
+    userStories: Array<{
+        id: string;
+        title: string;
+        project?: string;
+    }>;
+}
+/**
+ * Auto-creates external issues for increments
+ *
+ * Usage:
+ * ```typescript
+ * const creator = new ExternalIssueAutoCreator({ projectRoot: process.cwd() });
+ * const result = await creator.createForIncrement('0001-feature');
+ * ```
+ */
+export declare class ExternalIssueAutoCreator {
+    private projectRoot;
+    private logger;
+    private configManager;
+    constructor(options: ExternalIssueAutoCreatorOptions);
+    /**
+     * Create external issues for an increment (if configured and not already created)
+     *
+     * This method:
+     * 1. Checks if auto-create is enabled in config
+     * 2. Detects which provider to use (GitHub/JIRA/ADO)
+     * 3. Checks if issues already exist (3-layer idempotency)
+     * 4. Creates issues if missing
+     * 5. Updates metadata with issue links
+     */
+    createForIncrement(incrementId: string): Promise<AutoCreateResult>;
+    /**
+     * Check if auto-create is enabled in config
+     *
+     * Checks (in order):
+     * 1. sync.autoCreateOnIncrement (new, explicit)
+     * 2. sync.autoSync (legacy)
+     * 3. sync.settings.canUpsertInternalItems (legacy)
+     */
+    private isAutoCreateEnabled;
+    /**
+     * Detect which provider to use for external sync
+     *
+     * Priority:
+     * 1. GitHub (if sync.github.enabled = true)
+     * 2. JIRA (if sync.jira.enabled = true)
+     * 3. ADO (if sync.ado.enabled = true)
+     * 4. GitHub (if issueTracker.provider = 'github')
+     * 5. JIRA (if issueTracker.provider = 'jira')
+     * 6. ADO (if issueTracker.provider = 'ado')
+     */
+    private detectProvider;
+    /**
+     * Load increment information from spec.md and metadata.json
+     */
+    private loadIncrementInfo;
+    /**
+     * Parse user stories from spec.md body
+     */
+    private parseUserStories;
+    /**
+     * Check if increment already has external issue linked
+     *
+     * Checks:
+     * 1. metadata.json github/jira/ado fields
+     * 2. spec.md frontmatter external links
+     */
+    private checkExistingIssue;
+    /**
+     * Create GitHub issues for the increment
+     */
+    private createGitHubIssues;
+    /**
+     * Create JIRA issues for the increment
+     */
+    private createJiraIssues;
+    /**
+     * Create Azure DevOps work items for the increment
+     */
+    private createAdoIssues;
+    /**
+     * Detect GitHub repo from config
+     */
+    private detectGitHubRepo;
+    /**
+     * Build GitHub issue body for a user story
+     */
+    private buildGitHubIssueBody;
+    /**
+     * Build GitHub issue body for feature-level issue
+     */
+    private buildFeatureLevelIssueBody;
+    /**
+     * Build JIRA Epic description
+     */
+    private buildJiraEpicDescription;
+    /**
+     * Build ADO work item description
+     */
+    private buildAdoDescription;
+    /**
+     * Update metadata.json with GitHub issue
+     */
+    private updateMetadataWithGitHubIssue;
+    /**
+     * Update metadata.json with JIRA issue
+     */
+    private updateMetadataWithJiraIssue;
+    /**
+     * Update metadata.json with ADO work item
+     */
+    private updateMetadataWithAdoWorkItem;
+}
+/**
+ * Convenience function to auto-create issues for an increment
+ */
+export declare function autoCreateExternalIssue(projectRoot: string, incrementId: string, logger?: Logger): Promise<AutoCreateResult>;
+//# sourceMappingURL=external-issue-auto-creator.d.ts.map

package/dist/src/sync/external-issue-auto-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-issue-auto-creator.d.ts","sourceRoot":"","sources":["../../../src/sync/external-issue-auto-creator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,oBAAoB,CAAC;AAK3D,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,EAAE,+BAA+B;IAMpD;;;;;;;;;OASG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2ExE;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;YACW,iBAAiB;IAyD/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;;;;;OAMG;YACW,kBAAkB;IAmDhC;;OAEG;YACW,kBAAkB;IAqGhC;;OAEG;YACW,gBAAgB;IA0D9B;;OAEG;YACW,eAAe;IAoE7B;;OAEG;YACW,gBAAgB;IAqD9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4BlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;YACW,6BAA6B;IA0B3C;;OAEG;YACW,2BAA2B;IA0BzC;;OAEG;YACW,6BAA6B;CAyB5C;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}