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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
name: xcodebuildmcp-docs-command-review
description: Use when reviewing XcodeBuildMCP changelog CLI command references for invalid current guidance while allowing historical migration examples.
name: mobilebuildmcp-docs-command-review
description: Use when reviewing MobileBuildMCP changelog CLI command references for invalid current guidance while allowing historical migration examples.
allowed-tools: Read Grep Glob
---

# XcodeBuildMCP Docs Command Review
# MobileBuildMCP Docs Command Review

Review changed changelog entries for CLI command references that would mislead users or agents.

Expand All @@ -20,7 +20,7 @@ Report a finding only when a command reference is presented as current guidance

### High severity

- A changelog bullet, example, or migration instruction tells users to run a removed or invalid `xcodebuildmcp` command as the current path.
- A changelog bullet, example, or migration instruction tells users to run a removed or invalid `mobilebuildmcp` command as the current path.
- A Breaking change mentions a removed command but does not give a valid replacement.
- A command reference uses the wrong workflow/tool pairing in a way a user or agent would likely copy.

Expand All @@ -41,10 +41,10 @@ Example that should not be reported:

```markdown
Before:
xcodebuildmcp logging start-sim-log-cap
mobilebuildmcp logging start-sim-log-cap

After:
xcodebuildmcp simulator build-and-run
mobilebuildmcp simulator build-and-run
```

## Output
Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-docs-release-review
description: Use when reviewing XcodeBuildMCP documentation, CLI command references, website manifest generation, changelog, release notes, and release script changes.
name: mobilebuildmcp-docs-release-review
description: Use when reviewing MobileBuildMCP documentation, CLI command references, website manifest generation, changelog, release notes, and release script changes.
---

# XcodeBuildMCP Docs and Release Review
# MobileBuildMCP Docs and Release Review

Review guardrails for documentation, generated references, and release flow consistency.

Expand Down Expand Up @@ -32,11 +32,11 @@ Review guardrails for documentation, generated references, and release flow cons
- Website manifest generation preserves expected normalized fields.
- Docs explain runtime/contracts without deprecated patterns.
- Keep docs-only work from introducing product behavior changes.
- CLI command references in changelog entries are reviewed by `xcodebuildmcp-docs-command-review`.
- CLI command references in changelog entries are reviewed by `mobilebuildmcp-docs-command-review`.

## Validation

- `npm run build`
- Release notes check when touched:
- `node scripts/generate-github-release-notes.mjs --version <version> --changelog CHANGELOG.md`
- `npx skill-check .agents/skills/xcodebuildmcp-docs-release-review`
- `npx skill-check .agents/skills/mobilebuildmcp-docs-release-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-packaging-resource-review
description: Use when reviewing XcodeBuildMCP packaging, resource-root, build artifact, bundled AXe, schema, manifest, and portable macOS distribution changes.
name: mobilebuildmcp-packaging-resource-review
description: Use when reviewing MobileBuildMCP packaging, resource-root, build artifact, bundled AXe, schema, manifest, and portable macOS distribution changes.
---

# XcodeBuildMCP Packaging and Resource Review
# MobileBuildMCP Packaging and Resource Review

Review guardrails for package/build/resource integrity and portable distribution.

Expand All @@ -29,7 +29,7 @@ Review guardrails for package/build/resource integrity and portable distribution
- Published package `files` includes required runtime resources.
- Portable package includes `build`, `manifests`, `bundled`, `skills`, `package.json`, and production dependencies.
- AXe binary/framework expectations remain verified.
- Wrapper scripts preserve `XCODEBUILDMCP_RESOURCE_ROOT` and `DYLD_FRAMEWORK_PATH`.
- Wrapper scripts preserve `MOBILEBUILDMCP_RESOURCE_ROOT` and `DYLD_FRAMEWORK_PATH`.
- Schemas and manifests stay available in installed and portable layouts.
- Do not assume build outputs exist before `npm run build`.
- Avoid network-dependent packaging behavior without verification/checksums.
Expand All @@ -40,4 +40,4 @@ Review guardrails for package/build/resource integrity and portable distribution
- Packaging-specific when touched:
- `npm run package:macos -- --help` (if supported)
- `npm run verify:portable` after artifact creation
- `npx skill-check .agents/skills/xcodebuildmcp-packaging-resource-review`
- `npx skill-check .agents/skills/mobilebuildmcp-packaging-resource-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-rendering-streaming-review
description: Use when reviewing XcodeBuildMCP rendering, streaming fragment, next-step, and CLI output mode changes for boundary violations.
name: mobilebuildmcp-rendering-streaming-review
description: Use when reviewing MobileBuildMCP rendering, streaming fragment, next-step, and CLI output mode changes for boundary violations.
---

