arkaos 3.55.0 → 3.57.0

package/VERSION

@@ -1 +1 @@
-3.55.0
+3.57.0

package/dashboard/app/pages/personas/[id].vue

@@ -283,15 +283,28 @@ function onCloned(agentId: string) {
 }
 
 // PR88a v3.23.0 — Compare with linked agent.
-const compareWithOptions = computed(() =>
-  linkedAgentIds.value.map((aid) => ({
-    label: `Compare with ${aid}`,
-    icon: 'i-lucide-columns-2',
+// PR96c v3.57.0 — also compare with another persona.
+const { data: otherPersonasData } = fetchApi<{ personas: Array<{ id: string, name: string }> }>(
+  '/api/personas',
+)
+const compareWithOptions = computed(() => {
+  const agentOpts = linkedAgentIds.value.map((aid) => ({
+    label: `Compare with agent ${aid}`,
+    icon: 'i-lucide-user',
     onSelect: () => navigateTo(
       `/personas/compare-with-agent?persona=${personaId}&agent=${aid}`,
     ),
-  })),
-)
+  }))
+  const personaOpts = (otherPersonasData.value?.personas ?? [])
+    .filter((p) => p.id !== personaId)
+    .slice(0, 30)
+    .map((p) => ({
+      label: `Compare with persona ${p.name}`,
+      icon: 'i-lucide-user-plus',
+      onSelect: () => navigateTo(`/personas/compare?a=${personaId}&b=${p.id}`),
+    }))
+  return [...agentOpts, ...personaOpts]
+})
 
 // PR84c v3.9.0 — Auto-fill empty lists in one go.
 const autofilling = ref(false)

package/dashboard/app/pages/personas/compare.vue

