@agentikos/omega-os 0.19.37 → 0.19.39

package/bin/omega-os.js

@@ -36,7 +36,12 @@ console.log("  Omega OS — npx bootstrap");
 console.log("  -> handing off to install.sh");
 console.log("");
 
-const args = process.argv.slice(2);
+// Drop the literal `--` separator if npx/npm forwarded it. Without this,
+// `npx -y @agentikos/omega-os@latest -- --full` lands in install.sh as
+// `install.sh -- --full`, and the case-block rejects the unknown `--`.
+const rawArgs = process.argv.slice(2);
+const args = rawArgs.filter((a) => a !== "--");
+
 const result = spawnSync("bash", [installer, ...args], {
   stdio: "inherit",
   cwd: pkgRoot,

package/bootstrap/lib/steps.sh

@@ -461,6 +461,49 @@ PY
   return $?
 }
 
+# --- 38 -----------------------------------------------------------------------
+#
+# step_personas — seed the canonical OmegaOS context + every LLM's
+# expected filename for both chat sessions.
+#
+# Without this step, the canonical OMEGAOS-CONTEXT.md and the per-LLM
+# persona files (CLAUDE.md / GEMINI.md / AGENTS.md / QWEN.md /
+# .opencode/CONTEXT.md / .continue/CONTEXT.md / CONVENTIONS.md /
+# HERMES.md) only land the FIRST time the user spawns AISB-chat or
+# Hermès-chat. Eager seeding lets the operator inspect + edit the
+# canonical at install time and guarantees `omega doctor` sees every
+# persona file before the first session.
+#
+# Idempotent — re-runs only write files whose content actually differs
+# from the canonical.
+step_personas() {
+  PYTHONPATH="$OMEGA_HOME/Agentik_Engine" python3 - <<PY 2>>"$LOG_FILE"
+import os
+from pathlib import Path
+os.environ["OMEGA_HOME"] = "$OMEGA_HOME"
+home = Path("$OMEGA_HOME")
+from omega_engine.personas import (
+    ensure_canonical, write_all_personas, canonical_path, supported_llm_ids,
+)
+
+src = ensure_canonical(home)
+print(f"  canonical: {src.relative_to(home)} ({src.stat().st_size} bytes)")
+
+# Mirror to BOTH chat-context dirs so every LLM has its persona ready
+# from day one — no first-spawn lazy materialization.
+for label in ("aisb-master", "hermes"):
+    ctx = home / "Agentik_Coding" / "chat-contexts" / label
+    written = write_all_personas(home, ctx)
+    # Count EVERY persona file (root + subdir like .opencode/CONTEXT.md).
+    files = sorted(str(p.relative_to(ctx))
+                   for p in ctx.rglob("*.md"))
+    print(f"  {label}/: {len(files)} persona files ({', '.join(files)})")
+
+print(f"  supported LLMs: {len(supported_llm_ids())}")
+PY
+  return $?
+}
+
 # --- 40 -----------------------------------------------------------------------
 #
 # step_clis — install system CLIs + Printing Press CLI library.

package/install.sh

@@ -62,6 +62,10 @@ while [ $# -gt 0 ]; do
       fi
       ;;
     -h|--help)         awk 'NR==1 && /^#!/ {next} /^#/ {sub(/^#[ ]?/, ""); print; next} {exit}' "$0"; exit 0 ;;
+    # Accept the literal `--` separator as a no-op so recipes like
+    # `npx -y @agentikos/omega-os@latest -- --full` survive even if the
+    # JS launcher's filter is bypassed.
+    --)                shift ;;
     *)                 die "unknown argument: $1" ;;
   esac
 done
