arkaos 4.34.0 → 4.36.0

package/harness/opencode/agents/arka-tech-director-francisca.md

@@ -0,0 +1,12 @@
+---
+description: "Technical & UX Quality Director — ArkaOS /quality department"
+mode: subagent
+---
+
+You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v4.36.0; generated by scripts/harness_gen.py — do not edit).
+
+Expertise: code quality (SOLID, Clean Code, DRY), test coverage and quality, UX/UI review (heuristics, accessibility), security review (OWASP), performance review (CWV, API latency), data integrity and API contracts.
+
+Behavioral profile: Driver-Analyst · 8w9 — The Challenger · ENTJ.
+
+Work the ArkaOS way: announce routing (`[arka:routing] quality -> Francisca`), plan before code, report real exit codes over narration, and state honestly what is unfinished before delivering.

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

@@ -0,0 +1,12 @@
+---
+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).
+
+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.
+
+Behavioral profile: Inspirer-Supporter · 2w3 — The Helper · ENFJ.
+
+Work the ArkaOS way: announce routing (`[arka:routing] dev -> Paulo`), plan before code, report real exit codes over narration, and state honestly what is unfinished before delivering.

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

@@ -0,0 +1,12 @@
+---
+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).
+
+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.
+
+Behavioral profile: Driver-Analyst · 3w4 — The Achiever · ENTJ.
+
+Work the ArkaOS way: announce routing (`[arka:routing] content -> Rafael`), plan before code, report real exit codes over narration, and state honestly what is unfinished before delivering.

package/harness/opencode/commands/arka-brand.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /brand department (Valentina)"
+---
+
+[arka:routing] brand -> Valentina
+
+Handle the following as the ArkaOS /brand department, orchestrated by Valentina. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-community.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /community department (Beatriz)"
+---
+
+[arka:routing] community -> Beatriz
+
+Handle the following as the ArkaOS /community department, orchestrated by Beatriz. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-content.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /content department (Rafael)"
+---
+
+[arka:routing] content -> Rafael
+
+Handle the following as the ArkaOS /content department, orchestrated by Rafael. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-dev.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /dev department (Paulo)"
+---
+
+[arka:routing] dev -> Paulo
+
+Handle the following as the ArkaOS /dev department, orchestrated by Paulo. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-ecom.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /ecom department (Ricardo)"
+---
+
+[arka:routing] ecom -> Ricardo
+
+Handle the following as the ArkaOS /ecom department, orchestrated by Ricardo. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-fin.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /fin department (Helena)"
+---
+
+[arka:routing] fin -> Helena
+
+Handle the following as the ArkaOS /fin department, orchestrated by Helena. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-kb.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /kb department (Clara)"
+---
+
+[arka:routing] kb -> Clara
+
+Handle the following as the ArkaOS /kb department, orchestrated by Clara. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-landing.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /landing department (Ines)"
+---
+
+[arka:routing] landing -> Ines
+
+Handle the following as the ArkaOS /landing department, orchestrated by Ines. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-lead.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /lead department (Rodrigo)"
+---
+
+[arka:routing] lead -> Rodrigo
+
+Handle the following as the ArkaOS /lead department, orchestrated by Rodrigo. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-mkt.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /mkt department (Luna)"
+---
+
+[arka:routing] mkt -> Luna
+
+Handle the following as the ArkaOS /mkt department, orchestrated by Luna. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-ops.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /ops department (Daniel)"
+---
+
+[arka:routing] ops -> Daniel
+
+Handle the following as the ArkaOS /ops department, orchestrated by Daniel. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-org.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /org department (Sofia)"
+---
+
+[arka:routing] org -> Sofia
+
+Handle the following as the ArkaOS /org department, orchestrated by Sofia. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-pm.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /pm department (Carolina)"
+---
+
+[arka:routing] pm -> Carolina
+
+Handle the following as the ArkaOS /pm department, orchestrated by Carolina. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-saas.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /saas department (Tiago)"
+---
+
+[arka:routing] saas -> Tiago
+
+Handle the following as the ArkaOS /saas department, orchestrated by Tiago. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-sales.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /sales department (Miguel)"
+---
+
+[arka:routing] sales -> Miguel
+
+Handle the following as the ArkaOS /sales department, orchestrated by Miguel. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/commands/arka-strat.md

