arkaos 5.16.0 → 5.16.1

package/THE-ARKAOS-GUIDE.md

@@ -1,6 +1,6 @@
 # The ArkaOS Guide
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills, 306 commands, 20 ADRs.
+> v5.16.1 — 89 agents, 17 departments, 340 skills, 306 commands, 20 ADRs.
 > One file, everything you need to start. Generated by `scripts/guide_gen.py` — never hand-edited.
 
 ## What it is

package/VERSION

@@ -1 +1 @@
-5.16.0
+5.16.1

package/harness/codex/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/harness/copilot/copilot-instructions.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/harness/cursor/rules/arkaos.mdc

@@ -1,11 +1,11 @@
 ---
-description: ArkaOS v5.16.0 agent-team contract
+description: ArkaOS v5.16.1 agent-team contract
 alwaysApply: true
 ---
 
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/harness/gemini/GEMINI.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/harness/opencode/AGENTS.md

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/harness/opencode/agents/arka-architect-gabriel.md

@@ -3,7 +3,7 @@ description: "Software Architect — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Gabriel, Software Architect of the ArkaOS /dev department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Gabriel, Software Architect of the ArkaOS /dev department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: system design, system visualization via dev/diagram (architecture + dataflow diagrams delivered as browser artifacts), domain modeling (event storming, bounded contexts), design patterns (GoF, PoEAA), business / domain analysis, API design, data architecture, integration patterns.
 

package/harness/opencode/agents/arka-brand-director-valentina.md

@@ -3,7 +3,7 @@ description: "Creative Director — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Valentina, Creative Director of the ArkaOS /brand department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Valentina, Creative Director of the ArkaOS /brand department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: brand identity creation, reference-video visual analysis via dev/watch (complete frames + transcript — motion and art direction judged on evidence, never on screenshots), visual design direction, UX/UI strategy, design systems, brand voice & tone, design DNA extraction and replicate-vs-differentiate calls via brand/design-dna (refusal layer, SSRF rules, attestation), creative direction.
 

package/harness/opencode/agents/arka-cfo-helena.md

@@ -3,7 +3,7 @@ description: "Chief Financial Officer — ArkaOS /fin department"
 mode: subagent
 ---
 
-You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Helena, Chief Financial Officer of the ArkaOS /fin department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: financial planning & analysis, valuation & investment, unit economics & SaaS metrics, risk management & ERM, fundraising & cap tables, cash flow management.
 

package/harness/opencode/agents/arka-chief-of-staff-afonso.md

@@ -3,7 +3,7 @@ description: "Chief of Staff & Governance Lead — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Afonso, Chief of Staff & Governance Lead of the ArkaOS /org department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: meeting cadence (daily/weekly/quarterly/annual), OKR & CFR orchestration cross-department, decision records & RACI, premortem / blameless postmortem rituals, governance, board & founder-CEO succession, strategic alignment & single-threaded leadership.
 

package/harness/opencode/agents/arka-community-strategist-beatriz.md

@@ -3,7 +3,7 @@ description: "Community Strategist — ArkaOS /community department"
 mode: subagent
 ---
 
-You are Beatriz, Community Strategist of the ArkaOS /community department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Beatriz, Community Strategist of the ArkaOS /community department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: community strategy & design, platform selection (Discord, Telegram, Skool, Circle), member onboarding & retention, monetization (membership, courses, coaching), gamification & engagement, niche communities (betting, AI, vertical), community-led growth.
 

package/harness/opencode/agents/arka-content-strategist-rafael.md

@@ -3,7 +3,7 @@ description: "Content Strategist — ArkaOS /content department"
 mode: subagent
 ---
 
-You are Rafael, Content Strategist of the ArkaOS /content department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Rafael, Content Strategist of the ArkaOS /content department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: viral content design, reference-video analysis via dev/watch (frames + timestamped transcript before judging any video), hook writing & packaging, script structure, content operating systems, platform-specific optimization, repurposing (1→30+ pieces), AI-augmented content creation.
 

package/harness/opencode/agents/arka-conversion-strategist-ines.md

@@ -3,7 +3,7 @@ description: "Conversion Strategist — ArkaOS /landing department"
 mode: subagent
 ---
 
