brag-cli 0.1.0__tar.gz

brag_cli-0.1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.3
+Name: brag-cli
+Version: 0.1.0
+Summary: Add your description here
+Author: Antonio Henrique Machado
+Author-email: Antonio Henrique Machado <machadoah@proton.me>
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=15.0.0
+Requires-Dist: tomlkit>=0.15.0
+Requires-Dist: typer>=0.23.1
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+

brag_cli-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "brag-cli"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [{ name = "Antonio Henrique Machado", email = "machadoah@proton.me" }]
+requires-python = ">=3.14"
+dependencies = [
+    "httpx>=0.28.1",
+    "pydantic>=2.12.5",
+    "rich>=15.0.0",
+    "tomlkit>=0.15.0",
+    "typer>=0.23.1",
+]
+
+[project.scripts]
+brag = "brag_cli.main:app"
+
+[build-system]
+requires = ["uv_build>=0.11.6,<0.12.0"]
+build-backend = "uv_build"

brag_cli-0.1.0/src/brag_cli/commands/ai.py

@@ -0,0 +1,39 @@
+import typer
+import json
+from rich.console import Console
+from pathlib import Path
+from ..config import load_secrets, save_secrets
+
+ai_app = typer.Typer()
+console = Console()
+
+
+@ai_app.command("config-provider")
+def config_provider(
+    provider: str = typer.Option(..., prompt="Provider (ex: groq, openai, openrouter)"),
+    model: str = typer.Option(..., prompt="Model (ex: llama3-8b-8192, gpt-4o-mini)"),
+):
+    """Configura o provedor de IA e modelo no data/profile.json."""
+    profile_path = Path.cwd() / "profile.json"
+    if not profile_path.exists():
+        console.print(
+            "[red]Arquivo profile.json não encontrado na raiz. Rode `brag init` primeiro.[/red]"
+        )
+        raise typer.Exit(1)
+
+    data = json.loads(profile_path.read_text())
+    data["llm"] = {"provider": provider.lower(), "model": model}
+    profile_path.write_text(json.dumps(data, indent=2))
+    console.print(f"[green]Provedor configurado: {provider} / {model}[/green]")
+
+
+@ai_app.command("config-key")
+def config_key():
+    """Configura a chave do provider no secrets.toml (BYOK)."""
+    api_key = typer.prompt("Insira a API Key do seu provedor", hide_input=True)
+    secrets = load_secrets()
+    secrets["api_key"] = api_key
+    save_secrets(secrets)
+    console.print(
+        "[green]API Key salva com segurança no seu secrets.toml local.[/green]"
+    )

brag_cli-0.1.0/src/brag_cli/commands/svc.py

@@ -0,0 +1,55 @@
+import typer
+import subprocess
+from rich.console import Console
+from datetime import datetime
+from ..config import check_local_workspace
+
+svc_app = typer.Typer()
+console = Console()
+
+@svc_app.callback(invoke_without_command=True)
+def svc(
+    push: bool = typer.Option(False, "--push", help="Faz commit das alterações locais e push para o repositório remoto."),
+    pull: bool = typer.Option(False, "--pull", help="Faz pull das alterações mais recentes do repositório remoto.")
+):
+    """Sincroniza o repositório local (abstrai git pull e git push)."""
+    if not push and not pull:
+        console.print("[yellow]Forneça --push ou --pull[/yellow]")
+        return
+        
+    is_valid, msg = check_local_workspace()
+    if not is_valid:
+        console.print(f"[red]Erro:[/red] {msg}")
+        console.print("Rode [cyan]brag init[/cyan] ou entre no diretório correto.")
+        raise typer.Exit(1)
+        
+    if pull:
+        console.print("[dim]Executando git pull...[/dim]")
+        try:
+            subprocess.run(["git", "pull"], check=True)
+            console.print("[green]Sincronizado com sucesso (pull).[/green]")
+        except subprocess.CalledProcessError:
+            console.print("[red]Falha ao executar git pull.[/red]")
+            raise typer.Exit(1)
+            
+    if push:
+        console.print("[dim]Adicionando alterações ao git...[/dim]")
+        now = datetime.now()
+        commit_msg = f"{now.strftime('%Y-%m-%d %H:%M:%S')} - add entry for {now.strftime('%m')}/{now.strftime('%Y')}"
+        
+        try:
+            subprocess.run(["git", "add", "data/"], check=True)
+            status = subprocess.run(["git", "status", "--porcelain"], capture_output=True, text=True)
+            if not status.stdout.strip():
+                console.print("[yellow]Nenhuma alteração em 'data/' para enviar.[/yellow]")
+                return
+                
+            subprocess.run(["git", "commit", "-m", commit_msg], check=True)
+            console.print(f"[dim]Commit gerado: '{commit_msg}'[/dim]")
+            
+            console.print("[dim]Executando git push...[/dim]")
+            subprocess.run(["git", "push"], check=True)
+            console.print("[green]Alterações enviadas com sucesso (push).[/green]")
+        except subprocess.CalledProcessError as e:
+            console.print(f"[red]Falha ao sincronizar (push). Verifique seu remoto.[/red]")
+            raise typer.Exit(1)

