Merge pull request #2 from DiogoRibeiro7/test/todo-action-issue-creation

test: add sample TODO to trigger issue creation via GitHub Action

Author: DiogoRibeiro7

.github/workflows/todo.yml

@@ -3,8 +3,6 @@ name: Smart TODO Check
 on:
   push:
     branches: [main]
-  pull_request:
-    branches: [main]
 
 jobs:
   smart-todo:
@@ -23,4 +21,4 @@ jobs:
       - name: Run Smart TODO Action
         uses: ./
         with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          repo-token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}

ROADMAP.md

@@ -1,157 +1,168 @@
-# 🗺️ Roadmap - Projeto `smart-todo-action`
+# 🗺️ Roadmap — `smart-todo-action`
 
-Um GitHub Action inteligente para rastrear, classificar e transformar TODOs do seu código em issues inteligentes e contextualizadas.
+A smart GitHub Action that detects, classifies, and transforms inline TODOs in your codebase into actionable GitHub Issues — with semantic analysis and integration with task management systems.
 
 ---
 
-## 🧱 Fase 1: Fundações e Paridade com Projeto Original
+## 🧱 Phase 1: Foundations & Core Features
 
-> Recriação da funcionalidade básica com código limpo, modular e testável.
+> Rebuild the original functionality with clean, modular, and testable code.
 
-- [ ] Estrutura inicial do projeto (`src/`, `core/`, `parser/`, etc.)
-- [ ] Parser de TODOs/FIXME/BUG com suporte multi-linguagem
-- [ ] Sistema de tarefas inicial: integração com GitHub Issues
-- [ ] Templates configuráveis para issues
-- [ ] Configuração como GitHub Action (`action.yml`, workflow exemplo)
-- [ ] Testes unitários com Jest/Vitest
+- [X] Project structure and folder setup (`src/`, `core/`, `parser/`, etc.)
+- [X] TODO/FIXME/BUG parser with multi-language support
+- [ ] Initial task system: GitHub Issues integration
+- [ ] Configurable issue templates
+- [ ] GitHub Action integration (`action.yml`, workflow example)
+- [ ] Unit tests with Vitest or Jest
 
 ---
 
-## 🧠 Fase 2: Inteligência e Semântica
+## 🧠 Phase 2: Intelligence & Semantics
 
-> Adição de inteligência artificial e compreensão semântica aos TODOs.
+> Bring context-awareness and automation through LLMs and structured tags.
 
-- [ ] Classificação automática (`bug`, `refactor`, `enhancement`, etc.)
-- [ ] Geração automática de títulos e descrições via LLM
-- [ ] Extração de `due date` e `priority` do texto dos TODOs
-- [ ] Suporte a tags especiais (`@assignee`, `#module`, etc.)
+- [ ] Automatic classification (`bug`, `refactor`, `enhancement`, etc.)
+- [ ] LLM-powered title/description generation  
+  _e.g., `Review sort algorithm` → `Optimize Sorting Algorithm for Edge Cases`_
+- [ ] Parse structured metadata: `priority`, `due`, etc.  
+  _e.g., `TODO(priority=high, due=2025-06-01): improve this logic`_
+- [ ] Support for structured tags (`@assignee`, `#module`, etc.)
 
 ---
 
-## 🌍 Fase 3: Suporte Estendido
+## 🌍 Phase 3: Extended Support
 
-> Tornar o projeto mais flexível, aplicável e adaptável a diferentes realidades.
+> Make the system flexible, extensible, and applicable to diverse environments.
 
-- [ ] Integração com outros task managers (Jira, Notion, Linear, Trello)
-- [ ] Internacionalização (detecção multilíngue de TODOs)
-- [ ] Suporte a arquivos `.ipynb`, `.yaml`, `.json`, `.xml`, etc.
+- [ ] Multi-platform task integration (GitHub, Jira, Notion, Trello, Linear)
+- [ ] Internationalization (i18n): multilingual TODO detection
+- [ ] File format support: `.ipynb`, `.yaml`, `.json`, `.xml`, etc.
 
 ---
 
-## 📊 Fase 4: Análise e Relatórios
+## 📊 Phase 4: Insights & Reporting
 
-> Adicionar insights e visualizações sobre o uso e evolução dos TODOs.
+> Provide visibility into the evolution and structure of tracked TODOs.
 
-- [ ] Geração de dashboard (markdown/HTML) com métricas
-- [ ] Agrupamento por pasta, prioridade, autor (`git blame`)
-- [ ] Histórico de mudanças nos TODOs
-- [ ] Notificações de TODOs próximos da data (`due date`)
+- [ ] Markdown/HTML dashboard with summary statistics  
+  _Total TODOs, grouped by folder, priority, author (`git blame`)_
+- [ ] TODO history tracking (added/removed/modified)
+- [ ] Due date notifications or PR comments
 
 ---
 
