fix: gate workspace diagnostic migration

backend/test/workspace-registry.test.ts

@@ -11,7 +11,7 @@ import { WorkspaceRegistry } from "../src/workspaces/registry.js";
 import type { WorkspaceRegistryConfig } from "../src/workspaces/types.js";
 
 const validYaml = `workspace:
-  schema_version: 1
+  schema_version: 2
   id: psd-clinical
   name: Policlinico San Donato
   language: it
@@ -48,7 +48,7 @@ async function git(cwd: string, args: string[]): Promise<void> {
   await runFile("git", args, { cwd });
 }
 
-async function fixture(): Promise<{
+async function fixture(workspaceSource = validYaml): Promise<{
   root: string; remote: string; source: string; initialCommit: string;
 }> {
   const root = mkdtempSync(join(tmpdir(), "thoth-workspace-registry-"));
@@ -61,7 +61,7 @@ async function fixture(): Promise<{
   await git(source, ["config", "user.name", "Workspace Registry Test"]);
   await git(source, ["config", "user.email", "workspace-registry@example.invalid"]);
   mkdirSync(join(source, "workspaces"));
-  writeFileSync(join(source, "workspaces", "psd-clinical.yaml"), validYaml);
+  writeFileSync(join(source, "workspaces", "psd-clinical.yaml"), workspaceSource);
   await git(source, ["add", "workspaces/psd-clinical.yaml"]);
   await git(source, ["commit", "-m", "Initial workspace"]);
   await git(source, ["remote", "add", "origin", remote]);
@@ -104,6 +104,25 @@ test("bootstraps a checkout and activates a validated immutable snapshot", async
   });
 });
 
+test("lists a v1 descriptor in migration-required state without rendering operational artifacts", async () => {
+  const legacyYaml = validYaml.replace(
+    "    database: postgres\n    schema: vectors\n",
+    "",
+  ).replace("schema_version: 2", "schema_version: 1");
+  const remote = await fixture(legacyYaml);
+  const registry = new WorkspaceRegistry(config(join(remote.root, "registry"), remote.remote));
+
+  const status = await registry.bootstrap();
+  const [revision] = await registry.list();
+
+  expect(revision).toMatchObject({ state: "migration_required" });
+  await expect(registry.read("psd-clinical")).resolves.toMatchObject({
+    workspace: { workspace: { schema_version: 1 } },
+  });
+  expect(existsSync(join(remote.root, "registry", "snapshots", status.head!, "psd-clinical.env.example"))).toBe(false);
+  expect(existsSync(join(remote.root, "registry", "snapshots", status.head!, "psd-clinical.md"))).toBe(false);
+});
+
 test("keeps the last valid snapshot when a pulled commit has invalid YAML", async () => {
   const remote = await fixture();
   const registry = new WorkspaceRegistry(config(join(remote.root, "registry"), remote.remote));