@syedamirali/i18n-toolkit 0.1.0 → 0.2.0

package/README.md

@@ -31,7 +31,7 @@ Requires **Node ≥ 20**. For `translate` you also need a running Ollama instanc
 i18n-toolkit extract --src /path/to/your/app/src
 ```
 
-Output: `output/{timestamp}_translation_extractor.json` — sorted, deterministic.
+Output: `i18n-toolkit/output/{timestamp}_translation_extractor.json` — sorted, deterministic.
 
 **What it matches** (all AST-based, no regex):
 
@@ -48,8 +48,8 @@ Output: `output/{timestamp}_translation_extractor.json` — sorted, deterministi
 ```
 --src <path>             root to scan (default ".")
 --out <path>             explicit output file (overrides --output-dir)
---output-dir <path>      default ./output
---log-dir <path>         default ./logs
+--output-dir <path>      default ./i18n-toolkit/output
+--log-dir <path>         default ./i18n-toolkit/logs
 --lang <code>            top-level language key (default "en")
 --fail-on-conflict       exit 1 if any key has conflicting defaults
 --help                   full options list
@@ -70,7 +70,7 @@ i18n-toolkit diff
 `--src` accepts either a directory (runs extraction in-process) or a previously-extracted JSON file.
 `--resource` auto-detects flat `{ key: value }` vs language-wrapped `{ "en": { … } }` and picks the `en` slice.
 
-**Output:** `diff-output/{timestamp}/`
+**Output:** `i18n-toolkit/diff-output/{timestamp}/`
 
 | File | What's in it |
 |---|---|
@@ -96,7 +96,7 @@ Interactive. Three steps:
 
 The Ollama call streams with live thinking + response phases and a sticky status footer (elapsed / tokens / KB).
 
-**Output:** `translate-output/{timestamp}/translation.json`
+**Output:** `i18n-toolkit/translate-output/{timestamp}/translation.json`
 
 ```json
 {
@@ -121,15 +121,17 @@ NO_COLOR             disable ANSI colors
 The three commands compose:
 
 ```
-your-app/src/  ──extract──▶  output/…json
-                                  │
-                                  ▼
-   resource.json  ──diff──▶  diff-output/…/missing_in_resource.json
-                                                  │
-                                                  ▼
-                                     translate ──▶ translate-output/…/translation.json
+your-app/src/  ──extract──▶  i18n-toolkit/output/…json
+                                       │
+                                       ▼
+   resource.json  ──diff──▶  i18n-toolkit/diff-output/…/missing_in_resource.json
+                                                              │
+                                                              ▼
+                                     translate ──▶  i18n-toolkit/translate-output/…/translation.json
 ```
 
+All four output directories live under a single `i18n-toolkit/` workspace folder in your project root, so you only have **one** entry to ignore (`i18n-toolkit/`) — and the tool actually drops an auto-generated `i18n-toolkit/.gitignore` for you on first run, so you don't even have to do that.
+
 Drop the final `translation.json` back into your app's translation resource and the cycle closes.
 
 ---
@@ -169,7 +171,7 @@ docs/plans/          design docs (one per command)
 dist/                bundled output (generated; not in git)
 ```
 
-Generated output dirs (gitignored): `output/`, `logs/`, `diff-output/`, `translate-output/`.
+All generated artifacts go under `i18n-toolkit/` (auto-gitignored): `output/`, `logs/`, `diff-output/`, `translate-output/`.
 
 ---
 

package/dist/cli.js

@@ -5,18 +5,49 @@ import { parse } from "@babel/parser";
 import _traverse from "@babel/traverse";
 import * as t from "@babel/types";
 import fg from "fast-glob";
-import fs from "fs/promises";
+import fs2 from "fs/promises";
 import { createWriteStream } from "fs";
 import os from "os";
-import path from "path";
+import path2 from "path";
 import { format as formatInspect } from "util";
