@heznpc/imcp 1.1.0 → 1.3.0

package/README.md

@@ -4,21 +4,99 @@ MCP server for the entire Apple ecosystem — Notes, Reminders, Calendar, Contac
 
 > [한국어](README.ko.md)
 
-## Features
-
-- **110 tools** across 13 modules — full CRUD for Apple apps + system control + Apple Intelligence
-- **20 prompts** — per-app workflows + cross-module + developer workflows (dev-session, debug-loop, build-log)
-- **4 MCP Resources** — live data URIs for notes, calendar, and reminders
-- **JXA + Swift bridge** — JXA for core automation, EventKit/PhotoKit via Swift for advanced features
-- **Recurring events/reminders** — create recurrence rules via EventKit (macOS 26+ Swift bridge)
-- **Photos import/delete** — import and delete photos via PhotoKit (macOS 26+ Swift bridge)
-- **Apple Intelligence** — on-device summarization, rewriting, proofreading (macOS 26+)
-- **Native menubar app** — SwiftUI companion app for status monitoring, permission setup, config copy
-- **One-click setup** — `setup_permissions` tool or menubar app triggers all macOS permission prompts at once
-- **Dual transport** — stdio (default, secure local) + HTTP/SSE (`--http`) for remote agents and registries
-- **Safety annotations** — every tool tagged with readOnly/destructive hints
-
-## Quick Start
+## Get Started (2 minutes)
+
+### 1. Install Node.js
+
+If you don't have Node.js, install it first:
+
+```bash
+# Using Homebrew (recommended)
+brew install node
+
+# Or download from https://nodejs.org (LTS version)
+```
+
+### 2. Run the Setup Wizard
+
+```bash
+npx @heznpc/imcp init
+```
+
+This will:
+- Let you choose which Apple apps to connect (Notes, Calendar, Reminders, etc.)
+- Automatically configure Claude Desktop
+- Save your preferences to `~/.config/imcp/config.json`
+
+### 3. Restart Claude Desktop
+
+That's it! Claude can now read your notes, manage reminders, check your calendar, and more.
+
+### Troubleshooting
+
+```bash
+npx @heznpc/imcp doctor
+```
+
+Checks Node.js version, config files, Claude Desktop setup, macOS permissions, and module status — all in one command.
+
+---
+
+## What Can It Do?
+
+**122 tools** across 14 Apple app modules + semantic search, **9 MCP resources**, and **20 prompts**:
+
+| Module | What it does | Tools |
+|--------|-------------|-------|
+| **Notes** | Read, create, search, organize notes and folders | 12 |
+| **Reminders** | Create tasks, set due dates, manage lists | 11 |
+| **Calendar** | View events, create meetings, check schedule | 10 |
+| **Contacts** | Look up people, manage contact info | 10 |
+| **Mail** | Read, search, send, reply to emails | 11 |
+| **Music** | Control playback, search tracks, manage playlists | 9 |
+| **Finder** | Browse files, search with Spotlight, organize | 8 |
+| **Safari** | Read web pages, manage tabs | 8 |
+| **System** | Clipboard, volume, dark mode, screenshots, notifications | 10 |
+| **Photos** | Browse albums, import/delete photos | 9 |
+| **Messages** | View chats, send iMessages | 6 |
+| **Shortcuts** | Run Siri Shortcuts from AI | 4 |
+| **Intelligence** | On-device summarize, rewrite, proofread (macOS 26+) | 3 |
+| **TV** | Browse library, control playback, search content | 6 |
+| **Semantic** | On-device cross-app semantic search (Swift bridge) | 4 |
+
+All tools include MCP annotations (`readOnlyHint`, `destructiveHint`, `openWorldHint`) for client-side safety UI.
+
+## Module Presets
+
+By default, new installations start with 5 core modules (Notes, Reminders, Calendar, Shortcuts, System) to keep things simple. You can enable more anytime:
+
+```bash
+# Re-run the setup wizard to change modules
+npx @heznpc/imcp init
+
+# Or enable all modules at once
+npx @heznpc/imcp --full
+```
+
+Or edit `~/.config/imcp/config.json` directly:
+
+```json
+{
+  "disabledModules": ["messages", "intelligence"]
+}
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx @heznpc/imcp init` | Interactive setup wizard |
+| `npx @heznpc/imcp doctor` | Diagnose installation issues |
+| `npx @heznpc/imcp` | Start MCP server (stdio, default) |
+| `npx @heznpc/imcp --full` | Start with all 13 modules enabled |
+| `npx @heznpc/imcp --http` | Start as HTTP server (port 3847) |
+
+## Alternative Setup (Manual)
 
 ### Claude Desktop
 
