@tostudy-ai/cli 0.16.5 → 0.16.7

package/dist/cli.js

@@ -1366,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",
@@ -1374,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;
     }
@@ -2218,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";
@@ -2256,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 = [
@@ -2434,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;
@@ -2457,6 +2468,7 @@ ${content}`;
 var instruction_files_exports = {};
 __export(instruction_files_exports, {
   installUniversalCommand: () => installUniversalCommand,
+  needsRootAgentsConsent: () => needsRootAgentsConsent,
   slugify: () => slugify,
   upsertRootAgentsBlock: () => upsertRootAgentsBlock,
   writeInstructionFiles: () => writeInstructionFiles
@@ -2466,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;
@@ -3370,7 +3383,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.16.5" : "0.7.1";
+    CLI_VERSION = true ? "0.16.7" : "0.7.1";
   }
 });
 
@@ -3840,11 +3853,11 @@ import { stdin as processStdin, stdout as processStdout } from "node:process";
 function composeBriefFromAnswers(answers) {
   const levelLabel = {
     beginner: "iniciante",
-    intermediate: "intermediario",
-    advanced: "avancado"
+    intermediate: "intermedi\xE1rio",
+    advanced: "avan\xE7ado"
   }[answers.yourLevel];
   const paragraphOne = [answers.whoYouAre, answers.whereYouWork, answers.whatYouDo].map((s) => s.trim()).filter(Boolean).join(". ");
-  const paragraphTwo = `Meu nivel neste assunto e ${levelLabel}. ${answers.yourGoals.trim()}`;
+  const paragraphTwo = `Meu n\xEDvel neste assunto \xE9 ${levelLabel}. ${answers.yourGoals.trim()}`;
   const paragraphThree = `Contexto real do meu dia a dia: ${answers.realContext.trim()}`;
   const text = [paragraphOne, paragraphTwo, paragraphThree].map((p) => p.replace(/\.\.+/g, ".")).join("\n\n");
   return text.slice(0, 5e3);
@@ -3857,7 +3870,7 @@ async function askNonEmpty(question, deps) {
 }
 async function askLevel(deps) {
   while (true) {
-    const raw = (await deps.ask("  Seu nivel geral neste assunto (beginner/intermediate/advanced): ")).trim().toLowerCase();
+    const raw = (await deps.ask("  Seu n\xEDvel geral neste assunto (beginner/intermediate/advanced): ")).trim().toLowerCase();
     if (raw === "beginner" || raw === "intermediate" || raw === "advanced") {
       return raw;
     }
@@ -3867,15 +3880,15 @@ async function collectBootstrapAnswersWithDeps(input2, deps) {
   deps.write(
     [
       "",
-      `Ola ${input2.userName}, vamos criar seu brief base (1-2 minutos).`,
-      "Ele ajuda o tutor a te conhecer para adaptar o ensino a voce.",
-      "Voce pode editar depois em https://tostudy.ai/student/settings/learner-brief.",
+      `Ol\xE1 ${input2.userName}, vamos criar seu brief base (1-2 minutos).`,
+      "Ele ajuda o tutor a te conhecer para adaptar o ensino a voc\xEA.",
+      "Voc\xEA pode editar depois em https://tostudy.ai/student/settings/learner-brief.",
       ""
     ].join("\n")
   );
-  const whoYouAre = await askNonEmpty("  Quem voce e (profissao/cargo/area): ", deps);
+  const whoYouAre = await askNonEmpty("  Quem voc\xEA \xE9 (profiss\xE3o/cargo/\xE1rea): ", deps);
   const whereYouWork = await askNonEmpty("  Onde trabalha (empresa/setor): ", deps);
-  const whatYouDo = await askNonEmpty("  O que voce faz (responsabilidades/projetos): ", deps);
+  const whatYouDo = await askNonEmpty("  O que voc\xEA faz (responsabilidades/projetos): ", deps);
   const yourLevel = await askLevel(deps);
   const yourGoals = await askNonEmpty("  Seu objetivo de aprendizado: ", deps);
   const realContext = await askNonEmpty(
@@ -4204,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 = {}) {
@@ -4227,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";
@@ -4246,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);
@@ -4282,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", {
@@ -4305,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,
@@ -4341,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) {
@@ -20100,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) {
@@ -20118,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),
@@ -20341,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,
@@ -20385,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 = {
@@ -20405,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);
     });
   }
@@ -21407,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(
             {
@@ -21490,7 +21586,7 @@ var init_brief = __esm({
         }
         if (!remote) {
           const lines2 = [
-            "Voce ainda nao tem um brief base preenchido.",
+            "Voc\xEA ainda n\xE3o tem um brief base preenchido.",
             "Para criar: `tostudy brief-create` (terminal) ou `tostudy brief-open` (portal web)."
           ];
           output(lines2.join("\n"), { json: false });
@@ -21498,7 +21594,7 @@ var init_brief = __esm({
         }
         const lines = [`Brief base (atualizado em ${remote.updatedAt}):`, "", remote.text, ""];
         if (cached2 && cached2.brief && cached2.brief.updatedAt !== remote.updatedAt) {
-          lines.push("Aviso: cache local esta desatualizado. Rode `tostudy sync` para atualizar.");
+          lines.push("Aviso: cache local est\xE1 desatualizado. Rode `tostudy sync` para atualizar.");
         }
         output(lines.join("\n"), { json: false });
       } catch (err) {
@@ -22976,10 +23072,12 @@ if (!process.env.LOG_LEVEL) {
 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");
+  const localeFlagIdx = process.argv.indexOf("--locale");
+  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");
   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}.
+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}.