ai-sdlc 0.3.1-alpha.0-alpha.7 → 0.3.1-alpha.0-alpha.8

package/dist/services/ticket-provider/github-provider.js

@@ -0,0 +1,194 @@
+import { ghIssueView, ghIssueList, } from '../gh-cli.js';
+/**
+ * Ticket provider implementation for GitHub Issues.
+ *
+ * Integrates with GitHub Issues via the gh CLI. Supports:
+ * - Listing issues with filters
+ * - Fetching individual issues
+ * - Status mapping between GitHub and ai-sdlc
+ *
+ * Write operations (create, updateStatus, addComment, linkPR) will be
+ * implemented in story S-0075.
+ */
+export class GitHubTicketProvider {
+    config;
+    name = 'github';
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get owner and repo from config.
+     * @throws Error if repo is not configured
+     */
+    getOwnerRepo() {
+        if (!this.config?.repo) {
+            throw new Error('GitHub repository not configured. Set ticketing.github.repo in config.');
+        }
+        const [owner, repo] = this.config.repo.split('/');
+        if (!owner || !repo) {
+            throw new Error(`Invalid GitHub repository format: "${this.config.repo}". Expected "owner/repo".`);
+        }
+        return { owner, repo };
+    }
+    /**
+     * Map GitHub Issue to Ticket.
+     */
+    mapIssueToTicket(issue) {
+        const { owner, repo } = this.getOwnerRepo();
+        const url = `https://github.com/${owner}/${repo}/issues/${issue.number}`;
+        const labels = issue.labels.map((l) => l.name);
+        const assignee = issue.assignees[0]?.login;
+        // Extract priority from project if available
+        let priority = 3; // Default priority
+        if (issue.projectItems && issue.projectItems.length > 0) {
+            for (const item of issue.projectItems) {
+                // Look for priority field in project
+                if (item.fieldValueByName) {
+                    const priorityField = item.fieldValueByName.find((f) => f.field.name.toLowerCase() === 'priority');
+                    if (priorityField) {
+                        // Try to parse priority as number
+                        const priorityValue = parseInt(priorityField.name, 10);
+                        if (!isNaN(priorityValue)) {
+                            priority = priorityValue;
+                        }
+                    }
+                }
+            }
+        }
+        return {
+            id: issue.number.toString(),
+            url,
+            title: issue.title,
+            description: issue.body || '',
+            status: issue.state,
+            priority,
+            labels,
+            assignee,
+        };
+    }
+    /**
+     * List tickets matching the given filter criteria.
+     */
+    async list(filter) {
+        const { owner, repo } = this.getOwnerRepo();
+        // Convert TicketFilter to IssueFilter
+        const issueFilter = {};
+        if (filter?.status && filter.status.length > 0) {
+            // Map internal statuses to GitHub state
+            const hasOpen = filter.status.some((s) => ['backlog', 'ready', 'in-progress', 'blocked'].includes(s));
+            const hasClosed = filter.status.includes('done');
+            if (hasOpen && hasClosed) {
+                issueFilter.state = 'all';
+            }
+            else if (hasOpen) {
+                issueFilter.state = 'open';
+            }
+            else if (hasClosed) {
+                issueFilter.state = 'closed';
+            }
+        }
+        if (filter?.labels) {
+            issueFilter.labels = filter.labels;
+        }
+        if (filter?.assignee) {
+            issueFilter.assignee = filter.assignee;
+        }
+        if (filter?.limit) {
+            issueFilter.limit = filter.limit;
+        }
+        const issues = await ghIssueList(owner, repo, issueFilter);
+        return issues.map((issue) => this.mapIssueToTicket(issue));
+    }
+    /**
+     * Get a single ticket by its ID.
+     */
+    async get(id) {
+        const { owner, repo } = this.getOwnerRepo();
+        const issueNumber = parseInt(id, 10);
+        if (isNaN(issueNumber)) {
+            throw new Error(`Invalid GitHub issue number: "${id}"`);
+        }
+        const issue = await ghIssueView(owner, repo, issueNumber);
+        return this.mapIssueToTicket(issue);
+    }
+    /**
+     * Create a new ticket.
+     * @throws Error - Not yet implemented (S-0075)
+     */
+    async create(_ticket) {
+        throw new Error('GitHub ticket creation not yet implemented (S-0075)');
+    }
+    /**
+     * Update the status of a ticket.
+     * No-op: Write operations will be implemented in S-0075.
+     */
+    async updateStatus(_id, _status) {
+        // No-op: Write operations not yet implemented
+    }
+    /**
+     * Add a comment to a ticket.
+     * No-op: Write operations will be implemented in S-0075.
+     */
+    async addComment(_id, _body) {
+        // No-op: Write operations not yet implemented
+    }
+    /**
+     * Link a pull request to a ticket.
+     * No-op: Write operations will be implemented in S-0075.
+     */
+    async linkPR(_id, _prUrl) {
+        // No-op: Write operations not yet implemented
+    }
+    /**
+     * Map internal story status to external GitHub status.
+     *
+     * Uses label-based mapping if configured, otherwise uses state:
+     * - backlog, ready, in_progress, blocked → 'open'
+     * - done → 'closed'
+     */
+    mapStatusToExternal(status) {
+        // Check for custom label mapping
+        if (this.config?.statusLabels && this.config.statusLabels[status]) {
+            return this.config.statusLabels[status];
+        }
+        // Default mapping to GitHub issue state
+        switch (status) {
+            case 'done':
+                return 'closed';
+            case 'backlog':
+            case 'ready':
+            case 'in-progress':
+            case 'blocked':
+            default:
+                return 'open';
+        }
+    }
+    /**
+     * Map external GitHub status to internal story status.
+     *
+     * If status labels are configured, tries to match label to status.
+     * Otherwise uses issue state:
+     * - open → ready
+     * - closed → done
+     */
+    mapStatusFromExternal(externalStatus) {
+        // Check for custom label mapping (reverse lookup)
+        if (this.config?.statusLabels) {
+            for (const [status, label] of Object.entries(this.config.statusLabels)) {
+                if (label === externalStatus) {
+                    return status;
+                }
+            }
+        }
+        // Default mapping from GitHub issue state
+        const statusLower = externalStatus.toLowerCase();
+        switch (statusLower) {
+            case 'closed':
+                return 'done';
+            case 'open':
+            default:
+                return 'ready';
+        }
+    }
+}
+//# sourceMappingURL=github-provider.js.map

