<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/adr/3.x/2026-04-17-1-charter-synthesizer-adapter-seam/">
  <id>https://docs.spec-kitty.ai/adr/3.x/2026-04-17-1-charter-synthesizer-adapter-seam/</id>
  <title>Charter Synthesizer — Adapter Seam and Provenance Identity</title>
  <updated>2026-04-17T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/adr/3.x/2026-04-17-1-charter-synthesizer-adapter-seam/"/>
  <summary>Defines the synthesizer adapter as a runtime-checkable protocol with optional batch generation, isolating non-deterministic prose behind a deterministic pipeline.</summary>
  <content type="html">&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;Phase 3 introduces a Charter Synthesizer that turns interview answers, shipped doctrine, and the shipped Doctrine Reference Graph (DRG) into project-local artifacts. The actual prose generation step is model-driven and therefore non-deterministic in production. The rest of the pipeline — input normalization, target selection, write staging, validation, path-guard enforcement, topic resolution, manifest commit — must be fully deterministic and testable offline.&lt;/p&gt;
&lt;p&gt;This creates a fundamental split: the orchestration layer must be separated from the generation step by a narrow, stable interface. If the seam leaks — carrying prompt-engineering logic, retry policy, or model parameters into orchestration — determinism erodes and CI confidence in the deterministic surface collapses.&lt;/p&gt;
&lt;p&gt;Three questions needed answers before WP3.1 implementation:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Q1 (Adapter shape)&lt;/strong&gt;: What is the minimal synchronous interface that supports both fixture-backed testing and production model calls without leaking generation concerns into orchestration?&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q2 (Provenance identity)&lt;/strong&gt;: When long-lived adapters rotate their underlying model, how does provenance remain trustworthy without breaking determinism guarantees?&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Q3 (Fixture keying)&lt;/strong&gt;: How do we key fixture files so that semantically identical requests produce the same fixture path, and different requests (or different adapter versions) produce different paths?&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;The test suite must never make live model calls — 100% fixture-backed (C-003, FR-004).&lt;/li&gt;
&lt;li&gt;The adapter interface must be swappable without changes to orchestration code (FR-003).&lt;/li&gt;
&lt;li&gt;Provenance must record effective adapter identity per call, not just registered adapter identity (FR-006).&lt;/li&gt;
&lt;li&gt;Fixture-hash stability must be guaranteed across runs for identical semantic inputs (FR-014, NFR-006, R-8).&lt;/li&gt;
&lt;li&gt;Synchronous only — no asyncio introduction in this tranche (KD-3 constraint).&lt;/li&gt;
&lt;li&gt;Changes to this contract after WP3.1 lands require an ADR amendment (DIRECTIVE_003).&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;h3 id=&quot;q1--adapter-shape&quot;&gt;Q1 — Adapter shape&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Option A (chosen):&lt;/strong&gt; Minimal synchronous Protocol with required &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; and optional &lt;code dir=&quot;auto&quot;&gt;generate_batch&lt;/code&gt;. Orchestration detects batch support via &lt;code dir=&quot;auto&quot;&gt;hasattr&lt;/code&gt; at runtime.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option B:&lt;/strong&gt; Abstract base class (ABC) with &lt;code dir=&quot;auto&quot;&gt;@abstractmethod generate&lt;/code&gt;. Requires adapters to subclass; breaks structural typing.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option C:&lt;/strong&gt; Single &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; function (no batch). No efficiency path for adapters that support native batch calls.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option D:&lt;/strong&gt; Async Protocol. Requires asyncio plumbing throughout orchestration; deferred to a future tranche if needed.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;q2--provenance-identity&quot;&gt;Q2 — Provenance identity&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Option A (chosen):&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;AdapterOutput&lt;/code&gt; carries optional &lt;code dir=&quot;auto&quot;&gt;adapter_id_override&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;adapter_version_override&lt;/code&gt;. Orchestration uses override-first; fallback to &lt;code dir=&quot;auto&quot;&gt;adapter.id&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;adapter.version&lt;/code&gt;. Provenance always records the &lt;em&gt;effective&lt;/em&gt; identity.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option B:&lt;/strong&gt; Adapter stamps provenance directly. Leaks provenance concerns into the adapter; orchestration loses control of the provenance record.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option C:&lt;/strong&gt; Ignore per-call overrides; always use registered identity. Silently produces incorrect provenance when models rotate.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;q3--fixture-keying&quot;&gt;Q3 — Fixture keying&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Option A (chosen):&lt;/strong&gt; Hash &lt;code dir=&quot;auto&quot;&gt;(target, interview_snapshot, doctrine_snapshot, drg_snapshot, adapter_hints, adapter_id, adapter_version)&lt;/code&gt; with sorted-key canonical JSON, excluding &lt;code dir=&quot;auto&quot;&gt;run_id&lt;/code&gt;. SHA-256 (stdlib). Short hash = first 12 hex chars. Layout: &lt;code dir=&quot;auto&quot;&gt;tests/charter/fixtures/synthesizer/&amp;#x3C;kind&gt;/&amp;#x3C;slug&gt;/&amp;#x3C;short_hash&gt;.&amp;#x3C;kind&gt;.yaml&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option B:&lt;/strong&gt; Hash full request including &lt;code dir=&quot;auto&quot;&gt;run_id&lt;/code&gt;. Each run produces a different fixture path for identical inputs — fixture files multiply unboundedly. Rejected.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option C:&lt;/strong&gt; Hash only &lt;code dir=&quot;auto&quot;&gt;(kind, slug)&lt;/code&gt;. No adapter-version distinction; two adapter versions cannot coexist in the fixture set. Rejected.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option D:&lt;/strong&gt; Content-addressed fixtures (hash the output body). Requires recording the body before the fixture exists — circular. Rejected.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen options:&lt;/strong&gt; A for all three questions.&lt;/p&gt;
&lt;h3 id=&quot;protocol-shape-q1&quot;&gt;Protocol shape (Q1)&lt;/h3&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;python&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;@runtime_checkable&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;class&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#FFCB8B;--1:#111111&quot;&gt;SynthesisAdapter&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;Protocol&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;id&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;    &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;version: &lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;str&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;def&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;generate&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;(&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;self&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;, &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;request&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: SynthesisRequest&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;)&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; -&gt; AdapterOutput: &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# Optional (detected via hasattr at runtime):&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5F636F&quot;&gt;# def generate_batch(self, requests: Sequence[SynthesisRequest]) -&gt; Sequence[AdapterOutput]: ...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;@runtime_checkable&lt;/code&gt; enables &lt;code dir=&quot;auto&quot;&gt;isinstance(adapter, SynthesisAdapter)&lt;/code&gt; in conformance tests without requiring adapters to subclass.&lt;/p&gt;
&lt;p&gt;Orchestration uses &lt;code dir=&quot;auto&quot;&gt;generate_batch&lt;/code&gt; when present (&lt;code dir=&quot;auto&quot;&gt;hasattr(adapter, &quot;generate_batch&quot;)&lt;/code&gt;); falls back to sequential &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; otherwise. Neither path changes the orchestration contract.&lt;/p&gt;
&lt;h3 id=&quot;provenance-identity-q2&quot;&gt;Provenance identity (Q2)&lt;/h3&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;AdapterOutput&lt;/code&gt; carries:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;adapter_id_override: str | None&lt;/code&gt; — optional per-call identity override&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;adapter_version_override: str | None&lt;/code&gt; — optional per-call version override&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Orchestration records &lt;code dir=&quot;auto&quot;&gt;adapter_id_override or adapter.id&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;adapter_version_override or adapter.version&lt;/code&gt; in provenance. This makes model rotation visible in provenance without requiring adapters to register new identities.&lt;/p&gt;
&lt;h3 id=&quot;fixture-keying-q3&quot;&gt;Fixture keying (Q3)&lt;/h3&gt;
&lt;p&gt;Normalized bytes = canonical JSON over &lt;code dir=&quot;auto&quot;&gt;{adapter_id, adapter_version, target, interview_snapshot, doctrine_snapshot, drg_snapshot, adapter_hints}&lt;/code&gt; with sorted keys at every nesting level, stable float repr, &lt;code dir=&quot;auto&quot;&gt;run_id&lt;/code&gt; excluded.&lt;/p&gt;
&lt;p&gt;Hash = SHA-256 over normalized bytes. Short hash = first 12 hex chars (48 bits collision resistance in &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;kind&gt;/&amp;#x3C;slug&gt;/&lt;/code&gt; namespace).&lt;/p&gt;
&lt;p&gt;Fixture path = &lt;code dir=&quot;auto&quot;&gt;tests/charter/fixtures/synthesizer/&amp;#x3C;kind&gt;/&amp;#x3C;slug&gt;/&amp;#x3C;short_hash&gt;.&amp;#x3C;kind&gt;.yaml&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;The &lt;code dir=&quot;auto&quot;&gt;.&amp;#x3C;kind&gt;.yaml&lt;/code&gt; suffix matches the shipped repository glob so fixtures round-trip through the same loaders.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;normalize_request_for_hash()&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;src/charter/synthesizer/request.py&lt;/code&gt; is the sole, canonical source of fixture-hash bytes. Changing it changes every fixture hash — treat as a breaking change and amend this ADR.&lt;/strong&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;consequences&quot;&gt;Consequences&lt;/h2&gt;
&lt;h3 id=&quot;positive&quot;&gt;Positive&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Zero asyncio surface added — orchestration is simpler and CI does not need event-loop plumbing.&lt;/li&gt;
&lt;li&gt;Protocol (not ABC) enables duck-typing — any object with &lt;code dir=&quot;auto&quot;&gt;id&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;version&lt;/code&gt;, and &lt;code dir=&quot;auto&quot;&gt;generate&lt;/code&gt; is a valid adapter. No inheritance boilerplate.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;hasattr&lt;/code&gt;-based batch detection means batch-capable adapters self-declare without requiring Protocol sub-specialization. Orchestration code has one &lt;code dir=&quot;auto&quot;&gt;if hasattr&lt;/code&gt; branch, not an elaborate dispatch tree.&lt;/li&gt;
&lt;li&gt;Override-first provenance makes model rotation fully observable without manual provenance entry updates.&lt;/li&gt;
&lt;li&gt;Fixture keying is stable across runs for identical inputs, making fixture-authoring ergonomic: “run once, check in the printed path”.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;negative&quot;&gt;Negative&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;hasattr&lt;/code&gt; detection is not type-safe — mypy cannot verify the batch branch signature. Mitigated by &lt;code dir=&quot;auto&quot;&gt;BatchCapableSynthesisAdapter&lt;/code&gt; Protocol in &lt;code dir=&quot;auto&quot;&gt;adapter.py&lt;/code&gt; (documentation / static-analysis aid).&lt;/li&gt;
&lt;li&gt;Short-hash collisions (12 hex = 48 bits) are astronomically unlikely per &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;kind&gt;/&amp;#x3C;slug&gt;/&lt;/code&gt; but not impossible. Not a security concern; collision would produce an incorrect fixture load — detected at test time.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;neutral&quot;&gt;Neutral&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;Changing &lt;code dir=&quot;auto&quot;&gt;normalize_request_for_hash()&lt;/code&gt; requires an ADR amendment (this document). That is the intended friction — the function is load-bearing for fixture stability.&lt;/li&gt;
&lt;li&gt;SHA-256 (stdlib) is used in place of blake3. The charter package’s &lt;code dir=&quot;auto&quot;&gt;hasher.py&lt;/code&gt; already uses SHA-256 via hashlib; using the same approach avoids introducing a new dependency for no material benefit at this scale.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;conformance-contract&quot;&gt;Conformance Contract&lt;/h2&gt;
&lt;p&gt;The contract file at &lt;code dir=&quot;auto&quot;&gt;kitty-specs/phase-3-charter-synthesizer-pipeline-01KPE222/contracts/adapter.py&lt;/code&gt; and the implementation at &lt;code dir=&quot;auto&quot;&gt;src/charter/synthesizer/adapter.py&lt;/code&gt; MUST expose structurally identical shapes. &lt;code dir=&quot;auto&quot;&gt;tests/charter/synthesizer/test_adapter_contract.py::test_contract_structural_equivalence&lt;/code&gt; verifies this at runtime.&lt;/p&gt;
&lt;p&gt;Changes to either file require a synchronised update to both, plus an amendment to this ADR.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;related-decisions&quot;&gt;Related Decisions&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;ADR-2026-04-17-2&lt;/strong&gt; — Atomicity model (stage + ordered promote + manifest-last).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;ADR-6 (#521)&lt;/strong&gt; — Synthesizer model selection (production adapter policy; not authored by this mission).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;DIRECTIVE_003&lt;/strong&gt; — Decision documentation policy (requires ADR for load-bearing decisions).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;KD-1&lt;/strong&gt; — Module ownership (all synthesizer code under &lt;code dir=&quot;auto&quot;&gt;src/charter/synthesizer/&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;KD-5&lt;/strong&gt; — Path guard (write seam).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;KD-6&lt;/strong&gt; — ADR schedule (this ADR and ADR-2026-04-17-2 gate WP3.1 merge).&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;more-information&quot;&gt;More Information&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Plan: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/phase-3-charter-synthesizer-pipeline-01KPE222/plan.md&lt;/code&gt; §KD-3, §KD-4&lt;/li&gt;
&lt;li&gt;Data model: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/phase-3-charter-synthesizer-pipeline-01KPE222/data-model.md&lt;/code&gt; §E-1, §E-2, §E-3&lt;/li&gt;
&lt;li&gt;Contract: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/phase-3-charter-synthesizer-pipeline-01KPE222/contracts/adapter.py&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Research: &lt;code dir=&quot;auto&quot;&gt;kitty-specs/phase-3-charter-synthesizer-pipeline-01KPE222/research.md&lt;/code&gt; §R-0-6&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;amendment-2026-10-19-styleguide-source-urns-enter-the-request-hash-6442&quot;&gt;Amendment 2026-10-19: styleguide source URNs enter the request hash (#6442)&lt;/h2&gt;
&lt;p&gt;A synthesized &lt;code dir=&quot;auto&quot;&gt;testing_philosophy&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;quality_gates&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;documentation_policy&lt;/code&gt; styleguide now carries a &lt;code dir=&quot;auto&quot;&gt;source_urns&lt;/code&gt; entry naming its directive (DIRECTIVE_034, DIRECTIVE_030, DIRECTIVE_037), present only when that directive is in the run’s DRG snapshot. &lt;code dir=&quot;auto&quot;&gt;target&lt;/code&gt; is a hashed input, so the request hash of a sourced styleguide target differs from that of the same target without a source. No checked-in fixture under &lt;code dir=&quot;auto&quot;&gt;tests/charter/fixtures/synthesizer/styleguide/&lt;/code&gt; is keyed on a sourced request, so none was re-keyed; a fixture recorded for a sourced styleguide is keyed on the new hash. &lt;code dir=&quot;auto&quot;&gt;normalize_request_for_hash()&lt;/code&gt; itself is unchanged: the hash rule is the same, only the hashed values differ. Tactic, directive and &lt;code dir=&quot;auto&quot;&gt;language_scope&lt;/code&gt; styleguide hashes are unaffected.&lt;/p&gt;
&lt;h2 id=&quot;amendment-2026-10-19-observed-languages-enter-the-evidence-hash-only-for-polyglot-repositories-6444&quot;&gt;Amendment 2026-10-19: observed &lt;code dir=&quot;auto&quot;&gt;languages&lt;/code&gt; enter the evidence hash only for polyglot repositories (#6444)&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;CodeSignals&lt;/code&gt; gains &lt;code dir=&quot;auto&quot;&gt;languages&lt;/code&gt; (every observed language, primary first). &lt;code dir=&quot;auto&quot;&gt;_evidence_to_jsonable()&lt;/code&gt; adds &lt;code dir=&quot;auto&quot;&gt;code_signals.languages&lt;/code&gt; to the hashed evidence only when it holds more than one language, so the evidence hash of every single-language repository, and any provenance recorded against it, is unchanged (pinned by &lt;code dir=&quot;auto&quot;&gt;tests/charter/synthesizer/test_multi_language_evidence.py::test_single_language_evidence_hash_is_pinned&lt;/code&gt;). A polyglot repository hashes differently from before, as it now carries &lt;code dir=&quot;auto&quot;&gt;languages&lt;/code&gt;. A Kotlin repository also changes hash even when it is the only language, because its primary language changes from &lt;code dir=&quot;auto&quot;&gt;java&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;kotlin&lt;/code&gt; (FR-013, #6444). &lt;code dir=&quot;auto&quot;&gt;normalize_request_for_hash()&lt;/code&gt; itself is unchanged: the hash rule is the same, only the hashed values differ. The inclusion threshold for a language without a top-depth manifest is a 20% share of counted sources (&lt;code dir=&quot;auto&quot;&gt;_LANGUAGE_SHARE_THRESHOLD&lt;/code&gt; in &lt;code dir=&quot;auto&quot;&gt;charter.activation.language_authority&lt;/code&gt;).&lt;/p&gt;</content>
</entry>
