@tostudy-ai/cli 0.16.2 → 0.16.5

package/dist/cli.js

@@ -41,7 +41,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/@parisgroup-ai/logger/dist/sanitize-4AyoT9ic.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/sanitize-DSkXy3jL.mjs
 function isSensitiveKey(key) {
   if (matchesSensitiveField(key)) return true;
   return matchesPluralOfSensitiveField(key);
@@ -114,11 +114,12 @@ function sanitizeRecord(obj, ctx) {
   if (ctx.visited.has(obj)) return "[Circular]";
   ctx.visited.add(obj);
   const sanitized = { ...obj };
+  const mask = ctx.redactMask ?? "[REDACTED]";
   for (const [key, value] of Object.entries(sanitized)) {
     const isAdditionalKey = ctx.additionalSensitiveKeys?.some((k) => key.toLowerCase() === k.toLowerCase());
     const pluralCountExemption = typeof value === "number" && !isAdditionalKey && !matchesSensitiveField(key) && matchesPluralOfSensitiveField(key);
     if ((isSensitiveKey(key) || isAdditionalKey) && !pluralCountExemption) {
-      sanitized[key] = "[REDACTED]";
+      sanitized[key] = mask;
       continue;
     }
     if (value instanceof Error) {
@@ -139,16 +140,17 @@ function sanitizeRecord(obj, ctx) {
   ctx.visited.delete(obj);
   return sanitized;
 }
-function sanitizeEntryData(obj, additionalSensitiveKeys, includeStack) {
+function sanitizeEntryData(obj, additionalSensitiveKeys, includeStack, redactMask) {
   return sanitizeRecord(obj, {
     additionalSensitiveKeys,
     includeStack,
-    visited: /* @__PURE__ */ new WeakSet()
+    visited: /* @__PURE__ */ new WeakSet(),
+    redactMask
   });
 }
 var SENSITIVE_FIELDS;
-var init_sanitize_4AyoT9ic = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/sanitize-4AyoT9ic.mjs"() {
+var init_sanitize_DSkXy3jL = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/sanitize-DSkXy3jL.mjs"() {
     SENSITIVE_FIELDS = [
       "password",
       "senha",
@@ -279,7 +281,7 @@ var require_picocolors = __commonJS({
   }
 });
 
-// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DOZPgsDx.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DkbC4pBB.mjs
 function formatJson(entry) {
   const { timestamp, level, message, service, environment, context, data, error: error49 } = entry;
   const output3 = {
@@ -383,9 +385,9 @@ function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new W
   return info;
 }
 var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, BaseLogger;
-var init_logger_base_DOZPgsDx = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DOZPgsDx.mjs"() {
-    init_sanitize_4AyoT9ic();
+var init_logger_base_DkbC4pBB = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DkbC4pBB.mjs"() {
+    init_sanitize_DSkXy3jL();
     import_picocolors = __toESM(require_picocolors(), 1);
     LOG_LEVELS = {
       trace: 0,
@@ -414,6 +416,8 @@ var init_logger_base_DOZPgsDx = __esm({
       transports;
       shouldSanitize;
       sensitiveFields;
+      redactMask;
+      sampleRate;
       includeCaller;
       piiFilter;
       constructor(options, defaults) {
@@ -426,6 +430,8 @@ var init_logger_base_DOZPgsDx = __esm({
         this.transports = [];
         this.shouldSanitize = options.sanitize ?? true;
         this.sensitiveFields = options.sensitiveFields;
+        this.redactMask = options.redactMask;
+        this.sampleRate = options.sampleRate;
         this.includeCaller = options.includeCaller ?? "errors";
         this.piiFilter = options.piiFilter;
       }
@@ -440,14 +446,19 @@ var init_logger_base_DOZPgsDx = __esm({
       flush() {
       }
       shouldLog(level) {
-        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+        if (LOG_LEVELS[level] < LOG_LEVELS[this.level]) return false;
+        if (this.sampleRate !== void 0 && (level === "trace" || level === "debug" || level === "info")) {
+          if (this.sampleRate <= 0) return false;
+          if (this.sampleRate < 1 && Math.random() > this.sampleRate) return false;
+        }
+        return true;
       }
       buildEntry(level, message, data, error49) {
         const merged = {
           ...this.getLogContext() ?? {},
           ...this.additionalContext
         };
-        const context = this.shouldSanitize ? sanitizeEntryData(merged, this.sensitiveFields, !this.isProd()) : merged;
+        const context = this.shouldSanitize ? sanitizeEntryData(merged, this.sensitiveFields, !this.isProd(), this.redactMask) : merged;
         if (this.module) context.module = this.module;
         if (this.includeCaller === true || this.includeCaller === "errors" && (level === "error" || level === "fatal")) {
           const caller = this.getCaller();
@@ -478,11 +489,11 @@ var init_logger_base_DOZPgsDx = __esm({
         if (typeof data === "string" || typeof data === "number" || typeof data === "boolean") return { value: data };
         if (Array.isArray(data)) {
           const wrapped = { items: data };
-          return this.shouldSanitize ? sanitizeEntryData(wrapped, this.sensitiveFields, includeStack) : wrapped;
+          return this.shouldSanitize ? sanitizeEntryData(wrapped, this.sensitiveFields, includeStack, this.redactMask) : wrapped;
         }
         if (typeof data === "object") {
           const obj = data;
-          return this.shouldSanitize ? sanitizeEntryData(obj, this.sensitiveFields, includeStack) : obj;
+          return this.shouldSanitize ? sanitizeEntryData(obj, this.sensitiveFields, includeStack, this.redactMask) : obj;
         }
         return { value: String(data) };
       }
@@ -590,16 +601,60 @@ import { join } from "node:path";
 function getLogContext() {
   return asyncLocalStorage.getStore();
 }
-function globalSlot() {
-  return globalThis;
+function getOrCreateGlobalSingleton(key, factory) {
+  const slot = globalThis;
+  const existing = slot[key];
+  if (existing) return existing;
+  const created = factory();
+  slot[key] = created;
+  return created;
 }
 function getOrCreateHttpTransport(options) {
-  const slot = globalSlot();
-  const existing = slot[SINGLETON_KEY];
-  if (existing) return existing;
-  const transport = new HttpTransport(options);
-  slot[SINGLETON_KEY] = transport;
-  return transport;
+  return getOrCreateGlobalSingleton(SINGLETON_KEY$1, () => new HttpTransport(options));
+}
+function toAttributeValue(value) {
+  if (typeof value === "boolean") return { boolValue: value };
+  if (typeof value === "number") return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+  if (value == null) return { stringValue: "" };
+  if (typeof value === "object") try {
+    return { stringValue: JSON.stringify(value) };
+  } catch {
+    return { stringValue: String(value) };
+  }
+  return { stringValue: String(value) };
+}
+function toAttributes(record2) {
+  return Object.entries(record2).map(([key, value]) => ({
+    key,
+    value: toAttributeValue(value)
+  }));
+}
+function toLogRecord(entry) {
+  const { number: number4, text } = SEVERITY[entry.level] ?? SEVERITY.info;
+  const attributes = {
+    ...entry.context,
+    ...entry.data
+  };
+  return {
+    timeUnixNano: String(BigInt(Date.parse(entry.timestamp)) * 1000000n),
+    severityNumber: number4,
+    severityText: text,
+    body: { stringValue: entry.message },
+    attributes: toAttributes(attributes)
+  };
+}
+function getOrCreateOtlpLogsTransport(options) {
+  return getOrCreateGlobalSingleton(SINGLETON_KEY, () => new OtlpLogsTransport(options));
+}
+function parseOtlpResourceAttributes(raw) {
+  if (!raw) return {};
+  const out = {};
+  for (const pair of raw.split(",")) {
+    const eq = pair.indexOf("=");
+    if (eq <= 0) continue;
+    out[pair.slice(0, eq).trim()] = pair.slice(eq + 1).trim();
+  }
+  return out;
 }
 function detectEnvironment() {
   const isProd = process.env.NODE_ENV === "production" || !!process.env.VERCEL || !!process.env.RAILWAY_ENVIRONMENT;
@@ -650,11 +705,11 @@ function createLogger(module, options) {
     module
   });
 }
-var asyncLocalStorage, ConsoleTransport, FileTransport, HttpTransport, SINGLETON_KEY, Logger, logger;
+var asyncLocalStorage, ConsoleTransport, FileTransport, HttpTransport, SINGLETON_KEY$1, SEVERITY, OtlpLogsTransport, SINGLETON_KEY, Logger, logger;
 var init_dist = __esm({
   "../../node_modules/@parisgroup-ai/logger/dist/index.mjs"() {
-    init_logger_base_DOZPgsDx();
-    init_sanitize_4AyoT9ic();
+    init_logger_base_DkbC4pBB();
+    init_sanitize_DSkXy3jL();
     asyncLocalStorage = new AsyncLocalStorage();
     ConsoleTransport = class {
       log(entry, formatted) {
@@ -758,7 +813,113 @@ var init_dist = __esm({
         });
       }
     };
-    SINGLETON_KEY = /* @__PURE__ */ Symbol.for("@repo/logger.sharedHttpTransport");
+    SINGLETON_KEY$1 = /* @__PURE__ */ Symbol.for("@repo/logger.sharedHttpTransport");
+    SEVERITY = {
+      trace: {
+        number: 1,
+        text: "TRACE"
+      },
+      debug: {
+        number: 5,
+        text: "DEBUG"
+      },
+      info: {
+        number: 9,
+        text: "INFO"
+      },
+      warn: {
+        number: 13,
+        text: "WARN"
+      },
+      error: {
+        number: 17,
+        text: "ERROR"
+      },
+      fatal: {
+        number: 21,
+        text: "FATAL"
+      }
+    };
+    OtlpLogsTransport = class {
+      buffer = [];
+      timer = null;
+      flushing = false;
+      disposed = false;
+      url;
+      serviceName;
+      resourceAttributes;
+      extraHeaders;
+      maxBufferSize;
+      flushInterval;
+      onError;
+      constructor(options) {
+        this.url = `${options.endpoint.replace(/\/+$/, "")}/v1/logs`;
+        this.serviceName = options.serviceName;
+        this.resourceAttributes = options.resourceAttributes ?? {};
+        this.extraHeaders = options.headers ?? {};
+        this.maxBufferSize = options.maxBufferSize ?? 50;
+        this.flushInterval = options.flushInterval ?? 5e3;
+        this.onError = options.onError;
+        this.timer = setInterval(() => {
+          this.flush().catch(() => {
+          });
+        }, this.flushInterval);
+        process.once("beforeExit", () => this.dispose());
+        process.once("SIGTERM", () => this.dispose());
+      }
+      log(entry, _formatted) {
+        if (this.disposed) return;
+        this.buffer.push(entry);
+        if (this.buffer.length >= this.maxBufferSize) this.flush().catch(() => {
+        });
+      }
+      serialize(batch) {
+        const resourceAttrs = {
+          "service.name": this.serviceName,
+          ...this.resourceAttributes
+        };
+        return JSON.stringify({ resourceLogs: [{
+          resource: { attributes: toAttributes(resourceAttrs) },
+          scopeLogs: [{
+            scope: { name: "@parisgroup-ai/logger" },
+            logRecords: batch.map(toLogRecord)
+          }]
+        }] });
+      }
+      async flush() {
+        if (this.flushing || this.buffer.length === 0) return;
+        this.flushing = true;
+        const batch = this.buffer.splice(0);
+        try {
+          const response = await fetch(this.url, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              ...this.extraHeaders
+            },
+            body: this.serialize(batch),
+            signal: AbortSignal.timeout(1e4)
+          });
+          if (!response.ok) throw new Error(`OTLP log ingest failed: ${response.status} ${response.statusText}`);
+        } catch (error49) {
+          if (this.buffer.length < this.maxBufferSize * 3) this.buffer.unshift(...batch);
+          this.onError?.(error49, batch.length);
+        } finally {
+          this.flushing = false;
+        }
+      }
+      dispose() {
+        if (this.disposed) return;
+        this.disposed = true;
+        if (this.timer) {
+          clearInterval(this.timer);
+          this.timer = null;
+        }
+        if (this.buffer.length > 0) this.flush().catch(() => {
+        });
+      }
+    };
+    SINGLETON_KEY = /* @__PURE__ */ Symbol.for("@repo/logger.sharedOtlpLogsTransport");
     Logger = class Logger2 extends BaseLogger {
       fileTransport;
       _isProd;
@@ -783,6 +944,16 @@ var init_dist = __esm({
           authorization: `Bearer ${drainToken}`,
           onError: (err, count) => {
             process.stderr.write(`[logger] HTTP transport error: ${err.message} (${count} entries)
+`);
+          }
+        }));
+        const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        if (otlpEndpoint) this.transports.push(getOrCreateOtlpLogsTransport({
+          endpoint: otlpEndpoint,
+          serviceName: process.env.OTEL_SERVICE_NAME || getDefaultService(),
+          resourceAttributes: parseOtlpResourceAttributes(process.env.OTEL_RESOURCE_ATTRIBUTES),
+          onError: (err, count) => {
+            process.stderr.write(`[logger] OTLP transport error: ${err.message} (${count} entries)
 `);
           }
         }));
@@ -812,6 +983,8 @@ var init_dist = __esm({
           environment: this.environment,
           sanitize: this.shouldSanitize,
           sensitiveFields: this.sensitiveFields,
+          redactMask: this.redactMask,
+          sampleRate: this.sampleRate,
           includeCaller: this.includeCaller,
           piiFilter: this.piiFilter
         });
@@ -1414,7 +1587,7 @@ function formatCourseList(courses) {
     return [
       "Nenhum curso encontrado.",
       "",
-      "\u2192 tostudy enroll <curso>  para se matricular em um curso"
+      "\u2192 Acesse tostudy.ai para se matricular em um curso"
     ].join("\n");
   }
   const lines = ["Seus cursos:", ""];
@@ -2578,6 +2751,101 @@ var init_user_profile = __esm({
   }
 });
 
+// src/errors/errors-pt-br.ts
+var ptBrErrors;
+var init_errors_pt_br = __esm({
+  "src/errors/errors-pt-br.ts"() {
+    "use strict";
+    ptBrErrors = {
+      notFound: "n\xE3o encontrado",
+      workspaceNotFoundShort: "\u274C Workspace n\xE3o encontrado. Execute 'tostudy workspace setup' primeiro.\n",
+      workspaceNotFoundFromExport: "\u274C Workspace n\xE3o encontrado. Execute 'tostudy workspace setup' ou rode 'tostudy select' desta pasta.\n",
+      vaultNotFound: "\u274C Vault n\xE3o encontrado. Execute 'tostudy vault init' primeiro.\n",
+      logoutSuccess: "\n  Deslogado com sucesso.\n",
+      workspaceCommandDescription: "Gerenciar workspace de estudo local",
+      workspaceSetupDescription: "Criar estrutura do workspace para o curso ativo",
+      insufficientCredits: "\u274C Voc\xEA est\xE1 sem cr\xE9ditos. Cada resposta do tutor de IA consome cr\xE9ditos para cobrir o processamento. Recarregue em https://tostudy.ai/student/credits para continuar de onde parou.\n",
+      workspaceRefusedAtHome: "N\xE3o d\xE1 para configurar o estudo direto na sua pasta pessoal.\nCrie uma pasta para o curso e entre nela antes de continuar:\n\n  mkdir ~/meus-cursos && cd ~/meus-cursos\n",
+      courseArchived: "Este curso foi arquivado e est\xE1 dispon\xEDvel somente para leitura.\nUse `tostudy lesson` para revisar o conte\xFAdo j\xE1 estudado.\n",
+      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"
+    };
+  }
+});
+
+// src/errors/errors-en-us.ts
+var enUsErrors;
+var init_errors_en_us = __esm({
+  "src/errors/errors-en-us.ts"() {
+    "use strict";
+    enUsErrors = {
+      notFound: "not found",
+      workspaceNotFoundShort: "\u274C Workspace not found. Run 'tostudy workspace setup' first.\n",
+      workspaceNotFoundFromExport: "\u274C Workspace not found. Run 'tostudy workspace setup' or 'tostudy select' from this folder.\n",
+      vaultNotFound: "\u274C Vault not found. Run 'tostudy vault init' first.\n",
+      logoutSuccess: "\n  Logged out successfully.\n",
+      workspaceCommandDescription: "Manage local study workspace",
+      workspaceSetupDescription: "Create the workspace structure for the active course",
+      insufficientCredits: "\u274C You're out of credits. Every reply from the AI tutor uses credits to cover processing. Top up at https://tostudy.ai/student/credits to continue from where you stopped.\n",
+      workspaceRefusedAtHome: "Study can't be set up directly in your home folder.\nCreate a folder for the course and switch into it first:\n\n  mkdir ~/my-courses && cd ~/my-courses\n",
+      courseArchived: "This course has been archived and is available for reading only.\nUse `tostudy lesson` to review the content you've already studied.\n",
+      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"
+    };
+  }
+});
+
+// src/errors/index.ts
+function resolveLocale() {
+  if (_cachedLocale !== null) return _cachedLocale;
+  const argv = process.argv;
+  const flagIdx = argv.indexOf("--locale");
+  if (flagIdx !== -1 && flagIdx + 1 < argv.length) {
+    const val = argv[flagIdx + 1];
+    if (val === "pt-BR" || val === "en-US") {
+      _cachedLocale = val;
+      return val;
+    }
+  }
+  const lang = (process.env["LANG"] ?? "").toLowerCase();
+  if (lang.startsWith("en")) {
+    _cachedLocale = "en-US";
+    return "en-US";
+  }
+  _cachedLocale = "pt-BR";
+  return "pt-BR";
+}
+function getErrors(locale) {
+  return BUNDLES[locale ?? resolveLocale()];
+}
+function resolveErrorCode(err) {
+  if (err && typeof err === "object" && "code" in err) {
+    const code = err.code;
+    if (typeof code === "string" && code.length > 0) return code;
+  }
+  return err instanceof Error ? err.message : String(err);
+}
+function isInsufficientCreditsError(err) {
+  return resolveErrorCode(err).includes("INSUFFICIENT_CREDITS");
+}
+function isCourseArchivedError(err) {
+  return resolveErrorCode(err).includes("COURSE_ARCHIVED");
+}
+function isEnrollmentNotEntitledError(err) {
+  return resolveErrorCode(err).includes("ENROLLMENT_NOT_ENTITLED");
+}
+var BUNDLES, _cachedLocale;
+var init_errors = __esm({
+  "src/errors/index.ts"() {
+    "use strict";
+    init_errors_pt_br();
+    init_errors_en_us();
+    BUNDLES = {
+      "pt-BR": ptBrErrors,
+      "en-US": enUsErrors
+    };
+    _cachedLocale = null;
+  }
+});
+
 // src/workspace/workspace-marker.ts
 import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3, readFileSync as readFileSync2 } from "node:fs";
 import os4 from "node:os";
@@ -2607,9 +2875,7 @@ async function writeWorkspaceMarker(workspacePath, input2, options = {}) {
   const homeDir = path7.resolve(options.homeDir ?? os4.homedir());
   const resolvedWorkspace = path7.resolve(workspacePath);
   if (resolvedWorkspace === homeDir || homeDir.startsWith(resolvedWorkspace + path7.sep)) {
-    throw new Error(
-      `Refusing to write workspace marker at ${workspacePath}: it is the home directory or an ancestor of it.`
-    );
+    throw new Error(getErrors().workspaceRefusedAtHome);
   }
   const filePath = resolveMarkerPath(workspacePath);
   const dir = path7.dirname(filePath);
@@ -2634,6 +2900,7 @@ var CURRENT_VERSION, SUPPORTED_VERSIONS;
 var init_workspace_marker = __esm({
   "src/workspace/workspace-marker.ts"() {
     "use strict";
+    init_errors();
     CURRENT_VERSION = 1;
     SUPPORTED_VERSIONS = /* @__PURE__ */ new Set([1, 2]);
   }
@@ -2785,99 +3052,6 @@ var init_course_state = __esm({
   }
 });
 
-// src/errors/errors-pt-br.ts
-var ptBrErrors;
-var init_errors_pt_br = __esm({
-  "src/errors/errors-pt-br.ts"() {
-    "use strict";
-    ptBrErrors = {
-      notFound: "n\xE3o encontrado",
-      workspaceNotFoundShort: "\u274C Workspace n\xE3o encontrado. Execute 'tostudy workspace setup' primeiro.\n",
-      workspaceNotFoundFromExport: "\u274C Workspace n\xE3o encontrado. Execute 'tostudy workspace setup' ou rode 'tostudy select' desta pasta.\n",
-      vaultNotFound: "\u274C Vault n\xE3o encontrado. Execute 'tostudy vault init' primeiro.\n",
-      logoutSuccess: "\n  Deslogado com sucesso.\n",
-      workspaceCommandDescription: "Gerenciar workspace de estudo local",
-      workspaceSetupDescription: "Criar estrutura do workspace para o curso ativo",
-      insufficientCredits: "\u274C Voc\xEA est\xE1 sem cr\xE9ditos. Cada resposta do tutor de IA consome cr\xE9ditos para cobrir o processamento. Recarregue em https://tostudy.ai/student/credits para continuar de onde parou.\n",
-      courseArchived: "Este curso foi arquivado e est\xE1 dispon\xEDvel somente para leitura.\nUse `tostudy lesson` para revisar o conte\xFAdo j\xE1 estudado.\n",
-      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"
-    };
-  }
-});
-
-// src/errors/errors-en-us.ts
-var enUsErrors;
-var init_errors_en_us = __esm({
-  "src/errors/errors-en-us.ts"() {
-    "use strict";
-    enUsErrors = {
-      notFound: "not found",
-      workspaceNotFoundShort: "\u274C Workspace not found. Run 'tostudy workspace setup' first.\n",
-      workspaceNotFoundFromExport: "\u274C Workspace not found. Run 'tostudy workspace setup' or 'tostudy select' from this folder.\n",
-      vaultNotFound: "\u274C Vault not found. Run 'tostudy vault init' first.\n",
-      logoutSuccess: "\n  Logged out successfully.\n",
-      workspaceCommandDescription: "Manage local study workspace",
-      workspaceSetupDescription: "Create the workspace structure for the active course",
-      insufficientCredits: "\u274C You're out of credits. Every reply from the AI tutor uses credits to cover processing. Top up at https://tostudy.ai/student/credits to continue from where you stopped.\n",
-      courseArchived: "This course has been archived and is available for reading only.\nUse `tostudy lesson` to review the content you've already studied.\n",
-      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"
-    };
-  }
-});
-
-// src/errors/index.ts
-function resolveLocale() {
-  if (_cachedLocale !== null) return _cachedLocale;
-  const argv = process.argv;
-  const flagIdx = argv.indexOf("--locale");
-  if (flagIdx !== -1 && flagIdx + 1 < argv.length) {
-    const val = argv[flagIdx + 1];
-    if (val === "pt-BR" || val === "en-US") {
-      _cachedLocale = val;
-      return val;
-    }
-  }
-  const lang = (process.env["LANG"] ?? "").toLowerCase();
-  if (lang.startsWith("en")) {
-    _cachedLocale = "en-US";
-    return "en-US";
-  }
-  _cachedLocale = "pt-BR";
-  return "pt-BR";
-}
-function getErrors(locale) {
-  return BUNDLES[locale ?? resolveLocale()];
-}
-function resolveErrorCode(err) {
-  if (err && typeof err === "object" && "code" in err) {
-    const code = err.code;
-    if (typeof code === "string" && code.length > 0) return code;
-  }
-  return err instanceof Error ? err.message : String(err);
-}
-function isInsufficientCreditsError(err) {
-  return resolveErrorCode(err).includes("INSUFFICIENT_CREDITS");
-}
-function isCourseArchivedError(err) {
-  return resolveErrorCode(err).includes("COURSE_ARCHIVED");
-}
-function isEnrollmentNotEntitledError(err) {
-  return resolveErrorCode(err).includes("ENROLLMENT_NOT_ENTITLED");
-}
-var BUNDLES, _cachedLocale;
-var init_errors = __esm({
-  "src/errors/index.ts"() {
-    "use strict";
-    init_errors_pt_br();
-    init_errors_en_us();
-    BUNDLES = {
-      "pt-BR": ptBrErrors,
-      "en-US": enUsErrors
-    };
-    _cachedLocale = null;
-  }
-});
-
 // src/commands/logout.ts
 import { Command as Command2 } from "commander";
 var logoutCommand;
@@ -2913,9 +3087,6 @@ __export(resolve_exports, {
 import fs7 from "node:fs/promises";
 import path9 from "node:path";
 import os6 from "node:os";
-function courseSlug(title) {
-  return title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
-}
 async function resolveWorkspace(courseTitle, basePath = DEFAULT_BASE) {
   const slug = courseSlug(courseTitle);
   const candidate = path9.join(basePath, slug);
@@ -3001,11 +3172,13 @@ async function resolveActiveCourseFromWorkspace(options = {}) {
   const result = await findWorkspaceState2(options.cwd, options.homeDir);
   return result?.state ?? null;
 }
-var DEFAULT_BASE, resolveActiveCourseWithOverride;
+var DEFAULT_BASE, courseSlug, resolveActiveCourseWithOverride;
 var init_resolve = __esm({
   "src/workspace/resolve.ts"() {
     "use strict";
+    init_slug();
     DEFAULT_BASE = path9.join(os6.homedir(), "study");
+    courseSlug = slugify;
     resolveActiveCourseWithOverride = resolveActiveCourseFromWorkspace;
   }
 });
@@ -3197,7 +3370,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.16.2" : "0.7.1";
+    CLI_VERSION = true ? "0.16.5" : "0.7.1";
   }
 });
 
@@ -20404,7 +20577,9 @@ function getStarterCode(structuredData) {
   return data?.starterCode ?? null;
 }
 async function extractExercise(input2) {
-  const { lessonData, exerciseTier, workspacePath } = input2;
+  const { exerciseTier, workspacePath } = input2;
+  const paths = input2.workspacePaths ?? { workspace: workspacePath, vault: "$VAULT" };
+  const lessonData = resolveWorkspaceTokens(input2.lessonData, paths);
   const moduleDir = `${padOrder(lessonData.moduleOrder)}-${lessonData.moduleSlug}`;
   const lessonDir = `${padOrder(lessonData.lessonOrder)}-${lessonData.lessonSlug}`;
   const exercisePath = path16.join(workspacePath, "exercises", moduleDir, lessonDir);
@@ -20522,6 +20697,7 @@ var init_extract_exercise = __esm({
   "../../packages/tostudy-core/src/workspace/extract-exercise.ts"() {
     "use strict";
     init_templates();
+    init_workspace_tokens();
   }
 });
 
@@ -20822,7 +20998,10 @@ var init_export = __esm({
         const result = await extractExercise({
           lessonData,
           exerciseTier: tier,
-          workspacePath: ws.workspacePath
+          workspacePath: ws.workspacePath,
+          // Same pair `output()` prints with (GH #1278), so the exercise files on
+          // disk and the lesson text on screen name the same folder (GH #1284).
+          workspacePaths: cliWorkspacePaths(ws.workspacePath, activeCourse.courseTitle)
         });
         if (opts.json) {
           process.stdout.write(JSON.stringify(result, null, 2) + "\n");
@@ -20972,6 +21151,7 @@ var init_vault2 = __esm({
     "use strict";
     init_dist();
     init_vault();
+    init_workspace_tokens();
     init_courses();
     init_http();
     init_guards();
@@ -21017,12 +21197,11 @@ var init_vault2 = __esm({
         if (!data.success) {
           throw new Error("API returned success: false");
         }
-        const result = await writeVaultFiles(
+        const files = resolveWorkspaceTokens(
           data.files,
-          vaultOutputPath,
-          activeCourse.courseId,
-          slug
+          cliWorkspacePaths(workspacePath, activeCourse.courseTitle)
         );
+        const result = await writeVaultFiles(files, vaultOutputPath, activeCourse.courseId, slug);
         logger21.info("Vault generated", {
           courseId: activeCourse.courseId,
           vaultPath: result.vaultPath,
@@ -22233,7 +22412,10 @@ var init_export_grades = __esm({
     defaultDeps5 = {
       requireSession,
       requireActiveCourse,
-      fetch: globalThis.fetch.bind(globalThis),
+      // Lazy: ler `globalThis.fetch` no escopo do modulo executa no LOAD do arquivo,
+      // antes de qualquer guard. Em runtime sem `fetch` global isso derruba o import
+      // inteiro do cli.ts e, com ele, TODO comando. Encaminhar mantem o load inerte.
+      fetch: (...args) => globalThis.fetch(...args),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       // process.exit is typed as `never` — wrap so the cast is local to one line.
@@ -22420,7 +22602,10 @@ var init_grades2 = __esm({
     logger33 = createLogger("cli:grades");
     defaultDeps6 = {
       requireSession,
-      fetch: globalThis.fetch.bind(globalThis),
+      // Lazy: ler `globalThis.fetch` no escopo do modulo executa no LOAD do arquivo,
+      // antes de qualquer guard. Em runtime sem `fetch` global isso derruba o import
+      // inteiro do cli.ts e, com ele, TODO comando. Encaminhar mantem o load inerte.
+      fetch: (...args) => globalThis.fetch(...args),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
@@ -22600,7 +22785,10 @@ var init_review2 = __esm({
     logger34 = createLogger("cli:review");
     defaultDeps7 = {
       requireSession,
-      fetch: globalThis.fetch.bind(globalThis),
+      // Lazy: ler `globalThis.fetch` no escopo do modulo executa no LOAD do arquivo,
+      // antes de qualquer guard. Em runtime sem `fetch` global isso derruba o import
+      // inteiro do cli.ts e, com ele, TODO comando. Encaminhar mantem o load inerte.
+      fetch: (...args) => globalThis.fetch(...args),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
@@ -22785,6 +22973,21 @@ var init_auto_updater = __esm({
 if (!process.env.LOG_LEVEL) {
   process.env.LOG_LEVEL = "fatal";
 }
+var MIN_NODE_MAJOR = 18;
+var nodeMajor = Number.parseInt(process.versions.node.split(".")[0] ?? "0", 10);
+if (Number.isFinite(nodeMajor) && nodeMajor < MIN_NODE_MAJOR) {
+  const pt = !(process.env["LANG"] ?? "").toLowerCase().startsWith("en");
+  process.stderr.write(
+    pt ? `Erro: o ToStudy CLI precisa do Node.js ${MIN_NODE_MAJOR} ou superior.
+Voce esta 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.exit(1);
+}
 var { createProgram: createProgram2, CLI_VERSION: CLI_VERSION2 } = await Promise.resolve().then(() => (init_cli(), cli_exports));
 var { checkForUpdates: checkForUpdates2 } = await Promise.resolve().then(() => (init_update_checker(), update_checker_exports));
 var { maybeAutoUpdate: maybeAutoUpdate2 } = await Promise.resolve().then(() => (init_auto_updater(), auto_updater_exports));