@agentikos/omega-os 0.19.27 → 0.19.29

package/omega/Agentik_Engine/omega_engine/__init__.py

@@ -188,7 +188,7 @@ from omega_engine.genesis import (
 )
 from omega_engine import plan as plan_v7
 
-__version__ = "0.19.27"
+__version__ = "0.19.29"
 
 __all__ = [
     "__version__",

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -2855,19 +2855,20 @@ def cmd_menu(_args: argparse.Namespace) -> int:
     return 0
 
 
-def cmd_menu_tui(_args: argparse.Namespace) -> int:
-    """`omega menu-tui` — the OmegaOS Textual TUI (v0.19.27+).
+def cmd_menu_tui(args: argparse.Namespace) -> int:
+    """`omega menu-tui` — slash-command REPL (default) or Textual TUI.
 
-    Modern boxed-layout TUI with slash commands (Hermès-style), sidebar
-    categories, scrollable content log, footer keybindings. Falls back
-    to a plain slash REPL if `textual` isn't installed (e.g. headless
-    or before the engine venv finishes installing deps).
+    v0.19.29 default = plain REPL. Textual was unreliable under
+    tmux + send-keys (focus didn't reach the input). The REPL uses
+    synchronous input() which works EVERYWHERE, plus readline for
+    history + tab completion of slash commands.
 
-    Delegates to `omega_engine.tui.run_tui()` which encapsulates both
-    the Textual app and the plain REPL fallback.
+    Opt into Textual: `omega menu-tui --textual` (useful when running
+    omega directly in iTerm/Wezterm/Kitty without tmux send-keys).
     """
     from omega_engine.tui import run_tui
-    return run_tui()
+    prefer_textual = getattr(args, "textual", False)
+    return run_tui(prefer_textual=prefer_textual)
 
 
 def _legacy_fzf_menu(_args: argparse.Namespace) -> int:
@@ -4343,10 +4344,12 @@ def _build_parser() -> argparse.ArgumentParser:
     sub.add_parser("menu",
         help="open the interactive whiptail menu (legacy)"
     ).set_defaults(fn=cmd_menu_whiptail)
-    sub.add_parser("menu-tui",
-        help="the Textual TUI inside the Omega tmux session "
-        "(don't call directly — bare `omega` lands you here)"
-    ).set_defaults(fn=cmd_menu_tui)
+    p_mt = sub.add_parser("menu-tui",
+        help="slash-command REPL (default) — use --textual for the "
+        "fancier (but tmux-fragile) Textual TUI")
+    p_mt.add_argument("--textual", action="store_true",
+                      help="try the Textual app instead of the REPL")
+    p_mt.set_defaults(fn=cmd_menu_tui)
     sub.add_parser("menu-fzf",
         help="legacy v0.19.26 fzf menu fallback"
     ).set_defaults(fn=_legacy_fzf_menu)

package/omega/Agentik_Engine/omega_engine/tmux.py

@@ -533,9 +533,9 @@ bind-key S choose-tree -Zs
 # ════════════════════════════════════════════════════════════════════
 # Visual cues per session category
 # ════════════════════════════════════════════════════════════════════
-set -g status-style "bg=#1a1a2e,fg=#eee"
+set -g status-style "bg=#1a1a2e,fg=#eeeeee"
 set -g status-left  "#[fg=#7aa2f7,bold]#S #[fg=default]│ "
-set -g status-right "#[fg=#888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
+set -g status-right "#[fg=#888888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
 """
 
 
@@ -625,15 +625,15 @@ bind-key r source-file ~/.tmux.conf \\; display-message "tmux.conf reloaded"
 # ════════════════════════════════════════════════════════════════════
 # Visual cues per session category — colour the status bar by name.
 # ════════════════════════════════════════════════════════════════════
-set -g status-style "bg=#1a1a2e,fg=#eee"
+set -g status-style "bg=#1a1a2e,fg=#eeeeee"
 set -g status-left  "#[fg=#7aa2f7,bold]#S #[fg=default]│ "
-set -g status-right "#[fg=#888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
+set -g status-right "#[fg=#888888]%H:%M │ #(omega tmux count 2>/dev/null) sessions"
 set -g status-interval 5
 set -g status-left-length 40
 set -g status-right-length 60
 
 # Pane border colour — softer than default red
-set -g pane-border-style "fg=#333"
+set -g pane-border-style "fg=#333333"
 set -g pane-active-border-style "fg=#7aa2f7"
 """
 

package/omega/Agentik_Engine/omega_engine/tui.py

@@ -409,17 +409,34 @@ if TEXTUAL_AVAILABLE:
                 _switch_client(res.session_jump)
 
 
-def run_tui() -> int:
-    """Entry point — `omega menu-tui` calls this."""
-    if not TEXTUAL_AVAILABLE:
-        print("  textual not installed — `omega upgrade` or run:")
-        print("    pip install textual")
-        print()
-        print("  Falling back to plain prompt mode.")
-        return _plain_repl()
-    app = OmegaTUI()
-    app.run()
-    return 0
+def run_tui(prefer_textual: bool = False) -> int:
+    """Entry point — `omega menu-tui` calls this.
+
+    v0.19.29 — switched the DEFAULT to the plain slash REPL because the
+    Textual app, while pretty, has unreliable focus/keyboard delivery
+    inside tmux panes launched via send-keys. The user's bug report
+    ("je peux pas taper dans le keyboard ni sélectionner") was reproducible
+    on the VPS too — Textual's Input widget doesn't always claim focus
+    when the app starts under tmux + send-keys.
+
+    The plain REPL uses synchronous `input()` which is rock-solid in any
+    terminal, any tmux config, any TERM value. It accepts the SAME slash
+    commands (/aisb /hermes /switch /audit /mission /scrape /doctor …).
+
+    Opt back into Textual via `omega menu-tui --textual` (or pass
+    prefer_textual=True from code) — useful when iTerm/Wezterm/Kitty
+    runs the menu directly without tmux send-keys interference.
+    """
+    if prefer_textual and TEXTUAL_AVAILABLE:
+        try:
+            app = OmegaTUI()
+            app.run()
+            return 0
+        except Exception as exc:  # noqa: BLE001
+            print(f"  Textual TUI failed: {exc}")
+            print("  Falling back to plain REPL.")
+            return _plain_repl()
+    return _plain_repl()
 
 
 # ---------------------------------------------------------------------------
@@ -428,15 +445,73 @@ def run_tui() -> int:
 
 
 def _plain_repl() -> int:
-    """Slash-command REPL with no textual TUI — same command set."""
+    """Slash-command REPL — the v0.19.29 default for `omega menu-tui`.
+
+    Rock-solid input via Python's stdlib `input()` — works in any
+    terminal, any tmux setup, any TERM value. Same slash command set
+    as the Textual app. readline gives history (↑/↓), basic line
+    editing, Ctrl-r reverse search.
+    """
+    import os
     from omega_engine import __version__
-    print(f"\n  Ω  Omega OS v{__version__} — plain REPL mode")
-    print("  Type /help for commands, /quit to exit.\n")
+
+    # readline gives line editing + history. Persist history under $OMEGA_HOME.
+    try:
+        import readline
+        hist_path = os.path.join(
+            os.environ.get("OMEGA_HOME", os.path.expanduser("~/Omega")),
+            "Agentik_Extra", "var", "omega-repl-history",
+        )
+        try:
+            os.makedirs(os.path.dirname(hist_path), exist_ok=True)
+            if os.path.exists(hist_path):
+                readline.read_history_file(hist_path)
+        except OSError:
+            hist_path = None
+        readline.set_history_length(500)
+        # Tab-completion over known slash commands.
+        _COMMANDS = [
+            "/help", "/aisb", "/hermes", "/switch", "/mission", "/audit",
+            "/genesis", "/scrape", "/sessions", "/accounts", "/vault",
+            "/doctor", "/status", "/detach", "/quit",
+        ]
+        def _completer(text: str, state: int) -> str | None:
+            matches = [c for c in _COMMANDS if c.startswith(text)]
+            return matches[state] if state < len(matches) else None
+        readline.set_completer(_completer)
+        readline.parse_and_bind("tab: complete")
+    except ImportError:
+        hist_path = None
+
+    # Banner — boxed, orange Ω like Hermès's launch screen.
+    print()
+    print("  ┌─────────────────────────────────────────────────────────┐")
+    print(f"  │  \033[38;2;217;119;87m\033[1mΩ\033[0m  \033[1mOmega OS\033[0m v{__version__:<10}                          │")
+    print( "  │  type \033[1m/help\033[0m for slash commands • \033[1m/quit\033[0m to exit         │")
+    print( "  ├─────────────────────────────────────────────────────────┤")
+    print( "  │  quick start:                                           │")
+    print( "  │    \033[1m/aisb\033[0m              chat with AISB (Max OAuth)       │")
+    print( "  │    \033[1m/hermes\033[0m            chat with Hermès (Anthropic API) │")
+    print( "  │    \033[1m/switch\033[0m            see + hot-swap LLM provider      │")
+    print( "  │    \033[1m/mission \"...\"\033[0m     run verified-completion mission  │")
+    print( "  │    \033[1m/scrape <url>\033[0m      stealth scrape (CloakBrowser)    │")
+    print( "  │    \033[1m/audit <id>\033[0m        run a Quality Arsenal audit      │")
+    print( "  │    \033[1m/doctor\033[0m            full health check                │")
+    print( "  └─────────────────────────────────────────────────────────┘")
+    print()
+    print("  TAB completes slash commands  •  ↑/↓ for history\n")
+
+    PROMPT = "  \033[38;2;217;119;87mΩ\033[0m › "
     while True:
         try:
-            line = input("  Ω › ").strip()
+            line = input(PROMPT).strip()
         except (EOFError, KeyboardInterrupt):
             print()
+            if hist_path:
+                try:
+                    readline.write_history_file(hist_path)
+                except OSError:
+                    pass
             return 0
         if not line:
             continue
@@ -455,3 +530,8 @@ def _plain_repl() -> int:
             print()
         if res.session_jump:
             _switch_client(res.session_jump)
+        if hist_path:
+            try:
+                readline.write_history_file(hist_path)
+            except OSError:
+                pass

package/omega/Agentik_Engine/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "omega-engine"
-version = "0.19.27"
+version = "0.19.29"
 description = "The Omega OS orchestration engine — event-sourced, verified-completion agent graphs."
 readme = "README.md"
 requires-python = ">=3.11"

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.27
+0.19.29

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

@@ -0,0 +1,350 @@
+# OmegaOS — Audit Avant/Après (v0.19.27)
+
+> Rapport d'audit profond comparant le **système VPS live** (Agentik OS
+> historique tournant chez Gareth depuis ~14 mois) au **package OmegaOS
+> v0.19.27** (la refonte distribuable au public).
+>
+> Méthode : inventaire en parallèle des deux côtés, mapping fonctionnel,
+> identification des écarts (préservé / adapté / manquant / nouveau),
+> tests fonctionnels + vérification logique de l'architecture.
+
+---
+
+## 1. Comparaison quantitative
+
+| Surface | VPS live | OmegaOS v0.19.27 | Notes |
+|---|---:|---:|---|
+| Rules globales (~/.claude/rules/) | 15 | 0 + 3 lois embarquées | Rules condensées dans `personas/OMEGAOS-CONTEXT.md` |
+| Agents | 61 | 13 AISB + 8 Genesis | Le suite AISB est ce qui compte; le reste = noise sur le VPS |
+| Commands / Skills | 142 / 134 | 33 SSOT skills + 18 audits YAML | Refonte : les 17 audits + orchestrators = canon |
+| ~/.aisb/lib scripts | 200 .sh/.py | Engine Python: 60 modules | Refonte : engine remplace les bash scripts ad-hoc |
+| Cron entries | 39 | 1 launchd + autonomous charters | Refonte : systemd/launchd units canoniques + charters YAML |
+| Systemd services | 4 (aisb-bot, reactor, session-tracker, webhook-bridge) | 3 launchd plists (engine, telegram, autonomous) | Réduit à l'essentiel |
+| LLM CLIs disponibles | claude only (officiel) | 13 (Claude/Gemini/Codex/OpenCode/Qwen/Continue/Ollama/LM Studio/Aider/GLM/Copilot + provider configs pour 16 backends) | **Refonte massive** |
+| Scrapers | aucun officiel | CloakBrowser (default) + Scrapling (opt-in) | **Nouveau** |
+| Stacks Genesis | n/a (oracle = pure live) | 8 presets canoniques | **Nouveau** |
+| Persona system | ad-hoc CLAUDE.md éparpillés | 1 canonical → mirroré dans 10 LLM filenames | **Nouveau** |
+| TUI / Menu | tmux-claude session manager popup | Textual app (Hermès-style) + fzf fallback + plain REPL | **Nouveau** |
+| Tests automatisés | 0 officiel | **599 tests** (pytest) | **Refonte qualité** |
+
+---
+
+## 2. Mapping fonctionnel — où vit quoi maintenant
+
+### Côté Live VPS (ce qu'on avait)
+
+```
+~/.claude/                              ← Claude Code config + custom commands
+├── rules/                              ← 15 .md "lois" globales
+├── agents/                             ← 61 specialist personas
+├── commands/                           ← 142 slash command files
+├── skills/                             ← 134 skill files
+└── settings.json                       ← Agent Teams flag, hooks
+
+~/.aisb/                                ← AISB orchestration state
+├── lib/                                ← 200 bash + python scripts ad-hoc
+├── secrets/                            ← integrations.env (plain)
+├── state/                              ← oracle/worker .done.json + briefs
+├── locks/                              ← per-project ship locks
+├── docs/                               ← ARCHITECTURE / ORCHESTRATION / CLOUD
+└── heartbeats/                         ← keep-alive markers
+
+~/VibeCoding/agentic/agentik-monitor/
+├── telegram-bot/                       ← bot Python (single token)
+├── bot/                                ← SOUL.md + MEMORY.md
+├── dashboard/                          ← Next.js dashboard (separate)
+└── mcp-server/                         ← MCP integration
+```
+
+### Côté OmegaOS package (ce qu'on distribue)
+
+```
+omega/
+├── Agentik_Engine/                     ← LE MOTEUR (60 modules Python)
+│   └── omega_engine/
+│       ├── cli.py                      ← entry point — 70+ subcommands
+│       ├── tui.py                      ← Textual app + slash dispatcher  [NEW v0.19.27]
+│       ├── tmux.py                     ← spawn AISB/Hermes/Omega/Oracle/Worker
+│       ├── personas.py                 ← canonical OmegaOS context for 10 LLMs  [NEW v0.19.22]
+│       ├── genesis/                    ← 8 stack presets + PHASES pipeline
+│       ├── audits/                     ← 18 audit YAML → SKILL.md generator
+│       ├── hermes.py + hermes_*.py     ← L2 companion bridge
+│       ├── aisb_chat.py                ← chat_once() + run_chat_loop()
+│       ├── plan.py                     ← FSM-enforced multi-day planner
+│       ├── pursue.py                   ← native /goal replacement
+│       ├── vault.py                    ← age-encrypted secrets
+│       ├── webhooks.py                 ← HMAC-signed inbound triggers
+│       └── 50+ more...
+│
+├── Agentik_SSOT/                       ← source-of-truth (operator-editable)
+│   ├── skills/                         ← 33 skills (17 audits + orchestrators + scrape + switch)
+│   ├── audits/*.yaml                   ← 18 audit definitions
+│   ├── agents/aisb/                    ← (populated at install from bootstrap/templates/aisb)
+│   ├── personas/                       ← (populated at install — canonical OMEGAOS-CONTEXT.md)
+│   ├── clis/clis-catalog.yaml          ← 27 system CLIs (incl. CloakBrowser + Scrapling)  [NEW]
+│   ├── llm-providers/providers-catalog.yaml  ← 16 LLM providers (Anthropic/OpenAI/Gemini/GLM/DeepSeek/Qwen/Ollama/LM Studio/OpenRouter/Bedrock/Mistral/xAI/Vercel Gateway/Copilot/OpenAI-compat/ChatGPT sub)  [NEW v0.19.23]
+│   ├── mcp/mcp-catalog.yaml            ← 16 MCPs (LEGACY — opt-in only since v0.19.21)
+│   ├── claude-plugins/                 ← 15 plugins (incl. superpowers, claude-mem, document-skills)
+│   └── docs/                           ← LAYERS.md (4-level archi) + USER-JOURNEY.md + this audit
+│
+├── Agentik_Orchestration/
+│   ├── topologies/aisb-oracle-worker.yaml
+│   ├── autonomous/                     ← cron-driven charters YAML
+│   └── educators/                      ← self-improvement loops
+│
+├── Agentik_Coding/projects/<slug>/     ← strict per-project isolation
+├── Agentik_Providers/                  ← (claude/ — sync target)
+├── Agentik_Runtime/                    ← live: eventlog/rag.db/sessions/locks
+├── Agentik_Tools/bin/omega             ← symlink to engine venv
+└── Agentik_Extra/var/etc/staging/      ← logs, secrets vault, staging
+
+bootstrap/
+├── lib/
+│   ├── common.sh                       ← prompts, banner, NEWT_COLORS, install_venv
+│   ├── steps.sh                        ← 22 step functions
+│   ├── llm-clis.py                     ← 13 LLM CLI catalog
+│   ├── claude-code-settings.py         ← merge into ~/.claude/settings.json
+│   └── manifest-helpers.py             ← read install manifest
+└── templates/
+    └── aisb/                           ← 15 agent prompts (deployed at step 25)
+
+install.sh                              ← 21 STEPS, plan mode, prompt_yes_no, exec shell at end
+bin/omega-os.js                         ← npx entry → handoff to install.sh
+package.json                            ← @agentikos/omega-os@0.19.27
+```
+
+---
+
+## 3. Diff catégorisé
+
+### 3.1 — Préservé / adapté (canon transposé)
+
+| Concept Live | OmegaOS canon | Adaptation |
+|---|---|---|
+| 13 AISB agent prompts (Niobe/Oracle/Construct/Seraph/Smith/Pythia/...) | `bootstrap/templates/aisb/*.md` → `~/Omega/Agentik_SSOT/agents/aisb/` | Identiques. Step 25 les déploie tel quel. |
+| 17 audits Quality Arsenal | `Agentik_SSOT/audits/*.yaml` + `Agentik_SSOT/skills/*audit/SKILL.md` | YAML structurés + SKILL.md généré au step 27. |
+| Tmux-claude session manager | step 36 lance le canonical installer | Identique — `curl install.sh \| bash` du repo `agentik-os/tmux-claude`. |
+| 3 Laws | Embarqués dans `personas/OMEGAOS-CONTEXT.md` | Chaque LLM (Claude/Gemini/Codex/...) les voit au boot. |
+| Per-project Telegram topic | `Agentik_SSOT/projects/<slug>/registry.yaml` + topic_id map | Topic = project mission scope. |
+| 4-level hiérarchie | Documenté dans `LAYERS.md` + enforcé par engine | Human → AISB → Oracle → Workers. |
+| Claude Max OAuth single-token | Engine reads `~/.claude/.credentials.json` live | AISB+Oracle+Worker partagent. Hermès isolé (Anthropic API). |
+
+### 3.2 — Manquant / non porté
+
+| Live VPS | OmegaOS v0.19.27 status |
+|---|---|
+| 200 lib scripts ad-hoc (`safe-npm-build.sh`, `dispatch-to-session.sh`, `oracle-ship.sh`, etc.) | Remplacés par engine Python (`omega run`, `omega genesis`, `omega plan run`, etc.). Aucune mention 1:1 dans le package. |
+| 39 cron entries (mémoires SQLite, FFT-flusher, defensive scan, etc.) | Réduit à 0 entries cron — remplacé par 3 launchd services (engine, telegram, autonomous) + autonomous charters YAML. |
+| Shadow Manager (14 signals daemon) | Pas porté. Remplacé par `omega doctor` snapshot + manual ops. |
+| Safety Mesh L1-L4 (brief-replay, CPU Guard, Shadow Manager, Mission Auditor) | Mission Auditor partiellement = audit gate via Stop-hook. Les 3 autres non portés (CPU guard, shadow nudges, brief-replay). |
+| Tracking Reactor (inotify ~129ms stall detection) | Pas porté. |
+| Smart Resurrect Cascade (4 tiers) | Pas porté. |
+
+### 3.3 — Nouveau (refonte propre que le live n'a pas)
+
+| Ajout OmegaOS | Pourquoi |
+|---|---|
+| **8 Genesis stack presets** (omegaos-canonical / mobile-native / mobile-expo / desktop-tauri / supabase / claude-dashboard / convex-selfhosted / sqlite-local) | Le live n'avait pas de pipeline de "nouveau projet" — opérateur partait du clone à la main. |
+| **Persona system** (canonical OMEGAOS-CONTEXT.md → mirroré dans CLAUDE.md/GEMINI.md/AGENTS.md/...) | Hot-swap LLM possible — chaque CLI voit la même persona automatiquement. |
+| **`omega switch <provider>`** | Hot-swap LLM en une commande. Live = pas de switching. |
+| **Textual TUI** (`omega menu-tui` + slash commands `/aisb /hermes /switch /audit /mission /scrape`) | Le live = pas de TUI, juste tmux + scripts dispersés. |
+| **CloakBrowser scraper** (`omega scrape <url>`) | Le live n'avait pas de scraper officiel — usage ad-hoc de Playwright. |
+| **Scrapling scraper** (optionnel, `--engine scrapling`) | Idem, complément rapide pour les sites non protégés. |
+| **CLI Catalog `clis-catalog.yaml`** (27 system CLIs avec install per-OS, post_install hooks) | Live = installs manuels. |
+| **LLM Provider Catalog** (16 backends — Anthropic/OpenAI/Gemini/GLM/DeepSeek/Qwen/Ollama/LM Studio/OpenRouter/Bedrock/Mistral/xAI/Vercel Gateway/Copilot/OpenAI-compat/ChatGPT sub) | Live = claude only. |
+| **Plan v7 FSM-enforced executor** (PENDING→IN_PROGRESS→CLAIMED_DONE→VERIFIED, plan.db SQLite per-project, `omega plan run` multi-day autonomous loop) | Live = pas d'engine de planning, juste dispatch. |
+| **age-encrypted vault** (`omega vault read/write`) | Live = plain .env files. |
+| **Webhooks HMAC-signés** (`omega webhook handle`) | Live = pas de surface d'entrée webhook canonique. |
+| **Genesis pipeline** (vision → market 5 files → branding 3 files → PRD 9 files → features F-001..F-006 DAG → plan) | Live = aucun. Refonte produit-first. |
+| **2 scrapers + Printing Press CLI factory** | Nouveau écosystème d'agent-CLIs. |
+| **599 pytest tests** | Live = 0 test officiel. |
+| **`@agentikos/omega-os` npm package** distribuable + installer 21 steps avec plan mode | Live = config manuelle, jamais redistribuable. |
+
+---
+
+## 4. Tests fonctionnels exécutés
+
+| Test | Résultat |
+|---|---|
+| `python -m pytest -q --tb=no` | **599 passed**, 2 warnings (DeprecationWarning v0.6 backup), 20.8s |
+| `bash -n install.sh bootstrap/lib/{common,steps}.sh` | shell syntax OK |
+| Import canary: `from omega_engine import cli, tui, tmux, personas, genesis, audits` | all imports OK |
+| Slash dispatch: `dispatch_slash("/help")` | 30-line help OK |
+| Slash dispatch: `dispatch_slash("/aisb")` | `session_jump=AISB-chat` OK |
+| Slash dispatch: `dispatch_slash("/hermes")` | `session_jump=Hermes-chat` OK |
+| Slash dispatch: `dispatch_slash("/unknown_cmd")` | "unknown command" message OK |
+| `bash install.sh --dry-run --profile workstation` | 21 steps listed cleanly |
+| `personas.supported_llm_ids()` | 10 ids (claude_code/gemini_cli/codex/opencode/openrouter_cli/deepseek/qwen_code/continue_dev/aider/hermes) |
+| Catalog parse: MCP/CLI/LLM-providers/plugins | All 4 YAMLs parse cleanly, counts correct (16/27/16/15) |
+| npm tarball v0.19.27 contains all 13 LLM CLIs | verified via `npm pack` extraction |
+
+---
+
+## 5. Vérification de la logique architecture
+
+### 5.1 — 4-level hiérarchie
+
+```
+Human (Telegram / TUI omega / CLI)
+   ↓
+AISB (intake — Claude Max OAuth)
+   ↓ dispatch_oracle
+Oracle (per-project planner — Claude Max OAuth, persistent tmux)
+   ↓ dispatch_worker
+Worker (executor — short-lived tmux, .done.json signal)
+```
+
+**OmegaOS map :**
+- L1 Human → `omega` TUI + `omega run` CLI + Telegram bot (step 50)
+- L2 AISB → `Agentik_SSOT/agents/aisb/niobe.md` (intake personality) + `aisb_chat.py` + Telegram daemon
+- L3 Oracle → `tmux.spawn_oracle(project, oracle_id)` → persistent session
+- L4 Worker → `tmux.spawn_worker(project, task)` + `done_signal.py` + audit gate
+- L2bis Hermès → optionnel, séparé : `hermes.py` + Anthropic API + own Telegram bot
+
+**Verdict :** ✓ Architecture cohérente, enforcée en code (tmux session naming + role aliases dans `prompts.py`).
+
+### 5.2 — Provider hot-swap
+
+```
+omega switch gemini_cli
+   ↓
+$OMEGA_HOME/Agentik_Extra/var/active-llm-provider ← "gemini_cli"
+   ↓
+Next spawn_aisb_chat() reads active provider (planned v0.19.28+)
+   ↓
+tmux session launches `gemini` instead of `claude`
+```
+
+**OmegaOS status :** marker écrit (v0.19.22). `spawn_aisb_chat` ne le lit pas encore → utilise toujours `claude`. **Gap connu, v0.19.28.**
+
+### 5.3 — Persona system
+
+```
+$OMEGA_HOME/Agentik_SSOT/personas/OMEGAOS-CONTEXT.md  ← canonical (operator editable)
+   ↓ _ensure_chat_context_dir()
+$OMEGA_HOME/Agentik_Coding/chat-contexts/aisb-master/
+   ├── CLAUDE.md         ← Anthropic Claude Code reads this
+   ├── GEMINI.md         ← Google Gemini CLI reads this
+   ├── AGENTS.md         ← OpenAI Codex reads this
+   ├── QWEN.md           ← Alibaba Qwen reads this
+   ├── .opencode/CONTEXT.md   ← OpenCode reads this
+   ├── .continue/CONTEXT.md   ← Continue.dev reads this
+   ├── CONVENTIONS.md    ← Aider reads this
+   └── HERMES.md         ← Hermès reads this
+```
+
+**Verdict :** ✓ Tous les LLM voient le MÊME contexte OmegaOS. Edit `OMEGAOS-CONTEXT.md` une fois → propagé.
+
+### 5.4 — Scrapers (CLI surface pour les LLMs)
+
+```
+LLM dans une session Claude/Gemini/Codex
+   ↓ user: "fetch https://stripe.com/docs"
+   ↓ LLM shell-out:
+omega scrape https://stripe.com/docs           ← default CloakBrowser
+   OR
+omega scrape <url> --engine scrapling          ← fast HTTP-first
+   ↓
+markdown sur stdout → re-injecté dans le contexte du LLM
+```
+
+**Verdict :** ✓ Tous les LLMs ont accès au même scraper via Bash. Bot detection bypass via CloakBrowser C++ patches.
+
+### 5.5 — 21 install steps — séquence vérifiée
+
+| # | Step | Dépendances | Verdict |
+|---|---|---|---|
+| 00 | preflight | — | ✓ |
+| 10 | system-deps | brew/apt/dnf + installer venv (uv + Python 3.13 + pyyaml) | ✓ Tahoe-safe via uv |
+| 15 | llm-clis | npm (Node), uv (Python) | ✓ 13 CLIs offerts en multi-select |
+| 20 | structure | `cp -R omega/` | ✓ 8 blocks |
+| 25 | aisb-suite | step 20 done | ✓ 15 agent prompts copiés |
+| 27 | audit-skills | step 20 + 25 + yaml | ✓ 18 SKILL.md générés |
+| 30 | engine | uv venv + uv pip install -e . (incl. textual >= 1.0) | ✓ `omega` binary linké |
+| 33 | claude-code-settings | step 30 + claude installé | ✓ Stop-hook + Agent Teams flag |
+| 32 | accounts | manifest optional | skip si pas de manifest |
+| 35 | providers | manifest optional | skip si pas de manifest |
+| 36 | tmux-config | step 10 (tmux) | ✓ `agentik-os/tmux-claude` installer |
+| 37 | hermes-brief | step 30 | ✓ `~/.hermes/skills/omega/SKILL.md` |
+| 40 | **clis** (refonte v0.19.21 — replaces MCP) | step 30 | ✓ audit + install 10 native + Printing Press |
+| 45 | claude-plugins | claude CLI | ✓ 10 plugins (4 anciennement cassés fixés) |
+| 50 | telegram | curl | ✓ 2-bot model AISB + Hermès optionnel |
+| 55 | autonomous | manifest optional | skip si pas de manifest |
+| 57 | rag | step 30 | leaves defaults |
+| 58 | first-project | manifest optional | skip si pas de manifest |
+| 59 | hermes-session | step 30 + tmux | ✓ AISB-chat tmux toujours-active |
+| 60 | services | systemd/launchd | ✓ 3 plists / units |
+| 70 | doctor | step 30 + tout le reste | verdict READY/PARTIAL/NOT_READY |
+
+**Verdict global :** Les 21 steps couvrent install end-to-end. Étapes optionnelles (manifest-driven) gèrent gracieusement l'absence.
+
+### 5.6 — Régression historique (du v0.19.x debug saga)
+
+| Bug | Version d'origine | Fix | Verdict |
+|---|---|---|---|
+| `import yaml` crash sur macOS Tahoe | v0.19.7- | venv dédié avec uv + Python 3.13 managed | ✓ v0.19.11 |
+| `prompt_yes_no: command not found` | v0.19.1 | helper défini dans common.sh | ✓ v0.19.5 |
+| Banner G illisible (B confusion) | v0.19.0 | row 3 ouvert + arc bottom | ✓ v0.19.5 |
+| `${readiness,,}` bash 3.2 crash macOS | v0.19.4 | `tr` au lieu de `${var,,}` | ✓ v0.19.12 |
+| npx 404 (restricted access) | v0.19.4 | publishConfig.access=public | ✓ v0.19.7 |
+| `omega` ne fait rien sur Mac | v0.19.7 | NEWT_COLORS + text menu fallback | ✓ v0.19.12 |
+| MCP catalog count `(0\n?)` splatter | v0.19.11- | regex avec leading whitespace | ✓ v0.19.15 |
+| 4 MCPs failed (git/fetch/higgsfield/linear) | v0.19.20- | uvx method + correct package names | ✓ v0.19.16 |
+| AISB chat crash "cwd deleted" | v0.19.16- | spawn avec cwd=$HOME | ✓ v0.19.17 |
+| `omega aisb` silent attach to dead session | v0.19.17 | shell-stays-alive via send-keys + force_replace | ✓ v0.19.20 |
+| Claude plugins fail (anthropic-skills marketplace) | v0.19.19- | correct marketplace IDs + drop `-s scope` flag | ✓ v0.19.20 |
+| Bot Telegram DM rejected | v0.19.12- | route DM → AISB chat_once | ✓ v0.19.13 |
+| Source ~/.zshrc oubliée | toujours | `exec $SHELL -l` end of install | ✓ v0.19.20 |
+| Menu actions silently no-op | v0.19.25 | label matching bug + inline execution | ✓ v0.19.26 |
+| Plain fzf menu pas Hermès-grade | toujours | Textual TUI + slash commands | ✓ v0.19.27 |
+
+---
+
+## 6. Ce qui reste (roadmap v0.20+)
+
+1. **Streaming async dans le TUI** — actuellement subprocess capture + dump. Hermès = streaming live ligne-par-ligne.
+2. **`spawn_*_chat` provider-aware** — lire `active-llm-provider` et lancer le bon CLI (pas toujours `claude`).
+3. **Per-provider auth wizard** — `omega account login --provider gemini` qui lit `providers-catalog.yaml`.
+4. **Sync skills cross-provider** — translation Claude Code skills → Gemini CLI commands → Codex agents.
+5. **Safety Mesh L1-L4** — porter brief-replay + CPU Guard + Shadow Manager + Mission Auditor depuis le live VPS.
+6. **Tracking Reactor** — inotify stall detection.
+7. **Hermes dedicated daemon** — poll loop pour le bot Hermès séparé.
+8. **CloakBrowser auto-discovery via Claude `.claude/settings.json`** — pour que Claude découvre `omega scrape` sans qu'on lui dise.
+
+---
+
+## 7. Verdict
+
+**OmegaOS v0.19.27 = vraie refonte du système live**, pas un copier-coller.
+
+- ✓ **Distribuable** : `npx @agentikos/omega-os@0.19.27` install end-to-end en 21 steps.
+- ✓ **Multi-LLM** : 13 CLIs + 16 provider configs + persona system unifié.
+- ✓ **Multi-scraper** : CloakBrowser + Scrapling.
+- ✓ **TUI Hermès-style** : Textual app + slash commands.
+- ✓ **Testé** : 599 tests pytest passent.
+- ✓ **Documentation** : LAYERS.md (architecture) + USER-JOURNEY.md (parcours) + ce rapport.
+
+**Gaps connus** :
+- Provider hot-swap incomplet (marker écrit, spawn pas encore lecteur)
+- Safety Mesh non porté
+- Streaming async dans le TUI à venir
+
+**Ce qui rend OmegaOS supérieur au live VPS** :
+- Distribuable au public (vs setup manuel chez Gareth)
+- Hot-swap LLM (vs claude-only)
+- Stack Genesis (vs partir de zéro à la main)
+- Vault chiffré (vs .env plain)
+- 599 tests (vs 0)
+- TUI moderne (vs bash scripts dispersés)
+
+**Ce que le live VPS a de plus** :
+- Safety Mesh complet (4 layers de protection runtime)
+- 39 cron entries (Smith reflection, defensive scans, etc.)
+- 14 Shadow Manager signals
+- Tracking Reactor (~129ms stall detection)
+
+→ La refonte privilégie la **distributabilité** et la **multi-LLM** ; les couches de safety runtime du live restent à porter.
+
+---
+
+*Audit produit pour v0.19.27 — 2026-05-25 — testé sur le VPS (Linux x86_64, Python 3.13, uv 0.5+, tmux 3.x, fzf 0.60).*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentikos/omega-os",
-  "version": "0.19.27",
+  "version": "0.19.29",
   "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"