specweave 0.17.0 → 0.17.2

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

@@ -0,0 +1,299 @@
+/**
+ * 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();
+    }
+    /**
+     * 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');
+        }
+    }
+    /**
+     * 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) {
+        // 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}`);
+        }
+    }
+    /**
+     * 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 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}`);
+        }
+    }
+    /**
+     * 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}`);
+        }
+    }
+    /**
+     * 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}`);
+        }
+    }
+    /**
+     * 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}`);
+        }
+    }
+    /**
+     * 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}`);
+        }
+    }
+    /**
+     * 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
+    }
+    /**
+     * 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;
+    }
+    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}`);
+        }
+    }
+}
+//# sourceMappingURL=github-client.js.map

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

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

package/dist/plugins/specweave-github/lib/github-issue-updater.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GitHub Issue Updater for Living Docs Sync
+ *
+ * Handles updating GitHub issues with living documentation links and content.
+ * Used by post-task-completion hook to keep GitHub issues in sync with SpecWeave docs.
+ *
+ * @module github-issue-updater
+ */
+export interface LivingDocsSection {
+    specs: string[];
+    architecture: string[];
+    diagrams: string[];
+}
+export interface IncrementMetadata {
+    id: string;
+    status: string;
+    type: string;
+    github?: {
+        issue: number;
+        url: string;
+        synced?: string;
+    };
+}
+/**
+ * Update GitHub issue with living docs section
+ */
+export declare function updateIssueLivingDocs(issueNumber: number, livingDocs: LivingDocsSection, owner: string, repo: string): Promise<void>;
+/**
+ * Post comment about ADR/HLD/diagram creation
+ */
+export declare function postArchitectureComment(issueNumber: number, docPath: string, owner: string, repo: string): Promise<void>;
+/**
+ * Post scope change comment
+ */
+export declare function postScopeChangeComment(issueNumber: number, changes: {
+    added?: string[];
+    removed?: string[];
+    modified?: string[];
+    reason?: string;
+    impact?: string;
+}, owner: string, repo: string): Promise<void>;
+/**
+ * Post status change comment (pause/resume/abandon)
+ */
+export declare function postStatusChangeComment(issueNumber: number, status: 'paused' | 'resumed' | 'abandoned', reason: string, owner: string, repo: string): Promise<void>;
+/**
+ * Collect living docs for an increment
+ */
+export declare function collectLivingDocs(incrementId: string): Promise<LivingDocsSection>;
+/**
+ * Load increment metadata
+ */
+export declare function loadIncrementMetadata(incrementId: string): Promise<IncrementMetadata | null>;
+/**
+ * Detect repository owner and name from git remote
+ */
+export declare function detectRepo(): Promise<{
+    owner: string;
+    repo: string;
+} | null>;
+//# sourceMappingURL=github-issue-updater.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-issue-updater.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/github-issue-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,EAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqDvF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAalG;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsBlF"}