# XcodeBuildMCP Rendering and Streaming Review
# MobileBuildMCP Rendering and Streaming Review

Review guardrails for rendering boundaries, streaming fragments, and output modes.

Expand Down Expand Up @@ -39,4 +39,4 @@ Review guardrails for rendering boundaries, streaming fragments, and output mode
- `npm test -- src/runtime/__tests__/tool-invoker.test.ts`
- `npm run test:snapshots`
- `npm run typecheck`
- `npx skill-check .agents/skills/xcodebuildmcp-rendering-streaming-review`
- `npx skill-check .agents/skills/mobilebuildmcp-rendering-streaming-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-runtime-boundary-review
description: Use when reviewing XcodeBuildMCP runtime boundary changes across MCP, direct CLI invocation, daemon-routed tools, and Xcode IDE bridge routing.
name: mobilebuildmcp-runtime-boundary-review
description: Use when reviewing MobileBuildMCP runtime boundary changes across MCP, direct CLI invocation, daemon-routed tools, and Xcode IDE bridge routing.
---

# XcodeBuildMCP Runtime Boundary Review
# MobileBuildMCP Runtime Boundary Review

Review guardrails for runtime routing and invocation boundaries.

Expand Down Expand Up @@ -38,4 +38,4 @@ Review guardrails for runtime routing and invocation boundaries.

- `npm test -- src/runtime/__tests__/tool-invoker.test.ts`
- `npm run typecheck`
- `npx skill-check .agents/skills/xcodebuildmcp-runtime-boundary-review`
- `npx skill-check .agents/skills/mobilebuildmcp-runtime-boundary-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-snapshot-fixture-review
description: Use when reviewing XcodeBuildMCP snapshot fixture changes for MCP, CLI, and JSON output contract integrity.
name: mobilebuildmcp-snapshot-fixture-review
description: Use when reviewing MobileBuildMCP snapshot fixture changes for MCP, CLI, and JSON output contract integrity.
---

# XcodeBuildMCP Snapshot Fixture Review
# MobileBuildMCP Snapshot Fixture Review

Review guardrails for fixture and snapshot contract integrity.

Expand Down
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-structured-output-review
description: Use when reviewing XcodeBuildMCP structured output schema changes, schema versioning, manifest outputSchema metadata, and JSON fixture compatibility.
name: mobilebuildmcp-structured-output-review
description: Use when reviewing MobileBuildMCP structured output schema changes, schema versioning, manifest outputSchema metadata, and JSON fixture compatibility.
---

# XcodeBuildMCP Structured Output Review
# MobileBuildMCP Structured Output Review

Review guardrails for structured output schema correctness and compatibility.

Expand All @@ -24,7 +24,7 @@ Review guardrails for structured output schema correctness and compatibility.

## Guardrails

