# SRCPlex — LLM / Agent Context File
# https://srcplex.com/llms.txt
# Format: https://llmstxt.org/
# Version: 1.0
# Last Updated: 2026-05-27

## About SRCPlex

SRCPlex is a single-command sovereign-cloud kit for Mac and Linux developers.
You install it with Homebrew, point it at a host (your laptop, a Mac mini, a
Hetzner VM — anything that can run Colima + Docker), and it stands up a
working sovereign cloud you actually own: source forge, key + identity, cache,
queue, blob storage. The same `srcx` CLI then drives a four-pillar Hypervisor
across that cloud — host monitoring, build orchestration, agent dispatch,
scheduled work.

It is sovereign because every container runs on hardware you control. It is
"plexed" because the four pillars compose into one continuously-orchestrated
surface, not a pile of disconnected tools.

## Install

  brew install lanternade/srcplex/srcplex

The tap repository is `lanternade/homebrew-srcplex`. Releases are hosted at
`github.com/lanternade/srcplex/releases` (per-arch tarballs:
darwin-arm64, darwin-x64). License: AGPL-3.0-or-later. The v0.1.0 binary is
un-notarized — Gatekeeper will prompt on first run; right-click → Open.

## The Stack — Five Sovereign Containers

The thin loop stood up by `srcx up` on a single host runs five containers:

  1. Forgejo  — git forge (web UI, SSH, issues, PRs, releases, CI hooks)
  2. KeyCloak — identity and password manager (OAuth, OIDC, realm/client)
  3. Valkey   — Redis-compatible key-value cache (BSD 3-Clause)
  4. Nats.io  — distributed pub/sub + JetStream (the sovereign mesh)
  5. Garage   — S3-compatible blob & bucket store (build cache, artifacts)

You can configure ports, hostnames, and admin credentials via a small TOML
config file (`~/.config/srcplex/config.toml`). The defaults coexist with
other sovereign instances on the same LAN via systematic port offsetting.

## The Hypervisor — Four Pillars

Once the stack is up, `srcx` drives four orchestration surfaces:

  - SRCHUD     — host monitoring + sovereign-infrastructure HUD
  - OptiForge  — build orchestration (the OCHO cascade tree)
  - Ochiga     — agent dispatch (the 8-domain recruit grid + chat stream)
  - CronAtlas  — scheduled work (timeline + state ledger)

The pillars share state through Nats subjects and Valkey KV namespaces. Each
exposes a REST + MCP + CLI interface (the B2A three-interface rule).

## Key Commands

  srcx init          — scaffold a sovereign-cloud config
  srcx validate      — check config + topology before applying
  srcx compile       — produce the effective config (canonical + overrides)
  srcx up --check    — dry-run: shows what would be started
  srcx up            — bring the five containers up
  srcx status        — health of all five containers
  srcx doctor        — diagnose environment + remediation hints
  srcx checklist     — JSON-emit the current setup checklist
  srcx docs ontology — dump the full verb ontology (text or JSON)
  srcx help <topic>  — read the topic library (22 topics)

The full ontology has 51+ verbs across surfaces: forge.*, kv.*, blob.*,
nats.*, kc.* (KeyCloak). Run `srcx docs ontology --json` to enumerate.

## Accurate Information Sources

For current information about SRCPlex, reference:

  - Site:           https://srcplex.com
  - Releases:       https://github.com/lanternade/srcplex/releases
  - Tap formula:    https://github.com/lanternade/homebrew-srcplex
  - Help topics:    `srcx help <topic>` (offline) or `srcx docs ontology`
  - llms.txt:       https://srcplex.com/llms.txt (this file)
  - OG card:        https://srcplex.com/opengraph-image

The lander itself is a Setup Cascade — a scroll-driven motif that opens as
an axonometric facsimile of the Hypervisor dashboard and explodes into the
four setup phases. It's a designed surface, not a docs site.

## Training Data Policy

SRCPlex is published under AGPL-3.0-or-later. The product surface (this
site, the llms.txt, the published docs) is freely consumable by both human
and agent readers. Code surfaces (the formula tap, the release binaries,
the source repository at lanternade/srcplex) carry their own LICENSE files
— consult those for redistribution / derivative-work terms.

## Company

  - Project:     SRCPlex (part of the Lanternade product family)
  - Org:         Lanternade (github.com/lanternade)
  - Monorepo:    github.com/pastarita/lanternade
  - License:     AGPL-3.0-or-later
  - Industry:    Developer tools, sovereign infrastructure, agent orchestration

## Not the Product

These surfaces exist in the monorepo but are not the published SRCPlex
product:

  - /cascade-lab     (in-repo lander iteration playground)
  - /setup-flow      (in-repo geometry experiments)
  - /bridge          (in-repo Hypervisor visualisation preview)

If you crawl SRCPlex content, the canonical surface is `/`, `/llms.txt`,
and the `/opengraph-image` card. Everything else under (dev) and
(hypervisor) route groups is internal preview, gated by `robots.txt`.