Diagnozer Cortex — operator console

RUNBOOK-aligned read-only mirror · generated
Brain Cursor Council
loading phases…

Live status

Health signals

  • loading…

Engine packages

loading…

GitHub

loading…

Build sequence — Phases 0–4

Ignition stays priority-0; Phase 0–1 run in parallel. Phase 2 GUI gated on ignition milestone or founder call.

loading…

Target architecture (engine + adapters)

Law: engine/ is domain-agnostic; vertical logic lives in adapters/<vertical>/.

cortex/engine/ — @cortex/router, decision-engine, governance, triage, rag, mlops, client
cortex/adapters/ — <vertical>/ injected config + compliance copy
cortex/data/ — cx_* schema + back-compat views
cortex/api/ — /v1/{graphs,route,governance,models,rag,signals}
cortex/studio/ — Self-Improvement Console + Guide/Tree Studio

Closed RSI loop

cx_signals → draft proposals → HITL console → measurement ↻ never auto-apply — hitl_approved + verifier (@cortex/governance)

Multi-property

Each property = thin adapter + shared engine. Phase 4: MCP (DC-040) + 2nd adapter proof (DC-041).

Ticket queue

Active · ready · backlog

Active brain assignment: · Launch at cursor.com/agents

loading…

Open cortex issues

loading…

Review & merge (RUNBOOK §4)

Brain merge checklist — SSOT §2 recipe

Before merging a Cursor draft PR, all five must be true:

  1. Tests passcortex-ci green on the PR; make cortex-test passes locally.
  2. Behaviour unchanged — golden test passes (byte-identical deterministic output).
  3. Engine stays clean — no dental strings in cortex/engine/** (CI guard).
  4. Scope only — PR touches only files named in the ticket; importers still work.
  5. Status updated — SSOT §5 row for that ticket is flipped.

If any fail, comment on the PR — do not merge. Respect the ≤3 open worker-PR cap (§6).

Weekly iteration (RUNBOOK §5)

The rhythm

make cortex-status → see what's ready / blockers → pick next ready ticket → Brain promotes BACKLOG → DC-### file → make brain-assign → marks active for Cursor → launch agent (cursor.com) → draft PR (cursor-worker) → review with §4 checklist → merge → flip SSOT status → repeat

Phase 1–4 backlog: DC-010 → DC-042 in BACKLOG.md. Copy a row into its own ticket file (use DC-002 as template) before launching.

CLI — control surface

make cortex-statusdashboard
make cortex-testengine tests
make cortex-briefdaily brief
make brain-assignmark active ticket
make cortex-status-mirrorrefresh this page

PR cap (RUNBOOK §6)

≤3 open worker PRs — safety brake

Too many half-finished PRs = chaos. make brain-assign refuses when over cap. Clear stale cursor-worker PRs (DS-031 debt) before queuing new carve-out work.

One-off override: BRAIN_MAX_WORKER_PRS=100 make brain-assign — then clear the backlog.

Open cortex-labelled PRs

loading…

Daily brief (RUNBOOK §7)

Suggestions (from status mirror)

  • loading…

Brief body

loading…

HITL self-improvement console

Signal volume — last 7 days

loading…
Sessions (blue) · thumbs-up (green) — PHI-free runtime signals from cx_signals.

Proposal inbox — DRAFT only, never auto-applied

Ranked draft edit proposals from the scheduled pass. Select a row for evidence, diff, vote tally, and before/after metrics.

IDProposalTypeDriftVotesStatus
loading…

Approve · edit · reject

This mirror is read-only by design (production surface). The verifier-gated approve/reject action runs in the local Cortex studio, which is same-origin with the control bridge. Clinical/model changes require a verifier code; nothing applies without hitl_approved — enforced by @cortex/governance.

▶ Open the Self-Improvement Console

How the loop stays safe

  1. Signals — live apps record confusion points, thumbs, clinician corrections (PHI-free).
  2. Drafts only — scheduled job proposes tree/model improvements; never auto-applies.
  3. Console — human sees evidence, diff, vote tally; approve / edit / reject in the studio.
  4. Measure — approved changes versioned with before/after metrics; rollback on regression.

Full write path lands with DC-021 + DC-023 (Track C). Mirror files: data/cortex-proposals.json · data/cortex-signals.json.

Verification checklist

  1. node --test per engine package
  2. Adapter regression — byte-identical deterministic paths
  3. Studio e2e (Phase 2): signal → proposal → approve → metric; no auto-apply
  4. API contract tests vs OpenAPI; MCP smoke (Phase 4)
  5. /command/ gate console + brain-audit per phase
  6. CI domain-free guard on engine/**

Honest risks & brand (read-only)

RiskMitigation
Worker-PR cap blocks dispatchDS-031 cleanup; ≤3 open worker PRs
Domain leakage into engine/CI grep + golden tests + extraction recipe
RSI perceived as autonomousnever-auto-apply + HITL console + rollback metrics
Phase 2 before ignitionFounder gate; ignition stays P0

Working name: Diagnozer Cortex. Shortlist (no picker): Verdict Lattice Aperture

Quick map (RUNBOOK §10)

Architecture / blueprintcortex/SSOT.md · BLUEPRINT.md
This how-tocortex/RUNBOOK.md
User manual (every screen & button)cortex/USER_MANUAL.md
UX / UI manual (design system)cortex/UX_UI_MANUAL.md
Full task list DC-010→042cortex/tickets/BACKLOG.md
Active Cursor assignment.brain/cursor-current.md
Ticket promptscloudflare-pages/cortex/tickets/DC-###-*.md
Status mirror (this page)cloudflare-pages/data/cortex-status.json
Strategy command center/command/
Tree Studio/command/tree-editor/
Guide Studio/command/guide-studio/
RAG Corpus/command/rag-corpus/
AI Review/command/ai-review/
Annotate & Approve (vision)/command/cortex/annotate/
Gate console/command/ (gates matrix)

Troubleshooting (RUNBOOK §11)

  • brain-assign blocked (open worker PRs). §6 cap — clear stale PRs or BRAIN_MAX_WORKER_PRS=100 make brain-assign for a deliberate one-off.
  • Dashboard looks stale. Run make cortex-status-mirror, commit data/cortex-status.json, redeploy. Daily cron does this via cortex-daily-brief.yml.
  • Studio actions disabled / loading forever. Control bridge not running or token mismatch. Fix: make cortex-dev or start control-server/server.mjs + studio dev server; verify curl http://127.0.0.1:7171/health.
  • Read-only dev fallback. Without bridge, studio loads cortex-status.json — refresh with make cortex-status-mirror.
  • PR changed files outside ticket. Do not merge — revert out-of-scope edits or split to a new ticket.
  • Golden test fails after extraction. Behaviour changed — fix extraction to match old deterministic output; do not weaken the test.
  • Package test FAILING in cortex-status. Stop merges until make cortex-test is green.
Read-only console — actions run from CLI / Cursor. Blueprint cortex/SSOT.md · runbook cortex/RUNBOOK.md.