@agentikos/omega-os 0.19.37 → 0.19.38

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.38"
 
 __all__ = [
     "__version__",

package/omega/Agentik_Engine/omega_engine/cli.py

@@ -440,6 +440,40 @@ 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}")
+
     # 7b. Per-project vaults
     section("project vaults")
     try:

package/omega/Agentik_Engine/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "omega-engine"
-version = "0.19.37"
+version = "0.19.38"
 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_installer_wiring.py

@@ -48,6 +48,7 @@ class TestInstallerStepList(unittest.TestCase):
         # name (the human label) → step function name
         ("36-tmux-config",   "step_tmux_config"),
         ("37-hermes-brief",  "step_hermes_brief"),
+        ("38-personas",      "step_personas"),
         ("59-hermes-session", "step_hermes_session"),
     ]
 
@@ -497,5 +498,134 @@ class TestPostInstallCardSurfacesEntryPoints(unittest.TestCase):
         self.assertIn("tmux", text)
 
 
+# ---------------------------------------------------------------------------
+# step_personas (v0.19.38) — eagerly seeds canonical OMEGAOS-CONTEXT.md +
+# every LLM's expected persona filename for AISB-master + Hermès chats,
+# so the user does NOT have to spawn a chat once before personas exist.
+# ---------------------------------------------------------------------------
+
+
+class TestStepPersonasBehavior(unittest.TestCase):
+    """Without this step, personas materialize lazily on first chat spawn —
+    `omega doctor` shows them missing and the operator can't pre-edit the
+    canonical. This locks in eager seeding."""
+
+    def test_personas_land_in_both_chat_contexts(self):
+        with tempfile.TemporaryDirectory() as tmp:
+            home = Path(tmp) / "Omega"
+            home.mkdir()
+            # Mirror the engine into OMEGA_HOME the way step_structure does.
+            engine_src = REPO_ROOT / "omega" / "Agentik_Engine"
+            engine_dst = home / "Agentik_Engine"
+            engine_dst.mkdir()
+            for entry in engine_src.iterdir():
+                if entry.name in {"tests", "__pycache__"}:
+                    continue
+                if entry.is_dir():
+                    import shutil
+                    shutil.copytree(entry, engine_dst / entry.name)
+                else:
+                    (engine_dst / entry.name).write_bytes(entry.read_bytes())
+
+            old_home = os.environ.get("OMEGA_HOME")
+            os.environ["OMEGA_HOME"] = str(home)
+            sys.path.insert(0, str(engine_dst))
+            try:
+                # Reload the engine modules under the new OMEGA_HOME.
+                import importlib
+                import omega_engine.personas as P
+                importlib.reload(P)
+
+                # Mirror what step_personas does (the heredoc body).
+                P.ensure_canonical(home)
+                for label in ("aisb-master", "hermes"):
+                    ctx = home / "Agentik_Coding" / "chat-contexts" / label
+                    P.write_all_personas(home, ctx)
+            finally:
+                if old_home is None:
+                    os.environ.pop("OMEGA_HOME", None)
+                else:
+                    os.environ["OMEGA_HOME"] = old_home
+                sys.path.remove(str(engine_dst))
+
+            # Canonical lands at the SSOT path.
+            canon = home / "Agentik_SSOT" / "personas" / "OMEGAOS-CONTEXT.md"
+            self.assertTrue(canon.is_file(),
+                f"canonical must exist at {canon} — operator must be able "
+                "to edit it BEFORE the first chat spawn")
+            self.assertGreater(canon.stat().st_size, 500,
+                "canonical context looks suspiciously small")
+
+            # Per-LLM mirrors land in BOTH chat contexts.
+            for label in ("aisb-master", "hermes"):
+                ctx = home / "Agentik_Coding" / "chat-contexts" / label
+                for fname in ("CLAUDE.md", "GEMINI.md", "AGENTS.md",
+                              "QWEN.md", "HERMES.md", "CONVENTIONS.md"):
+                    self.assertTrue((ctx / fname).is_file(),
+                        f"missing {ctx}/{fname} — chat context not fully seeded")
+                # Subdir personas (.opencode shared by opencode/openrouter/deepseek).
+                self.assertTrue((ctx / ".opencode" / "CONTEXT.md").is_file(),
+                    f"missing .opencode/CONTEXT.md in {ctx}")
+                self.assertTrue((ctx / ".continue" / "CONTEXT.md").is_file(),
+                    f"missing .continue/CONTEXT.md in {ctx}")
+
+    def test_step_personas_heredoc_calls_required_helpers(self):
+        """Lock in the heredoc body — if someone renames or removes
+        ensure_canonical / write_all_personas the step still has to call
+        them or the install silently stops seeding."""
+        body = STEPS_SH.read_text()
+        m = re.search(r"^step_personas\(\) \{(.+?)^\}", body,
+                      re.DOTALL | re.MULTILINE)
+        self.assertIsNotNone(m, "step_personas function not found in steps.sh")
+        fn_body = m.group(1)
+        for name in ("ensure_canonical", "write_all_personas"):
+            self.assertIn(name, fn_body,
+                f"step_personas must call {name}() — without it the install "
+                "stops seeding personas")
+        for label in ("aisb-master", "hermes"):
+            self.assertIn(label, fn_body,
+                f"step_personas must seed chat-contexts/{label}/")
+
+
+# ---------------------------------------------------------------------------
+# v0.19.38 — `--` separator must NOT raise "unknown argument".
+# Repro: `npx -y @agentikos/omega-os@latest -- --full` lands in install.sh
+# as `install.sh -- --full`, and the case-block used to reject `--`.
+# ---------------------------------------------------------------------------
+
+
+class TestDashDashSeparatorAccepted(unittest.TestCase):
+    """Two layers must accept `--`:
+       1. bin/omega-os.js strips it before exec'ing bash.
+       2. install.sh accepts it as a no-op as defense-in-depth."""
+
+    def test_install_sh_has_dash_dash_no_op_case(self):
+        if not INSTALL_SH.is_file():
+            self.skipTest("install.sh not in repo")
+        text = INSTALL_SH.read_text()
+        # The case-block must explicitly match `--`. Use re.search with
+        # MULTILINE so `^` matches each line start.
+        self.assertTrue(
+            re.search(r"^\s*--\)\s+shift\s*;;", text, re.MULTILINE),
+            "install.sh must accept `--` as a no-op — without it "
+            "`bash install.sh -- --full` dies with `unknown argument: --`")
+
+    def test_bin_launcher_filters_dash_dash(self):
+        bin_js = REPO_ROOT / "bin" / "omega-os.js"
+        if not bin_js.is_file():
+            self.skipTest("bin/omega-os.js not in repo")
+        text = bin_js.read_text()
+        # The filter must drop the literal `--` so the bash installer's
+        # case-block isn't even reached for the npx-injected separator.
+        # Match `.filter(...)` containing the literal "--" on the same line.
+        # Use DOTALL-free single-line scan, just look for the two anchors
+        # together: `.filter(` and `"--"` within ~80 chars.
+        self.assertTrue(
+            re.search(r'\.filter\(.{0,80}"--"', text),
+            "bin/omega-os.js must filter the `--` separator out of argv "
+            "before passing to install.sh — pattern `.filter(... \"--\")` "
+            "not found")
+
+
 if __name__ == "__main__":
     unittest.main()