-## 🔁 Fase 5: Otimizações e Distribuição
+## 🔁 Phase 5: Optimization & Distribution
 
-> Melhorias finais para performance, manutenção e distribuição.
+> Final touches to ensure performance, scalability, and community usability.
 
-- [ ] Arquitetura modular e plugável
-- [ ] CLI standalone (fora do GitHub Actions)
-- [ ] >90% de cobertura de testes
-- [ ] Documentação completa
-- [ ] Publicação oficial no GitHub Marketplace
+- [ ] Plugin-based architecture
+- [ ] CLI support (standalone usage outside GitHub Actions)
+- [ ] >90% test coverage
+- [ ] Full documentation with usage examples
+- [ ] Publish to GitHub Marketplace
 
 ---
 
-# 🚀 Roadmap para TODO Issue Tracker 2.0
+## 📌 Notes
 
-Este projeto tem como objetivo construir uma GitHub Action inteligente para rastrear, classificar e transformar TODOs do seu código em issues contextualizadas, com suporte a análise semântica e integração com múltiplas plataformas.
+- Clean architecture and modularity are core principles from day one.
+- LLM functionality will be optional and clearly separated from core logic.
+- Built with automation, extensibility, and developer workflows in mind.
 
 ---
 
-## 🧱 Fase 1: Fundações e Paridade com o Projeto Original
+# 🚀 Roadmap for TODO Issue Tracker 2.0
 
-🎯 Objetivo: Recriar a funcionalidade original com código limpo, modular e testável.
+This project aims to build an intelligent GitHub Action that scans your codebase for TODOs, classifies them, and transforms them into contextualized GitHub Issues — with semantic analysis and multi-platform integration.
 
-- [ ] Criar estrutura base do projeto
-  - Pasta `src/` para código-fonte
-  - Subpastas: `core/`, `parser/`, `tasks/`, `templates/`, etc.
+---
+
+## 🧱 Phase 1: Foundations and Parity with the Original Project
+
+🎯 Goal: Recreate the original functionality with clean, modular, and testable code.
 
-- [ ] Implementar parser de TODOs
-  - Detectar comentários `TODO`, `FIXME`, `BUG`, etc.
-  - Suporte a múltiplas linguagens (`.js`, `.ts`, `.py`, `.go`, etc.)
+- [ ] Create the base project structure
+  - `src/` folder for source code
+  - Subfolders: `core/`, `parser/`, `tasks/`, `templates/`, etc.
 
-- [ ] Sistema de tarefas inicial: GitHub Issues
-  - Criar, atualizar e remover issues com base nos TODOs encontrados
+- [ ] Implement TODO parser
+  - Detect `TODO`, `FIXME`, `BUG`, etc. comments
+  - Support for multiple languages (`.js`, `.ts`, `.py`, `.go`, etc.)
 
-- [ ] Sistema de templates para criação de issues
-  - Títulos e descrições personalizáveis via templates
+- [ ] Initial task system: GitHub Issues
+  - Create, update, and remove issues based on detected TODOs
 
-- [ ] Workflow GitHub Action funcional
-  - Arquivo `action.yml`
-  - Exemplo de uso em `.github/workflows/todo.yml`
+- [ ] Templating system for issue creation
+  - Customizable titles and descriptions via templates
 
-- [ ] Testes unitários com Jest ou Vitest
+- [ ] Functional GitHub Action workflow
+  - `action.yml` definition file
+  - Example usage in `.github/workflows/todo.yml`
+
+- [ ] Unit testing with Jest or Vitest
 
 ---
 
-## 🧠 Fase 2: Inteligência e Semântica
+## 🧠 Phase 2: Intelligence and Semantics
 
-🎯 Objetivo: Tornar o sistema mais inteligente, aproveitando LLMs e contexto semântico.
+🎯 Goal: Make the system smarter by leveraging LLMs and contextual awareness.
 
-- [ ] Classificação automática de TODOs
-  - Usar LLMs ou regras heurísticas para classificar como `bug`, `enhancement`, `refactor`, etc.
+- [ ] Automatic TODO classification
+  - Use LLMs or heuristics to classify as `bug`, `enhancement`, `refactor`, etc.
 
-- [ ] Geração de título e descrição automática via LLM
-  - Exemplo: `Revisar algoritmo de ordenação` → `Optimize Sorting Algorithm for Edge Cases`
+- [ ] Auto-generate issue titles and descriptions using LLMs  
+  _Example: `Review sorting algorithm` → `Optimize Sorting Algorithm for Edge Cases`_
 
-- [ ] Extração de `due date` e `priority` via parsing
-  - Exemplo: `TODO(priority=high, due=2025-06-01): melhorar isso`
+- [ ] Extract `due date` and `priority` via inline metadata parsing  
+  _Example: `TODO(priority=high, due=2025-06-01): improve this logic`_
 
 ---
 
