wingfoil 0.2.2 → 0.3.0

package/dist/storage/templates.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUILTIN_WORKFLOWS_DIR = exports.BUILTIN_DIRECTIVES_DIR = exports.DEFAULT_TEMPLATE = exports.TEMPLATE_NAMES = exports.TEMPLATES = void 0;
+exports.CUSTOM_ADAPTERS_DIR = exports.BUILTIN_ADAPTERS_DIR = exports.BUILTIN_WORKFLOWS_DIR = exports.BUILTIN_DIRECTIVES_DIR = exports.DEFAULT_TEMPLATE = exports.TEMPLATE_NAMES = exports.TEMPLATES = void 0;
 exports.resolveTemplate = resolveTemplate;
 exports.initProjectCommitMessage = initProjectCommitMessage;
 exports.builtinTemplateSources = builtinTemplateSources;
@@ -22,7 +22,9 @@ exports.templateScaffold = templateScaffold;
  * so `wingfoil init --template X` is byte-identical run to run (REQ-SYS-07), and the returned list is
  * sorted by path so callers may diff the set safely.
  */
+const builtin_adapters_1 = require("./builtin-adapters");
 const builtin_directives_1 = require("./builtin-directives");
+const format_1 = require("../validation/format");
 const layout_1 = require("./layout");
 const SCRUM = {
     name: 'Scrum',
@@ -33,10 +35,11 @@ const SCRUM = {
 };
 const KANBAN = {
     name: 'Kanban',
-    description: 'Continuous-flow delivery with work-in-progress limits.',
+    description: 'Continuous-flow delivery; work-in-progress limits are declared per state with `limits:` in memory.yaml.',
     methodologies: ['Kanban', 'Specification by Example (BDD)', 'TDD'],
     slug: 'kanban',
-    cadence: 'Work flows continuously across the board under explicit WIP limits; there are no timeboxed iterations.',
+    cadence: 'Work flows continuously across the board; there are no timeboxed iterations. A state takes a WIP limit when its ' +
+        "type's machine in .wingfoil/memory.yaml declares one with `limits:` (the commented `bug` example shows how).",
 };
 /** The built-in methodology templates. Order fixed for deterministic listing (REQ-SYS-07). */
 exports.TEMPLATES = [SCRUM, KANBAN];
@@ -57,6 +60,10 @@ function initProjectCommitMessage(def) {
 exports.BUILTIN_DIRECTIVES_DIR = `${layout_1.WINGFOIL_DIR}/directives/built-in`;
 /** Scaffold directory holding the P4.17 built-in workflow templates (spec-011 storage layout). */
 exports.BUILTIN_WORKFLOWS_DIR = `${layout_1.WINGFOIL_DIR}/workflows/built-in`;
+/** Scaffold directory holding the built-in agent adapter manifests (`spec-016` §2.1, task-196). */
+exports.BUILTIN_ADAPTERS_DIR = `${layout_1.WINGFOIL_DIR}/agents/built-in`;
+/** Scaffold directory for the project's own adapter manifests, scaffolded empty (`spec-016` §2.1). */
+exports.CUSTOM_ADAPTERS_DIR = `${layout_1.WINGFOIL_DIR}/agents/custom`;
 /**
  * The built-in source one scaffold file contributes, or `null` when the file is not a built-in
  * template asset.
@@ -76,6 +83,8 @@ function builtinSourceOf(file) {
         kind = 'directive';
     else if (file.path.startsWith(`${exports.BUILTIN_WORKFLOWS_DIR}/`))
         kind = 'workflow';
+    else if (file.path.startsWith(`${exports.BUILTIN_ADAPTERS_DIR}/`))
+        kind = 'adapter';
     else
         return null;
     const dot = base.lastIndexOf('.');
@@ -108,7 +117,8 @@ function builtinSourceOf(file) {
  *
  * What it returns is a fact about the scaffold CONTENT, not a property of this function: for
  * {@link templateScaffold} it is the six P3.8 built-in directives `task-057-builtin-directive-templates`
- * ships (`./builtin-directives`, rendered by `builtinDirectiveMd`), for `scaffoldFiles` it is `[]` (a
+ * ships (`./builtin-directives`, rendered by `builtinDirectiveMd`) plus one `adapter` source per shipped
+ * built-in adapter manifest (`./builtin-adapters`: `claude-code` since task-236), for `scaffoldFiles` it is `[]` (a
  * `.gitkeep` only), and the workflows built-in directory still holds a `.gitkeep` only. Any asset added
  * later is checked with no edit here. Each shipped built-in must satisfy its pillar schema on its own —
  * `test/storage/builtin-directives.test.ts` runs every directive template through the real guard.
@@ -125,8 +135,12 @@ function builtinTemplateSources(files) {
 // --- Content generators -----------------------------------------------------------------------
 // Every generator is a pure function of its inputs (REQ-SYS-07): fixed strings only, no Date/random.
 const wf = (relative) => `${layout_1.WINGFOIL_DIR}/${relative}`;
-/** The Memory element types spec-011 requires a template scaffold for, in fixed order. */
-const MEMORY_TYPES = ['adr', 'bug', 'decision-log', 'release', 'release-line', 'task', 'tech-spec'];
+/**
+ * The Memory element types spec-011 requires a template scaffold for, in fixed order — plus `plan`, the
+ * record of a started workflow (`spec-017` §3.1, task-217): `wingfoil workflow start` adds and submits one,
+ * so a project `init` creates can start a workflow with no edit.
+ */
+const MEMORY_TYPES = ['adr', 'bug', 'decision-log', 'plan', 'release', 'release-line', 'task', 'tech-spec'];
 /**
  * Default `id_pattern` per scaffolded type (task-002-validation-id-engine's `{n}`/`{slug}` token
  * grammar, `src/validation/id.ts`) — required by `memoryAdd` (`src/core/index.ts`) even though
@@ -135,10 +149,31 @@ const MEMORY_TYPES = ['adr', 'bug', 'decision-log', 'release', 'release-line', '
  * repository's own dogfooded `.wingfoil/memory.yaml` scheme, a sensible [AUTHORING] default
  * a user is free to change.
  */
+/**
+ * Whether `memory amend` may correct each scaffolded type (`spec-001`'s `amendable` key; `dl-108` A3;
+ * approver ruling (c) at `task-127`'s review, 2026-10-01). It follows this repository's own
+ * `.wingfoil/memory.yaml`: records whose content is routinely corrected are amendable. `adr` is too,
+ * for dated correction and Revision notes (approver ruling at `task-158`, 2026-10-02); a change to
+ * the decision itself is still a new ADR. `release` is too since the approver ruling at `task-230`
+ * (2026-10-12, D3): dated notes and corrected facts, such as its `## Scope changes` at every re-plan
+ * checkpoint. `release-line` is not, because its content is the roadmap, which the release workflow
+ * phases change.
+ */
+const MEMORY_AMENDABLE = {
+    adr: true,
+    bug: true,
+    'decision-log': true,
+    plan: true,
+    release: true,
+    'release-line': false,
+    task: true,
+    'tech-spec': true,
+};
 const MEMORY_ID_PATTERNS = {
     adr: 'adr-{n}-{slug}',
     bug: 'bug-{n}-{slug}',
     'decision-log': 'dl-{n}-{slug}',
+    plan: '{workflow}-{phase}-plan',
     release: 'release-{n}',
     'release-line': 'rl-{n}',
     task: 'task-{n}-{slug}',
@@ -153,7 +188,7 @@ const MEMORY_ID_PATTERNS = {
  */
 const DIRECTIVES = [
     { name: 'determinism', title: 'Determinism', summary: 'No wall-clock, randomness, or unordered iteration in context-building paths; prefer declared config.' },
-    { name: 'doc-versioning', title: 'Documentation versioning', summary: 'Bump a document version only on the first edit after it was committed; update its date when bumping.' },
+    { name: 'doc-versioning', title: 'Documentation versioning', summary: 'Bump a document version once per change merged to the default branch, on its first edit since then; update its date when bumping.' },
     { name: 'security-secrets', title: 'Secret hygiene', summary: 'Never commit credentials or secrets; the repository is the single source of truth and is shared.' },
     { name: 'traceability', title: 'Traceability', summary: 'Maintain the feature -> story -> acceptance -> requirement -> task chain across every change.' },
 ];
@@ -172,7 +207,10 @@ function dnaYaml(def) {
     const methodologies = def.methodologies.map((m) => `    - name: ${m}`).join('\n');
     return `# Project DNA (P2.4) — scaffolded by \`wingfoil init\` (${def.name} template).
 # Structural map of the project: modules, stacks, team + roles, resource paths. Customize freely.
+# \`version\` is this file's content revision; \`format\` the file format it is written in (bumped by
+# WingFoil only on a backward-incompatible change).
 version: 1
+format: ${format_1.DNA_YAML_FORMAT}
 
 project:
   name: ""                        # your project name
@@ -208,14 +246,52 @@ team:
     - name: approver
 
 # Resource paths — query categories used to navigate the project.
+# \`runs\` holds exactly one directory: the agent run log, one <element-id>.jsonl per element.
 paths:
   sources: []
   tests: []
   docs: []
   config: [.wingfoil]
   governance: []
+  runs: [docs/runs/]
 `;
 }
+/**
+ * The commented-out per-type machine the scaffold shows on `bug` (`dl-072` (A) + S1, task-153): the
+ * scaffold keeps one shared `defaults` machine and does not commit a new project to any lifecycle, but
+ * shows the override mechanism (`adr-008`'s per-type machines) where a user will meet it. Uncommented,
+ * it is a valid `spec-001` machine (`test/storage/templates.test.ts` loads it); its states are an
+ * example, not a recommendation. It also shows a `returns` edge and a WIP limit (task-180, `dl-110`),
+ * which is where the Kanban template's cadence points.
+ */
+const BUG_STATES_EXAMPLE = `
+    # Example — uncomment to give \`bug\` its own state machine instead of \`defaults\` (spec-001):
+    # states:
+    #   sequence: [ draft, open, in-progress, resolved, closed ]
+    #   gates:
+    #     open: { reject: closed }
+    #     resolved: { reject: in-progress }
+    #   returns: { in-progress: open }    # memory park: back to open, with a reason
+    #   limits: { in-progress: 3 }        # at most 3 bugs in progress at once`;
+/**
+ * The scaffolded `plan` type (`spec-017` §3.1, task-217): the record `wingfoil workflow start` writes for a
+ * started workflow. Its `id_pattern` and `path` take the tokens `workflow start` derives (`{workflow}`,
+ * `{phase}`, `{scope}`, ruling R18); its own machine is `draft → active → done`, with `active` a `waiting`
+ * state: `workflow start` submits the plan (`draft → active`) and `workflow end` takes the `waiting` edge
+ * (`active → done`), which no verb drives.
+ */
+const PLAN_TYPE_YAML = `  plan:
+    path: docs/memory/plan/{scope}/{id}.md
+    id_pattern: "${MEMORY_ID_PATTERNS.plan}"
+    amendable: ${MEMORY_AMENDABLE.plan}
+    template:
+      file: memory/templates/plan.md
+      frontmatter:
+        required: [id, type, title, status, workflow, phase]
+    # A started workflow: \`wingfoil workflow start\` adds and submits it, \`wingfoil workflow end\` closes it.
+    states:
+      sequence: [ draft, active, done ]
+      waiting: [ active ]`;
 /**
  * The scaffolded `memory.yaml` (P1.13, `spec-001-memory-yaml-schema`) — type registry **plus** the
  * `defaults.states` machine every scaffolded type runs on.
@@ -232,18 +308,24 @@ paths:
  * be a product decision beyond this scaffold.
  */
 function memoryYaml() {
-    const types = MEMORY_TYPES.map((type) => `  ${type}:
+    const types = MEMORY_TYPES.map((type) => type === 'plan'
+        ? PLAN_TYPE_YAML
+        : `  ${type}:
     path: docs/memory/${type}/{id}.md
     id_pattern: "${MEMORY_ID_PATTERNS[type]}"
+    amendable: ${MEMORY_AMENDABLE[type]}
     template:
       file: memory/templates/${type}.md
       frontmatter:
-        required: [id, type, title, status]`).join('\n');
+        required: [id, type, title, status]${type === 'bug' ? BUG_STATES_EXAMPLE : ''}`).join('\n');
     return `# Memory element schema (P1.13) — scaffolded by \`wingfoil init\`.
 # One entry per element type: its path pattern, its id pattern and its scaffold template. Every type
 # below shares the \`defaults\` state machine; give a type its own \`states:\` block to override it for
-# that type only (REQ-STATE-08).
+# that type only (REQ-STATE-08) — \`bug\` carries a commented example. \`amendable\` says whether
+# \`memory amend\` may record a correction to the type's documents without a state change; absent
+# means false. \`version\` is this file's content revision; \`format\` the file format it is written in.
 version: 1
+format: ${format_1.MEMORY_YAML_FORMAT}
 
 # Default state machine — applies to every type that declares no \`states:\` block of its own.
 # \`sequence\` is the ordered forward chain (\`submit\` walks it); a \`gates\` state's forward edge needs
@@ -262,7 +344,9 @@ ${types}
 function rolesYaml() {
     return `# Directive role assignments (P3.2/P3.7) — scaffolded by \`wingfoil init\`.
 # Binds directives to roles by directive ID, independent of the built-in/custom subfolder holding the file.
+# \`version\` is this file's content revision; \`format\` the file format it is written in.
 version: 1
+format: ${format_1.ROLES_YAML_FORMAT}
 
 assignments:
   developer:
@@ -284,10 +368,12 @@ assignments:
     - architecture
     - code-review
 
-# Global directives apply to every role.
+# Global directives apply to every role. \`security\` is the built-in Security directive (REQ-SEC-08):
+# bound here so every role loads it; \`security-secrets\` is this project's secret-hygiene rule.
 global:
   - doc-versioning
   - documentation
+  - security
   - security-secrets
 `;
 }
@@ -308,7 +394,9 @@ function workflowsYaml(def) {
     return `# Project Workflow main configuration (P4.1) — scaffolded by \`wingfoil init\`.
 # This MAIN config file does not inline workflows; it include()s the custom (and, once populated,
 # built-in) workflow files. Startable mains + the ${def.name} delivery sub-workflow are composed below.
+# \`version\` is this file's content revision; \`format\` the file format it is written in.
 version: 1
+format: ${format_1.WORKFLOWS_YAML_FORMAT}
 
 include:
 ${includes}
@@ -329,6 +417,9 @@ ${includes}
  * binds roles on, and {@link rolesYaml} lists exactly those stems in its `assignments`/`global` blocks
  * — so any other value would leave every scaffolded role binding dangling. Keep the two in step.
  *
+ * No `scope:` key: {@link rolesYaml}'s `global:` list alone says which directives bind every role, and
+ * an absent `scope` is never reported as a disagreement (task-144 review, R3).
+ *
  * `kind: custom` is correct for `directives/custom/`, the only place this generator's output is written;
  * the P3.8 built-ins carry `kind: built-in` and have their own renderer (`builtinDirectiveMd`,
  * `./builtin-directives`).
@@ -340,6 +431,7 @@ name: ${d.name}
 type: directive
 kind: custom
 title: "${d.title}"
+format: ${format_1.DIRECTIVE_FORMAT}
 ---
 
 # ${d.title}
@@ -349,22 +441,66 @@ ${d.summary}
 <!-- Tailor this rule to your project's needs. Directives are auto-loaded per role (roles.yaml). -->
 `;
 }
+/**
+ * What the starter `adr`/`tech-spec` scaffolds say about the `supersedes:` trigger (task-209,
+ * `bug-219`). The starter project has neither its field nor its edge — {@link memoryTemplateMd} writes
+ * no `supersedes:` key and {@link memoryYaml} gives every type the default machine, which has no
+ * `superseded` state — so the scaffold says so, and how to add both, rather than leave a reader of the
+ * CLI reference to find out from a trigger that never fires (`src/core/memory-supersede.ts`).
+ */
+function supersedesNote(type) {
+    if (type !== 'adr' && type !== 'tech-spec')
+        return '';
+    return `
+<!-- Replacing an earlier ${type}? This starter scaffold has no \`supersedes:\` field, and the starter
+     \`memory.yaml\` no \`superseded\` state, so approving this ${type} retires nothing. To use the
+     trigger, add \`supersedes: ""\` to this scaffold (it holds the full id of the replaced element, e.g.
+     "${type === 'adr' ? 'adr-2-git-backed-storage' : 'spec-2-memory-yaml-schema'}", never a short form) and give the type its own \`states:\` in
+     \`memory.yaml\` whose \`sequence\` ends in a state listed in \`gates\`, then an approved state
+     listed in \`waiting\`, then \`superseded\`: the trigger fires only when \`memory approve\` lands
+     in that \`waiting\` state, and approve moves only out of a gate. Otherwise retire the replaced element with \`wingfoil memory deprecate\`, naming
+     this one in \`--reason\`. -->
+`;
+}
+/**
+ * The fields of the scaffolded `plan` template beyond the common four (`spec-017` §3.1, task-217):
+ * `workflow` and `phase` (required, filled by `workflow start`), the `element` the instance is bound to (or
+ * its context element), and `parent`, empty for an instance — a plan whose `parent` names
+ * `<workflow>.<phase>` is a phase plan, never an instance.
+ */
+const PLAN_TEMPLATE_FIELDS = `workflow: ""
+phase: ""
+element: ""
+parent: ""
+`;
+/**
+ * One scaffolded Memory template. Its body comment states what the two verbs that touch it actually
+ * do (task-209, `bug-146`): `memory add` sets `id`, `title`, `status` and any `--tags` / `--set` value
+ * (`renderAddDocument`, `src/memory/add.ts`), and `memory submit` checks the required fields, moves
+ * `status` and commits the document as the author left it (`renderSubmitDocument`,
+ * `src/memory/submit.ts`) — neither fills a field nor replaces a placeholder.
+ */
 function memoryTemplateMd(type) {
     return `---
 id: ""
 type: ${type}
 title: ""
 status: draft
+${type === 'plan' ? PLAN_TEMPLATE_FIELDS : ''}format: ${format_1.MEMORY_TEMPLATE_FORMAT}
 ---
 
-<!-- ${type} body. \`wingfoil memory add\` copies this scaffold verbatim; \`memory submit\` replaces
-     these placeholder comments with real content and fills the required frontmatter fields. -->
-`;
+<!-- ${type} body. \`wingfoil memory add\` copies this scaffold, setting only \`id\`, \`title\` and
+     \`status\` (and any \`--tags\` or \`--set\` value). Fill the required frontmatter fields and replace
+     these placeholder comments yourself; \`wingfoil memory submit\` then checks the required fields,
+     moves \`status\` forward and commits the document as you left it, naming in the commit body the
+     content it carries. -->
+${supersedesNote(type)}`;
 }
 function mainWorkflowYaml(name, description, phasesYaml) {
     return `# ${description}
 name: ${name}
 kind: main
+format: ${format_1.WORKFLOW_FORMAT}
 description: "${description}"
 ${phasesYaml}`;
 }
@@ -373,6 +509,7 @@ function deliveryWorkflowYaml(def) {
 # ${def.cadence}
 name: ${def.slug}-delivery
 kind: sub
+format: ${format_1.WORKFLOW_FORMAT}
 description: "${def.name} delivery loop"
 phases:
   - name: plan
@@ -385,18 +522,35 @@ phases:
     description: "Integrate the completed work."
 `;
 }
+/**
+ * The `agents/{built-in,custom}/` part of the scaffold (`spec-016` §2.1, task-196): one
+ * `built-in/<name>.yaml` per shipped adapter, written verbatim, and `custom/` reserved empty with a
+ * `.gitkeep`. Given an empty list (a test's seam), `built-in/` is reserved with a `.gitkeep` too, as
+ * `workflows/built-in/` is, so both directories exist after `init`.
+ */
+function adapterScaffold(adapters) {
+    const builtIn = adapters.length === 0
+        ? [{ path: `${exports.BUILTIN_ADAPTERS_DIR}/.gitkeep`, content: '' }]
+        : adapters.map((adapter) => ({ path: `${exports.BUILTIN_ADAPTERS_DIR}/${adapter.name}.yaml`, content: adapter.content }));
+    return [...builtIn, { path: `${exports.CUSTOM_ADAPTERS_DIR}/.gitkeep`, content: '' }];
+}
 /**
  * The COMPLETE spec-011 `.wingfoil/` layout for `def`, as a `ScaffoldFile[]` sorted by path
  * (deterministic — REQ-SYS-07). Consumed by `initStorage(root, files, message)`; every path is under
  * `.wingfoil/` so init never writes outside the WingFoil root.
+ *
+ * @param adapters - the built-in adapter manifests to install; {@link BUILTIN_ADAPTERS} (the shipped
+ *   list) unless a test passes a fixture list, since no real built-in ships yet (task-196).
  */
-function templateScaffold(def) {
+function templateScaffold(def, adapters = builtin_adapters_1.BUILTIN_ADAPTERS) {
     const files = [
         // Top-level pillar config (spec-011 "Top-level config files").
         { path: wf('dna.yaml'), content: dnaYaml(def) },
         { path: wf('memory.yaml'), content: memoryYaml() },
         { path: wf('roles.yaml'), content: rolesYaml() },
         { path: wf('workflows.yaml'), content: workflowsYaml(def) },
+        // Agent adapters built-in/custom split (spec-016 §2.1, task-196).
+        ...adapterScaffold(adapters),
         // Directives built-in/custom split (spec-011): the six P3.8 built-ins (task-057) + custom starters.
         ...builtin_directives_1.BUILTIN_DIRECTIVE_TEMPLATES.map((t) => ({ path: `${exports.BUILTIN_DIRECTIVES_DIR}/${t.id}.md`, content: (0, builtin_directives_1.builtinDirectiveMd)(t) })),
         ...DIRECTIVES.map((d) => ({ path: wf(`directives/custom/${d.name}.md`), content: directiveMd(d) })),
@@ -410,7 +564,7 @@ function templateScaffold(def) {
   - name: inception
   - name: specification
   - name: delivery
-    include: workflows/custom/${def.slug}-delivery.yaml
+    include: ${def.slug}-delivery
   - name: sunset
 `),
         },

package/dist/storage/templates.js.map

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

package/dist/validation/config-version.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The bump comparison of a versioned config file's `version:` (task-208, `bug-249`): the one rule the
+ * pending-change gate (`test/lint/helpers/version-bump.ts`, task-183) and the governance check's range
+ * rule (`scripts/check-governance.cjs`) share, so the two cannot disagree about what a bump is.
+ *
+ * `.wingfoil/dna.yaml`, `memory.yaml`, `workflows.yaml` and `roles.yaml` declare `version:` as a number
+ * (`memory.yaml`'s own annotation: "a NUMBER, compared numerically", `1.9 -> 2.0`, never `1.10`, which
+ * YAML reads as `1.1`). A bump is therefore a numeric **increase** of the value YAML reads — not any
+ * difference: a downgrade (`2.5 -> 2.4`) is no bump, nor is a re-quoting that reads as the same number
+ * (`1.0 -> "1.0"`). A dotted string with more than two parts (`"1.2.3"`) is compared part by part as
+ * integers. Pure (REQ-SYS-07).
+ */
+/**
+ * True when `after` is a bump over `before`: both read as versions and `after` is strictly greater.
+ * `before` and `after` are the values YAML reads for `version:` (a number, or a string when quoted).
+ * Anything else — absent, `null`, not a version — is never a bump.
+ */
+export declare function isVersionIncrease(before: unknown, after: unknown): boolean;
+//# sourceMappingURL=config-version.d.ts.map

package/dist/validation/config-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-version.d.ts","sourceRoot":"","sources":["../../src/validation/config-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgBH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAa1E"}

package/dist/validation/config-version.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * The bump comparison of a versioned config file's `version:` (task-208, `bug-249`): the one rule the
+ * pending-change gate (`test/lint/helpers/version-bump.ts`, task-183) and the governance check's range
+ * rule (`scripts/check-governance.cjs`) share, so the two cannot disagree about what a bump is.
+ *
+ * `.wingfoil/dna.yaml`, `memory.yaml`, `workflows.yaml` and `roles.yaml` declare `version:` as a number
+ * (`memory.yaml`'s own annotation: "a NUMBER, compared numerically", `1.9 -> 2.0`, never `1.10`, which
+ * YAML reads as `1.1`). A bump is therefore a numeric **increase** of the value YAML reads — not any
+ * difference: a downgrade (`2.5 -> 2.4`) is no bump, nor is a re-quoting that reads as the same number
+ * (`1.0 -> "1.0"`). A dotted string with more than two parts (`"1.2.3"`) is compared part by part as
+ * integers. Pure (REQ-SYS-07).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVersionIncrease = isVersionIncrease;
+/** A numeric reading of `value`: a finite number, or a string of digits with at most one dot. */
+function asNumber(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : null;
+    if (typeof value === 'string' && /^\d+(?:\.\d+)?$/.test(value.trim()))
+        return Number(value.trim());
+    return null;
+}
+/** The integer parts of a dotted version (`"1.10.0"` → `[1, 10, 0]`), or `null` when it is not one. */
+function asParts(value) {
+    const text = typeof value === 'number' ? String(value) : typeof value === 'string' ? value.trim() : null;
+    if (text === null || !/^\d+(?:\.\d+)*$/.test(text))
+        return null;
+    return text.split('.').map(Number);
+}
+/**
+ * True when `after` is a bump over `before`: both read as versions and `after` is strictly greater.
+ * `before` and `after` are the values YAML reads for `version:` (a number, or a string when quoted).
+ * Anything else — absent, `null`, not a version — is never a bump.
+ */
+function isVersionIncrease(before, after) {
+    const a = asNumber(before);
+    const b = asNumber(after);
+    if (a !== null && b !== null)
+        return b > a;
+    const left = asParts(before);
+    const right = asParts(after);
+    if (left === null || right === null)
+        return false;
+    for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+        const l = left[index] ?? 0;
+        const r = right[index] ?? 0;
+        if (r !== l)
+            return r > l;
+    }
+    return false;
+}
+//# sourceMappingURL=config-version.js.map

package/dist/validation/config-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-version.js","sourceRoot":"","sources":["../../src/validation/config-version.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAqBH,8CAaC;AAhCD,iGAAiG;AACjG,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACnG,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uGAAuG;AACvG,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzG,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,MAAe,EAAE,KAAc;IAC/D,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/validation/diagnostic.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The configuration diagnostic shape (spec-003-workflows-yaml-schema § "Diagnostics"; shared by
+ * spec-017-workflow-commands-and-state-deduction §2): `{ code, severity, file, path, message }`,
+ * carried by commands in one array named `diagnostics`.
+ *
+ * A {@link Diagnostic} is a {@link ValidationIssue} with a `severity`, so a list of them can ride a
+ * {@link ValidationError} unchanged; {@link DiagnosticsError} is the error a loader throws when the
+ * list holds at least one `error`.
+ */
+import { ValidationError, ValidationIssue } from './errors';
+/** `error` makes the operation fail; `warning` is reported and the operation goes on (spec-003). */
+export type DiagnosticSeverity = 'error' | 'warning';
+/** One load-time or deduction diagnostic (spec-003 § "Diagnostics", "Shape"). */
+export interface Diagnostic extends ValidationIssue {
+    /** `E_*` for an error, `W_*` for a warning. */
+    readonly code: string;
+    readonly severity: DiagnosticSeverity;
+    /** The configuration file, relative to `.wingfoil/` (e.g. `workflows/custom/dev-loop.yaml`). */
+    readonly file: string;
+    /** Locates the field inside `file`, e.g. `phases[3].include`; `''` for the whole file. */
+    readonly path: string;
+    readonly message: string;
+}
+/**
+ * One diagnostic as a reason line: `<code> <path> (<file>): <message>` — the shape every
+ * {@link ValidationError} reason has always had, so the reason names where to look even on a surface
+ * that renders no `details`.
+ */
+export declare function formatDiagnostic(diagnostic: Diagnostic): string;
+/**
+ * The failure of a load whose {@link diagnostics} hold at least one error (spec-003 § "Diagnostics"):
+ * `VALIDATION`, exit `1` ({@link EXIT_VALIDATION}). Its `message` — the reason the operation reports —
+ * is the **first error** in {@link formatDiagnostic}'s form, and {@link diagnostics} is the whole
+ * ordered list, warnings included, for the caller to carry in `details` (`dl-055`).
+ */
+export declare class DiagnosticsError extends ValidationError {
+    readonly diagnostics: readonly Diagnostic[];
+    constructor(diagnostics: readonly Diagnostic[]);
+}
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/validation/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../../src/validation/diagnostic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAmB,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE7E,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,iFAAiF;AACjF,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;gBAEhC,WAAW,EAAE,SAAS,UAAU,EAAE;CAQ/C"}

package/dist/validation/diagnostic.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagnosticsError = void 0;
+exports.formatDiagnostic = formatDiagnostic;
+/**
+ * The configuration diagnostic shape (spec-003-workflows-yaml-schema § "Diagnostics"; shared by
+ * spec-017-workflow-commands-and-state-deduction §2): `{ code, severity, file, path, message }`,
+ * carried by commands in one array named `diagnostics`.
+ *
+ * A {@link Diagnostic} is a {@link ValidationIssue} with a `severity`, so a list of them can ride a
+ * {@link ValidationError} unchanged; {@link DiagnosticsError} is the error a loader throws when the
+ * list holds at least one `error`.
+ */
+const errors_1 = require("./errors");
+/**
+ * One diagnostic as a reason line: `<code> <path> (<file>): <message>` — the shape every
+ * {@link ValidationError} reason has always had, so the reason names where to look even on a surface
+ * that renders no `details`.
+ */
+function formatDiagnostic(diagnostic) {
+    return `${diagnostic.code} ${diagnostic.path ? `${diagnostic.path} ` : ''}(${diagnostic.file}): ${diagnostic.message}`;
+}
+/**
+ * The failure of a load whose {@link diagnostics} hold at least one error (spec-003 § "Diagnostics"):
+ * `VALIDATION`, exit `1` ({@link EXIT_VALIDATION}). Its `message` — the reason the operation reports —
+ * is the **first error** in {@link formatDiagnostic}'s form, and {@link diagnostics} is the whole
+ * ordered list, warnings included, for the caller to carry in `details` (`dl-055`).
+ */
+class DiagnosticsError extends errors_1.ValidationError {
+    diagnostics;
+    constructor(diagnostics) {
+        super([...diagnostics], errors_1.EXIT_VALIDATION);
+        const first = diagnostics.find((d) => d.severity === 'error') ?? diagnostics[0];
+        this.message = first ? formatDiagnostic(first) : 'validation failed';
+        this.name = 'DiagnosticsError';
+        this.diagnostics = diagnostics;
+        Object.setPrototypeOf(this, DiagnosticsError.prototype);
+    }
+}
+exports.DiagnosticsError = DiagnosticsError;
+//# sourceMappingURL=diagnostic.js.map

package/dist/validation/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../src/validation/diagnostic.ts"],"names":[],"mappings":";;;AA+BA,4CAEC;AAjCD;;;;;;;;GAQG;AACH,qCAA6E;AAiB7E;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,UAAsB;IACrD,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,IAAI,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;AACzH,CAAC;AAED;;;;;GAKG;AACH,MAAa,gBAAiB,SAAQ,wBAAe;IAC1C,WAAW,CAAwB;IAE5C,YAAY,WAAkC;QAC5C,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,EAAE,wBAAe,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAXD,4CAWC"}