minerva-cli 0.1.0 → 0.2.1

package/dist/index.js

@@ -9,7 +9,7 @@ import { Command as Command20 } from "commander";
 // src/config/constants.ts
 var APP_NAME = "minerva";
 var APP_DESCRIPTION = "Organiza\xE7\xE3o acad\xEAmica para estudantes de ADS da FATEC \u{1F989}";
-var APP_VERSION = "0.1.0";
+var APP_VERSION = "0.2.1";
 var DEFAULT_VAULT_DIRNAME = "fatec-ads";
 var MATRIZ_URL = "https://fatectq.cps.sp.gov.br/matriz-curricular-ads/";
 
@@ -571,14 +571,20 @@ function disciplinaDir(root, semestre, disciplina) {
 async function scaffoldDisciplina(root, semestre, disciplina) {
   const dir = disciplinaDir(root, semestre, disciplina.nome);
   await Promise.all(
-    DISCIPLINA_FOLDERS.map((folder) => fs5.ensureDir(path6.join(dir, folder)))
+    DISCIPLINA_FOLDERS.map(
+      (folder) => fs5.ensureDir(path6.join(dir, folder))
+    )
   );
   const files = [
     [
       "README.md",
       () => renderTemplate(
         "disciplina",
-        { disciplina: disciplina.nome, semestre, aulas: disciplina.aulas },
+        {
+          disciplina: disciplina.nome,
+          semestre,
+          aulas: disciplina.aulas
+        },
         root
       )
     ],
@@ -831,7 +837,9 @@ function doctorCommand() {
       {
         label: "Node.js",
         run: () => {
-          const major = Number(process.versions.node.split(".")[0]);
+          const major = Number(
+            process.versions.node.split(".")[0]
+          );
           if (major < 20) {
             throw new Error(
               `v${process.versions.node} \u2014 atualize para a LTS (>= 20)`
@@ -848,7 +856,9 @@ function doctorCommand() {
         label: "Vault Minerva",
         run: () => {
           if (!root) {
-            throw new Error('n\xE3o encontrado \u2014 rode "minerva init"');
+            throw new Error(
+              'n\xE3o encontrado \u2014 rode "minerva init"'
+            );
           }
           return Promise.resolve(root);
         }
@@ -878,7 +888,9 @@ function doctorCommand() {
           label: "Reposit\xF3rio Git",
           run: async () => {
             if (!await fs7.pathExists(path10.join(root, ".git"))) {
-              throw new Error('ausente \u2014 rode "git init" no vault');
+              throw new Error(
+                'ausente \u2014 rode "git init" no vault'
+              );
             }
             return "ok";
           }
@@ -886,7 +898,9 @@ function doctorCommand() {
         {
           label: "Vault do Obsidian",
           run: async () => {
-            if (!await fs7.pathExists(path10.join(root, ".obsidian"))) {
+            if (!await fs7.pathExists(
+              path10.join(root, ".obsidian")
+            )) {
               throw new Error(
                 'pasta .obsidian ausente \u2014 rode "minerva init" novamente'
               );
@@ -939,7 +953,9 @@ async function loadEstudoLog(root) {
 }
 async function registrarEstudo(vault, horas, disciplina) {
   if (!Number.isFinite(horas) || horas <= 0) {
-    throw new Error("Informe um n\xFAmero de horas maior que zero (ex.: 1.5).");
+    throw new Error(
+      "Informe um n\xFAmero de horas maior que zero (ex.: 1.5)."
+    );
   }
   const sessao = {
     data: todayISO(),
@@ -985,12 +1001,16 @@ function estudoCommand() {
           );
           return;
         }
-        logger.title(`${vault.config.horasEstudadas}h estudadas no total`);
+        logger.title(
+          `${vault.config.horasEstudadas}h estudadas no total`
+        );
         for (const [disciplina2, total] of totals) {
           logger.item(`${disciplina2}: ${total}h`);
         }
         if (totals.size === 0) {
-          logger.info("Registre sua primeira sess\xE3o: minerva estudo 1.5");
+          logger.info(
+            "Registre sua primeira sess\xE3o: minerva estudo 1.5"
+          );
         }
         return;
       }
@@ -1039,7 +1059,9 @@ async function collectMarkdownFiles(dir) {
   const stack = [dir];
   while (stack.length > 0) {
     const current = stack.pop();
-    for (const entry of await fs9.readdir(current, { withFileTypes: true })) {
+    for (const entry of await fs9.readdir(current, {
+      withFileTypes: true
+    })) {
       const full = path12.join(current, entry.name);
       if (entry.isDirectory()) stack.push(full);
       else if (entry.name.endsWith(".md")) files.push(full);
@@ -1052,14 +1074,22 @@ async function collectAllFlashcards(vault) {
   const stack = [vault.root];
   while (stack.length > 0) {
     const current = stack.pop();
-    for (const entry of await fs9.readdir(current, { withFileTypes: true })) {
-      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+    for (const entry of await fs9.readdir(current, {
+      withFileTypes: true
+    })) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules")
+        continue;
       const full = path12.join(current, entry.name);
       if (!entry.isDirectory()) continue;
       if (entry.name.toLowerCase() === "flashcards") {
         const deck = path12.basename(path12.dirname(full));
         for (const file of await collectMarkdownFiles(full)) {
-          cards.push(...parseFlashcards(await fs9.readFile(file, "utf8"), deck));
+          cards.push(
+            ...parseFlashcards(
+              await fs9.readFile(file, "utf8"),
+              deck
+            )
+          );
         }
       } else {
         stack.push(full);
@@ -1134,22 +1164,26 @@ async function createNote(vault, input5) {
 
 // src/services/ai.ts
 import Anthropic from "@anthropic-ai/sdk";
-var AI_MODEL = "claude-opus-4-8";
+var ANTHROPIC_MODEL = "claude-opus-4-8";
+var OLLAMA_DEFAULT_MODEL = "llama3.2";
+var OLLAMA_DEFAULT_URL = "http://localhost:11434";
+var SYSTEM_PROMPT = "Voc\xEA \xE9 um monitor de estudos da FATEC (curso de An\xE1lise e Desenvolvimento de Sistemas). Responda sempre em portugu\xEAs do Brasil, em Markdown puro, sem pre\xE2mbulos.";
 function anthropicProvider() {
   if (!process.env["ANTHROPIC_API_KEY"]) {
     throw new Error(
-      'Defina a vari\xE1vel de ambiente ANTHROPIC_API_KEY para usar os recursos de IA.\n  Ex.: export ANTHROPIC_API_KEY="sk-ant-..."'
+      'Defina a vari\xE1vel de ambiente ANTHROPIC_API_KEY para usar o provedor Anthropic.\n  Ex.: export ANTHROPIC_API_KEY="sk-ant-..."'
     );
   }
   const client = new Anthropic();
   return {
+    name: `anthropic (${ANTHROPIC_MODEL})`,
     async generate(prompt, material) {
       try {
         const stream = client.messages.stream({
-          model: AI_MODEL,
+          model: ANTHROPIC_MODEL,
           max_tokens: 64e3,
           thinking: { type: "adaptive" },
-          system: "Voc\xEA \xE9 um monitor de estudos da FATEC (curso de An\xE1lise e Desenvolvimento de Sistemas). Responda sempre em portugu\xEAs do Brasil, em Markdown puro, sem pre\xE2mbulos.",
+          system: SYSTEM_PROMPT,
           messages: [
             {
               role: "user",
@@ -1165,7 +1199,9 @@ ${material}
         return message.content.filter((block) => block.type === "text").map((block) => block.text).join("\n");
       } catch (error) {
         if (error instanceof Anthropic.AuthenticationError) {
-          throw new Error("ANTHROPIC_API_KEY inv\xE1lida. Verifique a chave.");
+          throw new Error(
+            "ANTHROPIC_API_KEY inv\xE1lida. Verifique a chave."
+          );
         }
         if (error instanceof Anthropic.RateLimitError) {
           throw new Error(
@@ -1182,6 +1218,110 @@ ${material}
     }
   };
 }
+function ollamaProvider() {
+  const baseUrl = (process.env["OLLAMA_URL"] ?? OLLAMA_DEFAULT_URL).replace(
+    /\/$/,
+    ""
+  );
+  const model = process.env["OLLAMA_MODEL"] ?? OLLAMA_DEFAULT_MODEL;
+  const headers = {
+    "content-type": "application/json"
+  };
+  if (process.env["OLLAMA_API_KEY"]) {
+    headers["authorization"] = `Bearer ${process.env["OLLAMA_API_KEY"]}`;
+  }
+  const options = {
+    num_predict: Number(process.env["OLLAMA_MAX_TOKENS"] ?? 1500)
+  };
+  if (process.env["OLLAMA_THREADS"]) {
+    options["num_thread"] = Number(process.env["OLLAMA_THREADS"]);
+  }
+  return {
+    name: `ollama (${model} @ ${baseUrl})`,
+    async generate(prompt, material) {
+      let response;
+      try {
+        response = await fetch(`${baseUrl}/api/chat`, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({
+            model,
+            stream: false,
+            options,
+            messages: [
+              { role: "system", content: SYSTEM_PROMPT },
+              {
+                role: "user",
+                content: `${prompt}
+
+<material>
+${material}
+</material>`
+              }
+            ]
+          })
+        });
+      } catch (cause) {
+        throw new Error(
+          `N\xE3o consegui falar com o Ollama em ${baseUrl}.
+  Local: instale com "curl -fsSL https://ollama.com/install.sh | sh" e rode "ollama serve".
+  VPS: defina OLLAMA_URL apontando para o seu servidor.`,
+          { cause }
+        );
+      }
+      if (response.status === 404) {
+        throw new Error(
+          `O modelo "${model}" n\xE3o est\xE1 instalado no Ollama. Rode: ollama pull ${model}`
+        );
+      }
+      if (!response.ok) {
+        throw new Error(
+          `Ollama respondeu HTTP ${response.status}: ${await response.text()}`
+        );
+      }
+      const data = await response.json();
+      const content = data.message?.content;
+      if (!content) {
+        throw new Error("O Ollama retornou uma resposta vazia.");
+      }
+      return content;
+    }
+  };
+}
+async function ollamaDisponivel() {
+  const baseUrl = (process.env["OLLAMA_URL"] ?? OLLAMA_DEFAULT_URL).replace(
+    /\/$/,
+    ""
+  );
+  const headers = {};
+  if (process.env["OLLAMA_API_KEY"]) {
+    headers["authorization"] = `Bearer ${process.env["OLLAMA_API_KEY"]}`;
+  }
+  try {
+    const response = await fetch(`${baseUrl}/api/tags`, {
+      headers,
+      signal: AbortSignal.timeout(3e3)
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function resolveProvider() {
+  const forced = process.env["MINERVA_AI"]?.toLowerCase();
+  if (forced === "anthropic") return anthropicProvider();
+  if (forced === "ollama") return ollamaProvider();
+  if (forced) {
+    throw new Error(
+      `Provedor desconhecido em MINERVA_AI: "${forced}". Use "anthropic" ou "ollama".`
+    );
+  }
+  if (process.env["ANTHROPIC_API_KEY"]) return anthropicProvider();
+  if (await ollamaDisponivel()) return ollamaProvider();
+  throw new Error(
+    'Nenhum provedor de IA dispon\xEDvel. Escolha um:\n  \u2022 Anthropic (pago): export ANTHROPIC_API_KEY="sk-ant-..."\n  \u2022 Ollama (gr\xE1tis, local): instale em https://ollama.com e rode "ollama pull llama3.2"\n  \u2022 Ollama (gr\xE1tis, na sua VPS): export OLLAMA_URL="http://SEU-IP:11434"'
+  );
+}
 function resumoPrompt(disciplina, tema) {
   return `Gere um resumo de estudo sobre "${tema}" para a disciplina "${disciplina}", baseado nas anota\xE7\xF5es de aula fornecidas no material. Estruture com: vis\xE3o geral, pontos principais numerados, explica\xE7\xE3o com palavras simples e uma se\xE7\xE3o "Poss\xEDveis quest\xF5es de prova" com checkboxes (- [ ]). Se o material for insuficiente, complemente com seu conhecimento e sinalize o que n\xE3o veio das anota\xE7\xF5es.`;
 }
@@ -1206,7 +1346,9 @@ var DATE_HINT = "Use uma data v\xE1lida no formato YYYY-MM-DD.";
 async function readMaterial(dir) {
   if (!await fs11.pathExists(dir)) return "";
   const parts = [];
-  for (const file of (await fs11.readdir(dir)).filter((f) => f.endsWith(".md"))) {
+  for (const file of (await fs11.readdir(dir)).filter(
+    (f) => f.endsWith(".md")
+  )) {
     parts.push(await fs11.readFile(path14.join(dir, file), "utf8"));
   }
   return parts.join("\n\n---\n\n");
@@ -1222,7 +1364,7 @@ function noteCommand(spec) {
   if (spec.ai) {
     command.option(
       "--ai",
-      `gera o conte\xFAdo com IA a partir de ${spec.ai.sourceFolder}/ (requer ANTHROPIC_API_KEY)`
+      `gera o conte\xFAdo com IA a partir de ${spec.ai.sourceFolder}/ (Anthropic ou Ollama)`
     );
   }
   command.action(
@@ -1256,13 +1398,13 @@ function noteCommand(spec) {
       }
       let conteudoIA;
       if (spec.ai && options["ai"]) {
-        const provider = anthropicProvider();
+        const provider = await resolveProvider();
         const sourceDir = path14.join(
           disciplinaDir(vault.root, semestre, disciplina),
           spec.ai.sourceFolder
         );
         const spinAi = spinner(
-          `Gerando conte\xFAdo com IA (${spec.ai.sourceFolder}/)...`
+          `Gerando conte\xFAdo com IA a partir de ${spec.ai.sourceFolder}/...`
         ).start();
         try {
           const material = await readMaterial(sourceDir);
@@ -1286,11 +1428,14 @@ function noteCommand(spec) {
           extra
         });
         if (conteudoIA) {
-          await fs11.appendFile(file, `
+          await fs11.appendFile(
+            file,
+            `
 ## Gerado por IA
 
 ${conteudoIA}
-`);
+`
+          );
         }
         spin.succeed(`Pronto! Nota criada em:`);
         logger.item(path14.relative(vault.root, file));
@@ -1384,14 +1529,18 @@ function flashcardsCommand() {
   );
   const create = flashcardsNewCommand();
   command.addCommand(create, { isDefault: true });
-  command.command("export").description("Exporta todos os flashcards para um TSV import\xE1vel no Anki").action(async () => {
+  command.command("export").description(
+    "Exporta todos os flashcards para um TSV import\xE1vel no Anki"
+  ).action(async () => {
     const vault = await requireVault();
     const spin = spinner("Coletando flashcards do vault...").start();
     try {
       const { file, total } = await exportAnki(vault);
       spin.succeed(`${total} flashcard(s) exportado(s)!`);
       logger.item(path15.relative(vault.root, file));
-      logger.info("No Anki: Arquivo \u2192 Importar e selecione esse arquivo.");
+      logger.info(
+        "No Anki: Arquivo \u2192 Importar e selecione esse arquivo."
+      );
     } catch (error) {
       spin.fail("Falha na exporta\xE7\xE3o.");
       throw error;
@@ -1442,7 +1591,10 @@ function initCommand() {
   return new Command11("init").description("Cria a estrutura completa do curso (vault de estudos)").argument("[pasta]", "pasta de destino", DEFAULT_VAULT_DIRNAME).option("-s, --semestre <n>", "semestre atual (1-6)").option("-a, --aluno <nome>", "seu nome").action(
     async (pasta, options) => {
       logger.title("Minerva CLI \u2014 vamos montar sua gradua\xE7\xE3o!");
-      const aluno = options.aluno ?? await input3({ message: "Seu nome:", default: "Estudante" });
+      const aluno = options.aluno ?? await input3({
+        message: "Seu nome:",
+        default: "Estudante"
+      });
       const semestreAtual = options.semestre !== void 0 ? Number(options.semestre) : await number2({
         message: "Em qual semestre voc\xEA est\xE1? (1-6)",
         default: 1,
@@ -1467,7 +1619,10 @@ function initCommand() {
         spin.text = "Copiando templates...";
         await scaffoldTemplates(root);
         spin.text = "Criando semestres e disciplinas...";
-        const totalDisciplinas = await scaffoldSemestres(root, matrizOficial);
+        const totalDisciplinas = await scaffoldSemestres(
+          root,
+          matrizOficial
+        );
         spin.text = "Preparando vault do Obsidian...";
         await scaffoldObsidian(root);
         spin.text = "Gerando README e dashboard...";
@@ -1480,7 +1635,10 @@ function initCommand() {
             semestres: matrizOficial.semestres
           })
         );
-        await writeIfMissing(path16.join(root, ".gitignore"), GITIGNORE);
+        await writeIfMissing(
+          path16.join(root, ".gitignore"),
+          GITIGNORE
+        );
         await writeIfMissing(
           path16.join(root, "roadmap", "Roadmap.md"),
           ROADMAP
@@ -1491,14 +1649,20 @@ function initCommand() {
         spin.succeed("Vault criado com sucesso!");
         logger.blank();
         logger.success(`\u{1F4C1} ${root}`);
-        logger.item(`${totalDisciplinas} disciplinas em 6 semestres`);
+        logger.item(
+          `${totalDisciplinas} disciplinas em 6 semestres`
+        );
         logger.item("Dashboard em dashboard/Dashboard.md");
         logger.item("Abra a pasta como vault no Obsidian \u{1F7E3}");
         if (!gitOk) {
-          logger.warn("Git n\xE3o encontrado \u2014 reposit\xF3rio n\xE3o inicializado.");
+          logger.warn(
+            "Git n\xE3o encontrado \u2014 reposit\xF3rio n\xE3o inicializado."
+          );
         }
         logger.blank();
-        logger.info(`Pr\xF3ximo passo: cd ${pasta} && minerva dashboard`);
+        logger.info(
+          `Pr\xF3ximo passo: cd ${pasta} && minerva dashboard`
+        );
       } catch (error) {
         spin.fail("Falha ao criar o vault.");
         throw error;
@@ -1593,7 +1757,9 @@ function notaCommand() {
         `${linha.disciplina}: m\xE9dia ${chalk2.bold(linha.media)} \u2014 ${color(linha.situacao)}`
       );
       for (const nota of linha.notas) {
-        logger.item(`${nota.avaliacao}: ${nota.valor} (peso ${nota.peso})`);
+        logger.item(
+          `${nota.avaliacao}: ${nota.valor} (peso ${nota.peso})`
+        );
       }
     }
   });
@@ -1627,7 +1793,9 @@ function notaCommand() {
         peso: Number(options.peso)
       });
       const notas = await loadNotas(vault.root);
-      const linha = boletim(notas).find((b) => b.disciplina === disciplina);
+      const linha = boletim(notas).find(
+        (b) => b.disciplina === disciplina
+      );
       logger.success(
         `${avaliacao} = ${valorFinal} registrada em ${disciplina}.`
       );
@@ -1702,7 +1870,9 @@ async function listPendencias(vault, matriz) {
     const stack = [dir];
     while (stack.length > 0) {
       const current = stack.pop();
-      for (const entry of await fs14.readdir(current, { withFileTypes: true })) {
+      for (const entry of await fs14.readdir(current, {
+        withFileTypes: true
+      })) {
         const full = path19.join(current, entry.name);
         if (entry.isDirectory()) stack.push(full);
         else if (entry.name.endsWith(".md")) {
@@ -1802,9 +1972,15 @@ function portfolioCommand() {
         ),
         ""
       ];
-      const destination = path20.join(vault.root, "portfolio", "Portfolio.md");
+      const destination = path20.join(
+        vault.root,
+        "portfolio",
+        "Portfolio.md"
+      );
       await fs15.outputFile(destination, lines.join("\n"), "utf8");
-      spin.succeed(`Portf\xF3lio atualizado com ${items.length} projeto(s)!`);
+      spin.succeed(
+        `Portf\xF3lio atualizado com ${items.length} projeto(s)!`
+      );
       logger.item(path20.relative(vault.root, destination));
     } catch (error) {
       spin.fail("Falha ao gerar o portf\xF3lio.");
@@ -1854,7 +2030,10 @@ async function proximosCompromissos(vault, matriz, dias = 7) {
           compromissos.push({
             tipo: spec.tipo,
             disciplina: disciplina.nome,
-            titulo: extractTitle(content, file.replace(/\.md$/, "")),
+            titulo: extractTitle(
+              content,
+              file.replace(/\.md$/, "")
+            ),
             data,
             arquivo: path21.relative(vault.root, full)
           });
@@ -1911,7 +2090,9 @@ function semestreCommand() {
     if (numero === void 0) {
       const atual = getSemestre(matriz, vault.config.semestreAtual);
       logger.title(`${atual.numero}\xBA semestre`);
-      logger.info(`Progresso do curso: ${progressBar(atual.numero - 1, 6)}`);
+      logger.info(
+        `Progresso do curso: ${progressBar(atual.numero - 1, 6)}`
+      );
       for (const d of atual.disciplinas) {
         logger.item(`${d.nome} (${d.aulas} aulas)`);
       }
@@ -1940,8 +2121,11 @@ async function collectDates(root) {
   const stack = [root];
   while (stack.length > 0) {
     const current = stack.pop();
-    for (const entry of await fs17.readdir(current, { withFileTypes: true })) {
-      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+    for (const entry of await fs17.readdir(current, {
+      withFileTypes: true
+    })) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules")
+        continue;
       const full = path22.join(current, entry.name);
       if (entry.isDirectory()) stack.push(full);
       else {
@@ -1997,7 +2181,9 @@ function statsCommand() {
       return;
     }
     logger.title("Suas estat\xEDsticas de estudo");
-    logger.info(`\u{1F525} Streak: ${chalk4.bold(stats.streak)} dia(s) seguidos`);
+    logger.info(
+      `\u{1F525} Streak: ${chalk4.bold(stats.streak)} dia(s) seguidos`
+    );
     logger.info(`\u23F1\uFE0F  Horas estudadas: ${stats.horasEstudadas}h`);
     logger.info(`\u{1F4DD} Notas criadas: ${stats.totalNotas}`);
     logger.blank();