plugin: add Swift language tooling workflows

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     { "name": "agent-portability-skills", "source": "./plugins/agent-portability-skills", "description": "Cross-host agent-skill and plugin portability workflows.", "category": "developer-tools", "tags": ["skills", "portability"], "strict": false },
     { "name": "android-dev-skills", "source": "./plugins/android-dev-skills", "description": "Android, Kotlin, Java, Gradle, testing, and release workflows.", "category": "developer-tools", "tags": ["android", "skills"], "strict": false },
     { "name": "apple-creator-studio-skills", "source": "./plugins/apple-creator-studio-skills", "description": "Apple Creator Studio workflows for production and delivery.", "category": "productivity", "tags": ["apple", "creative"], "strict": false },
-    { "name": "apple-dev-skills", "source": "./plugins/apple-dev-skills", "description": "Apple, Swift, Xcode, and platform-development workflows.", "category": "developer-tools", "tags": ["apple", "swift", "xcode"], "mcpServers": "./.mcp.json", "strict": false },
+    { "name": "apple-dev-skills", "source": "./plugins/apple-dev-skills", "description": "Apple, SwiftPM extension, Swift, Xcode, and platform-development workflows.", "category": "developer-tools", "tags": ["apple", "swift", "swiftpm", "xcode"], "mcpServers": "./.mcp.json", "strict": false },
     { "name": "cardhop-app", "source": "./plugins/cardhop-app", "description": "Cardhop contact workflows with a Claude Code local MCP server.", "category": "productivity", "tags": ["contacts", "macos", "local-mcp"], "mcpServers": "./claude.mcp.json", "strict": false },
     { "name": "cloud-deployment-skills", "source": "./plugins/cloud-deployment-skills", "description": "Cloud deployment routing and provider integration workflows.", "category": "developer-tools", "tags": ["cloud", "deployment"], "strict": false },
     { "name": "cloud-inference-skills", "source": "./plugins/cloud-inference-skills", "description": "Cloud AI inference, training, conversion, and GPU workflows.", "category": "developer-tools", "tags": ["ai", "cloud", "mcp"], "mcpServers": "./.mcp.json", "strict": false },
@@ -24,7 +24,7 @@
     { "name": "rust-skills", "source": "./plugins/rust-skills", "description": "Rust, Cargo, crate, test, CI, and package workflows.", "category": "developer-tools", "tags": ["rust", "cargo"], "strict": false },
     { "name": "server-side-jvm", "source": "./plugins/server-side-jvm", "description": "Java, Scala, JVM service, build, and testing workflows.", "category": "developer-tools", "tags": ["java", "scala", "jvm"], "strict": false },
     { "name": "server-side-swift", "source": "./plugins/server-side-swift", "description": "Vapor, Hummingbird, SwiftNIO, and server-side Swift workflows.", "category": "developer-tools", "tags": ["swift", "server"], "strict": false },
-    { "name": "swift-lang", "source": "./plugins/swift-lang", "description": "Shared Swift API, error handling, formatting, and modernization workflows.", "category": "developer-tools", "tags": ["swift", "language"], "strict": false },
+    { "name": "swift-lang", "source": "./plugins/swift-lang", "description": "Shared Swift language, syntax, compiler, semantic indexing, LSP, formatting, and modernization workflows.", "category": "developer-tools", "tags": ["swift", "language", "tooling"], "strict": false },
     { "name": "swiftasb-skills", "source": "./plugins/swiftasb-skills", "description": "SwiftASB integration and application-development workflows.", "category": "developer-tools", "tags": ["swift", "swiftasb"], "strict": false },
     { "name": "things-app", "source": "./plugins/things-app", "description": "Things planning and reminder workflows with a Claude Code local MCP server.", "category": "productivity", "tags": ["things", "macos", "local-mcp"], "mcpServers": "./claude.mcp.json", "strict": false },
     { "name": "web-dev-skills", "source": "./plugins/web-dev-skills", "description": "Web and Expo native-boundary workflows.", "category": "developer-tools", "tags": ["web", "expo"], "strict": false }

README.md

