wingfoil 0.2.1

package/dist/dna/edit.js

@@ -0,0 +1,429 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDnaEditInText = applyDnaEditInText;
+/**
+ * The comment-preserving **structural** edit behind `dna add | remove | update` (task-093) — the
+ * sequence-aware sibling of `setDnaValueInText` (`task-063`, `bug-004-dna-set-strips-yaml-comments`).
+ *
+ * `setDnaValueInText` rewrites or inserts exactly one **mapping** line and skips every sequence branch
+ * by design, so it can express none of the four shapes `dl-081-dna-mutation-surface-shape`'s verbs
+ * write: a list of strings, an entry of a collection, a field inside an entry, or a list of strings
+ * inside an entry. Its fallback for a shape it cannot edit is a whole-file `js-yaml` `dump()` — correct,
+ * but it discards every comment token, including the inline `[SPEC]`/`[AUTHORING]` field-provenance
+ * annotations whose loss is exactly what `bug-004` filed. That fallback is rare for `dna set`; without
+ * this module it would be the **norm** for `dna add`, and the first structured write on a freshly
+ * `wingfoil init`-ed project would delete the scaffold's own guidance comments.
+ *
+ * The safety contract is `setDnaValueInText`'s, unchanged and strengthened: every candidate edit is
+ * verified by re-parsing it and comparing the **whole document** against the intended object before it
+ * is returned, and anything that cannot be done provably-minimally returns `undefined` so the caller
+ * falls back to `dump()` rather than writing something subtly wrong. A mis-located edit therefore
+ * cannot corrupt a file; at worst it costs the comments.
+ *
+ * Pure and deterministic (REQ-SYS-07): a function of `(text, edit, intended)` alone — no wall-clock, no
+ * randomness, no filesystem, and the input text is never mutated.
+ */
+const js_yaml_1 = require("js-yaml");
+const set_1 = require("./set");
+/** A block-mapping key line: optional `- `, a plain scalar key, `:`, then end-of-line or a space. */
+const KEY_LINE = /^( *)(- )?([A-Za-z0-9_][A-Za-z0-9_.+-]*):(?=$| )(.*)$/;
+/** Literal leading-space count. */
+function indentOf(line) {
+    return line.length - line.trimStart().length;
+}
+/** Whether a line carries no content of its own (blank, or a whole-line comment). */
+function isFiller(line) {
+    const trimmed = line.trim();
+    return trimmed === '' || trimmed.startsWith('#');
+}
+/** Parse a line as a block-mapping key, or `undefined` when it is not one. */
+function keyLineAt(lines, index) {
+    const line = lines[index];
+    const match = KEY_LINE.exec(line);
+    if (match === null)
+        return undefined;
+    const lead = match[1].length;
+    const dash = match[2] !== undefined;
+    return { line: index, indent: lead + (dash ? 2 : 0), key: match[3], rest: match[4], dash, lead };
+}
+/** Whether a line opens a sequence item (`- …`) at exactly `indent`. */
+function isItemLine(line, indent) {
+    return indentOf(line) === indent && line.trimStart().startsWith('-');
+}
+/**
+ * The lines belonging to the block under the key on `keyLine` — everything indented deeper, plus a
+ * sequence written at the key's own indentation (`key:` then `- item` in the same column, which YAML
+ * permits and some hand-written files use).
+ */
+function blockRegion(lines, key) {
+    let end = key.line + 1;
+    for (let i = key.line + 1; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (line.trim() === '')
+            continue;
+        const indent = indentOf(line);
+        if (indent > key.indent || (indent === key.indent && line.trimStart().startsWith('-') && !key.dash)) {
+            end = i + 1;
+            continue;
+        }
+        break;
+    }
+    return { start: key.line + 1, end };
+}
+/** The column this block's own content starts at (its children's indentation). */
+function childIndentOf(lines, region) {
+    for (let i = region.start; i < region.end; i += 1) {
+        const line = lines[i];
+        if (isFiller(line))
+            continue;
+        const indent = indentOf(line);
+        return line.trimStart().startsWith('- ') || line.trim() === '-' ? indent + 2 : indent;
+    }
+    return undefined;
+}
+/** Find `key` among the mapping keys directly inside `region` at `indent`. */
+function findKey(lines, region, indent, key) {
+    for (let i = region.start; i < region.end; i += 1) {
+        if (isFiller(lines[i]))
+            continue;
+        const candidate = keyLineAt(lines, i);
+        if (candidate === undefined || candidate.indent !== indent || candidate.key !== key)
+            continue;
+        return candidate;
+    }
+    return undefined;
+}
+/** The line spans of the sequence items directly inside `region`, in order. */
+function itemSpans(lines, region) {
+    let itemIndent;
+    const starts = [];
+    for (let i = region.start; i < region.end; i += 1) {
+        const line = lines[i];
+        if (isFiller(line))
+            continue;
+        const indent = indentOf(line);
+        if (itemIndent === undefined) {
+            if (!line.trimStart().startsWith('-'))
+                return [];
+            itemIndent = indent;
+        }
+        if (isItemLine(line, itemIndent))
+            starts.push(i);
+    }
+    return starts.map((start, position) => ({ start, end: starts[position + 1] ?? region.end }));
+}
+/** Follow `path` through the text, returning where its last step lands — or `undefined` if it is absent. */
+function locate(lines, path) {
+    let cursor = { region: { start: 0, end: lines.length }, indent: 0 };
+    for (const step of path) {
+        if ('key' in step) {
+            const key = findKey(lines, cursor.region, cursor.indent, step.key);
+            if (key === undefined)
+                return undefined;
+            const region = blockRegion(lines, key);
+            cursor = { region, indent: childIndentOf(lines, region) ?? key.indent + 2, key };
+            continue;
+        }
+        const spans = itemSpans(lines, cursor.region);
+        const span = spans[step.index];
+        if (span === undefined)
+            return undefined;
+        cursor = { region: span, indent: childIndentOf(lines, span) ?? cursor.indent + 2 };
+    }
+    return cursor;
+}
+/**
+ * Render a value as the single-line YAML token `js-yaml` itself would emit — which is what keeps this
+ * editor's bytes identical to the whole-file `dump()` fallback's at the same position, including
+ * defensive quoting (`'2'` stays a string, `'y'` is quoted because YAML 1.1 reads a bare `y` as a
+ * boolean).
+ *
+ * `flowLevel: 0` is what makes the result always a single line: every container is emitted in flow
+ * style and every scalar escaped rather than folded, so a value carrying a newline comes back as
+ * `"a\nb"` rather than a block scalar. That is why this returns a `string` and not `string |
+ * undefined` — there is no value the callers can pass that has no single-line form.
+ */
+function renderInline(value) {
+    return (0, js_yaml_1.dump)(value, { lineWidth: -1, flowLevel: 0 }).replace(/\n$/, '');
+}
+/** Rebuild a key line with a new value, keeping its indentation, its `- ` prefix and its inline comment. */
+function rewriteKeyLine(line, key, scalar) {
+    const head = `${' '.repeat(key.lead)}${key.dash ? '- ' : ''}${key.key}: ${scalar}`;
+    const commentIndex = (0, set_1.inlineCommentIndex)(key.rest);
+    if (commentIndex < 0)
+        return head;
+    const column = key.indent + key.key.length + 1 + commentIndex;
+    const gap = column > head.length ? ' '.repeat(column - head.length) : ' ';
+    return head + gap + key.rest.slice(commentIndex);
+}
+/** Render one sequence item as its own lines, at `indent`. */
+function renderItem(item, indent) {
+    const pad = ' '.repeat(indent);
+    if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+        return [`${pad}- ${renderInline(item)}`];
+    }
+    const entries = Object.entries(item);
+    if (entries.length === 0)
+        return undefined; // an empty mapping has no `- key: value` form
+    return entries.map(([key, value], index) => `${pad}${index === 0 ? '- ' : '  '}${key}: ${renderInline(value)}`);
+}
+/** Render a flow sequence, copying the bracket spacing of the line it replaces. */
+function renderFlow(items, spaced) {
+    if (items.length === 0)
+        return '[]';
+    const body = items.map((item) => renderInline(item)).join(', ');
+    return spaced ? `[ ${body} ]` : `[${body}]`;
+}
+/** The last index in `region` that carries content, so an insert lands before a trailing comment block. */
+function lastContentLine(lines, region) {
+    let last = region.start - 1;
+    for (let i = region.start; i < region.end; i += 1) {
+        if (!isFiller(lines[i]))
+            last = i;
+    }
+    return last;
+}
+/** The value `path` addresses inside an already-mutated document (used to re-render a flow sequence). */
+function valueAtPath(document, path) {
+    let node = document;
+    for (const step of path) {
+        if ('key' in step) {
+            if (typeof node !== 'object' || node === null || Array.isArray(node))
+                return undefined;
+            node = node[step.key];
+        }
+        else {
+            if (!Array.isArray(node))
+                return undefined;
+            node = node[step.index];
+        }
+    }
+    return node;
+}
+/** Order-insensitive structural equality — key ORDER is a rendering detail, key VALUES are the contract. */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a instanceof Date || b instanceof Date) {
+        return a instanceof Date && b instanceof Date && a.getTime() === b.getTime();
+    }
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((item, index) => deepEqual(item, b[index]));
+    }
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    const left = a;
+    const right = b;
+    const leftKeys = Object.keys(left);
+    if (leftKeys.length !== Object.keys(right).length)
+        return false;
+    return leftKeys.every((key) => Object.prototype.hasOwnProperty.call(right, key) && deepEqual(left[key], right[key]));
+}
+/** Write a value at the mapping key the path ends on, inserting the key when the block does not carry it. */
+function editSetScalar(lines, path, value) {
+    const scalar = renderInline(value);
+    const parentPath = path.slice(0, -1);
+    const last = path[path.length - 1];
+    if (last === undefined || !('key' in last))
+        return undefined;
+    const parent = locate(lines, parentPath);
+    if (parent === undefined)
+        return undefined;
+    const existing = findKey(lines, parent.region, parent.indent, last.key);
+    if (existing !== undefined) {
+        // A value that continues past its own line (a block scalar, a nested block) has no one-line edit.
+        const currentValue = (0, set_1.valueOf)(existing.rest);
+        if (currentValue.startsWith('|') || currentValue.startsWith('>'))
+            return undefined;
+        if (blockRegion(lines, existing).end > existing.line + 1)
+            return undefined;
+        lines[existing.line] = rewriteKeyLine(lines[existing.line], existing, scalar);
+        return lines;
+    }
+    // `lastContentLine` returns `region.start - 1` for an empty block, so the insert lands at its start.
+    lines.splice(lastContentLine(lines, parent.region) + 1, 0, `${' '.repeat(parent.indent)}${last.key}: ${scalar}`);
+    return lines;
+}
+/** Drop the mapping key the path ends on, together with the block hanging below it. */
+function editDeleteKey(lines, path) {
+    const cursor = locate(lines, path);
+    if (cursor?.key === undefined)
+        return undefined;
+    const region = blockRegion(lines, cursor.key);
+    lines.splice(cursor.key.line, Math.max(region.end, cursor.key.line + 1) - cursor.key.line);
+    return lines;
+}
+/** Append items to the sequence the path ends on, in whichever form that sequence is written. */
+function editAppendItems(lines, path, items, intended) {
+    const cursor = locate(lines, path);
+    if (cursor?.key === undefined)
+        return undefined;
+    const key = cursor.key;
+    const currentValue = (0, set_1.valueOf)(key.rest);
+    // An inline flow sequence (`roles: [ approver ]`) — or an empty one, which becomes a block below.
+    if (currentValue.startsWith('[')) {
+        if (currentValue !== '[]')
+            return rewriteFlow(lines, key, path, intended);
+        const rendered = renderItems(items, key.indent + 2);
+        if (rendered === undefined)
+            return undefined;
+        lines[key.line] = rewriteKeyLine(lines[key.line], key, '').replace(/: $/, ':');
+        lines.splice(key.line + 1, 0, ...rendered);
+        return lines;
+    }
+    if (currentValue !== '')
+        return undefined; // the key holds a plain scalar: not a sequence at all
+    const region = blockRegion(lines, key);
+    const spans = itemSpans(lines, region);
+    const itemIndent = spans.length > 0 ? indentOf(lines[spans[0].start]) : childIndentOf(lines, region) ?? key.indent + 2;
+    const rendered = renderItems(items, itemIndent);
+    if (rendered === undefined)
+        return undefined;
+    lines.splice(lastContentLine(lines, region) + 1, 0, ...rendered);
+    return lines;
+}
+/** Drop items from the sequence the path ends on. */
+function editRemoveItems(lines, path, indexes, intended) {
+    const cursor = locate(lines, path);
+    if (cursor?.key === undefined)
+        return undefined;
+    const key = cursor.key;
+    if ((0, set_1.valueOf)(key.rest).startsWith('['))
+        return rewriteFlow(lines, key, path, intended);
+    const region = blockRegion(lines, key);
+    const spans = itemSpans(lines, region);
+    if (spans.length === 0)
+        return undefined;
+    for (const index of [...indexes].sort((a, b) => b - a)) {
+        const span = spans[index];
+        if (span === undefined)
+            return undefined;
+        // Trailing comment/blank lines introduce whatever comes NEXT, so they are not this item's to delete.
+        const end = lastContentLine(lines, span) + 1;
+        lines.splice(span.start, end - span.start);
+    }
+    const remaining = valueAtPath(intended, path);
+    if (Array.isArray(remaining) && remaining.length === 0) {
+        lines[key.line] = rewriteKeyLine(lines[key.line], key, '[]');
+    }
+    return lines;
+}
+/** Replace the whole sequence the path ends on. */
+function editReplaceList(lines, path, items, intended) {
+    const cursor = locate(lines, path);
+    if (cursor?.key === undefined)
+        return undefined;
+    const key = cursor.key;
+    if ((0, set_1.valueOf)(key.rest).startsWith('['))
+        return rewriteFlow(lines, key, path, intended);
+    const region = blockRegion(lines, key);
+    const spans = itemSpans(lines, region);
+    if (spans.length === 0)
+        return undefined;
+    const itemIndent = indentOf(lines[spans[0].start]);
+    const rendered = renderItems(items, itemIndent);
+    if (rendered === undefined)
+        return undefined;
+    const from = spans[0].start;
+    const to = lastContentLine(lines, spans[spans.length - 1]) + 1;
+    lines.splice(from, to - from, ...rendered);
+    return lines;
+}
+/** Re-render an inline flow sequence from the intended document, keeping the line's bracket spacing. */
+function rewriteFlow(lines, key, path, intended) {
+    const items = valueAtPath(intended, path);
+    if (!Array.isArray(items))
+        return undefined;
+    lines[key.line] = rewriteKeyLine(lines[key.line], key, renderFlow(items, /\[\s/.test((0, set_1.valueOf)(key.rest))));
+    return lines;
+}
+/** Render several sequence items at `indent`, or `undefined` when any of them needs more than one line. */
+function renderItems(items, indent) {
+    const out = [];
+    for (const item of items) {
+        const rendered = renderItem(item, indent);
+        if (rendered === undefined)
+            return undefined;
+        out.push(...rendered);
+    }
+    return out;
+}
+/** Apply one edit to `lines` in place, returning `undefined` when it has no provably-minimal form. */
+function applyOne(lines, edit, intended) {
+    switch (edit.kind) {
+        case 'set-scalar':
+            return editSetScalar(lines, edit.path, edit.value);
+        case 'delete-key':
+            return editDeleteKey(lines, edit.path);
+        case 'append-items':
+            return editAppendItems(lines, edit.path, edit.items, intended);
+        case 'remove-items':
+            return editRemoveItems(lines, edit.path, edit.indexes, intended);
+        case 'replace-list':
+            return editReplaceList(lines, edit.path, edit.items, intended);
+        case 'batch': {
+            let current = lines;
+            for (const inner of edit.edits) {
+                current = applyOne(current, inner, intended);
+                if (current === undefined)
+                    return undefined;
+            }
+            return current;
+        }
+    }
+}
+/**
+ * The one shape the walker above cannot reach: a scalar whose PARENT key is itself absent from the
+ * text, so there is no block to insert into (`project.name` in a file with no `project:` at all).
+ * `setDnaValueInText` (`task-063`) already solves exactly that — it inserts the missing tail of a
+ * mapping path, comments intact — so it is reused rather than re-implemented, for the mapping-only
+ * paths it understands. Anything else still falls through to the caller's `dump()`.
+ */
+function insertMissingScalarPath(text, edit) {
+    if (edit.kind !== 'set-scalar' || typeof edit.value !== 'string')
+        return undefined;
+    if (!edit.path.every((step) => 'key' in step))
+        return undefined;
+    const keyPath = edit.path.map((step) => step.key).join('.');
+    return (0, set_1.setDnaValueInText)(text, keyPath, edit.value);
+}
+/**
+ * Apply `edit` to the RAW TEXT of a `dna.yaml`, editing as few lines as possible, and return the new
+ * text — or `undefined`, deliberately and not as an error, when no provably-minimal edit exists, so the
+ * caller falls back to the whole-file `dump()`.
+ *
+ * `intended` is the document the mutation produced (`applyDnaMutation`'s `dna`). It serves twice: an
+ * inline flow sequence is re-rendered from it rather than patched token-by-token, and — the part that
+ * makes this safe — the edited text is re-parsed and compared against it in full before being returned.
+ * Structural equality is used rather than a byte comparison because key ORDER is a rendering detail
+ * while key values are the contract; a mis-located edit fails the comparison and costs the comments,
+ * never the content.
+ *
+ * Declines (returns `undefined`) when: the text is not one valid YAML document; a step of the path is
+ * absent from the text; the target or a value it must rewrite spans more than its own line (a block
+ * scalar, a nested block); a value has no single-line YAML form; or the result does not read back as
+ * `intended`.
+ */
+function applyDnaEditInText(text, edit, intended) {
+    try {
+        (0, js_yaml_1.load)(text); // never "repair" input the caller could not read in the first place
+    }
+    catch {
+        return undefined;
+    }
+    const edited = applyOne(text.split('\n'), edit, intended) ?? insertMissingScalarPath(text, edit);
+    if (edited === undefined)
+        return undefined;
+    const result = Array.isArray(edited) ? edited.join('\n') : edited;
+    let parsed;
+    try {
+        parsed = (0, js_yaml_1.load)(result);
+    }
+    catch {
+        return undefined;
+    }
+    return deepEqual(parsed, intended) ? result : undefined;
+}
+//# sourceMappingURL=edit.js.map

package/dist/dna/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/dna/edit.ts"],"names":[],"mappings":";;AAycA,gDAkBC;AA3dD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qCAAqC;AAErC,+BAAuE;AAwCvE,qGAAqG;AACrG,MAAM,QAAQ,GAAG,uDAAuD,CAAC;AAEzE,mCAAmC;AACnC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,qFAAqF;AACrF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,KAAK,EAAE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,SAAS,SAAS,CAAC,KAAwB,EAAE,KAAa;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACpC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACrG,CAAC;AAED,wEAAwE;AACxE,SAAS,UAAU,CAAC,IAAY,EAAE,MAAc;IAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAwB,EAAE,GAAY;IACzD,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM;IACR,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;AACtC,CAAC;AAED,kFAAkF;AAClF,SAAS,aAAa,CAAC,KAAwB,EAAE,MAAc;IAC7D,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,SAAS,OAAO,CAAC,KAAwB,EAAE,MAAc,EAAE,MAAc,EAAE,GAAW;IACpF,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,SAAS;QAClC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,GAAG;YAAE,SAAS;QAC9F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,KAAwB,EAAE,MAAc;IACzD,IAAI,UAA8B,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;YACjD,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;QACD,IAAI,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAC/F,CAAC;AASD,4GAA4G;AAC5G,SAAS,MAAM,CAAC,KAAwB,EAAE,IAA4B;IACpE,IAAI,MAAM,GAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YACxC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACvC,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;YACjF,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,IAAA,cAAI,EAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,4GAA4G;AAC5G,SAAS,cAAc,CAAC,IAAY,EAAE,GAAY,EAAE,MAAc;IAChE,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;IACnF,MAAM,YAAY,GAAG,IAAA,wBAAkB,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,YAAY,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1E,OAAO,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACnD,CAAC;AAED,8DAA8D;AAC9D,SAAS,UAAU,CAAC,IAAa,EAAE,MAAc;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,GAAG,GAAG,KAAK,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC;IAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,8CAA8C;IAC1F,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAClH,CAAC;AAED,mFAAmF;AACnF,SAAS,UAAU,CAAC,KAAyB,EAAE,MAAe;IAC5D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;AAC9C,CAAC;AAED,2GAA2G;AAC3G,SAAS,eAAe,CAAC,KAAwB,EAAE,MAAc;IAC/D,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,IAAI,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yGAAyG;AACzG,SAAS,WAAW,CAAC,QAAiB,EAAE,IAA4B;IAClE,IAAI,IAAI,GAAY,QAAQ,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YACvF,IAAI,GAAI,IAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC3C,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4GAA4G;AAC5G,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;QAC3C,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAClF,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7F,MAAM,IAAI,GAAG,CAA4B,CAAC;IAC1C,MAAM,KAAK,GAAG,CAA4B,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvH,CAAC;AAED,6GAA6G;AAC7G,SAAS,aAAa,CAAC,KAAe,EAAE,IAA4B,EAAE,KAAc;IAClF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,kGAAkG;QAClG,MAAM,YAAY,GAAG,IAAA,aAAO,EAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACnF,IAAI,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3E,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC,CAAC;IACjH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uFAAuF;AACvF,SAAS,aAAa,CAAC,KAAe,EAAE,IAA4B;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3F,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iGAAiG;AACjG,SAAS,eAAe,CACtB,KAAe,EACf,IAA4B,EAC5B,KAAyB,EACzB,QAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,MAAM,YAAY,GAAG,IAAA,aAAO,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEvC,kGAAkG;IAClG,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC,CAAC,sDAAsD;IAEjG,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACzH,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,SAAS,eAAe,CACtB,KAAe,EACf,IAA4B,EAC5B,OAA0B,EAC1B,QAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,IAAA,aAAO,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,qGAAqG;QACrG,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mDAAmD;AACnD,SAAS,eAAe,CACtB,KAAe,EACf,IAA4B,EAC5B,KAAyB,EACzB,QAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,IAAI,MAAM,EAAE,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,IAAA,aAAO,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAE,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC;IAC7B,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC;IAChE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wGAAwG;AACxG,SAAS,WAAW,CAAC,KAAe,EAAE,GAAY,EAAE,IAA4B,EAAE,QAAiB;IACjG,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,GAAG,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAA,aAAO,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3G,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2GAA2G;AAC3G,SAAS,WAAW,CAAC,KAAyB,EAAE,MAAc;IAC5D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sGAAsG;AACtG,SAAS,QAAQ,CAAC,KAAe,EAAE,IAAiB,EAAE,QAAiB;IACrE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,KAAK,YAAY;YACf,OAAO,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,KAAK,cAAc;YACjB,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjE,KAAK,cAAc;YACjB,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnE,KAAK,cAAc;YACjB,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjE,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,OAAO,GAAyB,KAAK,CAAC;YAC1C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/B,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;gBAC7C,IAAI,OAAO,KAAK,SAAS;oBAAE,OAAO,SAAS,CAAC;YAC9C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAGD;;;;;;GAMG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,IAAiB;IAC9D,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjF,OAAO,IAAA,uBAAiB,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,kBAAkB,CAAC,IAAY,EAAE,IAAiB,EAAE,QAAiB;IACnF,IAAI,CAAC;QACH,IAAA,cAAI,EAAC,IAAI,CAAC,CAAC,CAAC,oEAAoE;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjG,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAClE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,cAAI,EAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC"}

package/dist/dna/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `dna` module — Project DNA pillar; structured project map (P2.4). `dna.yaml`'s schema
+ * (spec-002-dna-yaml-schema) lives here — the pillar owns its own independent schema (REQ-SYS-02);
+ * `src/core`'s loader wires it through the shared validation pipeline. `./roles` adds the
+ * role-based binding resolver (REQ-SYS-08, task-034-role-based-binding): `team.roles` is the sole
+ * role catalogue, `resolveRoleHolders` reads `team.members`/`team.agents` alone to answer "who holds
+ * this role today" — the foundation the Directives pillar (P3) builds on. Approval routing is *not*
+ * here (`dl-033-canonical-role-resolver`, option b): "may this principal approve?" is answered by
+ * `src/core/approval-authority.ts`. Further DNA behavior (`wingfoil dna show/set`, `wingfoil paths`)
+ * lands in later tasks.
+ */
+export declare const MODULE_NAME: "dna";
+export { DnaYaml, Project, Module, TechEntry, MethodologyEntry, Stacks, TeamMember, AgentEntry, RoleEntry, Team, Paths, } from './schema';
+export { isValidKeyPath, quoteDnaSegment, splitDnaPath, setDnaValueInText, DNA_KEY_ALIASES } from './set';
+export type { DnaPathSplit } from './set';
+export { resolveDnaPath, dnaCollectionPaths, dnaEntryOptionNames, DNA_ENTRY_OPTION_PREFIX, dnaEntryOptionName, dnaEntryFieldOfOption, } from './path';
+export type { DnaEntryField, DnaFieldKind, DnaPathResolution, DnaPathTarget, DnaTargetKind } from './path';
+export { applyDnaMutation } from './mutate';
+export type { DnaMutationRequest, DnaMutationResult, DnaMutationVerb } from './mutate';
+export { applyDnaEditInText } from './edit';
+export type { DnaTextEdit, DnaTextStep } from './edit';
+export { isRoleDefined, assertRoleDefined, resolveRoleHolders, UnknownRoleError, } from './roles';
+export type { RoleHolders } from './roles';
+//# sourceMappingURL=index.d.ts.map

package/dist/dna/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dna/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAG,KAAc,CAAC;AAE1C,OAAO,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,UAAU,EACV,SAAS,EACT,IAAI,EACJ,KAAK,GACN,MAAM,UAAU,CAAC;AAMlB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAC1G,YAAY,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE3G,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/dna/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownRoleError = exports.resolveRoleHolders = exports.assertRoleDefined = exports.isRoleDefined = exports.applyDnaEditInText = exports.applyDnaMutation = exports.dnaEntryFieldOfOption = exports.dnaEntryOptionName = exports.DNA_ENTRY_OPTION_PREFIX = exports.dnaEntryOptionNames = exports.dnaCollectionPaths = exports.resolveDnaPath = exports.DNA_KEY_ALIASES = exports.setDnaValueInText = exports.splitDnaPath = exports.quoteDnaSegment = exports.isValidKeyPath = exports.Paths = exports.Team = exports.RoleEntry = exports.AgentEntry = exports.TeamMember = exports.Stacks = exports.MethodologyEntry = exports.TechEntry = exports.Module = exports.Project = exports.DnaYaml = exports.MODULE_NAME = void 0;
+/**
+ * `dna` module — Project DNA pillar; structured project map (P2.4). `dna.yaml`'s schema
+ * (spec-002-dna-yaml-schema) lives here — the pillar owns its own independent schema (REQ-SYS-02);
+ * `src/core`'s loader wires it through the shared validation pipeline. `./roles` adds the
+ * role-based binding resolver (REQ-SYS-08, task-034-role-based-binding): `team.roles` is the sole
+ * role catalogue, `resolveRoleHolders` reads `team.members`/`team.agents` alone to answer "who holds
+ * this role today" — the foundation the Directives pillar (P3) builds on. Approval routing is *not*
+ * here (`dl-033-canonical-role-resolver`, option b): "may this principal approve?" is answered by
+ * `src/core/approval-authority.ts`. Further DNA behavior (`wingfoil dna show/set`, `wingfoil paths`)
+ * lands in later tasks.
+ */
+exports.MODULE_NAME = 'dna';
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "DnaYaml", { enumerable: true, get: function () { return schema_1.DnaYaml; } });
+Object.defineProperty(exports, "Project", { enumerable: true, get: function () { return schema_1.Project; } });
+Object.defineProperty(exports, "Module", { enumerable: true, get: function () { return schema_1.Module; } });
+Object.defineProperty(exports, "TechEntry", { enumerable: true, get: function () { return schema_1.TechEntry; } });
+Object.defineProperty(exports, "MethodologyEntry", { enumerable: true, get: function () { return schema_1.MethodologyEntry; } });
+Object.defineProperty(exports, "Stacks", { enumerable: true, get: function () { return schema_1.Stacks; } });
+Object.defineProperty(exports, "TeamMember", { enumerable: true, get: function () { return schema_1.TeamMember; } });
+Object.defineProperty(exports, "AgentEntry", { enumerable: true, get: function () { return schema_1.AgentEntry; } });
+Object.defineProperty(exports, "RoleEntry", { enumerable: true, get: function () { return schema_1.RoleEntry; } });
+Object.defineProperty(exports, "Team", { enumerable: true, get: function () { return schema_1.Team; } });
+Object.defineProperty(exports, "Paths", { enumerable: true, get: function () { return schema_1.Paths; } });
+// `splitDnaPath` (task-099, `dl-083-dotted-entry-names-in-paths`) is the pillar's path parser: the one
+// place a dotted path is split, and therefore the one definition of the quoted-segment rule that makes
+// an entry named `Node.js` addressable. `isValidKeyPath` is that parser reduced to a boolean, and
+// `quoteDnaSegment` is its inverse, used where a refusal echoes part of a path.
+var set_1 = require("./set");
+Object.defineProperty(exports, "isValidKeyPath", { enumerable: true, get: function () { return set_1.isValidKeyPath; } });
+Object.defineProperty(exports, "quoteDnaSegment", { enumerable: true, get: function () { return set_1.quoteDnaSegment; } });
+Object.defineProperty(exports, "splitDnaPath", { enumerable: true, get: function () { return set_1.splitDnaPath; } });
+Object.defineProperty(exports, "setDnaValueInText", { enumerable: true, get: function () { return set_1.setDnaValueInText; } });
+Object.defineProperty(exports, "DNA_KEY_ALIASES", { enumerable: true, get: function () { return set_1.DNA_KEY_ALIASES; } });
+// task-093-dna-mutation-surface-add-remove-update — the mutation surface `dl-081-dna-mutation-surface-shape`
+// ratified (option (E)): one schema-driven traversal (`./path`), the pure add|remove|update semantics
+// over it (`./mutate`), and the comment-preserving structural edit that writes the result (`./edit`).
+// `setDnaValue` is gone with them: it treated every path segment as an object key and created an object
+// for any segment it could not descend into, which is the mechanism `bug-084` filed.
+var path_1 = require("./path");
+Object.defineProperty(exports, "resolveDnaPath", { enumerable: true, get: function () { return path_1.resolveDnaPath; } });
+Object.defineProperty(exports, "dnaCollectionPaths", { enumerable: true, get: function () { return path_1.dnaCollectionPaths; } });
+Object.defineProperty(exports, "dnaEntryOptionNames", { enumerable: true, get: function () { return path_1.dnaEntryOptionNames; } });
+Object.defineProperty(exports, "DNA_ENTRY_OPTION_PREFIX", { enumerable: true, get: function () { return path_1.DNA_ENTRY_OPTION_PREFIX; } });
+Object.defineProperty(exports, "dnaEntryOptionName", { enumerable: true, get: function () { return path_1.dnaEntryOptionName; } });
+Object.defineProperty(exports, "dnaEntryFieldOfOption", { enumerable: true, get: function () { return path_1.dnaEntryFieldOfOption; } });
+var mutate_1 = require("./mutate");
+Object.defineProperty(exports, "applyDnaMutation", { enumerable: true, get: function () { return mutate_1.applyDnaMutation; } });
+var edit_1 = require("./edit");
+Object.defineProperty(exports, "applyDnaEditInText", { enumerable: true, get: function () { return edit_1.applyDnaEditInText; } });
+var roles_1 = require("./roles");
+Object.defineProperty(exports, "isRoleDefined", { enumerable: true, get: function () { return roles_1.isRoleDefined; } });
+Object.defineProperty(exports, "assertRoleDefined", { enumerable: true, get: function () { return roles_1.assertRoleDefined; } });
+Object.defineProperty(exports, "resolveRoleHolders", { enumerable: true, get: function () { return roles_1.resolveRoleHolders; } });
+Object.defineProperty(exports, "UnknownRoleError", { enumerable: true, get: function () { return roles_1.UnknownRoleError; } });
+//# sourceMappingURL=index.js.map

