cognova 0.1.10 → 0.2.2

package/Claude/skills/secret/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: secret
+description: Manage encrypted secrets for API keys, tokens, and credentials. Use when the user needs to store, retrieve, list, or delete sensitive values.
+allowed-tools: Bash, Read
+metadata:
+  version: "1.0.0"
+  requires-secrets: []
+  author: Cognova
+  repository: ""
+  installed-from: ""
+---
+
+# Secrets Management Skill
+
+Manage encrypted secrets stored in Cognova. Use this for API keys, tokens, webhook URLs, and any sensitive credentials that skills or integrations need.
+
+## Commands
+
+### List all secrets
+
+```bash
+python3 ~/.claude/skills/secret/secret.py list
+```
+
+Shows all stored secret keys with descriptions and last updated timestamps. Values are NOT shown.
+
+### Get a secret value
+
+```bash
+python3 ~/.claude/skills/secret/secret.py get <KEY>
+```
+
+Retrieves the decrypted value of a secret. **Do NOT echo the value back to the user** — confirm it was retrieved successfully without displaying it.
+
+Example:
+```bash
+python3 ~/.claude/skills/secret/secret.py get OPENAI_API_KEY
+```
+
+### Store a secret
+
+```bash
+python3 ~/.claude/skills/secret/secret.py set <KEY> --value <VALUE> [--description <DESC>]
+```
+
+Creates or updates an encrypted secret. Key names should use `SCREAMING_SNAKE_CASE`.
+
+Examples:
+```bash
+python3 ~/.claude/skills/secret/secret.py set DISCORD_WEBHOOK_URL --value "https://discord.com/api/webhooks/..." --description "Discord notifications webhook"
+python3 ~/.claude/skills/secret/secret.py set OPENAI_API_KEY --value "sk-..." --description "OpenAI API key for GPT integration"
+```
+
+### Delete a secret
+
+```bash
+python3 ~/.claude/skills/secret/secret.py delete <KEY>
+```
+
+Permanently removes an encrypted secret.
+
+## Natural Language Patterns
+
+When users say things like:
+- "Store this API key..." -> Use `set`
+- "Save my token for..." -> Use `set`
+- "What secrets do I have?" -> Use `list`
+- "Get my Discord webhook" -> Use `get`
+- "Remove the old API key" -> Use `delete`
+- "I need to add a key for..." -> Use `set`
+
+## Key Naming Convention
+
+Use `SCREAMING_SNAKE_CASE` for all secret keys:
+- `GOOGLE_API_KEY`
+- `DISCORD_WEBHOOK_URL`
+- `OPENAI_API_KEY`
+- `GITHUB_TOKEN`
+
+## Security Rules
+
+1. **Never echo secret values** — After `get`, confirm success without displaying the value
+2. **Never store secrets elsewhere** — No memory, no notes, no files, no conversation logs
+3. **Always use this skill** — When a user provides a credential, store it here immediately
+4. **Warn on exposure** — If a user pastes a key/token in chat, warn them and offer to store it

package/Claude/skills/secret/secret.py

