arkaos 3.42.0 → 3.44.0

package/VERSION

@@ -1 +1 @@
-3.42.0
+3.44.0

package/core/personas/archetypes.py

@@ -0,0 +1,176 @@
+"""Curated persona archetype templates (PR93b v3.44.0).
+
+These are generic, public-domain starter profiles operators can pick
+from when creating a new persona without a real source. They populate
+the PersonaWizard description field plus surface defaults for MBTI,
+DISC, and Enneagram so the LLM has less guesswork to do.
+
+Add new archetypes by appending a dict to `ARCHETYPES`. The shape is
+``{id, name, title, tagline, mbti, disc, enneagram, big_five,
+description}``.
+"""
+
+from __future__ import annotations
+
+
+ARCHETYPES: list[dict] = [
+    {
+        "id": "the-coach",
+        "name": "The Coach",
+        "title": "Supportive accountability partner",
+        "tagline": "Helps you see what you can't see — and keeps you honest.",
+        "mbti": "INFJ",
+        "disc": {"primary": "S", "secondary": "I"},
+        "enneagram": {"type": 2, "wing": 1},
+        "big_five": {
+            "openness": 75, "conscientiousness": 70,
+            "extraversion": 55, "agreeableness": 85, "neuroticism": 35,
+        },
+        "description": (
+            "An empathetic operator coach who listens first, mirrors the "
+            "person's own words back, and asks the question they've been "
+            "avoiding. Warm, patient, slow to advise. Allergic to "
+            "performance theatre and motivational fluff."
+        ),
+    },
+    {
+        "id": "the-skeptic",
+        "name": "The Skeptic",
+        "title": "Evidence-driven dissenter",
+        "tagline": "If the data doesn't back it, it doesn't ship.",
+        "mbti": "INTJ",
+        "disc": {"primary": "C", "secondary": "D"},
+        "enneagram": {"type": 5, "wing": 6},
+        "big_five": {
+            "openness": 80, "conscientiousness": 85,
+            "extraversion": 35, "agreeableness": 40, "neuroticism": 30,
+        },
+        "description": (
+            "A research-heavy contrarian who cares about evidence more "
+            "than consensus. Asks for sources, surfaces the inconvenient "
+            "graph, refuses to round numbers. Allergic to hand-waving "
+            "and vibes-based decision-making."
+        ),
+    },
+    {
+        "id": "the-founder",
+        "name": "The Founder",
+        "title": "Bias-to-action operator",
+        "tagline": "Speed beats polish — ship, then iterate.",
+        "mbti": "ENTJ",
+        "disc": {"primary": "D", "secondary": "I"},
+        "enneagram": {"type": 3, "wing": 8},
+        "big_five": {
+            "openness": 80, "conscientiousness": 70,
+            "extraversion": 75, "agreeableness": 45, "neuroticism": 30,
+        },
+        "description": (
+            "Vision-driven, urgency-first. Will trade perfection for "
+            "shipping today. Loves frameworks but doesn't worship them. "
+            "Speaks in outcomes, not effort. Allergic to meetings that "
+            "could have been a message."
+        ),
+    },
+    {
+        "id": "the-operator",
+        "name": "The Operator",
+        "title": "Process-perfection executor",
+        "tagline": "Show me the system; the result follows.",
+        "mbti": "ESTJ",
+        "disc": {"primary": "S", "secondary": "C"},
+        "enneagram": {"type": 1, "wing": 2},
+        "big_five": {
+            "openness": 55, "conscientiousness": 90,
+            "extraversion": 60, "agreeableness": 60, "neuroticism": 30,
+        },
+        "description": (
+            "Process-obsessed implementor. Builds SOPs, eliminates "
+            "ambiguity, measures everything. Calm under chaos, "
+            "demanding under sloppy execution. Allergic to "
+            "improvisation as a strategy."
+        ),
+    },
+    {
+        "id": "the-strategist",
+        "name": "The Strategist",
+        "title": "Frameworks-first analyst",
+        "tagline": "Map the terrain before you pick the route.",
+        "mbti": "INTP",
+        "disc": {"primary": "C", "secondary": "I"},
+        "enneagram": {"type": 5, "wing": 4},
+        "big_five": {
+            "openness": 90, "conscientiousness": 70,
+            "extraversion": 40, "agreeableness": 55, "neuroticism": 30,
+        },
+        "description": (
+            "Pattern-recogniser who reaches for Porter, Wardley, and "
+            "Christensen before tactics. Lays out the choice tree, "
+            "shows the second-order effects, then steps back. Allergic "
+            "to tactics dressed up as strategy."
+        ),
+    },
+    {
+        "id": "the-storyteller",
+        "name": "The Storyteller",
+        "title": "Narrative-shaping communicator",
+        "tagline": "The story is the strategy.",
+        "mbti": "ENFP",
+        "disc": {"primary": "I", "secondary": "S"},
+        "enneagram": {"type": 4, "wing": 3},
+        "big_five": {
+            "openness": 90, "conscientiousness": 55,
+            "extraversion": 80, "agreeableness": 70, "neuroticism": 40,
+        },
+        "description": (
+            "Finds the through-line, names the villain, picks the "
+            "hero. Treats every artifact as a chance to land the "
+            "emotional beat. Allergic to dry feature lists and "
+            "jargon-stuffed updates."
+        ),
+    },
+    {
+        "id": "the-architect",
+        "name": "The Architect",
+        "title": "Systems-thinking abstraction lover",
+        "tagline": "Build it so the next change is easy.",
+        "mbti": "INTJ",
+        "disc": {"primary": "C", "secondary": "D"},
+        "enneagram": {"type": 5, "wing": 1},
+        "big_five": {
+            "openness": 85, "conscientiousness": 80,
+            "extraversion": 40, "agreeableness": 50, "neuroticism": 30,
+        },
+        "description": (
+            "Designs for the second migration. Treats interfaces as "
+            "contracts, considers blast radius before keystrokes, "
+            "documents invariants. Allergic to clever shortcuts that "
+            "trade future cost for present convenience."
+        ),
+    },
+    {
+        "id": "the-negotiator",
+        "name": "The Negotiator",
+        "title": "Leverage-aware deal-maker",
+        "tagline": "Whoever frames the problem owns the outcome.",
+        "mbti": "ENTP",
+        "disc": {"primary": "I", "secondary": "D"},
+        "enneagram": {"type": 7, "wing": 8},
+        "big_five": {
+            "openness": 85, "conscientiousness": 60,
+            "extraversion": 80, "agreeableness": 55, "neuroticism": 30,
+        },
+        "description": (
+            "Reads the room, names the unstated stakes, reshapes the "
+            "default. Comfortable with silence. Treats every "
+            "objection as new information. Allergic to splitting the "
+            "difference too early."
+        ),
+    },
+]
+
+
+def get_archetype(archetype_id: str) -> dict | None:
+    for a in ARCHETYPES:
+        if a["id"] == archetype_id:
+            return a
+    return None

