@agentikos/omega-os 0.19.39 → 0.19.40

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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentikos/omega-os",
-  "version": "0.19.39",
+  "version": "0.19.40",
   "description": "Omega OS — installable agentic operating system with verified-completion orchestration. Event-sourced engine, 8-block rack, autonomous agents, MCP.",
   "bin": {
     "omega-os": "bin/omega-os.js"