feat: Phase 3 - Habits + Projects CRUD API, frontend, completions, sections

Habits REST API: - GET/POST /api/domains/[domainId]/habits (list with filters, create) - GET/PATCH/DELETE /api/domains/[domainId]/habits/[id] (detail, update, soft delete) - POST /api/domains/[domainId]/habits/[id]/complete (completion + streak calc) - GET /api/domains/[domainId]/habits/[id]/completions (list with date range) - POST/DELETE /api/domains/[domainId]/habits/[id]/tags Projects REST API: - GET/POST /api/domains/[domainId]/projects (list with task counts, create) - GET/PATCH/DELETE /api/domains/[domainId]/projects/[id] (detail with sections/tasks, update, soft delete) Sections REST API: - GET/POST /api/domains/[domainId]/projects/[projectId]/sections (list, create) - GET/PATCH/DELETE /api/domains/[domainId]/projects/[projectId]/sections/[id] Frontend: - Habits page: checklist view, difficulty badges, streak display, filter - Habit create dialog: name, description, frequency, difficulty, goal, unit, reminder, mood toggle - Habit completion dialog: value, mood (1-5 emoji), notes - Calendar heatmap: 365-day grid, color by value, hover tooltip - Projects page: grid of cards with progress bars, status badges, tags - Project detail page: sections board, drag tasks between sections - Project create dialog: name, description, status, color picker, target date - Section dialog: name, kind (section/milestone), status, target date Keyboard shortcuts: c h (new habit), c p (new project), c s (new section) All write routes follow AGENTS.md contract (Drizzle + recordActivity + pg_notify). Build, typecheck, and 15 new tests pass.
2026-07-29 06:37:37 -04:00
parent 1fcd12fc14
commit 064a46f97d
23 changed files with 3633 additions and 523 deletions
@@ -0,0 +1,123 @@
+// AGENT INSTRUCTION: After every write (INSERT/UPDATE/DELETE), you MUST:
+// 1. Insert activity feed entry
+// 2. Call pg.notify('project_e_events', JSON.stringify({ type, action, id, workspace_id }))
+// See AGENTS.md for full rules.
+
+import { NextRequest, NextResponse } from 'next/server';
+import { withAuth, requireWorkspaceAccess, createErrorResponse, ApiError } from '@/lib/auth';
+import { recordActivity } from '@/lib/activity';
+import { db, projects, sections } from '@project-e/db';
+import { and, eq, isNull } from 'drizzle-orm';
+import { z } from 'zod';
+
+const sectionKindEnum = z.enum(['section', 'milestone']);
+const sectionStatusEnum = z.enum(['planned', 'in_progress', 'complete']);
+
+const updateSectionSchema = z.object({
+  name: z.string().min(1).optional(),
+  kind: sectionKindEnum.optional(),
+  status: sectionStatusEnum.optional(),
+  targetDate: z.string().datetime().optional().nullable(),
+  sortOrder: z.number().int().optional(),
+});
+
+type RouteContext = { params: Promise<{ domainId: string; projectId: string; id: string }> };
+
+// GET /api/domains/[domainId]/projects/[projectId]/sections/[id] — Get a single section
+export const GET = withAuth<RouteContext>(async (request: NextRequest, user, context) => {
+  const { domainId, projectId, id } = await context!.params;
+  await requireWorkspaceAccess(domainId);
+
+  const [section] = await db.select()
+    .from(sections)
+    .where(and(eq(sections.id, id), eq(sections.projectId, projectId)))
+    .limit(1);
+
+  if (!section) {
+    return createErrorResponse('NOT_FOUND', 'Section not found', 404);
+  }
+
+  return NextResponse.json(section);
+});
+
+// PATCH /api/domains/[domainId]/projects/[projectId]/sections/[id] — Update a section
+export const PATCH = withAuth<RouteContext>(async (request: NextRequest, user, context) => {
+  const { domainId, projectId, id } = await context!.params;
+  await requireWorkspaceAccess(domainId);
+
+  try {
+    const body = await request.json();
+    const data = updateSectionSchema.parse(body);
+
+    const [existing] = await db.select()
+      .from(sections)
+      .where(and(eq(sections.id, id), eq(sections.projectId, projectId)))
+      .limit(1);
+
+    if (!existing) {
+      return createErrorResponse('NOT_FOUND', 'Section not found', 404);
+    }
+
+    const updateValues: Record<string, unknown> = {};
+    if (data.name !== undefined) updateValues.name = data.name;
+    if (data.kind !== undefined) updateValues.kind = data.kind;
+    if (data.status !== undefined) updateValues.status = data.status;
+    if (data.targetDate !== undefined) updateValues.targetDate = data.targetDate ? new Date(data.targetDate) : null;
+    if (data.sortOrder !== undefined) updateValues.sortOrder = data.sortOrder;
+    updateValues.updatedAt = new Date();
+
+    const [updated] = await db.update(sections)
+      .set(updateValues)
+      .where(eq(sections.id, id))
+      .returning();
+
+    await recordActivity({
+      actor: user.name,
+      action: 'updated',
+      entityType: 'section',
+      entityId: id,
+      changes: { ...data, previousName: existing.name, projectId },
+      workspaceId: domainId,
+    });
+
+    return NextResponse.json(updated);
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return createErrorResponse('VALIDATION_ERROR', 'Invalid input', 400, error.issues);
+    }
+    if (error instanceof ApiError) {
+      return createErrorResponse(error.code, error.message, error.status);
+    }
+    console.error('[sections PATCH] error:', error);
+    return createErrorResponse('INTERNAL_ERROR', 'Failed to update section', 500);
+  }
+});
+
+// DELETE /api/domains/[domainId]/projects/[projectId]/sections/[id] — Delete a section
+export const DELETE = withAuth<RouteContext>(async (request: NextRequest, user, context) => {
+  const { domainId, projectId, id } = await context!.params;
+  await requireWorkspaceAccess(domainId);
+
+  const [existing] = await db.select()
+    .from(sections)
+    .where(and(eq(sections.id, id), eq(sections.projectId, projectId)))
+    .limit(1);
+
+  if (!existing) {
+    return createErrorResponse('NOT_FOUND', 'Section not found', 404);
+  }
+
+  await db.delete(sections)
+    .where(eq(sections.id, id));
+
+  await recordActivity({
+    actor: user.name,
+    action: 'deleted',
+    entityType: 'section',
+    entityId: id,
+    changes: { name: existing.name, projectId },
+    workspaceId: domainId,
+  });
+
+  return new NextResponse(null, { status: 204 });
+});
@@ -0,0 +1,106 @@
+// AGENT INSTRUCTION: After every write (INSERT/UPDATE/DELETE), you MUST:
+// 1. Insert activity feed entry
+// 2. Call pg.notify('project_e_events', JSON.stringify({ type, action, id, workspace_id }))
+// See AGENTS.md for full rules.
+
+import { NextRequest, NextResponse } from 'next/server';
+import { withAuth, requireWorkspaceAccess, createErrorResponse, ApiError } from '@/lib/auth';
+import { recordActivity } from '@/lib/activity';
+import { db, projects, sections } from '@project-e/db';
+import { and, asc, eq, isNull, sql } from 'drizzle-orm';
+import { z } from 'zod';
+
+const sectionKindEnum = z.enum(['section', 'milestone']);
+const sectionStatusEnum = z.enum(['planned', 'in_progress', 'complete']);
+
+const createSectionSchema = z.object({
+  name: z.string().min(1, 'Name is required'),
+  kind: sectionKindEnum.optional().default('section'),
+  status: sectionStatusEnum.optional().default('planned'),
+  targetDate: z.string().datetime().optional().nullable(),
+  sortOrder: z.number().int().optional(),
+});
+
+type RouteContext = { params: Promise<{ domainId: string; projectId: string }> };
+
+// GET /api/domains/[domainId]/projects/[projectId]/sections — List sections for a project
+export const GET = withAuth<RouteContext>(async (request: NextRequest, user, context) => {
+  const { domainId, projectId } = await context!.params;
+  await requireWorkspaceAccess(domainId);
+
+  // Verify project exists and belongs to domain
+  const [project] = await db.select({ id: projects.id })
+    .from(projects)
+    .where(and(eq(projects.id, projectId), eq(projects.domainId, domainId), isNull(projects.deletedAt)))
+    .limit(1);
+
+  if (!project) {
+    return createErrorResponse('NOT_FOUND', 'Project not found', 404);
+  }
+
+  const items = await db.select()
+    .from(sections)
+    .where(eq(sections.projectId, projectId))
+    .orderBy(asc(sections.sortOrder));
+
+  return NextResponse.json({ items });
+});
+
+// POST /api/domains/[domainId]/projects/[projectId]/sections — Create a section
+export const POST = withAuth<RouteContext>(async (request: NextRequest, user, context) => {
+  const { domainId, projectId } = await context!.params;
+  await requireWorkspaceAccess(domainId);
+
+  try {
+    const body = await request.json();
+    const data = createSectionSchema.parse(body);
+
+    // Verify project exists
+    const [project] = await db.select({ id: projects.id, name: projects.name })
+      .from(projects)
+      .where(and(eq(projects.id, projectId), eq(projects.domainId, domainId), isNull(projects.deletedAt)))
+      .limit(1);
+
+    if (!project) {
+      return createErrorResponse('NOT_FOUND', 'Project not found', 404);
+    }
+
+    // Determine sort order if not provided
+    let sortOrder = data.sortOrder;
+    if (sortOrder === undefined) {
+      const [maxOrder] = await db.select({ max: sql<number>`COALESCE(MAX(sort_order), -1)` })
+        .from(sections)
+        .where(eq(sections.projectId, projectId));
+      sortOrder = Number(maxOrder?.max || -1) + 1;
+    }
+
+    const [section] = await db.insert(sections).values({
+      name: data.name,
+      projectId,
+      kind: data.kind,
+      status: data.status,
+      targetDate: data.targetDate ? new Date(data.targetDate) : null,
+      sortOrder,
+    }).returning();
+
+    await recordActivity({
+      actor: user.name,
+      action: 'created',
+      entityType: 'section',
+      entityId: section.id,
+      changes: { name: section.name, projectId, projectName: project.name, kind: section.kind },
+      workspaceId: domainId,
+    });
+
+    return NextResponse.json(section, { status: 201 });
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return createErrorResponse('VALIDATION_ERROR', 'Invalid input', 400, error.issues);
+    }
+    if (error instanceof ApiError) {
+      return createErrorResponse(error.code, error.message, error.status);
+    }
+    console.error('[sections POST] error:', error);
+    return createErrorResponse('INTERNAL_ERROR', 'Failed to create section', 500);
+  }
+});