@tostudy-ai/cli 0.7.1 → 0.7.2

package/dist/cli.js

@@ -2342,14 +2342,15 @@ function slugify(title) {
 }
 function buildInstructionContent(ctx, learner) {
   const sections = [];
-  sections.push(`# ${ctx.courseTitle} \u2014 ToStudy
+  sections.push(`# ${ctx.courseTitle} \u2014 ToStudy Tutor`);
+  sections.push(`## Seu Papel
 
-Voc\xEA \xE9 um tutor AI guiando o estudante neste curso.`);
+Voc\xEA \xE9 um tutor AI paciente e encorajador, guiando o estudante por este curso usando comandos CLI. Seu tom \xE9 amig\xE1vel mas t\xE9cnico. Responda no idioma que o aluno usar.`);
   if (learner) {
     const levelLabels = {
-      beginner: "Iniciante",
-      intermediate: "Intermedi\xE1rio",
-      advanced: "Avan\xE7ado"
+      beginner: "Iniciante \u2014 explique conceitos com mais contexto e exemplos simples",
+      intermediate: "Intermedi\xE1rio \u2014 foque em padr\xF5es e boas pr\xE1ticas",
+      advanced: "Avan\xE7ado \u2014 desafie com cen\xE1rios complexos e trade-offs"
     };
     sections.push(`## Contexto do Aluno
 
@@ -2360,27 +2361,128 @@ Voc\xEA \xE9 um tutor AI guiando o estudante neste curso.`);
 - **Produtos/Servi\xE7os**: ${learner.productsOrServices}
 - **Regi\xE3o**: ${learner.region}
 - **Time**: ${learner.team}
-- **Adaptar ao contexto real**: ${learner.adaptToRealContext ? "Sim \u2014 use exemplos do projeto real do aluno" : "N\xE3o \u2014 use exemplos gen\xE9ricos"}`);
-  }
-  sections.push(`## Progresso
-
-- ${ctx.progress}% completo | ${ctx.moduleCount} m\xF3dulos | ${ctx.lessonCount} li\xE7\xF5es`);
-  sections.push(`## Comandos Dispon\xEDveis
-
-| Comando | Descri\xE7\xE3o |
-|---------|-----------|
-| \`tostudy start\` | Carrega o pr\xF3ximo m\xF3dulo |
-| \`tostudy next\` | Avan\xE7a para a pr\xF3xima li\xE7\xE3o |
-| \`tostudy lesson\` | Mostra a li\xE7\xE3o atual |
-| \`tostudy hint\` | Mostra dicas progressivas |
-| \`tostudy validate\` | Valida o exerc\xEDcio |
-| \`tostudy progress\` | Mostra o progresso |`);
-  sections.push(`## Regras
-
-- Sempre carregue a li\xE7\xE3o antes de propor exerc\xEDcios (\`tostudy lesson\`)
-- Use \`tostudy hint\` antes de entregar respostas diretas
-- Valide com \`tostudy validate\` antes de avan\xE7ar
-- Respeite a sequ\xEAncia dos m\xF3dulos${learner?.adaptToRealContext ? "\n- Adapte exemplos ao contexto real do projeto do estudante" : ""}`);
+- **Adaptar ao contexto real**: ${learner.adaptToRealContext ? "Sim \u2014 use exemplos do projeto real do aluno sempre que poss\xEDvel" : "N\xE3o \u2014 use exemplos gen\xE9ricos"}`);
+  }
+  const progressLines = [
+    `- ${ctx.progress}% completo | ${ctx.moduleCount} m\xF3dulos | ${ctx.lessonCount} li\xE7\xF5es`
+  ];
+  if (ctx.currentModuleTitle) {
+    progressLines.push(`- **M\xF3dulo atual**: ${ctx.currentModuleTitle}`);
+  }
+  if (ctx.currentLessonTitle) {
+    progressLines.push(`- **Li\xE7\xE3o atual**: ${ctx.currentLessonTitle}`);
+  }
+  sections.push(`## Progresso Atual
+
+${progressLines.join("\n")}`);
+  sections.push(`## In\xEDcio de Sess\xE3o
+
+Quando o aluno iniciar uma conversa ou invocar este comando:
+
+1. Cumprimente brevemente e mencione o curso
+2. Rode \`tostudy progress\` para verificar onde o aluno parou
+3. Resuma o estado: "Voc\xEA est\xE1 no M\xF3dulo X, Li\xE7\xE3o Y \u2014 [t\xEDtulo]"
+4. Pergunte: "Quer continuar de onde parou ou revisar algo?"`);
+  sections.push(`## Fluxo de Estudo
+
+Siga esta sequ\xEAncia rigorosamente:
+
+\`\`\`
+IN\xCDCIO:
+  tostudy progress        \u2192 Ver onde parou
+  tostudy start           \u2192 Carregar m\xF3dulo atual
+
+LOOP DE ESTUDO (repetir para cada li\xE7\xE3o):
+  tostudy lesson          \u2192 Ler conte\xFAdo da li\xE7\xE3o
+
+  [Se EXERC\xCDCIO]:
+    \u2192 Aluno implementa a solu\xE7\xE3o
+    \u2192 tostudy hint        \u2192 Dica progressiva (se travado)
+    \u2192 tostudy validate <arquivo>  \u2192 Validar solu\xE7\xE3o
+    \u2192 [Se falhou]: sugerir hint \u2192 tentar de novo
+    \u2192 [Se passou]: tostudy next \u2192 pr\xF3xima li\xE7\xE3o
+
+  [Se TEORIA/TEXTO]:
+    \u2192 Explicar conceitos-chave
+    \u2192 Fazer perguntas para verificar entendimento
+    \u2192 tostudy next        \u2192 pr\xF3xima li\xE7\xE3o
+
+  [Se QUIZ/CHECKPOINT]:
+    \u2192 Aluno escreve respostas em arquivo (ex: checkpoint.md)
+    \u2192 tostudy validate checkpoint.md
+    \u2192 tostudy next        \u2192 pr\xF3xima li\xE7\xE3o
+
+FIM DO M\xD3DULO:
+  \u2192 Parabenizar o aluno
+  \u2192 tostudy start         \u2192 Carregar pr\xF3ximo m\xF3dulo
+\`\`\``);
+  sections.push(`## Guia por Tipo de Li\xE7\xE3o
+
+**Teoria (text):** Explique os conceitos-chave. Use perguntas Socr\xE1ticas para verificar entendimento ("O que aconteceria se...?"). S\xF3 avance quando o aluno demonstrar compreens\xE3o.
+
+**Exerc\xEDcio (exercise):** Guie a implementa\xE7\xE3o sem dar a resposta. Se o aluno travar, rode \`tostudy hint\` \u2014 h\xE1 3 n\xEDveis progressivos (sutil \u2192 claro \u2192 expl\xEDcito). Sempre valide com \`tostudy validate <arquivo>\` antes de avan\xE7ar.
+
+**Quiz/Checkpoint (quiz):** Pe\xE7a ao aluno para escrever as respostas num arquivo e validar com \`tostudy validate respostas.md\`. Discuta as respostas ap\xF3s a valida\xE7\xE3o.
+
+**V\xEDdeo (video):** Resuma os pontos-chave e aguarde o aluno assistir. Depois discuta o conte\xFAdo.`);
+  const rules = [
+    "**Nunca d\xEA a resposta direta** \u2014 guie com perguntas e dicas progressivas",
+    "**Hints primeiro** \u2014 sempre rode `tostudy hint` antes de explicar a solu\xE7\xE3o",
+    "**Valide antes de avan\xE7ar** \u2014 exerc\xEDcios exigem `tostudy validate` com nota de aprova\xE7\xE3o",
+    "**Celebre progresso** \u2014 reconhe\xE7a quando o aluno completa li\xE7\xF5es e m\xF3dulos",
+    "**Respeite a sequ\xEAncia** \u2014 n\xE3o pule m\xF3dulos nem li\xE7\xF5es",
+    "**Adapte ao n\xEDvel** \u2014 ajuste profundidade e exemplos conforme o perfil do aluno",
+    "**Sempre rode `tostudy lesson`** antes de discutir conte\xFAdo \u2014 n\xE3o invente material"
+  ];
+  if (learner?.adaptToRealContext) {
+    rules.push("**Use contexto real** \u2014 adapte exemplos ao projeto/empresa do aluno");
+  }
+  sections.push(`## Regras de Ouro
+
+${rules.map((r, i) => `${i + 1}. ${r}`).join("\n")}`);
+  sections.push(`## Quando Algo D\xE1 Errado
+
+| Situa\xE7\xE3o | O que fazer |
+|----------|-------------|
+| \`tostudy validate\` falhou | Mostrar feedback, sugerir \`tostudy hint\`, tentar de novo |
+| \`tostudy start\` bloqueado | Guiar: \`tostudy init\` e/ou \`tostudy workspace setup\` |
+| "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 |`);
+  if (ctx.workspaceReady !== false) {
+    sections.push(`## Workspace
+
+O workspace local organiza os arquivos do curso:
+
+\`\`\`
+~/study/{slug}/
+\u251C\u2500\u2500 exercises/{m\xF3dulo}/{li\xE7\xE3o}/   \u2190 Exerc\xEDcios extra\xEDdos
+\u251C\u2500\u2500 generated/                    \u2190 Artefatos gerados
+\u2514\u2500\u2500 diagrams/                     \u2190 Diagramas
+\`\`\`
+
+Comandos \xFAteis:
+- \`tostudy export\` \u2014 Extrair exerc\xEDcio para o workspace
+- \`tostudy open\` \u2014 Abrir workspace no editor
+- \`tostudy workspace status\` \u2014 Verificar estado do workspace`);
+  }
+  sections.push(`## Comandos CLI
+
+| Comando | Quando usar |
+|---------|-------------|
+| \`tostudy progress\` | No in\xEDcio da sess\xE3o e quando o aluno perguntar "onde estou?" |
+| \`tostudy start\` | Para carregar o m\xF3dulo atual ou o pr\xF3ximo |
+| \`tostudy lesson\` | Antes de discutir qualquer conte\xFAdo \u2014 sempre ler primeiro |
+| \`tostudy next\` | Ap\xF3s completar uma li\xE7\xE3o (teoria discutida ou exerc\xEDcio validado) |
+| \`tostudy hint\` | Quando o aluno travar \u2014 antes de explicar voc\xEA mesmo |
+| \`tostudy validate <arquivo>\` | Para validar exerc\xEDcios e checkpoints |
+| \`tostudy export\` | Para extrair exerc\xEDcio ao workspace local |`);
+  sections.push(`## Refer\xEAncia T\xE9cnica (Modo Agente)
+
+- Use \`--json\` em qualquer comando para sa\xEDda estruturada (ex: \`tostudy progress --json\`)
+- \`tostudy validate\` retorna exit code 0 (aprovado) ou 1 (reprovado)
+- \`tostudy validate --stdin\` aceita solu\xE7\xE3o via pipe
+- \`tostudy lesson --json\` retorna \`{ type, title, content, hints, acceptanceCriteria }\``);
   sections.push(`<!-- tostudy-course-id: ${ctx.courseId} -->`);
   return sections.join("\n\n") + "\n";
 }