brag_cli-0.1.0/src/brag_cli/config.py

@@ -0,0 +1,33 @@
+import json
+from pathlib import Path
+import tomlkit
+
+def get_secrets_file() -> Path:
+    return Path.cwd() / "secrets.toml"
+
+def load_secrets() -> dict:
+    secrets_file = get_secrets_file()
+    if not secrets_file.exists():
+        return {}
+    try:
+        with secrets_file.open("r") as f:
+            return tomlkit.load(f)
+    except Exception:
+        return {}
+
+def save_secrets(secrets: dict):
+    secrets_file = get_secrets_file()
+    with secrets_file.open("w") as f:
+        tomlkit.dump(secrets, f)
+
+def check_local_workspace():
+    """Valida se o diretório atual é um workspace válido do braguissimo."""
+    cwd = Path.cwd()
+    
+    if not (cwd / ".git").exists():
+        return False, "O diretório atual não é um repositório git."
+        
+    if not (cwd / "profile.json").exists():
+        return False, "Arquivo 'profile.json' não encontrado no diretório atual."
+        
+    return True, "OK"

brag_cli-0.1.0/src/brag_cli/llm.py

@@ -0,0 +1,56 @@
+import httpx
+from rich.console import Console
+
+console = Console()
+
+class LLMClient:
+    def __init__(self, provider: str, model: str, api_key: str):
+        self.provider = provider.lower()
+        self.model = model
+        self.api_key = api_key
+        
+        if self.provider == "groq":
+            self.base_url = "https://api.groq.com/openai/v1"
+        elif self.provider == "openai":
+            self.base_url = "https://api.openai.com/v1"
+        elif self.provider == "openrouter":
+            self.base_url = "https://openrouter.ai/api/v1"
+        else:
+            # Fallback to standard OpenAI compatibility format
+            self.base_url = "https://api.openai.com/v1"
+
+    def restructure_brag(self, title: str, description: str) -> str:
+        prompt = (
+            "Atue como um mentor de carreira especialista. Você receberá o título e a descrição de uma "
+            "conquista profissional (um 'brag'). Reescreva a descrição para torná-la mais profissional, "
+            "clara, focada em impacto e métricas, mas mantenha o texto em primeira pessoa. Não invente dados. "
+            "Responda APENAS com o texto reestruturado, sem introduções ou explicações.\n\n"
+            f"Título: {title}\n"
+            f"Descrição original: {description}"
+        )
+        
+        payload = {
+            "model": self.model,
+            "messages": [{"role": "user", "content": prompt}],
+            "temperature": 0.3
+        }
+        
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json"
+        }
+        
+        with console.status(f"[dim]Reestruturando brag usando {self.provider} ({self.model})...[/dim]"):
+            try:
+                resp = httpx.post(f"{self.base_url}/chat/completions", json=payload, headers=headers, timeout=30.0)
+                resp.raise_for_status()
+                data = resp.json()
+                return data["choices"][0]["message"]["content"].strip()
+            except httpx.HTTPError as e:
+                console.print(f"[red]Erro na chamada LLM: {e}[/red]")
+                if hasattr(e, 'response') and e.response:
+                    console.print(f"[dim]{e.response.text}[/dim]")
+                return description
+            except Exception as e:
+                console.print(f"[red]Erro interno no LLM: {e}[/red]")
+                return description

brag_cli-0.1.0/src/brag_cli/main.py

