feat: add module migration contracts and validation

templates/module/tests/manifest.test.ts

@@ -1,7 +1,10 @@
+import { createHash } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import {
   type CapabilityId,
+  parseDrizzleMigrationJournal,
   parseModuleManifest,
+  parseModuleMigrationPolicy,
   type RegisteredCapability,
 } from "@ekklesia/module-sdk";
 import { getTableConfig } from "drizzle-orm/pg-core";
@@ -19,6 +22,34 @@ describe("module template", () => {
     expect(manifest.capabilities).toEqual([{ id: "example.records", version: "1.0.0" }]);
     expect(manifest.storage.buckets.map((bucket) => bucket.id)).toEqual(["records"]);
     expect(manifest.entrypoints.schema).toBe("./dist/schema/index.js");
+    expect(manifest.entrypoints.migrations).toBe("./drizzle");
+  });
+
+  it("packages a generated stable Drizzle migration and matching policy", async () => {
+    const [journalInput, policyInput, packageInput, sql] = await Promise.all([
+      readFile(new URL("../drizzle/meta/_journal.json", import.meta.url), "utf8"),
+      readFile(new URL("../drizzle/meta/_ekklesia.json", import.meta.url), "utf8"),
+      readFile(new URL("../package.json", import.meta.url), "utf8"),
+      readFile(new URL("../drizzle/0000_initial.sql", import.meta.url)),
+    ]);
+    const journal = parseDrizzleMigrationJournal(JSON.parse(journalInput) as unknown);
+    const policy = parseModuleMigrationPolicy(JSON.parse(policyInput) as unknown);
+    const packageJson = JSON.parse(packageInput) as {
+      devDependencies?: Record<string, string>;
+      files?: string[];
+    };
+
+    expect(journal.entries.map((entry) => entry.tag)).toEqual(["0000_initial"]);
+    expect(policy).toMatchObject({
+      moduleId: "example",
+      entries: [{ tag: "0000_initial", destructive: { mode: "none" } }],
+    });
+    expect(packageJson.devDependencies?.["drizzle-kit"]).toBe("0.31.10");
+    expect(packageJson.files).toContain("drizzle");
+    expect(createHash("sha256").update(sql).digest("hex")).toBe(
+      "e09d6c9995fa2c4bd59b815afc9bb6ded6a2d4e1b3e1d97c10457a94a6a4f2a4",
+    );
+    expect(sql.toString("utf8")).toContain('CREATE TABLE "example_records"');
   });
 
   it("exports the typed runtime definition used by the compiled server entrypoint", async () => {