test: attribution wire coverage + close Level 4 residual notes

Unit-test toHit/SearchHitSchema attribution shapes; document list without
attribution; feed status filter comment reflects 4b retention outcomes;
memory_search tool blurb mentions attribution guidance.

Author: TheGreatAxios

IMPLEMENTATION.md

@@ -417,6 +417,8 @@ Capture-time `authority` is never rewritten. See `docs/RELEVANCY.md`.
 onto candidates; `toHit` emits provenance, source/temporal class, occurred_at,
 valid_until, corroboration counts, and derived_from. The plane maps these into
 additive `SearchItem.attribution` (and `DocumentStoreSearchItem.attribution`).
+**List/timeline** stays document-title oriented and does not attach the full
+attribution block (version-level fields are search/feed concerns).
 
 **Retention (CL-5871):** `memory.version.retention_class` + migration
 `0007_retention.sql`. Plane helpers in `services/retention.ts`

src/core/schemas/search.test.ts

@@ -47,6 +47,28 @@ describe("SearchHitSchema", () => {
     const out = SearchHitSchema(fixture);
     expect(out instanceof type.errors).toBe(true);
   });
+
+  it("accepts additive attribution fields (CL-5870)", () => {
+    const fixture = fullHitFixture();
+    fixture.provenance = "inferred";
+    fixture.source_class = "derived";
+    fixture.temporal_class = "lesson";
+    fixture.occurred_at = "2026-07-01T00:00:00.000Z";
+    fixture.valid_until = null;
+    fixture.supports = 3;
+    fixture.contradicts = 1;
+    fixture.derived_from = ["kv_src"];
+    fixture.generator_agent_id = "resident-distiller";
+    fixture.created_by_kind = "agent";
+    const out = SearchHitSchema(fixture);
+    expect(out instanceof type.errors ? out.summary : out).toEqual(fixture);
+  });
+
+  it("still parses without attribution fields (additive / back-compat)", () => {
+    const fixture = fullHitFixture();
+    const out = SearchHitSchema(fixture);
+    expect(out instanceof type.errors).toBe(false);
+  });
 });
 
 describe("SearchResponseSchema", () => {

src/services/feed.ts

@@ -69,8 +69,8 @@ export async function fetchFeed(
   const conditions = [
     eq(knowledgeVersion.tenantId, args.tenantId),
     eq(knowledgeVersion.generation, LIVE_GENERATION),
-    // Active (or superseded historical) live rows — exclude tombstones later in 4b.
-    // Feed surfaces commits; status filter keeps deprecated/tombstoned out once written.
+    // Live feed: active or superseded commits only. Deprecated / tombstoned
+    // versions are retention write-path outcomes and stay out of the cursor stream.
     sql`${knowledgeVersion.status} IN ('active', 'superseded')`,
     gt(knowledgeVersion.feedSeq, after),
   ];

src/services/search.test.ts

@@ -6,6 +6,7 @@ import {
   fetchDenseCandidates,
   hnswEfSearch,
   snippet,
+  toHit,
   type CandidateRow,
 } from "./search.ts";
 
@@ -523,3 +524,69 @@ describe("fetchDenseCandidates kind/entity filtering", () => {
     expect(chunkIds).toContain("chunk-note");
   });
 });
+
+describe("toHit — wire attribution (CL-5870)", () => {
+  it("surfaces provenance, temporal, corroboration, and derived_from on the hit", () => {
+    const hit = toHit(
+      candidate({
+        provenance: "inferred",
+        sourceClass: "derived",
+        temporalClass: "state",
+        validUntil: new Date("2026-12-01T00:00:00Z"),
+        supports: 2,
+        contradicts: 0,
+        derivedFrom: ["kv_source_1", "kv_source_2"],
+        generatorAgentId: "resident-distiller",
+        createdByKind: "agent",
+      }),
+    );
+    expect(hit.version_id).toBe("ver_1");
+    expect(hit.provenance).toBe("inferred");
+    expect(hit.source_class).toBe("derived");
+    expect(hit.temporal_class).toBe("state");
+    expect(hit.valid_until).toBe("2026-12-01T00:00:00.000Z");
+    expect(hit.supports).toBe(2);
+    expect(hit.contradicts).toBe(0);
+    expect(hit.derived_from).toEqual(["kv_source_1", "kv_source_2"]);
+    expect(hit.generator_agent_id).toBe("resident-distiller");
+    expect(hit.created_by_kind).toBe("agent");
+  });
+
+  it("omits optional attribution fields when absent (additive wire)", () => {
+    const hit = toHit(candidate());
+    expect(hit.provenance).toBeUndefined();
+    expect(hit.source_class).toBeUndefined();
+    expect(hit.derived_from).toBeUndefined();
+    expect(hit.generator_agent_id).toBeUndefined();
+    expect(hit.supports).toBe(0);
+    expect(hit.contradicts).toBe(0);
+    expect(hit.temporal_class).toBe("event");
+  });
+
+  it("distinguishes stated human vs inferred agent attribution shapes", () => {
+    const human = toHit(
+      candidate({
+        provenance: "stated",
+        sourceClass: "native",
+        createdByKind: "human",
+        generatorAgentId: null,
+      }),
+    );
+    const distilled = toHit(
+      candidate({
+        provenance: "inferred",
+        sourceClass: "derived",
+        createdByKind: "agent",
+        generatorAgentId: "resident-distiller",
+        derivedFrom: ["kv_raw"],
+      }),
+    );
+    expect(human.provenance).toBe("stated");
+    expect(human.created_by_kind).toBe("human");
+    expect(human.generator_agent_id).toBeUndefined();
+    expect(distilled.provenance).toBe("inferred");
+    expect(distilled.created_by_kind).toBe("agent");
+    expect(distilled.generator_agent_id).toBe("resident-distiller");
+    expect(distilled.derived_from).toEqual(["kv_raw"]);
+  });
+});

src/tools/search.ts

@@ -37,8 +37,10 @@ export const memorySearch = defineMemoryHttpTool({
   name: "memory_search",
   description:
     "Hybrid semantic + keyword search over tenant memory. " +
-    "Returns ranked items (and optional evidence). Identity is " +
-    "the authenticated principal on the hub.",
+    "Returns ranked items with optional additive attribution " +
+    "(provenance, temporal class, corroboration, derivedFrom) and evidence. " +
+    "Attribute stated content to the actor; treat inferred as own-voice claims. " +
+    "Identity is the authenticated principal on the hub.",
   inputSchema: {
     type: "object",
     properties: {