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/.env.example

@@ -0,0 +1,40 @@
+# Copy to .env on the host and fill in the values you actually need.
+# .env is gitignored.
+#
+# DEFAULT MODE: Ollama on api.neuronetz.ai
+#   The Oracle uses your own GPU-backed Ollama by default — no paid API keys
+#   required. Just make sure the chat + embedding models are pulled (see
+#   below) and you're done.
+
+# === Default Ollama backend (used when LLM_PROVIDER and EMBED_PROVIDER are
+#     'ollama' — which they are by default) ===
+
+# LLM_PROVIDER=ollama
+OLLAMA_BASE_URL=https://api.neuronetz.ai
+OLLAMA_CHAT_MODEL=qwen2.5-coder:14b
+OLLAMA_EMBED_MODEL=nomic-embed-text
+
+# Pull these once on your Ollama host:
+#   curl https://api.neuronetz.ai/api/pull -d '{"name":"qwen2.5-coder:14b"}'
+#   curl https://api.neuronetz.ai/api/pull -d '{"name":"nomic-embed-text"}'
+
+# === Oracle behaviour ===
+ORACLE_TOP_K=6
+ORACLE_MAX_TOKENS=800
+
+# === Let's Encrypt / nginx-proxy ===
+LETSENCRYPT_EMAIL=stephan.kasdorf@bittomine.com
+
+# ===========================================================================
+# OPTIONAL FALLBACKS — only set these if you want to switch off Ollama.
+# ===========================================================================
+
+# To use Claude as the answering model:
+#   LLM_PROVIDER=anthropic
+#   ANTHROPIC_API_KEY=sk-ant-...
+# ANTHROPIC_MODEL=claude-haiku-4-5-20251001
+
+# To use OpenAI for embeddings (build time + runtime):
+#   EMBED_PROVIDER=openai
+#   OPENAI_API_KEY=sk-...
+# OPENAI_EMBED_MODEL=text-embedding-3-small