wingfoil 0.2.1

package/dist/directives/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAssignedDirectives = exports.setRoleAssignmentsInText = exports.parseDirectiveIds = exports.renderCustomDirective = exports.isValidDirectiveName = exports.directiveTitleFromName = exports.INVALID_DIRECTIVE_NAME_MESSAGE = exports.RolesYaml = exports.DirectiveFrontmatter = exports.MODULE_NAME = void 0;
+/**
+ * `directives` module — Project Directives pillar; role-based rules (built-in + custom) (P3.5/P3.8).
+ * `DirectiveFrontmatter` (an [AUTHORING]-level minimal schema — see `./schema` for why there is no
+ * dedicated tech-spec yet) lives here — the pillar owns its own independent schema (REQ-SYS-02);
+ * `src/core`'s loader wires it through the shared validation pipeline. `./create`
+ * (task-050-directive-create, P3.1) adds the pillar's first *authoring* helpers — the kebab-case
+ * name rule and the generated file's content — which `src/core`'s `directiveCreate` operation
+ * composes with the git-identity pre-flight, write and commit. `./roles-edit`
+ * (task-051-directive-assign, P3.2) adds the pure, comment-preserving `roles.yaml` assignment edit that
+ * `src/core`'s `directiveAssign` writes through, and `parseDirectiveIds`
+ * (task-056-role-based-directive-assignment, P3.7) the comma-separated `--directive` value parser that
+ * makes the same verb bind several directives at once. `directive remove` (P3.3, task-052) reuses none
+ * of it — it refuses a still-assigned directive rather than unbinding it. Further Directives behavior
+ * lands in later tasks.
+ */
+exports.MODULE_NAME = 'directives';
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "DirectiveFrontmatter", { enumerable: true, get: function () { return schema_1.DirectiveFrontmatter; } });
+Object.defineProperty(exports, "RolesYaml", { enumerable: true, get: function () { return schema_1.RolesYaml; } });
+var create_1 = require("./create");
+Object.defineProperty(exports, "INVALID_DIRECTIVE_NAME_MESSAGE", { enumerable: true, get: function () { return create_1.INVALID_DIRECTIVE_NAME_MESSAGE; } });
+Object.defineProperty(exports, "directiveTitleFromName", { enumerable: true, get: function () { return create_1.directiveTitleFromName; } });
+Object.defineProperty(exports, "isValidDirectiveName", { enumerable: true, get: function () { return create_1.isValidDirectiveName; } });
+Object.defineProperty(exports, "renderCustomDirective", { enumerable: true, get: function () { return create_1.renderCustomDirective; } });
+var roles_edit_1 = require("./roles-edit");
+Object.defineProperty(exports, "parseDirectiveIds", { enumerable: true, get: function () { return roles_edit_1.parseDirectiveIds; } });
+Object.defineProperty(exports, "setRoleAssignmentsInText", { enumerable: true, get: function () { return roles_edit_1.setRoleAssignmentsInText; } });
+Object.defineProperty(exports, "withAssignedDirectives", { enumerable: true, get: function () { return roles_edit_1.withAssignedDirectives; } });
+//# sourceMappingURL=index.js.map

package/dist/directives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACU,QAAA,WAAW,GAAG,YAAqB,CAAC;AAEjD,mCAA2D;AAAlD,8GAAA,oBAAoB,OAAA;AAAE,mGAAA,SAAS,OAAA;AAExC,mCAKkB;AAJhB,wHAAA,8BAA8B,OAAA;AAC9B,gHAAA,sBAAsB,OAAA;AACtB,8GAAA,oBAAoB,OAAA;AACpB,+GAAA,qBAAqB,OAAA;AAGvB,2CAAmG;AAA1F,+GAAA,iBAAiB,OAAA;AAAE,sHAAA,wBAAwB,OAAA;AAAE,oHAAA,sBAAsB,OAAA"}

