arkaos 2.25.0 → 2.31.0

package/departments/brand/agents/design-ops/design-ops-lead.yaml

@@ -0,0 +1,78 @@
+id: design-ops-lead-iris
+name: Iris
+role: Design Ops Lead
+department: brand
+tier: 1
+model: sonnet
+
+parent_squad: brand
+sub_squad_role: lead
+
+behavioral_dna:
+  disc:
+    primary: D
+    secondary: C
+    communication_style: "Direct, blueprint-driven, defends production quality without smothering creative intent"
+    under_pressure: "Pushes back on shortcuts; protects the design system from drift"
+    motivator: "A design system that ships consistently across every surface"
+  enneagram:
+    type: 8
+    wing: 9
+    core_motivation: "Make the right thing also be the easy thing for designers and engineers"
+    core_fear: "Inconsistent UI shipped because nobody owned the production rails"
+    subtype: self-preservation
+  big_five:
+    openness: 60
+    conscientiousness: 88
+    extraversion: 52
+    agreeableness: 55
+    neuroticism: 28
+  mbti:
+    type: ESTJ
+
+mental_models:
+  primary:
+    - "Atomic Design (Frost)"
+    - "Design Tokens W3C Spec"
+    - "Single Source of Truth (Wheeler)"
+  secondary:
+    - "Theory of Constraints (Goldratt)"
+    - "Cynefin (Snowden)"
+    - "WCAG 2.2 AA"
+
+authority:
+  orchestrate: true
+  approve_quality: true
+  delegates_to:
+    - extraction-script-writer
+    - wcag-auditor
+    - shadcn-padronizer
+  escalates_to: brand-director-valentina
+
+expertise:
+  domains:
+    - 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)
+  frameworks:
+    - Atomic Design (Frost)
+    - Design Tokens Community Group
+    - WCAG 2.2
+    - Style Dictionary
+    - shadcn/ui conventions
+    - Tailwind CSS configuration
+  depth: master
+  years_equivalent: 12
+
+communication:
+  language: en
+  tone: "precise, blueprint-driven, low-drama"
+  vocabulary_level: advanced
+  preferred_format: "tables, JSON specs, before/after diffs"
+  avoid:
+    - "design by feel without a token spec"
+    - "ad-hoc one-off components"
+    - "shipping without accessibility audit"

package/departments/brand/agents/design-ops/extraction-script-writer.yaml

@@ -0,0 +1,74 @@
+id: extraction-script-writer-nia
+name: Nia
+role: Design Extraction Engineer
+department: brand
+tier: 2
+model: sonnet
+
+parent_squad: brand
+sub_squad_role: extraction-script-writer
+
+behavioral_dna:
+  disc:
+    primary: C
+    secondary: D
+    communication_style: "Investigative, evidence-first, writes the script before opining"
+    under_pressure: "Goes deeper into the source; refuses to guess"
+    motivator: "Reproducible extraction pipelines that turn a live site into structured tokens"
+  enneagram:
+    type: 5
+    wing: 6
+    core_motivation: "Understand a design system well enough to rebuild it from primitives"
+    core_fear: "Shipping a tokenisation that looks right but is silently wrong"
+    subtype: self-preservation
+  big_five:
+    openness: 78
+    conscientiousness: 82
+    extraversion: 35
+    agreeableness: 50
+    neuroticism: 30
+  mbti:
+    type: INTP
+
+mental_models:
+  primary:
+    - "Design Tokens W3C Spec"
+    - "Unix Philosophy (Pike & Kernighan)"
+    - "Reverse-Engineering Discipline"
+  secondary:
+    - "AST-based code analysis"
+    - "CSS Specificity Model"
+    - "Color Theory (Albers)"
+
+authority:
+  orchestrate: false
+  approve_quality: false
+  delegates_to: []
+  escalates_to: design-ops-lead-iris
+
+expertise:
+  domains:
+    - CSS extraction (computed styles, custom properties)
+    - color palette reverse-engineering from screenshots / live DOM
+    - typography token harvesting (font-family, size, weight, line-height scales)
+    - spacing and grid token inference
+    - figma file parsing
+    - chromium-headless capture pipelines
+  frameworks:
+    - W3C Design Tokens spec
+    - Style Dictionary
+    - Tailwind CSS token format
+    - shadcn/ui CSS variable convention
+    - DTCG JSON schema
+  depth: expert
+  years_equivalent: 9
+
+communication:
+  language: en
+  tone: "concise, citation-heavy, almost terse"
+  vocabulary_level: advanced
+  preferred_format: "JSON specs, before/after color swatches, script snippets"
+  avoid:
+    - "guessing token values without inspecting the source"
+    - "exposing hardcoded RGB instead of named tokens"
+    - "premature opinions on visual quality (that's brand-director territory)"

