wingfoil 0.2.1 → 0.3.0

package/README.md

@@ -1,6 +1,15 @@
+<p align="center"><img src="docs/assets/wingfoil-mark.svg" width="140" alt="WingFoil logo"></p>
+
+<p align="center"><a href="https://glama.ai/mcp/servers/wingfoil/wingfoil"><img src="https://glama.ai/mcp/servers/wingfoil/wingfoil/badges/score.svg" alt="WingFoil MCP server on Glama"></a></p>
+
 # WingFoil
 
-**A structured harness for deterministic AI-assisted software development.**
+[![npm version](https://img.shields.io/npm/v/wingfoil)](https://www.npmjs.com/package/wingfoil)
+[![licence](https://img.shields.io/npm/l/wingfoil)](https://github.com/wingfoil/wingfoil/blob/main/LICENSE)
+[![node](https://img.shields.io/node/v/wingfoil)](https://www.npmjs.com/package/wingfoil)
+[![publish](https://github.com/wingfoil/wingfoil/actions/workflows/publish.yml/badge.svg)](https://github.com/wingfoil/wingfoil/actions/workflows/publish.yml)
+
+**A structured harness for AI-assisted software development, built to make it deterministic.**
 
 WingFoil solves a critical problem: as your software project grows, AI agents lose consistency and control. Context gets
 scattered, conventions drift, and decisions made in one session don't carry forward to the next.
@@ -8,6 +17,13 @@ scattered, conventions drift, and decisions made in one session don't carry forw
 WingFoil centralizes your project's **memory, DNA, and directives** in a structured, git-backed format — giving both
 humans and AI agents a shared source of truth.
 
+![WingFoil in a terminal: init, configure an approver, add a task, submit and approve it, then show its git log](docs/assets/wingfoil-demo-first-project.gif)
+
+*The first example, [`docs/examples/01-first-project`](docs/examples/01-first-project/run.sh), recorded from
+[`docs/examples/01-first-project/demo.tape`](docs/examples/01-first-project/demo.tape). The example checks its own
+results, and the recording stops if a check fails, so if WingFoil stops matching the example the recording fails
+instead of going stale.*
+
 ---
 
 ## The Problem
@@ -33,7 +49,8 @@ WingFoil provides a **structured, authoritative interface** to your project:
 - **Workflow State Management** — Unified tracking and communication of project flow, progress, and blockers
 - **Interaction Layer** — CLI for humans, MCP for agents
 
-This keeps everything synchronized and deterministic.
+This keeps everything synchronized, so that two runs from the same specs and configuration can produce
+equivalent software: the goal the *Determinism Index* measures (see *Success Metric* below).
 
 ---
 
@@ -63,19 +80,21 @@ real-time tracking of project state.
 
 ## Key Features
 
-### Five Pillars — status in 0.2.1
+### Five Pillars — status in 0.3
 
 - ✓ **Project Memory** — Git-backed documents (tasks, ADRs, decision-logs, bugs, specs…) with per-type
   state machines, approval gates and an audit trail (**shipped**: create, search, submit, approve,
-  reject, deprecate, history)
+  reject, deprecate, history; **new in 0.3**: amend, park, work-in-progress limits)
 - ✓ **Project DNA** — Structured config: modules, tech stack, team & roles, resource paths
   (**shipped**: show, set, add, update, remove)
 - ✓ **Project Directives** — Role-scoped rules: six built-in templates installed by `init`, your own
-  custom directives, role assignments (**shipped in 0.2.1**)
+  custom directives, role assignments (**shipped in 0.2**)
 - ✓ **Interaction Layer** — CLI for humans and agents; MCP server for agents with read-only Resources
-  and one Prompt per role (**shipped**)
-- **Workflow State Management** — workflows are declared and listable today; the engine that starts
-  and tracks them is planned for 0.3
+  and one Prompt per role (**shipped**); `agent execute` launches Claude Code or Codex CLI on a Memory
+  element with its context assembled and checked first, and records the run (**new in 0.3**)
+- ✓ **Workflow State Management** — start, follow and end workflows: the next step and its role,
+  the open workflows, approvals routed to the approver, checkpoints (**new in 0.3**). WingFoil records
+  and routes the steps; people and agents carry them out
 
 ### CLI at a glance
 
@@ -83,17 +102,21 @@ real-time tracking of project state.
 |---|---|
 | Setup | `wingfoil init [--template Scrum\|Kanban]` · `wingfoil mcp` |
 | DNA | `wingfoil dna show [section]` · `dna set <path> --value <v>` · `dna add` · `dna update` · `dna remove` · `wingfoil paths [category]` |
-| Memory | `wingfoil memory add --type <t> --title <t>` · `submit <id>` · `approve <id> --reason <r>` · `reject <id> --reason <r>` · `deprecate <id>` · `history <id>` · `search [keyword]` |
+| Memory | `wingfoil memory add --type <t> --title <t> [--set <name>=<value>]` · `submit <id>` · `approve <id> --reason <r>` · `reject <id> --reason <r>` · `amend <id> --reason <r>` · `park <id> --reason <r>` · `deprecate <id>` · `history <id>` · `search [keyword]` |
 | Directives | `wingfoil directive create --name <n>` · `directive assign --directive <n> --role <r>` · `directive remove <n>` · `wingfoil directives list [--role <r>]` |
-| Workflow | `wingfoil workflow list` |
+| Workflow | `wingfoil workflow list` · `show <name>` · `start <name>` · `next` · `status` · `finalize` · `end` · `create <name>` · `remove <name>` |
+| Agent | `wingfoil agent execute --element <type:id> \| --next` · `agent list` · `agent show <run-id>` |
 
 Every command accepts `--format console|json|yaml` and ends with exit code `0` (success), `1` (refused)
-or `2` (bad command line). Full details: **[CLI reference](docs/cli-reference.md)**.
+or `2` (bad command line); every command that commits accepts `--dry-run`, except `init`. Full details: **[CLI reference](docs/cli-reference.md)**.
 
 ### For AI Agents
 
-- ✓ **MCP server** (`wingfoil mcp`, stdio) — DNA, Memory and workflows as read-only Resources, plus a
-  `<role>-session` Prompt per role that embeds the role's directives
+- ✓ **MCP server** (`wingfoil mcp`, stdio) — DNA, Memory and workflows as read-only Resources, the
+  workflow state as `wingfoil://workflows/-/next` and `wingfoil://workflows/-/status`, plus a
+  `<role>-session` Prompt per role that embeds the role's directives; given an `element` and a `state`
+  (a commit), the Prompt — and the Resource `wingfoil://session/{role}/{element}/{state}` — return the
+  agent's execution context for that element
 - ✓ **Read-only by construction** — the MCP surface has no Tools; changes go through the CLI, and
   approvals belong to a human holding the `approver` role
 - ✓ **[`docs/agents.md`](docs/agents.md)** — the same knowledge as a document an agent can read from a
@@ -127,6 +150,8 @@ workflows) and commits it:
 $ wingfoil init --template Scrum
 ```
 
+It also installs the built-in agent adapters (`claude-code`, `codex-cli`) under `.wingfoil/agents/`.
+
 **2. Name the project and register yourself as the approver** — approvals need a team member holding
 the `approver` role, with your git email:
 
@@ -177,6 +202,8 @@ wf(task): approve task-001-my-first-task [pending → approved]
 
 Approver: Ada Lovelace <ada@example.com> (approver)
 Reason: Scope is clear.
+
+WingFoil-Version: 0.3.0 (6ca54978a01dc29c81e395d363efcdeac8a513fd)
 ```
 
 **5. Connect your AI agent** — for Claude Code, add `.mcp.json` at the repository root:
@@ -193,6 +220,8 @@ Reason: Scope is clear.
 | **[CLI reference](docs/cli-reference.md)** | Every command: arguments, output, exit codes, the commit it writes |
 | **[Examples](docs/examples/)** | Runnable, self-checking scripts for the main scenarios |
 | **[Guide for AI agents](docs/agents.md)** | What an agent needs to operate in a WingFoil project |
+| **[Comparison](docs/comparison.md)** | WingFoil beside agent-rule files, spec-driven development tools, coding agents and IDEs |
+| **[Case study](docs/case-study.md)** | How WingFoil develops WingFoil, with the release-health figures of v0.1 and v0.2 |
 | **[Changelog](CHANGELOG.md)** | What changed in each release |
 
 ---
@@ -200,24 +229,34 @@ Reason: Scope is clear.
 ## Value Proposition
 
 **For** developers and teams already using AI agents  
-**WingFoil** makes the development process **deterministic**  
+**WingFoil** is built to make the development process **deterministic**, and measures how far it does  
 **By** centralizing memory, conventions, and directives — keeping them synchronized across all actors
 
 ### Success Metric: Determinism Index
 
 Two independent development runs from the same specs + WingFoil config using different AI agents should produce
 substantially equivalent software, with all team members and agents maintaining shared understanding of project workflow
-state, progress, and alignment.
+state, progress, and alignment. This is the goal WingFoil is measured against, not a property it already has.
+
+*Substantially equivalent* means **behaviourally equivalent**: both codebases pass the same acceptance contracts. The
+Index has three components:
+
+- **Input** — the context WingFoil assembles is identical for identical inputs: guaranteed, by tests.
+- **Process conformance** — the run followed its workflow (well-formed commits, legal transitions, phase outputs
+  present, roles respected): measured on every run.
+- **Outcome equivalence** — the two runs' software behaves the same: the agents and models write the code, so this is
+  measured, never promised.
 
 ---
 
 ## What Comes Later
 
-**0.3 — Project Workflow:** the workflow engine (`workflow start|next|status|show|end`…), approval
-routing by role, agent execution with directives and Memory context auto-loaded, reference workflow
-templates, notifications when an approval is required.
+**0.4 — Interaction Layer + Polish** (planned): adopting WingFoil in a project already
+under way (`init --mode infer`, `dna infer`, `memory import`, `audit`), MCP Tools through which agents
+submit their work, reference workflow templates (Scrum, Kanban, Lean Inception, Trunk-Based), and
+polished CLI help, errors and console output.
 
-**0.4 — Interaction Layer + Polish** · **1.0 — MVP complete**, all five pillars integrated.
+**1.0 — MVP complete**, all five pillars integrated.
 
 Later, based on early adopter feedback: semantic search, IDE integrations beyond MCP, notification
 routing (email, Slack), multi-project management.
@@ -232,13 +271,19 @@ WingFoil is built one pillar per release until all five are integrated in 1.0.
 |---|---|---|
 | Lean Inception · Requirements | Product vision, USM · BDD · SARD · backlog | ✓ Complete |
 | **0.1** | Project Memory + DNA | ✓ Released (not published to npm) |
-| **0.2** | + Project Directives, Memory approvals, DNA editing, MCP role Prompts | 🔄 Being released |
-| **0.3** | + Project Workflow | Planned |
+| **0.2** | + Project Directives, Memory approvals, DNA editing, MCP role Prompts | ✓ Released (`wingfoil@0.2.1` on npm) |
+| **0.2.2** | Patch: configuration at the repository root, staged npm publishing, first-use fixes | ✓ Released (`wingfoil@0.2.2` on npm) |
+| **0.3** | + Project Workflow: workflow state, approval routing, agent execution | ✓ Released (`wingfoil@0.3.0` on npm) |
 | **0.4** | + Interaction Layer polish | Planned |
 | **1.0** | MVP complete | Planned |
 
-**Dogfooding:** WingFoil's own development is managed with WingFoil — its configuration lives under
-`docs/self/`.
+**Dogfooding:** WingFoil's own development is managed with WingFoil — its configuration lives in
+`.wingfoil/` and its Memory in `docs/04_memory/`, at the repository root. Every verb that writes a
+`wf()` commit there (`add`, `submit`, `approve`, `reject`, `deprecate`, `amend`, `park`) runs on the
+build compiled from the checkout (`npm run build`, then `node dist/cli.js <command>`); the read commands
+and the MCP server registered in `.mcp.json` run on a published, pinned build of WingFoil
+(`npm run -s wingfoil -- <command>`), so they answer as the version users have. See
+[COLLABORATION.md](COLLABORATION.md).
 
 ---
 
@@ -258,13 +303,15 @@ WingFoil is built one pillar per release until all five are integrated in 1.0.
 └─────────────────────────────────────────────────┘
 ```
 
-- **CLI**: Humans (and agents) use `wingfoil` commands to manage Memory, DNA and Directives, and to read Workflows
-- **MCP Server**: Agents connect via Model Context Protocol to query Memory/DNA, receive Directives, and view Workflow
-  definitions
+- **CLI**: Humans (and agents) use `wingfoil` commands to manage Memory, DNA and Directives, to start, follow and end
+  Workflows, and to launch an agent on an element
+- **MCP Server**: Agents connect via Model Context Protocol to query Memory/DNA, receive Directives and their execution
+  context, and read Workflow definitions, the next step and the open workflows
 - **Git Backend**: All changes (memory, decisions, workflow state) are versioned and auditable
 - **Read-Only MCP**: The MCP surface is read-only; state changes go through the CLI, and approvals belong to a
   human holding the `approver` role
-- **Workflow Synchronization** *(0.3)*: All team members and agents stay aligned on current progress and blockers
+- **Workflow Synchronization**: All team members and agents read the same workflow state, deduced from the
+  repository: the next step, its role, and the approvals waiting
 
 ---
 
@@ -291,11 +338,11 @@ docs/
 | Layer          | Artifact                                                    | Count    |
 |----------------|-------------------------------------------------------------|----------|
 | Vision         | User journeys                                               | 8        |
-| Vision         | MVP features (5 pillars + notifications)                    | 63       |
-| User Story Map | Journey files · edge-case / interruption stories            | 7 · 14   |
-| BDD            | Gherkin feature files / scenarios                           | 63 / 190 |
-| SARD           | Architecture & NFR requirements (measurable Fit Criteria)   | 43       |
-| Backlog        | Implementation-ready tasks (63 user stories + 43 technical) | 106      |
+| Vision         | MVP features (5 pillars + notifications)                    | 66       |
+| User Story Map | Journey files · edge-case / interruption stories            | 7 · 15   |
+| BDD            | Gherkin feature files / scenarios                           | 66 / 267 |
+| SARD           | Architecture & NFR requirements (measurable Fit Criteria)   | 46       |
+| Backlog        | Implementation-ready tasks, as imported (63 stories + 43 technical) | 106      |
 
 All artifacts are scheduled across 5 release waves (v0.1 → v1.0), sequenced by risk in
 `docs/01_vision/07_sequencer.md`.
@@ -310,25 +357,24 @@ MIT — open source and free to use.
 
 ## Contributing
 
-Early feedback is welcome. Please open issues on GitHub to share:
-
-- Use cases and pain points
-- Feature requests
-- Bug reports
+Early feedback is welcome. Open a GitHub issue with the **Bug report** or the **Proposal** form: each is
+captured as a Memory element (a `bug`, a `decision-log`, or a `change-proposal` for a feature request)
+without asking you again.
 
 See **[`COLLABORATION.md`](COLLABORATION.md)** — how to contribute through Memory artifacts
-(Bug / Decision-Log / ADR / Tech-Spec) instead of code, with credit for the AI-generated work
-derived from your contribution.
+(Bug / Decision-Log / Change-Proposal / ADR / Tech-Spec) instead of code, with credit for the AI-generated work
+derived from your contribution. Everyone follows the [Code of Conduct](CODE_OF_CONDUCT.md); report a
+vulnerability privately, as [`SECURITY.md`](SECURITY.md) explains, never in a public issue.
 
 ---
 
 ## Questions?
 
-- **GitHub Issues:** Bug reports, feature requests
+- **GitHub Issues:** bug reports and proposals, through the issue forms
 - **Documentation:** Start from the [user guide](docs/user-guide.md); WingFoil's own specifications (vision, USM · BDD ·
   SARD, backlog) are under [`docs/`](docs/)
-- **Community:** Join discussions (links coming soon)
+- **Community:** ask and share in [GitHub Discussions](https://github.com/wingfoil/wingfoil/discussions)
 
 ---
 
-**WingFoil: Making AI-assisted development deterministic, not chaotic.**
+**WingFoil: governing AI-assisted development toward determinism, not chaos.**

package/dist/agent/discovery.d.ts

@@ -0,0 +1,72 @@
+import { type Diagnostic } from '../validation';
+import { type CoreResult } from '../core/types';
+import { type AdapterKind } from './manifest';
+import type { AdapterManifest } from './schema';
+/** Root-relative POSIX path of the adapter tree (`spec-016` §2.1). */
+export declare const ADAPTERS_DIR_PATH: ".wingfoil/agents";
+/** The `E_*` code of a name declared in both adapter directories. */
+export declare const E_ADAPTER_DUPLICATE = "E_ADAPTER_DUPLICATE";
+/** The `W_*` code of an entry under the adapter tree that is not an adapter (`bug-290`). */
+export declare const W_ADAPTER_IGNORED = "W_ADAPTER_IGNORED";
+/** An adapter found at a revision: its name (the file basename), its directory and its path. */
+export interface AdapterEntry {
+    readonly name: string;
+    readonly kind: AdapterKind;
+    /** Root-relative POSIX path, e.g. `.wingfoil/agents/custom/fake.yaml`. */
+    readonly path: string;
+}
+/** A selected adapter, its manifest parsed and validated. */
+export interface LoadedAdapter extends AdapterEntry {
+    readonly manifest: AdapterManifest;
+}
+/**
+ * Every entry under `.wingfoil/agents/` at `rev` that is not an adapter (`bug-290`, `spec-016` §2.1): a
+ * file of another extension, a nested file, a file outside `built-in/` and `custom/`, or a `.yaml`
+ * basename outside `spec-009`'s ID class — one `W_ADAPTER_IGNORED` warning each, naming the path in
+ * `file`, in path order (byte order). A `.gitkeep` is not reported. Nothing is parsed.
+ *
+ * @param rev - A revision naming one commit; `HEAD` for the gating read. At `HEAD`, a repository with
+ *   no commit has no entry and no diagnostic.
+ * @throws `RevisionError` when `rev`, other than `HEAD`, names no commit.
+ */
+export declare function adapterTreeDiagnosticsAtRev(root: string, rev: string): Diagnostic[];
+/**
+ * Every adapter commit `rev` declares, sorted by name (byte order): only the names {@link loadAdapter}
+ * can select; {@link adapterTreeDiagnosticsAtRev} reports the rest. Nothing is parsed.
+ *
+ * @param rev - A revision naming one commit; `HEAD` for the gating read.
+ * @throws `ValidationError` (`E_ADAPTER_DUPLICATE`) when a name is in both `built-in/` and `custom/`;
+ *   `RevisionError` when `rev` names no commit.
+ */
+export declare function listAdaptersAtRev(root: string, rev: string): AdapterEntry[];
+/**
+ * The refusal of a name declared in both adapter directories at `rev` (§2.1), in {@link loadAdapter}'s
+ * shape — `adapter '<first name>': declared in both …`, every duplicated name a `dl-055` detail line —
+ * or `undefined` when every name is unique. `agent execute` asks it where it lists the adapter tree
+ * (§3.3 step 2), before it resolves the element, the role or the agent.
+ *
+ * @param rev - A revision naming one commit (a sha, or `HEAD`; at `HEAD` a repository with no commit has
+ *   no adapter).
+ * @param label - How the refusal spells the revision; defaults to `rev`. A caller that resolved `HEAD`
+ *   to a sha once, to read everything at that one commit, passes the sha as `rev` and `HEAD` here
+ *   (task-235's review F3).
+ */
+export declare function duplicateAdapterRefusal(root: string, rev: string, label?: string): CoreResult<never> | undefined;
+/**
+ * Select, read and validate the adapter `name` at `rev` (`spec-016` §3.2 step 5): the gating read
+ * `agent execute` makes. Only that manifest is parsed.
+ *
+ * Refusals, each `adapter '<name>': …`:
+ * - `VALIDATION` — `name` is not an id (`spec-009` §1); a name is in both directories (the first such
+ *   name is the one named, and every duplicated name is a `dl-055` detail line); the manifest is invalid (§3.7: the first issue in the message, every issue
+ *   a `dl-055` detail line with its file);
+ * - `NOT_FOUND` — no `built-in/<name>.yaml` or `custom/<name>.yaml` at `rev` (at `HEAD`, a repository
+ *   with no commit has no adapter);
+ * - a `RevisionError`'s own code and message when `rev`, other than `HEAD`, names no commit.
+ *
+ * @param rev - Defaults to `HEAD` (`dl-080` (B)).
+ * @param label - How refusals and issue paths spell the revision; defaults to `rev` (see
+ *   {@link duplicateAdapterRefusal}).
+ */
+export declare function loadAdapter(root: string, name: string, rev?: string, label?: string): CoreResult<LoadedAdapter>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/agent/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/agent/discovery.ts"],"names":[],"mappings":"AAoBA,OAAO,EAA8B,KAAK,UAAU,EAAuC,MAAM,eAAe,CAAC;AAEjH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAwB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAG,kBAA2B,CAAC;AAE7D,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CASnF;AAqBD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAK3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,CAW7G;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,KAAK,SAAM,GAAG,UAAU,CAAC,aAAa,CAAC,CA6C5G"}

package/dist/agent/discovery.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.W_ADAPTER_IGNORED = exports.E_ADAPTER_DUPLICATE = exports.ADAPTERS_DIR_PATH = void 0;
+exports.adapterTreeDiagnosticsAtRev = adapterTreeDiagnosticsAtRev;
+exports.listAdaptersAtRev = listAdaptersAtRev;
+exports.duplicateAdapterRefusal = duplicateAdapterRefusal;
+exports.loadAdapter = loadAdapter;
+/**
+ * Discovering and loading adapter manifests (`spec-016` §2.1, §3.2 step 5, §3.3 step 2, task-177).
+ *
+ * - **Where:** `.wingfoil/agents/built-in/<name>.yaml` and `.wingfoil/agents/custom/<name>.yaml`. Any
+ *   other entry under `.wingfoil/agents/` (a `.gitkeep`, a nested directory, another extension) is
+ *   not an adapter.
+ * - **Baseline:** a revision, `HEAD` by default. Manifests gate what `agent execute` launches, so they
+ *   are a gating read (`dl-080` (B), the `command-baseline` directive, `spec-006` §6): an uncommitted
+ *   edit, or an untracked manifest, changes nothing.
+ * - **Discovery lists, it does not parse.** A name in both directories is refused here, because the
+ *   run record could not say which one launched (§2.1). Only the adapter a caller selects is then read
+ *   and validated (§3.2 step 5), so a broken manifest blocks nobody but its own agents.
+ * - **What is not an adapter is said, not skipped** (`bug-290`). The listing offers only names
+ *   {@link loadAdapter} can select — a basename in `spec-009`'s ID class — and
+ *   {@link adapterTreeDiagnosticsAtRev} reports every other entry under `.wingfoil/agents/` (another
+ *   extension, a nested file, a file outside the two directories, a basename outside the ID class) as a
+ *   `W_ADAPTER_IGNORED` warning naming its path, except the `.gitkeep` `wingfoil init` reserves the
+ *   directories with. `agent execute` prints them where it lists the adapter tree (§3.3 step 2).
+ */
+const storage_1 = require("../storage");
+const validation_1 = require("../validation");
+const revision_1 = require("../core/revision");
+const types_1 = require("../core/types");
+const manifest_1 = require("./manifest");
+/** Root-relative POSIX path of the adapter tree (`spec-016` §2.1). */
+exports.ADAPTERS_DIR_PATH = '.wingfoil/agents';
+/** The `E_*` code of a name declared in both adapter directories. */
+exports.E_ADAPTER_DUPLICATE = 'E_ADAPTER_DUPLICATE';
+/** The `W_*` code of an entry under the adapter tree that is not an adapter (`bug-290`). */
+exports.W_ADAPTER_IGNORED = 'W_ADAPTER_IGNORED';
+/** `.wingfoil/agents/<kind>/<basename>.yaml`, directly inside one of the two directories. */
+const ENTRY_RE = /^\.wingfoil\/agents\/(built-in|custom)\/([^/]+)\.yaml$/;
+/** Byte order, never locale order (REQ-SYS-07). */
+const byteOrder = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+/** The placeholder `wingfoil init` reserves an empty adapter directory with: never reported. */
+const GITKEEP = '.gitkeep';
+/** Why the entry at `path` is not an adapter, or `null` when it is one (or is a `.gitkeep`). */
+function notAnAdapter(path) {
+    const match = ENTRY_RE.exec(path);
+    if (match === null) {
+        return path.endsWith(`/${GITKEEP}`)
+            ? null
+            : `not an adapter: an adapter is a .yaml file directly inside ${exports.ADAPTERS_DIR_PATH}/built-in/ or ${exports.ADAPTERS_DIR_PATH}/custom/ (spec-016 §2.1)`;
+    }
+    const name = match[2];
+    return (0, validation_1.isIdPiece)(name)
+        ? null
+        : `not an adapter: its name '${name}' is not an id, characters [${validation_1.ID_CHAR_CLASS}] only (spec-009 §1), so no agent can select it`;
+}
+/** The adapters commit `sha` holds, by name then kind, duplicates included; only names that are ids. */
+function entriesAtCommit(root, sha) {
+    const entries = [];
+    for (const path of (0, revision_1.listPathsAtCommit)(root, sha, exports.ADAPTERS_DIR_PATH)) {
+        const match = ENTRY_RE.exec(path);
+        if (match === null || !(0, validation_1.isIdPiece)(match[2]))
+            continue;
+        entries.push({ name: match[2], kind: match[1], path });
+    }
+    return entries.sort((a, b) => byteOrder(a.name, b.name) || byteOrder(a.kind, b.kind));
+}
+/**
+ * Every entry under `.wingfoil/agents/` at `rev` that is not an adapter (`bug-290`, `spec-016` §2.1): a
+ * file of another extension, a nested file, a file outside `built-in/` and `custom/`, or a `.yaml`
+ * basename outside `spec-009`'s ID class — one `W_ADAPTER_IGNORED` warning each, naming the path in
+ * `file`, in path order (byte order). A `.gitkeep` is not reported. Nothing is parsed.
+ *
+ * @param rev - A revision naming one commit; `HEAD` for the gating read. At `HEAD`, a repository with
+ *   no commit has no entry and no diagnostic.
+ * @throws `RevisionError` when `rev`, other than `HEAD`, names no commit.
+ */
+function adapterTreeDiagnosticsAtRev(root, rev) {
+    const sha = rev === 'HEAD' ? (0, revision_1.atHeadOr)(root, () => (0, revision_1.resolveRevision)(root, rev), null) : (0, revision_1.resolveRevision)(root, rev);
+    if (sha === null)
+        return [];
+    const diagnostics = [];
+    for (const path of [...(0, revision_1.listPathsAtCommit)(root, sha, exports.ADAPTERS_DIR_PATH)].sort(byteOrder)) {
+        const message = notAnAdapter(path);
+        if (message !== null)
+            diagnostics.push({ code: exports.W_ADAPTER_IGNORED, severity: 'warning', file: path, path: '', message });
+    }
+    return diagnostics;
+}
+/** One issue per name declared in both directories, in name order, paired with that name. */
+function duplicateIssues(entries, file) {
+    const issues = [];
+    for (let i = 1; i < entries.length; i += 1) {
+        const [previous, entry] = [entries[i - 1], entries[i]];
+        if (previous.name !== entry.name)
+            continue;
+        issues.push({
+            name: entry.name,
+            issue: {
+                code: exports.E_ADAPTER_DUPLICATE,
+                path: '',
+                file,
+                message: `declared in both ${previous.path} and ${entry.path}: an adapter name is unique across built-in/ and custom/, it is not an override (spec-016 §2.1)`,
+            },
+        });
+    }
+    return issues;
+}
+/**
+ * Every adapter commit `rev` declares, sorted by name (byte order): only the names {@link loadAdapter}
+ * can select; {@link adapterTreeDiagnosticsAtRev} reports the rest. Nothing is parsed.
+ *
+ * @param rev - A revision naming one commit; `HEAD` for the gating read.
+ * @throws `ValidationError` (`E_ADAPTER_DUPLICATE`) when a name is in both `built-in/` and `custom/`;
+ *   `RevisionError` when `rev` names no commit.
+ */
+function listAdaptersAtRev(root, rev) {
+    const entries = entriesAtCommit(root, (0, revision_1.resolveRevision)(root, rev));
+    const duplicates = duplicateIssues(entries, `${rev}:${exports.ADAPTERS_DIR_PATH}`);
+    if (duplicates.length > 0)
+        throw new validation_1.ValidationError(duplicates.map(({ issue }) => issue));
+    return entries;
+}
+/**
+ * The refusal of a name declared in both adapter directories at `rev` (§2.1), in {@link loadAdapter}'s
+ * shape — `adapter '<first name>': declared in both …`, every duplicated name a `dl-055` detail line —
+ * or `undefined` when every name is unique. `agent execute` asks it where it lists the adapter tree
+ * (§3.3 step 2), before it resolves the element, the role or the agent.
+ *
+ * @param rev - A revision naming one commit (a sha, or `HEAD`; at `HEAD` a repository with no commit has
+ *   no adapter).
+ * @param label - How the refusal spells the revision; defaults to `rev`. A caller that resolved `HEAD`
+ *   to a sha once, to read everything at that one commit, passes the sha as `rev` and `HEAD` here
+ *   (task-235's review F3).
+ */
+function duplicateAdapterRefusal(root, rev, label = rev) {
+    const sha = rev === 'HEAD' ? (0, revision_1.atHeadOr)(root, () => (0, revision_1.resolveRevision)(root, rev), null) : (0, revision_1.resolveRevision)(root, rev);
+    if (sha === null)
+        return undefined;
+    const duplicates = duplicateIssues(entriesAtCommit(root, sha), `${label}:${exports.ADAPTERS_DIR_PATH}`);
+    if (duplicates.length === 0)
+        return undefined;
+    const [first] = duplicates;
+    return (0, types_1.coreErr)({
+        code: 'VALIDATION',
+        message: `adapter '${first.name}': ${first.issue.message}`,
+        details: { issues: duplicates.map(({ issue }) => ({ ...issue, detail: render(issue) })) },
+    });
+}
+/** An issue in the form a refusal shows it: `<path>: <message>`, or the message alone at the root. */
+function render(issue) {
+    return issue.path === '' ? issue.message : `${issue.path}: ${issue.message}`;
+}
+/**
+ * Select, read and validate the adapter `name` at `rev` (`spec-016` §3.2 step 5): the gating read
+ * `agent execute` makes. Only that manifest is parsed.
+ *
+ * Refusals, each `adapter '<name>': …`:
+ * - `VALIDATION` — `name` is not an id (`spec-009` §1); a name is in both directories (the first such
+ *   name is the one named, and every duplicated name is a `dl-055` detail line); the manifest is invalid (§3.7: the first issue in the message, every issue
+ *   a `dl-055` detail line with its file);
+ * - `NOT_FOUND` — no `built-in/<name>.yaml` or `custom/<name>.yaml` at `rev` (at `HEAD`, a repository
+ *   with no commit has no adapter);
+ * - a `RevisionError`'s own code and message when `rev`, other than `HEAD`, names no commit.
+ *
+ * @param rev - Defaults to `HEAD` (`dl-080` (B)).
+ * @param label - How refusals and issue paths spell the revision; defaults to `rev` (see
+ *   {@link duplicateAdapterRefusal}).
+ */
+function loadAdapter(root, name, rev = 'HEAD', label = rev) {
+    const refuse = (code, reason, issues, subject = name) => (0, types_1.coreErr)({
+        code,
+        message: `adapter '${subject}': ${reason}`,
+        ...(issues === undefined ? {} : { details: { issues: issues.map((issue) => ({ ...issue, detail: render(issue) })) } }),
+    });
+    if (!(0, validation_1.isIdPiece)(name)) {
+        return refuse('VALIDATION', `not an adapter name: an adapter name is an id, characters [${validation_1.ID_CHAR_CLASS}] only (spec-009 §1)`);
+    }
+    let sha;
+    try {
+        sha = rev === 'HEAD' ? (0, revision_1.atHeadOr)(root, () => (0, revision_1.resolveRevision)(root, rev), null) : (0, revision_1.resolveRevision)(root, rev);
+    }
+    catch (error) {
+        if (error instanceof revision_1.RevisionError)
+            return (0, types_1.coreErr)(error.toCoreError());
+        throw error;
+    }
+    const entries = sha === null ? [] : entriesAtCommit(root, sha);
+    // Every duplicated name is a dl-055 detail line; the message names the first (task-177 review F2).
+    const duplicates = duplicateIssues(entries, `${label}:${exports.ADAPTERS_DIR_PATH}`);
+    if (duplicates.length > 0) {
+        const [first] = duplicates;
+        return refuse('VALIDATION', first.issue.message, duplicates.map(({ issue }) => issue), first.name);
+    }
+    const entry = entries.find((candidate) => candidate.name === name);
+    const text = entry === undefined || sha === null ? null : (0, storage_1.readPathAtRev)(root, sha, entry.path);
+    if (entry === undefined || text === null) {
+        return refuse('NOT_FOUND', `no ${exports.ADAPTERS_DIR_PATH}/built-in/${name}.yaml or ${exports.ADAPTERS_DIR_PATH}/custom/${name}.yaml at ${label}`);
+    }
+    try {
+        const manifest = (0, manifest_1.parseAdapterManifest)(text, { name, kind: entry.kind, file: `${label}:${entry.path}` });
+        return (0, types_1.coreOk)({ ...entry, manifest });
+    }
+    catch (error) {
+        if (!(error instanceof validation_1.ValidationError))
+            throw error;
+        return refuse('VALIDATION', render(error.issues[0]), error.issues);
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/agent/discovery.js.map

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