Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ Current Socket catalog shape:
- `dotnet-skills`: .NET, F#, and C# project-shape, bootstrap, implementation, test, package, diagnostics, ASP.NET Core, interop, CI, upgrade, and tooling guidance
- `productivity-skills`: general-purpose maintainer and documentation workflow baseline
- `python-skills`: Python runtime and tooling workflows for Python-based projects; see the [Python skills expansion plan](./docs/maintainers/python-skills-plugin-plan.md) for maintainer details
- `server-side-swift`: server-side Swift, Vapor, Hummingbird, persistence, OpenAPI, and RPC-fit workflows with SwiftPM-first build, run, test, framework-specific migration, database, generated transport, and diagnostics guidance
- `server-side-swift`: server-side Swift support for building, running, containerizing, and maintaining services with frameworks like Vapor and Hummingbird
- `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
Expand Down
4 changes: 2 additions & 2 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,8 +159,8 @@ In Progress
- [ ] Add Swift observability and tracing guidance that covers Swift Logging, Metrics, Distributed Tracing, and OpenTelemetry-style instrumentation for service diagnostics.
- [ ] Add a server authentication and authorization workflow covering Vapor and Hummingbird auth boundaries, sessions, JWT, OAuth/OIDC handoffs, password storage, middleware placement, and security-sensitive testing without duplicating client Keychain guidance.
- [ ] Add a server app-sync workflow covering sync contracts, conflict handling, incremental change feeds, idempotent writes, cursor/token semantics, background job handoffs, and API-shape coordination without absorbing the separate OpenAPI or RPC workflow.
- [ ] Add a Docker workflow for server-side Swift packages, including Dockerfile shape, Compose-local development, Linux image concerns, environment configuration, and build/test handoffs.
- [ ] Add an Apple Containerization workflow for Apple's container tooling, keeping it distinct from generic Docker guidance and tied to current official Apple documentation.
- [x] Add a Docker workflow for server-side Swift packages, including Dockerfile shape, Compose-local development, Linux image concerns, environment configuration, and build/test handoffs.
- [x] Add an Apple Containerization workflow for Apple's container tooling, keeping it distinct from generic Docker guidance and tied to current official Apple documentation.
- [x] Update plugin metadata prompts and keywords as new server-side Swift skill surfaces ship.
- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py` after each metadata or marketplace-facing update.

Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-plugin-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agent-plugin-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Installable maintainer skills for skills-export repositories.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-plugin-skills/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "agent-plugin-skills-maintenance"
version = "6.14.5"
version = "6.15.0"
description = "Maintainer-only Python tooling baseline for agent-plugin-skills."
requires-python = ">=3.11"
dependencies = []
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-plugin-skills/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/android-dev-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "android-dev-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Placeholder plugin repository for future Android, Kotlin, and Java Codex skills.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/apple-dev-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "apple-dev-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Apple development workflows for Codex, including SwiftUI architecture, Icon Composer app icons, Safari extensions, Swift OpenAPI clients, and DocC authoring guidance.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/apple-dev-skills/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "apple-dev-skills-maintainer"
version = "6.14.5"
version = "6.15.0"
description = "Maintainer tooling for the apple-dev-skills repository"
requires-python = ">=3.9"
dependencies = []
Expand Down
2 changes: 1 addition & 1 deletion plugins/apple-dev-skills/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/cardhop-app/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "cardhop-app",
"version": "6.14.5",
"version": "6.15.0",
"description": "Cardhop.app workflow guidance plus a bundled local MCP server for contact capture and updates on macOS.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/cardhop-app/mcp/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "cardhop-app-mcp"
version = "6.14.5"
version = "6.15.0"
requires-python = ">=3.13"
dependencies = [
"fastmcp>=3.0.2",
Expand Down
2 changes: 1 addition & 1 deletion plugins/cardhop-app/mcp/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/dotnet-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "dotnet-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Codex skills for choosing, bootstrapping, building, testing, packaging, diagnosing, and maintaining .NET projects with F# and C# as equal first-party languages.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/productivity-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "productivity-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Broadly useful productivity workflows for Codex.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/productivity-skills/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "productivity-skills-maintenance"
version = "6.14.5"
version = "6.15.0"
description = "Maintainer-only Python tooling baseline for productivity-skills."
requires-python = ">=3.11"
dependencies = []
Expand Down
2 changes: 1 addition & 1 deletion plugins/productivity-skills/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/python-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "python-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Bundled Python-focused Codex skills for uv bootstrapping, project implementation, diagnostics, packaging, tooling, CI, upgrades, FastAPI, FastMCP, and pytest workflows.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/python-skills/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "python-skills-maintainer"
version = "6.14.5"
version = "6.15.0"
description = "Maintainer tooling for the python-skills repository"
requires-python = ">=3.11"
dependencies = []
Expand Down
2 changes: 1 addition & 1 deletion plugins/python-skills/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion plugins/rust-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "rust-skills",
"version": "6.14.5",
"version": "6.15.0",
"description": "Rust, Cargo, rustup, crate, workspace, CLI, library, package, CI, testing, linting, and formatting workflow skills.",
"skills": "./skills/",
"author": {
Expand Down
16 changes: 12 additions & 4 deletions plugins/server-side-swift/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "server-side-swift",
"version": "6.14.5",
"description": "Codex skills for building, running, and maintaining server-side Swift services, including Vapor, Hummingbird, persistence, Swift OpenAPI, RPC-fit decisions, and SwiftPM-first workflows.",
"version": "6.15.0",
"description": "Codex skills for building, running, containerizing, and maintaining server-side Swift services, including Vapor, Hummingbird, persistence, Swift OpenAPI, RPC-fit decisions, Docker, Apple Containerization, and SwiftPM-first workflows.",
"author": {
"name": "Gale",
"email": "mail@galewilliams.com",
Expand All @@ -23,13 +23,17 @@
"persistence",
"openapi",
"rpc",
"docker",
"containerization",
"apple-container",
"oci",
"swiftpm"
],
"skills": "./skills/",
"interface": {
"displayName": "Server-Side Swift",
"shortDescription": "Server-side Swift, Vapor, Hummingbird, persistence, OpenAPI, and RPC workflow guidance for Codex.",
"longDescription": "Guide Codex agents through server-side Swift projects with SwiftPM-first workflows, current Vapor, Hummingbird, and Swift OpenAPI documentation, local run commands, app structure, routing, middleware, request contexts, Fluent models, database migrations, query design, OpenAPI generation and transport wiring, RPC-fit decisions, environment configuration, tests, and deployment handoffs.",
"shortDescription": "Server-side Swift, Vapor, Hummingbird, persistence, OpenAPI, RPC, Docker, and Apple Containerization workflow guidance for Codex.",
"longDescription": "Guide Codex agents through server-side Swift projects with SwiftPM-first workflows, current Vapor, Hummingbird, Swift OpenAPI, Docker, and Apple Containerization documentation, local run commands, app structure, routing, middleware, request contexts, Fluent models, database migrations, query design, OpenAPI generation and transport wiring, RPC-fit decisions, Dockerfile and Compose workflows, Apple's container CLI and Containerization APIs, environment configuration, tests, and deployment handoffs.",
"developerName": "gaelic-ghost",
"category": "Developer Tools",
"capabilities": [
Expand All @@ -42,6 +46,10 @@
"Create a Hummingbird service plan using current Hummingbird docs and SwiftPM workflows.",
"Add Swift OpenAPI Generator to a server-side Swift package and wire the generated API to Vapor or Hummingbird.",
"Decide whether this Swift service boundary should use OpenAPI, JSON-RPC, gRPC, MCP-style tools, or ordinary HTTP routes.",
"Add a Dockerfile and Compose workflow for this server-side Swift package.",
"Diagnose why this Swift service Docker image fails to build, start, or bind its port.",
"Plan an Apple Containerization workflow for running this Swift service locally on Apple silicon.",
"Compare Docker and Apple's container CLI for this server-side Swift development workflow.",
"Inspect this Vapor app and explain its routes, configuration, and run commands.",
"Inspect this Hummingbird app and explain its router, middleware, request contexts, and run commands.",
"Inspect this OpenAPI-backed Swift service and explain its contract, generated symbols, transport, and validation commands.",
Expand Down
2 changes: 2 additions & 0 deletions plugins/server-side-swift/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,8 @@ This file is the Server-Side Swift child-plugin override for work done from `soc
- Match the `socket` shared semantic version exactly; use the Socket root release workflow for version inventory and bumps.
- Prefer Swift Package Manager as the source of truth for server-side Swift package structure, dependencies, builds, tests, and run commands.
- Use official framework documentation first for server-side Swift libraries and tools. For Vapor work, use the official Vapor docs before proposing CLI usage, app structure, migrations, deployment, or runtime changes. For Hummingbird work, use the official Hummingbird docs before proposing app setup, routes, middleware, request contexts, testing, service lifecycle, deployment, or runtime changes.
- For Docker work, use current official Docker documentation and Swift Docker image sources before proposing Dockerfile, Compose, BuildKit, image, registry, or runtime changes.
- For Apple Containerization work, use the official `apple/containerization` and `apple/container` documentation for the relevant branch or release before proposing `container` CLI commands, Containerization Swift API use, host requirements, kernel setup, Rosetta behavior, image, registry, or runtime changes.
- Treat the Vapor Toolbox as project-creation and convenience tooling, not as a replacement for SwiftPM. Prefer `swift build`, `swift test`, `swift run`, and `swift run App serve` after a project exists unless current Vapor documentation says otherwise for the specific task.
- Keep server-side Swift examples portable across macOS and Linux unless the target repository documents an Apple-only service environment.
- Keep dependencies fetchable from GitHub, package registries, package-manager URLs, or other real remote repositories. Do not commit machine-local package paths.
Expand Down
Loading