CLI Problem Solver

For cli-problem-solver, I intentionally kept commits quiet for a while. I was figuring out what this tool should really do: just call an LLM, or also keep local memory, search previous solutions, and feel like a true “context co-processor” for my terminal.
During this time I prototyped different flows locally (no commits), tried a few CLI designs, and thought a lot about how to balance AI calls with a fast local experience. Perplexity helped me explore options and refine the idea before I locked anything into the repo.
Once I felt I had a decent mental model (commands, history, basic architecture), I started committing the structure in bigger, more meaningful chunks instead of tiny incremental updates.

Título: Modularização Extrema, Rich CLI e a Grande Faxina no Flavortown
Data: 2026-02-25
Commits:

• 5ba3f12 — 🚀 REESTRUTURAÇÃO COMPLETA: O FLAVORTOWN AGORA É MODULAR! — 5ba3f12

Resumo: Adeus ao script único e bagunçado! Transformei o Flavortown em uma aplicação Python robusta, modular e visualmente incrível usando a biblioteca Rich para dominar o terminal.

O que foi feito:

• Arquitetura Modular (src/): Fiz o “de-coupling” total da lógica. O que antes era um emaranhado de funções no main.py agora está distribuído em módulos especializados:
  • src/ui: Toda a lógica de renderização e interação com o usuário.
  • src/quiz: O motor que controla o fluxo das perguntas e validações.
  • src/scoring: Sistema de cálculo e persistência de pontos.
  • src/problems: Gerenciamento dinâmico do banco de dados de desafios.
  • src/config: Centralização de constantes e caminhos do sistema.
• Centralização de Dados (data/): Criei uma “camada de persistência” real. Agora, questions.json e scores.json vivem em uma pasta dedicada, permitindo que eu adicione centenas de novos problemas sem precisar alterar uma única linha de código da lógica do quiz.
• Upgrade Visual com Rich: Implementei a biblioteca Rich para transformar a experiência de texto puro em algo profissional. Agora o Flavortown exibe as perguntas em painéis estilizados (Rich Panels), usa cores para indicar acertos ou erros e tabelas limpas para mostrar o desempenho. O terminal ganhou vida!
• Telemetria e Sync: Ajustei os utilitários de rastreamento para garantir que cada minuto codado no Termux seja computado corretamente pelo Wakatime/Hackatime. Corrigi bugs de pathing que faziam o tracker se perder durante a mudança para a estrutura src/.
• Refatoração e Limpeza: Removi arquivos temporários, templates HTML obsoletos do protótipo inicial e simplifiquei o ponto de entrada (main.py), que agora funciona apenas como o “orquestrador” do app.
  Ahh e a UX ficou até que interessante, o Rich Text CLI ajuda. 🙂👾

Título: Criação e Estruturação do Flavortown CLI Problem Solver
Commits:

• 3891434 — Reformulei o README com o link do design e tirei o projeto
• 1e3538c — chore: stop tracking .wakatime-project
• d1b0ec3 — chore: add .wakatime-project to .gitignore
• 9c2dabcf — chore: remove HTML design template and minor updates to main.py
• c647f39 — Initialize README with project details and instructions
• b0bb2a5 — refactor: reverte main.py para usar lista fixa (remove json)
• bc2d779 — feat: integra JSON de questoes e adiciona loop infinito

Resumo: Desenvolvimento inicial de um quiz CLI focado em lógica e programação, construído inteiramente em ambiente mobile (Termux/Acode).

O que foi feito:

• Implementação da lógica principal em Python (main.py) com sistema de quiz aleatório.
• Refatoração do banco de questões de JSON para lista interna para garantir portabilidade no MVP.
• Criação de sistema de validação de input com tratamento simples de strings (.lower() e .strip()).
• Design visual da identidade e landing page do projeto via Figma.
• Documentação completa do processo de desenvolvimento mobile e instruções de teste.
• Limpeza de arquivos de ambiente (.wakatime) e templates HTML obsoletos.

Resultados: CLI funcional operando via terminal, permitindo resolver problemas de lógica com feedback imediato. Design de interface concluído e documentado.

Próximos passos: Implementar sistema de pontuação acumulada, expandir o banco de perguntas e adicionar categorias de dificuldade.

Links do Projeto:
Design (Figma): https://www.figma.com/site/p8z5loosi9Lo5yZ4ayrYFp/CLI-Problem-Solver?node-id=0-1&t=Ds3KhPCdMtdeXuaJ-1
Timelapses (Hack Club):

• https://lapse.hackclub.com/timelapse/bn-VSIccCVrP
• https://lapse.hackclub.com/timelapse/X0uTiDgtooy5
• https://lapse.hackclub.com/timelapse/ngZbvjmv_t4y