DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import path from "node:path";
import { spawnSync } from "node:child_process";
import { expect, it } from "vitest";
const audit = path.resolve("scripts/i18n_audit.mjs");
function runAudit(
source: string,
en: Record<string, string>,
zh = en,
partial: { fr?: Record<string, string>; uk?: Record<string, string> } = {},
) {
const root = mkdtempSync(path.join(tmpdir(), "deeptutor-i18n-"));
try {
for (const [locale, entries] of Object.entries({
en,
zh,
fr: partial.fr ?? en,
de: en,
uk: partial.uk ?? en,
})) {
mkdirSync(path.join(root, "locales", locale), { recursive: true });
writeFileSync(path.join(root, "locales", locale, "app.json"), JSON.stringify(entries));
}
mkdirSync(path.join(root, "hooks"));
writeFileSync(path.join(root, "hooks", "sample.ts"), source);
return spawnSync(process.execPath, [audit, "--show-missing"], { cwd: root, encoding: "utf8" });
} finally {
rmSync(root, { recursive: true, force: true });
}
}
it("fails for keys absent from both locales, including .ts and conditional calls", () => {
const result = runAudit('t(active ? "Enabled" : "Disabled"); i18n.t("Missing");', { Enabled: "Enabled" });
expect(result.status).toBe(1);
expect(result.stdout).toContain('"Disabled"');
expect(result.stdout).toContain('"Missing"');
});
it("decodes escaped and multiline keys and ignores comments and string contents", () => {
const source = '// t("Not a call")\nconst example = \'t("Also not a call")\';\nt("Say \\\"hello\\\""); t(`First\nSecond`);';
const result = runAudit(source, { 'Say "hello"': "Hello", "First\nSecond": "Two lines" });
expect(result.status, result.stderr + result.stdout).toBe(0);
});
it("accepts complete locale-specific plural forms and rejects incomplete ones", () => {
const source = 't("Items", { count: 2 });';
const en = { Items_one: "One item", Items_other: "{{count}} items" };
const partial = { fr: { Items: "Articles" }, uk: { Items: "Елементи" } };
expect(runAudit(source, en, { Items_other: "{{count}} 项" }, partial).status).toBe(0);
expect(runAudit(source, { Items_one: "One item" }, { Items_other: "{{count}} 项" }, partial).status).toBe(1);
});
it("reports partial locale coverage and accepts documented English fallback", () => {
const source = 't("One"); t("Two"); t("Three"); t("Four");';
const en = { One: "One", Two: "Two", Three: "Three", Four: "Four" };
const result = runAudit(source, en, en, {
fr: { One: "Un", Two: "Deux", Three: "Trois" },
uk: { One: "Один", Two: "Два", Three: "Три" },
});
expect(result.status, result.stderr + result.stdout).toBe(0);
expect(result.stdout).toContain("fr: 3/4 used keys (75.0%)");
expect(result.stdout).toContain("uk: 3/4 used keys (75.0%)");
expect(result.stdout).toContain("fall back to English");
});
it("fails when partial coverage falls below its floor", () => {
const source = 't("One"); t("Two"); t("Three"); t("Four");';
const en = { One: "One", Two: "Two", Three: "Three", Four: "Four" };
const result = runAudit(source, en, en, {
fr: { One: "Un", Two: "Deux" },
uk: { One: "Один", Two: "Два", Three: "Три" },
});
expect(result.status).toBe(1);
expect(result.stderr).toContain("fr: used-key coverage below 65.0%");
});
it("fails on translated placeholder drift in French and Ukrainian", () => {
const source = 't("Hello {{name}}");';
const en = { "Hello {{name}}": "Hello {{name}}" };
const result = runAudit(source, en, en, {
fr: { "Hello {{name}}": "Bonjour {{person}}" },
uk: { "Hello {{name}}": "Вітаю, {{person}}" },
});
expect(result.status).toBe(1);
expect(result.stderr).toContain("fr: 1 interpolation placeholder mismatches");
expect(result.stderr).toContain("uk: 1 interpolation placeholder mismatches");
});