<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/migrations/charter-ownership-consolidation/">
  <id>https://docs.spec-kitty.ai/migrations/charter-ownership-consolidation/</id>
  <title>Migration — Charter ownership consolidation</title>
  <updated>2026-06-03T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/migrations/charter-ownership-consolidation/"/>
  <summary>Migration for the charter-ownership consolidation whose shim was removed in 3.2.0: what changed and the steps required to move onto the consolidated ownership.</summary>
  <content type="html">&lt;blockquote&gt;
&lt;p&gt;Migration note: This page documents a migration path or historical transition. It is not the current 3.2 happy path.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;span id=&quot;migration--charter-ownership-consolidation&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;strong&gt;Status&lt;/strong&gt;: Shim removed in release 3.2.0. Migration required.&lt;/p&gt;
&lt;h2 id=&quot;what-changed&quot;&gt;What changed&lt;/h2&gt;
&lt;p&gt;The authoritative implementation of charter services lives under the top-level
&lt;code dir=&quot;auto&quot;&gt;charter&lt;/code&gt; package. The legacy &lt;code dir=&quot;auto&quot;&gt;specify_cli.charter&lt;/code&gt; package and its
submodules (&lt;code dir=&quot;auto&quot;&gt;compiler&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;interview&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;resolver&lt;/code&gt;) remain as thin re-export shims
for backward compatibility, with a &lt;code dir=&quot;auto&quot;&gt;DeprecationWarning&lt;/code&gt; on first import.&lt;/p&gt;
&lt;h2 id=&quot;who-is-affected&quot;&gt;Who is affected&lt;/h2&gt;
&lt;p&gt;Any downstream Python code that imports directly from &lt;code dir=&quot;auto&quot;&gt;specify_cli.charter&lt;/code&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter import build_charter_context, ensure_charter_bundle_fresh&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.compiler import &amp;#x3C;X&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.interview import &amp;#x3C;X&gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.resolver import &amp;#x3C;X&gt;&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;First-party code inside spec-kitty no longer uses these paths (three test files
are retained as deliberate compatibility exceptions per mission-internal
occurrence-map rules).&lt;/p&gt;
&lt;h2 id=&quot;what-to-do&quot;&gt;What to do&lt;/h2&gt;
&lt;p&gt;Replace the import path:&lt;/p&gt;

























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Old&lt;/th&gt;&lt;th&gt;New&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter import X&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from charter import X&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.compiler import X&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from charter.compiler import X&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.interview import X&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from charter.interview import X&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from specify_cli.charter.resolver import X&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code dir=&quot;auto&quot;&gt;from charter.resolver import X&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;No call-site or signature changes are required — the re-exports are identity
re-exports, and the submodule shims alias &lt;code dir=&quot;auto&quot;&gt;sys.modules&lt;/code&gt; to the canonical module,
so the imported symbol is the same object.&lt;/p&gt;
&lt;h2 id=&quot;timeline&quot;&gt;Timeline&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;3.1.x&lt;/strong&gt;: shims were functional; importing them emitted a
single &lt;code dir=&quot;auto&quot;&gt;DeprecationWarning&lt;/code&gt; per process pointing at the caller.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;3.2.0&lt;/strong&gt;: shim package removed. Imports from &lt;code dir=&quot;auto&quot;&gt;specify_cli.charter&lt;/code&gt; will
raise &lt;code dir=&quot;auto&quot;&gt;ModuleNotFoundError&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;how-to-silence-the-warning-temporarily&quot;&gt;How to silence the warning temporarily&lt;/h2&gt;
&lt;p&gt;If you need to quiet the warning while you migrate, the standard &lt;code dir=&quot;auto&quot;&gt;warnings&lt;/code&gt;
module controls apply:&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;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:#C792EA;--1:#8844AE&quot;&gt;import&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; warnings&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:#D6DEEB;--1:#403F53&quot;&gt;warnings.&lt;/span&gt;&lt;span style=&quot;--0:#B2CCD6;--1:#096E72&quot;&gt;filterwarnings&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:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;ignore&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&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:#D7DBE0;--1:#403F53&quot;&gt;message&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;r&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#5CA7E4;--1:#3A688F&quot;&gt;specify_cli&lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;\.&lt;/span&gt;&lt;span style=&quot;--0:#5CA7E4;--1:#3A688F&quot;&gt;charter is deprecated.&lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;*&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&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:#D7DBE0;--1:#403F53&quot;&gt;category&lt;/span&gt;&lt;span style=&quot;--0:#C792EA;--1:#8844AE&quot;&gt;=&lt;/span&gt;&lt;span style=&quot;--0:#C5E478;--1:#3B61B0&quot;&gt;DeprecationWarning&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&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 style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Prefer migrating over filtering — the filter will stop working in 3.2.0 because
the target module will be gone.&lt;/p&gt;
&lt;h2 id=&quot;questions&quot;&gt;Questions&lt;/h2&gt;
&lt;p&gt;File an issue against the &lt;code dir=&quot;auto&quot;&gt;spec-kitty&lt;/code&gt; repository with the &lt;code dir=&quot;auto&quot;&gt;charter-migration&lt;/code&gt;
label.&lt;/p&gt;</content>
</entry>
