test(features): R50 — repo contract suites assert span shape per method

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

packages/blog/src/__contracts__/articles-repository.contract.ts

@@ -1,4 +1,4 @@
-import { it, expect, beforeEach } from "vitest";
+import { it, expect, beforeEach, describe } from "vitest";
 import { defineContractSuite } from "@repo/core-testing/contract";
 import type { IArticlesRepository } from "../application/repositories/articles.repository.interface.js";
 import { articleFactory } from "../__factories__/article.factory.js";
@@ -6,7 +6,7 @@ import { articleFactory } from "../__factories__/article.factory.js";
 export const articlesRepositoryContract =
   defineContractSuite<IArticlesRepository>(
     "IArticlesRepository",
-    ({ buildSubject }) => {
+    ({ buildSubject, getTracer }) => {
       let repo: IArticlesRepository;
 
       beforeEach(async () => {
@@ -116,5 +116,65 @@ export const articlesRepositoryContract =
         });
         expect(result).toBeUndefined();
       });
+
+      describe("span emission (R50)", () => {
+        it("getArticles emits articles.getArticles span with op=repository", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          await repo.getArticles({ limit: 5 });
+          const span = tracer.findSpan("articles.getArticles");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.limit).toBe(5);
+        });
+
+        it("getArticle emits articles.getArticle span with id attribute", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          await repo.getArticle("nonexistent");
+          const span = tracer.findSpan("articles.getArticle");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.id).toBe("nonexistent");
+        });
+
+        it("getArticleBySlug emits articles.getArticleBySlug span with slug attribute", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          await repo.getArticleBySlug("nonexistent");
+          const span = tracer.findSpan("articles.getArticleBySlug");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.slug).toBe("nonexistent");
+        });
+
+        it("createArticle emits articles.createArticle span", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          const seed = articleFactory.build();
+          await repo.createArticle(seed);
+          const span = tracer.findSpan("articles.createArticle");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.slug).toBe(seed.slug);
+        });
+
+        it("updateArticle emits articles.updateArticle span", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          const seed = articleFactory.build();
+          const created = await repo.createArticle(seed);
+          await repo.updateArticle(created.id, { title: "Updated" });
+          const span = tracer.findSpan("articles.updateArticle");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.id).toBe(created.id);
+        });
+      });
     },
   );

packages/blog/src/infrastructure/repositories/articles.repository.mock.test.ts

@@ -1,7 +1,12 @@
 import { describe } from "vitest";
+import { RecordingTracer } from "@repo/core-testing/instrumentation";
 import { MockArticlesRepository } from "@/infrastructure/repositories/articles.repository.mock";
 import { articlesRepositoryContract } from "@/__contracts__/articles-repository.contract";
 
 describe("MockArticlesRepository", () => {
-  articlesRepositoryContract.run(() => new MockArticlesRepository());
+  const tracer = new RecordingTracer();
+  articlesRepositoryContract.run(
+    () => new MockArticlesRepository(tracer),
+    { tracer: () => tracer },
+  );
 });

packages/blog/src/infrastructure/repositories/articles.repository.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, it, vi, beforeEach } from "vitest";
+import { RecordingTracer } from "@repo/core-testing/instrumentation";
 import { ArticlesRepository } from "@/infrastructure/repositories/articles.repository";
 import { articlesRepositoryContract } from "@/__contracts__/articles-repository.contract";
 import { stubPayloadConfig } from "@repo/core-testing/payload/stub-config";
@@ -102,12 +103,16 @@ vi.mock("payload", () => ({
 
 describe("ArticlesRepository", () => {
   describe("contract", () => {
-    articlesRepositoryContract.run(async () => {
-      const stub = buildPayloadStub();
-      const { getPayload } = await import("payload");
-      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
-      return new ArticlesRepository(stubPayloadConfig);
-    });
+    const tracer = new RecordingTracer();
+    articlesRepositoryContract.run(
+      async () => {
+        const stub = buildPayloadStub();
+        const { getPayload } = await import("payload");
+        (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
+        return new ArticlesRepository(stubPayloadConfig, tracer);
+      },
+      { tracer: () => tracer },
+    );
   });
 
   // -------------------------------------------------------------------------