@devory/github 0.3.1 → 0.4.6

package/dist/index.js

@@ -40,9 +40,13 @@ __export(src_exports, {
   canCreatePr: () => canCreatePr,
   commitType: () => commitType,
   createPr: () => createPr,
+  extractAcceptanceCriteria: () => extractAcceptanceCriteria,
+  fetchGitHubIssue: () => fetchGitHubIssue,
+  filterPlanningComments: () => filterPlanningComments,
   getRepoSlug: () => getRepoSlug,
   getRunId: () => getRunId,
   isGitHubActions: () => isGitHubActions,
+  isGitHubIssueUrl: () => isGitHubIssueUrl,
   prCreateBlockedReason: () => prCreateBlockedReason,
   setEnv: () => setEnv,
   setOutput: () => setOutput,
@@ -271,6 +275,138 @@ function createPr(meta, taskBody, options) {
   const prUrl = (result.stdout ?? "").trim();
   return { ok: true, prUrl: prUrl || void 0 };
 }
+
+// src/lib/issue-content-extractor.ts
+var AC_SECTION_HEADER = /^##\s*(acceptance criteria|ac|definition of done|dod)\s*$/i;
+var NEXT_SECTION_HEADER = /^##\s+/i;
+function cleanBullet(line) {
+  const trimmed = line.trim();
+  if (!/^[-*]\s+/.test(trimmed))
+    return null;
+  const cleaned = trimmed.replace(/^[-*]\s+/, "").trim();
+  return cleaned.length > 0 ? cleaned : null;
+}
+function isBadgeOnly(body) {
+  const normalized = body.trim();
+  if (normalized === "")
+    return true;
+  return /^\[!\[[^\]]*\]\([^)]*\)\]\([^)]*\)$/i.test(normalized);
+}
+function extractAcceptanceCriteria(body) {
+  if (!body || typeof body !== "string")
+    return [];
+  const lines = body.split(/\r?\n/);
+  let inAcSection = false;
+  const items = [];
+  for (const line of lines) {
+    if (!inAcSection && AC_SECTION_HEADER.test(line.trim())) {
+      inAcSection = true;
+      continue;
+    }
+    if (inAcSection && NEXT_SECTION_HEADER.test(line.trim())) {
+      break;
+    }
+    if (inAcSection) {
+      const bullet = cleanBullet(line);
+      if (bullet)
+        items.push(bullet);
+    }
+  }
+  return items;
+}
+function filterPlanningComments(comments) {
+  return comments.filter((comment) => {
+    const login = (comment.user?.login ?? "").toLowerCase();
+    if (login.endsWith("[bot]"))
+      return false;
+    const body = typeof comment.body === "string" ? comment.body : "";
+    if (isBadgeOnly(body))
+      return false;
+    return true;
+  }).map((comment) => typeof comment.body === "string" ? comment.body.trim() : "").filter((body) => body.length > 0);
+}
+
+// src/lib/issue-adapter.ts
+var GITHUB_ISSUE_URL = /^https:\/\/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)(?:\/)?(?:\?.*)?(?:#.*)?$/i;
+function normalizeDescription(body) {
+  if (typeof body !== "string")
+    return "";
+  return body.replace(/<[^>]+>/g, " ").replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function parseIssueUrl(url) {
+  const match = url.trim().match(GITHUB_ISSUE_URL);
+  if (!match)
+    return null;
+  return {
+    owner: match[1],
+    repo: match[2],
+    number: match[3]
+  };
+}
+function isGitHubIssueUrl(url) {
+  return parseIssueUrl(url) !== null;
+}
+async function fetchGitHubIssue(url) {
+  const parsed = parseIssueUrl(url);
+  if (!parsed) {
+    throw new Error(`GitHub issue URL is invalid: ${url}`);
+  }
+  const token = process.env.GITHUB_TOKEN;
+  if (typeof token !== "string" || token.trim() === "") {
+    throw new Error("GITHUB_TOKEN is required to fetch GitHub issues");
+  }
+  const apiUrl = `https://api.github.com/repos/${parsed.owner}/${parsed.repo}/issues/${parsed.number}`;
+  const response = await fetch(apiUrl, {
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: "application/vnd.github+json",
+      "User-Agent": "devory-intake"
+    }
+  });
+  if (response.status === 404) {
+    throw new Error(`GitHub issue not found: ${url}`);
+  }
+  if (response.status === 401) {
+    throw new Error("GitHub authentication failed \u2014 check GITHUB_TOKEN");
+  }
+  if (!response.ok) {
+    throw new Error(`GitHub issue fetch failed (${response.status})`);
+  }
+  const payload = await response.json();
+  let planningComments = [];
+  if (typeof payload.comments_url === "string" && payload.comments_url.trim() !== "") {
+    try {
+      const commentsResponse = await fetch(payload.comments_url, {
+        headers: {
+          Authorization: `Bearer ${token}`,
+          Accept: "application/vnd.github+json",
+          "User-Agent": "devory-intake"
+        }
+      });
+      if (commentsResponse.ok) {
+        const commentsPayload = await commentsResponse.json();
+        planningComments = filterPlanningComments(commentsPayload);
+      }
+    } catch {
+    }
+  }
+  const normalizedBody = normalizeDescription(payload.body);
+  const acceptanceCriteria = extractAcceptanceCriteria(normalizedBody);
+  const description = planningComments.length > 0 ? `${normalizedBody}
+
+Planning comments:
+${planningComments.map((entry) => `- ${entry}`).join("\n")}` : normalizedBody;
+  return {
+    source: "github-issue",
+    key: `${parsed.owner}/${parsed.repo}#${parsed.number}`,
+    url: payload.html_url ?? url,
+    title: typeof payload.title === "string" && payload.title.trim() !== "" ? payload.title.trim() : `Issue ${parsed.number}`,
+    description,
+    acceptance_criteria: acceptanceCriteria,
+    labels: Array.isArray(payload.labels) ? payload.labels.map((entry) => typeof entry?.name === "string" ? entry.name.trim() : "").filter((entry) => entry !== "") : [],
+    repo: `${parsed.owner}/${parsed.repo}`
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   appendStepSummary,
@@ -283,9 +419,13 @@ function createPr(meta, taskBody, options) {
   canCreatePr,
   commitType,
   createPr,
+  extractAcceptanceCriteria,
+  fetchGitHubIssue,
+  filterPlanningComments,
   getRepoSlug,
   getRunId,
   isGitHubActions,
+  isGitHubIssueUrl,
   prCreateBlockedReason,
   setEnv,
   setOutput,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devory/github",
-  "version": "0.3.1",
-  "description": "Devory GitHub integration \u2014 branch naming, PR helpers, and GitHub Actions support",
+  "version": "0.4.6",
+  "description": "Devory GitHub integration — branch naming, PR helpers, and GitHub Actions support",
   "repository": {
     "type": "git",
     "url": "https://github.com/devoryai/devory"
@@ -22,8 +22,8 @@
     "test": "tsx --test src/test/branch-helpers.test.ts src/test/pr-helpers.test.ts src/test/action-helpers.test.ts"
   },
   "dependencies": {
-    "@devory/cli": "0.3.1",
-    "@devory/core": "0.3.1"
+    "@devory/cli": "0.4.6",
+    "@devory/core": "0.4.6"
   },
   "devDependencies": {
     "esbuild": "^0.20.0",

package/src/index.ts

@@ -13,8 +13,8 @@ export {
   buildBranchName,
   branchPrefix,
   slugify,
-} from "./lib/branch-helpers.js";
-export type { BranchResult } from "./lib/branch-helpers.js";
+} from "./lib/branch-helpers.ts";
+export type { BranchResult } from "./lib/branch-helpers.ts";
 
 // ── PR helpers ──────────────────────────────────────────────────────────────
 export {
@@ -23,8 +23,8 @@ export {
   buildPrMetadata,
   commitType,
   taskScope,
-} from "./lib/pr-helpers.js";
-export type { PrMetadata } from "./lib/pr-helpers.js";
+} from "./lib/pr-helpers.ts";
+export type { PrMetadata } from "./lib/pr-helpers.ts";
 
 // ── GitHub Actions helpers ──────────────────────────────────────────────────
 export {
@@ -35,7 +35,7 @@ export {
   isGitHubActions,
   getRunId,
   getRepoSlug,
-} from "./lib/action-helpers.js";
+} from "./lib/action-helpers.ts";
 
 // ── PR creation (gated) ──────────────────────────────────────────────────────
 export {
@@ -43,5 +43,12 @@ export {
   prCreateBlockedReason,
   buildGhCreateArgs,
   createPr,
-} from "./lib/pr-create.js";
-export type { PrCreateOptions, PrCreateResult } from "./lib/pr-create.js";
+} from "./lib/pr-create.ts";
+export type { PrCreateOptions, PrCreateResult } from "./lib/pr-create.ts";
+
+// ── External intake adapters ────────────────────────────────────────────────
+export { fetchGitHubIssue, isGitHubIssueUrl } from "./lib/issue-adapter.ts";
+export {
+  extractAcceptanceCriteria,
+  filterPlanningComments,
+} from "./lib/issue-content-extractor.ts";