@vibe-agent-toolkit/utils 0.1.39-rc.9 → 0.1.39

package/dist/yaml/surgical-yaml.js

@@ -0,0 +1,314 @@
+/**
+ * Byte-surgical YAML value updater.
+ *
+ * The motivating problem: editing one value in an adopter's config file with the
+ * naive `doc.setIn(...); doc.toString()` round-trip reflows the ENTIRE document —
+ * collapsing flow sequences, re-wrapping long scalars, shifting comment alignment,
+ * normalising quote styles. That destroys hand-authored formatting the user never
+ * asked us to touch.
+ *
+ * This module instead changes the **minimum bytes possible**:
+ *
+ * - **Replace** an existing scalar: locate its source byte range via the parsed
+ *   node and splice the new serialized token in place. Every other byte is
+ *   identical.
+ * - **Insert** a new key: render ONLY the new nested fragment, indent it to the
+ *   target map's child column, and splice it in after the map's last item. The
+ *   rest of the document is never re-rendered.
+ *
+ * `verifyConfinedYamlEdit` is the double-checker: it re-parses before/after and
+ * asserts the edit landed, no other leaf value drifted, and no comment was lost.
+ * `updateYamlIn` calls it internally as a defensive post-condition.
+ *
+ * No filesystem access — these are pure string transforms.
+ */
+import { Document, isCollection, isMap, isScalar, parseDocument, visit, } from 'yaml';
+/** yaml's `toString` options — `lineWidth: 0` disables line-wrapping/folding. */
+const NO_WRAP = { lineWidth: 0 };
+/**
+ * Upsert a single scalar at `path` in `text`, changing the minimum bytes possible.
+ *
+ * - If `path` already resolves to a scalar, its source token is replaced in place
+ *   (byte-identical output except the one value, including surrounding comments,
+ *   alignment whitespace, flow-collection padding, and sibling formatting).
+ * - If `path` does not yet exist, a new nested fragment is rendered and spliced
+ *   into the deepest existing ancestor map at the correct child indentation —
+ *   without re-rendering (and thus reflowing) the rest of the document.
+ *
+ * The input's EOL style (`\n` vs `\r\n`) is detected and preserved.
+ *
+ * @param text - The full YAML source document.
+ * @param path - Key/index path to the scalar to set.
+ * @param value - The scalar value to write (string, number, boolean, or null).
+ * @returns The updated document text.
+ * @throws If `text` is not valid YAML, if `path` is empty, or if `path` resolves
+ *   to a collection that would be clobbered by a scalar (or an intermediate
+ *   ancestor is a scalar that cannot hold a child).
+ *
+ * @example
+ * updateYamlIn('model: haiku   # note\n', ['model'], 'opus')
+ * // => 'model: opus   # note\n'   (alignment + comment preserved)
+ */
+export function updateYamlIn(text, path, value) {
+    if (path.length === 0) {
+        throw new Error('updateYamlIn: path must have at least one segment');
+    }
+    const eol = detectEol(text);
+    const doc = parseDocument(text, { prettyErrors: true });
+    if (doc.errors.length > 0) {
+        throw new Error(`updateYamlIn: input is not valid YAML: ${doc.errors[0]?.message ?? 'unknown'}`);
+    }
+    const existing = doc.getIn(path, true);
+    let result;
+    if (isScalar(existing)) {
+        result = replaceScalarToken(text, existing.range, value, eol);
+    }
+    else if (isCollection(existing)) {
+        throw new Error(`updateYamlIn: refusing to overwrite the collection at [${path.join(', ')}] with a scalar`);
+    }
+    else {
+        result = insertNewKey(text, doc, path, value, eol);
+    }
+    // Defensive post-condition: prove the edit was actually confined.
+    verifyConfinedYamlEdit(text, result, [path]);
+    return result;
+}
+/**
+ * Re-parse `before` and `after` and assert the edit was correct and confined:
+ *
+ * 1. **Correctness** — every entry in `changedPaths` resolves in `after`.
+ * 2. **Confinement** — every other leaf path present in `before` has a deep-equal
+ *    value in `after` (no collateral value edits).
+ * 3. **Comment preservation** — the multiset of all comment strings is unchanged.
+ *
+ * Safe to call as an internal assertion from {@link updateYamlIn}.
+ *
+ * @param before - The original document text.
+ * @param after - The edited document text.
+ * @param changedPaths - The paths the caller intended to change.
+ * @throws A descriptive `Error` naming the offending path or lost comment on any
+ *   violation.
+ */
+export function verifyConfinedYamlEdit(before, after, changedPaths) {
+    const beforeDoc = parseDocument(before, { prettyErrors: true });
+    const afterDoc = parseDocument(after, { prettyErrors: true });
+    if (afterDoc.errors.length > 0) {
+        throw new Error(`verifyConfinedYamlEdit: 'after' is not valid YAML: ${afterDoc.errors[0]?.message ?? 'unknown'}`);
+    }
+    assertChangedPathsLanded(afterDoc, changedPaths);
+    assertConfinement(beforeDoc, afterDoc, changedPaths);
+    assertCommentsPreserved(beforeDoc, afterDoc);
+}
+// ---------------------------------------------------------------------------
+// Replace path
+// ---------------------------------------------------------------------------
+/** Splice a freshly serialized scalar token over the source range `[start, valueEnd]`. */
+function replaceScalarToken(text, range, value, eol) {
+    if (range == null) {
+        throw new Error('updateYamlIn: target scalar has no source range (cannot locate it to replace)');
+    }
+    const [start, valueEnd] = range;
+    return text.slice(0, start) + serializeScalar(value, eol) + text.slice(valueEnd);
+}
+/** Render a value as a single bare YAML token (no key, no trailing newline). */
+function serializeScalar(value, eol) {
+    const token = new Document(value).toString(NO_WRAP).trimEnd();
+    return applyEol(token, eol);
+}
+// ---------------------------------------------------------------------------
+// Insert path
+// ---------------------------------------------------------------------------
+/** Insert a not-yet-existing key by rendering only the new nested fragment. */
+function insertNewKey(text, doc, path, value, eol) {
+    const target = findInsertionTarget(doc, path);
+    if (target.map === null) {
+        // Root is empty (or document had no content) — nothing to preserve, so a
+        // plain render of the whole nested object is acceptable.
+        return applyEol(new Document(buildNested(path, value)).toString(NO_WRAP), eol);
+    }
+    return spliceFragmentIntoMap(text, target.map, target.remaining, value, eol);
+}
+/**
+ * Walk `path` from deepest to shallowest to find the deepest existing ancestor
+ * map and the remaining (not-yet-existing) key chain to create under it.
+ */
+function findInsertionTarget(doc, path) {
+    for (let i = path.length - 1; i >= 0; i--) {
+        const prefix = path.slice(0, i);
+        const node = prefix.length === 0 ? doc.contents : doc.getIn(prefix, true);
+        if (node === null || node === undefined) {
+            continue; // This ancestor does not exist yet — try a shallower one.
+        }
+        if (isMap(node)) {
+            return { map: node, remaining: path.slice(i) };
+        }
+        throw new Error(`updateYamlIn: cannot insert at [${path.join(', ')}] — ancestor [${prefix.join(', ')}] is not a map`);
+    }
+    return { map: null, remaining: path };
+}
+/** Build a right-nested plain object from a key chain and a leaf value. */
+function buildNested(keys, value) {
+    let acc = value;
+    for (let i = keys.length - 1; i >= 0; i--) {
+        acc = { [String(keys[i])]: acc };
+    }
+    return acc;
+}
+/** Render the new fragment, indent it to the map's child column, and splice it in. */
+function spliceFragmentIntoMap(text, map, remaining, value, eol) {
+    const indent = childIndentOf(text, map);
+    const rendered = new Document(buildNested(remaining, value)).toString(NO_WRAP).replace(/\n$/, '');
+    const indented = rendered
+        .split('\n')
+        .map((line) => (line.length > 0 ? indent + line : line))
+        .join(eol);
+    const insertAt = insertionOffset(map);
+    const needsLeadingEol = insertAt > 0 && text[insertAt - 1] !== '\n';
+    const piece = (needsLeadingEol ? eol : '') + indented + eol;
+    return text.slice(0, insertAt) + piece + text.slice(insertAt);
+}
+/** The leading whitespace string for `map`'s children, derived from its first item's key. */
+function childIndentOf(text, map) {
+    const firstKey = map.items[0]?.key;
+    const keyRange = firstKey?.range;
+    if (!keyRange) {
+        throw new Error('updateYamlIn: cannot determine child indentation for an empty map (insert target has no existing items)');
+    }
+    return ' '.repeat(columnAt(text, keyRange[0]));
+}
+/** Byte offset to splice a new item at: the end of the map's content. */
+function insertionOffset(map) {
+    if (map.range == null) {
+        throw new Error('updateYamlIn: insertion target map has no source range');
+    }
+    return map.range[1];
+}
+// ---------------------------------------------------------------------------
+// verifyConfinedYamlEdit helpers
+// ---------------------------------------------------------------------------
+function assertChangedPathsLanded(afterDoc, changedPaths) {
+    for (const path of changedPaths) {
+        if (!afterDoc.hasIn(path)) {
+            throw new Error(`verifyConfinedYamlEdit: changed path [${path.join(', ')}] did not land in 'after'`);
+        }
+    }
+}
+function assertConfinement(beforeDoc, afterDoc, changedPaths) {
+    const changed = new Set(changedPaths.map((p) => JSON.stringify(p)));
+    const beforeJs = beforeDoc.toJS() ?? {};
+    const afterJs = afterDoc.toJS() ?? {};
+    const leaves = [];
+    collectLeafPaths(beforeJs, [], leaves);
+    for (const leaf of leaves) {
+        if (changed.has(JSON.stringify(leaf.path))) {
+            continue;
+        }
+        const found = getAtPath(afterJs, leaf.path);
+        if (!found.present || !Object.is(found.value, leaf.value)) {
+            const actual = found.present ? JSON.stringify(found.value) : '(removed)';
+            throw new Error(`verifyConfinedYamlEdit: value at [${leaf.path.join(', ')}] changed from ` +
+                `${JSON.stringify(leaf.value)} to ${actual} — edit was not confined`);
+        }
+    }
+}
+function assertCommentsPreserved(beforeDoc, afterDoc) {
+    const before = collectComments(beforeDoc).sort((a, b) => a.localeCompare(b));
+    const after = collectComments(afterDoc).sort((a, b) => a.localeCompare(b));
+    if (before.length === after.length && before.every((c, i) => c === after[i])) {
+        return;
+    }
+    const dropped = multisetDifference(before, after);
+    const added = multisetDifference(after, before);
+    throw new Error(`verifyConfinedYamlEdit: comment set changed — dropped ${JSON.stringify(dropped)}, ` +
+        `added ${JSON.stringify(added)}`);
+}
+/** Recursively collect every leaf (primitive/null) path and its value. */
+function collectLeafPaths(node, prefix, out) {
+    if (Array.isArray(node)) {
+        for (const [index, item] of node.entries()) {
+            collectLeafPaths(item, [...prefix, index], out);
+        }
+        return;
+    }
+    if (node !== null && typeof node === 'object') {
+        for (const [key, val] of Object.entries(node)) {
+            collectLeafPaths(val, [...prefix, key], out);
+        }
+        return;
+    }
+    out.push({ path: prefix, value: node });
+}
+/** Walk a plain JS structure by path; report presence to distinguish `undefined` from missing. */
+function getAtPath(root, path) {
+    let current = root;
+    for (const segment of path) {
+        if (current === null || typeof current !== 'object') {
+            return { present: false, value: undefined };
+        }
+        const key = String(segment);
+        if (!Object.hasOwn(current, key)) {
+            return { present: false, value: undefined };
+        }
+        current = current[key];
+    }
+    return { present: true, value: current };
+}
+/** Collect every comment string attached anywhere in the document. */
+function collectComments(doc) {
+    const comments = [];
+    pushComment(comments, doc.commentBefore);
+    pushComment(comments, doc.comment);
+    visit(doc, {
+        Node(_key, node) {
+            pushComment(comments, node.commentBefore);
+            pushComment(comments, node.comment);
+        },
+        Pair(_key, pair) {
+            const keyNode = pair.key;
+            const valueNode = pair.value;
+            pushComment(comments, keyNode?.commentBefore);
+            pushComment(comments, valueNode?.comment);
+        },
+    });
+    return comments;
+}
+function pushComment(out, comment) {
+    if (comment != null && comment !== '') {
+        out.push(comment);
+    }
+}
+/** Items in `a` that are not balanced by an equal item in `b` (multiset semantics). */
+function multisetDifference(a, b) {
+    const remaining = [...b];
+    const diff = [];
+    for (const item of a) {
+        const idx = remaining.indexOf(item);
+        if (idx === -1) {
+            diff.push(item);
+        }
+        else {
+            remaining.splice(idx, 1);
+        }
+    }
+    return diff;
+}
+// ---------------------------------------------------------------------------
+// Shared text helpers
+// ---------------------------------------------------------------------------
+/** Detect the document's EOL convention. Mixed/absent endings default to `\n`. */
+function detectEol(text) {
+    return text.includes('\r\n') ? '\r\n' : '\n';
+}
+/** Rewrite `\n` line breaks in `token` to the target EOL (no-op for `\n`). */
+function applyEol(token, eol) {
+    return eol === '\n' ? token : token.split('\n').join(eol);
+}
+/** The 0-based column (in characters) of byte `offset` within its line. */
+function columnAt(text, offset) {
+    let column = 0;
+    for (let i = 0; i < offset; i++) {
+        column = text[i] === '\n' ? 0 : column + 1;
+    }
+    return column;
+}
+//# sourceMappingURL=surgical-yaml.js.map

package/dist/yaml/surgical-yaml.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/utils",
-  "version": "0.1.39-rc.9",
+  "version": "0.1.39",
   "type": "module",
   "description": "Core utility functions with no external dependencies",
   "keywords": [