@tostudy-ai/cli 0.16.12 → 0.17.1

package/dist/cli.js

@@ -281,7 +281,7 @@ var require_picocolors = __commonJS({
   }
 });
 
-// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DkbC4pBB.mjs
+// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-Bznav79x.mjs
 function formatJson(entry) {
   const { timestamp, level, message, service, environment, context, data, error: error49 } = entry;
   const output3 = {
@@ -385,8 +385,8 @@ function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new W
   return info;
 }
 var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, BaseLogger;
-var init_logger_base_DkbC4pBB = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DkbC4pBB.mjs"() {
+var init_logger_base_Bznav79x = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-Bznav79x.mjs"() {
     init_sanitize_DSkXy3jL();
     import_picocolors = __toESM(require_picocolors(), 1);
     LOG_LEVELS = {
@@ -708,7 +708,7 @@ function createLogger(module, options) {
 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_DkbC4pBB();
+    init_logger_base_Bznav79x();
     init_sanitize_DSkXy3jL();
     asyncLocalStorage = new AsyncLocalStorage();
     ConsoleTransport = class {
@@ -1917,6 +1917,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));
@@ -1926,7 +1933,11 @@ function renderCourseInstruction(input2) {
   sections.push(renderHowToAdapt(input2.enrollmentProfile));
   sections.push(renderPrecedence());
   sections.push(renderWhereStudentIs(input2.progress));
+  sections.push(renderMemoryLoad());
   sections.push(renderHowToConduct());
+  sections.push(renderStudentAuthorship());
+  sections.push(renderConceptBeforeApplication());
+  sections.push(renderTrainingCaseFraming());
   sections.push(renderSilentTools());
   sections.push(renderHandlingSituations());
   sections.push(renderTechnicalReference());
@@ -1967,6 +1978,9 @@ Rode \`tostudy context --json\` em sil\xEAncio para descobrir o estado do aluno.
 3. Se houver summaries, mencione brevemente: "Da \xFAltima vez paramos em {ultimoModulo}. Pronto pra continuar?"
 4. Siga "Como Conduzir a Aula" abaixo.`);
   sections.push(renderHowToConduct());
+  sections.push(renderStudentAuthorship());
+  sections.push(renderConceptBeforeApplication());
+  sections.push(renderTrainingCaseFraming());
   sections.push(renderSilentTools());
   sections.push(`## Compacta\xE7\xE3o de Contexto (Autom\xE1tico)
 
@@ -1983,7 +1997,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: 4 -->`);
+  sections.push(`<!-- tostudy-template-version: ${UNIVERSAL_TEMPLATE_VERSION} -->`);
   return sections.join("\n\n") + "\n";
 }
 function renderTitle(input2) {
@@ -2042,7 +2056,7 @@ function renderWhoIsStudent(brief, profile) {
   if (brief && brief.text.trim().length > 0) {
     parts.push(brief.text);
     parts.push(
-      "_(Este \xE9 o brief que o aluno escreveu sobre si mesmo. Use como contexto principal \u2014 nomes, empresa, projetos reais, motiva\xE7\xF5es. Tudo que voc\xEA disser deve parecer que voc\xEA leu e entendeu quem ele \xE9.)_"
+      '_(Este \xE9 o brief que o aluno escreveu sobre si mesmo. Use como contexto principal \u2014 nomes, empresa, projetos reais, motiva\xE7\xF5es. Tudo que voc\xEA disser deve parecer que voc\xEA leu e entendeu quem ele \xE9. O brief descreve quem ele \xE9 profissionalmente \u2014 N\xC3O o n\xEDvel dele neste curso: "avan\xE7ado" em outra \xE1rea n\xE3o vale como avan\xE7ado aqui.)_'
     );
   } else {
     parts.push(
@@ -2075,7 +2089,7 @@ function renderHowToAdapt(profile) {
   if (!profile) {
     return `### Como Adaptar
 
-Sem informa\xE7\xE3o de n\xEDvel espec\xEDfico deste curso \u2014 comece explicativo mas breve; calibre pelas primeiras respostas do aluno. Na d\xFAvida, prefira "porqu\xEA antes do como".`;
+Sem informa\xE7\xE3o de n\xEDvel espec\xEDfico deste curso \u2014 o brief base N\xC3O vale como n\xEDvel neste assunto. Comece explicativo mas breve; calibre pelo que o aluno demonstrar aqui. Na d\xFAvida, prefira "porqu\xEA antes do como".`;
   }
   if (profile.learnerLevel === "beginner") {
     return `### Como Adaptar
@@ -2115,6 +2129,9 @@ Voc\xEA tem DUAS fontes que te orientam, e elas resolvem conflitos assim:
 | ----------------------------- | ----------------------------- | ---------------------------------------------- |
 | Sua **persona** (acima)       | voz, tom, nome, express\xF5es    | usar catchphrase do creator ao cumprimentar    |
 | **Contexto do aluno** (acima) | profundidade, ritmo, exemplos | "vou come\xE7ar pelo porqu\xEA" (iniciante)          |
+| **Brief base (T1)**           | quem ele \xE9 (nomes, projetos)  | exemplos com o contexto real dele              |
+
+O brief base NUNCA define o n\xEDvel neste curso \u2014 o n\xEDvel vem do campo "Neste Curso" e do que o aluno demonstra nas respostas aqui.
 
 **Se conflitam, ambos valem ao mesmo tempo.** Voc\xEA mant\xE9m sua voz E adapta a profundidade. Exemplo: persona \`technical\` + aluno \`beginner\` \u2014 voc\xEA explica conceitos t\xE9cnicos de forma precisa MAS sempre come\xE7a pelo "porqu\xEA" antes do "como", e traduz jarg\xE3o na primeira vez que usa.`;
 }
@@ -2153,6 +2170,33 @@ Quando o aluno passou na li\xE7\xE3o:
 - Pergunte se ele quer seguir ou pausar.
 - Ao seguir \u2014 \`tostudy next\` (sil\xEAncio) \u2014 apresente a pr\xF3xima.`;
 }
+function renderMemoryLoad() {
+  return `## Mem\xF3ria do Aluno
+
+No in\xEDcio de cada sess\xE3o, rode \`tostudy memory --json\` em sil\xEAncio. Use as dificuldades conhecidas e os pontos fortes para calibrar ritmo e exemplos \u2014 reforce onde ele travou, n\xE3o repita o que ele j\xE1 domina. NUNCA mostre esse bloco cru ao aluno.`;
+}
+function renderStudentAuthorship() {
+  return `## Autoria do Aluno (OBRIGAT\xD3RIO)
+
+Em li\xE7\xF5es de **exerc\xEDcio, quiz ou checkpoint**, a resposta \xE9 do ALUNO \u2014 nunca sua.
+
+1. **Nunca redija a resposta sozinho.** Antes de escrever qualquer arquivo de resposta, pergunte ao aluno as decis\xF5es que o exerc\xEDcio pede (par\xE2metros, valores, escolhas \u2014 "qual dura\xE7\xE3o voc\xEA quer no gancho?", "qual curva voc\xEA escolhe para a aterrissagem?"). Rascunhe A PARTIR das respostas dele, com ele.
+2. **S\xF3 rode \`tostudy validate\` depois que o aluno revisar e confirmar a resposta como dele.** "Sim", "pr\xF3xima" ou "monte o arquivo" N\xC3O \xE9 resposta \u2014 \xE9 a deixa para voc\xEA perguntar a primeira decis\xE3o.
+3. **S\xF3 rode \`tostudy next\` quando o aluno pedir para avan\xE7ar com as pr\xF3prias palavras.** Nunca encadeie validate \u2192 next sem uma fala do aluno entre os dois.
+4. Isso vale em QUALQUER abordagem de ensino, incluindo explora\xE7\xE3o com IA: voc\xEA demonstra ferramentas e executa passos JUNTO com o aluno, mas exerc\xEDcios e checkpoints medem o que ELE decide. Sem as decis\xF5es dele, n\xE3o h\xE1 o que validar.`;
+}
+function renderConceptBeforeApplication() {
+  return `## Conceito Antes da Aplica\xE7\xE3o (OBRIGAT\xD3RIO)
+
+1. **N\xE3o cobre a aplica\xE7\xE3o de um termo que o aluno ainda n\xE3o explicou.** Antes de pedir uma decis\xE3o t\xE9cnica sobre um conceito novo, pe\xE7a que ele o descreva com as pr\xF3prias palavras. Se ele n\xE3o souber, ensine \u2014 analogia + exemplo \u2014 e s\xF3 ent\xE3o volte ao exerc\xEDcio.
+2. **"N\xE3o entendi" trava a aplica\xE7\xE3o.** Se o aluno pedir mais did\xE1tica ou disser que n\xE3o entendeu, explique por outro \xE2ngulo ou rode \`tostudy theory\` (em sil\xEAncio) e traduza. NUNCA repita a mesma pergunta de aplica\xE7\xE3o sem ensinar algo novo antes.
+3. **Dificuldade registrada = ritmo did\xE1tico.** Se a mem\xF3ria (\`tostudy memory\`) mostra dificuldades ou o aluno pediu ritmo mais did\xE1tico, priorize cheques de conceito antes de cada exerc\xEDcio \u2014 mesmo que o brief base diga "avan\xE7ado". O n\xEDvel dele NESTE curso \xE9 o que ele demonstra aqui.`;
+}
+function renderTrainingCaseFraming() {
+  return `## Enquadramento de Caso de Treino (OBRIGAT\xD3RIO)
+
+1. **SEMPRE identifique personas ou datasets fict\xEDcios de aulas realworld como cen\xE1rios de treino.** Fa\xE7a isso ANTES de apresentar a persona, os dados ou qualquer resultado derivado deles. **NUNCA apresente a sa\xEDda de um caso de treino como resultado do pr\xF3prio neg\xF3cio do aluno.** Esta regra se aplica a TODOS os tipos de aula \u2014 incluindo realworld, checkpoint, intro, conceito e exerc\xEDcio.`;
+}
 function renderSilentTools() {
   return `## Ferramentas Silenciosas
 
@@ -2164,6 +2208,8 @@ Estes comandos s\xE3o suas ferramentas. Rode em sil\xEAncio (sem anunciar), use
 - \`tostudy next --json\` \u2014 avan\xE7a para a pr\xF3xima li\xE7\xE3o.
 - \`tostudy hint --json\` \u2014 dica progressiva (3 n\xEDveis).
 - \`tostudy validate <arquivo>\` \u2014 valida exerc\xEDcio (exit 0 = passou, 1 = falhou).
+- \`tostudy theory --json\` \u2014 micro-aula extra na li\xE7\xE3o atual (aceita \`--focus "<tema>"\`). Use quando o aluno disser "n\xE3o entendi" ou pedir mais did\xE1tica.
+- \`tostudy level --json\` \u2014 v\xEA/ajusta o n\xEDvel de scaffolding dos exerc\xEDcios (os n\xEDveis DISPON\xCDVEIS v\xEAm no \`--json\`; ofere\xE7a s\xF3 esses). Use quando o exerc\xEDcio est\xE1 acima ou abaixo do ponto do aluno.
 
 - \`tostudy insight <tipo> "<descri\xE7\xE3o>" --json\` \u2014 registra na mem\xF3ria do curso um sinal cognitivo do aluno. Tipos: \`difficulty\` (travou ou confundiu um conceito), \`breakthrough\` (teve um clique, dominou algo), \`question\` (d\xFAvida recorrente).
 
@@ -2177,6 +2223,7 @@ function renderHandlingSituations() {
 | Situa\xE7\xE3o                              | O que fazer                                                |
 | ------------------------------------- | ---------------------------------------------------------- |
 | \`tostudy validate\` falhou           | Mostrar feedback, sugerir \`tostudy hint\`, tentar de novo |
+| Aluno diz "n\xE3o entendi" / quer did\xE1tica | Explicar por outro \xE2ngulo, \`tostudy theory\` (em sil\xEAncio); n\xE3o repetir a pergunta de aplica\xE7\xE3o |
 | "Nenhuma li\xE7\xE3o ativa"                 | Rodar \`tostudy start\` para carregar m\xF3dulo               |
 | Comando retorna erro                  | Verificar \`tostudy doctor\` para diagn\xF3stico              |
 | Aluno perdido / sem saber o que fazer | Rodar \`tostudy progress\` e resumir estado atual          |
@@ -2195,12 +2242,14 @@ function renderTechnicalReference() {
 }
 function renderFooter(course) {
   return `<!-- tostudy-course-id: ${course.courseId} -->
-<!-- tostudy-template-version: 3 -->`;
+<!-- 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",
@@ -2932,6 +2981,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,
@@ -2941,7 +3008,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;
@@ -2986,6 +3053,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;
@@ -3039,16 +3107,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"() {
@@ -3439,7 +3522,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.16.12" : "0.7.1";
+    CLI_VERSION = true ? "0.17.1" : "0.7.1";
   }
 });
 
@@ -4155,13 +4238,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)
@@ -4175,7 +4263,8 @@ async function resolveAndGenerate(input2, options = {}, context) {
     usedT1: studentBrief !== null,
     usedT2: enrollmentProfile !== null,
     bootstrapped,
-    renderedInstruction: content
+    renderedInstruction: content,
+    workspaceStateRecorded
   };
 }
 var logger6, defaultDeps2;
@@ -19663,6 +19752,13 @@ var init_credit_payment_enums = __esm({
   }
 });
 
+// ../../packages/types/src/meeting-integrations.ts
+var init_meeting_integrations = __esm({
+  "../../packages/types/src/meeting-integrations.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/types/src/referral.ts
 var init_referral = __esm({
   "../../packages/types/src/referral.ts"() {
@@ -19686,6 +19782,7 @@ var init_src = __esm({
     init_lesson_review();
     init_errors4();
     init_credit_payment_enums();
+    init_meeting_integrations();
     init_referral();
   }
 });
@@ -21561,6 +21658,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");
@@ -21574,8 +21672,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)
         });
@@ -21583,7 +21683,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
@@ -21603,21 +21703,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);
@@ -21872,6 +21976,7 @@ var init_context = __esm({
     init_dist();
     init_workspace_state();
     init_storage();
+    init_course_state();
     init_formatter();
     init_errors();
     logger27 = createLogger("cli:context");
@@ -21882,6 +21987,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: {
@@ -21900,7 +22007,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,