site: /reference becomes the metamodel, the adopter model moves to /reference/example

/reference now serves the metamodel — every type, subtype and attribute the
loader accepts — rendered in the metaobjects repo and copied from the release
tag. The adopter model that used to own that URL moves to /reference/example,
where it is labelled as what it is: a real project documented by meta docs,
which is the one thing a self-referential metamodel page cannot demonstrate.

The ordering here is load-bearing. The example step runs first, so the
metamodel copy must never rm -rf www/reference — that would delete the
example on every deploy. The example's own rm is narrowed to its own
subdirectory for the mirror-image reason: it used to remove the whole
directory, which would now take the reference with it.

HELD, not pushed. v0.24.5 carries no site-reference/, so deploying this now
would leave /reference showing only the example. Goes out with Task 15's held
commit right after the next release.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NynrRND6ZUwGvq3ZUTCfxG

Author: claude

.github/workflows/deploy.yml

@@ -35,15 +35,23 @@ jobs:
     # on every deploy (push to main / workflow_dispatch) — no cross-repo secrets.
     # --ignore-scripts skips wizardsofodd's wrangler postinstall (not needed for
     # docs). --prompts data/templates surfaces the actual prompt TEXT.
-    - name: Generate wizardsofodd reference docs
+    # A REAL PROJECT documented by `meta docs` — not "the reference". It lives at
+    # /reference/example because a self-referential metamodel page cannot show that the
+    # tool works on somebody's actual model, which is the only thing this demonstrates.
+    # /reference itself is the metamodel, copied in the next step.
+    #
+    # The `rm` is narrowed to this subdirectory. It used to remove the whole of
+    # www/reference, which — now that the metamodel lands there too — would delete the
+    # reference and leave only the example behind, on every deploy.
+    - name: Generate the example project's docs (a real model, documented by meta docs)
       run: |
         git clone --depth 1 https://github.com/Draagon/wizardsofodd.git /tmp/woo
         cd /tmp/woo
         npm ci --ignore-scripts
         npx meta docs . --site --prompts data/templates --out /tmp/woo-docs
-        rm -rf "$GITHUB_WORKSPACE/www/reference"
-        mkdir -p "$GITHUB_WORKSPACE/www/reference"
-        cp -r /tmp/woo-docs/site/* "$GITHUB_WORKSPACE/www/reference/"
+        rm -rf "$GITHUB_WORKSPACE/www/reference/example"
+        mkdir -p "$GITHUB_WORKSPACE/www/reference/example"
+        cp -r /tmp/woo-docs/site/* "$GITHUB_WORKSPACE/www/reference/example/"
 
     # Snippet injection: clone metaobjects at its latest npm RELEASE TAG — not main —
     # and inject its committed site-payload.json into this site's data-snippet
@@ -99,6 +107,24 @@ jobs:
         echo "injecting snippets from metaobjects $TAG"
         node scripts/site-inject-ci.mjs --site "$GITHUB_WORKSPACE/www"
 
+        # The metamodel reference at /reference — every type, subtype and attribute the
+        # loader accepts, rendered in the metaobjects repo and carried by the tag. It is
+        # NOT rendered here: this workflow has setup-node and nothing else, the metaobjects
+        # clone gets no install step, and keeping it that way is what stops a site deploy
+        # from depending on that workspace resolving.
+        #
+        # A plain copy, never `rm -rf www/reference` — the previous step has already
+        # written www/reference/example, and removing the parent would delete it on every
+        # deploy. Nothing stale can accumulate anyway: www/reference is gitignored, so each
+        # run starts from a checkout that does not contain it.
+        if [ -d site-reference ]; then
+          mkdir -p "$GITHUB_WORKSPACE/www/reference"
+          cp -r site-reference/. "$GITHUB_WORKSPACE/www/reference/"
+          echo "copied the metamodel reference from metaobjects $TAG"
+        else
+          echo "::warning::metaobjects $TAG has no site-reference/ — /reference will show only the example."
+        fi
+
     - name: Setup Pages
       uses: actions/configure-pages@v4
 

.gitignore

@@ -1,4 +1,6 @@
-# Generated at deploy time by deploy.yml (meta docs from wizardsofodd)
+# Built at deploy time by deploy.yml: /reference is the metamodel reference, rendered
+# in the metaobjects repo and copied from the release tag; /reference/example is a real
+# project documented by `meta docs`. Neither is authored here.
 www/reference/
 
 # Copied from the metaobjects repo at deploy (docs/llms/*), pinned to the release tag.

www/index.html

@@ -33,7 +33,7 @@
       <a href="/requirements.html" class="nav-link">Requirements</a>
       <a href="/story.html" class="nav-link">Story</a>
       <a href="/videos.html" class="nav-link">Videos</a>
-      <a href="/reference/" class="nav-link">Reference docs</a>
+      <a href="/reference/" class="nav-link">Reference</a>
       <a href="https://github.com/metaobjectsdev/metaobjects" class="nav-link">GitHub</a>
       <a href="#ai" class="nav-link">For AI</a>
       <a href="https://github.com/metaobjectsdev/metaobjects/tree/main/spec" class="nav-link nav-cta">Spec</a>