-## 🌍 Fase 3: Suporte Estendido
+## 🌍 Phase 3: Extended Support
 
-🎯 Objetivo: Tornar o sistema flexível e útil para ambientes diversos.
+🎯 Goal: Make the project adaptable to diverse environments and workflows.
 
-- [ ] Suporte a múltiplos sistemas de tarefas
-  - GitHub, Jira, Notion, Trello, Linear (via APIs)
+- [ ] Support for multiple task management platforms  
+  _GitHub, Jira, Notion, Trello, Linear (via APIs)_
 
-- [ ] Internacionalização (i18n)
-  - Detecção automática de TODOs em diversas línguas
+- [ ] Internationalization (i18n)  
+  _Detect TODOs written in different languages_
 
-- [ ] Suporte a mais formatos de arquivos
-  - `.ipynb`, `.yaml`, `.md`, `.json`, `.xml`, entre outros
+- [ ] Support for additional file types  
+  _`.ipynb`, `.yaml`, `.md`, `.json`, `.xml`, and more_
 
 ---
 
-## 📊 Fase 4: Análise e Relatórios
+## 📊 Phase 4: Analysis and Reporting
 
-🎯 Objetivo: Dar visibilidade sobre o estado e evolução dos TODOs.
+🎯 Goal: Provide visibility into the state and evolution of TODOs.
 
-- [ ] Dashboard em Markdown ou HTML
-  - Total de TODOs
-  - Agrupamento por pasta, prioridade, autor (via `git blame`)
+- [ ] Markdown/HTML dashboard with metrics  
+  _Total TODOs, grouped by folder, priority, author (`git blame`)_
 
-- [ ] Histórico de TODOs
-  - Rastrear adições e remoções ao longo do tempo
+- [ ] TODO history tracking  
+  _Track when TODOs are added, removed, or changed over time_
 
-- [ ] Notificações e lembretes
-  - Comentários automáticos em PRs/issues ao se aproximar a `due date`
+- [ ] Notifications and reminders  
+  _Comment on PRs or issues when due dates are approaching_
 
 ---
 
-## 🔁 Fase 5: Otimizações e Contribuições
+## 🔁 Phase 5: Optimizations and Contributions
 
-🎯 Objetivo: Garantir qualidade e facilitar manutenção.
+🎯 Goal: Ensure quality, performance, and ease of collaboration.
 
-- [ ] Arquitetura com módulos plugáveis
-- [ ] Cobertura de testes superior a 90%
-- [ ] Suporte a CLI standalone (fora do GitHub Actions)
-- [ ] Documentação completa com exemplos de uso
-- [ ] Publicação como GitHub Action oficial no Marketplace
+- [ ] Plugin-based modular architecture
+- [ ] CLI support (standalone usage outside GitHub Actions)
+- [ ] Test coverage >90%
+- [ ] Full documentation with usage examples
+- [ ] Publish to GitHub Marketplace as an official Action
 
 ---
 
-## 📌 Observações
+## 📌 Notes
+
+- Modularity, testability, and code clarity are priorities from day one.
+- LLM integration will be optional and cleanly decoupled from core logic.
+- Designed with automation, extensibility, and developer experience in mind.
 
-- Modularidade, testes e clareza são prioridades desde o início
-- Integração com LLMs será opcional e desacoplada do core

src/ActionMain.ts

@@ -10,21 +10,27 @@ async function run(): Promise<void> {
     const workspace = process.env.GITHUB_WORKSPACE || '.';
 
     const todos: TodoItem[] = extractTodosFromDir(workspace);
+    const octokit = github.getOctokit(token);
+    const { owner, repo } = github.context.repo;
 
-    core.info(`🔍 Encontrados ${todos.length} TODOs no repositório`);
+    core.info(`🔍 Found ${todos.length} TODOs`);
 
     for (const todo of todos) {
-      core.info(`📌 [${todo.tag}] ${todo.text} (${todo.file}:${todo.line})`);
-    }
+      const title = `[${todo.tag}] ${todo.text}`;
+      const body = `Found in \`${todo.file}:${todo.line}\`\n\n\`\`\`\n${todo.text}\n\`\`\``;
 
-    const octokit = github.getOctokit(token);
-    const { owner, repo } = github.context.repo;
+      await octokit.rest.issues.create({
+        owner,
+        repo,
+        title,
+        body
+      });
 
-    // No futuro: criar/atualizar issues aqui
+      core.info(`✅ Created issue: ${title}`);
+    }
 
-    core.info(`Contexto: ${owner}/${repo}`);
   } catch (error: any) {
-    core.setFailed(`Erro na execução: ${error.message}`);
+    core.setFailed(`Action failed: ${error.message}`);
   }
 }
 

src/testTodo.ts

@@ -0,0 +1,5 @@
+// src/testTodo.ts
+// TODO: Refactor this logic to improve performance
+export function testLogic() {
+    return Math.random();
+  }