@tostudy-ai/cli 0.18.27 → 0.18.33

package/README.md

@@ -0,0 +1,98 @@
+# ToStudy CLI
+
+Terminal study client for [ToStudy](https://tostudy.ai) — navigate courses, read lessons, get hints, and validate exercises from the command line. Published to npm as [`@tostudy-ai/cli`](https://www.npmjs.com/package/@tostudy-ai/cli). Since v0.18.0 it also carries the `creator` group, which lets a creator's own AI agent author a course and upload it as a draft.
+
+**Requires:** Node.js >= 22 (bundle loads on >= 20.18.1 with a warning)
+
+## Installation
+
+```bash
+npm install -g @tostudy-ai/cli
+```
+
+## Quick Start
+
+```bash
+tostudy login      # Authenticate (also installs the /tostudy command for your IDE)
+tostudy courses    # List enrolled courses
+tostudy select     # Select the active course
+tostudy lesson     # Read the current lesson
+tostudy next       # Advance to the next lesson
+tostudy validate   # Validate an exercise solution
+tostudy progress   # Show study progress
+```
+
+## Commands
+
+Source of truth: `src/commands/` (one file per command). Every command supports `--json` output designed for LLM agent consumption.
+
+| Command         | Description                                                                                        |
+| --------------- | -------------------------------------------------------------------------------------------------- |
+| `login`         | Authenticate with ToStudy (`--creator` requests the creator scope)                                 |
+| `logout`        | Revoke the server session and clear local authentication                                           |
+| `doctor`        | Diagnostic health check                                                                            |
+| `init`          | Initialize course workspace                                                                        |
+| `profile`       | Show or manage CLI profile                                                                         |
+| `courses`       | List enrolled courses (`--mine`: courses you authored)                                             |
+| `select`        | Select active course                                                                               |
+| `progress`      | Show study progress                                                                                |
+| `grades`        | Show grades and exercise scores                                                                    |
+| `review`        | Review past exercise attempts                                                                      |
+| `start`         | Start a module                                                                                     |
+| `start-next`    | Start next available module                                                                        |
+| `next`          | Advance to next lesson                                                                             |
+| `lesson`        | Show current lesson                                                                                |
+| `knowledge`     | Show the active course's knowledge base                                                            |
+| `hint`          | Get hint for current exercise                                                                      |
+| `theory`        | Request additional explanation in current lesson                                                   |
+| `validate`      | Validate exercise solution                                                                         |
+| `retry`         | Revalidate a completed lesson (grade keeps the best attempt)                                       |
+| `level`         | Adjust exercise difficulty in real time                                                            |
+| `menu`          | Interactive menu                                                                                   |
+| `sync`          | Regenerate instruction files (`--all-runtimes` for every supported runtime)                        |
+| `brief`         | Show base learner brief (T1) status                                                                |
+| `brief-create`  | Create base learner brief via interactive prompts                                                  |
+| `brief-open`    | Open the learner brief editor in the browser                                                       |
+| `export`        | Extract exercise to workspace                                                                      |
+| `export-grades` | Export exercise history in structured format                                                       |
+| `open`          | Open workspace in IDE                                                                              |
+| `workspace`     | Workspace operations (`workspace setup`)                                                           |
+| `vault`         | Obsidian vault operations (`vault init`, `vault sync`)                                             |
+| `compact`       | Save module study summary from stdin                                                               |
+| `context`       | Load session context (workspace + summaries)                                                       |
+| `memory`        | Load accumulated student memory                                                                    |
+| `insight`       | Record a student insight (difficulty/breakthrough/question)                                        |
+| `creator`       | Author a course with your AI agent (`init`, `validate`, `push`, `pull`, `audit`, `status`, `open`) |
+
+> `tostudy setup` is deprecated — IDE detection and `/tostudy` installation are part of `tostudy login`.
+
+## IDE Integration
+
+`tostudy login` / `select` / `init` generate instruction files that teach AI assistants how to tutor: Claude Code slash commands, Cursor rules, AGENTS.md blocks, OpenCode/Grok commands, and Antigravity skills. See [AGENTS.md](./AGENTS.md) for the full runtime matrix.
+
+## Development
+
+```bash
+# Run from source (no dev server — CLI tool)
+tsx bin/tostudy.ts <command>
+
+# Tests / lint / typecheck
+pnpm -C apps/tostudy-cli test
+pnpm -C apps/tostudy-cli lint
+pnpm -C apps/tostudy-cli type-check
+```
+
+## Build & Publish
+
+| Target      | Command                                         | Output                                        |
+| ----------- | ----------------------------------------------- | --------------------------------------------- |
+| npm package | `pnpm -C apps/tostudy-cli build`                | `dist/cli.js` + `dist/main.js` (esbuild, ESM) |
+| Standalone  | `pnpm -C apps/tostudy-cli build:standalone`     | 4 binaries (macOS arm64/x64, Linux, Windows)  |
+| Publish     | `pnpm -C apps/tostudy-cli build && npm publish` | `@tostudy-ai/cli` on npm (public)             |
+
+> Always build by hand right before publishing and verify `dist/main.js` holds the new version string — with `ignore-scripts=true` in `~/.npmrc`, npm silently skips `prepublishOnly` and packs a stale `dist/`.
+
+## Related
+
+- [AGENTS.md](./AGENTS.md) - Agent instructions (architecture, creator authoring, context pipeline)
+- [@repo/tostudy-core](../../packages/tostudy-core/README.md) - Shared business logic (bundled at build time)

package/dist/main.js

@@ -657,6 +657,12 @@ function parseOtlpResourceAttributes(raw2) {
   }
   return out;
 }
