altalandi-mcp 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "altalandi-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server exposing Altalandi (native-Icelandic refinement) as a tool for Claude Code and any MCP client.",
   "type": "module",
   "bin": {
@@ -11,6 +11,7 @@
     "key.mjs",
     "api-client.mjs",
     "format-response.mjs",
+    "report.mjs",
     "README.md",
     "LICENSE"
   ],

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/server.mjs

@@ -14,13 +14,14 @@ import { z } from "zod";
 import { requestRefine } from "./api-client.mjs";
 import { formatRefineResponse, outcomeOf } from "./format-response.mjs";
 import { resolveKey } from "./key.mjs";
+import { beforeAfterText, reportEnabled, writeReport } from "./report.mjs";
 
 const BASE = (process.env.ALTALANDI_BASE_URL || "https://altalandi.is/api").replace(/\/$/, "");
-const server = new McpServer({ name: "altalandi", version: "0.2.0" });
+const server = new McpServer({ name: "altalandi", version: "0.3.0" });
 
 server.tool(
   "refine_icelandic",
-  "Rewrite English or stiff/AI-translated Icelandic into native-sounding Icelandic, with a meaning-preservation check. Use whenever you need Icelandic that must read like a native wrote it (marketing copy, UI strings, prose). Returns the refined text, a 0-100 nativeness score, an explicit meaning verdict, and every API warning. Only 'meaning preserved' is verified; 'MEANING UNVERIFIED' requires review. On drift it returns the original unchanged.",
+  "Rewrite English or stiff/AI-translated Icelandic into native-sounding Icelandic, with a meaning-preservation check. Use whenever you need Icelandic that must read like a native wrote it (marketing copy, UI strings, prose). Returns the refined text, a 0-100 nativeness score, an explicit meaning verdict, and every API warning. Only 'meaning preserved' is verified; 'MEANING UNVERIFIED' requires review. On drift it returns the original unchanged. After every call, show the user the before/after block from the result (Fyrir / Eftir) and the numbered list of changes with their reasons, then mention the report path if one was written. Never replace the user's text silently.",
   {
     text: z.string().describe("Text to refine (English or Icelandic)."),
     domain: z.enum(["general", "marketing", "data-analysis", "childrens-fiction"]).optional()
@@ -28,8 +29,10 @@ server.tool(
     register: z.enum(["formal", "neutral", "warm"]).optional().describe("Tone. Default neutral."),
     sourceLang: z.enum(["auto", "en", "is"]).optional()
       .describe("Source-language hint. Default auto."),
+    report: z.boolean().optional()
+      .describe("Also write a Markdown report (input, output, every change with its reason, verdict) to ./altalandi-reports/. Default: on when ALTALANDI_REPORT=1."),
   },
-  async ({ text, domain, register, sourceLang }) => {
+  async ({ text, domain, register, sourceLang, report }) => {
     // Resolved per call, so a login made after the server started is picked up.
     const { key: KEY } = resolveKey();
     if (!KEY) {
@@ -47,8 +50,16 @@ server.tool(
       if (!response.ok) {
         return { content: [{ type: "text", text: `Altalandi error ${response.status}: ${data.detail || response.statusText}` }], isError: true };
       }
+      let reportLine = "";
+      if (reportEnabled(report)) {
+        try {
+          reportLine = `\n\nReport: ${await writeReport(text, data, { domain, register })}`;
+        } catch (e) {
+          reportLine = `\n\nReport could not be written: ${e.message}`;
+        }
+      }
       return {
-        content: [{ type: "text", text: formatRefineResponse(data) }],
+        content: [{ type: "text", text: `${formatRefineResponse(data)}\n\n${beforeAfterText(text, data)}${reportLine}` }],
         // MCP callers should not treat a refused rewrite (drift, a lost
         // invariant, or a candidate veto) or an unverified response as a
         // successfully refined artifact. "No rewrite needed" is a success. The