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>

application/module/ai/settings/ai.ini

@@ -0,0 +1,53 @@
+; =====================================================================
+;  Nibiru AI module — config
+;
+;  Sections supported under [AI]:
+;    - Ollama transport
+;    - Chat completions
+;    - Embeddings
+;    - RAG (retrieval-augmented generation)
+;    - Agents
+;
+;  Override per-environment with ai.production.ini, ai.staging.ini, etc.
+; =====================================================================
+
+[AI]
+; --- Ollama transport ---
+; Default is the standard local Ollama port. Override per environment in
+; ai.production.ini / ai.staging.ini, or set the OLLAMA_BASE_URL env var.
+ollama.base_url     = "http://localhost:11434"
+ollama.timeout      = 90
+ollama.retries      = 1
+
+; --- Chat ---
+chat.model          = "nibiru-coder:1.0"
+chat.fallback_model = "qwen2.5-coder:14b"
+chat.temperature    = 0.4
+chat.max_tokens     = 1024
+chat.system_prompt  = "You are an expert on the Nibiru PHP framework. Answer with concrete code examples."
+
+; --- Embeddings ---
+embed.model         = "nomic-embed-text"
+embed.batch         = 16
+embed.dim           = 768
+
+; --- RAG ---
+rag.storage_path    = "/../../application/module/ai/cache/rag/"
+rag.top_k           = 6
+rag.chunk_target    = 600
+rag.chunk_min       = 120
+rag.chunk_max       = 900
+
+; --- Agents ---
+agent.max_iterations    = 6
+agent.tool_timeout      = 30
+agent.allowed_tools[]   = "pdo_query"
+agent.allowed_tools[]   = "http_get"
+agent.allowed_tools[]   = "view_assign"
+agent.allowed_tools[]   = "form_build"
+
+; --- Anthropic / OpenAI fallback (optional) ---
+anthropic.api_key   = ""
+anthropic.model     = "claude-haiku-4-5-20251001"
+openai.api_key      = ""
+openai.embed_model  = "text-embedding-3-small"