# OpenWOP v2 extensions

> Source: https://openwop.dev/spec/v2/ext/README.html · OpenWOP, the open-source protocol for multi-agent workflow orchestration. CC BY 4.0.

> **Status: Stable.**

This page defines the maturity labels that extension documents carry.
Extensions are outside the core profile unless a core document explicitly
incorporates them.

Each declared extension has a page at `spec/v2/ext/<name>/README.md` and a row
in [`../declaration.json`](../declaration.json). A row reserves the identifier;
it does not make the extension interoperable. Read the individual page to see
whether it defines portable behavior or only a discovery claim.

## Maturity labels

`scripts/check-ext-status-coherence.mjs` checks these labels against committed
conformance evidence.

### `Draft`

Declared, but without qualifying interoperability evidence.

**Predicate:** The family is declared in `spec/v2/declaration.json` with
`anchor: ext`.

### `Stable`

Witnessed: a host at evidence tier 2 or better served it at a certified cut.
A **certified** bundle in `evidence/v2-host-bundles/` records the family's
declared witness class as satisfied.

**Predicate:** The family has at least one `executed-pass` row under its
witness id `openwop.family.<key>`, in a bundle that certifies at least one
profile and whose `discovery.url` origin is listed at tier 2 or better in
[`evidence/host-tiers.json`](https://github.com/openwop/openwop/blob/main/evidence/host-tiers.json). The seven-day
comment window has also run since the promotion PR.

**`Stable` is a historical witness.**

- A host's retirement does not demote a family.
- The page's `last witnessed:` header row names the newest qualifying bundle, so a
  reader can see which host served it and when.
- When no tier-2 or tier-3 host serves, a `Draft` family cannot graduate until one
  does.

The label means only what the family's witness class checks:

- `witnessable-gated` or `seam-gated`: the host behaves as the page says.
- `claims-check`: the host advertises the reservation in a well-formed record.
  Two hosts are not shown to interoperate on it, because the page defines no
  portable operations.

### `Retired`

Withdrawn: the family is removed from the declaration, and the document names
its replacement or the RFC that retired it.

**Predicate:** The family is absent from the declaration, and the document
carries a `Superseded by:` or `Retired by:` line.

The check works both ways:

- A `Stable` document without qualifying evidence fails validation.
- A `Draft` document with qualifying evidence is reported as eligible for
  review and promotion.

### `Note`

A directory with no declared family is an implementation or migration note. It
carries `Status: Note.` and MUST say it is not a declared family. It is outside
this maturity rule and never becomes `Stable`. Today the notes are
`grpc-transport`, `provider-idempotency`, and `sandbox-runtime-notes`.

## What this does not decide

Whether an extension should become core. That takes a separate RFC, normative
text, machine-readable contracts, and a behavioral witness.

*Sources: RFC 0174, RFC 0177, RFC 0220.*