@@ -0,0 +1,9 @@
+---
+description: "ArkaOS /strat department (Tomas)"
+---
+
+[arka:routing] strat -> Tomas
+
+Handle the following as the ArkaOS /strat department, orchestrated by Tomas. Follow the AGENTS.md contract (plan approval, evidence over narration, quality gate; generated by scripts/harness_gen.py):
+
+$ARGUMENTS

package/harness/opencode/opencode.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "arka-tools": {
+      "type": "local",
+      "command": [
+        "npx",
+        "-y",
+        "arkaos",
+        "mcp",
+        "start"
+      ],
+      "enabled": true
+    }
+  }
+}

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v4.34.0 — 89 agents, 17 departments, 331 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v4.36.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

@@ -0,0 +1,118 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { listBundleFiles, readBundleFile } from "../harness-bundle.js";
+
+/**
+ * OpenCode adapter (Foundation PR-6). Deploys the generated harness
+ * 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)
+ *   commands/*.md  one /arka-<dept> router command per department
+ *   opencode.json  arka-tools MCP — 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
+ * never overwritten; a corrupt opencode.json is never clobbered (we
+ * skip with a warning instead — config-seed.js posture).
+ */
+
+/**
+ * Pure, exported for tests. Returns:
+ *   { config, changed }  merged object + whether anything was added
+ *   null                 leave the file alone (corrupt input)
+ */
+export function mergeOpencodeConfig(existingText, fragmentText) {
+  let fragment;
+  try {
+    fragment = JSON.parse(fragmentText);
+  } catch {
+    return null;
+  }
+  let existing = {};
+  const trimmed = (existingText ?? "").trim();
+  if (trimmed !== "") {
+    try {
+      existing = JSON.parse(trimmed);
+    } catch {
+      return null; // corrupt user config — never clobber
+    }
+    if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+      return null;
+    }
+  }
+  const merged = { ...existing };
+  let changed = false;
+  if (!merged.$schema && fragment.$schema) {
+    merged.$schema = fragment.$schema;
+    changed = true;
+  }
+  const userMcp =
+    merged.mcp && typeof merged.mcp === "object" && !Array.isArray(merged.mcp)
+      ? merged.mcp
+      : {};
+  const mcp = { ...userMcp };
+  for (const [name, server] of Object.entries(fragment.mcp || {})) {
+    if (!(name in mcp)) {
+      mcp[name] = server;
+      changed = true;
+    }
+  }
+  if (changed && Object.keys(mcp).length > 0) merged.mcp = mcp;
+  return { config: merged, changed };
+}
+
+export default {
+  configureHooks(config) {
+    // OpenCode has no shell-hook chain; "configure" means deploying the
+    // instruction/agent/command surfaces + the MCP config merge.
+    const agentsMd = readBundleFile("opencode", "AGENTS.md");
+    if (!agentsMd) {
+      console.warn(
+        "         OpenCode bundle missing (harness/opencode/) — " +
+          "run scripts/harness_gen.py; skipping."
+      );
+      return;
+    }
+    mkdirSync(config.configDir, { recursive: true });
+    writeFileSync(join(config.configDir, "AGENTS.md"), agentsMd);
+
+    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}`);
+        if (content === null) continue;
+        writeFileSync(join(config.configDir, sub, name), content);
+        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);
+      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)."
+        );
+      }
+    }
+    console.log(
+      `         OpenCode configured (AGENTS.md + ${deployed} agent/command files).`
+    );
+  },
+};

package/installer/cli.js

@@ -21,6 +21,10 @@ const { values, positionals } = parseArgs({
     force: { type: "boolean", short: "f" },
     "no-system": { type: "boolean" },
     "with-ollama": { type: "boolean" },
+    // Foundation PR-3 — `npx arkaos install --profile <essential|complete|local-ai>`.
+    // Declared so it lands in `values.profile` instead of a free
+    // positional under strict:false (the documented --fix lesson).
+    profile: { type: "string" },
     // PR3.5 v3.74.1 — declared so `npx arkaos doctor --fix` lands in
     // `values.fix` rather than as a free positional under strict:false.
     // Eliminates the dead-branch fallback flagged by Marta in PR2's QG.
@@ -57,6 +61,7 @@ ArkaOS v${VERSION} — The Operating System for AI Agent Teams
 Usage:
   npx arkaos install          Install ArkaOS in current environment
   npx arkaos install --runtime <runtime>  Install for specific runtime
+  npx arkaos install --profile <profile>  Pick the install profile non-interactively
   npx arkaos init             Initialize project config (.arkaos.json)
   npx arkaos update           Update to latest version
   npx arkaos migrate          Migrate from v1 to v2
@@ -64,6 +69,7 @@ Usage:
   npx arkaos dashboard        Start monitoring dashboard
   npx arkaos autostart <enable|disable|status>  Start dashboard on boot
   npx arkaos autoupdate <enable|disable|status|run>  Keep ArkaOS updated automatically (daily check + notification)
+  npx arkaos menubar <enable|disable|status>  Menu bar launcher (macOS — ▲ quick actions)
   npx arkaos keys             Manage API keys (OpenAI, fal.ai, etc.)
   npx arkaos models           Model Fabric: which model runs each role
   npx arkaos models set <role> <provider>/<model>  Re-route a role
@@ -77,6 +83,9 @@ Options:
   -r, --runtime <name>   Target runtime: claude-code, codex, gemini, cursor
   -p, --path <dir>       Installation directory (default: auto-detect)
   -f, --force            Force reinstall, overwriting existing files
+  --profile <name>       Install profile: essential (venv, hooks, skills,
+                         dashboard, MCPs), complete (+ litellm[proxy], ffmpeg),
+                         local-ai (+ Ollama, local execution model)
   -v, --version          Show version
   -h, --help             Show this help
 
@@ -100,7 +109,20 @@ Examples:
 
 async function main() {
   switch (command) {
-    case "install":
+    case "install": {
+      // Validate --profile up front (before runtime detection) so a
+      // typo fails fast instead of silently falling back to the wizard.
+      let profileFlag;
+      if (values.profile !== undefined) {
+        const { normalizeProfileFlag, INSTALL_PROFILES } = await import("./profile.js");
+        profileFlag = normalizeProfileFlag(values.profile);
+        if (!profileFlag) {
+          console.error(
+            `Invalid --profile "${values.profile}". Valid values: ${INSTALL_PROFILES.join(", ")}`
+          );
+          process.exit(1);
+        }
+      }
       const runtime = values.runtime || await detectRuntime();
       await install({
         runtime,
@@ -108,8 +130,10 @@ async function main() {
         force: values.force,
         skipSystem: values["no-system"],
         withOllama: values["with-ollama"],
+        profileFlag,
       });
       break;
+    }
 
     case "init": {
       const { init } = await import("./init.js");
@@ -141,6 +165,12 @@ async function main() {
       break;
     }
 
+    case "menubar": {
+      const { menubar } = await import("./menubar.js");
+      await menubar(positionals.slice(1));
+      break;
+    }
+
     case "uninstall":
       const { uninstall } = await import("./uninstall.js");
       await uninstall();

package/installer/detect-runtime.js

@@ -69,6 +69,24 @@ const RUNTIMES = [
     skillsDir: () => join(homedir(), ".cursor", "skills"),
     settingsFile: () => join(homedir(), ".cursor", "settings.json"),
   },
+  {
+    // Foundation PR-6 — OpenCode first-class. Listed AFTER the existing
+    // runtimes so multi-runtime machines keep their current default
+    // (detection picks the first match).
+    id: "opencode",
+    name: "OpenCode",
+    detect: () => {
+      try {
+        execSync("opencode --version", { stdio: "pipe" });
+        return true;
+      } catch {
+        return existsSync(join(homedir(), ".config", "opencode"));
+      }
+    },
+    configDir: () => join(homedir(), ".config", "opencode"),
+    skillsDir: () => join(homedir(), ".config", "opencode", "commands"),
+    settingsFile: () => join(homedir(), ".config", "opencode", "opencode.json"),
+  },
 ];
 
 export async function detectRuntime() {