refactor(docs): move docs to /products and /realms URL namespace with 301s

.gitignore

@@ -16,3 +16,7 @@ content/docs/fabric/resonance/
 !.env.example
 !.env.*.template
 !.env.template
+
+# Local-only docs migration data (contains unlaunched/private product slugs); never commit
+scripts/migration/data/
+content/_unlaunched/

content/docs/community/contributing/golden.mdx

@@ -18,7 +18,7 @@ import app from "@/lib/config/app.config";
 **Omni Golden** is the canonical baseline for how Omni code should look, behave, and be styled. It documents style conventions, architectural patterns, and agent rules, representing the source of truth for _how_ code should be written.
 
 <Callout>
-  Golden contains only documentation. For config files and project scaffolding, see [📜 Templates](/armory/templates).
+  Golden contains only documentation. For config files and project scaffolding, see [📜 Templates](/realms/armory/templates).
 </Callout>
 
 ## See Also

content/docs/ethos.mdx

@@ -10,7 +10,7 @@ We believe openness creates better software and stronger communities.
 
 - **Open-source, self-hostable solutions.** Our core tools are open-source. You can inspect the code, contribute improvements, and self-host when you need full control.
 - **No vendor lock-in.** We design for portability. Your data and workflows are never trapped.
-- **Community-driven development.** Users influence our roadmap (see [📣 Backfeed](/core/backfeed)). We build what matters to the people who use our tools.
+- **Community-driven development.** Users influence our roadmap (see [📣 Backfeed](/products/backfeed)). We build what matters to the people who use our tools.
 
 ## Transparent Operations
 

content/docs/help/self-hosting/configuration.mdx

@@ -74,7 +74,7 @@ Set `SELF_HOSTED=true` to disable billing and cloud features:
 SELF_HOSTED=true
 ```
 
-See the full [Vortex configuration reference](/grid/vortex/configuration) for all available variables.
+See the full [Vortex configuration reference](/products/vortex/configuration) for all available variables.
 
 ### Manifold
 

content/docs/help/self-hosting/docker-compose.mdx

@@ -40,7 +40,7 @@ docker compose --env-file .env.local -f compose.yaml -f compose.dev.yaml up --bu
 
 ### Runa
 
-[Runa](/core/runa) runs three containers:
+[Runa](/products/runa) runs three containers:
 
 | Container | Image | Port |
 |-----------|-------|------|
@@ -60,7 +60,7 @@ docker compose --env-file .env.local up -d
 
 ### Vortex
 
-[Vortex](/grid/vortex) runs six containers:
+[Vortex](/products/vortex) runs six containers:
 
 | Container | Image | Port |
 |-----------|-------|------|
@@ -97,7 +97,7 @@ docker compose up -d
 | `IGGY_USERNAME` | Iggy admin username |
 | `IGGY_PASSWORD` | Iggy admin password |
 
-Optional: `DB_NAME`, `DB_USER`, `DB_PORT`, `API_PORT`, `APP_PORT`, `CACHE_PORT`, and OAuth provider credentials (`GOOGLE_*`, `GITHUB_*`, `OIDC_*`). See the full [Vortex configuration reference](/grid/vortex/configuration).
+Optional: `DB_NAME`, `DB_USER`, `DB_PORT`, `API_PORT`, `APP_PORT`, `CACHE_PORT`, and OAuth provider credentials (`GOOGLE_*`, `GITHUB_*`, `OIDC_*`). See the full [Vortex configuration reference](/products/vortex/configuration).
 
 #### Volumes
 
@@ -111,7 +111,7 @@ Three named volumes persist data across restarts:
 
 ### Manifold
 
-[Manifold](/armory/manifold) runs three containers:
+[Manifold](/products/manifold) runs three containers:
 
 | Container | Port | Description |
 |-----------|------|-------------|
@@ -149,11 +149,11 @@ Manifold supports filesystem or S3-compatible blob storage:
 | `BLOB_S3_ENDPOINT` | — | Custom S3 endpoint (for MinIO, R2) |
 | `BLOB_S3_PREFIX` | `blobs` | S3 key prefix |
 
-See the [Manifold Storage guide](/armory/manifold/storage) for details.
+See the [Manifold Storage guide](/products/manifold/storage) for details.
 
 ### Synapse
 
-[Synapse](/grid/synapse) runs five containers:
+[Synapse](/products/synapse) runs five containers:
 
 | Container | Image | Port |
 |-----------|-------|------|
@@ -191,7 +191,7 @@ Optional: `AUTH_BASE_URL` (HIDRA Gatekeeper), `BILLING_*` (billing), `CORS_ALLOW
 | `db_data` | PostgreSQL | Database files |
 | `valkey_data` | Valkey | Rate limit state and cache |
 