package/departments/brand/agents/design-ops/shadcn-padronizer.yaml

@@ -0,0 +1,76 @@
+id: shadcn-padronizer-leo
+name: Leo
+role: Component Library Padronizer
+department: brand
+tier: 2
+model: sonnet
+
+parent_squad: brand
+sub_squad_role: shadcn-padronizer
+
+behavioral_dna:
+  disc:
+    primary: C
+    secondary: I
+    communication_style: "Pattern-oriented, shows the canonical component before refactoring"
+    under_pressure: "Stays in the design system; refuses to fork components for one-offs"
+    motivator: "A shadcn/ui-shaped library that every project in the org can adopt verbatim"
+  enneagram:
+    type: 1
+    wing: 9
+    core_motivation: "One canonical component, used everywhere, evolving cleanly"
+    core_fear: "Five teams shipping five Button components that diverge over a quarter"
+    subtype: social
+  big_five:
+    openness: 65
+    conscientiousness: 84
+    extraversion: 50
+    agreeableness: 58
+    neuroticism: 30
+  mbti:
+    type: ISTP
+
+mental_models:
+  primary:
+    - "shadcn/ui composition philosophy"
+    - "Headless UI patterns (Radix, React Aria)"
+    - "Atomic Design (Frost)"
+  secondary:
+    - "Tailwind CSS configuration"
+    - "CVA (class-variance-authority) variants"
+    - "Theming via CSS variables"
+
+authority:
+  orchestrate: false
+  approve_quality: false
+  delegates_to: []
+  escalates_to: design-ops-lead-iris
+
+expertise:
+  domains:
+    - shadcn/ui component generation and customisation
+    - Radix UI primitives integration
+    - Tailwind configuration and theme tokens
+    - CVA variants and slot patterns
+    - dark mode and theme switching
+    - component API surface design (props, slots, polymorphic components)
+    - migration from MUI / Chakra / Ant Design to shadcn
+  frameworks:
+    - shadcn/ui
+    - Radix UI
+    - React Aria (Adobe)
+    - Tailwind CSS
+    - class-variance-authority
+    - tailwind-merge
+  depth: expert
+  years_equivalent: 8
+
+communication:
+  language: en
+  tone: "code-first, pragmatic, mild humour"
+  vocabulary_level: advanced
+  preferred_format: "tsx snippets, before/after component diffs, migration guides"
+  avoid:
+    - "rebuilding a primitive that Radix already ships"
+    - "inline styles that bypass the theme tokens"
+    - "magic numbers in className strings"

package/departments/brand/agents/design-ops/wcag-auditor.yaml

