altalandi 0.3.1 → 0.4.0

package/altalandi.mjs

@@ -1,203 +1,223 @@
-#!/usr/bin/env node
-// altalandi — turn English or stiff/AI Icelandic into native Icelandic from
-// your terminal. Zero dependencies (Node >= 18 has global fetch).
-//
-//   npx altalandi login                 # once: connects this computer to your account
-//   altalandi "Make sure to reach out to us today."
-//   echo "some text" | altalandi --domain marketing
-//
-// stdout = the refined text (so you can pipe it); stderr = nativeness score,
-// meaning verdict, API warnings, and the diff.
-
-import { refine } from "./client.mjs";
-import { readCredentials, resolveKey, runLogin, runLogout, runWhoami } from "./auth.mjs";
-
-const args = process.argv.slice(2);
-
-// Subcommands and meta flags are handled before anything that needs an API key
-// or input text. `altalandi update` checks for a newer CLI and skill and asks
-// before changing anything.
-let handled = false;
-if (args[0] === "update") {
-  handled = true;
-  const { runUpdate } = await import("./update.mjs");
-  const rest = args.slice(1);
-  if (rest.includes("-h") || rest.includes("--help")) { updateHelp(); process.exit(0); }
-  // exitCode, never process.exit(): the registry request can leave a socket
-  // mid-close, and exiting then aborts Node on Windows with a libuv assertion
-  // (UV_HANDLE_CLOSING). The refine path below exits the same way for the
-  // same reason.
-  process.exitCode = await runUpdate({
-    check: rest.includes("--check"),
-    yes: rest.includes("--yes") || rest.includes("-y"),
-    skillOnly: rest.includes("--skill-only"),
-  });
-}
-if (!handled && ["login", "setup", "logout", "whoami"].includes(args[0])) {
-  handled = true;
-  const rest = args.slice(1);
-  const flag = (name) => { const i = rest.indexOf(name); return i >= 0 ? rest[i + 1] : undefined; };
-  if (args[0] === "login" || args[0] === "setup") {
-    process.exitCode = await runLogin({
-      noBrowser: rest.includes("--no-browser"),
-      noSkill: rest.includes("--no-skill"),
-      baseUrl: flag("--base-url"),
-    });
-  } else if (args[0] === "logout") {
-    process.exitCode = await runLogout();
-  } else {
-    process.exitCode = await runWhoami({ json: rest.includes("--json"), baseUrl: flag("--base-url") });
-  }
-}
-if (!handled && (args.includes("-v") || args.includes("--version"))) {
-  const { currentVersion } = await import("./update.mjs");
-  console.log(await currentVersion());
-  process.exit(0);
-}
-
-function updateHelp() {
-  console.log(`altalandi update — check for a newer version and update if you agree
-
-Usage:
-  altalandi update            check, then ask before updating the CLI and the /altalandi skill
-  altalandi update --check    only report; never change anything
-  altalandi update --yes      update without asking (for scripts that already have consent)
-
-Nothing changes without consent. Without a terminal to ask in (agents, CI,
-pipes) and without --yes, it only reports what is available.
-
-Exit codes: 0 up to date or updated · 10 an update is available but was not
-applied · 1 the check or the update failed.`);
-}
-
-if (!handled) {
-const opts = { domain: "general", register: "neutral", json: false, fast: false };
-const positional = [];
-for (let i = 0; i < args.length; i++) {
-  const a = args[i];
-  if (a === "-h" || a === "--help") { help(); process.exit(0); }
-  else if (a === "--json") opts.json = true;
-  else if (a === "--fast") opts.fast = true;
-  else if (a === "--domain") opts.domain = args[++i];
-  else if (a === "--register") opts.register = args[++i];
-  else if (a === "--base-url") opts.baseUrl = args[++i];
-  else if (a === "--key") opts.key = args[++i];
-  else if (a === "--file") opts.file = args[++i];
-  else positional.push(a);
-}
-
-function help() {
-  console.log(`altalandi — native Icelandic from your terminal
-
-Usage:
-  altalandi login                       connect this computer to your account (once)
-  altalandi "text to refine"
-  altalandi --file draft.txt            read the text from a file (best for agents)
-  echo "text" | altalandi
-  altalandi --domain marketing --register warm "text"
-
-Commands:
-  altalandi login      open altalandi.is, sign in or sign up, approve; stores the key
-                       and installs the Claude Code skill (--no-skill, --no-browser)
-  altalandi whoami     show the account and balance behind the stored key
-  altalandi logout     forget the stored key on this computer
-  altalandi update     check for a newer version and update if you agree
-  altalandi --version  print the installed version
-
-Options:
-  --domain     general | marketing | data-analysis | childrens-fiction  (default general)
-  --register   formal | neutral | warm  (default neutral)
-  --fast       no polish, no nativeness score, no meaning gate — normally one writer call
-               (structured input can still add a structure-preserving retry)
-  --json       print the full JSON response
-  --file       read the text from a UTF-8 file instead of an argument
-  --base-url   API base  (default $ALTALANDI_BASE_URL or https://altalandi.is/api)
-
-stdout = refined text; stderr = nativeness / meaning / warnings / diff.
-Without --fast, false/null meaning verification exits 3 after printing the response.`);
-}
-
-function readStdin() {
-  return new Promise((resolve) => {
-    if (process.stdin.isTTY) return resolve("");
-    let d = "";
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (c) => (d += c));
-    process.stdin.on("end", () => resolve(d));
-  });
-}
-
-const stored = readCredentials();
-const baseUrl = (opts.baseUrl || process.env.ALTALANDI_BASE_URL || stored?.baseUrl || "https://altalandi.is/api").replace(/\/$/, "");
-const { key } = resolveKey({ flag: opts.key });
-
-if (opts.key) {
-  console.error("⚠ --key is deprecated because command arguments can leak through shell history/process listings; load ALTALANDI_API_KEY instead.");
-}
-
-let text = positional.join(" ").trim();
-if (opts.file) {
-  const { readFile } = await import("node:fs/promises");
-  try { text = (await readFile(opts.file, "utf8")).replace(/^/, "").trim(); }
-  catch (e) { console.error(`Could not read ${opts.file}: ${e.message}`); process.exit(2); }
-}
-if (!text) text = (await readStdin()).trim();
-if (!text) { console.error("No input. Pass text as an argument or pipe via stdin.  (altalandi --help)"); process.exit(2); }
-if (!key) { console.error("Not logged in. Run once:  npx altalandi login   (or set ALTALANDI_API_KEY)"); process.exit(2); }
-
-const requestOptions = {
-  apiKey: key,
-  baseUrl,
-  domain: opts.domain,
-  register: opts.register,
-};
-// --fast disables every optional quality/verification pass. The writer can
-// still retry once when it drops document structure, as documented in --help.
-// Name every switch explicitly so a future server-default change cannot make
-// this client silently slower.
-if (opts.fast) {
-  requestOptions.preserveMeaning = false;
-  requestOptions.scoreNativeness = false;
-  requestOptions.onlyImprove = false;
-  requestOptions.polishPass = false;
-  requestOptions.scoring = "none";
-}
-
-try {
-  // refine() owns a single 300-second AbortController deadline across fetch
-  // and response-body parsing, matching the hosted package API.
-  const data = await refine(text, requestOptions);
-  const verificationFailed = !opts.fast && data.meaningPreserved !== true;
-
-  if (opts.json) {
-    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
-    if (verificationFailed) {
-      console.error("Meaning verification did not pass; JSON was printed, exiting with status 3.");
-    }
-  } else {
-    process.stdout.write(data.output + "\n");
-    const q = data.quality || {};
-    const meta = [];
-    if (q.nativenessScore != null) meta.push(`nativeness ${q.nativenessScore}/100`);
-    if (data.meaningPreserved === false) meta.push("⚠ MEANING DRIFT — returned the original");
-    else if (data.meaningPreserved === true) meta.push("meaning preserved");
-    else if (opts.fast) meta.push("meaning check skipped (--fast)");
-    else meta.push("⚠ MEANING UNVERIFIED — review before use");
-    if (meta.length) console.error("· " + meta.join(" · "));
-    for (const warning of Array.isArray(data.warnings) ? data.warnings : []) {
-      console.error(`⚠ ${warning}`);
-    }
-    for (const d of data.diffs || []) console.error(`  − ${d.before}\n  + ${d.after}  (${d.reason})`);
-  }
-
-  // stdout/JSON is intentionally written first so callers can inspect the
-  // server response, but guarded automation must not accept null/false as a
-  // verified success. --fast is the explicit opt-out from this contract.
-  if (verificationFailed) process.exitCode = 3;
-} catch (e) {
-  console.error("Request failed:", e.message);
-  if (e.status === 402) console.error("→ Add credit at https://altalandi.is/portal (automatic top-up is available there).");
-  if (e.status === 401) console.error("→ The key is invalid or revoked. Run:  npx altalandi login");
-  process.exit(e.status === 402 ? 4 : 1);
-}
-}
+#!/usr/bin/env node
+// altalandi — turn English or stiff/AI Icelandic into native Icelandic from
+// your terminal. Zero dependencies (Node >= 18 has global fetch).
+//
+//   npx altalandi login                 # once: connects this computer to your account
+//   altalandi "Make sure to reach out to us today."
+//   echo "some text" | altalandi --domain marketing
+//
+// stdout = the refined text (so you can pipe it); stderr = nativeness score,
+// meaning verdict, API warnings, and the diff.
+
+import { refine } from "./client.mjs";
+import { beforeAfterText, reportEnabled, writeReport } from "./report.mjs";
+import { readCredentials, resolveKey, runLogin, runLogout, runWhoami } from "./auth.mjs";
+
+const args = process.argv.slice(2);
+
+// Subcommands and meta flags are handled before anything that needs an API key
+// or input text. `altalandi update` checks for a newer CLI and skill and asks
+// before changing anything.
+let handled = false;
+if (args[0] === "update") {
+  handled = true;
+  const { runUpdate } = await import("./update.mjs");
+  const rest = args.slice(1);
+  if (rest.includes("-h") || rest.includes("--help")) { updateHelp(); process.exit(0); }
+  // exitCode, never process.exit(): the registry request can leave a socket
+  // mid-close, and exiting then aborts Node on Windows with a libuv assertion
+  // (UV_HANDLE_CLOSING). The refine path below exits the same way for the
+  // same reason.
+  process.exitCode = await runUpdate({
+    check: rest.includes("--check"),
+    yes: rest.includes("--yes") || rest.includes("-y"),
+    skillOnly: rest.includes("--skill-only"),
+  });
+}
+if (!handled && ["login", "setup", "logout", "whoami"].includes(args[0])) {
+  handled = true;
+  const rest = args.slice(1);
+  const flag = (name) => { const i = rest.indexOf(name); return i >= 0 ? rest[i + 1] : undefined; };
+  if (args[0] === "login" || args[0] === "setup") {
+    process.exitCode = await runLogin({
+      noBrowser: rest.includes("--no-browser"),
+      noSkill: rest.includes("--no-skill"),
+      baseUrl: flag("--base-url"),
+    });
+  } else if (args[0] === "logout") {
+    process.exitCode = await runLogout();
+  } else {
+    process.exitCode = await runWhoami({ json: rest.includes("--json"), baseUrl: flag("--base-url") });
+  }
+}
+if (!handled && (args.includes("-v") || args.includes("--version"))) {
+  const { currentVersion } = await import("./update.mjs");
+  console.log(await currentVersion());
+  process.exit(0);
+}
+
+function updateHelp() {
+  console.log(`altalandi update — check for a newer version and update if you agree
+
+Usage:
+  altalandi update            check, then ask before updating the CLI and the /altalandi skill
+  altalandi update --check    only report; never change anything
+  altalandi update --yes      update without asking (for scripts that already have consent)
+
+Nothing changes without consent. Without a terminal to ask in (agents, CI,
+pipes) and without --yes, it only reports what is available.
+
+Exit codes: 0 up to date or updated · 10 an update is available but was not
+applied · 1 the check or the update failed.`);
+}
+
+if (!handled) {
+const opts = { domain: "general", register: "neutral", json: false, fast: false, diff: false, report: undefined };
+const positional = [];
+for (let i = 0; i < args.length; i++) {
+  const a = args[i];
+  if (a === "-h" || a === "--help") { help(); process.exit(0); }
+  else if (a === "--json") opts.json = true;
+  else if (a === "--fast") opts.fast = true;
+  else if (a === "--domain") opts.domain = args[++i];
+  else if (a === "--register") opts.register = args[++i];
+  else if (a === "--base-url") opts.baseUrl = args[++i];
+  else if (a === "--key") opts.key = args[++i];
+  else if (a === "--file") opts.file = args[++i];
+  else if (a === "--diff") opts.diff = true;
+  else if (a === "--report") opts.report = true;
+  else if (a === "--report-dir") { opts.report = true; opts.reportDir = args[++i]; }
+  else positional.push(a);
+}
+
+function help() {
+  console.log(`altalandi — native Icelandic from your terminal
+
+Usage:
+  altalandi login                       connect this computer to your account (once)
+  altalandi "text to refine"
+  altalandi --file draft.txt            read the text from a file (best for agents)
+  echo "text" | altalandi
+  altalandi --domain marketing --register warm "text"
+
+Commands:
+  altalandi login      open altalandi.is, sign in or sign up, approve; stores the key
+                       and installs the Claude Code skill (--no-skill, --no-browser)
+  altalandi whoami     show the account and balance behind the stored key
+  altalandi logout     forget the stored key on this computer
+  altalandi update     check for a newer version and update if you agree
+  altalandi --version  print the installed version
+
+Options:
+  --domain     general | marketing | data-analysis | childrens-fiction  (default general)
+  --register   formal | neutral | warm  (default neutral)
+  --fast       no polish, no nativeness score, no meaning gate — normally one writer call
+               (structured input can still add a structure-preserving retry)
+  --json       print the full JSON response
+  --diff       show the text before and after, and every change with its reason (stderr)
+  --report     also write a Markdown report (input, output, changes, reasons, verdict)
+               to ./altalandi-reports/  (or --report-dir <dir>; ALTALANDI_REPORT=1 turns it on)
+  --file       read the text from a UTF-8 file instead of an argument
+  --base-url   API base  (default $ALTALANDI_BASE_URL or https://altalandi.is/api)
+
+stdout = refined text; stderr = nativeness / meaning / warnings / diff.
+Without --fast, false/null meaning verification exits 3 after printing the response.`);
+}
+
+function readStdin() {
+  return new Promise((resolve) => {
+    if (process.stdin.isTTY) return resolve("");
+    let d = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (c) => (d += c));
+    process.stdin.on("end", () => resolve(d));
+  });
+}
+
+const stored = readCredentials();
+const baseUrl = (opts.baseUrl || process.env.ALTALANDI_BASE_URL || stored?.baseUrl || "https://altalandi.is/api").replace(/\/$/, "");
+const { key } = resolveKey({ flag: opts.key });
+
+if (opts.key) {
+  console.error("⚠ --key is deprecated because command arguments can leak through shell history/process listings; load ALTALANDI_API_KEY instead.");
+}
+
+let text = positional.join(" ").trim();
+if (opts.file) {
+  const { readFile } = await import("node:fs/promises");
+  try { text = (await readFile(opts.file, "utf8")).replace(/^/, "").trim(); }
+  catch (e) { console.error(`Could not read ${opts.file}: ${e.message}`); process.exit(2); }
+}
+if (!text) text = (await readStdin()).trim();
+if (!text) { console.error("No input. Pass text as an argument or pipe via stdin.  (altalandi --help)"); process.exit(2); }
+if (!key) { console.error("Not logged in. Run once:  npx altalandi login   (or set ALTALANDI_API_KEY)"); process.exit(2); }
+
+const requestOptions = {
+  apiKey: key,
+  baseUrl,
+  domain: opts.domain,
+  register: opts.register,
+};
+// --fast disables every optional quality/verification pass. The writer can
+// still retry once when it drops document structure, as documented in --help.
+// Name every switch explicitly so a future server-default change cannot make
+// this client silently slower.
+if (opts.fast) {
+  requestOptions.preserveMeaning = false;
+  requestOptions.scoreNativeness = false;
+  requestOptions.onlyImprove = false;
+  requestOptions.polishPass = false;
+  requestOptions.scoring = "none";
+}
+
+try {
+  // refine() owns a single 300-second AbortController deadline across fetch
+  // and response-body parsing, matching the hosted package API.
+  const data = await refine(text, requestOptions);
+  const verificationFailed = !opts.fast && data.meaningPreserved !== true;
+
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+    if (verificationFailed) {
+      console.error("Meaning verification did not pass; JSON was printed, exiting with status 3.");
+    }
+  } else {
+    process.stdout.write(data.output + "\n");
+    const q = data.quality || {};
+    const meta = [];
+    if (q.nativenessScore != null) meta.push(`nativeness ${q.nativenessScore}/100`);
+    if (data.meaningPreserved === false) meta.push("⚠ MEANING DRIFT — returned the original");
+    else if (data.meaningPreserved === true) meta.push("meaning preserved");
+    else if (opts.fast) meta.push("meaning check skipped (--fast)");
+    else meta.push("⚠ MEANING UNVERIFIED — review before use");
+    if (meta.length) console.error("· " + meta.join(" · "));
+    for (const warning of Array.isArray(data.warnings) ? data.warnings : []) {
+      console.error(`⚠ ${warning}`);
+    }
+    if (opts.diff || process.env.ALTALANDI_DIFF === "1") {
+      console.error("\n" + beforeAfterText(text, data, { color: Boolean(process.stderr.isTTY) && !process.env.NO_COLOR }));
+    } else {
+      for (const d of data.diffs || []) console.error(`  − ${d.before}\n  + ${d.after}  (${d.reason})`);
+    }
+  }
+
+  if (reportEnabled(opts.report)) {
+    try {
+      const path = await writeReport(text, data, { domain: opts.domain, register: opts.register }, opts.reportDir);
+      console.error(`Skýrsla: ${path}`);
+    } catch (e) {
+      console.error(`Could not write the report: ${e.message}`);
+    }
+  }
+
+  // stdout/JSON is intentionally written first so callers can inspect the
+  // server response, but guarded automation must not accept null/false as a
+  // verified success. --fast is the explicit opt-out from this contract.
+  if (verificationFailed) process.exitCode = 3;
+} catch (e) {
+  console.error("Request failed:", e.message);
+  if (e.status === 402) console.error("→ Add credit at https://altalandi.is/portal (automatic top-up is available there).");
+  if (e.status === 401) console.error("→ The key is invalid or revoked. Run:  npx altalandi login");
+  process.exit(e.status === 402 ? 4 : 1);
+}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "altalandi",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Native-sounding Icelandic from your terminal or AI agent: one-time login, a Claude Code skill, and meaning verification.",
   "type": "module",
   "main": "./client.mjs",
