specweave 0.33.2 → 0.33.3

package/dist/plugins/specweave-github/lib/per-us-sync.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Per-US GitHub Sync (v0.34.0+)
+ *
+ * Syncs each User Story to its explicitly declared project's GitHub repo.
+ * Uses the **Project**: field in spec.md (NOT keyword-based classification).
+ *
+ * Key difference from multi-project-sync:
+ * - Multi-project sync uses keyword/heuristic classification
+ * - Per-US sync uses EXPLICIT **Project**: field from spec.md
+ *
+ * @module per-us-sync
+ * @since v0.34.0
+ */
+import type { UserStoryData } from '../../../src/core/living-docs/types.js';
+import type { ProjectMappings } from '../../../src/core/types/config.js';
+import type { USExternalRefsMap } from '../../../src/core/types/increment-metadata.js';
+import { Logger } from '../../../src/utils/logger.js';
+/**
+ * Result of syncing a single US to GitHub
+ */
+export interface USSyncResult {
+    usId: string;
+    projectId: string;
+    repo: string;
+    issueNumber: number;
+    url: string;
+    action: 'created' | 'updated' | 'skipped';
+    error?: string;
+}
+/**
+ * Result of syncing all USs in an increment
+ */
+export interface PerUSSyncResult {
+    success: boolean;
+    synced: USSyncResult[];
+    failed: USSyncResult[];
+    externalRefs: USExternalRefsMap;
+    summary: {
+        total: number;
+        created: number;
+        updated: number;
+        skipped: number;
+        failed: number;
+    };
+}
+/**
+ * Options for per-US sync
+ */
+export interface PerUSSyncOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    defaultProject?: string;
+    logger?: Logger;
+}
+/**
+ * Per-US GitHub Sync
+ *
+ * Syncs each US to its declared project's GitHub repository.
+ */
+export declare class PerUSGitHubSync {
+    private token;
+    private projectMappings;
+    private octokit;
+    private logger;
+    constructor(token: string, projectMappings: ProjectMappings, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Sync all user stories to their respective GitHub repos
+     *
+     * @param userStories - User stories with explicit project fields
+     * @param featureId - Feature ID (e.g., "FS-137")
+     * @param options - Sync options
+     */
+    syncUserStories(userStories: UserStoryData[], featureId: string, options?: PerUSSyncOptions): Promise<PerUSSyncResult>;
+    /**
+     * Sync a single user story to GitHub
+     */
+    private syncUserStory;
+    /**
+     * Find existing issue by US ID in title
+     */
+    private findExistingIssue;
+    /**
+     * Build issue body from user story
+     */
+    private buildIssueBody;
+    /**
+     * Group user stories by their explicit project field
+     */
+    private groupByProject;
+}
+/**
+ * Format per-US sync results for display
+ */
+export declare function formatPerUSSyncResults(result: PerUSSyncResult): string;
+//# sourceMappingURL=per-us-sync.d.ts.map

package/dist/plugins/specweave-github/lib/per-us-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-us-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/per-us-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,mCAAmC,CAAC;AACxF,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,EAAE,MAAM,EAAiB,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;gBAGrB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAQnC;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAsF3B;;OAEG;YACW,aAAa;IAmE3B;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoCtB;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmCtE"}

package/dist/plugins/specweave-github/lib/per-us-sync.js

@@ -0,0 +1,274 @@
+/**
+ * Per-US GitHub Sync (v0.34.0+)
+ *
+ * Syncs each User Story to its explicitly declared project's GitHub repo.
+ * Uses the **Project**: field in spec.md (NOT keyword-based classification).
+ *
+ * Key difference from multi-project-sync:
+ * - Multi-project sync uses keyword/heuristic classification
+ * - Per-US sync uses EXPLICIT **Project**: field from spec.md
+ *
+ * @module per-us-sync
+ * @since v0.34.0
+ */
+import { Octokit } from '@octokit/rest';
+import { consoleLogger } from '../../../src/utils/logger.js';
+/**
+ * Per-US GitHub Sync
+ *
+ * Syncs each US to its declared project's GitHub repository.
+ */
+export class PerUSGitHubSync {
+    constructor(token, projectMappings, options = {}) {
+        this.token = token;
+        this.projectMappings = projectMappings;
+        this.octokit = new Octokit({ auth: token });
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Sync all user stories to their respective GitHub repos
+     *
+     * @param userStories - User stories with explicit project fields
+     * @param featureId - Feature ID (e.g., "FS-137")
+     * @param options - Sync options
+     */
+    async syncUserStories(userStories, featureId, options = {}) {
+        const synced = [];
+        const failed = [];
+        const externalRefs = {};
+        // Group USs by their declared project
+        const groups = this.groupByProject(userStories, options.defaultProject);
+        this.logger.log(`📡 Per-US GitHub Sync: ${userStories.length} USs across ${groups.size} projects`);
+        for (const [projectId, stories] of groups) {
+            // Get GitHub mapping for this project
+            const mapping = this.projectMappings[projectId]?.github;
+            if (!mapping) {
+                // No GitHub mapping for this project
+                this.logger.warn(`   ⚠️  No GitHub mapping for project "${projectId}" - skipping ${stories.length} USs`);
+                for (const story of stories) {
+                    failed.push({
+                        usId: story.id,
+                        projectId,
+                        repo: 'N/A',
+                        issueNumber: 0,
+                        url: '',
+                        action: 'skipped',
+                        error: `No GitHub mapping for project "${projectId}"`
+                    });
+                }
+                continue;
+            }
+            // Sync each US to this project's repo
+            for (const story of stories) {
+                try {
+                    const result = await this.syncUserStory(story, mapping, featureId, options);
+                    synced.push({
+                        ...result,
+                        projectId
+                    });
+                    // Build external ref
+                    if (!options.dryRun && result.action !== 'skipped') {
+                        externalRefs[story.id] = {
+                            github: {
+                                provider: 'github',
+                                issueNumber: result.issueNumber,
+                                url: result.url,
+                                targetProject: projectId,
+                                lastSynced: new Date().toISOString()
+                            }
+                        };
+                    }
+                }
+                catch (error) {
+                    failed.push({
+                        usId: story.id,
+                        projectId,
+                        repo: `${mapping.owner}/${mapping.repo}`,
+                        issueNumber: 0,
+                        url: '',
+                        action: 'skipped',
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+        // Calculate summary
+        const created = synced.filter(r => r.action === 'created').length;
+        const updated = synced.filter(r => r.action === 'updated').length;
+        const skipped = synced.filter(r => r.action === 'skipped').length;
+        return {
+            success: failed.length === 0,
+            synced,
+            failed,
+            externalRefs,
+            summary: {
+                total: userStories.length,
+                created,
+                updated,
+                skipped,
+                failed: failed.length
+            }
+        };
+    }
+    /**
+     * Sync a single user story to GitHub
+     */
+    async syncUserStory(story, mapping, featureId, options) {
+        const title = `[${featureId}][${story.id}] ${story.title}`;
+        const body = this.buildIssueBody(story, featureId);
+        if (options.dryRun) {
+            this.logger.log(`   🔍 [DRY-RUN] Would sync ${story.id} to ${mapping.owner}/${mapping.repo}`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                repo: `${mapping.owner}/${mapping.repo}`,
+                issueNumber: 0,
+                url: '',
+                action: 'skipped'
+            };
+        }
+        // Check for existing issue
+        const existingIssue = await this.findExistingIssue(mapping, story.id);
+        if (existingIssue) {
+            // Update existing issue
+            const response = await this.octokit.issues.update({
+                owner: mapping.owner,
+                repo: mapping.repo,
+                issue_number: existingIssue.number,
+                title,
+                body
+            });
+            this.logger.log(`   🔄 Updated ${story.id} → ${mapping.owner}/${mapping.repo}#${response.data.number}`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                repo: `${mapping.owner}/${mapping.repo}`,
+                issueNumber: response.data.number,
+                url: response.data.html_url,
+                action: 'updated'
+            };
+        }
+        else {
+            // Create new issue
+            const response = await this.octokit.issues.create({
+                owner: mapping.owner,
+                repo: mapping.repo,
+                title,
+                body,
+                labels: ['specweave', 'user-story']
+            });
+            this.logger.log(`   ✅ Created ${story.id} → ${mapping.owner}/${mapping.repo}#${response.data.number}`);
+            return {
+                usId: story.id,
+                projectId: story.project || 'unknown',
+                repo: `${mapping.owner}/${mapping.repo}`,
+                issueNumber: response.data.number,
+                url: response.data.html_url,
+                action: 'created'
+            };
+        }
+    }
+    /**
+     * Find existing issue by US ID in title
+     */
+    async findExistingIssue(mapping, usId) {
+        try {
+            const response = await this.octokit.issues.listForRepo({
+                owner: mapping.owner,
+                repo: mapping.repo,
+                labels: 'specweave',
+                state: 'all',
+                per_page: 100
+            });
+            const existing = response.data.find(issue => issue.title.includes(`[${usId}]`));
+            return existing ? { number: existing.number } : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Build issue body from user story
+     */
+    buildIssueBody(story, featureId) {
+        const lines = [];
+        lines.push(`# ${story.title}`);
+        lines.push('');
+        if (story.description) {
+            lines.push(story.description);
+            lines.push('');
+        }
+        if (story.acceptanceCriteria && story.acceptanceCriteria.length > 0) {
+            lines.push('## Acceptance Criteria');
+            lines.push('');
+            for (const ac of story.acceptanceCriteria) {
+                lines.push(`- [ ] ${ac}`);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+        lines.push(`**Feature**: ${featureId}`);
+        lines.push(`**User Story**: ${story.id}`);
+        if (story.project) {
+            lines.push(`**Project**: ${story.project}`);
+        }
+        if (story.board) {
+            lines.push(`**Board**: ${story.board}`);
+        }
+        lines.push('');
+        lines.push('🤖 Auto-generated by SpecWeave');
+        return lines.join('\n');
+    }
+    /**
+     * Group user stories by their explicit project field
+     */
+    groupByProject(userStories, defaultProject) {
+        const groups = new Map();
+        for (const story of userStories) {
+            const project = story.project || defaultProject || 'default';
+            if (!groups.has(project)) {
+                groups.set(project, []);
+            }
+            groups.get(project).push(story);
+        }
+        return groups;
+    }
+}
+/**
+ * Format per-US sync results for display
+ */
+export function formatPerUSSyncResults(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('📊 Per-US GitHub Sync Results');
+    lines.push('');
+    // Group by project
+    const byProject = new Map();
+    for (const r of [...result.synced, ...result.failed]) {
+        const existing = byProject.get(r.projectId) || [];
+        existing.push(r);
+        byProject.set(r.projectId, existing);
+    }
+    for (const [projectId, results] of byProject) {
+        lines.push(`**${projectId}**:`);
+        for (const r of results) {
+            const icon = r.action === 'created' ? '✅' :
+                r.action === 'updated' ? '🔄' :
+                    r.error ? '❌' : '⏭️';
+            if (r.issueNumber > 0) {
+                lines.push(`  ${icon} ${r.usId} → ${r.repo}#${r.issueNumber}`);
+            }
+            else if (r.error) {
+                lines.push(`  ${icon} ${r.usId}: ${r.error}`);
+            }
+            else {
+                lines.push(`  ${icon} ${r.usId} (${r.action})`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push(`📈 Summary: ${result.summary.created} created, ${result.summary.updated} updated, ${result.summary.failed} failed`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=per-us-sync.js.map

package/dist/plugins/specweave-github/lib/per-us-sync.js.map

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

package/dist/plugins/specweave-jira/lib/per-us-sync.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Per-US JIRA Sync (v0.34.0+)
+ *
+ * Syncs each User Story to its explicitly declared project's JIRA project.
+ * Uses the **Project**: field in spec.md (NOT keyword-based classification).
+ *
+ * Key difference from multi-project-sync:
+ * - Multi-project sync uses keyword/heuristic classification
+ * - Per-US sync uses EXPLICIT **Project**: field from spec.md
+ *
+ * @module per-us-sync
+ * @since v0.34.0
+ */
+import type { UserStoryData } from '../../../src/core/living-docs/types.js';
+import type { ProjectMappings } from '../../../src/core/types/config.js';
+import type { USExternalRefsMap } from '../../../src/core/types/increment-metadata.js';
+import { Logger } from '../../../src/utils/logger.js';
+/**
+ * Result of syncing a single US to JIRA
+ */
+export interface USSyncResult {
+    usId: string;
+    projectId: string;
+    jiraProject: string;
+    issueKey: string;
+    url: string;
+    action: 'created' | 'updated' | 'skipped';
+    error?: string;
+}
+/**
+ * Result of syncing all USs in an increment
+ */
+export interface PerUSSyncResult {
+    success: boolean;
+    synced: USSyncResult[];
+    failed: USSyncResult[];
+    externalRefs: USExternalRefsMap;
+    summary: {
+        total: number;
+        created: number;
+        updated: number;
+        skipped: number;
+        failed: number;
+    };
+}
+/**
+ * Options for per-US sync
+ */
+export interface PerUSSyncOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    defaultProject?: string;
+    logger?: Logger;
+}
+/**
+ * JIRA client interface (to be injected)
+ */
+export interface JiraClient {
+    createIssue(project: string, issueType: string, summary: string, description: string): Promise<{
+        key: string;
+        self: string;
+    }>;
+    updateIssue(issueKey: string, summary: string, description: string): Promise<void>;
+    searchIssues(jql: string): Promise<Array<{
+        key: string;
+        fields: {
+            summary: string;
+        };
+    }>>;
+    getIssueUrl(issueKey: string): string;
+}
+/**
+ * Per-US JIRA Sync
+ *
+ * Syncs each US to its declared project's JIRA project.
+ */
+export declare class PerUSJiraSync {
+    private projectMappings;
+    private jiraClient;
+    private logger;
+    constructor(jiraClient: JiraClient, projectMappings: ProjectMappings, options?: {
+        logger?: Logger;
+    });
+    /**
+     * Sync all user stories to their respective JIRA projects
+     *
+     * @param userStories - User stories with explicit project fields
+     * @param featureId - Feature ID (e.g., "FS-137")
+     * @param options - Sync options
+     */
+    syncUserStories(userStories: UserStoryData[], featureId: string, options?: PerUSSyncOptions): Promise<PerUSSyncResult>;
+    /**
+     * Sync a single user story to JIRA
+     */
+    private syncUserStory;
+    /**
+     * Find existing issue by US ID in summary
+     */
+    private findExistingIssue;
+    /**
+     * Build issue description from user story
+     */
+    private buildIssueDescription;
+    /**
+     * Group user stories by their explicit project field
+     */
+    private groupByProject;
+}
+/**
+ * Format per-US sync results for display
+ */
+export declare function formatPerUSSyncResults(result: PerUSSyncResult): string;
+//# sourceMappingURL=per-us-sync.d.ts.map

package/dist/plugins/specweave-jira/lib/per-us-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-us-sync.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-jira/lib/per-us-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,mCAAmC,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,MAAM,EAAiB,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9H,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IACxF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAGrB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAOnC;;;;;;OAMG;IACG,eAAe,CACnB,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAsF3B;;OAEG;YACW,aAAa;IA4D3B;;OAEG;YACW,iBAAiB;IAc/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAmCtE"}