cognova 0.2.3 → 0.2.5

package/app/pages/settings.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import type { NotificationPreferences, NotificationResource, NotificationAction } from '~~/shared/types'
+import type { NotificationPreferences, NotificationResource, NotificationAction, Bridge, BridgePlatform } from '~~/shared/types'
 import { defaultNotificationPreferences } from '~~/shared/utils/notification-defaults'
 
 interface Secret {
@@ -81,6 +81,7 @@ async function fetchSecrets() {
 const tabs = [
   { label: 'Account', icon: 'i-lucide-user', value: 'account', slot: 'account' },
   { label: 'Secrets', icon: 'i-lucide-key', value: 'secrets', slot: 'secrets' },
+  { label: 'Integrations', icon: 'i-lucide-plug', value: 'integrations', slot: 'integrations' },
   { label: 'App', icon: 'i-lucide-settings', value: 'app', slot: 'app' }
 ]
 
@@ -209,7 +210,8 @@ const resourceConfig: { key: NotificationResource, label: string, icon: string,
   { key: 'reminder', label: 'Reminders', icon: 'i-lucide-bell', subtypes: ['create'] },
   { key: 'secret', label: 'Secrets', icon: 'i-lucide-key-round', subtypes: ['create', 'edit', 'delete'] },
   { key: 'hook', label: 'Hooks', icon: 'i-lucide-webhook', subtypes: ['create'] },
-  { key: 'conversation', label: 'Conversations', icon: 'i-lucide-message-square', subtypes: ['delete'] }
+  { key: 'conversation', label: 'Conversations', icon: 'i-lucide-message-square', subtypes: ['delete'] },
+  { key: 'bridge', label: 'Bridges', icon: 'i-lucide-plug', subtypes: ['create', 'edit', 'delete', 'complete', 'fail'] }
 ]
 
 async function loadNotificationPrefs() {
@@ -257,10 +259,107 @@ function setSubtypeEnabled(key: NotificationResource, subtype: NotificationActio
   }
 }
 
-// Load secrets + notification prefs when component mounts
+// === Integrations / Bridges ===
+const bridgesData = ref<Bridge[]>([])
+const bridgesLoading = ref(false)
+const bridgeModal = ref(false)
+const bridgeSaving = ref(false)
+const bridgeDeleteConfirm = ref(false)
+const bridgeToDelete = ref<Bridge | null>(null)
+
+const bridgeForm = reactive({
+  platform: 'telegram' as BridgePlatform,
+  name: ''
+})
+
+const platformOptions: { value: BridgePlatform, label: string, icon: string }[] = [
+  { value: 'telegram', label: 'Telegram', icon: 'i-lucide-send' },
+  { value: 'discord', label: 'Discord', icon: 'i-lucide-message-circle' },
+  { value: 'imessage', label: 'iMessage', icon: 'i-lucide-smartphone' },
+  { value: 'google', label: 'Google Suite', icon: 'i-lucide-mail' },
+  { value: 'email', label: 'Email (IMAP)', icon: 'i-lucide-at-sign' }
+]
+
+const healthColors: Record<string, string> = {
+  connected: 'text-success',
+  disconnected: 'text-dimmed',
+  error: 'text-error',
+  unconfigured: 'text-dimmed'
+}
+
+async function fetchBridges() {
+  bridgesLoading.value = true
+  try {
+    const { data } = await $fetch<{ data: Bridge[] }>('/api/bridges')
+    bridgesData.value = data
+  } catch {
+    toast.add({ title: 'Failed to load integrations', color: 'error' })
+  }
+  bridgesLoading.value = false
+}
+
+function openCreateBridge() {
+  bridgeForm.platform = 'telegram'
+  bridgeForm.name = ''
+  bridgeModal.value = true
+}
+
+async function handleBridgeCreate() {
+  if (!bridgeForm.name) {
+    toast.add({ title: 'Name is required', color: 'error' })
+    return
+  }
+  bridgeSaving.value = true
+  try {
+    await $fetch('/api/bridges', {
+      method: 'POST',
+      body: { platform: bridgeForm.platform, name: bridgeForm.name }
+    })
+    toast.add({ title: 'Integration created', color: 'success' })
+    bridgeModal.value = false
+    await fetchBridges()
+  } catch (err: unknown) {
+    const error = err as { data?: { message?: string } }
+    toast.add({ title: 'Failed to create integration', description: error.data?.message, color: 'error' })
+  }
+  bridgeSaving.value = false
+}
+
+async function toggleBridge(bridge: Bridge) {
+  try {
+    await $fetch(`/api/bridges/${bridge.id}`, {
+      method: 'PUT',
+      body: { enabled: !bridge.enabled }
+    })
+    await fetchBridges()
+  } catch {
+    toast.add({ title: 'Failed to update integration', color: 'error' })
+  }
+}
+
+function confirmDeleteBridge(bridge: Bridge) {
+  bridgeToDelete.value = bridge
+  bridgeDeleteConfirm.value = true
+}
+
+async function handleDeleteBridge() {
+  if (!bridgeToDelete.value) return
+  try {
+    await $fetch(`/api/bridges/${bridgeToDelete.value.id}`, { method: 'DELETE' })
+    toast.add({ title: 'Integration deleted', color: 'success' })
+    bridgeDeleteConfirm.value = false
+    bridgeToDelete.value = null
+    await fetchBridges()
+  } catch {
+    toast.add({ title: 'Failed to delete integration', color: 'error' })
+  }
+}
+
+// Load secrets + notification prefs + bridges when component mounts
 onMounted(() => {
   fetchSecrets()
   loadNotificationPrefs()
+  fetchBridges()
 })
 
 // Form handlers
@@ -564,6 +663,104 @@ async function handlePasswordSubmit() {
             </div>
           </template>
 
+          <!-- Integrations Tab -->
+          <template #integrations>
+            <div class="py-6">
+              <div class="flex items-center justify-between mb-6">
+                <div>
+                  <h3 class="text-lg font-semibold">
+                    Integrations
+                  </h3>
+                  <p class="text-sm text-dimmed">
+                    Connect external platforms to the message bridge.
+                  </p>
+                </div>
+                <UButton
+                  icon="i-lucide-plus"
+                  @click="openCreateBridge"
+                >
+                  Add Integration
+                </UButton>
+              </div>
+
+              <div
+                v-if="bridgesLoading"
+                class="space-y-3"
+              >
+                <USkeleton
+                  v-for="i in 3"
+                  :key="i"
+                  class="h-16 w-full"
+                />
+              </div>
+
+              <div
+                v-else-if="bridgesData.length === 0"
+                class="py-12 text-center"
+              >
+                <UIcon
+                  name="i-lucide-plug"
+                  class="size-12 mx-auto mb-4 text-dimmed"
+                />
+                <p class="text-dimmed">
+                  No integrations configured.
+                </p>
+                <p class="text-sm text-dimmed mt-1">
+                  Connect Telegram, Discord, iMessage, or Google Suite.
+                </p>
+              </div>
+
+              <div
+                v-else
+                class="space-y-3"
+              >
+                <div
+                  v-for="bridge in bridgesData"
+                  :key="bridge.id"
+                  class="border border-default rounded-lg px-4 py-3"
+                >
+                  <div class="flex items-center justify-between">
+                    <div class="flex items-center gap-3">
+                      <UIcon
+                        :name="platformOptions.find(p => p.value === bridge.platform)?.icon || 'i-lucide-plug'"
+                        class="size-5 text-dimmed"
+                      />
+                      <div>
+                        <span class="font-medium">{{ bridge.name }}</span>
+                        <span class="text-sm text-dimmed ml-2">{{ platformOptions.find(p => p.value === bridge.platform)?.label }}</span>
+                      </div>
+                    </div>
+                    <div class="flex items-center gap-3">
+                      <span
+                        class="text-xs capitalize"
+                        :class="healthColors[bridge.healthStatus] || 'text-dimmed'"
+                      >
+                        {{ bridge.healthStatus }}
+                      </span>
+                      <USwitch
+                        :model-value="bridge.enabled"
+                        @update:model-value="toggleBridge(bridge)"
+                      />
+                      <UButton
+                        variant="ghost"
+                        color="error"
+                        icon="i-lucide-trash-2"
+                        size="xs"
+                        @click="confirmDeleteBridge(bridge)"
+                      />
+                    </div>
+                  </div>
+                  <p
+                    v-if="bridge.healthMessage"
+                    class="text-xs text-dimmed mt-1 pl-8"
+                  >
+                    {{ bridge.healthMessage }}
+                  </p>
+                </div>
+              </div>
+            </div>
+          </template>
+
           <!-- App Tab -->
           <template #app>
             <div class="max-w-2xl mx-auto py-6">
@@ -756,5 +953,84 @@ async function handlePasswordSubmit() {
         </div>
       </template>
     </UModal>
+
+    <!-- Bridge Create Modal -->
+    <UModal v-model:open="bridgeModal">
+      <template #header>
+        <h3 class="text-lg font-semibold">
+          Add Integration
+        </h3>
+      </template>
+      <template #body>
+        <div class="space-y-4">
+          <UFormField
+            label="Platform"
+            name="platform"
+          >
+            <USelect
+              v-model="bridgeForm.platform"
+              :items="platformOptions"
+              value-key="value"
+              class="w-full"
+            />
+          </UFormField>
+          <UFormField
+            label="Name"
+            name="name"
+          >
+            <UInput
+              v-model="bridgeForm.name"
+              placeholder="My Telegram Bot"
+              class="w-full"
+            />
+          </UFormField>
+          <div class="flex justify-end gap-2 pt-4">
+            <UButton
+              variant="ghost"
+              @click="bridgeModal = false"
+            >
+              Cancel
+            </UButton>
+            <UButton
+              :loading="bridgeSaving"
+              @click="handleBridgeCreate"
+            >
+              Create
+            </UButton>
+          </div>
+        </div>
+      </template>
+    </UModal>
+
+    <!-- Bridge Delete Confirmation Modal -->
+    <UModal v-model:open="bridgeDeleteConfirm">
+      <template #header>
+        <h3 class="text-lg font-semibold">
+          Delete Integration
+        </h3>
+      </template>
+      <template #body>
+        <p class="mb-4">
+          Are you sure you want to delete <strong>{{ bridgeToDelete?.name }}</strong>?
+        </p>
+        <p class="text-sm text-dimmed">
+          This will remove the integration and all associated message history.
+        </p>
+        <div class="flex justify-end gap-2 pt-6">
+          <UButton
+            variant="ghost"
+            @click="bridgeDeleteConfirm = false"
+          >
+            Cancel
+          </UButton>
+          <UButton
+            color="error"
+            @click="handleDeleteBridge"
+          >
+            Delete
+          </UButton>
+        </div>
+      </template>
+    </UModal>
   </UDashboardPanel>
 </template>

package/app/pages/skills/index.vue

@@ -13,6 +13,10 @@ const search = ref('')
 const createOpen = ref(false)
 const importing = ref(false)
 const fileInput = ref<HTMLInputElement | null>(null)
+const deleteTarget = ref('')
+const updateTarget = ref('')
+const deleting = ref(false)
+const updating = ref(false)
 
 const filteredSkills = computed(() => {
   if (!search.value.trim()) return skills.value
@@ -79,6 +83,39 @@ async function handleToggle(name: string) {
   }
 }
 
+async function confirmDelete() {
+  if (!deleteTarget.value) return
+  deleting.value = true
+  try {
+    await $fetch(`/api/skills/${deleteTarget.value}/delete`, { method: 'POST' })
+    skills.value = skills.value.filter(s => s.name !== deleteTarget.value)
+    toast.add({ title: `Deleted ${deleteTarget.value}`, color: 'success' })
+    deleteTarget.value = ''
+  } catch {
+    toast.add({ title: `Failed to delete ${deleteTarget.value}`, color: 'error' })
+  } finally {
+    deleting.value = false
+  }
+}
+
+async function confirmUpdate() {
+  if (!updateTarget.value) return
+  updating.value = true
+  try {
+    await $fetch('/api/skills/library/install', {
+      method: 'POST',
+      body: { name: updateTarget.value, force: true }
+    })
+    toast.add({ title: `Updated ${updateTarget.value}`, color: 'success' })
+    updateTarget.value = ''
+    await loadSkills()
+  } catch {
+    toast.add({ title: `Failed to update ${updateTarget.value}`, color: 'error' })
+  } finally {
+    updating.value = false
+  }
+}
+
 onMounted(() => loadSkills())
 </script>
 
@@ -189,6 +226,8 @@ onMounted(() => loadSkills())
               :key="skill.name"
               :skill="skill"
               @toggle="handleToggle"
+              @delete="deleteTarget = $event"
+              @update="updateTarget = $event"
             />
           </div>
         </div>
@@ -200,5 +239,72 @@ onMounted(() => loadSkills())
       @update:open="createOpen = $event"
       @created="loadSkills"
     />
+
+    <!-- Delete confirmation modal -->
+    <UModal
+      :open="!!deleteTarget"
+      @update:open="!$event && (deleteTarget = '')"
+    >
+      <template #header>
+        <span class="font-semibold">Delete Skill</span>
+      </template>
+      <template #body>
+        <p class="text-sm text-muted">
+          This will permanently delete <strong class="text-default">{{ deleteTarget }}</strong> and all its files. Any modifications you've made will be lost. This cannot be undone.
+        </p>
+      </template>
+      <template #footer>
+        <div class="flex justify-end gap-2">
+          <UButton
+            variant="ghost"
+            color="neutral"
+            :disabled="deleting"
+            @click="deleteTarget = ''"
+          >
+            Cancel
+          </UButton>
+          <UButton
+            color="error"
+            :loading="deleting"
+            @click="confirmDelete"
+          >
+            Delete
+          </UButton>
+        </div>
+      </template>
+    </UModal>
+
+    <!-- Update confirmation modal -->
+    <UModal
+      :open="!!updateTarget"
+      @update:open="!$event && (updateTarget = '')"
+    >
+      <template #header>
+        <span class="font-semibold">Update Skill</span>
+      </template>
+      <template #body>
+        <p class="text-sm text-muted">
+          This will re-download <strong class="text-default">{{ updateTarget }}</strong> from the community library, overwriting any local changes you've made to its files.
+        </p>
+      </template>
+      <template #footer>
+        <div class="flex justify-end gap-2">
+          <UButton
+            variant="ghost"
+            color="neutral"
+            :disabled="updating"
+            @click="updateTarget = ''"
+          >
+            Cancel
+          </UButton>
+          <UButton
+            :loading="updating"
+            @click="confirmUpdate"
+          >
+            Update
+          </UButton>
+        </div>
+      </template>
+    </UModal>
   </div>
 </template>

package/app/pages/skills/library.vue

@@ -6,6 +6,8 @@ definePageMeta({
   middleware: 'auth'
 })
 
+const route = useRoute()
+const router = useRouter()
 const toast = useToast()
 const skills = ref<SkillCatalogItem[]>([])
 const loading = ref(true)
@@ -96,7 +98,24 @@ async function handleUpdate(name: string) {
   }
 }
 
-onMounted(() => loadLibrary())
+onMounted(async () => {
+  await loadLibrary()
+
+  // Handle ?install= query param from docs site redirect
+  const installName = route.query.install as string | undefined
+  if (installName) {
+    router.replace({ query: {} })
+    const found = skills.value.find(s => s.name === installName)
+    if (found && !found.installed) {
+      toast.add({ title: `Installing ${installName} from docs...`, color: 'info' })
+      await handleInstall(installName)
+    } else if (found?.installed) {
+      toast.add({ title: `${installName} is already installed`, color: 'neutral' })
+    } else {
+      toast.add({ title: `Skill "${installName}" not found in library`, color: 'warning' })
+    }
+  }
+})
 </script>
 
 <template>

package/nuxt.config.ts

@@ -81,9 +81,9 @@ export default defineNuxtConfig({
     experimental: {
       websocket: true
     },
-    // node-pty is a native module that can't be bundled
+    // node-pty and discord.js are native/complex modules that can't be bundled
     externals: {
-      external: ['node-pty']
+      external: ['node-pty', 'discord.js']
     }
   },
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cognova",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Personal knowledge management system with Claude Code integration",
   "repository": {
     "type": "git",
@@ -36,10 +36,8 @@
     "db:migrate": "drizzle-kit migrate",
     "db:push": "drizzle-kit push",
     "db:studio": "drizzle-kit studio",
-    "db:up": "docker compose --profile local up -d db",
-    "db:down": "docker compose --profile local down",
-    "docker:up": "./scripts/docker-up.sh -d",
-    "docker:down": "docker compose --profile local down",
+    "db:up": "docker compose up -d",
+    "db:down": "docker compose down",
     "auth:create-admin": "tsx scripts/create-admin.ts",
     "auth:reset-pw": "tsx scripts/reset-password.ts"
   },
@@ -81,6 +79,7 @@
     "codemirror": "^6.0.2",
     "cron": "^4.4.0",
     "date-fns": "^4.1.0",
+    "discord.js": "^14.25.1",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
     "drizzle-orm": "^0.45.1",

package/server/api/bridges/[id]/health.get.ts

@@ -0,0 +1,78 @@
+import { eq } from 'drizzle-orm'
+import { getDb, schema } from '~~/server/db'
+import { requireDb } from '~~/server/utils/db-guard'
+import { getAdapter } from '~~/server/bridge/registry'
+
+/**
+ * Check bridge health on demand.
+ * Updates the health status in the database and returns it.
+ */
+export default defineEventHandler(async (event) => {
+  requireDb(event)
+
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    throw createError({ statusCode: 400, message: 'Bridge ID is required' })
+  }
+
+  const db = getDb()
+
+  const bridge = await db.query.bridges.findFirst({
+    where: eq(schema.bridges.id, id)
+  })
+
+  if (!bridge) {
+    throw createError({ statusCode: 404, message: 'Bridge not found' })
+  }
+
+  const adapter = getAdapter(id)
+  const now = new Date()
+
+  if (!bridge.enabled) {
+    return {
+      data: {
+        healthStatus: 'disconnected',
+        healthMessage: 'Bridge is disabled',
+        lastHealthCheck: now
+      }
+    }
+  }
+
+  if (!adapter) {
+    await db.update(schema.bridges)
+      .set({
+        healthStatus: 'disconnected',
+        healthMessage: 'No active adapter',
+        lastHealthCheck: now
+      })
+      .where(eq(schema.bridges.id, id))
+
+    return {
+      data: {
+        healthStatus: 'disconnected',
+        healthMessage: 'No active adapter',
+        lastHealthCheck: now
+      }
+    }
+  }
+
+  const healthy = adapter.isHealthy()
+  const status = healthy ? 'connected' : 'error'
+  const message = healthy ? null : 'Adapter reports unhealthy'
+
+  await db.update(schema.bridges)
+    .set({
+      healthStatus: status,
+      healthMessage: message,
+      lastHealthCheck: now
+    })
+    .where(eq(schema.bridges.id, id))
+
+  return {
+    data: {
+      healthStatus: status,
+      healthMessage: message,
+      lastHealthCheck: now
+    }
+  }
+})

package/server/api/bridges/[id].delete.ts

@@ -0,0 +1,41 @@
+import { eq } from 'drizzle-orm'
+import { getDb, schema } from '~~/server/db'
+import { requireDb } from '~~/server/utils/db-guard'
+import { notifyResourceChange } from '~~/server/utils/notify-resource'
+import { getAdapter, unregisterAdapter } from '~~/server/bridge/registry'
+
+export default defineEventHandler(async (event) => {
+  requireDb(event)
+
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    throw createError({ statusCode: 400, message: 'Bridge ID is required' })
+  }
+
+  const db = getDb()
+
+  // Stop adapter if running
+  const adapter = getAdapter(id)
+  if (adapter) {
+    await adapter.stop()
+    unregisterAdapter(id)
+  }
+
+  // Delete bridge (messages will cascade delete)
+  const [deleted] = await db.delete(schema.bridges)
+    .where(eq(schema.bridges.id, id))
+    .returning()
+
+  if (!deleted) {
+    throw createError({ statusCode: 404, message: 'Bridge not found' })
+  }
+
+  notifyResourceChange({
+    resource: 'bridge',
+    action: 'delete',
+    resourceId: id,
+    resourceName: deleted.name
+  })
+
+  return { data: deleted }
+})

package/server/api/bridges/[id].get.ts

@@ -0,0 +1,25 @@
+import { eq } from 'drizzle-orm'
+import { getDb, schema } from '~~/server/db'
+import { requireDb } from '~~/server/utils/db-guard'
+
+export default defineEventHandler(async (event) => {
+  requireDb(event)
+
+  const id = getRouterParam(event, 'id')
+  if (!id) {
+    throw createError({ statusCode: 400, message: 'Bridge ID is required' })
+  }
+
+  const db = getDb()
+
+  const bridge = await db.query.bridges.findFirst({
+    where: eq(schema.bridges.id, id),
+    with: { creator: true }
+  })
+
+  if (!bridge) {
+    throw createError({ statusCode: 404, message: 'Bridge not found' })
+  }
+
+  return { data: bridge }
+})