Skip to content

Developer kit 0.2.0 for Swift-JSON 1.9.0, installable in Claude Code - #92

Merged
ThorFuchs merged 4 commits into
mainfrom
claude/cranky-cray-29f878
Nov 12, 2026
Merged

ThorFuchs merged 4 commits into
mainfrom
claude/cranky-cray-29f878

Conversation

@ThorFuchs

Copy link
Copy Markdown
Owner

Brings the agent developer kit from 0.1.0 (pinned to 1.6.1, 8 products) to 0.2.0, pinned to published 1.9.0 (f2a0d12, tree 6b54387), and makes it installable as a Claude Code plugin. No Sources/, Package.swift or test-target change, so the CLI identity is untouched.

Changes

  • Skill and references: cover all 12 libraries, the CLI and the macOS 15 / iOS 18 floor (Xcode 27 / macOS 27 SDK). versions.md has a per-release table (1.6.1 → 1.9.0), so the skill doesn't use a newer API against an older pin. Semantics now cover optionalValues (nil vs .some(.null)), store ID kinds (integer IDs by exact value, scalar-distinct strings), located spans, complete-or-throw follow, owner-bound positions and Transform/selection EOF.
  • Recipes: 6 new compiled recipes in the asset consumer, 14 in total: located-stream (1.8), shape-snapshot, batch, store, transform (incl. selectIndices, incompleteSelection) and dsl (1.7–1.9). The consumer pins exact: "1.9.0" with .macOS(.v15), .iOS(.v18).
  • Claude Code: plugins/swift-json/.claude-plugin/plugin.json plus a root .claude-plugin/marketplace.json. Install with /plugin marketplace add ThorFuchs/Swift-JSON, then /plugin install swift-json@swift-json. The portable root plugin.json stays for Codex. The validator requires the two manifests to agree. The marketplace description sits under metadata because Claude Code 2.1.92 rejects a top-level description. .claude-plugin/ is added to the source-archive inventory.
  • Validator: validate_developer_kit.py now checks content rather than diffing against the old base 07912d8. It checks the file set, both manifests, the marketplace entry, frontmatter, links, private markers, the consumer's imports, pin and markers, and local hashes. When the pinned commit is available, it regenerates the compatibility map from that commit's bytes and requires an exact match. --write-compatibility refreshes the map.
  • CI: the docs lane now runs test_kit.py (23 tests, 6 new) and validate_developer_kit.py. This avoids a new lane and doesn't touch the lane list that Qualify Apple deployment floors and refine CLI source identity #88 edits.
  • Evaluation cases: updated for 1.9.0. Added DK-E17 to E22 (batch, store, located streaming, selectIndices, DSLs, and an iOS 17 floor boundary). Also updated run_recipes.py, the kit guide and README.

Checks run (macOS, Swift 6.4.2, TOOLCHAINS=org.swift.642202610261a)

  • python3 -B Tools/DeveloperKitAcceptance/run_recipes.py --output <new scratch dir> → exit 0, status passed. It resolved public HTTPS exact 1.9.0 to f2a0d12… / tree 6b54387…, checked the 12-library + CLI inventory and the tagged CLI identity, verified 50 recipe source hashes against the tagged checkout, and ran 75 checks in Debug and 75 in Release (identical), ending with KIT_RECIPES passed recipes=14 libraries=12.
  • python3 -B Scripts/ci.py --lane docs → exit 0. All 4 commands passed: exact projections, test_kit.py (23 ok), validate_developer_kit.py (recipe_sources: passed: 50 source bindings at f2a0d12…) and build_documentation.py.
  • python3 -B Scripts/public_check.py → no errors.
  • claude plugin validate . and claude plugin validate ./plugins/swift-json (Claude Code 2.1.92) → both "Validation passed".
  • package_developer_kit.py run twice → byte-identical plugin and skill ZIPs (1b159796…, 912b3939…), verified with --plugin-zip/--skill-zip.
  • Not run: the full native, safety and archive lanes. Sources didn't change, and the archive change only adds .claude-plugin to the inventory, which the focused archive tests cover.

Not done / for the maintainer

  • No developer-kit-v0.2.0 tag, release or marketplace submission was made. Publishing the ZIPs, qualification JSON and SHA256SUMS stays a separate decision.
  • /plugin marketplace add ThorFuchs/Swift-JSON only works once this is on main. Installing from GitHub and using the plugin end to end in a session haven't been observed yet. The Codex discovery check hasn't been repeated for 0.2.0, and no forward-test of the evaluation cases was run.
  • No CHANGELOG line: Unreleased — 1.9.1 hygiene exists only in open Qualify Apple deployment floors and refine CLI source identity #88. Once Qualify Apple deployment floors and refine CLI source identity #88 merges, add: "Developer kit 0.2.0: pinned to 1.9.0, installable from this repository's Claude Code marketplace; kit checks run in the docs lane."
  • Sources/JSONInspection/Documentation.docc/BoundedWorkflowRecipes.md still says the kit "stays pinned to its published library version". I left it alone to avoid a DocC edit before Qualify Apple deployment floors and refine CLI source identity #88 removes DocC from the CLI identity.

🤖 Generated with Claude Code

ThorFuchs and others added 4 commits November 11, 2026 19:10
- Pin the skill, references and asset consumer to published 1.9.0
  (f2a0d12, tree 6b54387): twelve libraries, the CLI and the macOS 15 /
  iOS 18 floor. Add compiled recipes for located root-array streaming,
  shape evidence and snapshots, ordered batches with optionalValues, the
  configured store with integer IDs, Transform with selectIndices and the
  value/schema DSLs (14 recipes, 50 hashed source bindings).
- Add a Claude Code manifest (.claude-plugin/plugin.json) and a repository
  marketplace (.claude-plugin/marketplace.json); keep the portable root
  plugin.json for Codex. Include .claude-plugin in source archives.
- Make validate_developer_kit.py validate content instead of diffing
  against a historical base, regenerate the compatibility map from the
  pinned commit (--write-compatibility) and run the kit checks in the
  docs lane.
- Update evaluation cases, run_recipes.py, the kit guide and README.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- SKILL.md: short swift-json CLI section (build, exit codes, named limit
  profiles, --version --json content digest versus Git commit), checked
  against the 1.9.0 CLI guide. Regenerate the compatibility map.
- CHANGELOG: developer kit 0.2.0 under "Unreleased — 1.9.1 hygiene".
- BoundedWorkflowRecipes.md: the kit now carries 1.9.0 recipes (DocC is
  outside the CLI identity since #88).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ThorFuchs
ThorFuchs merged commit 03f8340 into main Nov 12, 2026
21 checks passed
@ThorFuchs
ThorFuchs deleted the claude/cranky-cray-29f878 branch November 12, 2026 12:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant