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/controller/loginController.php

@@ -0,0 +1,70 @@
+<?php
+namespace Nibiru;
+/**
+ * Class    loginController
+ * @project src
+ * @desc    This is a PHP class file, please specify the use
+ * @author  nibiru Framework
+ * @date    Aug 17 2023
+ * @time    16:11:34
+ * @package Nibiru
+ */
+use Nibiru\Adapter\Controller;
+use Nibiru\Module\{
+    Users\Plugins\Acl,
+    Users\Plugins\User,
+    Users\Traits\NewUser
+};
+class loginController extends Controller
+{
+    private string $page;
+    private object $user;
+    private array $navigation;
+    private object $acl;
+
+    public function __construct()
+    {
+        $this->acl = new Acl();
+        $this->user = new User();
+        $this->user->validate();
+        $this->page = Router::getInstance()->currentPage();
+        if(!$this->user->checkForStandardUser())
+        {
+            $this->user->loadUser();
+            $this->user->createStandardUser();
+        }
+        $this->navigation = JsonNavigation::getInstance()->loadCompleteNavigation("main");
+    }
+    public function pageAction()
+    {
+        // TODO: Implement pageAction() method.
+    }
+
+    public function navigationAction()
+    {
+        View::assign([
+            'navigation' => $this->navigation,
+            'current_path' => $_SERVER['REQUEST_URI']
+        ]);
+    }
+
+    public function authAction()
+    {
+        if(!$this->user->isAuthorized())
+        {
+            View::assign([
+                'loginForm' => $this->user->loginForm()
+            ]);
+        }
+        else
+        {
+            View::forwardTo('/index');
+        }
+    }
+
+    public function logoutAction()
+    {
+        $this->user->revokeAuthorized();
+        View::forwardTo('/login');
+    }
+}