wingfoil 0.2.1

package/dist/dna/set.js

@@ -0,0 +1,428 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DNA_KEY_ALIASES = void 0;
+exports.splitDnaPath = splitDnaPath;
+exports.quoteDnaSegment = quoteDnaSegment;
+exports.isValidKeyPath = isValidKeyPath;
+exports.inlineCommentIndex = inlineCommentIndex;
+exports.valueOf = valueOf;
+exports.setDnaValueInText = setDnaValueInText;
+/**
+ * Pure DNA key-path helpers for `wingfoil dna set` (P2.1, task-025-implement-dna-set). The `dna`
+ * pillar owns the semantics of a dotted key path into its own structure; `src/core`'s `dnaSet`
+ * operation composes these with the git-identity pre-flight, schema re-validation, write, and commit
+ * (which are cross-pillar / storage concerns and therefore live in `src/core`, not here). Nothing in
+ * this file imports `src/core` — the pillar stays a leaf under core (spec-006-core-domain-api §1).
+ *
+ * task-063 adds {@link setDnaValueInText}, the minimal **comment-preserving** in-place edit that
+ * replaces the whole-file `js-yaml` `dump()` round-trip as `dna set`'s primary write path
+ * (bug-004-dna-set-strips-yaml-comments). Only `js-yaml` is imported — no comment-preserving YAML
+ * library is added, per `dl-010-minimal-dependencies`.
+ */
+const js_yaml_1 = require("js-yaml");
+/**
+ * The first-segment alias `dna show` resolves: `tech_stack` -> `stacks`, the BDD-compatibility alias
+ * spec-002-dna-yaml-schema's Consequences describe (the schema renamed the BDD's `tech_stack` wording
+ * to `stacks`), so `dna show tech_stack` still reads the `stacks` subtree.
+ *
+ * **READ side only, since task-093** (`bug-084-dna-key-alias-writes-unschemad-keys`). It used to be
+ * applied on the write path too, and there it was a trap: `stacks` replaced a fixed-key `tech_stack`
+ * OBJECT, which is a change of shape rather than of name, so rewriting only the first segment
+ * produced a path that resolves nowhere — `dna set tech_stack.cli.framework Commander` wrote
+ * `stacks.cli.framework`, a key no schema declares, through `Stacks`'s `.passthrough()`, at exit 0.
+ * spec-002 says plainly that "any consumer that read `tech_stack.<key>` must now scan" the lists, and
+ * a first-segment alias cannot honour that sentence. The write path therefore does not alias at all;
+ * an old-shape path is refused as the unknown key it is (`src/dna/path.ts`, exit 1).
+ */
+exports.DNA_KEY_ALIASES = { tech_stack: 'stacks' };
+/** The delimiter that opens and closes a quoted path segment (`dl-083`). */
+const QUOTE = '"';
+/**
+ * Parse a dotted DNA key path into its segments — the ONE place a path is split, shared by
+ * {@link isValidKeyPath}, {@link setDnaValueInText}'s text resolver and `resolveDnaPath`
+ * (`./path.ts`). It replaced three copies of `keyPath.split('.')`, which is why the quoting rule
+ * below has one definition rather than three chances to disagree.
+ *
+ * **The grammar** (`dl-083-dotted-entry-names-in-paths`, ratified; it exists because
+ * `dl-081-dna-mutation-surface-shape` made an entry's `name` the key it is addressed by, and
+ * `stacks.technologies` really does carry entries named `Node.js` and `Commander.js`):
+ *
+ * - a segment that **begins** with `"` is quoted and ends at the **next** `"`. The quotes are
+ *   delimiters and are not part of the name; between them `.` is an ordinary character, and so is
+ *   everything else;
+ * - the closing `"` must be followed by `.` or by the end of the path;
+ * - a segment that does not begin with `"` ends at the next `.`;
+ * - quoting is optional where it is unnecessary: `team."members".roberto` and `team.members.roberto`
+ *   are the same path.
+ *
+ * **The rule narrows what a path may mean, and for one class of path that is a breaking change.**
+ * Before it, `"` was an ordinary character inside a segment; under it every `"` is a delimiter. Two
+ * measured consequences, neither hypothetical: `isValidKeyPath('modules.co"re')` was `true` and is
+ * now `false`; and where a collection carries an entry named `"a"` beside one named `a` — the schema
+ * permits both, `uniquelyNamed` included — `stacks.technologies."a".category` resolved to the
+ * quote-named entry before and resolves to the **other** entry now, silently rather than by refusing.
+ * `dl-083` accepts the narrowing deliberately (a name containing `"` becomes unaddressable, with no
+ * escape sequence), but accepting it is not the same as nothing having changed.
+ *
+ * At a shell prompt the two quoting layers overlap and are easy to confuse:
+ * `wingfoil dna update 'stacks.technologies."Node.js".version' --value 22.14+` has the **shell's**
+ * single quotes outside and **WingFoil's** double quotes inside. This function sees only the inner
+ * form.
+ *
+ * **Three refusals, and the distinctions between them are load-bearing:**
+ *
+ * - an **empty** segment, quoted (`team.""`) or not (`..language`) — `invalid key path: '<path>'`,
+ *   the message `P2.1-dna-set.feature` scenario 3 pins, unchanged;
+ * - an **unterminated** quote — a segment that opens with `"` and never closes. Refused as
+ *   unterminated rather than taken as a name that happens to begin with a quote, so
+ *   `dna update 'stacks."Node.js'` reports the typo instead of hunting for an entry named `"Node`;
+ * - a `"` **no delimiter can account for**: inside an unquoted segment (`modules.co"re`), or in the
+ *   remainder of a quoted one (`stacks."say "hi""`). A quoted segment may not contain `"` and there
+ *   is **no escape sequence** — `dl-083` accepted that cost deliberately rather than overlooking it —
+ *   so the name being reached for has no spelling at all. The refusal says the **name** is
+ *   unaddressable, not that the path is malformed, because the path is the only spelling an
+ *   impossible request has. A quoted segment that merely fails to span its segment (`"Node.js"x`)
+ *   carries no such `"` and is malformed instead: that is what keeps the unaddressable message true
+ *   every time it is printed.
+ *
+ * All three are usage errors (exit 2, `spec-005-cli-command-contract` §1) — properties of how the
+ * argument is spelled, decided before anything is read. This is a pure function with no side effects,
+ * so the caller owns turning a refusal into that exit code.
+ */
+function splitDnaPath(keyPath) {
+    const malformed = { ok: false, message: `invalid key path: '${keyPath}'` };
+    const segments = [];
+    let index = 0;
+    for (;;) {
+        let segment;
+        /** Index of the `.` that ended this segment, or `-1` when the segment ran to the end of the path. */
+        let dot;
+        if (keyPath[index] === QUOTE) {
+            const close = keyPath.indexOf(QUOTE, index + 1);
+            if (close < 0) {
+                return {
+                    ok: false,
+                    message: `invalid key path: '${keyPath}': unterminated quote — a segment that opens with ${QUOTE} must close with ${QUOTE}`,
+                };
+            }
+            dot = keyPath.indexOf('.', close + 1);
+            const trailer = dot < 0 ? keyPath.slice(close + 1) : keyPath.slice(close + 1, dot);
+            if (trailer.length > 0)
+                return trailer.includes(QUOTE) ? unaddressable(keyPath) : malformed;
+            segment = keyPath.slice(index + 1, close);
+        }
+        else {
+            dot = keyPath.indexOf('.', index);
+            segment = dot < 0 ? keyPath.slice(index) : keyPath.slice(index, dot);
+            if (segment.includes(QUOTE))
+                return unaddressable(keyPath);
+        }
+        if (segment.length === 0)
+            return malformed;
+        segments.push(segment);
+        // A `.` always opens another segment — `team.` owes one, and it is the empty one refused above.
+        if (dot < 0)
+            return { ok: true, segments };
+        index = dot + 1;
+    }
+}
+/** The refusal for a `"` that cannot be a delimiter: the NAME has no spelling, not the path. */
+function unaddressable(keyPath) {
+    return {
+        ok: false,
+        message: `unaddressable entry name in key path '${keyPath}': a segment may not contain ${QUOTE} and there is ` +
+            `no escape sequence, so an entry whose name contains ${QUOTE} cannot be addressed`,
+    };
+}
+/**
+ * The path spelling of one segment: quoted when its name contains a `.`, bare otherwise. Used wherever
+ * a refusal echoes part of a path, so the reported prefix can be pasted back into a command — without
+ * it `stacks.technologies.Node.js` would be reported for the entry named `Node.js`, and that re-splits
+ * into four segments and names a different node.
+ *
+ * **It is the inverse of {@link splitDnaPath} on the segments `splitDnaPath` produces — not on every
+ * string**, and the difference is worth stating precisely rather than calling it "the inverse".
+ * Brute-forced over the alphabet `{a, ., "}` up to five characters (363 names): 62 round-trip
+ * unchanged, 294 produce a path `splitDnaPath` refuses, and **7 produce a path that parses back to a
+ * different name** — `"a"` contains no `.`, so it is returned bare and re-parses as `a`; `a"."a`
+ * becomes `"a"."a"`, which is two segments.
+ *
+ * All 7 have a `"` in the name, and that is why the gap is unreachable at the one call site
+ * (`prefixOf`, `./path.ts`), structurally rather than by luck: `prefixOf` is fed
+ * `DnaPathTarget.segments`, which comes from `splitDnaPath`, and a segment it returns can never
+ * contain a `"` — a bare segment containing one is refused as unaddressable, and a quoted segment
+ * ends at the *first* `"`. Measured over the same 363: **0** parse to a segment containing a quote.
+ * So the hardening a general inverse would need is unreachable code, and is deliberately not written;
+ * what is written instead is this note and the `"`-free precondition it rests on.
+ */
+function quoteDnaSegment(name) {
+    return name.includes('.') ? `${QUOTE}${name}${QUOTE}` : name;
+}
+/**
+ * Whether `keyPath` is a well-formed dotted path — {@link splitDnaPath} reduced to a boolean, so the
+ * predicate and the parser cannot disagree about what "well-formed" means. A malformed path (the
+ * BDD's `..language`, an empty segment, an unterminated or unaccountable quote) is a usage error
+ * (exit 2, spec-005-cli-command-contract §1) the caller rejects before any write; a caller that
+ * reports a message uses `splitDnaPath` directly, because only it knows *which* of the three it was.
+ */
+function isValidKeyPath(keyPath) {
+    return splitDnaPath(keyPath).ok;
+}
+/**
+ * A block-mapping key line: leading spaces, a plain scalar key, `:`, then end-of-line or a space.
+ * Deliberately narrow — quoted, complex or flow keys simply do not match, which can only make the
+ * scanner *miss* a key (falling back to the whole-file dump), never mis-target one.
+ */
+const KEY_LINE = /^( *)([A-Za-z0-9_][A-Za-z0-9_.+-]*):(?=$| )(.*)$/;
+/** Leading-space count of a line (its block-mapping indentation level). */
+function indentOf(line) {
+    return line.length - line.trimStart().length;
+}
+/**
+ * Index within `rest` of the `#` that starts an inline comment, or `-1`. Quote-aware, so a `#`
+ * inside a `'single'`- or `"double"`-quoted scalar is not mistaken for a comment; per the YAML spec
+ * a comment must also be preceded by whitespace (or start the field).
+ *
+ * Exported for `./edit.ts`, the sequence-aware editor added by task-093: both write paths must agree
+ * on where a line's value ends and its comment begins, and two copies of this scanner would be two
+ * chances to disagree.
+ */
+function inlineCommentIndex(rest) {
+    let quote;
+    for (let i = 0; i < rest.length; i += 1) {
+        const char = rest[i];
+        if (quote !== undefined) {
+            if (char === quote) {
+                if (quote === "'" && rest[i + 1] === "'")
+                    i += 1;
+                else
+                    quote = undefined;
+            }
+            else if (quote === '"' && char === '\\')
+                i += 1;
+            continue;
+        }
+        if (char === "'" || char === '"')
+            quote = char;
+        else if (char === '#' && (i === 0 || rest[i - 1] === ' ' || rest[i - 1] === '\t'))
+            return i;
+    }
+    return -1;
+}
+/** The value part of a key line's `rest`, with any inline comment and surrounding spaces removed. */
+function valueOf(rest) {
+    const commentIndex = inlineCommentIndex(rest);
+    return (commentIndex < 0 ? rest : rest.slice(0, commentIndex)).trim();
+}
+/**
+ * Whether the value on line `line` continues past it — a nested block, a same-indent sequence, or a
+ * multi-line scalar. Such a line cannot be rewritten on its own without orphaning what follows, so
+ * the editor refuses (the caller falls back to the whole-file dump).
+ */
+function hasContinuation(lines, line, indent) {
+    for (let i = line + 1; i < lines.length; i += 1) {
+        const candidate = lines[i];
+        if (candidate.trim() === '')
+            continue;
+        const candidateIndent = indentOf(candidate);
+        if (candidateIndent > indent)
+            return true;
+        return candidateIndent === indent && candidate.trimStart().startsWith('-');
+    }
+    return false;
+}
+/**
+ * Walk the document's block mappings top-down, tracking the current key path by indentation, and
+ * report where `segments` lands. Sequence branches are skipped wholesale (a dotted DNA key path only
+ * ever names mapping keys), as is block-scalar content, so neither can produce a false match.
+ */
+function resolveKeyPath(lines, segments) {
+    const stack = [];
+    /** While set, every line indented at least this far is skipped (sequence / block-scalar content). */
+    let skipFrom;
+    let parent;
+    let depth = 0;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (line.trim() === '')
+            continue; // blank lines belong to whatever region is open; never close one
+        const indent = indentOf(line);
+        if (skipFrom !== undefined) {
+            if (indent >= skipFrom)
+                continue;
+            skipFrom = undefined;
+        }
+        const content = line.trimStart();
+        if (content.startsWith('#'))
+            continue;
+        if (content.startsWith('-')) {
+            skipFrom = indent; // a sequence item: skip this whole branch, items and their children alike
+            continue;
+        }
+        const match = KEY_LINE.exec(line);
+        if (match === null)
+            continue;
+        const key = match[2];
+        const rest = match[3];
+        while (stack.length > 0 && stack[stack.length - 1].indent >= indent)
+            stack.pop();
+        const path = [...stack.map((frame) => frame.key), key];
+        if (path.length <= segments.length && path.every((name, index) => name === segments[index])) {
+            if (path.length === segments.length) {
+                return { leaf: { line: i, indent, key, rest }, depth: segments.length };
+            }
+            parent = { line: i, indent, key, rest };
+            depth = path.length;
+        }
+        stack.push({ key, indent });
+        const value = valueOf(rest);
+        if (value.startsWith('|') || value.startsWith('>'))
+            skipFrom = indent + 1; // block scalar content
+    }
+    return { parent, depth };
+}
+/**
+ * Rewrite `leaf`'s value to `scalar`, keeping its indentation, its key, and any inline comment —
+ * realigned to the column it already occupied whenever the new value still leaves room for it, so a
+ * hand-aligned annotation block stays aligned. Returns `undefined` when the value spills past this
+ * one line (block scalar, nested block, hanging sequence): no single-line edit exists then.
+ */
+function replaceLeafValue(lines, leaf, scalar) {
+    const value = valueOf(leaf.rest);
+    if (value.startsWith('|') || value.startsWith('>'))
+        return undefined;
+    if (hasContinuation(lines, leaf.line, leaf.indent))
+        return undefined;
+    const head = `${' '.repeat(leaf.indent)}${leaf.key}: ${scalar}`;
+    const commentIndex = inlineCommentIndex(leaf.rest);
+    if (commentIndex < 0) {
+        lines[leaf.line] = head;
+        return lines;
+    }
+    const column = leaf.indent + leaf.key.length + 1 + commentIndex;
+    const gap = column > head.length ? ' '.repeat(column - head.length) : ' ';
+    lines[leaf.line] = head + gap + leaf.rest.slice(commentIndex);
+    return lines;
+}
+/**
+ * Append `remaining` (the still-missing tail of the key path) to the end of `parent`'s block — or to
+ * the end of the document when `parent` is absent, i.e. the whole path is new. The new key lands
+ * after the block's last content line and *before* any trailing comment lines, so a comment that
+ * introduces the next section keeps introducing it. Returns `undefined` when the parent cannot hold
+ * a mapping key (it already holds an inline scalar, or its block is a sequence).
+ */
+function insertKeyPath(lines, parent, remaining, scalar) {
+    if (parent !== undefined && valueOf(parent.rest) !== '')
+        return undefined;
+    const containerLine = parent?.line ?? -1;
+    const containerIndent = parent?.indent ?? -1;
+    let blockEnd = containerLine;
+    let childIndent;
+    for (let i = containerLine + 1; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (line.trim() === '')
+            continue;
+        const indent = indentOf(line);
+        if (indent <= containerIndent)
+            break;
+        if (line.trimStart().startsWith('#'))
+            continue;
+        if (childIndent === undefined) {
+            if (line.trimStart().startsWith('-'))
+                return undefined; // the block is a sequence, not a mapping
+            childIndent = indent;
+        }
+        blockEnd = i;
+    }
+    const baseIndent = childIndent ?? (parent === undefined ? 0 : parent.indent + 2);
+    const inserted = remaining.map((segment, index) => {
+        const indent = ' '.repeat(baseIndent + index * 2);
+        return index === remaining.length - 1 ? `${indent}${segment}: ${scalar}` : `${indent}${segment}:`;
+    });
+    lines.splice(blockEnd + 1, 0, ...inserted);
+    return lines;
+}
+/**
+ * Render `value` as the YAML scalar token `js-yaml`'s own `dump()` would emit for it, so an in-place
+ * edit writes byte-identical bytes to a whole-file re-serialization at that position. This is what
+ * keeps `dna set`'s scalar-coercion contract intact: `dump('2')` is `'2'`, which reads back as the
+ * STRING `'2'` (and so still fails `version`'s `z.number()`), whereas a bare `2` would read back as
+ * a number. `undefined` when the scalar is itself multi-line (e.g. a `|-` block) — not inlinable.
+ */
+function renderScalar(value) {
+    const scalar = (0, js_yaml_1.dump)(value, { lineWidth: -1 }).replace(/\n$/, '');
+    return scalar.includes('\n') ? undefined : scalar;
+}
+/** Whether `text` parses and the (already alias-resolved) `segments` read back as exactly `scalar`. */
+function readsBackAs(text, segments, scalar) {
+    let node;
+    let expected;
+    try {
+        node = (0, js_yaml_1.load)(text);
+        expected = (0, js_yaml_1.load)(scalar);
+    }
+    catch {
+        return false;
+    }
+    for (const segment of segments) {
+        if (typeof node !== 'object' || node === null || Array.isArray(node))
+            return false;
+        if (!Object.prototype.hasOwnProperty.call(node, segment))
+            return false;
+        node = node[segment];
+    }
+    return node === expected;
+}
+/**
+ * Set the (alias-resolved) dotted `keyPath` to `value` inside the RAW TEXT of a `dna.yaml`, editing
+ * as few bytes as possible: one line rewritten, or one line inserted. Everything else — every
+ * comment, including the inline `[SPEC]`/`[AUTHORING]` field-provenance annotations, and every blank
+ * line, quote style and alignment — is returned byte-for-byte unchanged.
+ *
+ * This is `dna set`'s primary write path (bug-004): re-serializing the parsed object through
+ * `dump()` is correct but discards every comment token, which silently voids the field-provenance
+ * convention — a `[SPEC]` field may only be removed or renamed after changing the specification it
+ * cites, and that cannot be audited once the annotations are gone. A textual edit also needs no
+ * comment-preserving YAML library, keeping `dl-010-minimal-dependencies` intact.
+ *
+ * Returns `undefined` — deliberately, not as an error — whenever a provably-minimal edit does not
+ * exist, leaving the caller to fall back to the whole-file `dump()`:
+ * - `text` is not a single, valid YAML document;
+ * - the key path is malformed (the caller has already raised the exit-2 usage error for it);
+ * - the value's own YAML form is multi-line;
+ * - the target, or an ancestor of it, is a block/multi-line scalar, opens a nested block, or holds
+ *   an inline scalar the path would have to descend through;
+ * - the parent block is a sequence rather than a mapping;
+ * - the edited text does not read back with the target key holding exactly the intended scalar.
+ *
+ * The result is a pure function of `(text, keyPath, value)` — no wall-clock, randomness or unordered
+ * iteration anywhere on the path (REQ-SYS-07).
+ */
+function setDnaValueInText(text, keyPath, value) {
+    // task-093/bug-084: the write path does NOT apply `DNA_KEY_ALIASES` — see that constant's own note.
+    // task-099: one parser for every path, so a quoted segment means the same here as at the resolver,
+    // and a malformed path is the single `ok: false` this function turns into its `undefined` fallback.
+    const split = splitDnaPath(keyPath);
+    if (!split.ok)
+        return undefined;
+    const segments = split.segments;
+    try {
+        (0, js_yaml_1.load)(text); // a single, parseable document: never "repair" input the caller could not read
+    }
+    catch {
+        return undefined;
+    }
+    const scalar = renderScalar(value);
+    if (scalar === undefined)
+        return undefined;
+    const lines = text.split('\n');
+    const resolved = resolveKeyPath(lines, segments);
+    const edited = resolved.leaf !== undefined
+        ? replaceLeafValue(lines.slice(), resolved.leaf, scalar)
+        : insertKeyPath(lines.slice(), resolved.parent, segments.slice(resolved.depth), scalar);
+    if (edited === undefined)
+        return undefined;
+    const result = edited.join('\n');
+    return readsBackAs(result, segments, scalar) ? result : undefined;
+}
+//# sourceMappingURL=set.js.map

