vibefast-cli 0.6.2 → 0.7.1

package/2/.claude/docs/CONVEX_FEATURES_PLAN.md

@@ -1,249 +0,0 @@
-# Convex Features Demo Plan
-
-## Overview
-
-This plan outlines the implementation of a minimal todo application that demonstrates ALL Convex features defined in the schema. The app will showcase queries, mutations, actions, relationships, search, aggregates, triggers, and more.
-
-## Schema Features to Demonstrate
-
-### 1. **Core Models**
-
-- **Users**: Profile management, role-based access, soft deletion
-- **Todos**: CRUD operations, priorities, due dates, soft deletion
-- **Projects**: Project management, public/private visibility, archiving
-- **Tags**: Tag management with color coding
-- **Comments**: Nested comments with replies
-
-### 2. **Relationships**
-
-- 1:1 - User profile edges
-- 1:many - User→Todos, Project→Todos, Todo→Comments
-- Many:many - Todos↔Tags, Projects↔Members, Comments↔Replies
-
-### 3. **Advanced Features**
-
-- **Search**: Full-text search on todos (title/description)
-- **Aggregates**: Todo counts by user, project, status
-- **Triggers**: Auto-update aggregates, validation
-- **Soft Deletion**: Todos with deletionTime
-- **Indexes**: Optimized queries for filtering
-- **Pagination**: Todo lists with cursor-based pagination
-
-## Implementation Structure
-
-### Backend Files (`convex/`)
-
-#### 1. **todos.ts** - Todo CRUD
-
-- `list` - Paginated query with filters (status, project, tags)
-- `search` - Full-text search with filters
-- `get` - Single todo with relations
-- `create` - With validation, rate limiting
-- `update` - Patch updates with optimistic UI
-- `toggleComplete` - Quick status toggle
-- `delete` - Soft delete
-- `restore` - Undelete soft-deleted todos
-- `bulkDelete` - Batch operations
-- `reorder` - Drag-and-drop support
-
-#### 2. **projects.ts** - Project Management
-
-- `list` - User's projects (owned + member)
-- `get` - Project with members and todo count
-- `create` - With owner assignment
-- `update` - Name, description, visibility
-- `archive` - Soft archive
-- `addMember` - Add project member
-- `removeMember` - Remove project member
-- `leave` - Leave project as member
-- `transfer` - Transfer ownership
-
-#### 3. **tags.ts** - Tag System
-
-- `list` - User's tags with usage count
-- `create` - New tag with color
-- `update` - Rename/recolor
-- `delete` - Remove tag (cascade from todos)
-- `merge` - Merge two tags
-- `popular` - Most used tags
-
-#### 4. **todoComments.ts** - Comment System
-
-- `list` - Comments for a todo (nested)
-- `create` - Add comment
-- `reply` - Reply to comment
-- `update` - Edit comment
-- `delete` - Remove comment
-- `react` - Add reaction/emoji
-
-#### 5. **todoInternal.ts** - Internal Functions
-
-- `processOverdueTodos` - Mark overdue todos
-- `cleanupDeletedTodos` - Hard delete old soft-deleted
-- `calculateStats` - User/project statistics
-
-#### 6. **aggregates.ts** - Count Operations
-
-- Todo count by user
-- Todo count by project
-- Todo count by status
-- Tag usage count
-- Comment count per todo
-
-#### 7. **triggers.ts** - Database Triggers
-
-- Update aggregates on todo changes
-- Validate todo title length
-- Auto-assign creation timestamps
-- Cascade soft deletes
-
-### Frontend Structure (`src/`)
-
-#### 1. **Pages**
-
-- `/` - Dashboard with todo lists
-- `/projects` - Project management
-- `/projects/[id]` - Project detail with todos
-- `/tags` - Tag management
-- `/search` - Global search
-- `/settings` - User settings
-
-#### 2. **Components**
-
-- `TodoList` - Paginated list with filters
-- `TodoItem` - Single todo with actions
-- `TodoForm` - Create/edit todo
-- `TodoFilters` - Status, project, tag filters
-- `TodoSearch` - Search bar with results
-- `ProjectCard` - Project preview
-- `ProjectMembers` - Member management
-- `TagPicker` - Multi-select tags
-- `CommentThread` - Nested comments
-- `StatsWidget` - Aggregate displays
-
-#### 3. **Features to Showcase**
-
-- **Real-time Updates**: Live todo changes
-- **Optimistic UI**: Instant feedback
-- **Pagination**: Load more pattern
-- **Search**: Debounced full-text search
-- **Filters**: Combined filtering
-- **Drag & Drop**: Reorder todos
-- **Keyboard Shortcuts**: Quick actions
-- **Skeleton Loading**: Smooth loading states
-- **Error Handling**: User-friendly errors
-- **Rate Limiting**: Prevent spam
-
-## Key Patterns to Demonstrate
-
-### 1. **Authentication Context**
-
-```typescript
-// Use pre-loaded ctx.user
-handler: async (ctx, args) => {
-  await ctx.user.patch({ lastActive: Date.now() });
-};
-```
-
-### 2. **Edge Traversal**
-
-```typescript
-// Efficient relationship queries
-const todos = await user
-  .edge('todos')
-  .filter((q) => q.eq(q.field('completed'), false))
-  .order('desc')
-  .take(10);
-```
-
-### 3. **Aggregates with Triggers**
-
-```typescript
-// O(log n) counts
-const todoCount = await aggregateTodosByUser.count(ctx, {
-  namespace: userId,
-});
-```
-
-### 4. **Search with Filters**
-
-```typescript
-// Full-text + field filters
-const results = await ctx
-  .table('todos')
-  .search('search_title_description', (q) =>
-    q.search('title', query).eq('userId', userId).eq('completed', false),
-  )
-  .take(20);
-```
-
-### 5. **Pagination with Streams**
-
-```typescript
-// Complex filters with consistent pages
-const stream = await stream(ctx.db, schema)
-  .query('todos')
-  .filterWith(async (todo) => {
-    const tags = await todo.edge('tags');
-    return tags.some((t) => selectedTags.includes(t._id));
-  })
-  .paginate(args.paginationOpts);
-```
-
-## UI/UX Approach
-
-### Design Principles
-
-- **Minimal & Clean**: Focus on functionality over aesthetics
-- **Compact Layout**: Dense information display
-- **Instant Feedback**: Optimistic updates everywhere
-- **Keyboard First**: Shortcuts for power users
-- **Mobile Friendly**: Responsive design
-
-### Component Structure
-
-- Use shadcn/ui components exclusively
-- Minimal custom styling
-- Focus on demonstrating Convex features
-- Clear labeling of feature demos
-
-## Testing Checklist
-
-- [ ] All CRUD operations work
-- [ ] Real-time updates across sessions
-- [ ] Search returns relevant results
-- [ ] Filters combine correctly
-- [ ] Pagination loads smoothly
-- [ ] Aggregates update instantly
-- [ ] Soft delete/restore works
-- [ ] Rate limiting prevents spam
-- [ ] Error messages are helpful
-- [ ] Loading states are smooth
-- [ ] Mobile layout is usable
-- [ ] Keyboard shortcuts work
-
-## Development Order
-
-1. **Phase 1**: Core Todo CRUD
-   - Basic todo operations
-   - Real-time updates
-   - Soft deletion
-
-2. **Phase 2**: Projects & Relationships
-   - Project CRUD
-   - Todo-project association
-   - Member management
-
-3. **Phase 3**: Tags & Search
-   - Tag system
-   - Full-text search
-   - Combined filters
-
-4. **Phase 4**: Comments & Aggregates
-   - Comment threads
-   - Count displays
-   - Trigger setup
-
-5. **Phase 5**: Polish
-   - Loading states
-   - Error handling (toast)

