@agentikos/omega-os 0.19.26 → 0.19.28

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.26"
+__version__ = "0.19.28"
 
 __all__ = [
     "__version__",

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -2856,16 +2856,27 @@ def cmd_menu(_args: argparse.Namespace) -> int:
 
 
 def cmd_menu_tui(_args: argparse.Namespace) -> int:
-    """`omega menu-tui` — the fzf action picker for the Omega session.
+    """`omega menu-tui` — the OmegaOS Textual TUI (v0.19.27+).
 
-    v0.19.26 — actions now run INLINE in the menu pane (not in dead
-    background tmux windows). After every action, "press Enter to
-    return to menu". Sessions (AISB/Hermes) still spawn as separate
-    tmux sessions because they're meant to be talked to long-running.
+    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).
 
-    Bug fix: previous version used fzf with leading-space labels,
-    then `pick.strip()` killed the spaces, so display matching failed
-    and every pick became a no-op. Both sides stripped now.
+    Delegates to `omega_engine.tui.run_tui()` which encapsulates both
+    the Textual app and the plain REPL fallback.
+    """
+    from omega_engine.tui import run_tui
+    return run_tui()
+
+
+def _legacy_fzf_menu(_args: argparse.Namespace) -> int:
+    """v0.19.26 fzf menu — kept as fallback. Reachable via `omega menu-fzf`.
+
+    Actions run INLINE in the menu pane (not in dead background tmux
+    windows). After every action, "press Enter to return to menu".
+    Sessions (AISB/Hermes) still spawn as separate tmux sessions because
+    they're meant to be talked to long-running.
     """
     import os
     import shlex
@@ -4333,9 +4344,12 @@ def _build_parser() -> argparse.ArgumentParser:
         help="open the interactive whiptail menu (legacy)"
     ).set_defaults(fn=cmd_menu_whiptail)
     sub.add_parser("menu-tui",
-        help="the fzf action picker that runs INSIDE the Omega tmux "
-        "session (don't call directly — bare `omega` lands you here)"
+        help="the Textual TUI inside the Omega tmux session "
+        "(don't call directly — bare `omega` lands you here)"
     ).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)
     sub.add_parser("version", help="print the engine version").set_defaults(fn=cmd_version)
 
     # `omega switch <provider>` — hot-swap the LLM CLI used for new chats.

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

@@ -0,0 +1,457 @@
+"""OmegaOS interactive Textual TUI — the v0.19.27 redesign.
+
+User: "l'objectif c'est que ça fonctionne comme
+https://www.agentik-os.com/services/agentik-coding-workflow ! avec notre
+nouveau system omegaOS qui est noramlement une refont de tout ca ! et
+aussi pour ta reponse - le TUI mets tout en place pour OmegaOS"
+
+Architecture mirror of the Agentik Coding Workflow v2.5.1 doc:
+
+  - 4-level hierarchy visible (Human → AISB → Oracle → Worker)
+  - Telegram + terminal-native (no web dashboard)
+  - Terminal entry = this TUI
+  - Sessions exposed via tmux; TUI is the OmegaOS control surface
+
+Layout (Textual, mouse + keyboard, slash-command driven like Hermès):
+
+  ┌── Ω Omega OS v0.19.27  •  provider: claude_code  •  sessions: 3 ──┐
+  │  CATEGORY                  │  CONTENT                            │
+  │  ────────                  │  ───────                            │
+  │  ▶ Chat                    │  (selected category's content here  │
+  │    Projects                │   — sessions list, audit menu,      │
+  │    Audits                  │   doctor output, etc.)              │
+  │    Sessions                │                                     │
+  │    Accounts                │                                     │
+  │    Vault                   │                                     │
+  │    Health                  │                                     │
+  │    Scrape                  │                                     │
+  │                            │                                     │
+  ├────────────────────────────┴─────────────────────────────────────┤
+  │  Ω › /<slash command>                                            │
+  ├──────────────────────────────────────────────────────────────────┤
+  │  q quit  •  d detach  •  ? help  •  / focus slash input          │
+  └──────────────────────────────────────────────────────────────────┘
+
+Slash commands (Hermès-style):
+  /chat aisb          /chat hermes          /aisb  /hermes
+  /switch <provider>  /switch              (show current)
+  /audit <id>         /mission "<intent>"  /scrape <url>
+  /genesis <slug>     /doctor              /status
+  /vault [<key>]      /accounts            /sessions
+  /quit               /detach              /help
+"""
+from __future__ import annotations
+
+import os
+import subprocess
+import shlex
+from pathlib import Path
+from typing import Any
+
+try:
+    from textual.app import App, ComposeResult
+    from textual.widgets import (
+        Header, Footer, Input, RichLog, ListView, ListItem, Label,
+    )
+    from textual.containers import Horizontal, Vertical
+    from textual.binding import Binding
+    TEXTUAL_AVAILABLE = True
+except ImportError:
+    TEXTUAL_AVAILABLE = False
+
+
+# ---------------------------------------------------------------------------
+# Sidebar category map
+# ---------------------------------------------------------------------------
+
+CATEGORIES: list[tuple[str, str]] = [
+    ("chat",      "Chat — AISB & Hermès"),
+    ("projects",  "Projects — Genesis & shells"),
+    ("audits",    "Audits — Quality Arsenal (17 forensic)"),
+    ("missions",  "Missions — run with verified completion"),
+    ("sessions",  "Sessions — live tmux sessions"),
+    ("accounts",  "Accounts — Claude Max + provider auth"),
+    ("vault",     "Vault — encrypted secrets"),
+    ("health",    "Health — doctor + status"),
+    ("scrape",    "Scrape — CloakBrowser + Scrapling"),
+]
+
+
+# ---------------------------------------------------------------------------
+# Slash command dispatcher
+# ---------------------------------------------------------------------------
+
+
+class CommandResult:
+    """A command's effect — text to display + optional side-effects."""
+
+    def __init__(self, *, text: str = "", session_jump: str = "",
+                 exit_tui: bool = False, detach: bool = False) -> None:
+        self.text = text
+        self.session_jump = session_jump
+        self.exit_tui = exit_tui
+        self.detach = detach
+
+
+def _omega_bin() -> str:
+    home = Path(os.environ.get("OMEGA_HOME", str(Path.home() / "Omega")))
+    return str(home / "Agentik_Tools" / "bin" / "omega")
+
+
+def _run_omega(*args: str) -> str:
+    """Shell out to the omega CLI and capture its stdout/stderr."""
+    try:
+        proc = subprocess.run([_omega_bin(), *args],
+                              capture_output=True, text=True, timeout=120)
+        return (proc.stdout + proc.stderr).rstrip()
+    except subprocess.SubprocessError as exc:
+        return f"  error: {exc}"
+
+
+def _switch_client(target: str) -> None:
+    subprocess.run(["tmux", "switch-client", "-t", target],
+                   capture_output=True)
+
+
+def dispatch_slash(line: str) -> CommandResult:
+    """Parse a slash command and return the effect to apply."""
+    line = line.strip()
+    if not line:
+        return CommandResult(text="(empty)")
+    # Allow both "/foo bar" and "foo bar" inputs.
+    if line.startswith("/"):
+        line = line[1:]
+    try:
+        argv = shlex.split(line)
+    except ValueError as exc:
+        return CommandResult(text=f"  parse error: {exc}")
+    if not argv:
+        return CommandResult(text="(empty)")
+    cmd, *rest = argv
+
+    # Quit / detach
+    if cmd in ("quit", "q", "exit"):
+        return CommandResult(exit_tui=True)
+    if cmd in ("detach", "d"):
+        return CommandResult(detach=True)
+
+    # Chat sessions
+    if cmd == "aisb" or (cmd == "chat" and rest and rest[0] == "aisb"):
+        from omega_engine import tmux as _tx
+        _tx.spawn_aisb_chat(Path(os.environ.get(
+            "OMEGA_HOME", str(Path.home() / "Omega"))))
+        return CommandResult(
+            text="  AISB-chat spawned — switching client…",
+            session_jump="AISB-chat",
+        )
+    if cmd == "hermes" or (cmd == "chat" and rest and rest[0] == "hermes"):
+        from omega_engine import tmux as _tx
+        _tx.spawn_hermes_chat(Path(os.environ.get(
+            "OMEGA_HOME", str(Path.home() / "Omega"))))
+        return CommandResult(
+            text="  Hermes-chat spawned — switching client…",
+            session_jump="Hermes-chat",
+        )
+
+    # Provider hot-swap
+    if cmd == "switch":
+        if rest:
+            return CommandResult(text=_run_omega("switch", rest[0]))
+        return CommandResult(text=_run_omega("switch"))
+
+    # Audits + missions
+    if cmd == "audit":
+        if rest:
+            return CommandResult(text=_run_omega("audit", *rest))
+        return CommandResult(text=(
+            "  Quality Arsenal — 17 forensic audits:\n"
+            "    /codeaudit /uiuxaudit /flowaudit /debugaudit\n"
+            "    /featureaudit /perfaudit /secaudit /a11yaudit\n"
+            "    /seoaudit /dataaudit /apiaudit /copyaudit\n"
+            "    /dxaudit /motionaudit /automationaudit\n"
+            "    /logicaudit /retentionaudit /refontaudit\n"
+            "  invoke from any claude session, or:\n"
+            f"    omega audit <id>"
+        ))
+    if cmd in ("mission", "run"):
+        if not rest:
+            return CommandResult(text="  usage: /mission \"<intent>\"")
+        return CommandResult(text=_run_omega("run", " ".join(rest)))
+
+    # Genesis (new project)
+    if cmd == "genesis":
+        if not rest:
+            return CommandResult(text=_run_omega("genesis", "questions"))
+        return CommandResult(text=_run_omega("genesis", "new", rest[0]))
+
+    # Vault
+    if cmd == "vault":
+        if not rest:
+            return CommandResult(text=_run_omega("vault", "status"))
+        return CommandResult(text=_run_omega("vault", *rest))
+
+    # Accounts + sessions
+    if cmd == "accounts":
+        return CommandResult(text=_run_omega("account", "list"))
+    if cmd == "sessions":
+        try:
+            proc = subprocess.run(["tmux", "ls"],
+                                  capture_output=True, text=True, timeout=10)
+            return CommandResult(text=proc.stdout + proc.stderr)
+        except subprocess.SubprocessError as exc:
+            return CommandResult(text=f"  error: {exc}")
+
+    # Health
+    if cmd == "doctor":
+        return CommandResult(text=_run_omega("doctor"))
+    if cmd == "status":
+        return CommandResult(text=_run_omega("status"))
+
+    # Scrape
+    if cmd == "scrape":
+        if not rest:
+            return CommandResult(text="  usage: /scrape <url> [--engine scrapling]")
+        return CommandResult(text=_run_omega("scrape", *rest))
+
+    # Help
+    if cmd in ("help", "?"):
+        return CommandResult(text=(
+            "  SLASH COMMANDS\n"
+            "  ──────────────\n"
+            "    /aisb                    switch to AISB master chat (Max OAuth)\n"
+            "    /hermes                  switch to Hermès chat (Anthropic API)\n"
+            "    /switch <provider>       hot-swap LLM provider (Hermes-style)\n"
+            "    /mission \"<intent>\"      run a verified-completion mission\n"
+            "    /audit <id>              run a forensic audit (codeaudit, …)\n"
+            "    /genesis <slug>          start a new project via Genesis pipeline\n"
+            "    /scrape <url>            stealth scrape (CloakBrowser default)\n"
+            "    /scrape <url> --engine scrapling   fast scrape (Scrapling)\n"
+            "    /sessions                list active tmux sessions\n"
+            "    /accounts                list Claude Max account pool\n"
+            "    /vault [key]             vault status or read key\n"
+            "    /doctor                  full health check (omega doctor)\n"
+            "    /status                  task state (omega status)\n"
+            "    /detach                  detach from Omega tmux session\n"
+            "    /quit                    quit the TUI (kill Omega session)\n"
+            "    /help                    show this help\n"
+            "\n"
+            "  KEYBINDINGS\n"
+            "  ───────────\n"
+            "    /         focus the slash input\n"
+            "    ?         this help\n"
+            "    d         detach\n"
+            "    q         quit\n"
+            "    Tab       navigate categories"
+        ))
+
+    return CommandResult(text=(
+        f"  unknown command: /{cmd}\n"
+        f"  type /help for the list of commands"
+    ))
+
+
+# ---------------------------------------------------------------------------
+# The Textual app
+# ---------------------------------------------------------------------------
+
+
+if TEXTUAL_AVAILABLE:
+
+    class OmegaTUI(App):
+        """OmegaOS Textual TUI — the v0.19.27 control surface."""
+
+        CSS = """
+        Screen {
+            background: $background;
+        }
+        #sidebar {
+            width: 32;
+            border-right: tall $primary;
+            padding: 1 1;
+        }
+        #content {
+            padding: 1 2;
+        }
+        #slash {
+            border-top: tall $primary;
+            background: $surface;
+        }
+        Header {
+            background: $primary;
+            color: $text;
+        }
+        ListView > ListItem.--highlight {
+            background: $primary;
+            color: $text;
+        }
+        """
+
+        BINDINGS = [
+            Binding("q", "quit_omega", "Quit"),
+            Binding("d", "detach_omega", "Detach"),
+            Binding("question_mark", "help_omega", "Help"),
+            Binding("slash", "focus_slash", "Slash"),
+        ]
+
+        def __init__(self, *args: Any, **kwargs: Any) -> None:
+            super().__init__(*args, **kwargs)
+            self._content: RichLog | None = None
+            self._slash: Input | None = None
+
+        def compose(self) -> ComposeResult:
+            from omega_engine import __version__
+            yield Header(name=f"Ω  Omega OS v{__version__}", show_clock=True)
+            with Horizontal():
+                with Vertical(id="sidebar"):
+                    yield Label("Categories", id="sidebar-title")
+                    items = [ListItem(Label(name)) for _id, name in CATEGORIES]
+                    yield ListView(*items, id="cats")
+                with Vertical(id="content-wrap"):
+                    log = RichLog(id="content", highlight=True, markup=True,
+                                  wrap=True)
+                    self._content = log
+                    yield log
+            self._slash = Input(placeholder="Ω › type a slash command "
+                                "(/help for list, /quit to exit)",
+                                id="slash")
+            yield self._slash
+            yield Footer()
+
+        def on_mount(self) -> None:
+            self._write_welcome()
+            if self._slash:
+                self._slash.focus()
+
+        def _write_welcome(self) -> None:
+            if not self._content:
+                return
+            from omega_engine import __version__
+            self._content.write(
+                f"[bold #D97757]Ω  Omega OS v{__version__}[/]\n"
+                "Type /help to see all slash commands.\n"
+                "\n"
+                "Quick start:\n"
+                "  [bold]/aisb[/]                 chat with the AISB master agent\n"
+                "  [bold]/hermes[/]               chat with Hermès (Anthropic API)\n"
+                "  [bold]/switch[/]               see + hot-swap LLM provider\n"
+                "  [bold]/mission \"...\"[/]        run a verified-completion mission\n"
+                "  [bold]/scrape <url>[/]         stealth scrape via CloakBrowser\n"
+                "  [bold]/audit <id>[/]           run a Quality Arsenal audit\n"
+                "  [bold]/doctor[/]               full health check\n"
+                "\n"
+                "Click a category in the sidebar, or type a / command.\n"
+            )
+
+        def action_quit_omega(self) -> None:
+            subprocess.run(["tmux", "kill-session", "-t", "Omega"],
+                           capture_output=True)
+            self.exit()
+
+        def action_detach_omega(self) -> None:
+            subprocess.run(["tmux", "detach-client"], capture_output=True)
+            self.exit()
+
+        def action_help_omega(self) -> None:
+            res = dispatch_slash("/help")
+            if self._content:
+                self._content.write(res.text)
+
+        def action_focus_slash(self) -> None:
+            if self._slash:
+                self._slash.focus()
+
+        def on_list_view_selected(self, event: Any) -> None:
+            """User clicked a sidebar category — render that category's content."""
+            idx = event.list_view.index or 0
+            if idx >= len(CATEGORIES):
+                return
+            cat_id = CATEGORIES[idx][0]
+            self._render_category(cat_id)
+
+        def _render_category(self, cat_id: str) -> None:
+            if not self._content:
+                return
+            mapping = {
+                "chat":      "/help",       # show overall help — chat actions in help
+                "projects":  "/genesis",
+                "audits":    "/audit",
+                "missions":  "/help",
+                "sessions":  "/sessions",
+                "accounts":  "/accounts",
+                "vault":     "/vault",
+                "health":    "/doctor",
+                "scrape":    "/help",
+            }
+            cmd = mapping.get(cat_id, "/help")
+            res = dispatch_slash(cmd)
+            self._content.write(f"\n[bold #D97757]── {cat_id} ──[/]\n")
+            self._content.write(res.text)
+
+        def on_input_submitted(self, event: Any) -> None:
+            """User typed a slash command."""
+            value = event.value
+            if not value:
+                return
+            if self._content:
+                self._content.write(f"\n[bold #D97757]Ω ›[/] {value}\n")
+            res = dispatch_slash(value)
+            if event.input:
+                event.input.value = ""
+            if res.exit_tui:
+                self.action_quit_omega()
+                return
+            if res.detach:
+                self.action_detach_omega()
+                return
+            if res.text and self._content:
+                self._content.write(res.text)
+            if res.session_jump:
+                _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
+
+
+# ---------------------------------------------------------------------------
+# Plain REPL fallback (when textual isn't installed)
+# ---------------------------------------------------------------------------
+
+
+def _plain_repl() -> int:
+    """Slash-command REPL with no textual TUI — same command set."""
+    from omega_engine import __version__
+    print(f"\n  Ω  Omega OS v{__version__} — plain REPL mode")
+    print("  Type /help for commands, /quit to exit.\n")
+    while True:
+        try:
+            line = input("  Ω › ").strip()
+        except (EOFError, KeyboardInterrupt):
+            print()
+            return 0
+        if not line:
+            continue
+        res = dispatch_slash(line)
+        if res.exit_tui:
+            subprocess.run(["tmux", "kill-session", "-t", "Omega"],
+                           capture_output=True)
+            return 0
+        if res.detach:
+            subprocess.run(["tmux", "detach-client"], capture_output=True)
+            return 0
+        if res.text:
+            print()
+            for ln in res.text.splitlines():
+                print(f"  {ln}")
+            print()
+        if res.session_jump:
+            _switch_client(res.session_jump)

package/omega/Agentik_Engine/pyproject.toml

@@ -1,12 +1,13 @@
 [project]
 name = "omega-engine"
-version = "0.19.26"
+version = "0.19.28"
 description = "The Omega OS orchestration engine — event-sourced, verified-completion agent graphs."
 readme = "README.md"
 requires-python = ">=3.11"
 license = { text = "MIT" }
 dependencies = [
     "pyyaml>=6.0",
+    "textual>=1.0",
 ]
 
 [project.optional-dependencies]

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.26
+0.19.28

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.26",
+  "version": "0.19.28",
   "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"