datlechin · Oct 18, 2026 · Oct 17, 2026 · Oct 18, 2026
diff --git a/.claude/rules/plugin-system.md b/.claude/rules/plugin-system.md
@@ -24,9 +24,10 @@ TableProPluginKit is built with Library Evolution, so an already-built plugin ke
 - Add a requirement only with a default implementation, then bridge it in `PluginDriverAdapter`.
 - Additive: a new requirement with a default, a new field on a non-`@frozen` struct, a new case on a non-`@frozen` enum, a reordering.
 - Breaking: a changed, removed or renamed requirement or signature, a requirement without a default, a new case on a `@frozen` enum, a change to a frozen type's layout.
-- Every ABI change bumps `currentPluginKitVersion` (in `PluginManager.swift`) and `TableProPluginKitVersion` in every plugin `Info.plist`, at most once per release cycle: later changes in the cycle reuse the pending number. `scripts/ci/check-pluginkit-bump-cadence.py` checks it in Repo Hygiene.
+- Every ABI change bumps `TABLEPRO_PLUGINKIT_VERSION` in `Configs/PluginKit.xcconfig`, at most once per release cycle: later changes in the cycle reuse the pending number. `scripts/ci/check-pluginkit-bump-cadence.py` checks it in Repo Hygiene.
+- The build stamps that value into `TableProPluginKitVersion` of the app and of every plugin. A plugin's `Info.plist` holds `<integer>TABLEPRO_PLUGINKIT_VERSION</integer>` and is preprocessed, because every shipped app reads the key with `as? Int`; the source file therefore fails `plutil -lint`.
 - An additive change re-publishes nothing. Built plugins keep loading, and the bump makes an older app refuse a plugin rebuilt against the new API instead of failing its load.
-- A breaking change also raises `minimumCompatiblePluginKitVersion`, and every registry plugin is re-released with `scripts/release-all-plugins.sh <version>` before the app tag, because the release's `Registry Readiness` job fails while a registry driver has no binary in the app's kit range (`RELEASING.md`, The release pipeline).
+- A breaking change also raises `TABLEPRO_PLUGINKIT_MINIMUM_VERSION`, and every registry plugin is re-released with `scripts/release-all-plugins.sh <version>` before the app tag, because the release's `Registry Readiness` job fails while a registry driver has no binary in the app's kit range (`RELEASING.md`, The release pipeline).
 - Check with `verify.sh abi <merge-base>` (`scripts/check-pluginkit-abi.sh`). It builds PluginKit at HEAD and at the base with the same toolchain and diffs the public `.swiftinterface`. A base with no interface passes; a diff prints the additive and breaking rules and exits 1.
 - It refuses uncommitted changes, so run it after the commit and before the push. No workflow runs it.
 - The diff is textual, so a `-` line can be a declaration that moved. Only a removed line with no matching added line, or a requirement added without a default, is breaking. This lists the removed lines that do not come back:

diff --git a/.github/workflows/build-plugin.yml b/.github/workflows/build-plugin.yml
@@ -8,7 +8,7 @@ on:
       tags:
         description: >
           Comma-separated plugin tag:pluginKitVersion pairs.
-          pluginKitVersion defaults to currentPluginKitVersion from PluginManager.swift.
+          pluginKitVersion defaults to TABLEPRO_PLUGINKIT_VERSION from Configs/PluginKit.xcconfig.
           Examples: plugin-mongodb-v1.0.25, plugin-mongodb-v1.0.25:13
         required: true
         type: string
@@ -21,7 +21,7 @@ on:
         required: false
         type: string
 
-# Declared per job rather than here. resolve-tags reads two integers out of a Swift file and needs
+# Declared per job rather than here. resolve-tags reads an integer out of an xcconfig and needs
 # nothing, and a workflow-level grant hands it a write token it has no use for.
 permissions:
   contents: read
@@ -66,18 +66,17 @@ jobs:
       - name: Check the plugin manifest against the plugin classes
         run: python3 scripts/ci/check-plugin-manifest.py
 
-      - name: Read currentPluginKitVersion
+      - name: Read the PluginKit version
         id: pkv
         run: |