package/2/.claude/docs/project-status.md

@@ -1,25 +0,0 @@
-## Project Status: Pre-MVP
-
-**Current Stage**: Pre-MVP (highest velocity to ship)
-
-### DO Care About (Production-Ready Foundation)
-
-- **Security**: Authentication, authorization, session management
-- **Data Validation**: Zod schemas for all inputs
-- **Error Handling**: User-friendly error messages and proper error states
-- **Type Safety**: Full TypeScript coverage and type-safe APIs
-- **Data Integrity**: Proper database constraints and relationships
-- **Code Patterns**: Follow existing patterns in the codebase
-- **Core Features**: Complete implementation including error states
-- **API Security**: Rate limiting, protected procedures, userId filters
-
-### DO NOT Care About (Skip for Velocity)
-
-- **Breaking Changes**: Not deployed yet, refactor freely
-- **Unit Testing**: Unless specifically requested
-- **Performance Optimization**: Unless blocking functionality
-- **Backward Compatibility**: No existing users
-- **Migration Scripts**: No production data yet
-- **Extensive Documentation**: Unless requested
-- **Edge Cases**: That don't block core functionality
-- **Premature Abstractions**: Build what's needed now

package/2/.claude/docs/project-structure.md

@@ -1,7 +0,0 @@
-# Project Structure
-
-_Last Updated: 2025-07-27_
-
-```
-
-```

