feat(mcp): refactor to in-app HTTP server — v6.2.0 (build 96)

Replace the v6.1.0 helper-binary + stdio + URL-scheme + status-polling
architecture with a single in-process HTTP MCP server. Same 13 tools,
same one-click installer, but the entire pipeline now lives inside the
running app and works identically on App Store builds.

New:
- MCPHTTPServer (swift-nio + StatefulHTTPServerTransport) binds to
  127.0.0.1:8765 at /mcp, auto-retries higher ports if 8765 is taken.
- MCPToolRegistry owns the 13 tool definitions and dispatches each to
  direct calls into FrameHistoryDatabase / AstroRootStore / ArchiveScanner
  / TriageViewModel (via MCPViewModelBridge). No indirection, no polling.
- FrameHistoryDatabase+MCP extension hosts the per-tool query methods
  (listSetupsForMCP, qualitySummaryForMCP, etc.) returning plain Codable
  result structs.
- MCPConnectorWindow now shows the running endpoint URL with a live
  preflight, plus a "Test Connection" button that round-trips an
  initialize request to prove the server's up.
- com.apple.security.network.server entitlement on the app, so a
  sandboxed App Store build can also accept localhost connections.

Removed:
- AstroBlinkMCPServer standalone tool target and the entire MCPServer/
  directory.
- "Embed AstroBlinkMCPServer" postBuildScript + SKIP_MCP_HELPER switch.
- astroblink://scan and astroblink://mark-garbage URL verbs.
- MCPCommandRunner.swift, MCPCommandStatus.swift, the
  saveMCPCommandStatus / updateMCPProgress / autoGarbageCandidates-via-
  polling helpers.

Migration:
- No user action. The mcp_command_status table is now unused; left in
  place to avoid an immediate v11 migration.
- Old Claude Desktop configs pointing at the v6.1.0 helper binary are
  inert. Re-run "Install to Claude Desktop" from MCP Connector to
  overwrite with the new URL form.

kAlgorithmVersion unchanged. Tested end-to-end: app launches, server
binds, MCP initialize/tools/list/tools/call ping all succeed.

Author: joergs-git

AstroTriage.xcodeproj/project.pbxproj

@@ -5,73 +5,23 @@ import SwiftUI
 let appStoreURL = "https://apps.apple.com/app/astroblinkv2/id6760241266?mt=12"
 
 // Singleton handler registered before SwiftUI takes over the event pipeline.
-// Handles all astroblink:// verbs:
-//   open?folder=<path>                                 — open a folder (existing)
-//   scan?root=<path>&id=<uuid>                         — MCP: start headless scan
-//   mark-garbage?id=<uuid>&setup=<hash>&night=<date>   — MCP: identify/mark garbage
-//                       &dry_run=true|false
+// astroblink://open?folder=<path> — legacy "open a folder" verb.
+//
+// The v6.1.0 scan/mark-garbage URL verbs were removed in v6.2.0: MCP now uses
+// an in-process HTTP server (see MCPHTTPServer.swift), so external callers
+// don't need to round-trip via URL scheme + polling anymore.
 class URLSchemeHandler: NSObject {
     static let shared = URLSchemeHandler()
     @objc func handleGetURL(_ event: NSAppleEventDescriptor, withReply reply: NSAppleEventDescriptor) {
         guard let urlString = event.paramDescriptor(forKeyword: AEKeyword(keyDirectObject))?.stringValue,
               let url = URL(string: urlString),
               url.scheme == "astroblink",
               let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
-              let host = components.host else { return }
-        let params = (components.queryItems ?? []).reduce(into: [String: String]()) { acc, item in
-            if let v = item.value { acc[item.name] = v }
-        }
-
-        // Defer to allow AppKit/SwiftUI to finish launching when the URL arrives
-        // immediately at startup. Once running, the dispatch is essentially a no-op.
+              components.host == "open",
+              let folderPath = components.queryItems?.first(where: { $0.name == "folder" })?.value else { return }
+        let folderURL = URL(fileURLWithPath: folderPath)
         DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) {
-            switch host {
-            case "open":
-                guard let folder = params["folder"] else { return }
-                NotificationCenter.default.post(
-                    name: .openFolderAtPath, object: URL(fileURLWithPath: folder))
-
-            case "scan":
-                guard let root = params["root"], let id = params["id"] else { return }
-                // Insert pending status so the MCP server poller sees state="pending"
-                // immediately, even before the runner picks up the notification.
-                let status = MCPCommandStatus(
-                    commandId: id, verb: "scan", state: "pending",
-                    startedAt: MCPCommandStatus.nowISO8601(), completedAt: nil,
-                    progressCurrent: 0, progressTotal: 0,
-                    resultSummary: nil, errorMessage: nil
-                )
-                try? FrameHistoryDatabase.shared.saveMCPCommandStatus(status)
-                _ = MCPCommandRunner.shared  // ensure observers registered
-                NotificationCenter.default.post(
-                    name: .mcpScanRequested, object: nil,
-                    userInfo: ["rootPath": root, "commandId": id])
-
-            case "mark-garbage":
-                guard let id = params["id"] else { return }
-                let setupHash = params["setup"]
-                let night = params["night"]
-                let dryRun = (params["dry_run"] ?? "true").lowercased() != "false"
-                let status = MCPCommandStatus(
-                    commandId: id, verb: "mark-garbage", state: "pending",
-                    startedAt: MCPCommandStatus.nowISO8601(), completedAt: nil,
-                    progressCurrent: 0, progressTotal: 0,
-                    resultSummary: nil, errorMessage: nil
-                )
-                try? FrameHistoryDatabase.shared.saveMCPCommandStatus(status)
-                _ = MCPCommandRunner.shared
-                NotificationCenter.default.post(
-                    name: .mcpMarkGarbageRequested, object: nil,
-                    userInfo: [
-                        "commandId": id,
-                        "setupHash": setupHash as Any,
-                        "night": night as Any,
-                        "dryRun": dryRun
-                    ])
-
-            default:
-                break  // unknown verb — silently ignore
-            }
+            NotificationCenter.default.post(name: .openFolderAtPath, object: folderURL)
         }
     }
 }
@@ -372,9 +322,9 @@ class AstroBlinkV2AppDelegate: NSObject, NSApplicationDelegate {
         // Initialize Frame History database (local SQLite only — instant)
         if !isTestHost {
             _ = FrameHistoryDatabase.shared
-            // Register MCP notification observers up front so any astroblink://
-            // URL fired during early launch sees a runner ready to handle it.
-            _ = MCPCommandRunner.shared
+            // Start the in-process HTTP MCP server so external clients
+            // (Claude Code, Claude Desktop) can connect on localhost:8765.
+            MCPHTTPServer.shared.start()
         }
 
         DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {

AstroTriage.xcodeproj/xcshareddata/xcschemes/AstroBlinkMCPServer.xcscheme

@@ -27,5 +27,7 @@
 	<true/>
 	<key>com.apple.security.network.client</key>
 	<true/>
+	<key>com.apple.security.network.server</key>
+	<true/>
 </dict>
 </plist>