@@ -48,37 +126,100 @@ git clone https://github.com/heznpc/iMcp.git
 cd iMcp
 npm install
 npm run build
+node dist/index.js
 ```
 
-### Menubar App (Optional)
+## Configuration
 
-A native SwiftUI companion app for server status monitoring and permission setup.
+### Environment Variables
 
-```bash
-cd app && swift build -c release
-# Binary: app/.build/release/iMcpApp
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `IMCP_INCLUDE_SHARED` | `false` | Include shared notes/folders |
+| `IMCP_ALLOW_SEND_MESSAGES` | `true` | Allow sending iMessages |
+| `IMCP_ALLOW_SEND_MAIL` | `true` | Allow sending emails |
+| `IMCP_FULL` | `false` | Enable all modules (ignores preset) |
+| `IMCP_DISABLE_{MODULE}` | — | Disable a specific module (e.g. `IMCP_DISABLE_MUSIC=true`) |
+| `GEMINI_API_KEY` | — | Google Gemini API key for higher-quality embeddings (optional) |
+
+### Config File
+
+`~/.config/imcp/config.json`:
+
+```json
+{
+  "disabledModules": ["messages", "intelligence"],
+  "includeShared": false,
+  "allowSendMessages": true,
+  "allowSendMail": true,
+  "hitl": {
+    "level": "destructive-only",
+    "timeout": 30
+  }
+}
 ```
 
-Features: server status indicator, one-click permission setup, copy Claude config to clipboard.
+## Advanced Features
 
 ### HTTP Mode
 
-Run iMcp as an HTTP server for remote agents, Smithery registry, or multi-client setups:
+Run iMcp as an HTTP server for remote agents or multi-client setups:
 
 ```bash
 npx @heznpc/imcp --http --port 3847
 ```
 
-- Endpoint: `POST/GET/DELETE /mcp`
-- Transport: Streamable HTTP with SSE (MCP spec 2024-11-05)
-- Session management via `Mcp-Session-Id` header
-- Default port: 3847
+### Human-in-the-Loop (HITL)
+
+Require manual approval before destructive operations:
+
+```json
+{
+  "hitl": {
+    "level": "destructive-only",
+    "timeout": 30
+  }
+}
+```
+
+Levels: `off`, `destructive-only`, `all-writes`, `all`
+
+### Menubar App (Optional)
+
+A native SwiftUI companion app for server status monitoring and permission setup:
+
+```bash
+cd app && swift build -c release
+```
+
+### Semantic Search (Optional)
+
+On-device cross-app semantic search powered by Apple's NLContextualEmbedding. Find related notes, events, reminders, and emails by meaning — not just keywords.
+
+```bash
+npm run swift-build  # Build the Swift bridge first
+```
+
+Then use the tools:
+1. `semantic_index` — Index data from enabled Apple apps into a local vector store
+2. `semantic_search` — Search by meaning across all indexed data
+3. `find_related` — Find items related to a specific note/event/reminder
+4. `semantic_status` — Check index status
+
+Supports Korean, English, Japanese, Chinese with automatic language detection. Optionally set `GEMINI_API_KEY` for higher-quality Google Gemini embeddings.
+
+### Swift Bridge (Optional)
+
+For semantic search, recurring events/reminders (EventKit), photo import/delete (PhotoKit), and Apple Intelligence — requires macOS 26+:
 
-Useful for Mac Mini "always-on AI hub" setups where remote agents connect over the network.
+```bash
+npm run swift-build
+```
 
-## Tools
+## Tools Reference
 