package/dist/directives/roles-edit.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The set semantics of assigning `ids` to a role currently bound to `current`: existing ids keep
+ * their order, ids not yet present are appended in argument order, and no id ever appears twice
+ * (P3.7 "Binding is idempotent"). No sorting, so an assignment never moves an existing line.
+ *
+ * @param current - The role's current assignment list (from `roles.yaml`).
+ * @param ids - Directive ids to assign.
+ * @returns A new array; `current` is not mutated.
+ */
+export declare function withAssignedDirectives(current: readonly string[], ids: readonly string[]): string[];
+/**
+ * Parse the CLI `--directive "a,b,c"` value into the directive ids it names (P3.7, US-4-06,
+ * task-056-role-based-directive-assignment): split on commas, trim each segment, drop the empty ones,
+ * and de-duplicate keeping each id's FIRST position.
+ *
+ * The comma-separated spelling follows `memory add --tags "a,b"` (`parseTags`, `src/memory/add.ts`),
+ * the project's existing list-valued option: the CLI option seam carries one `string` per `--{name}`
+ * (`CliCommand.options` → `ParamsContext.options`), so a list travels inside the value rather than as
+ * a repeated flag. A value with no comma yields a one-element list, which is why P3.2's single-id
+ * invocation is byte-for-byte unchanged.
+ *
+ * De-duplication happens here rather than being left to {@link withAssignedDirectives} — which also
+ * de-duplicates — because this list is *echoed*: it becomes `DirectiveAssignResult.directives` and the
+ * ids named in the commit subject, and `--directive testing,testing` must not produce a subject naming
+ * `testing` twice.
+ *
+ * @param raw - The raw `--directive` value.
+ * @returns The ids, in argument order, without duplicates; **empty** when the value contributes none
+ *   (`""`, `"  "`, `","`), which the caller treats as a missing argument rather than as an empty id —
+ *   `directiveAssignFn`, spec-008 §4.
+ */
+export declare function parseDirectiveIds(raw: string): string[];
+/**
+ * Rewrite `assignments.<role>` in the raw `roles.yaml` text to exactly `next`, leaving every other
+ * line — comments, blank lines, other roles, `global`, inline comments on kept items — byte-for-byte
+ * intact.
+ *
+ * `next` is realized as the current list with some items deleted (greedy in-order match) followed by
+ * appended ids, so it covers assignment (append), removal (delete) and any combination. New item
+ * lines adopt the indentation of the role's existing items (else the key's indentation + 2); a role
+ * with no `assignments` entry yet (dl-029) gets its key inserted after the block's last content line,
+ * before any trailing blank/comment lines. An emptied list becomes `role: []`; an empty flow list
+ * `role: []` becomes a block list. CRLF files keep CRLF.
+ *
+ * @param text - The current `roles.yaml` file content.
+ * @param role - The role whose assignment list is rewritten.
+ * @param next - The exact list `assignments.<role>` must hold afterwards.
+ * @returns The edited text; `text` itself when nothing changes; `undefined` when the edit cannot be
+ *   made provably — no block `assignments:` mapping, a non-empty flow list, a non-scalar or multi-line
+ *   item, tab indentation, mixed line endings, or a re-parse that does not read back as intended.
+ */
+export declare function setRoleAssignmentsInText(text: string, role: string, next: readonly string[]): string | undefined;
+//# sourceMappingURL=roles-edit.d.ts.map

package/dist/directives/roles-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles-edit.d.ts","sourceRoot":"","sources":["../../src/directives/roles-edit.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAMnG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAOvD;AAkED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CA4ChH"}