package/dist/dna/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dna/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,WAAW,GAAG,KAAc,CAAC;AAE1C,mCAYkB;AAXhB,iGAAA,OAAO,OAAA;AACP,iGAAA,OAAO,OAAA;AACP,gGAAA,MAAM,OAAA;AACN,mGAAA,SAAS,OAAA;AACT,0GAAA,gBAAgB,OAAA;AAChB,gGAAA,MAAM,OAAA;AACN,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AACV,mGAAA,SAAS,OAAA;AACT,8FAAA,IAAI,OAAA;AACJ,+FAAA,KAAK,OAAA;AAGP,uGAAuG;AACvG,uGAAuG;AACvG,kGAAkG;AAClG,gFAAgF;AAChF,6BAA0G;AAAjG,qGAAA,cAAc,OAAA;AAAE,sGAAA,eAAe,OAAA;AAAE,mGAAA,YAAY,OAAA;AAAE,wGAAA,iBAAiB,OAAA;AAAE,sGAAA,eAAe,OAAA;AAG1F,6GAA6G;AAC7G,sGAAsG;AACtG,sGAAsG;AACtG,wGAAwG;AACxG,qFAAqF;AACrF,+BAOgB;AANd,sGAAA,cAAc,OAAA;AACd,0GAAA,kBAAkB,OAAA;AAClB,2GAAA,mBAAmB,OAAA;AACnB,+GAAA,uBAAuB,OAAA;AACvB,0GAAA,kBAAkB,OAAA;AAClB,6GAAA,qBAAqB,OAAA;AAIvB,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AAGzB,+BAA4C;AAAnC,0GAAA,kBAAkB,OAAA;AAG3B,iCAKiB;AAJf,sGAAA,aAAa,OAAA;AACb,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,yGAAA,gBAAgB,OAAA"}

