<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/architecture/05_ownership_map/">
  <id>https://docs.spec-kitty.ai/architecture/05_ownership_map/</id>
  <title>Functional Ownership Map (demoted — narrative only)</title>
  <updated>2026-10-19T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/architecture/05_ownership_map/"/>
  <summary>Historical functional-ownership narrative. Not authoritative: module boundaries are owned by the enforced pyproject wheel packages plus the test_layer_rules layer chain.</summary>
  <content type="html">&lt;span id=&quot;functional-ownership-map-demoted--narrative-only&quot;&gt;&lt;/span&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;⚠️ Not authoritative.&lt;/strong&gt; This document is a &lt;strong&gt;historical narrative&lt;/strong&gt; of how functional
ownership was &lt;em&gt;once&lt;/em&gt; modelled (mission &lt;code dir=&quot;auto&quot;&gt;functional-ownership-map-01KPDY72&lt;/code&gt;, 2026-04). Its
machine-readable companion &lt;code dir=&quot;auto&quot;&gt;05_ownership_manifest.yaml&lt;/code&gt; and that manifest’s schema gate
(&lt;code dir=&quot;auto&quot;&gt;tests/architecture/test_ownership_manifest_schema.py&lt;/code&gt;) were &lt;strong&gt;deleted&lt;/strong&gt; by mission
&lt;code dir=&quot;auto&quot;&gt;post-convergence-governance-01M1TMPH&lt;/code&gt; (2026-09-06): the manifest had drifted from reality
(it named the deleted &lt;code dir=&quot;auto&quot;&gt;src/doctrine/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/sync/&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/saas/&lt;/code&gt;
trees and the never-created &lt;code dir=&quot;auto&quot;&gt;src/lifecycle/&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;src/orchestrator/&lt;/code&gt; targets), and its schema
gate &lt;em&gt;pinned&lt;/em&gt; that stale vocabulary — so correcting the manifest reddened the gate. Rather
than perpetuate a self-declared authority that contradicted the code, both were removed.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;the-canonical-modularity-ssot-is-the-enforced-pair&quot;&gt;The canonical modularity SSOT is the enforced pair&lt;/h2&gt;
&lt;p&gt;Module boundaries and inventory are owned by two &lt;strong&gt;enforced&lt;/strong&gt; sources that agree with each
other and with the code CI actually ships. Treat every other module map (this file, the C4
landscape/implementation-mapping docs, the &lt;code dir=&quot;auto&quot;&gt;AGENTS.md&lt;/code&gt; package lists) as a &lt;em&gt;derived view&lt;/em&gt; that
must cite them:&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Concern&lt;/th&gt;&lt;th&gt;Canonical source&lt;/th&gt;&lt;th&gt;Enforced by&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;Module &lt;strong&gt;inventory&lt;/strong&gt; (which top-level packages ship)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;[tool.hatch.build.targets.wheel].packages&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_pyproject_shape.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Import &lt;strong&gt;direction&lt;/strong&gt; (the layer chain)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/architectural/conftest.py&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;landscape&lt;/code&gt; fixture + &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_layer_rules.py&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;test_layer_rules.py&lt;/code&gt; (pytestarch &lt;code dir=&quot;auto&quot;&gt;LayerRule&lt;/code&gt; + &lt;code dir=&quot;auto&quot;&gt;TestLayerCoverage&lt;/code&gt; meta-tests + the &lt;code dir=&quot;auto&quot;&gt;mission_runtime&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;runtime&lt;/code&gt; outbound ledgers)&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Retired-subsystem &lt;strong&gt;negative&lt;/strong&gt; boundary&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt; &lt;code dir=&quot;auto&quot;&gt;[tool.ruff.lint.flake8-tidy-imports.banned-api]&lt;/code&gt; (TID251)&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_no_retired_subsystems.py&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;The enforced layer chain is:&lt;/p&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;plaintext&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:#d6deeb;--1:#403f53&quot;&gt;kernel &amp;#x3C;- charter &amp;#x3C;- {glossary, runtime, mission_runtime} &amp;#x3C;- specify_cli&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;charter.offering&lt;/code&gt; holds the doctrine code the former top-level &lt;code dir=&quot;auto&quot;&gt;src/doctrine/&lt;/code&gt; package was
relocated into (Convergence #3881); the &lt;code dir=&quot;auto&quot;&gt;src/doctrine.py&lt;/code&gt; deprecation shim was removed (#805).&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Direction (2026-10-12):&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; is slated to leave this in-tree layer chain and become
an external contract package &lt;strong&gt;in its own repository&lt;/strong&gt;, consumed through &lt;code dir=&quot;auto&quot;&gt;charter.offering.api&lt;/code&gt;
like &lt;code dir=&quot;auto&quot;&gt;spec-kitty-events&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;spec-kitty-tracker&lt;/code&gt; (ADR
&lt;a href=&quot;/adr/4.x/2026-10-12-2-charter-extraction-to-its-own-repository/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;2026-10-12-2&lt;/code&gt;&lt;/a&gt;;
precondition #645, now GA-gating). The enforced pair stays the authority; this note changes
no gate.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Superseded (2026-10-19):&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; stays in this in-tree layer chain. The Python charter
stays in core until it is retired and nothing Python moves to &lt;code dir=&quot;auto&quot;&gt;spec-kitty-charter&lt;/code&gt;; offering
reads cut over to the &lt;code dir=&quot;auto&quot;&gt;spec-kitty-charter&lt;/code&gt; service through &lt;code dir=&quot;auto&quot;&gt;charter.offering.api&lt;/code&gt;
(&lt;code dir=&quot;auto&quot;&gt;spec-kitty-charter&lt;/code&gt; ADR-0008 and ADR-0010, which supersede ADR &lt;code dir=&quot;auto&quot;&gt;2026-10-12-2&lt;/code&gt;; ADR
&lt;a href=&quot;/adr/4.x/2026-10-16-1-extract-charter-offering-first-activation-rework-post-ga/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;2026-10-16-1&lt;/code&gt;&lt;/a&gt;,
Amendment 2026-10-19).&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;hosted-client-packages-were-removed&quot;&gt;Hosted client packages were removed&lt;/h2&gt;
&lt;p&gt;The former &lt;code dir=&quot;auto&quot;&gt;zeitgeist_client/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;saas_client/&lt;/code&gt; packages were removed from open-core (#6164; the code is preserved in &lt;code dir=&quot;auto&quot;&gt;spec-kitty/event-router&lt;/code&gt;). See ADR
&lt;a href=&quot;/adr/3.x/2026-09-06-1-convergence-retirement-and-client-repo-inversion/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;2026-09-06-1-convergence-retirement-and-client-repo-inversion&lt;/code&gt;&lt;/a&gt;
and the precedent ADR
&lt;a href=&quot;/adr/3.x/2026-04-25-1-shared-package-boundary/&quot;&gt;&lt;code dir=&quot;auto&quot;&gt;2026-04-25-1-shared-package-boundary&lt;/code&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&quot;historical-note&quot;&gt;Historical note&lt;/h2&gt;
&lt;p&gt;The original slice model (&lt;code dir=&quot;auto&quot;&gt;cli_shell&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;charter_governance&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;doctrine&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;runtime_mission_execution&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;glossary&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;lifecycle_status&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;orchestrator_sync_tracker_saas&lt;/code&gt;,
&lt;code dir=&quot;auto&quot;&gt;migration_versioning&lt;/code&gt;) framed an extraction roadmap (missions #612–#615). Only glossary
(→ &lt;code dir=&quot;auto&quot;&gt;src/glossary/&lt;/code&gt;) and part of runtime (→ &lt;code dir=&quot;auto&quot;&gt;src/runtime/next/&lt;/code&gt;) were extracted; the
&lt;code dir=&quot;auto&quot;&gt;src/lifecycle/&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;src/orchestrator/&lt;/code&gt; targets were never created, and the sync/saas slice
was retired outright by the Convergence. Consult git history for the pre-2026-09-06 slice
detail; do not treat it as a current statement of ownership.&lt;/p&gt;</content>
</entry>
