<?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-05-18-2-delete-specify-cli-auth-transport/">
  <id>https://docs.spec-kitty.ai/adr/3.x/2026-05-18-2-delete-specify-cli-auth-transport/</id>
  <title>ADR 2026-05-18-2 — DELETE specify_cli.auth.transport (deferred to Robert)</title>
  <updated>2026-05-18T00: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-05-18-2-delete-specify-cli-auth-transport/"/>
  <summary>Deletes the auth transport module: it has zero production callers and its architectural gate passes vacuously, so it mediates nothing that it claims to mediate.</summary>
  <content type="html">&lt;h2 id=&quot;context&quot;&gt;Context&lt;/h2&gt;
&lt;p&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/auth/transport.py&lt;/code&gt; ships as part of the spec-kitty CLI but has
zero non-test callers in the current codebase. Verified at HEAD &lt;code dir=&quot;auto&quot;&gt;6ae8d449&lt;/code&gt;:&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&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:#82AAFF;--1:#3B61B0&quot;&gt;rg&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&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;from specify_cli.auth.transport&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;src/specify_cli/&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:#919F9F;--1:#5F636F&quot;&gt;# returns 0 matches&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 style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;rg&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&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;import specify_cli.auth.transport&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;src/specify_cli/&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:#919F9F;--1:#5F636F&quot;&gt;# returns 0 matches&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;Alternate HTTP paths exist in &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/sync/&lt;/code&gt; and
&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/tracker/&lt;/code&gt;, which use their own &lt;code dir=&quot;auto&quot;&gt;httpx.AsyncClient&lt;/code&gt; instances
directly. The &lt;code dir=&quot;auto&quot;&gt;test_auth_transport_singleton.py&lt;/code&gt; architectural gate passes
vacuously: its &lt;code dir=&quot;auto&quot;&gt;_ALLOWED_DIRECT_HTTPX_FILES&lt;/code&gt; allowlist carries 2 entries that
do not currently route through the module.&lt;/p&gt;
&lt;p&gt;This is a C4 contradiction: the module claims to mediate auth-transport but
mediates nothing. It introduces surface area (an &lt;code dir=&quot;auto&quot;&gt;AuthTransport&lt;/code&gt; singleton)
with no active enforcement.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;audit-evidence&quot;&gt;Audit Evidence&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Zero callers:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;rg &quot;from specify_cli.auth.transport&quot; src/specify_cli/&lt;/code&gt;
returns 0 matches. &lt;code dir=&quot;auto&quot;&gt;rg &quot;from .*auth.transport import\|import .*auth\.transport&quot;&lt;/code&gt;
confirms this across the full &lt;code dir=&quot;auto&quot;&gt;src/&lt;/code&gt; tree.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Vacuous singleton gate:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_auth_transport_singleton.py&lt;/code&gt;
asserts the singleton pattern and lists 2 allowed files in
&lt;code dir=&quot;auto&quot;&gt;_ALLOWED_DIRECT_HTTPX_FILES&lt;/code&gt;. Neither of those files currently routes through
the &lt;code dir=&quot;auto&quot;&gt;AuthTransport&lt;/code&gt; module; the allowlist was grandfathered from a prior
design that was never fully wired.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Sync subsystem:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/sync/&lt;/code&gt; uses its own &lt;code dir=&quot;auto&quot;&gt;httpx.AsyncClient&lt;/code&gt;
directly without going through &lt;code dir=&quot;auto&quot;&gt;AuthTransport&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Tracker subsystem:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/tracker/&lt;/code&gt; manages its own request
flow; &lt;code dir=&quot;auto&quot;&gt;AuthTransport&lt;/code&gt; is not in the call chain.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No public API surface:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/auth/__init__.py&lt;/code&gt; does not
re-export &lt;code dir=&quot;auto&quot;&gt;AuthTransport&lt;/code&gt;; it is not part of any declared public facade.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;recommendation&quot;&gt;Recommendation&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;DELETE&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/auth/transport.py&lt;/code&gt; and remove
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_auth_transport_singleton.py&lt;/code&gt; (vacuous gate).&lt;/p&gt;
&lt;p&gt;Additionally:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Remove the &lt;code dir=&quot;auto&quot;&gt;allowed_direct_httpx_files: 2&lt;/code&gt; baseline from
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/_baselines.yaml&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Update any import in &lt;code dir=&quot;auto&quot;&gt;src/specify_cli/auth/__init__.py&lt;/code&gt; that references
&lt;code dir=&quot;auto&quot;&gt;transport&lt;/code&gt; (if any).&lt;/li&gt;
&lt;li&gt;Verify the full architectural suite still passes after deletion.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&quot;deferral-rationale-hic-5a3-binding-via-c-005&quot;&gt;Deferral Rationale (HiC §5a.3, binding via C-005)&lt;/h2&gt;
&lt;p&gt;Verbatim HiC adjudication (2026-05-18):&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;“Delete, but explicitly create an ADR for it, which is to be updated mentioning
the code that is deleted, and the commit in which it happened. In general: we
want to be extremely careful with auth-path cleanup as Robert (lead maintainer)
has indicated the SaaS platform has had recent auth-related challenges. It
would be best to highlight this, add our research / evidence and
recommendations, but leave the decision and clean-up action to Robert.
(descope from our proposed mission scope, but create a ticket with our
findings).”&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Per C-005 (binding for the Slice F mission): &lt;strong&gt;Slice F MUST NOT modify
&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/auth/transport.py&lt;/code&gt; or
&lt;code dir=&quot;auto&quot;&gt;tests/architectural/test_auth_transport_singleton.py&lt;/code&gt;.&lt;/strong&gt; Deletion is Robert’s
call after reviewing this ADR and the linked GitHub ticket.&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;reserved-fields-for-robert&quot;&gt;Reserved Fields for Robert&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Deleted in commit:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;SHA&gt;&lt;/code&gt; &lt;em&gt;(to be filled when deletion happens)&lt;/em&gt;
&lt;strong&gt;Deletion PR:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;URL&gt;&lt;/code&gt; &lt;em&gt;(to be filled)&lt;/em&gt;
&lt;strong&gt;Date of deletion:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;&amp;#x3C;DATE&gt;&lt;/code&gt; &lt;em&gt;(to be filled)&lt;/em&gt;&lt;/p&gt;
&lt;hr&gt;
&lt;h2 id=&quot;related&quot;&gt;Related&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;GitHub ticket:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;Priivacy-ai/spec-kitty#1118&lt;/code&gt; — &lt;a href=&quot;https://github.com/Priivacy-ai/spec-kitty/issues/1118&quot;&gt;https://github.com/Priivacy-ai/spec-kitty/issues/1118&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;spec.md:&lt;/strong&gt; FR-200, FR-201, FR-202, C-005, AC-12, AC-13&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HiC §5a.3&lt;/strong&gt; adjudication record (verbatim above)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Slice F mission:&lt;/strong&gt; &lt;code dir=&quot;auto&quot;&gt;slice-f-multi-context-extensibility-01KRX5C8&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;WP12 close-out commit:&lt;/strong&gt; see &lt;code dir=&quot;auto&quot;&gt;git log --grep=&quot;WP12&quot;&lt;/code&gt; on lane-a branch&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