+function resolveOtlpResourceAttributes(env) {
+  const attributes = parseOtlpResourceAttributes(env.OTEL_RESOURCE_ATTRIBUTES);
+  const railwayEnvironment = env.RAILWAY_ENVIRONMENT_NAME?.trim();
+  if (!attributes["deployment.environment"] && railwayEnvironment) attributes["deployment.environment"] = railwayEnvironment;
+  return attributes;
+}
 function parseOtlpHeaders(raw2) {
   if (!raw2) return {};
   const out = {};
@@ -975,7 +981,7 @@ var init_dist = __esm({
         if (otlpEndpoint) this.transports.push(getOrCreateOtlpLogsTransport({
           endpoint: otlpEndpoint,
           serviceName: process.env.OTEL_SERVICE_NAME || getDefaultService(),
-          resourceAttributes: parseOtlpResourceAttributes(process.env.OTEL_RESOURCE_ATTRIBUTES),
+          resourceAttributes: resolveOtlpResourceAttributes(process.env),
           headers: {
             ...parseOtlpHeaders(process.env.OTEL_EXPORTER_OTLP_HEADERS),
             ...parseOtlpHeaders(process.env.OTEL_EXPORTER_OTLP_LOGS_HEADERS)
@@ -1092,18 +1098,22 @@ var init_errors_pt_br = __esm({
         pathOutsideRoot: "caminho fora da pasta do curso: {path}. Use s\xF3 caminhos relativos dentro do workspace.",
         payloadTooLarge: "curso grande demais para um push: {bytes} bytes (limite {max}). Divida m\xF3dulos ou encurte li\xE7\xF5es.",
         validateOk: "\u2713 Workspace v\xE1lido: {lessons} li\xE7\xF5es, {bytes} bytes.",
-        validateFailed: "\u2717 {count} erro(s). Corrija e rode `tostudy creator validate` de novo.",
+        validateFailedOne: "\u2717 {count} erro. Corrija e rode `tostudy creator validate` de novo.",
+        validateFailedOther: "\u2717 {count} erros. Corrija e rode `tostudy creator validate` de novo.",
         pushCreated: "\u2713 Curso criado como rascunho. Revise no portal: {url}",
         pushUpdated: "\u2713 Curso atualizado. A revis\xE3o no portal foi reiniciada: {url}",
         pushUnchanged: "\u2713 Nada mudou desde o \xFAltimo push: {url}",
-        pullDone: "\u2713 {count} arquivo(s) atualizado(s) a partir do servidor:",
+        pullDoneOne: "\u2713 {count} arquivo atualizado a partir do servidor:",
+        pullDoneOther: "\u2713 {count} arquivos atualizados a partir do servidor:",
         pullStructureMismatch: "A estrutura local ({local}) difere da do servidor ({remote}). Nada foi escrito. `tostudy creator push --force` torna o workspace a fonte da verdade.",
         pullInvalidLesson: "O servidor devolveu li\xE7\xF5es que n\xE3o passam no contrato ({slots}). Nada foi escrito.",
-        auditResult: "Auditoria: {verdict} \xB7 nota {score}/100",
+        auditResult: "Checagem de formato: {verdict} \xB7 nota {score}/100",
+        formatOnly: "Esta checagem avalia o formato, n\xE3o a qualidade do ensino.",
         auditStale: "\u26A0 O conte\xFAdo mudou durante a auditoria: este relat\xF3rio j\xE1 est\xE1 desatualizado. Rode `tostudy creator audit` de novo.",
         statusLine: "Status: {status} \xB7 revis\xE3o: {review}",
-        lastAudit: "\xDAltima auditoria: {verdict} \xB7 nota {score}/100",
-        noAudit: "\xDAltima auditoria: nenhuma",
+        lastAudit: "\xDAltima checagem de formato: {verdict} \xB7 nota {score}/100",
+        noAudit: "\xDAltima checagem de formato: nenhuma",
+        pedagogicalNotRun: "! A revis\xE3o pedag\xF3gica n\xE3o rodou \u2014 a checagem de formato n\xE3o avalia a qualidade do ensino.",
         statusReady: "\u2713 Pronto para enviar para revis\xE3o pelo portal.",
         statusNotReady: "Falta para enviar para revis\xE3o:",
         portal: "Portal: {url}",
@@ -1206,18 +1216,22 @@ var init_errors_en_us = __esm({
         pathOutsideRoot: "path outside the course folder: {path}. Use only relative paths inside the workspace.",
         payloadTooLarge: "course too large for one push: {bytes} bytes (limit {max}). Split modules or shorten lessons.",
         validateOk: "\u2713 Workspace is valid: {lessons} lessons, {bytes} bytes.",
-        validateFailed: "\u2717 {count} error(s). Fix them and run `tostudy creator validate` again.",
+        validateFailedOne: "\u2717 {count} error. Fix it and run `tostudy creator validate` again.",
+        validateFailedOther: "\u2717 {count} errors. Fix them and run `tostudy creator validate` again.",
         pushCreated: "\u2713 Course created as a draft. Review it in the portal: {url}",
         pushUpdated: "\u2713 Course updated. The portal review was reset: {url}",
         pushUnchanged: "\u2713 Nothing changed since the last push: {url}",
-        pullDone: "\u2713 {count} file(s) updated from the server:",
+        pullDoneOne: "\u2713 {count} file updated from the server:",
+        pullDoneOther: "\u2713 {count} files updated from the server:",
         pullStructureMismatch: "The local structure ({local}) differs from the server's ({remote}). Nothing was written. `tostudy creator push --force` makes the workspace authoritative.",
         pullInvalidLesson: "The server returned lessons that do not pass the contract ({slots}). Nothing was written.",
-        auditResult: "Audit: {verdict} \xB7 score {score}/100",
+        auditResult: "Format check: {verdict} \xB7 score {score}/100",
+        formatOnly: "This checks format, not teaching quality.",
         auditStale: "\u26A0 The content changed while the audit ran: this report is already stale. Run `tostudy creator audit` again.",
         statusLine: "Status: {status} \xB7 review: {review}",
-        lastAudit: "Last audit: {verdict} \xB7 score {score}/100",
-        noAudit: "Last audit: none",
+        lastAudit: "Last format check: {verdict} \xB7 score {score}/100",
+        noAudit: "Last format check: none",
+        pedagogicalNotRun: "! Pedagogical review not run \u2014 the format check does not judge teaching quality.",
         statusReady: "\u2713 Ready to submit for review from the portal.",
         statusNotReady: "Still missing before submitting for review:",
         portal: "Portal: {url}",
@@ -3755,8 +3769,10 @@ var loginCommand = new Command("login").description("Autentica na ToStudy via br
         const data = createHttpProvider(apiUrl, token);
         const courses = await listCourses({ userId }, { data, logger: logger4 });
         if (courses.length > 0) {
-          console.log(`
-  \u2713 ${courses.length} curso(s) matriculado(s)`);
+          console.log(
+            `
+  \u2713 ${courses.length} ${courses.length === 1 ? "curso matriculado" : "cursos matriculados"}`
+          );
         } else {
           console.log(`
   \u2192 Nenhum curso matriculado. Rode: tostudy suggest`);
@@ -3828,7 +3844,7 @@ import { spawn } from "node:child_process";
 import { hostname } from "node:os";
 
 // src/version.ts
-var CLI_VERSION = true ? "0.18.27" : "0.7.1";
+var CLI_VERSION = true ? "0.18.33" : "0.7.1";
 
 // src/installer/mcp-setup.ts
 function safeServerError(text2) {
@@ -4431,7 +4447,9 @@ function normalizeReadiness(raw2) {
   const ready = typeof block["isReady"] === "boolean" ? block["isReady"] : missing.length === 0;
   const audit = block["lastAudit"];
   const report = audit && typeof audit === "object" ? audit : null;
-  return { ready, missing, report };
+  const review = block["pedagogicalReview"];
+  const pedagogicalReview = review === "not_run" || review === "approved" || review === "needs_revision" ? review : null;
+  return { ready, missing, report, pedagogicalReview };
 }
 
 // src/commands/courses.ts
@@ -5317,7 +5335,9 @@ var selectCommand = new Command8("select").description("Activate a course by ID
     if (/^\d+$/.test(course)) {
       const idx = parseInt(course, 10) - 1;
       if (idx < 0 || idx >= courses.length) {
-        error(`\xCDndice ${course} inv\xE1lido. Voc\xEA tem ${courses.length} curso(s).`);
+        error(
+          `\xCDndice ${course} inv\xE1lido. Voc\xEA tem ${courses.length} ${courses.length === 1 ? "curso" : "cursos"}.`
+        );
       }
       const found = courses[idx];
       courseId = found.courseId;
@@ -5398,7 +5418,7 @@ var selectCommand = new Command8("select").description("Activate a course by ID
       }
       const lines = [
         `\u2713 Curso ativado: ${detail.courseTitle}`,
-        `  Progresso: ${detail.progress}%  |  ${detail.moduleCount} m\xF3dulos  |  ${detail.lessonCount} li\xE7\xF5es`,
+        `  Progresso: ${detail.progress}%  |  ${detail.moduleCount} ${detail.moduleCount === 1 ? "m\xF3dulo" : "m\xF3dulos"}  |  ${detail.lessonCount} ${detail.lessonCount === 1 ? "li\xE7\xE3o" : "li\xE7\xF5es"}`,
         wsLine,
         "",
         pipelineError ? `\u26A0 Arquivos de contexto N\xC3O foram criados (${pipelineError}).
@@ -5855,7 +5875,10 @@ function formatKnowledge(data) {
     );
     return lines.join("\n");
   }
-  lines.push(`${data.resources.length} fonte(s) de conhecimento:`, "");
+  lines.push(
+    `${data.resources.length} ${data.resources.length === 1 ? "fonte" : "fontes"} de conhecimento:`,
+    ""
+  );
   data.resources.forEach((resource, idx) => {
     lines.push(`${idx + 1}. ${resource.title}  [${resource.type}]`, "", resource.content, "");
   });
@@ -19885,6 +19908,316 @@ async function setEnrollmentLevel(input2, deps) {
   return deps.data.exercises.setEnrollmentLevel(input2.enrollmentId, input2.level);
 }
 
+// ../../packages/validators/src/file-upload.ts
+var FILE_SIZE_LIMITS = {
+  /** Images: profile photos, thumbnails, etc. */
+  IMAGE: 5 * 1024 * 1024,
+  // 5MB
+  /** Documents: PDFs, Word docs, text files */
+  DOCUMENT: 10 * 1024 * 1024,
+  // 10MB
+  /** Videos: course content, recordings */
+  VIDEO: 500 * 1024 * 1024,
+  // 500MB
+  /** Audio: podcast, voice recordings */
+  AUDIO: 50 * 1024 * 1024,
+  // 50MB
+  /** Profile photos (smaller limit for optimization) */
+  PROFILE_PHOTO: 2 * 1024 * 1024,
+  // 2MB
+  /** Session room attachments */
+  SESSION_CONTENT: 10 * 1024 * 1024,
+  // 10MB
+  /** Knowledge base files */
+  KNOWLEDGE_BASE: 50 * 1024 * 1024,
+  // 50MB
+  /** R2/S3 general uploads */
+  R2_DEFAULT: 50 * 1024 * 1024,
+  // 50MB
+  /** MCP knowledge base file reading (local project files) */
+  MCP_KNOWLEDGE_BASE: 500 * 1024,
+  // 500KB
+  /** Default fallback */
+  DEFAULT: 10 * 1024 * 1024
+  // 10MB
+};
+var ALLOWED_EXTENSIONS = {
+  IMAGE: [".jpg", ".jpeg", ".png", ".gif", ".webp"],
+  DOCUMENT: [".pdf", ".doc", ".docx", ".xlsx", ".zip", ".txt", ".rtf", ".md", ".csv"],
+  VIDEO: [".mp4", ".mov", ".avi", ".webm", ".flv"],
+  AUDIO: [".mp3", ".wav", ".aac", ".ogg", ".flac", ".m4a"],
+  SESSION_CONTENT: [".pdf", ".png", ".jpg", ".jpeg"]
+};
+var STUDY_DOCUMENT_EXTENSIONS = [".md", ".csv", ".xlsx"];
+var STUDY_CHAT_CONTENT_MAX_CHARS = 1e4;
+var ALL_ALLOWED_EXTENSIONS = [
+  ...ALLOWED_EXTENSIONS.IMAGE,
+  ...ALLOWED_EXTENSIONS.DOCUMENT,
+  ...ALLOWED_EXTENSIONS.VIDEO,
+  ...ALLOWED_EXTENSIONS.AUDIO
+];
+function isStudyDocumentExtension(filename) {
+  const ext = getFileExtension(filename);
+  if (!ext) return false;
+  return STUDY_DOCUMENT_EXTENSIONS.includes(ext);
+}
+function extractStudyDocumentText(filename, buffer, maxChars = STUDY_CHAT_CONTENT_MAX_CHARS) {
+  if (!isStudyDocumentExtension(filename)) {
+    return { ok: false, error: "unsupported_extension" };
+  }
+  const ext = getFileExtension(filename);
+  if (ext === ".xlsx") {
+    return extractXlsxDocumentText(buffer, maxChars);
+  }
+  if (!buffer || buffer.includes(0)) {
+    return { ok: false, error: "invalid_encoding" };
+  }
+  let decoded;
+  try {
+    decoded = new TextDecoder("utf-8", { fatal: true }).decode(buffer);
+  } catch {
+    return { ok: false, error: "invalid_encoding" };
+  }
+  const normalized = decoded.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+  if (!normalized.trim()) {
+    return { ok: false, error: "empty_document" };
+  }
+  return finalizeExtractedStudyText(normalized, maxChars);
+}
+function finalizeExtractedStudyText(normalized, maxChars) {
+  const originalLength = normalized.length;
+  const truncated = originalLength > maxChars;
+  const text2 = truncated ? normalized.slice(0, maxChars) : normalized;
+  return {
+    ok: true,
+    text: text2,
+    truncated,
+    originalLength,
+    extractedLength: text2.length
+  };
+}
+var MAX_XLSX_UNCOMPRESSED_BYTES = 16 * 1024 * 1024;
+var MAX_XLSX_ENTRIES = 256;
+function getInflateRawSync() {
+  const proc = globalThis.process;
+  return proc?.getBuiltinModule?.("node:zlib")?.inflateRawSync;
+}
+function readZipXmlEntries(buffer) {
+  if (!buffer || buffer.byteLength < 22) return null;
+  const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+  if (view.getUint32(0, true) !== 67324752) return null;
+  let eocdOffset = -1;
+  const minEocdOffset = Math.max(0, buffer.byteLength - 65557);
+  for (let i = buffer.byteLength - 22; i >= minEocdOffset; i--) {
+    if (view.getUint32(i, true) === 101010256) {
+      eocdOffset = i;
+      break;
+    }
+  }
+  if (eocdOffset < 0) return null;
+  const totalEntries = view.getUint16(eocdOffset + 10, true);
+  const cdSize = view.getUint32(eocdOffset + 12, true);
+  const cdOffset = view.getUint32(eocdOffset + 16, true);
+  if (totalEntries === 0 || totalEntries > MAX_XLSX_ENTRIES || cdOffset + cdSize > buffer.byteLength) {
+    return null;
+  }
+  const inflateRawSync = getInflateRawSync();
+  const decoder = new TextDecoder("utf-8", { fatal: false });
+  const entries = /* @__PURE__ */ new Map();
+  let totalUncompressed = 0;
+  let pos = cdOffset;
+  for (let i = 0; i < totalEntries && pos + 46 <= cdOffset + cdSize; i++) {
+    if (view.getUint32(pos, true) !== 33639248) return null;
+    const compressionMethod = view.getUint16(pos + 10, true);
+    const compressedSize = view.getUint32(pos + 20, true);
+    const uncompressedSize = view.getUint32(pos + 24, true);
+    const fileNameLen = view.getUint16(pos + 28, true);
+    const extraLen = view.getUint16(pos + 30, true);
+    const commentLen = view.getUint16(pos + 32, true);
+    const localHeaderOffset = view.getUint32(pos + 42, true);
+    const headerEnd = pos + 46 + fileNameLen + extraLen + commentLen;
+    if (headerEnd > buffer.byteLength) return null;
+    const rawName = decoder.decode(buffer.subarray(pos + 46, pos + 46 + fileNameLen));
+    const normalizedName = rawName.replace(/^\/+/, "");
+    pos = headerEnd;
+    if (!normalizedName.startsWith("xl/") || !normalizedName.endsWith(".xml") && !normalizedName.endsWith(".rels")) {
+      continue;
+    }
+    if (uncompressedSize > MAX_XLSX_UNCOMPRESSED_BYTES || totalUncompressed + uncompressedSize > MAX_XLSX_UNCOMPRESSED_BYTES || localHeaderOffset + 30 > buffer.byteLength) {
+      return null;
+    }
+    if (view.getUint32(localHeaderOffset, true) !== 67324752) return null;
+    const localNameLen = view.getUint16(localHeaderOffset + 26, true);
+    const localExtraLen = view.getUint16(localHeaderOffset + 28, true);
+    const dataStart = localHeaderOffset + 30 + localNameLen + localExtraLen;
+    const dataEnd = dataStart + compressedSize;
+    if (dataEnd > buffer.byteLength) return null;
+    const compressedSlice = buffer.subarray(dataStart, dataEnd);
+    let rawBytes;
+    if (compressionMethod === 0) {
+      rawBytes = compressedSlice;
+    } else if (compressionMethod === 8) {
+      if (!inflateRawSync) return null;
+      rawBytes = inflateRawSync(compressedSlice, {
+        maxOutputLength: MAX_XLSX_UNCOMPRESSED_BYTES - totalUncompressed
+      });
+    } else {
+      return null;
+    }
+    totalUncompressed += rawBytes.byteLength;
+    if (totalUncompressed > MAX_XLSX_UNCOMPRESSED_BYTES) return null;
+    entries.set(normalizedName, decoder.decode(rawBytes));
+  }
+  return entries;
+}
+function decodeXmlText(input2) {
+  return input2.replace(/_x([0-9A-Fa-f]{4})_/g, (_, hex3) => String.fromCharCode(parseInt(hex3, 16))).replace(/&#x([0-9A-Fa-f]+);/g, (_, hex3) => String.fromCodePoint(parseInt(hex3, 16))).replace(/&#(\d+);/g, (_, dec) => String.fromCodePoint(parseInt(dec, 10))).replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+}
+function extractXmlAttr(tagAttrs, attrName) {
+  const pattern = new RegExp(`(?:^|\\s)${attrName}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`);
+  const match = pattern.exec(tagAttrs);
+  if (!match) return void 0;
+  return decodeXmlText(match[1] ?? match[2] ?? "");
+}
+function collectTextNodes(xmlFragment) {
+  const withoutPhonetic = xmlFragment.replace(/<rPh\b[^>]*>[\s\S]*?<\/rPh>/g, "");
+  const parts = [];
+  const tRegex = /<t(?:\s[^>]*)?>([\s\S]*?)<\/t>/g;
+  let match;
+  while ((match = tRegex.exec(withoutPhonetic)) !== null) {
+    parts.push(decodeXmlText(match[1] ?? ""));
+  }
+  return parts.join("");
+}
+function parseSharedStrings(xml) {
+  if (!xml) return [];
+  const strings = [];
+  const siRegex = /<si\b[^>]*>([\s\S]*?)<\/si>/g;
+  let match;
+  while ((match = siRegex.exec(xml)) !== null) {
+    strings.push(collectTextNodes(match[1] ?? ""));
+  }
+  return strings;
+}
+function resolveWorkbookSheets(entries) {
+  const workbookXml = entries.get("xl/workbook.xml");
+  const relsXml = entries.get("xl/_rels/workbook.xml.rels");
+  const relTargets = /* @__PURE__ */ new Map();
+  if (relsXml) {
+    const relRegex = /<Relationship\b([^>]*?)\/?>/g;
+    let match;
+    while ((match = relRegex.exec(relsXml)) !== null) {
+      const attrs = match[1] ?? "";
+      const id = extractXmlAttr(attrs, "Id");
+      const target = extractXmlAttr(attrs, "Target");
+      if (id && target) {
+        const normalizedTarget = target.startsWith("/") ? target.replace(/^\/+/, "") : `xl/${target.replace(/^\.?\//, "")}`;
+        relTargets.set(id, normalizedTarget);
+      }
+    }
+  }
+  const resolved = [];
+  const usedPaths = /* @__PURE__ */ new Set();
+  if (workbookXml) {
+    const sheetRegex = /<sheet\b([^>]*?)\/?>/g;
+    let match;
+    let idx = 1;
+    while ((match = sheetRegex.exec(workbookXml)) !== null) {
+      const attrs = match[1] ?? "";
+      const name = extractXmlAttr(attrs, "name") || `Sheet${idx}`;
+      const rId = extractXmlAttr(attrs, "r:id") ?? extractXmlAttr(attrs, "id");
+      const targetPath = (rId ? relTargets.get(rId) : void 0) ?? `xl/worksheets/sheet${idx}.xml`;
+      const sheetXml = entries.get(targetPath);
+      if (sheetXml) {
+        resolved.push({ name, xml: sheetXml });
+        usedPaths.add(targetPath);
+      }
+      idx++;
+    }
+  }
+  if (resolved.length === 0) {
+    const fallbackPaths = Array.from(entries.keys()).filter((k) => /^xl\/worksheets\/[^/]+\.xml$/i.test(k) && !usedPaths.has(k)).sort((a, b) => a.localeCompare(b, void 0, { numeric: true }));
+    fallbackPaths.forEach((p, i) => {
+      const xml = entries.get(p);
+      if (xml) resolved.push({ name: `Sheet${i + 1}`, xml });
+    });
+  }
+  return resolved;
+}
+function extractXlsxDocumentText(buffer, maxChars) {
+  let entries;
+  try {
+    entries = readZipXmlEntries(buffer);
+  } catch {
+    return { ok: false, error: "invalid_encoding" };
+  }
+  if (!entries) {
+    return { ok: false, error: "invalid_encoding" };
+  }
+  const sheets = resolveWorkbookSheets(entries);
+  if (sheets.length === 0) {
+    return { ok: false, error: "invalid_encoding" };
+  }
+  const sharedStrings = parseSharedStrings(entries.get("xl/sharedStrings.xml"));
+  const sheetSections = [];
+  for (const sheet of sheets) {
+    const cellLines = [];
+    const cellRegex = /<c\b([^>]*?)(?:\/>|>([\s\S]*?)<\/c>)/g;
+    let match;
+    let fallbackIndex = 1;
+    while ((match = cellRegex.exec(sheet.xml)) !== null) {
+      const attrs = match[1] ?? "";
+      const inner = match[2] ?? "";
+      if (!inner) continue;
+      const ref = extractXmlAttr(attrs, "r") || `Cell${fallbackIndex++}`;
+      const cellType = extractXmlAttr(attrs, "t");
+      const fMatch = /<f(?:\s[^>]*)?>([\s\S]*?)<\/f>/.exec(inner);
+      const rawFormula = fMatch ? decodeXmlText(fMatch[1] ?? "").trim() : "";
+      const formula = rawFormula ? rawFormula.startsWith("=") ? rawFormula : `=${rawFormula}` : "";
+      let value = "";
+      if (cellType === "inlineStr") {
+        const isMatch = /<is\b[^>]*>([\s\S]*?)<\/is>/.exec(inner);
+        value = isMatch ? collectTextNodes(isMatch[1] ?? "").trim() : "";
+      } else {
+        const vMatch = /<v(?:\s[^>]*)?>([\s\S]*?)<\/v>/.exec(inner);
+        const rawV = vMatch ? decodeXmlText(vMatch[1] ?? "").trim() : "";
+        if (rawV !== "") {
+          if (cellType === "s") {
+            const sstIdx = Number.parseInt(rawV, 10);
+            value = (Number.isFinite(sstIdx) ? sharedStrings[sstIdx] : void 0) ?? rawV;
+          } else if (cellType === "b") {
+            value = rawV === "1" ? "TRUE" : "FALSE";
+          } else {
+            value = rawV;
+          }
+        }
+      }
+      if (!formula && !value) continue;
+      if (formula && value) {
+        cellLines.push(`- ${ref}: ${formula} (valor: ${value})`);
+      } else if (formula) {
+        cellLines.push(`- ${ref}: ${formula}`);
+      } else {
+        cellLines.push(`- ${ref}: ${value}`);
+      }
+    }
+    if (cellLines.length > 0) {
+      sheetSections.push(`### Aba: ${sheet.name}
+${cellLines.join("\n")}`);
+    }
+  }
+  const combined = sheetSections.join("\n\n").trim();
+  if (!combined) {
+    return { ok: false, error: "empty_document" };
+  }
+  return finalizeExtractedStudyText(combined, maxChars);
+}
+function getFileExtension(filename) {
+  if (!filename || !filename.includes(".")) return null;
+  const ext = filename.substring(filename.lastIndexOf(".")).toLowerCase();
+  return ext || null;
+}
+
 // src/commands/validate.ts
 init_guards();
 init_course_state();
@@ -20171,7 +20504,34 @@ var validateCommand = new Command16("validate").description("Validate your solut
           jsonError("file_not_found", { message: `Arquivo n\xE3o encontrado: ${file2}` });
         error(`Arquivo n\xE3o encontrado: ${file2}`);
       }
-      solution = fs12.readFileSync(file2, "utf-8");
+      if (path15.extname(file2).toLowerCase() === ".xlsx") {
+        const rawBytes = fs12.readFileSync(file2);
+        if (rawBytes.byteLength === 0 || rawBytes.byteLength > FILE_SIZE_LIMITS.DOCUMENT) {
+          const msg = `Arquivo muito grande ou vazio: ${file2} (m\xE1ximo: 10 MB)`;
+          if (opts.json) jsonError("file_too_large", { message: msg });
+          error(msg);
+        }
+        const extracted = extractStudyDocumentText(
+          path15.basename(file2),
+          rawBytes,
+          STUDY_CHAT_CONTENT_MAX_CHARS
+        );
+        if (!extracted.ok) {
+          const msg = extracted.error === "empty_document" ? `Planilha vazia: ${file2}` : `Arquivo .xlsx inv\xE1lido ou corrompido: ${file2}`;
+          if (opts.json) jsonError("invalid_xlsx", { message: msg });
+          error(msg);
+        }
+        if (extracted.truncated) {
+          process.stderr.write(
+            `\u26A0\uFE0F O conte\xFAdo extra\xEDdo de ${path15.basename(file2)} foi truncado para o limite de ${STUDY_CHAT_CONTENT_MAX_CHARS} caracteres.
+
+`
+          );
+        }
+        solution = extracted.text;
+      } else {
+        solution = fs12.readFileSync(file2, "utf-8");
+      }
     } else {
       if (opts.json)
         jsonError("no_solution_provided", { message: "Forne\xE7a um arquivo ou use --stdin" });
@@ -22636,7 +22996,10 @@ function renderReport(report) {
   return [
     ...report.errors.map((issue2) => `\u2717 ${issue2.path}: ${issue2.message}`),
     ...report.warnings.map((issue2) => `\u26A0 ${issue2.path}: ${issue2.message}`),
-    report.ok ? fillTemplate(copy.validateOk, { lessons: report.lessonCount, bytes: report.payloadBytes }) : fillTemplate(copy.validateFailed, { count: report.errors.length })
+    report.ok ? fillTemplate(copy.validateOk, { lessons: report.lessonCount, bytes: report.payloadBytes }) : fillTemplate(
+      report.errors.length === 1 ? copy.validateFailedOne : copy.validateFailedOther,
+      { count: report.errors.length }
+    )
   ].join("\n");
 }
 function printReport(report, opts) {
@@ -22750,7 +23113,9 @@ creatorCommand.command("pull").description("Bring lessons edited in the portal i
     }
     output(
       [
-        fillTemplate(copy.pullDone, { count: outcome.files.length }),
+        fillTemplate(outcome.files.length === 1 ? copy.pullDoneOne : copy.pullDoneOther, {
+          count: outcome.files.length
+        }),
         ...outcome.files.map((file2) => `  ${file2}`)
       ].join("\n"),
       { json: false }
@@ -22761,7 +23126,10 @@ creatorCommand.command("pull").description("Bring lessons edited in the portal i
 });
 function renderAudit(result) {
   const copy = getErrors().creator;
-  const lines = [fillTemplate(copy.auditResult, { verdict: result.verdict, score: result.score })];
+  const lines = [
+    fillTemplate(copy.auditResult, { verdict: result.verdict, score: result.score }),
+    copy.formatOnly
+  ];
   if (result.stale) lines.push(copy.auditStale);
   for (const raw2 of result.findings) {
     const finding = raw2 ?? {};
@@ -22813,6 +23181,7 @@ function renderStatus(remote, readiness, url2) {
         score: readiness.report.score ?? "?"
       }) : copy.noAudit
     );
+    if (readiness.pedagogicalReview === "not_run") lines.push(copy.pedagogicalNotRun);
     if (readiness.ready) {
       lines.push(copy.statusReady);
     } else {
@@ -23613,12 +23982,17 @@ function formatGradesMarkdown(attempts) {
       lines.push("", "**Feedback:**", "", a.feedback);
     }
     if (a.solution) {
-      lines.push("", "**Solu\xE7\xE3o:**", "", "```", a.solution, "```");
+      const fence2 = fenceFor(a.solution);
+      lines.push("", "**Solu\xE7\xE3o:**", "", fence2, a.solution, fence2);
     }
   });
   lines.push("");
   return lines.join("\n");
 }
+function fenceFor(text2) {
+  const longest = Math.max(0, ...(text2.match(/`+/g) ?? []).map((run) => run.length));
+  return "`".repeat(Math.max(3, longest + 1));
+}
 function renderTableRow(cells, widths) {
   return cells.map((cell, idx) => {
     const w = widths[idx] ?? cell.length;
@@ -23673,7 +24047,7 @@ function formatGradesTable(attempts, options = {}) {
   const failed = sorted.length - passed;
   return [
     `Curso: ${title2}`,
-    `Total: ${sorted.length} tentativa(s) \u2014 ${passed} aprovada(s), ${failed} reprovada(s)`,
+    `Total: ${sorted.length} ${sorted.length === 1 ? "tentativa" : "tentativas"} \u2014 ${passed} ${passed === 1 ? "aprovada" : "aprovadas"}, ${failed} ${failed === 1 ? "reprovada" : "reprovadas"}`,
     "",
     headerLine,
     sepLine,
@@ -23748,7 +24122,8 @@ function formatLessonReview(attempt, options = {}) {
     lines.push("", "Feedback:", attempt.feedback);
   }
   if (attempt.solution) {
-    lines.push("", "Solu\xE7\xE3o submetida:", "```", attempt.solution, "```");
+    const fence2 = fenceFor(attempt.solution);
+    lines.push("", "Solu\xE7\xE3o submetida:", fence2, attempt.solution, fence2);
   }
   return lines.join("\n");
 }