goodfella 0.1.2__tar.gz

goodfella-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+# Adicionar CD e criação de release futuramente
+
+name: CI 
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Install uv and set up Python
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Run pytest
+        run: uv run pytest

goodfella-0.1.2/.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+name: Release & Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  github-release:
+    name: Generate GitHub Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+
+  pypi-publish:
+    name: Build and publish to PyPI
+    needs: github-release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/goodfella
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

goodfella-0.1.2/.gitignore

@@ -0,0 +1,25 @@
+.goodfella/
+
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+.venv/
+venv/
+
+.vscode/
+.idea/
+*.swp
+*.swo
+
+.DS_Store
+Thumbs.db
+
+.env
+.env.local
+
+brainstorm.md

goodfella-0.1.2/.python-version

@@ -0,0 +1 @@
+3.11

goodfella-0.1.2/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2026 Bruno
+
+All rights reserved.
+
+The source code in this repository is provided for viewing and educational purposes only.
+
+You are NOT permitted to:
+- Modify, adapt, or create derivative works from this software.
+- Distribute, publish, or share this software or any part of it.
+- Use this software for any commercial purposes.
+
+Any use of this software outside of personal viewing requires explicit prior written permission from the copyright holder.

goodfella-0.1.2/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: goodfella
+Version: 0.1.2
+Summary: Strict Pair Programmer CLI — AI-powered software architecture reviewer
+Project-URL: Homepage, https://github.com/BrunoSaintClair/goodfella-ai
+Project-URL: Repository, https://github.com/BrunoSaintClair/goodfella-ai.git
+Project-URL: Bug Tracker, https://github.com/BrunoSaintClair/goodfella-ai/issues
+Author-email: Bruno Saint Clair <brunosaint.dev@gmail.com>
+License: Copyright (c) 2026 Bruno
+        
+        All rights reserved.
+        
+        The source code in this repository is provided for viewing and educational purposes only.
+        
+        You are NOT permitted to:
+        - Modify, adapt, or create derivative works from this software.
+        - Distribute, publish, or share this software or any part of it.
+        - Use this software for any commercial purposes.
+        
+        Any use of this software outside of personal viewing requires explicit prior written permission from the copyright holder.
+License-File: LICENSE
+Keywords: ai,architecture,cli,goodfella,llm,pair-programming,rag
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.11
+Requires-Dist: chromadb>=0.5
+Requires-Dist: langchain-anthropic>=0.3
+Requires-Dist: langchain-community>=0.3
+Requires-Dist: langchain-google-genai>=2.0
+Requires-Dist: langchain-ollama>=0.3
+Requires-Dist: langchain-openai>=0.3
+Requires-Dist: langchain>=0.3
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# 🎩 Goodfella
+
+**Strict Pair Programmer CLI** — Um assistente de IA focado estritamente em Engenharia de Software que atua como um Pair Programmer Rigoroso e Arquiteto de Software.
+
+## O que é?
+
+O Goodfella analisa códigos, detecta violações de princípios (SOLID, Clean Architecture, DDD, etc.) e sugere melhorias. Ele **não altera código diretamente** — apenas aconselha.
+
+## Características
+
+- 🔒 **Local-First** — Processamento padrão 100% local via Ollama
+- ☁️ **Multi-Provedor** — Suporte a OpenAI, Anthropic, Gemini
+- 🧠 **RAG Inteligente** — Base vetorial com ChromaDB embutido
+- 📂 **Isolamento por Projeto** — Contextos independentes por diretório
+- 💬 **Chat Interativo** — REPL fluido no terminal com Rich
+
+## Instalação
+
+### Via pip (quando publicado)
+
+```bash
+pip install goodfella
+```
+
+### Via código-fonte
+
+```bash
+git clone <repo-url>
+cd goodfella
+uv sync
+uv run goodfella
+```
+
+## Uso
+
+```bash
+# Inicia o chat interativo no diretório do seu projeto
+$ goodfella
+```
+
+### Comandos Principais
+
+| Comando | Descrição |
+|---------|-----------|
+| `/review` | Revisão estrita de Clean Architecture/SOLID |
+| `/deep-review` | Análise completa via modelo Cloud (bypass do RAG) |
+| `/setup` | Assistente de configuração de provedor |
+| `/status` | Saúde do sistema e provedor ativo |
+| `/rule add` | Adicionar regra customizada |
+| `/rebuild` | Reconstruir banco vetorial do zero |
+| `/quit` | Encerrar e salvar histórico |
+
+## Stack Técnica
+
+- **Python** + **uv**
+- **LangChain** — Orquestração de IA
+- **ChromaDB** — Banco vetorial embutido
+- **Rich** — Interface de terminal
+- **Ollama** — LLM local (padrão)
+
+## Licença
+
+Proprietary / All Rights Reserved
+
+O código-fonte é disponibilizado apenas para visualização e fins educacionais. É estritamente proibido modificar, distribuir, sublicenciar ou utilizar este projeto (ou qualquer parte dele) para fins comerciais sem autorização prévia por escrito.

