arkaos 4.36.0 → 4.37.0

package/harness/opencode/agents/arka-tech-lead-paulo.md

@@ -3,7 +3,7 @@ description: "Tech Lead — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Paulo, Tech Lead of the ArkaOS /dev department (v4.36.0; generated by scripts/harness_gen.py — do not edit).
+You are Paulo, Tech Lead of the ArkaOS /dev department (v4.37.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow orchestration, visual spec/plan companions via dev/diagram (typed IR -> interactive HTML the user opens before build), code quality enforcement, sprint/cycle management, technical decision-making, developer experience.
 

package/harness/opencode/agents/arka-video-producer-simao.md

@@ -3,7 +3,7 @@ description: "Video Producer & Production Lead — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v4.36.0; generated by scripts/harness_gen.py — do not edit).
+You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v4.37.0; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: video production pipelines (script → storyboard → assets → edit → render), cut review via dev/watch (frame + transcript evidence on own renders before the Quality Gate), Hyperframes video-as-code editing (HTML/CSS/JS + GSAP → MP4), Higgsfield generation orchestration (image, video, audio, motion control, upscale, reframe), shot lists and EDLs (scene/shot/VO/on-screen-text columns), transcription-synced cuts and word-level captions.
 

package/harness/opencode/agents-meta.json

@@ -0,0 +1,27 @@
+{
+  "arka-cto-marco.md": "opus",
+  "arka-cfo-helena.md": "opus",
+  "arka-coo-sofia.md": "opus",
+  "arka-copy-director-eduardo.md": "sonnet",
+  "arka-tech-director-francisca.md": "sonnet",
+  "arka-cqo-marta.md": "opus",
+  "arka-design-ops-lead-iris.md": "sonnet",
+  "arka-brand-director-valentina.md": "sonnet",
+  "arka-community-strategist-beatriz.md": "sonnet",
+  "arka-content-strategist-rafael.md": "sonnet",
+  "arka-video-producer-simao.md": "opus",
+  "arka-architect-gabriel.md": "sonnet",
+  "arka-tech-lead-paulo.md": "sonnet",
+  "arka-ecom-director-ricardo.md": "sonnet",
+  "arka-knowledge-director-clara.md": "sonnet",
+  "arka-conversion-strategist-ines.md": "sonnet",
+  "arka-leadership-director-rodrigo.md": "sonnet",
+  "arka-marketing-director-luna.md": "sonnet",
+  "arka-ops-lead-daniel.md": "sonnet",
+  "arka-chief-of-staff-afonso.md": "sonnet",
+  "arka-pm-director-carolina.md": "sonnet",
+  "arka-saas-strategist-tiago.md": "sonnet",
+  "arka-revops-lead-vicente.md": "sonnet",
+  "arka-sales-director-miguel.md": "sonnet",
+  "arka-strategy-director-tomas.md": "sonnet"
+}

package/harness/opencode/opencode.json

@@ -11,6 +11,29 @@
         "start"
       ],
       "enabled": true
+    },
+    "arka-prompts": {
+      "type": "local",
+      "command": [
+        "uv",
+        "--directory",
+        "~/.claude/skills/arka/mcp-server",
+        "run",
+        "server.py"
+      ],
+      "enabled": true
+    },
+    "memory-bank": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "@allpepper/memory-bank-mcp"
+      ],
+      "environment": {
+        "MEMORY_BANK_ROOT": "~/memory-bank"
+      },
+      "enabled": true
     }
   }
 }

package/harness/opencode/plugins/arka.ts