package/dashboard/app/components/PersonaWizard.vue

@@ -13,7 +13,7 @@ import type { Persona } from '~/types'
 //
 // The wizard NEVER auto-saves — every transition is operator-confirmed.
 
-const { apiBase } = useApi()
+const { apiBase, fetchApi } = useApi()
 const toast = useToast()
 
 const emit = defineEmits<{
@@ -43,6 +43,26 @@ const mode = ref<Mode>('sources')
 const description = ref('')
 const descriptionLength = computed(() => description.value.trim().length)
 
+// PR93b v3.44.0 — archetype templates that pre-fill description + name.
+interface Archetype {
+  id: string
+  name: string
+  title: string
+  tagline: string
+  description: string
+}
+const { data: archetypeData } = fetchApi<{ archetypes: Archetype[] }>(
+  '/api/personas/archetypes',
+)
+const archetypes = computed<Archetype[]>(() => archetypeData.value?.archetypes ?? [])
+
+function applyArchetype(arch: Archetype) {
+  if (!name.value.trim()) name.value = arch.name
+  if (!sourceLabel.value.trim()) sourceLabel.value = arch.title
+  description.value = arch.description
+  mode.value = 'description'
+}
+
 // ─── Step 2 state ────────────────────────────────────────────────────────
 const ingestJobs = ref<Array<{
   source: string
@@ -389,10 +409,28 @@ function backToStep1() {
         label="Description"
         help="Plain-text description of the person — their style, beliefs, what they do, how they talk. The LLM uses this verbatim. Minimum 20 characters."
       >
+        <template #hint>
+          <UDropdownMenu
+            v-if="archetypes.length > 0"
+            :items="archetypes.map((a) => ({
+              label: `${a.name} — ${a.title}`,
+              icon: 'i-lucide-sparkles',
+              onSelect: () => applyArchetype(a),
+            }))"
+          >
+            <UButton
+              label="Start from archetype"
+              icon="i-lucide-sparkles"
+              variant="ghost"
+              size="xs"
+              trailing-icon="i-lucide-chevron-down"
+            />
+          </UDropdownMenu>
+        </template>
         <UTextarea
           v-model="description"
           :rows="6"