goodfella-0.1.2/README.md

@@ -0,0 +1,65 @@
+# 🎩 Goodfella
+
+**Strict Pair Programmer CLI** — Um assistente de IA focado estritamente em Engenharia de Software que atua como um Pair Programmer Rigoroso e Arquiteto de Software.
+
+## O que é?
+
+O Goodfella analisa códigos, detecta violações de princípios (SOLID, Clean Architecture, DDD, etc.) e sugere melhorias. Ele **não altera código diretamente** — apenas aconselha.
+
+## Características
+
+- 🔒 **Local-First** — Processamento padrão 100% local via Ollama
+- ☁️ **Multi-Provedor** — Suporte a OpenAI, Anthropic, Gemini
+- 🧠 **RAG Inteligente** — Base vetorial com ChromaDB embutido
+- 📂 **Isolamento por Projeto** — Contextos independentes por diretório
+- 💬 **Chat Interativo** — REPL fluido no terminal com Rich
+
+## Instalação
+
+### Via pip (quando publicado)
+
+```bash
+pip install goodfella
+```
+
+### Via código-fonte
+
+```bash
+git clone <repo-url>
+cd goodfella
+uv sync
+uv run goodfella
+```
+
+## Uso
+
+```bash
+# Inicia o chat interativo no diretório do seu projeto
+$ goodfella
+```
+
+### Comandos Principais
+
+| Comando | Descrição |
+|---------|-----------|
+| `/review` | Revisão estrita de Clean Architecture/SOLID |
+| `/deep-review` | Análise completa via modelo Cloud (bypass do RAG) |
+| `/setup` | Assistente de configuração de provedor |
+| `/status` | Saúde do sistema e provedor ativo |
+| `/rule add` | Adicionar regra customizada |
+| `/rebuild` | Reconstruir banco vetorial do zero |
+| `/quit` | Encerrar e salvar histórico |
+
+## Stack Técnica
+
+- **Python** + **uv**
+- **LangChain** — Orquestração de IA
+- **ChromaDB** — Banco vetorial embutido
+- **Rich** — Interface de terminal
+- **Ollama** — LLM local (padrão)
+
+## Licença
+
+Proprietary / All Rights Reserved
+
+O código-fonte é disponibilizado apenas para visualização e fins educacionais. É estritamente proibido modificar, distribuir, sublicenciar ou utilizar este projeto (ou qualquer parte dele) para fins comerciais sem autorização prévia por escrito.

