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/users/traits/users.php

@@ -0,0 +1,144 @@
+<?php
+namespace Nibiru\Module\Users\Traits;
+/**
+ * @desc this file is for the autoloader to function properly,
+ * you might as well use it as the primary user trait for your
+ * application
+ * Created by PhpStorm.
+ * User: kasdorf
+ * Date: 28.08.18
+ * Time: 11:24
+ */
+use Nibiru\Factory\Form;
+
+trait Users
+{
+    /**
+     * @desc this  will return the login form
+     * @return string
+     */
+    public function loginForm(): string
+    {
+        Form::create();
+        //Start form field Username
+        Form::addOpenDiv([
+            'class' => 'form-group',
+            'value' => ''
+        ]);
+        Form::addOpenDiv([
+            'class' => 'input-group mb-3',
+            'value' => ''
+        ]);
+        Form::addOpenAny([
+            'any' => 'span',
+            'class' => 'input-group-text bg-transparent',
+            'value' => ''
+        ]);
+        Form::addOpenAny([
+            'any' => 'i',
+            'class' => 'ti-user',
+            'value' => ''
+        ]);
+        Form::addCloseAny([
+            'any' => 'i'
+        ]);
+        Form::addCloseAny([
+            'any' => 'span'
+        ]);
+        Form::addInputTypeText([
+            'class' => 'form-control ps-15 bg-transparent',
+            'name'  => 'login',
+            'placeholder' => 'Benutzername'
+        ]);
+        Form::addCloseDiv();
+        Form::addCloseDiv();
+        //Start form field Password
+        Form::addOpenDiv([
+            'class' => 'form-group',
+            'value' => ''
+        ]);
+        Form::addOpenDiv([
+            'class' => 'input-group mb-3',
+            'value' => ''
+        ]);
+        Form::addOpenAny([
+            'any' => 'span',
+            'class' => 'input-group-text bg-transparent',
+            'value' => ''
+        ]);
+        Form::addOpenAny([
+            'any' => 'i',
+            'class' => 'ti-lock',
+            'value' => ''
+        ]);
+        Form::addCloseAny([
+            'any' => 'i'
+        ]);
+        Form::addCloseAny([
+            'any' => 'span'
+        ]);
+        Form::addInputTypePassword([
+            'class' => 'form-control ps-15 bg-transparent',
+            'name'  => 'password',
+            'placeholder' => 'Passwort'
+        ]);
+        Form::addCloseDiv();
+        Form::addCloseDiv();
+        //End form field Password
+        Form::addOpenDiv([
+            'class' => 'row',
+            'value' => ''
+        ]);
+        Form::addOpenDiv([
+            'class' => 'col-6',
+            'value' => ''
+        ]);
+
+        Form::addCloseDiv();
+
+
+        Form::addOpenDiv([
+            'class' => 'col-6',
+            'value' => ''
+        ]);
+        Form::addOpenDiv([
+            'class' => 'fog-pwd text-end',
+            'value' => ''
+        ]);
+
+        Form::addOpenAny([
+            'any' => 'a',
+            'href' => 'javascript:void(0)',
+            'class' => 'hover-warning',
+            'value' => '<i class="ion ion-locked"></i> Passwort vergessen?'
+        ]);
+        Form::addCloseAny([
+            'any' => 'a'
+        ]);
+        Form::addCloseDiv();
+        Form::addCloseDiv();
+
+        Form::addOpenDiv([
+            'class' => 'col-12 text-center',
+            'value' => ''
+        ]);
+
+        Form::addTypeButton([
+            'type' => 'submit',
+            'class' => 'btn btn-danger mt-10',
+            'value' => 'Anmelden'
+        ]);
+        Form::addCloseDiv();
+        Form::addCloseDiv();
+
+        return Form::addForm([
+            'name'  => 'loginForm',
+            'action' => '/users/login',
+            'method' => 'post',
+            'target' => '_self'
+        ]);
+    }
+
+
+
+}