Address program cache and reset review

Author: nabilfatih

apps/www/lib/programs/server.ts

@@ -3,12 +3,12 @@ import "server-only";
 import { api } from "@repo/backend/convex/_generated/api";
 import { fetchQuery } from "convex/nextjs";
 import { Effect, Schema } from "effect";
-import { cacheLife } from "next/cache";
 import type { Locale } from "next-intl";
 import type {
   ActiveLearningProfile,
   LearningProgramCatalog,
 } from "@/components/programs/contract";
+import { applyContentRuntimeCache } from "@/lib/content/cache";
 
 /** Expected failure while reading the current user's learning profile. */
 class ActiveLearningProfileReadError extends Schema.TaggedError<ActiveLearningProfileReadError>()(
@@ -47,7 +47,7 @@ export async function getLearningProgramCatalog(
   locale: Locale
 ): Promise<LearningProgramCatalog> {
   "use cache";
-  cacheLife("contentRuntime");
+  applyContentRuntimeCache();
 
   return await fetchQuery(api.learningPrograms.queries.listSelectablePrograms, {
     locale,

packages/backend/convex/contentSync/reset/spec.test.ts

@@ -0,0 +1,17 @@
+import {
+  preservedProgramCatalogTableNames,
+  resettableTableNames,
+} from "@repo/backend/convex/contentSync/reset/spec";
+import { describe, expect, it } from "vitest";
+
+describe("contentSync/reset spec", () => {
+  it("resets derived coverage while preserving referenced program catalog rows", () => {
+    expect(resettableTableNames).toContain("learningProgramCoverage");
+    expect(resettableTableNames).not.toContain("learningPrograms");
+    expect(resettableTableNames).not.toContain("learningProgramSources");
+    expect(preservedProgramCatalogTableNames).toEqual([
+      "learningPrograms",
+      "learningProgramSources",
+    ]);
+  });
+});

packages/backend/convex/contentSync/reset/spec.ts

@@ -59,3 +59,17 @@ export const resettableTableNames = [
 ] as const satisfies readonly TableNames[];
 
 export type ResettableTableName = (typeof resettableTableNames)[number];
+
+/**
+ * Program catalog rows are sync-managed but intentionally preserved by the broad
+ * content reset because learning profiles, plans, and plan items store generated
+ * program document IDs. Coverage rows are derived from content routes and remain
+ * reset-managed because they can be rebuilt without orphaning user state.
+ */
+export const preservedProgramCatalogTableNames = [
+  "learningPrograms",
+  "learningProgramSources",
+] as const satisfies readonly TableNames[];
+
+export type PreservedProgramCatalogTableName =
+  (typeof preservedProgramCatalogTableNames)[number];

packages/backend/scripts/sync-content/reset.test.ts

@@ -146,7 +146,27 @@ describe("sync-content reset", () => {
     expect(log).toHaveBeenCalledWith("  Quran Verses:          0");
     expect(log).toHaveBeenCalledWith("  Total derived items:  0");
     expect(logSuccess).toHaveBeenCalledWith(
-      "\nDatabase is already empty. Nothing to delete."
+      "\nReset-managed content is already empty. Nothing to delete."
+    );
+    expect(log).not.toHaveBeenCalledWith("\nTo delete all content, run:");
+  });
+
+  it("preserves program catalog rows without treating them as reset-managed content", async () => {
+    vi.mocked(getContentCounts).mockReturnValue(
+      Effect.succeed({
+        ...emptyCounts,
+        learningProgramSources: 5,
+        learningPrograms: 4,
+      })
+    );
+
+    await Effect.runPromise(reset(config, { force: false }));
+
+    expect(log).toHaveBeenCalledWith("  Learning Programs:     4");
+    expect(log).toHaveBeenCalledWith("  Learning Program Srcs: 5");
+    expect(log).toHaveBeenCalledWith("  Preserved program catalog rows: 9");
+    expect(logSuccess).toHaveBeenCalledWith(
+      "\nReset-managed content is already empty. Nothing to delete."
     );
     expect(log).not.toHaveBeenCalledWith("\nTo delete all content, run:");
   });

packages/backend/scripts/sync-content/reset.ts

@@ -446,22 +446,22 @@ export const reset = Effect.fn("sync.reset")(function* (
     counts.quranVerses +
     counts.audioContentSources +
     counts.contentAudios;
+  const preservedProgramCatalog =
+    counts.learningPrograms + counts.learningProgramSources;
 
   log(`\n  Total content items:  ${totalContent}`);
   log(`  Total related items:  ${totalRelated}`);
   log(`  Total runtime items:  ${totalRuntime}`);
   log(`  Total derived items:  ${totalDerived}`);
-  log(
-    `  Program catalog rows: ${counts.learningPrograms + counts.learningProgramSources}`
-  );
+  log(`  Preserved program catalog rows: ${preservedProgramCatalog}`);
 
   if (
     totalContent === 0 &&
     totalRelated === 0 &&
     totalRuntime === 0 &&
     totalDerived === 0
   ) {
-    logSuccess("\nDatabase is already empty. Nothing to delete.");
+    logSuccess("\nReset-managed content is already empty. Nothing to delete.");
     return;
   }