@@ -19,6 +19,7 @@
     "altalandi.mjs",
     "auth.mjs",
     "update.mjs",
+    "report.mjs",
     "skill/SKILL.md",
     "client.mjs",
     "client.d.ts",

package/report.mjs

@@ -0,0 +1,114 @@
+// Before/after for people: a terminal view and an optional Markdown report.
+//
+// The website shows each change inline; in a terminal or an editor the
+// before/after got lost. This module renders it the same way everywhere:
+//   beforeAfterText()  plain (or coloured) block for a terminal or a tool result
+//   reportMarkdown()   the report file: input, output, every change with its
+//                      reason, and the verdict
+//   writeReport()      writes it to ./altalandi-reports/ (or ALTALANDI_REPORT_DIR)
+//
+// Reports are opt-in (--report, or ALTALANDI_REPORT=1): they contain the text.
+
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+
+const VERDICT = {
+  rewritten: "Endurskrifað og merking staðfest",
+  refused: "Endurskrift hafnað: upprunalega textanum skilað óbreyttum",
+  unchanged: "Engin breyting þurfti",
+  unverified: "Merking ekki staðfest: farðu yfir áður en þú notar textann",
+};
+
+export function outcomeOf(data) {
+  if (data?.rejectionReason) return "refused";
+  if (data?.meaningPreserved === false) return "refused";
+  if (data?.rewriteAttempted === false) return "unchanged";
+  if (data?.meaningPreserved !== true) return "unverified";
+  return "rewritten";
+}
+
+export function reportEnabled(flag) {
+  if (flag !== undefined && flag !== null) return Boolean(flag);
+  return ["1", "true", "yes"].includes(String(process.env.ALTALANDI_REPORT || "").toLowerCase());
+}
+
+const paint = (on) => ({
+  red: (s) => (on ? `\x1b[31m${s}\x1b[0m` : s),
+  green: (s) => (on ? `\x1b[32m${s}\x1b[0m` : s),
+  dim: (s) => (on ? `\x1b[2m${s}\x1b[0m` : s),
+  bold: (s) => (on ? `\x1b[1m${s}\x1b[0m` : s),
+});
+
+/** A before/after block with the list of changes. `color` adds ANSI colours. */
+export function beforeAfterText(input, data, { color = false } = {}) {
+  const c = paint(color);
+  const diffs = Array.isArray(data?.diffs) ? data.diffs : [];
+  const rule = (label) => c.dim(`── ${label} ${"─".repeat(Math.max(4, 40 - label.length))}`);
+  const lines = [
+    rule("Fyrir"), String(input ?? ""), "",
+    rule("Eftir"), String(data?.output ?? ""), "",
+    rule(`Breytingar (${diffs.length})`),
+  ];
+  if (!diffs.length) lines.push(c.dim("Engar breytingar."));
+  diffs.forEach((d, i) => {
+    lines.push(`${i + 1}. ${c.red("− " + String(d.before ?? "").trim())}`);
+    lines.push(`   ${c.green("+ " + String(d.after ?? "").trim())}`);
+    if (d.reason) lines.push(`   ${c.dim("↳ " + String(d.reason))}`);
+  });
+  const q = data?.quality || {};
+  lines.push("", c.bold(VERDICT[outcomeOf(data)]) + (q.nativenessScore != null ? c.dim(` · innfæddni ${q.nativenessScore}/100`) : ""));
+  return lines.join("\n");
+}
+
+const fence = (s) => {
+  const text = String(s ?? "");
+  const ticks = text.includes("```") ? "````" : "```";
+  return `${ticks}text\n${text}\n${ticks}`;
+};
+const cell = (s) => String(s ?? "").replace(/\|/g, "\\|").replace(/\r?\n/g, " ").trim();
+
+export function reportMarkdown(input, data, options = {}) {
+  const q = data?.quality || {};
+  const diffs = Array.isArray(data?.diffs) ? data.diffs : [];
+  const warnings = Array.isArray(data?.warnings) ? data.warnings : [];
+  const tier = data?.billedTier || data?.tier || {};
+  const when = new Date().toISOString().replace("T", " ").slice(0, 19);
+  const out = [
+    `# Altalandi: ${data?.id || "yfirlestur"}`,
+    "",
+    `| | |`, `|---|---|`,
+    `| Tími | ${when} UTC |`,
+    `| Niðurstaða | ${VERDICT[outcomeOf(data)]} |`,
+    `| Frummál | ${data?.sourceLang || "?"} |`,
+    `| Tegund texta | ${options.domain || "general"} |`,
+    `| Málsnið | ${options.register || "neutral"} |`,
+    `| Innfæddni | ${q.nativenessScore ?? "n/a"}/100 |`,
+    `| Ritill | ${tier.writer || "standard"} / ${tier.scoring || "?"} |`,
+    `| Auðkenni | ${data?.id || "?"} |`,
+    "",
+    "## Fyrir", "", fence(input), "",
+    "## Eftir", "", fence(data?.output), "",
+    `## Breytingar (${diffs.length})`, "",
+  ];
+  if (diffs.length) {
+    out.push("| # | Fyrir | Eftir | Ástæða | Lag |", "|---|---|---|---|---|");
+    diffs.forEach((d, i) => out.push(`| ${i + 1} | ${cell(d.before)} | ${cell(d.after)} | ${cell(d.reason)} | ${cell(d.layer)} |`));
+  } else {
+    out.push("Engar breytingar.");
+  }
+  if (data?.rejectionReason) out.push("", "## Af hverju var endurskriftinni hafnað", "", cell(data.rejectionReason));
+  if (warnings.length) out.push("", "## Viðvaranir", "", ...warnings.map((w) => `- ${cell(w)}`));
+  if (data?.meaningNotes) out.push("", "## Athugun á merkingu", "", cell(data.meaningNotes));
+  return out.join("\n") + "\n";
+}
+
+/** Write the report; returns its path. */
+export async function writeReport(input, data, options = {}, dir) {
+  const base = resolve(dir || process.env.ALTALANDI_REPORT_DIR || join(process.cwd(), "altalandi-reports"));
+  await mkdir(base, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[-:]/g, "").replace("T", "-").slice(0, 15);
+  const id = String(data?.id || "yfirlestur").replace(/[^A-Za-z0-9_-]/g, "");
+  const path = join(base, `altalandi-${stamp}-${id}.md`);
+  await writeFile(path, reportMarkdown(input, data, options), "utf8");
+  return path;
+}

