# Seams

| Seam | Party A | Shared object | Party B |
|---|---|---|---|
| **[SM-01](seams.md#sm-01)** | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** Survey methodology and agent contracts | MCP tool protocol and survey phase contract | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** Knowledge tools and workflow API |
| **[SM-02](seams.md#sm-02)** | **[B-02](subsystems/b02-mcp-core-persistence-and-lifecycle.md)** MCP core, persistence, and lifecycle | ServerContext and memory.db | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** Knowledge tools and workflow API |
| **[SM-03](seams.md#sm-03)** | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** Knowledge tools and workflow API | materialize_docs subprocess and storage/docs projection | **[B-04](subsystems/b04-diff-aware-materializer.md)** Diff-aware materializer |
| **[SM-04](seams.md#sm-04)** | **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** Packaging, installer, validation, and product docs | packaged agent and reference mirrors | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** Survey methodology and agent contracts |
| **[SM-05](seams.md#sm-05)** | **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** Packaging, installer, validation, and product docs | packaged Python materializer mirror | **[B-04](subsystems/b04-diff-aware-materializer.md)** Diff-aware materializer |
| **[SM-06](seams.md#sm-06)** | **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** Report interface design and validation studies | report projection design/component contract | **[B-04](subsystems/b04-diff-aware-materializer.md)** Diff-aware materializer |
| **[SM-07](seams.md#sm-07)** | **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** Report interface design and validation studies | reporting terminology and information-architecture contract | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** Survey methodology and agent contracts |
| **[SM-08](seams.md#sm-08)** | **[B-07](subsystems/b07-embedded-research-surveys-and-platform-trials.md)** Embedded research surveys and platform trials | research-backed report design constraints | **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** Report interface design and validation studies |
| **[SM-09](seams.md#sm-09)** | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** Knowledge tools and workflow API | entries table (staleness columns: stale, stale_since, stale_reason) | **[B-04](subsystems/b04-diff-aware-materializer.md)** Diff-aware materializer |
| **[SM-10](seams.md#sm-10)** | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** Survey methodology and agent contracts | activation contract (installation scope, skill destination, config markers) | **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** Packaging, installer, validation, and product docs |

| Seam | Shared object | Kind | Parties | Assessable? | Notes |
|---|---|---|---|---|---|
| <a id="sm-01"></a>**SM-01** | MCP tool protocol and survey phase contract | rpc | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** ↔ **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** | ✅ | Assessed at b8b566f: protocol/tool contract passed; generative truth remains evidence-gated. |
| <a id="sm-02"></a>**SM-02** | ServerContext and memory.db | table | **[B-02](subsystems/b02-mcp-core-persistence-and-lifecycle.md)** ↔ **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** | ✅ | Assessed at b8b566f: context/schema contract mapped; [B02-1](findings.md#b02-1) remains a visible recoverability defect. |
| <a id="sm-03"></a>**SM-03** | materialize_docs subprocess and storage/docs projection | file | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** ↔ **[B-04](subsystems/b04-diff-aware-materializer.md)** | ✅ | Assessed at b8b566f: storage/process/summary contract passed; timeout remains unresolved. |
| <a id="sm-04"></a>**SM-04** | packaged agent and reference mirrors | file | **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** ↔ **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** | ✅ | Assessed at b8b566f: root agent sources are copied into the package mirror at prepack. |
| <a id="sm-05"></a>**SM-05** | packaged Python materializer mirror | file | **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** ↔ **[B-04](subsystems/b04-diff-aware-materializer.md)** | ✅ | Assessed at b8b566f: root materializer source is copied and the published layout is smoke-tested. |
| <a id="sm-06"></a>**SM-06** | report projection design/component contract | other | **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** ↔ **[B-04](subsystems/b04-diff-aware-materializer.md)** | ✅ | Assessed at e33bb5f under [SC-3](concerns.md#sc-3): refined coverage index, contextual identifier treatment, and prose-flow measures align; design validator and full materializer integration/red paths pass. |
| <a id="sm-07"></a>**SM-07** | reporting terminology and information-architecture contract | other | **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** ↔ **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** | ✅ | Assessed at e33bb5f under [SC-4](concerns.md#sc-4): both sides agree on sparse coverage, contextual identifier definitions, intact status labels, and 120ch/190ch prose flow. |
| <a id="sm-08"></a>**SM-08** | research-backed report design constraints | other | **[B-07](subsystems/b07-embedded-research-surveys-and-platform-trials.md)** ↔ **[B-06](subsystems/b06-report-interface-design-and-validation-studies.md)** | ✅ | Assessed at e33bb5f under [SC-5](concerns.md#sc-5): [B-06](subsystems/b06-report-interface-design-and-validation-studies.md) preserves [B-07](subsystems/b07-embedded-research-surveys-and-platform-trials.md)'s report-owned re-entry boundary, uses stricter visible copy where appropriate, and retains reader/browser/AT limitations rather than promoting evidence to an efficacy claim. |
| <a id="sm-09"></a>**SM-09** | entries table (staleness columns: stale, stale_since, stale_reason) | table | **[B-03](subsystems/b03-knowledge-tools-and-workflow-api.md)** ↔ **[B-04](subsystems/b04-diff-aware-materializer.md)** | ✅ | Assessed during the 2026-08-27 refresh under concern [VG-1](concerns.md#vg-1). The seam is broken on both sides of the same absent writer: no code path inserts into entries, so [B-03](subsystems/b03-knowledge-tools-and-workflow-api.md) publishes stale_entries=0 and an empty backlog, and [B-04](subsystems/b04-diff-aware-materializer.md) publishes an affirmative freshness sentence. Findings [B03-2](findings.md#b03-2) (inert staleness surface) and [B04-1](findings.md#b04-1) (absence rendered as health) are the two halves. Schema authority sits with [B-02](subsystems/b02-mcp-core-persistence-and-lifecycle.md), so a fix must decide whether entries is populated, whether staleness moves to a populated table such as file_ledger or subsystems, or whether the legacy surface is retired along with its public signals. |
| <a id="sm-10"></a>**SM-10** | activation contract (installation scope, skill destination, config markers) | config | **[B-01](subsystems/b01-survey-methodology-and-agent-contracts.md)** ↔ **[B-05](subsystems/b05-packaging-installer-validation-and-product-docs.md)** | ✅ | Assessed during the 2026-08-27 refresh. Verified in agreement at 5694080: scope defaults, $CODEX_HOME destinations, project-pin paths, the non-Codex --scope user rejection, and both contract markers match between setup.md and cli.ts. The agreement is currently maintained by hand; ADR-0021's A19 receipt is the closest thing to a check on it. |