@agentikos/omega-os 0.19.11 → 0.19.13

package/bootstrap/lib/common.sh

@@ -232,6 +232,38 @@ ask() {
 # UX — banner, preflight card, profile picker, step progress, post-install
 # ─────────────────────────────────────────────────────────────────────────────
 
+# NEWT_COLORS — whiptail palette in Claude theme. Without this, whiptail
+# defaults to the loud blue Windows-95 look. NEWT only knows 16 named
+# colors, so we map the Claude warm-light theme to the closest pairs:
+#   brown      ≈ #D97757  (Claude orange — used for accents)
+#   lightgray  ≈ off-white body text
+#   black      = backdrop (matches dark terminals)
+# This is exported into install.sh's env AND wired into the user's
+# shellrc by path_setup_user_rc so `omega` (the menu) also picks it up.
+export NEWT_COLORS='
+root=lightgray,black
+window=lightgray,black
+shadow=black,black
+title=brown,black
+border=brown,black
+textbox=lightgray,black
+listbox=lightgray,black
+sellistbox=black,brown
+actsellistbox=white,brown
+button=black,brown
+actbutton=white,brown
+compactbutton=brown,black
+checkbox=brown,black
+actcheckbox=white,brown
+entry=lightgray,black
+disentry=gray,black
+label=brown,black
+helpline=brown,black
+roottext=brown,black
+emptyscale=black,gray
+fullscale=brown,brown
+'
+
 if [ -t 1 ]; then
   C_BOLD=$'\033[1m'
   # Claude Code light theme — derived from tweakcn.com/r/themes/claude.json.
@@ -447,12 +479,17 @@ path_setup_user_rc() {
     return 0
   fi
   mkdir -p "$(dirname "$rc")"
+  # Build the NEWT_COLORS one-liner so the user's interactive `omega`
+  # menu uses the Claude theme too (orange accents, no Win-95 blue).
+  local newt_oneline
+  newt_oneline="$(printf '%s' "$NEWT_COLORS" | tr '\n' ':' | sed 's/^://;s/:$//')"
   if [ "$(basename "$rc")" = "config.fish" ]; then
     {
       echo ""
       echo "$marker"
       echo "set -gx OMEGA_HOME \"$OMEGA_HOME\""
       echo "set -gx PATH \"\$OMEGA_HOME/Agentik_Tools/bin\" \$PATH"
+      echo "set -gx NEWT_COLORS '$newt_oneline'"
       echo "$close"
     } >> "$rc"
   else
@@ -461,6 +498,7 @@ path_setup_user_rc() {
       echo "$marker"
       echo "export OMEGA_HOME=\"$OMEGA_HOME\""
       echo "export PATH=\"\$OMEGA_HOME/Agentik_Tools/bin:\$PATH\""
+      echo "export NEWT_COLORS='$newt_oneline'"
       echo "$close"
     } >> "$rc"
   fi
@@ -478,7 +516,12 @@ post_install_card() {
                 | python3 -c 'import sys,json
 try: d=json.load(sys.stdin); print(d.get("readiness","unknown"))
 except Exception: print("unknown")' 2>/dev/null)" || readiness="unknown"
-    case "${readiness,,}" in
+    # macOS ships Bash 3.2 (Apple won't update due to GPLv3) — no
+    # ${var,,} support. Use `tr` for the lowercase normalize so the
+    # installer works on Mac out of the box.
+    local readiness_lc
+    readiness_lc="$(printf '%s' "$readiness" | tr '[:upper:]' '[:lower:]')"
+    case "$readiness_lc" in
       ready)        verdict_text="READY"   ; verdict_color="$C_GREEN" ;;
       partial)      verdict_text="PARTIAL" ; verdict_color="$C_YELLOW" ;;
       not-ready|not_ready) verdict_text="NOT READY"; verdict_color="$C_RED" ;;

package/bootstrap/lib/steps.sh

