ios-agent-mcp 2.6.0 → 2.7.1

package/README.md

@@ -1,12 +1,26 @@
 # iOS Agent MCP
 
+[Explore the website](https://nagarjuna2997.github.io/ios-agent-skill/) · [Choose your AI and install](https://nagarjuna2997.github.io/ios-agent-skill/install.html)
+
+## Version 2.7.1
+
+Adds conservative launch-screen checks and local `apple analyze` / `apple prepare` drafts. See [release notes](https://nagarjuna2997.github.io/ios-agent-skill/releases.html) for scope and evidence.
+
+Includes real appearance-aware color catalogs and offline SVG-layer app icons,
+Muse Code setup with verified MCP discovery, and refreshed public Apple references
+through September 16, 2026 (27.0 releases and separately labeled 27.2 betas).
+The CLI is included automatically. User accounts, signing profiles and credentials
+are not package resources. Gemini CLI uses the repository extension; ChatGPT uses
+the skills package or a separately configured MCP connection. See the
+[client setup guide](https://nagarjuna2997.github.io/ios-agent-skill/install.html).
+
 ## One install, one MCP connection
 
 ```bash
 claude mcp add ios-agent -- npx -y ios-agent-mcp@latest
 ```
 
-The default server exposes 35 tools: 12 review/metadata tools, 8 Apple reference tools, 14 simulator tools, and `create_app`. App scaffolding and simulator packages install automatically as dependencies; no separate installation or MCP connection is needed. Remove the separate knowledge/simulator connections if you previously configured them to avoid duplicate tools.
+The published 2.7.1 server exposes 37 tools: 12 review/metadata tools, 8 Apple reference tools, 14 simulator tools, `create_app`, the local `prepare_issue_report` tool, and experimental `private_feedback`. App scaffolding and simulator packages install automatically as dependencies; no separate installation or MCP connection is needed. Remove the separate knowledge/simulator connections if you previously configured them to avoid duplicate tools.
 
 Create a starter directly:
 
@@ -20,7 +34,7 @@ Requires Node.js 20+. Simulator operations require macOS and Xcode; XcodeGen is
 
 # Local source retrieval in 2.4.0
 
-The knowledge server now searches bundled repository source, templates and guides, outlines sections, and reads exact content with bounded output and continuation offsets. It exposes eight knowledge tools separately from the eleven analyzer tools. No runtime browsing is needed for local source retrieval. See [offline source workflow](../docs/tooling/offline-source-library.md).
+The knowledge server now searches bundled repository source, templates and guides, outlines sections, and reads exact content with bounded output and continuation offsets. It exposes eight knowledge tools separately from the eleven analyzer tools. No runtime browsing is needed for local source retrieval. See [offline source workflow](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/tooling/offline-source-library.md).
 
 ## New in 2.4.0: Apple knowledge tools for more clients
 
@@ -30,7 +44,7 @@ This package includes two MCP binaries: `ios-agent-mcp` for local Swift project
 npx -y --package=ios-agent-mcp@2.4.0 ios-agent-knowledge
 ```
 
-Knowledge tools search 405 technologies and 96 update/release-note sources, retrieve guides, plan an app implementation, and specify separate Icon Composer layers. They do not write apps, access arbitrary project paths or claim native icon generation. [Setup](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/mcp/installation.md).
+Knowledge tools search 405 technologies and 96 update/release-note sources, retrieve guides, plan an app implementation, and specify separate Icon Composer layers. They do not write apps, access arbitrary project paths or claim native icon generation. [Setup](https://nagarjuna2997.github.io/ios-agent-skill/install.html).
 
 # ios-agent-mcp
 
@@ -58,6 +72,8 @@ Claude → review_swift_concurrency
 
 ## Install
 
+Choose your client: [Claude](#claude-code) · [ChatGPT / Codex](#chatgpt--codex) · [Gemini CLI](#gemini-cli) · [Muse Code](#muse-code). One server package; client connection methods differ.
+
 ### Claude Code
 
 ```bash
@@ -79,28 +95,59 @@ claude mcp add ios-agent -- npx -y ios-agent-mcp
 }
 ```
 
-### Cursor
+### ChatGPT / Codex
+
+**Codex** connects to the local unified server:
+
+```bash
+codex mcp add ios-agent -- npx -y ios-agent-mcp@latest
+```
 
-`.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` globally:
+**ChatGPT** has a different setup: use the skills-only release package where your account supports it, or configure a hosted HTTPS knowledge server/private MCP tunnel through a supported developer-mode flow. ChatGPT web does not run this local `npx` command itself. This project does not provide a public hosted endpoint. See the [ChatGPT setup guide](https://nagarjuna2997.github.io/ios-agent-skill/install.html#chatgpt) for account requirements and connection limits.
+
+### Gemini CLI
+
+```bash
+gemini mcp add ios-agent -- npx -y ios-agent-mcp@latest
+```
+
+This adds a local MCP connection; Gemini web chat is a different product. The repository extension additionally supplies `GEMINI.md`, but its version pin must be available on npm before installing it. Use one connection method to avoid duplicate tools. [Gemini setup and verification](https://nagarjuna2997.github.io/ios-agent-skill/install.html#gemini).
+
+### Muse Code
+
+Install outside the agent sandbox:
+
+```bash
+npm install -g ios-agent-mcp@latest
+```
+
+Merge this into `~/.config/muse/settings.json`, preserving your existing settings:
 
 ```json
 {
+  "schema_version": 1,
   "mcpServers": {
     "ios-agent": {
-      "command": "npx",
-      "args": ["-y", "ios-agent-mcp"]
+      "command": "ios-agent-mcp",
+      "args": []
     }
   }
 }
 ```
 
+Restart Muse. If the executable is not found, use its absolute path from `command -v ios-agent-mcp`. MCP discovery and a Stop hook have been verified; complete model-driven app creation has not. [Muse setup and evidence](https://nagarjuna2997.github.io/ios-agent-skill/install.html#muse).
+
+### Other clients, including Cursor
+
+Our primary client families are **Claude, ChatGPT/Codex, Gemini CLI and Muse**. Cursor and other MCP-compatible clients may use the generic `mcpServers` configuration shown above, but are not actively verified in this support scope. [Request another client or vote on an existing issue](https://github.com/Nagarjuna2997/ios-agent-skill/issues/new?template=client_support.md).
+
 ### From source
 
 ```bash
 git clone https://github.com/Nagarjuna2997/ios-agent-skill.git
 cd ios-agent-skill/mcp-server
 npm install && npm run build
-# then point your client at: node /absolute/path/to/mcp-server/dist/index.js
+# then point your client at: node /absolute/path/to/mcp-server/dist/unified.js
 ```
 
 ---
@@ -114,7 +161,7 @@ npm install && npm run build
 | `review_swift_architecture` | Live-implementation default arguments, presentation naming `URLSession`/`APIClient`/`ModelContext`, singletons in view models, domain importing SwiftUI, nested `NavigationStack`, `NavigationView` |
 | `review_swiftui` | Fixed font sizes and heights, `AnyView`, `.cornerRadius`, literal spacing, materials over solid backgrounds, view state on models, `ObservableObject`, `@EnvironmentObject`, `try!` |
 | `check_availability_guards` | Missing guards, **over-restrictive guards** (an iOS 26 API guarded at iOS 27 silently drops every iOS 26 device), Foundation Models without a runtime availability check |
-| `audit_app_store_readiness` | Permission frameworks with no Info.plist purpose string, missing `PrivacyInfo.xcprivacy`, unlocalized strings, unlabeled icon buttons, `print()` |
+| `audit_app_store_readiness` | Permission frameworks with no Info.plist purpose string, missing `PrivacyInfo.xcprivacy`, unlocalized strings, unlabeled icon buttons, `print()`; source builds also check launch configuration, storyboards and assets |
 | `review_swift_memory` | Repeating `Timer` and `NotificationCenter` blocks capturing self, Combine sinks, non-`weak` delegates, stored closures, `unowned self` |
 | `review_swift_security` | Hardcoded secrets, credentials in `UserDefaults`, disabled ATS, cleartext HTTP, TLS trust accepted without evaluation, MD5/SHA-1, Keychain accessibility |
 | `review_swift_testing` | **Test files only.** Sleeping, tests with no assertion, live `URLSession`, `await` in an `XCTAssert` autoclosure, order-dependent static state |
@@ -270,8 +317,27 @@ MIT — see [LICENSE](./LICENSE).
 
 ## App-building loop preview (source checkout)
 
-The CLI now provides `loop init`, `loop resume` and `loop status` alongside the unified MCP connection. See the [workflow guide](../docs/tooling/app-building-loop.md) and [reading-list demo](../samples/ReadingList/README.md) for reproducible acceptance checks, bounded Claude repairs, simulator evidence and saved progress. Real Claude repair is not yet integration-verified; the published npm version does not include this preview.
+The CLI now provides `loop init`, `loop resume` and `loop status` alongside the unified MCP connection. See the [workflow guide](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/tooling/app-building-loop.md) and [reading-list demo](../samples/ReadingList/README.md) for reproducible acceptance checks, bounded Claude repairs, simulator evidence and saved progress. Real Claude repair is not yet integration-verified; the published npm version does not include this preview.
 
 ## 2.6.0
 
 Adds `review_app_intents` with conservative SiriKit migration advice and opt-in Apple Intelligence schema/onscreen checks. Apple snapshots refreshed after the iOS 27 release. Includes the preview `loop` CLI; real Claude repair remains unverified. See [release verification](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/apple/ios-27-release-verification.md) and [complete tools](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/mcp/tools.md).
+
+## Local issue previews (2.7.0)
+
+`prepare_issue_report` is included in 2.7.0. It creates a local preview from fixed failure categories and links to this project’s issue tracker. It does not collect diagnostics, open a browser, make network calls or submit issues. Show the preview to the user before opening any link. GitHub sign-in and user submission are required.
+
+## Private chat feedback — experimental
+
+Version 2.7.1 includes `private_feedback` as a 37th tool. It requires an operator-configured HTTPS receiver, a local preview, and explicit user approval before sending fixed categories to a private repository. Hosting is not configured; private delivery is not live by default. No user GitHub sign-in is needed once deployed. No source, logs or credentials are accepted, and there is no automatic public fallback. See [the reporting workflow](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/tooling/issue-reporting.md).
+
+### Launch-screen review (2.7.1)
+
+The existing App Store audit and project analysis include target-aware static launch-screen checks. Unresolved settings are reported as coverage gaps. See [checks and limitations](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/tooling/launch-screen-review.md). Included in npm 2.7.1.
+
+### Local release-package foundation (2.7.1)
+
+`npx -y ios-agent-mcp@latest apple analyze|prepare --project /path/to/app --target App --configuration Release --json`
+collects selected-target facts, conservative feature/screen candidates, questions
+and hashed local draft packages. No Apple connection, AI provider, build, upload
+or submission is performed. See the [Phase 1 workflow and limitations](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/tooling/local-release-package.md).