0.5.1

Highlights

• Refreshed the npm-facing README so it now includes the NPM ready badge and the updated project description.
• No MCP tools changed in this release; this patch is only to republish the improved package metadata and documentation.

0.5.0

Highlights

• Added explicit workflow write tools: set_workflow_enabled, update_workflow_general, update_workflow_start_conditions, and update_workflow_actions.
• Added shared workflow formatting so read and write tools return the same structured workflow payload.
• Documented the workflow editing caveat: Restrict Editing must be disabled for reliable edits, even with an App Manager key.
• Live-tested the write flow against the Feature Branch workflow by disabling and re-enabling it, changing general settings, toggling the pull-request start condition, removing an action, restoring it, and confirming the workflow returned to its original state.

0.4.0

Highlights

• Added running and pending status filters to list_build_runs so agents can monitor active workflows directly.
• Improved the README feature section with a concrete tool table and human-friendly usage examples.
• Kept the existing build log and workflow detail flows unchanged and backward-compatible.

0.3.0

Highlights

• Added get_workflow_details to expose Xcode Cloud workflow configuration through MCP.
• The new tool returns general, environment, startConditions, actions, and postActions fields for agent-friendly inspection.
• Added repository, xcodeVersion, and macOsVersion workflow includes from App Store Connect.
• Updated the README, unit tests, and smoke test to cover the new workflow details flow.

0.2.0

Summary

0.2.0 expands the MCP surface for agent-driven investigation workflows around Xcode Cloud build failures.

Included in 0.2.0

• Added get_failed_tests to return only structured failed tests plus local saved log paths.
• Added materialize_build_logs as the explicit download-and-extract entrypoint for local log inspection.
• Added cleanup_saved_logs for one-build cleanup or age-based pruning of saved log directories.
• Added automatic retention cleanup for saved log directories older than 24 hours.
• Kept get_build_logs compact by returning saved log paths, failed test summaries, highlights, and a capped excerpt instead of huge log payloads.
• Documented the recommended agent workflow in the README and MCP tool descriptions.
• Bumped the package and MCP server version to 0.2.0.

Validation

• npm test
• npm run build
• Live verification of get_failed_tests, materialize_build_logs, and cleanup_saved_logs against build run 50185f9a-3e71-4648-88f3-19dcfbc0beb2.

0.1.2

Summary

Documentation and version update for the saved-log inspection flow introduced after 0.1.1.

Included in 0.1.2

• Clarified in the README that get_build_logs downloads and extracts logs into a local temporary directory for agent-side inspection.
• Documented the returned savedLogsDirectory and savedLogs fields so Claude and Codex know to inspect the saved files with rg, grep, or cat instead of relying on a large inline payload.
• Documented the current cleanup policy: the server recreates the build-specific temp directory on each call, but does not yet garbage-collect older build directories.
• Updated MCP tool descriptions so local agents see the saved-log workflow directly in tool metadata.
• Bumped the package and MCP server version to 0.1.2.

Validation

• npm test
• npm run build

0.1.1

Summary

Hotfix release for 0.1.0 that restores live build log retrieval from Xcode Cloud.

Fixed in 0.1.1

• Switched artifact collection from ciBuildRuns to ciBuildActions, which is where App Store Connect exposes action artifacts.
• Aggregated artifacts across all actions in a build run before classifying logs, result bundles, screenshots, videos, and test products.
• Added support for the LOG_BUNDLE artifact type so zipped build log bundles are treated as log artifacts and parsed correctly.
• Added regression coverage for merged action artifact groups and the updated retrieval flow.
• Bumped the package and MCP server version to 0.1.1.

Validation

• npm test
• npm run build
• Live MCP call to get_build_logs for build run f7853f41-9268-46c1-ab88-a0a7fed9023c returned 5 artifacts, parsed 5 log bundles, and surfaced the xcodebuild error line for the failed build.

0.1.0

Summary

Initial release of xcode-cloud-mcp as a minimal MCP server for Xcode Cloud.

Included in 0.1.0

• Added a Node.js and TypeScript stdio MCP server published as @thatfactory/xcode-cloud-mcp.
• Added App Store Connect authentication with support for both APPSTORE_CONNECT_API_* variables and APP_STORE_* aliases.
• Added discovery tools for products and workflows.
• Added workflow-scoped build lookup via buildRunId, workflowId + buildNumber, or workflowId + buildSelector.
• Added build issue retrieval and text-like log summarization for plain, gzip, and zip log artifacts.
• Added test summary and UI test artifact metadata retrieval.
• Added unit tests, a stdio smoke test, and GitHub Actions for CI and nightly runs on the self-hosted macOS runner.
• Added a full README with Claude and Codex setup instructions, badges, and example prompts.

Validation

• npm test
• npm run build