@@ -147,7 +147,7 @@ Current Socket catalog shape:
 - `agent-portability-skills`: maintainer skills plus a source-bundled guidance-sync custom-agent definition for Socket-owned agent skill portability, Codex plugin surfaces, and host adapter guidance
 - `android-dev-skills`: Android, Kotlin, Java, Gradle, Android Gradle Plugin, Compose/XML UI, testing, lint, emulator-aware validation handoff, and release-readiness workflow guidance
 - `apple-creator-studio-skills`: source-preserving Final Cut Pro editing, Motion template, Compressor delivery, Logic Pro production, MainStage concert, and GarageBand project workflows with local Help Viewer discovery, explicit Computer Use safeguards, and artifact or rehearsal verification
-- `apple-dev-skills`: Apple, Swift, Core Image and Image I/O, Vision and Core ML recognition, AVFoundation camera and depth capture, ARKit spatial sensing, VideoToolbox and Core Video codecs, PhotosUI and PhotoKit, AVFAudio, Core Media, Core Audio, SwiftUI, AppKit, Xcode, Safari, OpenAPI, and DocC workflows, plus the source-bundled `swift-steward` custom-agent definition with its own roadmap
+- `apple-dev-skills`: Apple, Swift, SwiftPM package plugins/macros/traits, Core Image and Image I/O, Vision and Core ML recognition, AVFoundation camera and depth capture, ARKit spatial sensing, VideoToolbox and Core Video codecs, PhotosUI and PhotoKit, AVFAudio, Core Media, Core Audio, SwiftUI, AppKit, Xcode, Safari, OpenAPI, and DocC workflows, plus the source-bundled `swift-steward` custom-agent definition with its own roadmap
 - `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
 - `cloud-deployment-skills`: cloud provider deployment routing, official provider plugin selection, credential and mutation boundary checks, and AWS handoff to the official AWS Agent Toolkit rather than duplicated AWS MCP, CLI, or SAM setup
 - `cloud-inference-skills`: cloud AI inference, training, model conversion, and GPU infrastructure routing for Runpod, Hugging Face, AWS, Vast.ai, CoreWeave, and similar providers, with bundled Runpod MCP server configuration, upstream Runpod skill mirrors, and first-party Hugging Face/AWS handoffs
@@ -162,7 +162,7 @@ Current Socket catalog shape:
 - `reverse-engineering-skills`: artifact triage, preservation, exact-build comparison, decompiler review, Apple Mach-O/runtime/signing/Apple Silicon/dyld/dynamic/kernel research, Cutter/Rizin, Malimite, Ghidra, Hopper, .NET, Unity and IL2CPP, and reproducible security evidence workflows
 - `server-side-jvm`: server-side JVM, Java, Scala, Gradle, Maven, SBT, and testing workflow guidance, with future Clojure support planned
 - `server-side-swift`: server-side Swift bootstrap and guidance sync, Vapor, Hummingbird, hb Server/Lambda flows, persistence, OpenAPI/RPC, SwiftNIO, observability, auth, app sync, Docker, Apple Containerization, and Fly.io support plus the source-bundled `server-swift-steward` custom-agent definition
-- `swift-lang`: shared Swift language, API style, error handling, functional pipelines, formatting, source organization, and modernization cleanup workflows
+- `swift-lang`: shared Swift language, API style, error handling, functional pipelines, formatting, source organization, SwiftSyntax transformation, compiler inspection, SourceKit semantics and indexing, SourceKit-LSP diagnosis, Swiftly/Xcode toolchain routing, and modernization cleanup workflows
 - `rust-skills`: Rust, Cargo, rustup, crate, workspace, CLI, library, package, CI, test, lint, and format workflow guidance
 - `speak-swiftly`: Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository
 - `swiftasb-skills`: SwiftASB companion guidance

ROADMAP.md

@@ -28,6 +28,7 @@
 - [Milestone 25: Apple Creator Studio operator workflows](#milestone-25-apple-creator-studio-operator-workflows)
 - [Milestone 26: Messaging collaboration skills plugin](#milestone-26-messaging-collaboration-skills-plugin)
 - [Milestone 27: Cybersecurity skills plugin](#milestone-27-cybersecurity-skills-plugin)
+- [Milestone 28: Swift language tooling expansion](#milestone-28-swift-language-tooling-expansion)
 - [Small Tickets](#small-tickets)
 - [Backlog Candidates](#backlog-candidates)
 - [History](#history)
@@ -69,6 +70,7 @@
 - Milestone 25: Apple Creator Studio operator workflows - Planned
 - Milestone 26: Messaging collaboration skills plugin - Completed
 - Milestone 27: Cybersecurity skills plugin - Planned
+- Milestone 28: Swift language tooling expansion - In Progress
 
 ## Milestone 5: SwiftASB skills plugin
 
@@ -899,6 +901,42 @@ Completed
 - [x] Deep binary work, repository source scanning, Apple implementation, and stack-specific fixes have explicit owner handoffs with no duplicate catch-all workflows.
 - [x] Root documentation, marketplace wiring, Codex/Hermes compatibility, plugin metadata, and validation agree on the shipped skill inventory.
 
+## Milestone 28: Swift language tooling expansion
+
+### Status
+
+In Progress
+
+### Scope
+
+- [x] Expand `swift-lang` with a first wave that routes and operates source-accurate syntax, compiler inspection, semantic and index queries, and SourceKit-LSP diagnosis without collapsing their data models or stability contracts.
+- [x] Treat Swiftly and Xcode as the two first-class Swift toolchain owners across the new workflows, including explicit resolution, selected-owner evidence, `swiftly use xcode` handling, and mixed-toolchain guards.
+- [x] Keep the expansion as portable instruction skills without bundling a compiler, SourceKit service, language server, MCP server, or native host plugin.
+- [ ] Add the second-wave API-surface workflow after the first-wave routing and fixtures establish a stable base.
+
+### First Wave
+
+- [x] Add `swift-lang:choose-swift-language-tooling` for information-model, project-model, and toolchain routing.
+- [x] Add `swift-lang:swift-syntax-tooling-workflow` for SwiftParser, SwiftSyntax, builders, visitors, rewriters, diagnostics, and macro implementation trees.
+- [x] Add `swift-lang:swift-compiler-inspection-workflow` for `swift`, `swiftc`, swift-driver, guarded `swift-frontend`, diagnostics, AST, SIL, IR, dependency, module, and interface inspection.
+- [x] Add `swift-lang:swift-semantic-indexing-workflow` for SourceKit, SourceKitten, compiler index stores, IndexStoreDB, positions, compiler arguments, and freshness decisions.
+- [x] Add `swift-lang:sourcekit-lsp-workflow` for SwiftPM, compilation database, build server, protocol lifecycle, generated source, indexing, logging, and diagnostic-bundle workflows.
+- [x] Export all five portable skills through the Hermes skill tap and preserve the existing Claude Code and Cowork instruction-only classification.
+
+### Second Wave
+
+- [ ] Add `swift-lang:swift-api-surface-analysis-workflow` for module interfaces, symbol graphs, `swift-api-digester`, API and ABI baselines, release comparisons, and documentation inputs.
+- [ ] Establish fixtures across Swiftly-selected Swift.org toolchains and Xcode-selected Apple toolchains before declaring persisted compiler output stable enough for automation.
+- [ ] Route DocC authoring to Apple Dev while retaining language-level symbol-graph and public-API analysis in `swift-lang`.
+- [ ] Update Swift Lang metadata, Hermes export, Claude marketplace description, and root documentation when the second-wave skill ships.
+
+### Exit Criteria
+
+- [x] An agent selects syntax, compiler, semantics, index, or LSP by required information rather than tool name alone.
+- [x] Every first-wave workflow reports whether Swiftly or Xcode owns each selected binary and refuses mixed-toolchain proof.
+- [x] Codex, Claude, Cowork, and Hermes compatibility surfaces agree on the portable first-wave skill inventory.
+- [ ] The second-wave workflow can compare public API and ABI artifacts with explicit version and toolchain evidence.
+
 ## Small Tickets
 
 - [ ] Record issue-sized fixes, TODO/FIXME imports, and cleanup work that is too small or too unplanned for a milestone.

docs/maintainers/hermes-compatibility.md

@@ -35,6 +35,11 @@ Socket tap. The curated set is:
 - `script-hopper-analysis`
 - `use-ghidra`
 - `use-hopper`
+- `choose-swift-language-tooling`
+- `sourcekit-lsp-workflow`
+- `swift-compiler-inspection-workflow`
+- `swift-semantic-indexing-workflow`
+- `swift-syntax-tooling-workflow`
 
 ```bash
 hermes skills tap add gaelic-ghost/socket