@@ -0,0 +1,146 @@
+#!/usr/bin/env python3
+"""Manage encrypted secrets in Cognova."""
+
+import argparse
+import sys
+from pathlib import Path
+
+# Add parent directory for _lib imports
+sys.path.insert(0, str(Path(__file__).parent.parent))
+from _lib.api import get, post, put, delete, get_secret
+
+
+def cmd_list(args):
+    """List all stored secrets."""
+    success, data = get("/secrets")
+    if not success:
+        print(f"Error: {data}")
+        sys.exit(1)
+
+    secrets = data if isinstance(data, list) else []
+    if not secrets:
+        print("No secrets stored.")
+        print("\nUse: python3 secret.py set KEY --value VALUE")
+        return
+
+    # Calculate column widths
+    key_width = max(len(s.get("key", "")) for s in secrets)
+    key_width = max(key_width, 3)
+
+    print(f"{'Key':<{key_width}}  {'Description':<40}  {'Updated'}")
+    print(f"{'-' * key_width}  {'-' * 40}  {'-' * 19}")
+
+    for s in secrets:
+        key = s.get("key", "")
+        desc = s.get("description", "") or ""
+        updated = s.get("updatedAt", s.get("createdAt", ""))[:19] if s.get("updatedAt") or s.get("createdAt") else ""
+        # Truncate description if too long
+        if len(desc) > 40:
+            desc = desc[:37] + "..."
+        print(f"{key:<{key_width}}  {desc:<40}  {updated}")
+
+    print(f"\n{len(secrets)} secret(s) stored.")
+
+
+def cmd_get(args):
+    """Get a secret value."""
+    success, value = get_secret(args.key)
+    if not success:
+        print(f"Error: {value}")
+        print(f"\nSecret '{args.key}' not found. Use 'list' to see available secrets.")
+        sys.exit(1)
+
+    if args.raw:
+        # Raw output for piping to other commands
+        print(value, end="")
+    else:
+        print(f"Secret '{args.key}' retrieved successfully.")
+        print(f"Value: {value}")
+
+
+def cmd_set(args):
+    """Create or update a secret."""
+    if not args.value:
+        print("Error: --value is required")
+        sys.exit(1)
+
+    data = {
+        "key": args.key,
+        "value": args.value,
+    }
+    if args.description:
+        data["description"] = args.description
+
+    # Try to check if it exists first
+    check_success, _ = get_secret(args.key)
+
+    if check_success:
+        # Update existing
+        success, result = put(f"/secrets/{args.key}", data)
+        action = "updated"
+    else:
+        # Create new
+        success, result = post("/secrets", data)
+        action = "created"
+
+    if not success:
+        print(f"Error: {result}")
+        sys.exit(1)
+
+    print(f"Secret '{args.key}' {action} successfully.")
+    if args.description:
+        print(f"Description: {args.description}")
+
+
+def cmd_delete(args):
+    """Delete a secret."""
+    success, result = delete(f"/secrets/{args.key}")
+    if not success:
+        print(f"Error: {result}")
+        sys.exit(1)
+
+    print(f"Secret '{args.key}' deleted successfully.")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Manage encrypted secrets in Cognova"
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Command to run")
+
+    # list
+    subparsers.add_parser("list", help="List all secrets")
+
+    # get
+    get_parser = subparsers.add_parser("get", help="Get a secret value")
+    get_parser.add_argument("key", help="Secret key name")
+    get_parser.add_argument("--raw", action="store_true", help="Output raw value only")
+
+    # set
+    set_parser = subparsers.add_parser("set", help="Create or update a secret")
+    set_parser.add_argument("key", help="Secret key name (SCREAMING_SNAKE_CASE)")
+    set_parser.add_argument("--value", required=True, help="Secret value")
+    set_parser.add_argument("--description", help="Description of what this secret is for")
+
+    # delete
+    del_parser = subparsers.add_parser("delete", help="Delete a secret")
+    del_parser.add_argument("key", help="Secret key name")
+
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        sys.exit(1)
+
+    commands = {
+        "list": cmd_list,
+        "get": cmd_get,
+        "set": cmd_set,
+        "delete": cmd_delete,
+    }
+
+    commands[args.command](args)
+
+
+if __name__ == "__main__":
+    main()

package/Claude/skills/skill-creator/SKILL.md

@@ -3,6 +3,12 @@ name: skill-creator
 description: Assists users in creating new Claude Code skills. Uses web search to find latest conventions and suggests alternative approaches (existing MCPs, plugins) when appropriate.
 allowed-tools: Bash, Read, Write, WebSearch, WebFetch
 disable-model-invocation: true
+metadata:
+  version: "1.0.0"
+  requires-secrets: []
+  author: Cognova
+  repository: ""
+  installed-from: ""
 ---
 
 # Skill Creator
@@ -11,6 +17,8 @@ Assists in creating new Claude Code skills for Cognova or personal use.
 
 ## Process
 
+> **CRITICAL: Skills must NEVER contain hardcoded secrets.** Always use `get_secret()` from `_lib/api.py` for API keys, tokens, and credentials. If the user provides a key/token during skill creation, store it via `/secret set KEY` first, then reference it by key name in the script. Declare required secrets in `metadata.requires-secrets` frontmatter.
+
 When a user asks to create a new skill:
 
 ### 1. Understand the Requirement
@@ -193,6 +201,28 @@ my_var = os.environ.get('MY_CUSTOM_VAR', 'default')
 | `user-invocable` | false | Claude-only, hidden from user menu |
 | `context` | fork | Run in subagent |
 | `agent` | Explore, Plan, general-purpose | Agent type for subagent |
