@bitmagic/cli 0.1.53-dev.3 → 0.1.53-dev.5

package/dist/render/qr.js

@@ -0,0 +1,516 @@
+/**
+ * A QR encoder, so `bitmagic publish` can hand the creator's phone the URL it just printed.
+ *
+ * The Creator does this server-side already — `PublishController.generateQRCode` calls the `qrcode`
+ * package and the publish dialog shows the PNG. The CLI cannot follow it there: `qrcode` drags in
+ * `dijkstrajs`, `pngjs` and `yargs@15`, and `@bitmagic/cli` is a published package with four
+ * deliberately-chosen runtime dependencies. So the encoder lives here instead, cut down to exactly
+ * what a published-game URL needs:
+ *
+ *   - **Byte mode only.** A URL is bytes. Numeric, alphanumeric and kanji modes would encode it
+ *     smaller in theory and never in practice, because `https://` alone rules out alphanumeric.
+ *   - **Error correction level M only**, matching the Creator's `errorCorrectionLevel: 'M'` — a code
+ *     scanned from this terminal and one scanned from the publish dialog then behave identically.
+ *   - **Versions 1-9 only.** The character-count indicator is 8 bits up to version 9 and 16 bits
+ *     from version 10, so stopping here removes a branch and four tables. Version 9 holds 180 bytes;
+ *     the longest URL this ever sees is the dev portal's, around 60. Anything longer returns null
+ *     rather than growing the tables — see `encodeQr`.
+ *
+ * Structure follows ISO/IEC 18004. Every table below is a literal with the spec's own name for it,
+ * and `__tests__/qr.test.ts` checks each one against fixtures generated by the `qrcode` package, so
+ * a transposed digit fails loudly instead of producing a code that scans as garbage.
+ */
+import { Buffer } from 'buffer';
+/** The largest symbol version this encoder builds. Above it the count indicator widens to 16 bits. */
+const MAX_VERSION = 9;
+/** Byte mode's 4-bit mode indicator (ISO/IEC 18004 table 2). */
+const MODE_BYTE = 0b0100;
+/** The two padding codewords, applied alternately to fill the data capacity (11.2.1). */
+const PAD_CODEWORDS = [0xec, 0x11];
+const BLOCKS_M = [
+    { ecPerBlock: 10, group1Blocks: 1, group1Data: 16, group2Blocks: 0, group2Data: 0 }, // v1  =  26
+    { ecPerBlock: 16, group1Blocks: 1, group1Data: 28, group2Blocks: 0, group2Data: 0 }, // v2  =  44
+    { ecPerBlock: 26, group1Blocks: 1, group1Data: 44, group2Blocks: 0, group2Data: 0 }, // v3  =  70
+    { ecPerBlock: 18, group1Blocks: 2, group1Data: 32, group2Blocks: 0, group2Data: 0 }, // v4  = 100
+    { ecPerBlock: 24, group1Blocks: 2, group1Data: 43, group2Blocks: 0, group2Data: 0 }, // v5  = 134
+    { ecPerBlock: 16, group1Blocks: 4, group1Data: 27, group2Blocks: 0, group2Data: 0 }, // v6  = 172
+    { ecPerBlock: 18, group1Blocks: 4, group1Data: 31, group2Blocks: 0, group2Data: 0 }, // v7  = 196
+    { ecPerBlock: 22, group1Blocks: 2, group1Data: 38, group2Blocks: 2, group2Data: 39 }, // v8 = 242
+    { ecPerBlock: 22, group1Blocks: 3, group1Data: 36, group2Blocks: 2, group2Data: 37 }, // v9 = 292
+];
+/**
+ * Alignment-pattern centre coordinates per version (ISO/IEC 18004 annex E).
+ *
+ * A pattern is drawn at every pairing of these coordinates except where it would collide with a
+ * finder — `drawAlignmentPatterns` skips those by checking whether the module is already set.
+ */
+const ALIGNMENT_POSITIONS = [
+    [], // v1 has none
+    [6, 18],
+    [6, 22],
+    [6, 26],
+    [6, 30],
+    [6, 34],
+    [6, 22, 38],
+    [6, 24, 42],
+    [6, 26, 46],
+];
+/**
+ * The 15-bit format-information strings for level M and mask 0-7 (ISO/IEC 18004 table C.1).
+ *
+ * Already BCH(15,5)-encoded and XORed with the 0b101010000010010 mask the spec applies, so nothing
+ * here has to be computed. Level M is the only row we need, which is why this is a flat array.
+ */
+const FORMAT_INFO_M = [0x5412, 0x5125, 0x5e7c, 0x5b4b, 0x45f9, 0x40ce, 0x4f97, 0x4aa0];
+/**
+ * The 18-bit version-information strings, which only versions 7 and up carry (table D.1).
+ *
+ * Indexed by version, so entries 1-6 are zero and never read.
+ */
+const VERSION_INFO = { 7: 0x07c94, 8: 0x085bc, 9: 0x09a99 };
+/** Penalty weights for the four mask-evaluation rules (ISO/IEC 18004 table 24). */
+const PENALTY_N1 = 3;
+const PENALTY_N2 = 3;
+const PENALTY_N3 = 40;
+const PENALTY_N4 = 10;
+/**
+ * The eight data-mask patterns (table 23). True means "invert this module".
+ *
+ * `row`/`col` are the spec's i/j. These apply to encoding-region modules only; function patterns
+ * are written before masking and are never touched, which `placeData` enforces by only filling
+ * modules still left null.
+ */
+const MASK_FUNCTIONS = [
+    (row, col) => (row + col) % 2 === 0,
+    (row) => row % 2 === 0,
+    (_row, col) => col % 3 === 0,
+    (row, col) => (row + col) % 3 === 0,
+    (row, col) => (Math.floor(row / 2) + Math.floor(col / 3)) % 2 === 0,
+    (row, col) => ((row * col) % 2) + ((row * col) % 3) === 0,
+    (row, col) => (((row * col) % 2) + ((row * col) % 3)) % 2 === 0,
+    (row, col) => (((row + col) % 2) + ((row * col) % 3)) % 2 === 0,
+];
+// ---------------------------------------------------------------------------------------------
+// GF(256) arithmetic, for Reed-Solomon
+// ---------------------------------------------------------------------------------------------
+/**
+ * Exponent and log tables over GF(256) with primitive polynomial 0x11d and generator 2 (annex B).
+ *
+ * The exponent table runs to 512 entries — a doubled copy — so `gfMul` can add two logs (each up to
+ * 254) and index straight in without a modulo.
+ */
+function buildGaloisTables() {
+    const exp = new Uint8Array(512);
+    const log = new Uint8Array(256);
+    let value = 1;
+    for (let i = 0; i < 255; i += 1) {
+        exp[i] = value;
+        log[value] = i;
+        value <<= 1;
+        if ((value & 0x100) !== 0)
+            value ^= 0x11d;
+    }
+    for (let i = 255; i < 512; i += 1)
+        exp[i] = exp[i - 255];
+    return { exp, log };
+}
+const { exp: GF_EXP, log: GF_LOG } = buildGaloisTables();
+function gfMultiply(a, b) {
+    if (a === 0 || b === 0)
+        return 0;
+    return GF_EXP[GF_LOG[a] + GF_LOG[b]];
+}
+/**
+ * The generator polynomial of the given degree, in descending coefficient order.
+ *
+ * Built as the product of (x - a^0)(x - a^1)...; subtraction is XOR in GF(2), so the sign vanishes.
+ */
+function generatorPolynomial(degree) {
+    let poly = Uint8Array.from([1]);
+    for (let d = 0; d < degree; d += 1) {
+        const next = new Uint8Array(poly.length + 1);
+        for (let i = 0; i < poly.length; i += 1) {
+            next[i] ^= poly[i];
+            next[i + 1] ^= gfMultiply(poly[i], GF_EXP[d]);
+        }
+        poly = next;
+    }
+    return poly;
+}
+/** The `ecLength` error-correction codewords for one block of data codewords. */
+function reedSolomon(data, ecLength) {
+    const generator = generatorPolynomial(ecLength);
+    // Long division of `data` shifted up by ecLength places; the remainder is the ECC.
+    const remainder = new Uint8Array(data.length + ecLength);
+    remainder.set(data);
+    for (let i = 0; i < data.length; i += 1) {
+        const factor = remainder[i];
+        if (factor === 0)
+            continue;
+        for (let j = 0; j < generator.length; j += 1) {
+            remainder[i + j] ^= gfMultiply(generator[j], factor);
+        }
+    }
+    return remainder.slice(data.length);
+}
+// ---------------------------------------------------------------------------------------------
+// Codewords
+// ---------------------------------------------------------------------------------------------
+function totalDataCodewords(spec) {
+    return spec.group1Blocks * spec.group1Data + spec.group2Blocks * spec.group2Data;
+}
+/**
+ * How many bytes fit at this version, in byte mode at level M.
+ *
+ * The header costs 12 bits — 4 for the mode indicator plus 8 for the count — so the payload gets
+ * the data capacity less one and a half codewords, rounded down.
+ */
+function byteCapacity(version) {
+    return Math.floor((totalDataCodewords(BLOCKS_M[version - 1]) * 8 - 12) / 8);
+}
+/** The smallest version that holds `byteLength` bytes, or null when even version 9 does not. */
+function smallestVersion(byteLength) {
+    for (let version = 1; version <= MAX_VERSION; version += 1) {
+        if (byteLength <= byteCapacity(version))
+            return version;
+    }
+    return null;
+}
+/**
+ * The final codeword sequence: header, payload, padding, ECC, interleaved as the spec requires.
+ *
+ * Interleaving (8.6) is what makes a burst of damage survivable — consecutive codewords in the
+ * symbol come from different blocks, so a smudge spreads its errors across every block's budget
+ * instead of exhausting one.
+ */
+function buildCodewords(payload, version) {
+    const spec = BLOCKS_M[version - 1];
+    const dataCodewordCount = totalDataCodewords(spec);
+    const capacityBits = dataCodewordCount * 8;
+    const bits = [];
+    const pushBits = (value, length) => {
+        for (let i = length - 1; i >= 0; i -= 1)
+            bits.push((value >>> i) & 1);
+    };
+    pushBits(MODE_BYTE, 4);
+    pushBits(payload.length, 8);
+    for (const byte of payload)
+        pushBits(byte, 8);
+    // Terminator: up to four zero bits, truncated if the capacity ends first (11.1).
+    for (let i = 0; i < 4 && bits.length < capacityBits; i += 1)
+        bits.push(0);
+    while (bits.length % 8 !== 0)
+        bits.push(0);
+    const data = new Uint8Array(dataCodewordCount);
+    for (let i = 0; i < bits.length; i += 1) {
+        if (bits[i] === 1)
+            data[i >> 3] |= 0x80 >> (i & 7);
+    }
+    for (let i = bits.length / 8, pad = 0; i < dataCodewordCount; i += 1, pad += 1) {
+        data[i] = PAD_CODEWORDS[pad % 2];
+    }
+    const blocks = [];
+    let offset = 0;
+    const groups = [
+        [spec.group1Blocks, spec.group1Data],
+        [spec.group2Blocks, spec.group2Data],
+    ];
+    for (const [count, size] of groups) {
+        for (let b = 0; b < count; b += 1) {
+            const chunk = data.slice(offset, offset + size);
+            offset += size;
+            blocks.push({ data: chunk, ec: reedSolomon(chunk, spec.ecPerBlock) });
+        }
+    }
+    const out = [];
+    const longestBlock = Math.max(spec.group1Data, spec.group2Data);
+    for (let i = 0; i < longestBlock; i += 1) {
+        for (const block of blocks) {
+            if (i < block.data.length)
+                out.push(block.data[i]);
+        }
+    }
+    for (let i = 0; i < spec.ecPerBlock; i += 1) {
+        for (const block of blocks)
+            out.push(block.ec[i]);
+    }
+    return Uint8Array.from(out);
+}
+function moduleCount(version) {
+    return version * 4 + 17;
+}
+/**
+ * One finder pattern with its separator, anchored at the given top-left module.
+ *
+ * The loop runs from -1 to 7 rather than 0 to 6 so the one-module separator is written in the same
+ * pass, as false. Out-of-range coordinates are skipped, which is what keeps the three call sites
+ * identical despite each finder having its separator on different sides.
+ */
+function drawFinderPattern(grid, row, col) {
+    const size = grid.length;
+    for (let r = -1; r <= 7; r += 1) {
+        if (row + r < 0 || row + r >= size)
+            continue;
+        for (let c = -1; c <= 7; c += 1) {
+            if (col + c < 0 || col + c >= size)
+                continue;
+            const onOuterRing = (r >= 0 && r <= 6 && (c === 0 || c === 6))
+                || (c >= 0 && c <= 6 && (r === 0 || r === 6));
+            const inCore = r >= 2 && r <= 4 && c >= 2 && c <= 4;
+            grid[row + r][col + c] = onOuterRing || inCore;
+        }
+    }
+}
+function drawTimingPatterns(grid) {
+    const size = grid.length;
+    for (let i = 8; i < size - 8; i += 1) {
+        if (grid[i][6] === null)
+            grid[i][6] = i % 2 === 0;
+        if (grid[6][i] === null)
+            grid[6][i] = i % 2 === 0;
+    }
+}
+function drawAlignmentPatterns(grid, version) {
+    const positions = ALIGNMENT_POSITIONS[version - 1];
+    for (const row of positions) {
+        for (const col of positions) {
+            // Already written means a finder owns this corner; the spec omits the pattern there.
+            if (grid[row][col] !== null)
+                continue;
+            for (let r = -2; r <= 2; r += 1) {
+                for (let c = -2; c <= 2; c += 1) {
+                    grid[row + r][col + c] = r === -2 || r === 2 || c === -2 || c === 2 || (r === 0 && c === 0);
+                }
+            }
+        }
+    }
+}
+/**
+ * The two copies of the format information, plus the always-dark module beside the bottom-left
+ * finder (8.9). Written before the data so `placeData` treats these positions as occupied.
+ */
+function drawFormatInfo(grid, mask) {
+    const size = grid.length;
+    const bits = FORMAT_INFO_M[mask];
+    for (let i = 0; i < 15; i += 1) {
+        const dark = ((bits >> i) & 1) === 1;
+        // Copy one, running down the left of the top-left finder and skipping the timing row.
+        if (i < 6)
+            grid[i][8] = dark;
+        else if (i < 8)
+            grid[i + 1][8] = dark;
+        else
+            grid[size - 15 + i][8] = dark;
+        // Copy two, running left from the top-right corner and continuing under the top-left finder.
+        if (i < 8)
+            grid[8][size - i - 1] = dark;
+        else if (i < 9)
+            grid[8][15 - i] = dark;
+        else
+            grid[8][14 - i] = dark;
+    }
+    grid[size - 8][8] = true;
+}
+/** The two copies of the version information, for versions 7 and up only (8.10). */
+function drawVersionInfo(grid, version) {
+    if (version < 7)
+        return;
+    const size = grid.length;
+    const bits = VERSION_INFO[version];
+    for (let i = 0; i < 18; i += 1) {
+        const dark = ((bits >> i) & 1) === 1;
+        const major = Math.floor(i / 3);
+        const minor = i % 3;
+        grid[major][size - 11 + minor] = dark;
+        grid[size - 11 + minor][major] = dark;
+    }
+}
+/**
+ * Fill the encoding region with the codeword bits, masking as we go.
+ *
+ * The walk is the spec's: two-module-wide columns from the right edge leftwards, alternating
+ * upward and downward, right module of the pair before the left. Column 6 is the vertical timing
+ * pattern and is stepped over entirely rather than skipped module by module.
+ *
+ * Running out of codewords is not an error — versions 2 to 6 have leftover remainder bits, which
+ * the spec fills with zeros. They still get masked, which is why this cannot just stop early.
+ */
+function placeData(grid, codewords, mask) {
+    const size = grid.length;
+    const maskFn = MASK_FUNCTIONS[mask];
+    let bitIndex = 7;
+    let byteIndex = 0;
+    let row = size - 1;
+    let upward = true;
+    for (let col = size - 1; col > 0; col -= 2) {
+        if (col === 6)
+            col -= 1;
+        for (;;) {
+            for (let c = 0; c < 2; c += 1) {
+                if (grid[row][col - c] !== null)
+                    continue;
+                let dark = false;
+                if (byteIndex < codewords.length) {
+                    dark = ((codewords[byteIndex] >>> bitIndex) & 1) === 1;
+                }
+                if (maskFn(row, col - c))
+                    dark = !dark;
+                grid[row][col - c] = dark;
+                bitIndex -= 1;
+                if (bitIndex === -1) {
+                    byteIndex += 1;
+                    bitIndex = 7;
+                }
+            }
+            row += upward ? -1 : 1;
+            if (row < 0 || row >= size) {
+                row -= upward ? -1 : 1;
+                upward = !upward;
+                break;
+            }
+        }
+    }
+}
+function buildSymbol(codewords, version, mask) {
+    const size = moduleCount(version);
+    const grid = Array.from({ length: size }, () => new Array(size).fill(null));
+    drawFinderPattern(grid, 0, 0);
+    drawFinderPattern(grid, size - 7, 0);
+    drawFinderPattern(grid, 0, size - 7);
+    drawAlignmentPatterns(grid, version);
+    drawTimingPatterns(grid);
+    drawFormatInfo(grid, mask);
+    drawVersionInfo(grid, version);
+    placeData(grid, codewords, mask);
+    // Every module is written by now: the function patterns above cover the whole reserved area, and
+    // placeData fills every remaining null. The cast is the only place this file assumes that.
+    return grid.map((row) => row.map((module) => module === true));
+}
+// ---------------------------------------------------------------------------------------------
+// Mask selection
+// ---------------------------------------------------------------------------------------------
+/**
+ * The spec's four penalty rules (8.8.2), summed. Lower is better.
+ *
+ * Scored over the entire symbol including function patterns, as the spec requires — the finders'
+ * own 1:1:3:1:1 ratio is exactly what rule 3 hunts for elsewhere, and excluding them would let a
+ * mask hide a false finder against a real one.
+ */
+export function maskPenalty(matrix) {
+    const size = matrix.length;
+    let points = 0;
+    // Rule 1: runs of five or more same-coloured modules in a row or column.
+    for (let a = 0; a < size; a += 1) {
+        let runRow = 1;
+        let runCol = 1;
+        for (let b = 1; b < size; b += 1) {
+            if (matrix[a][b] === matrix[a][b - 1])
+                runRow += 1;
+            else {
+                if (runRow >= 5)
+                    points += PENALTY_N1 + (runRow - 5);
+                runRow = 1;
+            }
+            if (matrix[b][a] === matrix[b - 1][a])
+                runCol += 1;
+            else {
+                if (runCol >= 5)
+                    points += PENALTY_N1 + (runCol - 5);
+                runCol = 1;
+            }
+        }
+        if (runRow >= 5)
+            points += PENALTY_N1 + (runRow - 5);
+        if (runCol >= 5)
+            points += PENALTY_N1 + (runCol - 5);
+    }
+    // Rule 2: every 2x2 block of one colour.
+    for (let row = 0; row < size - 1; row += 1) {
+        for (let col = 0; col < size - 1; col += 1) {
+            const dark = matrix[row][col];
+            if (matrix[row][col + 1] === dark
+                && matrix[row + 1][col] === dark
+                && matrix[row + 1][col + 1] === dark) {
+                points += PENALTY_N2;
+            }
+        }
+    }
+    // Rule 3: the 1:1:3:1:1 finder ratio with four light modules on one side, either orientation.
+    // Tracked as an 11-bit sliding window per row and per column; 0x5d0 is 10111010000 and 0x05d is
+    // 00001011101.
+    for (let a = 0; a < size; a += 1) {
+        let windowRow = 0;
+        let windowCol = 0;
+        for (let b = 0; b < size; b += 1) {
+            windowRow = ((windowRow << 1) & 0x7ff) | (matrix[a][b] ? 1 : 0);
+            windowCol = ((windowCol << 1) & 0x7ff) | (matrix[b][a] ? 1 : 0);
+            if (b < 10)
+                continue;
+            if (windowRow === 0x5d0 || windowRow === 0x05d)
+                points += PENALTY_N3;
+            if (windowCol === 0x5d0 || windowCol === 0x05d)
+                points += PENALTY_N3;
+        }
+    }
+    // Rule 4: how far the proportion of dark modules strays from half, in five-percent steps.
+    let dark = 0;
+    for (const row of matrix) {
+        for (const module of row) {
+            if (module)
+                dark += 1;
+        }
+    }
+    const percent = (dark * 100) / (size * size);
+    points += Math.floor(Math.abs(percent - 50) / 5) * PENALTY_N4;
+    return points;
+}
+// ---------------------------------------------------------------------------------------------
+// Public surface
+// ---------------------------------------------------------------------------------------------
+/**
+ * Encode `text` with an explicitly chosen mask.
+ *
+ * Exported for the fixture tests, which pin the mask so they compare structure — codewords, ECC,
+ * interleaving, function patterns, format bits — rather than a mask heuristic. Callers outside the
+ * tests want `encodeQr`.
+ */
+export function encodeQrWithMask(text, mask) {
+    if (mask < 0 || mask > 7)
+        return null;
+    const payload = Buffer.from(text, 'utf8');
+    const version = smallestVersion(payload.length);
+    if (version === null)
+        return null;
+    return buildSymbol(buildCodewords(payload, version), version, mask);
+}
+/**
+ * Encode `text` as a matrix of modules, row-major, true meaning dark. Null when it does not fit.
+ *
+ * The mask is chosen by the spec's penalty rules. That choice is a legibility heuristic and not a
+ * correctness property — all eight masks produce a valid, scannable symbol, and a decoder reads the
+ * chosen one out of the format information either way.
+ *
+ * There is no quiet zone here: it belongs to whatever draws the symbol, which knows what it is
+ * drawing onto. `qr-terminal.ts` paints its own.
+ */
+export function encodeQr(text) {
+    const payload = Buffer.from(text, 'utf8');
+    const version = smallestVersion(payload.length);
+    if (version === null)
+        return null;
+    const codewords = buildCodewords(payload, version);
+    let best = null;
+    let bestPenalty = Number.POSITIVE_INFINITY;
+    for (let mask = 0; mask < 8; mask += 1) {
+        const candidate = buildSymbol(codewords, version, mask);
+        const penalty = maskPenalty(candidate);
+        if (penalty < bestPenalty) {
+            bestPenalty = penalty;
+            best = candidate;
+        }
+    }
+    return best;
+}
+/** The longest text this encoder can hold, in bytes. Exported so a caller can explain a refusal. */
+export const MAX_BYTES = byteCapacity(MAX_VERSION);
+//# sourceMappingURL=qr.js.map