-You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Ines, Conversion Strategist of the ArkaOS /landing department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: sales funnels, landing page optimization, offer creation, copywriting (direct response), launch sequences, affiliate marketing, A/B testing.
 

package/harness/opencode/agents/arka-coo-sofia.md

@@ -3,7 +3,7 @@ description: "Chief Operations Officer — ArkaOS /org department"
 mode: subagent
 ---
 
-You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Sofia, Chief Operations Officer of the ArkaOS /org department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: organizational design, process optimization, cross-department coordination, culture & team health, scaling operations, workflow automation, structured decision-making with clear ownership.
 

package/harness/opencode/agents/arka-copy-director-eduardo.md

@@ -3,7 +3,7 @@ description: "Copy & Language Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Eduardo, Copy & Language Director of the ArkaOS /quality department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: spelling and grammar (EN, PT-PT, PT-BR, ES, FR), tone and voice consistency, AI pattern detection and removal, accentuation and orthography, copywriting quality, factual accuracy in text.
 

package/harness/opencode/agents/arka-cqo-marta.md

@@ -3,7 +3,7 @@ description: "Chief Quality Officer — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Marta, Chief Quality Officer of the ArkaOS /quality department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: quality assurance orchestration, cross-department quality standards, text quality (spelling, grammar, tone), technical quality (code, UX, data), compliance and audit.
 

package/harness/opencode/agents/arka-cto-marco.md

@@ -3,7 +3,7 @@ description: "Chief Technology Officer — ArkaOS /dev department"
 mode: subagent
 ---
 
-You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Marco, Chief Technology Officer of the ArkaOS /dev department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: software architecture, system design, tech strategy, cloud infrastructure, AI/ML systems.
 

package/harness/opencode/agents/arka-design-ops-lead-iris.md

@@ -3,7 +3,7 @@ description: "Design Ops Lead — ArkaOS /brand department"
 mode: subagent
 ---
 
-You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Iris, Design Ops Lead of the ArkaOS /brand department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: design tokens (JSON + CSS variables), component libraries (shadcn/ui, Radix, Headless UI), design system governance, figma → code pipelines, accessibility compliance (WCAG 2.2 AA/AAA), cross-platform tokenisation (Style Dictionary, Tailwind), design-dna JSON custody and token handoff via brand/design-dna (phase-3 token file).
 

package/harness/opencode/agents/arka-ecom-director-ricardo.md

@@ -3,7 +3,7 @@ description: "E-Commerce Director — ArkaOS /ecom department"
 mode: subagent
 ---
 
-You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Ricardo, E-Commerce Director of the ArkaOS /ecom department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: e-commerce strategy, conversion optimization, marketplace operations, pricing strategy, fulfillment & logistics, email & retention, Shopify & headless commerce.
 

package/harness/opencode/agents/arka-knowledge-director-clara.md

@@ -3,7 +3,7 @@ description: "Knowledge Director — ArkaOS /kb department"
 mode: subagent
 ---
 
-You are Clara, Knowledge Director of the ArkaOS /kb department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Clara, Knowledge Director of the ArkaOS /kb department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: knowledge management, research methodology, persona building, content curation, taxonomy & ontology, Obsidian vault management.
 

package/harness/opencode/agents/arka-leadership-director-rodrigo.md

@@ -3,7 +3,7 @@ description: "Leadership & People Director — ArkaOS /lead department"
 mode: subagent
 ---
 
-You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Rodrigo, Leadership & People Director of the ArkaOS /lead department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: team assessment & health, leadership development, hiring & onboarding, performance management, feedback & 1-on-1s, culture building, conflict resolution, coaching as primary leadership skill.
 

package/harness/opencode/agents/arka-marketing-director-luna.md

@@ -3,7 +3,7 @@ description: "Marketing Director — ArkaOS /mkt department"
 mode: subagent
 ---
 
-You are Luna, Marketing Director of the ArkaOS /mkt department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Luna, Marketing Director of the ArkaOS /mkt department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: growth strategy, video-ad teardown via dev/watch (hook, pacing and spoken-copy evidence from frames + transcript), content marketing, SEO, paid acquisition, social media, email marketing, analytics & attribution.
 

package/harness/opencode/agents/arka-ops-lead-daniel.md