@@ -66,6 +71,17 @@ Python SDK, and `HopperMCPServer` remain operator-local runtime surfaces. The
 Hopper MCP profile is therefore private user configuration, not a Socket
 `.mcp.json` declaration or a native Hermes plugin.
 
+The exported Swift language-tooling workflows are portable guidance. They
+resolve and invoke operator-installed Swiftly or Xcode tools but bundle no
+compiler, SourceKit service, language server, MCP declaration, hook, or native
+Hermes runtime. Hermes skill-tap support therefore preserves their real
+instruction contract without presenting the Codex plugin manifest as portable.
+
+The exported Swift package extension workflow is likewise portable guidance.
+It resolves operator-installed Swiftly and Xcode tools and plans SwiftPM plugin,
+macro, trait, generated-source, and permission work without bundling a compiler,
+plugin runtime, MCP server, or native Hermes extension.
+
 ## Maintainer Workflow
 
 1. Classify each changed surface before editing: portable skill, translated MCP,

docs/maintainers/swift-lang-plugin-plan.md

@@ -185,3 +185,31 @@ Later release:
 - Apple Dev and Server-Side Swift guidance can route shared Swift cleanup work
   to `swift-lang` while preserving standalone Apple-only behavior for the first
   release.
+
+## Language Tooling Expansion
+
+Treat the language-tooling expansion as a durable building-block change inside
+`swift-lang`. It removes the need to improvise syntax, compiler, semantic,
+index, and LSP decisions inside the broad modernization workflow while keeping
+Apple SDK, Xcode execution, package extension, and server framework ownership
+in their specialist plugins.
+
+First wave:
+
+- `choose-swift-language-tooling` routes by information model and project shape.
+- `swift-syntax-tooling-workflow` owns source-accurate parsing and transformation.
+- `swift-compiler-inspection-workflow` owns driver, compiler phase, and emitted-artifact inspection.
+- `swift-semantic-indexing-workflow` owns SourceKit, SourceKitten, compiler index store, and IndexStoreDB decisions.
+- `sourcekit-lsp-workflow` owns language-server integration and diagnosis.
+- Every workflow treats Swiftly and Xcode as separate first-class toolchain
+  owners, records both resolvers on macOS, and forbids mixed-toolchain evidence.
+
+Second wave:
+
+- Add `swift-api-surface-analysis-workflow` for module interfaces, symbol
+  graphs, API digester baselines, API-versus-ABI compatibility, release
+  comparisons, and documentation inputs after concrete fixtures establish the
+  stable output and versioning contract.
+
+Keep both waves as portable instruction skills. Export them through the Hermes
+skill tap; do not add a compiler wrapper, MCP server, or native host plugin.

