arkaos 4.36.0 → 4.38.0

package/README.md

@@ -2,7 +2,7 @@
 
 **The Operating System for AI Agent Teams.**
 
-89 agents. 17 departments. 331 skills. Enterprise frameworks. Multi-runtime. One install.
+89 agents. 17 departments. 332 skills. Enterprise frameworks. Multi-runtime. One install.
 
 ```bash
 npx arkaos install

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v4.36.0 — 89 agents, 17 departments, 331 skills, 297 commands, 17 ADRs.
+> v4.38.0 — 89 agents, 17 departments, 332 skills, 297 commands, 17 ADRs.
 > One file, everything you need to start. Generated by `scripts/guide_gen.py` — never hand-edited.
 
 ## What it is

package/VERSION

@@ -1 +1 @@
-4.36.0
+4.38.0

package/arka/SKILL.md

@@ -47,7 +47,7 @@ complementary, not alternatives.
 # ArkaOS — Main Orchestrator
 
 > **The Operating System for AI Agent Teams**
-> 89 agents. 17 departments. 331 skills. Multi-runtime. Dashboard. Knowledge RAG.
+> 89 agents. 17 departments. 332 skills. Multi-runtime. Dashboard. Knowledge RAG.
 
 ## ⛔ Evidence flow — 4 gates (NON-NEGOTIABLE)
 

package/config/skills-curated.yaml

@@ -24,8 +24,8 @@ curated_subskills:
   community: [moderation]
   content: [calendar, hook-write]
   dev: [api-design, architecture-design, clean-code-review, code-review,
-        db-design, diagram, refactor-plan, runbook, security-audit, spec,
-        tdd-cycle, watch]
+        db-design, diagram, refactor-plan, runbook, scroll-world,
+        security-audit, spec, tdd-cycle, watch]
   ecom: [cart-recovery, store-audit]
   finance: [financial-model, unit-economics]
   kb: [search-kb, zettelkasten-process]

package/config/skills-provenance.yaml

@@ -91,6 +91,13 @@ derived:
     origin: community
     source: https://github.com/nutlope/hallmark
     license: MIT
+  # Scroll-world — scroll-scrubbed "fly through the world" landing pages
+  # (Higgsfield pipeline + portable scrub engine), vendored verbatim with
+  # ArkaOS frontmatter; THIRD-PARTY-NOTICES records the trail.
+  departments/dev/skills/scroll-world:
+    origin: community
+    source: https://github.com/oso95/scroll-world
+    license: MIT
   # Watch absorption campaign — video-input primitive derived from
   # bradautomates/claude-video v0.2.0 (MIT), maintained natively.
   departments/dev/skills/watch:

package/core/hooks/session_start.py

@@ -341,16 +341,30 @@ def build_recap(cwd: str, budget_ms: int = _BUDGET_MS) -> str:
         if not records or (time.monotonic() - start) * 1000 > budget_ms:
             return ""
         lines = ["[SESSION-MEMORY] Prior turns (importance+recency — not semantic):"]
+        handoff = store.cross_runtime_handoff(project, "claude")
+        if handoff:
+            stamp = (
+                handoff.ts[11:16] + "Z" if len(handoff.ts) >= 16 else handoff.ts
+            )
+            h_summary = neutralize_summary(handoff.summary)[:_SUMMARY_CHARS]
+            tail = f": {h_summary}" if h_summary else ""
+            lines.append(
+                f"[arka:handoff] última sessão em {handoff.runtime}"
+                f" ({stamp}){tail}"
+            )
+        turn_lines = 0
         for record in records:
             summary = neutralize_summary(record.summary)[:_SUMMARY_CHARS]
             if not summary:
                 continue
-            lines.append(f"[SESSION-MEMORY] - {record.ts[:10]}: {summary}")
-        if len(lines) == 1:
+            runtime = f" · {record.runtime}" if record.runtime else ""
+            lines.append(f"[SESSION-MEMORY] - {record.ts[:10]}{runtime}: {summary}")
+            turn_lines += 1
+        if turn_lines == 0:
             return ""
         backends = ",".join(sorted({r.embedding_backend for r in records})) or "none"
         lines.append(
-            f"[SESSION-MEMORY] shown: {len(lines) - 1} turns ({project}),"
+            f"[SESSION-MEMORY] shown: {turn_lines} turns ({project}),"
             f" backends={backends}"
         )
         return "\n".join(lines)

package/core/memory/semantic_store.py

@@ -46,6 +46,7 @@ class TurnRecord(BaseModel):
     id: str = Field(default_factory=lambda: uuid.uuid4().hex)
     ts: str = ""
     session_id: str = ""
+    runtime: str = ""
     project_name: str = ""
     cwd: str = ""
     summary: str = ""
@@ -110,6 +111,7 @@ class SessionMemoryStore:
                     id TEXT PRIMARY KEY,
                     ts TEXT NOT NULL,
                     session_id TEXT NOT NULL,
+                    runtime TEXT NOT NULL DEFAULT '',
                     project_name TEXT NOT NULL DEFAULT '',
                     cwd TEXT NOT NULL DEFAULT '',
                     summary TEXT NOT NULL DEFAULT '',
@@ -122,13 +124,23 @@ class SessionMemoryStore:
                     dims INTEGER NOT NULL DEFAULT 0
                 )
             """)
+            self._migrate(conn)
+
+    def _migrate(self, conn: sqlite3.Connection) -> None:
+        """Additive column migrations for DBs created before a column
+        existed — CREATE TABLE IF NOT EXISTS never alters a live table."""
+        cols = {row[1] for row in conn.execute("PRAGMA table_info(turns)")}
+        if "runtime" not in cols:
             conn.execute(
-                "CREATE INDEX IF NOT EXISTS idx_turns_project_ts "
-                "ON turns (project_name, ts DESC)"
-            )
-            conn.execute(
-                "CREATE INDEX IF NOT EXISTS idx_turns_session ON turns (session_id)"
+                "ALTER TABLE turns ADD COLUMN runtime TEXT NOT NULL DEFAULT ''"
             )
+        conn.execute(
+            "CREATE INDEX IF NOT EXISTS idx_turns_project_ts "
+            "ON turns (project_name, ts DESC)"
+        )
+        conn.execute(
+            "CREATE INDEX IF NOT EXISTS idx_turns_session ON turns (session_id)"
+        )
 
     def save(self, record: TurnRecord) -> None:
         row = record.model_dump()
@@ -139,12 +151,13 @@ class SessionMemoryStore:
         )
         with closing(self._conn()) as conn, conn:
             conn.execute(
-                "INSERT OR REPLACE INTO turns (id, ts, session_id, project_name,"
-                " cwd, summary, tools_used, file_paths, importance, embedding,"
-                " embedding_backend, embedding_model, dims)"
-                " VALUES (:id, :ts, :session_id, :project_name, :cwd, :summary,"
-                " :tools_used, :file_paths, :importance, :embedding,"
-                " :embedding_backend, :embedding_model, :dims)",
+                "INSERT OR REPLACE INTO turns (id, ts, session_id, runtime,"
+                " project_name, cwd, summary, tools_used, file_paths,"
+                " importance, embedding, embedding_backend, embedding_model,"
+                " dims)"
+                " VALUES (:id, :ts, :session_id, :runtime, :project_name,"
+                " :cwd, :summary, :tools_used, :file_paths, :importance,"
+                " :embedding, :embedding_backend, :embedding_model, :dims)",
                 row,
             )
 
@@ -185,6 +198,40 @@ class SessionMemoryStore:
         where = f"WHERE {' AND '.join(clauses)}" if clauses else ""
         return where, params
 
+    def latest_turn(
+        self, project_name: str, exclude_session: str | None = None
+    ) -> TurnRecord | None:
+        """Newest turn in the project — the handoff-detection primitive."""
+        where, params = self._scope(project_name, exclude_session)
+        with closing(self._conn()) as conn:
+            row = conn.execute(
+                f"SELECT * FROM turns {where} ORDER BY ts DESC LIMIT 1",
+                params,
+            ).fetchone()
+        return self._row_to_record(row) if row else None
+
+    def cross_runtime_handoff(
+        self,
+        project_name: str,
+        current_runtime: str,
+        exclude_session: str | None = None,
+        max_age_h: float = 24,
+    ) -> TurnRecord | None:
+        """Newest turn in the project captured by a DIFFERENT runtime,
+        fresh enough to matter as a continuation hint — the shared
+        handoff predicate for every runtime's entry point."""
+        latest = self.latest_turn(project_name, exclude_session=exclude_session)
+        if not latest or not latest.runtime or latest.runtime == current_runtime:
+            return None
+        try:
+            age_h = (
+                datetime.now(UTC)
+                - datetime.fromisoformat(latest.ts.replace("Z", "+00:00"))
+            ).total_seconds() / 3600
+        except ValueError:
+            return None
+        return latest if age_h <= max_age_h else None
+
     def keyword_search(
         self, query: str, project_name: str | None = None, top_k: int = 3
     ) -> list[dict]:

package/core/memory/turn_capture.py

@@ -161,7 +161,8 @@ def _precompute_cache(
         "dims": record.dims,
         "items": [
             {"summary": i["summary"][:200], "project_name": i["project_name"],
-             "ts": i["ts"], "score": i["score"], "retrieval": i["retrieval"]}
+             "ts": i["ts"], "score": i["score"], "retrieval": i["retrieval"],
+             "runtime": i.get("runtime", "")}
             for i in items
         ],
     }
@@ -190,14 +191,16 @@ def _maintenance(store: SessionMemoryStore) -> None:
     store.prune()
 
 
-def capture_turn(session_id: str, transcript_path: str, cwd: str = "") -> int:
-    if not _config_enabled() or not session_id:
-        return 0
-    raw = _read_tail(transcript_path)
-    if not raw:
-        return 0
-    text = _last_assistant_text(transcript_path, raw)
-    tools, paths = _parse_tool_uses(raw)
+def _persist_record(
+    session_id: str,
+    text: str,
+    cwd: str,
+    runtime: str,
+    tools: list[str],
+    paths: list[str],
+) -> None:
+    """Shared tail for every capture path: sanitize -> embed -> store ->
+    precompute the F1-A3 neighbour cache -> amortised maintenance."""
     summary, sanitized_ok = _sanitized_summary(text)
     tools = _safe_tool_names(tools, sanitized_ok)
     if not sanitized_ok:
@@ -206,6 +209,7 @@ def capture_turn(session_id: str, transcript_path: str, cwd: str = "") -> int:
     record = TurnRecord(
         ts=datetime.now(UTC).isoformat(),
         session_id=session_id,
+        runtime=runtime,
         project_name=Path(cwd).name if cwd else "",
         cwd=cwd,
         summary=summary,
@@ -221,6 +225,31 @@ def capture_turn(session_id: str, transcript_path: str, cwd: str = "") -> int:
     store.save(record)
     _precompute_cache(store, record, session_id)
     _maintenance(store)
+
+
+def capture_turn(
+    session_id: str, transcript_path: str, cwd: str = "", runtime: str = "claude"
+) -> int:
+    if not _config_enabled() or not session_id:
+        return 0
+    raw = _read_tail(transcript_path)
+    if not raw:
+        return 0
+    text = _last_assistant_text(transcript_path, raw)
+    tools, paths = _parse_tool_uses(raw)
+    _persist_record(session_id, text, cwd, runtime, tools, paths)
+    return 0
+
+
+def capture_text_turn(
+    session_id: str, text: str, cwd: str = "", runtime: str = "opencode"
+) -> int:
+    """Transcript-free capture for runtimes without a Claude-style JSONL
+    transcript on disk (OpenCode: the plugin holds the messages, not us).
+    The caller hands over the last assistant text directly."""
+    if not _config_enabled() or not session_id or not text.strip():
+        return 0
+    _persist_record(session_id, text, cwd, runtime, [], [])
     return 0
 
 
@@ -261,14 +290,30 @@ def main(argv: list[str] | None = None) -> int:
             return run_maintenance()
         except Exception:  # detached worker must die quietly
             return 0
+    if args and args[0] == "capture-text":
+        if len(args) < 4:
+            print(
+                "usage: python3 -m core.memory.turn_capture"
+                " capture-text <session_id> <cwd> <runtime>  (text on stdin)"
+            )
+            return 2
+        try:
+            text = sys.stdin.read()
+            return capture_text_turn(args[1], text, args[2], args[3])
+        except Exception:  # detached worker must die quietly
+            return 0
     if len(args) < 2:
         print(
             "usage: python3 -m core.memory.turn_capture"
-            " (<session_id> <transcript_path> [cwd] | maintenance)"
+            " (<session_id> <transcript_path> [cwd] [runtime] |"
+            " capture-text <session_id> <cwd> <runtime> | maintenance)"
         )
         return 2
     try:
-        return capture_turn(args[0], args[1], args[2] if len(args) > 2 else "")
+        return capture_turn(
+            args[0], args[1], args[2] if len(args) > 2 else "",
+            args[3] if len(args) > 3 else "claude",
+        )
     except Exception:  # detached worker must die quietly
         return 0
 

package/core/runtime/opencode.py

@@ -2,9 +2,13 @@
 
 OpenCode (opencode.ai) — open-source terminal AI coding agent with
 native agents (markdown, ``~/.config/opencode/agents/``), custom
-commands (``commands/``), MCP servers (``opencode.json``), and AGENTS.md
-instructions. The installer adapter (installer/adapters/opencode.js)
-deploys the generated harness bundle onto those surfaces.
+commands (``commands/``), MCP servers (``opencode.json``), AGENTS.md
+instructions, and a TypeScript plugin system (``plugins/``). The
+installer adapter (installer/adapters/opencode.js) deploys the
+generated harness bundle onto those surfaces, including
+``plugins/arka.ts``, which bridges OpenCode events into
+``core.runtime.opencode_hooks`` (kb-first research gate, frontend
+gate, MCP telemetry, stop-hook compliance, compaction context).
 
 Headless invocation (live-verified against the installed binary,
 opencode 1.18.4, ``opencode run --help`` + a real probe, 2026-07-23):
@@ -60,18 +64,25 @@ class OpenCodeAdapter(RuntimeAdapter):
             config_dir=config_dir,
             skills_dir=config_dir / "commands",
             settings_file=config_dir / "opencode.json",
-            supports_hooks=False,
+            supports_hooks=(config_dir / "plugins" / "arka.ts").exists(),
             supports_subagents=True,
             supports_mcp=True,
             max_context_tokens=200_000,
         )
 
     def capabilities(self) -> dict[str, bool]:
+        plugin = (
+            Path(expanduser("~")) / ".config" / "opencode" / "plugins" / "arka.ts"
+        )
         return {
             "agent_dispatch": False,  # native agents exist; no ArkaOS wiring yet
             "headless": True,         # `opencode run` live-verified 2026-07-23
             "file_ops": True,         # terminal agent edits files natively
-            "hooks": False,           # plugins exist; no PreToolUse/Stop parity
+            # plugins/arka.ts (deployed by the installer adapter) bridges
+            # prompt/pre_tool/post_tool/idle/compact events into
+            # core.runtime.opencode_hooks — kb-first, frontend gate,
+            # telemetry, compliance. True only when actually deployed.
+            "hooks": plugin.exists(),
         }
 
     def inject_context(self, layers: dict[str, str]) -> str: