@listen-fire/handbook 0.12.0-rc.5 → 0.12.0-rc.7

package/dist/chapters/foundations.js

@@ -23,20 +23,32 @@ something reads like a special case, look for the position and the edge.
 
 ### language-versions
 
-Read the two-word name on an automation — "Quiet Heron", "Bright Otter", the current "Dancing Wren" — as
-the version of this language its text is written in. The automation validates,
-saves and runs as that version, and an edit never changes it; a new automation
-is written in the current version. So check an edit to an existing automation
-as the version it is written in, not as the current one.
-
-A warning on an automation says something keeps it on an older version: the
-current version reports errors for its text, or marks a construct whose meaning
-differs between the two versions, which blocks the move as surely as an error.
+An automation is pinned to the language release its text was written against,
+a version such as \`0.12.0\`. The automation validates, saves and runs under that
+pin, and an edit never changes it; a new automation is pinned to the current
+release. So check an edit to an existing automation under the release it is
+pinned to, not the current one.
+
+A release reads a pin that has its own compatibility key (the minor while the
+version starts with 0, so \`0.12.0\` and \`0.12.3\` read alike; the major from 1.0)
+and refuses any other by name:
+
+- a pin newer than the engine is refused; upgrade the engine
+- a pin of an older key is refused; validate the text under the current release,
+  then upgrade it
+
+An \`lf\` project pins in \`lf.yaml\`'s \`engine:\` (\`lf init\` writes the current
+release; \`lf upgrade\` moves it). An embedder pins with the run input's
+\`languageVersion\`; absent means the engine's own release.
+
+A warning on an automation says something keeps it on an older release: the
+current release reports errors for its text, or marks a construct whose meaning
+differs between the two releases, which blocks the move as surely as an error.
 Other warnings, such as cost notes, never block. The automation keeps running as
 it always has.
 
-To upgrade one, repair what the current version reports — in text that still
-validates as the older version — then upgrade it: the check runs again, shows
+To upgrade one, repair what the current release reports — in text that still
+validates under the older pin — then upgrade it: the check runs again, shows
 what it finds, and moves the automation only when that is clean and the move is
 confirmed. Only an upgrade someone requests moves an automation; a new release
 never does.

package/dist/language_search.js

@@ -110,7 +110,7 @@ function spelling(entry) {
 const CORE_SPELLING = { EXTRACT: 'extract', EXTRACTONE: 'extractOne' };
 /** `Text.join` for `JOIN` — the name an author writes. */
 function builtinName(entry) {
-    return spelling(entry)?.v5 ?? CORE_SPELLING[entry.name] ?? entry.name;
+    return spelling(entry)?.current ?? CORE_SPELLING[entry.name] ?? entry.name;
 }
 const settingsParam = (keys) => ({ name: `settings { ${keys} }`, type: 'options', optional: true });
 /** The registry's parameters in the order the author writes them. */
@@ -133,7 +133,7 @@ function writtenParams(entry) {
 }
 /** A summary names built-ins as the author writes them. */
 function builtinSummary(entry) {
-    return (0, surface_1.spellMessage)(entry.summary, movement_lang_1.CURRENT_LANGUAGE_VERSION);
+    return (0, surface_1.spellMessage)(entry.summary);
 }
 /** `Text.join(collection: any, separator?: text) → text` — generated, never written. */
 function builtinSignature(entry) {

package/dist/prose_rules.js

@@ -62,7 +62,7 @@ const NOT_RECOMMENDED = [
         label: 'a `movement` declaration — declare with `function`',
     },
     { pattern: /\bONLY\(\s*extract\(/i, label: '`only(extract(…))` — write `extractOne(…)`' },
-    // Language version 5's surface: the spellings it replaced, outside walk brackets.
+    // The current surface: the spellings it replaced, outside walk brackets.
     { pattern: /\bERROR\(/, label: '`ERROR(…)` — write `fail(…)`' },
     { pattern: /\(credentials:/, label: 'an adapter construction — write `connect attio using acme`' },
     { pattern: /\bIF\b[^\n]*\bTHEN\b/, label: '`IF … THEN … ELSE … END` — write `c ? a : b`' },

package/dist/testing.js

@@ -116,10 +116,10 @@ function admitProbe(claim, catalog = exports.HANDBOOK_CATALOG) {
         catalog: files
             ? { ...catalog, files: Object.fromEntries(Object.entries(files).map(([path, source]) => [path, { source }])) }
             : catalog,
-        languageVersion: movement_lang_1.CURRENT_LANGUAGE_VERSION,
+        languageVersion: movement_lang_1.LANGUAGE_VERSION,
     });
 }
 /** Only the parse the engine performs first: MOVENG_PARSE when it refuses. */
 function parseProbe(claim) {
-    movement_engine_1.programCheck.parsePinned({ source: claim.probe, languageVersion: movement_lang_1.CURRENT_LANGUAGE_VERSION });
+    movement_engine_1.programCheck.parsePinned({ source: claim.probe, languageVersion: movement_lang_1.LANGUAGE_VERSION });
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@listen-fire/handbook",
   "license": "Apache-2.0",
-  "version": "0.12.0-rc.5",
+  "version": "0.12.0-rc.7",
   "description": "The movement language's handbook: the hand-written chapters, the front page, the routes into them and the language search over them. A host adds its own systems' and plugins' sections on top (the platform assembles system:* and plugin:* chapters). `testing` is the catalog every shown example is checked against, for a host's tests of its own sections.",
   "engines": {
     "node": "22.20.0"
@@ -21,9 +21,9 @@
   },
   "type": "commonjs",
   "dependencies": {
-    "@listen-fire/engine": "^0.12.0-rc.5",
-    "@listen-fire/engine-contracts": "^0.12.0-rc.5",
-    "@listen-fire/movement-lang": "^0.12.0-rc.5"
+    "@listen-fire/engine": "^0.12.0-rc.7",
+    "@listen-fire/movement-lang": "^0.12.0-rc.7",
+    "@listen-fire/engine-contracts": "^0.12.0-rc.7"
   },
   "devDependencies": {
     "@types/jest": "29.5.14",