minerva-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Paulo Henrique Santos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# 🦉 Minerva CLI
+
+> Organização acadêmica de ponta a ponta para estudantes de **Análise e Desenvolvimento de Sistemas** da **FATEC** — direto do terminal, integrada ao Obsidian.
+
+[![CI](https://github.com/phs-santos/fatec-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/phs-santos/fatec-cli/actions/workflows/ci.yml)
+![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)
+![License](https://img.shields.io/badge/license-MIT-blue)
+
+A Minerva cria e mantém um **vault de estudos completo** para toda a graduação: os 6 semestres com todas as disciplinas da [matriz curricular oficial](https://fatectq.cps.sp.gov.br/matriz-curricular-ads/), templates de aula/resumo/prova/trabalho, dashboard automático, flashcards, cheatsheets, portfólio e muito mais.
+
+## Instalação
+
+```bash
+npm install -g minerva-cli
+```
+
+Requer Node.js 20+ (LTS).
+
+## Começando
+
+```bash
+minerva init            # cria o vault fatec-ads/ com tudo dentro
+cd fatec-ads
+minerva dashboard       # gera o dashboard de estudos
+```
+
+Abra a pasta `fatec-ads/` como vault no **Obsidian** e pronto. 🟣
+
+## Comandos
+
+| Comando                                          | O que faz                                                                                             |
+| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
+| `minerva init [pasta]`                           | Cria a estrutura completa do curso (Git, README, matriz, 6 semestres, templates, Obsidian, dashboard) |
+| `minerva dashboard`                              | Regenera o dashboard: disciplinas, pendências, próximas provas, progresso                             |
+| `minerva aula [título]`                          | Cria a anotação de uma aula                                                                           |
+| `minerva resumo [tema]`                          | Cria um resumo de estudo                                                                              |
+| `minerva prova [nome] --data YYYY-MM-DD`         | Agenda e planeja uma prova                                                                            |
+| `minerva trabalho [título] --entrega YYYY-MM-DD` | Cria um trabalho com data de entrega                                                                  |
+| `minerva projeto [nome]`                         | Cria um projeto de disciplina                                                                         |
+| `minerva portfolio`                              | Gera o índice do portfólio com todos os projetos                                                      |
+| `minerva cheatsheet [assunto]`                   | Cria uma cheatsheet avulsa (Git, SQL, Linux...)                                                       |
+| `minerva flashcards [tema]`                      | Cria um deck de flashcards (compatível com Spaced Repetition)                                         |
+| `minerva semestre [n]`                           | Mostra ou define o semestre atual                                                                     |
+| `minerva disciplina`                             | Lista as disciplinas; `disciplina add` cria uma extra                                                 |
+| `minerva estudo [horas]`                         | Registra horas de estudo (`-d` para disciplina); sem argumento, mostra os totais                      |
+| `minerva pendencias`                             | Lista todos os checkboxes abertos do semestre, com arquivo e linha                                    |
+| `minerva semana`                                 | Provas, entregas e pendências dos próximos 7 dias (`--dias N` muda a janela)                          |
+| `minerva nota`                                   | Boletim com médias e situação; `nota add` registra a nota de uma avaliação                            |
+| `minerva stats`                                  | Streak, horas e gráfico de constância dos últimos 30 dias                                             |
+| `minerva flashcards export`                      | Exporta todos os flashcards para TSV importável no Anki                                               |
+| `minerva open [arquivo]`                         | Abre o dashboard (ou um arquivo) no Obsidian                                                          |
+| `minerva commit [msg]`                           | Faz git add + commit de tudo que mudou no vault                                                       |
+| `minerva config`                                 | Mostra a configuração; `config set <chave> <valor>` edita                                             |
+| `minerva completion <shell>`                     | Gera autocomplete para bash ou zsh                                                                    |
+| `minerva update-matriz`                          | Atualiza a matriz curricular a partir do site oficial da FATEC                                        |
+| `minerva doctor`                                 | Diagnóstico do ambiente e do vault                                                                    |
+| `minerva version` / `minerva help`               | Versão e ajuda                                                                                        |
+
+Todos os comandos de nota aceitam `-d/--disciplina` e `-s/--semestre` para pular os prompts interativos, e `-c/--commit` para commitar o vault após criar. Comandos de leitura (`estudo`, `pendencias`, `semana`, `nota`, `stats`, `config`) aceitam `--json` para uso em scripts.
+
+### Resumos e flashcards com IA
+
+`minerva resumo --ai` lê suas anotações em `Aulas/` e gera o rascunho do resumo com Claude; `minerva flashcards --ai` gera cards a partir dos seus `Resumos/`. Requer a variável de ambiente `ANTHROPIC_API_KEY`:
+
+```bash
+export ANTHROPIC_API_KEY="sk-ant-..."
+minerva resumo "Normalização" -d "Banco de Dados" --ai
+```
+
+### Exemplo
+
+```bash
+minerva aula "Normalização" -d "Banco de Dados" -s 3
+# ✔ Pronto! Nota criada em:
+#   • 3-semestre/Banco de Dados/Aulas/2026-07-13-aula-normalizacao.md
+```
+
+## Estrutura criada pelo `minerva init`
+
+```
+fatec-ads/
+├── dashboard/            # Dashboard.md gerado automaticamente
+├── roadmap/              # roadmap da graduação
+├── curriculo/            # matriz.json (matriz curricular oficial)
+├── portfolio/            # índice de projetos (minerva portfolio)
+├── entrevistas/  estagio/  certificados/  artigos/  livros/
+├── snippets/  flashcards/  cheatsheets/  laboratorio/  desafios/
+├── templates/            # templates Handlebars personalizáveis
+├── projetos-pessoais/
+├── obsidian/             # daily notes, canvas, attachments, excalidraw
+├── 1-semestre/ ... 6-semestre/
+│   └── <Disciplina>/
+│       ├── README.md  Cheatsheet.md  Resumo-Final.md
+│       ├── Aulas/  Resumos/  Provas/  Trabalhos/  Projetos/
+│       └── Exercicios/  Flashcards/  Laboratorio/  Referencias/
+└── minerva.json           # configuração do vault
+```
+
+## Personalizando templates
+
+Os templates ficam em `templates/*.hbs` dentro do vault. Edite qualquer um deles e a Minerva passa a usar a sua versão — os embutidos no pacote são apenas o fallback.
+
+## Como atualizar
+
+```bash
+npm update -g minerva-cli
+minerva update-matriz   # re-sincroniza a matriz com o site da FATEC
+```
+
+## Desenvolvimento
+
+```bash
+git clone https://github.com/phs-santos/fatec-cli
+cd minerva-cli
+npm install
+npm run dev -- --help  # roda a CLI via tsx
+npm test               # Vitest
+npm run lint           # ESLint + Prettier
+npm run build          # tsup → ESM + CJS + tipos
+```
+
+A arquitetura, as decisões de design e os diagramas estão em [docs/ARQUITETURA.md](docs/ARQUITETURA.md). Fluxogramas de uso (do zero à rotina semanal) em [docs/GUIA-DE-USO.md](docs/GUIA-DE-USO.md).
+
+## Roadmap
+
+- [x] Resumos e flashcards gerados por IA (Anthropic; OpenAI/Gemini via interface `AiProvider`)
+- [x] Exportação de flashcards para Anki
+- [x] Registro de horas, boletim de notas e estatísticas de constância
+- [ ] Integração com Notion e Google Calendar
+- [ ] Sincronização com GitHub / nuvem
+- [ ] Servidor MCP para uso com agentes
+
+## Como contribuir
+
+1. Abra uma issue descrevendo a proposta.
+2. Fork + branch (`feat/minha-feature`).
+3. `npm test` e `npm run lint` verdes.
+4. Abra o pull request. 💜
+
+## Licença
+
+MIT