goodfella-0.1.2/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "goodfella"
+version = "0.1.2"
+description = "Strict Pair Programmer CLI — AI-powered software architecture reviewer"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [
+    { name = "Bruno Saint Clair", email = "brunosaint.dev@gmail.com" }
+]
+license = { file = "LICENSE" }
+keywords = ["ai", "cli", "pair-programming", "rag", "architecture", "llm", "goodfella"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Quality Assurance",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "langchain>=0.3",
+    "langchain-community>=0.3",
+    "langchain-ollama>=0.3",
+    "langchain-openai>=0.3",
+    "langchain-google-genai>=2.0",
+    "langchain-anthropic>=0.3",
+    "chromadb>=0.5",
+    "rich>=13.0",
+    "prompt-toolkit>=3.0",
+    "pydantic>=2.0",
+    "pydantic-settings>=2.0",
+    "python-dotenv>=1.0",
+    "questionary>=2.1.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/BrunoSaintClair/goodfella-ai"
+Repository = "https://github.com/BrunoSaintClair/goodfella-ai.git"
+"Bug Tracker" = "https://github.com/BrunoSaintClair/goodfella-ai/issues"
+
+[project.scripts]
+goodfella = "goodfella.cli.app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/goodfella"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[dependency-groups]
+dev = ["pytest>=8.0.0"]

goodfella-0.1.2/src/goodfella/__init__.py

@@ -0,0 +1,3 @@
+"""Goodfella"""
+
+__version__ = "0.1.0"

goodfella-0.1.2/src/goodfella/cli/__init__.py

@@ -0,0 +1 @@
+"""Goodfella CLI — Camada de interface do terminal."""

goodfella-0.1.2/src/goodfella/cli/app.py

@@ -0,0 +1,144 @@
+"""
+Entry point principal do Goodfella CLI.
+
+Este módulo contém a função `main()` que é registrada como console_script
+no pyproject.toml, permitindo invocar o Goodfella diretamente via terminal:
+
+    $ goodfella
+
+"""
+
+
+import sys
+import logging
+import warnings
+
+# Suprime warnings e logs de bibliotecas de terceiros (ChromaDB, Langchain, etc)
+warnings.filterwarnings("ignore")
+logging.getLogger("chromadb").setLevel(logging.ERROR)
+logging.getLogger("httpx").setLevel(logging.ERROR)
+
+from langchain_core.messages import SystemMessage, HumanMessage
+
+from goodfella.core.env import init_environment
+from goodfella.rag.chunker import run_indexing_pipeline
+from goodfella.knowledge.rules import sync_rules
+from goodfella.llm.factory import get_llm
+from goodfella.llm.memory import load_history, save_message, clear_history
+from goodfella.cli.ui import console, show_spinner
+from goodfella.cli.commands import handle_setup, handle_status, handle_refresh, handle_rebuild, handle_help, handle_review, handle_deep_review, handle_rule_add
+
+def print_welcome():
+    console.print("\n[bold magenta]🎩 Goodfella AI Pair Programmer[/bold magenta]")
+    console.print("[info]Digite /help para ver a lista de comandos disponíveis.[/info]\n")
+
+def main() -> None:
+    """Ponto de entrada principal do comando `goodfella`.
+
+    Inicializa o ambiente, sincroniza a base vetorial e
+    inicia o loop REPL interativo com o usuário.
+    """
+    try:
+        # 1. Setup do ambiente e Banco de Dados
+        init_environment()
+        
+        with show_spinner("Sincronizando base de código e regras..."):
+            sync_rules()
+            run_indexing_pipeline()
+            # 2. Inicialização da Instância LangChain
+            llm = get_llm()
+        
+        print_welcome()
+        
+        # 3. Loop REPL Interativo
+        while True:
+            try:
+                user_input = console.input("[bold blue]❯[/bold blue] ")
+            except (KeyboardInterrupt, EOFError):
+                break
+                
+            if not user_input.strip():
+                continue
+                
+            cmd = user_input.strip().lower()
+            if cmd in ["/exit", "/quit"]:
+                break
+            elif cmd == "/clear":
+                console.clear()
+                print_welcome()
+                continue
+            elif cmd == "/reset":
+                clear_history()
+                console.print("[info]Histórico apagado.[/info]\n")
+                continue
+            elif cmd == "/setup":
+                handle_setup()
+                continue
+            elif cmd == "/status":
+                handle_status()
+                continue
+            elif cmd == "/refresh":
+                handle_refresh()
+                continue
+            elif cmd == "/rebuild":
+                handle_rebuild()
+                continue
+            elif cmd == "/help":
+                handle_help()
+                continue
+            elif cmd.startswith("/rule add"):
+                handle_rule_add()
+                continue
+                
+            # Prepara a janela de contexto
+            history = load_history()
+            
+            if cmd.startswith("/review"):
+                user_msg, sys_prompt = handle_review(cmd)
+                if not user_msg:
+                    continue
+                user_input = user_msg
+                system_prompt = sys_prompt
+            elif cmd.startswith("/deep-review"):
+                user_msg, sys_prompt = handle_deep_review(cmd)
+                if not user_msg:
+                    continue
+                user_input = user_msg
+                system_prompt = sys_prompt
+            else:
+                system_prompt = (
+                    "Você é o Goodfella, um AI Pair Programmer local-first ultra focado em "
+                    "engenharia de software pragmática. Responda sempre em português, de forma direta."
+                )
+            
+            messages = [SystemMessage(content=system_prompt)]
+            messages.extend(history)
+            messages.append(HumanMessage(content=user_input))
+            
+            console.print("\n[bold magenta]❖[/bold magenta] ", end="")
+            full_response = ""
+            
+            try:
+                for chunk in llm.stream(messages):
+                    print(chunk.content, end="", flush=True)
+                    full_response += chunk.content
+            except Exception as e:
+                error_msg = str(e)
+                if "Connection refused" in error_msg or "Errno 111" in error_msg:
+                    console.print("\n[danger]Erro: Não foi possível conectar ao Ollama (Connection refused).[/danger]")
+                    console.print("[info]Dica: Verifique se o Ollama está rodando no seu terminal com 'ollama serve'.[/info]")
+                    console.print("[info]Se deseja usar OpenAI ou Gemini, configure-os usando o comando /setup.[/info]")
+                else:
+                    console.print(f"\n[danger]Erro de LLM: {error_msg}[/danger]")
+                continue
+            print("\n")
+            
+            save_message("user", user_input)
+            save_message("ai", full_response)
+            
+    except Exception as e:
+        console.print(f"\n[danger]Erro Fatal: {e}[/danger]")
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()