package/dist/dna/set.js.map

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

package/dist/mcp/dna-resource.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** Options for {@link registerDnaResources}. */
+export interface RegisterDnaResourcesOptions {
+    /** Resolves the project root each DNA Resource read is served from (an ambient concern, not a request parameter). */
+    readonly resolveRoot: () => string;
+}
+/** spec-004 §2.1 — the whole `dna.yaml` document. */
+export declare const DNA_WHOLE_URI = "wingfoil://dna";
+/** spec-004 §2.1 — one top-level `dna.yaml` section (`team`, `paths`, `modules`, `stacks`, ...). */
+export declare const DNA_SECTION_URI_TEMPLATE = "wingfoil://dna/{section}";
+/**
+ * Register both DNA Resources on `server`. Reads `.wingfoil/dna.yaml` fresh on every request (no
+ * server-lifetime cache), matching every other Resource this task registers.
+ */
+export declare function registerDnaResources(server: McpServer, options: RegisterDnaResourcesOptions): void;
+//# sourceMappingURL=dna-resource.d.ts.map

package/dist/mcp/dna-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-resource.d.ts","sourceRoot":"","sources":["../../src/mcp/dna-resource.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,qHAAqH;IACrH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED,qDAAqD;AACrD,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAC9C,oGAAoG;AACpG,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CA+BlG"}

