Add --issue flag to run command for GitHub issue creation (#1883)

Author: Copilot

packages/api/src/run.ts

@@ -61,6 +61,7 @@ import {
   genaiscriptDebug,
   generateId,
   getRunDir,
+  githubCreateIssue,
   githubCreateIssueComment,
   githubCreatePullRequestReviews,
   githubParseEnv,
@@ -204,6 +205,7 @@ export async function runScriptInternal(
   const pullRequestComment = options.pullRequestComment;
   const pullRequestDescription = options.pullRequestDescription;
   const pullRequestReviews = options.pullRequestReviews;
+  const issue = options.issue;
   const teamsMessage = options.teamsMessage;
   const outData = options.outData;
   const label = options.label;
@@ -740,6 +742,33 @@ export async function runScriptInternal(
     }
   }
 
+  if (issue && result.text) {
+    dbg(`creating GitHub issue`);
+    const ghInfo = await resolveGitHubInfo();
+    if (
+      ghInfo.repository &&
+      (await confirmOrSkipInCI("Would you like to create a GitHub issue?", {
+        preview: result.text,
+      }))
+    ) {
+      // Generate title (simple approach for now, can be enhanced with small model later)
+      const firstLine = result.text.split('\n')[0]?.trim();
+      const shortContent = firstLine ? firstLine.substring(0, 60) : '';
+      let title = shortContent ? `${script.id}: ${shortContent}` : `Generated by ${script.id}`;
+      
+      // TODO: Enhance with small model title generation
+      // This could be implemented by creating a temporary script and running it with the small model,
+      // but for now we use a simpler approach to avoid complexity.
+
+      await githubCreateIssue(script, ghInfo, title, result.text, {
+        cancellationToken,
+        stats,
+      });
+    } else {
+      logError("GitHub issue creation: no repository information found");
+    }
+  }
+
   if (result.status === "success") logInfo(`genaiscript: ${result.status}`);
   else if (result.status === "cancelled") logWarn(`genaiscript: ${result.status}`);
   else logError(`genaiscript: ${result.status}`);

packages/cli/src/cli.ts

@@ -214,6 +214,7 @@ export async function cli(): Promise<void> {
     )
     .option("--out-changelog <string>", "output file for changelogs");
   addPullRequestOptions(run)
+    .option("--issue", "create a GitHub issue with the generation output")
     .option("--teams-message", "Posts a message to the teams channel")
     .option("-j, --json", "emit full JSON response to output")
     .option(`--fail-on-errors`, `fails on detected annotation error`)

packages/core/src/githubclient.ts

@@ -18,7 +18,7 @@ import { resolveRuntimeHost } from "./host.js";
 import { prettifyMarkdown } from "./pretty.js";
 import { arrayify } from "./cleaners.js";
 import { assert } from "./assert.js";
-import { logError, logVerbose } from "./util.js";
+import { logError, logVerbose, logWarn } from "./util.js";
 import { shellRemoveAsciiColors } from "./shell.js";
 import { isGlobMatch } from "./glob.js";
 import { concurrentLimit } from "./concurrency.js";
@@ -507,6 +507,66 @@ export async function githubCreateIssueComment(
   return r;
 }
 
+// Function to generate a title for a GitHub issue
+async function generateIssueTitle(
+  script: PromptScript,
+  body: string,
+): Promise<string> {
+  // For now, create a simple title based on the script and first line of body
+  const firstLine = body.split('\n')[0]?.trim();
+  const shortContent = firstLine ? firstLine.substring(0, 60) : '';
+  
+  if (shortContent) {
+    return `${script.id}: ${shortContent}`;
+  }
+  
+  return `Generated by ${script.id}`;
+}
+
+// https://docs.github.com/en/rest/issues/issues?apiVersion=2022-11-28#create-an-issue
+export async function githubCreateIssue(
+  script: PromptScript,
+  info: GithubConnectionInfo,
+  title: string,
+  body: string,
+  options?: CancellationOptions & { stats?: GenerationStats },
+): Promise<{ created: boolean; statusText: string; html_url?: string; issue_number?: number }> {
+  const { cancellationToken, stats } = options ?? {};
+  const { repository, token } = info;
+
+  if (!repository) {
+    dbg(`missing repository, cannot create issue`);
+    return { created: false, statusText: "missing repository" };
+  }
+  if (!token) {
+    dbg(`missing github token, cannot create issue`);
+    return { created: false, statusText: "missing github token" };
+  }
+
+  try {
+    // Create the GitHub client and create the issue
+    const client = new GitHubClient(info);
+    const issue = await client.createIssue(title, prettifyMarkdown(dedent(body)));
+    
+    const r = {
+      created: true,
+      statusText: "Created",
+      html_url: issue.html_url,
+      issue_number: issue.number,
+    };
+    
+    logVerbose(`GitHub issue created at ${r.html_url}`);
+    return r;
+  } catch (error) {
+    const errorMsg = errorMessage(error);
+    logError(`GitHub issue creation failed: ${errorMsg}`);
+    return {
+      created: false,
+      statusText: errorMsg,
+    };
+  }
+}
+
 async function githubCreatePullRequestReview(
   script: PromptScript,
   info: Pick<

packages/core/src/server/messages.ts

@@ -165,6 +165,7 @@ export interface PromptScriptRunOptions {
   pullRequestComment: string | boolean;
   pullRequestDescription: string | boolean;
   pullRequestReviews: boolean;
+  issue: boolean;
   teamsMessage: boolean;
   outData: string;
   label: string;