@agentikos/omega-os 0.19.38 → 0.19.40

package/omega/Agentik_Engine/tests/test_tui_runtime.py

@@ -176,5 +176,161 @@ class TestPaperclipMenuIntegration(unittest.TestCase):
                 f"arrow menu must wire {action} (user asked for it in v0.19.37)")
 
 
+class TestChatFirstRedesign(unittest.TestCase):
+    """v0.19.39 — the TUI must open on CONVERSATIONS (live tmux sessions),
+    not on an action menu. Setup/config/infra/audits/scrape land in
+    sub-menus. These tests lock in the new layout so a careless refactor
+    doesn't bring back the v0.19.38 action-first menu."""
+
+    def test_conversations_section_appears_before_menu(self):
+        """The 'CONVERSATIONS' section header must appear in the source
+        BEFORE the 'MENU' sub-menu list — the redesign's whole point is
+        that chats are primary, settings are secondary. Match literal
+        ``_section("X")`` calls only (skip comments/docstrings)."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        conv_pos = src.find('_section("CONVERSATIONS")')
+        menu_pos = src.find('_section("MENU")')
+        self.assertGreater(conv_pos, 0,
+            "TUI must have a _section(\"CONVERSATIONS\") call")
+        self.assertGreater(menu_pos, 0,
+            "TUI must have a _section(\"MENU\") call for sub-menus")
+        self.assertLess(conv_pos, menu_pos,
+            "_section(\"CONVERSATIONS\") must render BEFORE _section(\"MENU\") "
+            "— the chat-first redesign requires it (v0.19.39)")
+
+    def test_dot_status_indicators_present(self):
+        """Each conversation row must show a status dot ● (alive) / ○
+        (off). Without dots the user can't tell which chats are running."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        for dot in ("●", "○"):
+            self.assertIn(dot, src,
+                f"menu must use {dot} status dot for live/off chats")
+        # The helper that renders dots must exist.
+        self.assertIn("_dot(", src,
+            "menu must have a _dot() helper for status indicators")
+
+    def test_submenu_dispatch_present(self):
+        """The new sub-menu pattern (`submenu:audits`, `submenu:setup`,
+        `submenu:infra`, `submenu:health`, `submenu:paperclip`) must be
+        wired AND the dispatch must handle them via _open_submenu()."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        for sub in ("submenu:audits", "submenu:setup", "submenu:infra",
+                    "submenu:health", "submenu:paperclip"):
+            self.assertIn(sub, src,
+                f"menu must declare {sub} as a sub-menu entry")
+        # The dispatch must indirect through _open_submenu.
+        self.assertIn("_open_submenu(", src,
+            "main loop must call _open_submenu() to render sub-menus")
+        # Sub-menu items provider exists.
+        self.assertIn("_submenu_items(", src,
+            "sub-menu rendering must use a _submenu_items() factory")
+
+    def test_attach_action_handler_present(self):
+        """The new `attach:<session>` action lets the user jump into a
+        live Oracle or Worker tmux session directly from the menu."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertIn('action.startswith("attach:")', src,
+            "menu must handle attach:<session> actions to let the user "
+            "jump into live Oracle/Worker sessions")
+        # Should use tmux select-window OR switch-client.
+        self.assertTrue(
+            "switch-client" in src or "select-window" in src,
+            "attach handler must use tmux select-window / switch-client")
+
+    def test_omega_window_alive_helper_used(self):
+        """The TUI status dots for AISB / Hermès rely on the
+        tmux.omega_window_alive() helper added in v0.19.39 — without it
+        we have no way to know if those windows are running."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertIn("omega_window_alive", src,
+            "menu must call tmux.omega_window_alive() to render the "
+            "AISB / Hermès status dots")
+
+    def test_paperclip_status_dot_inline_in_main_menu(self):
+        """The Paperclip dashboard row in QUICK ACTIONS must show a
+        live status dot — the user must see at-a-glance whether the
+        Paperclip daemon is running."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertIn("_paperclip_status_quick", src,
+            "menu must use the inline Paperclip probe to render its dot")
+        # Must integrate the new chantier-4 is_running() probe.
+        self.assertIn("paperclip_bridge", src)
+
+
+class TestPixelPalette(unittest.TestCase):
+    """Pixel/CRT amber palette — colour137 family. Locks in the
+    replacement of the Claude cream/orange palette with a retro-CRT
+    amber accent that inherits the terminal background, matching the
+    look-and-feel reference from agentik-os/tmux-claude."""
+
+    def test_amber_constant_defined(self):
+        """`AMBER` must be declared in `_arrow_menu` — it's the new
+        primary accent color (xterm 256 colour137 = amber gold)."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertIn("AMBER", src,
+            "_arrow_menu must declare AMBER (the new colour137 accent)")
+
+    def test_colour137_in_fzf_args(self):
+        """The fzf `--color=` block must use the xterm `colour137`
+        named amber — that's the look-and-feel reference."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertIn("colour137", src,
+            "fzf --color= block must use colour137 (amber gold) — "
+            "the pixel/CRT palette references it explicitly")
+
+    def test_no_claude_cream_orange_in_fzf(self):
+        """The old Claude cream `#FAFAF7` background must NOT appear in
+        `_arrow_menu` anymore — the new palette inherits the terminal
+        background (`bg:-1`) for a transparent retro feel."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        self.assertNotIn("#FAFAF7", src,
+            "_arrow_menu must NOT contain Claude cream #FAFAF7 — "
+            "the new palette inherits the terminal background")
+
+    def test_orange_aliased_to_amber(self):
+        """Backward-compat: `ORANGE` must alias `AMBER` so existing
+        references (`_section`, `_label`, prompts) keep working with
+        only a color change, no logic change."""
+        import inspect
+        from omega_engine.tui import _arrow_menu
+        src = inspect.getsource(_arrow_menu)
+        # Tolerate any reasonable spacing around `=`.
+        import re
+        self.assertRegex(src, r"ORANGE\s*=\s*AMBER",
+            "ORANGE must alias AMBER (backward-compat for existing "
+            "_section/_label/prompt code)")
+
+
+class TestOmegaWindowAliveHelper(unittest.TestCase):
+    """tmux.omega_window_alive() — the helper the chat-first TUI uses
+    to know whether AISB-chat / Hermès-chat are running."""
+
+    def test_returns_false_when_no_omega_session(self):
+        """When the Omega master tmux session is dead, ANY window query
+        must return False — never raise."""
+        from omega_engine.tmux import omega_window_alive
+        # Use a definitely-unique window name to avoid colliding with
+        # any real session the developer might have running.
+        self.assertIsInstance(omega_window_alive("____nonexistent_xyz"), bool)
+
+
 if __name__ == "__main__":
     unittest.main()

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.38
+0.19.40

package/omega/Agentik_SSOT/docs/AUDIT-V0.19.39.md

@@ -0,0 +1,161 @@
+# OmegaOS v0.19.39 — chat-first TUI + rules folder + prompt audit + Paperclip live sync
+
+> 4 parallel chantiers landed in one ship.
+> The user's invariant: *"l'utilisateur, une fois qu'il a setup tout l'outil
+> OmegaOS, doit être 100% fonctionnel. Il n'a rien à faire à part l'utiliser."*
+
+## 1. What changed
+
+| Chantier | Owner | Files touched | Net effect |
+|---|---|---|---|
+| **#1 TUI redesign (chat-first)** | main session | `tui.py` (+200 lines), `tmux.py` (+14 lines), `tests/test_tui_runtime.py` (+87 lines) | The TUI opens on CONVERSATIONS (AISB / Hermès / live Oracles / live Workers with ●/○ status dots) instead of an action menu. Everything else collapses into **MENU** with sub-menus. |
+| **#2 Rules folder** | background agent | `omega/Agentik_SSOT/rules/{three-laws,orchestration,prompt-protocols,audit-gates,scope-safety,verified-completion}.md` (6 new files, 1250 lines), `constitution.md` (+frontmatter only) | The rule set every LLM CLI reads is now COMPLETE. 7 files, YAML-frontmatter envelope, full cross-references, ~1300 lines total. No fabrication — every protocol sourced from existing docs. |
+| **#3 Prompt audit + doctor sections** | background agent | `omega_engine/prompt_audit.py` (395 lines, new), `tests/test_prompt_audit.py` (199 lines, new), `cli.py` (+39 lines) | New `omega doctor` sections `prompts` and `orchestration`. The audit scores each agent role /100 against Three Laws + LMC + `.done.json` references. Surfaces real drift (current suite average 52/100). |
+| **#4 Paperclip live status** | background agent | `omega_engine/paperclip_bridge.py` (+`is_running()` + `PaperclipStatus`), `tests/test_paperclip_status.py` (new) | TUI can show ●/○ next to "Paperclip dashboard" with the live port. 3-tier probe (pidfile → port-scan → none), ≤0.3s worst case, never raises. |
+| **#5 Integration + ship** | main session | `package.json`, `pyproject.toml`, `__init__.py`, `VERSION`, this doc | Version bump, commit, push, npm publish. |
+| **#6 Role-prompt enrichment** | follow-up (NOT in this ship) | — | The doctor surfaces 10 weak role prompts; enriching them to ≥80/100 is intentionally deferred — the audit infrastructure is what we needed. |
+
+## 2. The new TUI (chat-first)
+
+```
+── CONVERSATIONS ──
+   ●  AISB master                  claude (Max OAuth)
+   ○  Hermès                       claude (Anthropic API)
+
+   — Active Oracles (2) —
+   ●  Causio-oracle-2              project: Causio
+   ●  DentistryGPT-oracle          project: DentistryGPT
+   — Active Workers (1) —
+   ●  DentistryGPT-worker-3-ux-fix task: ux-fix
+
+── QUICK ACTIONS ──
+   + New AISB chat                 fresh session
+   + New Hermès chat               fresh session
+   + New project                   Genesis pipeline
+   Run a mission                   verified completion
+   ○  Paperclip dashboard          not running
+
+── MENU ──
+   Quality Arsenal                 17 forensic audits
+   Setup & config                  LLM: claude_code
+   Infrastructure                  sessions, scrape
+   Health checks                   doctor, status
+   Paperclip governance            register, status
+
+── EXIT ──
+   Detach                          session keeps running
+   Quit Omega                      kills the tmux session
+```
+
+**Picking any conversation row** (Oracle / Worker / AISB / Hermès) attaches to
+that tmux session via `tmux select-window` (for Omega windows) or
+`tmux switch-client` (for foreign sessions). One click → in the conversation.
+
+**Sub-menus** open in cascaded fzf with `← back` exit rows.
+
+## 3. The rules folder — what an LLM now reads at runtime
+
+```
+omega/Agentik_SSOT/rules/
+├── constitution.md         (frontmatter: priority=1) — the Prime Principle
+├── three-laws.md           (priority=2) — operational discipline per law
+├── orchestration.md        (priority=3) — L0-L5 dispatch hierarchy
+├── prompt-protocols.md     (priority=4) — brief/done/blocked schemas + LMC
+├── audit-gates.md          (priority=5) — 17 Quality Arsenal audits as gates
+├── scope-safety.md         (priority=6) — files_owned + Sacred Scopes
+└── verified-completion.md  (priority=7) — done_clean contract + third-party rule
+```
+
+These files are mirrored into every LLM's persona dir at install time
+(via `step_personas` from v0.19.38). So whether the operator runs
+`claude`, `gemini`, `codex`, `qwen`, or `opencode` inside an AISB chat,
+they ALL see the same complete rule set — no per-LLM drift.
+
+## 4. The new `omega doctor` output (sections that didn't exist before)
+
+```
+omega doctor — OMEGA_HOME=…/Omega
+  …
+  -- personas --                          (NEW in v0.19.38)
+  [ok] canonical: Agentik_SSOT/personas/OMEGAOS-CONTEXT.md (3402B)
+  [ok] chat-contexts/aisb-master/: 8 persona files
+  [ok] chat-contexts/hermes/: 8 persona files
+  …
+  -- prompts --                           (NEW in v0.19.39)
+  [ok]   CLAUDE: 90/100
+  [warn] morpheus: 75/100 — missing: LMC protocol
+  [warn] link: 65/100 — missing: LMC protocol
+  [FAIL] oracle: 45/100 — missing: LMC protocol, `.done.json` contract
+  [warn] average suite score: 52.0/100
+  [warn] weak prompts (<60): architect, construct, keymaker, …
+
+  -- orchestration --                     (NEW in v0.19.39)
+  [ok] AISB master prompt
+  [ok] Oracle role prompt
+  [ok] Worker-class prompts
+  [ok] Checker prompts (Seraph/Smith)
+  [ok] LMC protocol document
+  [warn] shared `.done.json` vocab: 33% of agents
+```
+
+The 52/100 average is **real drift**, not a bug. Most role prompts rely
+on the engine's `load_agent_prompt()` to concatenate `lmc-protocol.md`
+at spawn time, so the on-disk role file is silent. The audit makes that
+drift VISIBLE — an operator editing `oracle.md` now has a clear signal
+that the contract is implicit. Enriching the role files to score ≥80
+is chantier #6, deferred to v0.19.40.
+
+## 5. Paperclip status integration
+
+`omega_engine.paperclip_bridge.is_running()` returns a `PaperclipStatus`
+with `running: bool, pid, port, url, detection`. Three detection paths:
+
+| # | Method | Latency | Hint emitted in TUI |
+|---|---|---|---|
+| 1 | `~/.paperclip/run/dashboard.pid` + `os.kill(pid, 0)` | ~5ms | `localhost:8080` |
+| 2 | TCP connect 127.0.0.1:8080, 0.2s timeout | ≤200ms | `localhost:8080` |
+| 3 | Neither — fall through | <1ms | `not running` |
+
+The TUI's QUICK ACTIONS row renders a ●/○ dot using this probe — the
+user sees at-a-glance whether their Paperclip governance daemon is live.
+
+## 6. Multi-agent integration — the user's question, answered with code
+
+| Question (from the user's brief) | Answer | File reference |
+|---|---|---|
+| Multi-agents bien setup? | ✅ 14 agents (Hermès + 13 AISB) — templates landed at install via `step_aisb_suite`; persona context mirrored to all 10 LLM filenames via `step_personas`. | `bootstrap/lib/steps.sh:279-293` + `omega_engine/personas.py` |
+| Tmux orchestration AISB/Oracle/Workers? | ✅ Session naming convention parsed by `tmux.categorize()`; TUI now LISTS them with status dots and one-click attach. | `omega_engine/tmux.py:47-90` + `tui.py:528-557` |
+| Rules respectés pour chaque LLM? | ✅ 7 rule files at `Agentik_SSOT/rules/` are mirrored to every LLM persona dir; doctor's `prompts` section verifies role files reference them. | `Agentik_SSOT/rules/*.md` + `omega doctor prompts` |
+| Dossier maître linké pour le LLM? | ✅ `Agentik_SSOT/personas/OMEGAOS-CONTEXT.md` is the canonical; `Agentik_SSOT/agents/aisb/CLAUDE.md` is the AISB master; both auto-mirrored to per-LLM filenames (CLAUDE.md, GEMINI.md, AGENTS.md, QWEN.md, .opencode/CONTEXT.md, …) at install time. | `step_personas` from v0.19.38 |
+| Tout setup à l'install, rien à faire post-install? | ✅ Install steps 25 (aisb-suite), 37 (hermes-brief), 38 (personas) all eager-seed. `npx -y @agentikos/omega-os@latest --full` is sufficient. | `install.sh STEPS[]` |
+| Visibilité sur ce qui se passe? | ✅ TUI chat-first view + `omega doctor` 23 sections (incl. NEW personas/prompts/orchestration). | `tui.py::_arrow_menu` + `cli.py::cmd_doctor` |
+
+## 7. Tests (regression-locked)
+
+| Chantier | New tests | Suite total |
+|---|---|---|
+| Baseline (v0.19.38) | — | 627 passed |
+| #1 TUI chat-first | +7 (TestChatFirstRedesign + TestOmegaWindowAliveHelper) | +7 |
+| #3 Prompt audit | +5 (full-score, missing-laws, banned-phrases, real-suite, real-orchestration) | +5 |
+| #4 Paperclip status | +5 (no-pidfile, stale-pidfile, live-pidfile, port-scan, url-field) | +5 |
+| **v0.19.39 total** | **+17 new** | **644 passed, 0 regressions** |
+
+Chantier #2 (rules folder) is documentation-only — no Python code, no tests
+needed; format validated by manual grep + YAML parse.
+
+## 8. Verdict
+
+✅ TUI is now **conversation-first** as the user requested ("L'objectif…
+c'est d'avoir une interface extrêmement simple… cette interface permet de
+voir la conversation avec AISB… ensuite, de voir les conversations avec
+les oracles et les conversations avec les workers").
+✅ Setup/config/audits/scrape/governance moved to sub-menus reachable via
+**MENU** (one row).
+✅ Paperclip dashboard has a live status dot and is reachable in one pick.
+✅ Rules folder is COMPLETE (7 files, 1301 lines, cross-referenced).
+✅ `omega doctor` now surfaces the orchestration health (prompts + chain).
+✅ No regression in existing 627 tests.
+
+The user's "il n'a rien à faire à part l'utiliser" invariant is preserved:
+one `npx -y @agentikos/omega-os@latest --full` and the new menu, the new
+rules, the new audit, and the live Paperclip indicator are all in place.

package/omega/Agentik_SSOT/docs/AUDIT-V0.19.40.md

@@ -0,0 +1,163 @@
+# OmegaOS v0.19.40 — pixel/tmux-claude design + progress bar fix + AISB roles enriched
+
+> Four parallel chantiers + one main-session chantier. Total: 5 deliverables, 660 tests passing.
+> Reference design: github.com/agentik-os/tmux-claude — adopted verbatim where applicable.
+
+## 1. What changed
+
+| Chantier | Owner | Effect |
+|---|---|---|
+| **2A — progress bar fix** | agent | `_full_progress` was incrementing `STEP_COUNT` on BOTH `run` AND `ok` phases → counter ran to 2× STEP_TOTAL → bar hit 200% → newline spawned mid-install. Now: only `ok`/`skip` increment. The `\r`-driven single-line overwrite works as designed. |
+| **2B — pixel tmux palette** | agent | Replaced Claude cream/orange (`#FAFAF7` / `#D97757`) with tmux-claude's amber `colour137` palette. Window list HIDDEN (`window-status-format ''`). Status bar with bullets `•`. Popups full-screen (`-w 100% -h 100%`). Paste-deadlock fixes, kill forensics, smart-scroll all preserved. |
+| **2C — pixel fzf palette** | agent | Omega menu's fzf colors swapped to CRT amber: `bg:-1` (inherits terminal), `fg:default`, accents `colour137`/`colour215`. Backward-compat alias `ORANGE = AMBER` keeps existing `_section`/`_label` calls working. |
+| **6 — AISB role enrichment** | main session | 14 AISB role prompts enriched with a uniform "THREE LAWS + Operating Contract" block. Adds LAW 3 (autonomous execution), names LMC protocol path, references `.done.json` + done-marker tooling, requires fresh-context handoff. Per-role tier customization (Manager / Worker / Checker / Watcher). |
+
+## 2. Audit numbers — before / after
+
+**Prompt audit suite scores (v0.19.39 → v0.19.40):**
+
+| Role | Tier | Before | After |
+|---|---|---:|---:|
+| CLAUDE (master) | Lead | 90 | 90 |
+| morpheus | Worker | 75 | **100** |
+| link | Worker | 65 | **100** |
+| neo | Worker | 65 | **100** |
+| zion | Worker | 65 | **100** |
+| seraph | Checker | 55 | **100** |
+| oracle | Manager | 45 | **100** |
+| architect | Worker | 45 | **100** |
+| construct | Worker | 45 | **100** |
+| keymaker | Worker | 45 | **100** |
+| merovingian | Worker | 45 | **100** |
+| niobe | Worker | 45 | **100** |
+| smith | Worker | 45 | **100** |
+| pythia | Watcher | 5 | **100** |
+| lmc-protocol (doc) | Reference | 45 | **85** |
+| **Average** | | **52.0** | **98.3** |
+| **shared `.done.json` vocab overlap** | | 33% | **100%** |
+
+## 3. The Operating Contract every role now embeds
+
+```markdown
+## Operating Contract
+
+You are a **<TIER>** in the **LMC (Lead-Manager-Checker) protocol** — see
+`Agentik_SSOT/agents/aisb/lmc-protocol.md` for the full spec.
+
+**Tier responsibility**: <one-line per-role>
+
+**Verified completion** — you NEVER declare your own work done. The engine
+derives completion from a `.done.json` signal you emit via:
+
+    ~/.aisb/lib/<MARKER>   # writes .done.json with status + evidence
+
+Status ∈ {done_clean, pending, failed}. If genuinely blocked (Third-Law
+fallback), write worker-blocked-<session>.json + execute the fallback —
+never sit idle.
+
+**Fresh-context handoff** — every brief MUST be self-contained:
+Mission / Purpose / Context / Done Criteria / Verify Command.
+```
+
+Per-role tiers:
+- **Manager** (Oracle) — `oracle-mark-done.sh`
+- **Workers** (Morpheus, Construct, Architect, Keymaker, Niobe, Smith, Merovingian, Neo, Link, Zion) — `worker-mark-done.sh`
+- **Checker** (Seraph) — `worker-mark-done.sh`
+- **Watcher** (Pythia, read-only) — `worker-mark-done.sh`, status=`pending` for human review
+
+## 4. The new tmux look (tmux-claude alignment)
+
+**Before** (Claude cream/orange):
+```
+status-style "bg=#FAFAF7,fg=#3D3929"
+status-left  "#[fg=#D97757,bold]Ω #S #[fg=#A8A29E]│ "
+status-right "#[fg=#88837A]%H:%M │ <count> sessions"
+```
+
+**After** (tmux-claude amber):
+```
+status-style "fg=default"     # inherits terminal background
+status-left  '  #[fg=colour137,bold]Ω #S #[fg=default,nobold]• #[fg=colour137]#(omega tmux count) sess #[fg=default]• #[fg=colour137]%H:%M '
+status-right '#[fg=default]CPU #[fg=colour137]<cpu>% #[fg=default]• #[fg=colour137]Ω v<version>  '
+
+setw -g window-status-format ''           # hide window list
+setw -g window-status-current-format ''
+setw -g window-status-separator ''
+
+bind-key Z display-popup -E -w 100% -h 100% "omega tmux menu"   # was 80%
+bind-key -n M-/ display-popup -E -w 100% -h 100% "omega tmux switcher"
+
+set -g pane-active-border-style "fg=colour137"
+set -g message-style "fg=colour137,bg=default,bold"
+set -g mode-style    "fg=default,bg=colour137"
+```
+
+`bind-key -n M-z` keeps spawning the Omega session (unchanged).
+
+## 5. The fzf menu palette (Omega TUI)
+
+**ANSI constants in `_arrow_menu`** (with backward-compat alias):
+```python
+AMBER       = "\033[38;5;137m"     # xterm 256 colour137 — amber gold
+AMBER_BR    = "\033[38;5;215m"     # bright amber for highlighted rows
+MUTED       = "\033[38;5;240m"     # dim gray
+ORANGE      = AMBER                # alias — keeps existing code working
+```
+
+**fzf `--color=` block:**
+```
+bg:-1, fg:default,            # inherit terminal background (no cream)
+bg+:#1c1c1c, fg+:colour215,   # dark highlight bar, bright amber on selection
+hl/hl+/prompt/pointer/marker/header/border/info/spinner: colour137/215,
+gutter:-1
+```
+
+## 6. Tests (regression-locked)
+
+| Chantier | New tests | Suite total |
+|---|---|---|
+| v0.19.39 baseline | — | 644 |
+| 2A progress bar (3 new) | +3 | 647 |
+| 2C fzf palette (4 new) | +4 | 651 |
+| 2B tmux palette (4 new) | +4 | 655 |
+| 6 role enrichment (5 new) | +5 | **660** |
+
+**Regression locks for role enrichment:**
+- `test_every_aisb_role_scores_at_least_80` — floor: 80/100 per role
+- `test_average_suite_score_at_least_85` — floor: 85.0 average (current 98.3)
+- `test_done_json_vocab_overlap_at_least_80_percent` — floor: 80% (current 100%)
+- `test_every_role_references_lmc_protocol` — direct grep check
+- `test_every_role_references_three_laws` — LAW 3 mandatory
+
+## 7. Progress bar — before / after (the actual UX)
+
+**Before** (`STEP_TOTAL=21` but `STEP_COUNT` reaches 42):
+```
+Installing… ███████████████████ 21/21 100% step_aisb_suite
+Installing… ███████████████████ 22/21 104% step_audit_skills   ← newline mid-install
+Installing… ███████████████████ 23/21 109% step_engine
+…
+```
+
+**After** (count only on `ok`/`skip`):
+```
+Installing… ██████████████████░░ 18/21  85% step_clis        ← single line, no scroll noise
+```
+
+(then on the very last `ok` of the run, ONE newline so the post-install card prints cleanly)
+
+## 8. Verdict
+
+✅ TUI menu (fzf) — **pixel/CRT amber palette**, terminal bg inherited.
+✅ Tmux config — **tmux-claude design adopted** (colour137 amber, bullets, hidden window list, full-screen popups).
+✅ Install progress bar — **stays on one line**, no newline spawn.
+✅ AISB role prompts — **average 98.3/100** (was 52.0), every role references the LMC protocol + `.done.json` + Three Laws + done-marker + fresh-context.
+✅ `omega doctor prompts` section — surfaces healthy scores, drift detection live.
+✅ 660 tests passing, 0 regressions.
+
+Next steps (deferred to v0.19.41+, in order):
+- **Convex install step** — bundle Convex CLI, scaffold a starter project with Claude Code SDK + Google SDK + A2A schema
+- **Tmux popup-based menu** — replace inline fzf with `display-popup -E -w 100% -h 100%` like tmux-claude's `session-manager-v2`
+- **Status-bar cache daemon** — match tmux-claude's `/tmp/tmux-status-cache/` pattern to avoid subprocess spawning during paste
+
+The user's invariant remains: `npx -y @agentikos/omega-os@latest --full` and the system is 100% functional.