package/skill/SKILL.md

@@ -27,7 +27,7 @@ If a call prints `Not logged in` (exit code 2), connect the computer:
 2. Read its output as soon as it appears. It prints a link
    (`https://altalandi.is/tengja?kodi=XXXX-XXXX`) and a code, and opens the
    browser. Show the user the link and the code, and tell them to sign in or
-   create an account (new accounts get 500 kr. of trial credit) and click
+   create an account (every account gets 2,000 free words a day, and new accounts 500 kr. of trial credit) and click
    **Tengja**.
 3. Wait for the command to finish. `✓ Tengt sem <username>` means done. Then
    continue with the task.
@@ -76,13 +76,35 @@ For Icelandic input, one of three things happened. Tell them apart before using
 - `meaningPreserved: null` means unverified, not safe. For English input the
   translation still comes back; say it is unverified.
 - When the original comes back, say so. Don't claim Altalandi improved it.
-- Always show what changed (`diffs`: before, after, reason). Never silently replace
-  the user's text. Apply changes to files only after showing them, unless the user
-  asked for that directly.
+- Always show what changed. Never silently replace the user's text. Apply changes
+  to files only after showing them, unless the user asked for that directly.
+
+## 4. Show the before and after
+
+After every call, show the user this, in the chat, before anything else:
+
+```text
+Fyrir:  <the text you sent, or its first lines if long>
+Eftir:  <output>
+Breytingar:
+1. − <before>  → + <after>   (<reason>)
+...
+<the verdict: rewritten and verified / refused, original returned / no change needed / unverified>
+```
+
+For a long text, show the first few changes and say how many there were in all.
+For a quick look in a terminal, `--diff` prints the same block (coloured) on stderr.
+
+**Reports (optional).** When the user wants a record, add `--report` (or they set
+`ALTALANDI_REPORT=1`): the CLI writes `./altalandi-reports/altalandi-<time>-<id>.md`
+with the input, the output, every change with its reason and layer, warnings and
+the verdict. Tell the user the path it prints (`Skýrsla: …`). Reports contain the
+text, so don't write them unless asked or the setting is on. The MCP tool takes
+`report: true` for the same thing.
 - `quality.nativenessScore` is a hint, not a verdict. It has been confidently wrong
   in both directions; never use it to override a refusal.
 
-## 4. Good to know
+## 5. Good to know
 
 - Altalandi rewrites for natural Icelandic. If the user only wants spelling and
   grammar fixed and every other word left alone, tell them it may rephrase, and