- `schema` uses `xcodebuildmcp.output.<name>` format.
- `schema` uses `mobilebuildmcp.output.<name>` format.
- `schemaVersion` uses integer strings only.
- Breaking schema changes create a new versioned schema file.
- Published schema versions are not removed or mutated incompatibly.
Expand All @@ -37,4 +37,4 @@ Review guardrails for structured output schema correctness and compatibility.
- `npm run test:schema-fixtures`
- `npm test -- src/core/__tests__/structured-output-schema.test.ts`
- `npm run typecheck`
- `npx skill-check .agents/skills/xcodebuildmcp-structured-output-review`
- `npx skill-check .agents/skills/mobilebuildmcp-structured-output-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-test-boundary-review
description: Use when reviewing XcodeBuildMCP tests for correct unit, snapshot, schema, smoke, and external process boundaries.
name: mobilebuildmcp-test-boundary-review
description: Use when reviewing MobileBuildMCP tests for correct unit, snapshot, schema, smoke, and external process boundaries.
---

# XcodeBuildMCP Test Boundary Review
# MobileBuildMCP Test Boundary Review

Review guardrails for test isolation, scope, and contract validation.

Expand Down Expand Up @@ -38,4 +38,4 @@ Review guardrails for test isolation, scope, and contract validation.
- `npm test`
- `npm run typecheck`
- If fixtures/schemas changed: `npm run test:snapshots` and `npm run test:schema-fixtures`
- `npx skill-check .agents/skills/xcodebuildmcp-test-boundary-review`
- `npx skill-check .agents/skills/mobilebuildmcp-test-boundary-review`
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
name: xcodebuildmcp-tool-contract-review
description: Use when reviewing XcodeBuildMCP tool contract changes across implementation, manifests, workflow membership, output schema metadata, and next-step templates.
name: mobilebuildmcp-tool-contract-review
description: Use when reviewing MobileBuildMCP tool contract changes across implementation, manifests, workflow membership, output schema metadata, and next-step templates.
---

# XcodeBuildMCP Tool Contract Review
# MobileBuildMCP Tool Contract Review

Review guardrails for tool contract changes across implementation, manifests, and workflow exposure.

Expand Down Expand Up @@ -40,4 +40,4 @@ Review guardrails for tool contract changes across implementation, manifests, an
- `npm run typecheck`
- `npm test -- src/core/manifest/__tests__/schema.test.ts`
- `npm test -- src/runtime/__tests__/tool-invoker.test.ts`
- `npx skill-check .agents/skills/xcodebuildmcp-tool-contract-review`
- `npx skill-check .agents/skills/mobilebuildmcp-tool-contract-review`
10 changes: 5 additions & 5 deletions .cursor/BUGBOT.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Bugbot Review Guide for XcodeBuildMCP
# Bugbot Review Guide for MobileBuildMCP

## Project Snapshot

XcodeBuildMCP is an MCP server exposing Xcode / Swift workflows as **tools** and **resources**.
MobileBuildMCP is an MCP server exposing Xcode / Swift workflows as **tools** and **resources**.
Stack: TypeScript · Node.js · plugin-based auto-discovery (`src/mcp/tools`, `src/mcp/resources`).

For full details see [README.md](README.md) and [Architecture](https://xcodebuildmcp.com/docs/architecture).
For full details see [README.md](README.md) and [Architecture](https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/architecture.mdx).

---

Expand Down Expand Up @@ -57,7 +57,7 @@ export const handler = (p: FooBarParams) => fooBarLogic(p);

* Tool manifests, schemas, and implementations must stay aligned when tools are added, removed, or renamed.
*Diff heuristic*: tool changes without corresponding manifest/schema/fixture updates ⇒ **warning**.
* Public tool docs live at https://xcodebuildmcp.com/docs/tools and are synced from release data; do not require static in-repo tools-doc parity.
* Public tool docs live at https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx and are synced from release data; do not require static in-repo tools-doc parity.
* Update public docs when CLI parameters or tool names change.

---
Expand All @@ -77,7 +77,7 @@ export const handler = (p: FooBarParams) => fooBarLogic(p);

1. **External-boundary violations**: confirm tests use injected executors/filesystem for external side effects.
2. **DI compliance**: check direct `child_process` / `fs` imports in MCP tool logic; standalone utilities with simple commands are acceptable.
3. **Docs accuracy**: compare tool manifests, schemas, fixtures, and implementation changes; public tool docs are generated at https://xcodebuildmcp.com/docs/tools.
3. **Docs accuracy**: compare tool manifests, schemas, fixtures, and implementation changes; public tool docs are generated at https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx.
4. **Style**: ensure ESLint and Prettier pass (`npm run lint`, `npm run format:check`).

---
Expand Down
12 changes: 6 additions & 6 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
name: Bug Report
description: Report a bug or issue with XcodeBuildMCP
description: Report a bug or issue with MobileBuildMCP
title: '[Bug]: '
labels: ['bug']
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report an issue with XcodeBuildMCP!
Thanks for taking the time to report an issue with MobileBuildMCP!

- type: textarea
id: description
Expand All @@ -21,10 +21,10 @@ body:
id: debug
attributes:
label: Debug Output
description: Ask your agent "Run the XcodeBuildMCP `doctor` tool and return the output as markdown verbatim" and then copy paste it here.
description: Ask your agent "Run the MobileBuildMCP `doctor` tool and return the output as markdown verbatim" and then copy paste it here.
placeholder: |
```
XcodeBuildMCP Doctor
MobileBuildMCP Doctor

Generated: 2025-08-11T17:42:29.812Z
Server Version: 1.11.2
Expand All @@ -51,7 +51,7 @@ body:
id: mcp-server-version
attributes:
label: MCP Server Version
description: The version of XcodeBuildMCP you're using
description: The version of MobileBuildMCP you're using
placeholder: 1.2.2
validations:
required: true
Expand All @@ -74,7 +74,7 @@ body:
```json
{
"mcpServers": {
"XcodeBuildMCP": {...}
"MobileBuildMCP": {...}
}
}
```
Expand Down
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
name: Feature Request
description: Suggest a new feature for XcodeBuildMCP
description: Suggest a new feature for MobileBuildMCP
title: '[Feature]: '
labels: ['enhancement']
body:
- type: markdown
attributes:
value: |
Thanks for suggesting a new feature for XcodeBuildMCP!
Thanks for suggesting a new feature for MobileBuildMCP!

- type: textarea
id: feature-description
attributes:
label: Feature Description
description: Describe the new capability you'd like to add to XcodeBuildMCP
description: Describe the new capability you'd like to add to MobileBuildMCP
placeholder: I would like the AI assistant to be able to...
validations:
required: true
Expand Down
Loading
Loading