specweave 0.12.6 → 0.13.0

package/dist/plugins/specweave-github/lib/github-client-v2.js

@@ -0,0 +1,408 @@
+/**
+ * GitHub CLI Wrapper for SpecWeave (Multi-Project Support)
+ *
+ * Profile-based GitHub client that supports:
+ * - Multiple repositories via sync profiles
+ * - Time range filtering for syncs
+ * - Rate limiting protection
+ * - Secure command execution (no shell injection)
+ */
+import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+export class GitHubClientV2 {
+    /**
+     * Create GitHub client from sync profile
+     */
+    constructor(profile) {
+        if (profile.provider !== 'github') {
+            throw new Error(`Expected GitHub profile, got ${profile.provider}`);
+        }
+        const config = profile.config;
+        this.owner = config.owner;
+        this.repo = config.repo;
+        this.fullRepo = `${this.owner}/${this.repo}`;
+    }
+    /**
+     * Create client from owner/repo directly
+     */
+    static fromRepo(owner, repo) {
+        const profile = {
+            provider: 'github',
+            displayName: `${owner}/${repo}`,
+            config: { owner, repo },
+            timeRange: { default: '1M', max: '6M' },
+        };
+        return new GitHubClientV2(profile);
+    }
+    // ==========================================================================
+    // Authentication & Setup
+    // ==========================================================================
+    /**
+     * Check if GitHub CLI is installed and authenticated
+     */
+    static async checkCLI() {
+        // Check installation
+        const versionCheck = await execFileNoThrow('gh', ['--version']);
+        if (versionCheck.status !== 0) {
+            return {
+                installed: false,
+                authenticated: false,
+                error: 'GitHub CLI (gh) not installed. Install from: https://cli.github.com/',
+            };
+        }
+        // Check authentication
+        const authCheck = await execFileNoThrow('gh', ['auth', 'status']);
+        if (authCheck.status !== 0) {
+            return {
+                installed: true,
+                authenticated: false,
+                error: 'GitHub CLI not authenticated. Run: gh auth login',
+            };
+        }
+        return { installed: true, authenticated: true };
+    }
+    /**
+     * Auto-detect repository from git remote
+     */
+    static async detectRepo(cwd) {
+        const result = await execFileNoThrow('git', [
+            'remote',
+            'get-url',
+            'origin',
+        ], { cwd });
+        if (result.status !== 0) {
+            return null;
+        }
+        const remote = result.stdout.trim();
+        const match = remote.match(/github\.com[:/](.+)\/(.+?)(?:\.git)?$/);
+        if (!match) {
+            return null;
+        }
+        return {
+            owner: match[1],
+            repo: match[2],
+        };
+    }
+    // ==========================================================================
+    // Milestones
+    // ==========================================================================
+    /**
+     * Create or get existing milestone
+     */
+    async createOrGetMilestone(title, description, daysFromNow = 2) {
+        // Check if milestone already exists
+        const existing = await this.getMilestoneByTitle(title);
+        if (existing) {
+            return existing;
+        }
+        // Calculate due date
+        const dueDate = new Date();
+        dueDate.setDate(dueDate.getDate() + daysFromNow);
+        const dueDateISO = dueDate.toISOString();
+        // Build API request
+        const args = [
+            'api',
+            `repos/${this.fullRepo}/milestones`,
+            '-f',
+            `title=${title}`,
+            '-f',
+            `due_on=${dueDateISO}`,
+            '--jq',
+            '{number: .number, title: .title, description: .description, state: .state, due_on: .due_on}',
+        ];
+        if (description) {
+            args.splice(4, 0, '-f', `description=${description}`);
+        }
+        const result = await execFileNoThrow('gh', args);
+        if (result.status !== 0) {
+            throw new Error(`Failed to create milestone: ${result.stderr || result.stdout}`);
+        }
+        return JSON.parse(result.stdout);
+    }
+    /**
+     * Get milestone by title
+     */
+    async getMilestoneByTitle(title) {
+        const result = await execFileNoThrow('gh', [
+            'api',
+            `repos/${this.fullRepo}/milestones`,
+            '--jq',
+            `.[] | select(.title=="${title}") | {number: .number, title: .title, description: .description, state: .state}`,
+        ]);
+        if (result.status !== 0 || !result.stdout.trim()) {
+            return null;
+        }
+        return JSON.parse(result.stdout);
+    }
+    // ==========================================================================
+    // Issues
+    // ==========================================================================
+    /**
+     * Create epic issue (increment-level)
+     */
+    async createEpicIssue(title, body, milestone, labels = []) {
+        const args = [
+            'issue',
+            'create',
+            '--repo',
+            this.fullRepo,
+            '--title',
+            title,
+            '--body',
+            body,
+        ];
+        // Add labels
+        for (const label of labels) {
+            args.push('--label', label);
+        }
+        // Add milestone
+        if (milestone !== undefined) {
+            args.push('--milestone', String(milestone));
+        }
+        // Create issue (returns URL)
+        const createResult = await execFileNoThrow('gh', args);
+        if (createResult.status !== 0) {
+            throw new Error(`Failed to create epic issue: ${createResult.stderr || createResult.stdout}`);
+        }
+        const issueUrl = createResult.stdout.trim();
+        const issueNumber = parseInt(issueUrl.split('/').pop() || '0', 10);
+        if (!issueNumber) {
+            throw new Error(`Failed to extract issue number from URL: ${issueUrl}`);
+        }
+        // Fetch issue details
+        return await this.getIssue(issueNumber);
+    }
+    /**
+     * Create task issue (linked to epic)
+     */
+    async createTaskIssue(title, body, epicNumber, milestone, labels = []) {
+        // Add epic reference to body
+        const enhancedBody = `**Part of**: #${epicNumber}\n\n${body}`;
+        return await this.createEpicIssue(title, enhancedBody, milestone, labels);
+    }
+    /**
+     * Get issue details
+     */
+    async getIssue(issueNumber) {
+        const result = await execFileNoThrow('gh', [
+            'issue',
+            'view',
+            String(issueNumber),
+            '--repo',
+            this.fullRepo,
+            '--json',
+            'number,title,body,state,url,labels,milestone',
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to get issue #${issueNumber}: ${result.stderr || result.stdout}`);
+        }
+        const issue = JSON.parse(result.stdout);
+        return {
+            ...issue,
+            html_url: issue.url,
+            labels: issue.labels?.map((l) => l.name) || [],
+        };
+    }
+    /**
+     * Update issue body
+     */
+    async updateIssueBody(issueNumber, newBody) {
+        const result = await execFileNoThrow('gh', [
+            'issue',
+            'edit',
+            String(issueNumber),
+            '--repo',
+            this.fullRepo,
+            '--body',
+            newBody,
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to update issue #${issueNumber}: ${result.stderr || result.stdout}`);
+        }
+    }
+    /**
+     * Close issue
+     */
+    async closeIssue(issueNumber, comment) {
+        if (comment) {
+            await this.addComment(issueNumber, comment);
+        }
+        const result = await execFileNoThrow('gh', [
+            'issue',
+            'close',
+            String(issueNumber),
+            '--repo',
+            this.fullRepo,
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to close issue #${issueNumber}: ${result.stderr || result.stdout}`);
+        }
+    }
+    /**
+     * Add comment to issue
+     */
+    async addComment(issueNumber, comment) {
+        const result = await execFileNoThrow('gh', [
+            'issue',
+            'comment',
+            String(issueNumber),
+            '--repo',
+            this.fullRepo,
+            '--body',
+            comment,
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to add comment to issue #${issueNumber}: ${result.stderr || result.stdout}`);
+        }
+    }
+    /**
+     * Add labels to issue
+     */
+    async addLabels(issueNumber, labels) {
+        if (labels.length === 0)
+            return;
+        const args = [
+            'issue',
+            'edit',
+            String(issueNumber),
+            '--repo',
+            this.fullRepo,
+        ];
+        for (const label of labels) {
+            args.push('--add-label', label);
+        }
+        const result = await execFileNoThrow('gh', args);
+        if (result.status !== 0) {
+            throw new Error(`Failed to add labels to issue #${issueNumber}: ${result.stderr || result.stdout}`);
+        }
+    }
+    // ==========================================================================
+    // Time Range Filtering
+    // ==========================================================================
+    /**
+     * List issues within a time range
+     */
+    async listIssuesInTimeRange(timeRange, customStart, customEnd) {
+        const { since, until } = this.calculateTimeRange(timeRange, customStart, customEnd);
+        // GitHub search query
+        const query = `repo:${this.fullRepo} is:issue created:${since}..${until}`;
+        const result = await execFileNoThrow('gh', [
+            'search',
+            'issues',
+            query,
+            '--json',
+            'number,title,body,state,url,labels,milestone',
+            '--limit',
+            '1000', // Max results
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to list issues: ${result.stderr || result.stdout}`);
+        }
+        const issues = JSON.parse(result.stdout);
+        return issues.map((issue) => ({
+            ...issue,
+            html_url: issue.url,
+            labels: issue.labels?.map((l) => l.name) || [],
+        }));
+    }
+    /**
+     * Calculate date range from time range preset
+     */
+    calculateTimeRange(timeRange, customStart, customEnd) {
+        if (timeRange === 'ALL') {
+            return {
+                since: '1970-01-01',
+                until: new Date().toISOString().split('T')[0],
+            };
+        }
+        if (customStart) {
+            return {
+                since: customStart,
+                until: customEnd || new Date().toISOString().split('T')[0],
+            };
+        }
+        const now = new Date();
+        const since = new Date(now);
+        // Calculate date based on preset
+        switch (timeRange) {
+            case '1W':
+                since.setDate(now.getDate() - 7);
+                break;
+            case '2W':
+                since.setDate(now.getDate() - 14);
+                break;
+            case '1M':
+                since.setMonth(now.getMonth() - 1);
+                break;
+            case '3M':
+                since.setMonth(now.getMonth() - 3);
+                break;
+            case '6M':
+                since.setMonth(now.getMonth() - 6);
+                break;
+            case '1Y':
+                since.setFullYear(now.getFullYear() - 1);
+                break;
+        }
+        return {
+            since: since.toISOString().split('T')[0],
+            until: now.toISOString().split('T')[0],
+        };
+    }
+    // ==========================================================================
+    // Rate Limiting
+    // ==========================================================================
+    /**
+     * Check rate limit status
+     */
+    async checkRateLimit() {
+        const result = await execFileNoThrow('gh', [
+            'api',
+            'rate_limit',
+            '--jq',
+            '.rate | {remaining: .remaining, limit: .limit, reset: .reset}',
+        ]);
+        if (result.status !== 0) {
+            throw new Error(`Failed to check rate limit: ${result.stderr || result.stdout}`);
+        }
+        const data = JSON.parse(result.stdout);
+        return {
+            ...data,
+            reset: new Date(data.reset * 1000),
+        };
+    }
+    // ==========================================================================
+    // Batch Operations
+    // ==========================================================================
+    /**
+     * Batch create issues with rate limit handling
+     */
+    async batchCreateIssues(issues, milestone, epicNumber, options = {}) {
+        const { batchSize = 10, delayMs = 6000 } = options;
+        const createdIssues = [];
+        for (let i = 0; i < issues.length; i += batchSize) {
+            const batch = issues.slice(i, i + batchSize);
+            console.log(`Creating issues ${i + 1}-${Math.min(i + batchSize, issues.length)} of ${issues.length}...`);
+            for (const issue of batch) {
+                try {
+                    const created = epicNumber
+                        ? await this.createTaskIssue(issue.title, issue.body, epicNumber, milestone, issue.labels)
+                        : await this.createEpicIssue(issue.title, issue.body, milestone, issue.labels);
+                    createdIssues.push(created);
+                }
+                catch (error) {
+                    console.error(`Failed to create issue "${issue.title}":`, error.message);
+                }
+            }
+            // Delay between batches
+            if (i + batchSize < issues.length) {
+                console.log(`Waiting ${delayMs / 1000}s to avoid rate limits...`);
+                await this.sleep(delayMs);
+            }
+        }
+        return createdIssues;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=github-client-v2.js.map

package/dist/plugins/specweave-github/lib/github-client-v2.js.map

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

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

@@ -0,0 +1,96 @@
+/**
+ * GitHub CLI wrapper for SpecWeave
+ * Uses `gh` command for GitHub API operations
+ */
+import { GitHubIssue, GitHubMilestone } from './types';
+export declare class GitHubClient {
+    private repo;
+    constructor(repo?: string);
+    /**
+     * Auto-detect GitHub repository from git remote
+     */
+    private detectRepo;
+    /**
+     * Check if GitHub CLI is installed and authenticated
+     */
+    static checkGitHubCLI(): {
+        installed: boolean;
+        authenticated: boolean;
+        error?: string;
+    };
+    /**
+     * Create or get existing milestone
+     *
+     * @param title Milestone title
+     * @param description Milestone description
+     * @param daysFromNow Days until milestone due (default: 2 days - SpecWeave AI velocity)
+     */
+    createOrGetMilestone(title: string, description?: string, daysFromNow?: number): Promise<GitHubMilestone>;
+    /**
+     * Get milestone by title
+     */
+    private getMilestoneByTitle;
+    /**
+     * Create epic issue (increment-level)
+     */
+    createEpicIssue(title: string, body: string, milestone?: number | string, labels?: string[]): Promise<GitHubIssue>;
+    /**
+     * Create task issue (linked to epic)
+     */
+    createTaskIssue(title: string, body: string, epicNumber: number, milestone?: number | string, labels?: string[]): Promise<GitHubIssue>;
+    /**
+     * Update issue body
+     */
+    updateIssueBody(issueNumber: number, newBody: string): Promise<void>;
+    /**
+     * Get issue details
+     */
+    getIssue(issueNumber: number): Promise<GitHubIssue>;
+    /**
+     * Close issue
+     */
+    closeIssue(issueNumber: number, comment?: string): Promise<void>;
+    /**
+     * Add comment to issue
+     */
+    addComment(issueNumber: number, comment: string): Promise<void>;
+    /**
+     * Add labels to issue
+     */
+    addLabels(issueNumber: number, labels: string[]): Promise<void>;
+    /**
+     * Check rate limit status
+     */
+    checkRateLimit(): Promise<{
+        remaining: number;
+        limit: number;
+        reset: Date;
+    }>;
+    /**
+     * Escape quotes in strings for shell commands
+     */
+    private escapeQuotes;
+    /**
+     * Batch create issues with rate limit handling
+     */
+    batchCreateIssues(issues: Array<{
+        title: string;
+        body: string;
+        labels?: string[];
+    }>, milestone?: number | string, epicNumber?: number, options?: {
+        batchSize?: number;
+        delayMs?: number;
+    }): Promise<GitHubIssue[]>;
+    private sleep;
+    /**
+     * Get all repositories accessible to the user
+     * @param owner Optional: filter by specific owner/org (e.g., 'octocat', 'my-org')
+     * @param limit Maximum number of repos to fetch (default: 100, max: 1000)
+     */
+    static getRepositories(owner?: string, limit?: number): Promise<Array<{
+        owner: string;
+        name: string;
+        fullName: string;
+    }>>;
+}
+//# sourceMappingURL=github-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-client.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEvD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,CAAC,EAAE,MAAM;IAKzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAevF;;;;;;OAMG;IACG,oBAAoB,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,eAAe,CAAC;IAuB3B;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAgCvB;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,MAAM,GAAE,MAAM,EAAO,GACpB,OAAO,CAAC,WAAW,CAAC;IAmCvB;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E;;OAEG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAezD;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IActE;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAelF;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,EACjE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,OAAO,CAAC,WAAW,EAAE,CAAC;IA+BzB,OAAO,CAAC,KAAK;IAIb;;;;OAIG;WACU,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAsBnI"}