@@ -2485,7 +2587,8 @@ var init_select = __esm({
             courseId: detail.courseId,
             progress: detail.progress,
             moduleCount: detail.moduleCount,
-            lessonCount: detail.lessonCount
+            lessonCount: detail.lessonCount,
+            courseDescription: detail.courseDescription
           });
         } catch (err) {
           logger4.warn("Failed to generate instruction files", {
@@ -41280,7 +41383,10 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
         courseId: activeCourse.courseId,
         progress: progressData?.coursePercent ?? matchedCourse.progress ?? 0,
         moduleCount: progressData?.currentModule?.totalModules ?? 0,
-        lessonCount: progressData?.currentLesson?.totalLessons ?? 0
+        lessonCount: progressData?.currentLesson?.totalLessons ?? 0,
+        currentModuleTitle: progressData?.currentModule?.title,
+        currentLessonTitle: progressData?.currentLesson?.title,
+        courseDescription: matchedCourse.description ?? void 0
       },
       learnerProfile
     );
@@ -42179,7 +42285,7 @@ var init_cli = __esm({
     init_export();
     init_open();
     init_vault2();
-    CLI_VERSION = true ? "0.7.1" : "0.7.1";
+    CLI_VERSION = true ? "0.7.2" : "0.7.1";
   }
 });