chore: develop work

Author: DiogoRibeiro7

.github/workflows/todo.yml

@@ -29,6 +29,9 @@ jobs:
           issue-title-template: src/templates/issueTitle.txt
           issue-body-template: src/templates/issueBody.md
           report: true
+          llm: true
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
 
       - name: Upload TODO report
         uses: actions/upload-artifact@v4
@@ -46,5 +49,4 @@ jobs:
           git add TODO_REPORT.md CHANGELOG.md
           git diff --cached --quiet && echo "No changes to commit." || git commit -m "chore(report): update TODO report and changelog [skip ci]"
           git push
-
   

action.yml

@@ -20,11 +20,19 @@ inputs:
     required: false
     description: Optional path to custom issue body template
 
+  llm:
+    required: false
+    description: Use LLM to generate issue titles and bodies
+    default: 'false'
+
+  openai-api-key:
+    required: false
+    description: OpenAI API key used when `llm` is true
+
 runs:
   using: 'node20'
   main: 'dist/index.js'
 
 branding:
   icon: 'check-circle'
   color: 'blue'
-

package.json

@@ -23,10 +23,11 @@
   "dependencies": {
     "@actions/core": "^1.10.0",
     "@actions/github": "^5.1.1",
-    "@octokit/rest": "^21.1.1"
+    "@octokit/rest": "^21.1.1",
+    "openai": "^4.95.0"
   },
   "devDependencies": {
-    "@types/node": "^20.11.17",
+    "@types/node": "^22.14.1",
     "@vercel/ncc": "^0.38.3",
     "@vitest/coverage-v8": "^3.1.1",
     "ts-node": "^10.9.2",

src/ActionMain.ts

@@ -18,6 +18,13 @@ async function run(): Promise<void> {
     const bodyTemplatePath = core.getInput('issue-body-template');
     const workspace = process.env.GITHUB_WORKSPACE || '.';
 
+    // LLM support
+    process.env.OPENAI_API_KEY = core.getInput('openai-api-key') || process.env.OPENAI_API_KEY;
+    const useLLM = core.getInput('llm') === 'true';
+    if (useLLM && !process.env.OPENAI_API_KEY) {
+      core.warning('⚠️ LLM is enabled, but OPENAI_API_KEY is not set.');
+    }
+
     const todos: TodoItem[] = extractTodosFromDir(workspace);
     const octokit = github.getOctokit(token);
     const { owner, repo } = github.context.repo;
@@ -63,4 +70,3 @@ async function run(): Promise<void> {
 }
 
 run();
-

src/core/issueManager.ts

@@ -1,13 +1,9 @@
 import * as core from '@actions/core';
 import * as github from '@actions/github';
 import { TodoItem } from '../parser/types';
-import {
-  LABELS_BY_TAG,
-  labelsFromMetadata,
-  ensureLabelExists,
-  labelsFromTodo // ⬅️ novo
-} from './labelManager';
+import { LABELS_BY_TAG, labelsFromMetadata, ensureLabelExists, labelsFromTodo } from './labelManager';
 import { loadTemplate, applyTemplate } from '../templates/utils';
+import { generateIssueTitleAndBodyLLM } from './llm/generateIssueContent';
 
 export async function getExistingIssueTitles(
   octokit: ReturnType<typeof github.getOctokit>,
@@ -45,50 +41,64 @@ export async function getExistingIssueTitles(
 }
 
 export async function createIssueIfNeeded(
-    octokit: ReturnType<typeof github.getOctokit>,
-    owner: string,
-    repo: string,
-    todo: TodoItem,
-    existingTitles: Set<string>,
-    titlePath?: string,
-    bodyPath?: string
-  ): Promise<void> {
-    const titleTemplate = loadTemplate('issueTitle.txt');
-    const bodyTemplate = loadTemplate('issueBody.md');
-  
-    const flattened = {
-        ...todo,
-        ...todo.metadata
-      } as Record<string, string | number>;
-      
-    const title = applyTemplate(titleTemplate, flattened);
-    const body = applyTemplate(bodyTemplate, flattened);
-      
-  
-    if (existingTitles.has(title)) {
-      core.info(`🟡 Skipping duplicate issue: ${title}`);
-      return;
-    }
-  
-    const labels = labelsFromTodo(todo);
+  octokit: ReturnType<typeof github.getOctokit>,
+  owner: string,
+  repo: string,
+  todo: TodoItem,
+  existingTitles: Set<string>,
+  titlePath?: string,
+  bodyPath?: string
+): Promise<void> {
+  const useLLM = core.getInput('llm') === 'true';
 
-  
-    for (const label of labels) {
-      await ensureLabelExists(octokit, owner, repo, label);
-    }
-  
+  let title: string;
+  let body: string;
+
+  if (useLLM) {
     try {
-      await octokit.rest.issues.create({
-        owner,
-        repo,
-        title,
-        body,
-        labels
-      });
-  
-      core.info(`✅ Created issue with labels [${labels.join(', ')}]: ${title}`);
+      const result = await generateIssueTitleAndBodyLLM(todo);
+      title = result.title;
+      body = result.body;
     } catch (err: any) {
-      core.warning(`⚠️ Failed to create issue for: ${title} — ${err.message}`);
+      core.warning(`⚠️ LLM fallback triggered for TODO: ${todo.text}`);
+      const titleTemplate = loadTemplate(titlePath || 'issueTitle.txt');
+      const bodyTemplate = loadTemplate(bodyPath || 'issueBody.md');
+      const flattened = { ...todo, ...todo.metadata } as Record<string, string | number>;
+      title = applyTemplate(titleTemplate, flattened);
+      body = applyTemplate(bodyTemplate, flattened);
     }
+  } else {
+    const titleTemplate = loadTemplate(titlePath || 'issueTitle.txt');
+    const bodyTemplate = loadTemplate(bodyPath || 'issueBody.md');
+    const flattened = { ...todo, ...todo.metadata } as Record<string, string | number>;
+    title = applyTemplate(titleTemplate, flattened);
+    body = applyTemplate(bodyTemplate, flattened);
+  }
+
+  if (existingTitles.has(title)) {
+    core.info(`🟡 Skipping duplicate issue: ${title}`);
+    return;
+  }
+
+  const labels = labelsFromTodo(todo);
+
+  for (const label of labels) {
+    await ensureLabelExists(octokit, owner, repo, label);
   }
+
+  try {
+    await octokit.rest.issues.create({
+      owner,
+      repo,
+      title,
+      body,
+      labels
+    });
+
+    core.info(`✅ Created issue with labels [${labels.join(', ')}]: ${title}`);
+  } catch (err: any) {
+    core.warning(`⚠️ Failed to create issue for: ${title} — ${err.message}`);
+  }
+}
+
 

src/core/llm/generateIssueContent.ts

@@ -0,0 +1,43 @@
+// src/core/llm/generateIssueContent.ts
+import { TodoItem } from '../../parser/types';
+import OpenAI from 'openai';
+
+const openai = new OpenAI({
+  apiKey: process.env.OPENAI_API_KEY || '', // ou core.getInput('openai-api-key')
+});
+
+export async function generateIssueTitleAndBodyLLM(todo: TodoItem): Promise<{ title: string; body: string }> {
+  const prompt = `
+You are a helpful assistant converting inline TODO comments from source code into GitHub Issues.
+
+The TODO is:
+- Tag: ${todo.tag}
+- Text: ${todo.text}
+- File: ${todo.file}
+- Line: ${todo.line}
+- Metadata: ${JSON.stringify(todo.metadata)}
+
+Generate a concise and descriptive GitHub issue title, followed by a detailed body with context.
+
+Format:
+TITLE: <title>
+BODY:
+<detailed body>
+`;
+
+  const response = await openai.chat.completions.create({
+    model: 'gpt-4',
+    messages: [{ role: 'user', content: prompt }],
+    temperature: 0.4,
+  });
+
+  const result = response.choices[0].message?.content || '';
+  const match = result.match(/TITLE:\s*(.+?)\s*BODY:\s*([\s\S]*)/i);
+
+  if (!match) {
+    throw new Error('Failed to parse LLM response.');
+  }
+
+  const [, title, body] = match;
+  return { title: title.trim(), body: body.trim() };
+}