refactor: complete v2 refactoring plan (Phases 1-5)

Phase 1 — Quick Wins: centralize formatMoney/formatCents, extract
findUniqueOrThrow helper (19 routers), shared Prisma select constants,
useInvalidatePlanningViews hook, status badge consolidation, composite
DB indexes.

Phase 2 — Timeline Split: extract TimelineContext, TimelineResourcePanel,
TimelineProjectPanel; split 28-dep useMemo into 3 focused memos.
TimelineView.tsx reduced from 1,903 to 538 lines.

Phase 3 — Query Performance: server-side filtering for getEntriesView,
remove availability from timeline resource select, SSE event debouncing
(50ms batch window).

Phase 4 — Estimate Workspace: extract 7 tab components and 3 editor
components. EstimateWorkspaceClient 1,298→306 lines,
EstimateWorkspaceDraftEditor 1,205→581 lines.

Phase 5 — Package Cleanup: split commit-dispo-import-batch (1,112→573
lines), extract shared pagination helper with 11 tests.

All tests pass: 209 API, 254 engine, 67 application.

Co-Authored-By: claude-flow <ruv@ruv.net>

packages/api/src/router/country.ts

@@ -7,6 +7,7 @@ import {
 import { Prisma } from "@planarchy/db";
 import { TRPCError } from "@trpc/server";
 import { z } from "zod";
+import { findUniqueOrThrow } from "../db/helpers.js";
 import { adminProcedure, createTRPCRouter, protectedProcedure } from "../trpc.js";
 
 /** Convert nullable JSON to Prisma-compatible value (null → Prisma.JsonNull). */
@@ -31,14 +32,16 @@ export const countryRouter = createTRPCRouter({
   getById: protectedProcedure
     .input(z.object({ id: z.string() }))
     .query(async ({ ctx, input }) => {
-      const country = await ctx.db.country.findUnique({
-        where: { id: input.id },
-        include: {
-          metroCities: { orderBy: { name: "asc" } },
-          _count: { select: { resources: true } },
-        },
-      });
-      if (!country) throw new TRPCError({ code: "NOT_FOUND", message: "Country not found" });
+      const country = await findUniqueOrThrow(
+        ctx.db.country.findUnique({
+          where: { id: input.id },
+          include: {
+            metroCities: { orderBy: { name: "asc" } },
+            _count: { select: { resources: true } },
+          },
+        }),
+        "Country",
+      );
       return country;
     }),
 
@@ -63,8 +66,10 @@ export const countryRouter = createTRPCRouter({
   update: adminProcedure
     .input(z.object({ id: z.string(), data: UpdateCountrySchema }))
     .mutation(async ({ ctx, input }) => {
-      const existing = await ctx.db.country.findUnique({ where: { id: input.id } });
-      if (!existing) throw new TRPCError({ code: "NOT_FOUND", message: "Country not found" });
+      const existing = await findUniqueOrThrow(
+        ctx.db.country.findUnique({ where: { id: input.id } }),
+        "Country",
+      );
 
       if (input.data.code && input.data.code !== existing.code) {
         const conflict = await ctx.db.country.findUnique({ where: { code: input.data.code } });
@@ -91,8 +96,10 @@ export const countryRouter = createTRPCRouter({
   createCity: adminProcedure
     .input(CreateMetroCitySchema)
     .mutation(async ({ ctx, input }) => {
-      const country = await ctx.db.country.findUnique({ where: { id: input.countryId } });
-      if (!country) throw new TRPCError({ code: "NOT_FOUND", message: "Country not found" });
+      await findUniqueOrThrow(
+        ctx.db.country.findUnique({ where: { id: input.countryId } }),
+        "Country",
+      );
 
       return ctx.db.metroCity.create({
         data: { name: input.name, countryId: input.countryId },
@@ -111,11 +118,13 @@ export const countryRouter = createTRPCRouter({
   deleteCity: adminProcedure
     .input(z.object({ id: z.string() }))
     .mutation(async ({ ctx, input }) => {
-      const city = await ctx.db.metroCity.findUnique({
-        where: { id: input.id },
-        include: { _count: { select: { resources: true } } },
-      });
-      if (!city) throw new TRPCError({ code: "NOT_FOUND", message: "Metro city not found" });
+      const city = await findUniqueOrThrow(
+        ctx.db.metroCity.findUnique({
+          where: { id: input.id },
+          include: { _count: { select: { resources: true } } },
+        }),
+        "Metro city",
+      );
       if (city._count.resources > 0) {
         throw new TRPCError({
           code: "PRECONDITION_FAILED",