package/omega/Agentik_SSOT/VERSION

@@ -1 +1 @@
-0.19.37
+0.19.38

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

@@ -0,0 +1,90 @@
+# OmegaOS v0.19.38 — multi-LLM persona seeding + `--` argument fix
+
+> Run 2026-05-25, post-v0.19.37 (fzf indexed matching + Paperclip menu).
+> Two surgical fixes, both fully tested.
+
+## 1. The two issues fixed
+
+| # | Bug | Trigger | Root cause | Fix |
+|---|---|---|---|---|
+| 1 | `!! unknown argument: --` | `npx -y @agentikos/omega-os@latest -- --full` | `bin/omega-os.js` forwarded `--` raw → `install.sh` case-block had no `--)` arm | (a) launcher filters `--` from argv, (b) install.sh accepts `--` as a no-op (defense-in-depth) |
+| 2 | Personas lazy on first chat spawn | Operator can't inspect/edit `OMEGAOS-CONTEXT.md` before first AISB-chat; `omega doctor` showed nothing | No install step called `personas.ensure_canonical()` / `write_all_personas()` — engine was wired but never invoked at install | New `step_personas` (position 38) eagerly seeds canonical + both chat-context dirs with all 8 LLM persona files |
+
+## 2. What `step_personas` does (full materialization at install time)
+
+```
+$OMEGA_HOME/
+├── Agentik_SSOT/personas/OMEGAOS-CONTEXT.md          (1)  canonical
+├── Agentik_Coding/chat-contexts/aisb-master/         (8)  AISB chat
+│   ├── CLAUDE.md       ← claude / claude-code
+│   ├── GEMINI.md       ← gemini-cli
+│   ├── AGENTS.md       ← openai codex
+│   ├── QWEN.md         ← qwen-code
+│   ├── CONVENTIONS.md  ← aider
+│   ├── HERMES.md       ← hermès
+│   ├── .opencode/CONTEXT.md   ← opencode / openrouter / deepseek
+│   └── .continue/CONTEXT.md   ← continue.dev
+└── Agentik_Coding/chat-contexts/hermes/              (8)  Hermès chat
+    └── … same 8 files …
+```
+
+**Result: 17 persona files on disk at install time** (1 canonical + 16 mirrors).
+Operator can `cat / vim` any of them before the first chat spawn. Each LLM CLI
+that lands in either dir reads its native filename and gets the SAME OmegaOS
+context. Hot-swap (`omega switch <provider>`) just re-renders the active
+context's pointer; nothing else moves.
+
+## 3. The Three Laws are in the canonical (mandatory baseline for every LLM)
+
+Every persona file is a mirror of `Agentik_SSOT/personas/OMEGAOS-CONTEXT.md`,
+which embeds:
+
+1. **Code lies. Comments lie. Only runtime tells the truth.**
+2. **Researcher, not sycophant.** Challenge → think → iterate → root cause.
+3. **Autonomous execution.** When dispatched, never wait — decide, execute,
+   report via `.done.json`.
+
+Plus the L1-L5 layer map, the 17 Quality Arsenal audits, the OMEGA_HOME
+folder map, and the `omega` command surface.
+
+## 4. Multi-agent setup — verification (from runtime)
+
+| Question | Answer | Evidence |
+|---|---|---|
+| Is the canonical persona file linked for every LLM? | **Yes.** 10 LLM ids → 8 distinct filenames (.opencode/CONTEXT.md is shared by opencode/openrouter/deepseek). | `omega_engine/personas.py::_LLM_PERSONA_PATHS` |
+| Is everything setup at install time (not lazy)? | **Yes (new in v0.19.38).** `step_personas` runs at install step 38 and seeds both chat contexts before the user opens any session. | `bootstrap/lib/steps.sh::step_personas`, `install.sh STEPS[]` |
+| Are rules respected per LLM? | **Yes.** Same canonical written to every LLM filename — same Three Laws, same architecture, same audits surface. | `personas.write_all_personas()` content equality check |
+| Are AISB + Oracle + Workers using Claude Max OAuth (no API keys)? | **Yes.** `spawn_aisb_chat` shells out to `claude` which reads `~/.claude/.credentials.json`; no `ANTHROPIC_API_KEY` injection. | `omega_engine/tmux.py::spawn_aisb_chat` |
+| Is Hermès budget-isolated? | **Yes.** `spawn_hermes_chat` reads `ANTHROPIC_API_KEY_HERMES` from the age-encrypted vault and inlines it on the `claude` command for that session only — never touches Max OAuth. | `omega_engine/tmux.py::spawn_hermes_chat` lines 433-468 |
+| Does `omega doctor` verify all this? | **Yes (new in v0.19.38).** New `personas` section reports canonical + per-LLM file counts for both contexts. | `cli.py::cmd_doctor` `section("personas")` |
+| Will the user have to do anything post-install? | **No.** One `npx -y @agentikos/omega-os@latest --full` and every LLM persona is on disk, Three Laws encoded, AISB/Hermès tmux sessions ready. | end-to-end install pipeline |
+
+## 5. Tests (regression locks)
+
+`tests/test_installer_wiring.py` — 4 new tests:
+
+| Test | Locks in |
+|---|---|
+| `TestInstallerStepList` (extended) | `38-personas:step_personas` is registered in `install.sh STEPS[]` AND defined in `steps.sh` |
+| `TestStepPersonasBehavior::test_personas_land_in_both_chat_contexts` | Running step_personas against a temp `OMEGA_HOME` materializes canonical + 8 persona files in BOTH aisb-master/ and hermes/ |
+| `TestStepPersonasBehavior::test_step_personas_heredoc_calls_required_helpers` | The heredoc body explicitly calls `ensure_canonical` AND `write_all_personas` AND seeds both labels — rename-safe |
+| `TestDashDashSeparatorAccepted::test_install_sh_has_dash_dash_no_op_case` | `install.sh` case-block contains `--) shift ;;` — without it `bash install.sh -- --full` dies |
+| `TestDashDashSeparatorAccepted::test_bin_launcher_filters_dash_dash` | `bin/omega-os.js` filters `--` from argv before passing to bash |
+
+**Suite total: 627 passed** (was 623; +4 new, +0 regressions).
+
+## 6. Recipe (after v0.19.38 ships)
+
+```bash
+# Either of these works now (the `--` is no-op):
+npx -y @agentikos/omega-os@latest --full
+npx -y @agentikos/omega-os@latest -- --full
+```
+
+## 7. Verdict
+
+✅ Multi-LLM persona setup is **complete and verified at install time**.
+✅ `--` argument bug **eliminated at both layers** (launcher filter + install.sh no-op).
+✅ `omega doctor` **now reports persona health** alongside AISB suite, providers, vault, etc.
+✅ No regression in existing 623 tests.
+✅ User's invariant satisfied: **"l'utilisateur, une fois qu'il a setup tout l'outil OmegaOS, doit être 100% fonctionnel. Il n'a rien à faire à part l'utiliser."**

package/package.json

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