@@ -0,0 +1,76 @@
+id: wcag-auditor-oren
+name: Oren
+role: Accessibility Auditor
+department: brand
+tier: 2
+model: sonnet
+
+parent_squad: brand
+sub_squad_role: wcag-auditor
+
+behavioral_dna:
+  disc:
+    primary: C
+    secondary: S
+    communication_style: "Methodical, cites the exact WCAG criterion, never bluffs"
+    under_pressure: "Reports findings in priority order with severity; refuses to skip levels"
+    motivator: "Interfaces every human can actually use, including with assistive tech"
+  enneagram:
+    type: 1
+    wing: 2
+    core_motivation: "Make accessibility the default rather than a retrofit"
+    core_fear: "A real user blocked by a contrast ratio or focus-trap nobody caught"
+    subtype: social
+  big_five:
+    openness: 55
+    conscientiousness: 92
+    extraversion: 38
+    agreeableness: 68
+    neuroticism: 32
+  mbti:
+    type: ISTJ
+
+mental_models:
+  primary:
+    - "WCAG 2.2 (AA + AAA)"
+    - "POUR Principles (Perceivable, Operable, Understandable, Robust)"
+    - "ARIA Authoring Practices"
+  secondary:
+    - "Inclusive Design Microsoft toolkit"
+    - "Cognitive Load Theory (Sweller)"
+    - "Universal Design (Mace)"
+
+authority:
+  orchestrate: false
+  approve_quality: false
+  delegates_to: []
+  escalates_to: design-ops-lead-iris
+
+expertise:
+  domains:
+    - WCAG 2.2 AA / AAA conformance auditing
+    - color contrast ratio analysis (4.5:1 text, 3:1 large text and UI)
+    - keyboard navigation and focus management
+    - screen reader compatibility (NVDA, JAWS, VoiceOver)
+    - ARIA pattern review (no-redundant-roles, correct landmarks)
+    - cognitive accessibility (reading level, error recovery)
+    - accessibility statement drafting
+  frameworks:
+    - WCAG 2.2
+    - WAI-ARIA 1.2
+    - ATAG 2.0
+    - EAA / EN 301 549
+    - axe-core ruleset
+    - Section 508
+  depth: master
+  years_equivalent: 11
+
+communication:
+  language: en
+  tone: "neutral, criterion-cited, never moralising"
+  vocabulary_level: advanced
+  preferred_format: "issue tables (severity / criterion / location / fix), conformance reports"
+  avoid:
+    - "claiming AAA without measurement"
+    - "blocking a ship on a Level AAA edge case"
+    - "fixing accessibility late instead of as a design constraint"

package/departments/dev/skills/mcp/SKILL.md