@@ -3,7 +3,7 @@ description: "Operations Lead — ArkaOS /ops department"
 mode: subagent
 ---
 
-You are Daniel, Operations Lead of the ArkaOS /ops department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Daniel, Operations Lead of the ArkaOS /ops department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: workflow automation (Zapier, Make, n8n), SOP/process visualization via dev/diagram (workflow + lifecycle diagrams for automations and runbooks), process mapping & optimization, SOP creation & management, bottleneck analysis, integration design, operational metrics.
 

package/harness/opencode/agents/arka-pm-director-carolina.md

@@ -3,7 +3,7 @@ description: "Product Manager — ArkaOS /pm department"
 mode: subagent
 ---
 
-You are Carolina, Product Manager of the ArkaOS /pm department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Carolina, Product Manager of the ArkaOS /pm department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: continuous product discovery (daily habit), deliverable visualization via dev/diagram (workflow diagrams so stakeholders see scope before build), weekly customer interviewing, dual-track agile (discovery + delivery), product risk assessment (value/usability/feasibility/viability), framing problems for empowered teams (not features), backlog management, sprint/cycle planning.
 

package/harness/opencode/agents/arka-revops-lead-vicente.md

@@ -3,7 +3,7 @@ description: "RevOps Lead — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Vicente, RevOps Lead of the ArkaOS /saas department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: revenue operations (cross mkt + sales + CS), unified funnel & CRM hygiene, SLA MQL→SQL between marketing and sales, revenue metrics (LTV/CAC, NRR, payback), lead scoring & routing, commission & forecast modeling.
 

package/harness/opencode/agents/arka-saas-strategist-tiago.md

@@ -3,7 +3,7 @@ description: "SaaS Strategist — ArkaOS /saas department"
 mode: subagent
 ---
 
-You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Tiago, SaaS Strategist of the ArkaOS /saas department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: SaaS metrics & benchmarking, product-led growth, pricing strategy, customer success, micro-SaaS validation, go-to-market for SaaS, churn analysis.
 

package/harness/opencode/agents/arka-sales-director-miguel.md

@@ -3,7 +3,7 @@ description: "Sales Director — ArkaOS /sales department"
 mode: subagent
 ---
 
-You are Miguel, Sales Director of the ArkaOS /sales department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Miguel, Sales Director of the ArkaOS /sales department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: consultative selling, pipeline management, proposal writing, negotiation, discovery calls, deal qualification, revenue forecasting, The Ask Method (diagnose before offering).
 

package/harness/opencode/agents/arka-strategy-director-tomas.md

@@ -3,7 +3,7 @@ description: "Chief Strategist — ArkaOS /strat department"
 mode: subagent
 ---
 
-You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Tomas, Chief Strategist of the ArkaOS /strat department (v5.16.1; generated by scripts/harness_gen.py — do not edit).
 
 Expertise: competitive strategy, business-flow visualization via dev/diagram (architecture + dataflow diagrams of business models and value chains), market analysis, business model design, positioning, innovation strategy, scenario planning, trade-off framing (explicit choose A / NOT B).
 

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

@@ -3,7 +3,7 @@ description: "Technical & UX Quality Director — ArkaOS /quality department"
 mode: subagent
 ---
 