package/dist/mcp/dna-resource.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DNA_SECTION_URI_TEMPLATE = exports.DNA_WHOLE_URI = void 0;
+exports.registerDnaResources = registerDnaResources;
+/**
+ * `wingfoil://dna` (whole file) and `wingfoil://dna/{section}` (one top-level key) Resources —
+ * task-011-mcp-resources-read-only, REQ-INT-01, spec-004-mcp-surface-contract §2.1. Distinct from
+ * `registerCoreModules`'s existing, mechanically-derived `wingfoil://dna/show` Resource
+ * (task-006-dual-interface-shared-core): that URI is `registerCoreModules`'s generic
+ * `wingfoil://{module}/{verb}` transform of the `dnaShow` `CoreOperation` and is left untouched here —
+ * this module adds the spec-004 §2.1-conformant addressing alongside it (both can and do coexist on
+ * the same server; they are different URIs, never registered twice for one address).
+ *
+ * `{section}` is any top-level key of the parsed `dna.yaml` document (`version`, `project`, `modules`,
+ * `stacks`, `team`, `paths`) — spec-002-dna-yaml-schema's own top-level shape, not a hand-maintained
+ * allowlist here, so a future DNA schema field is addressable the moment it exists in `dna.yaml`
+ * without a change to this module.
+ *
+ * Registered directly via `McpServer.registerResource`, not through `registerCoreModules`'s
+ * `CoreModule[]` registry — no `dnaSection`/`dnaShowFull` `CoreOperation` exists yet; same
+ * spec-006-core-domain-api §4 parity deviation `memory-resource.ts` documents for its own two
+ * Resources, for the same reason (task-030-implement-mcp-resources' scope, not this task's).
+ */
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const core_1 = require("../core");
+const read_only_1 = require("./read-only");
+/** spec-004 §2.1 — the whole `dna.yaml` document. */
+exports.DNA_WHOLE_URI = 'wingfoil://dna';
+/** spec-004 §2.1 — one top-level `dna.yaml` section (`team`, `paths`, `modules`, `stacks`, ...). */
+exports.DNA_SECTION_URI_TEMPLATE = 'wingfoil://dna/{section}';
+/**
+ * Register both DNA Resources on `server`. Reads `.wingfoil/dna.yaml` fresh on every request (no
+ * server-lifetime cache), matching every other Resource this task registers.
+ */
+function registerDnaResources(server, options) {
+    server.registerResource('dna.read', exports.DNA_WHOLE_URI, { description: 'the whole dna.yaml document (read-only)' }, async (uri, extra) => {
+        (0, read_only_1.refuseIfWriteIntent)(extra._meta);
+        const root = options.resolveRoot();
+        const dna = (0, core_1.loadDnaYaml)(root);
+        return (0, read_only_1.jsonResourceResult)(uri, dna);
+    });
+    const sectionTemplate = new mcp_js_1.ResourceTemplate(exports.DNA_SECTION_URI_TEMPLATE, { list: undefined });
+    server.registerResource('dna.section', sectionTemplate, { description: 'one top-level dna.yaml section (read-only)' }, async (uri, variables, extra) => {
+        (0, read_only_1.refuseIfWriteIntent)(extra._meta);
+        const root = options.resolveRoot();
+        const dna = (0, core_1.loadDnaYaml)(root);
+        // `variables.section` is typed `string | string[]` (see `memory-resource.ts`'s identical note
+        // on `{type}`/`{id}`) — this template's `{section}` has no explode modifier, so it is always a
+        // single string in practice.
+        const section = variables.section;
+        if (!(section in dna))
+            throw (0, read_only_1.resourceNotFoundError)(`dna/${section}`);
+        return (0, read_only_1.jsonResourceResult)(uri, dna[section]);
+    });
+}
+//# sourceMappingURL=dna-resource.js.map

