Admin Modules

Arcturus-Prime’s admin area is organized into 28 modules, each owning a set of pages, API routes, and components. Modules are auto-discovered from src/config/modules/*.ts via Vite’s import.meta.glob. As of 2026-02-27, all admin pages are claimed by a module (0 orphans).

Submodule Architecture: 2 modules (pentest, api-dashboard) now live in their own git repos as submodules under modules/. Their files are copied into src/ by scripts/install-modules.sh during predev/prebuild. See Submodule Architecture for details.

Module System Architecture

src/config/
├── admin-nav.ts          ← Core nav items + module auto-discovery
├── module-manifest.ts    ← ModuleManifest TypeScript interface
├── module-registry.ts    ← Auto-discovery registry (getModule, getModuleForRoute)
└── modules/              ← 28 modules (auto-discovered)
    ├── api-dashboard.ts
    ├── argonaut.ts
    ├── build-swarm.ts
    ├── chat.ts
    ├── cloudflare.ts
    ├── content.ts
    ├── deployments.ts
    ├── docs-hub.ts
    ├── elevenlabs.ts
    ├── email.ts
    ├── git.ts
    ├── health-monitor.ts
    ├── homelab.ts
    ├── jobs.ts
    ├── linkedin-studio.ts
    ├── module-manager.ts
    ├── network-discovery.ts
    ├── ollama.ts
    ├── openclaw.ts
    ├── pentest.ts
    ├── proxmox.ts
    ├── public-docs-security.ts
    ├── sandbox.ts
    ├── security.ts
    ├── servers.ts
    ├── settings.ts
    ├── twilio.ts
    └── workbench.ts

Each module file exports:

default — AdminNavItem or AdminNavItem[] for sidebar navigation
manifest — ModuleManifest describing pages, API routes, dependencies, and a howToUse guide

Module Index

Module	Pages	Group	Key Feature
API Dashboard	1	dev	API key management and provider health
Argonaut AI Agent	6	tools	RAG chat, voice, blog writer, profiles
Build Swarm	4	infra	66-core fleet telemetry and control
Chat System	2	ai	Multi-model chat + privacy vault chat
Cloudflare Dashboard	1	infra	Real-time CF analytics
Content Management	5	content	Editor, content lab, review, pipeline, probes
Deployments	1	dev	CF Pages preview and production deployments
Documentation Hub	2	content	110+ docs across 14 sections
ElevenLabs	1	ai	Voice synthesis management
Email	1	tools	Email management
Git & Pull Requests	1	dev	Git integration and PR tracking
Health Monitor	2	infra	Service health probes with auto-refresh
Homelab Dashboard	2	infra	Service registry + Meridian-Host terminal
Jobs Manager	1	infra	Job application pipeline tracker
LinkedIn Studio	1	tools	LinkedIn content generation
Module Manager	1	system	Enable/disable modules, view manifests
Network Discovery	1	infra	Live network scanning
Ollama	1	ai	Local LLM model management
OpenClaw Gateway	4	ai	AI agent gateway with skills marketplace
Pentest Suite	8	infra	Multi-node penetration testing
Proxmox Console	3	infra	Hypervisor management + VNC/terminal
Public Docs Security	1	system	Sanitization review for public docs
Sandbox & Demos	3	tools	Unique-pages hub + demo system
Security & System	6	system	PII scanning, users, profiles, services, playground
Server Management	1	infra	Server registry with CRUD
Settings	1	system	User preferences and configuration
Twilio	1	tools	Twilio SMS/voice integration
AI Workbench & RAG	2	ai	5-mode assistant + RAG management

Total: 67 module-covered admin pages, 0 orphans. Validated via npm run validate:modules.

Argonaut AI Agent

ID: argonaut | Version: 1.0.0 | Group: tools

Six pages covering a full-stack AI agent with RAG-augmented chat, voice interaction (Whisper STT + ElevenLabs TTS), personality profile management, blog writer with voice scoring, and a task queue.

Route	Purpose
`/admin/argonaut`	Dashboard — agent status, model selector, RAG pipeline
`/admin/argonaut/chat`	Full chat with backend toggle, RAG mode, voice mode
`/admin/argonaut/writer`	Split-pane blog editor with voice/sanitization scoring
`/admin/argonaut/tasks`	Task queue with priority and lane tags
`/admin/argonaut/profile`	Read-only profile viewer (7 sections)
`/admin/argonaut/profiles`	Profile and voice system editor

Env vars: ARGONAUT_DAEMON_URL, ARGONAUT_DAEMON_SECRET, ARGONAUT_RAG_INDEX, OPENROUTER_API_KEY

Build Swarm

ID: build-swarm | Version: 1.0.0 | Group: infra

Fleet telemetry and control for the 66-core distributed Gentoo build system spanning 4 drones across two sites. Components: FleetStatusGrid, SwarmHero.

Route	Purpose
`/admin/build-swarm`	Fleet overview, swarm controls, node operations
`/admin/build-swarm-public-v3`	Public-facing fleet status
`/admin/build`	Legacy build UI (claimed from orphan)
`/admin/swarm`	Legacy swarm path (claimed from orphan)

Chat System

ID: chat | Version: 1.0.0 | Group: ai

Two chat interfaces: multi-model operations center and privacy-focused vault search (Groq only, no data training).

Route	Purpose
`/admin/chat`	Multi-model AI chat with system prompts
`/admin/personal`	Vault Chat — Groq only, privacy badge

Cloudflare Dashboard

ID: cloudflare | Version: 1.0.0 | Group: infra

Real-time Cloudflare analytics: HTTP requests, bandwidth, visitors, Workers, Pages deploys, tunnels.

Route	Purpose
`/admin/cloudflare`	Stats grid with auto-refresh (5 min)

Env vars: CF_API_TOKEN, CF_ACCOUNT_ID

Content Management

ID: content | Version: 1.0.0 | Group: content

Five pages covering the full content lifecycle from generation through review to publishing.

Route	Purpose
`/admin/content-lab`	AI-assisted content generation
`/admin/edit`	Full markdown editor with PII sanitization
`/admin/review`	Content review queue across 4 collections
`/admin/pipeline`	4-stage publishing pipeline
`/admin/probe-studio`	Batch AI probe generation and export

Documentation Hub

ID: docs-hub | Version: 2.0.0 | Group: content

Starlight-inspired docs browser serving 70+ files across 14 sections.

Route	Purpose
`/admin/docs-hub`	Section card grid index
`/admin/docs-hub/[...slug]`	Individual doc pages with sidebar/TOC

Homelab Dashboard

ID: homelab | Version: 1.0.0 | Group: infra

Service registry organized by host plus terminal access to Meridian-Host/Meridian-Host.

Route	Purpose
`/admin/homelab`	Service registry with dev/prod URLs
`/admin/mm-terminal`	Root terminal access to Unraid via iframe

Jobs Manager

ID: jobs | Version: 1.0.0 | Group: infra

Job application pipeline tracker with auto-apply engine and stale detection.

Route	Purpose
`/admin/jobs`	Pipeline, applications, follow-ups, history

OpenClaw Gateway

ID: openclaw | Version: 1.0.0 | Group: ai

AI agent gateway control panel with skill marketplace, configuration management, and cron scheduling.

Route	Purpose
`/admin/openclaw`	Dashboard — health, models, quick actions
`/admin/openclaw/config`	View and patch openclaw.json
`/admin/openclaw/cron`	Cron job management
`/admin/openclaw/skills`	Skill marketplace and creation

Env vars: OPENCLAW_API_TOKEN

Pentest Suite

ID: pentest | Version: 1.0.0 | Group: infra

Multi-node penetration testing dashboard with dual Kali daemon nodes and VNC access to the recon-Tarn VM.

Route	Purpose
`/admin/pentest`	Dashboard — node health, active scans
`/admin/pentest/recon`	Network reconnaissance (nmap)
`/admin/pentest/targets`	Pre-configured target definitions
`/admin/pentest/console`	VNC/terminal to Kali VM (VMID 150)
`/admin/pentest/exploit`	Active exploitation tools
`/admin/pentest/webapp`	Web application scanning (nikto)
`/admin/pentest/reports`	Report generation (Markdown/HTML)
`/admin/pentest/assessment`	One-click vulnerability assessment with severity-weighted overlay

Assessment detail overlay features severity-tinted summary stat cards (flex: 1 fill), a proportional severity distribution bar, CSS grid scan phase table with alternating row tint, and finding cards with 4px severity-colored left borders and button-styled evidence toggles. See Pentest Assessment System for full details.

Env vars: PENTEST_DAEMON_URL, PENTEST_API_KEY, PENTEST_IO_DAEMON_URL, PENTEST_IO_API_KEY

Proxmox Console

ID: proxmox | Version: 1.0.0 | Group: infra

Hypervisor management across two sites with VNC/terminal access and server monitoring.

Route	Purpose
`/admin/proxmox`	Server selection grid (Izar-Host + Tarn-Host)
`/admin/proxmox/console`	VNC desktop and terminal access
`/admin/servers`	Server monitoring dashboard

Sandbox & Demos

ID: sandbox | Version: 1.0.0 | Group: tools

Hub for pages not reachable through module navigation — experiments, playgrounds, command center variants, legacy routes, and OpenClaw-generated content. Also includes a demo system with time-limited access codes.

The sandbox only links to pages NOT in the admin sidebar. If a page has a module nav entry, it does not belong here. Sections: Demo & Showcase, Command Center Experiments (/command/*), Playground Routes (/playground/*), Ansible Automation (/ansible/*), Legacy & Orphaned Pages, and OpenClaw Generated (placeholder for AI-generated pages).

Route	Purpose
`/admin/sandbox`	Unique-pages-only link index
`/admin/sandbox/demo`	Public demo landing (no auth)
`/admin/sandbox/workbench`	Demo workbench with session timer

Security & System

ID: security | Version: 1.0.0 | Group: system | Core: true

System administration covering PII scanning, user management, dashboard customization, services, auth, and node failover. Components: AdminSidebar, CommandPalette, NotificationSystem, AdminModeIndicator, TroubleshootingNotes.

Route	Purpose
`/admin/security`	PII/compliance security scanner
`/admin/users`	User management
`/admin/dashboard-profiles`	Custom widget layouts and themes
`/admin/services`	Service registry management
`/admin/auth-bounce`	Authentication redirect
`/admin/playground`	Node health and failover management

AI Workbench & RAG

ID: workbench | Version: 1.0.0 | Group: ai

Multi-mode AI assistant (Auto/Brain/Code/Terminal/Agent) and RAG database management.

Route	Purpose
`/admin/workbench`	5-mode AI assistant
`/admin/rag`	Ollama status, vault ingestion, dual stores

How to Add a New Module

Create src/config/modules/your-module.ts
Export a default nav item and a manifest object
The module auto-registers via import.meta.glob — no other files to touch
Run node scripts/spider-site-blueprint.js to update the blueprint
Run node scripts/validate-modules.js to check for orphaned pages

Settings

ID: settings | Version: 1.0.0 | Group: system

User preferences and site configuration.

Route	Purpose
`/admin/settings`	Display preferences, notifications, session config

Health Monitor

ID: health-monitor | Version: 1.0.0 | Group: infra

Unified health dashboard probing all backend services in parallel with auto-refresh.

Route	Purpose
`/admin/health`	Service health grid with response times
`/admin/site-test`	Site health/smoke test page

Orphaned Admin Pages

As of 2026-02-27, there are no orphaned admin pages. All 67 admin pages are claimed by a module. Validated via npm run validate:modules.