+
+// src/lib/workspace.ts
+import fs from "fs/promises";
+import path from "path";
+var WORKSPACE_DIR_NAME = "i18n-toolkit";
+var DEFAULT_DIRS = {
+  output: `./${WORKSPACE_DIR_NAME}/output`,
+  logs: `./${WORKSPACE_DIR_NAME}/logs`,
+  diffOutput: `./${WORKSPACE_DIR_NAME}/diff-output`,
+  translateOutput: `./${WORKSPACE_DIR_NAME}/translate-output`
+};
+var GITIGNORE_BODY = `# Auto-generated by @syedamirali/i18n-toolkit.
+# Safe to delete or commit. Everything inside is build output.
+*
+!.gitignore
+`;
+async function ensureWorkspaceGitignore(targetPath) {
+  const workspaceAbs = path.resolve(WORKSPACE_DIR_NAME);
+  const targetAbs = path.resolve(targetPath);
+  if (targetAbs !== workspaceAbs && !targetAbs.startsWith(workspaceAbs + path.sep)) return;
+  await fs.mkdir(workspaceAbs, { recursive: true });
+  const gitignorePath = path.join(workspaceAbs, ".gitignore");
+  try {
+    await fs.stat(gitignorePath);
+    return;
+  } catch {
+  }
+  await fs.writeFile(gitignorePath, GITIGNORE_BODY, "utf8");
+}
+
+// src/index.ts
 var traverse = _traverse.default ?? _traverse;
 function parseArgs(argv) {
   const opts = {
     src: ".",
     out: null,
-    outputDir: "./output",
-    logDir: "./logs",
+    outputDir: DEFAULT_DIRS.output,
+    logDir: DEFAULT_DIRS.logs,
     noLog: false,
     lang: "en",
     includeDynamic: true,
@@ -101,8 +132,8 @@ Usage:
 Options:
   --src <path>              Root directory to scan (default ".")
   --out <path>              Output JSON file (overrides --output-dir)
-  --output-dir <path>       Directory for auto-named output (default "./output")
-  --log-dir <path>          Directory for run logs (default "./logs")
+  --output-dir <path>       Directory for auto-named output (default "./i18n-toolkit/output")
+  --log-dir <path>          Directory for run logs (default "./i18n-toolkit/logs")
   --no-log                  Disable writing the per-run log file
   --lang <code>             Top-level language key (default "en")
   --include-dynamic <bool>  Emit dynamic keys with "__dynamic__" value (default true)
@@ -473,8 +504,8 @@ function extractFromFile(filePath, source, opts) {
   }
   traverse(ast, {
     // Handle `t("k") || "fallback"` BEFORE the inner CallExpression visitor sees it.
-    LogicalExpression(path4) {
-      const node = path4.node;
+    LogicalExpression(path5) {
+      const node = path5.node;
       if (node.operator !== "||") return;
       if (!t.isCallExpression(node.left)) return;
       if (!isTCall(node.left)) return;
@@ -483,14 +514,14 @@ function extractFromFile(filePath, source, opts) {
       handleTCall(node.left, fallback);
       handledCalls.add(node.left);
     },
-    CallExpression(path4) {
-      const node = path4.node;
+    CallExpression(path5) {
+      const node = path5.node;
       if (handledCalls.has(node)) return;
       if (!isTCall(node)) return;
       handleTCall(node, null);
     },
-    JSXOpeningElement(path4) {
-      const openingEl = path4.node;
+    JSXOpeningElement(path5) {
+      const openingEl = path5.node;
       let localKeyAttr = null;
       for (const attr of openingEl.attributes) {
         if (!t.isJSXAttribute(attr)) continue;
@@ -509,7 +540,7 @@ function extractFromFile(filePath, source, opts) {
       }
       const keyInfo = getKeyFromNode(keyNode);
       if (!keyInfo) return;
-      const parent = path4.parent;
+      const parent = path5.parent;
       const children = t.isJSXElement(parent) ? parent.children : [];
       let value;
       if (openingEl.selfClosing || children.length === 0) {
@@ -526,7 +557,7 @@ function extractFromFile(filePath, source, opts) {
   return records;
 }
 async function runExtraction(opts) {
-  const srcAbs = path.resolve(opts.src);
+  const srcAbs = path2.resolve(opts.src);
   const includeDynamic = opts.includeDynamic !== false;
   const includeMissing = opts.includeMissing !== false;
   const debug = opts.debug === true;
@@ -557,7 +588,7 @@ async function runExtraction(opts) {
       const file = files[i];
       let size;
       try {
-        const st = await fs.stat(file);
+        const st = await fs2.stat(file);
         size = st.size;
       } catch (err) {
         if (debug) console.warn(`${c.warn("[stat-error]")} ${c.path(file)}: ${err.message}`);
@@ -570,7 +601,7 @@ async function runExtraction(opts) {
       }
       let source;
       try {
-        source = await fs.readFile(file, "utf8");
+        source = await fs2.readFile(file, "utf8");
       } catch (err) {
         if (debug) console.warn(`${c.warn("[read-error]")} ${c.path(file)}: ${err.message}`);
         skippedFiles++;
@@ -579,7 +610,7 @@ async function runExtraction(opts) {
       try {
         perFileRecords[i] = extractFromFile(file, source, fileOpts);
         parsedFiles++;
-        if (debug) console.log(`${c.ok("[parsed]")} ${c.path(path.relative(process.cwd(), file))}`);
+        if (debug) console.log(`${c.ok("[parsed]")} ${c.path(path2.relative(process.cwd(), file))}`);
       } catch {
         parseErrorFiles++;
       }
@@ -611,21 +642,23 @@ async function main() {
   const opts = parseArgs(process.argv.slice(2));
   const startedAt = /* @__PURE__ */ new Date();
   const timestamp = formatTimestamp(startedAt);
-  const srcAbs = path.resolve(opts.src);
+  const srcAbs = path2.resolve(opts.src);
   let outAbs;
   if (opts.out !== null) {
-    outAbs = path.resolve(opts.out);
+    outAbs = path2.resolve(opts.out);
   } else {
-    const outDirAbs = path.resolve(opts.outputDir);
-    await fs.mkdir(outDirAbs, { recursive: true });
-    outAbs = path.join(outDirAbs, `${timestamp}_translation_extractor.json`);
+    const outDirAbs = path2.resolve(opts.outputDir);
+    await ensureWorkspaceGitignore(outDirAbs);
+    await fs2.mkdir(outDirAbs, { recursive: true });
+    outAbs = path2.join(outDirAbs, `${timestamp}_translation_extractor.json`);
   }
   let logTee = null;
   let logAbs = null;
   if (!opts.noLog) {
-    const logDirAbs = path.resolve(opts.logDir);
-    await fs.mkdir(logDirAbs, { recursive: true });
-    logAbs = path.join(logDirAbs, `${timestamp}_translation_extractor.log`);
+    const logDirAbs = path2.resolve(opts.logDir);
+    await ensureWorkspaceGitignore(logDirAbs);
+    await fs2.mkdir(logDirAbs, { recursive: true });
+    logAbs = path2.join(logDirAbs, `${timestamp}_translation_extractor.log`);
     const stream = createWriteStream(logAbs, { flags: "a" });
     logTee = setupLogTee(stream);
     const tag = c.head("[translation-extractor]");
@@ -651,8 +684,8 @@ async function main() {
     for (const conf of result.conflicts) {
       const keptAbs = conf.kept.location.file;
       const seenAbs = conf.seen.location.file;
-      const keptRel = path.relative(process.cwd(), keptAbs);
-      const seenRel = path.relative(process.cwd(), seenAbs);
+      const keptRel = path2.relative(process.cwd(), keptAbs);
+      const seenRel = path2.relative(process.cwd(), seenAbs);
       const keptLine = conf.kept.location.line;
       const seenLine = conf.seen.location.line;
       const keptVal = JSON.stringify(conf.kept.value);
@@ -677,8 +710,8 @@ async function main() {
   for (const [k, v] of result.entries) langObj[k] = v;
   const output2 = { [opts.lang]: langObj };
   const json = opts.pretty ? JSON.stringify(output2, null, 2) + "\n" : JSON.stringify(output2);
-  await fs.mkdir(path.dirname(outAbs), { recursive: true });
-  await fs.writeFile(outAbs, json, "utf8");
+  await fs2.mkdir(path2.dirname(outAbs), { recursive: true });
+  await fs2.writeFile(outAbs, json, "utf8");
   const skippedNum = result.skippedFiles > 0 ? c.warn(result.skippedFiles) : c.value(result.skippedFiles);
   const skipNote = result.skippedFiles > 0 ? c.label(" (too large or unreadable; rerun with --debug to include)") : "";
   const conflictsNum = result.conflicts.length > 0 ? c.warn(result.conflicts.length) : c.ok(result.conflicts.length);
@@ -699,8 +732,8 @@ async function main() {
     )
   );
   console.log(stat("Conflicts", String(conflictsNum)));
-  console.log(stat("Output", c.path(path.relative(process.cwd(), outAbs))));
-  if (logAbs) console.log(stat("Log", c.path(path.relative(process.cwd(), logAbs))));
+  console.log(stat("Output", c.path(path2.relative(process.cwd(), outAbs))));
+  if (logAbs) console.log(stat("Log", c.path(path2.relative(process.cwd(), logAbs))));
   if (logTee) await logTee.teardown();
   if (opts.failOnConflict && result.conflicts.length > 0) {
     process.exit(1);
@@ -717,12 +750,12 @@ async function runCommand(_argv) {
 
 // src/diff.ts
 import { createInterface } from "readline/promises";
-import fs2 from "fs/promises";
+import fs3 from "fs/promises";
 import { createWriteStream as createWriteStream2 } from "fs";
-import path2 from "path";
+import path3 from "path";
 import { stdin as input, stdout as output } from "process";
 var TARGET_LANG = "en";
-var DIFF_OUTPUT_DIR = "./diff-output";
+var DIFF_OUTPUT_DIR = DEFAULT_DIRS.diffOutput;
 function parseDiffArgs(argv) {
   const opts = { src: null, resource: null };
   for (let i = 0; i < argv.length; i++) {
@@ -753,9 +786,9 @@ function cleanPath(raw) {
 }
 async function resolveSourcePath(p) {
   if (!p) return { error: "Empty input." };
-  const abs = path2.resolve(p);
+  const abs = path3.resolve(p);
   try {
-    const st = await fs2.stat(abs);
+    const st = await fs3.stat(abs);
     if (st.isDirectory()) return { kind: "directory", absPath: abs };
     if (st.isFile()) {
       if (!abs.toLowerCase().endsWith(".json")) return { error: `Not a .json file: ${abs}` };
@@ -768,9 +801,9 @@ async function resolveSourcePath(p) {
 }
 async function resolveResourcePath(p) {
   if (!p) return { error: "Empty input." };
-  const abs = path2.resolve(p);
+  const abs = path3.resolve(p);
   try {
-    const st = await fs2.stat(abs);
+    const st = await fs3.stat(abs);
     if (!st.isFile()) return { error: `Not a file: ${abs}` };
     if (!abs.toLowerCase().endsWith(".json")) return { error: `Not a .json file: ${abs}` };
     return { absPath: abs };
@@ -810,7 +843,7 @@ async function promptForResource(rl) {
   }
 }
 async function loadKeyMap(filePath, sourceLabel) {
-  const text = await fs2.readFile(filePath, "utf8");
+  const text = await fs3.readFile(filePath, "utf8");
   const json = JSON.parse(text);
   if (json === null || typeof json !== "object" || Array.isArray(json)) {
     throw new Error(`${sourceLabel}: expected a JSON object at the top level`);
@@ -848,11 +881,12 @@ async function loadKeyMap(filePath, sourceLabel) {
 async function main2() {
   const startedAt = /* @__PURE__ */ new Date();
   const timestamp = formatTimestamp(startedAt);
-  const runDir = path2.resolve(DIFF_OUTPUT_DIR, timestamp);
-  await fs2.mkdir(runDir, { recursive: true });
-  const logAbs = path2.join(runDir, `${timestamp}_translation_diff.log`);
-  const missingInResourcePath = path2.join(runDir, "missing_in_resource.json");
-  const missingInExtractorPath = path2.join(runDir, "missing_in_extractor.json");
+  const runDir = path3.resolve(DIFF_OUTPUT_DIR, timestamp);
+  await ensureWorkspaceGitignore(runDir);
+  await fs3.mkdir(runDir, { recursive: true });
+  const logAbs = path3.join(runDir, `${timestamp}_translation_diff.log`);
+  const missingInResourcePath = path3.join(runDir, "missing_in_resource.json");
+  const missingInExtractorPath = path3.join(runDir, "missing_in_extractor.json");
   const stream = createWriteStream2(logAbs, { flags: "a" });
   const logTee = setupLogTee(stream);
   const tag = c.head("[translation-diff]");
@@ -983,8 +1017,8 @@ async function main2() {
     return out;
   };
   const wrap2 = (m) => ({ [TARGET_LANG]: sortedObject(m) });
-  await fs2.writeFile(missingInResourcePath, JSON.stringify(wrap2(missingInResource), null, 2) + "\n", "utf8");
-  await fs2.writeFile(missingInExtractorPath, JSON.stringify(wrap2(missingInExtractor), null, 2) + "\n", "utf8");
+  await fs3.writeFile(missingInResourcePath, JSON.stringify(wrap2(missingInResource), null, 2) + "\n", "utf8");
+  await fs3.writeFile(missingInExtractorPath, JSON.stringify(wrap2(missingInExtractor), null, 2) + "\n", "utf8");
   const labels = ["Extractor keys", "Resource keys", "Dynamic skipped", "Missing in resource", "Missing in extractor", "Output dir"];
   const pad = Math.max(...labels.map((l) => l.length));
   const stat = (label, value) => `${c.label(label.padEnd(pad) + " :")} ${value}`;
@@ -1007,10 +1041,10 @@ async function main2() {
       `${Object.keys(missingInExtractor).length > 0 ? c.warn(Object.keys(missingInExtractor).length) : c.ok(0)}  ${c.label("(in resource, not in extractor)")}`
     )
   );
-  console.log(stat("Output dir", c.path(path2.relative(process.cwd(), runDir))));
+  console.log(stat("Output dir", c.path(path3.relative(process.cwd(), runDir))));
   console.log(`  ${c.label("\u251C\u2500")} ${c.path("missing_in_resource.json")}`);
   console.log(`  ${c.label("\u251C\u2500")} ${c.path("missing_in_extractor.json")}`);
-  console.log(`  ${c.label("\u2514\u2500")} ${c.path(path2.basename(logAbs))}`);
+  console.log(`  ${c.label("\u2514\u2500")} ${c.path(path3.basename(logAbs))}`);
   await logTee.teardown();
 }
 async function runCommand2(_argv) {
@@ -1023,9 +1057,9 @@ async function runCommand2(_argv) {
 }
 
 // src/translate.ts
-import fs3 from "fs/promises";
+import fs4 from "fs/promises";
 import { createWriteStream as createWriteStream3 } from "fs";
-import path3 from "path";
+import path4 from "path";
 import { fileURLToPath } from "url";
 import { checkbox, select, input as inquirerInput, Separator } from "@inquirer/prompts";
 
@@ -1533,12 +1567,12 @@ function formatError(e) {
 }
 
 // src/translate.ts
-var SCRIPT_DIR = path3.dirname(fileURLToPath(import.meta.url));
-var PROJECT_ROOT = path3.resolve(SCRIPT_DIR, "..");
-var PROMPT_PATH = path3.resolve(PROJECT_ROOT, "prompt/translation-prompt.md");
-var LANGUAGES_JSON_PATH = path3.resolve(PROJECT_ROOT, "data/languages.json");
-var DIFF_OUTPUT_DIR2 = path3.resolve(PROJECT_ROOT, "diff-output");
-var TRANSLATE_OUTPUT_DIR = path3.resolve(PROJECT_ROOT, "translate-output");
+var SCRIPT_DIR = path4.dirname(fileURLToPath(import.meta.url));
+var PACKAGE_ROOT = path4.resolve(SCRIPT_DIR, "..");
+var PROMPT_PATH = path4.resolve(PACKAGE_ROOT, "prompt/translation-prompt.md");
+var LANGUAGES_JSON_PATH = path4.resolve(PACKAGE_ROOT, "data/languages.json");
+var DIFF_OUTPUT_DIR2 = path4.resolve(process.cwd(), DEFAULT_DIRS.diffOutput);
+var TRANSLATE_OUTPUT_DIR = path4.resolve(process.cwd(), DEFAULT_DIRS.translateOutput);
 var PLACEHOLDER_CONTENT = "PASTE CONTENT HERE";
 var PLACEHOLDER_LANGS = "LANGUAGES TO PRODUCE";
 var SOURCE_LANG = "en";
@@ -1588,17 +1622,17 @@ function cleanPath2(raw) {
 async function findRecentDiffOutputs(max = 5) {
   let dirEntries = [];
   try {
-    dirEntries = await fs3.readdir(DIFF_OUTPUT_DIR2);
+    dirEntries = await fs4.readdir(DIFF_OUTPUT_DIR2);
   } catch {
     return [];
   }
   const candidates = [];
   for (const dirName of dirEntries) {
-    const filePath = path3.join(DIFF_OUTPUT_DIR2, dirName, "missing_in_resource.json");
+    const filePath = path4.join(DIFF_OUTPUT_DIR2, dirName, "missing_in_resource.json");
     try {
-      const st = await fs3.stat(filePath);
+      const st = await fs4.stat(filePath);
       if (!st.isFile()) continue;
-      const text = await fs3.readFile(filePath, "utf8");
+      const text = await fs4.readFile(filePath, "utf8");
       const json = JSON.parse(text);
       const enSlice = json[SOURCE_LANG] ?? json;
       const keyCount = typeof enSlice === "object" && enSlice !== null ? Object.keys(enSlice).length : 0;
@@ -1609,7 +1643,7 @@ async function findRecentDiffOutputs(max = 5) {
   candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
   return candidates.slice(0, max).map((it) => ({
     absPath: it.abs,
-    relPath: path3.relative(process.cwd(), it.abs),
+    relPath: path4.relative(process.cwd(), it.abs),
     mtimeMs: it.mtimeMs,
     keyCount: it.keyCount,
     ageLabel: humanAge(Date.now() - it.mtimeMs)
@@ -1626,7 +1660,7 @@ function humanAge(ms) {
   return `${d}d ago`;
 }
 async function loadLanguages() {
-  const text = await fs3.readFile(LANGUAGES_JSON_PATH, "utf8");
+  const text = await fs4.readFile(LANGUAGES_JSON_PATH, "utf8");
   const arr = JSON.parse(text);
   return arr.filter((l) => l && l.active && l.code);
 }
@@ -1716,7 +1750,7 @@ async function promptInput(recents) {
     choices
   });
   if (pick.kind === "recent") {
-    const text = await fs3.readFile(pick.file.absPath, "utf8");
+    const text = await fs4.readFile(pick.file.absPath, "utf8");
     return {
       sourceLabel: pick.file.absPath,
       keyMap: parseEnglishKeyMap(text, pick.file.absPath)
@@ -1728,15 +1762,15 @@ async function promptInput(recents) {
         message: "Paste a JSON file path:",
         validate: (v) => v.trim().length > 0 ? true : "Path required"
       });
-      const p = path3.resolve(cleanPath2(raw));
+      const p = path4.resolve(cleanPath2(raw));
       try {
-        const st = await fs3.stat(p);
+        const st = await fs4.stat(p);
         if (!st.isFile() || !p.toLowerCase().endsWith(".json")) {
           console.log(c.err(`  Not a .json file: ${p}
 `));
           continue;
         }
-        const text = await fs3.readFile(p, "utf8");
+        const text = await fs4.readFile(p, "utf8");
         return { sourceLabel: p, keyMap: parseEnglishKeyMap(text, p) };
       } catch (err) {
         console.log(c.err(`  ${err.message}
@@ -1992,10 +2026,11 @@ function printHeader(args) {
 async function main3() {
   const startedAt = /* @__PURE__ */ new Date();
   const timestamp = formatTimestamp(startedAt);
-  const runDir = path3.join(TRANSLATE_OUTPUT_DIR, timestamp);
-  await fs3.mkdir(runDir, { recursive: true });
-  const outputPath = path3.join(runDir, "translation.json");
-  const logAbs = path3.join(runDir, `${timestamp}_translate.log`);
+  const runDir = path4.join(TRANSLATE_OUTPUT_DIR, timestamp);
+  await ensureWorkspaceGitignore(runDir);
+  await fs4.mkdir(runDir, { recursive: true });
+  const outputPath = path4.join(runDir, "translation.json");
+  const logAbs = path4.join(runDir, `${timestamp}_translate.log`);
   const stream = createWriteStream3(logAbs, { flags: "a" });
   const logTee = setupLogTee(stream);
   const tag = c.head("[translation-translate]");
@@ -2027,9 +2062,9 @@ async function main3() {
     sourceLabel: picked.sourceLabel,
     keyCount: Object.keys(picked.keyMap).length,
     langs: selectedLangs,
-    outputDir: path3.relative(process.cwd(), runDir)
+    outputDir: path4.relative(process.cwd(), runDir)
   });
-  const promptTemplate = await fs3.readFile(PROMPT_PATH, "utf8");
+  const promptTemplate = await fs4.readFile(PROMPT_PATH, "utf8");
   const prompt = renderPrompt(promptTemplate, selectedLangs, picked.keyMap);
   const t0 = Date.now();
   const spinner = new Spinner();
@@ -2041,7 +2076,7 @@ async function main3() {
     parsed = JSON.parse(jsonText);
   } catch (e) {
     const debugPath = `${outputPath}.raw.txt`;
-    await fs3.writeFile(debugPath, response, "utf8");
+    await fs4.writeFile(debugPath, response, "utf8");
     throw new Error(
       `Failed to parse JSON from model output. Raw response saved to ${debugPath}.
 ${e.message}`
@@ -2051,7 +2086,7 @@ ${e.message}`
   const expectedKeys = Object.keys(picked.keyMap);
   const report = validateTranslation(parsed, expectedLangs, expectedKeys);
   const sorted = sortedLangBundle(parsed, expectedLangs, expectedKeys);
-  await fs3.writeFile(outputPath, JSON.stringify(sorted, null, 2) + "\n", "utf8");
+  await fs4.writeFile(outputPath, JSON.stringify(sorted, null, 2) + "\n", "utf8");
   const responseRate = metrics.evalTokens && metrics.evalMs ? (metrics.evalTokens / metrics.evalMs * 1e3).toFixed(1) : "\u2014";
   process.stdout.write(`
   ${rule()}

package/package.json

@@ -1,13 +1,13 @@
 {
     "name": "@syedamirali/i18n-toolkit",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "AST-based CLI to extract translation keys from React/Next.js code, diff them against translation files, and translate missing keys via a local Ollama instance.",
     "type": "module",
     "license": "MIT",
     "author": "Syed Amir Ali",
     "repository": {
         "type": "git",
-        "url": "https://github.com/SyedAmirAli/i18n-toolkit.git"
+        "url": "git+https://github.com/SyedAmirAli/i18n-toolkit.git"
     },
     "homepage": "https://github.com/SyedAmirAli/i18n-toolkit#readme",
     "bugs": {
@@ -31,7 +31,7 @@
         "node": ">=20"
     },
     "bin": {
-        "i18n-toolkit": "./dist/cli.js"
+        "i18n-toolkit": "dist/cli.js"
     },
     "files": [
         "dist",