-          VERSION=$(grep -E 'static let currentPluginKitVersion\s*=\s*[0-9]+' \
-            TablePro/Core/Plugins/PluginManager.swift \
-            | grep -oE '[0-9]+$' | head -1)
+          VERSION=$(sed -nE 's/^TABLEPRO_PLUGINKIT_VERSION[[:space:]]*=[[:space:]]*([0-9]+)[[:space:]]*$/\1/p' \
+            Configs/PluginKit.xcconfig)
           if [ -z "$VERSION" ]; then
-            echo "::error::Could not parse currentPluginKitVersion from PluginManager.swift"
+            echo "::error::Could not parse TABLEPRO_PLUGINKIT_VERSION from Configs/PluginKit.xcconfig"
             exit 1
           fi
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "currentPluginKitVersion=$VERSION"
+          echo "TABLEPRO_PLUGINKIT_VERSION=$VERSION"
 
       - name: Build matrix
         id: tags

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -185,7 +185,7 @@ jobs:
             build/Release/TablePro-*.dmg
             build/Release/TablePro-*.tar.xz
 
-  # Reads two integers out of a Swift file and fetches a JSON manifest, so it wants nothing
+  # Reads two integers out of an xcconfig and fetches a JSON manifest, so it wants nothing
   # from macOS and does not need to spend a macOS runner minute (billed at ten times Linux).
   registry-readiness:
     name: Registry Readiness
@@ -199,9 +199,9 @@ jobs:
 
       - name: Verify registry has compatible plugin binaries
         run: |
-          MANAGER="TablePro/Core/Plugins/PluginManager.swift"
-          CURRENT=$(grep -E 'static let currentPluginKitVersion = ' "$MANAGER" | grep -oE '[0-9]+' | head -1)
-          FLOOR=$(grep -E 'static let minimumCompatiblePluginKitVersion = ' "$MANAGER" | grep -oE '[0-9]+' | head -1)
+          CONFIG="Configs/PluginKit.xcconfig"
+          CURRENT=$(sed -nE 's/^TABLEPRO_PLUGINKIT_VERSION[[:space:]]*=[[:space:]]*([0-9]+)[[:space:]]*$/\1/p' "$CONFIG")
+          FLOOR=$(sed -nE 's/^TABLEPRO_PLUGINKIT_MINIMUM_VERSION[[:space:]]*=[[:space:]]*([0-9]+)[[:space:]]*$/\1/p' "$CONFIG")
           echo "PluginKit floor=$FLOOR current=$CURRENT"
           python3 scripts/check-registry-readiness.py --floor "$FLOOR" --current "$CURRENT"
 

diff --git a/Configs/Base.xcconfig b/Configs/Base.xcconfig
@@ -2,6 +2,8 @@
 // Structure rule: project-wide and per-configuration settings live in Configs/*.xcconfig.
 // Per-target settings live in project.yml, where the target templates are.
 
+#include "PluginKit.xcconfig"
+
 ALWAYS_SEARCH_USER_PATHS = NO
 ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES
 CLANG_ANALYZER_NONNULL = YES
@@ -60,10 +62,9 @@ STRINGS_FILE_OUTPUT_ENCODING = binary
 SWIFT_VERSION = 6.0
 CODE_SIGN_STYLE = Automatic
 
-// Signing knobs. Only the two app targets read them, so plugin bundles and the helper
-// tool sign ad-hoc and a contributor without the official team can still build everything.
-// A contributor overrides these in Configs/Secrets.xcconfig without touching a tracked file,
-// and the release scripts pass their own values on the xcodebuild command line.
+// Signing knobs. The app targets and the plugin bundles sign with this team; the helper tool
+// signs ad hoc. A contributor overrides these in Configs/Secrets.xcconfig without touching a
+// tracked file, and the release scripts pass their own values on the xcodebuild command line.
 TABLEPRO_DEVELOPMENT_TEAM = D7HJ5TFYCU
 TABLEPRO_APP_BUNDLE_IDENTIFIER = com.TablePro
 

diff --git a/Configs/PluginKit.xcconfig b/Configs/PluginKit.xcconfig
@@ -0,0 +1,3 @@
+// When to raise each, and how the build stamps them: .claude/rules/plugin-system.md, ABI.
+TABLEPRO_PLUGINKIT_VERSION = 39
+TABLEPRO_PLUGINKIT_MINIMUM_VERSION = 19
diff --git a/Plugins/BeancountDriverPlugin/Info.plist b/Plugins/BeancountDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Beancount</string>

