altalandi 0.6.1 → 0.6.3

package/skill/SKILL.md

@@ -14,7 +14,7 @@ description: >-
 
 Altalandi rewrites English or stiff Icelandic so it reads as if a native wrote
 it, checks that the meaning held, and lists every change with its reason. Each
-call is paid from the user's free daily units or their credit.
+call is paid from the user's free daily characters or their credit.
 
 **Follow this procedure exactly, every time.** The user must always see the same
 thing: the verdict, the text before and after, each change with its reason, what
@@ -27,7 +27,7 @@ yourself or summarise the result in your own words.
   line, below. It waits up to 5 minutes per call and handles long texts.
 - **No shell, only the Altalandi tools** (`refine_icelandic`,
   `proofread_icelandic`, `get_refinement_status`, for example in claude.ai or
-  ChatGPT): use the tools, and follow "Long texts through the tools" below. The
+  ChatGPT): use the tools, and follow "Long texts in parts" below. The
   tools cannot wait as long as the command line, so long texts go in parts.
 
 How long a call takes: a few seconds for a sentence, 10–30 seconds for a
@@ -52,7 +52,7 @@ a check is rewritten once more, which can double that.
 3. **Paste its stdout into your reply exactly as printed**, as the first thing in
    your reply. It is Markdown: a verdict line, **Fyrir**, **Eftir**,
    **Breytingar** (each change and its reason), **Kostnaður** (cost of this call,
-   balance and free units left) and **Verkið**, the run's own page. Do not
+   balance and free characters left) and **Verkið**, the run's own page. Do not
    shorten, reorder, translate or reword it. The run page shows the user the
    text sent, the result and the checks, and lets them approve, reject or edit
    the result there; point them to it when they want to review the work.
@@ -70,24 +70,33 @@ a check is rewritten once more, which can double that.
    of your own.
 
 A document of several sections (more than about 3,000 characters) goes better
-through the folder run below: it sends each passage separately, two at a time,
+through the folder run below: it refines and checks each passage on its own,
 and a passage that fails keeps its original without holding up the rest. Save
 the text as a `.md` file in an empty temporary folder and run the folder steps.
+To send it in parts instead, follow "Long texts in parts".
 
-## Long texts through the tools
+## Long texts in parts
 
 1. **Split the text into parts** at paragraph breaks, never inside a sentence:
    at most **1,000 characters** a part for English, **1,500** for Icelandic.
    Keep a heading with the paragraph under it. A list or a table stays in one
    part when it fits.
-2. **Call the tool once per part,** at most 3 at a time, in order. Give every
-   part its own new `operationId` (a fresh UUID). Keep a note of which ID
+2. **Command line: make one job id** for the whole text: `j_`, today's date
+   (yyyymmdd) and 6 random letters or digits, e.g. `j_20261013k4x9qa`. Run the
+   procedure once per part, in order, each with its own in and out files, and
+   add `--job <id> --part "Hluti N af M"` every time; on the first part add
+   `--job-title "<short name of the document>"` too. All parts are then one
+   verk on the site.
+3. **Tools: call the tool once per part,** at most 3 at a time, in order. Give
+   every part its own new `operationId` (a fresh UUID). Keep a note of which ID
    belongs to which part.
-3. **Join the results in the original order** and give the user the whole text,
-   then each part's verdict and changes, as the tool returns them.
-4. **A part that is refused or unverified keeps its original text.** Say which
+4. **Join the results in the original order** and give the user the whole text,
+   then each part's verdict and changes, as the command or the tool returns
+   them. With a job, end with its link once: `Verkið: <link>`, as the blocks
+   print it.
+5. **A part that is refused or unverified keeps its original text.** Say which
    part, and why (the tool says why). Never rewrite it yourself.
-5. **Terms must match across parts.** If two parts translate the same term
+6. **Terms must match across parts.** If two parts translate the same term
    differently, point it out and ask which to keep; do not quietly change one.
 
 ## If a call times out
@@ -120,10 +129,15 @@ charged at https://altalandi.is/stjornbord/notkun. With the tools:
 - **Never hand-edit the Icelandic and present it as Altalandi's.** If you think
   something should still change, say so separately under a heading such as
   "Mín tillaga (ekki yfirfarin af Altalandi)", or ask before running it again.
