cognova 0.1.0

package/Claude/skills/task/task.py

@@ -0,0 +1,310 @@
+#!/usr/bin/env python3
+"""
+Task Management Skill for Cognova
+
+Usage:
+    python task.py create <title> [options]
+    python task.py list [filters]
+    python task.py update <id> [options]
+    python task.py done <id_or_search>
+    python task.py delete <id>
+"""
+
+import argparse
+import sys
+from datetime import datetime, timedelta
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).parent.parent / '_lib'))
+
+from api import get, post, put, delete
+from output import success, error, info, format_task
+
+
+def parse_date(date_str: str) -> str | None:
+    """Parse natural language date to ISO format."""
+    if not date_str:
+        return None
+
+    lower = date_str.lower().strip()
+    today = datetime.now()
+
+    if lower == 'today':
+        return today.strftime('%Y-%m-%d')
+    elif lower == 'tomorrow':
+        return (today + timedelta(days=1)).strftime('%Y-%m-%d')
+    elif lower == 'next week':
+        return (today + timedelta(weeks=1)).strftime('%Y-%m-%d')
+    elif lower in ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday']:
+        days = ['monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday', 'sunday']
+        target = days.index(lower)
+        current = today.weekday()
+        delta = (target - current) % 7
+        if delta == 0:
+            delta = 7
+        return (today + timedelta(days=delta)).strftime('%Y-%m-%d')
+
+    try:
+        parsed = datetime.strptime(date_str, '%Y-%m-%d')
+        return parsed.strftime('%Y-%m-%d')
+    except ValueError:
+        pass
+
+    return date_str
+
+
+def find_project(name: str) -> dict | None:
+    """Search for a project by name."""
+    ok, projects = get('/projects')
+    if not ok:
+        return None
+
+    for p in projects:
+        if p['name'].lower() == name.lower():
+            return p
+
+    matches = [p for p in projects if name.lower() in p['name'].lower()]
+
+    if len(matches) == 1:
+        return matches[0]
+    elif len(matches) > 1:
+        print("Multiple projects match:", file=sys.stderr)
+        for p in matches:
+            print(f"  - {p['name']} (ID: {p['id'][:8]})", file=sys.stderr)
+        print("\nPlease be more specific.", file=sys.stderr)
+        return None
+
+    return None
+
+
+def find_task_by_id(id_prefix: str) -> str | None:
+    """Find a task by ID prefix."""
+    ok, tasks = get('/tasks', {'includeDeleted': 'false'})
+    if not ok:
+        return None
+
+    for task in tasks:
+        if task['id'].startswith(id_prefix):
+            return task['id']
+
+    return None
+
+
+def cmd_create(args):
+    """Create a new task."""
+    data = {
+        'title': args.title,
+        'priority': args.priority or 2,
+    }
+
+    if args.description:
+        data['description'] = args.description
+
+    if args.due:
+        data['dueDate'] = parse_date(args.due)
+
+    if args.tags:
+        data['tags'] = [t.strip() for t in args.tags.split(',')]
+
+    if args.project:
+        project = find_project(args.project)
+        if project:
+            data['projectId'] = project['id']
+            info(f"Associated with project: {project['name']}")
+        else:
+            info(f"No project found matching '{args.project}'. Task created without project.")
+
+    ok, result = post('/tasks', data)
+    if ok:
+        success(f"Created task: {result['title']}", result)
+    else:
+        error(f"Failed to create task: {result}")
+        sys.exit(1)
+
+
+def cmd_list(args):
+    """List tasks with filters."""
+    params = {}
+
+    if args.status:
+        params['status'] = args.status
+    if args.project:
+        project = find_project(args.project)
+        if project:
+            params['projectId'] = project['id']
+    if args.search:
+        params['search'] = args.search
+
+    ok, tasks = get('/tasks', params)
+    if not ok:
+        error(f"Failed to fetch tasks: {tasks}")
+        sys.exit(1)
+
+    if args.due:
+        today = datetime.now().date()
+        filtered = []
+        for t in tasks:
+            if not t.get('dueDate'):
+                continue
+            try:
+                due = datetime.fromisoformat(t['dueDate'].replace('Z', '+00:00')).date()
+            except (ValueError, AttributeError):
+                continue
+
+            if args.due == 'today' and due <= today:
+                filtered.append(t)
+            elif args.due == 'week' and due <= today + timedelta(days=7):
+                filtered.append(t)
+            elif args.due == 'overdue' and due < today:
+                filtered.append(t)
+        tasks = filtered
+
+    if not tasks:
+        print("No tasks found matching criteria.")
+        return
+
+    print(f"Found {len(tasks)} task(s):\n")
+    for task in tasks:
+        print(format_task(task))
+        print()
+
+
+def cmd_update(args):
+    """Update an existing task."""
+    data = {}
+
+    if args.title:
+        data['title'] = args.title
+    if args.description:
+        data['description'] = args.description
+    if args.status:
+        data['status'] = args.status
+    if args.priority:
+        data['priority'] = args.priority
+    if args.due:
+        data['dueDate'] = parse_date(args.due)
+    if args.tags:
+        data['tags'] = [t.strip() for t in args.tags.split(',')]
+    if args.project:
+        project = find_project(args.project)
+        if project:
+            data['projectId'] = project['id']
+
+    if not data:
+        error("No updates specified")
+        sys.exit(1)
+
+    task_id = find_task_by_id(args.id)
+    if not task_id:
+        error(f"Task not found: {args.id}")
+        sys.exit(1)
+
+    ok, result = put(f'/tasks/{task_id}', data)
+    if ok:
+        success(f"Updated task: {result['title']}", result)
+    else:
+        error(f"Failed to update task: {result}")
+        sys.exit(1)
+
+
+def cmd_done(args):
+    """Mark a task as done."""
+    task_id = find_task_by_id(args.id_or_search)
+
+    if not task_id:
+        ok, tasks = get('/tasks', {'search': args.id_or_search})
+        if ok and tasks:
+            incomplete = [t for t in tasks if t.get('status') != 'done']
+            if len(incomplete) == 1:
+                task_id = incomplete[0]['id']
+            elif len(incomplete) > 1:
+                print(f"Multiple tasks match '{args.id_or_search}':", file=sys.stderr)
+                for t in incomplete[:5]:
+                    print(f"  - {t['title']} (ID: {t['id'][:8]})", file=sys.stderr)
+                error("Please be more specific or use task ID")
+                sys.exit(1)
+
+    if not task_id:
+        error(f"Task not found: {args.id_or_search}")
+        sys.exit(1)
+
+    ok, result = put(f'/tasks/{task_id}', {'status': 'done'})
+    if ok:
+        success(f"Completed: {result['title']}")
+    else:
+        error(f"Failed to complete task: {result}")
+        sys.exit(1)
+
+
+def cmd_delete(args):
+    """Delete a task (soft delete)."""
+    task_id = find_task_by_id(args.id)
+    if not task_id:
+        error(f"Task not found: {args.id}")
+        sys.exit(1)
+
+    ok, result = delete(f'/tasks/{task_id}')
+    if ok:
+        success(f"Deleted task: {args.id}")
+    else:
+        error(f"Failed to delete task: {result}")
+        sys.exit(1)
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Task Management Skill')
+    subparsers = parser.add_subparsers(dest='command', required=True)
+
+    # Create
+    create_p = subparsers.add_parser('create', help='Create a new task')
+    create_p.add_argument('title', help='Task title')
+    create_p.add_argument('--project', '-p', help='Project name')
+    create_p.add_argument('--priority', '-P', type=int, choices=[1, 2, 3],
+                          help='Priority (1=Low, 2=Medium, 3=High)')
+    create_p.add_argument('--due', '-d', help='Due date')
+    create_p.add_argument('--tags', '-t', help='Comma-separated tags')
+    create_p.add_argument('--description', help='Task description')
+
+    # List
+    list_p = subparsers.add_parser('list', help='List tasks')
+    list_p.add_argument('--status', '-s',
+                        choices=['todo', 'in_progress', 'done', 'blocked'])
+    list_p.add_argument('--project', '-p', help='Filter by project')
+    list_p.add_argument('--search', '-q', help='Search title/description')
+    list_p.add_argument('--due', choices=['today', 'week', 'overdue'])
+
+    # Update
+    update_p = subparsers.add_parser('update', help='Update a task')
+    update_p.add_argument('id', help='Task ID (prefix)')
+    update_p.add_argument('--title', help='New title')
+    update_p.add_argument('--description', help='New description')
+    update_p.add_argument('--status',
+                          choices=['todo', 'in_progress', 'done', 'blocked'])
+    update_p.add_argument('--priority', type=int, choices=[1, 2, 3])
+    update_p.add_argument('--due', help='New due date')
+    update_p.add_argument('--tags', help='New tags')
+    update_p.add_argument('--project', help='New project')
+
+    # Done
+    done_p = subparsers.add_parser('done', help='Mark task as done')
+    done_p.add_argument('id_or_search', help='Task ID or title search')
+
+    # Delete
+    delete_p = subparsers.add_parser('delete', help='Delete a task')
+    delete_p.add_argument('id', help='Task ID (prefix)')
+
+    args = parser.parse_args()
+
+    commands = {
+        'create': cmd_create,
+        'list': cmd_list,
+        'update': cmd_update,
+        'done': cmd_done,
+        'delete': cmd_delete,
+    }
+
+    commands[args.command](args)
+
+
+if __name__ == '__main__':
+    main()

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tony Costanzo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# Cognova
+
+Personal knowledge management system with an embedded AI terminal. Built for a unified place to manage notes, tasks, and AI-assisted workflows from any device.
+
+> **Warning:** This application gives an AI agent unrestricted access to the host machine via an embedded terminal and the Claude Code CLI. It can read, write, and execute anything. **Do not run this on a personal machine or a server with sensitive data.** Deploy only in a sandboxed, isolated, or airgapped environment. See [Security](#security) for details.
+
+## Features
+
+- **File Browser** - Navigate your vault with drag-drop, context menus, search
+- **Markdown Editor** - WYSIWYG editing powered by TipTap via Nuxt UI
+- **Embedded Terminal** - Claude Code CLI in a floating terminal panel
+- **Interactive Chat** - Conversational Claude interface with streaming, tool calls, and session history
+- **Task Management** - Track tasks with status, priority, and project tags
+- **Scheduled Agents** - Cron-based Claude agents with cost tracking and real-time status
+- **Memory Dashboard** - View and manage Claude's memory context
+- **Dashboard** - Overview of recent activity and quick capture
+- **Custom Homepage** - Override the landing page by creating `index.md` in your vault
+- **Public Document Sharing** - Share vault documents via unique link (no auth required)
+- **Hook Events** - Monitor and review Claude Code hook activity
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Framework | [Nuxt 4](https://nuxt.com) |
+| UI | [Nuxt UI v4](https://ui.nuxt.com) |
+| Editor | TipTap (via UEditor) |
+| Terminal | xterm.js + node-pty |
+| Database | PostgreSQL (local Docker or [Neon](https://neon.tech)) |
+| AI | [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) |
+
+## Installation
+
+### Prerequisites
+
+- Node.js 20+
+- PostgreSQL (local Docker or hosted like [Neon](https://neon.tech))
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+
+### Install via CLI
+
+```bash
+# Install globally
+npm install -g cognova
+
+# Run the interactive setup wizard
+cognova init
+```
+
+The setup wizard will:
+1. Ask for your vault path (where your markdown files live)
+2. Configure your database connection (local Docker or Neon)
+3. Set up authentication secrets
+4. Install dependencies and build the application
+5. Start the app via PM2
+
+Once running, visit `http://localhost:3000`.
+
+### Managing the App
+
+```bash
+cognova start      # Start the app (PM2)
+cognova stop       # Stop the app
+cognova restart    # Restart the app
+cognova update     # Update to the latest version (with automatic rollback)
+cognova doctor     # Check health of all components
+cognova reset      # Regenerate configuration files
+```
+
+### Default Admin User
+
+On first startup with an empty database, a default admin user is created:
+- Email: `admin@example.com`
+- Password: `changeme123`
+
+Customize via `ADMIN_EMAIL` and `ADMIN_PASSWORD` in your `.env` file.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `VAULT_PATH` | Yes | Path to your markdown vault |
+| `DATABASE_URL` | No | PostgreSQL URL (defaults to local Docker) |
+| `BETTER_AUTH_SECRET` | Yes | Secret key for session encryption (generate with `openssl rand -base64 32`) |
+| `BETTER_AUTH_URL` | Yes | Base URL of your app (e.g., `http://localhost:3000`) |
+| `ADMIN_EMAIL` | No | Default admin email (default: `admin@example.com`) |
+| `ADMIN_PASSWORD` | No | Default admin password (default: `changeme123`) |
+| `ADMIN_NAME` | No | Default admin display name (default: `Admin`) |
+
+## Security
+
+Cognova gives an AI agent (Claude Code) and any authenticated user **full, unrestricted access** to the host machine. This includes:
+
+- Arbitrary command execution via the embedded terminal
+- File system read/write through the vault mount and shell
+- Network access from the host (API calls, outbound connections)
+- Access to any credentials or secrets present on the machine
+
+### Deployment Guidelines
+
+- **Never run on a personal machine** — use a dedicated VM, container, or cloud instance
+- **Isolate the environment** — sandbox or airgap the host so a compromised session can't reach sensitive infrastructure
+- **Never expose directly to the internet** — always put a reverse proxy with TLS in front (Nginx, Traefik, Cloudflare Access, Tailscale, etc.)
+- **Limit blast radius** — don't store SSH keys, cloud credentials, or production secrets on the same machine
+- **Review agent activity** — use the Hook Events dashboard to monitor what Claude Code is doing
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/patrity/cognova.git
+cd cognova
+pnpm install
+cp .env.example .env
+# Edit .env with your VAULT_PATH and database config
+```
+
+### Local PostgreSQL
+
+Docker Compose is used to run a local PostgreSQL instance for development:
+
+```bash
+# Start postgres
+pnpm db:up
+
+# Run dev server
+pnpm dev
+
+# Stop postgres when done
+pnpm db:down
+```
+
+Alternatively, point `DATABASE_URL` at any PostgreSQL instance (hosted Neon, local install, etc.).
+
+### Build
+
+```bash
+pnpm build
+node .output/server/index.mjs
+```
+
+## Project Structure
+
+```
+cognova/
+├── app/
+│   ├── components/     # Vue components
+│   ├── composables/    # Shared logic
+│   ├── layouts/        # Dashboard, auth, view layouts
+│   └── pages/          # Route pages
+├── server/
+│   ├── api/            # REST endpoints
+│   ├── routes/         # WebSocket handlers
+│   ├── services/       # Agent executor, cron scheduler
+│   └── db/             # Drizzle schema + migrations
+├── cli/                # CLI installer (cognova init/update/start/stop)
+├── shared/             # Shared types and utilities
+├── Claude/             # Claude Code skills, hooks, & config
+└── docs/               # Architecture docs
+```
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [architecture.md](./docs/architecture.md) | System design and components |
+| [ui-wireframes.md](./docs/ui-wireframes.md) | Interface layouts |
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT - see [LICENSE](./LICENSE)

package/app/app.config.ts

@@ -0,0 +1,8 @@
+export default defineAppConfig({
+  ui: {
+    colors: {
+      primary: 'orange',
+      neutral: 'stone'
+    }
+  }
+})

package/app/app.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+const colorMode = useColorMode()
+
+const color = computed(() => colorMode.value === 'dark' ? '#1b1718' : 'white')
+
+useHead({
+  meta: [
+    { charset: 'utf-8' },
+    { name: 'viewport', content: 'width=device-width, initial-scale=1' },
+    { key: 'theme-color', name: 'theme-color', content: color }
+  ],
+  link: [
+    { rel: 'icon', href: '/favicon.ico' }
+  ],
+  htmlAttrs: {
+    lang: 'en'
+  }
+})
+
+const title = 'Cognova'
+const description = 'A personal knowledge management system powered by Claude Code.'
+
+useSeoMeta({
+  title,
+  description,
+  ogTitle: title,
+  ogDescription: description
+})
+</script>
+
+<template>
+  <UApp>
+    <NuxtLoadingIndicator />
+
+    <NuxtLayout>
+      <NuxtPage />
+    </NuxtLayout>
+  </UApp>
+</template>

package/app/assets/css/main.css

@@ -0,0 +1,10 @@
+@import "tailwindcss";
+@import "@nuxt/ui";
+
+@theme {
+  --font-sans: 'Outfit', sans-serif;
+}
+
+:root {
+  --ui-radius: 0.375rem;
+}

package/app/components/AppLogo.vue

@@ -0,0 +1,40 @@
+<template>
+  <svg
+    width="1020"
+    height="200"
+    viewBox="0 0 1020 200"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+  >
+    <path
+      d="M377 200C379.16 200 381 198.209 381 196V103C381 103 386 112 395 127L434 194C435.785 197.74 439.744 200 443 200H470V50H443C441.202 50 439 51.4941 439 54V148L421 116L385 55C383.248 51.8912 379.479 50 376 50H350V200H377Z"
+      fill="currentColor"
+    />
+    <path
+      d="M726 92H739C742.314 92 745 89.3137 745 86V60H773V92H800V116H773V159C773 169.5 778.057 174 787 174H800V200H783C759.948 200 745 185.071 745 160V116H726V92Z"
+      fill="currentColor"
+    />
+    <path
+      d="M591 92V154C591 168.004 585.742 179.809 578 188C570.258 196.191 559.566 200 545 200C530.434 200 518.742 196.191 511 188C503.389 179.809 498 168.004 498 154V92H514C517.412 92 520.769 92.622 523 95C525.231 97.2459 526 98.5652 526 102V154C526 162.059 526.457 167.037 530 171C533.543 174.831 537.914 176 545 176C552.217 176 555.457 174.831 559 171C562.543 167.037 563 162.059 563 154V102C563 98.5652 563.769 96.378 566 94C567.96 91.9107 570.028 91.9599 573 92C573.411 92.0055 574.586 92 575 92H591Z"
+      fill="currentColor"
+    />
+    <path
+      d="M676 144L710 92H684C680.723 92 677.812 93.1758 676 96L660 120L645 97C643.188 94.1758 639.277 92 636 92H611L645 143L608 200H634C637.25 200 640.182 196.787 642 194L660 167L679 195C680.818 197.787 683.75 200 687 200H713L676 144Z"
+      fill="currentColor"
+    />
+    <path
+      d="M168 200H279C282.542 200 285.932 198.756 289 197C292.068 195.244 295.23 193.041 297 190C298.77 186.959 300.002 183.51 300 179.999C299.998 176.488 298.773 173.04 297 170.001L222 41C220.23 37.96 218.067 35.7552 215 34C211.933 32.2448 207.542 31 204 31C200.458 31 197.067 32.2448 194 34C190.933 35.7552 188.77 37.96 187 41L168 74L130 9.99764C128.228 6.95784 126.068 3.75491 123 2C119.932 0.245087 116.542 0 113 0C109.458 0 106.068 0.245087 103 2C99.9323 3.75491 96.7717 6.95784 95 9.99764L2 170.001C0.226979 173.04 0.00154312 176.488 1.90993e-06 179.999C-0.0015393 183.51 0.229648 186.959 2 190C3.77035 193.04 6.93245 195.244 10 197C13.0675 198.756 16.4578 200 20 200H90C117.737 200 137.925 187.558 152 164L186 105L204 74L259 168H186L168 200ZM89 168H40L113 42L150 105L125.491 147.725C116.144 163.01 105.488 168 89 168Z"
+      fill="var(--ui-primary)"
+    />
+    <path
+      d="M958 60.0001H938C933.524 60.0001 929.926 59.9395 927 63C924.074 65.8905 925 67.5792 925 72V141C925 151.372 923.648 156.899 919 162C914.352 166.931 908.468 169 899 169C889.705 169 882.648 166.931 878 162C873.352 156.899 873 151.372 873 141V72.0001C873 67.5793 872.926 65.8906 870 63.0001C867.074 59.9396 863.476 60.0001 859 60.0001H840V141C840 159.023 845.016 173.458 855 184C865.156 194.542 879.893 200 899 200C918.107 200 932.844 194.542 943 184C953.156 173.458 958 159.023 958 141V60.0001Z"
+      fill="var(--ui-primary)"
+    />
+    <path
+      fill-rule="evenodd"
+      clip-rule="evenodd"
+      d="M1000 60.0233L1020 60V77L1020 128V156.007L1020 181L1020 189.004C1020 192.938 1019.98 194.429 1017 197.001C1014.02 199.725 1009.56 200 1005 200H986.001V181.006L986 130.012V70.0215C986 66.1576 986.016 64.5494 989 62.023C991.819 59.6358 995.437 60.0233 1000 60.0233Z"
+      fill="var(--ui-primary)"
+    />
+  </svg>
+</template>