@tostudy-ai/cli 0.17.0 → 0.17.2

package/dist/cli.js

@@ -1668,7 +1668,7 @@ function formatLesson(data) {
   if (lesson.exerciseContent) {
     lines.push("", "\u2500\u2500\u2500 Exerc\xEDcio \u2500\u2500\u2500", lesson.exerciseContent);
   }
-  if (/^checkpoint/i.test(lesson.title.trim())) {
+  if (lesson.type === "checkpoint" || /^checkpoint/i.test(lesson.title.trim())) {
     lines.push(
       "",
       "\u{1F4A1} Escreva suas respostas num arquivo (ex: checkpoint.md) e valide:",
@@ -1758,11 +1758,20 @@ function formatModuleStart(data) {
   if (firstLesson.acceptanceCriteria) {
     lines.push("", "Crit\xE9rios de aceita\xE7\xE3o:", firstLesson.acceptanceCriteria);
   }
-  lines.push(
-    "",
-    "\u2192 tostudy validate <resposta>  para validar sua solu\xE7\xE3o",
-    "\u2192 tostudy hint                 para obter uma dica"
-  );
+  if (firstLesson.type === "checkpoint" || /^checkpoint/i.test(firstLesson.title.trim())) {
+    lines.push(
+      "",
+      "\u{1F4A1} Escreva suas respostas num arquivo (ex: checkpoint.md) e valide:",
+      "   tostudy validate checkpoint.md",
+      "\u2192 tostudy hint                 para obter uma dica"
+    );
+  } else {
+    lines.push(
+      "",
+      "\u2192 tostudy validate <resposta>  para validar sua solu\xE7\xE3o",
+      "\u2192 tostudy hint                 para obter uma dica"
+    );
+  }
   return lines.join("\n");
 }
 function formatMoreTheory(data) {
@@ -1917,6 +1926,13 @@ var init_ide_detector = __esm({
 });
 
 // src/output/instruction-template-v3.ts
+var instruction_template_v3_exports = {};
+__export(instruction_template_v3_exports, {
+  COURSE_TEMPLATE_VERSION: () => COURSE_TEMPLATE_VERSION,
+  UNIVERSAL_TEMPLATE_VERSION: () => UNIVERSAL_TEMPLATE_VERSION,
+  renderCourseInstruction: () => renderCourseInstruction,
+  renderUniversalInstruction: () => renderUniversalInstruction
+});
 function renderCourseInstruction(input2) {
   const sections = [];
   sections.push(renderTitle(input2));
@@ -1990,7 +2006,7 @@ Quando \`tostudy next --json\` retornar \`MODULE_COMPLETE\`:
 Isso garante continuidade entre sess\xF5es e evita estouro de contexto em sess\xF5es longas.`);
   sections.push(renderHandlingSituations());
   sections.push(renderTechnicalReference());
-  sections.push(`<!-- tostudy-template-version: 5 -->`);
+  sections.push(`<!-- tostudy-template-version: ${UNIVERSAL_TEMPLATE_VERSION} -->`);
   return sections.join("\n\n") + "\n";
 }
 function renderTitle(input2) {
@@ -2235,12 +2251,14 @@ function renderTechnicalReference() {
 }
 function renderFooter(course) {
   return `<!-- tostudy-course-id: ${course.courseId} -->
-<!-- tostudy-template-version: 4 -->`;
+<!-- tostudy-template-version: ${COURSE_TEMPLATE_VERSION} -->`;
 }
-var TONE_LABELS, LEVEL_LABELS;
+var COURSE_TEMPLATE_VERSION, UNIVERSAL_TEMPLATE_VERSION, TONE_LABELS, LEVEL_LABELS;
 var init_instruction_template_v3 = __esm({
   "src/output/instruction-template-v3.ts"() {
     "use strict";
+    COURSE_TEMPLATE_VERSION = 4;
+    UNIVERSAL_TEMPLATE_VERSION = 5;
     TONE_LABELS = {
       formal: "formal",
       casual: "casual",
@@ -2972,6 +2990,24 @@ async function writeWorkspaceMarker(workspacePath, input2, options = {}) {
   }
   const existing = await readWorkspaceMarker(workspacePath);
   const now = (/* @__PURE__ */ new Date()).toISOString();
+  let carried = {};
+  if (existing && existing.courseId === input2.courseId) {
+    try {
+      const raw = JSON.parse(readFileSync2(filePath, "utf-8"));
+      for (const key of [
+        "currentLessonId",
+        "currentModuleId",
+        "courseTags",
+        "courseLevel",
+        "lastInitCourseId",
+        "templateVersion"
+      ]) {
+        if (raw[key] !== void 0) carried[key] = raw[key];
+      }
+    } catch {
+      carried = {};
+    }
+  }
   const marker = {
     version: CURRENT_VERSION,
     courseId: input2.courseId,
@@ -2981,7 +3017,7 @@ async function writeWorkspaceMarker(workspacePath, input2, options = {}) {
     createdAt: existing?.createdAt ?? now,
     updatedAt: now
   };
-  writeFileSync3(filePath, JSON.stringify(marker, null, 2), { mode: 384 });
+  writeFileSync3(filePath, JSON.stringify({ ...carried, ...marker }, null, 2), { mode: 384 });
   return filePath;
 }
 var CURRENT_VERSION, SUPPORTED_VERSIONS;
@@ -3026,6 +3062,7 @@ async function readWorkspaceState(workspacePath) {
       state.courseLevel = raw.courseLevel;
     }
     if (typeof raw.lastInitCourseId === "string") state.lastInitCourseId = raw.lastInitCourseId;
+    if (typeof raw.templateVersion === "number") state.templateVersion = raw.templateVersion;
     return state;
   } catch {
     return null;
@@ -3079,16 +3116,31 @@ async function setLastInitCourseId(courseId, _configDir) {
 }
 async function checkCourseDrift() {
   const { findWorkspaceState: findWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_exports));
+  const { COURSE_TEMPLATE_VERSION: COURSE_TEMPLATE_VERSION2 } = await Promise.resolve().then(() => (init_instruction_template_v3(), instruction_template_v3_exports));
   const result = await findWorkspaceState2();
   if (!result) return null;
   const state = result.state;
-  if (!state.lastInitCourseId) return null;
-  if (state.lastInitCourseId === state.courseId) return null;
-  return [
-    `\u26A0\uFE0F Curso ativo mudou para "${state.courseTitle}".`,
-    `   Rode \`tostudy init\` para atualizar o contexto do assistente.`,
-    ""
-  ].join("\n");
+  const warnings = [];
+  if (state.lastInitCourseId && state.lastInitCourseId !== state.courseId) {
+    warnings.push(
+      [
+        `\u26A0\uFE0F Curso ativo mudou para "${state.courseTitle}".`,
+        `   Rode \`tostudy init\` para atualizar o contexto do assistente.`,
+        ""
+      ].join("\n")
+    );
+  }
+  if ((state.templateVersion ?? 0) < COURSE_TEMPLATE_VERSION2) {
+    const from = state.templateVersion ? `v${state.templateVersion}` : "vers\xE3o antiga";
+    warnings.push(
+      [
+        `\u26A0\uFE0F As instru\xE7\xF5es do tutor neste workspace est\xE3o desatualizadas (${from} < v${COURSE_TEMPLATE_VERSION2}).`,
+        `   Rode \`tostudy sync\` para atualizar as regras do tutor.`,
+        ""
+      ].join("\n")
+    );
+  }
+  return warnings.length > 0 ? warnings.join("\n") : null;
 }
 var init_course_drift = __esm({
   "src/onboarding/course-drift.ts"() {
@@ -3479,7 +3531,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.17.0" : "0.7.1";
+    CLI_VERSION = true ? "0.17.2" : "0.7.1";
   }
 });
 
@@ -4195,13 +4247,18 @@ async function resolveAndGenerate(input2, options = {}, context) {
   } catch (err) {
     logger6.warn("Failed to write workspace marker", { err });
   }
+  let workspaceStateRecorded = false;
   if (markerPath) {
     try {
       await updateWorkspaceState(context.cwd, {
         courseTags: courseMeta.courseTags,
         courseLevel: courseMeta.courseLevel,
-        lastInitCourseId: input2.courseId
+        lastInitCourseId: input2.courseId,
+        // GH #1534: record which template generated the instruction files so
+        // checkCourseDrift() can flag stale workspaces after a template bump.
+        templateVersion: COURSE_TEMPLATE_VERSION
       });
+      workspaceStateRecorded = true;
     } catch (err) {
       logger6.warn("Failed to update workspace state v2 fields", {
         error: err instanceof Error ? err.message : String(err)
@@ -4215,7 +4272,8 @@ async function resolveAndGenerate(input2, options = {}, context) {
     usedT1: studentBrief !== null,
     usedT2: enrollmentProfile !== null,
     bootstrapped,
-    renderedInstruction: content
+    renderedInstruction: content,
+    workspaceStateRecorded
   };
 }
 var logger6, defaultDeps2;
@@ -4873,12 +4931,15 @@ function adjustTimeEstimate(type, baseMinutes) {
   if (type === "exercise") return Math.max(baseMinutes, 30);
   return baseMinutes;
 }
-function isCheckpoint(title) {
-  return /^checkpoint/i.test(title.trim());
+function isCheckpoint(type, title) {
+  return type === "checkpoint" || /^checkpoint/i.test(title.trim());
+}
+function isPracticalType(type) {
+  return type === "exercise" || type === "checkpoint" || type === "realworld" || type === "project";
 }
 function formatLessonContent(data, workspacePath, courseTitle) {
   const time3 = adjustTimeEstimate(data.type, data.estimatedTimeMinutes);
-  const isPractical = data.type === "exercise" || isCheckpoint(data.title);
+  const isPractical = isPracticalType(data.type) || isCheckpoint(data.type, data.title);
   const lines = [`\u2501\u2501\u2501 Li\xE7\xE3o: ${data.title} \u2501\u2501\u2501`];
   if (isPractical && workspacePath) {
     const base = path13.basename(workspacePath) === ".tostudy" ? path13.dirname(workspacePath) : workspacePath;
@@ -4899,7 +4960,7 @@ function formatLessonContent(data, workspacePath, courseTitle) {
   if (data.hints && data.hints.length > 0) {
     lines.push("", `Dicas dispon\xEDveis: ${data.hints.length}`);
   }
-  if (isCheckpoint(data.title)) {
+  if (isCheckpoint(data.type, data.title)) {
     lines.push(
       "",
       "\u{1F4A1} Escreva suas respostas num arquivo (ex: checkpoint.md) e valide:",
@@ -4975,7 +5036,7 @@ var init_lesson = __esm({
             { json: false }
           );
         }
-        if (content.type === "exercise" && !ws.found) {
+        if (isPracticalType(content.type) && !ws.found) {
           process.stderr.write(
             "\n\u{1F4A1} Dica: rode `tostudy select` desta pasta para us\xE1-la como workspace, ou `tostudy workspace setup` para criar em ~/study/.\n"
           );
@@ -21609,6 +21670,7 @@ var init_sync = __esm({
     init_guards();
     init_formatter();
     init_instruction_pipeline();
+    init_workspace_state();
     init_root_agents_consent();
     init_pipeline_deps();
     logger22 = createLogger("cli:sync");
@@ -21622,8 +21684,10 @@ var init_sync = __esm({
       try {
         await requireSession();
         const activeCourse = await requireActiveCourse();
+        const found = await findWorkspaceState();
+        const workspaceCwd = found?.workspacePath ?? process.cwd();
         const rootAgents = await resolveRootAgentsConsent({
-          cwd: process.cwd(),
+          cwd: workspaceCwd,
           flag: opts.rootAgents,
           interactive: isInteractiveTerminal(opts.json)
         });
@@ -21631,7 +21695,7 @@ var init_sync = __esm({
           { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
           { forceRefresh: true, collectT1Interactive: false, collectT2Interactive: false },
           {
-            cwd: process.cwd(),
+            cwd: workspaceCwd,
             deps: buildPipelineDeps({
               allRuntimes: opts.allRuntimes,
               rootAgentsConsent: rootAgents.consent
@@ -21651,21 +21715,25 @@ var init_sync = __esm({
               markerPath: pipelineResult.markerPath,
               usedT0: pipelineResult.usedT0,
               usedT1: pipelineResult.usedT1,
-              usedT2: pipelineResult.usedT2
+              usedT2: pipelineResult.usedT2,
+              workspaceStateRecorded: pipelineResult.workspaceStateRecorded
             },
             { json: true }
           );
         } else {
-          output(
-            [
-              `\u2713 Instru\xE7\xF5es sincronizadas para "${activeCourse.courseTitle}"`,
-              `  - T0 (persona): ${pipelineResult.usedT0 ? "presente" : "ausente"}`,
-              `  - T1 (brief base): ${pipelineResult.usedT1 ? "presente" : "ausente"}`,
-              `  - T2 (curso): ${pipelineResult.usedT2 ? "presente" : "ausente"}`,
-              `  - Arquivos: ${pipelineResult.wroteFiles.join(", ")}`
-            ].join("\n"),
-            { json: false }
-          );
+          const lines = [
+            `\u2713 Instru\xE7\xF5es sincronizadas para "${activeCourse.courseTitle}"`,
+            `  - T0 (persona): ${pipelineResult.usedT0 ? "presente" : "ausente"}`,
+            `  - T1 (brief base): ${pipelineResult.usedT1 ? "presente" : "ausente"}`,
+            `  - T2 (curso): ${pipelineResult.usedT2 ? "presente" : "ausente"}`,
+            `  - Arquivos: ${pipelineResult.wroteFiles.join(", ")}`
+          ];
+          if (!pipelineResult.workspaceStateRecorded) {
+            lines.push(
+              `\u26A0 N\xE3o consegui gravar .tostudy/workspace.json \u2014 o aviso de template pode continuar aparecendo. Verifique as permiss\xF5es do diret\xF3rio do workspace.`
+            );
+          }
+          output(lines.join("\n"), { json: false });
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -21920,6 +21988,7 @@ var init_context = __esm({
     init_dist();
     init_workspace_state();
     init_storage();
+    init_course_state();
     init_formatter();
     init_errors();
     logger27 = createLogger("cli:context");
@@ -21930,6 +21999,8 @@ var init_context = __esm({
           if (opts.json) jsonError("no_workspace");
           error(getErrors().noActiveCourse.trimEnd());
         }
+        const driftWarning = await checkCourseDrift();
+        if (driftWarning && !opts.json) process.stderr.write(driftWarning + "\n");
         const sessionCtx = await loadSessionContext(ws.workspacePath);
         const result = {
           workspace: {
@@ -21948,7 +22019,8 @@ var init_context = __esm({
             summary: s.summary,
             savedAt: s.savedAt
           })),
-          totalModulesCompleted: sessionCtx.moduleSummaries.length
+          totalModulesCompleted: sessionCtx.moduleSummaries.length,
+          driftWarning: driftWarning ?? null
         };
         logger27.debug("Context loaded", {
           courseId: ws.state.courseId,