@tostudy-ai/cli 0.18.6 → 0.18.7

package/dist/cli.js

@@ -21,6 +21,29 @@ function canRunOnNode(version) {
   }
   return true;
 }
+var INSTALL_UNIX = "curl -fsSL https://tostudy.ai/install.sh | sh";
+var INSTALL_WINDOWS = "irm https://tostudy.ai/install.ps1 | iex";
+function nodeGuardMessage(mode, version, pt) {
+  const installers = `  macOS/Linux: ${INSTALL_UNIX}
+  Windows (PowerShell): ${INSTALL_WINDOWS}
+`;
+  if (mode === "block") {
+    return pt ? `Erro: o ToStudy CLI precisa do Node.js ${MIN_NODE_MAJOR} ou superior.
+Voc\xEA est\xE1 no Node.js ${version}.
+Para atualizar, rode o instalador de novo:
+${installers}Ou atualize em https://nodejs.org. Depois rode o comando de novo.
+` : `Error: the ToStudy CLI requires Node.js ${MIN_NODE_MAJOR} or newer.
+You are on Node.js ${version}.
+To update, run the installer again:
+${installers}Or update at https://nodejs.org. Then run the command again.
+`;
+  }
+  return pt ? `Aviso: o Node.js ${version} n\xE3o \xE9 mais suportado pelo ToStudy CLI. Atualize para o Node.js ${MIN_NODE_MAJOR} ou superior rodando o instalador de novo:
+${installers}Ou atualize em https://nodejs.org.
+` : `Warning: Node.js ${version} is no longer supported by the ToStudy CLI. Update to Node.js ${MIN_NODE_MAJOR} or newer by running the installer again:
+${installers}Or update at https://nodejs.org.
+`;
+}
 
 // src/cli-entry.ts
 if (!process.env.LOG_LEVEL) {
@@ -31,22 +54,10 @@ if (!meetsNodeFloor(process.versions.node)) {
   const localeFlag = localeFlagIdx !== -1 && localeFlagIdx + 1 < process.argv.length ? process.argv[localeFlagIdx + 1] : void 0;
   const pt = localeFlag === "pt-BR" || localeFlag === "en-US" ? localeFlag === "pt-BR" : !(process.env["LANG"] ?? "").toLowerCase().startsWith("en");
   if (!canRunOnNode(process.versions.node)) {
-    process.stderr.write(
-      pt ? `Erro: o ToStudy CLI precisa do Node.js ${MIN_NODE_MAJOR} ou superior.
-Voc\xEA est\xE1 no Node.js ${process.versions.node}.
-Atualize em https://nodejs.org e rode o comando de novo.
-` : `Error: the ToStudy CLI requires Node.js ${MIN_NODE_MAJOR} or newer.
-You are on Node.js ${process.versions.node}.
-Update at https://nodejs.org and run the command again.
-`
-    );
+    process.stderr.write(nodeGuardMessage("block", process.versions.node, pt));
     process.exit(1);
   }
-  process.stderr.write(
-    pt ? `Aviso: o Node.js ${process.versions.node} n\xE3o \xE9 mais suportado pelo ToStudy CLI. Atualize para o Node.js ${MIN_NODE_MAJOR} ou superior em https://nodejs.org.
-` : `Warning: Node.js ${process.versions.node} is no longer supported by the ToStudy CLI. Update to Node.js ${MIN_NODE_MAJOR} or newer at https://nodejs.org.
-`
-  );
+  process.stderr.write(nodeGuardMessage("warn", process.versions.node, pt));
 }
 if (!process.env["TOSTUDY_LOCALE"]) {
   try {

package/dist/cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/node-floor.ts", "../src/cli-entry.ts"],
-  "sourcesContent": ["// GH #2114 \u2014 the Node floors of the CLI, read by the runtime guard (cli-entry.ts),\n// `tostudy doctor` (installer/node-detector.ts) and the label doctor prints.\n//\n// Two floors on purpose:\n// - MIN_NODE_MAJOR is the supported floor (Node 20 is EOL since 2026-04-30). It must\n//   match `engines` in package.json and the esbuild target in build-npm.mjs.\n// - MIN_NODE_RUNTIME is where the bundle actually loads (undici 7 needs 20.18.1). The\n//   guard blocks below it and only warns between the two, so students on Node 20, who\n//   ran 0.18.0 fine, are not locked out by the auto-update.\n//\n// Leaf module on purpose: cli-entry.ts imports it before the bundle loads, so it must\n// not import anything (the guard has to run on runtimes the rest of the CLI rejects).\nexport const MIN_NODE_MAJOR = 22;\nexport const MIN_NODE_RUNTIME = \"20.18.1\";\n\nfunction parseVersion(version: string): [number, number, number] | null {\n  const match = /^v?(\\d+)\\.(\\d+)\\.(\\d+)/.exec(version.trim());\n  if (!match) return null;\n  return [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\n/** Supported floor. Accepts `process.versions.node` (\"22.1.0\") or `node --version` (\"v22.1.0\"). */\nexport function meetsNodeFloor(version: string): boolean {\n  const parsed = parseVersion(version);\n  return parsed !== null && parsed[0] >= MIN_NODE_MAJOR;\n}\n\n/** Hard floor: false means the bundle cannot run on this Node at all. */\nexport function canRunOnNode(version: string): boolean {\n  const parsed = parseVersion(version);\n  const floor = parseVersion(MIN_NODE_RUNTIME);\n  if (!parsed || !floor) return false;\n  for (let i = 0; i < 3; i++) {\n    if (parsed[i]! !== floor[i]!) return parsed[i]! > floor[i]!;\n  }\n  return true;\n}\n", "/**\n * Entry point for the bundled npm CLI.\n * This file is used by build-npm.mjs as the esbuild entrypoint.\n *\n * Uses dynamic import so LOG_LEVEL is set BEFORE any module loads\n * (ESM static imports are hoisted and run before top-level code).\n */\n\n// The only static import: a leaf with no imports and no side effects (see node-floor.ts).\nimport { MIN_NODE_MAJOR, canRunOnNode, meetsNodeFloor } from \"./node-floor\";\n\n// Suppress @repo/logger output in CLI mode\nif (!process.env.LOG_LEVEL) {\n  process.env.LOG_LEVEL = \"fatal\";\n}\n\n// GH #1414 \u2014 guard de versao ANTES de qualquer import. O CLI exige Node >= 22\n// (`engines`, node-detector.ts, build target `node22`) mas nada checava em runtime:\n// o aluno com Node antigo levava um erro cru de sintaxe/referencia, sem saber que a\n// causa era a versao. Mensagem simples e sem dependencia \u2014 o bundle de erros vive\n// dentro de ./cli, que e justamente o que nao pode carregar aqui.\n//\n// GH #2114 \u2014 o piso real das dependencias e 20.18.1 (undici 7; commander 14 pede 20),\n// e o Node 20 esta em EOL desde 2026-04-30, entao o piso suportado e 22: abaixo de\n// 20.18.1 o guard bloqueia, entre 20.18.1 e 21 ele so avisa (node-floor.ts). O guard so\n// roda antes do undici porque o resto do CLI mora em dist/main.js (build-npm.mjs): num\n// arquivo unico o esbuild subia os imports externos para o topo de dist/cli.js e o Node\n// 18 quebrava dentro do undici. A mensagem aponta para nodejs.org, nao para o\n// instalador: o install.sh ainda aceita Node 18+ e nao faria o upgrade (#2115).\n//\n// A resolucao de idioma espelha `errors/index.ts:resolveLocale()` de proposito:\n// `--locale` > `LANG` > pt-BR (o CLI e pt-BR-first, CHORE-1571 Fase D). Nao da\n// para reusar a funcao \u2014 ela vive no bundle que este guard existe para nao\n// carregar. Sem o passo do `--locale` este era o unico ponto do CLI que ignorava\n// a flag (GH #1414).\nif (!meetsNodeFloor(process.versions.node)) {\n  const localeFlagIdx = process.argv.indexOf(\"--locale\");\n  const localeFlag =\n    localeFlagIdx !== -1 && localeFlagIdx + 1 < process.argv.length\n      ? process.argv[localeFlagIdx + 1]\n      : undefined;\n  const pt =\n    localeFlag === \"pt-BR\" || localeFlag === \"en-US\"\n      ? localeFlag === \"pt-BR\"\n      : !(process.env[\"LANG\"] ?? \"\").toLowerCase().startsWith(\"en\");\n  // GH #2114 \u2014 below MIN_NODE_RUNTIME the bundle cannot load (undici 7): stop here.\n  // Between it and MIN_NODE_MAJOR (Node 20.18.1+) the CLI still works, so warn and go\n  // on: those students ran 0.18.0 fine and get this version through the auto-update.\n  if (!canRunOnNode(process.versions.node)) {\n    process.stderr.write(\n      pt\n        ? `Erro: o ToStudy CLI precisa do Node.js ${MIN_NODE_MAJOR} ou superior.\\nVoc\u00EA est\u00E1 no Node.js ${process.versions.node}.\\nAtualize em https://nodejs.org e rode o comando de novo.\\n`\n        : `Error: the ToStudy CLI requires Node.js ${MIN_NODE_MAJOR} or newer.\\nYou are on Node.js ${process.versions.node}.\\nUpdate at https://nodejs.org and run the command again.\\n`\n    );\n    process.exit(1);\n  }\n  process.stderr.write(\n    pt\n      ? `Aviso: o Node.js ${process.versions.node} n\u00E3o \u00E9 mais suportado pelo ToStudy CLI. Atualize para o Node.js ${MIN_NODE_MAJOR} ou superior em https://nodejs.org.\\n`\n      : `Warning: Node.js ${process.versions.node} is no longer supported by the ToStudy CLI. Update to Node.js ${MIN_NODE_MAJOR} or newer at https://nodejs.org.\\n`\n  );\n}\n\n// GH #1414 item 7 \u2014 account locale captured by `tostudy login` (config.json)\n// beats the OS LANG. Read here, before the bundle loads, and handed over via\n// env so errors/index.ts stays a leaf (no errors \u2192 auth import edge).\nif (!process.env[\"TOSTUDY_LOCALE\"]) {\n  try {\n    const { readFileSync } = await import(\"node:fs\");\n    const { join } = await import(\"node:path\");\n    const { homedir } = await import(\"node:os\");\n    const xdg = process.env[\"XDG_CONFIG_HOME\"];\n    const dir =\n      process.platform === \"linux\" && xdg ? join(xdg, \"tostudy\") : join(homedir(), \".tostudy\");\n    const { locale } = JSON.parse(readFileSync(join(dir, \"config.json\"), \"utf-8\")) as {\n      locale?: unknown;\n    };\n    if (locale === \"pt-BR\" || locale === \"en-US\") process.env[\"TOSTUDY_LOCALE\"] = locale;\n  } catch {\n    // No session yet, or unreadable \u2014 LANG / pt-BR fallback applies.\n  }\n}\n\nconst { createProgram, CLI_VERSION, checkForUpdates, maybeAutoUpdate } = await import(\"./main\");\n\n// GH #1419 item 3 \u2014 `.action(async \u2026)` + `parse()` means a rejected command\n// promise is an unhandled rejection: Node dumps a raw stack. One net, in the\n// student's language, instead of a try/catch per command.\nprocess.on(\"unhandledRejection\", (reason) => {\n  const msg = reason instanceof Error ? reason.message : String(reason);\n  process.stderr.write(`Erro: ${msg}\\n  Se o problema continuar, rode: tostudy doctor\\n`);\n  process.exit(1);\n});\n\nconst program = createProgram();\nprogram.parse();\n\ncheckForUpdates(CLI_VERSION);\nmaybeAutoUpdate(CLI_VERSION);\n\nexport {};\n"],
-  "mappings": ";;;AAYO,IAAM,iBAAiB;AACvB,IAAM,mBAAmB;AAEhC,SAAS,aAAa,SAAkD;AACtE,QAAM,QAAQ,yBAAyB,KAAK,QAAQ,KAAK,CAAC;AAC1D,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC;AAC9D;AAGO,SAAS,eAAe,SAA0B;AACvD,QAAM,SAAS,aAAa,OAAO;AACnC,SAAO,WAAW,QAAQ,OAAO,CAAC,KAAK;AACzC;AAGO,SAAS,aAAa,SAA0B;AACrD,QAAM,SAAS,aAAa,OAAO;AACnC,QAAM,QAAQ,aAAa,gBAAgB;AAC3C,MAAI,CAAC,UAAU,CAAC,MAAO,QAAO;AAC9B,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAI,OAAO,CAAC,MAAO,MAAM,CAAC,EAAI,QAAO,OAAO,CAAC,IAAK,MAAM,CAAC;AAAA,EAC3D;AACA,SAAO;AACT;;;ACxBA,IAAI,CAAC,QAAQ,IAAI,WAAW;AAC1B,UAAQ,IAAI,YAAY;AAC1B;AAqBA,IAAI,CAAC,eAAe,QAAQ,SAAS,IAAI,GAAG;AAC1C,QAAM,gBAAgB,QAAQ,KAAK,QAAQ,UAAU;AACrD,QAAM,aACJ,kBAAkB,MAAM,gBAAgB,IAAI,QAAQ,KAAK,SACrD,QAAQ,KAAK,gBAAgB,CAAC,IAC9B;AACN,QAAM,KACJ,eAAe,WAAW,eAAe,UACrC,eAAe,UACf,EAAE,QAAQ,IAAI,MAAM,KAAK,IAAI,YAAY,EAAE,WAAW,IAAI;AAIhE,MAAI,CAAC,aAAa,QAAQ,SAAS,IAAI,GAAG;AACxC,YAAQ,OAAO;AAAA,MACb,KACI,0CAA0C,cAAc;AAAA,6BAAuC,QAAQ,SAAS,IAAI;AAAA;AAAA,IACpH,2CAA2C,cAAc;AAAA,qBAAkC,QAAQ,SAAS,IAAI;AAAA;AAAA;AAAA,IACtH;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,UAAQ,OAAO;AAAA,IACb,KACI,oBAAoB,QAAQ,SAAS,IAAI,yEAAmE,cAAc;AAAA,IAC1H,oBAAoB,QAAQ,SAAS,IAAI,iEAAiE,cAAc;AAAA;AAAA,EAC9H;AACF;AAKA,IAAI,CAAC,QAAQ,IAAI,gBAAgB,GAAG;AAClC,MAAI;AACF,UAAM,EAAE,aAAa,IAAI,MAAM,OAAO,SAAS;AAC/C,UAAM,EAAE,KAAK,IAAI,MAAM,OAAO,WAAW;AACzC,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,SAAS;AAC1C,UAAM,MAAM,QAAQ,IAAI,iBAAiB;AACzC,UAAM,MACJ,QAAQ,aAAa,WAAW,MAAM,KAAK,KAAK,SAAS,IAAI,KAAK,QAAQ,GAAG,UAAU;AACzF,UAAM,EAAE,OAAO,IAAI,KAAK,MAAM,aAAa,KAAK,KAAK,aAAa,GAAG,OAAO,CAAC;AAG7E,QAAI,WAAW,WAAW,WAAW,QAAS,SAAQ,IAAI,gBAAgB,IAAI;AAAA,EAChF,QAAQ;AAAA,EAER;AACF;AAEA,IAAM,EAAE,eAAe,aAAa,iBAAiB,gBAAgB,IAAI,MAAM,OAAO,WAAQ;AAK9F,QAAQ,GAAG,sBAAsB,CAAC,WAAW;AAC3C,QAAM,MAAM,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM;AACpE,UAAQ,OAAO,MAAM,SAAS,GAAG;AAAA;AAAA,CAAqD;AACtF,UAAQ,KAAK,CAAC;AAChB,CAAC;AAED,IAAM,UAAU,cAAc;AAC9B,QAAQ,MAAM;AAEd,gBAAgB,WAAW;AAC3B,gBAAgB,WAAW;",
+  "sourcesContent": ["// GH #2114 \u2014 the Node floors of the CLI, read by the runtime guard (cli-entry.ts),\n// `tostudy doctor` (installer/node-detector.ts) and the label doctor prints.\n//\n// Two floors on purpose:\n// - MIN_NODE_MAJOR is the supported floor (Node 20 is EOL since 2026-04-30). It must\n//   match `engines` in package.json and the esbuild target in build-npm.mjs.\n// - MIN_NODE_RUNTIME is where the bundle actually loads (undici 7 needs 20.18.1). The\n//   guard blocks below it and only warns between the two, so students on Node 20, who\n//   ran 0.18.0 fine, are not locked out by the auto-update.\n//\n// Leaf module on purpose: cli-entry.ts imports it before the bundle loads, so it must\n// not import anything (the guard has to run on runtimes the rest of the CLI rejects).\nexport const MIN_NODE_MAJOR = 22;\nexport const MIN_NODE_RUNTIME = \"20.18.1\";\n\nfunction parseVersion(version: string): [number, number, number] | null {\n  const match = /^v?(\\d+)\\.(\\d+)\\.(\\d+)/.exec(version.trim());\n  if (!match) return null;\n  return [Number(match[1]), Number(match[2]), Number(match[3])];\n}\n\n/** Supported floor. Accepts `process.versions.node` (\"22.1.0\") or `node --version` (\"v22.1.0\"). */\nexport function meetsNodeFloor(version: string): boolean {\n  const parsed = parseVersion(version);\n  return parsed !== null && parsed[0] >= MIN_NODE_MAJOR;\n}\n\n/** Hard floor: false means the bundle cannot run on this Node at all. */\nexport function canRunOnNode(version: string): boolean {\n  const parsed = parseVersion(version);\n  const floor = parseVersion(MIN_NODE_RUNTIME);\n  if (!parsed || !floor) return false;\n  for (let i = 0; i < 3; i++) {\n    if (parsed[i]! !== floor[i]!) return parsed[i]! > floor[i]!;\n  }\n  return true;\n}\n\n// GH-2130 \u2014 since GH-2115 install.sh / install.ps1 upgrade Node below 22, so the guard\n// sends the student back to them first, with nodejs.org as the manual path. Lives here\n// (a leaf) so it is testable without running the guard. The English phrases\n// \"requires Node.js N or newer\" and \"Update to Node.js N or newer\" are asserted by the\n// CI job in .github/scripts/tostudy-cli-assert-node-guard.sh.\nconst INSTALL_UNIX = \"curl -fsSL https://tostudy.ai/install.sh | sh\";\nconst INSTALL_WINDOWS = \"irm https://tostudy.ai/install.ps1 | iex\";\n\n/** Text the runtime guard prints: `block` below MIN_NODE_RUNTIME, `warn` up to MIN_NODE_MAJOR. */\nexport function nodeGuardMessage(mode: \"block\" | \"warn\", version: string, pt: boolean): string {\n  const installers = `  macOS/Linux: ${INSTALL_UNIX}\\n  Windows (PowerShell): ${INSTALL_WINDOWS}\\n`;\n  if (mode === \"block\") {\n    return pt\n      ? `Erro: o ToStudy CLI precisa do Node.js ${MIN_NODE_MAJOR} ou superior.\\nVoc\u00EA est\u00E1 no Node.js ${version}.\\nPara atualizar, rode o instalador de novo:\\n${installers}Ou atualize em https://nodejs.org. Depois rode o comando de novo.\\n`\n      : `Error: the ToStudy CLI requires Node.js ${MIN_NODE_MAJOR} or newer.\\nYou are on Node.js ${version}.\\nTo update, run the installer again:\\n${installers}Or update at https://nodejs.org. Then run the command again.\\n`;\n  }\n  return pt\n    ? `Aviso: o Node.js ${version} n\u00E3o \u00E9 mais suportado pelo ToStudy CLI. Atualize para o Node.js ${MIN_NODE_MAJOR} ou superior rodando o instalador de novo:\\n${installers}Ou atualize em https://nodejs.org.\\n`\n    : `Warning: Node.js ${version} is no longer supported by the ToStudy CLI. Update to Node.js ${MIN_NODE_MAJOR} or newer by running the installer again:\\n${installers}Or update at https://nodejs.org.\\n`;\n}\n", "/**\n * Entry point for the bundled npm CLI.\n * This file is used by build-npm.mjs as the esbuild entrypoint.\n *\n * Uses dynamic import so LOG_LEVEL is set BEFORE any module loads\n * (ESM static imports are hoisted and run before top-level code).\n */\n\n// The only static import: a leaf with no imports and no side effects (see node-floor.ts).\nimport { canRunOnNode, meetsNodeFloor, nodeGuardMessage } from \"./node-floor\";\n\n// Suppress @repo/logger output in CLI mode\nif (!process.env.LOG_LEVEL) {\n  process.env.LOG_LEVEL = \"fatal\";\n}\n\n// GH #1414 \u2014 guard de versao ANTES de qualquer import. O CLI exige Node >= 22\n// (`engines`, node-detector.ts, build target `node22`) mas nada checava em runtime:\n// o aluno com Node antigo levava um erro cru de sintaxe/referencia, sem saber que a\n// causa era a versao. Mensagem simples e sem dependencia \u2014 o bundle de erros vive\n// dentro de ./cli, que e justamente o que nao pode carregar aqui.\n//\n// GH #2114 \u2014 o piso real das dependencias e 20.18.1 (undici 7; commander 14 pede 20),\n// e o Node 20 esta em EOL desde 2026-04-30, entao o piso suportado e 22: abaixo de\n// 20.18.1 o guard bloqueia, entre 20.18.1 e 21 ele so avisa (node-floor.ts). O guard so\n// roda antes do undici porque o resto do CLI mora em dist/main.js (build-npm.mjs): num\n// arquivo unico o esbuild subia os imports externos para o topo de dist/cli.js e o Node\n// 18 quebrava dentro do undici.\n//\n// GH #2130 \u2014 desde a GH #2115 o install.sh e o install.ps1 atualizam o Node abaixo do\n// 22, entao a mensagem manda rodar o instalador de novo e deixa o nodejs.org como\n// caminho manual (texto em node-floor.ts:nodeGuardMessage).\n//\n// A resolucao de idioma espelha `errors/index.ts:resolveLocale()` de proposito:\n// `--locale` > `LANG` > pt-BR (o CLI e pt-BR-first, CHORE-1571 Fase D). Nao da\n// para reusar a funcao \u2014 ela vive no bundle que este guard existe para nao\n// carregar. Sem o passo do `--locale` este era o unico ponto do CLI que ignorava\n// a flag (GH #1414).\nif (!meetsNodeFloor(process.versions.node)) {\n  const localeFlagIdx = process.argv.indexOf(\"--locale\");\n  const localeFlag =\n    localeFlagIdx !== -1 && localeFlagIdx + 1 < process.argv.length\n      ? process.argv[localeFlagIdx + 1]\n      : undefined;\n  const pt =\n    localeFlag === \"pt-BR\" || localeFlag === \"en-US\"\n      ? localeFlag === \"pt-BR\"\n      : !(process.env[\"LANG\"] ?? \"\").toLowerCase().startsWith(\"en\");\n  // GH #2114 \u2014 below MIN_NODE_RUNTIME the bundle cannot load (undici 7): stop here.\n  // Between it and MIN_NODE_MAJOR (Node 20.18.1+) the CLI still works, so warn and go\n  // on: those students ran 0.18.0 fine and get this version through the auto-update.\n  if (!canRunOnNode(process.versions.node)) {\n    process.stderr.write(nodeGuardMessage(\"block\", process.versions.node, pt));\n    process.exit(1);\n  }\n  process.stderr.write(nodeGuardMessage(\"warn\", process.versions.node, pt));\n}\n\n// GH #1414 item 7 \u2014 account locale captured by `tostudy login` (config.json)\n// beats the OS LANG. Read here, before the bundle loads, and handed over via\n// env so errors/index.ts stays a leaf (no errors \u2192 auth import edge).\nif (!process.env[\"TOSTUDY_LOCALE\"]) {\n  try {\n    const { readFileSync } = await import(\"node:fs\");\n    const { join } = await import(\"node:path\");\n    const { homedir } = await import(\"node:os\");\n    const xdg = process.env[\"XDG_CONFIG_HOME\"];\n    const dir =\n      process.platform === \"linux\" && xdg ? join(xdg, \"tostudy\") : join(homedir(), \".tostudy\");\n    const { locale } = JSON.parse(readFileSync(join(dir, \"config.json\"), \"utf-8\")) as {\n      locale?: unknown;\n    };\n    if (locale === \"pt-BR\" || locale === \"en-US\") process.env[\"TOSTUDY_LOCALE\"] = locale;\n  } catch {\n    // No session yet, or unreadable \u2014 LANG / pt-BR fallback applies.\n  }\n}\n\nconst { createProgram, CLI_VERSION, checkForUpdates, maybeAutoUpdate } = await import(\"./main\");\n\n// GH #1419 item 3 \u2014 `.action(async \u2026)` + `parse()` means a rejected command\n// promise is an unhandled rejection: Node dumps a raw stack. One net, in the\n// student's language, instead of a try/catch per command.\nprocess.on(\"unhandledRejection\", (reason) => {\n  const msg = reason instanceof Error ? reason.message : String(reason);\n  process.stderr.write(`Erro: ${msg}\\n  Se o problema continuar, rode: tostudy doctor\\n`);\n  process.exit(1);\n});\n\nconst program = createProgram();\nprogram.parse();\n\ncheckForUpdates(CLI_VERSION);\nmaybeAutoUpdate(CLI_VERSION);\n\nexport {};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/main.js

@@ -1040,6 +1040,8 @@ var init_errors_pt_br = __esm({
       suggestNoOverlap: "Sem coincid\xEAncia com o perfil.",
       suggestEmptyProfile: "Perfil vazio. Mostrando cursos gratuitos em aberto.",
       suggestReason: "Motivo:",
+      suggestReasonMatch: "combina com o seu perfil em",
+      suggestReasonAnd: "e",
       suggestPaidHeader: "Pagos. A matr\xEDcula fica no navegador e nada \xE9 debitado por aqui:",
       enrollmentNotEntitled: "\u{1F6AB} Sua matr\xEDcula neste curso n\xE3o est\xE1 mais ativa (reembolso, cancelamento ou preview expirado).\nPara voltar a estudar, adquira o curso novamente em https://tostudy.ai.\n",
       creator: {
@@ -1149,6 +1151,8 @@ var init_errors_en_us = __esm({
       suggestNoOverlap: "No word in the profile matched.",
       suggestEmptyProfile: "Profile is empty. Showing open free courses.",
       suggestReason: "Why:",
+      suggestReasonMatch: "matches your profile on",
+      suggestReasonAnd: "and",
       suggestPaidHeader: "Paid. Enrollment stays in the browser and nothing is charged here:",
       enrollmentNotEntitled: "\u{1F6AB} Your enrollment in this course is no longer active (refund, cancellation, or expired preview).\nTo study again, purchase the course at https://tostudy.ai.\n",
       creator: {
@@ -1620,7 +1624,8 @@ function formatCourseList(courses) {
     return [
       "Nenhum curso encontrado.",
       "",
-      "\u2192 Acesse tostudy.ai para se matricular em um curso"
+      "\u2192 tostudy suggest           cursos que voc\xEA pode come\xE7ar agora",
+      "\u2192 tostudy enroll <id>       matricula sem sair do terminal"
     ].join("\n");
   }
   const lines = ["Seus cursos:", ""];
@@ -3452,6 +3457,13 @@ function assertTrustedApiUrl(apiUrl) {
     `API URL n\xE3o confi\xE1vel: ${apiUrl}. Use https://tostudy.ai (ou um subdom\xEDnio) ou localhost.`
   );
 }
+function browserCommand(platform2, url2) {
+  if (platform2 === "darwin") return { cmd: "open", args: [url2] };
+  if (platform2 === "win32") {
+    return { cmd: "rundll32", args: ["url.dll,FileProtocolHandler", url2] };
+  }
+  return { cmd: "xdg-open", args: [url2] };
+}
 function buildAuthorizeUrl(apiUrl, port, state, creator) {
   const base = `${apiUrl}/api/cli/auth/authorize?port=${port}&state=${state}`;
   return creator ? `${base}&scope=creator` : base;
@@ -3559,8 +3571,8 @@ var loginCommand = new Command("login").description("Autentica no ToStudy via br
     const state = randomBytes(32).toString("hex");
     const serverPromise = startCallbackServer(PORT, state);
     const authUrl = buildAuthorizeUrl(apiUrl, PORT, state, opts.creator === true);
-    const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
-    execFile2(openCmd, [authUrl], (err) => {
+    const { cmd, args } = browserCommand(process.platform, authUrl);
+    execFile2(cmd, args, (err) => {
       if (err) {
         console.log(`  N\xE3o foi poss\xEDvel abrir o browser automaticamente.`);
         console.log(`  Abra manualmente: ${authUrl}
@@ -3644,7 +3656,7 @@ var loginCommand = new Command("login").description("Autentica no ToStudy via br
   \u2713 ${courses.length} curso(s) matriculado(s)`);
         } else {
           console.log(`
-  \u2192 Nenhum curso matriculado. Acesse tostudy.ai`);
+  \u2192 Nenhum curso matriculado. Rode: tostudy suggest`);
         }
       } catch {
       }
@@ -3748,9 +3760,14 @@ async function runMcpSetup(session, token, spawnImpl = spawn) {
 var defaultDeps = {
   log: (message = "") => {
     console.log(message);
-  }
+  },
+  setupMcp: () => runSetupMcpSubcommand()
 };
-async function runSetup(_opts, deps = defaultDeps) {
+async function runSetup(opts, deps = defaultDeps) {
+  if (opts.mcp) {
+    await deps.setupMcp();
+    return;
+  }
   const errors = getErrors();
   deps.log(errors.setupRetiredNotice);
   deps.log(errors.setupRetiredNext);
@@ -3816,7 +3833,7 @@ init_workspace_state();
 init_formatter();
 
 // src/version.ts
-var CLI_VERSION = true ? "0.18.6" : "0.7.1";
+var CLI_VERSION = true ? "0.18.7" : "0.7.1";
 
 // src/update-checker.ts
 init_config_dir();
@@ -4348,18 +4365,40 @@ var STOP_WORDS = /* @__PURE__ */ new Set([
   "do",
   "das",
   "dos",
+  "por",
+  "pro",
+  "pra",
   "para",
   "com",
+  "sem",
   "uma",
   "um",
+  "nao",
+  "n\xE3o",
+  "que",
+  "mais",
+  "como",
+  "isso",
+  "este",
+  "esta",
+  "tem",
   "the",
   "and",
   "for",
   "you",
+  "your",
+  "with",
   "seu",
   "sua",
+  "seus",
+  "suas",
+  "meu",
+  "minha",
   "curso",
-  "course"
+  "cursos",
+  "course",
+  "tags",
+  "tag"
 ]);
 var TOKEN_SPLIT = /[^\p{L}\p{N}]+/u;
 var MAX_RESULTS = 3;
@@ -4401,7 +4440,7 @@ function rankSuggestions(courses, query) {
     }));
   }
   const textTokens = tokensOf(text2, true);
-  const levelTokens = level === null ? [] : tokensOf(level, false);
+  const levelTokens = level === null ? [] : tokensOf(level, true);
   const scored = courses.map((course) => {
     const stack = haystack(course);
     const outsideLevel = haystackWithoutLevel(course);
@@ -4544,10 +4583,14 @@ function suggestionQuery(brief, profile, workspaceTokens) {
     level: profile?.learnerLevel ?? null
   };
 }
+function listaDeTemas(tokens, copy) {
+  if (tokens.length === 1) return tokens[0];
+  return `${tokens.slice(0, -1).join(", ")} ${copy.suggestReasonAnd} ${tokens.at(-1)}`;
+}
 function reasonText(reason, copy) {
   if (reason === "empty-profile") return copy.suggestEmptyProfile;
   if (reason === "no-overlap") return copy.suggestNoOverlap;
-  return reason;
+  return `${copy.suggestReasonMatch} ${listaDeTemas(reason.split(","), copy)}`;
 }
 function formatBlock(ranked, lineFor) {
   const copy = getErrors();
@@ -22267,18 +22310,7 @@ import { execFile as execFile4 } from "node:child_process";
 import { platform } from "node:process";
 var BRIEF_URL = "https://tostudy.ai/student/settings/learner-brief";
 function openUrl(url2, options = {}) {
-  let cmd;
-  let args;
-  if (platform === "darwin") {
-    cmd = "open";
-    args = [url2];
-  } else if (platform === "win32") {
-    cmd = "cmd";
-    args = ["/c", "start", "", url2];
-  } else {
-    cmd = "xdg-open";
-    args = [url2];
-  }
+  const { cmd, args } = browserCommand(platform, url2);
   execFile4(cmd, args, (err) => {
     if (err && !options.silent) {
       output(`N\xE3o consegui abrir o navegador. Acesse manualmente: ${url2}`, {