@tostudy-ai/cli 0.16.5 → 0.16.6

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.6" : "0.7.1";
   }
 });
 
@@ -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(
             {