plugins/agent-portability-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-portability-skills",
-  "version": "9.16.0",
+  "version": "9.17.0",
   "description": "Maintainer skills for Socket-owned agent skill portability, Codex plugin surfaces, and host adapter guidance.",
   "author": {
     "name": "Gale",

plugins/agent-portability-skills/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-portability-skills-maintenance"
-version = "9.16.0"
+version = "9.17.0"
 description = "Maintainer-only Python tooling baseline for Agent Portability Skills."
 requires-python = ">=3.11"
 dependencies = []

plugins/agentdeck/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentdeck",
-  "version": "9.16.0",
+  "version": "9.17.0",
   "description": "Local Codex runtime utilities for thread, hook, and app-server workflows.",
   "author": {
     "name": "Gale",

plugins/android-dev-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "android-dev-skills",
-  "version": "9.16.0",
+  "version": "9.17.0",
   "description": "Android, Kotlin, Java, Gradle, Android Gradle Plugin, testing, lint, UI implementation, and release-readiness workflow skills.",
   "author": {
     "name": "Gale",

plugins/apple-creator-studio-skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "apple-creator-studio-skills",
-  "version": "9.16.0",
+  "version": "9.17.0",
   "description": "Human-facing and Computer Use-aware Apple Creator Studio workflows for Final Cut Pro editing, Motion templates, Compressor delivery, Logic Pro production, MainStage concert preparation, and GarageBand projects.",
   "author": {
     "name": "Gale",