-- **One call per coherent text** (a page section, an email, one UI string). For
-  a few strings, run them one by one, at most 4 at a time, and paste each block.
-  Keep keys, placeholders (`{name}`, `%s`), HTML and code out of the text you send.
-  For a whole folder, i18n catalog or website, use the folder run below instead.
+- **One call per coherent text** (a page section, an email). Keep keys,
+  placeholders (`{name}`, `%s`), HTML and code out of the text you send. For a
+  whole folder, i18n catalog or website, use the folder run below instead.
+- **Many short strings** (UI strings, an i18n catalog, a list of labels or
+  messages): **never call Altalandi once per string.** Put them in a JSON file
+  (`{"key": "English text", …}`) in an empty temporary folder, or use the
+  project's existing catalog folder, and run the folder run below on that folder
+  (`--dry-run` first). It sends short strings together in batches, which is
+  cheaper and faster, and still checks each string on its own.
 - **Product names and coined words** the meaning check cannot recognise can make
   it refuse a rewrite (exit 3, "ekki tókst að staðfesta"). That is the safe
   result: keep the original and tell the user.
@@ -132,11 +146,13 @@ charged at https://altalandi.is/stjornbord/notkun. With the tools:
   writes `./altalandi-reports/altalandi-<time>-<id>.md`, and the block shows
   its path. Reports contain the text, so write them only when asked.
 - **Don't use `--fast`** for text people will read: it skips the meaning check.
+- **Cost is in characters and krónur,** as the block and the estimate show it.
+  Never work out or quote a price per 100 characters.
 - If the user only wants spelling fixed and every other word kept, use the
   `proofread_icelandic` tool where it is available. The command line rewrites:
   tell the user it may rephrase, and go through the changes with them.
 - Every call from a signed-in account is kept in that account's history for
-  90 days, so the run page can show it; only the account and its team see it,
+  as long as they keep it, so the run page can show it; only the account and its team see it,
   and it can be deleted on the page or switched off in Settings. Separately,
   free use is kept, with personal data scrubbed, to improve the service; paid
   use only with consent. Add `--no-store` when the user asks that their text
@@ -152,7 +168,7 @@ check passed.
 
 1. **Estimate first:** `npx -y altalandi@latest <folder or URL> --dry-run` (add
    `--site` for a whole site). Show the user the estimate it prints: files,
-   passages, characters, units and the price if paid from credit.
+   passages, the characters billed and the price if paid from credit.
 2. **Only when the user agrees,** run the same command with `--yes` in place of
    `--dry-run`, with the shell timeout set to 10 minutes or in the background.
    The result goes to `<folder>-is` unless they name a place (`--out <path>`).
@@ -169,12 +185,12 @@ Only when a call exits with 2 (`Not logged in`):
    minutes.
 2. As soon as it prints a link (`https://altalandi.is/tengja?kodi=XXXX-XXXX`) and
    a code, show both to the user. Tell them to sign in or create an account
-   (2,000 free units a day, and 500 kr. of trial credit once they confirm their email) and
+   (a free daily allowance of characters, and 500 kr. of trial credit once they confirm their email) and
    click **Tengja**.
 3. When it prints `✓ Tengt sem <username>`, run step 2 of the procedure again.
 
 Never ask the user for an API key, and do not tell them to set
 `ALTALANDI_API_KEY`. `npx -y altalandi@latest whoami` shows the account, the
-balance and the free units at any time.
+balance and the free characters left today at any time.
 
 Docs for building the API into an app: https://altalandi.is/agents.md

package/update.mjs

@@ -140,6 +140,9 @@ export const SHIPPED_SKILLS = new Set([
   "f7de208557f519a4", // 0.4.0
   "4bd64565d251641e", // 0.5.0
   "aeb88010599539fd", // 0.6.0
+  "ebfc4ef17a614973", // 0.6.1
+  "9def55ecc6b30785", // 0.6.2
+  "2168eaa25a5c561c", // after 0.6.2 (3c73702: stafir and krónur)
 ]);
 
 export function skillFingerprint(text) {