-### Notes (12 tools)
+<details>
+<summary>Notes (12 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -94,8 +235,10 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `scan_notes` | Bulk scan with metadata and preview | read |
 | `compare_notes` | Compare 2-5 notes side by side | read |
 | `bulk_move_notes` | Move multiple notes at once | destructive |
+</details>
 
-### Reminders (11 tools)
+<details>
+<summary>Reminders (11 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -110,8 +253,10 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `create_reminder_list` | Create a new reminder list | write |
 | `delete_reminder_list` | Delete a reminder list | destructive |
 | `create_recurring_reminder` | Create with recurrence rule (Swift/EventKit) | write |
+</details>
 
-### Calendar (10 tools)
+<details>
+<summary>Calendar (10 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -125,8 +270,10 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `get_upcoming_events` | Next N events from now | read |
 | `today_events` | All events for today | read |
 | `create_recurring_event` | Create with recurrence rule (Swift/EventKit) | write |
+</details>
 
-### Contacts (10 tools)
+<details>
+<summary>Contacts (10 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -140,8 +287,10 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `add_contact_email` | Add email to existing contact | write |
 | `add_contact_phone` | Add phone to existing contact | write |
 | `list_group_members` | List contacts in a group | read |
+</details>
 
-### Mail (9 tools)
+<details>
+<summary>Mail (9 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -154,8 +303,10 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `get_unread_count` | Total unread across all mailboxes | read |
 | `move_message` | Move message to another mailbox | destructive |
 | `list_accounts` | List all mail accounts | read |
+</details>
 
-### Music (9 tools)
+<details>
+<summary>Music (9 tools)</summary>
 
 | Tool | Description | Type |
 |------|-------------|------|
@@ -168,102 +319,13 @@ Useful for Mac Mini "always-on AI hub" setups where remote agents connect over t
 | `play_playlist` | Start playing a playlist | write |
 | `get_track_info` | Detailed track metadata | read |
 | `set_shuffle` | Set shuffle and repeat mode | write |
+</details>
 
-### Finder (8 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `search_files` | Spotlight search in a folder | read |
-| `get_file_info` | File size, dates, kind, tags | read |
-| `set_file_tags` | Set Finder tags on a file | destructive |
-| `recent_files` | Recently modified files | read |
-| `list_directory` | List files in a directory | read |
-| `move_file` | Move or rename a file | destructive |
-| `trash_file` | Move file to Trash | destructive |
-| `create_directory` | Create a new directory | write |
-
-### Safari (8 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `list_tabs` | List all open tabs across windows | read |
-| `read_page_content` | Read text content of a page | read |
-| `get_current_tab` | Get the active tab URL and title | read |
-| `open_url` | Open a URL in Safari | write |
-| `close_tab` | Close a specific tab | destructive |
-| `activate_tab` | Switch to a specific tab | write |
-| `run_javascript` | Execute JavaScript in a tab | write |
-| `search_tabs` | Search tabs by title or URL | read |
-
-### System (10 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `get_clipboard` | Read clipboard contents | read |
-| `set_clipboard` | Write to clipboard | write |
-| `get_volume` | Get system volume level | read |
-| `set_volume` | Set system volume level | write |
-| `toggle_dark_mode` | Toggle dark/light mode | write |
-| `get_frontmost_app` | Get the frontmost application | read |
-| `list_running_apps` | List all running applications | read |
-| `get_screen_info` | Get display information | read |
-| `show_notification` | Display a system notification | write |
-| `capture_screenshot` | Take a screenshot (fullscreen/window/selection) | write |
-
-### Photos (9 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `list_albums` | List photo albums | read |
-| `list_photos` | List photos in an album | read |
-| `search_photos` | Search photos by keyword | read |
-| `get_photo_info` | Detailed photo metadata | read |
-| `list_favorites` | List favorite photos | read |
-| `create_album` | Create a new album | write |
-| `add_to_album` | Add photos to an album | write |
-| `import_photo` | Import from file path (Swift/PhotoKit) | write |
-| `delete_photos` | Delete photos by ID (Swift/PhotoKit) | destructive |
-
-### Messages (6 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `list_chats` | List recent chats with participants | read |
-| `read_chat` | Read chat details including participants and last update | read |
-| `search_chats` | Search by name, participant, or handle | read |
-| `send_message` | Send text via iMessage/SMS | write |
-| `send_file` | Send file attachment via iMessage/SMS | write |
-| `list_participants` | List participants in a chat | read |
+<details>
+<summary>Finder, Safari, System, Photos, Messages, Shortcuts, Intelligence</summary>
 
-### Shortcuts (4 tools)
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `list_shortcuts` | List available Shortcuts | read |
-| `run_shortcut` | Run a Shortcut by name | write |
-| `search_shortcuts` | Search shortcuts by name | read |
-| `get_shortcut_detail` | Get shortcut details/actions | read |
-
-### Apple Intelligence (3 tools)
-
-Requires macOS 26+ with Apple Silicon. Graceful error on unsupported systems.
-
-| Tool | Description | Type |
-|------|-------------|------|
-| `summarize_text` | On-device summarization | read |
-| `rewrite_text` | Rewrite in specified tone | read |
-| `proofread_text` | Grammar/spelling correction | read |
-
-## Resources
-
-MCP Resources expose live data from Apple apps as URIs.
-
-| URI | Description |
-|-----|-------------|
-| `notes://recent` | 10 most recent notes |
-| `notes://recent/{count}` | Recent notes (configurable count) |
-| `calendar://today` | Today's calendar events |
-| `reminders://due` | Overdue reminders |
+See the full tool list in the [Tools Reference](https://github.com/heznpc/iMcp/wiki/Tools-Reference) or run the server to explore via your AI client.
+</details>
 
 ## Prompts
 
@@ -281,103 +343,26 @@ MCP Resources expose live data from Apple apps as URIs.
 - **weekly-digest** — Past N days: events + notes + reminders combined
 - **meeting-notes-to-reminders** — Extract action items from meeting notes, create reminders
 - **event-follow-up** — Create follow-up note and reminders after a meeting
-- **research-with-safari** — Browse with Safari + save findings to Notes
-- **focus-session** — Calendar + Reminders + Music for focused work
-- **file-organizer** — Organize files with Finder + track in Notes
 
 ### Developer Workflows
 - **dev-session** — Scan project, check specs, research docs, create session notes
-- **debug-loop** — Capture errors from Safari/clipboard, locate code, log bugs, create fix tasks
-- **screen-capture-flow** — Screenshot → Photos import → annotated note
-- **app-release-prep** — Calendar dates + changelog from Notes + Reminders checklist
+- **debug-loop** — Capture errors from Safari/clipboard, locate code, log bugs
 - **idea-to-task** — Break idea into tasks → Reminders + Calendar time blocks
-- **build-log** — Analyze build output, log errors or celebrate success with Music
-
-## Developer Agent Pipeline
-
-iMcp's developer prompts chain Apple apps into autonomous agent workflows. Each prompt orchestrates multiple tools across modules — the AI reads your actual filesystem, Notes, Calendar, and Reminders to build real context, then writes back structured results.
-
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     dev-session                                 │
-│  Finder (scan) → Notes (specs) → Safari (docs) → Notes (log)   │
-└─────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────┐
-│                     debug-loop                                  │
-│  Safari (JS errors) → Clipboard → Finder (locate) →            │
-│  Notes (bug log) → Reminders (fix task)                         │
-└─────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────┐
-│                     idea-to-task                                 │
-│  Notes (capture) → AI (decompose) → Reminders (tasks) →        │
-│  Calendar (time blocks)                                         │
-└─────────────────────────────────────────────────────────────────┘
-
-┌─────────────────────────────────────────────────────────────────┐
-│                     build-log                                   │
-│  Finder (output) → Clipboard (log) →                            │
-│  ┌ fail → Notes (error log) → Reminders (fix task)              │
-│  └ pass → Notification → Music (celebrate) → Notes (success)    │
-└─────────────────────────────────────────────────────────────────┘
-```
-
-These prompts are designed for AI coding agents (Claude Code, Cursor, Copilot) to invoke as MCP prompts — turning your Mac into a context-aware development environment.
-
-> Demo video coming soon.
-
-## Configuration
-
-| Environment Variable | Default | Description |
-|---------------------|---------|-------------|
-| `IMCP_INCLUDE_SHARED` | `false` | Include shared notes/folders in results |
+- **build-log** — Analyze build output, log errors or celebrate success
 
 ## Requirements
 
 - macOS (Apple apps require macOS)
 - Node.js >= 18
-- First run will prompt for Automation permission for each app — use `setup_permissions` tool to grant all at once
 - Apple Intelligence tools require macOS 26+ with Apple Silicon
 
 ## Limitations
 
-### Notes
-- Move copies and deletes (new ID, reset dates, lost attachments)
-- Update replaces entire body. Read first to preserve content.
-- Password-protected notes unreadable.
-
-### Reminders / Calendar
-- JXA recurrence rules are read-only — use `create_recurring_event`/`create_recurring_reminder` (Swift/EventKit) to create recurring items
-- Calendar attendees are read-only
-
-### Contacts
-- Custom fields not accessible
-
-### Mail
-- Content truncated to 5000 characters by default (configurable via `maxLength` parameter)
-
-### Messages
-- Chat message history (individual message content) is not accessible via JXA
-- Send requires the recipient to be a known buddy in the Messages service
-
-### Music
-- Smart playlists are read-only
-- No queue manipulation
-
-### Finder
-- Tags use Spotlight (mdfind), performance varies with index state
-
-### Safari
-- Reading page content requires Allow JavaScript from Apple Events in Safari Developer menu
-
-### Photos
-- JXA: albums can be created and photos added, but no import/delete
-- Swift bridge (macOS 26+): full import and delete via PhotoKit
-
-### Apple Intelligence
-- Requires macOS 26 (Tahoe) + Apple Silicon
-- Run `npm run swift-build` to compile the bridge binary
+- **Notes**: Move copies and deletes (new ID, reset dates, lost attachments). Update replaces entire body.
+- **Calendar/Reminders**: JXA recurrence is read-only — use Swift bridge for recurring items.
+- **Messages**: Chat message history not accessible via JXA. Send requires known buddy.
+- **Safari**: Reading page content requires "Allow JavaScript from Apple Events" in Safari Developer menu.
+- **Photos**: Full import/delete requires Swift bridge (macOS 26+).
 
 ## License
 

package/dist/cli/doctor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `npx @heznpc/imcp doctor` — Diagnose iMcp installation.
+ *
+ * Checks: Node version, config files, Claude Desktop config,
+ * module status, and optionally probes macOS permissions.
+ */
+export declare function runDoctor(): Promise<void>;

package/dist/cli/doctor.js

@@ -0,0 +1,135 @@
+/**
+ * `npx @heznpc/imcp doctor` — Diagnose iMcp installation.
+ *
+ * Checks: Node version, config files, Claude Desktop config,
+ * module status, and optionally probes macOS permissions.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { MODULE_NAMES, STARTER_MODULES } from "../shared/config.js";
+const HOME = process.env.HOME ?? process.env.USERPROFILE ?? "";
+const CLAUDE_CONFIG_PATH = join(HOME, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+const IMCP_CONFIG_PATH = join(HOME, ".config", "imcp", "config.json");
+const OK = "\x1b[32m✓\x1b[0m";
+const WARN = "\x1b[33m⚠\x1b[0m";
+const FAIL = "\x1b[31m✗\x1b[0m";
+function check(label, status, detail) {
+    console.log(`  ${status} ${label.padEnd(22)} ${detail}`);
+}
+export async function runDoctor() {
+    console.log("");
+    console.log("\x1b[1m\x1b[36m  iMcp Doctor\x1b[0m");
+    console.log("");
+    // 1. Node version
+    const nodeVer = process.version;
+    const major = parseInt(nodeVer.slice(1), 10);
+    check("Node.js", major >= 18 ? OK : FAIL, `${nodeVer} ${major >= 18 ? "(>= 18 required)" : "— upgrade required (>= 18)"}`);
+    // 2. macOS check
+    const platform = process.platform;
+    check("Platform", platform === "darwin" ? OK : FAIL, platform === "darwin" ? "macOS" : `${platform} — iMcp requires macOS`);
+    // 3. Config file
+    let fileConfig = null;
+    if (existsSync(IMCP_CONFIG_PATH)) {
+        try {
+            fileConfig = JSON.parse(readFileSync(IMCP_CONFIG_PATH, "utf-8"));
+            check("Config file", OK, IMCP_CONFIG_PATH);
+        }
+        catch {
+            check("Config file", WARN, `${IMCP_CONFIG_PATH} (parse error)`);
+        }
+    }
+    else {
+        check("Config file", WARN, "Not found — using starter preset (5 modules)");
+    }
+    // 4. Claude Desktop config
+    if (existsSync(CLAUDE_CONFIG_PATH)) {
+        try {
+            const raw = JSON.parse(readFileSync(CLAUDE_CONFIG_PATH, "utf-8"));
+            const servers = raw?.mcpServers ?? {};
+            if (servers.imcp) {
+                check("Claude Desktop", OK, "imcp entry found");
+            }
+            else {
+                check("Claude Desktop", WARN, "Config exists but no 'imcp' entry — run: npx @heznpc/imcp init");
+            }
+        }
+        catch {
+            check("Claude Desktop", WARN, `Config parse error: ${CLAUDE_CONFIG_PATH}`);
+        }
+    }
+    else {
+        check("Claude Desktop", WARN, "Config not found — run: npx @heznpc/imcp init");
+    }
+    // 5. Enabled modules
+    const disabledSet = new Set(fileConfig?.disabledModules ?? []);
+    const enabledMods = [];
+    const disabledMods = [];
+    for (const mod of MODULE_NAMES) {
+        if (fileConfig) {
+            // Explicit config
+            if (disabledSet.has(mod)) {
+                disabledMods.push(mod);
+            }
+            else {
+                enabledMods.push(mod);
+            }
+        }
+        else {
+            // Starter preset
+            if (STARTER_MODULES.has(mod)) {
+                enabledMods.push(mod);
+            }
+            else {
+                disabledMods.push(mod);
+            }
+        }
+    }
+    console.log("");
+    console.log(`  \x1b[1mModules\x1b[0m (${enabledMods.length} enabled, ${disabledMods.length} disabled)`);
+    for (const mod of MODULE_NAMES) {
+        const on = enabledMods.includes(mod);
+        console.log(`    ${on ? OK : "\x1b[2m-\x1b[0m"} ${mod}${on ? "" : " \x1b[2m(disabled)\x1b[0m"}`);
+    }
+    // 6. Permission probe (macOS only, skip if not darwin)
+    if (platform === "darwin") {
+        console.log("");
+        console.log("  \x1b[1mPermissions\x1b[0m");
+        const APP_MAP = {
+            notes: "Notes",
+            reminders: "Reminders",
+            calendar: "Calendar",
+            contacts: "Contacts",
+            mail: "Mail",
+            messages: "Messages",
+            music: "Music",
+            finder: "Finder",
+            safari: "Safari",
+            system: "System Events",
+            photos: "Photos",
+            tv: "TV",
+        };
+        for (const mod of enabledMods) {
+            const appName = APP_MAP[mod];
+            if (!appName)
+                continue;
+            try {
+                execSync(`osascript -l JavaScript -e "Application('${appName}'); JSON.stringify({ok:true})"`, { timeout: 5000, stdio: "pipe" });
+                check(`  ${appName}`, OK, "Accessible");
+            }
+            catch {
+                check(`  ${appName}`, WARN, "Not accessible — grant permission in System Settings > Privacy");
+            }
+        }
+    }
+    // 7. Swift bridge
+    const swiftBridgePath = join(process.cwd(), "swift", ".build", "release", "imcp-bridge");
+    if (existsSync(swiftBridgePath)) {
+        check("Swift bridge", OK, "Built");
+    }
+    else {
+        check("Swift bridge", WARN, "Not built — run: npm run swift-build (optional, for EventKit/PhotoKit/Intelligence)");
+    }
+    console.log("");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/init.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `npx @heznpc/imcp init` — Interactive setup wizard.
+ *
+ * 1. Choose modules (toggle-style)
+ * 2. Write ~/.config/imcp/config.json
+ * 3. Patch Claude Desktop config (auto-detect path)
+ */
+export declare function runInit(): Promise<void>;