@@ -0,0 +1,213 @@
+<script setup lang="ts">
+// PR96c v3.57.0 — Compare two personas side-by-side.
+//
+// Driven by `?a=p1&b=p2`. Mirrors the agents/compare layout but
+// adapts to the persona schema (flat mental_models, no department).
+
+const route = useRoute()
+const { fetchApi } = useApi()
+
+const ids = computed<string[]>(() => {
+  const raw = [route.query.a, route.query.b]
+  return raw.map((v) => String(v ?? '').trim()).filter(Boolean).slice(0, 2)
+})
+
+interface PersonaDetail {
+  id: string
+  name?: string
+  title?: string
+  source?: string
+  tagline?: string
+  mbti?: string
+  disc?: { primary?: string, secondary?: string }
+  enneagram?: { type?: number, wing?: number }
+  big_five?: {
+    openness?: number
+    conscientiousness?: number
+    extraversion?: number
+    agreeableness?: number
+    neuroticism?: number
+  }
+  mental_models?: string[]
+  expertise_domains?: string[]
+  frameworks?: string[]
+  key_quotes?: string[]
+  communication?: { tone?: string, vocabulary_level?: string, avoid?: string[] }
+  bio_md?: string
+  error?: string
+}
+
+const { data: a, status: aStatus } = fetchApi<PersonaDetail>(
+  () => ids.value[0] ? `/api/personas/${ids.value[0]}` : '',
+)
+const { data: b, status: bStatus } = fetchApi<PersonaDetail>(
+  () => ids.value[1] ? `/api/personas/${ids.value[1]}` : '',
+)
+
+const loading = computed(() => aStatus.value === 'pending' || bStatus.value === 'pending')
+const errorMsg = computed(() => {
+  if (ids.value.length < 2) return 'Pass two persona ids via ?a=p1&b=p2'
+  if (a.value?.error) return `Left: ${a.value.error}`
+  if (b.value?.error) return `Right: ${b.value.error}`
+  return null
+})
+
+function diffClass(left: unknown, right: unknown): string {
+  return left !== right ? 'bg-yellow-500/10 border-yellow-500/30' : ''
+}
+function listDiffClass(left: unknown[] | undefined, right: unknown[] | undefined): string {
+  const x = JSON.stringify([...(left ?? [])].sort())
+  const y = JSON.stringify([...(right ?? [])].sort())
+  return x !== y ? 'bg-yellow-500/10 border-yellow-500/30' : ''
+}
+
+const bigFiveKeys = ['openness', 'conscientiousness', 'extraversion', 'agreeableness', 'neuroticism'] as const
+</script>
+
+<template>
+  <UDashboardPanel id="personas-compare">
+    <template #header>
+      <UDashboardNavbar title="Compare personas">
+        <template #leading>
+          <UButton icon="i-lucide-arrow-left" variant="ghost" size="sm" to="/personas" aria-label="Back" />
+        </template>
+        <template #trailing>
+          <UBadge label="2-way" variant="subtle" size="sm" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <div v-if="errorMsg" class="p-6 text-center text-sm text-error">
+        {{ errorMsg }}
+      </div>
+      <div v-else-if="loading" class="p-6 text-center text-sm text-muted">
+        <UIcon name="i-lucide-loader-2" class="size-4 animate-spin inline" /> Loading…
+      </div>
+      <div v-else-if="a && b" class="space-y-4 max-w-6xl">
+        <section class="grid grid-cols-2 gap-3">
+          <NuxtLink :to="`/personas/${a.id}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Left</p>
+            <h2 class="text-xl font-bold">{{ a.name }}</h2>
+            <p class="text-sm text-muted">{{ a.title || '—' }}</p>
+          </NuxtLink>
+          <NuxtLink :to="`/personas/${b.id}`" class="rounded-lg border border-default p-4 hover:border-primary/40">
+            <p class="text-xs text-muted uppercase tracking-wide">Right</p>
+            <h2 class="text-xl font-bold">{{ b.name }}</h2>
+            <p class="text-sm text-muted">{{ b.title || '—' }}</p>
+          </NuxtLink>
+        </section>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Behavioural DNA</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', diffClass(a.mbti, b.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ a.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(a.mbti, b.mbti)]">
+            <p class="text-xs text-muted">MBTI</p>
+            <p class="text-lg font-mono font-bold">{{ b.mbti ?? '—' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.disc?.primary}/${a.disc?.secondary}`, `${b.disc?.primary}/${b.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ a.disc?.primary ?? '?' }}/{{ a.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.disc?.primary}/${a.disc?.secondary}`, `${b.disc?.primary}/${b.disc?.secondary}`)]">
+            <p class="text-xs text-muted">DISC</p>
+            <p class="text-lg font-mono font-bold">{{ b.disc?.primary ?? '?' }}/{{ b.disc?.secondary ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.enneagram?.type}w${a.enneagram?.wing}`, `${b.enneagram?.type}w${b.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ a.enneagram?.type ?? '?' }}w{{ a.enneagram?.wing ?? '?' }}</p>
+          </div>
+          <div :class="['rounded-lg border p-3', diffClass(`${a.enneagram?.type}w${a.enneagram?.wing}`, `${b.enneagram?.type}w${b.enneagram?.wing}`)]">
+            <p class="text-xs text-muted">Enneagram</p>
+            <p class="text-lg font-mono font-bold">{{ b.enneagram?.type ?? '?' }}w{{ b.enneagram?.wing ?? '?' }}</p>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Big Five (OCEAN)</h3>
+        <div class="space-y-1">
+          <div v-for="k in bigFiveKeys" :key="k" class="grid grid-cols-2 gap-3">
+            <div :class="['rounded-lg border p-2 flex items-center gap-3', diffClass(a.big_five?.[k], b.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ a.big_five?.[k] ?? '—' }}</span>
+            </div>
+            <div :class="['rounded-lg border p-2 flex items-center gap-3', diffClass(a.big_five?.[k], b.big_five?.[k])]">
+              <span class="text-xs text-muted w-36 shrink-0 capitalize">{{ k }}</span>
+              <span class="font-mono text-sm">{{ b.big_five?.[k] ?? '—' }}</span>
+            </div>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Expertise domains</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(a.expertise_domains, b.expertise_domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in a.expertise_domains" :key="d">{{ d }}</li>
+              <li v-if="!a.expertise_domains?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.expertise_domains, b.expertise_domains)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="d in b.expertise_domains" :key="d">{{ d }}</li>
+              <li v-if="!b.expertise_domains?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Mental models</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(a.mental_models, b.mental_models)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in a.mental_models" :key="m">{{ m }}</li>
+              <li v-if="!a.mental_models?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.mental_models, b.mental_models)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="m in b.mental_models" :key="m">{{ m }}</li>
+              <li v-if="!b.mental_models?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Frameworks</h3>
+        <div class="grid grid-cols-2 gap-3">
+          <div :class="['rounded-lg border p-3', listDiffClass(a.frameworks, b.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in a.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!a.frameworks?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+          <div :class="['rounded-lg border p-3', listDiffClass(a.frameworks, b.frameworks)]">
+            <ul class="list-disc list-inside text-sm space-y-1">
+              <li v-for="f in b.frameworks" :key="f">{{ f }}</li>
+              <li v-if="!b.frameworks?.length" class="list-none text-muted italic">none</li>
+            </ul>
+          </div>
+        </div>
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Bio (Markdown)</h3>
+        <TextDiff
+          :left="a.bio_md || ''"
+          :right="b.bio_md || ''"
+          :left-label="a.name || a.id"
+          :right-label="b.name || b.id"
+        />
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Communication tone</h3>
+        <TextDiff
+          :left="a.communication?.tone || ''"
+          :right="b.communication?.tone || ''"
+          :left-label="a.name || a.id"
+          :right-label="b.name || b.id"
+        />
+
+        <p class="text-xs text-muted pt-4 italic">
+          Yellow tint = different. Red removed, green added.
+        </p>
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

package/dashboard/app/pages/terminal.vue

@@ -9,10 +9,18 @@
 // instead ships a controlled command runner with allowlist + capped
 // output. xterm.js-style PTY can be a later upgrade if needed.
 
+interface CommandArg {
+  name: string
+  label: string
+  choices: string[]
+  default: string
+}
+
 interface CommandEntry {
   id: string
   label: string
   description: string
+  args?: CommandArg[]
 }
 
 interface ExecResult {
@@ -41,12 +49,33 @@ const commands = computed<CommandEntry[]>(() => cmdData.value?.commands ?? [])
 const running = ref<string | null>(null)
 const history = ref<HistoryEntry[]>([])
 
+// PR96b v3.56.0 — per-command arg state. Keyed by command id, holds
+// the operator's current selection for each arg.
+const argState = reactive<Record<string, Record<string, string>>>({})
+
+function ensureArgState(cmd: CommandEntry) {
+  if (!cmd.args || cmd.args.length === 0) return
+  if (!argState[cmd.id]) argState[cmd.id] = {}
+  for (const arg of cmd.args) {
+    if (argState[cmd.id][arg.name] === undefined) {
+      argState[cmd.id][arg.name] = arg.default
+    }
+  }
+}
+
 async function run(cmd: CommandEntry) {
   running.value = cmd.id
+  ensureArgState(cmd)
   try {
     const res = await $fetch<ExecResult & { error?: string }>(
       `${apiBase}/api/terminal/exec`,
-      { method: 'POST', body: { command_id: cmd.id } },
+      {
+        method: 'POST',
+        body: {
+          command_id: cmd.id,
+          args: cmd.args ? argState[cmd.id] : undefined,
+        },
+      },
     )
     if (res.error) throw new Error(res.error)
     history.value = [
@@ -139,22 +168,47 @@ function relative(iso: string): string {
                 </p>
               </div>
             </template>
-            <div class="grid grid-cols-1 md:grid-cols-2 gap-2">
-              <UButton
+            <div class="grid grid-cols-1 md:grid-cols-2 gap-3">
+              <div
                 v-for="cmd in commands"
                 :key="cmd.id"
-                :label="cmd.label"
-                :description="cmd.description"
-                icon="i-lucide-terminal"
-                variant="soft"
-                color="primary"
-                size="sm"
-                block
-                class="justify-start"
-                :loading="running === cmd.id"
-                :disabled="running !== null && running !== cmd.id"
-                @click="run(cmd)"
-              />
+                class="rounded-lg border border-default p-3 space-y-2"
+              >
+                <div>
+                  <p class="text-sm font-semibold">{{ cmd.label }}</p>
+                  <p class="text-xs text-muted">{{ cmd.description }}</p>
+                </div>
+                <!-- PR96b v3.56.0 — arg pickers for parameterised commands -->
+                <div v-if="cmd.args && cmd.args.length > 0" class="grid grid-cols-2 gap-2">
+                  <UFormField
+                    v-for="arg in cmd.args"
+                    :key="arg.name"
+                    :label="arg.label"
+                    size="xs"
+                  >
+                    <USelect
+                      :model-value="(argState[cmd.id] || {})[arg.name] || arg.default"
+                      :items="arg.choices.map((c) => ({ label: c, value: c }))"
+                      size="xs"
+                      class="w-full"
+                      @update:model-value="(v) => {
+                        ensureArgState(cmd)
+                        argState[cmd.id][arg.name] = String(v)
+                      }"
+                    />
+                  </UFormField>
+                </div>
+                <UButton
+                  label="Run"
+                  icon="i-lucide-play"
+                  color="primary"
+                  size="sm"
+                  block
+                  :loading="running === cmd.id"
+                  :disabled="running !== null && running !== cmd.id"
+                  @click="run(cmd)"
+                />
+              </div>
             </div>
           </UCard>
 

package/package.json

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

package/pyproject.toml

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

package/scripts/dashboard-api.py

@@ -2024,9 +2024,17 @@ TERMINAL_ALLOWLIST: list[dict] = [
     },
     {
         "id": "git-log",
-        "label": "git log (10)",
-        "cmd": ["git", "log", "-10", "--oneline"],
-        "description": "Most recent 10 commits.",
+        "label": "git log",
+        "cmd_template": ["git", "log", "-{count}", "--oneline"],
+        "args": [
+            {
+                "name": "count",
+                "label": "Commits to show",
+                "choices": ["5", "10", "20", "50"],
+                "default": "10",
+            },
+        ],
+        "description": "Most recent N commits (operator picks N).",
     },
     {
         "id": "npm-version",
@@ -2046,6 +2054,20 @@ TERMINAL_ALLOWLIST: list[dict] = [
         "cmd": ["ls", "-la"],
         "description": "List files in the project root.",
     },
+    {
+        "id": "arka-costs",
+        "label": "ArkaOS costs",
+        "cmd_template": ["python3", "-m", "core.runtime.llm_cost_telemetry_cli", "{period}"],
+        "args": [
+            {
+                "name": "period",
+                "label": "Period",
+                "choices": ["today", "week", "month", "all"],
+                "default": "today",
+            },
+        ],
+        "description": "LLM cost summary for the selected period.",
+    },
 ]
 
 _TERMINAL_TIMEOUT_S = 15
@@ -2054,14 +2076,41 @@ _TERMINAL_MAX_OUTPUT = 20_000  # chars — both stdout and stderr capped
 
 @app.get("/api/terminal/commands")
 def terminal_commands():
-    """List allowlisted commands the dashboard terminal may run."""
-    return {
-        "commands": [
-            {"id": c["id"], "label": c["label"], "description": c["description"]}
-            for c in TERMINAL_ALLOWLIST
-        ],
-        "total": len(TERMINAL_ALLOWLIST),
-    }
+    """List allowlisted commands the dashboard terminal may run.
+
+    PR96b v3.56.0 — includes the `args` schema (label / choices /
+    default) when an entry has parameters. The raw cmd / cmd_template
+    is NEVER returned — defence in depth.
+    """
+    out: list[dict] = []
+    for c in TERMINAL_ALLOWLIST:
+        out.append({
+            "id": c["id"],
+            "label": c["label"],
+            "description": c["description"],
+            "args": _safe_args_schema(c.get("args")),
+        })
+    return {"commands": out, "total": len(out)}
+
+
+def _safe_args_schema(args) -> list[dict]:
+    """Sanitised arg schema for the public API — never leaks cmd/template."""
+    if not isinstance(args, list):
+        return []
+    out: list[dict] = []
+    for a in args:
+        if not isinstance(a, dict):
+            continue
+        choices = a.get("choices")
+        if not isinstance(choices, list) or not choices:
+            continue
+        out.append({
+            "name": str(a.get("name") or ""),
+            "label": str(a.get("label") or a.get("name") or ""),
+            "choices": [str(x) for x in choices],
+            "default": str(a.get("default") or choices[0]),
+        })
+    return out
 
 
 @app.post("/api/terminal/exec")
@@ -2080,11 +2129,20 @@ def terminal_exec(body: dict):
     entry = next((c for c in TERMINAL_ALLOWLIST if c["id"] == cid), None)
     if entry is None:
         return {"error": f"command '{cid}' is not on the allowlist"}
+
+    # PR96b v3.56.0 — resolve template + args, or fall back to fixed cmd.
+    if "cmd_template" in entry:
+        argv, err = _resolve_cmd_template(entry, body.get("args") or {})
+        if err:
+            return {"error": err}
+    else:
+        argv = entry["cmd"]
+
     import time
     started = time.monotonic()
     try:
         result = subprocess.run(
-            entry["cmd"],
+            argv,
             cwd=str(ARKAOS_ROOT),
             capture_output=True,
             text=True,
@@ -2097,7 +2155,7 @@ def terminal_exec(body: dict):
             "stderr": f"command timed out after {_TERMINAL_TIMEOUT_S}s",
             "exit_code": -1,
             "duration_ms": int(_TERMINAL_TIMEOUT_S * 1000),
-            "command": " ".join(entry["cmd"]),
+            "command": " ".join(argv),
         }
     except OSError as exc:
         return {
@@ -2105,7 +2163,7 @@ def terminal_exec(body: dict):
             "stderr": f"command failed to launch: {exc}",
             "exit_code": -1,
             "duration_ms": int((time.monotonic() - started) * 1000),
-            "command": " ".join(entry["cmd"]),
+            "command": " ".join(argv),
         }
     duration_ms = int((time.monotonic() - started) * 1000)
     return {
@@ -2113,10 +2171,49 @@ def terminal_exec(body: dict):
         "stderr": (result.stderr or "")[:_TERMINAL_MAX_OUTPUT],
         "exit_code": result.returncode,
         "duration_ms": duration_ms,
-        "command": " ".join(entry["cmd"]),
+        "command": " ".join(argv),
     }
 
 
+def _resolve_cmd_template(entry: dict, supplied: dict) -> tuple[list[str], "str | None"]:
+    """Substitute `{name}` placeholders in cmd_template with validated args.
+
+    Returns (argv, None) on success, ([], error_msg) on validation failure.
+    Anything supplied that isn't in the schema's choices is rejected.
+    Unknown arg names are also rejected — no silent passthrough.
+    """
+    schema = entry.get("args") or []
+    if not isinstance(schema, list):
+        return [], "command has invalid args schema"
+    by_name: dict[str, dict] = {a["name"]: a for a in schema if isinstance(a, dict)}
+    chosen: dict[str, str] = {}
+    for arg_def in schema:
+        name = arg_def["name"]
+        s = supplied.get(name)
+        if s is None:
+            chosen[name] = str(arg_def.get("default") or arg_def["choices"][0])
+            continue
+        s_str = str(s)
+        if s_str not in arg_def["choices"]:
+            return [], (
+                f"arg '{name}'='{s_str}' is not in the allowed choices "
+                f"({', '.join(arg_def['choices'])})"
+            )
+        chosen[name] = s_str
+    for k in supplied:
+        if k not in by_name:
+            return [], f"unknown arg '{k}'"
+    argv: list[str] = []
+    for tok in entry["cmd_template"]:
+        if not isinstance(tok, str):
+            continue
+        out_tok = tok
+        for name, val in chosen.items():
+            out_tok = out_tok.replace(f"{{{name}}}", val)
+        argv.append(out_tok)
+    return argv, None
+
+
 @app.put("/api/workflows/{workflow_id}/yaml")
 def workflow_update_yaml(workflow_id: str, body: dict):
     """PR94d v3.50.0 — overwrite a workflow's YAML file in place.