Initial public push: docs cosmos v4 + AI module + framework groundwork

This is the snapshot the production landing site (nibiru-framework.com) is
deployed from. Brings together the recent splash + docs migration to the v4
"Cosmos" design system, the new in-framework AI module, and the framework
groundwork that backs the framework-reference extraction.

What lands:
- docs/: Astro + Starlight site with the v4 dark cosmic palette, GalaxyHero
  canvas constellation, Mission Control chat (wired to /api/oracle →
  api.neuronetz.ai via providers.mjs Ollama), 5-panel MMVC stage
  (Model · AI · Module · Controller · View), translated EN/DE/JA/ES/FR
  content, PWA + sitemap + llms.txt + Umami analytics.
- docs/design-system/: canonical mockup bundle (source/index-v2.html for
  splash, source/docs-system.html + preview/ for docs, SPEC.md, tokens).
- docs/scripts/extraction/framework-reference-v2.md: deep framework
  reference (~1.6k lines, file:line citations, every public factory and
  idiom — basis for the LoRA training corpus.
- application/module/ai/: AI module with chat / embed / RAG / agent
  plugins, plus pdoQuery / httpGet / fileRead tools and Modelfile +
  smoke-test in training/.
- application/module/users/: user / ACL / form-factory traits used as the
  reference plugin pattern for the framework docs.
- application/settings/config/database/: schema + seed migrations
  including the AI module tables (200–203).
- Form factory + autogenerator changes the framework-reference-v2 covers.

Production secrets stay out: docs/.env, settings.production.ini and
ai.production.ini are all gitignored (.example files are in tree).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

docs/design-system/README.md

@@ -0,0 +1,61 @@
+# Nibiru Atelier — Design System
+
+The visual language of the Nibiru framework. A lotus on cream paper, lit by morning light.
+
+## What's here
+
+| File | Purpose |
+|---|---|
+| `tokens.json` | Source of truth, [W3C Design Tokens Community Group](https://design-tokens.github.io/community-group/format/) format. |
+| `tokens.css` | CSS custom properties, namespaced `--nibiru-*`. |
+| `tokens.scss` | SCSS variables and maps. |
+| `tailwind.preset.js` | Tailwind preset extending colours, fonts, shadows. |
+
+## Use
+
+### CSS
+
+```html
+<link rel="stylesheet"
+      href="https://nibiru-framework.com/design-system/tokens.css">
+<style>
+  body  { background: var(--nibiru-paper); color: var(--nibiru-ink);
+          font-family: var(--nibiru-font-text); }
+  h1    { font-variation-settings: var(--nibiru-fv-display-hero);
+          letter-spacing: var(--nibiru-tracking-display); }
+  .cta  { background: var(--nibiru-ink); color: var(--nibiru-paper);
+          padding: 0.7rem 1.2rem;
+          border-radius: var(--nibiru-radius-md); }
+</style>
+```
+
+### Tailwind
+
+```jsx
+<button className="bg-nibiru-ink text-nibiru-paper px-5 py-2 rounded-md font-display tracking-body">
+  Read the docs
+</button>
+
+<h1 className="text-hero text-nibiru-ink tracking-display">
+  Create. Invent. <em className="text-nibiru-iris-deep">Impress.</em>
+</h1>
+```
+
+## Full guide
+
+→ <https://nibiru-framework.com/en/design/overview/>
+
+## Versioning
+
+`4.0.0` — **Cosmos**. Dark-first AI-framework brand. Magenta-amber-blue nebula
+palette on a deep-space body, Space Grotesk display + Inter Tight body +
+JetBrains Mono. Light "paper" surfaces still available via `.alt` sections for
+content-heavy reading.
+
+`3.0.0` — **Atelier × Cosmos**. Reconciles the editorial atelier (paper-and-ink)
+with a modern AI-tool dialect: warmer butter page (`#fdf6df`), Geist type,
+rounder surfaces (8–16 px), plus a dark cosmic sub-palette and a code surface
+stack for hero / chat / code-card components.
+
+`2.0.0` — Atelier release. Lotus-violet, sky-blue and warm-cream system drawn
+from the actual brand mark. Bricolage Grotesque, editorial radii.