@@ -448,7 +448,12 @@ PY
 step_mcp() {
   local catalog="$OMEGA_HOME/Agentik_SSOT/mcp/mcp-catalog.yaml"
   [ -f "$catalog" ] || { err "MCP catalog missing: $catalog"; return 1; }
-  info "MCP catalog present ($(grep -c '^- id:' "$catalog" 2>/dev/null || echo '?') entries)"
+  # grep -c exits 1 when count is 0, which made the old `|| echo '?'`
+  # fire AND grep's "0" stayed printed → "0\n? entries" splatter.
+  local _mcp_count
+  _mcp_count="$(grep -c '^- id:' "$catalog" 2>/dev/null || true)"
+  _mcp_count="$(printf '%s' "$_mcp_count" | tr -d '\n ' )"
+  info "MCP catalog present (${_mcp_count:-?} entries)"
 
   # Collect the selection into newline-separated $selected.
   local selected=""

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

package/omega/Agentik_Engine/omega_engine/aisb_chat.py

@@ -60,6 +60,49 @@ def _clear_history(home: Path) -> int:
         conn.close()
 
 
+def chat_once(home: Path, text: str, *,
+              topic_id: int = None,
+              record_history: bool = True) -> str:
+    """Run ONE conversation turn against the AISB envelope and return the
+    reply. Stateless from the caller's POV — history is persisted via
+    ``telegram_history`` keyed on ``topic_id`` (a single global default
+    for the tmux REPL; chat_id for Telegram DMs to keep per-user threads).
+
+    Extracted so the Telegram DM path can talk to the same agent the
+    tmux REPL talks to, without duplicating env+envelope+provider plumbing.
+    """
+    import time
+    from omega_engine.envelope import EnvelopeContext, build_envelope
+    from omega_engine.provider import AgentRequest
+    from omega_engine.router import ModelRouter
+    from omega_engine.telegram_history import (
+        build_context_prompt, record_inbound, record_outbound,
+    )
+    if topic_id is None:
+        topic_id = CHAT_TOPIC
+    if record_history:
+        record_inbound(home, topic_id=topic_id, text=text)
+    enriched = build_context_prompt(
+        home, topic_id=topic_id, new_intent=text, limit=10,
+    )
+    ctx = EnvelopeContext(
+        role="aisb",
+        intent=enriched,
+        task_id=f"chat-{int(time.time())}",
+    )
+    env = build_envelope(home, ctx)
+    router = ModelRouter.auto()
+    provider = router.resolve("aisb")
+    result = provider.run(AgentRequest(
+        role="aisb", prompt=env["user"], context={},
+        system=env["system"],
+    ))
+    reply = (result.text or "").strip() or "(empty reply)"
+    if record_history:
+        record_outbound(home, topic_id=topic_id, text=reply)
+    return reply
+
+
 def run_chat_loop() -> int:
     """Block until /quit. Returns 0 on clean exit."""
     home = _omega_home()

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -275,14 +275,21 @@ def cmd_doctor(args: argparse.Namespace) -> int:
     section("llm clis")
     import shutil as _shu
     import subprocess as _sup
-    _cli_specs = [
+    # CLI specs split into REQUIRED (Claude Code is the only one we hard-
+    # require — everything else is genuinely optional). Optional CLIs that
+    # aren't installed are reported as ``info``, NOT ``warn``, so they no
+    # longer drag a clean install down to PARTIAL when the user opted out.
+    _required_clis = [
         ("claude_code", "claude", ["claude", "--version"]),
+    ]
+    _optional_clis = [
         ("gemini_cli",  "gemini", ["gemini", "--version"]),
         ("codex",       "codex",  ["codex", "--version"]),
         ("aider",       "aider",  ["aider", "--version"]),
     ]
     any_cli = False
-    for cli_id, bin_name, ver_cmd in _cli_specs:
+    for cli_id, bin_name, ver_cmd in _required_clis + _optional_clis:
+        is_optional = (cli_id, bin_name, ver_cmd) in _optional_clis
         if _shu.which(bin_name):
             any_cli = True
             try:
@@ -293,16 +300,21 @@ def cmd_doctor(args: argparse.Namespace) -> int:
                 v = "(version check failed)"
             line("ok", f"{cli_id:<14} {v}")
         else:
-            line("warn", f"{cli_id:<14} (not on PATH)")
-    # GLM SDK is a Python import, not a binary
+            line("info" if is_optional else "warn",
+                 f"{cli_id:<14} (not on PATH{', optional' if is_optional else ''})")
+    # GLM SDK is a Python import — also OPTIONAL (only used when the user
+    # opts into a GLM provider; flagging it as warn every install is wrong).
     try:
         import importlib
         importlib.import_module("zhipuai")
         line("ok", "glm_sdk        (zhipuai Python SDK importable)")
         any_cli = True
     except ImportError:
-        line("warn", "glm_sdk        (not installed — `uv tool install zhipuai`)")
+        line("info", "glm_sdk        (not installed, optional — "
+             "`uv tool install zhipuai`)")
     if not any_cli:
+        # Only flag PARTIAL when literally ZERO LLM CLI is present — at
+        # that point the system has no model to talk to.
         line("warn", "no LLM CLI installed — `omega upgrade` or re-run "
              "install.sh with the llm_clis: block")
 
@@ -324,12 +336,29 @@ def cmd_doctor(args: argparse.Namespace) -> int:
             line("ok" if dm == "bypassPermissions" else "warn",
                  f"permissions.defaultMode: {dm or 'default'}")
             stop_hooks = (data.get("hooks") or {}).get("Stop") or []
+            # Accept the gate as wired if EITHER the `tag` is still ours
+            # OR ANY Stop hook commands `omega audit gate` (Claude Code
+            # may strip the custom `tag` field on its own rewrites of the
+            # settings file — content match is more resilient).
+            def _is_gate(entry: dict) -> bool:
+                if entry.get("tag") == "omega-audit-gate":
+                    return True
+                for h in (entry.get("hooks") or []):
+                    if not isinstance(h, dict):
+                        continue
+                    cmd = h.get("command", "")
+                    args = h.get("args") or []
+                    if cmd.endswith("/omega") and "gate" in args:
+                        return True
+                return False
             has_gate = any(
-                isinstance(e, dict) and e.get("tag") == "omega-audit-gate"
-                for e in stop_hooks
+                isinstance(e, dict) and _is_gate(e) for e in stop_hooks
             )
-            line("ok" if has_gate else "warn",
-                 f"Stop-hook audit gate: {'wired' if has_gate else 'not wired'}")
+            # Demoted to "info" when missing — the gate is an
+            # opt-in safety net, not a hard requirement. Doctor no
+            # longer drops to PARTIAL just because the hook isn't there.
+            line("ok" if has_gate else "info",
+                 f"Stop-hook audit gate: {'wired' if has_gate else 'not wired (optional)'}")
         except Exception as exc:  # noqa: BLE001
             line("warn", f"settings.json unreadable: {exc}")
 

package/omega/Agentik_Engine/omega_engine/daemons/telegram.py

@@ -153,33 +153,46 @@ def _route_one(
     """
     from omega_engine import telegram_history
 
-    # DM (no topic) — log it, refuse to start a mission. AISB DM
-    # is NOT where the orchestration runs; it's where the operator
-    # talks to the bot 1:1. The mission must run inside a project topic.
+    # DM (no topic) — route to the AISB conversational agent (same one
+    # the tmux REPL talks to). This used to refuse with "Missions only
+    # run from a project topic" which broke the most basic UX (a fresh
+    # install has no group topic yet, so the bot was effectively dead).
+    #
+    # Per-chat conversation history is namespaced by chat_id (encoded
+    # as a negative topic_id to avoid collisions with real Telegram
+    # forum topics, which are always positive small integers).
     if topic_id is None:
-        # We still record DM history so the operator's question + the
-        # bot's eventual reply (handled elsewhere) are linked.
+        dm_topic = -abs(int(chat_id)) if chat_id is not None else 0
         telegram_history.record_inbound(
-            home, topic_id=0, text=text, message_id=message_id,
+            home, topic_id=dm_topic, text=text, message_id=message_id,
         )
         logger.info(
-            "telegram in: DM (chat=%s) text=%r — refusing to start a "
-            "mission from the DM; ask in a project topic instead",
+            "telegram in: DM (chat=%s) text=%r — routing to AISB chat",
             chat_id, text[:80],
         )
+        try:
+            from omega_engine.aisb_chat import chat_once
+            reply = chat_once(home, text, topic_id=dm_topic,
+                              record_history=False)
+        except Exception as exc:  # noqa: BLE001
+            logger.warning("telegram DM: chat_once failed",
+                           exc_info=True)
+            reply = (
+                f"I hit an error talking to the AISB agent: {exc}\n"
+                "Check `omega doctor` for provider/account status."
+            )
+        telegram_history.record_outbound(
+            home, topic_id=dm_topic, text=reply,
+        )
         if telegram_bridge is not None and chat_id is not None:
             try:
                 telegram_bridge._call("sendMessage", {  # noqa: SLF001
                     "chat_id": str(chat_id),
-                    "text": (
-                        "Missions only run from a project topic in the "
-                        "OmegaOS group — not the DM. Open the topic for "
-                        "the project and re-send your request there."
-                    ),
+                    "text": reply[:3900],
                 })
             except Exception:  # noqa: BLE001
                 logger.warning("telegram daemon: DM reply failed", exc_info=True)
-        return "dm:refused"
+        return "dm:aisb-chat"
 
     # Topic message — record + route.
     telegram_history.record_inbound(

package/omega/Agentik_Engine/omega_engine/genesis/stack.py

@@ -176,6 +176,35 @@ def _backend_supabase_stack() -> Stack:
     )
 
 
+def _claude_dashboard_stack() -> Stack:
+    """The Claude Code-grade premium dashboard stack.
+
+    Picks up the architecture contract from
+    ``Agentik_SSOT/docs/references/CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md``
+    during PRD + branding + design-system phases. Worker prompts include
+    the `/desktop-architecture` skill so every generated component traces
+    back to the same reference doc.
+    """
+    return Stack(
+        id="claude-dashboard",
+        title="Claude-grade premium dashboard (Next.js + Convex + shadcn + Motion + references doc)",
+        config=StackConfig(
+            type="web",
+            frontend="nextjs",
+            backend="convex",
+            deploy="vercel",
+            payments="stripe",
+            ui_kit="shadcn",
+            auth="clerk",
+            extras=["desktop-architecture-reference"],
+        ),
+        why="When the operator wants the Claude / Linear / Vercel / Stripe / "
+            "Elevenlabs dashboard look. Genesis phases pull from "
+            "Agentik_SSOT/docs/references/CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md "
+            "as the single source of design truth.",
+    )
+
+
 CANONICAL_STACKS: dict[str, Stack] = {
     s.id: s for s in (
         default_stack(),
@@ -183,6 +212,7 @@ CANONICAL_STACKS: dict[str, Stack] = {
         _mobile_cross_stack(),
         _desktop_tauri_stack(),
         _backend_supabase_stack(),
+        _claude_dashboard_stack(),
     )
 }
 

package/omega/Agentik_Engine/pyproject.toml

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

package/omega/Agentik_Engine/tests/test_install_steps.py

@@ -319,7 +319,10 @@ class TestDoctorJSON(unittest.TestCase):
                 self.assertIn("section", r)
                 self.assertIn("status", r)
                 self.assertIn("msg", r)
-                self.assertIn(r["status"], {"ok", "warn", "FAIL"})
+                # "info" added in v0.19.12 for genuinely optional checks
+                # that should not drag READY → PARTIAL (e.g. optional
+                # LLM CLIs the user did not opt into).
+                self.assertIn(r["status"], {"ok", "warn", "FAIL", "info"})
 
 
 class TestInstallerWiring(unittest.TestCase):

package/omega/Agentik_Engine/tests/test_telegram_history.py

@@ -142,10 +142,15 @@ class TestTopicStats(unittest.TestCase):
             self.assertEqual(by_topic[2]["messages"], 1)
 
 
-class TestDaemonDMRefusal(unittest.TestCase):
-    """The daemon must refuse to start a mission from a DM."""
-    def test_dm_message_is_refused(self):
-        from omega_engine.daemons.telegram import _route_one
+class TestDaemonDMRoutesToAISBChat(unittest.TestCase):
+    """The daemon now routes DMs to the AISB conversational agent
+    (v0.19.13 change). Previously it refused with "project topic only",
+    which made the bot mute on a fresh install with no group yet."""
+
+    def test_dm_message_routes_to_aisb_chat(self):
+        from omega_engine.daemons import telegram as T
+        from omega_engine import aisb_chat
+        from unittest import mock
 
         class _FakeBridge:
             def __init__(self):
@@ -161,22 +166,65 @@ class TestDaemonDMRefusal(unittest.TestCase):
         with tempfile.TemporaryDirectory() as td:
             home = Path(td)
             bridge = _FakeBridge()
-            tag = _route_one(
-                topic_id=None, text="hi from DM",
-                message_id=5, chat_id=12345,
-                supervisor=_FakeSupervisor(),
-                project_map={},
-                home=home,
-                telegram_bridge=bridge,
-            )
-            self.assertEqual(tag, "dm:refused")
-            # We replied to the user with the redirect message.
+            with mock.patch.object(aisb_chat, "chat_once",
+                                   return_value="hello from AISB"):
+                tag = T._route_one(
+                    topic_id=None, text="hi from DM",
+                    message_id=5, chat_id=12345,
+                    supervisor=_FakeSupervisor(),
+                    project_map={},
+                    home=home,
+                    telegram_bridge=bridge,
+                )
+            self.assertEqual(tag, "dm:aisb-chat",
+                "DM must now be tagged as routed to AISB, not refused")
+            # We sent the AISB reply back via sendMessage.
             self.assertEqual(len(bridge.calls), 1)
             self.assertEqual(bridge.calls[0]["method"], "sendMessage")
             self.assertEqual(
                 str(bridge.calls[0]["fields"]["chat_id"]), "12345",
             )
-            self.assertIn("project topic", bridge.calls[0]["fields"]["text"])
+            self.assertEqual(
+                bridge.calls[0]["fields"]["text"], "hello from AISB",
+            )
+
+    def test_dm_history_is_namespaced_by_chat_id(self):
+        """Two DMs from different chats must NOT cross-contaminate history.
+        We use negative topic_ids derived from chat_id (real topics are
+        always positive Telegram forum thread IDs)."""
+        from omega_engine.daemons import telegram as T
+        from omega_engine import aisb_chat
+        from unittest import mock
+
+        class _FakeBridge:
+            def __init__(self): self.calls = []
+            def _call(self, method, fields, **_kw):
+                self.calls.append({"method": method, "fields": fields})
+                return {"message_id": 1}
+
+        class _FakeSupervisor:
+            def on_channel_message(self, t, x): return []
+
+        with tempfile.TemporaryDirectory() as td:
+            home = Path(td)
+            (home / "Agentik_Runtime").mkdir(parents=True)
+            captured: list[int] = []
+            def _fake_chat(home_arg, text, *, topic_id, record_history):
+                captured.append(topic_id)
+                return "ok"
+            with mock.patch.object(aisb_chat, "chat_once",
+                                   side_effect=_fake_chat):
+                T._route_one(topic_id=None, text="hi", message_id=1,
+                             chat_id=42, supervisor=_FakeSupervisor(),
+                             project_map={}, home=home,
+                             telegram_bridge=_FakeBridge())
+                T._route_one(topic_id=None, text="hi", message_id=2,
+                             chat_id=99, supervisor=_FakeSupervisor(),
+                             project_map={}, home=home,
+                             telegram_bridge=_FakeBridge())
+            self.assertEqual(captured, [-42, -99],
+                "DM history must be namespaced by chat_id "
+                "(encoded as negative topic_id)")
 
     def test_topic_message_records_history(self):
         from omega_engine.daemons.telegram import _route_one

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.11
+0.19.13

package/omega/Agentik_SSOT/docs/references/README.md

@@ -0,0 +1,17 @@
+# References
+
+Operator-curated source-of-truth documents that OmegaOS skills + Genesis
+consume by name. Drop a new version of any file here and it propagates
+to every project at the next `omega sync`.
+
+## Active references
+
+| File | Consumed by | Topic |
+|---|---|---|
+| `CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md` | `/desktop-architecture`, Genesis stack `claude-dashboard`, refonte audit | Premium desktop / dashboard UI architecture, the "Claude / Linear / Vercel / Stripe / Elevenlabs" canon |
+
+## Format
+
+Plain Markdown. No frontmatter needed — these are reference docs, not
+SKILL.md. Headings should be self-describing so skills can extract
+sub-sections by regex if needed.

package/omega/Agentik_SSOT/skills/desktop-architecture/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: desktop-architecture
+description: >
+  Reference skill — pull the canonical Claude Code-grade desktop/dashboard
+  architecture (`Agentik_SSOT/docs/references/CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md`)
+  and apply it to a project. Triggers on "desktop architecture", "Claude
+  dashboard", "Claude desktop", "premium dashboard", "comme Linear / Vercel
+  / Stripe / Elevenlabs", "dashboard senior", "claude stack". Use whenever
+  the user asks for a dashboard refonte or a new project that needs the
+  Claude-grade desktop look.
+when_to_use: >
+  User mentions "desktop architecture", "Claude dashboard", "Claude desktop
+  stack", or asks for a dashboard rebuild "comme Claude / Linear / Vercel /
+  Stripe / Elevenlabs". Also triggers automatically when the Genesis stack
+  picker selects the `claude-dashboard` preset.
+allowed-tools: Read Grep Glob
+---
+
+# /desktop-architecture — pull the canonical Claude dashboard reference
+
+This skill loads the **Claude Desktop Frontend Architecture** reference
+document from the SSOT and applies its principles to the current task.
+
+## What it does
+
+1. Reads `$OMEGA_HOME/Agentik_SSOT/docs/references/CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md`
+2. Extracts the relevant section (components, layout, motion, palette,
+   typography, density, navigation, command palette, etc.)
+3. Applies it as the design contract for the requested task:
+   - **Refonte audit** — score the current UI against this contract
+   - **Genesis** — when stack = `claude-dashboard`, the PRD, branding and
+     design-system phases derive their tokens from this doc
+   - **Component builder** — when a worker generates a new dashboard
+     screen, it references the layout primitives from this doc first
+
+## Triggers (any of these in a user prompt invoke me)
+
+- `desktop architecture`
+- `Claude desktop` / `Claude dashboard` / `Claude stack`
+- `premium dashboard` / `dashboard senior`
+- `comme Linear` / `comme Vercel` / `comme Stripe` / `comme Elevenlabs`
+- `refais le dashboard` / `redesign dashboard` (combined with project name)
+
+## Where it lives
+
+The reference doc itself lives at:
+`$OMEGA_HOME/Agentik_SSOT/docs/references/CLAUDE-DESKTOP-FRONTEND-ARCHITECTURE.md`
+
+It's the single source of truth — when Gareth refreshes the document
+(e.g. new components, new motion language), every project re-reads it
+on next `/desktop-architecture` invocation. No fork, no drift.
+
+## How to refresh the reference
+
+The operator drops a new version into the SSOT path above, then runs:
+
+```bash
+omega sync     # projects to ~/.claude/skills/<id>/
+```
+
+Workers spawned after the sync pick up the new content automatically.

package/package.json

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