Web UI control surface for Hero OS VMs: services, AI keys, upgrades, and docs.
  • Rust 77.6%
  • HTML 22.4%
Find a file
mik-tf 7a5899c048
All checks were successful
lab publish / publish (push) Successful in 26m36s
feat(cockpit): list Hero Orchestrator in the Apps catalog
Add hero_orchestrator (server + admin) to the cockpit apps catalog and the
service-to-repo upgrade map so it shows as an app and can be installed or
upgraded from the dashboard, now that it ships as part of the tester stack.
Both completeness guard tests updated in lockstep.

Signed-by: mik-tf <mik-tf@noreply.invalid>
2026-06-06 23:57:09 -04:00
.forgejo/workflows cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00
crates feat(cockpit): list Hero Orchestrator in the Apps catalog 2026-06-06 23:57:09 -04:00
.gitignore feat(scaffold): hero_cockpit s133 — 5-crate workspace from hero_template 2026-05-21 07:55:09 -04:00
Cargo.lock cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00
Cargo.toml cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00
README.md cockpit: rename demo to Hero OS Tester Sandbox in user-facing copy 2026-05-27 14:07:15 -04:00
rust-toolchain.toml cockpit: build from main + migrate to relocated hero_lib API 2026-06-03 15:17:13 -04:00

hero_cockpit

End-user control surface for a Hero OS Tester Sandbox VM. Lets the user see / start / stop services, set BYO AI keys, trigger upgrades, submit feedback, and read the manual via a simple web UI.

Spec: hero_cockpit#1 — architecture, page inventory, API surface, per-user manifest format. Arc tracker: lhumina_code/home#235 (Hero OS demo-deployer arc).

Workspace shape

Five crates, scaffolded from hero_template:

Crate Binary Socket Purpose
hero_cockpit hero_cockpit Lifecycle CLI (--start / --stop / --info)
hero_cockpit_server hero_cockpit_server hero_cockpit/rpc.sock OpenRPC backend (service state, BYO keys, upgrade, feedback)
hero_cockpit_sdk (lib) Generated typed client
hero_cockpit_admin hero_cockpit_admin hero_cockpit/admin.sock Admin dashboard
hero_cockpit_web hero_cockpit_web hero_cockpit/web.sock End-user web UI

Quick start

# Build the workspace via lab
lab build hero_cockpit --release --install

# Start the stack via hero_proc
hero_cockpit --start

# Or via lab service
lab service hero_cockpit --install --start

Endpoints

Each daemon serves these:

  • GET /health — liveness probe
  • GET /.well-known/heroservice.json — service manifest

The server additionally serves POST /rpc (JSON-RPC 2.0 — cockpit.* methods).

Status

  • s133: scaffold (5 crates, service.toml × 4 daemons, /health + /.well-known endpoints, cargo check + lab infocheck clean). The real API surface lands in s134-s139.

License

Apache-2.0