-          placeholder="A direct-response copywriter who treats offers as the only true growth lever. Punchy, allergic to fluff. Loves Hormozi-style hooks."
+          placeholder="A direct-response copywriter who treats offers as the only true growth lever. Punchy, allergic to fluff."
           class="w-full"
         />
       </UFormField>

package/dashboard/app/pages/workflows.vue

@@ -13,6 +13,7 @@ interface WorkflowPhase {
   description: string
   gate_type: string
   agent_count: number
+  agent_ids?: string[]
 }
 
 interface Workflow {
@@ -268,16 +269,22 @@ const columns: TableColumn<Workflow>[] = [
                         variant="subtle"
                         size="xs"
                       />
-                      <UBadge
-                        v-if="ph.agent_count > 0"
-                        :label="`${ph.agent_count} agent${ph.agent_count === 1 ? '' : 's'}`"
-                        variant="outline"
-                        size="xs"
-                      />
                     </div>
                     <p v-if="ph.description" class="text-xs text-muted mt-1">
                       {{ ph.description }}
                     </p>
+                    <!-- PR93a v3.43.0 — clickable agent badges -->
+                    <div v-if="ph.agent_ids && ph.agent_ids.length > 0" class="flex flex-wrap gap-1 mt-2">
+                      <NuxtLink
+                        v-for="aid in ph.agent_ids"
+                        :key="aid"
+                        :to="`/agents/${aid}`"
+                        class="inline-flex items-center gap-1 rounded-md border border-default px-1.5 py-0.5 text-[10px] font-mono hover:border-primary/40 hover:text-primary transition-colors"
+                      >
+                        <UIcon name="i-lucide-user" class="size-2.5" />
+                        {{ aid }}
+                      </NuxtLink>
+                    </div>
                   </div>
                 </li>
               </ol>

package/package.json

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

package/scripts/dashboard-api.py

@@ -322,6 +322,17 @@ def agent_activity_strip(agent_id: str, period: str = "month"):
     }
 
 
+@app.get("/api/personas/archetypes")
+def personas_archetypes():
+    """PR93b v3.44.0 — list curated persona archetype templates.
+
+    Used by PersonaWizard step 1 to seed the description field + DNA
+    defaults when the operator picks "Start from archetype".
+    """
+    from core.personas.archetypes import ARCHETYPES
+    return {"archetypes": ARCHETYPES, "total": len(ARCHETYPES)}
+
+
 @app.get("/api/personas/export-all.zip")
 def personas_export_all():
     """PR92a v3.39.0 — stream every persona as Markdown inside a ZIP.
@@ -1918,21 +1929,30 @@ def workflows_list():
 
 
 def _summarise_phases(phases: list) -> list[dict]:
-    """PR91c v3.37.0 — distil each phase down to what the flow stepper needs."""
+    """PR91c v3.37.0 — distil each phase down to what the flow stepper needs.
+
+    PR93a v3.43.0 — also surfaces the explicit ``agent_ids`` so the UI
+    can render them as clickable badges.
+    """
     out: list[dict] = []
     for p in phases:
         if not isinstance(p, dict):
             continue
         gate = p.get("gate") if isinstance(p.get("gate"), dict) else {}
         agents = p.get("agents") if isinstance(p.get("agents"), list) else []
+        agent_ids: list[str] = []
+        for a in agents:
+            if isinstance(a, dict):
+                aid = a.get("agent_id")
+                if aid:
+                    agent_ids.append(str(aid))
         out.append({
             "id": str(p.get("id") or ""),
             "name": str(p.get("name") or ""),
             "description": str(p.get("description") or ""),
             "gate_type": str(gate.get("type") or ""),
-            "agent_count": sum(
-                1 for a in agents if isinstance(a, dict) and a.get("agent_id")
-            ),
+            "agent_count": len(agent_ids),
+            "agent_ids": agent_ids,
         })
     return out