bugcap 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,290 @@
+<p align="center">
+  <pre align="center">
+ ____  _   _  ____     ____    _    ____
+| __ )| | | |/ ___|   / ___|  / \  |  _ \
+|  _ \| | | | |  _   | |     / _ \ | |_) |
+| |_) | |_| | |_| |  | |___ / ___ \|  __/
+|____/ \___/ \____|   \____/_/   \_\_|
+  </pre>
+</p>
+
+<h3 align="center">🐛 Transforme sua programação com IA em um idle game no terminal</h3>
+
+<p align="center">
+  <a href="#instalacao">Instalacao</a> •
+  <a href="#como-funciona">Como Funciona</a> •
+  <a href="#comandos">Comandos</a> •
+  <a href="#mecanicas">Mecanicas</a> •
+  <a href="#multi-projeto">Multi-Projeto</a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/npm/v/bugcap?color=green&label=version" alt="version" />
+  <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen" alt="node" />
+  <img src="https://img.shields.io/badge/license-MIT-blue" alt="license" />
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey" alt="platform" />
+</p>
+
+---
+
+**Bug Capitalist** e um idle game de terminal que transforma sua atividade de programacao com ferramentas de IA (Claude Code, Cursor, Copilot, Aider, etc.) em gameplay. Cada arquivo que voce modifica gera tokens, bugs e dinheiro — tudo sem sair do terminal.
+
+Zero configuracao. Zero integracao. So rodar e programar.
+
+---
+
+## Por que?
+
+Voce ja passa horas programando com IA. O Bug Capitalist gamifica isso: monitora as mudancas nos seus arquivos em tempo real e converte sua produtividade em recompensas. E um incentivo divertido pra quem vive no terminal.
+
+---
+
+<h2 id="instalacao">Instalacao</h2>
+
+```bash
+# Rodar direto sem instalar
+npx bugcap
+
+# Ou instalar globalmente
+npm install -g bugcap
+```
+
+> Requer **Node.js 18+**
+
+---
+
+<h2 id="como-funciona">Como Funciona</h2>
+
+```
+  Voce programa com IA
+        |
+        v
+  Arquivos mudam no disco
+        |
+        v
+  Bug Capitalist detecta as mudancas
+        |
+        v
+  Tokens gerados --> XP acumulado --> Level up!
+        |
+        v
+  Bugs aparecem (aleatorio) --> Auto-vendidos --> $$$ no bolso
+```
+
+O Bug Capitalist **nunca le o conteudo dos seus arquivos** — ele apenas observa mudancas de tamanho (linhas adicionadas/removidas). Seus dados sao somente seus.
+
+---
+
+<h2 id="comandos">Comandos</h2>
+
+### Iniciar o jogo (watcher + interface)
+
+```bash
+npx bugcap
+```
+
+Abre a interface TUI interativa e comeca a monitorar o diretorio atual. Basta programar normalmente e ver os numeros subirem.
+
+### Monitorar um diretorio adicional (headless)
+
+```bash
+npx bugcap watch ~/projetos/meu-app
+```
+
+Roda em modo headless (sem interface), enviando os dados para o estado compartilhado. Perfeito para monitorar multiplos projetos simultaneamente.
+
+### Resetar o progresso
+
+```bash
+npx bugcap reset          # Com confirmacao
+npx bugcap reset --force  # Sem confirmacao
+```
+
+---
+
+<h2 id="mecanicas">Mecanicas do Jogo</h2>
+
+### Tokens
+
+Toda mudanca em arquivo gera tokens. A taxa base e **5 tokens por linha modificada**.
+
+### Bugs
+
+Mudancas mais intensas tem chance de gerar bugs:
+
+| Linhas modificadas | Chance de bug |
+|--------------------|---------------|
+| 1-49               | 15%           |
+| 50-99              | 25%           |
+| 100-149            | 35%           |
+| 150+               | 45%           |
+
+Bugs sao **vendidos automaticamente** assim que aparecem.
+
+### Dinheiro (Bug Bounty)
+
+O preco de cada bug depende do seu level:
+
+```
+Preco = $25 x multiplicador do level
+```
+
+| Level | Multiplicador | Preco por Bug |
+|-------|---------------|---------------|
+| 1     | 1.00x         | $25.00        |
+| 2     | 1.25x         | $31.25        |
+| 5     | 2.00x         | $50.00        |
+| 10    | 3.25x         | $81.25        |
+
+### XP e Levels
+
+- Ganho: **0.1 XP por token**
+- Para subir do level N para N+1, voce precisa de **N x 500 XP**
+- Levels aumentam o multiplicador de venda de bugs
+
+---
+
+## Interface
+
+### Modo Normal (terminais >= 60 colunas)
+
+```
+ ____  _   _  ____     ____    _    ____
+| __ )| | | |/ ___|   / ___|  / \  |  _ \
+|  _ \| | | | |  _   | |     / _ \ | |_) |
+| |_) | |_| | |_| |  | |___ / ___ \|  __/
+|____/ \___/ \____|   \____/_/   \_\_|
+
+              [● LIVE]
+
+        ┌─────────────────┐
+        │   Bug Bounty     │
+        │     $1,250       │
+        └─────────────────┘
+
+  Level: 3    Bugs: 38    Tokens: 12,400
+
+  XP: [████████████░░░░░░░░] 62%
+
+  Recent Activity:
+  $ Bug sold — +$37.50              2s
+  🐛 Bug detected — queued          2s
+  ⚡ 45 lines added — +200 tokens   5s
+```
+
+### Modo Compacto (terminais < 60 colunas)
+
+```
+[●] BUG CAP $1,250 | Lv3 | T:12,400 | B:38
+```
+
+---
+
+<h2 id="multi-projeto">Monitorando Multiplos Projetos</h2>
+
+Abra terminais separados para cada projeto:
+
+```bash
+# Terminal 1 — projeto principal + interface
+cd ~/projetos/api && npx bugcap
+
+# Terminal 2 — projeto frontend (headless)
+npx bugcap watch ~/projetos/frontend
+
+# Terminal 3 — projeto mobile (headless)
+npx bugcap watch ~/projetos/mobile
+```
+
+Todos os watchers escrevem no mesmo estado (`~/.bugcap/state.json`), e a interface principal reflete toda a atividade.
+
+---
+
+## Diretorios Ignorados
+
+O watcher automaticamente ignora:
+
+```
+.git, node_modules, vendor, dist, build,
+.next, __pycache__, .venv, target
+```
+
+Tambem respeita padroes do `.gitignore` se existir.
+
+---
+
+## Armazenamento
+
+Os dados do jogo ficam em `~/.bugcap/`:
+
+| Arquivo        | Descricao                                       |
+|----------------|------------------------------------------------|
+| `state.json`   | Estado atual do jogo (tokens, bugs, level, $)  |
+| `events.jsonl` | Log de eventos (rotaciona automaticamente em 5MB) |
+
+---
+
+## Simulacao (para testes)
+
+Quer testar sem programar de verdade? Use o script de simulacao:
+
+```bash
+# Simular atividade a cada 2 segundos
+sh simulate.sh /tmp/bugcap-sim 2
+```
+
+Ele cria, modifica e deleta arquivos aleatorios, imitando um fluxo real de desenvolvimento.
+
+---
+
+## Stack
+
+| Componente   | Tecnologia                     |
+|-------------|-------------------------------|
+| Linguagem    | TypeScript                     |
+| Runtime      | Node.js (v18+)                 |
+| TUI          | Ink (React para Terminal)      |
+| File Watcher | chokidar                       |
+| CLI          | Commander                      |
+| Distribuicao | npm (`npx bugcap`)             |
+
+---
+
+## Desenvolvimento
+
+```bash
+# Clonar e instalar
+git clone https://github.com/seu-usuario/bug-capitalist.git
+cd bug-capitalist
+npm install
+
+# Modo desenvolvimento (recompila automaticamente)
+npm run dev
+
+# Build
+npm run build
+
+# Rodar
+npm start
+```
+
+---
+
+## Roadmap
+
+- [x] **v0.1** — MVP: watcher, TUI, economia basica, persistencia
+- [ ] **v0.2** — Eventos dinamicos, historico, notificacoes de milestone
+- [ ] **v0.3** — Sistema de upgrades, multiplicadores, desafios por level
+- [ ] **v0.4** — ASCII art avancado, temas, animacoes
+- [ ] **v1.0** — Achievements, leaderboard, hooks para Claude Code, UI multi-projeto
+
+---
+
+## Licenca
+
+MIT
+
+---
+
+<p align="center">
+  <strong>Pare de apenas programar. Lucre com seus bugs. 🐛💰</strong>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bugcap",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Turn your AI coding into a terminal idle game",
   "type": "module",
   "bin": {
@@ -12,7 +12,13 @@
     "start": "node dist/cli.js",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["cli", "terminal", "idle-game", "ai", "developer-tools"],
+  "keywords": [
+    "cli",
+    "terminal",
+    "idle-game",
+    "ai",
+    "developer-tools"
+  ],
   "license": "MIT",
   "files": [
     "dist"