@tostudy-ai/cli 0.16.3 → 0.16.6

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
         });
@@ -1193,7 +1366,7 @@ async function loadStoredSessionSecrets(configDir) {
   const account = getStoreKey(configDir);
   if (process.platform === "darwin") {
     try {
-      const { stdout } = await execFileAsync("security", [
+      const { stdout: stdout2 } = await execFileAsync("security", [
         "find-generic-password",
         "-s",
         "tostudy-cli-session",
@@ -1201,21 +1374,21 @@ async function loadStoredSessionSecrets(configDir) {
         account,
         "-w"
       ]);
-      return JSON.parse(stdout.trim());
+      return JSON.parse(stdout2.trim());
     } catch {
       return null;
     }
   }
   if (process.platform === "linux" && await hasCommand("secret-tool")) {
     try {
-      const { stdout } = await execFileAsync("secret-tool", [
+      const { stdout: stdout2 } = await execFileAsync("secret-tool", [
         "lookup",
         "service",
         "tostudy-cli-session",
         "account",
         account
       ]);
-      return JSON.parse(stdout.trim());
+      return JSON.parse(stdout2.trim());
     } catch {
       return null;
     }
@@ -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:", ""];
@@ -2045,6 +2218,7 @@ var runtime_registry_exports = {};
 __export(runtime_registry_exports, {
   RUNTIMES: () => RUNTIMES,
   detectedSlashHints: () => detectedSlashHints,
+  needsRootAgentsConsent: () => needsRootAgentsConsent,
   upsertRootAgentsBlock: () => upsertRootAgentsBlock
 });
 import { execFileSync as execFileSync2 } from "node:child_process";
@@ -2083,6 +2257,15 @@ ${content}`;
 function detectedSlashHints(slug, home, cwd) {
   return RUNTIMES.filter((r) => r.slashHint && r.detect(home, cwd)).map((r) => r.slashHint(slug));
 }
+function needsRootAgentsConsent(cwd) {
+  const filePath = join2(cwd, "AGENTS.md");
+  if (!existsSync2(filePath)) return false;
+  try {
+    return !TOSTUDY_BLOCK_PATTERN.test(readFileSync(filePath, "utf-8"));
+  } catch {
+    return false;
+  }
+}
 function upsertRootAgentsBlock(cwd, ctx) {
   const slug = slugifyTitle(ctx.courseTitle);
   const block = [
@@ -2261,9 +2444,10 @@ ${content}`;
         name: "Generic (AGENTS.md)",
         // Windsurf is the remaining consumer of the generic universal install.
         detect: (home) => existsSync2(join2(home, ".codeium", "windsurf")),
-        writePerCourse({ cwd, slug, ctx, content }) {
+        writePerCourse({ cwd, slug, ctx, content, rootAgentsConsent }) {
           writeFile2(join2(cwd, ".tostudy", "courses", slug), "AGENTS.md", content);
           const written = [`.tostudy/courses/${slug}/AGENTS.md`];
+          if (needsRootAgentsConsent(cwd) && rootAgentsConsent !== true) return written;
           const rootAgents = upsertRootAgentsBlock(cwd, ctx);
           if (rootAgents) written.push(rootAgents);
           return written;
@@ -2284,6 +2468,7 @@ ${content}`;
 var instruction_files_exports = {};
 __export(instruction_files_exports, {
   installUniversalCommand: () => installUniversalCommand,
+  needsRootAgentsConsent: () => needsRootAgentsConsent,
   slugify: () => slugify,
   upsertRootAgentsBlock: () => upsertRootAgentsBlock,
   writeInstructionFiles: () => writeInstructionFiles
@@ -2293,8 +2478,9 @@ function writeInstructionFiles(cwd, ctx, content, opts = {}) {
   const home = opts.home ?? homedir();
   const force = opts.allRuntimes ?? false;
   const slug = slugify(ctx.courseTitle);
+  const rootAgentsConsent = opts.rootAgentsConsent ?? false;
   const written = RUNTIMES.flatMap(
-    (r) => r.writePerCourse?.({ cwd, home, slug, ctx, content, force }) ?? []
+    (r) => r.writePerCourse?.({ cwd, home, slug, ctx, content, force, rootAgentsConsent }) ?? []
   );
   logger3.info("Generated instruction files (v3)", { slug, files: written });
   return written;
@@ -2578,6 +2764,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 +2888,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 +2913,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 +3065,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;
@@ -3196,7 +3383,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.16.3" : "0.7.1";
+    CLI_VERSION = true ? "0.16.6" : "0.7.1";
   }
 });
 
@@ -4030,7 +4217,7 @@ async function writeFilesAdapter(cwd, courseMeta, content, opts = {}) {
       courseDescription: courseMeta.courseDescription
     },
     content,
-    { allRuntimes: opts.allRuntimes }
+    { allRuntimes: opts.allRuntimes, rootAgentsConsent: opts.rootAgentsConsent }
   );
 }
 function buildPipelineDeps(opts = {}) {
@@ -4053,6 +4240,43 @@ var init_pipeline_deps = __esm({
   }
 });
 
+// src/commands/_shared/root-agents-consent.ts
+import readline2 from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+function rootAgentsSkippedHint() {
+  return "  AGENTS.md desta pasta n\xE3o foi alterado \u2014 rode `tostudy sync --root-agents` para adicionar o bloco do ToStudy.";
+}
+async function askViaReadline(question) {
+  const rl = readline2.createInterface({ input: stdin, output: stdout });
+  try {
+    return await rl.question(question);
+  } finally {
+    rl.close();
+  }
+}
+async function resolveRootAgentsConsent(input2) {
+  const needs = (input2.needsConsent ?? needsRootAgentsConsent)(input2.cwd);
+  if (!needs) return { consent: true, asked: false };
+  if (input2.flag === true) return { consent: true, asked: true };
+  if (!input2.interactive) return { consent: false, asked: true };
+  const answer = (await (input2.ask ?? askViaReadline)(ROOT_AGENTS_QUESTION)).trim().toLowerCase();
+  return {
+    consent: answer === "s" || answer === "sim" || answer === "y" || answer === "yes",
+    asked: true
+  };
+}
+function isInteractiveTerminal(json2) {
+  return Boolean(stdin.isTTY && stdout.isTTY) && json2 !== true;
+}
+var ROOT_AGENTS_QUESTION;
+var init_root_agents_consent = __esm({
+  "src/commands/_shared/root-agents-consent.ts"() {
+    "use strict";
+    init_runtime_registry();
+    ROOT_AGENTS_QUESTION = "Esta pasta j\xE1 tem um AGENTS.md. Adicionar o bloco do ToStudy nele? [s/N] ";
+  }
+});
+
 // src/commands/select.ts
 import { Command as Command6 } from "commander";
 import os7 from "node:os";
@@ -4072,8 +4296,12 @@ var init_select = __esm({
     init_status();
     init_instruction_pipeline();
     init_pipeline_deps();
+    init_root_agents_consent();
     logger8 = createLogger("cli:select");
-    selectCommand = new Command6("select").description("Activate a course by ID or list index number").argument("<course>", "Course ID (UUID) or index number from `tostudy courses`").option("--json", "Output structured JSON").action(async (course, opts) => {
+    selectCommand = new Command6("select").description("Activate a course by ID or list index number").argument("<course>", "Course ID (UUID) or index number from `tostudy courses`").option("--json", "Output structured JSON").option(
+      "--root-agents",
+      "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
+    ).action(async (course, opts) => {
       try {
         const session = await requireSession();
         const data = createHttpProvider(session.apiUrl, session.token);
@@ -4108,12 +4336,20 @@ var init_select = __esm({
           enrollmentId
         };
         const onboarding = await getCourseOnboardingStatus(activeCourseForStatus);
+        const rootAgents = await resolveRootAgentsConsent({
+          cwd: process.cwd(),
+          flag: opts.rootAgents,
+          interactive: isInteractiveTerminal(opts.json)
+        });
         let pipelineResult = null;
         try {
           pipelineResult = await resolveAndGenerate(
             { courseId: detail.courseId, enrollmentId },
             { forceRefresh: false, collectT1Interactive: false, collectT2Interactive: false },
-            { cwd: process.cwd(), deps: buildPipelineDeps() }
+            {
+              cwd: process.cwd(),
+              deps: buildPipelineDeps({ rootAgentsConsent: rootAgents.consent })
+            }
           );
         } catch (err) {
           logger8.warn("Failed to run instruction pipeline", {
@@ -4131,6 +4367,7 @@ var init_select = __esm({
               workspacePath: onboarding.workspacePath,
               workspaceSource: onboarding.workspaceSource,
               wroteFiles: pipelineResult?.wroteFiles ?? [],
+              rootAgentsSkipped: rootAgents.asked && !rootAgents.consent,
               markerPath: pipelineResult?.markerPath ?? null,
               usedT0: pipelineResult?.usedT0 ?? false,
               usedT1: pipelineResult?.usedT1 ?? false,
@@ -4167,6 +4404,9 @@ var init_select = __esm({
           if (pipelineResult && !pipelineResult.usedT1) {
             lines.push("  (sem brief base \u2014 rode `tostudy init` para configurar)");
           }
+          if (rootAgents.asked && !rootAgents.consent) {
+            lines.push(rootAgentsSkippedHint());
+          }
           lines.push("", "\u2192 Abra sua plataforma (claude, codex, cursor...)");
           const hints = courseSlug2 ? detectedSlashHints(courseSlug2, home, cwd) : [];
           if (hints.length > 0) {
@@ -19926,7 +20166,7 @@ var init_menu = __esm({
 });
 
 // src/onboarding/learner-context.ts
-import readline2 from "node:readline/promises";
+import readline3 from "node:readline/promises";
 import { stdin as input, stdout as output2 } from "node:process";
 async function askNonEmpty2(question, deps, defaultValue) {
   while (true) {
@@ -19944,7 +20184,7 @@ async function askChoice(question, choices, deps, defaultChoice) {
   }
 }
 function createPromptDeps() {
-  const rl = readline2.createInterface({ input, output: output2 });
+  const rl = readline3.createInterface({ input, output: output2 });
   return {
     ask: (question) => rl.question(question),
     write: (content) => output2.write(content),
@@ -20167,10 +20407,18 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
   });
   await deps.saveCourseLearnerProfile(activeCourse, learnerProfile, artifacts);
   try {
+    const rootAgents = await resolveRootAgentsConsent({
+      cwd: process.cwd(),
+      flag: flags.rootAgents,
+      interactive: isInteractiveTerminal(flags.json)
+    });
     const pipelineResult = await deps.resolveAndGenerate(
       { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
       { forceRefresh: false, collectT1Interactive: true, collectT2Interactive: false },
-      { cwd: process.cwd(), deps: deps.buildPipelineDeps() }
+      {
+        cwd: process.cwd(),
+        deps: deps.buildPipelineDeps({ rootAgentsConsent: rootAgents.consent })
+      }
     );
     deps.logger.info("Instruction files regenerated via pipeline", {
       wroteFiles: pipelineResult.wroteFiles,
@@ -20211,6 +20459,7 @@ var init_init = __esm({
     init_learner_context();
     init_api3();
     init_instruction_pipeline();
+    init_root_agents_consent();
     init_pipeline_deps();
     logger17 = createLogger("cli:init");
     defaultDeps4 = {
@@ -20231,7 +20480,10 @@ var init_init = __esm({
       resolveAndGenerate,
       buildPipelineDeps
     };
-    initCommand = new Command16("init").description("Generate tutor instructions and learner brief for the active course").option("--segment <segment>", "Learner segment/niche").option("--company <company>", "Company or business type").option("--products <products>", "Main products or services").option("--region <region>", "Operating region").option("--team <team>", "Team involved").option("--goal <goal>", "Primary learning goal").option("--level <level>", "Learner level: beginner, intermediate, advanced").option("--adapt-context", "Adapt examples to learner's real context").option("--json", "Output structured JSON").action(async (opts) => {
+    initCommand = new Command16("init").description("Generate tutor instructions and learner brief for the active course").option("--segment <segment>", "Learner segment/niche").option("--company <company>", "Company or business type").option("--products <products>", "Main products or services").option("--region <region>", "Operating region").option("--team <team>", "Team involved").option("--goal <goal>", "Primary learning goal").option("--level <level>", "Learner level: beginner, intermediate, advanced").option("--adapt-context", "Adapt examples to learner's real context").option(
+      "--root-agents",
+      "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
+    ).option("--json", "Output structured JSON").action(async (opts) => {
       await runInit(defaultDeps4, opts);
     });
   }
@@ -21233,20 +21485,38 @@ var init_sync = __esm({
     init_guards();
     init_formatter();
     init_instruction_pipeline();
+    init_root_agents_consent();
     init_pipeline_deps();
     logger22 = createLogger("cli:sync");
     syncCommand = new Command22("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
       "--all-runtimes",
       "Write instruction files for every supported runtime, even undetected ones"
+    ).option(
+      "--root-agents",
+      "Add the ToStudy block to an existing AGENTS.md in this folder without asking"
     ).action(async (opts) => {
       try {
         await requireSession();
         const activeCourse = await requireActiveCourse();
+        const rootAgents = await resolveRootAgentsConsent({
+          cwd: process.cwd(),
+          flag: opts.rootAgents,
+          interactive: isInteractiveTerminal(opts.json)
+        });
         const pipelineResult = await resolveAndGenerate(
           { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
           { forceRefresh: true, collectT1Interactive: false, collectT2Interactive: false },
-          { cwd: process.cwd(), deps: buildPipelineDeps({ allRuntimes: opts.allRuntimes }) }
+          {
+            cwd: process.cwd(),
+            deps: buildPipelineDeps({
+              allRuntimes: opts.allRuntimes,
+              rootAgentsConsent: rootAgents.consent
+            })
+          }
         );
+        if (rootAgents.asked && !rootAgents.consent && !opts.json) {
+          output(rootAgentsSkippedHint(), { json: false });
+        }
         if (opts.json) {
           output(
             {
@@ -22238,7 +22508,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.
@@ -22425,7 +22698,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),
@@ -22605,7 +22881,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),
@@ -22790,6 +23069,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));