package/dist/render/qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.js","sourceRoot":"","sources":["../../src/render/qr.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/project-files.js

@@ -396,45 +396,49 @@ export function renderBitmagicJson(metadata) {
     return renderJson(metadata);
 }
 /**
- * The "Updating the bitmagic CLI" section, which exists because the answer is written down and was
- * still being asked.
+ * The "Updating the bitmagic CLI" section, which used to have two jobs and now has one.
  *
- * An agent told to update the CLI in a project directory has two published lines to choose from and,
- * before this, nothing in the project that named one — so it asked the creator "dev or prod?", which
- * is a question the project already answers. The pin decides it (see `updateTagForEnvironment`), so
- * the section states the command outright rather than describing how to work it out.
+ * It began as an answer to a question the project already answered: an agent told to update the CLI
+ * had two published lines to choose from, nothing in the project naming one, and so asked the
+ * creator "dev or prod?". The section baked in the right `npm i -g` for the pin and forbade the
+ * question.
  *
- * The rule is spelled out under the command anyway, for the one case the baked value can be wrong:
- * this file is written at scaffold time and refreshed by `bitmagic upgrade`, so a creator who edits
- * `environment` in between has a project whose pin has moved and whose AGENTS.md has not.
+ * That instruction was right about the line and wrong about the mechanism. A printed `npm i -g` is
+ * run by whatever `npm` the agent's shell resolves, and a coding agent's non-interactive shell
+ * sources no profile — under nvm it gets a different node's npm, installs into a prefix nothing on
+ * PATH points at, and reports success while `bitmagic --version` never moves. `bitmagic
+ * self-update` resolves its own install from the running process and reads the pin itself, so the
+ * whole two-line explanation collapses into one command that cannot be aimed at the wrong place or
+ * the wrong line. What remains of the old paragraph is the *why*, which an agent still needs when
+ * something looks wrong — not a choice for it to make.
  *
- * `environment` is undefined for a project scaffolded before the pin existed. That project has no
- * answer to bake, so the section gives it the rule and the command that produces the pin instead of
- * guessing a line on its behalf.
+ * `environment` is undefined for a project scaffolded before the pin existed. The command still
+ * works there (it falls back to the line the installed build is on), so that case only loses the
+ * sentence naming this project's environment.
  */
 function renderCliUpdateSection(environment) {
-    const install = environment === 'prod' ? 'npm i -g @bitmagic/cli' : 'npm i -g @bitmagic/cli@dev';
     const here = environment === undefined
         ? `This project predates the \`environment\` field of \`bitmagic.json\` and so has no pin yet.
-Run \`bitmagic upgrade\` once to stamp one; \`bitmagic whoami\` prints what the CLI resolves in the
-meantime, and that environment decides the line by the rule below.`
-        : `This project is on the **${environment}** environment (\`environment\` in
-\`bitmagic.json\`), so exactly one command updates the CLI here:
+Run \`bitmagic upgrade\` once to stamp one, and \`bitmagic whoami\` to see what the CLI resolves in
+the meantime; until there is a pin, \`self-update\` keeps you on the line your installed build is
+already on.`
+        : `This project is on the **${environment}** environment (\`environment\` in \`bitmagic.json\`), and the command reads that pin itself.`;
+    return `## Updating the bitmagic CLI
 
 \`\`\`
-${install}
-\`\`\``;
-    return `## Updating the bitmagic CLI
+bitmagic self-update
+\`\`\`
 
 ${here}
 
-**Never ask which line to install, and never offer the choice** — the environment decides it.
-\`dev\` and \`local\` projects take \`npm i -g @bitmagic/cli@dev\`, the prerelease line developed
-against the dev api-server; \`prod\` projects take the plain \`npm i -g @bitmagic/cli\`. They are not
-interchangeable — the wrong one calls endpoints that do not exist yet, or lags the engine its
-environment serves, and both fail as opaque command errors rather than version warnings. Run the
-wrong one here and every command opens with a notice saying so. If \`bitmagic.json\` ever disagrees
-with this paragraph, the file is right. The engine is a separate command: \`bitmagic upgrade\`.`;
+**Never ask which line to install, never offer the choice, and never update with \`npm i -g @bitmagic/cli\`** —
+\`self-update\` reinstalls into the exact place this CLI lives, using the node running it, which the \`npm\` on
+your PATH may not be; under nvm it usually is not, and the install lands in another prefix while
+\`bitmagic --version\` never moves. The lines are not interchangeable (\`dev\` and \`local\` take the prerelease
+built against the dev api-server, \`prod\` the release), and the wrong one fails as opaque command errors
+rather than version warnings — so run \`self-update\` before debugging a command that started failing
+strangely. If \`bitmagic.json\` ever disagrees with this paragraph, the file is right. The engine is a
+separate command: \`bitmagic upgrade\`.`;
 }
 export function renderAgentsMd(environment) {
     return `# Working on this Bitmagic game