altalandi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Altalandi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# altalandi
+
+Turn English or stiff/AI-translated Icelandic into Icelandic that reads as if a
+native wrote it — from your terminal. Thin client over the
+[Altalandi API](https://altalandi.is). Zero dependencies (Node ≥ 18).
+
+```bash
+export ALTALANDI_API_KEY="rtv_..."     # mint one at https://altalandi.is/portal
+npx altalandi "Make sure to reach out to us today."
+#  → Hafðu samband við okkur í dag.
+```
+
+`stdout` is the refined text (pipe it anywhere); `stderr` carries the 0–100
+nativeness score, the meaning verdict, and the diff.
+
+## Install
+
+```bash
+npm i -g altalandi      # then use `altalandi ...`
+# or run without installing:  npx altalandi "..."
+```
+
+## Usage
+
+```bash
+altalandi "Some English or Icelandic text."
+echo "some text" | altalandi --domain marketing
+altalandi --json "..."                 # full JSON response
+altalandi --fast "..."                 # skip the meaning + nativeness gates
+```
+
+| flag | default | meaning |
+|------|---------|---------|
+| `--domain` | `general` | `general` \| `marketing` \| `data-analysis` \| `childrens-fiction` |
+| `--register` | `neutral` | `formal` \| `neutral` \| `warm` |
+| `--json` | off | print the full API response |
+| `--fast` | off | `preserveMeaning:false`, `scoreNativeness:false` (one model call) |
+
+## The meaning guarantee
+
+Altalandi never silently changes meaning. For Icelandic input where the rewrite
+can't be verified to preserve meaning, it returns the **original unchanged** and
+says so on `stderr` (or `meaningPreserved:false` with `--json`). Check it before
+trusting the output in an automated pipeline.
+
+## Config
+
+| env | default | purpose |
+|-----|---------|---------|
+| `ALTALANDI_API_KEY` | — | your key (Bearer). Mint at https://altalandi.is/portal |
+| `ALTALANDI_BASE_URL` | `https://altalandi.is/api` | API base (override for self-hosting) |
+
+MIT licensed. The hosted API is metered per key (calls + words/day).

package/altalandi.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+// altalandi — turn English or stiff/AI Icelandic into native Icelandic from
+// your terminal. Zero dependencies (Node >= 18 has global fetch).
+//
+//   export ALTALANDI_API_KEY=...        # get one at https://altalandi.is
+//   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, and the diff.
+
+const args = process.argv.slice(2);
+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 positional.push(a);
+}
+
+function help() {
+  console.log(`altalandi — native Icelandic from your terminal
+
+Usage:
+  altalandi "text to refine"
+  echo "text" | altalandi
+  altalandi --domain marketing --register warm "text"
+
+Options:
+  --domain     general | marketing | data-analysis | childrens-fiction  (default general)
+  --register   formal | neutral | warm  (default neutral)
+  --fast       skip the meaning gate + nativeness score (faster, cheaper)
+  --json       print the full JSON response
+  --base-url   API base  (default $ALTALANDI_BASE_URL or https://altalandi.is/api)
+  --key        API key   (default $ALTALANDI_API_KEY)
+
+stdout = refined text; stderr = nativeness / meaning / diff.`);
+}
+
+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 baseUrl = (opts.baseUrl || process.env.ALTALANDI_BASE_URL || "https://altalandi.is/api").replace(/\/$/, "");
+const key = opts.key || process.env.ALTALANDI_API_KEY || process.env.ALTALANDI_KEY;
+
+const text = (positional.join(" ").trim()) || (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("No API key. Set ALTALANDI_API_KEY or pass --key.  Get one at https://altalandi.is"); process.exit(2); }
+
+const body = { text, domain: opts.domain, register: opts.register };
+if (opts.fast) { body.preserveMeaning = false; body.scoreNativeness = false; }
+
+try {
+  const res = await fetch(`${baseUrl}/v1/refine`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${key}` },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json().catch(() => ({}));
+  if (!res.ok) { console.error(`Error ${res.status}: ${data.detail || res.statusText}`); process.exit(1); }
+  if (opts.json) { process.stdout.write(JSON.stringify(data, null, 2) + "\n"); process.exit(0); }
+
+  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");
+  if (meta.length) console.error("· " + meta.join(" · "));
+  for (const d of data.diffs || []) console.error(`  − ${d.before}\n  + ${d.after}  (${d.reason})`);
+} catch (e) {
+  console.error("Request failed:", e.message);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "altalandi",
+  "version": "0.1.0",
+  "description": "Turn English or stiff/AI-translated Icelandic into native-sounding Icelandic from your terminal — via the Altalandi API, with a meaning-preservation check.",
+  "type": "module",
+  "bin": { "altalandi": "./altalandi.mjs" },
+  "files": ["altalandi.mjs", "README.md", "LICENSE"],
+  "keywords": [
+    "icelandic", "íslenska", "translation", "translationese", "nlp",
+    "altalandi", "cli", "i18n", "localization", "language"
+  ],
+  "homepage": "https://altalandi.is",
+  "repository": { "type": "git", "url": "git+https://github.com/pbidhjorvar/ritvit.git", "directory": "tools/cli" },
+  "bugs": { "url": "https://github.com/pbidhjorvar/ritvit/issues" },
+  "engines": { "node": ">=18" },
+  "license": "MIT"
+}