package/dist/dna/mutate.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The pure `add | remove | update` semantics of the DNA mutation surface
+ * (`dl-081-dna-mutation-surface-shape`, ratified option **(E)**; task-093;
+ * closes `bug-083-dna-set-cannot-write-array-valued-fields`).
+ *
+ * Before this module, `dna set` reached 7 of roughly 38 schema fields — `version` and the six scalars
+ * under `project` — because its traversal treated every path segment as an object key. 11 fields are
+ * array-valued and 17 more live inside array entries, and none of them was reachable for create, update
+ * or delete: not a module's `path`, a technology's `version`, a member's `email`, nor the removal of any
+ * of them, nor the addition of a role or a member (`dl-081` E2/E3).
+ *
+ * The grammar the ratification chose, and which this module implements — with the path in the verb's
+ * **positional** (`dl-082-cli-parameter-shape`: a positional carries the identity of the target, an
+ * option a named attribute of the action) and every attribute in an option:
+ *
+ * ```
+ * dna add    team.roles                 --value reviewer --entry-description "reviews changes"
+ * dna add    team.members               --value roberto  --entry-email r@example.it --entry-roles approver
+ * dna add    team.members.roberto.roles --value qa
+ * dna update team.members               --value roberto  --entry-email new@example.it
+ * dna update modules.core.path          --value src/core
+ * dna remove modules                    --value core
+ * ```
+ *
+ * `--value` carries **two** things by position — the new entry's identity when the path ends at a
+ * collection, the new value when it ends at a leaf. That is a convention rather than something the
+ * grammar states, so it is stated: here, in `--help` (`src/core/index.ts`'s option descriptions) and in
+ * `spec-008-cli-grammar`.
+ *
+ * This module is pure (REQ-SYS-07): no git, no filesystem, no clock, and the document it is handed is
+ * never mutated — every mutation is applied to a deep clone, so a refusal leaves the caller's object
+ * untouched and `src/core` re-validates and commits only what comes back. It sits under `src/core`
+ * (`spec-006-core-domain-api` §1: the pillar is a leaf, and imports nothing from `core`).
+ */
+import type { z } from 'zod';
+import type { DnaTextEdit } from './edit';
+/** The three verbs `dl-081` ratified. `dna set` is `update` restricted to a scalar. */
+export type DnaMutationVerb = 'add' | 'remove' | 'update';
+/** One mutation request: the full `<path>`, the `--value` payload, and the per-entry `--entry-<field>` options. */
+export interface DnaMutationRequest {
+    readonly verb: DnaMutationVerb;
+    /** The FULL dotted path (`dl-081`: never a bare field name — `team.roles` and `team.members.roles` differ). */
+    readonly field: string;
+    /** The entry's identity at a collection; the new value at a leaf. Optional only where the path says everything. */
+    readonly value?: string;
+    /** `--entry-<field>` options, keyed by the schema's own field name and still raw strings; coerced against the entry schema (`{ email: 'r@x.y' }`). */
+    readonly fields?: Readonly<Record<string, string>>;
+}
+/** The mutated document plus the minimal text edit that expresses it, or the refusal to report at exit `1`. */
+export type DnaMutationResult = {
+    readonly ok: true;
+    readonly dna: Record<string, unknown>;
+    readonly edit: DnaTextEdit;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * Apply one `add`/`remove`/`update` to `dna`, returning the new document and the minimal text edit that
+ * expresses it — or a refusal message the caller reports at exit `1` (`spec-005` §1, as ruled on
+ * `bug-076`: a well-formed invocation that fails on the content is a logic error, not a usage error).
+ *
+ * Every refusal names what failed and, where there is one, the verb that would have worked — the whole
+ * point of `bug-083`'s repair is that `dna set team.members '[…]'` used to fail with
+ * `expected array, received string` from a schema re-validation, which says nothing about how to reach
+ * the field.
+ *
+ * `schemaRoot` is passed straight to `resolveDnaPath` and defaults to `DnaYaml` there — the only schema
+ * any caller uses. It is a parameter for the same reason: the semantics below are a function of *a*
+ * schema (which field kinds exist, which are required), so they stay exercisable against shapes
+ * `spec-002` does not declare today rather than resting on an untested claim.
+ */
+export declare function applyDnaMutation(dna: Record<string, unknown>, request: DnaMutationRequest, schemaRoot?: z.ZodType): DnaMutationResult;
+//# sourceMappingURL=mutate.d.ts.map

package/dist/dna/mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../../src/dna/mutate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,QAAQ,CAAC;AAGvD,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,mHAAmH;AACnH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,+GAA+G;IAC/G,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sJAAsJ;IACtJ,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,+GAA+G;AAC/G,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GACxF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAkIrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,GACrB,iBAAiB,CAsBnB"}