@@ -182,6 +186,7 @@ STEPS=(
   "35-providers:step_providers"
   "36-tmux-config:step_tmux_config"
   "37-hermes-brief:step_hermes_brief"
+  "38-personas:step_personas"
   # v0.19.21 — MCP install dropped from the default sequence. MCPs are
   # token-expensive (each call pays the protocol round-trip + the
   # server's system prompt overhead). We replace with system CLIs +

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

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -440,6 +440,79 @@ def cmd_doctor(args: argparse.Namespace) -> int:
     except Exception as exc:  # noqa: BLE001
         line("FAIL", f"agent suite check failed: {exc}")
 
+    # 7a-bis. Multi-LLM personas — canonical + per-LLM mirrors for the
+    # two chat contexts (AISB-master + Hermès). Step 38-personas should
+    # have materialized these at install time; if they're missing the
+    # user can re-run `omega menu-tui` → "Re-seed personas".
+    section("personas")
+    try:
+        from omega_engine.personas import canonical_path, supported_llm_ids
+        canon = canonical_path(home)
+        if canon.exists():
+            line("ok", f"canonical: {canon.relative_to(home)} ({canon.stat().st_size}B)")
+        else:
+            line("warn",
+                 f"canonical missing at {canon.relative_to(home)} — "
+                 "spawn AISB-chat once or re-run install step 38-personas")
+        # Each chat context should have at least one persona file per LLM
+        # subgroup. We count both root *.md and subdir CONTEXT.md.
+        for label in ("aisb-master", "hermes"):
+            ctx = home / "Agentik_Coding" / "chat-contexts" / label
+            if not ctx.is_dir():
+                line("warn", f"chat-contexts/{label}/ not seeded yet")
+                continue
+            files = sorted(p.relative_to(ctx).as_posix()
+                           for p in ctx.rglob("*.md") if p.is_file())
+            if files:
+                line("ok",
+                     f"chat-contexts/{label}/: {len(files)} persona file(s) "
+                     f"({', '.join(files[:4])}{'...' if len(files) > 4 else ''})")
+            else:
+                line("warn",
+                     f"chat-contexts/{label}/ exists but has no persona files")
+        line("ok", f"supported LLM persona ids: {len(supported_llm_ids())}")
+    except Exception as exc:  # noqa: BLE001
+        line("FAIL", f"personas check failed: {exc}")
+
+    # 7c. Prompt audit — each AISB role's prompt must reference the
+    # Three Laws + LMC protocol + done.json contract. Otherwise the
+    # agent runs blind and orchestration breaks at the first dispatch.
+    section("prompts")
+    try:
+        from omega_engine.prompt_audit import audit_aisb_suite
+        rep = audit_aisb_suite(home)
+        if not rep.per_agent:
+            line("warn", "no AISB prompts found — step 25-aisb-suite may have been skipped")
+        else:
+            for r in rep.per_agent:
+                status = "ok" if r.score >= 80 else ("warn" if r.score >= 60 else "FAIL")
+                line(status, f"{r.agent_id}: {r.score}/100"
+                     + (f" — missing: {', '.join(r.violations[:2])}" if r.violations else ""))
+            avg_status = "ok" if rep.average_score >= 80 else "warn"
+            line(avg_status, f"average suite score: {rep.average_score:.1f}/100")
+            if rep.missing_critical:
+                line("warn", f"weak prompts (<60): {', '.join(rep.missing_critical)}")
+    except Exception as exc:  # noqa: BLE001
+        line("FAIL", f"prompt audit failed: {exc}")
+
+    # 7d. Orchestration chain — AISB → Oracle → Worker → Checker must
+    # all be wired and share the LMC protocol vocabulary.
+    section("orchestration")
+    try:
+        from omega_engine.prompt_audit import orchestration_health
+        oh = orchestration_health(home)
+        for k, v in (("aisb_master_present", "AISB master prompt"),
+                     ("oracle_present", "Oracle role prompt"),
+                     ("workers_role_present", "Worker-class prompts"),
+                     ("checker_present", "Checker prompts (Seraph/Smith)"),
+                     ("lmc_protocol_present", "LMC protocol document")):
+            line("ok" if oh.get(k) else "warn", v)
+        overlap = oh.get("shared_vocab_overlap", 0.0)
+        line("ok" if overlap >= 0.6 else "warn",
+             f"shared `.done.json` vocab: {overlap*100:.0f}% of agents")
+    except Exception as exc:  # noqa: BLE001
+        line("FAIL", f"orchestration check failed: {exc}")
+
     # 7b. Per-project vaults
     section("project vaults")
     try:

package/omega/Agentik_Engine/omega_engine/paperclip_bridge.py

@@ -26,6 +26,7 @@ from __future__ import annotations
 import json
 import os
 import shutil
+import socket
 import subprocess
 import time
 from dataclasses import asdict, dataclass, field
@@ -584,3 +585,112 @@ def start_server(bind: str = "loopback", *, detach: bool = True) -> int:
         )
         return proc.pid
     return subprocess.call(args)
