@tostudy-ai/cli 0.13.0 → 0.15.0

package/dist/cli.js

@@ -41,137 +41,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/picocolors/picocolors.js
-var require_picocolors = __commonJS({
-  "../../node_modules/picocolors/picocolors.js"(exports, module) {
-    var p = process || {};
-    var argv = p.argv || [];
-    var env = p.env || {};
-    var isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
-    var formatter = (open, close, replace = open) => (input2) => {
-      let string4 = "" + input2, index2 = string4.indexOf(close, open.length);
-      return ~index2 ? open + replaceClose(string4, close, replace, index2) + close : open + string4 + close;
-    };
-    var replaceClose = (string4, close, replace, index2) => {
-      let result = "", cursor = 0;
-      do {
-        result += string4.substring(cursor, index2) + replace;
-        cursor = index2 + close.length;
-        index2 = string4.indexOf(close, cursor);
-      } while (~index2);
-      return result + string4.substring(cursor);
-    };
-    var createColors = (enabled = isColorSupported) => {
-      let f = enabled ? formatter : () => String;
-      return {
-        isColorSupported: enabled,
-        reset: f("\x1B[0m", "\x1B[0m"),
-        bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
-        dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
-        italic: f("\x1B[3m", "\x1B[23m"),
-        underline: f("\x1B[4m", "\x1B[24m"),
-        inverse: f("\x1B[7m", "\x1B[27m"),
-        hidden: f("\x1B[8m", "\x1B[28m"),
-        strikethrough: f("\x1B[9m", "\x1B[29m"),
-        black: f("\x1B[30m", "\x1B[39m"),
-        red: f("\x1B[31m", "\x1B[39m"),
-        green: f("\x1B[32m", "\x1B[39m"),
-        yellow: f("\x1B[33m", "\x1B[39m"),
-        blue: f("\x1B[34m", "\x1B[39m"),
-        magenta: f("\x1B[35m", "\x1B[39m"),
-        cyan: f("\x1B[36m", "\x1B[39m"),
-        white: f("\x1B[37m", "\x1B[39m"),
-        gray: f("\x1B[90m", "\x1B[39m"),
-        bgBlack: f("\x1B[40m", "\x1B[49m"),
-        bgRed: f("\x1B[41m", "\x1B[49m"),
-        bgGreen: f("\x1B[42m", "\x1B[49m"),
-        bgYellow: f("\x1B[43m", "\x1B[49m"),
-        bgBlue: f("\x1B[44m", "\x1B[49m"),
-        bgMagenta: f("\x1B[45m", "\x1B[49m"),
-        bgCyan: f("\x1B[46m", "\x1B[49m"),
-        bgWhite: f("\x1B[47m", "\x1B[49m"),
-        blackBright: f("\x1B[90m", "\x1B[39m"),
-        redBright: f("\x1B[91m", "\x1B[39m"),
-        greenBright: f("\x1B[92m", "\x1B[39m"),
-        yellowBright: f("\x1B[93m", "\x1B[39m"),
-        blueBright: f("\x1B[94m", "\x1B[39m"),
-        magentaBright: f("\x1B[95m", "\x1B[39m"),
-        cyanBright: f("\x1B[96m", "\x1B[39m"),
-        whiteBright: f("\x1B[97m", "\x1B[39m"),
-        bgBlackBright: f("\x1B[100m", "\x1B[49m"),
-        bgRedBright: f("\x1B[101m", "\x1B[49m"),
-        bgGreenBright: f("\x1B[102m", "\x1B[49m"),
-        bgYellowBright: f("\x1B[103m", "\x1B[49m"),
-        bgBlueBright: f("\x1B[104m", "\x1B[49m"),
-        bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
-        bgCyanBright: f("\x1B[106m", "\x1B[49m"),
-        bgWhiteBright: f("\x1B[107m", "\x1B[49m")
-      };
-    };
-    module.exports = createColors();
-    module.exports.createColors = createColors;
-  }
-});
-
-// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-DJVL2Rjl.mjs
-function formatJson(entry) {
-  const { timestamp: timestamp2, level, message, service, environment, context, data, error: error49 } = entry;
-  const output3 = {
-    timestamp: timestamp2,
-    level,
-    message,
-    service,
-    environment,
-    ...context,
-    ...data
-  };
-  if (error49) output3.error = error49;
-  return JSON.stringify(output3);
-}
-function formatTime(timestamp2) {
-  const date6 = new Date(timestamp2);
-  return `${String(date6.getUTCHours()).padStart(2, "0")}:${String(date6.getUTCMinutes()).padStart(2, "0")}:${String(date6.getUTCSeconds()).padStart(2, "0")}`;
-}
-function formatLevel(level) {
-  const colorFn = LEVEL_COLORS[level];
-  return colorFn(level.toUpperCase().padEnd(LEVEL_WIDTH));
-}
-function formatData(data) {
-  const entries = Object.entries(data);
-  if (entries.length === 0) return "";
-  return "\n" + entries.map(([key, value]) => {
-    const formatted = typeof value === "object" ? JSON.stringify(value) : String(value);
-    return `               ${import_picocolors.default.dim(key + ":")} ${formatted}`;
-  }).join("\n");
-}
-function formatPretty(entry) {
-  const { timestamp: timestamp2, level, message, service, context, data, error: error49 } = entry;
-  const time4 = formatTime(timestamp2);
-  const lvl = formatLevel(level);
-  const mod = context.module ? import_picocolors.default.dim(`[${context.module}]`) + " " : "";
-  const svc = import_picocolors.default.dim(`[${service}]`) + " ";
-  let output3 = `${import_picocolors.default.dim(time4)} ${lvl} ${svc}${mod}${message}`;
-  const traceInfo = {};
-  if (context.traceId) traceInfo.traceId = context.traceId;
-  if (context.requestId && context.requestId !== context.traceId) traceInfo.requestId = context.requestId;
-  if (context.caller) traceInfo.caller = context.caller;
-  if (context.duration !== void 0) traceInfo.duration = `${context.duration}ms`;
-  const allData = {
-    ...traceInfo,
-    ...data
-  };
-  if (Object.keys(allData).length > 0) output3 += formatData(allData);
-  if (error49) {
-    output3 += "\n" + import_picocolors.default.red(`               ${error49.name}: ${error49.message}`);
-    if (error49.code) output3 += import_picocolors.default.dim(` (${error49.code})`);
-    if (error49.stack) {
-      const stackLines = error49.stack.split("\n").slice(1, 4);
-      output3 += "\n" + stackLines.map((l) => import_picocolors.default.dim(`               ${l.trim()}`)).join("\n");
-    }
-    if (error49.cause) output3 += "\n" + import_picocolors.default.dim(`               Caused by: ${error49.cause.name}: ${error49.cause.message}`);
-  }
-  return output3;
-}
+// ../../node_modules/@parisgroup-ai/logger/dist/sanitize-u1LaSkAO.mjs
 function email(value) {
   if (!value || typeof value !== "string") return "[INVALID_EMAIL]";
   const atIndex = value.indexOf("@");
@@ -296,42 +166,9 @@ function headers(hdrs) {
   for (const key of Object.keys(sanitized)) if (sensitiveHeaders.some((h) => key.toLowerCase() === h)) sanitized[key] = "[REDACTED]";
   return sanitized;
 }
-function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new WeakSet()) {
-  const info = {
-    name: error49.name,
-    message: error49.message
-  };
-  if (includeStack && error49.stack) info.stack = error49.stack;
-  if ("code" in error49 && typeof error49.code === "string") info.code = error49.code;
-  visited.add(error49);
-  if (error49.cause instanceof Error) if (visited.has(error49.cause)) info.cause = {
-    name: error49.cause.name,
-    message: "[Circular]"
-  };
-  else info.cause = extractErrorInfo(error49.cause, includeStack, visited);
-  return info;
-}
-var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, SENSITIVE_FIELDS, sanitize, BaseLogger;
-var init_logger_base_DJVL2Rjl = __esm({
-  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-DJVL2Rjl.mjs"() {
-    import_picocolors = __toESM(require_picocolors(), 1);
-    LOG_LEVELS = {
-      trace: 0,
-      debug: 1,
-      info: 2,
-      warn: 3,
-      error: 4,
-      fatal: 5
-    };
-    LEVEL_COLORS = {
-      trace: import_picocolors.default.gray,
-      debug: import_picocolors.default.cyan,
-      info: import_picocolors.default.green,
-      warn: import_picocolors.default.yellow,
-      error: import_picocolors.default.red,
-      fatal: (s) => import_picocolors.default.bgRed(import_picocolors.default.white(s))
-    };
-    LEVEL_WIDTH = 5;
+var SENSITIVE_FIELDS, sanitize;
+var init_sanitize_u1LaSkAO = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/sanitize-u1LaSkAO.mjs"() {
     SENSITIVE_FIELDS = [
       "password",
       "senha",
@@ -398,6 +235,177 @@ var init_logger_base_DJVL2Rjl = __esm({
       headers,
       isSensitiveKey
     };
+  }
+});
+
+// ../../node_modules/picocolors/picocolors.js
+var require_picocolors = __commonJS({
+  "../../node_modules/picocolors/picocolors.js"(exports, module) {
+    var p = process || {};
+    var argv = p.argv || [];
+    var env = p.env || {};
+    var isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
+    var formatter = (open, close, replace = open) => (input2) => {
+      let string4 = "" + input2, index2 = string4.indexOf(close, open.length);
+      return ~index2 ? open + replaceClose(string4, close, replace, index2) + close : open + string4 + close;
+    };
+    var replaceClose = (string4, close, replace, index2) => {
+      let result = "", cursor = 0;
+      do {
+        result += string4.substring(cursor, index2) + replace;
+        cursor = index2 + close.length;
+        index2 = string4.indexOf(close, cursor);
+      } while (~index2);
+      return result + string4.substring(cursor);
+    };
+    var createColors = (enabled = isColorSupported) => {
+      let f = enabled ? formatter : () => String;
+      return {
+        isColorSupported: enabled,
+        reset: f("\x1B[0m", "\x1B[0m"),
+        bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
+        dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
+        italic: f("\x1B[3m", "\x1B[23m"),
+        underline: f("\x1B[4m", "\x1B[24m"),
+        inverse: f("\x1B[7m", "\x1B[27m"),
+        hidden: f("\x1B[8m", "\x1B[28m"),
+        strikethrough: f("\x1B[9m", "\x1B[29m"),
+        black: f("\x1B[30m", "\x1B[39m"),
+        red: f("\x1B[31m", "\x1B[39m"),
+        green: f("\x1B[32m", "\x1B[39m"),
+        yellow: f("\x1B[33m", "\x1B[39m"),
+        blue: f("\x1B[34m", "\x1B[39m"),
+        magenta: f("\x1B[35m", "\x1B[39m"),
+        cyan: f("\x1B[36m", "\x1B[39m"),
+        white: f("\x1B[37m", "\x1B[39m"),
+        gray: f("\x1B[90m", "\x1B[39m"),
+        bgBlack: f("\x1B[40m", "\x1B[49m"),
+        bgRed: f("\x1B[41m", "\x1B[49m"),
+        bgGreen: f("\x1B[42m", "\x1B[49m"),
+        bgYellow: f("\x1B[43m", "\x1B[49m"),
+        bgBlue: f("\x1B[44m", "\x1B[49m"),
+        bgMagenta: f("\x1B[45m", "\x1B[49m"),
+        bgCyan: f("\x1B[46m", "\x1B[49m"),
+        bgWhite: f("\x1B[47m", "\x1B[49m"),
+        blackBright: f("\x1B[90m", "\x1B[39m"),
+        redBright: f("\x1B[91m", "\x1B[39m"),
+        greenBright: f("\x1B[92m", "\x1B[39m"),
+        yellowBright: f("\x1B[93m", "\x1B[39m"),
+        blueBright: f("\x1B[94m", "\x1B[39m"),
+        magentaBright: f("\x1B[95m", "\x1B[39m"),
+        cyanBright: f("\x1B[96m", "\x1B[39m"),
+        whiteBright: f("\x1B[97m", "\x1B[39m"),
+        bgBlackBright: f("\x1B[100m", "\x1B[49m"),
+        bgRedBright: f("\x1B[101m", "\x1B[49m"),
+        bgGreenBright: f("\x1B[102m", "\x1B[49m"),
+        bgYellowBright: f("\x1B[103m", "\x1B[49m"),
+        bgBlueBright: f("\x1B[104m", "\x1B[49m"),
+        bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
+        bgCyanBright: f("\x1B[106m", "\x1B[49m"),
+        bgWhiteBright: f("\x1B[107m", "\x1B[49m")
+      };
+    };
+    module.exports = createColors();
+    module.exports.createColors = createColors;
+  }
+});
+
+// ../../node_modules/@parisgroup-ai/logger/dist/logger.base-W8CRO9aE.mjs
+function formatJson(entry) {
+  const { timestamp: timestamp2, level, message, service, environment, context, data, error: error49 } = entry;
+  const output3 = {
+    timestamp: timestamp2,
+    level,
+    message,
+    service,
+    environment,
+    ...context,
+    ...data
+  };
+  if (error49) output3.error = error49;
+  return JSON.stringify(output3);
+}
+function formatTime(timestamp2) {
+  const date6 = new Date(timestamp2);
+  return `${String(date6.getUTCHours()).padStart(2, "0")}:${String(date6.getUTCMinutes()).padStart(2, "0")}:${String(date6.getUTCSeconds()).padStart(2, "0")}`;
+}
+function formatLevel(level) {
+  const colorFn = LEVEL_COLORS[level];
+  return colorFn(level.toUpperCase().padEnd(LEVEL_WIDTH));
+}
+function formatData(data) {
+  const entries = Object.entries(data);
+  if (entries.length === 0) return "";
+  return "\n" + entries.map(([key, value]) => {
+    const formatted = typeof value === "object" ? JSON.stringify(value) : String(value);
+    return `               ${import_picocolors.default.dim(key + ":")} ${formatted}`;
+  }).join("\n");
+}
+function formatPretty(entry) {
+  const { timestamp: timestamp2, level, message, service, context, data, error: error49 } = entry;
+  const time4 = formatTime(timestamp2);
+  const lvl = formatLevel(level);
+  const mod = context.module ? import_picocolors.default.dim(`[${context.module}]`) + " " : "";
+  const svc = import_picocolors.default.dim(`[${service}]`) + " ";
+  let output3 = `${import_picocolors.default.dim(time4)} ${lvl} ${svc}${mod}${message}`;
+  const traceInfo = {};
+  if (context.traceId) traceInfo.traceId = context.traceId;
+  if (context.requestId && context.requestId !== context.traceId) traceInfo.requestId = context.requestId;
+  if (context.caller) traceInfo.caller = context.caller;
+  if (context.duration !== void 0) traceInfo.duration = `${context.duration}ms`;
+  const allData = {
+    ...traceInfo,
+    ...data
+  };
+  if (Object.keys(allData).length > 0) output3 += formatData(allData);
+  if (error49) {
+    output3 += "\n" + import_picocolors.default.red(`               ${error49.name}: ${error49.message}`);
+    if (error49.code) output3 += import_picocolors.default.dim(` (${error49.code})`);
+    if (error49.stack) {
+      const stackLines = error49.stack.split("\n").slice(1, 4);
+      output3 += "\n" + stackLines.map((l) => import_picocolors.default.dim(`               ${l.trim()}`)).join("\n");
+    }
+    if (error49.cause) output3 += "\n" + import_picocolors.default.dim(`               Caused by: ${error49.cause.name}: ${error49.cause.message}`);
+  }
+  return output3;
+}
+function extractErrorInfo(error49, includeStack, visited = /* @__PURE__ */ new WeakSet()) {
+  const info = {
+    name: error49.name,
+    message: error49.message
+  };
+  if (includeStack && error49.stack) info.stack = error49.stack;
+  if ("code" in error49 && typeof error49.code === "string") info.code = error49.code;
+  visited.add(error49);
+  if (error49.cause instanceof Error) if (visited.has(error49.cause)) info.cause = {
+    name: error49.cause.name,
+    message: "[Circular]"
+  };
+  else info.cause = extractErrorInfo(error49.cause, includeStack, visited);
+  return info;
+}
+var import_picocolors, LOG_LEVELS, LEVEL_COLORS, LEVEL_WIDTH, BaseLogger;
+var init_logger_base_W8CRO9aE = __esm({
+  "../../node_modules/@parisgroup-ai/logger/dist/logger.base-W8CRO9aE.mjs"() {
+    init_sanitize_u1LaSkAO();
+    import_picocolors = __toESM(require_picocolors(), 1);
+    LOG_LEVELS = {
+      trace: 0,
+      debug: 1,
+      info: 2,
+      warn: 3,
+      error: 4,
+      fatal: 5
+    };
+    LEVEL_COLORS = {
+      trace: import_picocolors.default.gray,
+      debug: import_picocolors.default.cyan,
+      info: import_picocolors.default.green,
+      warn: import_picocolors.default.yellow,
+      error: import_picocolors.default.red,
+      fatal: (s) => import_picocolors.default.bgRed(import_picocolors.default.white(s))
+    };
+    LEVEL_WIDTH = 5;
     BaseLogger = class {
       level;
       format;
@@ -639,7 +647,8 @@ function createLogger(module, options) {
 var asyncLocalStorage, ConsoleTransport, FileTransport, HttpTransport, SINGLETON_KEY, Logger, logger;
 var init_dist = __esm({
   "../../node_modules/@parisgroup-ai/logger/dist/index.mjs"() {
-    init_logger_base_DJVL2Rjl();
+    init_logger_base_W8CRO9aE();
+    init_sanitize_u1LaSkAO();
     asyncLocalStorage = new AsyncLocalStorage();
     ConsoleTransport = class {
       log(entry, formatted) {
@@ -1575,13 +1584,27 @@ function detectIDEs(home = os3.homedir()) {
       detected: checkExists(path4.join(home, ".codex")),
       configPath: path4.join(home, ".codex", "config.toml")
     },
-    // OpenCode: ~/.opencode
+    // OpenCode: ~/.opencode or XDG ~/.config/opencode
     {
       name: "OpenCode",
       id: "opencode",
-      detected: checkExists(path4.join(home, ".opencode")),
+      detected: checkExists(path4.join(home, ".opencode")) || checkExists(path4.join(home, ".config", "opencode")),
       configPath: path4.join(home, ".opencode", "opencode.json")
     },
+    // Grok CLI: ~/.grok
+    {
+      name: "Grok CLI",
+      id: "grok",
+      detected: checkExists(path4.join(home, ".grok")),
+      configPath: path4.join(home, ".grok", "config.toml")
+    },
+    // Antigravity: ~/.gemini/antigravity-cli
+    {
+      name: "Antigravity",
+      id: "antigravity",
+      detected: checkExists(path4.join(home, ".gemini", "antigravity-cli")),
+      configPath: path4.join(home, ".gemini", "antigravity-cli", "mcp_config.json")
+    },
     // Manual (always available as fallback)
     {
       name: "Manual",
@@ -1598,6 +1621,19 @@ function detectIDEs(home = os3.homedir()) {
     } catch {
     }
   }
+  for (const [id, bin] of [
+    ["grok", "grok"],
+    ["antigravity", "agy"]
+  ]) {
+    const ide = ides.find((i) => i.id === id);
+    if (ide && !ide.detected) {
+      try {
+        execFileSync("which", [bin], { encoding: "utf-8" });
+        ide.detected = true;
+      } catch {
+      }
+    }
+  }
   return ides;
 }
 var init_ide_detector = __esm({
@@ -1906,64 +1942,51 @@ var init_instruction_template_v3 = __esm({
   }
 });
 
-// src/workspace/instruction-files.ts
-var instruction_files_exports = {};
-__export(instruction_files_exports, {
-  installUniversalCommand: () => installUniversalCommand,
-  slugify: () => slugify,
-  upsertRootAgentsBlock: () => upsertRootAgentsBlock,
-  writeInstructionFiles: () => writeInstructionFiles
+// src/workspace/runtime-registry.ts
+var runtime_registry_exports = {};
+__export(runtime_registry_exports, {
+  RUNTIMES: () => RUNTIMES,
+  detectedSlashHints: () => detectedSlashHints,
+  upsertRootAgentsBlock: () => upsertRootAgentsBlock
 });
+import { execFileSync as execFileSync2 } from "node:child_process";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir } from "node:os";
 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 hasBinary(name) {
+  try {
+    execFileSync2("which", [name], { encoding: "utf-8", stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
 }
-function writeInstructionFiles(cwd, ctx, content) {
-  const slug = slugify(ctx.courseTitle);
-  const written = [];
-  const claudeDir = join2(cwd, ".claude", "commands");
-  if (!existsSync2(claudeDir)) {
-    mkdirSync2(claudeDir, { recursive: true });
-  }
-  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
+function writeFile2(absDir, fileName, body) {
+  mkdirSync2(absDir, { recursive: true });
+  writeFileSync2(join2(absDir, fileName), body);
+}
+function cursorMdc(title, content) {
+  return `---
+description: ${title} \u2014 ToStudy Course Guide
 globs: ["**/*"]
 alwaysApply: true
 ---
 
 ${content}`;
-    const cursorFile = `tostudy-${slug}.mdc`;
-    writeFileSync2(join2(cursorDir, cursorFile), mdcContent);
-    written.push(`.cursor/rules/${cursorFile}`);
-  }
-  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`);
-  const rootAgents = upsertRootAgentsBlock(cwd, ctx);
-  if (rootAgents) {
-    written.push(rootAgents);
-  }
-  logger2.info("Generated instruction files (v3)", {
-    slug,
-    files: written
-  });
-  return written;
+}
+function antigravitySkillMd(name, description, content) {
+  return `---
+name: ${name}
+description: >-
+  ${description}
+---
+
+${content}`;
+}
+function detectedSlashHints(slug, home, cwd) {
+  return RUNTIMES.filter((r) => r.slashHint && r.detect(home, cwd)).map((r) => r.slashHint(slug));
 }
 function upsertRootAgentsBlock(cwd, ctx) {
-  const slug = slugify(ctx.courseTitle);
+  const slug = slugifyTitle(ctx.courseTitle);
   const block = [
     "<!-- tostudy:start -->",
     "",
@@ -2007,67 +2030,198 @@ function upsertRootAgentsBlock(cwd, ctx) {
     return null;
   }
 }
-function installUniversalCommand(platform2, cwd = process.cwd(), homeDir = homedir()) {
-  const content = renderUniversalInstruction();
-  const written = [];
-  if (platform2 === "claude") {
-    const dir = join2(cwd, ".claude", "commands");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    writeFileSync2(join2(dir, "tostudy.md"), content);
-    written.push(".claude/commands/tostudy.md");
-  }
-  if (platform2 === "codex") {
-    const dir = join2(homeDir, ".codex", "prompts");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    const file2 = join2(dir, "tostudy.md");
-    writeFileSync2(file2, content);
-    written.push(file2);
-  }
-  if (platform2 === "opencode") {
-    const dir = join2(homeDir, ".config", "opencode", "command");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    const file2 = join2(dir, "tostudy.md");
-    writeFileSync2(
-      file2,
-      `---
-description: ToStudy \u2014 AI Tutor Guide
+function slugifyTitle(title) {
+  return title.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+}
+var logger2, detectOpencode, detectGrok, detectAntigravity, RUNTIMES, TOSTUDY_BLOCK_PATTERN, TOSTUDY_BLOCK_PATTERN_GLOBAL;
+var init_runtime_registry = __esm({
+  "src/workspace/runtime-registry.ts"() {
+    "use strict";
+    init_dist();
+    logger2 = createLogger("cli:runtime-registry");
+    detectOpencode = (home) => existsSync2(join2(home, ".opencode")) || existsSync2(join2(home, ".config", "opencode"));
+    detectGrok = (home) => existsSync2(join2(home, ".grok")) || hasBinary("grok");
+    detectAntigravity = (home) => existsSync2(join2(home, ".gemini", "antigravity-cli")) || hasBinary("agy");
+    RUNTIMES = [
+      {
+        id: "claude",
+        name: "Claude Code",
+        detect: () => hasBinary("claude"),
+        writePerCourse({ cwd, slug, content }) {
+          writeFile2(join2(cwd, ".claude", "commands"), `tostudy-${slug}.md`, content);
+          return [`.claude/commands/tostudy-${slug}.md`];
+        },
+        writeUniversal({ cwd, content }) {
+          writeFile2(join2(cwd, ".claude", "commands"), "tostudy.md", content);
+          return [".claude/commands/tostudy.md"];
+        },
+        slashHint: (slug) => `No Claude Code, digite: /tostudy-${slug}`
+      },
+      {
+        id: "cursor",
+        name: "Cursor",
+        detect: (home, cwd) => existsSync2(join2(home, ".cursor")) || existsSync2(join2(cwd, ".cursor")),
+        writePerCourse({ cwd, slug, ctx, content, force }) {
+          if (!force && !existsSync2(join2(cwd, ".cursor"))) return [];
+          writeFile2(
+            join2(cwd, ".cursor", "rules"),
+            `tostudy-${slug}.mdc`,
+            cursorMdc(ctx.courseTitle, content)
+          );
+          return [`.cursor/rules/tostudy-${slug}.mdc`];
+        },
+        writeUniversal({ cwd, content }) {
+          writeFile2(join2(cwd, ".cursor", "rules"), "tostudy.mdc", cursorMdc("ToStudy", content));
+          return [".cursor/rules/tostudy.mdc"];
+        }
+      },
+      {
+        id: "codex",
+        name: "Codex",
+        detect: (home) => existsSync2(join2(home, ".codex")),
+        // No writePerCourse: Codex has no project-level command channel — the
+        // root AGENTS.md managed block (generic entry) is its per-course path.
+        writeUniversal({ home, content }) {
+          const file2 = join2(home, ".codex", "prompts", "tostudy.md");
+          writeFile2(join2(home, ".codex", "prompts"), "tostudy.md", content);
+          return [file2];
+        }
+      },
+      {
+        id: "opencode",
+        name: "OpenCode",
+        detect: (home) => detectOpencode(home),
+        writePerCourse({ cwd, home, slug, ctx, content, force }) {
+          if (!force && !detectOpencode(home)) return [];
+          const body = `---
+description: ${ctx.courseTitle} \u2014 ToStudy Course Guide
 ---
 
-${content}`
-    );
-    written.push(file2);
-  }
-  if (platform2 === "cursor") {
-    const dir = join2(cwd, ".cursor", "rules");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    const mdcContent = `---
+${content}`;
+          writeFile2(join2(cwd, ".opencode", "command"), `tostudy-${slug}.md`, body);
+          return [`.opencode/command/tostudy-${slug}.md`];
+        },
+        writeUniversal({ home, content }) {
+          const dir = join2(home, ".config", "opencode", "command");
+          const body = `---
 description: ToStudy \u2014 AI Tutor Guide
-globs: ["**/*"]
-alwaysApply: true
 ---
 
 ${content}`;
-    writeFileSync2(join2(dir, "tostudy.mdc"), mdcContent);
-    written.push(".cursor/rules/tostudy.mdc");
-  }
-  if (platform2 === "generic") {
-    const dir = join2(cwd, ".tostudy");
-    if (!existsSync2(dir)) mkdirSync2(dir, { recursive: true });
-    writeFileSync2(join2(dir, "AGENTS.md"), content);
-    written.push(".tostudy/AGENTS.md");
+          writeFile2(dir, "tostudy.md", body);
+          return [join2(dir, "tostudy.md")];
+        },
+        slashHint: (slug) => `No OpenCode, digite: /tostudy-${slug}`
+      },
+      {
+        id: "grok",
+        name: "Grok CLI",
+        detect: (home) => detectGrok(home),
+        writePerCourse({ cwd, home, slug, content, force }) {
+          if (!force && !detectGrok(home)) return [];
+          writeFile2(join2(cwd, ".grok", "commands"), `tostudy-${slug}.md`, content);
+          return [`.grok/commands/tostudy-${slug}.md`];
+        },
+        writeUniversal({ home, content }) {
+          const dir = join2(home, ".grok", "commands");
+          writeFile2(dir, "tostudy.md", content);
+          return [join2(dir, "tostudy.md")];
+        },
+        slashHint: (slug) => `No Grok, digite: /tostudy-${slug}`
+      },
+      {
+        id: "antigravity",
+        name: "Antigravity",
+        detect: (home) => detectAntigravity(home),
+        writePerCourse({ cwd, home, slug, ctx, content, force }) {
+          if (!force && !detectAntigravity(home)) return [];
+          writeFile2(
+            join2(cwd, ".agents", "skills", `tostudy-${slug}`),
+            "SKILL.md",
+            antigravitySkillMd(
+              `tostudy-${slug}`,
+              `${ctx.courseTitle} \u2014 ToStudy Course Guide. Use when the student asks to study, continue the course, or runs tostudy commands.`,
+              content
+            )
+          );
+          return [`.agents/skills/tostudy-${slug}/SKILL.md`];
+        },
+        writeUniversal({ cwd, content }) {
+          writeFile2(
+            join2(cwd, ".agents", "skills", "tostudy"),
+            "SKILL.md",
+            antigravitySkillMd(
+              "tostudy",
+              "ToStudy \u2014 AI Tutor Guide. Use when the student asks to study or runs tostudy commands.",
+              content
+            )
+          );
+          return [".agents/skills/tostudy/SKILL.md"];
+        },
+        slashHint: (slug) => `No Antigravity, a skill tostudy-${slug} ativa automaticamente`
+      },
+      {
+        id: "generic",
+        name: "Generic (AGENTS.md)",
+        // Windsurf is the remaining consumer of the generic universal install.
+        detect: (home) => existsSync2(join2(home, ".codeium", "windsurf")),
+        writePerCourse({ cwd, slug, ctx, content }) {
+          writeFile2(join2(cwd, ".tostudy", "courses", slug), "AGENTS.md", content);
+          const written = [`.tostudy/courses/${slug}/AGENTS.md`];
+          const rootAgents = upsertRootAgentsBlock(cwd, ctx);
+          if (rootAgents) written.push(rootAgents);
+          return written;
+        },
+        writeUniversal({ cwd, content }) {
+          writeFile2(join2(cwd, ".tostudy"), "AGENTS.md", content);
+          return [".tostudy/AGENTS.md"];
+        }
+      }
+    ];
+    TOSTUDY_BLOCK_PATTERN = /<!-- tostudy:start -->[\s\S]*?<!-- tostudy:end -->/;
+    TOSTUDY_BLOCK_PATTERN_GLOBAL = /<!-- tostudy:start -->[\s\S]*?<!-- tostudy:end -->/g;
   }
-  logger2.info("Installed universal /tostudy command", { platform: platform2, files: written });
+});
+
+// src/workspace/instruction-files.ts
+var instruction_files_exports = {};
+__export(instruction_files_exports, {
+  installUniversalCommand: () => installUniversalCommand,
+  slugify: () => slugify,
+  upsertRootAgentsBlock: () => upsertRootAgentsBlock,
+  writeInstructionFiles: () => writeInstructionFiles
+});
+import { homedir } 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);
+}
+function writeInstructionFiles(cwd, ctx, content, opts = {}) {
+  const home = opts.home ?? homedir();
+  const force = opts.allRuntimes ?? false;
+  const slug = slugify(ctx.courseTitle);
+  const written = RUNTIMES.flatMap(
+    (r) => r.writePerCourse?.({ cwd, home, slug, ctx, content, force }) ?? []
+  );
+  logger3.info("Generated instruction files (v3)", { slug, files: written });
+  return written;
+}
+function installUniversalCommand(platform2, cwd = process.cwd(), homeDir = homedir()) {
+  const entry = RUNTIMES.find((r) => r.id === platform2);
+  if (!entry?.writeUniversal) return [];
+  const content = renderUniversalInstruction();
+  const written = entry.writeUniversal({ cwd, home: homeDir, content });
+  logger3.info("Installed universal /tostudy command", { platform: platform2, files: written });
   return written;
 }
-var logger2, TOSTUDY_BLOCK_PATTERN, TOSTUDY_BLOCK_PATTERN_GLOBAL;
+var logger3;
 var init_instruction_files = __esm({
   "src/workspace/instruction-files.ts"() {
     "use strict";
     init_dist();
     init_instruction_template_v3();
-    logger2 = createLogger("cli:instruction-files");
-    TOSTUDY_BLOCK_PATTERN = /<!-- tostudy:start -->[\s\S]*?<!-- tostudy:end -->/;
-    TOSTUDY_BLOCK_PATTERN_GLOBAL = /<!-- tostudy:start -->[\s\S]*?<!-- tostudy:end -->/g;
+    init_runtime_registry();
+    init_runtime_registry();
+    logger3 = createLogger("cli:instruction-files");
   }
 });
 
@@ -2140,16 +2294,7 @@ async function loginWithMagicLink(magicLinkUrl, apiUrl) {
   await persistSession(data, apiUrl);
   return data;
 }
-function ideToPlatform(ideName) {
-  const lower = ideName.toLowerCase();
-  if (lower.includes("claude")) return "claude";
-  if (lower.includes("codex")) return "codex";
-  if (lower.includes("cursor")) return "cursor";
-  if (lower.includes("opencode")) return "opencode";
-  if (lower.includes("windsurf") || lower.includes("antigravity")) return "generic";
-  return null;
-}
-var logger3, DEFAULT_API_URL, PORT, loginCommand;
+var logger4, DEFAULT_API_URL, PORT, loginCommand;
 var init_login = __esm({
   "src/commands/login.ts"() {
     "use strict";
@@ -2159,7 +2304,7 @@ var init_login = __esm({
     init_oauth_server();
     init_session_store();
     init_formatter();
-    logger3 = createLogger("cli:login");
+    logger4 = 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("--code <code>", "Login n\xE3o-interativo via c\xF3digo de autentica\xE7\xE3o").option("--magic-link <url>", "Login via URL de magic-link (recupera\xE7\xE3o)").option("--api-url <url>", "API URL override", DEFAULT_API_URL).action(async (opts) => {
@@ -2224,6 +2369,8 @@ var init_login = __esm({
         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 { RUNTIMES: RUNTIMES2 } = await Promise.resolve().then(() => (init_runtime_registry(), runtime_registry_exports));
+          const { homedir: homedir2 } = await import("node:os");
           const ides = detectIDEs2();
           const detected = ides.filter((ide) => ide.detected);
           if (detected.length > 0) {
@@ -2231,27 +2378,26 @@ var init_login = __esm({
             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);
-              }
+          }
+          const cwd = process.cwd();
+          const home = homedir2();
+          const installedFiles = [];
+          for (const runtime of RUNTIMES2) {
+            if (runtime.writeUniversal && runtime.detect(home, cwd)) {
+              installedFiles.push(...installUniversalCommand2(runtime.id, cwd));
             }
-            if (installedFiles.length > 0) {
-              console.log("");
-              for (const file2 of [...new Set(installedFiles)]) {
-                console.log(`  \u2713 Instalado: ${file2}`);
-              }
+          }
+          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 });
+          const courses3 = await listCourses({ userId }, { data, logger: logger4 });
           if (courses3.length > 0) {
             console.log(`
   \u2713 ${courses3.length} curso(s) matriculado(s)`);
@@ -2775,16 +2921,16 @@ var init_setup = __esm({
 });
 
 // src/installer/node-detector.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
+import { execFileSync as execFileSync3 } from "node:child_process";
 function detectNode() {
   try {
-    const version3 = execFileSync2("node", ["--version"], {
+    const version3 = execFileSync3("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();
+      nodePath = execFileSync3(whichCmd, ["node"], { encoding: "utf-8" }).trim();
     } catch {
     }
     const major = parseInt(version3.replace("v", ""), 10);
@@ -2804,7 +2950,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "0.13.0" : "0.7.1";
+    CLI_VERSION = true ? "0.15.0" : "0.7.1";
   }
 });
 
@@ -2814,22 +2960,24 @@ __export(update_checker_exports, {
   checkForUpdates: () => checkForUpdates,
   checkVersionSync: () => checkVersionSync,
   fetchLatestVersion: () => fetchLatestVersion,
-  isNewerVersion: () => isNewerVersion
+  isNewerVersion: () => isNewerVersion,
+  readCache: () => readCache,
+  writeCache: () => writeCache
 });
 import fs7 from "node:fs";
 import path9 from "node:path";
-function readCache() {
+function readCache(configDir) {
   try {
-    const p = path9.join(getConfigDir(), CACHE_FILE);
+    const p = path9.join(configDir ?? getConfigDir(), CACHE_FILE);
     if (!fs7.existsSync(p)) return null;
     return JSON.parse(fs7.readFileSync(p, "utf-8"));
   } catch {
     return null;
   }
 }
-function writeCache(cache) {
+function writeCache(cache, configDir) {
   try {
-    const dir = getConfigDir();
+    const dir = configDir ?? getConfigDir();
     fs7.mkdirSync(dir, { recursive: true });
     fs7.writeFileSync(path9.join(dir, CACHE_FILE), JSON.stringify(cache));
   } catch {
@@ -2993,14 +3141,14 @@ var init_doctor = __esm({
         git: null
       };
       try {
-        const { execFileSync: execFileSync3 } = await import("node:child_process");
-        envChecks["pnpm"] = execFileSync3("pnpm", ["--version"], { encoding: "utf-8" }).trim();
+        const { execFileSync: execFileSync4 } = await import("node:child_process");
+        envChecks["pnpm"] = execFileSync4("pnpm", ["--version"], { encoding: "utf-8" }).trim();
       } catch {
         envChecks["pnpm"] = null;
       }
       try {
-        const { execFileSync: execFileSync3 } = await import("node:child_process");
-        envChecks["git"] = execFileSync3("git", ["--version"], { encoding: "utf-8" }).trim().replace("git version ", "");
+        const { execFileSync: execFileSync4 } = await import("node:child_process");
+        envChecks["git"] = execFileSync4("git", ["--version"], { encoding: "utf-8" }).trim().replace("git version ", "");
       } catch {
         envChecks["git"] = null;
       }
@@ -3179,7 +3327,7 @@ var init_doctor = __esm({
 
 // src/commands/courses.ts
 import { Command as Command5 } from "commander";
-var logger4, coursesCommand;
+var logger5, coursesCommand;
 var init_courses2 = __esm({
   "src/commands/courses.ts"() {
     "use strict";
@@ -3188,12 +3336,12 @@ var init_courses2 = __esm({
     init_http();
     init_guards();
     init_formatter();
-    logger4 = createLogger("cli:courses");
+    logger5 = createLogger("cli:courses");
     coursesCommand = new Command5("courses").description("List your enrolled courses with progress").option("--json", "Output structured JSON").option("--mine", "List only your own courses, including drafts").action(async (opts) => {
       try {
         const session = await requireSession();
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger4 };
+        const deps = { data, logger: logger5 };
         let coursesToList;
         if (opts.mine) {
           coursesToList = await data.courses.listCreatorCourses({
@@ -3525,7 +3673,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
         });
       }
     } catch (err) {
-      logger5.warn("T0 fetch failed \u2014 rendering without persona", { err });
+      logger6.warn("T0 fetch failed \u2014 rendering without persona", { err });
       tutorPersona = null;
     }
   }
@@ -3549,7 +3697,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
         fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
     } catch (err) {
-      logger5.warn("T1 fetch failed \u2014 rendering without brief", { err });
+      logger6.warn("T1 fetch failed \u2014 rendering without brief", { err });
     }
   }
   if (!studentBrief && options.collectT1Interactive) {
@@ -3569,7 +3717,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
       });
       bootstrapped = "t1";
     } catch (err) {
-      logger5.warn("T1 bootstrap failed", { err });
+      logger6.warn("T1 bootstrap failed", { err });
     }
   }
   let enrollmentProfile = null;
@@ -3583,7 +3731,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
       enrollmentProfile = onboarding.learnerProfile;
     }
   } catch (err) {
-    logger5.warn("T2 fetch failed \u2014 rendering without enrollment profile", { err });
+    logger6.warn("T2 fetch failed \u2014 rendering without enrollment profile", { err });
   }
   const content = renderCourseInstruction({
     course: {
@@ -3607,7 +3755,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
       courseTitle: courseMeta.courseTitle
     });
   } catch (err) {
-    logger5.warn("Failed to write workspace marker", { err });
+    logger6.warn("Failed to write workspace marker", { err });
   }
   if (markerPath) {
     try {
@@ -3617,7 +3765,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
         lastInitCourseId: input2.courseId
       });
     } catch (err) {
-      logger5.warn("Failed to update workspace state v2 fields", {
+      logger6.warn("Failed to update workspace state v2 fields", {
         error: err instanceof Error ? err.message : String(err)
       });
     }
@@ -3632,7 +3780,7 @@ async function resolveAndGenerate(input2, options = {}, context) {
     renderedInstruction: content
   };
 }
-var logger5, defaultDeps2;
+var logger6, defaultDeps2;
 var init_instruction_pipeline = __esm({
   "src/instruction-pipeline.ts"() {
     "use strict";
@@ -3647,7 +3795,7 @@ var init_instruction_pipeline = __esm({
     init_api3();
     init_session_store();
     init_instruction_template_v3();
-    logger5 = createLogger("cli:instruction-pipeline");
+    logger6 = createLogger("cli:instruction-pipeline");
     defaultDeps2 = {
       fetchTutorPersona: fetchTutorPersonality,
       fetchLearnerBrief,
@@ -3670,7 +3818,7 @@ var init_instruction_pipeline = __esm({
 async function fetchCourseMetaViaHttp(input2) {
   const { session, courseId, enrollmentId } = input2;
   const data = createHttpProvider(session.apiUrl, session.token);
-  const coreDeps = { data, logger: logger6 };
+  const coreDeps = { data, logger: logger7 };
   const detail = await selectCourse({ userId: session.userId, courseId }, coreDeps);
   let currentModuleTitle;
   let currentLessonTitle;
@@ -3679,7 +3827,7 @@ async function fetchCourseMetaViaHttp(input2) {
     currentModuleTitle = progress3.currentModule?.title;
     currentLessonTitle = progress3.currentLesson?.title;
   } catch (err) {
-    logger6.debug("getProgress failed \u2014 falling back to basic course meta", {
+    logger7.debug("getProgress failed \u2014 falling back to basic course meta", {
       error: err instanceof Error ? err.message : String(err)
     });
   }
@@ -3693,7 +3841,7 @@ async function fetchCourseMetaViaHttp(input2) {
       courseLevel = match.level;
     }
   } catch (err) {
-    logger6.debug("listCourses failed \u2014 skipping tags/level", {
+    logger7.debug("listCourses failed \u2014 skipping tags/level", {
       error: err instanceof Error ? err.message : String(err)
     });
   }
@@ -3713,7 +3861,7 @@ async function fetchCourseMetaViaHttp(input2) {
     }
   };
 }
-async function writeFilesAdapter(cwd, courseMeta, content) {
+async function writeFilesAdapter(cwd, courseMeta, content, opts = {}) {
   return writeInstructionFiles(
     cwd,
     {
@@ -3726,17 +3874,18 @@ async function writeFilesAdapter(cwd, courseMeta, content) {
       currentLessonTitle: courseMeta.progress.currentLessonTitle,
       courseDescription: courseMeta.courseDescription
     },
-    content
+    content,
+    { allRuntimes: opts.allRuntimes }
   );
 }
-function buildPipelineDeps() {
+function buildPipelineDeps(opts = {}) {
   return {
     ...defaultDeps2,
     fetchCourseMeta: fetchCourseMetaViaHttp,
-    writeFiles: writeFilesAdapter
+    writeFiles: (cwd, courseMeta, content) => writeFilesAdapter(cwd, courseMeta, content, opts)
   };
 }
-var logger6;
+var logger7;
 var init_pipeline_deps = __esm({
   "src/commands/_shared/pipeline-deps.ts"() {
     "use strict";
@@ -3745,14 +3894,14 @@ var init_pipeline_deps = __esm({
     init_http();
     init_instruction_pipeline();
     init_instruction_files();
-    logger6 = createLogger("cli:pipeline-deps");
+    logger7 = createLogger("cli:pipeline-deps");
   }
 });
 
 // src/commands/select.ts
 import { Command as Command6 } from "commander";
 import os7 from "node:os";
-var logger7, selectCommand;
+var logger8, selectCommand;
 var init_select = __esm({
   "src/commands/select.ts"() {
     "use strict";
@@ -3762,17 +3911,18 @@ var init_select = __esm({
     init_guards();
     init_workspace_marker();
     init_resolve();
+    init_runtime_registry();
     init_formatter();
     init_errors();
     init_status();
     init_instruction_pipeline();
     init_pipeline_deps();
-    logger7 = createLogger("cli:select");
+    logger8 = 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: logger7 };
+        const deps = { data, logger: logger8 };
         const courses3 = await listCourses({ userId: session.userId }, deps);
         let courseId = course;
         let enrollmentId = "";
@@ -3811,7 +3961,7 @@ var init_select = __esm({
             { cwd: process.cwd(), deps: buildPipelineDeps() }
           );
         } catch (err) {
-          logger7.warn("Failed to run instruction pipeline", {
+          logger8.warn("Failed to run instruction pipeline", {
             error: err instanceof Error ? err.message : String(err)
           });
         }
@@ -3862,12 +4012,18 @@ var init_select = __esm({
           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"
-          );
+          lines.push("", "\u2192 Abra sua plataforma (claude, codex, cursor...)");
+          if (courseSlug2) {
+            const hints = detectedSlashHints(courseSlug2, home, cwd);
+            if (hints.length > 0) {
+              lines.push(...hints.map((h) => `\u2192 ${h}`));
+            } else {
+              lines.push(`\u2192 No Claude Code, digite: ${slashCmd}`);
+            }
+          } else {
+            lines.push(`\u2192 No Claude Code, digite: ${slashCmd}`);
+          }
+          lines.push("\u2192 Em outras plataformas: tostudy init");
           output(lines.join("\n"), { json: false });
         }
       } catch (err) {
@@ -3884,7 +4040,7 @@ var init_select = __esm({
 
 // src/commands/progress.ts
 import { Command as Command7 } from "commander";
-var logger8, progressCommand;
+var logger9, progressCommand;
 var init_progress = __esm({
   "src/commands/progress.ts"() {
     "use strict";
@@ -3895,7 +4051,7 @@ var init_progress = __esm({
     init_course_state();
     init_formatter();
     init_errors();
-    logger8 = createLogger("cli:progress");
+    logger9 = 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();
@@ -3903,7 +4059,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: logger8 };
+        const deps = { data, logger: logger9 };
         const progress3 = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
         if (opts.json) {
           output(progress3, { json: true });
@@ -5468,7 +5624,7 @@ var init_query_promise = __esm({
 function mapResultRow(columns, row, joinsNotNullableMap) {
   const nullifyMap = {};
   const result = columns.reduce(
-    (result2, { path: path23, field }, columnIndex) => {
+    (result2, { path: path24, field }, columnIndex) => {
       let decoder;
       if (is(field, Column)) {
         decoder = field;
@@ -5480,8 +5636,8 @@ function mapResultRow(columns, row, joinsNotNullableMap) {
         decoder = field.sql.decoder;
       }
       let node = result2;
-      for (const [pathChunkIndex, pathChunk] of path23.entries()) {
-        if (pathChunkIndex < path23.length - 1) {
+      for (const [pathChunkIndex, pathChunk] of path24.entries()) {
+        if (pathChunkIndex < path24.length - 1) {
           if (!(pathChunk in node)) {
             node[pathChunk] = {};
           }
@@ -5489,8 +5645,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) && path23.length === 2) {
-            const objectName = path23[0];
+          if (joinsNotNullableMap && is(field, Column) && path24.length === 2) {
+            const objectName = path24[0];
             if (!(objectName in nullifyMap)) {
               nullifyMap[objectName] = value === null ? getTableName(field.table) : false;
             } else if (typeof nullifyMap[objectName] === "string" && nullifyMap[objectName] !== getTableName(field.table)) {
@@ -9437,13 +9593,13 @@ function Subscribe(postgres2, options) {
       }
     }
     function handle(a, b2) {
-      const path23 = b2.relation.schema + "." + b2.relation.table;
+      const path24 = b2.relation.schema + "." + b2.relation.table;
       call("*", a, b2);
-      call("*:" + path23, a, b2);
-      b2.relation.keys.length && call("*:" + path23 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call("*:" + path24, a, b2);
+      b2.relation.keys.length && call("*:" + path24 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
       call(b2.command, a, b2);
-      call(b2.command + ":" + path23, a, b2);
-      b2.relation.keys.length && call(b2.command + ":" + path23 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
+      call(b2.command + ":" + path24, a, b2);
+      b2.relation.keys.length && call(b2.command + ":" + path24 + "=" + b2.relation.keys.map((x2) => a[x2.name]), a, b2);
     }
     function pong() {
       const x2 = Buffer.alloc(34);
@@ -9556,8 +9712,8 @@ function parseEvent(x) {
   const xs = x.match(/^(\*|insert|update|delete)?:?([^.]+?\.?[^=]+)?=?(.+)?/i) || [];
   if (!xs)
     throw new Error("Malformed subscribe pattern: " + x);
-  const [, command, path23, key] = xs;
-  return (command || "*") + (path23 ? ":" + (path23.indexOf(".") === -1 ? "public." + path23 : path23) : "") + (key ? "=" + key : "");
+  const [, command, path24, key] = xs;
+  return (command || "*") + (path24 ? ":" + (path24.indexOf(".") === -1 ? "public." + path24 : path24) : "") + (key ? "=" + key : "");
 }
 var noop2;
 var init_subscribe = __esm({
@@ -9695,10 +9851,10 @@ function Postgres(a, b2) {
       });
       return query;
     }
-    function file2(path23, args = [], options2 = {}) {
+    function file2(path24, args = [], options2 = {}) {
       arguments.length === 2 && !Array.isArray(args) && (options2 = args, args = []);
       const query = new Query([], args, (query2) => {
-        fs11.readFile(path23, "utf8", (err, string4) => {
+        fs11.readFile(path24, "utf8", (err, string4) => {
           if (err)
             return query2.reject(err);
           query2.strings = [string4];
@@ -14277,12 +14433,12 @@ var init_session2 = __esm({
     init_tracing();
     init_utils();
     PostgresJsPreparedQuery = class extends PgPreparedQuery {
-      constructor(client, queryString, params, logger34, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
+      constructor(client, queryString, params, logger35, cache, queryMetadata, cacheConfig, fields, _isResponseInArrayMode, customResultMapper) {
         super({ sql: queryString, params }, cache, queryMetadata, cacheConfig);
         this.client = client;
         this.queryString = queryString;
         this.params = params;
-        this.logger = logger34;
+        this.logger = logger35;
         this.fields = fields;
         this._isResponseInArrayMode = _isResponseInArrayMode;
         this.customResultMapper = customResultMapper;
@@ -14423,11 +14579,11 @@ function construct(client, config2 = {}) {
   client.options.serializers["114"] = transparentParser;
   client.options.serializers["3802"] = transparentParser;
   const dialect = new PgDialect({ casing: config2.casing });
-  let logger34;
+  let logger35;
   if (config2.logger === true) {
-    logger34 = new DefaultLogger();
+    logger35 = new DefaultLogger();
   } else if (config2.logger !== false) {
-    logger34 = config2.logger;
+    logger35 = config2.logger;
   }
   let schema;
   if (config2.schema) {
@@ -14441,7 +14597,7 @@ function construct(client, config2 = {}) {
       tableNamesMap: tablesConfig.tableNamesMap
     };
   }
-  const session = new PostgresJsSession(client, dialect, schema, { logger: logger34, cache: config2.cache });
+  const session = new PostgresJsSession(client, dialect, schema, { logger: logger35, cache: config2.cache });
   const db2 = new PostgresJsDatabase(dialect, session, schema);
   db2.$client = client;
   db2.$cache = config2.cache;
@@ -14756,10 +14912,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path23) {
-  if (!path23)
+function getElementAtPath(obj, path24) {
+  if (!path24)
     return obj;
-  return path23.reduce((acc, key) => acc?.[key], obj);
+  return path24.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -15071,11 +15227,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path23, issues) {
+function prefixIssues(path24, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path23);
+    iss.path.unshift(path24);
     return iss;
   });
 }
@@ -15317,7 +15473,7 @@ function formatError(error49, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error49, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error50, path23 = []) => {
+  const processError = (error50, path24 = []) => {
     var _a2, _b;
     for (const issue2 of error50.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -15327,7 +15483,7 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path23, ...issue2.path];
+        const fullpath = [...path24, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -15359,8 +15515,8 @@ function treeifyError(error49, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path23 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path23) {
+  const path24 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path24) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -28054,13 +28210,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path23 = ref.slice(1).split("/").filter(Boolean);
-  if (path23.length === 0) {
+  const path24 = ref.slice(1).split("/").filter(Boolean);
+  if (path24.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path23[0] === defsKey) {
-    const key = path23[1];
+  if (path24[0] === defsKey) {
+    const key = path24[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -29167,7 +29323,7 @@ var init_user_preferences = __esm({
 });
 
 // ../../packages/database/src/schema/mcp.ts
-var mcpSessions, syncLogs, platformConfig;
+var mcpSessions, syncLogs;
 var init_mcp = __esm({
   "../../packages/database/src/schema/mcp.ts"() {
     "use strict";
@@ -29230,11 +29386,6 @@ var init_mcp = __esm({
         syncedAtIdx: index("idx_sync_logs_synced_at").on(table.syncedAt)
       })
     );
-    platformConfig = pgTable("platform_config", {
-      key: varchar("key", { length: 50 }).primaryKey(),
-      value: text("value").notNull(),
-      updatedAt: timestamp("updated_at").defaultNow().notNull()
-    });
   }
 });
 
@@ -29568,6 +29719,13 @@ var init_tutor_feedback = __esm({
   }
 });
 
+// ../../packages/types/src/lesson-review.ts
+var init_lesson_review = __esm({
+  "../../packages/types/src/lesson-review.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/types/src/errors.ts
 var init_errors6 = __esm({
   "../../packages/types/src/errors.ts"() {
@@ -29599,7 +29757,8 @@ var init_credit_payment_enums = __esm({
       // course_sale_credit (legacy Stripe 20/85) so reconciliation/clawback never
       // conflate the two funding models.
       "course_enrollment_debit",
-      "course_enrollment_credit"
+      "course_enrollment_credit",
+      "referral_bonus"
     ];
     CREDIT_SUBSCRIPTION_STATUS_VALUES = [
       "active",
@@ -29619,6 +29778,13 @@ var init_credit_payment_enums = __esm({
   }
 });
 
+// ../../packages/types/src/referral.ts
+var init_referral = __esm({
+  "../../packages/types/src/referral.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/types/src/index.ts
 var init_src2 = __esm({
   "../../packages/types/src/index.ts"() {
@@ -29632,8 +29798,10 @@ var init_src2 = __esm({
     init_exercise_type();
     init_lesson_contract();
     init_tutor_feedback();
+    init_lesson_review();
     init_errors6();
     init_credit_payment_enums();
+    init_referral();
   }
 });
 
@@ -30016,7 +30184,7 @@ var init_llm_analytics = __esm({
         // Operation type
         operationType: varchar("operation_type", { length: 50 }).notNull(),
         // Provider (references llm_provider enum from llm-pricing.ts)
-        provider: llmProviderEnum("provider").notNull().default("anthropic"),
+        provider: llmProviderEnum("provider").notNull().default("other"),
         // Tracing
         correlationId: varchar("correlation_id", { length: 64 }),
         // Relationships
@@ -30036,6 +30204,11 @@ var init_llm_analytics = __esm({
         responseTokens: integer("response_tokens"),
         // Cost & Revenue
         costUsd: decimal("cost_usd", { precision: 10, scale: 6 }),
+        // spec 2026-07-10 phase 3.3: where cost_usd came from - 'table' (pricing
+        // table rate), 'gateway' (LiteLLM-reported cost fallback), 'unpriced'
+        // (no rate anywhere: cost_usd=0, alertable). Nullable: rows predating the
+        // marker stay null.
+        costSource: varchar("cost_source", { length: 16 }),
         revenueUsd: decimal("revenue_usd", { precision: 10, scale: 6 }).default("0"),
         // Cache metrics (prompt caching)
         cacheCreationTokens: integer("cache_creation_tokens").default(0),
@@ -30062,6 +30235,12 @@ var init_llm_analytics = __esm({
           "llm_interactions_status_check",
           sql`${table.status} IN ('pending', 'success', 'error', 'timeout', 'abandoned')`
         ),
+        // spec 2026-07-10 phase 3.3: cost_source vocabulary — NULL allowed for
+        // rows predating the marker.
+        costSourceVocabularyCheck: check(
+          "llm_interactions_cost_source_check",
+          sql`${table.costSource} IS NULL OR ${table.costSource} IN ('table', 'gateway', 'unpriced')`
+        ),
         creatorIdx: index("idx_llm_interactions_creator").on(table.creatorId, table.createdAt),
         operationIdx: index("idx_llm_interactions_operation").on(table.operationType, table.createdAt),
         correlationIdx: index("idx_llm_interactions_correlation").on(table.correlationId),
@@ -30148,7 +30327,9 @@ var init_credit_wallets = __esm({
       // Credits-first (WS3/WS4): student debit (-), creator full-price credit (+).
       course_enrollment_debit: "negative",
       course_enrollment_credit: "positive",
-      adjustment: "either"
+      adjustment: "either",
+      // Referral program (spec 2026-07-17): both-sides fixed grant on first purchase.
+      referral_bonus: "positive"
     };
     WITHDRAWABLE_LEDGER_TYPES = [
       "course_sale_credit",
@@ -30194,6 +30375,7 @@ var init_credit_wallets = __esm({
       "subscription",
       "package",
       "withdrawal",
+      "referral",
       "backfill",
       "credit_transaction_migration"
     ];
@@ -30248,6 +30430,12 @@ var init_credit_wallets = __esm({
         // the PK). Raw `sql` literal (not eq()) to dodge the drizzle-kit `$N`
         // placeholder DDL bug — see packages/database/AGENTS.md.
         courseSaleCreditEnrollmentUnique: uniqueIndex("cwt_course_sale_credit_enrollment_unique").on(table.referenceId, table.referenceType, table.type).where(sql`${table.type} = 'course_sale_credit' AND ${table.referenceType} = 'enrollment'`),
+        cwtPurchasePaymentIntentUnique: uniqueIndex("cwt_purchase_payment_intent_unique").on(sql`(${table.metadata}->>'stripe_payment_intent_id')`).where(sql`${table.type} = 'purchase'`),
+        // Idempotency guard for subscription reloads via stripe invoice.
+        // Closes the double-reload window when Stripe invoice webhook fires concurrently
+        // or re-delivers. Raw `sql` literal (not eq()) to dodge the drizzle-kit `$N`
+        // placeholder DDL bug — see packages/database/AGENTS.md.
+        cwtSubscriptionReloadInvoiceUnique: uniqueIndex("cwt_subscription_reload_invoice_unique").on(sql`(${table.metadata}->>'stripe_invoice_id')`).where(sql`${table.type} = 'subscription_reload'`),
         // Idempotency guard for the AI-consumption reconciliation sweep (CHORE-credit-recon).
         // The sweep must not double-charge a debit the inline path already committed;
         // this index makes the DB the final arbiter — a second ai_consumption insert
@@ -30257,23 +30445,34 @@ var init_credit_wallets = __esm({
         // Raw `sql` literal (not eq()) to dodge the drizzle-kit `$N` placeholder DDL
         // bug (packages/database/AGENTS.md).
         aiConsumptionInteractionUniq: uniqueIndex("cwt_ai_consumption_interaction_uniq").on(table.interactionId).where(sql`${table.type} = 'ai_consumption' AND ${table.interactionId} IS NOT NULL`),
-        // Credits-first (WS3/WS4): NO partial-unique DB index for course_enrollment_debit
-        // / course_enrollment_credit. A partial index whose predicate references a
-        // freshly-added enum value cannot be created in this repo's one-transaction
-        // `pnpm db:migrate` (AGENTS.md): the enum literal trips check_safe_enum_use
-        // (enum.c) and a `::text` cast is non-IMMUTABLE so it trips CheckPredicate.
-        // Unlike the webhook-driven legacy paths (course_sale_credit / refund_debit),
-        // which need a DB race-guard against concurrent Stripe deliveries, the
-        // credit-debit enrollment path is a SYNCHRONOUS user mutation — idempotency is
-        // enforced at the application layer (EnrollWithCreditsUseCase: find-existing
-        // enrollment + atomic debit/credit/enrollment in one tx). If post-launch
-        // reconciliation surfaces a need, add the partial index in a standalone
-        // migration once these enum values are universally committed.
+        // Credits-first ramp gate (credits-ssot-ux WS1): partial UNIQUE closes the
+        // double-debit window in EnrollWithCreditsUseCase before the
+        // `feature.credit_debit_enrollment_enabled` ramp. The advisory lock + re-check
+        // covers the double-click case, but the DB is the final arbiter against any
+        // path that bypasses the lock (retry storms, future callers); the use-case
+        // catches 23505 as AlreadyEnrolled. This is the "standalone migration once
+        // these enum values are universally committed" the previous note here
+        // anticipated: the enum values landed in 0044 (13 migrations back, deployed
+        // to prod), and a cold-boot single-transaction `pnpm db:migrate` is safe
+        // because the TYPE itself is created in that same transaction (enum.c's
+        // check_safe_enum_use only restricts values added to a PRE-EXISTING type).
+        // Scoped to type='course_enrollment_debit' AND reference_type='enrollment' —
+        // predicate-disjoint from every other partial index on this table, so the
+        // `undefined`-constraint branches of the sibling 23505 detectors stay safe.
+        // course_enrollment_credit needs no index of its own: it is written in the
+        // SAME transaction as the debit, so the debit index aborts both. Raw `sql`
+        // literal (not eq()) to dodge the drizzle-kit `$N` placeholder DDL bug —
+        // see packages/database/AGENTS.md.
+        courseEnrollmentDebitEnrollmentUnique: uniqueIndex(
+          "cwt_course_enrollment_debit_enrollment_unique"
+        ).on(table.referenceId, table.referenceType, table.type).where(
+          sql`${table.type} = 'course_enrollment_debit' AND ${table.referenceType} = 'enrollment'`
+        ),
         referenceTypeCheck: check(
           "cwt_reference_type_check",
           sql`${table.referenceType} IS NULL OR ${table.referenceType} IN (
         'ai_operation', 'enrollment', 'booking',
-        'subscription', 'package', 'withdrawal',
+        'subscription', 'package', 'withdrawal', 'referral',
         'backfill', 'credit_transaction_migration'
       )`
         )
@@ -30323,6 +30522,10 @@ var init_credit_packages = __esm({
         }).notNull(),
         isActive: boolean("is_active").notNull().default(true),
         includesCatalog: boolean("includes_catalog").notNull().default(true),
+        // Subscription tiers 2026-07-07 spec: % off AI-usage debits (0 = none).
+        consumptionDiscountPercent: integer("consumption_discount_percent").notNull().default(0),
+        // Course enrollments redeemable per billing cycle (0 = none; Pro = 1).
+        courseEnrollmentsPerMonth: integer("course_enrollments_per_month").notNull().default(0),
         sortOrder: integer("sort_order").notNull().default(0),
         createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
         updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
@@ -30330,7 +30533,12 @@ var init_credit_packages = __esm({
       (table) => ({
         creditsPositive: check("csp_credits_positive", sql`${table.creditsPerMonth} > 0`),
         pricePositive: check("csp_price_positive", sql`${table.priceUsdMonthly} > 0`),
-        nameSlugPattern: check("csp_name_slug_pattern", sql`${table.name} ~ '^[a-z][a-z0-9_]{0,49}$'`)
+        nameSlugPattern: check("csp_name_slug_pattern", sql`${table.name} ~ '^[a-z][a-z0-9_]{0,49}$'`),
+        discountRange: check(
+          "csp_discount_range",
+          sql`${table.consumptionDiscountPercent} >= 0 AND ${table.consumptionDiscountPercent} <= 90`
+        ),
+        quotaNonNegative: check("csp_quota_non_negative", sql`${table.courseEnrollmentsPerMonth} >= 0`)
       })
     );
     creditSubscriptions = pgTable(
@@ -30363,7 +30571,13 @@ var init_credit_packages = __esm({
       (table) => ({
         userIdx: index("cs_user_idx").on(table.userId),
         stripeSubIdx: index("cs_stripe_sub_idx").on(table.stripeSubscriptionId),
-        lastInvoiceIdx: index("cs_last_invoice_idx").on(table.lastInvoiceId)
+        lastInvoiceIdx: index("cs_last_invoice_idx").on(table.lastInvoiceId),
+        // #793: one live billable row per user. createSubscription's active/past_due
+        // guard checks-then-inserts without a lock; this closes the double-submit
+        // race (deferred "while latent" in credit-wallet.router.ts — the rm-030
+        // acquisition UI un-latents it). Raw sql in .where() — drizzle-kit
+        // serializes eq() as a $N placeholder in partial-index DDL (42P02).
+        activeUserUnique: uniqueIndex("cs_active_user_unique").on(table.userId).where(sql`status = 'active'`)
       })
     );
   }
@@ -31026,7 +31240,7 @@ var init_enrollment_channel_changes = __esm({
 });
 
 // ../../packages/database/migrations/schema.ts
-var applicableTo, badgeCriteriaType, badgeTier, badgeType, brainstormStatus, cancellationReason, challengeType, communityPostType, courseReviewStatus, courseStatus, discountType, enrollmentStatus, funnelEventType, knowledgeProcessingStatus, knowledgeResourceType, knowledgeUrlMode, marketingContentType, mentorshipCreditStatus, mentorshipTransactionStatus, mentorshipTransactionType, moderationAction, moderationTarget, participantStatus, progressStatus, proposalStatus, refundReason, refundType, reportReason, reportStatus, resourceType, serviceType, sessionCancelledReason, sessionStatus, slaStatus, studentRole, testimonialStatus, threadStatus, transactionType, userRole, userStatus, goalType, skillLevel, pathStatus, milestoneStatus, tsvector, slashCommandAnalytics, notificationLogs, couponUsages, validationAttempts, users2, accounts2, platformConfig2, concepts2, mentorshipMessages, courseReviews2, webhookEvents, sessions2, courses2, badges2, userBadges2, challenges, userChallengeScores, leaderboardPreferences, onboardingAnalytics, creatorApplications, reviews, certificates2, userPreferences2, progress2, mentorshipTemplates, notifications, lessons2, syncLogs2, mentorshipThreads, courseReports2, mcpSessions2, transactions, enrollments2, reviewHelpfulVotes, modules2, coupons, funnelEvents, moderationLog, mentorshipServices, mentorAvailability, mentorAvailabilityExceptions, sessionWaitlist, sessionParticipants, mentorshipTransactions, mentorshipSessions, sessionResources, sessionReviews, mentorshipPackages, mentorshipCredits, refundAuditLog, sessionReviewVotes, communityPosts, communityComments, communityLikes, userFollows, sparkChatSessions, platformSettings, generationState, creatorTestimonials, marketingContent, studentNotes, userCredits, userUsageQuotas, usageTierLimits, brainstormSessions, creditTransactions, courseProposals, brainstormMessages, knowledgeResources, knowledgeChunks, verificationTokens2, studentTutorContext, tutorInteractionHistory, studentLearningPreferences, learningStreaks, dailyGoals, dailyGoalProgress, learningPaths, pathCourses, pathMilestones;
+var applicableTo, badgeCriteriaType, badgeTier, badgeType, brainstormStatus, cancellationReason, challengeType, communityPostType, courseReviewStatus, courseStatus, discountType, enrollmentStatus, funnelEventType, knowledgeProcessingStatus, knowledgeResourceType, knowledgeUrlMode, marketingContentType, mentorshipCreditStatus, mentorshipTransactionStatus, mentorshipTransactionType, moderationAction, moderationTarget, participantStatus, progressStatus, proposalStatus, refundReason, refundType, reportReason, reportStatus, resourceType, serviceType, sessionCancelledReason, sessionStatus, slaStatus, studentRole, testimonialStatus, threadStatus, transactionType, userRole, userStatus, goalType, skillLevel, pathStatus, milestoneStatus, tsvector, slashCommandAnalytics, notificationLogs, couponUsages, validationAttempts, users2, accounts2, platformConfig, concepts2, mentorshipMessages, courseReviews2, webhookEvents, sessions2, courses2, badges2, userBadges2, challenges, userChallengeScores, leaderboardPreferences, onboardingAnalytics, creatorApplications, reviews, certificates2, userPreferences2, progress2, mentorshipTemplates, notifications, lessons2, syncLogs2, mentorshipThreads, courseReports2, mcpSessions2, transactions, enrollments2, reviewHelpfulVotes, modules2, coupons, funnelEvents, moderationLog, mentorshipServices, mentorAvailability, mentorAvailabilityExceptions, sessionWaitlist, sessionParticipants, mentorshipTransactions, mentorshipSessions, sessionResources, sessionReviews, mentorshipPackages, mentorshipCredits, refundAuditLog, sessionReviewVotes, communityPosts, communityComments, communityLikes, userFollows, sparkChatSessions, platformSettings, generationState, creatorTestimonials, marketingContent, studentNotes, userCredits, userUsageQuotas, usageTierLimits, brainstormSessions, creditTransactions, courseProposals, brainstormMessages, knowledgeResources, knowledgeChunks, verificationTokens2, studentTutorContext, tutorInteractionHistory, studentLearningPreferences, learningStreaks, dailyGoals, dailyGoalProgress, learningPaths, pathCourses, pathMilestones;
 var init_schema2 = __esm({
   "../../packages/database/migrations/schema.ts"() {
     "use strict";
@@ -31489,7 +31703,7 @@ var init_schema2 = __esm({
         }).onDelete("cascade")
       ]
     );
-    platformConfig2 = pgTable("platform_config", {
+    platformConfig = pgTable("platform_config", {
       key: varchar({ length: 50 }).primaryKey().notNull(),
       value: text().notNull(),
       updatedAt: timestamp("updated_at", { mode: "string" }).defaultNow().notNull()
@@ -35885,13 +36099,17 @@ var init_mentorship_credits = __esm({
         // Package lookup
         packageIdIdx: index("mentorship_credits_package_id_idx").on(table.packageId),
         // Stripe payment intent lookup (for webhook idempotency)
-        stripePaymentIntentIdIdx: index("mentorship_credits_stripe_payment_intent_idx").on(
-          table.stripePaymentIntentId
-        ),
+        stripePaymentIntentIdUnique: uniqueIndex("mentorship_credits_stripe_payment_intent_unique").on(table.stripePaymentIntentId).where(sql`${table.stripePaymentIntentId} IS NOT NULL`),
         // ORDER BY purchasedAt DESC (credit transaction history)
         purchasedAtIdx: index("mentorship_credits_purchased_at_idx").on(table.purchasedAt),
         // FEAT-1288: refund revoke looks up course-granted credits by enrollment
         enrollmentIdIdx: index("mentorship_credits_enrollment_id_idx").on(table.enrollmentId),
+        // GH #905 F5: one course-purchase grant per enrollment. The check-then-write
+        // in GrantCourseMentoriaCreditsUseCase races on Stripe webhook re-delivery
+        // (stripe_payment_intent_id is null for these rows, so the existing intent
+        // unique index doesn't cover them). This partial unique index is the DB-side
+        // idempotency guard; the use case catches 23505 as a no-op.
+        courseEnrollmentUnique: uniqueIndex("mentorship_credits_course_enrollment_unique").on(table.enrollmentId).where(sql`${table.origin} = 'course_purchase' AND ${table.enrollmentId} IS NOT NULL`),
         // FEAT-1288: each origin carries its tracing FK — package rows keep a
         // package_id, course-purchase rows keep an enrollment_id.
         originConsistencyCheck: check(
@@ -35985,6 +36203,7 @@ var init_mentorship_transactions = __esm({
   "../../packages/database/src/schema/mentorship-transactions.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_users();
     init_mentorship_sessions();
     init_mentorship_packages();
@@ -36085,9 +36304,9 @@ var init_mentorship_transactions = __esm({
         studentIdIdx: index("mentorship_transactions_student_id_idx").on(table.studentId),
         mentorIdIdx: index("mentorship_transactions_mentor_id_idx").on(table.mentorId),
         statusIdx: index("mentorship_transactions_status_idx").on(table.status),
-        stripePaymentIntentIdIdx: index("mentorship_transactions_stripe_payment_intent_id_idx").on(
-          table.stripePaymentIntentId
-        ),
+        stripePaymentIntentIdUnique: uniqueIndex(
+          "mentorship_transactions_stripe_payment_intent_id_unique"
+        ).on(table.stripePaymentIntentId).where(sql`${table.stripePaymentIntentId} IS NOT NULL`),
         createdAtIdx: index("mentorship_transactions_created_at_idx").on(table.createdAt),
         // Story 19.3: Additional indexes for split and aggregation
         typeIdx: index("mentorship_transactions_type_idx").on(table.transactionType),
@@ -37515,6 +37734,7 @@ var init_transactions = __esm({
   "../../packages/database/src/schema/transactions.ts"() {
     "use strict";
     init_pg_core();
+    init_drizzle_orm();
     init_courses3();
     init_users();
     init_enrollments();
@@ -37523,9 +37743,13 @@ var init_transactions = __esm({
       {
         id: uuid("id").defaultRandom().primaryKey(),
         // Stripe references
-        stripePaymentIntentId: varchar("stripe_payment_intent_id", { length: 255 }).notNull().unique(),
+        stripePaymentIntentId: varchar("stripe_payment_intent_id", { length: 255 }).unique(),
         stripeTransferId: varchar("stripe_transfer_id", { length: 255 }),
         // Stripe Transfer ID (if separate transfer)
+        // spec 2026-07-31-pix-modobank: second inbound provider. 'stripe' rows keep
+        // stripe_payment_intent_id; 'modobank' rows carry the e2eid here instead.
+        provider: varchar("provider", { length: 20 }).notNull().default("stripe"),
+        providerPaymentId: varchar("provider_payment_id", { length: 255 }),
         // Foreign keys
         courseId: uuid("course_id").notNull().references(() => courses.id, { onDelete: "restrict" }),
         creatorId: uuid("creator_id").notNull().references(() => users.id, { onDelete: "restrict" }),
@@ -37597,6 +37821,56 @@ var init_transactions = __esm({
           table.studentId,
           table.status,
           table.createdAt
+        ),
+        // spec 2026-07-31-pix-modobank: dedupes per-provider payment refs; NULL
+        // provider_payment_id (legacy Stripe rows, pre-webhook-write) is excluded.
+        providerPaymentIdUnique: uniqueIndex("transactions_provider_payment_id_unique").on(table.provider, table.providerPaymentId).where(sql`${table.providerPaymentId} IS NOT NULL`)
+      })
+    );
+  }
+});
+
+// ../../packages/database/src/schema/pix-charges.ts
+var PIX_CHARGE_STATUSES, PIX_CHARGE_PURPOSES, pixCharges;
+var init_pix_charges = __esm({
+  "../../packages/database/src/schema/pix-charges.ts"() {
+    "use strict";
+    init_drizzle_orm();
+    init_pg_core();
+    init_users();
+    PIX_CHARGE_STATUSES = ["pending", "paid", "fulfilled", "expired", "refunded"];
+    PIX_CHARGE_PURPOSES = ["course_sale", "credit_topup"];
+    pixCharges = pgTable(
+      "pix_charges",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        txid: varchar("txid", { length: 35 }).notNull(),
+        e2eid: varchar("e2eid", { length: 64 }),
+        status: varchar("status", { length: 20 }).notNull().default("pending"),
+        purpose: varchar("purpose", { length: 20 }).notNull(),
+        userId: uuid("user_id").references(() => users.id, { onDelete: "restrict" }).notNull(),
+        /** courseId (course_sale) or credit package id (credit_topup). */
+        referenceId: uuid("reference_id"),
+        amountBrlCents: integer("amount_brl_cents").notNull(),
+        pixCopiaECola: text("pix_copia_e_cola").notNull(),
+        /** course_sale: money breakdown replayed at fulfillment (creatorId, fees, couponId...). */
+        metadata: jsonb("metadata").notNull().default(sql`'{}'::jsonb`),
+        expiresAt: timestamp("expires_at", { withTimezone: true }).notNull(),
+        paidAt: timestamp("paid_at", { withTimezone: true }),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull().$onUpdate(() => /* @__PURE__ */ new Date())
+      },
+      (table) => ({
+        txidUnique: uniqueIndex("pix_charges_txid_unique").on(table.txid),
+        userIdIdx: index("pix_charges_user_id_idx").on(table.userId),
+        sweepIdx: index("pix_charges_sweep_idx").on(table.status, table.expiresAt),
+        statusCheck: check(
+          "pxc_status_check",
+          sql`${table.status} IN ('pending', 'paid', 'fulfilled', 'expired', 'refunded')`
+        ),
+        purposeCheck: check(
+          "pxc_purpose_check",
+          sql`${table.purpose} IN ('course_sale', 'credit_topup')`
         )
       })
     );
@@ -38516,140 +38790,6 @@ var init_study_index = __esm({
   }
 });
 
-// ../../packages/database/src/schema/platform-settings.ts
-function parseSettingValue(value, valueType) {
-  switch (valueType) {
-    case "boolean":
-      return value === "true";
-    case "number":
-      return Number(value);
-    case "json":
-      try {
-        return JSON.parse(value);
-      } catch {
-        return null;
-      }
-    default:
-      return value;
-  }
-}
-function stringifySettingValue(value, valueType) {
-  switch (valueType) {
-    case "boolean":
-      return value ? "true" : "false";
-    case "number":
-      return String(value);
-    case "json":
-      return JSON.stringify(value);
-    default:
-      return String(value);
-  }
-}
-var settingValueTypes, settingCategories, platformSettings2, insertPlatformSettingSchema, selectPlatformSettingSchema, settingKeys;
-var init_platform_settings = __esm({
-  "../../packages/database/src/schema/platform-settings.ts"() {
-    "use strict";
-    init_pg_core();
-    init_zod();
-    settingValueTypes = ["string", "boolean", "number", "json"];
-    settingCategories = [
-      "platform",
-      "notifications",
-      "security",
-      "email",
-      "financial"
-    ];
-    platformSettings2 = pgTable(
-      "platform_settings",
-      {
-        key: varchar("key", { length: 100 }).primaryKey(),
-        value: text("value").notNull(),
-        valueType: varchar("value_type", { length: 20 }).notNull().default("string"),
-        category: varchar("category", { length: 50 }).notNull().default("general"),
-        description: text("description"),
-        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow(),
-        updatedBy: varchar("updated_by", { length: 255 })
-      },
-      (table) => [index("idx_platform_settings_category").on(table.category)]
-    );
-    insertPlatformSettingSchema = external_exports.object({
-      key: external_exports.string().min(1).max(100),
-      value: external_exports.string(),
-      valueType: external_exports.enum(settingValueTypes).default("string"),
-      category: external_exports.enum(settingCategories).default("platform"),
-      description: external_exports.string().nullable().optional(),
-      updatedBy: external_exports.string().nullable().optional()
-    });
-    selectPlatformSettingSchema = external_exports.object({
-      key: external_exports.string(),
-      value: external_exports.string(),
-      valueType: external_exports.string(),
-      category: external_exports.string(),
-      description: external_exports.string().nullable(),
-      updatedAt: external_exports.date().nullable(),
-      updatedBy: external_exports.string().nullable()
-    });
-    settingKeys = {
-      // Platform
-      platformName: "platform_name",
-      platformUrl: "platform_url",
-      platformLogoUrl: "platform_logo_url",
-      platformDescription: "platform_description",
-      maintenanceMode: "maintenance_mode",
-      // Notifications
-      emailWelcome: "email_welcome",
-      emailCourseApproved: "email_course_approved",
-      emailNewEnrollment: "email_new_enrollment",
-      adminSystemAlerts: "admin_system_alerts",
-      // Security
-      mfaRequiredAdmins: "mfa_required_admins",
-      mfaRequiredCreators: "mfa_required_creators",
-      sessionTimeoutMinutes: "session_timeout_minutes",
-      maxLoginAttempts: "max_login_attempts",
-      // Email
-      emailFrom: "email_from",
-      emailFromName: "email_from_name"
-    };
-  }
-});
-
-// ../../packages/database/src/schema/admin-settings-audit.ts
-var adminSettingsAudit, adminSettingsAuditRelations;
-var init_admin_settings_audit = __esm({
-  "../../packages/database/src/schema/admin-settings-audit.ts"() {
-    "use strict";
-    init_pg_core();
-    init_drizzle_orm();
-    init_users();
-    adminSettingsAudit = pgTable(
-      "admin_settings_audit",
-      {
-        id: uuid("id").defaultRandom().primaryKey(),
-        // What changed
-        settingKey: varchar("setting_key", { length: 100 }).notNull(),
-        previousValue: jsonb("previous_value"),
-        // nullable for new settings
-        newValue: jsonb("new_value").notNull(),
-        // Who changed it
-        adminId: uuid("admin_id").references(() => users.id, { onDelete: "set null" }),
-        // When
-        createdAt: timestamp("created_at").defaultNow().notNull()
-      },
-      (table) => ({
-        settingKeyIdx: index("admin_settings_audit_setting_key_idx").on(table.settingKey),
-        adminIdIdx: index("admin_settings_audit_admin_id_idx").on(table.adminId),
-        createdAtIdx: index("admin_settings_audit_created_at_idx").on(table.createdAt)
-      })
-    );
-    adminSettingsAuditRelations = relations(adminSettingsAudit, ({ one }) => ({
-      admin: one(users, {
-        fields: [adminSettingsAudit.adminId],
-        references: [users.id]
-      })
-    }));
-  }
-});
-
 // ../../packages/database/src/schema/admin-activity-feed.ts
 var adminActivityFeed, adminActivityFeedRelations;
 var init_admin_activity_feed = __esm({
@@ -39859,26 +39999,19 @@ var init_system_config = __esm({
     }));
     configKeys = {
       // AI - Generation
-      "ai.generation.model": "ai.generation.model",
+      // GH #942: ai.*.model keys (generation/chat/study) retired — model comes from
+      // the routing rule + gateway tier (GH #799 2b); DB keeps inference params only.
       "ai.generation.max_tokens": "ai.generation.max_tokens",
       "ai.generation.temperature": "ai.generation.temperature",
       // AI - Chat
-      "ai.chat.model": "ai.chat.model",
       "ai.chat.max_tokens": "ai.chat.max_tokens",
       "ai.chat.temperature": "ai.chat.temperature",
       // AI - Study
-      "ai.study.chat_model": "ai.study.chat_model",
-      "ai.study.hint_model": "ai.study.hint_model",
       "ai.study.max_tokens": "ai.study.max_tokens",
       "ai.study.temperature": "ai.study.temperature",
-      // AI - Costs
+      // AI - Costs (GH #947: cache_optimization_enabled and ai.context.* purged;
+      // GH #974: requests_per_minute purged — reader never mounted)
       "ai.costs.daily_limit_usd": "ai.costs.daily_limit_usd",
-      "ai.costs.requests_per_minute": "ai.costs.requests_per_minute",
-      "ai.costs.cache_optimization_enabled": "ai.costs.cache_optimization_enabled",
-      // AI - Context Window Management
-      "ai.context.window_size": "ai.context.window_size",
-      "ai.context.output_reserve": "ai.context.output_reserve",
-      "ai.context.compression_threshold": "ai.context.compression_threshold",
       // Business - Pricing
       "business.pricing.min_course_price_brl": "business.pricing.min_course_price_brl",
       "business.pricing.course_mentoria_creator_share": "business.pricing.course_mentoria_creator_share",
@@ -39895,6 +40028,8 @@ var init_system_config = __esm({
       "business.monitoring.prompt_caching_discount": "business.monitoring.prompt_caching_discount",
       "business.monitoring.llm_cost_warning_usd": "business.monitoring.llm_cost_warning_usd",
       "business.monitoring.llm_cost_critical_usd": "business.monitoring.llm_cost_critical_usd",
+      // GH #948: margin tolerance for the daily credit-reconciliation job
+      "business.monitoring.margin_tolerance_percent": "business.monitoring.margin_tolerance_percent",
       // Business - Limits
       "business.limits.max_courses_per_creator": "business.limits.max_courses_per_creator",
       "business.limits.max_modules_per_course": "business.limits.max_modules_per_course",
@@ -39907,21 +40042,11 @@ var init_system_config = __esm({
       "feature.community_enabled": "feature.community_enabled",
       "feature.certificates_enabled": "feature.certificates_enabled",
       "feature.maintenance_mode": "feature.maintenance_mode",
-      "feature.new_user_registration": "feature.new_user_registration",
       "feature.require_creator_mfa": "feature.require_creator_mfa",
       "feature.require_admin_mfa": "feature.require_admin_mfa",
-      "feature.security.session_timeout_minutes": "feature.security.session_timeout_minutes",
-      "feature.security.max_login_attempts": "feature.security.max_login_attempts",
-      // Platform Identity
-      "platform.identity.name": "platform.identity.name",
-      "platform.identity.url": "platform.identity.url",
-      "platform.identity.logo_url": "platform.identity.logo_url",
-      "platform.identity.description": "platform.identity.description",
+      // GH #947: feature.security.*, platform.identity.* and the four
+      // notification.email.* toggles purged — zero functional readers.
       // Notification Settings
-      "notification.email.welcome_enabled": "notification.email.welcome_enabled",
-      "notification.email.course_approved_enabled": "notification.email.course_approved_enabled",
-      "notification.email.new_enrollment_enabled": "notification.email.new_enrollment_enabled",
-      "notification.email.admin_system_alerts": "notification.email.admin_system_alerts",
       "notification.sender.from_address": "notification.sender.from_address",
       "notification.sender.from_name": "notification.sender.from_name"
     };
@@ -41192,7 +41317,6 @@ var init_relations_auth = __esm({
     init_user_regional_settings();
     init_users();
     init_validation_attempts();
-    init_admin_settings_audit();
     init_brainstormings();
     init_course_review_snapshots();
     init_learning_paths();
@@ -41250,7 +41374,6 @@ var init_relations_auth = __esm({
       dailyGoal: one(dailyGoals2),
       dailyGoalProgress: many(dailyGoalProgress2),
       regionalSettings: one(userRegionalSettings),
-      adminSettingsAuditLogs: many(adminSettingsAudit),
       creatorAuditLogs: many(creatorAuditLog),
       lessonRefinements: many(lessonRefinements),
       courseReviewSnapshots: many(courseReviewSnapshots),
@@ -43035,6 +43158,77 @@ var init_idempotency = __esm({
   }
 });
 
+// ../../packages/database/src/schema/referrals.ts
+var referralCodes, referrals;
+var init_referrals = __esm({
+  "../../packages/database/src/schema/referrals.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    referralCodes = pgTable("referral_codes", {
+      userId: uuid("user_id").primaryKey().references(() => users.id, { onDelete: "cascade" }),
+      code: varchar("code", { length: 16 }).notNull().unique(),
+      createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow()
+    });
+    referrals = pgTable("referrals", {
+      // PK = one referrer per person, one bonus per person, DB-enforced.
+      referredUserId: uuid("referred_user_id").primaryKey().references(() => users.id, { onDelete: "cascade" }),
+      // null = referrer account deleted; referred keeps their referral record.
+      referrerUserId: uuid("referrer_user_id").references(() => users.id, { onDelete: "set null" }),
+      code: varchar("code", { length: 16 }).notNull(),
+      createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+      // Set exactly once by the bonus claim (UPDATE ... WHERE qualified_at IS NULL).
+      qualifiedAt: timestamp("qualified_at", { withTimezone: true })
+    });
+  }
+});
+
+// ../../packages/database/src/schema/user-consents.ts
+var userConsentDocumentEnum, userConsentSurfaceEnum, userConsents;
+var init_user_consents = __esm({
+  "../../packages/database/src/schema/user-consents.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    userConsentDocumentEnum = pgEnum("user_consent_document", ["terms", "privacy"]);
+    userConsentSurfaceEnum = pgEnum("user_consent_surface", [
+      "signup_form",
+      // password signup, /signup
+      "oauth",
+      // provider buttons, on /signup AND on /login
+      "magic_link",
+      // magic-link request form
+      "login_form"
+      // /login, login-time capture for pre-chokepoint accounts (GH #1007)
+    ]);
+    userConsents = pgTable(
+      "user_consents",
+      {
+        id: uuid("id").primaryKey().defaultRandom(),
+        userId: uuid("user_id").notNull().references(() => users.id, { onDelete: "cascade" }),
+        document: userConsentDocumentEnum("document").notNull(),
+        // Policy version the person was shown, e.g. "v1.0" or "v1.0-BR". Width matches
+        // countries.terms_version so a per-jurisdiction scheme stays possible later.
+        version: varchar("version", { length: 20 }).notNull(),
+        // Which translation was on screen — 5 locales means 5 different texts.
+        locale: varchar("locale", { length: 10 }).notNull(),
+        surface: userConsentSurfaceEnum("surface").notNull(),
+        acknowledgedAt: timestamp("acknowledged_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        // Idempotency, not just a constraint: the OAuth callback runs on EVERY login,
+        // so the writer must be safe to call repeatedly. The left-hand prefix also
+        // serves every "what has this user acknowledged?" read, so no second index.
+        userDocumentVersionUnique: uniqueIndex("user_consents_user_document_version_unique").on(
+          table.userId,
+          table.document,
+          table.version
+        )
+      })
+    );
+  }
+});
+
 // ../../packages/database/src/schema/user-deletions.ts
 var userDeletionStatusEnum, userDeletions;
 var init_user_deletions = __esm({
@@ -43206,6 +43400,87 @@ var init_email_delivery = __esm({
   }
 });
 
+// ../../packages/database/src/schema/subscription-redemptions.ts
+var subscriptionCourseRedemptions;
+var init_subscription_redemptions = __esm({
+  "../../packages/database/src/schema/subscription-redemptions.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    init_courses3();
+    init_enrollments();
+    init_credit_packages();
+    subscriptionCourseRedemptions = pgTable(
+      "subscription_course_redemptions",
+      {
+        id: uuid("id").defaultRandom().primaryKey(),
+        subscriptionId: uuid("subscription_id").references(() => creditSubscriptions.id, { onDelete: "restrict" }).notNull(),
+        userId: uuid("user_id").references(() => users.id, { onDelete: "cascade" }).notNull(),
+        courseId: uuid("course_id").references(() => courses.id, { onDelete: "restrict" }).notNull(),
+        enrollmentId: uuid("enrollment_id").references(() => enrollments.id, { onDelete: "restrict" }).notNull(),
+        cycleStart: timestamp("cycle_start", { withTimezone: true }).notNull(),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (table) => ({
+        oncePerCycle: uniqueIndex("scr_subscription_cycle_uq").on(
+          table.subscriptionId,
+          table.cycleStart
+        ),
+        userIdx: index("scr_user_idx").on(table.userId)
+      })
+    );
+  }
+});
+
+// ../../packages/database/src/schema/operation-billing-rates.ts
+var operationBillingRates, operationBillingRatesHistory;
+var init_operation_billing_rates = __esm({
+  "../../packages/database/src/schema/operation-billing-rates.ts"() {
+    "use strict";
+    init_pg_core();
+    init_users();
+    operationBillingRates = pgTable(
+      "operation_billing_rates",
+      {
+        id: uuid("id").primaryKey().defaultRandom(),
+        operationType: varchar("operation_type", { length: 100 }).notNull().unique(),
+        chargedInputPer1M: decimal("charged_input_per_1m", {
+          precision: 10,
+          scale: 4,
+          mode: "number"
+        }).notNull(),
+        chargedOutputPer1M: decimal("charged_output_per_1m", {
+          precision: 10,
+          scale: 4,
+          mode: "number"
+        }).notNull(),
+        isActive: boolean("is_active").notNull().default(true),
+        createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+      },
+      (table) => [index("idx_operation_billing_rates_active").on(table.isActive)]
+    );
+    operationBillingRatesHistory = pgTable(
+      "operation_billing_rates_history",
+      {
+        id: uuid("id").primaryKey().defaultRandom(),
+        operationType: varchar("operation_type", { length: 100 }).notNull(),
+        action: varchar("action", { length: 20 }).notNull(),
+        // 'create' | 'update' | 'delete'
+        oldValues: jsonb("old_values"),
+        newValues: jsonb("new_values"),
+        changedBy: uuid("changed_by").notNull().references(() => users.id),
+        changedAt: timestamp("changed_at", { withTimezone: true }).notNull().defaultNow(),
+        reason: varchar("reason", { length: 500 })
+      },
+      (table) => [
+        index("idx_obr_history_operation").on(table.operationType),
+        index("idx_obr_history_date").on(table.changedAt)
+      ]
+    );
+  }
+});
+
 // ../../packages/database/src/schema/index.ts
 var schema_exports = {};
 __export(schema_exports, {
@@ -43221,6 +43496,8 @@ __export(schema_exports, {
   PACKAGE_MINIMUM_PRICES: () => PACKAGE_MINIMUM_PRICES,
   PACKAGE_SESSION_OPTIONS: () => PACKAGE_SESSION_OPTIONS,
   PACKAGE_VALIDITY_OPTIONS: () => PACKAGE_VALIDITY_OPTIONS,
+  PIX_CHARGE_PURPOSES: () => PIX_CHARGE_PURPOSES,
+  PIX_CHARGE_STATUSES: () => PIX_CHARGE_STATUSES,
   REVIEW_TAGS: () => REVIEW_TAGS,
   SUGGESTED_DISCOUNTS: () => SUGGESTED_DISCOUNTS,
   V3_CANCEL_REASON_TTL_SECONDS: () => V3_CANCEL_REASON_TTL_SECONDS,
@@ -43230,8 +43507,6 @@ __export(schema_exports, {
   actionTypeEnum: () => actionTypeEnum,
   adminActivityFeed: () => adminActivityFeed,
   adminActivityFeedRelations: () => adminActivityFeedRelations,
-  adminSettingsAudit: () => adminSettingsAudit,
-  adminSettingsAuditRelations: () => adminSettingsAuditRelations,
   announcementTypes: () => announcementTypes,
   announcements: () => announcements,
   applicableToEnum: () => applicableToEnum,
@@ -43398,7 +43673,6 @@ __export(schema_exports, {
   insertCourseMentoriaOfferSchema: () => insertCourseMentoriaOfferSchema,
   insertMentorshipCreditSchema: () => insertMentorshipCreditSchema,
   insertMentorshipPackageSchema: () => insertMentorshipPackageSchema,
-  insertPlatformSettingSchema: () => insertPlatformSettingSchema,
   isAmountSignValid: () => isAmountSignValid,
   isCreditUsable: () => isCreditUsable,
   isWithdrawableLedgerType: () => isWithdrawableLedgerType,
@@ -43486,9 +43760,10 @@ __export(schema_exports, {
   notificationsRelations: () => notificationsRelations2,
   onboardingAnalytics: () => onboardingAnalytics2,
   onboardingAnalyticsRelations: () => onboardingAnalyticsRelations2,
+  operationBillingRates: () => operationBillingRates,
+  operationBillingRatesHistory: () => operationBillingRatesHistory,
   optimizerRoleEnum: () => optimizerRoleEnum,
   parisAuthorizedCreators: () => parisAuthorizedCreators,
-  parseSettingValue: () => parseSettingValue,
   participantStatusEnum: () => participantStatusEnum,
   pathCourses: () => pathCourses2,
   pathCoursesRelations: () => pathCoursesRelations2,
@@ -43502,9 +43777,8 @@ __export(schema_exports, {
   payoutWithdrawalTransitions: () => payoutWithdrawalTransitions,
   payoutWithdrawals: () => payoutWithdrawals,
   pgBackendIdempotencyKeys: () => pgBackendIdempotencyKeys,
+  pixCharges: () => pixCharges,
   pixKeyTypeEnum: () => pixKeyTypeEnum,
-  platformConfig: () => platformConfig,
-  platformSettings: () => platformSettings2,
   playgroundEvalScores: () => playgroundEvalScores,
   playgroundEvalScoresRelations: () => playgroundEvalScoresRelations,
   playgroundEvaluations: () => playgroundEvaluations,
@@ -43548,6 +43822,8 @@ __export(schema_exports, {
   pushTokens: () => pushTokens,
   pushTokensRelations: () => pushTokensRelations,
   quotaChangeHistory: () => quotaChangeHistory,
+  referralCodes: () => referralCodes,
+  referrals: () => referrals,
   refinementStatusEnum: () => refinementStatusEnum,
   refundAuditLog: () => refundAuditLog2,
   refundAuditLogRelations: () => refundAuditLogRelations2,
@@ -43570,7 +43846,6 @@ __export(schema_exports, {
   securityEventCategoryEnum: () => securityEventCategoryEnum,
   securityEventResultEnum: () => securityEventResultEnum,
   securityEventTypeEnum: () => securityEventTypeEnum,
-  selectPlatformSettingSchema: () => selectPlatformSettingSchema,
   serviceTypeEnum: () => serviceTypeEnum,
   sessionCancelledReasonEnum: () => sessionCancelledReasonEnum,
   sessionParticipants: () => sessionParticipants2,
@@ -43586,9 +43861,6 @@ __export(schema_exports, {
   sessionWaitlistRelations: () => sessionWaitlistRelations2,
   sessions: () => sessions,
   sessionsRelations: () => sessionsRelations2,
-  settingCategories: () => settingCategories,
-  settingKeys: () => settingKeys,
-  settingValueTypes: () => settingValueTypes,
   skillLevelEnum: () => skillLevelEnum,
   slaStatusEnum: () => slaStatusEnum,
   slashCommandAnalytics: () => slashCommandAnalytics2,
@@ -43598,7 +43870,6 @@ __export(schema_exports, {
   sparkChatSessions: () => sparkChatSessions2,
   sparkChatSessionsRelations: () => sparkChatSessionsRelations2,
   sparkPhaseValues: () => sparkPhaseValues,
-  stringifySettingValue: () => stringifySettingValue,
   studentCourseMemory: () => studentCourseMemory,
   studentCourseMemoryRelations: () => studentCourseMemoryRelations,
   studentFeedback: () => studentFeedback,
@@ -43628,6 +43899,7 @@ __export(schema_exports, {
   studyModuleSessionsRelations: () => studyModuleSessionsRelations,
   studyPhaseV2Values: () => studyPhaseV2Values,
   studyPhaseValues: () => studyPhaseValues,
+  subscriptionCourseRedemptions: () => subscriptionCourseRedemptions,
   subscriptionPoolStatusEnum: () => subscriptionPoolStatusEnum,
   subscriptionSplitStatusEnum: () => subscriptionSplitStatusEnum,
   supportedCurrencies: () => supportedCurrencies,
@@ -43655,6 +43927,9 @@ __export(schema_exports, {
   userBadgesRelations: () => userBadgesRelations2,
   userChallengeScores: () => userChallengeScores,
   userChallengeScoresRelations: () => userChallengeScoresRelations,
+  userConsentDocumentEnum: () => userConsentDocumentEnum,
+  userConsentSurfaceEnum: () => userConsentSurfaceEnum,
+  userConsents: () => userConsents,
   userDeletionStatusEnum: () => userDeletionStatusEnum,
   userDeletions: () => userDeletions,
   userFollows: () => userFollows2,
@@ -43714,6 +43989,7 @@ var init_schema3 = __esm({
     init_creator_index();
     init_webhook_events();
     init_transactions();
+    init_pix_charges();
     init_coupons();
     init_coupon_usages();
     init_onboarding_analytics();
@@ -43726,8 +44002,6 @@ var init_schema3 = __esm({
     init_user_follows();
     init_spark_chat_sessions();
     init_study_index();
-    init_platform_settings();
-    init_admin_settings_audit();
     init_admin_activity_feed();
     init_generation_state();
     init_security_audit_log();
@@ -43775,7 +44049,6 @@ var init_schema3 = __esm({
     init_relations_community();
     init_relations_gamification();
     init_moderation_log();
-    init_admin_settings_audit();
     init_creator_audit_log();
     init_banks();
     init_course_qa_reports();
@@ -43797,10 +44070,14 @@ var init_schema3 = __esm({
     init_course_visibility();
     init_course_allowlist();
     init_idempotency();
+    init_referrals();
+    init_user_consents();
     init_user_deletions();
     init_user_profiles();
     init_user_resource_audits();
     init_email_delivery();
+    init_subscription_redemptions();
+    init_operation_billing_rates();
   }
 });
 
@@ -43862,7 +44139,6 @@ var init_src3 = __esm({
     init_user_follows();
     init_generation_state();
     init_community();
-    init_platform_settings();
     init_marketing();
     init_security_audit_log();
     init_credit_movement_audit_log();
@@ -44201,7 +44477,7 @@ async function runStart(opts, deps = defaultDeps3) {
     deps.error(msg);
   }
 }
-var logger9, defaultDeps3, startCommand;
+var logger10, defaultDeps3, startCommand;
 var init_start = __esm({
   "src/commands/start.ts"() {
     "use strict";
@@ -44214,7 +44490,7 @@ var init_start = __esm({
     init_status();
     init_formatter();
     init_errors();
-    logger9 = createLogger("cli:start");
+    logger10 = createLogger("cli:start");
     defaultDeps3 = {
       requireSession,
       requireActiveCourse,
@@ -44228,7 +44504,7 @@ var init_start = __esm({
       output,
       error,
       stderrWrite: (message) => process.stderr.write(message),
-      logger: logger9
+      logger: logger10
     };
     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);
@@ -44238,7 +44514,7 @@ var init_start = __esm({
 
 // src/commands/start-next.ts
 import { Command as Command9 } from "commander";
-var logger10, startNextCommand;
+var logger11, startNextCommand;
 var init_start_next = __esm({
   "src/commands/start-next.ts"() {
     "use strict";
@@ -44250,7 +44526,7 @@ var init_start_next = __esm({
     init_workspace_state();
     init_formatter();
     init_errors();
-    logger10 = createLogger("cli:start-next");
+    logger11 = 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();
@@ -44258,7 +44534,7 @@ 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: logger10 };
+        const deps = { data, logger: logger11 };
         const moduleData = await startNextModule({ enrollmentId: activeCourse.enrollmentId }, deps);
         const ws = await findWorkspaceState();
         if (ws)
@@ -44295,7 +44571,7 @@ var init_start_next = __esm({
 
 // src/commands/next.ts
 import { Command as Command10 } from "commander";
-var logger11, nextCommand;
+var logger12, nextCommand;
 var init_next = __esm({
   "src/commands/next.ts"() {
     "use strict";
@@ -44307,7 +44583,7 @@ var init_next = __esm({
     init_workspace_state();
     init_formatter();
     init_errors();
-    logger11 = createLogger("cli:next");
+    logger12 = 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();
@@ -44315,7 +44591,7 @@ 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: logger11 };
+        const deps = { data, logger: logger12 };
         const lessonData = await nextLesson(
           { enrollmentId: activeCourse.enrollmentId, userConfirmation: "cli-next" },
           deps
@@ -44388,7 +44664,7 @@ function replacePlaceholders(text2, workspacePath, courseTitle) {
   const base = path13.basename(workspacePath) === ".tostudy" ? path13.dirname(workspacePath) : workspacePath;
   const slug = courseSlug(courseTitle);
   const vaultPath = resolveVaultPath(workspacePath, slug);
-  return text2.replaceAll("$WORKSPACE", base).replaceAll("$VAULT", vaultPath);
+  return text2.replace(/\$WORKSPACE(?![A-Za-z0-9_])/g, () => base).replace(/\$VAULT(?![A-Za-z0-9_])/g, () => vaultPath);
 }
 function formatLessonContent(data, workspacePath, courseTitle) {
   const time4 = adjustTimeEstimate(data.type, data.estimatedTimeMinutes);
@@ -44429,7 +44705,7 @@ function formatLessonContent(data, workspacePath, courseTitle) {
   }
   return lines.join("\n");
 }
-var logger12, lessonCommand;
+var logger13, lessonCommand;
 var init_lesson = __esm({
   "src/commands/lesson.ts"() {
     "use strict";
@@ -44442,7 +44718,7 @@ var init_lesson = __esm({
     init_formatter();
     init_resolve();
     init_errors();
-    logger12 = createLogger("cli:lesson");
+    logger13 = createLogger("cli:lesson");
     lessonCommand = new Command11("lesson").description("Show the content of the current lesson").option("--json", "Output structured JSON").option(
       "--read <lessonId>",
       "Read a specific lesson by id (works on archived / read-only courses)"
@@ -44453,7 +44729,7 @@ 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: logger12 };
+        const deps = { data, logger: logger13 };
         let lessonId = opts.read ?? activeCourse.currentLessonId;
         if (!lessonId) {
           try {
@@ -44548,7 +44824,7 @@ function formatKnowledge(data) {
   });
   return lines.join("\n").trimEnd();
 }
-var logger13, knowledgeCommand;
+var logger14, knowledgeCommand;
 var init_knowledge2 = __esm({
   "src/commands/knowledge.ts"() {
     "use strict";
@@ -44556,7 +44832,7 @@ var init_knowledge2 = __esm({
     init_http();
     init_guards();
     init_formatter();
-    logger13 = createLogger("cli:knowledge");
+    logger14 = createLogger("cli:knowledge");
     knowledgeCommand = new Command12("knowledge").description("Show the active course's knowledge base (base de conhecimento)").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
@@ -44580,7 +44856,7 @@ var init_knowledge2 = __esm({
           else error(msg);
           return;
         }
-        logger13.warn("knowledge failed", { error: msg });
+        logger14.warn("knowledge failed", { error: msg });
         if (opts.json) jsonError(msg);
         else error(msg);
       }
@@ -44590,7 +44866,7 @@ var init_knowledge2 = __esm({
 
 // src/commands/hint.ts
 import { Command as Command13 } from "commander";
-var logger14, hintCommand;
+var logger15, hintCommand;
 var init_hint = __esm({
   "src/commands/hint.ts"() {
     "use strict";
@@ -44601,7 +44877,7 @@ var init_hint = __esm({
     init_course_state();
     init_formatter();
     init_errors();
-    logger14 = createLogger("cli:hint");
+    logger15 = createLogger("cli:hint");
     hintCommand = new Command13("hint").description("Get a progressive hint for the current exercise").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -44609,7 +44885,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: logger14 };
+        const deps = { data, logger: logger15 };
         const hint = await getHint(
           { userId: session.userId, enrollmentId: activeCourse.enrollmentId },
           deps
@@ -44963,7 +45239,7 @@ var init_init_template = __esm({
 import fs12 from "node:fs";
 import path14 from "node:path";
 import { Command as Command14 } from "commander";
-var logger15, validateCommand;
+var logger16, validateCommand;
 var init_validate = __esm({
   "src/commands/validate.ts"() {
     "use strict";
@@ -44976,7 +45252,7 @@ var init_validate = __esm({
     init_formatter();
     init_init_template();
     init_errors();
-    logger15 = createLogger("cli:validate");
+    logger16 = createLogger("cli:validate");
     validateCommand = new Command14("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();
@@ -44984,7 +45260,7 @@ var init_validate = __esm({
         const driftWarning = await checkCourseDrift();
         if (driftWarning) process.stderr.write(driftWarning + "\n");
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger15 };
+        const deps = { data, logger: logger16 };
         let lessonId = activeCourse.currentLessonId;
         if (!lessonId) {
           try {
@@ -45433,7 +45709,7 @@ Rode \`tostudy select <n\xFAmero>\` para ativar um curso.`,
     deps.output(artifacts.learnerBrief, { json: false });
   }
 }
-var logger16, defaultDeps4, initCommand;
+var logger17, defaultDeps4, initCommand;
 var init_init = __esm({
   "src/commands/init.ts"() {
     "use strict";
@@ -45449,7 +45725,7 @@ var init_init = __esm({
     init_api3();
     init_instruction_pipeline();
     init_pipeline_deps();
-    logger16 = createLogger("cli:init");
+    logger17 = createLogger("cli:init");
     defaultDeps4 = {
       getSession,
       findWorkspaceState,
@@ -45463,7 +45739,7 @@ var init_init = __esm({
       saveCourseLearnerProfile,
       buildInitArtifacts,
       output,
-      logger: logger16,
+      logger: logger17,
       createHttpProvider,
       resolveAndGenerate,
       buildPipelineDeps
@@ -45785,7 +46061,7 @@ import { Command as Command17 } from "commander";
 import path17 from "node:path";
 import os9 from "node:os";
 import fs15 from "node:fs/promises";
-var logger17, workspaceCommand;
+var logger18, workspaceCommand;
 var init_workspace2 = __esm({
   "src/commands/workspace.ts"() {
     "use strict";
@@ -45795,7 +46071,7 @@ var init_workspace2 = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger17 = createLogger("cli:workspace");
+    logger18 = createLogger("cli:workspace");
     workspaceCommand = new Command17("workspace").description(
       getErrors().workspaceCommandDescription
     );
@@ -45861,7 +46137,7 @@ Pr\xF3ximo passo: tostudy export
           );
         }
       } catch (err) {
-        logger17.error("workspace setup failed", { error: err });
+        logger18.error("workspace setup failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -45969,7 +46245,7 @@ import { Command as Command18 } from "commander";
 import path18 from "node:path";
 import os10 from "node:os";
 import fs16 from "node:fs/promises";
-var logger18, exportCommand;
+var logger19, exportCommand;
 var init_export = __esm({
   "src/commands/export.ts"() {
     "use strict";
@@ -45980,7 +46256,7 @@ var init_export = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger18 = createLogger("cli:export");
+    logger19 = createLogger("cli:export");
     exportCommand = new Command18("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", path18.join(os10.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -46008,7 +46284,7 @@ var init_export = __esm({
           }
           if (!hasConfig) {
             const slug = courseSlug(activeCourse.courseTitle);
-            logger18.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
+            logger19.info("Auto-initializing workspace", { workspacePath: ws.workspacePath });
             await fs16.mkdir(ws.workspacePath, { recursive: true });
             for (const dir of ["exercises", "generated", "notes", "diagrams"]) {
               await fs16.mkdir(path18.join(ws.workspacePath, dir), { recursive: true });
@@ -46070,7 +46346,7 @@ ${result.files.map((f) => `  \u{1F4C4} ${f}`).join("\n")}
           );
         }
       } catch (err) {
-        logger18.error("export failed", { error: err });
+        logger19.error("export failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -46084,7 +46360,7 @@ import { Command as Command19 } from "commander";
 import { execFile as execFile3 } from "node:child_process";
 import path19 from "node:path";
 import os11 from "node:os";
-var logger19, openCommand;
+var logger20, openCommand;
 var init_open = __esm({
   "src/commands/open.ts"() {
     "use strict";
@@ -46093,7 +46369,7 @@ var init_open = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger19 = createLogger("cli:open");
+    logger20 = createLogger("cli:open");
     openCommand = new Command19("open").description("Abrir workspace do curso na IDE").option("--path <dir>", "Diret\xF3rio base do workspace", path19.join(os11.homedir(), "study")).action(async (opts) => {
       try {
         const activeCourse = await requireActiveCourse();
@@ -46111,7 +46387,7 @@ var init_open = __esm({
         const editor = process.env["EDITOR"] ?? "code";
         execFile3(editor, [ws.workspacePath], (err) => {
           if (err) {
-            logger19.error("open failed", { editor, workspacePath: ws.workspacePath });
+            logger20.error("open failed", { editor, workspacePath: ws.workspacePath });
             process.stderr.write(`\u274C Falha ao abrir: ${err.message}
 `);
             process.exit(1);
@@ -46120,7 +46396,7 @@ var init_open = __esm({
 `);
         });
       } catch (err) {
-        logger19.error("open command failed", { error: err });
+        logger20.error("open command failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -46192,7 +46468,7 @@ import { Command as Command20 } from "commander";
 import path21 from "node:path";
 import os12 from "node:os";
 import fs18 from "node:fs/promises";
-var logger20, vaultCommand;
+var logger21, vaultCommand;
 var init_vault2 = __esm({
   "src/commands/vault.ts"() {
     "use strict";
@@ -46204,7 +46480,7 @@ var init_vault2 = __esm({
     init_course_state();
     init_resolve();
     init_errors();
-    logger20 = createLogger("cli:vault");
+    logger21 = createLogger("cli:vault");
     vaultCommand = new Command20("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", path21.join(os12.homedir(), "study")).option("--json", "Output structured JSON").action(async (opts) => {
       try {
@@ -46249,7 +46525,7 @@ var init_vault2 = __esm({
           activeCourse.courseId,
           slug
         );
-        logger20.info("Vault generated", {
+        logger21.info("Vault generated", {
           courseId: activeCourse.courseId,
           vaultPath: result.vaultPath,
           filesWritten: result.filesWritten
@@ -46282,7 +46558,7 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger20.error("vault init failed", { error: err });
+        logger21.error("vault init failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -46312,7 +46588,7 @@ Para visualizar:
           process.exit(1);
         }
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger20 };
+        const deps = { data, logger: logger21 };
         const progress3 = await getProgress({ enrollmentId: activeCourse.enrollmentId }, deps);
         const markerPath = path21.join(vaultPath, ".ana-vault.json");
         const markerRaw = await fs18.readFile(markerPath, "utf-8");
@@ -46366,7 +46642,7 @@ Para visualizar:
           );
         }
       } catch (err) {
-        logger20.error("vault sync failed", { error: err });
+        logger21.error("vault sync failed", { error: err });
         process.stderr.write(`\u274C ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -46446,7 +46722,7 @@ var init_profile = __esm({
 
 // src/commands/sync.ts
 import { Command as Command22 } from "commander";
-var logger21, syncCommand;
+var logger22, syncCommand;
 var init_sync = __esm({
   "src/commands/sync.ts"() {
     "use strict";
@@ -46455,15 +46731,18 @@ var init_sync = __esm({
     init_formatter();
     init_instruction_pipeline();
     init_pipeline_deps();
-    logger21 = createLogger("cli:sync");
-    syncCommand = new Command22("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").action(async (opts) => {
+    logger22 = createLogger("cli:sync");
+    syncCommand = new Command22("sync").description("Regenerate instruction files with updated progress").option("--json", "Output structured JSON").option(
+      "--all-runtimes",
+      "Write instruction files for every supported runtime, even undetected ones"
+    ).action(async (opts) => {
       try {
         await requireSession();
         const activeCourse = await requireActiveCourse();
         const pipelineResult = await resolveAndGenerate(
           { courseId: activeCourse.courseId, enrollmentId: activeCourse.enrollmentId },
           { forceRefresh: true, collectT1Interactive: false, collectT2Interactive: false },
-          { cwd: process.cwd(), deps: buildPipelineDeps() }
+          { cwd: process.cwd(), deps: buildPipelineDeps({ allRuntimes: opts.allRuntimes }) }
         );
         if (opts.json) {
           output(
@@ -46494,7 +46773,7 @@ var init_sync = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger21.warn("sync failed", { error: msg });
+        logger22.warn("sync failed", { error: msg });
         error(msg);
       }
     });
@@ -46503,7 +46782,7 @@ var init_sync = __esm({
 
 // src/commands/brief.ts
 import { Command as Command23 } from "commander";
-var logger22, briefCommand;
+var logger23, briefCommand;
 var init_brief = __esm({
   "src/commands/brief.ts"() {
     "use strict";
@@ -46512,7 +46791,7 @@ var init_brief = __esm({
     init_cache();
     init_api();
     init_formatter();
-    logger22 = createLogger("cli:brief");
+    logger23 = createLogger("cli:brief");
     briefCommand = new Command23("brief").description("Show your base learner brief (T1) status and content").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const session = await requireSession();
@@ -46546,7 +46825,7 @@ var init_brief = __esm({
         }
         output(lines.join("\n"), { json: false });
       } catch (err) {
-        logger22.error("Failed to show brief", { err });
+        logger23.error("Failed to show brief", { err });
         error(`Erro ao buscar brief: ${err instanceof Error ? err.message : String(err)}`);
       }
     });
@@ -46555,7 +46834,7 @@ var init_brief = __esm({
 
 // src/commands/brief-create.ts
 import { Command as Command24 } from "commander";
-var logger23, briefCreateCommand;
+var logger24, briefCreateCommand;
 var init_brief_create = __esm({
   "src/commands/brief-create.ts"() {
     "use strict";
@@ -46565,7 +46844,7 @@ var init_brief_create = __esm({
     init_api();
     init_cache();
     init_formatter();
-    logger23 = createLogger("cli:brief-create");
+    logger24 = createLogger("cli:brief-create");
     briefCreateCommand = new Command24("brief-create").description("Create your base learner brief via interactive prompts (T1 bootstrap)").action(async () => {
       try {
         const session = await requireSession();
@@ -46590,7 +46869,7 @@ var init_brief_create = __esm({
         ];
         output(doneLines.join("\n"), { json: false });
       } catch (err) {
-        logger23.error("Failed to create brief", { err });
+        logger24.error("Failed to create brief", { err });
         error(`Erro ao criar brief: ${err instanceof Error ? err.message : String(err)}`);
       }
     });
@@ -46655,7 +46934,7 @@ async function saveModuleSummary(workspacePath, input2) {
     ""
   ].join("\n");
   fs19.writeFileSync(filePath, header + input2.summary, { mode: 384 });
-  logger24.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
+  logger25.debug("Module summary saved", { moduleId: input2.moduleId, path: filePath });
   return filePath;
 }
 async function loadSessionContext(workspacePath) {
@@ -46676,19 +46955,19 @@ async function loadSessionContext(workspacePath) {
   }
   return { moduleSummaries: summaries };
 }
-var logger24;
+var logger25;
 var init_storage = __esm({
   "src/sessions/storage.ts"() {
     "use strict";
     init_dist();
-    logger24 = createLogger("cli:sessions");
+    logger25 = createLogger("cli:sessions");
   }
 });
 
 // src/commands/compact.ts
 import fs20 from "node:fs";
 import { Command as Command26 } from "commander";
-var logger25, compactCommand;
+var logger26, compactCommand;
 var init_compact = __esm({
   "src/commands/compact.ts"() {
     "use strict";
@@ -46697,7 +46976,7 @@ var init_compact = __esm({
     init_workspace_state();
     init_storage();
     init_formatter();
-    logger25 = createLogger("cli:compact");
+    logger26 = createLogger("cli:compact");
     compactCommand = new Command26("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();
@@ -46718,7 +46997,7 @@ var init_compact = __esm({
           moduleTitle,
           summary
         });
-        logger25.debug("Compact summary saved", { moduleId, filePath });
+        logger26.debug("Compact summary saved", { moduleId, filePath });
         if (opts.json) {
           output({ saved: true, path: filePath, moduleId }, { json: true });
         } else {
@@ -46727,7 +47006,7 @@ var init_compact = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger25.warn("compact failed", { error: msg });
+        logger26.warn("compact failed", { error: msg });
         if (opts.json) jsonError(msg);
         error(msg);
       }
@@ -46737,7 +47016,7 @@ var init_compact = __esm({
 
 // src/commands/context.ts
 import { Command as Command27 } from "commander";
-var logger26, contextCommand;
+var logger27, contextCommand;
 var init_context = __esm({
   "src/commands/context.ts"() {
     "use strict";
@@ -46745,7 +47024,7 @@ var init_context = __esm({
     init_workspace_state();
     init_storage();
     init_formatter();
-    logger26 = createLogger("cli:context");
+    logger27 = createLogger("cli:context");
     contextCommand = new Command27("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();
@@ -46773,7 +47052,7 @@ var init_context = __esm({
           })),
           totalModulesCompleted: sessionCtx.moduleSummaries.length
         };
-        logger26.debug("Context loaded", {
+        logger27.debug("Context loaded", {
           courseId: ws.state.courseId,
           moduleSummaries: sessionCtx.moduleSummaries.length
         });
@@ -46787,7 +47066,7 @@ var init_context = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger26.warn("context failed", { error: msg });
+        logger27.warn("context failed", { error: msg });
         if (opts.json) jsonError(msg);
         error(msg);
       }
@@ -46797,7 +47076,7 @@ var init_context = __esm({
 
 // src/commands/memory.ts
 import { Command as Command28 } from "commander";
-var logger27, memoryCommand;
+var logger28, memoryCommand;
 var init_memory = __esm({
   "src/commands/memory.ts"() {
     "use strict";
@@ -46806,7 +47085,7 @@ var init_memory = __esm({
     init_workspace_state();
     init_guards();
     init_formatter();
-    logger27 = createLogger("cli:memory");
+    logger28 = createLogger("cli:memory");
     memoryCommand = new Command28("memory").description("Load accumulated student memory (learning profile + recent lessons) for the tutor").option("--json", "Output structured JSON").action(async (opts) => {
       try {
         const ws = await findWorkspaceState();
@@ -46830,7 +47109,7 @@ var init_memory = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger27.warn("memory failed", { error: msg });
+        logger28.warn("memory failed", { error: msg });
         if (opts.json) jsonError(msg);
         else error(msg);
       }
@@ -46840,7 +47119,7 @@ var init_memory = __esm({
 
 // src/commands/insight.ts
 import { Command as Command29 } from "commander";
-var logger28, VALID_TYPES, insightCommand;
+var logger29, VALID_TYPES, insightCommand;
 var init_insight = __esm({
   "src/commands/insight.ts"() {
     "use strict";
@@ -46849,7 +47128,7 @@ var init_insight = __esm({
     init_workspace_state();
     init_guards();
     init_formatter();
-    logger28 = createLogger("cli:insight");
+    logger29 = createLogger("cli:insight");
     VALID_TYPES = ["difficulty", "breakthrough", "question"];
     insightCommand = new Command29("insight").description(
       "Persist a student cognitive insight (difficulty | breakthrough | question) into course memory"
@@ -46891,7 +47170,7 @@ var init_insight = __esm({
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         if (msg.includes("process.exit")) return;
-        logger28.warn("insight failed", { error: msg });
+        logger29.warn("insight failed", { error: msg });
         if (opts.json) jsonError(msg);
         else error(msg);
       }
@@ -46904,7 +47183,7 @@ import { Command as Command30 } from "commander";
 function isExerciseLevel2(value) {
   return ALL_LEVELS.includes(value);
 }
-var logger29, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
+var logger30, ALL_LEVELS, LEVEL_LABELS2, levelCommand;
 var init_level = __esm({
   "src/commands/level.ts"() {
     "use strict";
@@ -46913,7 +47192,7 @@ var init_level = __esm({
     init_exercises();
     init_guards();
     init_formatter();
-    logger29 = createLogger("cli:level");
+    logger30 = createLogger("cli:level");
     ALL_LEVELS = ["L0", "L1", "L2", "L3", "L4"];
     LEVEL_LABELS2 = {
       L0: "Pr\xE9-check (perguntas conceituais)",
@@ -46927,7 +47206,7 @@ var init_level = __esm({
         const session = await requireSession();
         const activeCourse = await requireActiveCourse();
         const data = createHttpProvider(session.apiUrl, session.token);
-        const deps = { data, logger: logger29 };
+        const deps = { data, logger: logger30 };
         if (!rawLevel) {
           const levels = await getEnrollmentLevels({ enrollmentId: activeCourse.enrollmentId }, deps);
           if (opts.json) {
@@ -46986,7 +47265,7 @@ var init_level = __esm({
 
 // src/commands/theory.ts
 import { Command as Command31 } from "commander";
-var logger30, EXERCISE_LEVELS2, theoryCommand;
+var logger31, EXERCISE_LEVELS2, theoryCommand;
 var init_theory = __esm({
   "src/commands/theory.ts"() {
     "use strict";
@@ -46994,7 +47273,7 @@ var init_theory = __esm({
     init_guards();
     init_formatter();
     init_errors();
-    logger30 = createLogger("cli:theory");
+    logger31 = createLogger("cli:theory");
     EXERCISE_LEVELS2 = ["L0", "L1", "L2", "L3", "L4"];
     theoryCommand = new Command31("theory").description("Request more theory on the current lesson (escape hatch)").option("--focus <text>", "Optional focus area in PT-BR (max 500 chars)").option("--level <L0|L1|L2|L3|L4>", "Override current exercise level (otherwise auto-detect)").option("--lesson <uuid>", "Override lesson ID (defaults to current workspace lesson)").option("--json", "Output structured JSON").action(async (opts) => {
       try {
@@ -47033,7 +47312,7 @@ var init_theory = __esm({
           currentLevel = levels.currentLevel;
         }
         const requestUrl = `${session.apiUrl}/api/cli/exercises/more-theory`;
-        logger30.debug("Requesting more theory", { lessonId, currentLevel });
+        logger31.debug("Requesting more theory", { lessonId, currentLevel });
         const res = await fetch(requestUrl, {
           method: "POST",
           headers: {
@@ -47438,7 +47717,7 @@ async function runExportGrades(opts, deps = defaultDeps5) {
   if (!rendered.endsWith("\n")) rendered += "\n";
   deps.stdoutWrite(rendered);
 }
-var logger31, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
+var logger32, SUPPORTED_FORMATS, defaultDeps5, exportGradesCommand;
 var init_export_grades = __esm({
   "src/commands/export-grades.ts"() {
     "use strict";
@@ -47446,7 +47725,7 @@ var init_export_grades = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger31 = createLogger("cli:export-grades");
+    logger32 = createLogger("cli:export-grades");
     SUPPORTED_FORMATS = ["json", "csv", "md"];
     defaultDeps5 = {
       requireSession,
@@ -47456,7 +47735,7 @@ var init_export_grades = __esm({
       stderrWrite: (message) => process.stderr.write(message),
       // process.exit is typed as `never` — wrap so the cast is local to one line.
       exit: (code) => process.exit(code),
-      logger: logger31,
+      logger: logger32,
       resolveBySlug: resolveEnrollmentBySlug
     };
     exportGradesCommand = new Command32("export-grades").description("Exporta o hist\xF3rico de valida\xE7\xF5es (notas) do curso ativo").option(
@@ -47625,7 +47904,7 @@ async function runGrades(opts, deps = defaultDeps6) {
   );
   deps.stdoutWrite(formatGradesAllEnrollmentsTable(summaries) + "\n");
 }
-var logger32, defaultDeps6, gradesCommand;
+var logger33, defaultDeps6, gradesCommand;
 var init_grades2 = __esm({
   "src/commands/grades.ts"() {
     "use strict";
@@ -47635,14 +47914,14 @@ var init_grades2 = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger32 = createLogger("cli:grades");
+    logger33 = createLogger("cli:grades");
     defaultDeps6 = {
       requireSession,
       fetch: globalThis.fetch.bind(globalThis),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger32,
+      logger: logger33,
       resolveBySlug: resolveEnrollmentBySlug,
       buildDataProvider: createHttpProvider,
       listCoursesFn: listCourses
@@ -47807,7 +48086,7 @@ async function runReview(slug, opts, deps = defaultDeps7) {
     }) + "\n"
   );
 }
-var logger33, defaultDeps7, reviewCommand;
+var logger34, defaultDeps7, reviewCommand;
 var init_review2 = __esm({
   "src/commands/review.ts"() {
     "use strict";
@@ -47815,14 +48094,14 @@ var init_review2 = __esm({
     init_guards();
     init_grades();
     init_resolve_enrollment();
-    logger33 = createLogger("cli:review");
+    logger34 = createLogger("cli:review");
     defaultDeps7 = {
       requireSession,
       fetch: globalThis.fetch.bind(globalThis),
       stdoutWrite: (message) => process.stdout.write(message),
       stderrWrite: (message) => process.stderr.write(message),
       exit: (code) => process.exit(code),
-      logger: logger33,
+      logger: logger34,
       resolveBySlug: resolveEnrollmentBySlug,
       promptLessonChoice: defaultPromptLessonChoice
     };
@@ -47937,13 +48216,77 @@ var init_cli = __esm({
   }
 });
 
+// src/auto-updater.ts
+var auto_updater_exports = {};
+__export(auto_updater_exports, {
+  detectManager: () => detectManager,
+  maybeAutoUpdate: () => maybeAutoUpdate
+});
+import fs21 from "node:fs";
+import path23 from "node:path";
+import { spawn as spawn2 } from "node:child_process";
+function detectManager(entryRealPath) {
+  const p = entryRealPath.split(path23.sep).join("/");
+  if (p.includes("/pnpm/")) return { cmd: "pnpm", args: ["add", "-g", `${PACKAGE_NAME2}@latest`] };
+  if (p.includes("/.bun/")) return { cmd: "bun", args: ["add", "-g", `${PACKAGE_NAME2}@latest`] };
+  if (p.includes(`/node_modules/${PACKAGE_NAME2}/`))
+    return { cmd: "npm", args: ["i", "-g", `${PACKAGE_NAME2}@latest`] };
+  return null;
+}
+function installDir(entryRealPath) {
+  const normalized = entryRealPath.split(path23.sep).join("/");
+  const marker = `/node_modules/${PACKAGE_NAME2}/`;
+  const idx = normalized.indexOf(marker);
+  if (idx === -1) return path23.dirname(entryRealPath);
+  return entryRealPath.slice(0, idx + marker.length - 1);
+}
+function maybeAutoUpdate(currentVersion, opts = {}) {
+  try {
+    const env = opts.env ?? process.env;
+    const argv = opts.argv ?? process.argv;
+    const isTTY = opts.isTTY ?? process.stderr.isTTY === true;
+    if (env["TOSTUDY_NO_AUTO_UPDATE"]) return;
+    if (env["CI"] || !isTTY || argv.includes("--json")) return;
+    const configDir = opts.configDir ?? getConfigDir();
+    const cache = readCache(configDir);
+    if (!cache || !isNewerVersion(cache.latest, currentVersion)) return;
+    if (cache.attemptedVersion === cache.latest) return;
+    const entryPath = opts.entryPath ?? argv[1];
+    if (!entryPath) return;
+    const real2 = fs21.realpathSync(entryPath);
+    const mgr = detectManager(real2);
+    if (!mgr) return;
+    fs21.accessSync(installDir(real2), fs21.constants.W_OK);
+    writeCache({ ...cache, attemptedVersion: cache.latest }, configDir);
+    process.stderr.write(
+      `
+  Atualizando ${PACKAGE_NAME2} para ${cache.latest} em segundo plano\u2026
+`
+    );
+    const spawnFn = opts.spawnFn ?? spawn2;
+    spawnFn(mgr.cmd, mgr.args, { detached: true, stdio: "ignore" }).unref();
+  } catch {
+  }
+}
+var PACKAGE_NAME2;
+var init_auto_updater = __esm({
+  "src/auto-updater.ts"() {
+    "use strict";
+    init_config_dir();
+    init_update_checker();
+    PACKAGE_NAME2 = "@tostudy-ai/cli";
+  }
+});
+
 // src/cli-entry.ts
 if (!process.env.LOG_LEVEL) {
   process.env.LOG_LEVEL = "fatal";
 }
 var { createProgram: createProgram2, CLI_VERSION: CLI_VERSION2 } = await Promise.resolve().then(() => (init_cli(), cli_exports));
 var { checkForUpdates: checkForUpdates2 } = await Promise.resolve().then(() => (init_update_checker(), update_checker_exports));
+var { maybeAutoUpdate: maybeAutoUpdate2 } = await Promise.resolve().then(() => (init_auto_updater(), auto_updater_exports));
 var program = createProgram2();
 program.parse();
 checkForUpdates2(CLI_VERSION2);
+maybeAutoUpdate2(CLI_VERSION2);
 //# sourceMappingURL=cli.js.map