feat(09-01): add classification column to setupItems with service layer and tests

- Add classification text column (default 'base') to setupItems schema
- Add classificationSchema and updateClassificationSchema Zod validators
- Add UpdateClassification type inferred from Zod schema
- Implement updateItemClassification service function
- Modify getSetupWithItems to return classification field
- Modify syncSetupItems to preserve classifications across re-sync
- Add tests for classification CRUD, preservation, and cross-setup independence
- Generate and apply Drizzle migration

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/db/schema.ts

@@ -86,6 +86,7 @@ export const setupItems = sqliteTable("setup_items", {
 	itemId: integer("item_id")
 		.notNull()
 		.references(() => items.id, { onDelete: "cascade" }),
+	classification: text("classification").notNull().default("base"),
 });
 
 export const settings = sqliteTable("settings", {

src/server/services/setup.service.ts

@@ -53,6 +53,7 @@ export function getSetupWithItems(db: Db = prodDb, setupId: number) {
 			updatedAt: items.updatedAt,
 			categoryName: categories.name,
 			categoryIcon: categories.icon,
+			classification: setupItems.classification,
 		})
 		.from(setupItems)
 		.innerJoin(items, eq(setupItems.itemId, items.id))
@@ -101,16 +102,51 @@ export function syncSetupItems(
 	itemIds: number[],
 ) {
 	return db.transaction((tx) => {
+		// Save existing classifications before deleting
+		const existing = tx
+			.select({
+				itemId: setupItems.itemId,
+				classification: setupItems.classification,
+			})
+			.from(setupItems)
+			.where(eq(setupItems.setupId, setupId))
+			.all();
+
+		const classificationMap = new Map<number, string>();
+		for (const row of existing) {
+			classificationMap.set(row.itemId, row.classification);
+		}
+
 		// Delete all existing items for this setup
 		tx.delete(setupItems).where(eq(setupItems.setupId, setupId)).run();
 
-		// Re-insert new items
+		// Re-insert new items, preserving classifications for retained items
 		for (const itemId of itemIds) {
-			tx.insert(setupItems).values({ setupId, itemId }).run();
+			tx.insert(setupItems)
+				.values({
+					setupId,
+					itemId,
+					classification: classificationMap.get(itemId) ?? "base",
+				})
+				.run();
 		}
 	});
 }
 
+export function updateItemClassification(
+	db: Db = prodDb,
+	setupId: number,
+	itemId: number,
+	classification: string,
+) {
+	db.update(setupItems)
+		.set({ classification })
+		.where(
+			sql`${setupItems.setupId} = ${setupId} AND ${setupItems.itemId} = ${itemId}`,
+		)
+		.run();
+}
+
 export function removeSetupItem(
 	db: Db = prodDb,
 	setupId: number,

src/shared/schemas.ts

@@ -73,3 +73,10 @@ export const updateSetupSchema = z.object({
 export const syncSetupItemsSchema = z.object({
 	itemIds: z.array(z.number().int().positive()),
 });
+
+// Classification schemas
+export const classificationSchema = z.enum(["base", "worn", "consumable"]);
+
+export const updateClassificationSchema = z.object({
+	classification: classificationSchema,
+});

src/shared/types.ts

@@ -17,6 +17,7 @@ import type {
 	syncSetupItemsSchema,
 	updateCandidateSchema,
 	updateCategorySchema,
+	updateClassificationSchema,
 	updateItemSchema,
 	updateSetupSchema,
 	updateThreadSchema,
@@ -37,6 +38,7 @@ export type ResolveThread = z.infer<typeof resolveThreadSchema>;
 export type CreateSetup = z.infer<typeof createSetupSchema>;
 export type UpdateSetup = z.infer<typeof updateSetupSchema>;
 export type SyncSetupItems = z.infer<typeof syncSetupItemsSchema>;
+export type UpdateClassification = z.infer<typeof updateClassificationSchema>;
 
 // Types inferred from Drizzle schema
 export type Item = typeof items.$inferSelect;