<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/changelog/release-notes-3.2.6rc1/">
  <id>https://docs.spec-kitty.ai/changelog/release-notes-3.2.6rc1/</id>
  <title>Release notes — 3.2.6rc1 (internal Release Candidate)</title>
  <updated>2026-09-03T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/changelog/release-notes-3.2.6rc1/"/>
  <summary>Internal Release Candidate notes for spec-kitty-cli 3.2.6rc1: an opt-in prerelease build for maintainer validation, not an official 3.2.6 release.</summary>
  <content type="html">&lt;span id=&quot;release-notes--326rc1-internal-release-candidate&quot;&gt;&lt;/span&gt;
&lt;p&gt;&lt;em&gt;For the existing Spec Kitty operator/maintainer deciding whether to pull this candidate into a test environment.&lt;/em&gt;&lt;/p&gt;
&lt;aside aria-label=&quot;Warning&quot; class=&quot;starlight-aside starlight-aside--caution&quot;&gt;&lt;p class=&quot;starlight-aside__title&quot; aria-hidden=&quot;true&quot;&gt;&lt;svg viewBox=&quot;0 0 24 24&quot; width=&quot;16&quot; height=&quot;16&quot; fill=&quot;currentColor&quot; class=&quot;starlight-aside__icon&quot;&gt;&lt;path d=&quot;M12 16a1 1 0 1 0 0 2 1 1 0 0 0 0-2Zm10.67 1.47-8.05-14a3 3 0 0 0-5.24 0l-8 14A3 3 0 0 0 3.94 22h16.12a3 3 0 0 0 2.61-4.53Zm-1.73 2a1 1 0 0 1-.88.51H3.94a1 1 0 0 1-.88-.51 1 1 0 0 1 0-1l8-14a1 1 0 0 1 1.78 0l8.05 14a1 1 0 0 1 .05 1.02v-.02ZM12 8a1 1 0 0 0-1 1v4a1 1 0 0 0 2 0V9a1 1 0 0 0-1-1Z&quot;&gt;&lt;/path&gt;&lt;/svg&gt;Warning&lt;/p&gt;&lt;div class=&quot;starlight-aside__content&quot;&gt;&lt;p&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;3.2.6rc1&lt;/code&gt; is a Release Candidate — an internal, delta build published for validation, NOT an official &lt;code dir=&quot;auto&quot;&gt;3.2.6&lt;/code&gt; release.&lt;/strong&gt; It ships as a GitHub &lt;em&gt;prerelease&lt;/em&gt; and to PyPI as a PEP 440 prerelease, so ordinary installers skip it unless you explicitly opt in with &lt;code dir=&quot;auto&quot;&gt;--pre&lt;/code&gt;. Do &lt;strong&gt;not&lt;/strong&gt; use it for production or general rollout. The last official release remains &lt;code dir=&quot;auto&quot;&gt;v3.2.5&lt;/code&gt;; when &lt;code dir=&quot;auto&quot;&gt;3.2.6&lt;/code&gt; is finalized its changelog section supersedes this candidate.&lt;/p&gt;&lt;/div&gt;&lt;/aside&gt;
&lt;aside aria-label=&quot;Note&quot; class=&quot;starlight-aside starlight-aside--note&quot;&gt;&lt;p class=&quot;starlight-aside__title&quot; aria-hidden=&quot;true&quot;&gt;&lt;svg viewBox=&quot;0 0 24 24&quot; width=&quot;16&quot; height=&quot;16&quot; fill=&quot;currentColor&quot; class=&quot;starlight-aside__icon&quot;&gt;&lt;path d=&quot;M12 11a1 1 0 0 0-1 1v4a1 1 0 0 0 2 0v-4a1 1 0 0 0-1-1Zm.38-3.92a1 1 0 0 0-.76 0 1 1 0 0 0-.33.21 1.15 1.15 0 0 0-.21.33 1 1 0 0 0 .21 1.09c.097.088.209.16.33.21A1 1 0 0 0 13 8a1.05 1.05 0 0 0-.29-.71 1 1 0 0 0-.33-.21ZM12 2a10 10 0 1 0 0 20 10 10 0 0 0 0-20Zm0 18a8 8 0 1 1 0-16.001A8 8 0 0 1 12 20Z&quot;&gt;&lt;/path&gt;&lt;/svg&gt;Note&lt;/p&gt;&lt;div class=&quot;starlight-aside__content&quot;&gt;&lt;p&gt;&lt;strong&gt;Update 2026-09-03 — the release-critical work that remained after this candidate has fully landed.&lt;/strong&gt; At rc1 time, a set of release-blocking bugs (the 3.2.6 execution DAG, tracker #3692) still gated the final tag. That book is now empty — all twenty DAG nodes are closed, #3692 is closed, and the milestone stands at 0 remaining work items. This candidate’s highlights below are the rc1 snapshot; the finalized &lt;code dir=&quot;auto&quot;&gt;3.2.6&lt;/code&gt; changelog section is the authoritative record of everything the release ships.&lt;/p&gt;&lt;/div&gt;&lt;/aside&gt;
&lt;h2 id=&quot;install-for-testing&quot;&gt;Install for testing&lt;/h2&gt;
&lt;p&gt;This candidate is opt-in. Standard installs will not pick it up without &lt;code dir=&quot;auto&quot;&gt;--pre&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;pipx&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;install&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;--pre&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;spec-kitty-cli==3.2.6rc1&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;# or, inside an existing environment:&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:#82AAFF;--1:#3B61B0&quot;&gt;pip&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;install&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;--pre&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;spec-kitty-cli==3.2.6rc1&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;h2 id=&quot;highlights-since-v325&quot;&gt;Highlights since &lt;code dir=&quot;auto&quot;&gt;v3.2.5&lt;/code&gt;&lt;/h2&gt;
&lt;p&gt;The operator-facing changes worth exercising in this candidate:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Breaking — built-in doctrine content relocated to &lt;code dir=&quot;auto&quot;&gt;packs/built-in/&lt;/code&gt; with no compatibility shim&lt;/strong&gt; (mission &lt;code dir=&quot;auto&quot;&gt;relocate-builtin-doctrine-packs&lt;/code&gt;). Repoint any reference that still targets the old &lt;code dir=&quot;auto&quot;&gt;src/doctrine/&amp;#x3C;kind&gt;/built-in/&lt;/code&gt; path.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Breaking — local &lt;code dir=&quot;auto&quot;&gt;beads&lt;/code&gt;/&lt;code dir=&quot;auto&quot;&gt;fp&lt;/code&gt; tracker sync now requires a recorded egress decision&lt;/strong&gt; (mission &lt;code dir=&quot;auto&quot;&gt;tracker-egress-refusal-3108&lt;/code&gt;). A binding that never recorded hosted-sync consent stops syncing on upgrade until you record &lt;code dir=&quot;auto&quot;&gt;tracker.egress: permitted&lt;/code&gt; or &lt;code dir=&quot;auto&quot;&gt;sync.enabled: true&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Breaking — the &lt;code dir=&quot;auto&quot;&gt;rtk-search-tooling&lt;/code&gt; toolguide is removed&lt;/strong&gt;, and the &lt;code dir=&quot;auto&quot;&gt;3.2.6_retire_rtk_search_tooling&lt;/code&gt; upgrade migration strips it from projects that had it activated (it runs automatically on &lt;code dir=&quot;auto&quot;&gt;spec-kitty upgrade&lt;/code&gt; and is safe to re-run).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Breaking — org packs with an unrecognised agent-profile or DRG key now fail to load&lt;/strong&gt; (mission &lt;code dir=&quot;auto&quot;&gt;doctrine-silence-guards&lt;/code&gt;). Run &lt;code dir=&quot;auto&quot;&gt;spec-kitty doctor doctrine --json&lt;/code&gt; and check &lt;code dir=&quot;auto&quot;&gt;skipped_profiles&lt;/code&gt; before you upgrade.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code dir=&quot;auto&quot;&gt;charter synthesize&lt;/code&gt; is now non-destructive&lt;/strong&gt; — it preserves backed governance content by default, with &lt;code dir=&quot;auto&quot;&gt;--prune&lt;/code&gt; as the explicit opt-in and &lt;code dir=&quot;auto&quot;&gt;--dry-run&lt;/code&gt; to preview (mission &lt;code dir=&quot;auto&quot;&gt;charter-synthesize-reconciliation&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;#3270&lt;/code&gt; P0, folds &lt;code dir=&quot;auto&quot;&gt;#2777&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;#3052&lt;/code&gt;). The &lt;code dir=&quot;auto&quot;&gt;implement&lt;/code&gt; / &lt;code dir=&quot;auto&quot;&gt;next&lt;/code&gt; boundary no longer hard-blocks until you resynthesize.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Approving a work package after a rejection now sticks with no override flag required&lt;/strong&gt; (mission &lt;code dir=&quot;auto&quot;&gt;review-verdict-write-integrity&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;#3044&lt;/code&gt;) — the reject → fix → approve cycle no longer forces &lt;code dir=&quot;auto&quot;&gt;--skip-review-artifact-check&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Timestamps Spec Kitty writes into your project are now correct aware-UTC&lt;/strong&gt; instead of local time mislabelled as UTC (mission &lt;code dir=&quot;auto&quot;&gt;kernel-clock-single-door&lt;/code&gt;; &lt;code dir=&quot;auto&quot;&gt;#3305&lt;/code&gt;, closes &lt;code dir=&quot;auto&quot;&gt;#3289&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CLI UX: shell autocompletion, a &lt;code dir=&quot;auto&quot;&gt;-h&lt;/code&gt; short-help alias, and alphabetical command listing&lt;/strong&gt; (&lt;code dir=&quot;auto&quot;&gt;#2232&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;#2234&lt;/code&gt;, &lt;code dir=&quot;auto&quot;&gt;#2235&lt;/code&gt;) — additive, with no behavior change to existing commands.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;full-changelog&quot;&gt;Full changelog&lt;/h2&gt;
&lt;p&gt;These highlights are a curated subset. For the complete, factual list of everything in this candidate — every Added, Fixed, Changed, and Breaking Changes entry — see the &lt;code dir=&quot;auto&quot;&gt;[3.2.6rc1]&lt;/code&gt; section of the &lt;a href=&quot;/changelog/CHANGELOG/&quot;&gt;canonical changelog&lt;/a&gt;.&lt;/p&gt;</content>
</entry>
