arkaos 3.48.0 → 3.50.0

package/VERSION

@@ -1 +1 @@
-3.48.0
+3.50.0

package/dashboard/app/components/TextDiff.vue

@@ -0,0 +1,110 @@
+<script setup lang="ts">
+// PR94c v3.49.0 — minimal side-by-side line diff.
+//
+// Uses LCS (longest common subsequence) on lines to mark equal / added /
+// removed rows. Empty inputs render an italic "—" placeholder. Diff is
+// pure client-side — no deps.
+
+const props = defineProps<{
+  left: string
+  right: string
+  leftLabel?: string
+  rightLabel?: string
+}>()
+
+interface DiffRow {
+  kind: 'eq' | 'add' | 'del'
+  left: string
+  right: string
+}
+
+function lineDiff(a: string, b: string): DiffRow[] {
+  const left = (a ?? '').split(/\r?\n/)
+  const right = (b ?? '').split(/\r?\n/)
+  const m = left.length
+  const n = right.length
+  // Build LCS table.
+  const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0))
+  for (let i = m - 1; i >= 0; i -= 1) {
+    for (let j = n - 1; j >= 0; j -= 1) {
+      if (left[i] === right[j]) dp[i][j] = dp[i + 1][j + 1] + 1
+      else dp[i][j] = Math.max(dp[i + 1][j], dp[i][j + 1])
+    }
+  }
+  // Walk back, emitting rows.
+  const rows: DiffRow[] = []
+  let i = 0
+  let j = 0
+  while (i < m && j < n) {
+    if (left[i] === right[j]) {
+      rows.push({ kind: 'eq', left: left[i], right: right[j] })
+      i += 1
+      j += 1
+    } else if (dp[i + 1][j] >= dp[i][j + 1]) {
+      rows.push({ kind: 'del', left: left[i], right: '' })
+      i += 1
+    } else {
+      rows.push({ kind: 'add', left: '', right: right[j] })
+      j += 1
+    }
+  }
+  while (i < m) {
+    rows.push({ kind: 'del', left: left[i], right: '' })
+    i += 1
+  }
+  while (j < n) {
+    rows.push({ kind: 'add', left: '', right: right[j] })
+    j += 1
+  }
+  return rows
+}
+
+const rows = computed(() => lineDiff(props.left || '', props.right || ''))
+
+const summary = computed(() => {
+  const adds = rows.value.filter((r) => r.kind === 'add').length
+  const dels = rows.value.filter((r) => r.kind === 'del').length
+  return { adds, dels }
+})
+</script>
+
+<template>
+  <div class="rounded-lg border border-default overflow-hidden">
+    <div class="px-3 py-2 border-b border-default bg-elevated/30 flex items-center justify-between gap-3 text-xs">
+      <div class="flex items-center gap-3">
+        <span class="font-mono">{{ leftLabel ?? 'left' }}</span>
+        <UIcon name="i-lucide-arrow-right" class="size-3 text-muted" />
+        <span class="font-mono">{{ rightLabel ?? 'right' }}</span>
+      </div>
+      <div class="flex items-center gap-2 font-mono text-muted">
+        <span v-if="summary.adds > 0" class="text-emerald-500">+{{ summary.adds }}</span>
+        <span v-if="summary.dels > 0" class="text-rose-500">-{{ summary.dels }}</span>
+        <span v-if="summary.adds === 0 && summary.dels === 0">identical</span>
+      </div>
+    </div>
+    <div class="grid grid-cols-2 text-xs font-mono overflow-x-auto">
+      <div>
+        <div
+          v-for="(row, idx) in rows"
+          :key="`l-${idx}`"
+          :class="[
+            'px-3 py-1 whitespace-pre-wrap break-words border-b border-default/50 min-h-[1.5rem]',
+            row.kind === 'del' ? 'bg-rose-500/10 text-rose-600 dark:text-rose-400' : '',
+            row.kind === 'add' ? 'bg-muted/10' : '',
+          ]"
+        >{{ row.left || '·' }}</div>
+      </div>
+      <div class="border-l border-default">
+        <div
+          v-for="(row, idx) in rows"
+          :key="`r-${idx}`"
+          :class="[
+            'px-3 py-1 whitespace-pre-wrap break-words border-b border-default/50 min-h-[1.5rem]',
+            row.kind === 'add' ? 'bg-emerald-500/10 text-emerald-600 dark:text-emerald-400' : '',
+            row.kind === 'del' ? 'bg-muted/10' : '',
+          ]"
+        >{{ row.right || '·' }}</div>
+      </div>
+    </div>
+  </div>
+</template>

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