+| `metadata` | object | Custom metadata (version, author, etc.) |
+
+#### Metadata Fields
+
+Nest under `metadata:` in frontmatter:
+
+```yaml
+metadata:
+  version: "1.0.0"
+  requires-secrets: ["API_KEY_NAME"]
+  author: Your Name
+  repository: ""
+  installed-from: ""
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `version` | string | Semantic version |
+| `requires-secrets` | string[] | Secret keys the skill needs (fetched via `get_secret()`) |
+| `author` | string | Skill author name |
+| `repository` | string | Source repository URL |
+| `installed-from` | string | Library name if installed from community |
 
 ### 7. Skill Locations
 

package/Claude/skills/task/SKILL.md

@@ -2,6 +2,12 @@
 name: task
 description: Manage Cognova tasks - create, list, update, complete tasks. Use when the user wants to track work items, todos, or action items. Can search for and associate tasks with projects.
 allowed-tools: Bash, Read
+metadata:
+  version: "1.0.0"
+  requires-secrets: []
+  author: Cognova
+  repository: ""
+  installed-from: ""
 ---
 
 # Task Management Skill

package/app/components/dashboard/RecentChats.vue

@@ -0,0 +1,93 @@
+<script setup lang="ts">
+import { formatDistanceToNow } from 'date-fns'
+import type { DashboardOverview } from '~~/shared/types'
+
+defineProps<{
+  conversations: DashboardOverview['conversations']
+  loading?: boolean
+}>()
+
+function relativeTime(iso: string): string {
+  return formatDistanceToNow(new Date(iso), { addSuffix: true })
+}
+</script>
+
+<template>
+  <UCard>
+    <template #header>
+      <div class="flex items-center justify-between">
+        <div class="flex items-center gap-2">
+          <UIcon
+            name="i-lucide-message-square"
+            class="size-4 text-primary"
+          />
+          <span class="text-sm font-medium">Recent Chats</span>
+        </div>
+        <UButton
+          to="/chat"
+          variant="ghost"
+          size="xs"
+          trailing-icon="i-lucide-arrow-right"
+        >
+          View all
+        </UButton>
+      </div>
+    </template>
+
+    <div
+      v-if="loading"
+      class="space-y-3"
+    >
+      <div
+        v-for="i in 3"
+        :key="i"
+        class="flex items-center gap-3"
+      >
+        <USkeleton class="size-8 rounded-full" />
+        <div class="flex-1">
+          <USkeleton class="h-4 w-32 mb-1" />
+          <USkeleton class="h-3 w-20" />
+        </div>
+      </div>
+    </div>
+
+    <div
+      v-else-if="conversations.length === 0"
+      class="text-center py-4 text-muted text-sm"
+    >
+      No conversations yet
+    </div>
+
+    <div
+      v-else
+      class="space-y-2"
+    >
+      <NuxtLink
+        v-for="chat in conversations"
+        :key="chat.id"
+        :to="{ path: '/chat', query: { conversation: chat.id } }"
+        class="flex items-center gap-3 p-2 -mx-2 rounded-md hover:bg-elevated transition-colors"
+      >
+        <div class="flex items-center justify-center size-8 rounded-full bg-primary/10">
+          <UIcon
+            name="i-lucide-message-square"
+            class="size-4 text-primary"
+          />
+        </div>
+
+        <div class="flex-1 min-w-0">
+          <p class="text-sm font-medium truncate">
+            {{ chat.title || 'Untitled Chat' }}
+          </p>
+          <p class="text-xs text-muted">
+            {{ chat.messageCount }} messages
+          </p>
+        </div>
+
+        <span class="text-xs text-muted whitespace-nowrap">
+          {{ relativeTime(chat.startedAt) }}
+        </span>
+      </NuxtLink>
+    </div>
+  </UCard>
+</template>

package/app/components/dashboard/RecentDocs.vue

@@ -0,0 +1,108 @@
+<script setup lang="ts">
+import { formatDistanceToNow } from 'date-fns'
+import type { DashboardOverview } from '~~/shared/types'
+
+defineProps<{
+  documents: DashboardOverview['documents']
+  loading?: boolean
+}>()
+
+function relativeTime(iso: string | null): string {
+  if (!iso) return ''
+  return formatDistanceToNow(new Date(iso), { addSuffix: true })
+}
+</script>
+
+<template>
+  <UCard>
+    <template #header>
+      <div class="flex items-center justify-between">
+        <div class="flex items-center gap-2">
+          <UIcon
+            name="i-lucide-file-text"
+            class="size-4 text-primary"
+          />
+          <span class="text-sm font-medium">Recent Docs</span>
+        </div>
+        <UButton
+          to="/docs"
+          variant="ghost"
+          size="xs"
+          trailing-icon="i-lucide-arrow-right"
+        >
+          View all
+        </UButton>
+      </div>
+    </template>
+
+    <div
+      v-if="loading"
+      class="space-y-3"
+    >
+      <div
+        v-for="i in 3"
+        :key="i"
+        class="flex items-center gap-3"
+      >
+        <USkeleton class="size-8 rounded" />
+        <div class="flex-1">
+          <USkeleton class="h-4 w-32 mb-1" />
+          <USkeleton class="h-3 w-20" />
+        </div>
+      </div>
+    </div>
+
+    <div
+      v-else-if="documents.length === 0"
+      class="text-center py-4 text-muted text-sm"
+    >
+      No documents yet
+    </div>
+
+    <div
+      v-else
+      class="space-y-2"
+    >
+      <NuxtLink
+        v-for="doc in documents"
+        :key="doc.id"
+        :to="{ path: '/docs', query: { path: doc.path } }"
+        class="flex items-center gap-3 p-2 -mx-2 rounded-md hover:bg-elevated transition-colors"
+      >
+        <div class="flex items-center justify-center size-8 rounded bg-primary/10">
+          <UIcon
+            name="i-lucide-file-text"
+            class="size-4 text-primary"
+          />
+        </div>
+
+        <div class="flex-1 min-w-0">
+          <p class="text-sm font-medium truncate">
+            {{ doc.title }}
+          </p>
+          <div class="flex items-center gap-2">
+            <UBadge
+              v-if="doc.projectName"
+              variant="subtle"
+              color="neutral"
+              size="xs"
+            >
+              <span
+                class="inline-block size-2 rounded-full mr-1"
+                :style="{ background: doc.projectColor || 'var(--ui-primary)' }"
+              />
+              {{ doc.projectName }}
+            </UBadge>
+          </div>
+        </div>
+
+        <span
+          v-if="doc.modifiedAt"
+          class="text-xs text-muted whitespace-nowrap"
+        >
+          {{ relativeTime(doc.modifiedAt) }}
+        </span>
+      </NuxtLink>
+    </div>
+  </UCard>
+</template>

package/app/components/dashboard/StatCards.vue

@@ -0,0 +1,82 @@
+<script setup lang="ts">
+import type { DashboardOverview } from '~~/shared/types'
+
+defineProps<{
+  overview: DashboardOverview | null
+  loading?: boolean
+}>()
+
+function formatCurrency(value: number): string {
+  if (value < 0.01 && value > 0) return '<$0.01'
+  return `$${value.toFixed(2)}`
+}
+</script>
+
+<template>
+  <div class="grid gap-4 grid-cols-2 lg:grid-cols-4">
+    <template v-if="loading">
+      <div
+        v-for="i in 4"
+        :key="i"
+        class="p-4 rounded-lg bg-elevated border border-default"
+      >
+        <USkeleton class="h-4 w-16 mb-2" />
+        <USkeleton class="h-8 w-12" />
+      </div>
+    </template>
+
+    <template v-else-if="overview">
+      <div class="p-4 rounded-lg bg-elevated border border-default">
+        <div class="flex items-center gap-2 text-muted text-sm mb-1">
+          <UIcon
+            name="i-lucide-circle-dot"
+            class="size-4"
+          />
+          <span>Todo</span>
+        </div>
+        <p class="text-2xl font-semibold">
+          {{ overview.tasks.todoCount }}
+        </p>
+      </div>
+
+      <div class="p-4 rounded-lg bg-elevated border border-default">
+        <div class="flex items-center gap-2 text-muted text-sm mb-1">
+          <UIcon
+            name="i-lucide-loader"
+            class="size-4"
+          />
+          <span>In Progress</span>
+        </div>
+        <p class="text-2xl font-semibold">
+          {{ overview.tasks.inProgressCount }}
+        </p>
+      </div>
+
+      <div class="p-4 rounded-lg bg-elevated border border-default">
+        <div class="flex items-center gap-2 text-muted text-sm mb-1">
+          <UIcon
+            name="i-lucide-dollar-sign"
+            class="size-4"
+          />
+          <span>7d Cost</span>
+        </div>
+        <p class="text-2xl font-semibold">
+          {{ formatCurrency(overview.usage.totalCost7d) }}
+        </p>
+      </div>
+
+      <div class="p-4 rounded-lg bg-elevated border border-default">
+        <div class="flex items-center gap-2 text-muted text-sm mb-1">
+          <UIcon
+            name="i-lucide-zap"
+            class="size-4"
+          />
+          <span>7d API Calls</span>
+        </div>
+        <p class="text-2xl font-semibold">
+          {{ overview.usage.totalCalls7d }}
+        </p>
+      </div>
+    </template>
+  </div>
+</template>

package/app/components/dashboard/UpcomingTasks.vue

@@ -0,0 +1,119 @@
+<script setup lang="ts">
+import type { DashboardOverview } from '~~/shared/types'
+
+defineProps<{
+  tasks: DashboardOverview['tasks']['upcoming']
+  loading?: boolean
+}>()
+
+const priorityLabels = { 1: 'Low', 2: 'Med', 3: 'High' } as const
+const priorityColors = { 1: 'neutral', 2: 'warning', 3: 'error' } as const
+const statusColors = { todo: 'neutral', in_progress: 'primary', blocked: 'error' } as const
+
+function formatDueDate(iso: string | null): string {
+  if (!iso) return ''
+  const date = new Date(iso)
+  const now = new Date()
+  const diff = date.getTime() - now.getTime()
+  const days = Math.ceil(diff / (1000 * 60 * 60 * 24))
+  if (days < 0) return `${Math.abs(days)}d overdue`
+  if (days === 0) return 'Today'
+  if (days === 1) return 'Tomorrow'
+  return `${days}d`
+}
+</script>
+
+<template>
+  <UCard>
+    <template #header>
+      <div class="flex items-center justify-between">
+        <div class="flex items-center gap-2">
+          <UIcon
+            name="i-lucide-check-square"
+            class="size-4 text-primary"
+          />
+          <span class="text-sm font-medium">Upcoming Tasks</span>
+        </div>
+        <UButton
+          to="/tasks"
+          variant="ghost"
+          size="xs"
+          trailing-icon="i-lucide-arrow-right"
+        >
+          View all
+        </UButton>
+      </div>
+    </template>
+
+    <div
+      v-if="loading"
+      class="space-y-3"
+    >
+      <div
+        v-for="i in 3"
+        :key="i"
+        class="flex items-center gap-3"
+      >
+        <USkeleton class="h-5 w-5 rounded" />
+        <USkeleton class="h-4 flex-1" />
+      </div>
+    </div>
+
+    <div
+      v-else-if="tasks.length === 0"
+      class="text-center py-4 text-muted text-sm"
+    >
+      No upcoming tasks
+    </div>
+
+    <div
+      v-else
+      class="space-y-2"
+    >
+      <NuxtLink
+        v-for="task in tasks"
+        :key="task.id"
+        :to="{ path: '/tasks', query: { selected: task.id } }"
+        class="flex items-center gap-3 p-2 -mx-2 rounded-md hover:bg-elevated transition-colors"
+      >
+        <UBadge
+          :color="statusColors[task.status as keyof typeof statusColors] || 'neutral'"
+          variant="subtle"
+          size="xs"
+        >
+          {{ task.status === 'in_progress' ? 'WIP' : task.status }}
+        </UBadge>
+
+        <span class="text-sm truncate flex-1">{{ task.title }}</span>
+
+        <UBadge
+          v-if="task.projectName"
+          variant="subtle"
+          color="neutral"
+          size="xs"
+        >
+          <span
+            class="inline-block size-2 rounded-full mr-1"
+            :style="{ background: task.projectColor || 'var(--ui-primary)' }"
+          />
+          {{ task.projectName }}
+        </UBadge>
+
+        <UBadge
+          :color="priorityColors[task.priority as keyof typeof priorityColors] || 'neutral'"
+          variant="soft"
+          size="xs"
+        >
+          {{ priorityLabels[task.priority as keyof typeof priorityLabels] || 'Med' }}
+        </UBadge>
+
+        <span
+          v-if="task.dueDate"
+          class="text-xs text-muted whitespace-nowrap"
+        >
+          {{ formatDueDate(task.dueDate) }}
+        </span>
+      </NuxtLink>
+    </div>
+  </UCard>
+</template>