arkaos 3.71.1 → 3.72.0

package/VERSION

@@ -1 +1 @@
-3.71.1
+3.72.0

package/dashboard/app/layouts/default.vue

@@ -80,6 +80,13 @@ const links = [[{
   onSelect: () => {
     open.value = false
   }
+}, {
+  label: 'Dreaming',
+  icon: 'i-lucide-sparkles',
+  to: '/cognition',
+  onSelect: () => {
+    open.value = false
+  }
 }], [{
   label: 'Health',
   icon: 'i-lucide-heart-pulse',

package/dashboard/app/pages/cognition.vue

@@ -0,0 +1,311 @@
+<script setup lang="ts">
+// v3.72.0 — Cognition page: monitor what Dreaming has been learning.
+// Read-only view over the insights the Cognitive Layer already writes to
+// <vault>/Projects/ArkaOS/Dreams. Backend: /api/cognition/{insights,status}.
+
+import { marked } from 'marked'
+
+definePageMeta({ layout: 'default' })
+
+interface Insight {
+  date: string
+  title: string
+  confidence: string
+  sources: string[]
+  tags: string[]
+  body: string
+}
+interface Status {
+  today: number
+  week: number
+  total: number
+  by_confidence: { high: number, medium: number, low: number }
+  vault_configured: boolean
+  last_date: string | null
+}
+
+const { apiBase } = useApi()
+
+const days = ref(7)
+const confidenceFilter = ref<'all' | 'high' | 'medium' | 'low'>('all')
+const tagFilter = ref('')
+const insights = ref<Insight[]>([])
+const status = ref<Status | null>(null)
+const available = ref(true)
+const loading = ref(true)
+const expanded = ref<Set<string>>(new Set())
+
+const windowOptions = [
+  { label: 'Today', value: 1 },
+  { label: 'Last 7 days', value: 7 },
+  { label: 'Last 30 days', value: 30 }
+]
+const confidenceOptions = [
+  { label: 'All confidence', value: 'all' },
+  { label: 'High', value: 'high' },
+  { label: 'Medium', value: 'medium' },
+  { label: 'Low', value: 'low' }
+]
+
+async function refresh() {
+  loading.value = true
+  try {
+    const [s, i] = await Promise.all([
+      $fetch<Status>(`${apiBase}/api/cognition/status`),
+      $fetch<{ insights: Insight[], available: boolean }>(
+        `${apiBase}/api/cognition/insights?days=${days.value}`
+      )
+    ])
+    status.value = s
+    insights.value = i.insights
+    available.value = i.available
+  } catch {
+    available.value = false
+  } finally {
+    loading.value = false
+  }
+}
+
+onMounted(refresh)
+// Reset the tag filter when the window changes — a tag may not exist in the
+// new window, which would otherwise strand the user on an empty result.
+watch(days, () => {
+  tagFilter.value = ''
+  refresh()
+})
+
+const allTags = computed(() => {
+  const set = new Set<string>()
+  for (const i of insights.value) for (const t of i.tags) set.add(t)
+  return [...set].sort()
+})
+
+const filtered = computed(() => insights.value.filter((i) => {
+  if (confidenceFilter.value !== 'all' && i.confidence !== confidenceFilter.value) return false
+  if (tagFilter.value && !i.tags.includes(tagFilter.value)) return false
+  return true
+}))
+
+function confidenceColor(c: string): 'success' | 'warning' | 'neutral' {
+  if (c === 'high') return 'success'
+  if (c === 'low') return 'neutral'
+  return 'warning'
+}
+
+function toggle(key: string) {
+  const next = new Set(expanded.value)
+  if (next.has(key)) next.delete(key)
+  else next.add(key)
+  expanded.value = next
+}
+
+function renderBody(body: string): string {
+  if (!body) return ''
+  try {
+    return marked.parse(body, { async: false }) as string
+  } catch {
+    return body
+  }
+}
+
+const isActive = computed(() => {
+  if (!status.value?.last_date) return false
+  const last = new Date(status.value.last_date + 'T00:00:00Z').getTime()
+  return Date.now() - last < 3 * 86_400_000
+})
+</script>
+
+<template>
+  <UDashboardPanel id="cognition">
+    <template #header>
+      <UDashboardNavbar title="Dreaming">
+        <template #leading>
+          <UDashboardSidebarCollapse />
+        </template>
+        <template #right>
+          <UBadge
+            :color="isActive ? 'success' : 'neutral'"
+            variant="soft"
+            size="sm"
+          >
+            <UIcon
+              :name="isActive ? 'i-lucide-activity' : 'i-lucide-moon'"
+              class="size-3 mr-1"
+            />
+            {{ isActive ? 'Active' : 'Idle' }}
+            <span v-if="status?.last_date" class="ml-1 opacity-70">· {{ status.last_date }}</span>
+          </UBadge>
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <div class="flex flex-col gap-4 p-4">
+        <p class="text-sm text-muted -mt-1">
+          What the Cognitive Layer has been learning — insights surfaced by
+          Dreaming from your vault and sessions.
+        </p>
+
+        <!-- Stats -->
+        <div v-if="status?.vault_configured" class="grid grid-cols-2 sm:grid-cols-4 gap-3">
+          <div class="rounded-lg border border-default bg-elevated/10 p-3">
+            <div class="text-2xl font-semibold tabular-nums">
+              {{ status.today }}
+            </div>
+            <div class="text-xs text-muted">
+              today
+            </div>
+          </div>
+          <div class="rounded-lg border border-default bg-elevated/10 p-3">
+            <div class="text-2xl font-semibold tabular-nums">
+              {{ status.week }}
+            </div>
+            <div class="text-xs text-muted">
+              last 7 days
+            </div>
+          </div>
+          <div class="rounded-lg border border-default bg-elevated/10 p-3">
+            <div class="text-2xl font-semibold tabular-nums">
+              {{ status.total }}
+            </div>
+            <div class="text-xs text-muted">
+              total insights
+            </div>
+          </div>
+          <div class="rounded-lg border border-default bg-elevated/10 p-3 flex flex-col justify-center gap-1">
+            <div class="flex items-center gap-2 text-xs">
+              <UBadge color="success" variant="soft" size="xs">
+                high {{ status.by_confidence.high }}
+              </UBadge>
+              <UBadge color="warning" variant="soft" size="xs">
+                med {{ status.by_confidence.medium }}
+              </UBadge>
+              <UBadge color="neutral" variant="soft" size="xs">
+                low {{ status.by_confidence.low }}
+              </UBadge>
+            </div>
+          </div>
+        </div>
+
+        <!-- Filters -->
+        <div class="flex flex-wrap items-center gap-2">
+          <USelect
+            v-model="days"
+            :items="windowOptions"
+            size="sm"
+            class="w-40"
+          />
+          <USelect
+            v-model="confidenceFilter"
+            :items="confidenceOptions"
+            size="sm"
+            class="w-44"
+          />
+          <USelect
+            v-if="allTags.length"
+            v-model="tagFilter"
+            :items="[{ label: 'All tags', value: '' }, ...allTags.map(t => ({ label: '#' + t, value: t }))]"
+            size="sm"
+            class="w-40"
+          />
+          <UButton
+            size="sm"
+            variant="ghost"
+            icon="i-lucide-refresh-cw"
+            :loading="loading"
+            @click="refresh"
+          >
+            Refresh
+          </UButton>
+        </div>
+
+        <!-- Feed -->
+        <div v-if="loading" class="text-sm text-muted py-8 text-center">
+          <UIcon name="i-lucide-loader" class="animate-spin size-5 mx-auto mb-2" />
+          Loading insights…
+        </div>
+        <div
+          v-else-if="!available || !status?.vault_configured"
+          class="rounded-lg border border-dashed border-default p-10 text-center text-muted"
+        >
+          <UIcon name="i-lucide-moon-star" class="size-8 mx-auto mb-3 opacity-40" />
+          <p class="text-sm">
+            No vault connected, or Dreaming hasn't run yet.
+          </p>
+          <p class="text-xs mt-1 opacity-70">
+            Configure a vault and let the Cognitive Layer dream — insights show up here.
+          </p>
+        </div>
+        <div
+          v-else-if="filtered.length === 0"
+          class="rounded-lg border border-dashed border-default p-10 text-center text-muted"
+        >
+          <UIcon name="i-lucide-search-x" class="size-7 mx-auto mb-3 opacity-40" />
+          <p class="text-sm">
+            No insights match these filters.
+          </p>
+        </div>
+        <ul v-else class="flex flex-col gap-3">
+          <li
+            v-for="(ins, idx) in filtered"
+            :key="`${ins.date}-${idx}`"
+            class="rounded-lg border border-default bg-elevated/10 overflow-hidden"
+          >
+            <button
+              class="w-full flex items-start gap-3 p-3 text-left hover:bg-elevated/20 transition-colors"
+              @click="toggle(`${ins.date}-${idx}`)"
+            >
+              <UBadge
+                :color="confidenceColor(ins.confidence)"
+                variant="soft"
+                size="xs"
+                class="mt-0.5 shrink-0 uppercase"
+              >
+                {{ ins.confidence }}
+              </UBadge>
+              <div class="flex-1 min-w-0">
+                <div class="font-medium truncate">
+                  {{ ins.title }}
+                </div>
+                <div class="flex items-center gap-2 mt-1 flex-wrap">
+                  <span class="text-xs text-muted tabular-nums">{{ ins.date }}</span>
+                  <UBadge
+                    v-for="t in ins.tags"
+                    :key="t"
+                    variant="subtle"
+                    size="xs"
+                  >
+                    #{{ t }}
+                  </UBadge>
+                </div>
+              </div>
+              <UIcon
+                :name="expanded.has(`${ins.date}-${idx}`) ? 'i-lucide-chevron-up' : 'i-lucide-chevron-down'"
+                class="size-4 shrink-0 text-muted mt-0.5"
+              />
+            </button>
+            <div v-if="expanded.has(`${ins.date}-${idx}`)" class="px-3 pb-3 border-t border-default/60 pt-3">
+              <!-- Trusted content: the operator's own Dreaming output from
+                   their local vault, served over the localhost-only API —
+                   same trust boundary as the persona bio renderer. -->
+              <!-- eslint-disable-next-line vue/no-v-html -->
+              <div class="prose prose-sm dark:prose-invert max-w-none text-sm" v-html="renderBody(ins.body)" />
+              <div v-if="ins.sources.length" class="flex items-center gap-1.5 flex-wrap mt-3 pt-2 border-t border-default/40">
+                <span class="text-[11px] text-muted">sources:</span>
+                <UBadge
+                  v-for="s in ins.sources"
+                  :key="s"
+                  variant="subtle"
+                  size="xs"
+                  color="info"
+                >
+                  {{ s }}
+                </UBadge>
+              </div>
+            </div>
+          </li>
+        </ul>
+      </div>
+    </template>
+  </UDashboardPanel>
+</template>

package/dashboard/app/pages/settings.vue

@@ -1,4 +1,7 @@
 <script setup lang="ts">
+// PR92d v3.42.0 — primary color picker.
+import { THEME_COLOR_OPTIONS, useThemeColor } from '~/composables/useThemeColor'
+
 interface ProfileResponse {
   version: string
   name: string
@@ -22,7 +25,7 @@ const {
   data: profile,
   status: profileStatus,
   error: profileError,
-  refresh: refreshProfile,
+  refresh: refreshProfile
 } = await fetchApi<ProfileResponse>('/api/profile')
 
 const profileDraft = ref({
@@ -32,7 +35,7 @@ const profileDraft = ref({
   market: profile.value?.market ?? '',
   language: profile.value?.language ?? 'en',
   vaultPath: profile.value?.vaultPath ?? '',
-  projectsDir: profile.value?.projectsDir ?? '',
+  projectsDir: profile.value?.projectsDir ?? ''
 })
 
 watch(profile, (p) => {
@@ -44,7 +47,7 @@ watch(profile, (p) => {
     market: p.market,
     language: p.language,
     vaultPath: p.vaultPath,
-    projectsDir: p.projectsDir,
+    projectsDir: p.projectsDir
   }
 }, { immediate: true })
 
@@ -68,7 +71,7 @@ async function testVault() {
     if (profileDraft.value.vaultPath !== profile.value?.vaultPath) {
       await $fetch(`${apiBase}/api/profile`, {
         method: 'POST',
-        body: { vaultPath: profileDraft.value.vaultPath },
+        body: { vaultPath: profileDraft.value.vaultPath }
       })
     }
     vaultStatus.value = await $fetch<VaultStatus>(`${apiBase}/api/settings/vault`)
@@ -76,13 +79,13 @@ async function testVault() {
       title: vaultStatus.value.exists ? 'Vault reachable' : 'Vault not found',
       description: vaultStatus.value.vault_path || 'Set a path first',
       color: vaultStatus.value.exists ? 'success' : 'warning',
-      icon: vaultStatus.value.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle',
+      icon: vaultStatus.value.exists ? 'i-lucide-check-circle' : 'i-lucide-alert-circle'
     })
   } catch (err) {
     toast.add({
       title: 'Test failed',
       description: err instanceof Error ? err.message : 'unknown error',
-      color: 'error',
+      color: 'error'
     })
   } finally {
     testingVault.value = false
@@ -94,19 +97,19 @@ async function saveProfile() {
   try {
     await $fetch<ProfileResponse>(`${apiBase}/api/profile`, {
       method: 'POST',
-      body: profileDraft.value,
+      body: profileDraft.value
     })
     await refreshProfile()
     toast.add({
       title: 'Profile saved',
       description: 'Settings written to ~/.arkaos/profile.json',
-      color: 'success',
+      color: 'success'
     })
   } catch (err) {
     toast.add({
       title: 'Save failed',
       description: err instanceof Error ? err.message : 'unknown error',
-      color: 'error',
+      color: 'error'
     })
   } finally {
     savingProfile.value = false
@@ -115,7 +118,7 @@ async function saveProfile() {
 
 const languageOptions = [
   { label: 'English', value: 'en' },
-  { label: 'Português', value: 'pt' },
+  { label: 'Português', value: 'pt' }
 ]
 
 const roleOptions = [
@@ -125,16 +128,23 @@ const roleOptions = [
   { label: 'Engineer', value: 'engineer' },
   { label: 'Designer', value: 'designer' },
   { label: 'Operator', value: 'operator' },
-  { label: 'Consultant', value: 'consultant' },
+  { label: 'Consultant', value: 'consultant' }
 ]
 
 // ─── API Keys (preserved from earlier) ──────────────────────────────────
 
+interface KeyRow {
+  key: string
+  provider: string
+  configured: boolean
+  used_for?: string
+}
+
 const {
   data: keysData,
   status: keysStatus,
-  refresh: refreshKeys,
-} = fetchApi<any>('/api/keys')
+  refresh: refreshKeys
+} = fetchApi<{ keys: KeyRow[] }>('/api/keys')
 
 const keys = computed(() => keysData.value?.keys ?? [])
 
@@ -154,13 +164,13 @@ async function saveKey() {
   try {
     await $fetch(`${apiBase}/api/keys`, {
       method: 'POST',
-      body: { key: keyName, value: newValue.value },
+      body: { key: keyName, value: newValue.value }
     })
     newKey.value = ''
     newValue.value = ''
     customKeyName.value = ''
     await refreshKeys()
-  } catch {}
+  } catch { /* best-effort; surfaced via list refresh */ }
   saving.value = false
 }
 
@@ -169,7 +179,7 @@ async function deleteKey(keyName: string) {
   try {
     await $fetch(`${apiBase}/api/keys/${keyName}`, { method: 'DELETE' })
     await refreshKeys()
-  } catch {}
+  } catch { /* best-effort; surfaced via list refresh */ }
   deletingKey.value = null
 }
 
@@ -177,7 +187,7 @@ const keyOptions = [
   { label: 'OPENAI_API_KEY', value: 'OPENAI_API_KEY' },
   { label: 'FAL_API_KEY', value: 'FAL_API_KEY' },
   { label: 'GOOGLE_API_KEY', value: 'GOOGLE_API_KEY' },
-  { label: 'Custom...', value: 'custom' },
+  { label: 'Custom...', value: 'custom' }
 ]
 
 // ─── PR63b v2.89.0 — MCPs / Hooks / Plugins / Theme sections ────────────
@@ -231,11 +241,8 @@ const colorMode = useColorMode()
 const themeOptions = [
   { label: 'System (auto)', value: 'system' },
   { label: 'Light', value: 'light' },
-  { label: 'Dark', value: 'dark' },
+  { label: 'Dark', value: 'dark' }
 ]
-
-// PR92d v3.42.0 — primary color picker.
-import { THEME_COLOR_OPTIONS, useThemeColor } from '~/composables/useThemeColor'
 const themeColor = useThemeColor()
 const themeColorOptions = THEME_COLOR_OPTIONS
 
@@ -256,19 +263,52 @@ function formatInstalledAt(iso: string): string {
 
 // ─── Section nav ────────────────────────────────────────────────────────
 
-type SectionId = 'profile' | 'projects' | 'keys' | 'mcps' | 'hooks' | 'plugins' | 'theme'
-
-const sections: { id: SectionId; label: string; icon: string }[] = [
-  { id: 'profile',  label: 'Profile',   icon: 'i-lucide-user-circle' },
-  { id: 'projects', label: 'Projects',  icon: 'i-lucide-folders' },
-  { id: 'keys',     label: 'API Keys',  icon: 'i-lucide-key' },
-  { id: 'mcps',     label: 'MCPs',      icon: 'i-lucide-plug-2' },
-  { id: 'hooks',    label: 'Hooks',     icon: 'i-lucide-webhook' },
-  { id: 'plugins',  label: 'Plugins',   icon: 'i-lucide-puzzle' },
-  { id: 'theme',    label: 'Theme',     icon: 'i-lucide-palette' },
+type SectionId = 'profile' | 'projects' | 'keys' | 'mcps' | 'hooks' | 'plugins' | 'theme' | 'updates'
+
+const sections: { id: SectionId, label: string, icon: string }[] = [
+  { id: 'profile', label: 'Profile', icon: 'i-lucide-user-circle' },
+  { id: 'projects', label: 'Projects', icon: 'i-lucide-folders' },
+  { id: 'keys', label: 'API Keys', icon: 'i-lucide-key' },
+  { id: 'mcps', label: 'MCPs', icon: 'i-lucide-plug-2' },
+  { id: 'hooks', label: 'Hooks', icon: 'i-lucide-webhook' },
+  { id: 'plugins', label: 'Plugins', icon: 'i-lucide-puzzle' },
+  { id: 'theme', label: 'Theme', icon: 'i-lucide-palette' },
+  { id: 'updates', label: 'Updates', icon: 'i-lucide-download' }
 ]
 
 const activeSection = ref<SectionId>('profile')
+
+// ─── Updates (v3.72.0) — version check + one-click core update ──────────
+const ver = ref<{ current: string, latest: string | null, update_available: boolean } | null>(null)
+const checkingVer = ref(false)
+const updating = ref(false)
+const updateResult = ref<{ ok: boolean, output: string } | null>(null)
+
+async function checkVersion() {
+  checkingVer.value = true
+  try {
+    ver.value = await $fetch(`${apiBase}/api/system/version`)
+  } catch {
+    ver.value = null
+  } finally {
+    checkingVer.value = false
+  }
+}
+
+async function runUpdate() {
+  updating.value = true
+  updateResult.value = null
+  try {
+    updateResult.value = await $fetch(`${apiBase}/api/system/update`, { method: 'POST' })
+  } catch (e) {
+    updateResult.value = { ok: false, output: e instanceof Error ? e.message : String(e) }
+  } finally {
+    updating.value = false
+    checkVersion()
+  }
+}
+
+onMounted(checkVersion)
 </script>
 
 <template>
@@ -299,8 +339,8 @@ const activeSection = ref<SectionId>('profile')
             <span>{{ s.label }}</span>
           </button>
           <p class="text-xs text-muted px-3 mt-6">
-            7 sections. Profile + Projects edit data; everything else is
-            read-only diagnostics until an explicit edit endpoint lands.
+            8 sections. Profile + Projects edit data; Updates runs the core
+            update; everything else is read-only diagnostics.
           </p>
         </nav>
 
@@ -308,7 +348,9 @@ const activeSection = ref<SectionId>('profile')
         <div>
           <!-- Profile -->
           <section v-if="activeSection === 'profile'">
-            <h2 class="text-lg font-semibold mb-1">Profile</h2>
+            <h2 class="text-lg font-semibold mb-1">
+              Profile
+            </h2>
             <p class="text-sm text-muted mb-6">
               Your identity, role, and language. Stored locally at
               <code class="font-mono text-xs">~/.arkaos/profile.json</code>.
@@ -448,7 +490,9 @@ const activeSection = ref<SectionId>('profile')
 
           <!-- Projects -->
           <section v-else-if="activeSection === 'projects'">
-            <h2 class="text-lg font-semibold mb-1">Project directories</h2>
+            <h2 class="text-lg font-semibold mb-1">
+              Project directories
+            </h2>
             <p class="text-sm text-muted mb-6">
               Directories the sync engine scans for projects.
               Comma-separated absolute paths (e.g.
@@ -500,7 +544,9 @@ const activeSection = ref<SectionId>('profile')
 
           <!-- API Keys -->
           <section v-else-if="activeSection === 'keys'">
-            <h2 class="text-lg font-semibold mb-1">API Keys</h2>
+            <h2 class="text-lg font-semibold mb-1">
+              API Keys
+            </h2>
             <p class="text-sm text-muted mb-6">
               Configure API keys for external services. Keys are stored
               locally at <code class="font-mono text-xs">~/.arkaos/keys.json</code>.
@@ -508,11 +554,18 @@ const activeSection = ref<SectionId>('profile')
 
             <UCard class="mb-6">
               <div class="space-y-4">
-                <p class="text-xs font-semibold text-muted uppercase tracking-wider">Add API Key</p>
+                <p class="text-xs font-semibold text-muted uppercase tracking-wider">
+                  Add API Key
+                </p>
                 <div class="grid grid-cols-1 md:grid-cols-3 gap-3 items-end">
                   <div>
                     <label class="text-xs text-muted mb-1 block">Provider</label>
-                    <USelect v-model="newKey" :items="keyOptions" class="w-full" placeholder="Select key..." />
+                    <USelect
+                      v-model="newKey"
+                      :items="keyOptions"
+                      class="w-full"
+                      placeholder="Select key..."
+                    />
                   </div>
                   <div v-if="isCustom">
                     <label class="text-xs text-muted mb-1 block">Key Name</label>
@@ -520,7 +573,12 @@ const activeSection = ref<SectionId>('profile')
                   </div>
                   <div :class="isCustom ? '' : 'md:col-span-1'">
                     <label class="text-xs text-muted mb-1 block">Value</label>
-                    <UInput v-model="newValue" type="password" class="w-full" placeholder="sk-..." />
+                    <UInput
+                      v-model="newValue"
+                      type="password"
+                      class="w-full"
+                      placeholder="sk-..."
+                    />
                   </div>
                   <div>
                     <UButton
@@ -560,9 +618,17 @@ const activeSection = ref<SectionId>('profile')
                         variant="subtle"
                         size="xs"
                       />
-                      <UBadge v-else label="Not Set" color="neutral" variant="outline" size="xs" />
+                      <UBadge
+                        v-else
+                        label="Not Set"
+                        color="neutral"
+                        variant="outline"
+                        size="xs"
+                      />
                     </div>
-                    <p v-if="k.used_for" class="text-xs text-muted mt-0.5">{{ k.used_for }}</p>
+                    <p v-if="k.used_for" class="text-xs text-muted mt-0.5">
+                      {{ k.used_for }}
+                    </p>
                     <p v-if="k.masked_value && k.configured" class="text-xs font-mono text-muted/60 mt-0.5">
                       {{ k.masked_value }}
                     </p>
@@ -585,7 +651,9 @@ const activeSection = ref<SectionId>('profile')
           <!-- MCPs -->
           <section v-else-if="activeSection === 'mcps'">
             <div class="flex items-baseline justify-between mb-1">
-              <h2 class="text-lg font-semibold">MCPs</h2>
+              <h2 class="text-lg font-semibold">
+                MCPs
+              </h2>
               <UButton
                 label="Refresh"
                 variant="ghost"
@@ -601,7 +669,9 @@ const activeSection = ref<SectionId>('profile')
             </p>
             <div v-if="!mcps.length" class="rounded-lg border border-default p-6 text-center">
               <UIcon name="i-lucide-plug-2" class="size-10 text-muted mx-auto mb-2" />
-              <p class="text-sm text-muted">No MCP servers configured.</p>
+              <p class="text-sm text-muted">
+                No MCP servers configured.
+              </p>
             </div>
             <div v-else class="space-y-2">
               <div
@@ -632,7 +702,9 @@ const activeSection = ref<SectionId>('profile')
           <!-- Hooks -->
           <section v-else-if="activeSection === 'hooks'">
             <div class="flex items-baseline justify-between mb-1">
-              <h2 class="text-lg font-semibold">Hooks</h2>
+              <h2 class="text-lg font-semibold">
+                Hooks
+              </h2>
               <UButton
                 label="Refresh"
                 variant="ghost"
@@ -657,7 +729,9 @@ const activeSection = ref<SectionId>('profile')
             </div>
             <div v-if="!hooks.length" class="rounded-lg border border-default p-6 text-center">
               <UIcon name="i-lucide-webhook" class="size-10 text-muted mx-auto mb-2" />
-              <p class="text-sm text-muted">No hooks wired in settings.json.</p>
+              <p class="text-sm text-muted">
+                No hooks wired in settings.json.
+              </p>
             </div>
             <div v-else class="space-y-3">
               <div
@@ -691,7 +765,9 @@ const activeSection = ref<SectionId>('profile')
           <!-- Plugins -->
           <section v-else-if="activeSection === 'plugins'">
             <div class="flex items-baseline justify-between mb-1">
-              <h2 class="text-lg font-semibold">Plugins</h2>
+              <h2 class="text-lg font-semibold">
+                Plugins
+              </h2>
               <UButton
                 label="Refresh"
                 variant="ghost"
@@ -707,7 +783,9 @@ const activeSection = ref<SectionId>('profile')
             </p>
             <div v-if="!plugins.length" class="rounded-lg border border-default p-6 text-center">
               <UIcon name="i-lucide-puzzle" class="size-10 text-muted mx-auto mb-2" />
-              <p class="text-sm text-muted">No plugins installed.</p>
+              <p class="text-sm text-muted">
+                No plugins installed.
+              </p>
               <p class="text-xs text-muted mt-2">
                 Try <code class="font-mono">/plugin marketplace add andreagroferreira/arka-os</code>
                 from Claude Code.
@@ -724,8 +802,18 @@ const activeSection = ref<SectionId>('profile')
                   <div class="flex items-center gap-2 mb-0.5">
                     <span class="text-sm font-semibold">{{ p.name }}</span>
                     <UBadge :label="p.marketplace" variant="outline" size="xs" />
-                    <UBadge v-if="p.scope" :label="p.scope" variant="soft" size="xs" />
-                    <UBadge v-if="p.version" :label="`v${p.version}`" variant="subtle" size="xs" />
+                    <UBadge
+                      v-if="p.scope"
+                      :label="p.scope"
+                      variant="soft"
+                      size="xs"
+                    />
+                    <UBadge
+                      v-if="p.version"
+                      :label="`v${p.version}`"
+                      variant="subtle"
+                      size="xs"
+                    />
                   </div>
                   <p v-if="p.installed_at" class="text-xs text-muted">
                     Installed {{ formatInstalledAt(p.installed_at) }}
@@ -737,7 +825,9 @@ const activeSection = ref<SectionId>('profile')
 
           <!-- Theme -->
           <section v-else-if="activeSection === 'theme'">
-            <h2 class="text-lg font-semibold mb-1">Theme</h2>
+            <h2 class="text-lg font-semibold mb-1">
+              Theme
+            </h2>
             <p class="text-sm text-muted mb-6">
               Light / dark / system (follows OS preference).
               Stored locally by your browser.
@@ -779,7 +869,7 @@ const activeSection = ref<SectionId>('profile')
                           'bg-rose-500': opt.value === 'rose',
                           'bg-amber-500': opt.value === 'amber',
                           'bg-teal-500': opt.value === 'teal',
-                          'bg-cyan-500': opt.value === 'cyan',
+                          'bg-cyan-500': opt.value === 'cyan'
                         }"
                       />
                       {{ opt.label }}
@@ -789,6 +879,80 @@ const activeSection = ref<SectionId>('profile')
               </div>
             </UCard>
           </section>
+
+          <section v-else-if="activeSection === 'updates'">
+            <h2 class="text-lg font-semibold mb-1">
+              Updates
+            </h2>
+            <p class="text-sm text-muted mb-6">
+              Keep ArkaOS current. The button runs the core update
+              (<code class="text-xs">npx arkaos@latest update</code>); finish
+              the project sync by running <code class="text-xs">/arka update</code>
+              in Claude Code.
+            </p>
+            <UCard>
+              <div class="space-y-4">
+                <div class="flex items-center gap-3 flex-wrap">
+                  <div class="text-sm">
+                    Installed:
+                    <UBadge :label="`v${ver?.current ?? '—'}`" variant="subtle" size="sm" />
+                  </div>
+                  <div class="text-sm">
+                    Latest:
+                    <UBadge
+                      :label="ver?.latest ? `v${ver.latest}` : '—'"
+                      :color="ver?.update_available ? 'warning' : 'success'"
+                      variant="subtle"
+                      size="sm"
+                    />
+                  </div>
+                  <UButton
+                    size="xs"
+                    variant="ghost"
+                    icon="i-lucide-refresh-cw"
+                    :loading="checkingVer"
+                    @click="checkVersion"
+                  >
+                    Check
+                  </UButton>
+                </div>
+
+                <div v-if="ver?.update_available" class="flex items-center gap-3">
+                  <UButton
+                    icon="i-lucide-download"
+                    color="primary"
+                    :loading="updating"
+                    @click="runUpdate"
+                  >
+                    {{ updating ? 'Updating…' : `Update to v${ver.latest}` }}
+                  </UButton>
+                  <span class="text-xs text-muted">Runs the core update, then asks you to finish in Claude Code.</span>
+                </div>
+                <p v-else-if="ver && !ver.update_available" class="text-sm text-success flex items-center gap-1.5">
+                  <UIcon name="i-lucide-check-circle" class="size-4" />
+                  You're on the latest version.
+                </p>
+                <p v-else class="text-sm text-muted">
+                  Couldn't reach the version service.
+                </p>
+
+                <div
+                  v-if="updateResult"
+                  class="rounded-lg border p-3 text-xs"
+                  :class="updateResult.ok ? 'border-success/40 bg-success/5' : 'border-error/40 bg-error/5'"
+                >
+                  <div class="flex items-center gap-1.5 font-medium mb-1">
+                    <UIcon :name="updateResult.ok ? 'i-lucide-check-circle' : 'i-lucide-alert-triangle'" class="size-4" />
+                    {{ updateResult.ok ? 'Core updated' : 'Update failed' }}
+                  </div>
+                  <p v-if="updateResult.ok" class="text-muted">
+                    Now run <code>/arka update</code> in Claude Code to sync all projects (step 2).
+                  </p>
+                  <pre class="mt-2 whitespace-pre-wrap font-mono text-[11px] text-muted max-h-48 overflow-y-auto">{{ updateResult.output }}</pre>
+                </div>
+              </div>
+            </UCard>
+          </section>
         </div>
       </div>
     </template>

package/installer/autostart.js

@@ -0,0 +1,178 @@
+/**
+ * Cross-OS autostart for the ArkaOS dashboard (v3.72.0, feature #2).
+ *
+ * Opt-in: `npx arkaos autostart enable|disable|status`. Installs a per-OS
+ * boot item that runs `scripts/start-dashboard.sh` (macOS/Linux) or
+ * `scripts/start-dashboard.ps1` (Windows) — the same launcher the
+ * `dashboard` command uses, which already starts the Python API + the
+ * dashboard UI (preferring the production build, falling back to dev).
+ *
+ * ESM, Node + Bun, no interactive prompts. The unit-generation (`unitFor`)
+ * is pure so it can be unit-tested without touching the OS.
+ */
+
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const AUTOSTART_LABEL = "io.wizardingcode.arkaos.dashboard";
+const SERVICE_NAME = "arkaos-dashboard.service";
+
+function defaultRepoRoot() {
+  return join(dirname(fileURLToPath(import.meta.url)), "..");
+}
+
+/** Pure: the boot unit for a given platform. Throws on unsupported OS. */
+export function unitFor(os, { repoRoot, home }) {
+  if (os === "darwin") {
+    const startScript = `${repoRoot}/scripts/start-dashboard.sh`;
+    const log = `${home}/.arkaos/logs/dashboard-autostart.log`;
+    const content = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${AUTOSTART_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/bash</string>
+    <string>${startScript}</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>ARKAOS_ROOT</key>
+    <string>${repoRoot}</string>
+  </dict>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${log}</string>
+  <key>StandardErrorPath</key>
+  <string>${log}</string>
+</dict>
+</plist>
+`;
+    return {
+      kind: "launchd",
+      path: join(home, "Library", "LaunchAgents", `${AUTOSTART_LABEL}.plist`),
+      content,
+    };
+  }
+
+  if (os === "linux") {
+    const startScript = `${repoRoot}/scripts/start-dashboard.sh`;
+    const content = `[Unit]
+Description=ArkaOS Dashboard (Python API + UI)
+After=network.target
+
+[Service]
+Type=simple
+Environment=ARKAOS_ROOT=${repoRoot}
+ExecStart=/bin/bash ${startScript}
+Restart=on-failure
+
+[Install]
+WantedBy=default.target
+`;
+    return {
+      kind: "systemd",
+      path: join(home, ".config", "systemd", "user", SERVICE_NAME),
+      content,
+    };
+  }
+
+  if (os === "win32") {
+    const ps1 = join(repoRoot, "scripts", "start-dashboard.ps1");
+    const content = `@echo off
+rem ArkaOS dashboard autostart (login).
+powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "${ps1}"
+`;
+    return {
+      kind: "startup",
+      path: join(
+        home,
+        "AppData", "Roaming", "Microsoft", "Windows",
+        "Start Menu", "Programs", "Startup",
+        "arkaos-dashboard.cmd",
+      ),
+      content,
+    };
+  }
+
+  throw new Error(`unsupported platform for autostart: ${os}`);
+}
+
+function _silent(cmd) {
+  try {
+    execSync(cmd, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function enable({ repoRoot = defaultRepoRoot() } = {}) {
+  const unit = unitFor(process.platform, { repoRoot, home: homedir() });
+  mkdirSync(dirname(unit.path), { recursive: true });
+  mkdirSync(join(homedir(), ".arkaos", "logs"), { recursive: true });
+  writeFileSync(unit.path, unit.content, "utf8");
+  if (unit.kind === "launchd") {
+    _silent(`launchctl unload "${unit.path}"`);
+    if (!_silent(`launchctl load -w "${unit.path}"`)) {
+      return { ok: false, path: unit.path,
+        message: `Plist written but launchctl load failed — it will still run at next login.` };
+    }
+  } else if (unit.kind === "systemd") {
+    _silent("systemctl --user daemon-reload");
+    if (!_silent(`systemctl --user enable --now ${SERVICE_NAME}`)) {
+      return { ok: false, path: unit.path,
+        message: `Service written but systemctl enable failed — check 'systemctl --user' availability.` };
+    }
+  }
+  // startup: writing the .cmd is sufficient; it runs on next login.
+  return { ok: true, path: unit.path,
+    message: `Autostart enabled (${unit.kind}). The dashboard will start on login.` };
+}
+
+export function disable() {
+  const unit = unitFor(process.platform, { repoRoot: defaultRepoRoot(), home: homedir() });
+  if (unit.kind === "launchd") _silent(`launchctl unload "${unit.path}"`);
+  else if (unit.kind === "systemd") _silent(`systemctl --user disable --now ${SERVICE_NAME}`);
+  if (existsSync(unit.path)) rmSync(unit.path);
+  return { ok: true, path: unit.path, message: "Autostart disabled." };
+}
+
+export function status() {
+  let unit;
+  try {
+    unit = unitFor(process.platform, { repoRoot: defaultRepoRoot(), home: homedir() });
+  } catch (err) {
+    return { installed: false, supported: false, message: err.message };
+  }
+  return {
+    installed: existsSync(unit.path),
+    supported: true,
+    kind: unit.kind,
+    path: unit.path,
+  };
+}
+
+export async function autostart(args = []) {
+  const action = (args[0] || "status").toLowerCase();
+  if (action === "enable") {
+    const r = enable();
+    console.log(`  ${r.ok ? "✓" : "⚠"} ${r.message}\n    ${r.path}`);
+  } else if (action === "disable") {
+    const r = disable();
+    console.log(`  ✓ ${r.message}`);
+  } else if (action === "status") {
+    const s = status();
+    if (!s.supported) console.log(`  Autostart not supported here: ${s.message}`);
+    else console.log(`  Autostart: ${s.installed ? "ENABLED" : "disabled"} (${s.kind})\n    ${s.path}`);
+  } else {
+    console.error(`  Unknown autostart action: ${action}. Use enable | disable | status.`);
+    process.exitCode = 1;
+  }
+}

package/installer/cli.js

@@ -45,6 +45,7 @@ Usage:
   npx arkaos migrate          Migrate from v1 to v2
   npx arkaos migrate-user-data  Move user data (~/.claude/skills/arka/ → ~/.arkaos/)
   npx arkaos dashboard        Start monitoring dashboard
+  npx arkaos autostart <enable|disable|status>  Start dashboard on boot
   npx arkaos keys             Manage API keys (OpenAI, fal.ai, etc.)
   npx arkaos doctor           Run health checks
   npx arkaos uninstall        Remove ArkaOS
@@ -101,6 +102,12 @@ async function main() {
       await update();
       break;
 
+    case "autostart": {
+      const { autostart } = await import("./autostart.js");
+      await autostart(positionals.slice(1));
+      break;
+    }
+
     case "uninstall":
       const { uninstall } = await import("./uninstall.js");
       await uninstall();

package/package.json

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

package/scripts/dashboard-api.py

@@ -20,7 +20,7 @@ from typing import Optional
 ARKAOS_ROOT = Path(os.environ.get("ARKAOS_ROOT", Path(__file__).resolve().parent.parent))
 sys.path.insert(0, str(ARKAOS_ROOT))
 
-from fastapi import FastAPI, Query, WebSocket, WebSocketDisconnect
+from fastapi import FastAPI, Query, Request, WebSocket, WebSocketDisconnect
 from fastapi.middleware.cors import CORSMiddleware
 
 app = FastAPI(title="ArkaOS Dashboard API", version="2.2.0")
@@ -2259,6 +2259,160 @@ def workflow_update_yaml(workflow_id: str, body: dict):
     return {"updated": True, "id": workflow_id, "file": str(target)}
 
 
+# ============================================================================
+# v3.72.0 — Cognition: surface Dreaming insights (read-only) to the dashboard.
+# Reads existing markdown insights from <vault>/Projects/ArkaOS/Dreams via
+# core.cognition.dreams_reader. No new engine — pure read.
+# ============================================================================
+
+
+def _dreams_dir():
+    """Resolve the Dreams folder from the user's vault, or None."""
+    from core.runtime.path_resolver import load_profile, ProfileMissingError
+    try:
+        profile = load_profile()
+    except ProfileMissingError:
+        return None
+    except Exception:  # noqa: BLE001 — never break the endpoint on profile errors
+        return None
+    vault = getattr(profile, "vault_path", None)
+    return (Path(vault) / "Projects" / "ArkaOS" / "Dreams") if vault else None
+
+
+def _insight_to_dict(ins) -> dict:
+    return {
+        "date": ins.date,
+        "title": ins.title,
+        "confidence": ins.confidence,
+        "sources": list(ins.sources),
+        "tags": list(ins.tags),
+        "body": ins.body,
+    }
+
+
+@app.get("/api/cognition/insights")
+def cognition_insights(days: int = 7):
+    """Recent Dreaming insights within the given window. Never 500s."""
+    dreams = _dreams_dir()
+    if dreams is None:
+        return {"insights": [], "available": False}
+    from core.cognition.dreams_reader import list_insights
+    items = list_insights(dreams, since_days=max(1, int(days)))
+    return {"insights": [_insight_to_dict(i) for i in items], "available": True}
+
+
+@app.get("/api/cognition/status")
+def cognition_status():
+    """Insight counts + confidence breakdown + last activity date."""
+    dreams = _dreams_dir()
+    if dreams is None:
+        return {
+            "today": 0, "week": 0, "total": 0,
+            "by_confidence": {"high": 0, "medium": 0, "low": 0},
+            "vault_configured": False, "last_date": None,
+        }
+    from core.cognition.dreams_reader import list_insights
+    all_items = list_insights(dreams, since_days=36500)
+    by_conf = {"high": 0, "medium": 0, "low": 0}
+    for i in all_items:
+        by_conf[i.confidence if i.confidence in by_conf else "medium"] += 1
+    return {
+        "today": len(list_insights(dreams, since_days=1)),
+        "week": len(list_insights(dreams, since_days=7)),
+        "total": len(all_items),
+        "by_confidence": by_conf,
+        "vault_configured": True,
+        "last_date": all_items[0].date if all_items else None,
+    }
+
+
+# ============================================================================
+# v3.72.0 — System: version check + one-click core update (feature #3).
+# ============================================================================
+
+_npm_latest_cache = {"version": None, "ts": 0.0}
+
+
+def _current_version() -> str:
+    root = os.environ.get("ARKAOS_ROOT") or str(Path(__file__).resolve().parent.parent)
+    try:
+        return (Path(root) / "VERSION").read_text(encoding="utf-8").strip()
+    except OSError:
+        return "0.0.0"
+
+
+def _npm_latest_version():
+    import subprocess
+    import time
+    now = time.time()
+    if _npm_latest_cache["version"] and now - _npm_latest_cache["ts"] < 600:
+        return _npm_latest_cache["version"]
+    try:
+        out = subprocess.run(
+            ["npm", "view", "arkaos", "version"],
+            capture_output=True, text=True, timeout=20,
+        )
+        latest = (out.stdout or "").strip() or None
+    except Exception:  # noqa: BLE001
+        latest = None
+    if latest:
+        _npm_latest_cache["version"] = latest
+        _npm_latest_cache["ts"] = now
+    return latest
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    import re
+    def _parts(v):
+        nums = [int(n) for n in re.findall(r"\d+", v)[:3]]
+        return nums or [0]
+    try:
+        return _parts(latest) > _parts(current)
+    except Exception:  # noqa: BLE001
+        return False
+
+
+def _run_core_update() -> dict:
+    import subprocess
+    try:
+        out = subprocess.run(
+            ["npx", "arkaos@latest", "update"],
+            capture_output=True, text=True, timeout=600,
+        )
+        tail = ((out.stdout or "") + (out.stderr or ""))[-2000:]
+        return {"ok": out.returncode == 0, "output": tail}
+    except Exception as exc:  # noqa: BLE001
+        return {"ok": False, "output": f"update failed: {exc}"}
+
+
+@app.get("/api/system/version")
+def system_version():
+    """Current installed version vs the latest on npm."""
+    current = _current_version()
+    latest = _npm_latest_version()
+    return {
+        "current": current,
+        "latest": latest,
+        "update_available": bool(latest) and _is_newer(latest, current),
+    }
+
+
+@app.post("/api/system/update")
+def system_update(request: Request):
+    """Run `npx arkaos@latest update` (update step 1). Step 2 (project
+    sync via /arka update) is a Claude Code action the UI prompts for.
+
+    A regular POST is CORS-protected; as defense-in-depth for an endpoint
+    that runs an update, reject any explicitly non-localhost origin (an
+    empty origin — local CLI / same-origin — is allowed).
+    """
+    origin = request.headers.get("origin", "")
+    if origin and not _terminal_origin_ok(origin):
+        from fastapi import HTTPException
+        raise HTTPException(status_code=403, detail="origin not allowed")
+    return _run_core_update()
+
+
 # ============================================================================
 # PR99a v3.67.0 — Terminal PTY WebSocket + REST.
 #