package/dist/directives/roles-edit.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAssignedDirectives = withAssignedDirectives;
+exports.parseDirectiveIds = parseDirectiveIds;
+exports.setRoleAssignmentsInText = setRoleAssignmentsInText;
+/**
+ * Pure, comment-preserving edits of `.wingfoil/roles.yaml` role → directive assignments
+ * (task-051-directive-assign, P3.2), plus the `--directive a,b,c` value parser multi-directive
+ * assignment needs (task-056-role-based-directive-assignment, P3.7).
+ *
+ * P3.7 reuses {@link withAssignedDirectives} and {@link setRoleAssignmentsInText} unchanged — both
+ * were written to take a *list* of ids from the start. `directive remove` (P3.3, task-052) reuses
+ * **neither**: P3.3 refuses a still-assigned directive rather than unbinding it, so a removal has no
+ * `roles.yaml` write to make (see `src/core/directive-assign.ts`'s module doc).
+ *
+ * `roles.yaml` is hand-annotated configuration, so a whole-file `js-yaml` `dump()` — which drops every
+ * comment — is not an acceptable write path (bug-004 for `dna.yaml`, and bug-019 for the silent
+ * fallback). Like `setDnaValueInText` (`src/dna/set.ts`, task-063) this module edits the raw text
+ * line by line, touching only the lines of one role's list, and needs no YAML CST dependency
+ * (dl-010). Anything it cannot edit provably yields `undefined`, leaving the fallback decision to the
+ * caller.
+ *
+ * Zero imports besides `js-yaml`: no filesystem, no git, no clock (REQ-SYS-07 — outputs are a pure
+ * function of the inputs), and no dependency on `src/core` (the pillar stays a leaf).
+ */
+const js_yaml_1 = require("js-yaml");
+/**
+ * The set semantics of assigning `ids` to a role currently bound to `current`: existing ids keep
+ * their order, ids not yet present are appended in argument order, and no id ever appears twice
+ * (P3.7 "Binding is idempotent"). No sorting, so an assignment never moves an existing line.
+ *
+ * @param current - The role's current assignment list (from `roles.yaml`).
+ * @param ids - Directive ids to assign.
+ * @returns A new array; `current` is not mutated.
+ */
+function withAssignedDirectives(current, ids) {
+    const next = [...current];
+    for (const id of ids) {
+        if (!next.includes(id))
+            next.push(id);
+    }
+    return next;
+}
+/**
+ * Parse the CLI `--directive "a,b,c"` value into the directive ids it names (P3.7, US-4-06,
+ * task-056-role-based-directive-assignment): split on commas, trim each segment, drop the empty ones,
+ * and de-duplicate keeping each id's FIRST position.
+ *
+ * The comma-separated spelling follows `memory add --tags "a,b"` (`parseTags`, `src/memory/add.ts`),
+ * the project's existing list-valued option: the CLI option seam carries one `string` per `--{name}`
+ * (`CliCommand.options` → `ParamsContext.options`), so a list travels inside the value rather than as
+ * a repeated flag. A value with no comma yields a one-element list, which is why P3.2's single-id
+ * invocation is byte-for-byte unchanged.
+ *
+ * De-duplication happens here rather than being left to {@link withAssignedDirectives} — which also
+ * de-duplicates — because this list is *echoed*: it becomes `DirectiveAssignResult.directives` and the
+ * ids named in the commit subject, and `--directive testing,testing` must not produce a subject naming
+ * `testing` twice.
+ *
+ * @param raw - The raw `--directive` value.
+ * @returns The ids, in argument order, without duplicates; **empty** when the value contributes none
+ *   (`""`, `"  "`, `","`), which the caller treats as a missing argument rather than as an empty id —
+ *   `directiveAssignFn`, spec-008 §4.
+ */
+function parseDirectiveIds(raw) {
+    const ids = [];
+    for (const segment of raw.split(',')) {
+        const id = segment.trim();
+        if (id.length > 0 && !ids.includes(id))
+            ids.push(id);
+    }
+    return ids;
+}
+const COMMENT_OR_BLANK = /^\s*(#.*)?$/;
+const EMPTY_FLOW_VALUE = /^(\s*.*?):\s*\[\s*\](\s*#.*)?$/;
+const NULL_VALUE = /^(\s*.*?):(\s+#.*)?$/;
+const ITEM = /^-\s+(.*)$/;
+function parseLine(raw) {
+    const body = raw.trimStart();
+    return { indent: raw.length - body.length, body };
+}
+function isContent(raw) {
+    return !COMMENT_OR_BLANK.test(raw);
+}
+/** Parse a YAML fragment, or `undefined` when it is not valid YAML. */
+function tryLoad(text) {
+    try {
+        return (0, js_yaml_1.load)(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Render a scalar exactly as a whole-file `dump` would, or `undefined` when it would span lines. */
+function renderScalar(value) {
+    const rendered = (0, js_yaml_1.dump)(value, { lineWidth: -1 }).replace(/\n$/, '');
+    return rendered.includes('\n') ? undefined : rendered;
+}
+/** The single key and value of a `key: value` mapping line, or `undefined` when it is not one. */
+function mappingEntry(body) {
+    const parsed = tryLoad(body);
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
+        return undefined;
+    const keys = Object.keys(parsed);
+    if (keys.length !== 1)
+        return undefined;
+    return { key: keys[0], value: parsed[keys[0]] };
+}
+function sameJson(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * Read `edited` back and confirm `assignments.<role>` is exactly `next` while every other top-level
+ * key and every other role is unchanged — the safety net behind the textual edit (it catches, e.g., a
+ * YAML alias elsewhere in the file that would silently change along with the edited list).
+ */
+function readsBackAs(original, edited, role, next) {
+    const before = tryLoad(original);
+    const after = tryLoad(edited);
+    if (!before || !after)
+        return false;
+    const beforeAssignments = { ...before.assignments };
+    const afterAssignments = { ...after.assignments };
+    const roleMatches = sameJson(afterAssignments[role], next);
+    delete beforeAssignments[role];
+    delete afterAssignments[role];
+    return roleMatches && sameJson({ ...before, assignments: beforeAssignments }, { ...after, assignments: afterAssignments });
+}
+/**
+ * Rewrite `assignments.<role>` in the raw `roles.yaml` text to exactly `next`, leaving every other
+ * line — comments, blank lines, other roles, `global`, inline comments on kept items — byte-for-byte
+ * intact.
+ *
+ * `next` is realized as the current list with some items deleted (greedy in-order match) followed by
+ * appended ids, so it covers assignment (append), removal (delete) and any combination. New item
+ * lines adopt the indentation of the role's existing items (else the key's indentation + 2); a role
+ * with no `assignments` entry yet (dl-029) gets its key inserted after the block's last content line,
+ * before any trailing blank/comment lines. An emptied list becomes `role: []`; an empty flow list
+ * `role: []` becomes a block list. CRLF files keep CRLF.
+ *
+ * @param text - The current `roles.yaml` file content.
+ * @param role - The role whose assignment list is rewritten.
+ * @param next - The exact list `assignments.<role>` must hold afterwards.
+ * @returns The edited text; `text` itself when nothing changes; `undefined` when the edit cannot be
+ *   made provably — no block `assignments:` mapping, a non-empty flow list, a non-scalar or multi-line
+ *   item, tab indentation, mixed line endings, or a re-parse that does not read back as intended.
+ */
+function setRoleAssignmentsInText(text, role, next) {
+    const crlf = text.includes('\r\n');
+    if (crlf && text.replace(/\r\n/g, '').includes('\n'))
+        return undefined;
+    if (!crlf && text.includes('\r'))
+        return undefined;
+    const eol = crlf ? '\r\n' : '\n';
+    const lines = text.split(eol);
+    if (lines.some((raw) => /^\s*\t/.test(raw)))
+        return undefined;
+    const header = lines.findIndex((raw) => /^assignments:(\s+#.*)?$/.test(raw));
+    if (header < 0)
+        return undefined;
+    // The block runs until the next top-level content line; its insertion point is after its last
+    // content line, so trailing blank/comment lines stay attached to whatever follows.
+    let end = header + 1;
+    let lastContent = header;
+    while (end < lines.length) {
+        const raw = lines[end];
+        if (isContent(raw)) {
+            if (parseLine(raw).indent === 0)
+                break;
+            lastContent = end;
+        }
+        end += 1;
+    }
+    const firstChild = lines.slice(header + 1, lastContent + 1).find(isContent);
+    const childIndent = firstChild === undefined ? 2 : parseLine(firstChild).indent;
+    let keyIndex = -1;
+    for (let i = header + 1; i <= lastContent; i += 1) {
+        const raw = lines[i];
+        const line = parseLine(raw);
+        if (!isContent(raw) || line.indent !== childIndent || line.body.startsWith('-'))
+            continue;
+        const entry = mappingEntry(line.body);
+        if (entry === undefined)
+            return undefined;
+        if (entry.key === role)
+            keyIndex = i;
+    }
+    const edited = keyIndex < 0
+        ? insertRole(lines, header, lastContent, childIndent, role, next)
+        : rewriteRole(lines, keyIndex, childIndent, lastContent, next);
+    if (edited === undefined)
+        return undefined;
+    const result = edited.join(eol);
+    if (result === text)
+        return text;
+    return readsBackAs(text, result, role, next) ? result : undefined;
+}
+function insertRole(lines, header, lastContent, childIndent, role, next) {
+    if (next.length === 0)
+        return [...lines];
+    const key = renderScalar(role);
+    const items = next.map(renderScalar);
+    if (key === undefined || items.some((item) => item === undefined))
+        return undefined;
+    // Reuse the item indentation of an existing sibling list, so the new key matches its neighbours.
+    const siblingItem = lines
+        .slice(header + 1, lastContent + 1)
+        .map(parseLine)
+        .reverse()
+        .find((line) => line.body.startsWith('- '));
+    const itemIndent = siblingItem ? siblingItem.indent : childIndent + 2;
+    const inserted = [
+        `${' '.repeat(childIndent)}${key}:`,
+        ...items.map((item) => `${' '.repeat(itemIndent)}- ${item}`),
+    ];
+    return [...lines.slice(0, lastContent + 1), ...inserted, ...lines.slice(lastContent + 1)];
+}
+function rewriteRole(lines, keyIndex, childIndent, lastContent, next) {
+    const keyLine = lines[keyIndex];
+    const entry = mappingEntry(parseLine(keyLine).body);
+    const isEmptyFlow = Array.isArray(entry?.value) && (entry?.value).length === 0;
+    if (!isEmptyFlow && entry?.value !== null)
+        return undefined;
+    // Collect the role's item lines (and interleaved comments) up to the next sibling key.
+    const itemIndices = [];
+    const current = [];
+    let i = keyIndex + 1;
+    for (; i <= lastContent; i += 1) {
+        const raw = lines[i];
+        if (!isContent(raw))
+            continue;
+        const line = parseLine(raw);
+        if (line.indent < childIndent || (line.indent === childIndent && !line.body.startsWith('-')))
+            break;
+        const item = ITEM.exec(line.body);
+        if (isEmptyFlow || item === null)
+            return undefined;
+        const value = tryLoad(item[1]);
+        if (typeof value !== 'string')
+            return undefined;
+        itemIndices.push(i);
+        current.push(value);
+    }
+    // Greedy in-order match: keep the current items `next` still wants, in order; delete the rest;
+    // append whatever of `next` is left.
+    const deleted = new Set();
+    let matched = 0;
+    current.forEach((id, index) => {
+        if (matched < next.length && next[matched] === id)
+            matched += 1;
+        else
+            deleted.add(itemIndices[index]);
+    });
+    const appended = next.slice(matched).map(renderScalar);
+    if (appended.some((item) => item === undefined))
+        return undefined;
+    const firstItem = itemIndices[0];
+    const itemIndent = firstItem === undefined ? childIndent + 2 : parseLine(lines[firstItem]).indent;
+    const appendAfter = itemIndices.length > 0 ? itemIndices[itemIndices.length - 1] : keyIndex;
+    const newItems = appended.map((item) => `${' '.repeat(itemIndent)}- ${item}`);
+    const out = [];
+    lines.forEach((raw, index) => {
+        if (deleted.has(index)) {
+            if (index === appendAfter)
+                out.push(...newItems);
+            return;
+        }
+        if (index === keyIndex)
+            out.push(renderKeyLine(raw, next.length === 0));
+        else
+            out.push(raw);
+        if (index === appendAfter)
+            out.push(...newItems);
+    });
+    return out;
+}
+/** The role's key line in block form (`key:`) or, for an emptied list, flow form (`key: []`). */
+function renderKeyLine(raw, empty) {
+    const flow = EMPTY_FLOW_VALUE.exec(raw);
+    const bare = flow ?? NULL_VALUE.exec(raw);
+    if (bare === null)
+        return raw;
+    const [, key, comment = ''] = bare;
+    return empty ? `${key}: []${comment}` : `${key}:${comment}`;
+}
+//# sourceMappingURL=roles-edit.js.map

package/dist/directives/roles-edit.js.map

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

package/dist/directives/schema.d.ts

@@ -0,0 +1,65 @@
+/**
+ * DirectiveFrontmatter schema (task-004-decoupled-pillars, REQ-SYS-02) — the fourth pillar named by
+ * this task's Acceptance Criteria ("memory.yaml, dna.yaml, directives/*.yaml, and workflows.yaml
+ * each validate against their own Zod schema independently").
+ *
+ * UNLIKE memory.yaml/dna.yaml/workflows.yaml, there is currently no dedicated, approved tech-spec
+ * for the Directives pillar's own file shape: spec-010-memory-frontmatter-schema's scope is
+ * explicitly `docs/self/docs/04_memory/**\/*.md frontmatter` (Memory documents), not
+ * `.wingfoil/directives/**` (Directives files are `.md` with YAML frontmatter, not `.yaml` — the
+ * AC's "directives/*.yaml" phrasing does not match the real file extension either). This schema is
+ * therefore an [AUTHORING]-level minimal shape, grounded directly in the fields every one of the
+ * twelve real files under `docs/self/.wingfoil/directives/custom/*.md` actually carries (`id`,
+ * `name`, `type: directive`, `kind`, `title`, `tags`, `ref`, and — on three files — `scope`), not a
+ * transcription of an approved spec. See this task's Execution Notes for why this was not treated
+ * as a hard STOP (design-gap) and the follow-up this leaves for the reviewer/approver (a candidate
+ * `spec-013-directive-frontmatter-schema`).
+ *
+ * `name` is REQUIRED, not merely observed: REQ-SYS-02's own traceability cites
+ * `p3-directives/P3.5-project-directives.feature`, whose "Error - a directive file missing required
+ * header fields" scenario is explicit ("Given a custom directive file lacks its required 'name'
+ * header ... Then loading reports the file as invalid") — the one piece of that BDD contract this
+ * schema honors even without a tech-spec of its own.
+ *
+ * `.passthrough()` per spec-009-validation-strategy §2, matching every other pillar schema.
+ */
+import { z } from 'zod';
+/**
+ * The YAML frontmatter of a `.wingfoil/directives/**\/*.md` file — the minimal [AUTHORING] shape
+ * grounded in the fields the real custom directive files carry (see the module doc for why there is
+ * no dedicated tech-spec). `name` is required per REQ-SYS-08's BDD contract. `.passthrough()` per
+ * spec-009 §2.
+ */
+export declare const DirectiveFrontmatter: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodLiteral<"directive">;
+    kind: z.ZodString;
+    title: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ref: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+/** Parsed shape of the {@link DirectiveFrontmatter} schema. */
+export type DirectiveFrontmatter = z.infer<typeof DirectiveFrontmatter>;
+/**
+ * `.wingfoil/roles.yaml` schema (task-037-role-task-scoped-context, REQ-STATE-05's
+ * `directive-loader`, P3.2/P3.7) — the role → directive binding config
+ * `resolveRoleDirectives`/`assembleExecutionContext` (`src/core/context.ts`) resolve against. Same
+ * [AUTHORING]-level rationale as {@link DirectiveFrontmatter}: no dedicated tech-spec covers this
+ * pillar's own file shapes yet (spec-012-context-loader-relevance-filtering §5 describes the
+ * `directive-loader`'s *behavior* — "look up the request role in `roles.yaml`" — but not roles.yaml's
+ * own schema), so this is grounded directly in the fields the real, live
+ * `docs/self/.wingfoil/roles.yaml` file carries: `version`, `assignments` (role name -> directive id
+ * array), and `global` (directive ids applied to every role). `assignments` keys are role names
+ * (validated against `dna.yaml`'s `team.roles` catalogue elsewhere, by REQ-SYS-08/task-034 — NOT here,
+ * to keep this pillar's schema independent per REQ-SYS-02); `assignments` values and `global` entries
+ * are directive **ids** (`DirectiveFrontmatter.id`), not `name`s. `.passthrough()` per spec-009 §2.
+ */
+export declare const RolesYaml: z.ZodObject<{
+    version: z.ZodOptional<z.ZodNumber>;
+    assignments: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    global: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>;
+/** Parsed shape of the {@link RolesYaml} schema. */
+export type RolesYaml = z.infer<typeof RolesYaml>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/directives/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/directives/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;iBAUjB,CAAC;AACjB,+DAA+D;AAC/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS;;;;iBAMN,CAAC;AACjB,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/directives/schema.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RolesYaml = exports.DirectiveFrontmatter = void 0;
+/**
+ * DirectiveFrontmatter schema (task-004-decoupled-pillars, REQ-SYS-02) — the fourth pillar named by
+ * this task's Acceptance Criteria ("memory.yaml, dna.yaml, directives/*.yaml, and workflows.yaml
+ * each validate against their own Zod schema independently").
+ *
+ * UNLIKE memory.yaml/dna.yaml/workflows.yaml, there is currently no dedicated, approved tech-spec
+ * for the Directives pillar's own file shape: spec-010-memory-frontmatter-schema's scope is
+ * explicitly `docs/self/docs/04_memory/**\/*.md frontmatter` (Memory documents), not
+ * `.wingfoil/directives/**` (Directives files are `.md` with YAML frontmatter, not `.yaml` — the
+ * AC's "directives/*.yaml" phrasing does not match the real file extension either). This schema is
+ * therefore an [AUTHORING]-level minimal shape, grounded directly in the fields every one of the
+ * twelve real files under `docs/self/.wingfoil/directives/custom/*.md` actually carries (`id`,
+ * `name`, `type: directive`, `kind`, `title`, `tags`, `ref`, and — on three files — `scope`), not a
+ * transcription of an approved spec. See this task's Execution Notes for why this was not treated
+ * as a hard STOP (design-gap) and the follow-up this leaves for the reviewer/approver (a candidate
+ * `spec-013-directive-frontmatter-schema`).
+ *
+ * `name` is REQUIRED, not merely observed: REQ-SYS-02's own traceability cites
+ * `p3-directives/P3.5-project-directives.feature`, whose "Error - a directive file missing required
+ * header fields" scenario is explicit ("Given a custom directive file lacks its required 'name'
+ * header ... Then loading reports the file as invalid") — the one piece of that BDD contract this
+ * schema honors even without a tech-spec of its own.
+ *
+ * `.passthrough()` per spec-009-validation-strategy §2, matching every other pillar schema.
+ */
+const zod_1 = require("zod");
+/**
+ * The YAML frontmatter of a `.wingfoil/directives/**\/*.md` file — the minimal [AUTHORING] shape
+ * grounded in the fields the real custom directive files carry (see the module doc for why there is
+ * no dedicated tech-spec). `name` is required per REQ-SYS-08's BDD contract. `.passthrough()` per
+ * spec-009 §2.
+ */
+exports.DirectiveFrontmatter = zod_1.z
+    .object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    type: zod_1.z.literal('directive'),
+    kind: zod_1.z.string(),
+    title: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    ref: zod_1.z.array(zod_1.z.string()).optional(),
+})
+    .passthrough();
+/**
+ * `.wingfoil/roles.yaml` schema (task-037-role-task-scoped-context, REQ-STATE-05's
+ * `directive-loader`, P3.2/P3.7) — the role → directive binding config
+ * `resolveRoleDirectives`/`assembleExecutionContext` (`src/core/context.ts`) resolve against. Same
+ * [AUTHORING]-level rationale as {@link DirectiveFrontmatter}: no dedicated tech-spec covers this
+ * pillar's own file shapes yet (spec-012-context-loader-relevance-filtering §5 describes the
+ * `directive-loader`'s *behavior* — "look up the request role in `roles.yaml`" — but not roles.yaml's
+ * own schema), so this is grounded directly in the fields the real, live
+ * `docs/self/.wingfoil/roles.yaml` file carries: `version`, `assignments` (role name -> directive id
+ * array), and `global` (directive ids applied to every role). `assignments` keys are role names
+ * (validated against `dna.yaml`'s `team.roles` catalogue elsewhere, by REQ-SYS-08/task-034 — NOT here,
+ * to keep this pillar's schema independent per REQ-SYS-02); `assignments` values and `global` entries
+ * are directive **ids** (`DirectiveFrontmatter.id`), not `name`s. `.passthrough()` per spec-009 §2.
+ */
+exports.RolesYaml = zod_1.z
+    .object({
+    version: zod_1.z.number().optional(),
+    assignments: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.string())),
+    global: zod_1.z.array(zod_1.z.string()).default([]),
+})
+    .passthrough();
+//# sourceMappingURL=schema.js.map

package/dist/directives/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/directives/schema.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,6BAAwB;AAExB;;;;;GAKG;AACU,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,GAAG,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAIjB;;;;;;;;;;;;;GAaG;AACU,QAAA,SAAS,GAAG,OAAC;KACvB,MAAM,CAAC;IACN,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/dna/edit.d.ts

@@ -0,0 +1,61 @@
+/** One step of a text path: a mapping key, or the index of an entry inside a block sequence. */
+export type DnaTextStep = {
+    readonly key: string;
+} | {
+    readonly index: number;
+};
+/** The minimal edits `applyDnaMutation` (`./mutate.ts`) expresses its result as. */
+export type DnaTextEdit = 
+/** Write `value` at the mapping key the path ends on, inserting the key when it is absent. */
+{
+    readonly kind: 'set-scalar';
+    readonly path: readonly DnaTextStep[];
+    readonly value: unknown;
+}
+/** Drop the mapping key the path ends on, with whatever block hangs below it. */
+ | {
+    readonly kind: 'delete-key';
+    readonly path: readonly DnaTextStep[];
+}
+/** Append `items` to the sequence the path ends on. */
+ | {
+    readonly kind: 'append-items';
+    readonly path: readonly DnaTextStep[];
+    readonly items: readonly unknown[];
+}
+/** Drop the items at `indexes` from the sequence the path ends on. */
+ | {
+    readonly kind: 'remove-items';
+    readonly path: readonly DnaTextStep[];
+    readonly indexes: readonly number[];
+}
+/** Replace the whole sequence the path ends on with `items`. */
+ | {
+    readonly kind: 'replace-list';
+    readonly path: readonly DnaTextStep[];
+    readonly items: readonly unknown[];
+}
+/** Apply several edits in order, verified once at the end (an entry update changing two fields). */
+ | {
+    readonly kind: 'batch';
+    readonly edits: readonly DnaTextEdit[];
+};
+/**
+ * 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`.
+ */
+export declare function applyDnaEditInText(text: string, edit: DnaTextEdit, intended: unknown): string | undefined;
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/dna/edit.ts"],"names":[],"mappings":"AA0BA,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,oFAAoF;AACpF,MAAM,MAAM,WAAW;AACrB,8FAA8F;AAC5F;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AACjG,iFAAiF;GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE;AACxE,uDAAuD;GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE;AAC9G,sEAAsE;GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AAC/G,gEAAgE;GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE;AAC9G,oGAAoG;GAClG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;CAAE,CAAC;AA8YvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAkBzG"}