@@ -0,0 +1,113 @@
+import type { Plugin } from "@opencode-ai/plugin"
+import { homedir } from "node:os"
+import { join } from "node:path"
+
+const ARKA_PY = join(homedir(), ".arkaos", "bin", "arka-py")
+
+type HookResult = Record<string, any> | null
+
+function runHook(action: string, payload: Record<string, any>): HookResult {
+  try {
+    const body = JSON.stringify({ action, ...payload })
+    const proc = Bun.spawnSync([ARKA_PY, "-m", "core.runtime.opencode_hooks"], {
+      stdin: Buffer.from(body),
+      stdout: "pipe",
+      stderr: "pipe",
+    })
+    if (proc.exitCode !== 0) return null
+    return JSON.parse(proc.stdout.toString() || "null")
+  } catch {
+    return null
+  }
+}
+
+export const ArkaPlugin: Plugin = async ({ client, directory }) => {
+  const log = async (level: "info" | "warn" | "error", message: string) => {
+    try {
+      await client.app.log({ body: { service: "arka", level, message } })
+    } catch {}
+  }
+
+  await log("info", "ArkaOS opencode bridge loaded")
+
+  return {
+    "tui.prompt.append": async (input: any, output: any) => {
+      const result = runHook("prompt", {
+        prompt: String(input?.text ?? ""),
+        session_id: String(input?.sessionID ?? ""),
+      })
+      const suggestions: string[] = result?.suggestions ?? []
+      if (suggestions.length > 0) {
+        output.text += "\n\n" + suggestions.join("\n")
+      }
+    },
+
+    "tool.execute.before": async (input: any, output: any) => {
+      const result = runHook("pre_tool", {
+        tool: String(input?.tool ?? ""),
+        args: output?.args ?? {},
+        session_id: String(input?.sessionID ?? ""),
+        cwd: directory,
+      })
+      if (!result) return
+      if (result.allow === false) {
+        throw new Error(result.message || "Blocked by ArkaOS gate")
+      }
+      if (result.message) {
+        await log("warn", result.message)
+      }
+    },
+
+    "tool.execute.after": async (input: any) => {
+      runHook("post_tool", {
+        tool: String(input?.tool ?? ""),
+        session_id: String(input?.sessionID ?? ""),
+        ok: true,
+      })
+    },
+
+    "experimental.session.compacting": async (_input: any, output: any) => {
+      const result = runHook("compact", {})
+      const context: string[] = result?.context ?? []
+      for (const line of context) {
+        output.context.push(line)
+      }
+    },
+
+    event: async ({ event }: any) => {
+      if (event?.type === "session.created") {
+        await log("info", "ArkaOS gates active (kb-first, frontend, compliance)")
+        return
+      }
+      if (event?.type !== "session.idle") return
+      try {
+        const sessionID = String(event?.properties?.sessionID ?? "")
+        if (!sessionID) return
+        const response: any = await client.session.messages({
+          path: { id: sessionID },
+        })
+        const messages: any[] = Array.isArray(response?.data)
+          ? response.data
+          : Array.isArray(response)
+            ? response
+            : []
+        const lastAssistant = [...messages]
+          .reverse()
+          .find((m: any) => m?.info?.role === "assistant" || m?.role === "assistant")
+        const parts: any[] = lastAssistant?.parts ?? []
+        const text = parts
+          .filter((p: any) => p?.type === "text")
+          .map((p: any) => String(p?.text ?? ""))
+          .join("\n")
+        if (!text) return
+        const result = runHook("idle", {
+          response_text: text.slice(-20000),
+          session_id: sessionID,
+        })
+        for (const nudge of result?.nudges ?? []) {
+          await log("warn", nudge)
+        }
+      } catch {}
+    },
+  }
+}

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.36.0 — 89 agents, 17 departments, 331 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.37.0 — 89 agents, 17 departments, 331 skills. Generated by `scripts/harness_gen.py`; do not edit.
 
 You are operating within ArkaOS. Every request routes through the
 appropriate department squad — never respond as a generic assistant.

package/installer/adapters/opencode.js

@@ -1,4 +1,5 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
 import { listBundleFiles, readBundleFile } from "../harness-bundle.js";
 
@@ -7,9 +8,13 @@ import { listBundleFiles, readBundleFile } from "../harness-bundle.js";
  * bundle onto OpenCode's native surfaces (opencode.ai/docs):
  *
  *   AGENTS.md      instructions contract (same body as codex)
