test: restore task 2 review coverage

backend/test/routes-workspaces.test.ts

@@ -7,7 +7,7 @@ import { buildApp } from "../src/app.js";
 import { loadConfig } from "../src/config.js";
 import { WorkspaceRegistryError } from "../src/workspaces/git-repository.js";
 import type { WorkspaceRegistry, WorkspaceRevision } from "../src/workspaces/registry.js";
-import { renderWorkspaceDocs, serializeWorkspaceYaml, type CanonicalWorkspace } from "../src/workspaces/schema.js";
+import { renderWorkspaceDocs, serializeWorkspaceYaml, type CanonicalWorkspace, type WorkspaceV2 } from "../src/workspaces/schema.js";
 
 const workspace: CanonicalWorkspace = {
   workspace: {
@@ -39,6 +39,61 @@ const workspace: CanonicalWorkspace = {
   llm_policy: { allowed: ["zai/glm-5.2"] },
 };
 
+const workspaceV2: WorkspaceV2 = {
+  workspace: {
+    schema_version: 2,
+    id: "psd-clinical",
+    name: "Policlinico San Donato",
+    description: "Clinical analytics workspace",
+    language: "it",
+  },
+  dwh: {
+    engine: "postgres",
+    database: "warehouse",
+    schema: "datawarehouse",
+    supported_transports: ["rest_api"],
+  },
+  semantic_index: {
+    vector_store: {
+      engine: "pgvector",
+      database: "warehouse",
+      schema: "vectors",
+      collection: "clinical_documents",
+      dimensions: 768,
+      distance: "cosine",
+      supported_transports: ["rest_api"],
+    },
+    embedding: {
+      provider: "ollama_compatible",
+      model: "nomic-embed-text-v2-moe",
+      dimensions: 768,
+    },
+  },
+  diagnostics: {
+    dwh_rest: {
+      method: "GET",
+      path: "/health",
+      auth: "none",
+      response: { database: "database", schema: "schema" },
+    },
+    vector_rest: {
+      metadata: {
+        method: "GET",
+        path: "/metadata",
+        auth: "none",
+        response: { collection: "collection", dimensions: "dimensions", distance: "distance" },
+      },
+    },
+    embedding: {
+      method: "GET",
+      path: "/models",
+      auth: "none",
+      response: { model: "model", dimensions: "dimensions" },
+    },
+  },
+  llm_policy: { allowed: ["zai/glm-5.2"] },
+};
+
 const revision: WorkspaceRevision = {
   id: workspace.workspace.id,
   commit: "a".repeat(40),
@@ -177,10 +232,49 @@ test("validates a canonical workspace and runs the injected installation diagnos
   const app = appFor(registryFake(), diagnose);
 
   const validate = await app.inject({ method: "POST", url: "/workspaces/validate", payload: { workspace } });
-  const testResult = await app.inject({ method: "POST", url: "/workspaces/psd-clinical/test", payload: {} });
 
   expect(validate.statusCode).toBe(200);
   expect(validate.json()).toMatchObject({ workspace });
+  expect(diagnose).not.toHaveBeenCalled();
+});
+
+test("runs the injected installation diagnostic for a migration-required v2 workspace when legacy bindings resolve", async () => {
+  const diagnose = vi.fn(async () => ({
+    activatable: false,
+    diagnostics: [{ level: "error" as const, code: "binding_missing" as const, field: "THT_WS_PSD_CLINICAL_VECTOR_BASE_URL", message: "Installation binding is missing or invalid." }],
+  }));
+  const registry = registryFake({
+    read: vi.fn(async () => ({ workspace: workspaceV2, revision: { ...revision, state: "migration_required" as const } })),
+  });
+  const app = appFor(registry, diagnose);
+
+  const originalEnv = { ...process.env };
+  process.env.THT_WS_PSD_CLINICAL_DWH_TRANSPORT = "rest_api";
+  process.env.THT_WS_PSD_CLINICAL_DWH_BASE_URL = "https://dwh.example.test";
+  process.env.THT_WS_PSD_CLINICAL_VECTOR_TRANSPORT = "rest_api";
+  process.env.THT_WS_PSD_CLINICAL_VECTOR_BASE_URL = "https://vector.example.test";
+  process.env.THT_WS_PSD_CLINICAL_EMBEDDING_BASE_URL = "https://embedding.example.test";
+  try {
+    const testResult = await app.inject({ method: "POST", url: "/workspaces/psd-clinical/test", payload: {} });
+
+    expect(testResult.statusCode).toBe(200);
+    expect(testResult.json()).toMatchObject({ activatable: false, diagnostics: [{ code: "binding_missing" }] });
+    expect(diagnose).toHaveBeenCalledWith(workspaceV2, expect.objectContaining({
+      dwh: expect.objectContaining({ transport: "rest_api", missing: [] }),
+      vector: expect.objectContaining({ transport: "rest_api", missing: [] }),
+      embedding: expect.objectContaining({ transport: "rest_api", missing: [] }),
+    }), { writeProbe: false });
+  } finally {
+    process.env = originalEnv;
+  }
+});
+
+test("fails closed for /workspaces/:id/test on a schema v3 workspace before the internal runtime lands", async () => {
+  const diagnose = vi.fn(async () => ({ activatable: true, diagnostics: [] }));
+  const app = appFor(registryFake(), diagnose);
+
+  const testResult = await app.inject({ method: "POST", url: "/workspaces/psd-clinical/test", payload: {} });
+
   expect(testResult.statusCode).toBe(400);
   expect(testResult.json()).toMatchObject({ code: "workspace_invalid" });
   expect(diagnose).not.toHaveBeenCalled();

backend/test/workspace-registry.test.ts

@@ -139,6 +139,18 @@ function legacyV1Yaml(source = validYaml): string {
     .replace("schema_version: 3", "schema_version: 1");
 }
 
+function legacyV2Yaml(source = validYaml): string {
+  return source
+    .replace("    engine: qdrant\n", "    engine: pgvector\n    database: postgres\n    schema: vectors\n")
+    .replace("    collection: psd-clinical\n", "    collection: psd_clinical\n")
+    .replace("    dimensions: 1024", "    dimensions: 768")
+    .replace("    provider: ollama_internal", "    provider: ollama_compatible")
+    .replace("    model: qwen3-embedding:0.6b", "    model: nomic-embed-text-v2-moe")
+    .replace("    dimensions: 1024", "    dimensions: 768")
+    .replace("distance: cosine\n", "distance: cosine\n    supported_transports: [pgvector_direct]\n")
+    .replace("schema_version: 3", "schema_version: 2");
+}
+
 const runFile = promisify(execFile);
 const temporaryRoots: string[] = [];
 
@@ -639,6 +651,19 @@ test("does not acquire a session revision lease for a migration_required workspa
   });
 });
 
+test("lists a schema v2 descriptor as migration_required and refuses to acquire it", async () => {
+  const remote = await fixture(legacyV2Yaml());
+  const registry = new WorkspaceRegistry(config(join(remote.root, "registry"), remote.remote));
+  await registry.bootstrap();
+
+  await expect(registry.list()).resolves.toMatchObject([
+    { id: "psd-clinical", state: "migration_required" },
+  ]);
+  await expect(registry.acquireSessionRevision("psd-clinical")).rejects.toMatchObject({
+    code: "workspace_invalid",
+  });
+});
+
 test("lists operational descriptors retained after their workspace was removed from the active revision", async () => {
   const remote = await fixture();
   const root = join(remote.root, "registry");