@tostudy-ai/cli 0.8.0 → 0.10.0

package/dist/cli.js

@@ -1289,19 +1289,153 @@ var init_secret_store = __esm({
   }
 });
 
+// src/workspace/workspace-marker.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, readFileSync } from "node:fs";
+import os2 from "node:os";
+import path2 from "node:path";
+function resolveMarkerPath(workspacePath) {
+  if (path2.basename(workspacePath) === ".tostudy") {
+    return path2.join(workspacePath, "workspace.json");
+  }
+  return path2.join(workspacePath, ".tostudy", "workspace.json");
+}
+async function readWorkspaceMarker(workspacePath) {
+  const filePath = resolveMarkerPath(workspacePath);
+  if (!existsSync2(filePath)) return null;
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!SUPPORTED_VERSIONS.has(parsed.version)) return null;
+    if (typeof parsed.courseId !== "string" || typeof parsed.enrollmentId !== "string" || typeof parsed.slug !== "string" || typeof parsed.courseTitle !== "string" || typeof parsed.createdAt !== "string" || typeof parsed.updatedAt !== "string") {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+async function writeWorkspaceMarker(workspacePath, input2, options = {}) {
+  const homeDir = path2.resolve(options.homeDir ?? os2.homedir());
+  const resolvedWorkspace = path2.resolve(workspacePath);
+  if (resolvedWorkspace === homeDir || homeDir.startsWith(resolvedWorkspace + path2.sep)) {
+    throw new Error(
+      `Refusing to write workspace marker at ${workspacePath}: it is the home directory or an ancestor of it.`
+    );
+  }
+  const filePath = resolveMarkerPath(workspacePath);
+  const dir = path2.dirname(filePath);
+  if (!existsSync2(dir)) {
+    mkdirSync2(dir, { recursive: true });
+  }
+  const existing = await readWorkspaceMarker(workspacePath);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const marker = {
+    version: CURRENT_VERSION,
+    courseId: input2.courseId,
+    enrollmentId: input2.enrollmentId,
+    slug: input2.slug,
+    courseTitle: input2.courseTitle,
+    createdAt: existing?.createdAt ?? now,
+    updatedAt: now
+  };
+  writeFileSync2(filePath, JSON.stringify(marker, null, 2), { mode: 384 });
+  return filePath;
+}
+var CURRENT_VERSION, SUPPORTED_VERSIONS;
+var init_workspace_marker = __esm({
+  "src/workspace/workspace-marker.ts"() {
+    "use strict";
+    CURRENT_VERSION = 1;
+    SUPPORTED_VERSIONS = /* @__PURE__ */ new Set([1, 2]);
+  }
+});
+
+// src/workspace/workspace-state.ts
+var workspace_state_exports = {};
+__export(workspace_state_exports, {
+  findWorkspaceState: () => findWorkspaceState,
+  readWorkspaceState: () => readWorkspaceState,
+  updateWorkspaceState: () => updateWorkspaceState
+});
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync3 } from "node:fs";
+import os3 from "node:os";
+import path3 from "node:path";
+async function readWorkspaceState(workspacePath) {
+  const marker = await readWorkspaceMarker(workspacePath);
+  if (!marker) return null;
+  const filePath = resolveMarkerPath(workspacePath);
+  try {
+    const raw = JSON.parse(readFileSync2(filePath, "utf-8"));
+    const state = {
+      version: 2,
+      courseId: marker.courseId,
+      enrollmentId: marker.enrollmentId,
+      slug: marker.slug,
+      courseTitle: marker.courseTitle,
+      createdAt: marker.createdAt,
+      updatedAt: marker.updatedAt
+    };
+    if (typeof raw.currentLessonId === "string") state.currentLessonId = raw.currentLessonId;
+    if (typeof raw.currentModuleId === "string") state.currentModuleId = raw.currentModuleId;
+    if (Array.isArray(raw.courseTags)) state.courseTags = raw.courseTags;
+    if (raw.courseLevel === "beginner" || raw.courseLevel === "intermediate" || raw.courseLevel === "advanced" || raw.courseLevel === null) {
+      state.courseLevel = raw.courseLevel;
+    }
+    if (typeof raw.lastInitCourseId === "string") state.lastInitCourseId = raw.lastInitCourseId;
+    return state;
+  } catch {
+    return null;
+  }
+}
+async function findWorkspaceState(startCwd = process.cwd(), homeDir = os3.homedir()) {
+  const home = path3.resolve(homeDir);
+  let current = path3.resolve(startCwd);
+  while (true) {
+    if (current === home) return null;
+    const state = await readWorkspaceState(current);
+    if (state) return { state, workspacePath: current };
+    const parent = path3.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+async function updateWorkspaceState(workspacePath, update) {
+  const existing = await readWorkspaceState(workspacePath);
+  if (!existing) {
+    throw new Error(`No workspace marker found at ${workspacePath}. Run 'tostudy select' first.`);
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const merged = {
+    ...existing,
+    ...update,
+    version: 2,
+    createdAt: existing.createdAt,
+    updatedAt: now
+  };
+  const filePath = resolveMarkerPath(workspacePath);
+  writeFileSync3(filePath, JSON.stringify(merged, null, 2), { mode: 384 });
+  return merged;
+}
+var init_workspace_state = __esm({
+  "src/workspace/workspace-state.ts"() {
+    "use strict";
+    init_workspace_marker();
+  }
+});
+
 // src/auth/session.ts
 import fs2 from "node:fs";
-import path2 from "node:path";
-import os2 from "node:os";
+import path4 from "node:path";
+import os4 from "node:os";
 function getConfigDir(override) {
   if (override) return override;
   if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
-    return path2.join(process.env["XDG_CONFIG_HOME"], "tostudy");
+    return path4.join(process.env["XDG_CONFIG_HOME"], "tostudy");
   }
-  return path2.join(os2.homedir(), ".tostudy");
+  return path4.join(os4.homedir(), ".tostudy");
 }
 function getCourseOnboardingPath(configDir) {
-  return path2.join(getConfigDir(configDir), "course-onboarding.json");
+  return path4.join(getConfigDir(configDir), "course-onboarding.json");
 }
 function readCourseOnboardingState(configDir) {
   const onboardingPath = getCourseOnboardingPath(configDir);
@@ -1343,7 +1477,7 @@ async function saveCourseLearnerProfile(course, learnerProfile, artifacts, confi
   await saveUserProfile(learnerProfile, configDir);
 }
 function getUserProfilePath(configDir) {
-  return path2.join(getConfigDir(configDir), "user-profile.json");
+  return path4.join(getConfigDir(configDir), "user-profile.json");
 }
 async function getUserProfile(configDir) {
   const profilePath = getUserProfilePath(configDir);
@@ -1378,13 +1512,13 @@ async function saveSession(session, configDir) {
     apiUrl: session.apiUrl,
     sessionId: session.sessionId
   };
-  fs2.writeFileSync(path2.join(dir, "config.json"), JSON.stringify(stored, null, 2), {
+  fs2.writeFileSync(path4.join(dir, "config.json"), JSON.stringify(stored, null, 2), {
     mode: 384
   });
 }
 async function getSession(configDir) {
   const dir = getConfigDir(configDir);
-  const p = path2.join(dir, "config.json");
+  const p = path4.join(dir, "config.json");
   if (!fs2.existsSync(p)) return null;
   const stored = JSON.parse(fs2.readFileSync(p, "utf-8"));
   const secrets = await loadStoredSessionSecrets(dir);
@@ -1401,29 +1535,12 @@ async function getSession(configDir) {
 }
 async function clearSession(configDir) {
   const dir = getConfigDir(configDir);
-  const p = path2.join(dir, "config.json");
+  const p = path4.join(dir, "config.json");
   if (fs2.existsSync(p)) fs2.unlinkSync(p);
-  const ap = path2.join(dir, "active-course.json");
-  if (fs2.existsSync(ap)) fs2.unlinkSync(ap);
   const onboardingPath = getCourseOnboardingPath(configDir);
   if (fs2.existsSync(onboardingPath)) fs2.unlinkSync(onboardingPath);
   await deleteStoredSessionSecrets(dir);
 }
-async function getActiveCourse(configDir) {
-  const dir = getConfigDir(configDir);
-  const p = path2.join(dir, "active-course.json");
-  if (!fs2.existsSync(p)) return null;
-  return JSON.parse(fs2.readFileSync(p, "utf-8"));
-}
-async function setActiveCourse(course, configDir) {
-  const dir = getConfigDir(configDir);
-  fs2.mkdirSync(dir, { recursive: true });
-  const onboardingState = await getCourseOnboardingState(course.courseId, configDir);
-  const persistedCourse = onboardingState?.initCompletedAt && !course.lastInitCourseId ? { ...course, lastInitCourseId: course.courseId } : course;
-  fs2.writeFileSync(path2.join(dir, "active-course.json"), JSON.stringify(persistedCourse, null, 2), {
-    mode: 384
-  });
-}
 async function refreshCliSession(session, configDir) {
   try {
     const response = await fetch(`${session.apiUrl}/api/cli/auth/refresh`, {
@@ -1466,33 +1583,31 @@ async function requireSession(configDir) {
   }
   return session;
 }
-async function requireActiveCourse(configDir) {
-  const course = await getActiveCourse(configDir);
-  if (!course) {
-    process.stderr.write("Erro: Nenhum curso ativo. Rode: tostudy select <curso>\n");
-    process.exit(3);
-  }
-  return course;
-}
-async function setLastInitCourseId(courseId, configDir) {
-  const existing = await getActiveCourse(configDir);
-  if (!existing) return;
-  await setActiveCourse({ ...existing, lastInitCourseId: courseId }, configDir);
-  await updateCourseOnboardingState(
-    courseId,
-    {
-      initCompletedAt: (/* @__PURE__ */ new Date()).toISOString()
-    },
-    configDir
-  );
+async function requireActiveCourse() {
+  const { findWorkspaceState: findWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_exports));
+  const result = await findWorkspaceState2();
+  if (result) return result.state;
+  process.stderr.write("Erro: Nenhum workspace configurado. Rode: tostudy setup\n");
+  process.exit(3);
+}
+async function setLastInitCourseId(courseId, _configDir) {
+  const { findWorkspaceState: findWorkspaceState2, updateWorkspaceState: updateWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_exports));
+  const found = await findWorkspaceState2();
+  if (!found) return;
+  await updateWorkspaceState2(found.workspacePath, { lastInitCourseId: courseId });
+  await updateCourseOnboardingState(courseId, {
+    initCompletedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
 }
-async function checkCourseDrift(configDir) {
-  const course = await getActiveCourse(configDir);
-  if (!course) return null;
-  if (!course.lastInitCourseId) return null;
-  if (course.lastInitCourseId === course.courseId) return null;
+async function checkCourseDrift() {
+  const { findWorkspaceState: findWorkspaceState2 } = await Promise.resolve().then(() => (init_workspace_state(), workspace_state_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 "${course.courseTitle}".`,
+    `\u26A0\uFE0F Curso ativo mudou para "${state.courseTitle}".`,
     `   Rode \`tostudy init\` para atualizar o contexto do assistente.`,
     ""
   ].join("\n");
@@ -1504,295 +1619,6 @@ var init_session = __esm({
   }
 });
 
-// src/onboarding/api.ts
-async function apiFetch2(url2, token2, init) {
-  const response = await fetch(url2, {
-    ...init,
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${token2}`,
-      ...init?.headers
-    }
-  });
-  const body = await response.json();
-  if (!response.ok) {
-    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
-  }
-  return body;
-}
-async function getRemoteEnrollmentOnboarding(input2) {
-  const url2 = new URL(`${input2.apiUrl}/api/cli/onboarding`);
-  url2.searchParams.set("enrollmentId", input2.enrollmentId);
-  const response = await apiFetch2(
-    url2.toString(),
-    input2.token
-  );
-  return response.onboarding;
-}
-async function saveRemoteEnrollmentOnboarding(input2) {
-  const response = await apiFetch2(
-    `${input2.apiUrl}/api/cli/onboarding`,
-    input2.token,
-    {
-      method: "POST",
-      body: JSON.stringify({
-        enrollmentId: input2.enrollmentId,
-        learnerBrief: input2.learnerBrief,
-        learnerProfile: input2.learnerProfile
-      })
-    }
-  );
-  return response.onboarding;
-}
-var init_api = __esm({
-  "src/onboarding/api.ts"() {
-    "use strict";
-    init_http2();
-  }
-});
-
-// src/output/init-template.ts
-function detectTechFromTags(tags) {
-  const found = /* @__PURE__ */ new Set();
-  const keywords = Object.keys(LANGUAGE_TAGS);
-  const joined = tags.map((t) => t.toLowerCase()).join(" ");
-  for (const kw of keywords) {
-    const pattern = new RegExp(`\\b${kw.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`);
-    if (pattern.test(joined)) {
-      found.add(kw);
-    }
-  }
-  return [...found];
-}
-function formatCourseLanguage(tags) {
-  if (!tags || tags.length === 0) return "Programa\xE7\xE3o";
-  const direct = tags.map((t) => LANGUAGE_TAGS[t.toLowerCase()]).filter(Boolean);
-  if (direct.length > 0) return direct.slice(0, 3).join(" / ");
-  const detected = detectTechFromTags(tags);
-  const mapped = detected.map((t) => LANGUAGE_TAGS[t]).filter(Boolean);
-  return mapped.length > 0 ? mapped.slice(0, 3).join(" / ") : "Programa\xE7\xE3o";
-}
-function formatCourseLevel(level) {
-  const map2 = {
-    beginner: "Iniciante",
-    intermediate: "Intermedi\xE1rio",
-    advanced: "Avan\xE7ado"
-  };
-  return map2[level ?? "intermediate"] ?? "Intermedi\xE1rio";
-}
-function formatCourseMethodology(approach) {
-  const map2 = {
-    hybrid: "Teoria e pr\xE1tica",
-    structured: "Estruturado com exerc\xEDcios",
-    exploratory: "Explorat\xF3rio",
-    mentored: "Mentoria guiada",
-    "ai-exploration": "Explora\xE7\xE3o com IA"
-  };
-  return map2[approach] ?? "Teoria e pr\xE1tica";
-}
-function formatCourseObjective(description) {
-  if (!description || description.trim() === "") return null;
-  const firstSentence = description.split(/[.!?]/)[0]?.trim();
-  if (!firstSentence) return null;
-  if (firstSentence.length > 200) return firstSentence.slice(0, 200) + "...";
-  return firstSentence;
-}
-function buildInitTemplate(userName, course, progress3) {
-  const lines = [];
-  lines.push("# ToStudy CLI \u2014 Instru\xE7\xF5es para o Assistente AI");
-  lines.push("");
-  lines.push("Voc\xEA \xE9 um tutor de programa\xE7\xE3o auxiliando um aluno via terminal.");
-  lines.push("");
-  lines.push("## 1. Estado Atual");
-  lines.push(`- Usu\xE1rio: ${userName}`);
-  lines.push(`- Curso: "${course.title}" (${progress3?.coursePercent ?? course.progress}%)`);
-  if (progress3) {
-    const mod = progress3.currentModule;
-    const les = progress3.currentLesson;
-    lines.push(`- M\xF3dulo ${mod.order}/${mod.totalModules}: "${mod.title}"`);
-    lines.push(`- Li\xE7\xE3o ${les.order}/${les.totalLessons}: "${les.title}"`);
-  } else {
-    lines.push("- Nenhuma li\xE7\xE3o iniciada. Rode `tostudy start` para come\xE7ar.");
-  }
-  const language = formatCourseLanguage(course.tags);
-  const level = formatCourseLevel(course.level);
-  const methodology = formatCourseMethodology(course.teachingApproach);
-  const objective = formatCourseObjective(course.description);
-  lines.push("");
-  lines.push("## 2. Contexto do Curso");
-  lines.push(`- Linguagem: ${language}`);
-  lines.push(`- N\xEDvel: ${level}`);
-  lines.push(`- Metodologia: ${methodology}`);
-  if (objective) lines.push(`- Objetivo: ${objective}`);
-  lines.push("");
-  lines.push("Adapte explica\xE7\xF5es e exemplos para esta stack.");
-  lines.push("Exerc\xEDcios envolvem arquivos de c\xF3digo no workspace do aluno.");
-  lines.push("");
-  lines.push("## 3. Comandos");
-  lines.push("| Comando                          | Uso                              |");
-  lines.push("|----------------------------------|----------------------------------|");
-  lines.push("| `tostudy lesson`                 | Ver conte\xFAdo da li\xE7\xE3o atual      |");
-  lines.push("| `tostudy next`                   | Avan\xE7ar para pr\xF3xima li\xE7\xE3o       |");
-  lines.push("| `tostudy hint`                   | Dica progressiva                 |");
-  lines.push("| `tostudy validate <arquivo>`     | Validar solu\xE7\xE3o do exerc\xEDcio     |");
-  lines.push("| `tostudy progress`               | Ver progresso detalhado          |");
-  lines.push("| `tostudy start`                  | Iniciar/retomar m\xF3dulo           |");
-  lines.push("| `tostudy start-next`             | Avan\xE7ar para pr\xF3ximo m\xF3dulo      |");
-  lines.push("| `tostudy courses`                | Listar cursos matriculados       |");
-  lines.push("| `tostudy select <n>`             | Trocar curso ativo               |");
-  lines.push("| `tostudy doctor`                 | Diagn\xF3stico de problemas         |");
-  lines.push("");
-  lines.push("Adicione `--json` para output estruturado quando precisar parsear.");
-  lines.push("");
-  lines.push("## 4. Regras");
-  lines.push("1. Comece rodando `tostudy lesson` para carregar o conte\xFAdo");
-  lines.push("2. N\xE3o d\xEA respostas diretas \u2014 use `tostudy hint` para dicas progressivas");
-  lines.push("3. Ap\xF3s `tostudy validate`, analise cada crit\xE9rio e guie a corre\xE7\xE3o");
-  lines.push("4. N\xE3o avance com `tostudy next` sem o aluno completar o exerc\xEDcio");
-  lines.push('5. Se algum comando retornar aviso de "curso ativo mudou", rode `tostudy init`');
-  lines.push("");
-  lines.push("## 5. Coexist\xEAncia");
-  lines.push("Este workspace pode ter suas pr\xF3prias instru\xE7\xF5es (CLAUDE.md, AGENTS.md).");
-  lines.push("- Instru\xE7\xF5es do projeto \u2192 decis\xF5es de c\xF3digo (estilo, lint, arquitetura)");
-  lines.push("- Instru\xE7\xF5es do ToStudy \u2192 fluxo de estudo (navega\xE7\xE3o, exerc\xEDcios, valida\xE7\xE3o)");
-  return lines.join("\n");
-}
-function resolveTutorMode(level) {
-  if (level === "beginner") return "guided";
-  if (level === "advanced") return "direct";
-  return "balanced";
-}
-function formatTutorMode(mode) {
-  const map2 = {
-    guided: "Guiado",
-    balanced: "Equilibrado",
-    direct: "Direto"
-  };
-  return map2[mode];
-}
-function buildTutorPersonalizationSection(course, learnerProfile) {
-  const mode = resolveTutorMode(course.level);
-  const lines = [];
-  lines.push("## 6. Personaliza\xE7\xE3o do Tutor");
-  lines.push(`- Modo inicial do tutor: ${formatTutorMode(mode)}`);
-  lines.push(
-    "- Na primeira intera\xE7\xE3o, apresente a escolha entre cen\xE1rio fict\xEDcio do curso e adapta\xE7\xE3o ao contexto real do aluno."
-  );
-  lines.push(
-    `- O aluno atual j\xE1 optou por: ${learnerProfile.adaptToRealContext ? "Adaptar para o contexto real" : "Manter o cen\xE1rio fict\xEDcio"}`
-  );
-  lines.push(`- Segmento: ${learnerProfile.segment}`);
-  lines.push(`- Empresa: ${learnerProfile.company}`);
-  lines.push(`- Produtos/servi\xE7os: ${learnerProfile.productsOrServices}`);
-  lines.push(`- Regi\xE3o: ${learnerProfile.region}`);
-  lines.push(`- Equipe: ${learnerProfile.team}`);
-  lines.push(`- Objetivo: ${learnerProfile.goal}`);
-  lines.push(`- N\xEDvel declarado do aluno: ${formatCourseLevel(learnerProfile.learnerLevel)}`);
-  if (learnerProfile.adaptToRealContext) {
-    lines.push(
-      "- Use o contexto do aluno como padr\xE3o para explica\xE7\xF5es, exemplos, exerc\xEDcios e framing."
-    );
-    lines.push(
-      "- Troque nomes, entreg\xE1veis e restri\xE7\xF5es do cen\xE1rio fict\xEDcio por equivalentes reais."
-    );
-    lines.push(
-      "- Preserve objetivos pedag\xF3gicos, crit\xE9rios de valida\xE7\xE3o e progress\xE3o de dificuldade."
-    );
-  } else {
-    lines.push(
-      "- Preserve o cen\xE1rio fict\xEDcio como padr\xE3o e conecte os conceitos ao neg\xF3cio real quando isso ajudar."
-    );
-    lines.push(
-      "- Se o aluno quiser migrar para o contexto real depois, oriente a rodar `tostudy init` novamente."
-    );
-  }
-  if (mode === "guided") {
-    lines.push(
-      "- No modo guiado, explique o porqu\xEA de cada passo, proponha checkpoints curtos e confirme entendimento antes de avan\xE7ar."
-    );
-  } else if (mode === "direct") {
-    lines.push(
-      "- Mesmo no modo mais direto, continue sem dar a resposta pronta e preserve a progress\xE3o pedag\xF3gica."
-    );
-  } else {
-    lines.push(
-      "- No modo equilibrado, combine explica\xE7\xF5es curtas com autonomia entre checkpoints."
-    );
-  }
-  return lines.join("\n");
-}
-function buildLearnerBrief(userName, course, learnerProfile) {
-  const lines = [];
-  lines.push("# ToStudy CLI \u2014 Brief do Aluno");
-  lines.push("");
-  lines.push("Este documento resume o contexto real do aluno para orientar exemplos e exercicios.");
-  lines.push("");
-  lines.push("## 1. Identificacao");
-  lines.push(`- Aluno: ${userName}`);
-  lines.push(`- Curso: "${course.title}"`);
-  lines.push(`- Segmento: ${learnerProfile.segment}`);
-  lines.push(`- Empresa: ${learnerProfile.company}`);
-  lines.push(`- Produtos/servicos: ${learnerProfile.productsOrServices}`);
-  lines.push(`- Regiao: ${learnerProfile.region}`);
-  lines.push(`- Equipe: ${learnerProfile.team}`);
-  lines.push("");
-  lines.push("## 2. Objetivo e Contexto");
-  lines.push(`- Objetivo principal: ${learnerProfile.goal}`);
-  lines.push(`- Nivel do aluno: ${formatCourseLevel(learnerProfile.learnerLevel)}`);
-  lines.push(
-    `- Adaptar curso ao contexto real: ${learnerProfile.adaptToRealContext ? "Sim" : "Nao"}`
-  );
-  lines.push("");
-  lines.push("## 3. Como usar este brief");
-  lines.push("- Reutilize este contexto para adaptar exemplos, cenarios e exercicios.");
-  lines.push("- Preserve a proposta pedagogica do curso antes de customizar o contexto.");
-  lines.push(
-    "- Se algo mudar no negocio do aluno, rode `tostudy init` novamente para atualizar o brief."
-  );
-  return lines.join("\n");
-}
-function buildInitArtifacts(userName, course, progress3, learnerProfile) {
-  return {
-    tutorInstructions: [
-      buildInitTemplate(userName, course, progress3),
-      buildTutorPersonalizationSection(course, learnerProfile)
-    ].join("\n\n"),
-    learnerBrief: buildLearnerBrief(userName, course, learnerProfile)
-  };
-}
-var LANGUAGE_TAGS;
-var init_init_template = __esm({
-  "src/output/init-template.ts"() {
-    "use strict";
-    LANGUAGE_TAGS = {
-      javascript: "JavaScript",
-      typescript: "TypeScript",
-      python: "Python",
-      react: "React",
-      "react-native": "React Native",
-      node: "Node.js",
-      nodejs: "Node.js",
-      go: "Go",
-      rust: "Rust",
-      java: "Java",
-      csharp: "C#",
-      "c#": "C#",
-      cpp: "C++",
-      ruby: "Ruby",
-      php: "PHP",
-      swift: "Swift",
-      kotlin: "Kotlin",
-      html: "HTML",
-      css: "CSS",
-      sql: "SQL",
-      vue: "Vue.js",
-      angular: "Angular",
-      nextjs: "Next.js",
-      svelte: "Svelte"
-    };
-  }
-});
-
 // src/output/formatter.ts
 function output(data, opts) {
   if (opts.json) {
@@ -1808,6 +1634,13 @@ function error(msg, code = 1) {
 `);
   process.exit(code);
 }
+function jsonError(key, opts) {
+  const code = opts?.code ?? 1;
+  process.stdout.write(
+    JSON.stringify({ error: true, key, message: opts?.message ?? key, code }) + "\n"
+  );
+  process.exit(code);
+}
 function progressBar(percent, width = 20) {
   const clamped = Math.max(0, Math.min(100, percent));
   const filled = Math.round(clamped / 100 * width);
@@ -1995,192 +1828,40 @@ var init_formatter = __esm({
   }
 });
 
-// src/commands/login.ts
-import { Command } from "commander";
-import { execFile as execFile2 } from "node:child_process";
-async function syncRemoteProfile(apiUrl, token2, activeCourse, userName, courseData) {
-  try {
-    const remote = await getRemoteEnrollmentOnboarding({
-      apiUrl,
-      token: token2,
-      enrollmentId: activeCourse.enrollmentId
-    });
-    if (remote?.learnerProfile) {
-      const artifacts = buildInitArtifacts(userName, courseData, null, remote.learnerProfile);
-      await saveCourseLearnerProfile(activeCourse, remote.learnerProfile, artifacts);
-      console.log(`  \u2713 Perfil de aprendizagem sincronizado (${remote.source})`);
-    }
-  } catch (err) {
-    logger2.warn("Failed to sync remote profile", {
-      error: err instanceof Error ? err.message : String(err)
-    });
-  }
-}
-var logger2, DEFAULT_API_URL, PORT, loginCommand;
-var init_login = __esm({
-  "src/commands/login.ts"() {
-    "use strict";
-    init_src();
-    init_courses();
-    init_http2();
-    init_oauth_server();
-    init_session();
-    init_api();
-    init_init_template();
-    init_formatter();
-    logger2 = createLogger("cli:login");
-    DEFAULT_API_URL = "https://tostudy.ai";
-    PORT = 9876;
-    loginCommand = new Command("login").description("Autentica no ToStudy via browser").option("--manual", "Login manual (sem browser)").option("--api-url <url>", "API URL override", DEFAULT_API_URL).action(async (opts) => {
-      const apiUrl = opts.apiUrl;
-      if (opts.manual) {
-        console.log(`
-  Acesse este endere\xE7o no seu browser:`);
-        console.log(`  ${apiUrl}/api/cli/auth/authorize?port=${PORT}
-`);
-        console.log("  Ap\xF3s autorizar, o browser ser\xE1 redirecionado e o login ser\xE1 conclu\xEDdo.");
-        console.log("  Certifique-se de rodar este comando sem --manual para o fluxo autom\xE1tico.\n");
-        return;
-      }
-      console.log("\n  Abrindo browser para autentica\xE7\xE3o...\n");
-      const serverPromise = startCallbackServer(PORT);
-      const authUrl = `${apiUrl}/api/cli/auth/authorize?port=${PORT}`;
-      const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
-      execFile2(openCmd, [authUrl], (err) => {
-        if (err) {
-          console.log(`  N\xE3o foi poss\xEDvel abrir o browser automaticamente.`);
-          console.log(`  Abra manualmente: ${authUrl}
-`);
-        }
-      });
-      try {
-        const { code } = await serverPromise;
-        const res = await fetch(`${apiUrl}/api/cli/auth/exchange`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ code })
-        });
-        if (!res.ok) {
-          const body = await res.json();
-          error(body.error ?? "Falha na autentica\xE7\xE3o");
-        }
-        const { token: token2, refreshToken, sessionId, userId, userName, expiresAt } = await res.json();
-        await saveSession({ token: token2, refreshToken, sessionId, userId, userName, expiresAt, apiUrl });
-        console.log(`
-  \u2713 Logado como ${userName}`);
-        try {
-          const data = createHttpProvider(apiUrl, token2);
-          const courses3 = await listCourses({ userId }, { data, logger: logger2 });
-          if (courses3.length > 0) {
-            console.log(`  \u2713 ${courses3.length} curso(s) matriculado(s)`);
-            const activeCourse = await getActiveCourse();
-            const targetCourse = activeCourse && courses3.find((c) => c.courseId === activeCourse.courseId) ? activeCourse : null;
-            if (!targetCourse && courses3.length === 1) {
-              const only = courses3[0];
-              const newActive = {
-                courseId: only.courseId,
-                courseTitle: only.title,
-                enrollmentId: only.enrollmentId,
-                courseTags: only.tags,
-                courseLevel: only.level
-              };
-              await setActiveCourse(newActive);
-              console.log(`  \u2713 Curso ativo: ${only.title} (${only.progress}%)`);
-              await syncRemoteProfile(apiUrl, token2, newActive, userName, courses3[0]);
-            } else if (targetCourse) {
-              const matched = courses3.find((c) => c.courseId === targetCourse.courseId);
-              if (matched) {
-                await syncRemoteProfile(apiUrl, token2, targetCourse, userName, matched);
-              }
-            } else {
-              console.log(`  \u2192 Rode \`tostudy setup\` para configurar seu ambiente`);
-            }
-          } else {
-            console.log(`  \u2192 Nenhum curso matriculado. Acesse tostudy.ai para se matricular.`);
-          }
-        } catch (syncErr) {
-          logger2.warn("Post-login sync failed", {
-            error: syncErr instanceof Error ? syncErr.message : String(syncErr)
-          });
-        }
-        console.log("");
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : "Login falhou";
-        error(msg);
-      }
-    });
-  }
-});
-
-// src/commands/logout.ts
-import { Command as Command2 } from "commander";
-var logoutCommand;
-var init_logout = __esm({
-  "src/commands/logout.ts"() {
-    "use strict";
-    init_session();
-    logoutCommand = new Command2("logout").description("Remove token local").action(async () => {
-      await clearSession();
-      console.log("\n  Deslogado com sucesso.\n");
-    });
-  }
+// src/installer/ide-detector.ts
+var ide_detector_exports = {};
+__export(ide_detector_exports, {
+  detectIDEs: () => detectIDEs
 });
-
-// src/installer/node-detector.ts
 import { execFileSync } from "node:child_process";
-function detectNode() {
-  try {
-    const version3 = execFileSync("node", ["--version"], {
-      encoding: "utf-8"
-    }).trim();
-    let nodePath = null;
-    try {
-      const whichCmd = process.platform === "win32" ? "where" : "which";
-      nodePath = execFileSync(whichCmd, ["node"], { encoding: "utf-8" }).trim();
-    } catch {
-    }
-    const major = parseInt(version3.replace("v", ""), 10);
-    return { installed: true, version: version3, meetsMinimum: major >= 18, path: nodePath };
-  } catch {
-    return { installed: false, version: null, meetsMinimum: false, path: null };
-  }
-}
-var init_node_detector = __esm({
-  "src/installer/node-detector.ts"() {
-    "use strict";
-  }
-});
-
-// src/installer/ide-detector.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
 import fs3 from "node:fs";
-import path3 from "node:path";
-import os3 from "node:os";
+import path5 from "node:path";
+import os5 from "node:os";
 function checkExists(p) {
   return fs3.existsSync(p);
 }
 function detectIDEs() {
-  const home = os3.homedir();
+  const home = os5.homedir();
   const ides = [
     // Claude Code: detected by presence of 'claude' binary
     {
       name: "Claude Code",
       id: "claude-code",
       detected: false,
-      configPath: path3.join(home, ".mcp.json")
+      configPath: path5.join(home, ".mcp.json")
     },
     // Cursor: ~/.cursor directory
     {
       name: "Cursor",
       id: "cursor",
-      detected: checkExists(path3.join(home, ".cursor")),
-      configPath: path3.join(home, ".cursor", "mcp.json")
+      detected: checkExists(path5.join(home, ".cursor")),
+      configPath: path5.join(home, ".cursor", "mcp.json")
     },
     // VS Code: ~/.vscode directory
     {
       name: "VS Code",
       id: "vscode",
-      detected: checkExists(path3.join(home, ".vscode")),
+      detected: checkExists(path5.join(home, ".vscode")),
       configPath: ".vscode/mcp.json"
     },
     // Claude Desktop: platform-specific config dir
@@ -2188,29 +1869,29 @@ function detectIDEs() {
       name: "Claude Desktop",
       id: "desktop",
       detected: checkExists(
-        process.platform === "darwin" ? path3.join(home, "Library", "Application Support", "Claude") : process.platform === "win32" ? path3.join(process.env["APPDATA"] ?? home, "Claude") : path3.join(home, ".config", "claude")
+        process.platform === "darwin" ? path5.join(home, "Library", "Application Support", "Claude") : process.platform === "win32" ? path5.join(process.env["APPDATA"] ?? home, "Claude") : path5.join(home, ".config", "claude")
       ),
-      configPath: process.platform === "darwin" ? path3.join(
+      configPath: process.platform === "darwin" ? path5.join(
         home,
         "Library",
         "Application Support",
         "Claude",
         "claude_desktop_config.json"
-      ) : process.platform === "win32" ? path3.join(process.env["APPDATA"] ?? home, "Claude", "claude_desktop_config.json") : path3.join(home, ".config", "claude", "claude_desktop_config.json")
+      ) : process.platform === "win32" ? path5.join(process.env["APPDATA"] ?? home, "Claude", "claude_desktop_config.json") : path5.join(home, ".config", "claude", "claude_desktop_config.json")
     },
     // Windsurf: ~/.codeium/windsurf
     {
       name: "Windsurf",
       id: "windsurf",
-      detected: checkExists(path3.join(home, ".codeium", "windsurf")),
-      configPath: path3.join(home, ".codeium", "windsurf", "mcp_config.json")
+      detected: checkExists(path5.join(home, ".codeium", "windsurf")),
+      configPath: path5.join(home, ".codeium", "windsurf", "mcp_config.json")
     },
     // OpenCode: ~/.opencode
     {
       name: "OpenCode",
       id: "opencode",
-      detected: checkExists(path3.join(home, ".opencode")),
-      configPath: path3.join(home, ".opencode", "opencode.json")
+      detected: checkExists(path5.join(home, ".opencode")),
+      configPath: path5.join(home, ".opencode", "opencode.json")
     },
     // Manual (always available as fallback)
     {
@@ -2223,7 +1904,7 @@ function detectIDEs() {
   const claudeIde = ides.find((ide) => ide.id === "claude-code");
   if (claudeIde) {
     try {
-      execFileSync2("which", ["claude"], { encoding: "utf-8" });
+      execFileSync("which", ["claude"], { encoding: "utf-8" });
       claudeIde.detected = true;
     } catch {
     }
@@ -2236,418 +1917,362 @@ var init_ide_detector = __esm({
   }
 });
 
-// src/installer/mcp-setup.ts
-import { spawn } from "node:child_process";
-async function exchangeCliSessionForMcpToken(session, fetchImpl = fetch) {
-  const res = await fetchImpl(`${session.apiUrl}/api/mcp/token`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${session.token}`
-    }
-  });
-  if (!res.ok) {
-    const body = await res.json().catch(() => ({}));
-    throw new Error(body.error ?? `Falha ao obter token MCP (${res.status})`);
-  }
-  return res.json();
-}
-async function runMcpSetup(session, token2, spawnImpl = spawn) {
-  const command = process.platform === "win32" ? "npx.cmd" : "npx";
-  await new Promise((resolve, reject) => {
-    const child = spawnImpl(command, ["-y", "@tostudy-ai/mcp-setup", "--url", session.apiUrl], {
-      stdio: "inherit",
-      env: {
-        ...process.env,
-        TOSTUDY_API_KEY: token2
-      }
-    });
-    child.once("error", reject);
-    child.once("exit", (code) => {
-      if (code === 0) {
-        resolve();
-        return;
-      }
-      reject(new Error(`MCP setup failed with exit code ${code ?? "unknown"}`));
-    });
-  });
-}
-var init_mcp_setup = __esm({
-  "src/installer/mcp-setup.ts"() {
-    "use strict";
-  }
-});
-
-// src/workspace/instruction-files.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join2 } from "node:path";
-import os4 from "node:os";
-function slugify(title) {
-  return title.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+// src/output/instruction-template-v3.ts
+function renderCourseInstruction(input2) {
+  const sections = [];
+  sections.push(renderTitle(input2));
+  sections.push(renderWhoYouAre(input2.tutorPersona));
+  sections.push(renderVoiceRules());
+  sections.push(renderWhoIsStudent(input2.studentBrief, input2.enrollmentProfile));
+  sections.push(renderHowToAdapt(input2.enrollmentProfile));
+  sections.push(renderPrecedence());
+  sections.push(renderWhereStudentIs(input2.progress));
+  sections.push(renderHowToConduct());
+  sections.push(renderSilentTools());
+  sections.push(renderHandlingSituations());
+  sections.push(renderTechnicalReference());
+  sections.push(renderFooter(input2.course));
+  return sections.join("\n\n") + "\n";
 }
-function buildInstructionContent(ctx, learner) {
+function renderUniversalInstruction() {
   const sections = [];
-  sections.push(`# ${ctx.courseTitle} \u2014 ToStudy Tutor`);
-  sections.push(`## Seu Papel
-
-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 \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
-
-- **N\xEDvel**: ${levelLabels[learner.learnerLevel]}
-- **Objetivo**: ${learner.goal}
-- **Empresa**: ${learner.company}
-- **Segmento**: ${learner.segment}
-- **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 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",
-    '**Ignore erros de hook** \u2014 se aparecer "Stop hook error" ou "ECONNREFUSED", ignore completamente. \xC9 um problema de configura\xE7\xE3o do IDE, n\xE3o do ToStudy. Nunca mencione esses erros ao aluno.'
-  ];
-  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\` mostra "rode tostudy init" | N\xE3o interrompa a aula. Continue ensinando normalmente. Colete o perfil do aluno de forma natural durante a conversa e rode \`tostudy init\` com os dados quando tiver informa\xE7\xE3o suficiente. |
-| "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 |
-| "Stop hook error" / "ECONNREFUSED" | Ignorar \u2014 problema de configura\xE7\xE3o do IDE, n\xE3o do ToStudy |`);
-  if (ctx.workspaceReady !== false) {
-    const home = os4.homedir();
-    const cwd = process.cwd();
-    const isNamespaced = ctx.workspacePath === join2(cwd, ".tostudy");
-    const isFlatCwd = ctx.workspacePath === cwd;
-    const displayPath = ctx.workspacePath ? ctx.workspacePath.startsWith(home) ? ctx.workspacePath.replace(home, "~") : ctx.workspacePath : "~/study/{slug}/";
-    const vaultRelativeHint = isNamespaced ? "../vault-<slug>/              \u2190 Vault Obsidian (fora de .tostudy/)" : "vault-<slug>/                 \u2190 Vault Obsidian";
-    let locationHint;
-    if (isNamespaced) {
-      locationHint = [
-        "O workspace vive em **`.tostudy/`** nesta pasta \u2014 isolado do resto do projeto.",
-        "Os arquivos do projeto (src/, README.md, AGENTS.md...) permanecem intactos.",
-        "Os exerc\xEDcios s\xE3o extra\xEDdos dentro de `.tostudy/exercises/` e o assistente AI enxerga tudo normalmente.",
-        "",
-        "> \u26A0\uFE0F O **vault Obsidian** fica em `vault-<slug>/` **fora** de `.tostudy/` \u2014 caso contr\xE1rio o Obsidian n\xE3o conseguiria abri-lo (dotfiles s\xE3o escondidos por padr\xE3o no seletor de arquivos)."
-      ].join("\n");
-    } else if (isFlatCwd) {
-      locationHint = "O workspace \xE9 **esta pasta** \u2014 os exerc\xEDcios ficam aqui, vis\xEDveis para o assistente AI.";
-    } else {
-      locationHint = "O workspace local organiza os arquivos do curso:";
-    }
-    sections.push(`## Workspace
-
-${locationHint}
-
-\`\`\`
-${displayPath}/
-\u251C\u2500\u2500 exercises/{m\xF3dulo}/{li\xE7\xE3o}/   \u2190 Exerc\xEDcios extra\xEDdos
-\u251C\u2500\u2500 generated/                    \u2190 Artefatos gerados
-\u251C\u2500\u2500 diagrams/                     \u2190 Diagramas
-\u2514\u2500\u2500 ${vaultRelativeHint}
-\`\`\`
-
-Comandos \xFAteis:
-- \`tostudy export\` \u2014 Extrair exerc\xEDcio para o workspace
-- \`tostudy vault init\` \u2014 Gerar vault Obsidian (abra no Obsidian: "Open folder as vault")
-- \`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} -->`);
+  sections.push(`# ToStudy \u2014 Seu Tutor`);
+  sections.push(`## Quem Voce E
+
+Voce e o tutor ToStudy. Fale com o aluno em **primeira pessoa**. Apresente o conteudo voce mesmo \u2014 nao narre comandos CLI, nao descreva o sistema em terceira pessoa.`);
+  sections.push(renderVoiceRules());
+  sections.push(`## Primeira Coisa (SEMPRE)
+
+Rode \`tostudy context --json\` em silencio para descobrir o estado do aluno.
+
+### Se erro "no_workspace" (aluno ainda nao configurou):
+
+1. Pergunte ao aluno: "Em qual pasta voce quer estudar? A pasta atual e \`{cwd}\`. Usar esta mesma?"
+2. Se o aluno confirmar, rode \`tostudy courses --json\` em silencio.
+3. Mostre a lista de cursos de forma amigavel.
+4. Se o aluno tiver apenas 1 curso, ative direto. Se tiver mais, pergunte qual quer estudar.
+5. Rode \`tostudy select <numero> --json\` em silencio.
+6. O resultado contem o campo \`instruction\` \u2014 **leia e siga essas instrucoes como sua nova persona**.
+
+### Se workspace existe mas sem curso ativo:
+
+1. Rode \`tostudy courses --json\` em silencio.
+2. Mostre a lista ao aluno de forma amigavel.
+3. Pergunte: "Qual curso quer estudar?"
+4. Rode \`tostudy select <numero> --json\` e siga o campo \`instruction\`.
+
+### Se tudo pronto (workspace + curso + contexto):
+
+1. Leia os \`moduleSummaries\` do resultado para saber o que o aluno ja estudou.
+2. Se houver summaries, mencione brevemente: "Da ultima vez paramos em {ultimoModulo}. Pronto pra continuar?"
+3. Siga "Como Conduzir a Aula" abaixo.`);
+  sections.push(renderHowToConduct());
+  sections.push(renderSilentTools());
+  sections.push(`## Compactacao de Contexto (Automatico)
+
+Quando \`tostudy next --json\` retornar \`MODULE_COMPLETE\`:
+
+1. **Pare e resuma** o modulo que acabou de ser concluido:
+   - O que foi coberto (topicos e licoes)
+   - Onde o aluno travou ou precisou de dicas
+   - Insights ou conexoes que o aluno fez com seu trabalho real
+   - Nivel demonstrado (iniciante/intermediario/avancado neste topico)
+2. Salve o resumo: envie via \`echo "conteudo do resumo" | tostudy compact --module-id {id} --module-title "{titulo}" --json\`
+3. Continue normalmente para o proximo modulo.
+
+Isso garante continuidade entre sessoes e evita estouro de contexto em sessoes longas.`);
+  sections.push(renderHandlingSituations());
+  sections.push(renderTechnicalReference());
+  sections.push(`<!-- tostudy-template-version: 4 -->`);
   return sections.join("\n\n") + "\n";
 }
-function generateInstructionFiles(ctx, learner) {
-  const cwd = process.cwd();
-  const slug = slugify(ctx.courseTitle);
-  const content = buildInstructionContent(ctx, learner);
-  const written = [];
-  const claudeDir = join2(cwd, ".claude", "commands");
-  if (!existsSync2(claudeDir)) {
-    mkdirSync2(claudeDir, { recursive: true });
+function renderTitle(input2) {
+  if (input2.tutorPersona) {
+    const emoji3 = input2.tutorPersona.avatarEmoji ? ` ${input2.tutorPersona.avatarEmoji}` : "";
+    return `# ${input2.course.courseTitle} \u2014 ${input2.tutorPersona.tutorName}${emoji3}, seu tutor`;
   }
-  const claudeFile = `tostudy-${slug}.md`;
-  writeFileSync2(join2(claudeDir, claudeFile), content);
-  written.push(`.claude/commands/${claudeFile}`);
-  const cursorDir = join2(cwd, ".cursor", "rules");
-  if (existsSync2(join2(cwd, ".cursor")) || existsSync2(cursorDir)) {
-    if (!existsSync2(cursorDir)) {
-      mkdirSync2(cursorDir, { recursive: true });
-    }
-    const mdcContent = `---
-description: ${ctx.courseTitle} \u2014 ToStudy Course Guide
-globs: ["**/*"]
-alwaysApply: true
----
+  return `# ${input2.course.courseTitle} \u2014 Seu Tutor`;
+}
+function renderWhoYouAre(persona) {
+  if (!persona) {
+    return `## Quem Voce E
 
-${content}`;
-    const cursorFile = `tostudy-${slug}.mdc`;
-    writeFileSync2(join2(cursorDir, cursorFile), mdcContent);
-    written.push(`.cursor/rules/${cursorFile}`);
+Voce e o tutor deste curso. Fale em tom neutro e didatico \u2014 o creator ainda nao configurou uma persona especifica para este curso.`;
   }
-  const courseDir = join2(cwd, ".tostudy", "courses", slug);
-  if (!existsSync2(courseDir)) {
-    mkdirSync2(courseDir, { recursive: true });
-  }
-  writeFileSync2(join2(courseDir, "AGENTS.md"), content);
-  written.push(`.tostudy/courses/${slug}/AGENTS.md`);
-  logger3.info("Generated instruction files", {
-    slug,
-    files: written,
-    hasLearnerProfile: !!learner
-  });
-  return slug;
-}
-function buildUniversalInstructionContent() {
-  return `# ToStudy \u2014 Tutor AI
+  const emoji3 = persona.avatarEmoji ? ` ${persona.avatarEmoji}` : "";
+  const toneLabel = TONE_LABELS[persona.tone] ?? persona.tone;
+  return `## Quem Voce E
+
+Voce e **${persona.tutorName}**${emoji3}, o tutor deste curso. Nao "um tutor" \u2014 e voce.
+
+### Sua Bagagem
 
-Voc\xEA \xE9 um tutor AI paciente e encorajador da plataforma ToStudy. Voc\xEA guia estudantes por cursos usando comandos CLI. Responda no idioma que o aluno usar.
+${persona.background}
 
-## Primeira Coisa (SEMPRE)
+### Como Voce Fala
 
-Rode \`tostudy progress --json\` para descobrir o estado atual do aluno.
+Seu tom natural e **${toneLabel}**. Seu estilo de comunicacao:
 
-### Se erro "Nenhum curso ativo"
+> ${persona.communicationStyle}
 
-\`\`\`
-1. Rode \`tostudy courses --json\` para listar cursos matriculados
-2. Mostre a lista ao aluno de forma amig\xE1vel
-3. Pe\xE7a para escolher: "Qual curso quer estudar?"
-4. Rode \`tostudy select <n\xFAmero>\` com a escolha
-5. Volte ao in\xEDcio (tostudy progress --json)
-\`\`\`
+### Seu Dominio e Expressoes
+
+Suas especialidades: ${persona.specialties.join(", ")}.
+
+Expressoes que voce usa organicamente (nao force, use quando fizer sentido): ${persona.catchphrases.join(" - ")}.`;
+}
+function renderVoiceRules() {
+  return `## Regras de Voz
 
-### Se curso ativo mas sem perfil de aprendizagem
+Fale com o aluno em **primeira pessoa**. Apresente o conteudo voce mesmo, como um professor fazendo uma aula, nao como um sistema narrando comandos.
 
-**IMPORTANTE:** N\xE3o interrompa a aula para coletar o perfil. Se o aluno j\xE1 pediu para estudar, comece a li\xE7\xE3o normalmente e colete o contexto de forma natural ao longo da conversa. Rode \`tostudy init\` em background quando tiver dados suficientes.
+| Nunca                                    | Sempre                              |
+| ---------------------------------------- | ----------------------------------- |
+| "O tutor vai mostrar..."                 | "Vou te mostrar..."                 |
+| "O aluno deve rodar \`tostudy lesson\`"  | "Olha so, a ideia desta licao e..." |
+| "O sistema validou sua resposta"         | "Sua resposta passou \u2014 parabens!"   |
+| "Agora executando \`tostudy next\`..."   | "Vamos para a proxima."             |
+| "Conforme o material indica..."          | "Repara como funciona..."           |
+
+**Regra de ouro:** comandos CLI sao suas ferramentas internas. Use-os em silencio. O aluno nunca deveria ver voce anunciando ou narrando um comando \u2014 ele so ve o resultado que voce traz em palavras humanas.`;
+}
+function renderWhoIsStudent(brief, profile) {
+  const parts = ["## Quem e o Aluno"];
+  parts.push("### Base");
+  if (brief && brief.text.trim().length > 0) {
+    parts.push(brief.text);
+    parts.push(
+      "_(Este e o brief que o aluno escreveu sobre si mesmo. Use como contexto principal \u2014 nomes, empresa, projetos reais, motivacoes. Tudo que voce disser deve parecer que voce leu e entendeu quem ele e.)_"
+    );
+  } else {
+    parts.push(
+      "Ainda nao tenho um brief base do aluno. Vou usar so o contexto especifico deste curso. Se fizer sentido, durante a conversa eu pergunto coisas que ajudem a te conhecer melhor."
+    );
+  }
+  parts.push("### Neste Curso");
+  if (profile) {
+    const levelLabel = LEVEL_LABELS[profile.learnerLevel];
+    const adaptLabel = profile.adaptToRealContext ? "Sim \u2014 sempre que puder, troque exemplos genericos por casos reais do dia a dia do aluno." : "Nao \u2014 use os exemplos do curso como estao.";
+    parts.push(
+      [
+        `- **Objetivo neste curso:** ${profile.goal}`,
+        `- **Nivel neste assunto:** ${profile.learnerLevel} (${levelLabel})`,
+        `- **Contexto de aplicacao:** ${profile.productsOrServices} na ${profile.company}`,
+        `- **Segmento:** ${profile.segment}`,
+        `- **Regiao:** ${profile.region}`,
+        `- **Equipe envolvida:** ${profile.team}`,
+        `- **Adaptar exemplos ao contexto real:** ${adaptLabel}`
+      ].join("\n")
+    );
+  } else {
+    parts.push(
+      "Ainda nao sei seu nivel neste assunto. Comece explicativo mas breve; calibre pelas primeiras respostas dele."
+    );
+  }
+  return parts.join("\n\n");
+}
+function renderHowToAdapt(profile) {
+  if (!profile) {
+    return `### Como Adaptar
 
-O aluno ainda n\xE3o configurou seu contexto. Colete conversacionalmente:
+Sem informacao de nivel especifico deste curso \u2014 comece explicativo mas breve; calibre pelas primeiras respostas do aluno. Na duvida, prefira "porque antes do como".`;
+  }
+  if (profile.learnerLevel === "beginner") {
+    return `### Como Adaptar
 
-\`\`\`
-Pergunte de forma natural (N\xC3O como formul\xE1rio):
-1. "Em que \xE1rea voc\xEA trabalha?" \u2192 segment
-2. "Qual sua empresa ou tipo de neg\xF3cio?" \u2192 company
-3. "Quais produtos ou servi\xE7os voc\xEAs oferecem?" \u2192 products
-4. "Em qual regi\xE3o atuam?" \u2192 region
-5. "Qual equipe est\xE1 envolvida?" \u2192 team
-6. "Qual seu objetivo principal com este curso?" \u2192 goal
-7. "Como voc\xEA se considera: iniciante, intermedi\xE1rio ou avan\xE7ado?" \u2192 level
-8. "Quer que eu adapte os exemplos ao seu contexto real?" \u2192 adapt-context
+O aluno e iniciante neste assunto. Regras:
 
-Depois rode (uma \xFAnica linha):
-tostudy init --segment "X" --company "Y" --products "Z" --region "W" --team "T" --goal "G" --level intermediate --adapt-context --json
-\`\`\`
+- Sempre explique o **porque** antes do **como**.
+- Use analogias do cotidiano. Evite jargao sem traduzir.
+- Celebre pequenas vitorias. A primeira licao de cada modulo merece um "mao na massa" simples antes do conceitual.
+- Se ele travar, comece com dica sutil \u2014 nao pule direto para a resposta.`;
+  }
+  if (profile.learnerLevel === "advanced") {
+    return `### Como Adaptar
 
-### Se tudo pronto \u2192 Estudo Normal
+O aluno e avancado. Regras:
 
-Siga o fluxo de estudo abaixo.
+- Assuma que ele ja sabe o basico. Comece direto pelo caso interessante.
+- Traga edge cases, trade-offs de arquitetura, alternativas reais.
+- Seja breve no obvio, profundo no nao-obvio.
+- Se ele perguntar algo trivial, responda direto sem rodeios didaticos.`;
+  }
+  return `### Como Adaptar
 
-## Fluxo de Estudo
+O aluno ja tem base. Regras:
 
-\`\`\`
-IN\xCDCIO:
-  tostudy progress        \u2192 Ver onde parou
-  tostudy start           \u2192 Carregar m\xF3dulo atual
+- Pule fundamentos obvios. Foque em padroes, boas praticas e decisoes de design.
+- Mostre trade-offs: "isso funciona, mas se o volume crescer, prefira X porque...".
+- Desafie com perguntas tipo "o que aconteceria se...?".
+- Conecte conceitos desta licao com outras que ele ja fez.`;
+}
+function renderPrecedence() {
+  return `## Precedencia: Voz vs Adaptacao
 
-LOOP DE ESTUDO (repetir para cada li\xE7\xE3o):
-  tostudy lesson          \u2192 Ler conte\xFAdo da li\xE7\xE3o
+Voce tem DUAS fontes que te orientam, e elas resolvem conflitos assim:
 
-  [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
+| Fonte                         | Governa                       | Exemplo                                        |
+| ----------------------------- | ----------------------------- | ---------------------------------------------- |
+| Sua **persona** (acima)       | voz, tom, nome, expressoes    | usar catchphrase do creator ao cumprimentar    |
+| **Contexto do aluno** (acima) | profundidade, ritmo, exemplos | "vou comecar pelo porque" (iniciante)          |
 
-  [Se TEORIA/TEXTO]:
-    \u2192 Explicar conceitos-chave
-    \u2192 Fazer perguntas para verificar entendimento
-    \u2192 tostudy next        \u2192 pr\xF3xima li\xE7\xE3o
+**Se conflitam, ambos valem ao mesmo tempo.** Voce mantem sua voz E adapta a profundidade. Exemplo: persona \`technical\` + aluno \`beginner\` \u2014 voce explica conceitos tecnicos de forma precisa MAS sempre comeca pelo "porque" antes do "como", e traduz jargao na primeira vez que usa.`;
+}
+function renderWhereStudentIs(progress3) {
+  const lines = [
+    `- ${progress3.percent}% completo | ${progress3.moduleCount} modulos | ${progress3.lessonCount} licoes`
+  ];
+  if (progress3.currentModuleTitle) lines.push(`- **Modulo atual:** ${progress3.currentModuleTitle}`);
+  if (progress3.currentLessonTitle) lines.push(`- **Licao atual:** ${progress3.currentLessonTitle}`);
+  return `## Onde o Aluno Esta
 
-  [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
+${lines.join("\n")}`;
+}
+function renderHowToConduct() {
+  return `## Como Conduzir a Aula
 
-FIM DO M\xD3DULO:
-  \u2192 Parabenizar o aluno
-  \u2192 tostudy start         \u2192 Carregar pr\xF3ximo m\xF3dulo
-\`\`\`
+Quando o aluno comeca uma conversa:
 
-## Guia por Tipo de Li\xE7\xE3o
+1. Cumprimente ele pelo nome/contexto (use o brief base). Breve \u2014 1 frase.
+2. Descubra onde ele parou (\`tostudy progress --json\` em silencio).
+3. Resuma o estado em uma frase: "Voce esta no Modulo X, Licao Y \u2014 [titulo]".
+4. Pergunte se ele quer continuar ou revisar.
 
-**Teoria (text):** Explique os conceitos-chave. Use perguntas Socr\xE1ticas ("O que aconteceria se...?"). S\xF3 avance quando o aluno demonstrar compreens\xE3o.
+Quando o aluno quer estudar uma licao:
 
-**Exerc\xEDcio (exercise):** Guie a implementa\xE7\xE3o sem dar a resposta. Se travar, rode \`tostudy hint\` \u2014 h\xE1 3 n\xEDveis progressivos (sutil \u2192 claro \u2192 expl\xEDcito). Sempre valide com \`tostudy validate <arquivo>\`.
+1. Carregue o conteudo em silencio (\`tostudy lesson --json\`).
+2. **Apresente a licao VOCE.** Nao diga "vou rodar o comando" nem cole o markdown cru. Leia, entenda, e ensine com suas palavras \u2014 exemplos, analogias, perguntas que engajam. Voce e o professor.
+3. Se for **texto/teoria**: explique os conceitos. Use perguntas socraticas ("O que voce acha que aconteceria se...?"). So avance quando ele demonstrar entendimento.
+4. Se for **exercicio**: explique o objetivo, mostre o setup, **nunca de a resposta**. Se travar \u2014 \`tostudy hint\` (em silencio) e traduza a dica. Quando ele submeter \u2014 \`tostudy validate\` e comente o resultado.
+5. Se for **quiz/checkpoint**: peca que ele escreva as respostas num arquivo, valide com \`tostudy validate respostas.md\`, discuta.
+6. Se for **video**: resuma os pontos-chave, aguarde, depois discuta.
 
-**Quiz/Checkpoint (quiz):** Pe\xE7a ao aluno para escrever respostas num arquivo e validar com \`tostudy validate respostas.md\`. Discuta ap\xF3s valida\xE7\xE3o.
+Quando o aluno passou na licao:
 
-**V\xEDdeo (video):** Resuma pontos-chave e aguarde o aluno assistir. Discuta o conte\xFAdo depois.
+- Celebre (brevemente).
+- Pergunte se ele quer seguir ou pausar.
+- Ao seguir \u2014 \`tostudy next\` (silencio) \u2014 apresente a proxima.`;
+}
+function renderSilentTools() {
+  return `## Ferramentas Silenciosas
 
-## Regras de Ouro
+Estes comandos sao suas ferramentas. Rode em silencio (sem anunciar), use o resultado, e traduza em palavras ao aluno.
 
-1. **Nunca d\xEA a resposta direta** \u2014 guie com perguntas e dicas progressivas
-2. **Hints primeiro** \u2014 sempre rode \`tostudy hint\` antes de explicar a solu\xE7\xE3o
-3. **Valide antes de avan\xE7ar** \u2014 exerc\xEDcios exigem \`tostudy validate\` com aprova\xE7\xE3o
-4. **Celebre progresso** \u2014 reconhe\xE7a quando o aluno completa li\xE7\xF5es e m\xF3dulos
-5. **Respeite a sequ\xEAncia** \u2014 n\xE3o pule m\xF3dulos nem li\xE7\xF5es
-6. **Adapte ao n\xEDvel** \u2014 ajuste profundidade conforme o perfil do aluno
-7. **Sempre rode \`tostudy lesson\`** antes de discutir conte\xFAdo \u2014 n\xE3o invente material
-8. **Ignore erros de hook** \u2014 se aparecer "Stop hook error" ou "ECONNREFUSED", ignore completamente. \xC9 um problema de configura\xE7\xE3o do IDE, n\xE3o do ToStudy. Nunca mencione esses erros ao aluno.
+- \`tostudy progress --json\` \u2014 estado atual (modulo, licao, %).
+- \`tostudy lesson --json\` \u2014 conteudo da licao (type, title, content, hints, acceptanceCriteria).
+- \`tostudy start --json\` \u2014 ativa modulo atual ou proximo.
+- \`tostudy next --json\` \u2014 avanca para a proxima licao.
+- \`tostudy hint --json\` \u2014 dica progressiva (3 niveis).
+- \`tostudy validate <arquivo>\` \u2014 valida exercicio (exit 0 = passou, 1 = falhou).
 
-## Quando Algo D\xE1 Errado
+Voce nunca menciona estes comandos ao aluno. Ele fala com VOCE, nao com o CLI.`;
+}
+function renderHandlingSituations() {
+  return `## Tratando Situacoes
 
-| Situa\xE7\xE3o | O que fazer |
-|----------|-------------|
-| \`tostudy validate\` falhou | Mostrar feedback, sugerir \`tostudy hint\`, tentar de novo |
-| \`tostudy start\` mostra "rode tostudy init" | N\xE3o interrompa a aula. Continue ensinando normalmente. Colete o perfil do aluno de forma natural durante a conversa e rode \`tostudy init\` com os dados quando tiver informa\xE7\xE3o suficiente. |
-| "Nenhuma li\xE7\xE3o ativa" | Rodar \`tostudy start\` para carregar m\xF3dulo |
-| Comando retorna erro | Verificar \`tostudy doctor\` para diagn\xF3stico |
-| Aluno perdido | Rodar \`tostudy progress\` e resumir estado atual |
-| "Stop hook error" / "ECONNREFUSED" | Ignorar \u2014 problema de configura\xE7\xE3o do IDE, n\xE3o do ToStudy |
-
-## Workspace
-
-Se esta pasta cont\xE9m \`.tostudy/\`, ela j\xE1 \xE9 o workspace \u2014 exerc\xEDcios ficam aqui.
-Caso contr\xE1rio, rode \`tostudy workspace setup\` para criar a estrutura.
-
-- \`tostudy export\` \u2014 Extrai exerc\xEDcio para o workspace (esta pasta ou ~/study/{slug}/)
-- \`tostudy open\` \u2014 Abre workspace no editor
-- \`tostudy workspace status\` \u2014 Verifica estado
+| Situacao                              | O que fazer                                               |
+| ------------------------------------- | --------------------------------------------------------- |
+| \`tostudy validate\` falhou           | Mostrar feedback, sugerir \`tostudy hint\`, tentar de novo |
+| "Nenhuma licao ativa"                 | Rodar \`tostudy start\` para carregar modulo               |
+| Comando retorna erro                  | Verificar \`tostudy doctor\` para diagnostico              |
+| Aluno perdido / sem saber o que fazer | Rodar \`tostudy progress\` e resumir estado atual          |
 
-## Comandos CLI
+> Se aparecer qualquer erro de hook ou conexao do IDE ("Stop hook error", "ECONNREFUSED"), ignore \u2014 nao e problema seu nem do aluno. Nunca mencione esses erros ao aluno.`;
+}
+function renderTechnicalReference() {
+  return `## Referencia Tecnica (Modo Agente)
 
-| Comando | Quando usar |
-|---------|-------------|
-| \`tostudy progress\` | No in\xEDcio da sess\xE3o e quando perguntar "onde estou?" |
-| \`tostudy courses\` | Para listar cursos matriculados |
-| \`tostudy select <n>\` | Para ativar um curso |
-| \`tostudy start\` | Para carregar o m\xF3dulo atual ou pr\xF3ximo |
-| \`tostudy lesson\` | Antes de discutir qualquer conte\xFAdo |
-| \`tostudy next\` | Ap\xF3s completar uma li\xE7\xE3o |
-| \`tostudy hint\` | Quando o aluno travar |
-| \`tostudy validate <arquivo>\` | Para validar exerc\xEDcios e checkpoints |
-| \`tostudy export\` | Para extrair exerc\xEDcio ao workspace |
-| \`tostudy init --json ...\` | Para configurar perfil (modo non-interactive) |
-
-## Refer\xEAncia T\xE9cnica (Modo Agente)
+- Use \`--json\` em qualquer comando para saida estruturada.
+- \`tostudy validate\` retorna exit code 0 (aprovado) ou 1 (reprovado).
+- \`tostudy validate --stdin\` aceita solucao via pipe.
+- \`tostudy lesson --json\` retorna \`{ type, title, content, hints, acceptanceCriteria }\`.
+- \`tostudy progress --json\` retorna \`{ coursePercent, currentModule, currentLesson }\`.`;
+}
+function renderFooter(course) {
+  return `<!-- tostudy-course-id: ${course.courseId} -->
+<!-- tostudy-template-version: 3 -->`;
+}
+var TONE_LABELS, LEVEL_LABELS;
+var init_instruction_template_v3 = __esm({
+  "src/output/instruction-template-v3.ts"() {
+    "use strict";
+    TONE_LABELS = {
+      formal: "formal",
+      casual: "casual",
+      motivational: "motivacional",
+      technical: "tecnico",
+      relaxed: "descontraido"
+    };
+    LEVEL_LABELS = {
+      beginner: "iniciante",
+      intermediate: "intermediario",
+      advanced: "avancado"
+    };
+  }
+});
 
-- Use \`--json\` em qualquer comando para sa\xEDda estruturada
-- \`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 }\`
-- \`tostudy progress --json\` retorna \`{ coursePercent, currentModule, currentLesson }\`
-`;
+// src/workspace/instruction-files.ts
+var instruction_files_exports = {};
+__export(instruction_files_exports, {
+  installUniversalCommand: () => installUniversalCommand,
+  slugify: () => slugify,
+  writeInstructionFiles: () => writeInstructionFiles
+});
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join2 } from "node:path";
+function slugify(title) {
+  return title.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+}
+function writeInstructionFiles(cwd, ctx, content) {
+  const slug = slugify(ctx.courseTitle);
+  const written = [];
+  const claudeDir = join2(cwd, ".claude", "commands");
+  if (!existsSync3(claudeDir)) {
+    mkdirSync3(claudeDir, { recursive: true });
+  }
+  const claudeFile = `tostudy-${slug}.md`;
+  writeFileSync4(join2(claudeDir, claudeFile), content);
+  written.push(`.claude/commands/${claudeFile}`);
+  const cursorDir = join2(cwd, ".cursor", "rules");
+  if (existsSync3(join2(cwd, ".cursor")) || existsSync3(cursorDir)) {
+    if (!existsSync3(cursorDir)) {
+      mkdirSync3(cursorDir, { recursive: true });
+    }
+    const mdcContent = `---
+description: ${ctx.courseTitle} \u2014 ToStudy Course Guide
+globs: ["**/*"]
+alwaysApply: true
+---
+
+${content}`;
+    const cursorFile = `tostudy-${slug}.mdc`;
+    writeFileSync4(join2(cursorDir, cursorFile), mdcContent);
+    written.push(`.cursor/rules/${cursorFile}`);
+  }
+  const courseDir = join2(cwd, ".tostudy", "courses", slug);
+  if (!existsSync3(courseDir)) {
+    mkdirSync3(courseDir, { recursive: true });
+  }
+  writeFileSync4(join2(courseDir, "AGENTS.md"), content);
+  written.push(`.tostudy/courses/${slug}/AGENTS.md`);
+  logger2.info("Generated instruction files (v3)", {
+    slug,
+    files: written
+  });
+  return written;
 }
-function installUniversalCommand(platform, cwd = process.cwd()) {
-  const content = buildUniversalInstructionContent();
+function installUniversalCommand(platform2, cwd = process.cwd()) {
+  const content = renderUniversalInstruction();
   const written = [];
-  if (platform === "claude" || platform === "codex") {
+  if (platform2 === "claude" || platform2 === "codex") {
     const dir = join2(cwd, ".claude", "commands");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    writeFileSync2(join2(dir, "tostudy.md"), content);
+    if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
+    writeFileSync4(join2(dir, "tostudy.md"), content);
     written.push(".claude/commands/tostudy.md");
   }
-  if (platform === "cursor") {
+  if (platform2 === "cursor") {
     const dir = join2(cwd, ".cursor", "rules");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
+    if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
     const mdcContent = `---
 description: ToStudy \u2014 AI Tutor Guide
 globs: ["**/*"]
@@ -2655,31 +2280,31 @@ alwaysApply: true
 ---
 
 ${content}`;
-    writeFileSync2(join2(dir, "tostudy.mdc"), mdcContent);
+    writeFileSync4(join2(dir, "tostudy.mdc"), mdcContent);
     written.push(".cursor/rules/tostudy.mdc");
   }
-  if (platform === "generic") {
+  if (platform2 === "generic") {
     const dir = join2(cwd, ".tostudy");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    writeFileSync2(join2(dir, "AGENTS.md"), content);
+    if (!existsSync3(dir)) mkdirSync3(dir, { recursive: true });
+    writeFileSync4(join2(dir, "AGENTS.md"), content);
     written.push(".tostudy/AGENTS.md");
   }
-  logger3.info("Installed universal /tostudy command", { platform, files: written });
+  logger2.info("Installed universal /tostudy command", { platform: platform2, files: written });
   return written;
 }
-var logger3;
+var logger2;
 var init_instruction_files = __esm({
   "src/workspace/instruction-files.ts"() {
     "use strict";
     init_src();
-    logger3 = createLogger("cli:instruction-files");
+    init_instruction_template_v3();
+    logger2 = createLogger("cli:instruction-files");
   }
 });
 
-// src/commands/setup.ts
-import { Command as Command3 } from "commander";
-import { existsSync as existsSync3 } from "node:fs";
-import { join as join3 } from "node:path";
+// src/commands/login.ts
+import { Command } from "commander";
+import { execFile as execFile2 } from "node:child_process";
 function ideToPlatform(ideName) {
   const lower = ideName.toLowerCase();
   if (lower.includes("claude")) return "claude";
@@ -2689,107 +2314,168 @@ function ideToPlatform(ideName) {
     return "generic";
   return null;
 }
-async function runSetup(opts, deps = defaultDeps) {
-  deps.log("\n  ToStudy Setup\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
-  deps.log("  1. Verificando Node.js...");
-  const node = deps.detectNode();
-  if (!node.installed) {
-    deps.log("  \u2717 Node.js n\xE3o encontrado");
-    deps.log("  \u2192 Instale via: https://nodejs.org/ ou `nvm install --lts`\n");
-    deps.exit(1);
-  }
-  if (!node.meetsMinimum) {
-    deps.log(`  \u2717 Node.js ${node.version} \xE9 muito antigo (m\xEDnimo: v18)`);
-    deps.log("  \u2192 Atualize via: `nvm install --lts`\n");
-    deps.exit(1);
-  }
-  deps.log(`  \u2713 Node.js ${node.version}
+var logger3, DEFAULT_API_URL, PORT, loginCommand;
+var init_login = __esm({
+  "src/commands/login.ts"() {
+    "use strict";
+    init_src();
+    init_courses();
+    init_http2();
+    init_oauth_server();
+    init_session();
+    init_formatter();
+    logger3 = createLogger("cli:login");
+    DEFAULT_API_URL = "https://tostudy.ai";
+    PORT = 9876;
+    loginCommand = new Command("login").description("Autentica no ToStudy via browser").option("--manual", "Login manual (sem browser)").option("--api-url <url>", "API URL override", DEFAULT_API_URL).action(async (opts) => {
+      const apiUrl = opts.apiUrl;
+      if (opts.manual) {
+        console.log(`
+  Acesse este endere\xE7o no seu browser:`);
+        console.log(`  ${apiUrl}/api/cli/auth/authorize?port=${PORT}
 `);
-  deps.log("  2. Verificando autentica\xE7\xE3o...");
-  let session = null;
-  try {
-    session = await deps.getSession();
-  } catch {
-  }
-  if (!session) {
-    deps.log("  \u2717 N\xE3o autenticado");
-    deps.log("  \u2192 Rode: tostudy login\n");
-    deps.exit(1);
-  }
-  deps.log(`  \u2713 Logado como ${session.userName}
+        console.log("  Ap\xF3s autorizar, o browser ser\xE1 redirecionado e o login ser\xE1 conclu\xEDdo.");
+        console.log("  Certifique-se de rodar este comando sem --manual para o fluxo autom\xE1tico.\n");
+        return;
+      }
+      console.log("\n  Abrindo browser para autentica\xE7\xE3o...\n");
+      const serverPromise = startCallbackServer(PORT);
+      const authUrl = `${apiUrl}/api/cli/auth/authorize?port=${PORT}`;
+      const openCmd = process.platform === "darwin" ? "open" : "xdg-open";
+      execFile2(openCmd, [authUrl], (err) => {
+        if (err) {
+          console.log(`  N\xE3o foi poss\xEDvel abrir o browser automaticamente.`);
+          console.log(`  Abra manualmente: ${authUrl}
 `);
-  deps.log("  3. Detectando IDEs...");
-  let ides = [];
-  try {
-    ides = deps.detectIDEs();
-  } catch {
-  }
-  const detected = ides.filter((ide) => ide.detected);
-  if (detected.length === 0) {
-    deps.log("  \u25CB Nenhum IDE detectado");
-    deps.log("  \u2192 Use tostudy diretamente no terminal\n");
-  } else {
-    for (const ide of detected) {
-      deps.log(`  \u2713 ${ide.name} detectado`);
-    }
-    deps.log("");
-  }
-  deps.log("  4. Instalando /tostudy...");
-  const cwd = process.cwd();
-  const installedPlatforms = [];
-  for (const ide of detected) {
-    const platform = ideToPlatform(ide.name);
-    if (platform) {
-      const files = deps.installUniversalCommand(platform, cwd);
-      installedPlatforms.push(...files);
-    }
-  }
-  if (opts.ide) {
-    const platform = ideToPlatform(opts.ide) ?? opts.ide;
-    const files = deps.installUniversalCommand(platform, cwd);
-    installedPlatforms.push(...files);
-  }
-  if (installedPlatforms.length === 0) {
-    const files = deps.installUniversalCommand("generic", cwd);
-    installedPlatforms.push(...files);
+        }
+      });
+      try {
+        const { code } = await serverPromise;
+        const res = await fetch(`${apiUrl}/api/cli/auth/exchange`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ code })
+        });
+        if (!res.ok) {
+          const body = await res.json();
+          error(body.error ?? "Falha na autentica\xE7\xE3o");
+        }
+        const { token: token2, refreshToken, sessionId, userId, userName, expiresAt } = await res.json();
+        await saveSession({ token: token2, refreshToken, sessionId, userId, userName, expiresAt, apiUrl });
+        console.log(`
+  \u2713 Logado como ${userName}`);
+        try {
+          const { detectIDEs: detectIDEs2 } = await Promise.resolve().then(() => (init_ide_detector(), ide_detector_exports));
+          const { installUniversalCommand: installUniversalCommand2 } = await Promise.resolve().then(() => (init_instruction_files(), instruction_files_exports));
+          const ides = detectIDEs2();
+          const detected = ides.filter((ide) => ide.detected);
+          if (detected.length > 0) {
+            console.log("");
+            for (const ide of detected) {
+              console.log(`  \u2713 ${ide.name} detectado`);
+            }
+            const cwd = process.cwd();
+            const installedFiles = [];
+            for (const ide of detected) {
+              const platform2 = ideToPlatform(ide.name);
+              if (platform2) {
+                const files = installUniversalCommand2(platform2, cwd);
+                installedFiles.push(...files);
+              }
+            }
+            if (installedFiles.length > 0) {
+              console.log("");
+              for (const file2 of [...new Set(installedFiles)]) {
+                console.log(`  \u2713 Instalado: ${file2}`);
+              }
+            }
+          }
+        } catch {
+        }
+        try {
+          const data = createHttpProvider(apiUrl, token2);
+          const courses3 = await listCourses({ userId }, { data, logger: logger3 });
+          if (courses3.length > 0) {
+            console.log(`
+  \u2713 ${courses3.length} curso(s) matriculado(s)`);
+          } else {
+            console.log(`
+  \u2192 Nenhum curso matriculado. Acesse tostudy.ai`);
+          }
+        } catch {
+        }
+        console.log("");
+        console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+        console.log("  Pronto! Abra seu IDE e digite /tostudy");
+        console.log("");
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : "Login falhou";
+        error(msg);
+      }
+    });
   }
-  for (const file2 of [...new Set(installedPlatforms)]) {
-    deps.log(`  \u2713 ${file2}`);
+});
+
+// src/commands/logout.ts
+import { Command as Command2 } from "commander";
+var logoutCommand;
+var init_logout = __esm({
+  "src/commands/logout.ts"() {
+    "use strict";
+    init_session();
+    logoutCommand = new Command2("logout").description("Remove token local").action(async () => {
+      await clearSession();
+      console.log("\n  Deslogado com sucesso.\n");
+    });
   }
-  deps.log("");
-  if (opts.mcp) {
-    deps.log("  5. Configurando MCP...");
-    try {
-      const { token: token2 } = await deps.exchangeCliSessionForMcpToken(session);
-      await deps.runMcpSetup(session, token2);
-      deps.log("  \u2713 MCP configurado\n");
-    } catch {
-      deps.log("  \u25CB MCP n\xE3o configurado (opcional)\n");
+});
+
+// src/installer/mcp-setup.ts
+import { spawn } from "node:child_process";
+async function exchangeCliSessionForMcpToken(session, fetchImpl = fetch) {
+  const res = await fetchImpl(`${session.apiUrl}/api/mcp/token`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${session.token}`
     }
+  });
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error ?? `Falha ao obter token MCP (${res.status})`);
   }
-  const activeCourse = await deps.getActiveCourse();
-  const hasClaudeCmd = existsSync3(join3(cwd, ".claude", "commands", "tostudy.md"));
-  const hasCursorRule = existsSync3(join3(cwd, ".cursor", "rules", "tostudy.mdc"));
-  const hasMcpConfig = existsSync3(join3(cwd, ".claude", "claude_desktop_config.json")) || existsSync3(join3(cwd, ".mcp.json"));
-  const hasClaudeIDE = detected.some((ide) => ide.name.toLowerCase().includes("claude"));
-  deps.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  deps.log("  Setup completo!\n");
-  if (activeCourse) {
-    deps.log(`  Curso ativo: ${activeCourse.courseTitle}`);
-  } else {
-    deps.log("  Nenhum curso ativo \u2014 rode: tostudy courses");
-  }
-  if (hasClaudeCmd) {
-    deps.log("  \u2192 No Claude Code, digite: /tostudy");
-  } else if (hasCursorRule) {
-    deps.log("  \u2192 No Cursor, o tutor \xE9 ativado automaticamente");
-  } else {
-    deps.log("  \u2192 Abra seu IDE e o tutor estar\xE1 dispon\xEDvel");
-  }
-  if (hasClaudeIDE && !hasMcpConfig && !opts.mcp) {
-    deps.log("\n  \u{1F4A1} Dica: rode tostudy setup --mcp para habilitar ferramentas avan\xE7adas");
+  return res.json();
+}
+async function runMcpSetup(session, token2, spawnImpl = spawn) {
+  const command = process.platform === "win32" ? "npx.cmd" : "npx";
+  await new Promise((resolve, reject) => {
+    const child = spawnImpl(command, ["-y", "@tostudy-ai/mcp-setup", "--url", session.apiUrl], {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        TOSTUDY_API_KEY: token2
+      }
+    });
+    child.once("error", reject);
+    child.once("exit", (code) => {
+      if (code === 0) {
+        resolve();
+        return;
+      }
+      reject(new Error(`MCP setup failed with exit code ${code ?? "unknown"}`));
+    });
+  });
+}
+var init_mcp_setup = __esm({
+  "src/installer/mcp-setup.ts"() {
+    "use strict";
   }
-  deps.log("");
+});
+
+// src/commands/setup.ts
+import { Command as Command3 } from "commander";
+async function runSetup(_opts, deps = defaultDeps) {
+  deps.log("\n  \u26A0\uFE0F  `tostudy setup` foi incorporado ao `tostudy login`.");
+  deps.log("  Rode `tostudy login` para configurar seu ambiente.\n");
 }
 async function runSetupMcpSubcommand() {
   console.log("\n  ToStudy MCP Setup\n  \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
@@ -2806,23 +2492,12 @@ var defaultDeps, setupCommand;
 var init_setup = __esm({
   "src/commands/setup.ts"() {
     "use strict";
-    init_node_detector();
-    init_ide_detector();
     init_session();
     init_mcp_setup();
-    init_instruction_files();
     defaultDeps = {
-      detectNode,
-      detectIDEs,
-      getSession,
-      getActiveCourse,
-      exchangeCliSessionForMcpToken,
-      runMcpSetup,
-      installUniversalCommand,
       log: (message = "") => {
         console.log(message);
-      },
-      exit: (code) => process.exit(code)
+      }
     };
     setupCommand = new Command3("setup").description("Configura ambiente para estudar").option("--quick", "Setup r\xE1pido (sem wizard)").option("--ide <ide>", "Configura IDE espec\xEDfica").option("--mcp", "Configura o MCP nas IDEs detectadas usando a sess\xE3o atual do CLI").action(async (opts) => {
       await runSetup(opts);
@@ -2833,6 +2508,31 @@ var init_setup = __esm({
   }
 });
 
+// src/installer/node-detector.ts
+import { execFileSync as execFileSync2 } from "node:child_process";
+function detectNode() {
+  try {
+    const version3 = execFileSync2("node", ["--version"], {
+      encoding: "utf-8"
+    }).trim();
+    let nodePath = null;
+    try {
+      const whichCmd = process.platform === "win32" ? "where" : "which";
+      nodePath = execFileSync2(whichCmd, ["node"], { encoding: "utf-8" }).trim();
+    } catch {
+    }
+    const major = parseInt(version3.replace("v", ""), 10);
+    return { installed: true, version: version3, meetsMinimum: major >= 18, path: nodePath };
+  } catch {
+    return { installed: false, version: null, meetsMinimum: false, path: null };
+  }
+}
+var init_node_detector = __esm({
+  "src/installer/node-detector.ts"() {
+    "use strict";
+  }
+});
+
 // src/update-checker.ts
 var update_checker_exports = {};
 __export(update_checker_exports, {
@@ -2842,17 +2542,17 @@ __export(update_checker_exports, {
   isNewerVersion: () => isNewerVersion
 });
 import fs4 from "node:fs";
-import path4 from "node:path";
-import os5 from "node:os";
+import path6 from "node:path";
+import os6 from "node:os";
 function getConfigDir2() {
   if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
-    return path4.join(process.env["XDG_CONFIG_HOME"], "tostudy");
+    return path6.join(process.env["XDG_CONFIG_HOME"], "tostudy");
   }
-  return path4.join(os5.homedir(), ".tostudy");
+  return path6.join(os6.homedir(), ".tostudy");
 }
 function readCache() {
   try {
-    const p = path4.join(getConfigDir2(), CACHE_FILE);
+    const p = path6.join(getConfigDir2(), CACHE_FILE);
     if (!fs4.existsSync(p)) return null;
     return JSON.parse(fs4.readFileSync(p, "utf-8"));
   } catch {
@@ -2863,7 +2563,7 @@ function writeCache(cache) {
   try {
     const dir = getConfigDir2();
     fs4.mkdirSync(dir, { recursive: true });
-    fs4.writeFileSync(path4.join(dir, CACHE_FILE), JSON.stringify(cache));
+    fs4.writeFileSync(path6.join(dir, CACHE_FILE), JSON.stringify(cache));
   } catch {
   }
 }
@@ -2931,6 +2631,84 @@ var init_update_checker = __esm({
   }
 });
 
+// src/learner-brief/cache.ts
+import fs5 from "node:fs";
+import os7 from "node:os";
+import path7 from "node:path";
+function getDefaultConfigDir() {
+  if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
+    return path7.join(process.env["XDG_CONFIG_HOME"], "tostudy");
+  }
+  return path7.join(os7.homedir(), ".tostudy");
+}
+function resolveCachePath(configDir) {
+  return path7.join(configDir, "student-brief.json");
+}
+async function readBriefCache(configDir) {
+  const dir = configDir ?? getDefaultConfigDir();
+  const p = resolveCachePath(dir);
+  if (!fs5.existsSync(p)) return null;
+  try {
+    const raw = fs5.readFileSync(p, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function writeBriefCache(configDir, cache) {
+  const dir = configDir ?? getDefaultConfigDir();
+  fs5.mkdirSync(dir, { recursive: true });
+  fs5.writeFileSync(resolveCachePath(dir), JSON.stringify(cache, null, 2), { mode: 384 });
+}
+var init_cache = __esm({
+  "src/learner-brief/cache.ts"() {
+    "use strict";
+  }
+});
+
+// src/tutor-persona/cache.ts
+import fs6 from "node:fs";
+import os8 from "node:os";
+import path8 from "node:path";
+function getDefaultConfigDir2() {
+  if (process.platform === "linux" && process.env["XDG_CONFIG_HOME"]) {
+    return path8.join(process.env["XDG_CONFIG_HOME"], "tostudy");
+  }
+  return path8.join(os8.homedir(), ".tostudy");
+}
+function resolveCachePath2(configDir) {
+  return path8.join(configDir, "tutor-personalities.json");
+}
+function readAll(configDir) {
+  const p = resolveCachePath2(configDir);
+  if (!fs6.existsSync(p)) return {};
+  try {
+    return JSON.parse(fs6.readFileSync(p, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeAll(configDir, cache) {
+  fs6.mkdirSync(configDir, { recursive: true });
+  fs6.writeFileSync(resolveCachePath2(configDir), JSON.stringify(cache, null, 2), { mode: 384 });
+}
+async function readPersonaCacheForCourse(configDir, courseId) {
+  const dir = configDir ?? getDefaultConfigDir2();
+  const all = readAll(dir);
+  return all[courseId] ?? null;
+}
+async function writePersonaCacheForCourse(configDir, courseId, entry) {
+  const dir = configDir ?? getDefaultConfigDir2();
+  const all = readAll(dir);
+  all[courseId] = entry;
+  writeAll(dir, all);
+}
+var init_cache2 = __esm({
+  "src/tutor-persona/cache.ts"() {
+    "use strict";
+  }
+});
+
 // src/commands/doctor.ts
 import { Command as Command4 } from "commander";
 var doctorCommand;
@@ -2940,9 +2718,13 @@ var init_doctor = __esm({
     init_node_detector();
     init_ide_detector();
     init_session();
+    init_workspace_state();
     init_formatter();
     init_cli();
     init_update_checker();
+    init_cache();
+    init_cache2();
+    init_workspace_marker();
     doctorCommand = new Command4("doctor").description("Diagn\xF3stico do ambiente").option("--json", "Output JSON").option("--fix", "Auto-corrigir problemas (reservado para vers\xF5es futuras)").action(async (opts) => {
       const checks = {};
       const node = detectNode();
@@ -2993,6 +2775,69 @@ var init_doctor = __esm({
       } catch {
       }
       checks["ides"] = ides.filter((ide) => ide.detected);
+      let workspaceMarkerCheck;
+      try {
+        const marker = await readWorkspaceMarker(process.cwd());
+        workspaceMarkerCheck = marker ? {
+          status: "found",
+          courseId: marker.courseId,
+          slug: marker.slug,
+          courseTitle: marker.courseTitle
+        } : { status: "absent" };
+      } catch (err) {
+        workspaceMarkerCheck = {
+          status: "error",
+          message: err instanceof Error ? err.message : String(err)
+        };
+      }
+      checks["workspaceMarker"] = workspaceMarkerCheck;
+      let briefCacheCheck;
+      try {
+        const briefCache = await readBriefCache();
+        if (briefCache?.brief) {
+          const ageMs = Date.now() - new Date(briefCache.fetchedAt).getTime();
+          const ageDays = Math.floor(ageMs / (1e3 * 60 * 60 * 24));
+          briefCacheCheck = { status: "cached", ageDays, stale: ageDays > 7 };
+        } else if (briefCache?.skipped) {
+          briefCacheCheck = { status: "skipped" };
+        } else {
+          briefCacheCheck = { status: "missing" };
+        }
+      } catch (err) {
+        briefCacheCheck = {
+          status: "error",
+          message: err instanceof Error ? err.message : String(err)
+        };
+      }
+      checks["briefCache"] = briefCacheCheck;
+      let personaCacheCheck;
+      try {
+        const wsResult = await findWorkspaceState();
+        const active = wsResult?.state ?? null;
+        if (active) {
+          const personaEntry = await readPersonaCacheForCourse(void 0, active.courseId);
+          if (personaEntry) {
+            const ageMs = Date.now() - new Date(personaEntry.fetchedAt).getTime();
+            const ageDays = Math.floor(ageMs / (1e3 * 60 * 60 * 24));
+            personaCacheCheck = {
+              status: "cached",
+              courseTitle: active.courseTitle,
+              ageDays,
+              stale: ageDays > 7
+            };
+          } else {
+            personaCacheCheck = { status: "missing", courseTitle: active.courseTitle };
+          }
+        } else {
+          personaCacheCheck = { status: "no-active-course" };
+        }
+      } catch (err) {
+        personaCacheCheck = {
+          status: "error",
+          message: err instanceof Error ? err.message : String(err)
+        };
+      }
+      checks["personaCache"] = personaCacheCheck;
       if (opts.json) {
         output(checks, { json: true });
         return;
@@ -3038,6 +2883,38 @@ var init_doctor = __esm({
           `  ${ide.detected ? "\u2713" : "\u25CB"} ${ide.name.padEnd(14)} ${ide.detected ? "detectado" : "n\xE3o detectado"}`
         );
       }
+      console.log("\n  Contexto de estudo");
+      if (workspaceMarkerCheck.status === "found") {
+        console.log(
+          `  \u2713 Workspace     ${workspaceMarkerCheck.courseTitle} (${workspaceMarkerCheck.slug})`
+        );
+      } else if (workspaceMarkerCheck.status === "absent") {
+        console.log("  \u25CB Workspace     sem marker no diret\xF3rio atual (usando estado global)");
+      } else {
+        console.log(`  \u2717 Workspace     erro ao ler marker: ${workspaceMarkerCheck.message}`);
+      }
+      if (briefCacheCheck.status === "cached") {
+        const warn = briefCacheCheck.stale ? " (desatualizado \u2014 rode `tostudy sync`)" : "";
+        console.log(`  \u2713 Brief (T1)    cache com ${briefCacheCheck.ageDays}d${warn}`);
+      } else if (briefCacheCheck.status === "skipped") {
+        console.log("  \u25CB Brief (T1)    ignorado pelo usu\xE1rio");
+      } else if (briefCacheCheck.status === "missing") {
+        console.log("  \u25CB Brief (T1)    n\xE3o criado \u2014 rode `tostudy brief-create`");
+      } else {
+        console.log(`  \u2717 Brief (T1)    erro: ${briefCacheCheck.message}`);
+      }
+      if (personaCacheCheck.status === "cached") {
+        const warn = personaCacheCheck.stale ? " (desatualizado)" : "";
+        console.log(
+          `  \u2713 Persona (T0)  cache para "${personaCacheCheck.courseTitle}" (${personaCacheCheck.ageDays}d)${warn}`
+        );
+      } else if (personaCacheCheck.status === "missing") {
+        console.log(`  \u25CB Persona (T0)  sem cache para "${personaCacheCheck.courseTitle}"`);
+      } else if (personaCacheCheck.status === "no-active-course") {
+        console.log("  \u25CB Persona (T0)  nenhum curso ativo");
+      } else {
+        console.log(`  \u2717 Persona (T0)  erro: ${personaCacheCheck.message}`);
+      }
       console.log("");
     });
   }
@@ -3075,17 +2952,17 @@ var init_courses2 = __esm({
 });
 
 // src/workspace/resolve.ts
-import fs5 from "node:fs/promises";
-import path5 from "node:path";
-import os6 from "node:os";
+import fs7 from "node:fs/promises";
+import path9 from "node:path";
+import os9 from "node:os";
 function courseSlug(title) {
   return title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
 }
 async function resolveWorkspace(courseTitle, basePath = DEFAULT_BASE) {
   const slug = courseSlug(courseTitle);
-  const candidate = path5.join(basePath, slug);
+  const candidate = path9.join(basePath, slug);
   try {
-    await fs5.access(path5.join(candidate, ".ana-config.json"));
+    await fs7.access(path9.join(candidate, ".ana-config.json"));
     return { found: true, workspacePath: candidate, source: "default" };
   } catch {
     return { found: false, workspacePath: null };
@@ -3095,46 +2972,58 @@ async function isCwdWorkspace(cwd = process.cwd()) {
   return await resolveCwdWorkspacePath(cwd) !== null;
 }
 async function resolveCwdWorkspacePath(cwd = process.cwd()) {
-  const tostudyDir = path5.join(cwd, ".tostudy");
+  const tostudyDir = path9.join(cwd, ".tostudy");
   try {
-    const stat = await fs5.stat(tostudyDir);
+    const stat = await fs7.stat(tostudyDir);
     if (stat.isDirectory()) return tostudyDir;
   } catch {
   }
   try {
-    await fs5.access(path5.join(cwd, ".ana-config.json"));
+    await fs7.access(path9.join(cwd, ".ana-config.json"));
     return cwd;
   } catch {
     return null;
   }
 }
+async function findCwdWorkspaceUpwards(startCwd = process.cwd(), homeDir = os9.homedir()) {
+  const home = path9.resolve(homeDir);
+  let current = path9.resolve(startCwd);
+  while (true) {
+    if (current === home) return null;
+    const direct = await resolveCwdWorkspacePath(current);
+    if (direct) return direct;
+    const parent = path9.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
 function resolveVaultPath(workspacePath, slug) {
-  const base = path5.basename(workspacePath) === ".tostudy" ? path5.dirname(workspacePath) : workspacePath;
-  return path5.join(base, `vault-${slug}`);
+  const base = path9.basename(workspacePath) === ".tostudy" ? path9.dirname(workspacePath) : workspacePath;
+  return path9.join(base, `vault-${slug}`);
 }
 async function findExistingVault(workspacePath, slug) {
   const slugged = resolveVaultPath(workspacePath, slug);
   try {
-    await fs5.access(path5.join(slugged, ".ana-vault.json"));
+    await fs7.access(path9.join(slugged, ".ana-vault.json"));
     return slugged;
   } catch {
   }
-  const legacy = path5.join(workspacePath, "vault");
+  const legacy = path9.join(workspacePath, "vault");
   try {
-    await fs5.access(path5.join(legacy, ".ana-vault.json"));
+    await fs7.access(path9.join(legacy, ".ana-vault.json"));
     return legacy;
   } catch {
     return null;
   }
 }
-async function resolveEffectiveWorkspace(courseTitle, storedPath, cwd = process.cwd(), defaultBasePath = DEFAULT_BASE) {
-  const cwdWorkspace = await resolveCwdWorkspacePath(cwd);
+async function resolveEffectiveWorkspace(courseTitle, storedPath, cwd = process.cwd(), defaultBasePath = DEFAULT_BASE, homeDir = os9.homedir()) {
+  const cwdWorkspace = await findCwdWorkspaceUpwards(cwd, homeDir);
   if (cwdWorkspace) {
     return { found: true, workspacePath: cwdWorkspace, source: "cwd" };
   }
   if (storedPath) {
     try {
-      await fs5.access(path5.join(storedPath, ".ana-config.json"));
+      await fs7.access(path9.join(storedPath, ".ana-config.json"));
       return { found: true, workspacePath: storedPath, source: "stored" };
     } catch {
     }
@@ -3149,7 +3038,7 @@ var DEFAULT_BASE;
 var init_resolve = __esm({
   "src/workspace/resolve.ts"() {
     "use strict";
-    DEFAULT_BASE = path5.join(os6.homedir(), "study");
+    DEFAULT_BASE = path9.join(os9.homedir(), "study");
   }
 });
 
@@ -3177,10 +3066,459 @@ var init_status = __esm({
   }
 });
 
+// src/learner-brief/api.ts
+async function apiFetch2(url2, token2, init) {
+  const response = await fetch(url2, {
+    method: init?.method ?? "GET",
+    body: init?.body,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token2}`,
+      ...init?.headers ?? {}
+    }
+  });
+  const body = await response.json();
+  if (!response.ok) {
+    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
+  }
+  return body;
+}
+async function fetchLearnerBrief(input2) {
+  const response = await apiFetch2(
+    `${input2.apiUrl}/api/cli/student/learner-brief`,
+    input2.token
+  );
+  return response.brief;
+}
+async function upsertLearnerBrief(input2) {
+  const response = await apiFetch2(
+    `${input2.apiUrl}/api/cli/student/learner-brief`,
+    input2.token,
+    {
+      method: "POST",
+      body: JSON.stringify({ text: input2.text, source: input2.source })
+    }
+  );
+  return response.brief;
+}
+var init_api = __esm({
+  "src/learner-brief/api.ts"() {
+    "use strict";
+    init_http2();
+  }
+});
+
+// src/learner-brief/bootstrap.ts
+import readline from "node:readline/promises";
+import { stdin as processStdin, stdout as processStdout } from "node:process";
+function composeBriefFromAnswers(answers) {
+  const levelLabel = {
+    beginner: "iniciante",
+    intermediate: "intermediario",
+    advanced: "avancado"
+  }[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 paragraphThree = `Contexto real do meu dia a dia: ${answers.realContext.trim()}`;
+  const text2 = [paragraphOne, paragraphTwo, paragraphThree].map((p) => p.replace(/\.\.+/g, ".")).join("\n\n");
+  return text2.slice(0, 5e3);
+}
+async function askNonEmpty(question, deps) {
+  while (true) {
+    const answer = (await deps.ask(question)).trim();
+    if (answer.length > 0) return answer;
+  }
+}
+async function askLevel(deps) {
+  while (true) {
+    const raw = (await deps.ask("  Seu nivel geral neste assunto (beginner/intermediate/advanced): ")).trim().toLowerCase();
+    if (raw === "beginner" || raw === "intermediate" || raw === "advanced") {
+      return raw;
+    }
+  }
+}
+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.",
+      ""
+    ].join("\n")
+  );
+  const whoYouAre = await askNonEmpty("  Quem voce e (profissao/cargo/area): ", deps);
+  const whereYouWork = await askNonEmpty("  Onde trabalha (empresa/setor): ", deps);
+  const whatYouDo = await askNonEmpty("  O que voce faz (responsabilidades/projetos): ", deps);
+  const yourLevel = await askLevel(deps);
+  const yourGoals = await askNonEmpty("  Seu objetivo de aprendizado: ", deps);
+  const realContext = await askNonEmpty(
+    "  Contexto real (exemplos que o tutor pode usar nas aulas): ",
+    deps
+  );
+  return { whoYouAre, whereYouWork, whatYouDo, yourLevel, yourGoals, realContext };
+}
+async function collectBootstrapAnswers(input2) {
+  const rl = readline.createInterface({ input: processStdin, output: processStdout });
+  try {
+    return await collectBootstrapAnswersWithDeps(input2, {
+      ask: (q) => rl.question(q),
+      write: (s) => {
+        processStdout.write(s);
+      }
+    });
+  } finally {
+    rl.close();
+  }
+}
+var init_bootstrap = __esm({
+  "src/learner-brief/bootstrap.ts"() {
+    "use strict";
+  }
+});
+
+// src/tutor-persona/api.ts
+async function fetchTutorPersonality(input2) {
+  const url2 = new URL(`${input2.apiUrl}/api/cli/tutor-personality`);
+  url2.searchParams.set("courseId", input2.courseId);
+  const response = await fetch(url2.toString(), {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${input2.token}`
+    }
+  });
+  const body = await response.json();
+  if (!response.ok) {
+    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
+  }
+  return body.personality ?? null;
+}
+var init_api2 = __esm({
+  "src/tutor-persona/api.ts"() {
+    "use strict";
+    init_http2();
+  }
+});
+
+// src/onboarding/api.ts
+async function apiFetch3(url2, token2, init) {
+  const response = await fetch(url2, {
+    ...init,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token2}`,
+      ...init?.headers
+    }
+  });
+  const body = await response.json();
+  if (!response.ok) {
+    throw new CliApiError(body.error ?? `API error ${response.status}`, response.status);
+  }
+  return body;
+}
+async function getRemoteEnrollmentOnboarding(input2) {
+  const url2 = new URL(`${input2.apiUrl}/api/cli/onboarding`);
+  url2.searchParams.set("enrollmentId", input2.enrollmentId);
+  const response = await apiFetch3(
+    url2.toString(),
+    input2.token
+  );
+  return response.onboarding;
+}
+async function saveRemoteEnrollmentOnboarding(input2) {
+  const response = await apiFetch3(
+    `${input2.apiUrl}/api/cli/onboarding`,
+    input2.token,
+    {
+      method: "POST",
+      body: JSON.stringify({
+        enrollmentId: input2.enrollmentId,
+        learnerBrief: input2.learnerBrief,
+        learnerProfile: input2.learnerProfile
+      })
+    }
+  );
+  return response.onboarding;
+}
+var init_api3 = __esm({
+  "src/onboarding/api.ts"() {
+    "use strict";
+    init_http2();
+  }
+});
+
+// src/instruction-pipeline.ts
+async function defaultWriteFiles(_cwd, _courseMeta, _content) {
+  throw new Error(
+    "writeFiles default implementation is a stub \u2014 inject a real one from the calling command (select/init/sync). Commit 9 will wire the real implementation."
+  );
+}
+async function defaultFetchCourseMeta(_input) {
+  throw new Error(
+    "fetchCourseMeta default implementation is a stub \u2014 inject a real one from the calling command (select/init/sync)"
+  );
+}
+async function resolveAndGenerate(input2, options = {}, context) {
+  const deps = context.deps ?? defaultDeps2;
+  const forceRefresh = options.forceRefresh ?? false;
+  const session = await deps.getSession(context.configDir);
+  if (!session) {
+    throw new Error("No active session \u2014 run `tostudy login`");
+  }
+  const courseMeta = await deps.fetchCourseMeta({
+    session,
+    courseId: input2.courseId,
+    enrollmentId: input2.enrollmentId
+  });
+  let tutorPersona = null;
+  if (!forceRefresh) {
+    const cached2 = await deps.readPersonaCacheForCourse(context.configDir, input2.courseId);
+    if (cached2) tutorPersona = cached2.personality;
+  }
+  if (!tutorPersona) {
+    try {
+      tutorPersona = await deps.fetchTutorPersona({
+        apiUrl: session.apiUrl,
+        token: session.token,
+        courseId: input2.courseId
+      });
+      if (tutorPersona) {
+        await deps.writePersonaCacheForCourse(context.configDir, input2.courseId, {
+          personality: tutorPersona,
+          fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          profileUpdatedAt: tutorPersona.updatedAt
+        });
+      }
+    } catch (err) {
+      logger5.warn("T0 fetch failed \u2014 rendering without persona", { err });
+      tutorPersona = null;
+    }
+  }
+  let studentBrief = null;
+  let bootstrapped = null;
+  if (!forceRefresh) {
+    const cached2 = await deps.readBriefCache(context.configDir);
+    if (cached2 && cached2.userId === session.userId && !cached2.skipped) {
+      studentBrief = cached2.brief;
+    }
+  }
+  if (!studentBrief) {
+    try {
+      studentBrief = await deps.fetchLearnerBrief({
+        apiUrl: session.apiUrl,
+        token: session.token
+      });
+      await deps.writeBriefCache(context.configDir, {
+        userId: session.userId,
+        brief: studentBrief,
+        fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    } catch (err) {
+      logger5.warn("T1 fetch failed \u2014 rendering without brief", { err });
+    }
+  }
+  if (!studentBrief && options.collectT1Interactive) {
+    try {
+      const answers = await deps.collectBootstrapAnswers({ userName: session.userName });
+      const text2 = composeBriefFromAnswers(answers);
+      studentBrief = await deps.upsertLearnerBrief({
+        apiUrl: session.apiUrl,
+        token: session.token,
+        text: text2,
+        source: "manual"
+      });
+      await deps.writeBriefCache(context.configDir, {
+        userId: session.userId,
+        brief: studentBrief,
+        fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      bootstrapped = "t1";
+    } catch (err) {
+      logger5.warn("T1 bootstrap failed", { err });
+    }
+  }
+  let enrollmentProfile = null;
+  try {
+    const onboarding = await deps.fetchEnrollmentOnboarding({
+      apiUrl: session.apiUrl,
+      token: session.token,
+      enrollmentId: input2.enrollmentId
+    });
+    if (onboarding) {
+      enrollmentProfile = onboarding.learnerProfile;
+    }
+  } catch (err) {
+    logger5.warn("T2 fetch failed \u2014 rendering without enrollment profile", { err });
+  }
+  const content = renderCourseInstruction({
+    course: {
+      courseId: courseMeta.courseId,
+      courseTitle: courseMeta.courseTitle,
+      slug: courseMeta.slug,
+      courseDescription: courseMeta.courseDescription
+    },
+    progress: courseMeta.progress,
+    tutorPersona,
+    studentBrief,
+    enrollmentProfile
+  });
+  const wroteFiles = await deps.writeFiles(context.cwd, courseMeta, content);
+  let markerPath = null;
+  try {
+    markerPath = await deps.writeWorkspaceMarker(context.cwd, {
+      courseId: courseMeta.courseId,
+      enrollmentId: input2.enrollmentId,
+      slug: courseMeta.slug,
+      courseTitle: courseMeta.courseTitle
+    });
+  } catch (err) {
+    logger5.warn("Failed to write workspace marker", { err });
+  }
+  if (markerPath) {
+    try {
+      await updateWorkspaceState(context.cwd, {
+        courseTags: courseMeta.courseTags,
+        courseLevel: courseMeta.courseLevel,
+        lastInitCourseId: input2.courseId
+      });
+    } catch (err) {
+      logger5.warn("Failed to update workspace state v2 fields", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return {
+    wroteFiles,
+    markerPath,
+    usedT0: tutorPersona !== null,
+    usedT1: studentBrief !== null,
+    usedT2: enrollmentProfile !== null,
+    bootstrapped,
+    renderedInstruction: content
+  };
+}
+var logger5, defaultDeps2;
+var init_instruction_pipeline = __esm({
+  "src/instruction-pipeline.ts"() {
+    "use strict";
+    init_src();
+    init_workspace_marker();
+    init_workspace_state();
+    init_api();
+    init_cache();
+    init_bootstrap();
+    init_api2();
+    init_cache2();
+    init_api3();
+    init_session();
+    init_instruction_template_v3();
+    logger5 = createLogger("cli:instruction-pipeline");
+    defaultDeps2 = {
+      fetchTutorPersona: fetchTutorPersonality,
+      fetchLearnerBrief,
+      fetchEnrollmentOnboarding: getRemoteEnrollmentOnboarding,
+      fetchCourseMeta: defaultFetchCourseMeta,
+      readBriefCache,
+      writeBriefCache,
+      readPersonaCacheForCourse,
+      writePersonaCacheForCourse,
+      writeFiles: defaultWriteFiles,
+      writeWorkspaceMarker,
+      collectBootstrapAnswers,
+      upsertLearnerBrief,
+      getSession
+    };
+  }
+});
+
+// src/commands/_shared/pipeline-deps.ts
+async function fetchCourseMetaViaHttp(input2) {
+  const { session, courseId, enrollmentId } = input2;
+  const data = createHttpProvider(session.apiUrl, session.token);
+  const coreDeps = { data, logger: logger6 };
+  const detail = await selectCourse({ userId: session.userId, courseId }, coreDeps);
+  let currentModuleTitle;
+  let currentLessonTitle;
+  try {
+    const progress3 = await getProgress({ enrollmentId }, coreDeps);
+    currentModuleTitle = progress3.currentModule?.title;
+    currentLessonTitle = progress3.currentLesson?.title;
+  } catch (err) {
+    logger6.debug("getProgress failed \u2014 falling back to basic course meta", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+  let courseTags;
+  let courseLevel;
+  try {
+    const courses3 = await listCourses({ userId: session.userId }, coreDeps);
+    const match = courses3.find((c) => c.courseId === courseId);
+    if (match) {
+      courseTags = match.tags;
+      courseLevel = match.level;
+    }
+  } catch (err) {
+    logger6.debug("listCourses failed \u2014 skipping tags/level", {
+      error: err instanceof Error ? err.message : String(err)
+    });
+  }
+  return {
+    courseId: detail.courseId,
+    courseTitle: detail.courseTitle,
+    slug: slugify(detail.courseTitle),
+    courseDescription: detail.courseDescription,
+    courseTags,
+    courseLevel,
+    progress: {
+      percent: detail.progress,
+      moduleCount: detail.moduleCount,
+      lessonCount: detail.lessonCount,
+      currentModuleTitle,
+      currentLessonTitle
+    }
+  };
+}
+async function writeFilesAdapter(cwd, courseMeta, content) {
+  return writeInstructionFiles(
+    cwd,
+    {
+      courseTitle: courseMeta.courseTitle,
+      courseId: courseMeta.courseId,
+      progress: courseMeta.progress.percent,
+      moduleCount: courseMeta.progress.moduleCount,
+      lessonCount: courseMeta.progress.lessonCount,
+      currentModuleTitle: courseMeta.progress.currentModuleTitle,
+      currentLessonTitle: courseMeta.progress.currentLessonTitle,
+      courseDescription: courseMeta.courseDescription
+    },
+    content
+  );
+}
+function buildPipelineDeps() {
+  return {
+    ...defaultDeps2,
+    fetchCourseMeta: fetchCourseMetaViaHttp,
+    writeFiles: writeFilesAdapter
+  };
+}
+var logger6;
+var init_pipeline_deps = __esm({
+  "src/commands/_shared/pipeline-deps.ts"() {
+    "use strict";
+    init_src();
+    init_courses();
+    init_http2();
+    init_instruction_pipeline();
+    init_instruction_files();
+    logger6 = createLogger("cli:pipeline-deps");
+  }
+});
+
 // src/commands/select.ts
 import { Command as Command6 } from "commander";
-import os7 from "node:os";
-var logger5, selectCommand;
+import os10 from "node:os";
+var logger7, selectCommand;
 var init_select = __esm({
   "src/commands/select.ts"() {
     "use strict";
@@ -3188,15 +3526,18 @@ var init_select = __esm({
     init_courses();
     init_http2();
     init_session();
+    init_workspace_marker();
+    init_resolve();
     init_formatter();
-    init_instruction_files();
     init_status();
-    logger5 = createLogger("cli:select");
+    init_instruction_pipeline();
+    init_pipeline_deps();
+    logger7 = 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) => {
       try {
         const session = await requireSession();
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger5 };
+        const deps = { data, logger: logger7 };
         const courses3 = await listCourses({ userId: session.userId }, deps);
         let courseId = course;
         let enrollmentId = "";
@@ -3214,14 +3555,12 @@ var init_select = __esm({
             enrollmentId = found.enrollmentId;
           }
         }
-        const matched = courses3.find((c) => c.courseId === courseId);
         const detail = await selectCourse({ userId: session.userId, courseId }, deps);
-        await setActiveCourse({
+        await writeWorkspaceMarker(process.cwd(), {
           courseId: detail.courseId,
-          courseTitle: detail.courseTitle,
           enrollmentId,
-          courseTags: matched?.tags,
-          courseLevel: matched?.level
+          slug: courseSlug(detail.courseTitle),
+          courseTitle: detail.courseTitle
         });
         const activeCourseForStatus = {
           courseId: detail.courseId,
@@ -3229,23 +3568,20 @@ var init_select = __esm({
           enrollmentId
         };
         const onboarding = await getCourseOnboardingStatus(activeCourseForStatus);
-        let courseSlug2 = "";
+        let pipelineResult = null;
         try {
-          courseSlug2 = generateInstructionFiles({
-            courseTitle: detail.courseTitle,
-            courseId: detail.courseId,
-            progress: detail.progress,
-            moduleCount: detail.moduleCount,
-            lessonCount: detail.lessonCount,
-            courseDescription: detail.courseDescription,
-            workspaceReady: onboarding.workspaceReady,
-            workspacePath: onboarding.workspacePath ?? void 0
-          });
+          pipelineResult = await resolveAndGenerate(
+            { courseId: detail.courseId, enrollmentId },
+            { forceRefresh: false, collectT1Interactive: false, collectT2Interactive: false },
+            { cwd: process.cwd(), deps: buildPipelineDeps() }
+          );
         } catch (err) {
-          logger5.warn("Failed to generate instruction files", {
+          logger7.warn("Failed to run instruction pipeline", {
             error: err instanceof Error ? err.message : String(err)
           });
         }
+        const slugMatch = pipelineResult?.wroteFiles.find((f) => f.startsWith(".claude/commands/"))?.match(/tostudy-(.+)\.md$/);
+        const courseSlug2 = slugMatch?.[1] ?? "";
         if (opts.json) {
           output(
             {
@@ -3253,13 +3589,19 @@ var init_select = __esm({
               enrollmentId,
               courseSlug: courseSlug2,
               workspacePath: onboarding.workspacePath,
-              workspaceSource: onboarding.workspaceSource
+              workspaceSource: onboarding.workspaceSource,
+              wroteFiles: pipelineResult?.wroteFiles ?? [],
+              markerPath: pipelineResult?.markerPath ?? null,
+              usedT0: pipelineResult?.usedT0 ?? false,
+              usedT1: pipelineResult?.usedT1 ?? false,
+              usedT2: pipelineResult?.usedT2 ?? false,
+              instruction: pipelineResult?.renderedInstruction ?? null
             },
             { json: true }
           );
         } else {
           const slashCmd = courseSlug2 ? `/tostudy-${courseSlug2}` : "/tostudy";
-          const home = os7.homedir();
+          const home = os10.homedir();
           const cwd = process.cwd();
           const namespacedPath = `${cwd}/.tostudy`;
           let wsLine;
@@ -3272,20 +3614,26 @@ var init_select = __esm({
           } else {
             wsLine = "  Workspace: rode `tostudy workspace setup` para configurar";
           }
-          output(
-            [
-              `\u2713 Curso ativado: ${detail.courseTitle}`,
-              `  Progresso: ${detail.progress}%  |  ${detail.moduleCount} m\xF3dulos  |  ${detail.lessonCount} li\xE7\xF5es`,
-              wsLine,
-              "",
-              "  Arquivos de contexto criados para seu assistente AI.",
-              "",
-              "\u2192 Abra sua plataforma (claude, codex, cursor...)",
-              `\u2192 No Claude Code, digite: ${slashCmd}`,
-              "\u2192 Em outras plataformas: tostudy init"
-            ].join("\n"),
-            { json: false }
+          const lines = [
+            `\u2713 Curso ativado: ${detail.courseTitle}`,
+            `  Progresso: ${detail.progress}%  |  ${detail.moduleCount} m\xF3dulos  |  ${detail.lessonCount} li\xE7\xF5es`,
+            wsLine,
+            "",
+            "  Arquivos de contexto criados para seu assistente AI."
+          ];
+          if (pipelineResult && !pipelineResult.usedT0) {
+            lines.push("  (sem persona do creator \u2014 usando tutor neutro)");
+          }
+          if (pipelineResult && !pipelineResult.usedT1) {
+            lines.push("  (sem brief base \u2014 rode `tostudy init` para configurar)");
+          }
+          lines.push(
+            "",
+            "\u2192 Abra sua plataforma (claude, codex, cursor...)",
+            `\u2192 No Claude Code, digite: ${slashCmd}`,
+            "\u2192 Em outras plataformas: tostudy init"
           );
+          output(lines.join("\n"), { json: false });
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
@@ -3297,7 +3645,7 @@ var init_select = __esm({
 
 // src/commands/progress.ts
 import { Command as Command7 } from "commander";
-var logger6, progressCommand;
+var logger8, progressCommand;
 var init_progress = __esm({
   "src/commands/progress.ts"() {
     "use strict";
@@ -3306,7 +3654,7 @@ var init_progress = __esm({
     init_http2();
     init_session();
     init_formatter();
-    logger6 = createLogger("cli:progress");
+    logger8 = createLogger("cli:progress");
     progressCommand = new Command7("progress").description("Show your progress in the active course").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -3314,7 +3662,7 @@ var init_progress = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger6 };
+        const deps = { data, logger: logger8 };
         const progress3 = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
         if (opts.json) {
           output(progress3, { json: true });
@@ -4132,7 +4480,7 @@ var init_subquery = __esm({
 var version;
 var init_version = __esm({
   "../../node_modules/drizzle-orm/version.js"() {
-    version = "0.45.1";
+    version = "0.45.2";
   }
 });
 
@@ -4573,7 +4921,7 @@ var init_sql = __esm({
         return new SQL([new StringChunk(str)]);
       }
       sql2.raw = raw;
-      function join4(chunks, separator) {
+      function join3(chunks, separator) {
         const result = [];
         for (const [i, chunk] of chunks.entries()) {
           if (i > 0 && separator !== void 0) {
@@ -4583,7 +4931,7 @@ var init_sql = __esm({
         }
         return new SQL(result);
       }
-      sql2.join = join4;
+      sql2.join = join3;
       function identifier(value) {
         return new Name(value);
       }
@@ -4875,7 +5223,7 @@ var init_query_promise = __esm({
 function mapResultRow(columns, row, joinsNotNullableMap) {
   const nullifyMap = {};
   const result = columns.reduce(
-    (result2, { path: path14, field }, columnIndex) => {
+    (result2, { path: path19, field }, columnIndex) => {
       let decoder;
       if (is(field, Column)) {
         decoder = field;
@@ -4887,8 +5235,8 @@ function mapResultRow(columns, row, joinsNotNullableMap) {
         decoder = field.sql.decoder;
       }
       let node = result2;
-      for (const [pathChunkIndex, pathChunk] of path14.entries()) {
-        if (pathChunkIndex < path14.length - 1) {
+      for (const [pathChunkIndex, pathChunk] of path19.entries()) {
+        if (pathChunkIndex < path19.length - 1) {
           if (!(pathChunk in node)) {
             node[pathChunk] = {};
           }
@@ -4896,8 +5244,8 @@ function mapResultRow(columns, row, joinsNotNullableMap) {
         } else {
           const rawValue = row[columnIndex];
           const value = node[pathChunk] = rawValue === null ? null : decoder.mapFromDriverValue(rawValue);
-          if (joinsNotNullableMap && is(field, Column) && path14.length === 2) {
-            const objectName = path14[0];
+          if (joinsNotNullableMap && is(field, Column) && path19.length === 2) {
+            const objectName = path19[0];
             if (!(objectName in nullifyMap)) {
               nullifyMap[objectName] = value === null ? getTableName(field.table) : false;
             } else if (typeof nullifyMap[objectName] === "string" && nullifyMap[objectName] !== getTableName(field.table)) {
@@ -8844,13 +9192,13 @@ function Subscribe(postgres2, options) {
       }
     }
     function handle(a, b2) {
-      const path14 = b2.relation.schema + "." + b2.relation.table;
+      const path19 = b2.relation.schema + "." + b2.relation.table;
       call("*", a, b2);
-      call("*:" + path14, a, b2);
-      b2.relation.keys.length && call("*:" + path14 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call("*:" + path19, a, b2);
+      b2.relation.keys.length && call("*:" + path19 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
       call(b2.command, a, b2);
-      call(b2.command + ":" + path14, a, b2);
-      b2.relation.keys.length && call(b2.command + ":" + path14 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call(b2.command + ":" + path19, a, b2);
+      b2.relation.keys.length && call(b2.command + ":" + path19 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
     }
     function pong() {
       const x2 = Buffer.alloc(34);
@@ -8963,8 +9311,8 @@ function parseEvent(x) {
   const xs = x.match(/^(\*|insert|update|delete)?:?([^.]+?\.?[^=]+)?=?(.+)?/i) || [];
   if (!xs)
     throw new Error("Malformed subscribe pattern: " + x);
-  const [, command, path14, key] = xs;
-  return (command || "*") + (path14 ? ":" + (path14.indexOf(".") === -1 ? "public." + path14 : path14) : "") + (key ? "=" + key : "");
+  const [, command, path19, key] = xs;
+  return (command || "*") + (path19 ? ":" + (path19.indexOf(".") === -1 ? "public." + path19 : path19) : "") + (key ? "=" + key : "");
 }
 var noop2;
 var init_subscribe = __esm({
@@ -9045,8 +9393,8 @@ var init_large = __esm({
 });
 
 // ../../node_modules/postgres/src/index.js
-import os8 from "os";
-import fs6 from "fs";
+import os11 from "os";
+import fs8 from "fs";
 function Postgres(a, b2) {
   const options = parseOptions(a, b2), subscribe = options.no_subscribe || Subscribe(Postgres, { ...options });
   let ending = false;
@@ -9102,10 +9450,10 @@ function Postgres(a, b2) {
       });
       return query;
     }
-    function file2(path14, args = [], options2 = {}) {
+    function file2(path19, args = [], options2 = {}) {
       arguments.length === 2 && !Array.isArray(args) && (options2 = args, args = []);
       const query = new Query([], args, (query2) => {
-        fs6.readFile(path14, "utf8", (err, string4) => {
+        fs8.readFile(path19, "utf8", (err, string4) => {
           if (err)
             return query2.reject(err);
           query2.strings = [string4];
@@ -9423,7 +9771,7 @@ function parseUrl(url2) {
 }
 function osUsername() {
   try {
-    return os8.userInfo().username;
+    return os11.userInfo().username;
   } catch (_) {
     return process.env.USERNAME || process.env.USER || process.env.LOGNAME;
   }
@@ -9901,7 +10249,7 @@ var init_dialect = __esm({
         });
       }
       escapeName(name) {
-        return `"${name}"`;
+        return `"${name.replace(/"/g, '""')}"`;
       }
       escapeParam(num) {
         return `$${num + 1}`;
@@ -11115,7 +11463,7 @@ var init_select3 = __esm({
           const baseTableName = this.tableName;
           const tableName = getTableLikeName(table);
           for (const item of extractUsedTable(table)) this.usedTables.add(item);
-          if (typeof tableName === "string" && this.config.joins?.some((join4) => join4.alias === tableName)) {
+          if (typeof tableName === "string" && this.config.joins?.some((join3) => join3.alias === tableName)) {
             throw new Error(`Alias "${tableName}" is already used in this query`);
           }
           if (!this.isPartialSelect) {
@@ -12642,7 +12990,7 @@ var init_update = __esm({
       createJoin(joinType) {
         return (table, on) => {
           const tableName = getTableLikeName(table);
-          if (typeof tableName === "string" && this.config.joins.some((join4) => join4.alias === tableName)) {
+          if (typeof tableName === "string" && this.config.joins.some((join3) => join3.alias === tableName)) {
             throw new Error(`Alias "${tableName}" is already used in this query`);
           }
           if (typeof on === "function") {
@@ -12738,10 +13086,10 @@ var init_update = __esm({
               const fromFields = this.getTableLikeFields(this.config.from);
               fields[tableName] = fromFields;
             }
-            for (const join4 of this.config.joins) {
-              const tableName2 = getTableLikeName(join4.table);
-              if (typeof tableName2 === "string" && !is(join4.table, SQL)) {
-                const fromFields = this.getTableLikeFields(join4.table);
+            for (const join3 of this.config.joins) {
+              const tableName2 = getTableLikeName(join3.table);
+              if (typeof tableName2 === "string" && !is(join3.table, SQL)) {
+                const fromFields = this.getTableLikeFields(join3.table);
                 fields[tableName2] = fromFields;
               }
             }
@@ -13331,7 +13679,7 @@ async function hashQuery(sql2, params) {
   return hashHex;
 }
 var Cache, NoopCache;
-var init_cache = __esm({
+var init_cache3 = __esm({
   "../../node_modules/drizzle-orm/cache/core/cache.js"() {
     init_entity();
     Cache = class {
@@ -13356,7 +13704,7 @@ var init_cache = __esm({
 // ../../node_modules/drizzle-orm/cache/core/index.js
 var init_core = __esm({
   "../../node_modules/drizzle-orm/cache/core/index.js"() {
-    init_cache();
+    init_cache3();
   }
 });
 
@@ -13464,7 +13812,7 @@ var init_schema = __esm({
 var PgPreparedQuery, PgSession, PgTransaction;
 var init_session2 = __esm({
   "../../node_modules/drizzle-orm/pg-core/session.js"() {
-    init_cache();
+    init_cache3();
     init_entity();
     init_errors();
     init_sql2();
@@ -13684,12 +14032,12 @@ var init_session3 = __esm({
     init_tracing();
     init_utils();
     PostgresJsPreparedQuery = class extends PgPreparedQuery {
-      constructor(client, queryString, params, logger19, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
+      constructor(client, queryString, params, logger26, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
         super({ sql: queryString, params }, cache, queryMetadata, cacheConfig);
         this.client = client;
         this.queryString = queryString;
         this.params = params;
-        this.logger = logger19;
+        this.logger = logger26;
         this.fields = fields;
         this._isResponseInArrayMode = _isResponseInArrayMode;
         this.customResultMapper = customResultMapper;
@@ -13830,11 +14178,11 @@ function construct(client, config2 = {}) {
   client.options.serializers["114"] = transparentParser;
   client.options.serializers["3802"] = transparentParser;
   const dialect = new PgDialect({ casing: config2.casing });
-  let logger19;
+  let logger26;
   if (config2.logger === true) {
-    logger19 = new DefaultLogger();
+    logger26 = new DefaultLogger();
   } else if (config2.logger !== false) {
-    logger19 = config2.logger;
+    logger26 = config2.logger;
   }
   let schema;
   if (config2.schema) {
@@ -13848,7 +14196,7 @@ function construct(client, config2 = {}) {
       tableNamesMap: tablesConfig.tableNamesMap
     };
   }
-  const session = new PostgresJsSession(client, dialect, schema, { logger: logger19, cache: config2.cache });
+  const session = new PostgresJsSession(client, dialect, schema, { logger: logger26, cache: config2.cache });
   const db2 = new PostgresJsDatabase(dialect, session, schema);
   db2.$client = client;
   db2.$cache = config2.cache;
@@ -14163,10 +14511,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path14) {
-  if (!path14)
+function getElementAtPath(obj, path19) {
+  if (!path19)
     return obj;
-  return path14.reduce((acc, key) => acc?.[key], obj);
+  return path19.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -14478,11 +14826,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path14, issues) {
+function prefixIssues(path19, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path14);
+    iss.path.unshift(path19);
     return iss;
   });
 }
@@ -14724,7 +15072,7 @@ function formatError(error49, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error49, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error50, path14 = []) => {
+  const processError = (error50, path19 = []) => {
     var _a2, _b;
     for (const issue2 of error50.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -14734,7 +15082,7 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path14, ...issue2.path];
+        const fullpath = [...path19, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -14766,8 +15114,8 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path14 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path14) {
+  const path19 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path19) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -24678,7 +25026,7 @@ function _stringFormat(Class2, format, fnOrRegex, _params = {}) {
   return inst;
 }
 var TimePrecision;
-var init_api2 = __esm({
+var init_api4 = __esm({
   "../../node_modules/zod/v4/core/api.js"() {
     init_checks2();
     init_registries();
@@ -25989,7 +26337,7 @@ var init_core3 = __esm({
     init_locales();
     init_registries();
     init_doc();
-    init_api2();
+    init_api4();
     init_to_json_schema();
     init_json_schema_processors();
     init_json_schema_generator();
@@ -27461,13 +27809,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path14 = ref.slice(1).split("/").filter(Boolean);
-  if (path14.length === 0) {
+  const path19 = ref.slice(1).split("/").filter(Boolean);
+  if (path19.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path14[0] === defsKey) {
-    const key = path14[1];
+  if (path19[0] === defsKey) {
+    const key = path19[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -38785,27 +39133,33 @@ var init_media_assets = __esm({
       "marketing",
       "other"
     ];
-    mediaAssets = pgTable("media_assets", {
-      id: uuid("id").defaultRandom().primaryKey(),
-      url: text("url").notNull(),
-      r2Key: text("r2_key").notNull(),
-      thumbnailUrl: text("thumbnail_url"),
-      type: text("type", { enum: mediaAssetTypeEnum }).notNull(),
-      mimeType: text("mime_type").notNull(),
-      title: text("title"),
-      originalFilename: text("original_filename").notNull(),
-      size: integer("size").notNull(),
-      width: integer("width"),
-      height: integer("height"),
-      tags: text("tags").array().default([]),
-      uploadedById: uuid("uploaded_by_id").references(() => users.id, {
-        onDelete: "set null"
-      }),
-      domain: text("domain", { enum: mediaAssetDomainEnum }),
-      domainEntityId: uuid("domain_entity_id"),
-      status: text("status", { enum: mediaAssetStatusEnum }).notNull().default("pending"),
-      createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
-    });
+    mediaAssets = pgTable(
+      "media_assets",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        url: text("url").notNull(),
+        r2Key: text("r2_key").notNull(),
+        thumbnailUrl: text("thumbnail_url"),
+        type: text("type", { enum: mediaAssetTypeEnum }).notNull(),
+        mimeType: text("mime_type").notNull(),
+        title: text("title"),
+        originalFilename: text("original_filename").notNull(),
+        size: integer("size").notNull(),
+        width: integer("width"),
+        height: integer("height"),
+        tags: text("tags").array().default([]),
+        uploadedById: uuid("uploaded_by_id").references(() => users.id, {
+          onDelete: "set null"
+        }),
+        domain: text("domain", { enum: mediaAssetDomainEnum }),
+        domainEntityId: uuid("domain_entity_id"),
+        status: text("status", { enum: mediaAssetStatusEnum }).notNull().default("pending"),
+        createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+      },
+      (table) => ({
+        r2KeyUnique: uniqueIndex("media_assets_r2_key_unique").on(table.r2Key)
+      })
+    );
   }
 });
 
@@ -40995,7 +41349,7 @@ var init_lessons2 = __esm({
 
 // src/commands/start.ts
 import { Command as Command8 } from "commander";
-async function runStart(opts, deps = defaultDeps2) {
+async function runStart(opts, deps = defaultDeps3) {
   try {
     const session = await deps.requireSession();
     const activeCourse = await deps.requireActiveCourse();
@@ -41011,7 +41365,12 @@ async function runStart(opts, deps = defaultDeps2) {
       { enrollmentId: activeCourse.enrollmentId },
       { data, logger: deps.logger }
     );
-    await deps.setActiveCourse({ ...activeCourse, currentLessonId: moduleData.firstLesson.id });
+    const ws = await deps.findWorkspaceState();
+    if (ws)
+      await deps.updateWorkspaceState(ws.workspacePath, {
+        currentLessonId: moduleData.firstLesson.id,
+        currentModuleId: moduleData.module.id
+      });
     if (opts.json) {
       deps.output(moduleData, { json: true });
     } else {
@@ -41027,7 +41386,7 @@ async function runStart(opts, deps = defaultDeps2) {
     deps.error(msg);
   }
 }
-var logger7, defaultDeps2, startCommand;
+var logger9, defaultDeps3, startCommand;
 var init_start = __esm({
   "src/commands/start.ts"() {
     "use strict";
@@ -41035,22 +41394,24 @@ var init_start = __esm({
     init_lessons2();
     init_http2();
     init_session();
+    init_workspace_state();
     init_status();
     init_formatter();
-    logger7 = createLogger("cli:start");
-    defaultDeps2 = {
+    logger9 = createLogger("cli:start");
+    defaultDeps3 = {
       requireSession,
       requireActiveCourse,
       checkCourseDrift,
       getCourseOnboardingStatus,
       createHttpProvider,
       startModule,
-      setActiveCourse,
+      findWorkspaceState,
+      updateWorkspaceState,
       formatModuleStart,
       output,
       error,
       stderrWrite: (message) => process.stderr.write(message),
-      logger: logger7
+      logger: logger9
     };
     startCommand = new Command8("start").description("Start (or resume) the current module of the active course").option("--json", "Output structured JSON").action(async (opts) => {
       await runStart(opts);
@@ -41060,7 +41421,7 @@ var init_start = __esm({
 
 // src/commands/start-next.ts
 import { Command as Command9 } from "commander";
-var logger8, startNextCommand;
+var logger10, startNextCommand;
 var init_start_next = __esm({
   "src/commands/start-next.ts"() {
     "use strict";
@@ -41068,8 +41429,9 @@ var init_start_next = __esm({
     init_lessons2();
     init_http2();
     init_session();
+    init_workspace_state();
     init_formatter();
-    logger8 = createLogger("cli:start-next");
+    logger10 = createLogger("cli:start-next");
     startNextCommand = new Command9("start-next").description("Transition to the next module after completing the current one").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -41077,9 +41439,14 @@ var init_start_next = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger8 };
+        const deps = { data, logger: logger10 };
         const moduleData = await startNextModule({ enrollmentId: activeCourse.enrollmentId }, deps);
-        await setActiveCourse({ ...activeCourse, currentLessonId: moduleData.firstLesson.id });
+        const ws = await findWorkspaceState();
+        if (ws)
+          await updateWorkspaceState(ws.workspacePath, {
+            currentLessonId: moduleData.firstLesson.id,
+            currentModuleId: moduleData.module.id
+          });
         if (opts.json) {
           output(moduleData, { json: true });
         } else {
@@ -41092,6 +41459,7 @@ var init_start_next = __esm({
           process.exit(0);
         }
         const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -41100,7 +41468,7 @@ var init_start_next = __esm({
 
 // src/commands/next.ts
 import { Command as Command10 } from "commander";
-var logger9, nextCommand;
+var logger11, nextCommand;
 var init_next = __esm({
   "src/commands/next.ts"() {
     "use strict";
@@ -41108,8 +41476,9 @@ var init_next = __esm({
     init_lessons2();
     init_http2();
     init_session();
+    init_workspace_state();
     init_formatter();
-    logger9 = createLogger("cli:next");
+    logger11 = createLogger("cli:next");
     nextCommand = new Command10("next").description("Advance to the next lesson in the active course").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -41117,12 +41486,17 @@ var init_next = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger9 };
+        const deps = { data, logger: logger11 };
         const lessonData = await nextLesson(
           { enrollmentId: activeCourse.enrollmentId, userConfirmation: "cli-next" },
           deps
         );
-        await setActiveCourse({ ...activeCourse, currentLessonId: lessonData.lesson.id });
+        const ws = await findWorkspaceState();
+        if (ws)
+          await updateWorkspaceState(ws.workspacePath, {
+            currentLessonId: lessonData.lesson.id,
+            ...lessonData.lesson.moduleId ? { currentModuleId: lessonData.lesson.moduleId } : {}
+          });
         if (opts.json) {
           output(lessonData, { json: true });
         } else {
@@ -41152,6 +41526,7 @@ var init_next = __esm({
           }
         }
         const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -41198,7 +41573,7 @@ function formatLessonContent(data) {
   }
   return lines.join("\n");
 }
-var logger10, lessonCommand;
+var logger12, lessonCommand;
 var init_lesson = __esm({
   "src/commands/lesson.ts"() {
     "use strict";
@@ -41208,7 +41583,7 @@ var init_lesson = __esm({
     init_session();
     init_formatter();
     init_resolve();
-    logger10 = createLogger("cli:lesson");
+    logger12 = createLogger("cli:lesson");
     lessonCommand = new Command11("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -41216,9 +41591,10 @@ var init_lesson = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger10 };
+        const deps = { data, logger: logger12 };
         const lessonId = activeCourse.currentLessonId;
         if (!lessonId) {
+          if (opts.json) jsonError("no_active_lesson", { message: "Nenhuma li\xE7\xE3o ativa encontrada" });
           error("Nenhuma li\xE7\xE3o ativa encontrada. Rode: tostudy start  ou  tostudy next");
         }
         const content = await getContent({ lessonId, enrollmentId: activeCourse.enrollmentId }, deps);
@@ -41241,6 +41617,7 @@ var init_lesson = __esm({
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -41249,7 +41626,7 @@ var init_lesson = __esm({
 
 // src/commands/hint.ts
 import { Command as Command12 } from "commander";
-var logger11, hintCommand;
+var logger13, hintCommand;
 var init_hint = __esm({
   "src/commands/hint.ts"() {
     "use strict";
@@ -41258,7 +41635,7 @@ var init_hint = __esm({
     init_http2();
     init_session();
     init_formatter();
-    logger11 = createLogger("cli:hint");
+    logger13 = createLogger("cli:hint");
     hintCommand = new Command12("hint").description("Get a progressive hint for the current exercise").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -41266,7 +41643,7 @@ var init_hint = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger11 };
+        const deps = { data, logger: logger13 };
         const hint = await getHint(
           { userId: session.userId, enrollmentId: activeCourse.enrollmentId },
           deps
@@ -41278,6 +41655,7 @@ var init_hint = __esm({
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -41311,11 +41689,253 @@ var init_exercises = __esm({
   }
 });
 
+// src/output/init-template.ts
+function detectTechFromTags(tags) {
+  const found = /* @__PURE__ */ new Set();
+  const keywords = Object.keys(LANGUAGE_TAGS);
+  const joined = tags.map((t) => t.toLowerCase()).join(" ");
+  for (const kw of keywords) {
+    const pattern = new RegExp(`\\b${kw.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`);
+    if (pattern.test(joined)) {
+      found.add(kw);
+    }
+  }
+  return [...found];
+}
+function formatCourseLanguage(tags) {
+  if (!tags || tags.length === 0) return "Programa\xE7\xE3o";
+  const direct = tags.map((t) => LANGUAGE_TAGS[t.toLowerCase()]).filter(Boolean);
+  if (direct.length > 0) return direct.slice(0, 3).join(" / ");
+  const detected = detectTechFromTags(tags);
+  const mapped = detected.map((t) => LANGUAGE_TAGS[t]).filter(Boolean);
+  return mapped.length > 0 ? mapped.slice(0, 3).join(" / ") : "Programa\xE7\xE3o";
+}
+function formatCourseLevel(level) {
+  const map2 = {
+    beginner: "Iniciante",
+    intermediate: "Intermedi\xE1rio",
+    advanced: "Avan\xE7ado"
+  };
+  return map2[level ?? "intermediate"] ?? "Intermedi\xE1rio";
+}
+function formatCourseMethodology(approach) {
+  const map2 = {
+    hybrid: "Teoria e pr\xE1tica",
+    structured: "Estruturado com exerc\xEDcios",
+    exploratory: "Explorat\xF3rio",
+    mentored: "Mentoria guiada",
+    "ai-exploration": "Explora\xE7\xE3o com IA"
+  };
+  return map2[approach] ?? "Teoria e pr\xE1tica";
+}
+function formatCourseObjective(description) {
+  if (!description || description.trim() === "") return null;
+  const firstSentence = description.split(/[.!?]/)[0]?.trim();
+  if (!firstSentence) return null;
+  if (firstSentence.length > 200) return firstSentence.slice(0, 200) + "...";
+  return firstSentence;
+}
+function buildInitTemplate(userName, course, progress3) {
+  const lines = [];
+  lines.push("# ToStudy CLI \u2014 Instru\xE7\xF5es para o Assistente AI");
+  lines.push("");
+  lines.push("Voc\xEA \xE9 um tutor de programa\xE7\xE3o auxiliando um aluno via terminal.");
+  lines.push("");
+  lines.push("## 1. Estado Atual");
+  lines.push(`- Usu\xE1rio: ${userName}`);
+  lines.push(`- Curso: "${course.title}" (${progress3?.coursePercent ?? course.progress}%)`);
+  if (progress3) {
+    const mod = progress3.currentModule;
+    const les = progress3.currentLesson;
+    lines.push(`- M\xF3dulo ${mod.order}/${mod.totalModules}: "${mod.title}"`);
+    lines.push(`- Li\xE7\xE3o ${les.order}/${les.totalLessons}: "${les.title}"`);
+  } else {
+    lines.push("- Nenhuma li\xE7\xE3o iniciada. Rode `tostudy start` para come\xE7ar.");
+  }
+  const language = formatCourseLanguage(course.tags);
+  const level = formatCourseLevel(course.level);
+  const methodology = formatCourseMethodology(course.teachingApproach);
+  const objective = formatCourseObjective(course.description);
+  lines.push("");
+  lines.push("## 2. Contexto do Curso");
+  lines.push(`- Linguagem: ${language}`);
+  lines.push(`- N\xEDvel: ${level}`);
+  lines.push(`- Metodologia: ${methodology}`);
+  if (objective) lines.push(`- Objetivo: ${objective}`);
+  lines.push("");
+  lines.push("Adapte explica\xE7\xF5es e exemplos para esta stack.");
+  lines.push("Exerc\xEDcios envolvem arquivos de c\xF3digo no workspace do aluno.");
+  lines.push("");
+  lines.push("## 3. Comandos");
+  lines.push("| Comando                          | Uso                              |");
+  lines.push("|----------------------------------|----------------------------------|");
+  lines.push("| `tostudy lesson`                 | Ver conte\xFAdo da li\xE7\xE3o atual      |");
+  lines.push("| `tostudy next`                   | Avan\xE7ar para pr\xF3xima li\xE7\xE3o       |");
+  lines.push("| `tostudy hint`                   | Dica progressiva                 |");
+  lines.push("| `tostudy validate <arquivo>`     | Validar solu\xE7\xE3o do exerc\xEDcio     |");
+  lines.push("| `tostudy progress`               | Ver progresso detalhado          |");
+  lines.push("| `tostudy start`                  | Iniciar/retomar m\xF3dulo           |");
+  lines.push("| `tostudy start-next`             | Avan\xE7ar para pr\xF3ximo m\xF3dulo      |");
+  lines.push("| `tostudy courses`                | Listar cursos matriculados       |");
+  lines.push("| `tostudy select <n>`             | Trocar curso ativo               |");
+  lines.push("| `tostudy doctor`                 | Diagn\xF3stico de problemas         |");
+  lines.push("");
+  lines.push("Adicione `--json` para output estruturado quando precisar parsear.");
+  lines.push("");
+  lines.push("## 4. Regras");
+  lines.push("1. Comece rodando `tostudy lesson` para carregar o conte\xFAdo");
+  lines.push("2. N\xE3o d\xEA respostas diretas \u2014 use `tostudy hint` para dicas progressivas");
+  lines.push("3. Ap\xF3s `tostudy validate`, analise cada crit\xE9rio e guie a corre\xE7\xE3o");
+  lines.push("4. N\xE3o avance com `tostudy next` sem o aluno completar o exerc\xEDcio");
+  lines.push('5. Se algum comando retornar aviso de "curso ativo mudou", rode `tostudy init`');
+  lines.push("");
+  lines.push("## 5. Coexist\xEAncia");
+  lines.push("Este workspace pode ter suas pr\xF3prias instru\xE7\xF5es (CLAUDE.md, AGENTS.md).");
+  lines.push("- Instru\xE7\xF5es do projeto \u2192 decis\xF5es de c\xF3digo (estilo, lint, arquitetura)");
+  lines.push("- Instru\xE7\xF5es do ToStudy \u2192 fluxo de estudo (navega\xE7\xE3o, exerc\xEDcios, valida\xE7\xE3o)");
+  return lines.join("\n");
+}
+function resolveTutorMode(level) {
+  if (level === "beginner") return "guided";
+  if (level === "advanced") return "direct";
+  return "balanced";
+}
+function formatTutorMode(mode) {
+  const map2 = {
+    guided: "Guiado",
+    balanced: "Equilibrado",
+    direct: "Direto"
+  };
+  return map2[mode];
+}
+function buildTutorPersonalizationSection(course, learnerProfile) {
+  const mode = resolveTutorMode(course.level);
+  const lines = [];
+  lines.push("## 6. Personaliza\xE7\xE3o do Tutor");
+  lines.push(`- Modo inicial do tutor: ${formatTutorMode(mode)}`);
+  lines.push(
+    "- Na primeira intera\xE7\xE3o, apresente a escolha entre cen\xE1rio fict\xEDcio do curso e adapta\xE7\xE3o ao contexto real do aluno."
+  );
+  lines.push(
+    `- O aluno atual j\xE1 optou por: ${learnerProfile.adaptToRealContext ? "Adaptar para o contexto real" : "Manter o cen\xE1rio fict\xEDcio"}`
+  );
+  lines.push(`- Segmento: ${learnerProfile.segment}`);
+  lines.push(`- Empresa: ${learnerProfile.company}`);
+  lines.push(`- Produtos/servi\xE7os: ${learnerProfile.productsOrServices}`);
+  lines.push(`- Regi\xE3o: ${learnerProfile.region}`);
+  lines.push(`- Equipe: ${learnerProfile.team}`);
+  lines.push(`- Objetivo: ${learnerProfile.goal}`);
+  lines.push(`- N\xEDvel declarado do aluno: ${formatCourseLevel(learnerProfile.learnerLevel)}`);
+  if (learnerProfile.adaptToRealContext) {
+    lines.push(
+      "- Use o contexto do aluno como padr\xE3o para explica\xE7\xF5es, exemplos, exerc\xEDcios e framing."
+    );
+    lines.push(
+      "- Troque nomes, entreg\xE1veis e restri\xE7\xF5es do cen\xE1rio fict\xEDcio por equivalentes reais."
+    );
+    lines.push(
+      "- Preserve objetivos pedag\xF3gicos, crit\xE9rios de valida\xE7\xE3o e progress\xE3o de dificuldade."
+    );
+  } else {
+    lines.push(
+      "- Preserve o cen\xE1rio fict\xEDcio como padr\xE3o e conecte os conceitos ao neg\xF3cio real quando isso ajudar."
+    );
+    lines.push(
+      "- Se o aluno quiser migrar para o contexto real depois, oriente a rodar `tostudy init` novamente."
+    );
+  }
+  if (mode === "guided") {
+    lines.push(
+      "- No modo guiado, explique o porqu\xEA de cada passo, proponha checkpoints curtos e confirme entendimento antes de avan\xE7ar."
+    );
+  } else if (mode === "direct") {
+    lines.push(
+      "- Mesmo no modo mais direto, continue sem dar a resposta pronta e preserve a progress\xE3o pedag\xF3gica."
+    );
+  } else {
+    lines.push(
+      "- No modo equilibrado, combine explica\xE7\xF5es curtas com autonomia entre checkpoints."
+    );
+  }
+  return lines.join("\n");
+}
+function buildLearnerBrief(userName, course, learnerProfile) {
+  const lines = [];
+  lines.push("# ToStudy CLI \u2014 Brief do Aluno");
+  lines.push("");
+  lines.push("Este documento resume o contexto real do aluno para orientar exemplos e exercicios.");
+  lines.push("");
+  lines.push("## 1. Identificacao");
+  lines.push(`- Aluno: ${userName}`);
+  lines.push(`- Curso: "${course.title}"`);
+  lines.push(`- Segmento: ${learnerProfile.segment}`);
+  lines.push(`- Empresa: ${learnerProfile.company}`);
+  lines.push(`- Produtos/servicos: ${learnerProfile.productsOrServices}`);
+  lines.push(`- Regiao: ${learnerProfile.region}`);
+  lines.push(`- Equipe: ${learnerProfile.team}`);
+  lines.push("");
+  lines.push("## 2. Objetivo e Contexto");
+  lines.push(`- Objetivo principal: ${learnerProfile.goal}`);
+  lines.push(`- Nivel do aluno: ${formatCourseLevel(learnerProfile.learnerLevel)}`);
+  lines.push(
+    `- Adaptar curso ao contexto real: ${learnerProfile.adaptToRealContext ? "Sim" : "Nao"}`
+  );
+  lines.push("");
+  lines.push("## 3. Como usar este brief");
+  lines.push("- Reutilize este contexto para adaptar exemplos, cenarios e exercicios.");
+  lines.push("- Preserve a proposta pedagogica do curso antes de customizar o contexto.");
+  lines.push(
+    "- Se algo mudar no negocio do aluno, rode `tostudy init` novamente para atualizar o brief."
+  );
+  return lines.join("\n");
+}
+function buildInitArtifacts(userName, course, progress3, learnerProfile) {
+  return {
+    tutorInstructions: [
+      buildInitTemplate(userName, course, progress3),
+      buildTutorPersonalizationSection(course, learnerProfile)
+    ].join("\n\n"),
+    learnerBrief: buildLearnerBrief(userName, course, learnerProfile)
+  };
+}
+var LANGUAGE_TAGS;
+var init_init_template = __esm({
+  "src/output/init-template.ts"() {
+    "use strict";
+    LANGUAGE_TAGS = {
+      javascript: "JavaScript",
+      typescript: "TypeScript",
+      python: "Python",
+      react: "React",
+      "react-native": "React Native",
+      node: "Node.js",
+      nodejs: "Node.js",
+      go: "Go",
+      rust: "Rust",
+      java: "Java",
+      csharp: "C#",
+      "c#": "C#",
+      cpp: "C++",
+      ruby: "Ruby",
+      php: "PHP",
+      swift: "Swift",
+      kotlin: "Kotlin",
+      html: "HTML",
+      css: "CSS",
+      sql: "SQL",
+      vue: "Vue.js",
+      angular: "Angular",
+      nextjs: "Next.js",
+      svelte: "Svelte"
+    };
+  }
+});
+
 // src/commands/validate.ts
-import fs7 from "node:fs";
-import path6 from "node:path";
+import fs9 from "node:fs";
+import path10 from "node:path";
 import { Command as Command13 } from "commander";
-var logger12, validateCommand;
+var logger14, validateCommand;
 var init_validate = __esm({
   "src/commands/validate.ts"() {
     "use strict";
@@ -41325,7 +41945,7 @@ var init_validate = __esm({
     init_session();
     init_formatter();
     init_init_template();
-    logger12 = createLogger("cli:validate");
+    logger14 = createLogger("cli:validate");
     validateCommand = new Command13("validate").description("Validate your solution for the current exercise").argument("[file]", "Path to the solution file to read").option("--stdin", "Read solution from stdin instead of a file").option("--json", "Output structured JSON").action(async (file2, opts) => {
       try {
         const session = await requireSession();
@@ -41334,21 +41954,26 @@ var init_validate = __esm({
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const lessonId = activeCourse.currentLessonId;
         if (!lessonId) {
+          if (opts.json) jsonError("no_active_lesson", { message: "Nenhuma li\xE7\xE3o ativa encontrada" });
           error("Nenhuma li\xE7\xE3o ativa encontrada. Rode: tostudy start  ou  tostudy next");
         }
         let solution;
         if (opts.stdin) {
-          solution = fs7.readFileSync("/dev/stdin", "utf-8");
+          solution = fs9.readFileSync("/dev/stdin", "utf-8");
         } else if (file2) {
-          if (!fs7.existsSync(file2)) {
+          if (!fs9.existsSync(file2)) {
+            if (opts.json)
+              jsonError("file_not_found", { message: `Arquivo n\xE3o encontrado: ${file2}` });
             error(`Arquivo n\xE3o encontrado: ${file2}`);
           }
-          solution = fs7.readFileSync(file2, "utf-8");
+          solution = fs9.readFileSync(file2, "utf-8");
         } else {
+          if (opts.json)
+            jsonError("no_solution_provided", { message: "Forne\xE7a um arquivo ou use --stdin" });
           error("Forne\xE7a um arquivo ou use --stdin.\n\nExemplo: tostudy validate resposta.md");
         }
         if (file2 && activeCourse.courseTags?.length) {
-          const ext = path6.extname(file2).toLowerCase();
+          const ext = path10.extname(file2).toLowerCase();
           const LANG_EXTENSIONS = {
             ".html": ["html", "html5"],
             ".css": ["css"],
@@ -41384,7 +42009,7 @@ var init_validate = __esm({
           }
         }
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger12 };
+        const deps = { data, logger: logger14 };
         const result = await validateSolution(
           {
             lessonId,
@@ -41402,6 +42027,7 @@ var init_validate = __esm({
         process.exit(result.passed ? 0 : 1);
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -41415,10 +42041,12 @@ var init_menu = __esm({
   "src/commands/menu.ts"() {
     "use strict";
     init_session();
+    init_workspace_state();
     init_formatter();
     menuCommand = new Command14("menu").description("Show available commands and current study context").action(async () => {
       const session = await getSession();
-      const activeCourse = session ? await getActiveCourse() : null;
+      const wsResult = session ? await findWorkspaceState() : null;
+      const activeCourse = wsResult?.state ?? null;
       const lines = [
         "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
         "\u2502             ToStudy CLI \u2014 Menu              \u2502",
@@ -41473,9 +42101,9 @@ var init_menu = __esm({
 });
 
 // src/onboarding/learner-context.ts
-import readline from "node:readline/promises";
+import readline2 from "node:readline/promises";
 import { stdin as input, stdout as output2 } from "node:process";
-async function askNonEmpty(question, deps, defaultValue) {
+async function askNonEmpty2(question, deps, defaultValue) {
   while (true) {
     const answer = (await deps.ask(question)).trim();
     if (answer.length > 0) return answer;
@@ -41491,7 +42119,7 @@ async function askChoice(question, choices, deps, defaultChoice) {
   }
 }
 function createPromptDeps() {
-  const rl = readline.createInterface({ input, output: output2 });
+  const rl = readline2.createInterface({ input, output: output2 });
   return {
     ask: (question) => rl.question(question),
     write: (content) => output2.write(content),
@@ -41524,32 +42152,32 @@ async function collectLearnerContextProfileWithDeps(input2, deps) {
     "keep"
   ) : "edit";
   const baseProfile = existingProfile;
-  const segment = action === "keep" && baseProfile ? baseProfile.segment : await askNonEmpty(
+  const segment = action === "keep" && baseProfile ? baseProfile.segment : await askNonEmpty2(
     baseProfile ? `Segmento ou nicho do aluno [${baseProfile.segment}]: ` : "Segmento ou nicho do aluno: ",
     deps,
     baseProfile?.segment
   );
-  const company = action === "keep" && baseProfile ? baseProfile.company : await askNonEmpty(
+  const company = action === "keep" && baseProfile ? baseProfile.company : await askNonEmpty2(
     baseProfile ? `Empresa ou tipo de negocio [${baseProfile.company}]: ` : "Empresa ou tipo de negocio: ",
     deps,
     baseProfile?.company
   );
-  const productsOrServices = action === "keep" && baseProfile ? baseProfile.productsOrServices : await askNonEmpty(
+  const productsOrServices = action === "keep" && baseProfile ? baseProfile.productsOrServices : await askNonEmpty2(
     baseProfile ? `Produtos ou servicos principais [${baseProfile.productsOrServices}]: ` : "Produtos ou servicos principais: ",
     deps,
     baseProfile?.productsOrServices
   );
-  const region = action === "keep" && baseProfile ? baseProfile.region : await askNonEmpty(
+  const region = action === "keep" && baseProfile ? baseProfile.region : await askNonEmpty2(
     baseProfile ? `Regiao de atuacao [${baseProfile.region}]: ` : "Regiao de atuacao: ",
     deps,
     baseProfile?.region
   );
-  const team = action === "keep" && baseProfile ? baseProfile.team : await askNonEmpty(
+  const team = action === "keep" && baseProfile ? baseProfile.team : await askNonEmpty2(
     baseProfile ? `Equipe envolvida neste contexto [${baseProfile.team}]: ` : "Equipe envolvida neste contexto: ",
     deps,
     baseProfile?.team
   );
-  const goal = action === "keep" && baseProfile ? baseProfile.goal : await askNonEmpty(
+  const goal = action === "keep" && baseProfile ? baseProfile.goal : await askNonEmpty2(
     baseProfile ? `Objetivo principal com este curso [${baseProfile.goal}]: ` : "Objetivo principal com este curso: ",
     deps,
     baseProfile?.goal
@@ -41598,7 +42226,7 @@ function isCompleteProfile(flags) {
     flags.segment && flags.company && flags.products && flags.region && flags.team && flags.goal && flags.level
   );
 }
-async function runInit(deps = defaultDeps3, flags = {}) {
+async function runInit(deps = defaultDeps4, flags = {}) {
   const session = await deps.getSession();
   if (!session) {
     deps.output("Nao autenticado. Rode `tostudy login` para comecar.", { json: false });
@@ -41606,7 +42234,8 @@ async function runInit(deps = defaultDeps3, flags = {}) {
   }
   const data = deps.createHttpProvider(session.apiUrl, session.token);
   const apiDeps = { data, logger: deps.logger };
-  const activeCourse = await deps.getActiveCourse();
+  const wsResult = await deps.findWorkspaceState();
+  const activeCourse = wsResult?.state ?? null;
   if (!activeCourse) {
     try {
       const courses3 = await deps.listCourses({ userId: session.userId }, apiDeps);
@@ -41713,22 +42342,20 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
   });
   await deps.saveCourseLearnerProfile(activeCourse, learnerProfile, artifacts);
   try {
-    generateInstructionFiles(
-      {
-        courseTitle: matchedCourse.title,
-        courseId: activeCourse.courseId,
-        progress: progressData?.coursePercent ?? matchedCourse.progress ?? 0,
-        moduleCount: progressData?.currentModule?.totalModules ?? 0,
-        lessonCount: progressData?.currentLesson?.totalLessons ?? 0,
-        currentModuleTitle: progressData?.currentModule?.title,
-        currentLessonTitle: progressData?.currentLesson?.title,
-        courseDescription: matchedCourse.description ?? void 0
-      },
-      learnerProfile
+    const pipelineResult = await deps.resolveAndGenerate(
+      { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
+      { forceRefresh: false, collectT1Interactive: true, collectT2Interactive: false },
+      { cwd: process.cwd(), deps: deps.buildPipelineDeps() }
     );
-    deps.logger.info("Instruction files enriched with learner profile");
+    deps.logger.info("Instruction files regenerated via pipeline", {
+      wroteFiles: pipelineResult.wroteFiles,
+      usedT0: pipelineResult.usedT0,
+      usedT1: pipelineResult.usedT1,
+      usedT2: pipelineResult.usedT2,
+      bootstrapped: pipelineResult.bootstrapped
+    });
   } catch (err) {
-    deps.logger.warn("Failed to update instruction files", {
+    deps.logger.warn("Failed to run instruction pipeline", {
       error: err instanceof Error ? err.message : String(err)
     });
   }
@@ -41744,7 +42371,7 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
     deps.output(artifacts.learnerBrief, { json: false });
   }
 }
-var logger13, defaultDeps3, initCommand;
+var logger15, defaultDeps4, initCommand;
 var init_init = __esm({
   "src/commands/init.ts"() {
     "use strict";
@@ -41752,15 +42379,17 @@ var init_init = __esm({
     init_courses();
     init_http2();
     init_session();
+    init_workspace_state();
     init_formatter();
     init_init_template();
     init_learner_context();
-    init_api();
-    init_instruction_files();
-    logger13 = createLogger("cli:init");
-    defaultDeps3 = {
+    init_api3();
+    init_instruction_pipeline();
+    init_pipeline_deps();
+    logger15 = createLogger("cli:init");
+    defaultDeps4 = {
       getSession,
-      getActiveCourse,
+      findWorkspaceState,
       listCourses,
       getProgress,
       getRemoteEnrollmentOnboarding,
@@ -41771,24 +42400,26 @@ var init_init = __esm({
       saveCourseLearnerProfile,
       buildInitArtifacts,
       output,
-      logger: logger13,
-      createHttpProvider
+      logger: logger15,
+      createHttpProvider,
+      resolveAndGenerate,
+      buildPipelineDeps
     };
     initCommand = new Command15("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) => {
-      await runInit(defaultDeps3, opts);
+      await runInit(defaultDeps4, opts);
     });
   }
 });
 
 // ../../packages/tostudy-core/src/workspace/setup-workspace.ts
-import fs8 from "node:fs/promises";
-import path7 from "node:path";
+import fs10 from "node:fs/promises";
+import path11 from "node:path";
 async function setupWorkspace(input2) {
-  const workspacePath = path7.join(input2.basePath, input2.courseSlug);
+  const workspacePath = path11.join(input2.basePath, input2.courseSlug);
   for (const dir of WORKSPACE_DIRS) {
-    await fs8.mkdir(path7.join(workspacePath, dir), { recursive: true });
+    await fs10.mkdir(path11.join(workspacePath, dir), { recursive: true });
   }
-  const configPath = path7.join(workspacePath, ".ana-config.json");
+  const configPath = path11.join(workspacePath, ".ana-config.json");
   const config2 = {
     courseId: input2.courseId,
     courseSlug: input2.courseSlug,
@@ -41798,7 +42429,7 @@ async function setupWorkspace(input2) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     lastAccessedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  await fs8.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
+  await fs10.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
   const readme = [
     `# ${input2.courseName}`,
     "",
@@ -41823,7 +42454,7 @@ async function setupWorkspace(input2) {
     "tostudy vault sync      # Sincronizar progresso",
     "```"
   ].join("\n");
-  await fs8.writeFile(path7.join(workspacePath, "README.md"), readme, "utf-8");
+  await fs10.writeFile(path11.join(workspacePath, "README.md"), readme, "utf-8");
   return { workspacePath, directories: WORKSPACE_DIRS, configPath };
 }
 var WORKSPACE_DIRS;
@@ -41924,8 +42555,8 @@ var init_templates = __esm({
 });
 
 // ../../packages/tostudy-core/src/workspace/extract-exercise.ts
-import fs9 from "node:fs/promises";
-import path8 from "node:path";
+import fs11 from "node:fs/promises";
+import path12 from "node:path";
 function padOrder(n) {
   return String(n).padStart(2, "0");
 }
@@ -41949,16 +42580,16 @@ async function extractExercise(input2) {
   const { lessonData, exerciseTier, workspacePath } = input2;
   const moduleDir = `${padOrder(lessonData.moduleOrder)}-${lessonData.moduleSlug}`;
   const lessonDir = `${padOrder(lessonData.lessonOrder)}-${lessonData.lessonSlug}`;
-  const exercisePath = path8.join(workspacePath, "exercises", moduleDir, lessonDir);
-  await fs9.mkdir(exercisePath, { recursive: true });
+  const exercisePath = path12.join(workspacePath, "exercises", moduleDir, lessonDir);
+  await fs11.mkdir(exercisePath, { recursive: true });
   const extractedFiles = [];
   let hasStarterCode = false;
   if (lessonData.sandpackConfig?.files) {
     for (const [filePath, fileData] of Object.entries(lessonData.sandpackConfig.files)) {
       const cleanPath = filePath.startsWith("/") ? filePath.slice(1) : filePath;
-      const fullPath = path8.join(exercisePath, cleanPath);
-      await fs9.mkdir(path8.dirname(fullPath), { recursive: true });
-      await fs9.writeFile(fullPath, fileData.code, "utf-8");
+      const fullPath = path12.join(exercisePath, cleanPath);
+      await fs11.mkdir(path12.dirname(fullPath), { recursive: true });
+      await fs11.writeFile(fullPath, fileData.code, "utf-8");
       extractedFiles.push(cleanPath);
       hasStarterCode = true;
     }
@@ -41966,13 +42597,13 @@ async function extractExercise(input2) {
     const tierData = getTierData(lessonData.structuredData, exerciseTier);
     const tierCode = tierData?.code;
     if (tierCode) {
-      await fs9.writeFile(path8.join(exercisePath, "exercise.js"), tierCode, "utf-8");
+      await fs11.writeFile(path12.join(exercisePath, "exercise.js"), tierCode, "utf-8");
       extractedFiles.push("exercise.js");
       hasStarterCode = true;
     } else {
       const starter = getStarterCode(lessonData.structuredData);
       if (starter) {
-        await fs9.writeFile(path8.join(exercisePath, "exercise.js"), starter, "utf-8");
+        await fs11.writeFile(path12.join(exercisePath, "exercise.js"), starter, "utf-8");
         extractedFiles.push("exercise.js");
         hasStarterCode = true;
       }
@@ -41990,8 +42621,8 @@ async function extractExercise(input2) {
           ...exerciseDeps
         }
       };
-      await fs9.writeFile(
-        path8.join(exercisePath, "package.json"),
+      await fs11.writeFile(
+        path12.join(exercisePath, "package.json"),
         JSON.stringify(pkgJson, null, 2),
         "utf-8"
       );
@@ -42003,20 +42634,20 @@ async function extractExercise(input2) {
       );
       for (const [configFile, configContent] of Object.entries(scaffold.configs)) {
         if (!sandpackFileNames.has(configFile)) {
-          await fs9.writeFile(path8.join(exercisePath, configFile), configContent, "utf-8");
+          await fs11.writeFile(path12.join(exercisePath, configFile), configContent, "utf-8");
           extractedFiles.push(configFile);
         }
       }
       const setupSh = `#!/bin/sh
 ${scaffold.setupScript}
 `;
-      await fs9.writeFile(path8.join(exercisePath, "setup.sh"), setupSh, "utf-8");
+      await fs11.writeFile(path12.join(exercisePath, "setup.sh"), setupSh, "utf-8");
       extractedFiles.push("setup.sh");
     }
   }
   const readme = generateReadme(lessonData, exerciseTier);
-  const readmePath = path8.join(exercisePath, "README.md");
-  await fs9.writeFile(readmePath, readme, "utf-8");
+  const readmePath = path12.join(exercisePath, "README.md");
+  await fs11.writeFile(readmePath, readme, "utf-8");
   extractedFiles.push("README.md");
   return {
     exercisePath,
@@ -42088,10 +42719,10 @@ var init_workspace = __esm({
 
 // src/commands/workspace.ts
 import { Command as Command16 } from "commander";
-import path9 from "node:path";
-import os9 from "node:os";
-import fs10 from "node:fs/promises";
-var logger14, workspaceCommand;
+import path13 from "node:path";
+import os12 from "node:os";
+import fs12 from "node:fs/promises";
+var logger16, workspaceCommand;
 var init_workspace2 = __esm({
   "src/commands/workspace.ts"() {
     "use strict";
@@ -42099,7 +42730,7 @@ var init_workspace2 = __esm({
     init_workspace();
     init_session();
     init_resolve();
-    logger14 = createLogger("cli:workspace");
+    logger16 = createLogger("cli:workspace");
     workspaceCommand = new Command16("workspace").description(
       "Gerenciar workspace de estudo local"
     );
@@ -42112,14 +42743,14 @@ var init_workspace2 = __esm({
         let directories;
         if (!opts.path && cwdIsWorkspace) {
           const resolvedCwd = await resolveCwdWorkspacePath(process.cwd());
-          workspacePath = resolvedCwd ?? path9.join(process.cwd(), ".tostudy");
-          await fs10.mkdir(workspacePath, { recursive: true });
+          workspacePath = resolvedCwd ?? path13.join(process.cwd(), ".tostudy");
+          await fs12.mkdir(workspacePath, { recursive: true });
           directories = ["exercises", "generated", "notes", "diagrams"];
           for (const dir of directories) {
-            await fs10.mkdir(path9.join(workspacePath, dir), { recursive: true });
+            await fs12.mkdir(path13.join(workspacePath, dir), { recursive: true });
           }
-          const configPath = path9.join(workspacePath, ".ana-config.json");
-          await fs10.writeFile(
+          const configPath = path13.join(workspacePath, ".ana-config.json");
+          await fs12.writeFile(
             configPath,
             JSON.stringify(
               {
@@ -42137,7 +42768,7 @@ var init_workspace2 = __esm({
             "utf-8"
           );
         } else {
-          const basePath = opts.path ?? path9.join(os9.homedir(), "study");
+          const basePath = opts.path ?? path13.join(os12.homedir(), "study");
           const result2 = await setupWorkspace({
             courseId: activeCourse.courseId,
             courseSlug: courseSlug(activeCourse.courseTitle),
@@ -42165,13 +42796,13 @@ Pr\xF3ximo passo: tostudy export
           );
         }
       } catch (err) {
-        logger14.error("workspace setup failed", { error: err });
+        logger16.error("workspace setup failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
       }
     });
-    workspaceCommand.command("status").description("Mostrar status do workspace do curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path9.join(os9.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    workspaceCommand.command("status").description("Mostrar status do workspace do curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path13.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
         const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -42190,40 +42821,40 @@ Pr\xF3ximo passo: tostudy export
         const workspacePath = ws.workspacePath;
         let configData = null;
         try {
-          const raw = await fs10.readFile(path9.join(workspacePath, ".ana-config.json"), "utf-8");
+          const raw = await fs12.readFile(path13.join(workspacePath, ".ana-config.json"), "utf-8");
           configData = JSON.parse(raw);
         } catch {
           configData = null;
         }
-        const exercisesDir = path9.join(workspacePath, "exercises");
+        const exercisesDir = path13.join(workspacePath, "exercises");
         let exerciseCount = 0;
         try {
-          const moduleDirs = await fs10.readdir(exercisesDir);
+          const moduleDirs = await fs12.readdir(exercisesDir);
           for (const modDir of moduleDirs) {
-            const modPath = path9.join(exercisesDir, modDir);
-            const stat = await fs10.stat(modPath);
+            const modPath = path13.join(exercisesDir, modDir);
+            const stat = await fs12.stat(modPath);
             if (stat.isDirectory()) {
-              const lessonDirs = await fs10.readdir(modPath);
+              const lessonDirs = await fs12.readdir(modPath);
               for (const lessonDir of lessonDirs) {
-                const lessonPath = path9.join(modPath, lessonDir);
-                const lstat = await fs10.stat(lessonPath);
+                const lessonPath = path13.join(modPath, lessonDir);
+                const lstat = await fs12.stat(lessonPath);
                 if (lstat.isDirectory()) exerciseCount++;
               }
             }
           }
         } catch {
         }
-        const generatedDir = path9.join(workspacePath, "generated");
+        const generatedDir = path13.join(workspacePath, "generated");
         let artifactCount = 0;
         try {
-          const files = await fs10.readdir(generatedDir);
+          const files = await fs12.readdir(generatedDir);
           artifactCount = files.length;
         } catch {
         }
-        const diagramsDir = path9.join(workspacePath, "diagrams");
+        const diagramsDir = path13.join(workspacePath, "diagrams");
         let diagramCount = 0;
         try {
-          const files = await fs10.readdir(diagramsDir);
+          const files = await fs12.readdir(diagramsDir);
           diagramCount = files.length;
         } catch {
         }
@@ -42272,10 +42903,10 @@ Pr\xF3ximo passo: tostudy export
 
 // src/commands/export.ts
 import { Command as Command17 } from "commander";
-import path10 from "node:path";
-import os10 from "node:os";
-import fs11 from "node:fs/promises";
-var logger15, exportCommand;
+import path14 from "node:path";
+import os13 from "node:os";
+import fs13 from "node:fs/promises";
+var logger17, exportCommand;
 var init_export = __esm({
   "src/commands/export.ts"() {
     "use strict";
@@ -42284,8 +42915,8 @@ var init_export = __esm({
     init_http2();
     init_session();
     init_resolve();
-    logger15 = createLogger("cli:export");
-    exportCommand = new Command17("export").description("Extrair exerc\xEDcio atual para o workspace local").option("--tier <tier>", "Tier do exerc\xEDcio: guided, semiGuided, challenging", "guided").option("--path <dir>", "Diret\xF3rio base do workspace", path10.join(os10.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    logger17 = createLogger("cli:export");
+    exportCommand = new Command17("export").description("Extrair exerc\xEDcio atual para o workspace local").option("--tier <tier>", "Tier do exerc\xEDcio: guided, semiGuided, challenging", "guided").option("--path <dir>", "Diret\xF3rio base do workspace", path14.join(os13.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -42303,21 +42934,21 @@ var init_export = __esm({
           opts.path
         );
         if (ws.found && ws.source === "cwd" && ws.workspacePath) {
-          const configPath = path10.join(ws.workspacePath, ".ana-config.json");
+          const configPath = path14.join(ws.workspacePath, ".ana-config.json");
           let hasConfig = false;
           try {
-            await fs11.access(configPath);
+            await fs13.access(configPath);
             hasConfig = true;
           } catch {
           }
           if (!hasConfig) {
             const slug = courseSlug(activeCourse.courseTitle);
-            logger15.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
-            await fs11.mkdir(ws.workspacePath, { recursive: true });
+            logger17.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
+            await fs13.mkdir(ws.workspacePath, { recursive: true });
             for (const dir of ["exercises", "generated", "notes", "diagrams"]) {
-              await fs11.mkdir(path10.join(ws.workspacePath, dir), { recursive: true });
+              await fs13.mkdir(path14.join(ws.workspacePath, dir), { recursive: true });
             }
-            await fs11.writeFile(
+            await fs13.writeFile(
               configPath,
               JSON.stringify(
                 {
@@ -42335,7 +42966,7 @@ var init_export = __esm({
               "utf-8"
             );
             await setCourseWorkspacePath(activeCourse.courseId, ws.workspacePath);
-            const isNamespaced = ws.workspacePath === path10.join(process.cwd(), ".tostudy");
+            const isNamespaced = ws.workspacePath === path14.join(process.cwd(), ".tostudy");
             process.stderr.write(
               isNamespaced ? `\u2728 Workspace inicializado em .tostudy/ (isolado do projeto).
 ` : `\u2728 Workspace inicializado nesta pasta.
@@ -42376,7 +43007,7 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
           );
         }
       } catch (err) {
-        logger15.error("export failed", { error: err });
+        logger17.error("export failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -42388,17 +43019,17 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
 // src/commands/open.ts
 import { Command as Command18 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
-import path11 from "node:path";
-import os11 from "node:os";
-var logger16, openCommand;
+import path15 from "node:path";
+import os14 from "node:os";
+var logger18, openCommand;
 var init_open = __esm({
   "src/commands/open.ts"() {
     "use strict";
     init_src();
     init_session();
     init_resolve();
-    logger16 = createLogger("cli:open");
-    openCommand = new Command18("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path11.join(os11.homedir(), "study")).action(async (opts) => {
+    logger18 = createLogger("cli:open");
+    openCommand = new Command18("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path15.join(os14.homedir(), "study")).action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
         const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
@@ -42417,7 +43048,7 @@ var init_open = __esm({
         const editor = process.env["EDITOR"] ?? "code";
         execFile3(editor, [ws.workspacePath], (err) => {
           if (err) {
-            logger16.error("open failed", { editor, workspacePath: ws.workspacePath });
+            logger18.error("open failed", { editor, workspacePath: ws.workspacePath });
             process.stderr.write(`\u274C Falha ao abrir: ${err.message}
 `);
             process.exit(1);
@@ -42426,7 +43057,7 @@ var init_open = __esm({
 `);
         });
       } catch (err) {
-        logger16.error("open command failed", { error: err });
+        logger18.error("open command failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -42453,24 +43084,24 @@ var init_types3 = __esm({
 });
 
 // ../../packages/tostudy-core/src/vault/write-vault.ts
-import fs12 from "node:fs/promises";
-import path12 from "node:path";
+import fs14 from "node:fs/promises";
+import path16 from "node:path";
 async function writeVaultFiles(files, outputPath, courseId, courseSlug2) {
   for (const file2 of files) {
-    const fullPath = path12.join(outputPath, file2.relativePath);
-    await fs12.mkdir(path12.dirname(fullPath), { recursive: true });
-    await fs12.writeFile(fullPath, file2.content, "utf-8");
+    const fullPath = path16.join(outputPath, file2.relativePath);
+    await fs14.mkdir(path16.dirname(fullPath), { recursive: true });
+    await fs14.writeFile(fullPath, file2.content, "utf-8");
   }
-  const vaultPath = path12.join(outputPath, courseSlug2);
+  const vaultPath = path16.join(outputPath, courseSlug2);
   const marker = {
     courseId,
     courseSlug: courseSlug2,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     version: VAULT_MARKER_VERSION
   };
-  await fs12.mkdir(vaultPath, { recursive: true });
-  await fs12.writeFile(
-    path12.join(vaultPath, VAULT_MARKER_FILENAME),
+  await fs14.mkdir(vaultPath, { recursive: true });
+  await fs14.writeFile(
+    path16.join(vaultPath, VAULT_MARKER_FILENAME),
     JSON.stringify(marker, null, 2),
     "utf-8"
   );
@@ -42495,10 +43126,10 @@ var init_vault = __esm({
 
 // src/commands/vault.ts
 import { Command as Command19 } from "commander";
-import path13 from "node:path";
-import os12 from "node:os";
-import fs13 from "node:fs/promises";
-var logger17, vaultCommand;
+import path17 from "node:path";
+import os15 from "node:os";
+import fs15 from "node:fs/promises";
+var logger19, vaultCommand;
 var init_vault2 = __esm({
   "src/commands/vault.ts"() {
     "use strict";
@@ -42508,9 +43139,9 @@ var init_vault2 = __esm({
     init_http2();
     init_session();
     init_resolve();
-    logger17 = createLogger("cli:vault");
+    logger19 = createLogger("cli:vault");
     vaultCommand = new Command19("vault").description("Gerenciar vault Obsidian do curso");
-    vaultCommand.command("init").description("Gerar vault Obsidian para o curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path13.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    vaultCommand.command("init").description("Gerar vault Obsidian para o curso ativo").option("--path <dir>", "Diret\xF3rio base do workspace", path17.join(os15.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -42555,7 +43186,7 @@ var init_vault2 = __esm({
           activeCourse.courseId,
           slug
         );
-        logger17.info("Vault generated", {
+        logger19.info("Vault generated", {
           courseId: activeCourse.courseId,
           vaultPath: result.vaultPath,
           filesWritten: result.filesWritten
@@ -42588,13 +43219,13 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger17.error("vault init failed", { error: err });
+        logger19.error("vault init failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
       }
     });
-    vaultCommand.command("sync").description("Sincronizar progresso do curso com o vault local").option("--path <dir>", "Diret\xF3rio base do workspace", path13.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
+    vaultCommand.command("sync").description("Sincronizar progresso do curso com o vault local").option("--path <dir>", "Diret\xF3rio base do workspace", path17.join(os15.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
@@ -42620,10 +43251,10 @@ Para visualizar:
           process.exit(1);
         }
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger17 };
+        const deps = { data, logger: logger19 };
         const progress3 = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
-        const markerPath = path13.join(vaultPath, ".ana-vault.json");
-        const markerRaw = await fs13.readFile(markerPath, "utf-8");
+        const markerPath = path17.join(vaultPath, ".ana-vault.json");
+        const markerRaw = await fs15.readFile(markerPath, "utf-8");
         const marker = JSON.parse(markerRaw);
         marker.lastSyncedAt = (/* @__PURE__ */ new Date()).toISOString();
         marker.progress = {
@@ -42631,10 +43262,10 @@ Para visualizar:
           currentModule: progress3.currentModule.title,
           currentLesson: progress3.currentLesson.title
         };
-        await fs13.writeFile(markerPath, JSON.stringify(marker, null, 2), "utf-8");
-        const courseIndexPath = path13.join(vaultPath, slug, "index.md");
+        await fs15.writeFile(markerPath, JSON.stringify(marker, null, 2), "utf-8");
+        const courseIndexPath = path17.join(vaultPath, slug, "index.md");
         try {
-          let indexContent = await fs13.readFile(courseIndexPath, "utf-8");
+          let indexContent = await fs15.readFile(courseIndexPath, "utf-8");
           indexContent = indexContent.replace(/\n---\n\n> 📊 Progresso:.*\n/g, "");
           const titleEnd = indexContent.indexOf("\n");
           if (titleEnd !== -1) {
@@ -42645,7 +43276,7 @@ Para visualizar:
 `;
             indexContent = indexContent.slice(0, titleEnd) + banner + indexContent.slice(titleEnd);
           }
-          await fs13.writeFile(courseIndexPath, indexContent, "utf-8");
+          await fs15.writeFile(courseIndexPath, indexContent, "utf-8");
         } catch {
         }
         const syncedAt = marker.lastSyncedAt;
@@ -42674,7 +43305,7 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger17.error("vault sync failed", { error: err });
+        logger19.error("vault sync failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -42752,68 +43383,349 @@ var init_profile = __esm({
 
 // src/commands/sync.ts
 import { Command as Command21 } from "commander";
-var logger18, syncCommand;
+var logger20, syncCommand;
 var init_sync = __esm({
   "src/commands/sync.ts"() {
     "use strict";
     init_src();
-    init_courses();
-    init_http2();
     init_session();
     init_formatter();
-    init_instruction_files();
-    init_status();
-    logger18 = createLogger("cli:sync");
+    init_instruction_pipeline();
+    init_pipeline_deps();
+    logger20 = createLogger("cli:sync");
     syncCommand = new Command21("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").action(async (opts) => {
       try {
-        const session = await requireSession();
+        await requireSession();
         const activeCourse = await requireActiveCourse();
-        const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger18 };
-        const [courses3, progressData] = await Promise.all([
-          listCourses({ userId: session.userId }, deps),
-          getProgress({ enrollmentId: activeCourse.enrollmentId }, deps).catch(() => null)
-        ]);
-        const matchedCourse = courses3.find((c) => c.courseId === activeCourse.courseId);
-        if (!matchedCourse) {
-          error("Curso ativo n\xE3o encontrado. Rode `tostudy courses` para verificar.");
-        }
-        const onboardingState = await getCourseOnboardingState(activeCourse.courseId);
-        const onboarding = await getCourseOnboardingStatus(activeCourse);
-        const slug = generateInstructionFiles(
-          {
-            courseTitle: matchedCourse.title,
-            courseId: activeCourse.courseId,
-            progress: progressData?.coursePercent ?? matchedCourse.progress ?? 0,
-            moduleCount: progressData?.currentModule?.totalModules ?? 0,
-            lessonCount: progressData?.currentLesson?.totalLessons ?? 0,
-            currentModuleTitle: progressData?.currentModule?.title,
-            currentLessonTitle: progressData?.currentLesson?.title,
-            courseDescription: matchedCourse.description ?? void 0,
-            workspaceReady: onboarding.workspaceReady,
-            workspacePath: onboarding.workspacePath ?? void 0
-          },
-          onboardingState?.learnerProfile
+        const pipelineResult = await resolveAndGenerate(
+          { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
+          { forceRefresh: true, collectT1Interactive: false, collectT2Interactive: false },
+          { cwd: process.cwd(), deps: buildPipelineDeps() }
         );
         if (opts.json) {
           output(
             {
               status: "ok",
               courseId: activeCourse.courseId,
-              slug,
-              progress: progressData?.coursePercent ?? matchedCourse.progress ?? 0
+              courseTitle: activeCourse.courseTitle,
+              wroteFiles: pipelineResult.wroteFiles,
+              markerPath: pipelineResult.markerPath,
+              usedT0: pipelineResult.usedT0,
+              usedT1: pipelineResult.usedT1,
+              usedT2: pipelineResult.usedT2
             },
             { json: true }
           );
         } else {
-          const progress3 = progressData?.coursePercent ?? matchedCourse.progress ?? 0;
-          output(`\u2713 Instru\xE7\xF5es sincronizadas para "${matchedCourse.title}" (${progress3}%)`, {
-            json: false
-          });
+          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 }
+          );
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("process.exit")) return;
+        logger20.warn("sync failed", { error: msg });
+        error(msg);
+      }
+    });
+  }
+});
+
+// src/commands/brief.ts
+import { Command as Command22 } from "commander";
+var logger21, briefCommand;
+var init_brief = __esm({
+  "src/commands/brief.ts"() {
+    "use strict";
+    init_src();
+    init_session();
+    init_cache();
+    init_api();
+    init_formatter();
+    logger21 = createLogger("cli:brief");
+    briefCommand = new Command22("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
+      try {
+        const session = await requireSession();
+        const cached2 = await readBriefCache();
+        const remote = await fetchLearnerBrief({
+          apiUrl: session.apiUrl,
+          token: session.token
+        });
+        if (opts.json) {
+          output(
+            {
+              cached: cached2?.brief ?? null,
+              remote,
+              cacheFetchedAt: cached2?.fetchedAt ?? null
+            },
+            { json: true }
+          );
+          return;
+        }
+        if (!remote) {
+          const lines2 = [
+            "Voce ainda nao tem um brief base preenchido.",
+            "Para criar: `tostudy brief-create` (terminal) ou `tostudy brief-open` (portal web)."
+          ];
+          output(lines2.join("\n"), { json: false });
+          return;
+        }
+        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.");
+        }
+        output(lines.join("\n"), { json: false });
+      } catch (err) {
+        logger21.error("Failed to show brief", { err });
+        error(`Erro ao buscar brief: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    });
+  }
+});
+
+// src/commands/brief-create.ts
+import { Command as Command23 } from "commander";
+var logger22, briefCreateCommand;
+var init_brief_create = __esm({
+  "src/commands/brief-create.ts"() {
+    "use strict";
+    init_src();
+    init_session();
+    init_bootstrap();
+    init_api();
+    init_cache();
+    init_formatter();
+    logger22 = createLogger("cli:brief-create");
+    briefCreateCommand = new Command23("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
+      try {
+        const session = await requireSession();
+        const answers = await collectBootstrapAnswers({ userName: session.userName });
+        const text2 = composeBriefFromAnswers(answers);
+        const previewLines = ["", "Brief composto:", "---", text2, "---"];
+        output(previewLines.join("\n"), { json: false });
+        const brief = await upsertLearnerBrief({
+          apiUrl: session.apiUrl,
+          token: session.token,
+          text: text2,
+          source: "manual"
+        });
+        await writeBriefCache(void 0, {
+          userId: session.userId,
+          brief,
+          fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        const doneLines = [
+          "",
+          "Brief salvo. Rode `tostudy sync` para atualizar os instruction files."
+        ];
+        output(doneLines.join("\n"), { json: false });
+      } catch (err) {
+        logger22.error("Failed to create brief", { err });
+        error(`Erro ao criar brief: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    });
+  }
+});
+
+// src/commands/brief-open.ts
+import { Command as Command24 } from "commander";
+import { execFile as execFile4 } from "node:child_process";
+import { platform } from "node:process";
+function openUrl(url2) {
+  let cmd;
+  let args;
+  if (platform === "darwin") {
+    cmd = "open";
+    args = [url2];
+  } else if (platform === "win32") {
+    cmd = "cmd";
+    args = ["/c", "start", "", url2];
+  } else {
+    cmd = "xdg-open";
+    args = [url2];
+  }
+  execFile4(cmd, args, (err) => {
+    if (err) {
+      output(`Nao consegui abrir o navegador. Acesse manualmente: ${url2}`, { json: false });
+    }
+  });
+}
+var BRIEF_URL, briefOpenCommand;
+var init_brief_open = __esm({
+  "src/commands/brief-open.ts"() {
+    "use strict";
+    init_session();
+    init_formatter();
+    BRIEF_URL = "https://tostudy.ai/student/settings/learner-brief";
+    briefOpenCommand = new Command24("brief-open").description("Open the learner brief editor in your web browser").action(async () => {
+      await requireSession();
+      output(`Abrindo ${BRIEF_URL} no navegador...`, { json: false });
+      openUrl(BRIEF_URL);
+    });
+  }
+});
+
+// src/sessions/storage.ts
+import fs16 from "node:fs";
+import path18 from "node:path";
+function sessionsDir(workspacePath) {
+  return path18.join(workspacePath, ".tostudy", "sessions");
+}
+async function saveModuleSummary(workspacePath, input2) {
+  const dir = sessionsDir(workspacePath);
+  fs16.mkdirSync(dir, { recursive: true });
+  const filename = `module-${input2.moduleId}-summary.md`;
+  const filePath = path18.join(dir, filename);
+  const header = [
+    "---",
+    `moduleId: ${input2.moduleId}`,
+    `moduleTitle: "${input2.moduleTitle}"`,
+    `savedAt: "${(/* @__PURE__ */ new Date()).toISOString()}"`,
+    "---",
+    ""
+  ].join("\n");
+  fs16.writeFileSync(filePath, header + input2.summary, { mode: 384 });
+  logger23.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
+  return filePath;
+}
+async function loadSessionContext(workspacePath) {
+  const dir = sessionsDir(workspacePath);
+  if (!fs16.existsSync(dir)) return { moduleSummaries: [] };
+  const files = fs16.readdirSync(dir).filter((f) => f.startsWith("module-") && f.endsWith("-summary.md")).sort();
+  const summaries = [];
+  for (const file2 of files) {
+    const content = fs16.readFileSync(path18.join(dir, file2), "utf-8");
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) continue;
+    const meta3 = frontmatterMatch[1];
+    const body = frontmatterMatch[2].trim();
+    const moduleId = meta3.match(/moduleId:\s*(.+)/)?.[1]?.trim() ?? "";
+    const moduleTitle = meta3.match(/moduleTitle:\s*"(.+)"/)?.[1]?.trim() ?? "";
+    const savedAt = meta3.match(/savedAt:\s*"(.+)"/)?.[1]?.trim() ?? "";
+    summaries.push({ moduleId, moduleTitle, summary: body, savedAt });
+  }
+  return { moduleSummaries: summaries };
+}
+var logger23;
+var init_storage = __esm({
+  "src/sessions/storage.ts"() {
+    "use strict";
+    init_src();
+    logger23 = createLogger("cli:sessions");
+  }
+});
+
+// src/commands/compact.ts
+import fs17 from "node:fs";
+import { Command as Command25 } from "commander";
+var logger24, compactCommand;
+var init_compact = __esm({
+  "src/commands/compact.ts"() {
+    "use strict";
+    init_src();
+    init_session();
+    init_workspace_state();
+    init_storage();
+    init_formatter();
+    logger24 = createLogger("cli:compact");
+    compactCommand = new Command25("compact").description("Save a module study summary (LLM-generated, from stdin)").option("--module-id <id>", "Module ID").option("--module-title <title>", "Module title").option("--json", "Output structured JSON").action(async (opts) => {
+      try {
+        const activeCourse = await requireActiveCourse();
+        const ws = await findWorkspaceState();
+        if (!ws) {
+          if (opts.json) jsonError("no_workspace");
+          error("Nenhum workspace encontrado.");
+        }
+        const summary = fs17.readFileSync("/dev/stdin", "utf-8").trim();
+        if (!summary) {
+          if (opts.json) jsonError("empty_summary", { message: "Summary vazio" });
+          error("Summary vazio. Envie o conteudo via stdin.");
+        }
+        const moduleId = opts.moduleId ?? activeCourse.currentModuleId ?? "unknown";
+        const moduleTitle = opts.moduleTitle ?? `Modulo ${moduleId}`;
+        const filePath = await saveModuleSummary(ws.workspacePath, {
+          moduleId,
+          moduleTitle,
+          summary
+        });
+        logger24.debug("Compact summary saved", { moduleId, filePath });
+        if (opts.json) {
+          output({ saved: true, path: filePath, moduleId }, { json: true });
+        } else {
+          output(`\u2713 Summary salvo: ${filePath}`, { json: false });
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("process.exit")) return;
+        logger24.warn("compact failed", { error: msg });
+        if (opts.json) jsonError(msg);
+        error(msg);
+      }
+    });
+  }
+});
+
+// src/commands/context.ts
+import { Command as Command26 } from "commander";
+var logger25, contextCommand;
+var init_context2 = __esm({
+  "src/commands/context.ts"() {
+    "use strict";
+    init_src();
+    init_workspace_state();
+    init_storage();
+    init_formatter();
+    logger25 = createLogger("cli:context");
+    contextCommand = new Command26("context").description("Load session context (workspace state + module summaries) for LLM consumption").option("--json", "Output structured JSON").action(async (opts) => {
+      try {
+        const ws = await findWorkspaceState();
+        if (!ws) {
+          if (opts.json) jsonError("no_workspace");
+          error("Nenhum workspace encontrado. Rode: tostudy setup");
+        }
+        const sessionCtx = await loadSessionContext(ws.workspacePath);
+        const result = {
+          workspace: {
+            path: ws.workspacePath,
+            courseId: ws.state.courseId,
+            courseTitle: ws.state.courseTitle,
+            enrollmentId: ws.state.enrollmentId,
+            currentLessonId: ws.state.currentLessonId ?? null,
+            currentModuleId: ws.state.currentModuleId ?? null,
+            courseTags: ws.state.courseTags ?? [],
+            courseLevel: ws.state.courseLevel ?? null
+          },
+          moduleSummaries: sessionCtx.moduleSummaries.map((s) => ({
+            moduleId: s.moduleId,
+            moduleTitle: s.moduleTitle,
+            summary: s.summary,
+            savedAt: s.savedAt
+          })),
+          totalModulesCompleted: sessionCtx.moduleSummaries.length
+        };
+        logger25.debug("Context loaded", {
+          courseId: ws.state.courseId,
+          moduleSummaries: sessionCtx.moduleSummaries.length
+        });
+        if (opts.json) {
+          output(result, { json: true });
+        } else {
+          output(`Workspace: ${ws.workspacePath}`, { json: false });
+          output(`Curso: ${ws.state.courseTitle}`, { json: false });
+          output(`Modulos resumidos: ${sessionCtx.moduleSummaries.length}`, { json: false });
         }
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
+        logger25.warn("context failed", { error: msg });
+        if (opts.json) jsonError(msg);
         error(msg);
       }
     });
@@ -42826,9 +43738,9 @@ __export(cli_exports, {
   CLI_VERSION: () => CLI_VERSION,
   createProgram: () => createProgram
 });
-import { Command as Command22 } from "commander";
+import { Command as Command27 } from "commander";
 function createProgram() {
-  const program2 = new Command22();
+  const program2 = new Command27();
   program2.name("tostudy").description("ToStudy CLI \u2014 study courses from the terminal").version(CLI_VERSION).option("--verbose", "Enable debug output").option("--course <id>", "Override active course ID");
   program2.addCommand(setupCommand);
   program2.addCommand(doctorCommand);
@@ -42846,11 +43758,16 @@ function createProgram() {
   program2.addCommand(validateCommand);
   program2.addCommand(menuCommand);
   program2.addCommand(profileCommand);
+  program2.addCommand(briefCommand);
+  program2.addCommand(briefCreateCommand);
+  program2.addCommand(briefOpenCommand);
   program2.addCommand(workspaceCommand);
   program2.addCommand(syncCommand);
   program2.addCommand(exportCommand);
   program2.addCommand(openCommand);
   program2.addCommand(vaultCommand);
+  program2.addCommand(compactCommand);
+  program2.addCommand(contextCommand);
   return program2;
 }
 var CLI_VERSION;
@@ -42878,7 +43795,12 @@ var init_cli = __esm({
     init_vault2();
     init_profile();
     init_sync();
-    CLI_VERSION = true ? "0.8.0" : "0.7.1";
+    init_brief();
+    init_brief_create();
+    init_brief_open();
+    init_compact();
+    init_context2();
+    CLI_VERSION = true ? "0.10.0" : "0.7.1";
   }
 });