- *   agents/*.md    curated agent cut (C-suite + squad leads)
+ *   agents/*.md    curated agent cut (C-suite + squad leads), with the
+ *                  agent-YAML model tier resolved onto the user's own
+ *                  opencode model/small_model (agents-meta.json sidecar)
  *   commands/*.md  one /arka-<dept> router command per department
- *   opencode.json  arka-tools MCP — merged NON-destructively
+ *   plugins/arka.ts  governance plugin (kb-first/frontend/compliance gates)
+ *   opencode.json  arka-tools MCP + seeded user MCPs — merged
+ *                  NON-destructively
  *
  * Merge contract: user keys ALWAYS win. An existing `$schema`, any
  * user-defined `mcp` server, or a user-modified `arka-tools` entry is
@@ -62,6 +67,88 @@ export function mergeOpencodeConfig(existingText, fragmentText) {
   return { config: merged, changed };
 }
 
+/** Expand leading `~` in command arrays / env values (pure, testable). */
+export function expandHome(value) {
+  if (typeof value === "string") {
+    return value.startsWith("~/") ? join(homedir(), value.slice(2)) : value;
+  }
+  if (Array.isArray(value)) return value.map(expandHome);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([k, v]) => [k, expandHome(v)])
+    );
+  }
+  return value;
+}
+
+/**
+ * User-local MCPs seeded from ArkaOS state (never in the static bundle —
+ * paths/endpoints differ per machine). Returns only entries the user
+ * config does NOT already define.
+ */
+export function userLocalMcpSeeds(existingMcp) {
+  const home = homedir();
+  const seeds = {};
+  try {
+    const profile = JSON.parse(
+      readFileSync(join(home, ".arkaos", "profile.json"), "utf-8")
+    );
+    if (profile.vaultPath && existsSync(profile.vaultPath)) {
+      seeds.obsidian = {
+        type: "local",
+        command: ["npx", "-y", "@bitbonsai/mcpvault@latest", profile.vaultPath],
+        enabled: true,
+      };
+    }
+  } catch {}
+  try {
+    const arkaConfig = JSON.parse(
+      readFileSync(join(home, ".arkaos", "config.json"), "utf-8")
+    );
+    const graphify = arkaConfig?.knowledge?.graphify;
+    if (graphify?.enabled && graphify?.url) {
+      let headers = graphify.headers;
+      if (!headers) {
+        try {
+          const claude = JSON.parse(
+            readFileSync(join(home, ".claude.json"), "utf-8")
+          );
+          const raw = claude?.mcpServers?.graphify?.headers;
+          if (raw) {
+            headers = Object.fromEntries(
+              Object.entries(raw).map(([k, v]) => [
+                k,
+                String(v).replace(/^Bearer\s+Bearer\s+/i, "Bearer "),
+              ])
+            );
+          }
+        } catch {}
+      }
+      seeds.graphify = {
+        type: "remote",
+        url: graphify.url,
+        ...(headers ? { headers } : {}),
+        enabled: true,
+      };
+    }
+  } catch {}
+  return Object.fromEntries(
+    Object.entries(seeds).filter(([name]) => !(name in (existingMcp || {})))
+  );
+}
+
+/**
+ * Inject `model:` into a deployed agent file's frontmatter, mapping the
+ * ArkaOS tier onto the user's own opencode models. Skips when the file
+ * already pins a model or no model is configured.
+ */
+export function injectAgentModel(content, tier, mainModel, smallModel) {
+  if (!mainModel || /^model:/m.test(content)) return content;
+  const resolved = tier === "haiku" ? smallModel || mainModel : mainModel;
+  if (!resolved) return content;
+  return content.replace(/^---\n/, `---\nmodel: ${resolved}\n`);
+}
+
 export default {
   configureHooks(config) {
     // OpenCode has no shell-hook chain; "configure" means deploying the
@@ -77,42 +164,81 @@ export default {
     mkdirSync(config.configDir, { recursive: true });
     writeFileSync(join(config.configDir, "AGENTS.md"), agentsMd);
 
+    const existingText = existsSync(config.settingsFile)
+      ? readFileSync(config.settingsFile, "utf-8")
+      : "";
+    let existingConfig = {};
+    try {
+      existingConfig = existingText.trim() ? JSON.parse(existingText) : {};
+    } catch {
+      existingConfig = {};
+    }
+
+    let agentsMeta = {};
+    try {
+      agentsMeta = JSON.parse(
+        readBundleFile("opencode", "agents-meta.json") || "{}"
+      );
+    } catch {
+      agentsMeta = {};
+    }
+
     let deployed = 0;
     for (const sub of ["agents", "commands"]) {
       const names = listBundleFiles("opencode", sub);
       if (names.length === 0) continue;
       mkdirSync(join(config.configDir, sub), { recursive: true });
       for (const name of names) {
-        const content = readBundleFile("opencode", `${sub}/${name}`);
+        let content = readBundleFile("opencode", `${sub}/${name}`);
         if (content === null) continue;
+        if (sub === "agents" && agentsMeta[name]) {
+          content = injectAgentModel(
+            content,
+            agentsMeta[name],
+            existingConfig.model,
+            existingConfig.small_model
+          );
+        }
         writeFileSync(join(config.configDir, sub, name), content);
         deployed += 1;
       }
     }
 
+    const plugin = readBundleFile("opencode", "plugins/arka.ts");
+    if (plugin !== null) {
+      mkdirSync(join(config.configDir, "plugins"), { recursive: true });
+      writeFileSync(join(config.configDir, "plugins", "arka.ts"), plugin);
+      deployed += 1;
+    }
+
     const fragment = readBundleFile("opencode", "opencode.json");
     if (fragment) {
-      const existingText = existsSync(config.settingsFile)
-        ? readFileSync(config.settingsFile, "utf-8")
-        : "";
-      const result = mergeOpencodeConfig(existingText, fragment);
+      const expanded = JSON.stringify(expandHome(JSON.parse(fragment)));
+      const result = mergeOpencodeConfig(existingText, expanded);
       if (result === null) {
         console.warn(
           "         opencode.json unreadable — left untouched " +
             "(the merge is never destructive)."
         );
-      } else if (result.changed) {
-        writeFileSync(
-          config.settingsFile,
-          JSON.stringify(result.config, null, 2) + "\n"
-        );
-        console.log(
-          "         opencode.json updated (arka-tools MCP registered, user keys preserved)."
-        );
+      } else {
+        const seeds = userLocalMcpSeeds(result.config.mcp || {});
+        if (Object.keys(seeds).length > 0) {
+          result.config.mcp = { ...(result.config.mcp || {}), ...seeds };
+          result.changed = true;
+        }
+        if (result.changed) {
+          writeFileSync(
+            config.settingsFile,
+            JSON.stringify(result.config, null, 2) + "\n"
+          );
+          console.log(
+            "         opencode.json updated (arka MCPs registered, user keys preserved)."
+          );
+        }
       }
     }
     console.log(
-      `         OpenCode configured (AGENTS.md + ${deployed} agent/command files).`
+      `         OpenCode configured (AGENTS.md + ${deployed} agent/command/plugin files).`
     );
   },
 };

package/installer/assets/opencode/arka.ts

@@ -0,0 +1,113 @@
+import type { Plugin } from "@opencode-ai/plugin"
+import { homedir } from "node:os"
+import { join } from "node:path"
+
+const ARKA_PY = join(homedir(), ".arkaos", "bin", "arka-py")
+
+type HookResult = Record<string, any> | null
+
+function runHook(action: string, payload: Record<string, any>): HookResult {
+  try {
+    const body = JSON.stringify({ action, ...payload })
+    const proc = Bun.spawnSync([ARKA_PY, "-m", "core.runtime.opencode_hooks"], {
+      stdin: Buffer.from(body),
+      stdout: "pipe",
+      stderr: "pipe",
+    })
+    if (proc.exitCode !== 0) return null
+    return JSON.parse(proc.stdout.toString() || "null")
+  } catch {
+    return null
+  }
+}
+
+export const ArkaPlugin: Plugin = async ({ client, directory }) => {
+  const log = async (level: "info" | "warn" | "error", message: string) => {
+    try {
+      await client.app.log({ body: { service: "arka", level, message } })
+    } catch {}
+  }
+
+  await log("info", "ArkaOS opencode bridge loaded")
+
+  return {
+    "tui.prompt.append": async (input: any, output: any) => {
+      const result = runHook("prompt", {
+        prompt: String(input?.text ?? ""),
+        session_id: String(input?.sessionID ?? ""),
+      })
+      const suggestions: string[] = result?.suggestions ?? []
+      if (suggestions.length > 0) {
+        output.text += "\n\n" + suggestions.join("\n")
+      }
+    },
+
+    "tool.execute.before": async (input: any, output: any) => {
+      const result = runHook("pre_tool", {
+        tool: String(input?.tool ?? ""),
+        args: output?.args ?? {},
+        session_id: String(input?.sessionID ?? ""),
+        cwd: directory,
+      })
+      if (!result) return
+      if (result.allow === false) {
+        throw new Error(result.message || "Blocked by ArkaOS gate")
+      }
+      if (result.message) {
+        await log("warn", result.message)
+      }
+    },
+
+    "tool.execute.after": async (input: any) => {
+      runHook("post_tool", {
+        tool: String(input?.tool ?? ""),
+        session_id: String(input?.sessionID ?? ""),
+        ok: true,
+      })
+    },
+
+    "experimental.session.compacting": async (_input: any, output: any) => {
+      const result = runHook("compact", {})
+      const context: string[] = result?.context ?? []
+      for (const line of context) {
+        output.context.push(line)
+      }
+    },
+
+    event: async ({ event }: any) => {
+      if (event?.type === "session.created") {
+        await log("info", "ArkaOS gates active (kb-first, frontend, compliance)")
+        return
+      }
+      if (event?.type !== "session.idle") return
+      try {
+        const sessionID = String(event?.properties?.sessionID ?? "")
+        if (!sessionID) return
+        const response: any = await client.session.messages({
+          path: { id: sessionID },
+        })
+        const messages: any[] = Array.isArray(response?.data)
+          ? response.data
+          : Array.isArray(response)
+            ? response
+            : []
+        const lastAssistant = [...messages]
+          .reverse()
+          .find((m: any) => m?.info?.role === "assistant" || m?.role === "assistant")
+        const parts: any[] = lastAssistant?.parts ?? []
+        const text = parts
+          .filter((p: any) => p?.type === "text")
+          .map((p: any) => String(p?.text ?? ""))
+          .join("\n")
+        if (!text) return
+        const result = runHook("idle", {
+          response_text: text.slice(-20000),
+          session_id: sessionID,
+        })
+        for (const nudge of result?.nudges ?? []) {
+          await log("warn", nudge)
+        }
+      } catch {}
+    },
+  }
+}

package/knowledge/skills-manifest.json

@@ -1,7 +1,7 @@
 {
   "_meta": {
     "generator": "scripts/marketplace_gen.py",
-    "version": "4.36.0",
+    "version": "4.37.0",
     "marketplace": "arkaos"
   },
   "structural": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "4.36.0",
+  "version": "4.37.0",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "4.36.0"
+version = "4.37.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/harness_gen.py

@@ -283,10 +283,22 @@ def _agent_markdown(agent: dict) -> str:
 
 
 def _opencode_agent_files() -> dict[str, str]:
-    return {
+    curated = _curated_agents(_load_agents())
+    files = {
         f"opencode/agents/arka-{agent['id']}.md": _agent_markdown(agent)
-        for agent in _curated_agents(_load_agents())
+        for agent in curated
     }
+    # Model-tier sidecar: the installer adapter maps each tier onto the
+    # user's own opencode model/small_model at deploy time (the bundle
+    # cannot hardcode a provider — opencode runs on any provider).
+    files["opencode/agents-meta.json"] = json.dumps(
+        {
+            f"arka-{agent['id']}.md": agent.get("model", "sonnet")
+            for agent in curated
+        },
+        indent=2,
+    ) + "\n"
+    return files
 
 
 def _opencode_command_files() -> dict[str, str]:
@@ -310,7 +322,10 @@ def _opencode_command_files() -> dict[str, str]:
 def _opencode_config() -> str:
     """Reference opencode.json fragment. The installer adapter merges it
     NON-destructively — user keys always win; this file is never copied
-    over an existing config verbatim."""
+    over an existing config verbatim. ``~`` placeholders are expanded by
+    the adapter against the installing user's home directory. User-local
+    MCPs (obsidian vault, graphify endpoint) are seeded adapter-side from
+    ~/.arkaos/profile.json and ~/.arkaos/config.json, not here."""
     config = {
         "$schema": "https://opencode.ai/config.json",
         "mcp": {
@@ -319,11 +334,35 @@ def _opencode_config() -> str:
                 "command": ["npx", "-y", "arkaos", "mcp", "start"],
                 "enabled": True,
             },
+            "arka-prompts": {
+                "type": "local",
+                "command": [
+                    "uv",
+                    "--directory",
+                    "~/.claude/skills/arka/mcp-server",
+                    "run",
+                    "server.py",
+                ],
+                "enabled": True,
+            },
+            "memory-bank": {
+                "type": "local",
+                "command": ["npx", "-y", "@allpepper/memory-bank-mcp"],
+                "environment": {"MEMORY_BANK_ROOT": "~/memory-bank"},
+                "enabled": True,
+            },
         },
     }
     return json.dumps(config, indent=2) + "\n"
 
 
+def _opencode_plugin() -> str:
+    """Source of the opencode governance plugin (hooks parity). Lives in
+    installer/assets so the plugin is reviewable TS, not generated text."""
+    path = ROOT / "installer" / "assets" / "opencode" / "arka.ts"
+    return path.read_text(encoding="utf-8")
+
+
 def generate() -> dict[str, str]:
     """Return {relative path under harness/: content}."""
     body = _contract_body()
@@ -337,6 +376,7 @@ def generate() -> dict[str, str]:
     for rel, content in _cursor_files().items():
         files[f"cursor/{rel}"] = content
     files["opencode/opencode.json"] = _opencode_config()
+    files["opencode/plugins/arka.ts"] = _opencode_plugin()
     files.update(_opencode_agent_files())
     files.update(_opencode_command_files())
     return files