package/dist/services/ticket-provider/github-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-provider.js","sourceRoot":"","sources":["../../../src/services/ticket-provider/github-provider.ts"],"names":[],"mappings":"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"}

package/dist/services/ticket-provider/index.d.ts

@@ -2,6 +2,7 @@ import { Config } from '../../types/index.js';
 import { TicketProvider } from './types.js';
 export * from './types.js';
 export { NullTicketProvider } from './null-provider.js';
+export { GitHubTicketProvider } from './github-provider.js';
 /**
  * Create a ticket provider based on configuration.
  *

package/dist/services/ticket-provider/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/ticket-provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAoBnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/ticket-provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAmBnE"}

package/dist/services/ticket-provider/index.js

@@ -1,7 +1,9 @@
 import { NullTicketProvider } from './null-provider.js';
+import { GitHubTicketProvider } from './github-provider.js';
 // Re-export types
 export * from './types.js';
 export { NullTicketProvider } from './null-provider.js';
+export { GitHubTicketProvider } from './github-provider.js';
 /**
  * Create a ticket provider based on configuration.
  *
@@ -23,8 +25,7 @@ export function createTicketProvider(config) {
         case 'none':
             return new NullTicketProvider();
         case 'github':
-            // Placeholder for S-0074 (GitHub provider implementation)
-            throw new Error('GitHub provider not yet implemented');
+            return new GitHubTicketProvider(config.ticketing?.github);
         case 'jira':
             // Placeholder for future Jira provider implementation
             throw new Error('Jira provider not yet implemented');

package/dist/services/ticket-provider/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/ticket-provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,IAAI,MAAM,CAAC;IAEtD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAElC,KAAK,QAAQ;YACX,0DAA0D;YAC1D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAEzD,KAAK,MAAM;YACT,sDAAsD;YACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAEvD;YACE,+CAA+C;YAC/C,OAAO,CAAC,IAAI,CAAC,4BAA4B,QAAQ,2BAA2B,CAAC,CAAC;YAC9E,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/ticket-provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,QAAQ,IAAI,MAAM,CAAC;IAEtD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAElC,KAAK,QAAQ;YACX,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE5D,KAAK,MAAM;YACT,sDAAsD;YACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAEvD;YACE,+CAA+C;YAC/C,OAAO,CAAC,IAAI,CAAC,4BAA4B,QAAQ,2BAA2B,CAAC,CAAC;YAC9E,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACpC,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sdlc",
-  "version": "0.3.1-alpha.0-alpha.7",
+  "version": "0.3.1-alpha.0-alpha.8",
   "description": "Agent-first SDLC workflow manager using Claude Agent SDK",
   "type": "module",
   "main": "dist/index.js",