+
+
+# ---------------------------------------------------------------------------
+# Live status probe — is the Paperclip dashboard actually running?
+# ---------------------------------------------------------------------------
+
+
+@dataclass
+class PaperclipStatus:
+    """Snapshot of whether the Paperclip dashboard daemon is alive.
+
+    Consumed by the TUI to render ●/○ next to Paperclip menu items so the
+    operator can tell at a glance whether the dashboard is reachable.
+    """
+
+    running: bool
+    pid: int | None         # process PID if alive (None for port-scan hits)
+    port: int | None        # port the dashboard listens on (8080 default)
+    url: str | None         # http://host:port if running, else None
+    detection: str          # "pidfile" | "port-scan" | "none"
+
+
+def is_running(omega_home: Path | str | None = None,
+               *,
+               port: int = 8080,
+               host: str = "127.0.0.1") -> PaperclipStatus:
+    """Probe the Paperclip daemon — running or not?
+
+    Detection strategy (cheap → expensive, returns on first hit):
+      1. Read ``$PAPERCLIP_HOME/run/dashboard.pid`` (default ``~/.paperclip``).
+         If file exists AND ``os.kill(pid, 0)`` succeeds → running.
+      2. Else try TCP connect to ``<host>:<port>`` with a 0.2s timeout.
+         If accept → running but no pidfile (caller may warn).
+      3. Else → not running.
+
+    Never raises. Never blocks more than ~0.3s total.
+
+    Args:
+        omega_home: Accepted for API symmetry with the rest of the bridge;
+            the actual pidfile lives under ``$PAPERCLIP_HOME`` (resolved
+            via :func:`paperclip_home`), not under ``$OMEGA_HOME``.
+        port: TCP port to probe in the fallback path. Default 8080.
+        host: Loopback host to probe. Default 127.0.0.1.
+
+    Returns:
+        :class:`PaperclipStatus` — never None.
+    """
+    del omega_home  # signature consistency only; pidfile lives under PAPERCLIP_HOME
+
+    # ---- 1. Pidfile check (cheapest) -----------------------------------
+    pidfile = paperclip_home() / "run" / "dashboard.pid"
+    if pidfile.exists():
+        try:
+            pid_text = pidfile.read_text().strip()
+            pid = int(pid_text)
+        except (OSError, ValueError):
+            pid = None
+        if pid is not None and pid > 0:
+            alive = False
+            try:
+                os.kill(pid, 0)
+                alive = True
+            except ProcessLookupError:
+                alive = False
+            except PermissionError:
+                # PID exists but is owned by another user — still proves
+                # SOMETHING is alive at that PID, so treat as running.
+                alive = True
+            except OSError:
+                alive = False
+            if alive:
+                return PaperclipStatus(
+                    running=True,
+                    pid=pid,
+                    port=port,
+                    url=f"http://localhost:{port}",
+                    detection="pidfile",
+                )
+            # Stale pidfile — fall through to port scan.
+
+    # ---- 2. Port scan fallback (~0.2s) ---------------------------------
+    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+    try:
+        sock.settimeout(0.2)
+        try:
+            sock.connect((host, port))
+            return PaperclipStatus(
+                running=True,
+                pid=None,
+                port=port,
+                url=f"http://localhost:{port}",
+                detection="port-scan",
+            )
+        except (OSError, socket.timeout):
+            pass
+    finally:
+        try:
+            sock.close()
+        except OSError:
+            pass
+
+    # ---- 3. Not running -------------------------------------------------
+    return PaperclipStatus(
+        running=False,
+        pid=None,
+        port=None,
+        url=None,
+        detection="none",
+    )