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/view/mockup/template/php/contact.php

@@ -0,0 +1,36 @@
+<?php
+ 
+    // Collect the data from the form.
+    $full_name = htmlspecialchars($_POST["full-name"]);
+    $email = htmlspecialchars($_POST["email"]);
+    $website = htmlspecialchars($_POST["website"]);
+    $company = htmlspecialchars($_POST["company"]);
+    $country = htmlspecialchars($_POST["country"]);
+    $message = htmlspecialchars($_POST["message"]);
+
+    // Paste your mail here.
+    $myemail = "mail@example.com";
+ 
+    // Setting a content type.
+    $headers = "MIME-Version: 1.0\r\n";
+    $headers .= "Content-Type: text/html; charset=utf-8";
+   
+    // The message title which will be displayed in your mail box.
+    $subject = "New message from VSDocs!";
+
+    // Get the HTML template
+    $html_template = file_get_contents('../mail-template-contacts.html');
+
+
+    // Injecting variables in the HTML template
+    $html_template = str_replace('<% fullName %>', $full_name, $html_template);
+    $html_template = str_replace('<% email %>', $email, $html_template);
+    $html_template = str_replace('<% website %>', $website, $html_template);
+    $html_template = str_replace('<% company %>', $company, $html_template);
+    $html_template = str_replace('<% country %>', $country, $html_template);
+    $html_template = str_replace('<% message %>', $message, $html_template);
+   
+    // Send the mail.
+    mail($myemail, $subject, $html_template, $headers);
+
+?>