@@ -0,0 +1,280 @@
+import typer
+from rich.console import Console
+from datetime import datetime
+import json
+import uuid
+import subprocess
+from pathlib import Path
+
+from .commands.svc import svc_app
+from .commands.ai import ai_app
+from .config import check_local_workspace
+
+app = typer.Typer(name="braguissimo", help="CLI para registrar suas conquistas (Local + BYOS).")
+app.add_typer(svc_app, name="svc", help="Sincronização do repositório (push/pull)")
+app.add_typer(ai_app, name="ai", help="Comandos de IA e configuração de BYOK")
+console = Console()
+
+@app.command()
+def init():
+    """Inicializa um repositório local do braguissimo no diretório atual."""
+    cwd = Path.cwd()
+    
+    if (cwd / ".git").exists() and (cwd / "profile.json").exists():
+        console.print("[yellow]O repositório já está inicializado neste diretório.[/yellow]")
+        return
+        
+    console.print("[dim]Inicializando repositório Git local...[/dim]")
+    try:
+        subprocess.run(["git", "init"], check=True, capture_output=True)
+    except subprocess.CalledProcessError:
+        console.print("[red]Falha ao rodar git init. Você tem o git instalado?[/red]")
+        raise typer.Exit(1)
+        
+    owner = typer.prompt("Nome de usuário (github username)", default="")
+    
+    # Criar profile.json na raiz
+    profile_path = cwd / "profile.json"
+    if not profile_path.exists():
+        profile_path.write_text(json.dumps({
+            "name": owner, 
+            "created_at": datetime.utcnow().isoformat() + "Z",
+            "initialized": True
+        }, indent=2))
+        
+    # Criar .gitignore
+    gitignore_path = cwd / ".gitignore"
+    ignores = ["secrets.toml", ".venv/", "__pycache__/"]
+    if not gitignore_path.exists():
+        gitignore_path.write_text("\n".join(ignores) + "\n")
+    else:
+        content = gitignore_path.read_text()
+        to_append = [ign for ign in ignores if ign not in content]
+        if to_append:
+            with gitignore_path.open("a") as f:
+                f.write("\n" + "\n".join(to_append) + "\n")
+        
+    console.print("[green]Repositório inicializado com sucesso![/green]")
+    console.print("Adicione seu remote com: [cyan]git remote add origin <sua-url>[/cyan]")
+
+@app.command()
+def add(title: str = typer.Option(None, "--title", "-t", help="Título da conquista"),
+        description: str = typer.Option(None, "--message", "-m", help="Descrição livre"),
+        tags: str = typer.Option("", "--tags", help="Tags separadas por vírgula")):
+    """Adiciona um novo brag localmente."""
+    is_valid, msg = check_local_workspace()
+    if not is_valid:
+        console.print(f"[red]{msg}[/red]")
+        console.print("Rode [cyan]brag init[/cyan] primeiro neste diretório.")
+        raise typer.Exit(1)
+        
+    date_input = typer.prompt("Data (DD/MM/AAAA) [Deixe vazio para hoje]", default="", show_default=False)
+    if not date_input:
+        target_date = datetime.utcnow()
+    else:
+        try:
+            target_date = datetime.strptime(date_input, "%d/%m/%Y")
+        except ValueError:
+            console.print("[red]Formato de data inválido. Use DD/MM/AAAA.[/red]")
+            raise typer.Exit(1)
+            
+    if not title:
+        title = typer.prompt("Título da conquista")
+    if not description:
+        description = typer.prompt("Descrição")
+    if not tags:
+        tags = typer.prompt("Tags (separadas por vírgula)", default="", show_default=False)
+        
+    # AI Reestruturação
+    from .llm import LLMClient
+    from .config import load_secrets
+    
+    profile_path = Path.cwd() / "profile.json"
+    secrets = load_secrets()
+    api_key = secrets.get("api_key")
+    
+    if api_key and profile_path.exists():
+        try:
+            profile_data = json.loads(profile_path.read_text())
+            llm_config = profile_data.get("llm")
+            if llm_config and llm_config.get("provider") and llm_config.get("model"):
+                want_ai = typer.confirm("Você quer reestruturar o brag com IA?", default=True)
+                if want_ai:
+                    client = LLMClient(llm_config["provider"], llm_config["model"], api_key)
+                    new_desc = client.restructure_brag(title, description)
+                    console.print("\n[dim]--- Texto sugerido ---[/dim]")
+                    console.print(new_desc)
+                    console.print("[dim]------------------------[/dim]\n")
+                    if typer.confirm("Deseja usar essa nova descrição?", default=True):
+                        description = new_desc
+        except Exception as e:
+            console.print(f"[dim]Falha ao carregar IA: {e}[/dim]")
+            
+    tag_list = [t.strip() for t in tags.split(",") if t.strip()]
+    
+    brag = {
+        "id": str(uuid.uuid4()),
+        "date": target_date.isoformat() + "Z",
+        "title": title,
+        "description": description,
+        "tags": tag_list
+    }
+    
+    month_dir = Path.cwd() / "data" / "entries" / target_date.strftime('%Y')
+    month_dir.mkdir(parents=True, exist_ok=True)
+    
+    path = month_dir / f"{target_date.strftime('%m')}.json"
+    
+    if path.exists():
+        data = json.loads(path.read_text())
+        data.setdefault("entries", []).append(brag)
+    else:
+        data = {
+            "month": target_date.strftime('%B'),
+            "year": target_date.year,
+            "entries": [brag]
+        }
+        
+    path.write_text(json.dumps(data, indent=2))
+    console.print(f"[green]Brag adicionado localmente! (ID: {brag['id']})[/green]")
+    console.print("Use [cyan]brag svc --push[/cyan] para enviar ao repositório remoto.")
+
+@app.command()
+def list(month: str = typer.Option(None, help="Mês no formato MM"),
+         year: str = typer.Option(None, help="Ano no formato YYYY")):
+    """Lista os brags locais do período."""
+    is_valid, msg = check_local_workspace()
+    if not is_valid:
+        console.print(f"[red]{msg}[/red]")
+        raise typer.Exit(1)
+        
+    now = datetime.now()
+    m = month or now.strftime('%m')
+    y = year or now.strftime('%Y')
+    
+    path = Path.cwd() / "data" / "entries" / y / f"{m}.json"
+    
+    if not path.exists():
+        console.print("[yellow]Nenhum brag encontrado localmente para este período.[/yellow]")
+        return
+        
+    data = json.loads(path.read_text())
+    entries = data.get("entries", [])
+    
+    if not entries:
+        console.print("[yellow]Nenhum brag encontrado localmente para este período.[/yellow]")
+        return
+        
+    for entry in entries:
+        console.print(f"\n[cyan]{entry['title']}[/cyan] ({entry.get('date', '')})")
+        console.print(f"ID: [dim]{entry['id']}[/dim]")
+        console.print(f"{entry['description']}")
+        if entry.get('tags'):
+            console.print(f"Tags: {', '.join(entry['tags'])}")
+
+@app.command()
+def edit(id: str):
+    """Permite editar um brag local específico."""
+    console.print(f"[yellow]O arquivo é local! Você pode editá-lo diretamente em `data/entries/` com seu editor preferido.[/yellow]")
+
+@app.command()
+def delete(id: str):
+    """Remove um brag específico."""
+    console.print(f"[yellow]O arquivo é local! Você pode remover a entrada do JSON em `data/entries/`.[/yellow]")
+
+@app.command()
+def status():
+    """Exibe o status do repositório local e métricas rápidas."""
+    is_valid, msg = check_local_workspace()
+    if not is_valid:
+        console.print(f"[red]{msg}[/red]")
+        raise typer.Exit(1)
+        
+    from .stats import get_git_info, get_all_brags, get_current_month_count
+    from rich.table import Table
+    from rich.panel import Panel
+    
+    profile_path = Path.cwd() / "profile.json"
+    owner = "Desconhecido"
+    if profile_path.exists():
+        try:
+            owner = json.loads(profile_path.read_text()).get("name", "Desconhecido")
+        except Exception:
+            pass
+            
+    git_info = get_git_info()
+    brags = get_all_brags()
+    current_count = get_current_month_count(brags)
+    
+    table = Table(show_header=False, box=None, expand=True)
+    table.add_column("Chave", style="dim", width=25)
+    table.add_column("Valor", style="bold")
+    
+    table.add_row("Usuário", f"[cyan]{owner}[/cyan]")
+    table.add_row("Repositório Remoto", f"{git_info['remote_url']}")
+    
+    changes_str = "[yellow]Existem alterações não sincronizadas[/yellow]" if git_info['has_changes'] else "[green]Tudo sincronizado[/green]"
+    table.add_row("Status Git", changes_str)
+    
+    table.add_row("Brags neste mês", f"{current_count}")
+    table.add_row("Brags no total", f"{len(brags)}")
+    
+    panel = Panel(table, title="📊 Braguíssimo Status", border_style="blue", expand=True)
+    console.print(panel)
+
+@app.command()
+def analytics():
+    """Exibe um dashboard com métricas detalhadas de uso."""
+    is_valid, msg = check_local_workspace()
+    if not is_valid:
+        console.print(f"[red]{msg}[/red]")
+        raise typer.Exit(1)
+        
+    from .stats import get_all_brags, get_monthly_stats, get_tag_stats
+    from rich.table import Table
+    from rich.panel import Panel
+    
+    brags = get_all_brags()
+    if not brags:
+        console.print("[yellow]Você ainda não registrou nenhum brag para analisar.[/yellow]")
+        return
+        
+    counts, top_month, top_count = get_monthly_stats(brags)
+    tags_freq = get_tag_stats(brags)
+    
+    # 1. Tabela Geral
+    overview_table = Table(title="Visão Geral", show_header=False, box=None, expand=True)
+    overview_table.add_column("Métrica", style="dim")
+    overview_table.add_column("Valor", style="bold")
+    overview_table.add_row("Total de Entradas", str(len(brags)))
+    if top_month:
+        overview_table.add_row("Mês Mais Produtivo", f"{top_month} ({top_count} brags)")
+    
+    # 2. Distribuição de Tags
+    tag_table = Table(title="Top Tags", show_edge=False, header_style="dim", expand=True)
+    tag_table.add_column("Tag")
+    tag_table.add_column("Uso", justify="right")
+    
+    for tag, freq in tags_freq[:5]:
+        tag_table.add_row(f"[cyan]{tag}[/cyan]", str(freq))
+        
+    if not tags_freq:
+        tag_table.add_row("Nenhuma tag", "0")
+        
+    # 3. Timeline de Meses
+    timeline_table = Table(title="Atividade por Mês", show_edge=False, header_style="dim", expand=True)
+    timeline_table.add_column("Mês")
+    timeline_table.add_column("Volume", justify="left")
+    timeline_table.add_column("Qtd", justify="right")
+    
+    for month_key in sorted(counts.keys()):
+        qtd = counts[month_key]
+        bar = "█" * min(qtd, 40)
+        timeline_table.add_row(month_key, f"[green]{bar}[/green]", str(qtd))
+        
+    console.print(Panel(overview_table, border_style="blue", expand=True))
+    console.print(Panel(tag_table, border_style="cyan", expand=True))
+    console.print(Panel(timeline_table, border_style="green", expand=True))
+
+if __name__ == "__main__":
+    app()