@@ -40,6 +40,8 @@ interface AgentDetail {
     preferred_format?: string
     language?: string
   }
+  // PR94c v3.49.0 — diffable free-text field
+  bio_md?: string
 }
 
 const { data: a, status: aStatus } = fetchApi<AgentDetail>(
@@ -216,8 +218,26 @@ const bigFiveKeys = ['openness', 'conscientiousness', 'extraversion', 'agreeable
           </div>
         </div>
 
+        <!-- PR94c v3.49.0 — text diff blocks for the free-text fields -->
+        <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">
-          Cells with a yellow tint differ between the two agents.
+          Cells with a yellow tint differ between the two agents. Red lines were
+          removed; green lines were added.
         </p>
       </div>
     </template>

package/dashboard/app/pages/personas/compare-with-agent.vue

@@ -29,6 +29,7 @@ interface PersonaDetail {
   expertise_domains?: string[]
   frameworks?: string[]
   communication?: { tone?: string, vocabulary_level?: string, avoid?: string[] }
+  bio_md?: string  // PR94c v3.49.0
 }
 
 interface AgentDetail {
@@ -43,6 +44,7 @@ interface AgentDetail {
   mental_models?: { primary?: string[], secondary?: string[] }
   expertise?: { domains?: string[], frameworks?: string[] }
   communication?: { tone?: string, vocabulary_level?: string, avoid?: string[] }
+  bio_md?: string  // PR94c v3.49.0
 }
 
 const { data: persona, status: pStatus } = fetchApi<PersonaDetail>(
@@ -209,8 +211,26 @@ const bigFiveKeys = ['openness', 'conscientiousness', 'extraversion', 'agreeable
           </div>
         </div>
 
+        <!-- PR94c v3.49.0 — free-text diff blocks -->
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Bio (Markdown)</h3>
+        <TextDiff
+          :left="persona.bio_md || ''"
+          :right="agent.bio_md || ''"
+          :left-label="persona.name || persona.id"
+          :right-label="agent.name || agent.id"
+        />
+
+        <h3 class="text-sm font-semibold uppercase tracking-wide text-muted pt-2">Communication tone</h3>
+        <TextDiff
+          :left="persona.communication?.tone || ''"
+          :right="agent.communication?.tone || ''"
+          :left-label="persona.name || persona.id"
+          :right-label="agent.name || agent.id"
+        />
+
         <p class="text-xs text-muted pt-4 italic">
-          Cells with a yellow tint differ between persona and agent.
+          Cells with a yellow tint differ between persona and agent. Red lines
+          were removed; green lines were added.
         </p>
       </div>
     </template>

package/dashboard/app/pages/workflows.vue

@@ -30,8 +30,55 @@ interface Workflow {
 }
 
 const { fetchApi, apiBase } = useApi()
+const toast = useToast()
 const { data, status, error, refresh } = await fetchApi<{ workflows: Workflow[] }>('/api/workflows')
 
+// PR94d v3.50.0 — inline YAML editor state.
+const editingYaml = ref(false)
+const yamlDraft = ref('')
+const savingYaml = ref(false)
+
+function startEditYaml() {
+  if (!selected.value) return
+  yamlDraft.value = selected.value.content
+  editingYaml.value = true
+}
+
+function cancelEditYaml() {
+  yamlDraft.value = ''
+  editingYaml.value = false
+}
+
+async function saveYaml() {
+  if (!selected.value) return
+  savingYaml.value = true
+  try {
+    const res = await $fetch<{ updated?: boolean, error?: string }>(
+      `${apiBase}/api/workflows/${selected.value.id}/yaml`,
+      { method: 'PUT', body: { content: yamlDraft.value } },
+    )
+    if (res.error) throw new Error(res.error)
+    toast.add({
+      title: 'YAML updated',
+      description: selected.value.file,
+      color: 'success',
+      icon: 'i-lucide-check',
+    })
+    // Patch local content so the preview shows the new YAML immediately.
+    selected.value = { ...selected.value, content: yamlDraft.value }
+    editingYaml.value = false
+    await refresh()
+  } catch (err) {
+    toast.add({
+      title: 'Save failed',
+      description: err instanceof Error ? err.message : 'unknown error',
+      color: 'error',
+    })
+  } finally {
+    savingYaml.value = false
+  }
+}
+
 // PR89b v3.28.0 — recent runs for the selected workflow.
 interface WorkflowRun {
   session_id: string
@@ -171,7 +218,7 @@ const columns: TableColumn<Workflow>[] = [
               th: 'py-2 first:rounded-l-lg last:rounded-r-lg border-y border-default first:border-l last:border-r',
               td: 'border-b border-default',
             }"
-            @select="(row: { original: Workflow }) => { selected = row.original; sidePanelTab = 'flow'; runs = []; loadRuns(row.original.id) }"
+            @select="(row: { original: Workflow }) => { selected = row.original; sidePanelTab = 'flow'; runs = []; editingYaml = false; loadRuns(row.original.id) }"
           >
             <template #name-cell="{ row }">
               <div class="min-w-0">
@@ -292,8 +339,47 @@ const columns: TableColumn<Workflow>[] = [
                 No phases defined.
               </div>
             </div>
-            <div v-else-if="sidePanelTab === 'yaml'" class="overflow-x-auto">
-              <pre class="p-4 text-xs font-mono whitespace-pre">{{ selected.content }}</pre>
+            <div v-else-if="sidePanelTab === 'yaml'" class="flex flex-col">
+              <div class="px-4 py-2 border-b border-default flex items-center justify-between text-xs">
+                <span class="text-muted font-mono">{{ selected.file }}</span>
+                <div class="flex items-center gap-2">
+                  <template v-if="!editingYaml">
+                    <UButton
+                      label="Edit"
+                      icon="i-lucide-pencil"
+                      size="xs"
+                      variant="soft"
+                      @click="startEditYaml"
+                    />
+                  </template>
+                  <template v-else>
+                    <UButton
+                      label="Cancel"
+                      variant="ghost"
+                      size="xs"
+                      :disabled="savingYaml"
+                      @click="cancelEditYaml"
+                    />
+                    <UButton
+                      label="Save"
+                      icon="i-lucide-check"
+                      color="primary"
+                      size="xs"
+                      :loading="savingYaml"
+                      @click="saveYaml"
+                    />
+                  </template>
+                </div>
+              </div>
+              <div v-if="!editingYaml" class="overflow-x-auto">
+                <pre class="p-4 text-xs font-mono whitespace-pre">{{ selected.content }}</pre>
+              </div>
+              <UTextarea
+                v-else
+                v-model="yamlDraft"
+                :rows="20"
+                class="m-2 font-mono text-xs"
+              />
             </div>
             <div v-else class="p-4">
               <div v-if="runsLoading" class="py-6 text-center text-sm text-muted">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "3.48.0",
+  "version": "3.50.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.48.0"
+version = "3.50.0"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}

package/scripts/dashboard-api.py

@@ -1894,6 +1894,62 @@ def _iso_duration_s(start_iso: str, end_iso: str) -> Optional[int]:
         return 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.
+
+    Body: ``{"content": "<full YAML body>"}``. Validates that the
+    content parses to a dict with a non-empty ``id`` key. Refuses to
+    move the file (operator can't rename via this endpoint — that
+    would invalidate cached references).
+    """
+    if not isinstance(body, dict):
+        return {"error": "body must be an object"}
+    content = str(body.get("content") or "")
+    if not content.strip():
+        return {"error": "content is required"}
+    target = _resolve_workflow_yaml(workflow_id)
+    if target is None:
+        return {"error": "workflow not found"}
+    try:
+        import yaml as _yaml
+        parsed = _yaml.safe_load(content)
+    except Exception as exc:  # noqa: BLE001
+        return {"error": f"YAML parse failed: {exc}"}
+    if not isinstance(parsed, dict):
+        return {"error": "YAML root must be a mapping"}
+    if not parsed.get("id"):
+        return {"error": "YAML must include a non-empty 'id' field"}
+    try:
+        tmp = target.with_suffix(target.suffix + ".tmp")
+        tmp.write_text(content, encoding="utf-8")
+        tmp.replace(target)
+    except OSError as exc:
+        return {"error": f"write failed: {exc}"}
+    return {"updated": True, "id": workflow_id, "file": str(target)}
+
+
+def _resolve_workflow_yaml(workflow_id: str):
+    """Return the YAML path for a workflow id, or None when missing."""
+    try:
+        import yaml as _yaml
+    except ImportError:
+        return None
+    dept_root = ARKAOS_ROOT / "departments"
+    if not dept_root.exists():
+        return None
+    for path in dept_root.glob("*/workflows/*.yaml"):
+        try:
+            raw = _yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+        except Exception:  # noqa: BLE001
+            continue
+        if not isinstance(raw, dict):
+            continue
+        if str(raw.get("id") or path.stem) == workflow_id:
+            return path
+    return None
+
+
 @app.get("/api/workflows")
 def workflows_list():
     """Scan departments/*/workflows/*.yaml and return metadata + content."""