@@ -118,3 +118,19 @@ The user should set these in their shell profile or project `.env`, or run `bash
 - `DISCORD_TOKEN` — Discord bot integration
 - `WHATSAPP_API_TOKEN` / `WHATSAPP_PHONE_ID` — WhatsApp Business API
 - `TEAMS_APP_ID` / `TEAMS_APP_SECRET` — Microsoft Teams
+
+## Recommended baseline (Orgo 2026-05-13)
+
+Three MCPs that the 2026-05-13 podcast pattern recommends for every
+agent-business setup. They are *optional* in the registry but worth
+adopting deliberately:
+
+| MCP | Why | When to add |
+| --- | --- | --- |
+| **Composio** | One connector, thousands of apps (Gmail, Slack, Notion, GitHub). Handles auth + tool calling without per-tool wiring. | Any agent that needs broad SaaS integration. Cuts setup time on every new customer. |
+| **Agent Mail** | Gives each agent a real email address that it can read and send from. Adds the "digital employee" feel that closes deals. | Customer-facing agents, executive assistants, follow-up workflows. |
+| **XMCP** | Twitter / X's official MCP. Brings community wisdom into the agent's context — recent threads, hot takes, real-time discourse. | Research-heavy workflows, content / community / sales squads. |
+
+These pair naturally with the existing `Firecrawl` (deep scrape),
+`Context7` (official docs), and `Perplexity` (real-time web). The
+`/arka research` skill fans out across all five.

package/installer/cli.js

@@ -20,6 +20,7 @@ const { values, positionals } = parseArgs({
     path: { type: "string", short: "p" },
     force: { type: "boolean", short: "f" },
     "no-system": { type: "boolean" },
+    "with-ollama": { type: "boolean" },
   },
   allowPositionals: true,
   strict: false,
@@ -75,7 +76,13 @@ async function main() {
   switch (command) {
     case "install":
       const runtime = values.runtime || await detectRuntime();
-      await install({ runtime, path: values.path, force: values.force, skipSystem: values["no-system"] });
+      await install({
+        runtime,
+        path: values.path,
+        force: values.force,
+        skipSystem: values["no-system"],
+        withOllama: values["with-ollama"],
+      });
       break;
 
     case "init": {

package/installer/doctor.js

@@ -4,7 +4,7 @@ import { homedir } from "node:os";
 import { execSync } from "node:child_process";
 import { getArkaosPython, getVenvPython, canImportCore, getRepoRoot } from "./python-resolver.js";
 import { IS_WINDOWS, HOOK_EXT, CMD_FINDER } from "./platform.js";
-import { checkNode, checkObsidian } from "./system-tools.js";
+import { checkNode, checkObsidian, checkOllama } from "./system-tools.js";
 
 const INSTALL_DIR = join(homedir(), ".arkaos");
 
@@ -147,6 +147,18 @@ const checks = [
       return `Install Node.js 20+ from ${s.fallbackUrl || "https://nodejs.org/en/download"}`;
     },
   },
+  {
+    name: "ollama",
+    description: "Ollama present (optional — cognitive layer LLM runtime)",
+    severity: "warn",
+    check: () => checkOllama().installed,
+    fix: () => {
+      const s = checkOllama();
+      if (s.needsAction === "start") return `Run: ${s.suggestedCommand}`;
+      if (s.suggestedCommand) return `Run: ${s.suggestedCommand}`;
+      return `Install Ollama from ${s.fallbackUrl || "https://ollama.com/download"}`;
+    },
+  },
   {
     name: "claude-code-version",
     description: "Claude Code 2.1.122+ (ToolSearch late-binding + hooks isolation)",

package/installer/index.js

@@ -12,7 +12,7 @@ const __dirname = dirname(__filename);
 const ARKAOS_ROOT = resolve(__dirname, "..");
 const VERSION = JSON.parse(readFileSync(join(ARKAOS_ROOT, "package.json"), "utf-8")).version;
 
-export async function install({ runtime, path, force, skipSystem }) {
+export async function install({ runtime, path, force, skipSystem, withOllama }) {
   const startTime = Date.now();
   const config = getRuntimeConfig(runtime);
   const isUpgrade = existsSync(join(path || join(homedir(), ".arkaos"), "install-manifest.json"));
@@ -80,16 +80,19 @@ export async function install({ runtime, path, force, skipSystem }) {
     try {
       const { ensureSystemTools } = await import("./system-tools.js");
       const { formatSudoInstructions } = await import("./package-manager.js");
-      const sys = ensureSystemTools({ skipSystem: false });
+      const sys = ensureSystemTools({ skipSystem: false, withOllama });
       if (sys.sudoCommands && sys.sudoCommands.length > 0) {
         console.log(formatSudoInstructions(sys.sudoCommands));
       }
-      for (const tool of [sys.obsidian, sys.node]) {
+      for (const tool of [sys.obsidian, sys.node, sys.ollama]) {
         if (!tool) continue;
         if (tool.justInstalled) ok(`${tool.name} installed`);
         else if (tool.needsAction === "none") ok(`${tool.name} ready`);
         else warn(`${tool.name} ${tool.needsAction} — see commands above`);
       }
+      if (withOllama && sys.ollama?.needsAction === "none") {
+        ok("Ollama backend ready — cognitive layer can use local LLM inference");
+      }
     } catch (err) {
       warn(`System tool check failed: ${err.message}. Continuing without it.`);
     }

package/installer/system-tools.js

@@ -41,13 +41,27 @@ const NODE_PACKAGE = {
   choco: "nodejs",
 };
 
+const OLLAMA_PACKAGE = {
+  brew: "ollama",
+  winget: "Ollama.Ollama",
+  choco: "ollama",
+};
+
 const OBSIDIAN_FALLBACK_URL = "https://obsidian.md/download";
 const NODE_FALLBACK_URL = "https://nodejs.org/en/download";
 const PYTHON_FALLBACK_URL = "https://www.python.org/downloads/";
+const OLLAMA_FALLBACK_URL = "https://ollama.com/download";
 
 /**
  * Validate every required tool, install what can be installed without
  * sudo, and collect copy-paste commands for the ones that can't.
+ *
+ * When ``options.withOllama`` is set, Ollama is included in the check
+ * + install set as one possible **backend** for the cognitive layer.
+ * Opt-in: most users keep the Claude Code backend (default) and never
+ * need a local LLM runtime. Multi-backend selection lives in
+ * ``profile.json:cognitiveBackend``; this flag only governs the
+ * Ollama prerequisite at install time.
  */
 export function ensureSystemTools(options = {}) {
   if (options.skipSystem) {
@@ -56,6 +70,7 @@ export function ensureSystemTools(options = {}) {
       obsidian: null,
       node: null,
       python: null,
+      ollama: null,
       sudoCommands: [],
     };
   }
@@ -64,7 +79,13 @@ export function ensureSystemTools(options = {}) {
   const node = ensureTool("node", checkNode, NODE_PACKAGE, NODE_FALLBACK_URL, options);
   const python = checkPython();  // never auto-install Python — leave to OS
 
-  const sudoCommands = [obsidian, node]
+  let ollama = null;
+  if (options.withOllama) {
+    ollama = ensureTool("ollama", checkOllama, OLLAMA_PACKAGE, OLLAMA_FALLBACK_URL, options);
+  }
+
+  const tools = [obsidian, node, ollama].filter(Boolean);
+  const sudoCommands = tools
     .filter((t) => t?.needsSudo && t.suggestedCommand)
     .map((t) => t.suggestedCommand);
 
@@ -72,7 +93,7 @@ export function ensureSystemTools(options = {}) {
     sudoCommands.push(python.suggestedCommand);
   }
 
-  return { skipped: false, obsidian, node, python, sudoCommands };
+  return { skipped: false, obsidian, node, python, ollama, sudoCommands };
 }
 
 /**
@@ -131,6 +152,40 @@ export function checkNode() {
   };
 }
 
+/**
+ * Detect Ollama presence + whether the local service responds.
+ *
+ * Ollama is the cognitive-layer LLM runtime. Linux install uses an
+ * official script (``curl https://ollama.com/install.sh | sh``) that
+ * requires sudo — we never run it; we surface the command.
+ */
+export function checkOllama() {
+  const location = findBinary("ollama");
+  if (!location) {
+    const suggested = buildOllamaSuggestion();
+    return {
+      name: "ollama",
+      installed: false,
+      needsAction: "install",
+      suggestedCommand: suggested.command,
+      needsSudo: suggested.needsSudo,
+      fallbackUrl: OLLAMA_FALLBACK_URL,
+    };
+  }
+  const reachable = isOllamaReachable();
+  const version = readVersion("ollama --version");
+  return {
+    name: "ollama",
+    installed: true,
+    location,
+    version,
+    needsAction: reachable ? "none" : "start",
+    suggestedCommand: reachable ? undefined : "ollama serve   # or run the Ollama app",
+    needsSudo: false,
+  };
+}
+
+
 export function checkPython() {
   const candidates = IS_WINDOWS ? ["python", "py"] : ["python3", "python3.12", "python3.13"];
   for (const cmd of candidates) {
@@ -195,6 +250,28 @@ function buildSuggestedInstall(packageMap, fallbackUrl) {
   return { command: `Download from ${fallbackUrl}`, needsSudo: false, fallbackUrl };
 }
 
+function buildOllamaSuggestion() {
+  const os = platform();
+  if (os === "darwin") return { command: "brew install ollama", needsSudo: false };
+  if (IS_WINDOWS) return { command: "winget install --id Ollama.Ollama --silent --accept-source-agreements --accept-package-agreements", needsSudo: false };
+  if (os === "linux") return { command: "curl -fsSL https://ollama.com/install.sh | sh", needsSudo: true };
+  return { command: `Download from ${OLLAMA_FALLBACK_URL}`, needsSudo: false };
+}
+
+
+function isOllamaReachable() {
+  try {
+    execSync("ollama list", {
+      stdio: ["ignore", "ignore", "ignore"],
+      timeout: 1500,
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+
 function findBinary(name) {
   try {
     const out = execSync(`${CMD_FINDER} ${name}`, {

package/package.json

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

package/pyproject.toml

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