package/2/.claude/docs/tech-stack.md

@@ -1,157 +0,0 @@
-# Tech Stack Documentation
-
-## Overview
-
-Next.js application with Convex backend, Better Auth authentication, and Tailwind CSS v4 styling. Built with TypeScript and React 19.
-
-## Programming Language & Runtime
-
-- **TypeScript**: 5.x
-- **Node.js**: v18.20.8
-- **Package Manager**: pnpm
-
-## Frontend
-
-### UI Framework
-
-- **React**: 19.1.0
-- **React DOM**: 19.1.0
-- **Next.js**: 15.4.4 (App Router)
-
-### Styling
-
-- **Tailwind CSS**: v4
-- **PostCSS**: @tailwindcss/postcss
-- **tw-animate-css**: 1.3.6
-- **Fonts**: Geist Sans, Geist Mono (Google Fonts)
-
-### Component Libraries
-
-- **Radix UI**: Full suite of primitives (accordion, alert-dialog, avatar, checkbox, dialog, dropdown-menu, etc.)
-- **shadcn/ui components**: Built on Radix UI
-- **class-variance-authority**: 0.7.1
-- **clsx**: 2.1.1
-- **tailwind-merge**: 3.3.1
-
-### State Management
-
-- **jotai-x**: 2.3.3
-- **React Hook Form**: 7.61.1
-- **@hookform/resolvers**: 5.2.0
-
-### Data Fetching
-
-- **@tanstack/react-query**: 5.83.0
-- **@convex-dev/react-query**: 0.0.0-alpha.11
-
-### UI Components
-
-- **cmdk**: 1.1.1 (Command palette)
-- **date-fns**: 4.1.0 (Date utilities)
-- **embla-carousel-react**: 8.6.0
-- **input-otp**: 1.4.2
-- **lucide-react**: 0.526.0 (Icons)
-- **react-day-picker**: 9.8.1
-- **react-resizable-panels**: 3.0.3
-- **recharts**: 2.15.4 (Charts)
-- **sonner**: 2.0.6 (Toast notifications)
-- **vaul**: 1.1.2 (Drawer component)
-
-### Utilities
-
-- **next-themes**: 0.4.6 (Theme management)
-- **nuqs**: 2.4.1 (URL state management)
-- **ts-essentials**: 10.1.1
-
-## Backend
-
-### Backend Framework
-
-- **Convex**: 1.25.2
-- **convex-ents**: 0.15.0 (Entity system)
-- **convex-helpers**: 0.1.99
-
-### Authentication
-
-- **better-auth**: 1.3.4
-- **@convex-dev/better-auth**: 0.7.0 (Convex adapter)
-
-### Backend Components
-
-- **@convex-dev/aggregate**: 0.1.21
-- **@convex-dev/rate-limiter**: 0.2.10
-
-### Validation
-
-- **zod**: 3.25.76
-
-## Database & Storage
-
-- **Convex Database**: Built-in reactive database
-- **Schema**: Defined using convex-ents with users table
-
-## Development Tools & Workflow
-
-### Build Tools
-
-- **Next.js Turbopack**: Development server
-- **TypeScript**: Compiler with custom tsconfig
-
-### Scripts
-
-```json
-{
-  "build": "next build",
-  "dev": "concurrently 'pnpm dev:app' 'pnpm dev:backend'",
-  "dev:app": "next dev --turbopack",
-  "dev:backend": "convex dev",
-  "lint": "next lint",
-  "lint:fix": "next lint --fix",
-  "typecheck": "tsc --noEmit",
-  "typecheck:watch": "pnpm typecheck --watch",
-  "seed": "convex run seed:seed",
-  "studio": "pnpm convex dashboard"
-}
-```
-
-### Development Dependencies
-
-- **ESLint**: v9 with Next.js config
-- **@types/node**: v20
-- **@types/react**: v19
-- **@types/react-dom**: v19
-- **concurrently**: 9.2.0
-
-### Environment Configuration
-
-- **@t3-oss/env-nextjs**: 0.13.8
-
-## TypeScript Configuration
-
-```json
-{
-  "strict": false,
-  "strictNullChecks": true,
-  "target": "es2022",
-  "module": "esnext",
-  "moduleResolution": "bundler",
-  "jsx": "preserve",
-  "paths": {
-    "@/*": ["./src/*"],
-    "@convex/*": ["./convex/*"]
-  }
-}
-```
-
-## Path Aliases
-
-- `@/*` � `./src/*`
-- `@convex/*` � `./convex/*`
-
-## Convex Configuration
-
-- Better Auth integration
-- Rate limiting
-- User aggregation
-- Custom authentication with email verification
-- Session management (30-day expiry, 15-day update age)

