docs: add Build an integration and extend the stability contract

[datlechin]

Why

Integrators had no page that says which surface fits a job, how to find the app without a path check, or what stays stable beyond MCP and the URL scheme. The iOS page also claimed deep links work as on the Mac, and iOS answers only two of them.

Change

• Developers > Overview is now "Build an integration": a job-to-surface table, finding the app by bundle ID com.TablePro (Swift, shell, Raycast), the stability table and the security model.
• Versioning covers links on Mac and iOS, database URLs, AppleScript terms and codes, MCP and pairing, the tablepro command, the bundle ID, the tablepro-mcp path and port 23508, and lists the plist, Keychain items, SQLite databases and install location as not covered.
• URL scheme gains an iPhone and iPad section and a generic pairing example, and no longer points at the handshake file.

Verified

verify.sh docs, mint validate and mint broken-links --check-anchors pass. Claims checked against DeeplinkParser, SceneIntent, ConnectionURLParser, TabRouter, CommandLineToolInstaller, TablePro.sdef and MCPSettings. The Swift and shell samples ran locally.

Not in this PR

• The pairing.mdx sample still reads mcp-handshake.json; the pairing response-mode PR replaces it.
• New lines say Settings > Integrations; the pane rename PR needs to cover them.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
TablePro	🟢 Ready	View Preview	Oct 10, 2026, 9:12 AM

💡 Tip: Enable Automations to automatically generate PRs for you.