brag_cli-0.1.0/src/brag_cli/stats.py

@@ -0,0 +1,83 @@
+import json
+import subprocess
+from pathlib import Path
+from datetime import datetime
+from collections import Counter, defaultdict
+
+def get_git_info():
+    """Retorna um dicionário com status git (has_changes, remote_url)."""
+    info = {"has_changes": False, "remote_url": "Sem remote configurado"}
+    try:
+        # Pega a origin URL
+        remote = subprocess.run(["git", "remote", "get-url", "origin"], capture_output=True, text=True)
+        if remote.returncode == 0:
+            info["remote_url"] = remote.stdout.strip()
+            
+        # Pega as modificações locais em data/ ou em tudo
+        status = subprocess.run(["git", "status", "--porcelain"], capture_output=True, text=True)
+        if status.stdout.strip():
+            info["has_changes"] = True
+    except FileNotFoundError:
+        pass
+    except subprocess.CalledProcessError:
+        pass
+    return info
+
+def get_all_brags():
+    """Lê todos os JSONs e retorna a lista combinada de todos os brags."""
+    cwd = Path.cwd()
+    entries_dir = cwd / "data" / "entries"
+    
+    all_brags = []
+    if not entries_dir.exists():
+        return all_brags
+        
+    for json_file in entries_dir.rglob("*.json"):
+        try:
+            data = json.loads(json_file.read_text())
+            for entry in data.get("entries", []):
+                all_brags.append(entry)
+        except Exception:
+            pass
+            
+    # Sort por date descendente
+    all_brags.sort(key=lambda x: x.get("date", ""), reverse=True)
+    return all_brags
+
+def get_monthly_stats(brags):
+    """
+    Agrupa os brags por YYYY-MM.
+    Retorna (timeline_dict, top_month, top_month_count).
+    """
+    counts = defaultdict(int)
+    for b in brags:
+        date_str = b.get("date", "")
+        if len(date_str) >= 7:
+            month_key = date_str[:7] 
+            counts[month_key] += 1
+            
+    top_month = None
+    top_count = 0
+    if counts:
+        top_month = max(counts, key=counts.get)
+        top_count = counts[top_month]
+        
+    return counts, top_month, top_count
+
+def get_tag_stats(brags):
+    """Calcula frequência de tags."""
+    tag_counter = Counter()
+    for b in brags:
+        for t in b.get("tags", []):
+            if t:
+                tag_counter[t] += 1
+    return tag_counter.most_common()
+
+def get_current_month_count(brags):
+    now_prefix = datetime.now().strftime("%Y-%m")
+    count = 0
+    for b in brags:
+        date_str = b.get("date", "")
+        if date_str.startswith(now_prefix):
+            count += 1
+    return count