package/2/.claude/scripts/tree.sh

@@ -1,70 +0,0 @@
-#!/bin/bash
-
-# Custom folders to ignore (in addition to .gitignore)
-CUSTOM_IGNORE="@trunk|skill-tree|@skill-tree|public|migrations|tracingDir|eslint.tsconfig.mjs|tooling|sentry*|.github"
-
-# Parse tsconfig.json exclude patterns
-TSCONFIG_IGNORE=""
-if [ -f "tsconfig.json" ]; then
-    # Extract exclude patterns from tsconfig.json
-    # Parse the JSON properly and handle wildcards
-    TSCONFIG_PATTERNS=$(node -e "
-        const fs = require('fs');
-        const tsconfig = JSON.parse(fs.readFileSync('tsconfig.json', 'utf8'));
-        if (tsconfig.exclude) {
-            const patterns = tsconfig.exclude.map(p => {
-                // Remove leading **/ and trailing /*
-                return p.replace(/^\*\*\//, '').replace(/\/\*$/, '').replace(/^\*\*/, '');
-            }).filter(p => p && !p.includes('*'));
-            console.info(patterns.join('|'));
-        }
-    " 2>/dev/null || echo "")
-    
-    if [ -n "$TSCONFIG_PATTERNS" ]; then
-        TSCONFIG_IGNORE="|$TSCONFIG_PATTERNS"
-    fi
-fi
-
-# Combine all ignore patterns
-FULL_IGNORE=".git|*.bak|$CUSTOM_IGNORE$TSCONFIG_IGNORE"
-
-# Output file
-OUTPUT=".claude/docs/project-structure.md"
-
-# Create directory if it doesn't exist
-mkdir -p .claude/docs
-
-# Header
-cat > "$OUTPUT" << 'EOF'
-# Project Structure
-
-EOF
-
-echo "_Last Updated: $(date +%Y-%m-%d)_" >> "$OUTPUT"
-echo "" >> "$OUTPUT"
-echo '```' >> "$OUTPUT"
-
-# Backup original .gitignore
-cp .gitignore .gitignore.bak
-
-# Remove !.* line temporarily (both commented and uncommented versions)
-grep -v '^!\.\*' .gitignore | grep -v '^# !\.\*' > .gitignore.tmp && mv .gitignore.tmp .gitignore
-
-# Use tree with gitignore (now without !.* line)
-tree --gitignore \
-  -a \
-  -I "$FULL_IGNORE" \
-  --dirsfirst \
-  >> "$OUTPUT"
-
-# Restore original .gitignore
-mv .gitignore.bak .gitignore
-
-# Close code block
-echo '```' >> "$OUTPUT"
-echo "" >> "$OUTPUT"
-
-echo "Project structure written to $OUTPUT"
-
-# Output the contents to stdout as well
-cat "$OUTPUT"

package/2/.claude/settings.json

@@ -1,30 +0,0 @@
-{
-  "permissions": {
-    "allow": ["Bash", "Edit", "mcp__task_master_ai__*"]
-  },
-  "enableAllProjectMcpServers": true,
-  "hooks": {
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "DATA=$(cat); TRANSCRIPT=$(echo \"$DATA\" | jq -r '.transcript_path'); TITLE=$(grep -m1 '\"type\":\"summary\"' \"$TRANSCRIPT\" 2>/dev/null | jq -r '.summary' 2>/dev/null || echo \"Claude Code\"); terminal-notifier -message \"Claude finished responding\" -title \"$TITLE\" -sound Ping"
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "DATA=$(cat); TRANSCRIPT=$(echo \"$DATA\" | jq -r '.transcript_path'); TITLE=$(grep -m1 '\"type\":\"summary\"' \"$TRANSCRIPT\" 2>/dev/null | jq -r '.summary' 2>/dev/null || echo \"Claude Code\"); terminal-notifier -message \"Compacting conversation...\" -title \"$TITLE\" -sound Bottle"
-          }
-        ]
-      }
-    ]
-  }
-}