specweave 0.17.0 → 0.17.1

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

@@ -1,265 +1,299 @@
-import { execSync } from "child_process";
-class GitHubClient {
-  constructor(repo) {
-    this.repo = repo || this.detectRepo();
-  }
-  /**
-   * Auto-detect GitHub repository from git remote
-   */
-  detectRepo() {
-    try {
-      const remote = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
-      const match = remote.match(/github\.com[:/](.+\/.+?)(?:\.git)?$/);
-      if (!match) {
-        throw new Error("Could not detect GitHub repository from git remote");
-      }
-      return match[1];
-    } catch (error) {
-      throw new Error("Not a git repository or no GitHub remote configured");
+/**
+ * GitHub CLI wrapper for SpecWeave
+ * Uses `gh` command for GitHub API operations
+ */
+import { execSync } from 'child_process';
+export class GitHubClient {
+    constructor(repo) {
+        // Auto-detect repo from git remote if not provided
+        this.repo = repo || this.detectRepo();
     }
-  }
-  /**
-   * Check if GitHub CLI is installed and authenticated
-   */
-  static checkGitHubCLI() {
-    try {
-      execSync("gh --version", { encoding: "utf-8", stdio: "pipe" });
-    } catch {
-      return { installed: false, authenticated: false, error: "GitHub CLI (gh) not installed" };
+    /**
+     * Auto-detect GitHub repository from git remote
+     */
+    detectRepo() {
+        try {
+            const remote = execSync('git remote get-url origin', { encoding: 'utf-8' }).trim();
+            const match = remote.match(/github\.com[:/](.+\/.+?)(?:\.git)?$/);
+            if (!match) {
+                throw new Error('Could not detect GitHub repository from git remote');
+            }
+            return match[1];
+        }
+        catch (error) {
+            throw new Error('Not a git repository or no GitHub remote configured');
+        }
     }
-    try {
-      execSync("gh auth status", { encoding: "utf-8", stdio: "pipe" });
-      return { installed: true, authenticated: true };
-    } catch {
-      return { installed: true, authenticated: false, error: "GitHub CLI not authenticated. Run: gh auth login" };
+    /**
+     * Check if GitHub CLI is installed and authenticated
+     */
+    static checkGitHubCLI() {
+        try {
+            execSync('gh --version', { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            return { installed: false, authenticated: false, error: 'GitHub CLI (gh) not installed' };
+        }
+        try {
+            execSync('gh auth status', { encoding: 'utf-8', stdio: 'pipe' });
+            return { installed: true, authenticated: true };
+        }
+        catch {
+            return { installed: true, authenticated: false, error: 'GitHub CLI not authenticated. Run: gh auth login' };
+        }
     }
-  }
-  /**
-   * 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)
-   */
-  async createOrGetMilestone(title, description, daysFromNow = 2) {
-    const existing = await this.getMilestoneByTitle(title);
-    if (existing) {
-      return existing;
+    /**
+     * 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)
+     */
+    async createOrGetMilestone(title, description, daysFromNow = 2) {
+        // Check if milestone already exists
+        const existing = await this.getMilestoneByTitle(title);
+        if (existing) {
+            return existing;
+        }
+        // Calculate due date (SpecWeave default: 1-2 days with AI assistance)
+        const dueDate = new Date();
+        dueDate.setDate(dueDate.getDate() + daysFromNow);
+        const dueDateISO = dueDate.toISOString();
+        // Create new milestone with due date
+        const cmd = `gh api repos/${this.repo}/milestones -f title="${title}" ${description ? `-f description="${description}"` : ''} -f due_on="${dueDateISO}" --jq '{number: .number, title: .title, description: .description, state: .state, due_on: .due_on}'`;
+        try {
+            const output = execSync(cmd, { encoding: 'utf-8' });
+            return JSON.parse(output);
+        }
+        catch (error) {
+            throw new Error(`Failed to create milestone: ${error.message}`);
+        }
     }
-    const dueDate = /* @__PURE__ */ new Date();
-    dueDate.setDate(dueDate.getDate() + daysFromNow);
-    const dueDateISO = dueDate.toISOString();
-    const cmd = `gh api repos/${this.repo}/milestones -f title="${title}" ${description ? `-f description="${description}"` : ""} -f due_on="${dueDateISO}" --jq '{number: .number, title: .title, description: .description, state: .state, due_on: .due_on}'`;
-    try {
-      const output = execSync(cmd, { encoding: "utf-8" });
-      return JSON.parse(output);
-    } catch (error) {
-      throw new Error(`Failed to create milestone: ${error.message}`);
+    /**
+     * Get milestone by title
+     */
+    async getMilestoneByTitle(title) {
+        try {
+            const cmd = `gh api repos/${this.repo}/milestones --jq '.[] | select(.title=="${title}") | {number: .number, title: .title, description: .description, state: .state}'`;
+            const output = execSync(cmd, { encoding: 'utf-8' }).trim();
+            return output ? JSON.parse(output) : null;
+        }
+        catch {
+            return null;
+        }
     }
-  }
-  /**
-   * Get milestone by title
-   */
-  async getMilestoneByTitle(title) {
-    try {
-      const cmd = `gh api repos/${this.repo}/milestones --jq '.[] | select(.title=="${title}") | {number: .number, title: .title, description: .description, state: .state}'`;
-      const output = execSync(cmd, { encoding: "utf-8" }).trim();
-      return output ? JSON.parse(output) : null;
-    } catch {
-      return null;
+    /**
+     * Create epic issue (increment-level)
+     */
+    async createEpicIssue(title, body, milestone, labels = []) {
+        const labelArgs = labels.map(l => `-l "${l}"`).join(' ');
+        const milestoneArg = milestone ? `-m "${milestone}"` : '';
+        // Create issue (returns URL)
+        const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(body)}" ${labelArgs} ${milestoneArg}`;
+        try {
+            const issueUrl = execSync(createCmd, { encoding: 'utf-8' }).trim();
+            // Extract issue number from URL (e.g., https://github.com/owner/repo/issues/123)
+            const issueNumber = parseInt(issueUrl.split('/').pop() || '0', 10);
+            if (!issueNumber) {
+                throw new Error('Failed to extract issue number from URL: ' + issueUrl);
+            }
+            // Fetch issue details
+            const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
+            const output = execSync(viewCmd, { encoding: 'utf-8' });
+            const issue = JSON.parse(output);
+            return {
+                ...issue,
+                html_url: issue.url,
+                labels: issue.labels?.map((l) => l.name) || []
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to create epic issue: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Create epic issue (increment-level)
-   */
-  async createEpicIssue(title, body, milestone, labels = []) {
-    const labelArgs = labels.map((l) => `-l "${l}"`).join(" ");
-    const milestoneArg = milestone ? `-m "${milestone}"` : "";
-    const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(body)}" ${labelArgs} ${milestoneArg}`;
-    try {
-      const issueUrl = execSync(createCmd, { encoding: "utf-8" }).trim();
-      const issueNumber = parseInt(issueUrl.split("/").pop() || "0", 10);
-      if (!issueNumber) {
-        throw new Error("Failed to extract issue number from URL: " + issueUrl);
-      }
-      const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
-      const output = execSync(viewCmd, { encoding: "utf-8" });
-      const issue = JSON.parse(output);
-      return {
-        ...issue,
-        html_url: issue.url,
-        labels: issue.labels?.map((l) => l.name) || []
-      };
-    } catch (error) {
-      throw new Error(`Failed to create epic issue: ${error.message}`);
+    /**
+     * 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}`;
+        const labelArgs = labels.map(l => `-l "${l}"`).join(' ');
+        const milestoneArg = milestone ? `-m "${milestone}"` : '';
+        // Create issue (returns URL)
+        const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(enhancedBody)}" ${labelArgs} ${milestoneArg}`;
+        try {
+            const issueUrl = execSync(createCmd, { encoding: 'utf-8' }).trim();
+            // Extract issue number from URL
+            const issueNumber = parseInt(issueUrl.split('/').pop() || '0', 10);
+            if (!issueNumber) {
+                throw new Error('Failed to extract issue number from URL: ' + issueUrl);
+            }
+            // Fetch issue details
+            const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
+            const output = execSync(viewCmd, { encoding: 'utf-8' });
+            const issue = JSON.parse(output);
+            return {
+                ...issue,
+                html_url: issue.url,
+                labels: issue.labels?.map((l) => l.name) || []
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to create task issue: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Create task issue (linked to epic)
-   */
-  async createTaskIssue(title, body, epicNumber, milestone, labels = []) {
-    const enhancedBody = `**Part of**: #${epicNumber}
-
-${body}`;
-    const labelArgs = labels.map((l) => `-l "${l}"`).join(" ");
-    const milestoneArg = milestone ? `-m "${milestone}"` : "";
-    const createCmd = `gh issue create --repo ${this.repo} --title "${this.escapeQuotes(title)}" --body "${this.escapeQuotes(enhancedBody)}" ${labelArgs} ${milestoneArg}`;
-    try {
-      const issueUrl = execSync(createCmd, { encoding: "utf-8" }).trim();
-      const issueNumber = parseInt(issueUrl.split("/").pop() || "0", 10);
-      if (!issueNumber) {
-        throw new Error("Failed to extract issue number from URL: " + issueUrl);
-      }
-      const viewCmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,url,labels,milestone`;
-      const output = execSync(viewCmd, { encoding: "utf-8" });
-      const issue = JSON.parse(output);
-      return {
-        ...issue,
-        html_url: issue.url,
-        labels: issue.labels?.map((l) => l.name) || []
-      };
-    } catch (error) {
-      throw new Error(`Failed to create task issue: ${error.message}`);
+    /**
+     * Update issue body
+     */
+    async updateIssueBody(issueNumber, newBody) {
+        const cmd = `gh issue edit ${issueNumber} --repo ${this.repo} --body "${this.escapeQuotes(newBody)}"`;
+        try {
+            execSync(cmd, { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to update issue #${issueNumber}: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Update issue body
-   */
-  async updateIssueBody(issueNumber, newBody) {
-    const cmd = `gh issue edit ${issueNumber} --repo ${this.repo} --body "${this.escapeQuotes(newBody)}"`;
-    try {
-      execSync(cmd, { encoding: "utf-8", stdio: "pipe" });
-    } catch (error) {
-      throw new Error(`Failed to update issue #${issueNumber}: ${error.message}`);
+    /**
+     * Get issue details
+     */
+    async getIssue(issueNumber) {
+        const cmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,html_url,labels,milestone`;
+        try {
+            const output = execSync(cmd, { encoding: 'utf-8' });
+            const issue = JSON.parse(output);
+            return {
+                ...issue,
+                labels: issue.labels?.map((l) => l.name) || []
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get issue #${issueNumber}: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Get issue details
-   */
-  async getIssue(issueNumber) {
-    const cmd = `gh issue view ${issueNumber} --repo ${this.repo} --json number,title,body,state,html_url,labels,milestone`;
-    try {
-      const output = execSync(cmd, { encoding: "utf-8" });
-      const issue = JSON.parse(output);
-      return {
-        ...issue,
-        labels: issue.labels?.map((l) => l.name) || []
-      };
-    } catch (error) {
-      throw new Error(`Failed to get issue #${issueNumber}: ${error.message}`);
+    /**
+     * Close issue
+     */
+    async closeIssue(issueNumber, comment) {
+        if (comment) {
+            await this.addComment(issueNumber, comment);
+        }
+        const cmd = `gh issue close ${issueNumber} --repo ${this.repo}`;
+        try {
+            execSync(cmd, { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to close issue #${issueNumber}: ${error.message}`);
+        }
+    }
+    /**
+     * Add comment to issue
+     */
+    async addComment(issueNumber, comment) {
+        const cmd = `gh issue comment ${issueNumber} --repo ${this.repo} --body "${this.escapeQuotes(comment)}"`;
+        try {
+            execSync(cmd, { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to add comment to issue #${issueNumber}: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Close issue
-   */
-  async closeIssue(issueNumber, comment) {
-    if (comment) {
-      await this.addComment(issueNumber, comment);
+    /**
+     * Add labels to issue
+     */
+    async addLabels(issueNumber, labels) {
+        if (labels.length === 0)
+            return;
+        const labelArgs = labels.map(l => `"${l}"`).join(',');
+        const cmd = `gh issue edit ${issueNumber} --repo ${this.repo} --add-label ${labelArgs}`;
+        try {
+            execSync(cmd, { encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch (error) {
+            throw new Error(`Failed to add labels to issue #${issueNumber}: ${error.message}`);
+        }
     }
-    const cmd = `gh issue close ${issueNumber} --repo ${this.repo}`;
-    try {
-      execSync(cmd, { encoding: "utf-8", stdio: "pipe" });
-    } catch (error) {
-      throw new Error(`Failed to close issue #${issueNumber}: ${error.message}`);
+    /**
+     * Check rate limit status
+     */
+    async checkRateLimit() {
+        const cmd = `gh api rate_limit --jq '.rate | {remaining: .remaining, limit: .limit, reset: .reset}'`;
+        try {
+            const output = execSync(cmd, { encoding: 'utf-8' });
+            const data = JSON.parse(output);
+            return {
+                ...data,
+                reset: new Date(data.reset * 1000)
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to check rate limit: ${error.message}`);
+        }
     }
-  }
-  /**
-   * Add comment to issue
-   */
-  async addComment(issueNumber, comment) {
-    const cmd = `gh issue comment ${issueNumber} --repo ${this.repo} --body "${this.escapeQuotes(comment)}"`;
-    try {
-      execSync(cmd, { encoding: "utf-8", stdio: "pipe" });
-    } catch (error) {
-      throw new Error(`Failed to add comment to issue #${issueNumber}: ${error.message}`);
+    /**
+     * Escape quotes in strings for shell commands
+     */
+    escapeQuotes(str) {
+        return str
+            .replace(/\\/g, '\\\\') // Escape backslashes first
+            .replace(/"/g, '\\"') // Escape double quotes
+            .replace(/`/g, '\\`') // Escape backticks
+            .replace(/\$/g, '\\$'); // Escape dollar signs
     }
-  }
-  /**
-   * Add labels to issue
-   */
-  async addLabels(issueNumber, labels) {
-    if (labels.length === 0) return;
-    const labelArgs = labels.map((l) => `"${l}"`).join(",");
-    const cmd = `gh issue edit ${issueNumber} --repo ${this.repo} --add-label ${labelArgs}`;
-    try {
-      execSync(cmd, { encoding: "utf-8", stdio: "pipe" });
-    } catch (error) {
-      throw new Error(`Failed to add labels to issue #${issueNumber}: ${error.message}`);
+    /**
+     * Batch create issues with rate limit handling
+     */
+    async batchCreateIssues(issues, milestone, epicNumber, options = {}) {
+        const { batchSize = 10, delayMs = 6000 } = options; // 10 issues per minute by default
+        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 (except after last batch)
+            if (i + batchSize < issues.length) {
+                console.log(`Waiting ${delayMs / 1000}s to avoid rate limits...`);
+                await this.sleep(delayMs);
+            }
+        }
+        return createdIssues;
     }
-  }
-  /**
-   * Check rate limit status
-   */
-  async checkRateLimit() {
-    const cmd = `gh api rate_limit --jq '.rate | {remaining: .remaining, limit: .limit, reset: .reset}'`;
-    try {
-      const output = execSync(cmd, { encoding: "utf-8" });
-      const data = JSON.parse(output);
-      return {
-        ...data,
-        reset: new Date(data.reset * 1e3)
-      };
-    } catch (error) {
-      throw new Error(`Failed to check rate limit: ${error.message}`);
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
     }
-  }
-  /**
-   * Escape quotes in strings for shell commands
-   */
-  escapeQuotes(str) {
-    return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/`/g, "\\`").replace(/\$/g, "\\$");
-  }
-  /**
-   * Batch create issues with rate limit handling
-   */
-  async batchCreateIssues(issues, milestone, epicNumber, options = {}) {
-    const { batchSize = 10, delayMs = 6e3 } = 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) {
+    /**
+     * 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 async getRepositories(owner, limit = 100) {
         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);
+            const ownerFilter = owner ? `${owner}/` : '';
+            const cmd = `gh repo list ${ownerFilter} --limit ${limit} --json owner,name,nameWithOwner`;
+            const output = execSync(cmd, { encoding: 'utf-8' }).trim();
+            if (!output) {
+                return [];
+            }
+            const repos = JSON.parse(output);
+            return repos.map((repo) => ({
+                owner: repo.owner?.login || '',
+                name: repo.name,
+                fullName: repo.nameWithOwner
+            }));
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch repositories: ${error.message}`);
         }
-      }
-      if (i + batchSize < issues.length) {
-        console.log(`Waiting ${delayMs / 1e3}s to avoid rate limits...`);
-        await this.sleep(delayMs);
-      }
-    }
-    return createdIssues;
-  }
-  sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-  }
-  /**
-   * 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 async getRepositories(owner, limit = 100) {
-    try {
-      const ownerFilter = owner ? `${owner}/` : "";
-      const cmd = `gh repo list ${ownerFilter} --limit ${limit} --json owner,name,nameWithOwner`;
-      const output = execSync(cmd, { encoding: "utf-8" }).trim();
-      if (!output) {
-        return [];
-      }
-      const repos = JSON.parse(output);
-      return repos.map((repo) => ({
-        owner: repo.owner?.login || "",
-        name: repo.name,
-        fullName: repo.nameWithOwner
-      }));
-    } catch (error) {
-      throw new Error(`Failed to fetch repositories: ${error.message}`);
     }
-  }
 }
-export {
-  GitHubClient
-};
+//# sourceMappingURL=github-client.js.map