-See the [Synapse self-hosting guide](/grid/synapse/self-hosting) for Helm charts, gateway configuration, and binary installs.
+See the [Synapse self-hosting guide](/products/synapse/self-hosting) for Helm charts, gateway configuration, and binary installs.
 
 ## Database Migrations
 

content/docs/help/self-hosting/index.mdx

@@ -17,46 +17,46 @@ Most Omni products follow a [standard Docker Compose pattern](/help/self-hosting
 
 | Product | Realm | Guide |
 |---------|-------|-------|
-| [Runa](/core/runa) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Backfeed](/core/backfeed) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Channel](/core/channel) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Crystal](/core/crystal) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Mantle](/core/mantle) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [MyFi](/core/myfi) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Halo](/core/halo) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Blink](/kindred/blink) | Kindred | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Creator](/fabric/creator) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Gaia](/fabric/gaia) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Trellis](/fabric/trellis) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Beacon](/grid/beacon) | Grid | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Vortex](/grid/vortex) | Grid | [Docker Compose](/help/self-hosting/docker-compose), [Helm](/help/self-hosting/kubernetes) |
-| [Lattice](/grid/lattice) | Grid | [Docker Compose](/help/self-hosting/docker-compose) |
-| [HIDRA](/armory/hidra) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Aether](/armory/aether) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Arbor](/armory/arbor) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
-| [Manifold](/armory/manifold) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Runa](/products/runa) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Backfeed](/products/backfeed) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Channel](/products/channel) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Crystal](/realms/core/crystal) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Mantle](/products/mantle) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [MyFi](/products/myfi) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Halo](/products/halo) | Core | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Blink](/products/blink) | Kindred | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Creator](/products/creator) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Gaia](/products/gaia) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Trellis](/products/trellis) | Fabric | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Beacon](/products/beacon) | Grid | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Vortex](/products/vortex) | Grid | [Docker Compose](/help/self-hosting/docker-compose), [Helm](/help/self-hosting/kubernetes) |
+| [Lattice](/realms/grid/lattice) | Grid | [Docker Compose](/help/self-hosting/docker-compose) |
+| [HIDRA](/products/hidra) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Aether](/products/aether) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Arbor](/realms/armory/arbor) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
+| [Manifold](/products/manifold) | Armory | [Docker Compose](/help/self-hosting/docker-compose) |
 
 ### Kubernetes
 
 | Product | Guide |
 |---------|-------|
