opencode-sdlc-plugin 1.0.0-alpha.0 → 1.1.1

package/dist/index.js

@@ -1,6 +1,8 @@
 import { tmpdir, homedir, platform } from 'os';
 import { existsSync, readFileSync, appendFileSync, mkdirSync, writeFileSync, statSync, truncateSync } from 'fs';
 import { join, dirname } from 'path';
+import { execSync } from 'child_process';
+import { Octokit } from '@octokit/rest';
 import { minimatch } from 'minimatch';
 import { z } from 'zod';
 import { readFile, mkdir, writeFile, readdir } from 'fs/promises';
@@ -173,14 +175,692 @@ function handleSessionError(event, tracker) {
     });
   }
 }
+function resolveGitHubToken(explicitToken) {
+  if (explicitToken) {
+    return explicitToken;
+  }
+  const envToken = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+  if (envToken) {
+    return envToken;
+  }
+  try {
+    const ghToken = execSync("gh auth token", {
+      encoding: "utf-8",
+      timeout: 5e3,
+      stdio: ["pipe", "pipe", "pipe"]
+    }).trim();
+    if (ghToken) {
+      return ghToken;
+    }
+  } catch {
+  }
+  return null;
+}
+function isGitHubAuthenticated(token) {
+  return resolveGitHubToken(token) !== null;
+}
+var GitHubClient = class {
+  octokit;
+  owner;
+  repo;
+  constructor(options = {}) {
+    const token = resolveGitHubToken(options.token);
+    if (!token) {
+      throw new Error(
+        "GitHub authentication not found. Set GITHUB_TOKEN environment variable or run 'gh auth login'."
+      );
+    }
+    this.octokit = new Octokit({ auth: token });
+    this.owner = options.owner;
+    this.repo = options.repo;
+  }
+  /**
+   * Set the default owner/repo for operations
+   */
+  setRepo(owner, repo) {
+    this.owner = owner;
+    this.repo = repo;
+  }
+  getRepoParams(owner, repo) {
+    const o = owner || this.owner;
+    const r = repo || this.repo;
+    if (!o || !r) {
+      throw new Error("Repository owner and name are required");
+    }
+    return { owner: o, repo: r };
+  }
+  // ==========================================================================
+  // Issues
+  // ==========================================================================
+  /**
+   * Get a single issue by number
+   */
+  async getIssue(issueNumber, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.issues.get({
+      ...params,
+      issue_number: issueNumber
+    });
+    return {
+      number: data.number,
+      title: data.title,
+      body: data.body ?? null,
+      url: data.html_url,
+      state: data.state,
+      labels: (data.labels || []).map(
+        (label) => typeof label === "string" ? { name: label } : { name: label.name || "" }
+      )
+    };
+  }
+  /**
+   * List issues in a repository
+   */
+  async listIssues(options = {}, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.issues.listForRepo({
+      ...params,
+      state: options.state || "open",
+      labels: options.labels?.join(","),
+      per_page: options.limit || 30
+    });
+    return data.filter((issue) => !issue.pull_request).map((issue) => ({
+      number: issue.number,
+      title: issue.title,
+      url: issue.html_url,
+      state: issue.state
+    }));
+  }
+  /**
+   * Update an issue's body
+   */
+  async updateIssueBody(issueNumber, body, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    await this.octokit.issues.update({
+      ...params,
+      issue_number: issueNumber,
+      body
+    });
+  }
+  /**
+   * Add labels to an issue
+   */
+  async addLabels(issueNumber, labels, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    await this.octokit.issues.addLabels({
+      ...params,
+      issue_number: issueNumber,
+      labels
+    });
+  }
+  // ==========================================================================
+  // Pull Requests
+  // ==========================================================================
+  /**
+   * Create a pull request
+   */
+  async createPullRequest(options, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.pulls.create({
+      ...params,
+      title: options.title,
+      body: options.body,
+      head: options.head,
+      base: options.base || "main",
+      draft: options.draft
+    });
+    return {
+      number: data.number,
+      url: data.html_url
+    };
+  }
+  /**
+   * Get pull request details
+   */
+  async getPullRequest(prNumber, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.pulls.get({
+      ...params,
+      pull_number: prNumber
+    });
+    return {
+      number: data.number,
+      title: data.title,
+      body: data.body,
+      url: data.html_url,
+      state: data.merged ? "merged" : data.state,
+      mergeable: data.mergeable,
+      mergeableState: data.mergeable_state,
+      draft: data.draft || false
+    };
+  }
+  /**
+   * Get pull request status including checks and reviews
+   */
+  async getPullRequestStatus(prNumber, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const pr = await this.getPullRequest(prNumber, owner, repo);
+    const { data: prData } = await this.octokit.pulls.get({
+      ...params,
+      pull_number: prNumber
+    });
+    let checks = [];
+    try {
+      const { data: checksData } = await this.octokit.checks.listForRef({
+        ...params,
+        ref: prData.head.sha
+      });
+      checks = checksData.check_runs.map((check) => ({
+        name: check.name,
+        status: check.status === "completed" ? check.conclusion === "success" ? "pass" : check.conclusion === "skipped" ? "skipped" : "fail" : "pending",
+        conclusion: check.conclusion
+      }));
+    } catch {
+    }
+    const { data: reviewsData } = await this.octokit.pulls.listReviews({
+      ...params,
+      pull_number: prNumber
+    });
+    const reviews = reviewsData.map((review) => ({
+      reviewer: review.user?.login || "unknown",
+      state: review.state
+    }));
+    return {
+      number: pr.number,
+      url: pr.url,
+      state: pr.state,
+      mergeable: pr.mergeable,
+      checks,
+      reviews
+    };
+  }
+  /**
+   * Get pull request diff
+   */
+  async getPullRequestDiff(prNumber, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.pulls.get({
+      ...params,
+      pull_number: prNumber,
+      mediaType: { format: "diff" }
+    });
+    return data;
+  }
+  /**
+   * Merge a pull request
+   */
+  async mergePullRequest(options, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.pulls.merge({
+      ...params,
+      pull_number: options.prNumber,
+      merge_method: options.mergeMethod || "squash",
+      commit_title: options.commitTitle,
+      commit_message: options.commitMessage
+    });
+    return {
+      sha: data.sha,
+      merged: data.merged
+    };
+  }
+  // ==========================================================================
+  // Repositories
+  // ==========================================================================
+  /**
+   * Create a new repository (personal or in an organization)
+   */
+  async createRepository(options) {
+    let data;
+    if (options.org) {
+      const response = await this.octokit.repos.createInOrg({
+        org: options.org,
+        name: options.name,
+        description: options.description,
+        private: options.private ?? false,
+        auto_init: options.autoInit ?? false
+      });
+      data = response.data;
+    } else {
+      const response = await this.octokit.repos.createForAuthenticatedUser({
+        name: options.name,
+        description: options.description,
+        private: options.private ?? false,
+        auto_init: options.autoInit ?? false
+      });
+      data = response.data;
+    }
+    return {
+      id: data.id,
+      name: data.name,
+      fullName: data.full_name,
+      url: data.html_url,
+      private: data.private,
+      defaultBranch: data.default_branch || "main"
+    };
+  }
+  /**
+   * List organizations the authenticated user belongs to
+   */
+  async listOrganizations() {
+    const query = `
+      query {
+        viewer {
+          organizations(first: 100) {
+            nodes {
+              id
+              databaseId
+              login
+              name
+            }
+          }
+        }
+      }
+    `;
+    const result = await this.octokit.graphql(query);
+    return result.viewer.organizations.nodes.map((org) => ({
+      id: String(org.databaseId),
+      nodeId: org.id,
+      login: org.login,
+      name: org.name
+    }));
+  }
+  /**
+   * Get repository details
+   */
+  async getRepository(owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const { data } = await this.octokit.repos.get(params);
+    return {
+      id: data.id,
+      name: data.name,
+      fullName: data.full_name,
+      url: data.html_url,
+      private: data.private,
+      defaultBranch: data.default_branch || "main"
+    };
+  }
+  /**
+   * List repositories for the authenticated user
+   */
+  async listUserRepos(options = {}) {
+    const { data } = await this.octokit.repos.listForAuthenticatedUser({
+      type: options.type || "owner",
+      per_page: options.limit || 30,
+      sort: "updated"
+    });
+    return data.map((repo) => ({
+      id: repo.id,
+      name: repo.name,
+      fullName: repo.full_name,
+      url: repo.html_url,
+      private: repo.private,
+      defaultBranch: repo.default_branch || "main"
+    }));
+  }
+  // ==========================================================================
+  // Projects (GraphQL required for Projects V2)
+  // ==========================================================================
+  /**
+   * List projects for the authenticated user
+   * Note: Projects V2 requires GraphQL API
+   */
+  async listUserProjects(limit = 20) {
+    const query = `
+      query($first: Int!) {
+        viewer {
+          projectsV2(first: $first) {
+            nodes {
+              id
+              number
+              title
+              url
+            }
+          }
+        }
+      }
+    `;
+    const result = await this.octokit.graphql(query, { first: limit });
+    return result.viewer.projectsV2.nodes;
+  }
+  /**
+   * Get project by number for a user
+   */
+  async getUserProject(userLogin, projectNumber) {
+    const query = `
+      query($login: String!, $number: Int!) {
+        user(login: $login) {
+          projectV2(number: $number) {
+            id
+            number
+            title
+            url
+          }
+        }
+      }
+    `;
+    try {
+      const result = await this.octokit.graphql(query, { login: userLogin, number: projectNumber });
+      return result.user.projectV2;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Get project by number for an organization
+   */
+  async getOrgProject(orgLogin, projectNumber) {
+    const query = `
+      query($login: String!, $number: Int!) {
+        organization(login: $login) {
+          projectV2(number: $number) {
+            id
+            number
+            title
+            url
+          }
+        }
+      }
+    `;
+    try {
+      const result = await this.octokit.graphql(query, { login: orgLogin, number: projectNumber });
+      return result.organization.projectV2;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * List projects for an organization
+   */
+  async listOrgProjects(orgLogin, limit = 20) {
+    const query = `
+      query($login: String!, $first: Int!) {
+        organization(login: $login) {
+          projectsV2(first: $first) {
+            nodes {
+              id
+              number
+              title
+              url
+            }
+          }
+        }
+      }
+    `;
+    try {
+      const result = await this.octokit.graphql(query, { login: orgLogin, first: limit });
+      return result.organization.projectsV2.nodes;
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Create a new project
+   */
+  async createProject(options) {
+    let ownerId;
+    if (options.isOrg) {
+      const query = `
+        query($login: String!) {
+          organization(login: $login) {
+            id
+          }
+        }
+      `;
+      const result2 = await this.octokit.graphql(query, { login: options.ownerLogin });
+      ownerId = result2.organization.id;
+    } else {
+      const query = `
+        query($login: String!) {
+          user(login: $login) {
+            id
+          }
+        }
+      `;
+      const result2 = await this.octokit.graphql(query, { login: options.ownerLogin });
+      ownerId = result2.user.id;
+    }
+    const mutation = `
+      mutation($ownerId: ID!, $title: String!) {
+        createProjectV2(input: { ownerId: $ownerId, title: $title }) {
+          projectV2 {
+            id
+            number
+            title
+            url
+          }
+        }
+      }
+    `;
+    const result = await this.octokit.graphql(mutation, { ownerId, title: options.title });
+    return result.createProjectV2.projectV2;
+  }
+  /**
+   * Copy an existing project
+   */
+  async copyProject(options) {
+    let sourceProject;
+    if (options.sourceIsOrg) {
+      sourceProject = await this.getOrgProject(
+        options.sourceOwnerLogin,
+        options.sourceProjectNumber
+      );
+    } else {
+      sourceProject = await this.getUserProject(
+        options.sourceOwnerLogin,
+        options.sourceProjectNumber
+      );
+    }
+    if (!sourceProject) {
+      throw new Error(
+        `Source project #${options.sourceProjectNumber} not found for ${options.sourceOwnerLogin}`
+      );
+    }
+    let targetOwnerId;
+    if (options.targetIsOrg) {
+      const query = `
+        query($login: String!) {
+          organization(login: $login) {
+            id
+          }
+        }
+      `;
+      const result2 = await this.octokit.graphql(query, { login: options.targetOwnerLogin });
+      targetOwnerId = result2.organization.id;
+    } else {
+      const query = `
+        query($login: String!) {
+          user(login: $login) {
+            id
+          }
+        }
+      `;
+      const result2 = await this.octokit.graphql(query, { login: options.targetOwnerLogin });
+      targetOwnerId = result2.user.id;
+    }
+    const mutation = `
+      mutation($projectId: ID!, $ownerId: ID!, $title: String!, $includeDraftIssues: Boolean) {
+        copyProjectV2(input: { 
+          projectId: $projectId, 
+          ownerId: $ownerId, 
+          title: $title,
+          includeDraftIssues: $includeDraftIssues
+        }) {
+          projectV2 {
+            id
+            number
+            title
+            url
+          }
+        }
+      }
+    `;
+    const result = await this.octokit.graphql(mutation, {
+      projectId: sourceProject.id,
+      ownerId: targetOwnerId,
+      title: options.title,
+      includeDraftIssues: options.includeDraftIssues ?? false
+    });
+    return result.copyProjectV2.projectV2;
+  }
+  /**
+   * Link a repository to a project
+   * Note: This creates a linked repository in the project
+   */
+  async linkRepoToProject(projectId, repoOwner, repoName) {
+    const { data: repoData } = await this.octokit.repos.get({
+      owner: repoOwner,
+      repo: repoName
+    });
+    const mutation = `
+      mutation($projectId: ID!, $repositoryId: ID!) {
+        linkProjectV2ToRepository(input: { projectId: $projectId, repositoryId: $repositoryId }) {
+          repository {
+            id
+          }
+        }
+      }
+    `;
+    await this.octokit.graphql(mutation, {
+      projectId,
+      repositoryId: repoData.node_id
+    });
+  }
+  /**
+   * Add an issue to a project
+   */
+  async addIssueToProject(projectId, issueNodeId) {
+    const mutation = `
+      mutation($projectId: ID!, $contentId: ID!) {
+        addProjectV2ItemById(input: { projectId: $projectId, contentId: $contentId }) {
+          item {
+            id
+          }
+        }
+      }
+    `;
+    const result = await this.octokit.graphql(mutation, {
+      projectId,
+      contentId: issueNodeId
+    });
+    return result.addProjectV2ItemById.item.id;
+  }
+  // ==========================================================================
+  // Branch Protection / Rulesets
+  // ==========================================================================
+  /**
+   * Create a branch ruleset with common protection rules
+   */
+  async createBranchRuleset(options, owner, repo) {
+    const params = this.getRepoParams(owner, repo);
+    const rules = [];
+    if (options.requirePullRequest) {
+      rules.push({
+        type: "pull_request",
+        parameters: {
+          dismiss_stale_reviews_on_push: options.dismissStaleReviews ?? false,
+          require_code_owner_review: options.requireCodeOwnerReview ?? false,
+          require_last_push_approval: false,
+          required_approving_review_count: options.requiredApprovals ?? 1,
+          required_review_thread_resolution: false
+        }
+      });
+    }
+    if (options.requireSignedCommits) {
+      rules.push({ type: "required_signatures" });
+    }
+    if (options.requireLinearHistory) {
+      rules.push({ type: "required_linear_history" });
+    }
+    if (options.preventDeletion) {
+      rules.push({ type: "deletion" });
+    }
+    if (options.preventForcePush) {
+      rules.push({ type: "non_fast_forward" });
+    }
+    const { data } = await this.octokit.repos.createRepoRuleset({
+      ...params,
+      name: options.name,
+      enforcement: options.enforcement,
+      conditions: {
+        ref_name: {
+          include: options.targetBranches,
+          exclude: []
+        }
+      },
+      rules
+    });
+    return { id: data.id };
+  }
+  // ==========================================================================
+  // Utility Methods
+  // ==========================================================================
+  /**
+   * Get the authenticated user's login
+   */
+  async getAuthenticatedUser() {
+    const { data } = await this.octokit.users.getAuthenticated();
+    return { login: data.login, id: data.id };
+  }
+  /**
+   * Check if a repository exists
+   */
+  async repoExists(owner, repo) {
+    try {
+      await this.octokit.repos.get({ owner, repo });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+function createGitHubClientIfAuthenticated(options = {}) {
+  if (!isGitHubAuthenticated(options.token)) {
+    return null;
+  }
+  try {
+    return new GitHubClient(options);
+  } catch {
+    return null;
+  }
+}
 
 // src/plugin/utils/github-issues.ts
 var log3 = createPluginLogger("github-issues");
+var cachedClient = null;
+var cachedClientRepo = null;
+function getClient(config) {
+  if (!config.github?.owner || !config.github?.repo) return null;
+  const repoKey = `${config.github.owner}/${config.github.repo}`;
+  if (cachedClient && cachedClientRepo === repoKey) {
+    return cachedClient;
+  }
+  cachedClient = createGitHubClientIfAuthenticated({
+    owner: config.github.owner,
+    repo: config.github.repo
+  });
+  cachedClientRepo = cachedClient ? repoKey : null;
+  return cachedClient;
+}
 function getRepo(config) {
   if (!config.github?.owner || !config.github?.repo) return null;
   return { owner: config.github.owner, repo: config.github.repo };
 }
 async function fetchIssue(ctx, config, issueNumber) {
+  const client = getClient(config);
+  if (client) {
+    try {
+      const issue = await client.getIssue(issueNumber);
+      return {
+        number: issue.number,
+        title: issue.title,
+        body: issue.body,
+        url: issue.url,
+        state: issue.state,
+        labels: issue.labels
+      };
+    } catch (error) {
+      log3.warn("Failed to fetch issue via Octokit", { issueNumber, error: String(error) });
+    }
+  }
   const repo = getRepo(config);
   if (!repo) return null;
   try {
@@ -194,6 +874,20 @@ async function fetchIssue(ctx, config, issueNumber) {
   }
 }
 async function listIssues(ctx, config, status, limit = 20) {
+  const client = getClient(config);
+  if (client && !status) {
+    try {
+      const issues = await client.listIssues({ limit });
+      return issues.map((issue) => ({
+        number: issue.number,
+        title: issue.title,
+        url: issue.url,
+        state: issue.state
+      }));
+    } catch (error) {
+      log3.warn("Failed to list issues via Octokit", { error: String(error) });
+    }
+  }
   const repo = getRepo(config);
   if (!repo) return [];
   try {
@@ -219,6 +913,15 @@ async function moveIssueToStatus(ctx, config, issueNumber, status) {
   }
 }
 async function updateIssueBody(ctx, config, issueNumber, body) {
+  const client = getClient(config);
+  if (client) {
+    try {
+      await client.updateIssueBody(issueNumber, body);
+      return true;
+    } catch (error) {
+      log3.warn("Failed to update issue body via Octokit", { issueNumber, error: String(error) });
+    }
+  }
   const repo = getRepo(config);
   if (!repo) return false;
   try {