feat(fixtures): consolidate corpus around a flagship demo fork + mutation tests

.github/workflows/ci.yml

@@ -77,12 +77,19 @@ jobs:
       - name: Verify report snapshots
         run: pnpm reports:verify
 
-      # Dogfood the negotiation middleware over HTTP: `next start` on the built middleware fixture,
+      # Dogfood the negotiation middleware over HTTP: `next start` on the built flagship fixture,
       # then the dual-fetch probes (Ora's markdown-negotiation-vary semantics), the cloaking
       # guards, and the gated/dynamic/unknown-path branches — the Edge bundle serving for real.
       - name: Middleware dual-fetch dogfood
         run: pnpm dogfood:middleware
 
+      # Multi-build mutation tests over the flagship fixture: idempotence, user-edit preservation,
+      # orphaned-twin cleanup, additive change, and manifest drift — each is a copy → build →
+      # mutate → rebuild sequence with targeted delta assertions (the build-N+1 bugs the one-shot
+      # golden layer can't see).
+      - name: Flagship mutation tests
+        run: pnpm mutation:test
+
       # Official ARD conformance tool (vendored from ards-project/ard-spec — spec/ard/README.md)
       # over every catalog the fixture builds just generated. jsonschema enables the tool's strict
       # JSON Schema layer on top of its semantic checks.

.gitignore

@@ -26,16 +26,11 @@ fixtures/**/public/.well-known/mcp/server-card/
 # Markdown twins + the auth guide ax's postbuild step generates in fixtures — build output. The
 # tracked artifacts are the normalized snapshots under fixtures/*/twins.golden/. Scoped to the
 # exact generated paths so hand-authored fixture markdown (markdown-twins/public/hand.md,
-# discovery/public/agents.md) stays committed; a newly generated file that isn't listed here shows
-# up as untracked, which is the prompt to snapshot and list it.
+# flagship/public/destinations.md) stays committed; a newly generated file that isn't listed here
+# shows up as untracked, which is the prompt to snapshot and list it.
 fixtures/markdown-twins/public/index.md
 fixtures/markdown-twins/public/guides/
 fixtures/markdown-twins/public/live.md
-fixtures/mdx-content/public/index.md
-fixtures/mdx-content/public/guide.md
-fixtures/mcp-multi-server/public/index.md
-fixtures/discovery/public/index.md
-fixtures/middleware/public/index.md
 fixtures/*/public/auth.md
 fixtures/*/public/404.md
 
@@ -52,3 +47,18 @@ fixtures/**/.ora/
 
 # npm pack build artifact (not committed in this repo; the demo repo commits its own copy)
 *.tgz
+
+# Flagship fixture generated twins (its hand-authored twin, public/destinations.md, stays
+# committed; generated per-slug twins under public/destinations/ are covered by the dir entry).
+fixtures/flagship/public/index.md
+fixtures/flagship/public/results.md
+fixtures/flagship/public/checkout.md
+fixtures/flagship/public/seats.md
+fixtures/flagship/public/confirmation.md
+fixtures/flagship/public/guide.md
+fixtures/flagship/public/account.md
+fixtures/flagship/public/destinations/
+
+# flagship-pages fixture generated twins — build output.
+fixtures/flagship-pages/public/index.md
+fixtures/flagship-pages/public/destinations.md

README.md

@@ -181,5 +181,5 @@ actionable message.
 ```
 packages/ax            the plugin / CLI (`@ora-ai/ax`) — the npm package (3 runtime deps: ajv, ajv-formats, jiti)
 spec/                  vendored AI Catalog spec + hand-written JSON Schema + validator oracle
-fixtures/*             minimal-but-real Next.js apps — the test suite, docs examples, and eval corpus
+fixtures/*             real Next.js apps — the flagship (a full demo-app fork) + single-axis fixtures; the test suite, docs examples, and eval corpus
 ```