Skip to content
Spectral Codex
GitHub
Operations

Operations cockpit

Functional specifications for the Operations cockpit. The operator-facing cockpit (apps/operations). Each page is generated from a natural-language spec under qa/operations/specs/ and carries its latest replay-run status.

  • Action Authoring — A world’s action set is the list of routing keys the customer’s agent names on POST /decide and discovers via GET /actions (ADR-089/104).
  • Action Inputs — An action’s inputs are the canonical values the customer’s agent sends on POST /decide for that routing key — its ontology.
  • Auth Gating — The operator cockpit is gated to Spectral staff with the operations organization role.
  • Authoring Loop — The conversational authoring loop is the primary alpha flow: the operator chats with the Assistant on its dedicated page, shares source material via the sing…
  • Candidate Review — The review queue is where the operator dispositions proposed rules outside the chat.
  • Feedback Evolution — The Feedback & evolution surface is the fifth workspace tab inside a ruleset.
  • Llm Config — The operator configures the platform-default World-Agent LLM from the cockpit’s LLM config surface: a global, non-ruleset setting that selects the provid…
  • Navigation IA — The cockpit’s information architecture is a persistent navigation shell: a left rail on every operator surface (brand, command-palette button, global nav wit…
  • Publish Deploy — Once rules are approved, the operator publishes a new ruleset version.
  • States — Every operator surface should communicate its loading, empty, and error states rather than rendering a blank or broken page.
  • Verify Remediation — When the operator runs verify-at-review on a proposed rule (“Generate & run checks”), the rule’s deterministic logic is generated and its checks run.
  • World Model Card — The Ruleset Card is the version-addressed, read-only artifact that presents a published version’s content for inspection/audit.
  • Worlds Crud — Rulesets are the top-level container an operator authors against (the UI says “ruleset”; the route + wire stay /worlds / world_id).