arkaos 4.13.2 → 4.14.0

package/installer/update.js

@@ -1,9 +1,11 @@
-import { existsSync, readFileSync, writeFileSync, copyFileSync, chmodSync, mkdirSync, readdirSync, cpSync, statSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, copyFileSync, chmodSync, mkdirSync, readdirSync, cpSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
 import { homedir } from "node:os";
 import { execSync } from "node:child_process";
 import { ensureVenv, ensureVenvHealthy, getArkaosPython, pipInstall } from "./python-resolver.js";
-import { copyHookLib } from "./hook-lib.js";
+import { copyHookLib, copyHookAssets } from "./hook-lib.js";
+import { deploySkills } from "./skill-deploy.js";
+import { deprecationNotice, resolveSkillsMode } from "./skills-mode.js";
 import { deployCoreSnapshot } from "./core-snapshot.js";
 import { getRuntimeConfig } from "./detect-runtime.js";
 import { loadAdapter } from "./index.js";
@@ -16,7 +18,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const ARKAOS_ROOT = resolve(__dirname, "..");
 const VERSION = JSON.parse(readFileSync(join(ARKAOS_ROOT, "package.json"), "utf-8")).version;
 
-export async function update() {
+export async function update({ skillsFlag = "" } = {}) {
   const installDir = join(homedir(), ".arkaos");
   const manifestPath = join(installDir, "install-manifest.json");
   const profilePath = join(installDir, "profile.json");
@@ -207,6 +209,8 @@ export async function update() {
     "cwd-changed",
     "pre-tool-use",
     "stop",
+    "subagent-stop",
+    "session-end",
   ];
   const hookExt = HOOK_EXT;
   const srcHooksDir = join(ARKAOS_ROOT, "config", "hooks");
@@ -246,6 +250,13 @@ export async function update() {
     console.log("         ✓ Hook lib updated (_lib/)");
   }
 
+  // F2-6 fast-path shims + gate manifest (same shared deploy as the
+  // fresh-install path — single asset list in hook-lib.js).
+  const assetCount = copyHookAssets(srcHooksDir, destHooksDir);
+  if (assetCount > 0) {
+    console.log(`         ✓ Hook fast-path assets updated (${assetCount})`);
+  }
+
   // Re-register hooks in the runtime's settings file.
   // Without this, updating from an older version leaves settings.json
   // frozen at the previous hook spec (missing new hooks, stale timeouts).
@@ -323,82 +334,36 @@ export async function update() {
   // never deployed anything else.
   console.log("  [6/8] Updating /arka skill...");
   const skillsBase = join(homedir(), ".claude", "skills");
-  const skillSrc = join(ARKAOS_ROOT, "arka", "SKILL.md");
   const skillDest = join(skillsBase, "arka");
-  mkdirSync(skillDest, { recursive: true });
-  if (existsSync(skillSrc)) {
-    safeResolveMarkdown(skillSrc, join(skillDest, "SKILL.md"));
-    writeFileSync(join(skillDest, ".repo-path"), ARKAOS_ROOT);
-    writeFileSync(join(skillDest, "VERSION"), VERSION);
-    console.log("         ✓ /arka skill updated");
-  }
-
-  // Department skills + sub-skills + agent personas.
-  // Keep in sync with installer/index.js::installSkill — if anything
-  // changes about how top-level skills or agents are structured, both
-  // functions must be updated together.
-  const listSubdirs = (parent) => {
-    if (!existsSync(parent)) return [];
-    try {
-      return readdirSync(parent, { withFileTypes: true })
-        .filter((e) => e.isDirectory())
-        .map((e) => e.name);
-    } catch {
-      return [];
-    }
-  };
-  const copyResources = (src, dest) => {
-    for (const res of ["scripts", "references", "assets"]) {
-      const s = join(src, res);
-      if (!existsSync(s)) continue;
-      try { cpSync(s, join(dest, res), { recursive: true }); } catch {}
-    }
-  };
-  const deployTop = (src, arkaName) => {
-    const md = join(src, "SKILL.md");
-    if (!existsSync(md)) return false;
-    const dest = join(skillsBase, arkaName);
-    mkdirSync(dest, { recursive: true });
-    safeResolveMarkdown(md, join(dest, "SKILL.md"));
-    copyResources(src, dest);
-    return true;
-  };
-
-  const deptRoot = join(ARKAOS_ROOT, "departments");
-  let deptCount = 0;
-  let subCount = 0;
-  for (const dept of listSubdirs(deptRoot)) {
-    if (deployTop(join(deptRoot, dept), `arka-${dept}`)) deptCount++;
-    for (const sub of listSubdirs(join(deptRoot, dept, "skills"))) {
-      if (deployTop(join(deptRoot, dept, "skills", sub), `arka-${sub}`)) subCount++;
-    }
-  }
-  if (deptCount > 0) {
-    console.log(`         ✓ ${deptCount} department skills updated`);
-  }
-  if (subCount > 0) {
-    console.log(`         ✓ ${subCount} sub-skills updated`);
-  }
-
-  const agentsBase = join(homedir(), ".claude", "agents");
-  mkdirSync(agentsBase, { recursive: true });
-  let agentCount = 0;
-  for (const dept of listSubdirs(deptRoot)) {
-    const agentsSrc = join(deptRoot, dept, "agents");
-    if (!existsSync(agentsSrc)) continue;
-    try {
-      for (const file of readdirSync(agentsSrc)) {
-        if (!file.endsWith(".md")) continue;
-        const srcFile = join(agentsSrc, file);
-        try { if (!statSync(srcFile).isFile()) continue; } catch { continue; }
-        const base = file.replace(/\.md$/, "");
-        copyFileSync(srcFile, join(agentsBase, `arka-${base}.md`));
-        agentCount++;
-      }
-    } catch {}
-  }
-  if (agentCount > 0) {
-    console.log(`         ✓ ${agentCount} agent personas updated`);
+  // Single shared deployment (installer/skill-deploy.js) — identical
+  // surface to a fresh install BY CONSTRUCTION: main /arka + nested
+  // reference bundle + department hubs + sub-skills + META skills
+  // (arka-flow & co. were silently missing from update-only machines
+  // before F2-7c-pre) + agent personas.
+  const skillsMode = resolveSkillsMode({ flag: skillsFlag, fresh: false });
+  if (skillsMode.deprecated) {
+    console.log("         " + deprecationNotice());
+  }
+  const skillCounts = deploySkills({
+    repoRoot: ARKAOS_ROOT,
+    skillsBase,
+    agentsBase: join(homedir(), ".claude", "agents"),
+    version: VERSION,
+    mode: skillsMode.mode,
+  });
+  console.log(`         ✓ skill set mode: ${skillsMode.mode}`);
+  if (skillCounts.main) console.log("         ✓ /arka skill updated");
+  if (skillCounts.depts > 0) {
+    console.log(`         ✓ ${skillCounts.depts} department skills updated`);
+  }
+  if (skillCounts.subs > 0) {
+    console.log(`         ✓ ${skillCounts.subs} sub-skills updated`);
+  }
+  if (skillCounts.meta > 0) {
+    console.log(`         ✓ ${skillCounts.meta} meta skills updated`);
+  }
+  if (skillCounts.agents > 0) {
+    console.log(`         ✓ ${skillCounts.agents} agent personas updated`);
   }
 
   // MCP infrastructure: deploy mcps/ subdirectories, registry, and
@@ -436,7 +401,18 @@ export async function update() {
       }
     }
 
-    console.log("         ✓ MCP infrastructure updated (profiles, stacks, scripts, arka-prompts server)");
+    // arka-tools server (F2-3) — mirrors the same block in installSkill().
+    const mcpToolsSrc = join(mcpsSrc, "arka-tools");
+    const mcpToolsDest = join(skillsBase, "arka", "mcp-tools");
+    if (existsSync(mcpToolsSrc)) {
+      if (!existsSync(mcpToolsDest)) mkdirSync(mcpToolsDest, { recursive: true });
+      for (const f of ["server.py", "pyproject.toml"]) {
+        const src = join(mcpToolsSrc, f);
+        if (existsSync(src)) copyFileSync(src, join(mcpToolsDest, f));
+      }
+    }
+
+    console.log("         ✓ MCP infrastructure updated (profiles, stacks, scripts, arka-prompts + arka-tools servers)");
 
     // Higgsfield MCP is registered but requires an account + API key to connect.
     // Non-blocking warning: the update succeeds even without a Higgsfield account.

package/knowledge/commands-registry.json.bak

@@ -1,14 +1,14 @@
 {
   "_meta": {
     "version": "3.0.0",
-    "generated": "2026-07-09T15:18:25Z",
-    "total_commands": 262,
+    "generated": "2026-07-10T13:12:22Z",
+    "total_commands": 269,
     "generator": "core/registry/generator.py",
     "departments": {
-      "arka": 19,
+      "arka": 21,
       "brand": 12,
       "community": 14,
-      "content": 14,
+      "content": 19,
       "dev": 36,
       "ecom": 18,
       "fin": 10,
@@ -317,6 +317,44 @@
       "requires_branch": false,
       "modifies_code": false
     },
+    {
+      "id": "arka-refine",
+      "command": "/arka refine <rough idea>",
+      "department": "arka",
+      "description": "Turn a vague or domain-unfamiliar ask into a precise English prompt by asking about the topic first (arka-refine). Auto-suggested on vague requests.",
+      "lead_agent": "arka",
+      "keywords": [],
+      "examples": [],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
+    {
+      "id": "arka-recipes",
+      "command": "/arka recipes [list\\|show\\|apply] <slug>",
+      "department": "arka",
+      "description": "Reuse validated QG-approved feature builds (arka-recipes). Synapse L7.6 auto-surfaces matches.",
+      "lead_agent": "arka",
+      "keywords": [
+        "recipe",
+        "recipes",
+        "receita",
+        "reuse",
+        "validated build",
+        "apply recipe",
+        "feature template"
+      ],
+      "examples": [
+        "que receitas temos",
+        "apply the laravel login recipe",
+        "reusa a receita de auth"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
     {
       "id": "do",
       "command": "/do <description>",
@@ -1213,6 +1251,135 @@
       "requires_branch": false,
       "modifies_code": false
     },
+    {
+      "id": "content-video",
+      "command": "/content video <topic>",
+      "department": "content",
+      "description": "End-to-end video production (research → script → assets → render)",
+      "lead_agent": "arka-content",
+      "keywords": [
+        "produce video",
+        "video production",
+        "produz um vídeo",
+        "faz um vídeo",
+        "edit video",
+        "edita o vídeo",
+        "render video",
+        "monta o vídeo",
+        "hyperframes"
+      ],
+      "examples": [
+        "produz um vídeo sobre agentes de AI",
+        "produce a video about our launch",
+        "edita este vídeo com legendas e b-roll"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
+    {
+      "id": "content-trends",
+      "command": "/content trends <niche>",
+      "department": "content",
+      "description": "Demand-first trend and niche analysis with STEPPS scoring",
+      "lead_agent": "arka-content",
+      "keywords": [
+        "trends",
+        "trending",
+        "niche analysis",
+        "análise de nicho",
+        "que trends",
+        "what's trending",
+        "encontra um nicho",
+        "trend hunt",
+        "nichos"
+      ],
+      "examples": [
+        "que trends há em fitness agora",
+        "find me a profitable faceless niche",
+        "analisa o nicho de finanças pessoais"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
+    {
+      "id": "content-research",
+      "command": "/content research <topic>",
+      "department": "content",
+      "description": "Sourced research compiled into a production brief",
+      "lead_agent": "arka-content",
+      "keywords": [
+        "research topic",
+        "pesquisa o tema",
+        "production brief",
+        "brief de produção",
+        "research for video",
+        "pesquisa para o vídeo",
+        "fact check topic"
+      ],
+      "examples": [
+        "faz o research para o vídeo sobre LLMs",
+        "research this topic with sources",
+        "prepara o brief de produção do episódio 3"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
+    {
+      "id": "content-video-setup",
+      "command": "/content video-setup",
+      "department": "content",
+      "description": "Video production environment bootstrap (Hyperframes, Agent-Reach, Higgsfield)",
+      "lead_agent": "arka-content",
+      "keywords": [
+        "video setup",
+        "setup video environment",
+        "instala hyperframes",
+        "configura produção de vídeo",
+        "agent-reach setup",
+        "video prerequisites"
+      ],
+      "examples": [
+        "prepara o ambiente de produção de vídeo",
+        "install hyperframes and agent-reach",
+        "video-setup"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
+    {
+      "id": "content-shorts",
+      "command": "/content shorts <niche>",
+      "department": "content",
+      "description": "Batch production of 3-5 rendered shorts with posting schedule",
+      "lead_agent": "arka-content",
+      "keywords": [
+        "shorts batch",
+        "produce shorts",
+        "produz shorts",
+        "reels batch",
+        "tiktok batch",
+        "faz-me uns shorts",
+        "render shorts",
+        "lote de shorts"
+      ],
+      "examples": [
+        "produz um lote de 5 shorts sobre finanças",
+        "produce a batch of shorts for the launch",
+        "faz-me shorts desta masterclass"
+      ],
+      "source": "builtin",
+      "tier": 2,
+      "requires_branch": false,
+      "modifies_code": false
+    },
     {
       "id": "dev-feature",
       "command": "/dev feature <description>",