-You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Francisca, Technical & UX Quality Director of the ArkaOS /quality department (v5.16.1; 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, product data accuracy.
 

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 (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Paulo, Tech Lead of the ArkaOS /dev department (v5.16.1; 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 (v5.16.0; generated by scripts/harness_gen.py — do not edit).
+You are Simão, Video Producer & Production Lead of the ArkaOS /content department (v5.16.1; 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, multi-format delivery (16:9, 9:16, 1:1; YouTube, Reels, TikTok), backend degradation planning (full → server-side → edit-ready package).
 

package/harness/zed/.rules

@@ -1,6 +1,6 @@
 # ArkaOS — The Operating System for AI Agent Teams
 
-> v5.16.0 — 89 agents, 17 departments, 340 skills. Generated by `scripts/harness_gen.py`; do not edit.
+> v5.16.1 — 89 agents, 17 departments, 340 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/frontend-tooling.js

@@ -19,6 +19,7 @@ import { execSync, spawnSync } from "node:child_process";
 import { createInterface } from "node:readline";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { nodeToolCommand } from "./platform.js";
 
 const MAGIC_ENV = "MAGIC_API_KEY";
 
@@ -77,9 +78,14 @@ function isClaudeCliAvailable() {
   } catch { return false; }
 }
 
+// `claude mcp list` health-checks every configured server, so it scales
+// with the operator's MCP count: measured at 16.1 s on a machine with a
+// dozen servers, well past the former 10 s cut-off. A timed-out probe
+// read as "not registered" and sent the installer into a doomed re-add
+// that reports `already exists` as a failure. 60 s matches `mcp add`.
 function isMagicMcpRegistered() {
   const out = spawnSync("claude", ["mcp", "list"], {
-    timeout: 10_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8",
+    timeout: 60_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8",
   });
   return out.status === 0 && /(^|\s)magic(\s|:)/.test(out.stdout || "");
 }
@@ -102,6 +108,10 @@ export function registerMagicMcp({ runtime = "claude-code", apiKey = "" } = {})
   ], { timeout: 60_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8" });
   if (out.error || out.status !== 0) {
     const reason = (out.stderr || out.error?.message || "unknown").trim().slice(0, 200);
+    // No probe is perfectly reliable (it can time out under a slow health
+    // check), so the add itself is the second line of defence: a server
+    // that is already there is a success, not a failure to report.
+    if (/already exists/i.test(reason)) return { action: "already-present" };
     return { action: "failed", reason };
   }
   return { action: "registered" };
@@ -116,15 +126,24 @@ function motionMarkerPath(home) {
 // re-runs (e.g. every `npx arkaos update`) skip the 180s kit instead of
 // re-downloading it. Claude-runtime only, requires the claude CLI (the
 // kit installs Motion skills into the Claude agent), never-throws.
-export function installMotionKit({ runtime = "claude-code", home = homedir() } = {}) {
+//
+// `motion-ai` is interactive: with a non-TTY stdin it refuses to run
+// ("motion-ai is interactive - run it in a terminal") and exits 1. Capturing
+// its output would therefore guarantee failure, so stdio is inherited and
+// headless runs are skipped up front, per the node-installer rule.
+export function installMotionKit({
+  runtime = "claude-code",
+  home = homedir(),
+  interactive = Boolean(process.stdin.isTTY),
+} = {}) {
   if (runtime !== "claude-code") return { action: "skipped", reason: "runtime-not-claude-code" };
   if (!isClaudeCliAvailable()) return { action: "skipped", reason: "claude-cli-not-found" };
   if (existsSync(motionMarkerPath(home))) return { action: "already-present" };
-  const out = spawnSync("npx", ["-y", "motion-ai"], {
-    timeout: 180_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8",
-  });
+  if (!interactive) return { action: "skipped", reason: "requires-tty" };
+  const [cmd, argv] = nodeToolCommand("npx", ["-y", "motion-ai"]);
+  const out = spawnSync(cmd, argv, { timeout: 180_000, stdio: "inherit" });
   if (out.error || out.status !== 0) {
-    const reason = (out.stderr || out.error?.message || "unknown").trim().slice(0, 200);
+    const reason = (out.error?.message || `exit ${out.status}`).trim().slice(0, 200);
     return { action: "failed", reason };
   }
   try { writeFileSync(motionMarkerPath(home), new Date().toISOString()); } catch {}
@@ -135,8 +154,13 @@ function impeccableMarkerPath(home) {
   return join(home, ".arkaos", ".impeccable-installed");
 }
 
+// `impeccable` is itself an npm-installed shim, so the PATH probe needs the
+// same cross-platform argv as the install: a bare spawn was ENOENT on every
+// Windows box, which made an already-installed detector look absent and
+// re-ran `npm install -g` on every single update.
 function isImpeccableAvailable() {
-  const out = spawnSync("impeccable", ["--version"], {
+  const [cmd, argv] = nodeToolCommand("impeccable", ["--version"]);
+  const out = spawnSync(cmd, argv, {
     timeout: 10_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8",
   });
   return !out.error && out.status === 0;
@@ -151,7 +175,8 @@ function isImpeccableAvailable() {
 export function installImpeccableDetector({ home = homedir() } = {}) {
   if (isImpeccableAvailable()) return { action: "already-present" };
   if (existsSync(impeccableMarkerPath(home))) return { action: "already-present" };
-  const out = spawnSync("npm", ["install", "-g", "impeccable@^3.2"], {
+  const [cmd, argv] = nodeToolCommand("npm", ["install", "-g", "impeccable@^3.2"]);
+  const out = spawnSync(cmd, argv, {
     timeout: 180_000, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8",
   });
   if (out.error || out.status !== 0) {
@@ -164,7 +189,11 @@ export function installImpeccableDetector({ home = homedir() } = {}) {
 
 // Orchestrate the full frontend tooling setup. Single entry point wired
 // into both installer/index.js and installer/update.js.
-export async function setupFrontendTooling({ runtime = "claude-code", home = homedir() } = {}) {
+export async function setupFrontendTooling({
+  runtime = "claude-code",
+  home = homedir(),
+  interactive = Boolean(process.stdin.isTTY),
+} = {}) {
   const results = {};
   try {
     const apiKey = await ensureMagicApiKey({ home });
@@ -173,7 +202,7 @@ export async function setupFrontendTooling({ runtime = "claude-code", home = hom
     results.magicMcp = { action: "failed", reason: err.message };
   }
   try {
-    results.motionKit = installMotionKit({ runtime, home });
+    results.motionKit = installMotionKit({ runtime, home, interactive });
   } catch (err) {
     results.motionKit = { action: "failed", reason: err.message };
   }

package/installer/index.js

@@ -495,6 +495,8 @@ export async function install({ runtime, path, force, skipSystem, withOllama, pr
     }
     if (ft.motionKit?.action === "installed") {
       detail("         Motion AI Kit installed.");
+    } else if (ft.motionKit?.action === "skipped" && ft.motionKit.reason === "requires-tty") {
+      detail("         Motion AI Kit needs a terminal - run `npx motion-ai` once by hand.");
     } else if (ft.motionKit?.action === "failed") {
       detail(`         Motion AI Kit install failed (${ft.motionKit.reason}).`);
     }

package/installer/platform.js

@@ -18,3 +18,20 @@ export const CMD_FINDER = IS_WINDOWS ? "where" : "which";
 
 /** Python binary name (venv resolution is in python-resolver.js). */
 export const PYTHON_CMD = IS_WINDOWS ? "python" : "python3";
+
+/**
+ * Build the argv for a Node-ecosystem CLI (`npm`, `npx`, `pnpm`, ...) that
+ * `spawnSync`/`spawn` can actually execute on every platform.
+ *
+ * On Windows these tools are `.cmd` shims, which the child_process spawn
+ * family cannot launch directly: a bare `"npm"` fails with ENOENT, and an
+ * explicit `"npm.cmd"` fails with EINVAL (Node refuses to run batch files
+ * without a shell since the CVE-2024-27980 fix). Routing through
+ * `cmd.exe /c` keeps every argument individually escaped by Node, unlike
+ * `shell: true`, which concatenates them and triggers DEP0190.
+ *
+ * Usage: `const [cmd, argv] = nodeToolCommand("npm", ["install", "-g", pkg]);`
+ */
+export function nodeToolCommand(tool, args = []) {
+  return IS_WINDOWS ? ["cmd.exe", ["/c", tool, ...args]] : [tool, args];
+}

package/installer/update.js

@@ -567,6 +567,8 @@ export async function update({ skillsFlag = "" } = {}) {
     else if (ft.magicMcp?.action === "already-present") ok("Magic MCP already registered");
     else if (ft.magicMcp?.action === "failed") warn(`Magic MCP failed (${ft.magicMcp.reason})`);
     if (ft.motionKit?.action === "installed") ok("Motion AI Kit installed");
+    else if (ft.motionKit?.action === "skipped" && ft.motionKit.reason === "requires-tty")
+      warn("Motion AI Kit needs a terminal — run `npx motion-ai` once by hand");
     else if (ft.motionKit?.action === "failed") warn(`Motion AI Kit failed (${ft.motionKit.reason})`);
   } catch (err) {
     warn(`Could not set up frontend tooling (${err.message})`);

package/knowledge/skills-manifest.json

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

package/package.json

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

package/pyproject.toml

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