package/dist/mcp/dna-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dna-resource.js","sourceRoot":"","sources":["../../src/mcp/dna-resource.ts"],"names":[],"mappings":";;;AAyCA,oDA+BC;AAxED;;;;;;;;;;;;;;;;;;GAkBG;AACH,oEAA2E;AAG3E,kCAAsC;AAEtC,2CAA6F;AAQ7F,qDAAqD;AACxC,QAAA,aAAa,GAAG,gBAAgB,CAAC;AAC9C,oGAAoG;AACvF,QAAA,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,OAAoC;IAC1F,MAAM,CAAC,gBAAgB,CACrB,UAAU,EACV,qBAAa,EACb,EAAE,WAAW,EAAE,yCAAyC,EAAE,EAC1D,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnB,IAAA,+BAAmB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAA,kBAAW,EAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAA,8BAAkB,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC,CACF,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,yBAAgB,CAAC,gCAAwB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5F,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,eAAe,EACf,EAAE,WAAW,EAAE,4CAA4C,EAAE,EAC7D,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE;QAC9B,IAAA,+BAAmB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAA,kBAAW,EAAC,IAAI,CAA4B,CAAC;QACzD,8FAA8F;QAC9F,+FAA+F;QAC/F,6BAA6B;QAC7B,MAAM,OAAO,GAAG,SAAS,CAAC,OAAiB,CAAC;QAC5C,IAAI,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;YAAE,MAAM,IAAA,iCAAqB,EAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAErE,OAAO,IAAA,8BAAkB,EAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `mcp-server` module — agent interface (MCP over stdio, Anthropic SDK); Resources, Prompts, Tools.
+ * Path is `src/mcp` per `dna.yaml`'s module entry (`name: mcp-server`, `path: src/mcp`).
+ *
+ * task-006-dual-interface-shared-core adds the thin adapter (spec-006 §2, spec-004): `registerCoreModules`
+ * derives every MCP Tool (mutating) and Resource (read-only) from the same `CoreModule[]` registry
+ * `src/cli` builds its commands from (`src/core/index.ts`'s `CORE_MODULES`), with no business logic
+ * of its own.
+ *
+ * task-011-mcp-resources-read-only adds the spec-004-mcp-surface-contract §2-conformant Resources
+ * channel (REQ-INT-01 / REQ-SEC-05): `registerMemoryResources` (`wingfoil://memory/{type}`,
+ * `wingfoil://memory/{type}/{id}` — REPLACING task-009-mcp-resource-fetch-latency's placeholder
+ * `wingfoil://memory/{id}` adapter), `registerDnaResources` (`wingfoil://dna`, `wingfoil://dna/{section}`),
+ * `registerWorkflowResources` (`wingfoil://workflows`, `wingfoil://workflows/{name}`), and
+ * `registerWriteRefusalHandler` (the structural `resources/write` refusal, spec-004 §2.3).
+ * `registerReadOnlyResources` wires all four together — the one call a future production entry point
+ * (`task-030-implement-mcp-resources`'s `StdioServerTransport`/`wingfoil mcp` command, out of this
+ * task's scope) needs alongside `registerCoreModules`. See `./read-only.ts` for the shared
+ * write-refusal/not-found conventions every one of these Resources follows.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/** This module's `dna.yaml` name (`mcp-server`) — the stable identifier surfaces and tests key it by. */
+export declare const MODULE_NAME: "mcp-server";
+export { registerCoreModules, deriveMcpToolName, deriveMcpResourceUri } from './registrar';
+export type { RegisterCoreModulesOptions } from './registrar';
+export { registerMemoryResources, MEMORY_COLLECTION_URI_TEMPLATE, MEMORY_DOCUMENT_URI_TEMPLATE, } from './memory-resource';
+export type { RegisterMemoryResourcesOptions } from './memory-resource';
+export { registerDnaResources, DNA_WHOLE_URI, DNA_SECTION_URI_TEMPLATE } from './dna-resource';
+export type { RegisterDnaResourcesOptions } from './dna-resource';
+export { registerWorkflowResources, WORKFLOWS_COLLECTION_URI, WORKFLOW_DOCUMENT_URI_TEMPLATE, } from './workflow-resource';
+export type { RegisterWorkflowResourcesOptions } from './workflow-resource';
+export { registerWriteRefusalHandler, refuseIfWriteIntent, resourceNotFoundError, WRITE_REFUSAL_MESSAGE, WRITE_INTENT_META_KEY, } from './read-only';
+export { registerRolePrompts, roleSessionPromptName } from './prompt';
+export type { RegisterRolePromptsOptions } from './prompt';
+/** Options for {@link registerReadOnlyResources}. */
+export interface RegisterReadOnlyResourcesOptions {
+    /** Resolves the project root each Resource read is served from (an ambient concern, not a request parameter). */
+    readonly resolveRoot: () => string;
+}
+/**
+ * Wire the full spec-004 §2 read-only Resources channel onto `server` in one call: the Memory, DNA,
+ * and Workflow Resources plus the structural `resources/write` refusal. Deliberately does not touch
+ * `registerCoreModules`/`CORE_MODULES` — a caller building a real server still calls that separately
+ * for the (today, zero) Tools/legacy-shaped Resources it derives from `src/core`.
+ */
+export declare function registerReadOnlyResources(server: McpServer, options: RegisterReadOnlyResourcesOptions): void;
+export { createMcpServer, startMcpServer } from './server';
+export type { McpServerOptions } from './server';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,yGAAyG;AACzG,eAAO,MAAM,WAAW,EAAG,YAAqB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtE,YAAY,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAO3D,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gCAAgC,GAAG,IAAI,CAK5G;AAMD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}