LUMAURA ATLAS - Cognitive Operating Layer

LUMAURA ATLAS is a VS Code extension that turns your monorepo into a navigable operating map with local-first reasoning tools.

Key Features

• Minimal default shell: only Home + Builder are visible by default; advanced surfaces are behind ATLAS: Toggle Advanced Surfaces.
• Command Center: one launcher for build, audit, mapping, billing, and UI mode toggles.
• Home View (ATLAS): clean launchpad with key actions and status pills.
• Systems View (ASTRIL): Browse system definitions and details.
• Governance (VAEHAWK): Architecture drift and compliance signals.
• Missions (SYMBIOS): Guided execution tracking.
• Impact (ZVINX): Blast-radius and failure simulation.
• Constellation Control Center: Search, focus, audit, mission launch, docs/site shortcuts, and snapshot export.
• Builder Chat (VAELIOS): In-sidebar plan/build/ship chat workflow.
• Universal Ingest: + button supports files and folders from local disk, with PDF text preview extraction and binary fallback for any format.
• Arvex Settlement (INFLO): Helcim checkout and billing portal hooks.
• Webhook-Ready Entitlements: local cache + backend sync endpoint integration.
• Sovereign Runtime: Atlas chat, SCALVNBO, and PRIMAL CORTEX route to a self-hosted runtime (/api/vaelios/*, /api/primal-cortex/*).

Builder Chat

Open the ATLAS sidebar and use Builder Chat (VAELIOS).

• Quick actions: Plan, Build, Ship, Audit
• Simple/Power toggle: clean default layout first, full control surface on demand.
• Focus + Activity + Metrics toggles: collapse noise and keep only what you need visible.
• Dockable activity shell: switch multi-agent panel between right and bottom docks.
• Live multi-agent progress: per-request runtime progress bar and richer status cards.
• In-chat mindmap tab: live execution graph inside Builder (not just external view).
• Responsive premium shell: better header/composer behavior in narrow widths and popout windows.
• Simple/Power state memory: leaving Simple restores your prior focus/activity/metrics layout.
• Attach lane: add files/folders with +, then ask for summaries, extraction, or implementation plans.
• VAEHAWK-ONE lane: one-click audit from Home, Command Center, and Builder header.
• Command lane: run /scan, /plan, /build, /audit, /mindmap directly from the builder shell.
• Popout command: ATLAS: Open Builder Chat
• Home command: ATLAS: Open Home
• Command center: ATLAS: Open Command Center
• Console command: VAELIOS: Open Command Console

Helcim Configuration

Set these VS Code settings to wire paid tiers:

• atlas.billing.helcimProCheckoutUrl
• atlas.billing.helcimEliteCheckoutUrl
• atlas.billing.helcimPortalUrl
• atlas.billing.entitlementsEndpointUrl
• atlas.billing.entitlementsAuthToken
• atlas.billing.customerId
• atlas.billing.syncOnViewOpen (default: true)
• atlas.founderMode (default: true)
• atlas.marketing.siteUrl
• atlas.marketing.docsUrl
• atlas.design.figmaMakeUrl
• atlas.valuation.docPath
• atlas.runtime.baseUrl
• atlas.runtime.fallbackBaseUrl
• atlas.runtime.apiBearerToken
• atlas.runtime.timeoutMs
• atlas.runtime.retryCount
• atlas.ui.advancedMode (default: false)

Environment fallback is also supported for billing fields:

• ATLAS_HELCIM_PRO_CHECKOUT_URL (or HELCIM_PRO_CHECKOUT_URL)
• ATLAS_HELCIM_ELITE_CHECKOUT_URL (or HELCIM_ELITE_CHECKOUT_URL)
• ATLAS_HELCIM_PORTAL_URL (or HELCIM_PORTAL_URL)
• ATLAS_ENTITLEMENTS_ENDPOINT_URL (or ENTITLEMENTS_ENDPOINT_URL)
• ATLAS_ENTITLEMENTS_AUTH_TOKEN (or ENTITLEMENTS_AUTH_TOKEN)
• ATLAS_CUSTOMER_ID (or HELCIM_CUSTOMER_ID)

When atlas.founderMode is true, Founder Elite is always unlocked locally.

Webhook-Ready Flow

1. Helcim webhooks are processed by your backend.
2. Your backend exposes an entitlement endpoint.
3. Atlas syncs and stores entitlements in:
   • .lumaura/atlas/entitlements.json
4. Tier UI resolves from entitlement state when Founder Mode is off.

Commands

• ATLAS: Audit Current System
• ATLAS: Run VAEHAWK-ONE Audit
• ATLAS: Show Architecture Drift
• ATLAS: Simulate Change Impact
• ATLAS: Simulate System Failure
• ATLAS: Build AI Context Pack
• ATLAS: Create SYMBIOS Mission
• ATLAS: Open Constellation Map (Popout)
• ATLAS: Open Builder Chat
• ATLAS: Open Home
• ATLAS: Open Figma Make Workspace
• ATLAS: Open AIVA Valuation Doc
• ATLAS: Enable No-API Beta Mode
• ATLAS: Enable Payment-Ready Mode
• ATLAS: Auto-Configure Runtime From Infra
• ATLAS: Auto-Configure Billing From Runtime Env
• ATLAS: Run Production Readiness Check
• ATLAS: Open Atlas Settings JSON
• ATLAS: Reset UI Layout
• ATLAS: Open Command Center
• ATLAS: Toggle Advanced Surfaces
• ATLAS: Open LUMAURA Site
• ATLAS: Sync Billing Entitlements
• ATLAS: Open Entitlements File
• VAELIOS: Open Command Console

Local-First Policy

Atlas routes through a sovereign runtime with provider allowlist controls (llamacpp, lumaura-cluster). External provider routes are blocked in runtime policy. If runtime is temporarily unavailable, Atlas switches to local continuity mode so chat remains actionable without external providers.