-| [Fractal](/grid/fractal) | [Kubernetes](/help/self-hosting/kubernetes) |
-| [Vortex](/grid/vortex) | [Helm chart](/help/self-hosting/kubernetes#vortex-helm-chart) |
+| [Fractal](/products/fractal) | [Kubernetes](/help/self-hosting/kubernetes) |
+| [Vortex](/products/vortex) | [Helm chart](/help/self-hosting/kubernetes#vortex-helm-chart) |
 
 ### Binary / Docker
 
 | Product | Methods | Guide |
 |---------|---------|-------|
-| [Synapse](/grid/synapse) | Docker Compose, Helm, Binary | [Docker Compose](/help/self-hosting/docker-compose#synapse), [Self-Hosting](/grid/synapse/self-hosting) |
-| [Omni Terminal](/armory/omni-terminal) | Binary, Docker | [Binary installs](#omni-terminal) |
+| [Synapse](/products/synapse) | Docker Compose, Helm, Binary | [Docker Compose](/help/self-hosting/docker-compose#synapse), [Self-Hosting](/products/synapse/self-hosting) |
+| [Omni Terminal](/products/omni-terminal) | Binary, Docker | [Binary installs](#omni-terminal) |
 
 ## Binary Installs
 
 Some products ship as standalone binaries and don't require Docker or Kubernetes.
 
 ### Synapse
 
-[Synapse](/grid/synapse) runs as a full stack (gateway + API + dashboard) via Docker Compose, or the gateway alone as a standalone binary:
+[Synapse](/products/synapse) runs as a full stack (gateway + API + dashboard) via Docker Compose, or the gateway alone as a standalone binary:
 
 ```bash
 # Full stack (Docker Compose)
@@ -75,11 +75,11 @@ cargo build --release
 
 Prebuilt gateway binaries for Linux (x86_64, aarch64) and macOS (Apple Silicon) are available on the [releases page](https://github.com/omnidotdev/synapse-gateway/releases).
 
-See the [Synapse self-hosting guide](/grid/synapse/self-hosting) for full configuration and environment variable reference.
+See the [Synapse self-hosting guide](/products/synapse/self-hosting) for full configuration and environment variable reference.
 
 ### Omni Terminal
 
-[Omni Terminal](/armory/omni-terminal) runs in the browser via the `serve` subcommand. The WASM frontend is embedded at compile time:
+[Omni Terminal](/products/omni-terminal) runs in the browser via the `serve` subcommand. The WASM frontend is embedded at compile time:
 
 ```bash
 # Via package manager (Homebrew, AUR, etc.)
@@ -107,11 +107,11 @@ docker build -t omni-terminal-web .
 docker run -p 3000:3000 omni-terminal-web
 ```
 
-See the [Omni Terminal Web docs](/armory/omni-terminal/web) for full details including TLS configuration and the npm package.
+See the [Omni Terminal Web docs](/products/omni-terminal/web) for full details including TLS configuration and the npm package.
 
 ## Self-Hosting Simplification
 
-[Run](/grid/run) is Omni's tool for simplifying self-hosted deployments. Check its documentation for the latest on streamlining multi-product setups.
+[Run](/products/run) is Omni's tool for simplifying self-hosted deployments. Check its documentation for the latest on streamlining multi-product setups.
 
 <Cards>
   <Card title="Docker Compose" href="/help/self-hosting/docker-compose">

content/docs/help/self-hosting/kubernetes.mdx

@@ -7,7 +7,7 @@ This page covers Kubernetes-based deployments: Fractal for full platform provisi
 
 ## Fractal
 
-[Fractal](/grid/fractal) is Omni's self-hostable application deployment platform built on Kubernetes. It can provision a cluster from scratch or install on an existing one.
+[Fractal](/products/fractal) is Omni's self-hostable application deployment platform built on Kubernetes. It can provision a cluster from scratch or install on an existing one.
 
 ### Installation Modes
 
@@ -106,11 +106,11 @@ Fractal applies default-deny Cilium network policies per project namespace. Each
 - DNS resolution
 - OTEL collector (observability)
 
-See the [Fractal documentation](/grid/fractal) for configuration and CLI reference.
+See the [Fractal documentation](/products/fractal) for configuration and CLI reference.
 
 ## Vortex Helm Chart
 
-[Vortex](/grid/vortex) ships a Helm chart for Kubernetes deployments.
+[Vortex](/products/vortex) ships a Helm chart for Kubernetes deployments.
 
 ### Prerequisites
 

content/docs/meta.json

@@ -10,28 +10,42 @@
     "ethos",
     "ecosystem",
     "open-source",
-    "orin",
-    "launcher",
-    "lens",
-    "...",
+    "products",
     "---Core---",
-    "...core",
-    "---Fabric---",
-    "...fabric",
-    "---Armory---",
-    "...armory",
-    "---Reality---",
-    "...reality",
+    "realms/core/index",
+    "products/backfeed",
+    "products/runa",
     "---Kindred---",
-    "...kindred",
+    "realms/kindred/index",
+    "---Fabric---",
+    "realms/fabric/index",
     "---Grid---",
-    "...grid",
+    "realms/grid/index",
+    "products/beacon",
+    "products/fractal",
+    "products/kiln",
+    "products/synapse",
+    "products/vortex",
+    "---Armory---",
+    "realms/armory/index",
+    "products/eden",
+    "products/omni-cli",
+    "products/omni-terminal",
+    "realms/armory/templates",
     "---Codex---",
-    "...codex",
+    "realms/codex/index",
+    "products/garden",
+    "products/life-json",
+    "products/persona-json",
     "---Sigil---",
-    "...sigil",
+    "realms/sigil/index",
+    "products/thornberry",
+    "products/zenpetal",
+    "---Reality---",
+    "realms/reality/index",
+    "products/rdk",
     "---Worlds---",
-    "...worlds",
+    "realms/worlds/index",
     "---Community---",
     "...community",
     "---Help---",

content/docs/core/backfeed/api.mdx → content/docs/products/backfeed/api.mdx

@@ -5,7 +5,7 @@ description: Programmatic access and event-driven integration (planned)
 
 <Callout type="warn">
   **Planned.** A documented public API and webhooks are on the
-  [roadmap](/core/backfeed/roadmap). This page describes the direction, not yet
+  [roadmap](/products/backfeed/roadmap). This page describes the direction, not yet
   a stable contract.
 </Callout>
 
@@ -16,5 +16,5 @@ existing stack.
 In the meantime, Backfeed is already event-driven internally: every change emits
 a [CloudEvent](https://cloudevents.io) (`backfeed.post.*`, `backfeed.comment.*`,
 `backfeed.vote.*`, and more) so the rest of the Omni ecosystem can react,
-including [closing the loop with Runa](/core/backfeed/runa-loop). See
-[integrations](/core/backfeed/integrations) for what connects today.
+including [closing the loop with Runa](/products/backfeed/runa-loop). See
+[integrations](/products/backfeed/integrations) for what connects today.

content/docs/core/backfeed/features/ai-ingestion.mdx → content/docs/products/backfeed/features/ai-ingestion.mdx

@@ -35,4 +35,4 @@ flow still works.
 
 More connectors are on the way: in-app widgets, social mentions, app-store
 reviews, and chat channels (the Signal model already supports these source
-types). Track them on the [roadmap](/core/backfeed/roadmap).
+types). Track them on the [roadmap](/products/backfeed/roadmap).

content/docs/core/backfeed/features/boards-posts.mdx → content/docs/products/backfeed/features/boards-posts.mdx

@@ -12,7 +12,7 @@ A shareable board per project where users submit posts and the team triages
 them. Boards are **public by default** (no account required to view), so the
 primary use case (collecting feedback from external users) works out of the box.
 Posting and voting require signing in. See
-[board visibility](/core/backfeed/board-visibility) for the public/private
+[board visibility](/products/backfeed/board-visibility) for the public/private
 toggle.
 
 ## Posts
@@ -31,7 +31,7 @@ addressed by a per-project number (`#42`, or `PREFIX-42` when a prefix is set).
 
 Up/down votes on every post surface demand; sort the board by top-voted or most
 recent. Human votes are always the prioritization layer, even as
-[AI triage](/core/backfeed/features/ai-ingestion) handles sorting.
+[AI triage](/products/backfeed/features/ai-ingestion) handles sorting.
 
 ## Comments & reactions
 

content/docs/core/backfeed/features/index.mdx → content/docs/products/backfeed/features/index.mdx

@@ -6,18 +6,18 @@ description: A map of what Backfeed does, grouped by what you are trying to get
 Backfeed's features fall into a few groups. Start anywhere; everything connects
 to the same board.
 
-- **[Boards, posts & voting](/core/backfeed/features/boards-posts)** — collect
+- **[Boards, posts & voting](/products/backfeed/features/boards-posts)** — collect
   feedback: public boards, posts with rich text and attachments, voting,
   threaded comments, reactions, and duplicate detection.
-- **[Statuses, roadmap & changelog](/core/backfeed/features/statuses-roadmap)** —
+- **[Statuses, roadmap & changelog](/products/backfeed/features/statuses-roadmap)** —
   track and communicate: customizable statuses, a per-post timeline, a public
   roadmap, an opt-in changelog, status notifications, and at-a-glance metrics.
-- **[Tags & filtering](/core/backfeed/features/tags-filtering)** — organize:
+- **[Tags & filtering](/products/backfeed/features/tags-filtering)** — organize:
   project-scoped tags, search, sorting, and saved views.
-- **[AI & ingestion](/core/backfeed/features/ai-ingestion)** — scale: the Signal
+- **[AI & ingestion](/products/backfeed/features/ai-ingestion)** — scale: the Signal
   model, email-to-feedback, optional AI triage, and content moderation.
 
 Two cross-cutting topics have their own pages:
-[board visibility](/core/backfeed/board-visibility) (public vs private) and
-[closing the loop with Runa](/core/backfeed/runa-loop). What is coming next
-lives on the [roadmap](/core/backfeed/roadmap).
+[board visibility](/products/backfeed/board-visibility) (public vs private) and
+[closing the loop with Runa](/products/backfeed/runa-loop). What is coming next
+lives on the [roadmap](/products/backfeed/roadmap).

content/docs/core/backfeed/getting-started.mdx → content/docs/products/backfeed/getting-started.mdx

@@ -14,4 +14,4 @@ description: Spin up a workspace, create a project, and start collecting feedbac
 5. **Review & Prioritize**
    Use Backfeed's prioritization tools to filter, sort, and rank posts based on importance and feasibility.
 6. **Plan & Execute**
-   Move posts through your statuses to build the roadmap, hand accepted work to [Runa](/core/runa), and close the loop with reporters when it ships.
+   Move posts through your statuses to build the roadmap, hand accepted work to [Runa](/products/runa), and close the loop with reporters when it ships.

content/docs/core/backfeed/index.mdx → content/docs/products/backfeed/index.mdx

@@ -61,4 +61,4 @@ import {
 
 **Omni Backfeed** is a user feedback reporting platform. Backfeed aggregates user data for your products, services, and experiences, providing a centralized location to iterate on your projects with user-driven insights and planning.
 
-Backfeed is evolving from a feedback board into an **AI-native feedback brain**: it keeps the public board, voting, and roadmap at its core while learning to ingest feedback from many sources and triage it automatically. The board stays the source of truth, and human votes still set priority. AI handles the manual labor of sorting, not the judgment. See [AI & Ingestion](/core/backfeed/features/ai-ingestion).
+Backfeed is evolving from a feedback board into an **AI-native feedback brain**: it keeps the public board, voting, and roadmap at its core while learning to ingest feedback from many sources and triage it automatically. The board stays the source of truth, and human votes still set priority. AI handles the manual labor of sorting, not the judgment. See [AI & Ingestion](/products/backfeed/features/ai-ingestion).