diff --git a/Plugins/BigQueryDriverPlugin/Info.plist b/Plugins/BigQueryDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/BigtableDriverPlugin/Info.plist b/Plugins/BigtableDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Bigtable</string>

diff --git a/Plugins/CSVExportPlugin/Info.plist b/Plugins/CSVExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>csv</string>

diff --git a/Plugins/CSVImportPlugin/Info.plist b/Plugins/CSVImportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesImportFormatIds</key>
 	<array>
 		<string>csv</string>

diff --git a/Plugins/CassandraDriverPlugin/Info.plist b/Plugins/CassandraDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/ClickHouseDriverPlugin/Info.plist b/Plugins/ClickHouseDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>ClickHouse</string>

diff --git a/Plugins/CloudflareD1DriverPlugin/Info.plist b/Plugins/CloudflareD1DriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/CloudflareR2SQLDriverPlugin/Info.plist b/Plugins/CloudflareR2SQLDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Cloudflare R2 SQL</string>

diff --git a/Plugins/DamengDriverPlugin/Info.plist b/Plugins/DamengDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Dameng</string>

diff --git a/Plugins/DuckDBDriverPlugin/Info.plist b/Plugins/DuckDBDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/DynamoDBDriverPlugin/Info.plist b/Plugins/DynamoDBDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/ElasticsearchDriverPlugin/Info.plist b/Plugins/ElasticsearchDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/EtcdDriverPlugin/Info.plist b/Plugins/EtcdDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/FirebaseDriverPlugin/Info.plist b/Plugins/FirebaseDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Firestore</string>

diff --git a/Plugins/HanaDriverPlugin/Info.plist b/Plugins/HanaDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>SAP HANA</string>

diff --git a/Plugins/JSONExportPlugin/Info.plist b/Plugins/JSONExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>json</string>

diff --git a/Plugins/JSONImportPlugin/Info.plist b/Plugins/JSONImportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesImportFormatIds</key>
 	<array>
 		<string>json</string>

diff --git a/Plugins/KafkaDriverPlugin/Info.plist b/Plugins/KafkaDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Kafka</string>

diff --git a/Plugins/LibSQLDriverPlugin/Info.plist b/Plugins/LibSQLDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/MQLExportPlugin/Info.plist b/Plugins/MQLExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>mql</string>

diff --git a/Plugins/MSSQLDriverPlugin/Info.plist b/Plugins/MSSQLDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/MarkdownExportPlugin/Info.plist b/Plugins/MarkdownExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>md</string>

diff --git a/Plugins/MongoDBDriverPlugin/Info.plist b/Plugins/MongoDBDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/MySQLDriverPlugin/Info.plist b/Plugins/MySQLDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>MySQL</string>

diff --git a/Plugins/OracleDriverPlugin/Info.plist b/Plugins/OracleDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/ParquetExportPlugin/Info.plist b/Plugins/ParquetExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>parquet</string>

diff --git a/Plugins/PostgreSQLDriverPlugin/Info.plist b/Plugins/PostgreSQLDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>PostgreSQL</string>

diff --git a/Plugins/RedisDriverPlugin/Info.plist b/Plugins/RedisDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Redis</string>

diff --git a/Plugins/SQLExportPlugin/Info.plist b/Plugins/SQLExportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesExportFormatIds</key>
 	<array>
 		<string>sql</string>

diff --git a/Plugins/SQLImportPlugin/Info.plist b/Plugins/SQLImportPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesImportFormatIds</key>
 	<array>
 		<string>sql</string>

diff --git a/Plugins/SQLiteDriverPlugin/Info.plist b/Plugins/SQLiteDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>SQLite</string>

diff --git a/Plugins/SnowflakeDriverPlugin/Info.plist b/Plugins/SnowflakeDriverPlugin/Info.plist
@@ -3,6 +3,6 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 </dict>
 </plist>
diff --git a/Plugins/SpannerDriverPlugin/Info.plist b/Plugins/SpannerDriverPlugin/Info.plist
@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>TableProPluginKitVersion</key>
-	<integer>39</integer>
+	<integer>TABLEPRO_PLUGINKIT_VERSION</integer>
 	<key>TableProProvidesDatabaseTypeIds</key>
 	<array>
 		<string>Spanner</string>