GitHub

# For PAT authentication
GITHUB_TOKEN=ghp_your_personal_access_token
GITHUB_WEBHOOK_SECRET=your-webhook-secret

# For GitHub App authentication (alternative)
# GITHUB_APP_ID=123456
# GITHUB_APP_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n..."
# GITHUB_APP_INSTALLATION_ID=78901234

import { Cognest } from "@cognest/sdk";
import { GitHubIntegration } from "@cognest/integrations/github";

const cognest = new Cognest();
const github = cognest.integration<GitHubIntegration>("github");

// Create a new issue
const issue = await github.createIssue({
  owner: "your-org",
  repo: "your-repo",
  title: "Bug: Login page returns 500 on invalid email",
  body: [
    "## Description",
    "Submitting an invalid email format on the login page causes a 500 error.",
    "",
    "## Steps to Reproduce",
    "1. Navigate to /login",
    '2. Enter "notanemail" in the email field',
    "3. Click Submit",
    "",
    "## Expected Behavior",
    "A validation error should be shown to the user.",
  ].join("\n"),
  labels: ["bug", "priority:high"],
  assignees: ["developer-username"],
});

// Create a pull request
const pr = await github.createPR({
  owner: "your-org",
  repo: "your-repo",
  title: "fix: validate email format on login page",
  body: `Closes #${issue.number}\n\nAdds client-side and server-side email validation.`,
  head: "fix/login-email-validation",
  base: "main",
  draft: false,
});

// Add a comment to the issue
await github.createComment({
  owner: "your-org",
  repo: "your-repo",
  issue_number: issue.number,
  body: `Fix submitted in #${pr.number}. Awaiting review.`,
});

import { Cognest, Skill, IncomingEvent } from "@cognest/sdk";
import {
  GitHubIntegration,
  GitHubIssueEvent,
  GitHubPushEvent,
} from "@cognest/integrations/github";

const cognest = new Cognest();
const github = cognest.integration<GitHubIntegration>("github");

const issueTriage = new Skill({
  name: "issue-triage",
  description: "Auto-triage, label, and assign new GitHub issues",
});

// Auto-triage new issues
issueTriage.on(
  "github:issue:opened",
  async (event: IncomingEvent<GitHubIssueEvent>) => {
    const { issue, repository } = event.payload;
    const { owner, repo } = {
      owner: repository.owner.login,
      repo: repository.name,
    };

    // Use the Think Engine to classify the issue
    const triage = await cognest.think({
      prompt: `You are a GitHub issue triage assistant for the ${repo} repository.

Analyze this issue and classify it.

Title: ${issue.title}
Body: ${issue.body?.slice(0, 1500) ?? "(empty)"}
Author: ${issue.user.login}

Respond with JSON:
{
  "category": "bug" | "feature" | "docs" | "question" | "chore",
  "priority": "low" | "medium" | "high" | "critical",
  "estimated_effort": "small" | "medium" | "large",
  "suggested_assignee": "username or null",
  "summary": "one-line summary"
}`,
      responseFormat: "json",
    });

    const { category, priority, estimated_effort, suggested_assignee, summary } =
      triage.parsed;

    // Apply labels
    const labels = [
      category,
      `priority:${priority}`,
      `effort:${estimated_effort}`,
    ];

    await github.addLabel({
      owner,
      repo,
      issue_number: issue.number,
      labels,
    });

    // Post a triage summary comment
    await github.createComment({
      owner,
      repo,
      issue_number: issue.number,
      body: [
        "## Triage Summary",
        "",
        `| Field | Value |`,
        `|---|---|`,
        `| **Category** | ${category} |`,
        `| **Priority** | ${priority} |`,
        `| **Effort** | ${estimated_effort} |`,
        `| **Summary** | ${summary} |`,
        "",
        suggested_assignee
          ? `Suggested assignee: @${suggested_assignee}`
          : "No assignee suggested — please self-assign if this is in your area.",
        "",
        "*This issue was triaged automatically by Cognest.*",
      ].join("\n"),
    });

    // Auto-close duplicate detection
    const existingIssues = await github.listIssues({
      owner,
      repo,
      state: "open",
      labels: category,
      per_page: 50,
    });

    const duplicateCheck = await cognest.think({
      prompt: `Given this new issue:
Title: "${issue.title}"
Summary: "${summary}"

And these existing open issues:
${existingIssues
  .filter((i) => i.number !== issue.number)
  .slice(0, 20)
  .map((i) => `#${i.number}: ${i.title}`)
  .join("\n")}

Is this a duplicate of any existing issue? Respond with JSON:
{ "is_duplicate": boolean, "duplicate_of": number | null }`,
      responseFormat: "json",
    });

    if (duplicateCheck.parsed.is_duplicate && duplicateCheck.parsed.duplicate_of) {
      await github.createComment({
        owner,
        repo,
        issue_number: issue.number,
        body: `This appears to be a duplicate of #${duplicateCheck.parsed.duplicate_of}. Closing as duplicate.\n\n*Detected by Cognest issue triage.*`,
      });

      await github.addLabel({
        owner,
        repo,
        issue_number: issue.number,
        labels: ["duplicate"],
      });

      await github.closeIssue({
        owner,
        repo,
        issue_number: issue.number,
        reason: "not_planned",
      });
    }

    cognest.log.info(
      `Triaged issue #${issue.number} as ${category}/${priority} in ${owner}/${repo}`
    );
  }
);

// Post a summary comment on push events with multiple commits
issueTriage.on(
  "github:push",
  async (event: IncomingEvent<GitHubPushEvent>) => {
    const { commits, repository, ref } = event.payload;
    const branch = ref.replace("refs/heads/", "");

    // Only summarize pushes to main with 3+ commits
    if (branch !== "main" || commits.length < 3) return;

    const summary = await cognest.think({
      prompt: `Summarize these ${commits.length} commits pushed to main in 2-3 sentences:

${commits.map((c) => `- ${c.message}`).join("\n")}`,
    });

    cognest.log.info(
      `Push to ${repository.full_name}/main: ${summary.text}`
    );
  }
);

cognest.register(issueTriage);
cognest.start();