diff --git a/POLICY.md b/POLICY.md index e0e3419..659faf9 100644 --- a/POLICY.md +++ b/POLICY.md @@ -1,6 +1,6 @@ # Listing policy -Version 1, effective 2026-10-10. +Version 2, effective 2026-11-08. This policy decides what appears in the TablePro integration directory at [tablepro.app/integrations](https://tablepro.app/integrations) and in this repository's published data. @@ -28,7 +28,7 @@ An integration uses only the interfaces in the [developer docs](https://docs.tab It never reads, writes or deletes TablePro's private files: `connections.json`, `com.TablePro.plist`, `mcp-handshake.json`, TablePro's Keychain items or its SQLite databases. There is no exception and no grace period for new entries. CI scans open-source entries for these paths. -It finds TablePro by bundle identifier `com.TablePro`, not by a fixed install path. +It finds TablePro by bundle identifier `com.TablePro` on a Mac and app ID `app.tablepro.TablePro` on Linux, not by a fixed install path. ## 5. License and source @@ -40,7 +40,7 @@ There is no minimum number of stars, installs or downloads. ## 6. Safety settings -An integration may open connections with Safe Mode below the user's default only for local development environments, such as `safeModeLevel=0` for a database on the same Mac. The entry discloses it, and the directory shows it on the entry page. +An integration may open connections with Safe Mode below the user's default only for local development environments, such as `safeModeLevel=0` for a database on the same computer. The entry discloses it, and the directory shows it on the entry page. ## 7. Disclosures @@ -48,7 +48,7 @@ Every entry states: - what it reads from TablePro (connection list, schema, row data) and what it writes (data, schema); - whether it lowers Safe Mode; -- where it sends data: nowhere, this Mac only, or the internet, and to whom; +- where it sends data: nowhere, this computer only, or the internet, and to whom; - whether it needs an account with another service, with a privacy policy link; - whether it is free, has optional payment, or is paid. diff --git a/integrations/claude-code/icon.png b/integrations/claude-code/icon.png index 1b465c1..173ad2a 100644 Binary files a/integrations/claude-code/icon.png and b/integrations/claude-code/icon.png differ diff --git a/integrations/claude-code/integration.json b/integrations/claude-code/integration.json index 604b885..966dc7b 100644 --- a/integrations/claude-code/integration.json +++ b/integrations/claude-code/integration.json @@ -4,7 +4,7 @@ "slug": "claude-code", "name": "Claude Code", "summary": "Connect Claude Code to your databases through the MCP server built into TablePro.", - "description": "Claude Code runs the bundled tablepro-mcp bridge as a local MCP server. Setup is one claude mcp add command.", + "description": "On a Mac, Claude Code runs the bundled tablepro-mcp bridge as a local MCP server. On Linux, it connects to TablePro's MCP server over HTTP on 127.0.0.1 with an access token. Setup is one claude mcp add command.", "tier": "official", "status": { "state": "active" @@ -31,10 +31,12 @@ "url": "https://claude.com/product/claude-code" }, "minTableProVersion": { - "macos": "0.37.0" + "macos": "0.37.0", + "linux": "0.1.0-beta.1" }, "platforms": [ - "macos" + "macos", + "linux" ], "categories": [ "ai-clients", @@ -53,7 +55,7 @@ "data", "schema" ], - "accessNote": "Uses the Read & Write token of the bundled bridge. Each connection's External Clients level and Safe Mode still apply.", + "accessNote": "On a Mac it uses the Read & Write token of the bundled bridge, on Linux the access token from the MCP page of Preferences. Each connection's External Clients level and Safe Mode still apply.", "lowersSafeMode": false, "network": "internet", "networkNote": "Claude Code sends tool results, such as connection names, schemas and rows, to its model provider.", @@ -74,5 +76,5 @@ "ai" ], "addedAt": "2026-10-10", - "lastVerifiedAt": "2026-10-10" + "lastVerifiedAt": "2026-11-08" } diff --git a/integrations/claude-desktop/icon.png b/integrations/claude-desktop/icon.png index 1b465c1..173ad2a 100644 Binary files a/integrations/claude-desktop/icon.png and b/integrations/claude-desktop/icon.png differ diff --git a/integrations/cursor/icon.png b/integrations/cursor/icon.png index 1b465c1..052b090 100644 Binary files a/integrations/cursor/icon.png and b/integrations/cursor/icon.png differ diff --git a/integrations/zed/icon.png b/integrations/zed/icon.png index 1b465c1..959403c 100644 Binary files a/integrations/zed/icon.png and b/integrations/zed/icon.png differ diff --git a/integrations/zed/integration.json b/integrations/zed/integration.json index 89bbea6..b799dce 100644 --- a/integrations/zed/integration.json +++ b/integrations/zed/integration.json @@ -4,7 +4,7 @@ "slug": "zed", "name": "Zed", "summary": "Connect Zed's agent to your databases through the MCP server built into TablePro.", - "description": "Zed runs the bundled tablepro-mcp bridge as a local MCP server. Setup is one entry under context_servers in Zed's settings file.", + "description": "On a Mac, Zed runs the bundled tablepro-mcp bridge as a local MCP server. On Linux, it connects to TablePro's MCP server over HTTP on 127.0.0.1 with an access token. Setup is one entry under context_servers in Zed's settings file.", "tier": "official", "status": { "state": "active" @@ -31,10 +31,12 @@ "url": "https://zed.dev" }, "minTableProVersion": { - "macos": "0.37.0" + "macos": "0.37.0", + "linux": "0.1.0-beta.1" }, "platforms": [ - "macos" + "macos", + "linux" ], "categories": [ "ai-clients", @@ -53,7 +55,7 @@ "data", "schema" ], - "accessNote": "Uses the Read & Write token of the bundled bridge. Each connection's External Clients level and Safe Mode still apply.", + "accessNote": "On a Mac it uses the Read & Write token of the bundled bridge, on Linux the access token from the MCP page of Preferences. Each connection's External Clients level and Safe Mode still apply.", "lowersSafeMode": false, "network": "internet", "networkNote": "Zed sends tool results, such as connection names, schemas and rows, to its model provider.", @@ -73,5 +75,5 @@ "ai" ], "addedAt": "2026-10-10", - "lastVerifiedAt": "2026-10-10" + "lastVerifiedAt": "2026-11-08" } diff --git a/schema/integration.schema.json b/schema/integration.schema.json index de770fb..d9c2225 100644 --- a/schema/integration.schema.json +++ b/schema/integration.schema.json @@ -159,9 +159,10 @@ "additionalProperties": false, "minProperties": 1, "properties": { - "macos": { "$ref": "#/$defs/version" }, - "ios": { "$ref": "#/$defs/version" }, - "ipados": { "$ref": "#/$defs/version" } + "macos": { "$ref": "#/$defs/appVersion" }, + "linux": { "$ref": "#/$defs/appVersion" }, + "ios": { "$ref": "#/$defs/appVersion" }, + "ipados": { "$ref": "#/$defs/appVersion" } } }, "platforms": { @@ -169,7 +170,7 @@ "type": "array", "minItems": 1, "uniqueItems": true, - "items": { "enum": ["macos", "ios", "ipados"] } + "items": { "enum": ["macos", "linux", "ios", "ipados"] } }, "categories": { "type": "array", @@ -310,6 +311,11 @@ "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?$" }, + "appVersion": { + "description": "A TablePro release. TablePro for Linux ships betas before 0.1.0, such as 0.1.0-beta.1.", + "type": "string", + "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)(?:\\.(?:0|[1-9][0-9]*))?(?:-(?:alpha|beta|rc)\\.(?:0|[1-9][0-9]*))?$" + }, "statusActive": { "type": "object", "additionalProperties": false, @@ -515,7 +521,7 @@ }, "safeModeNote": { "allOf": [{ "$ref": "#/$defs/plainLine" }], "maxLength": 200 }, "network": { - "description": "Where the integration itself sends data, besides TablePro and the user's databases. local means this Mac only.", + "description": "Where the integration itself sends data, besides TablePro and the user's databases. local means this computer only.", "enum": ["none", "local", "internet"] }, "networkNote": { "allOf": [{ "$ref": "#/$defs/plainLine" }], "maxLength": 200 }, diff --git a/scripts/tests/test_validate.py b/scripts/tests/test_validate.py index 6b623e1..b31b8ee 100644 --- a/scripts/tests/test_validate.py +++ b/scripts/tests/test_validate.py @@ -341,6 +341,16 @@ def test_grace_ending_before_start(self): self.edit("localwp", lambda d: d["compliance"]["grace"].update(endsAt="2026-10-01")) self.assertError(self.run_validator(), "must be after startedAt") + def test_linux_with_a_beta_version(self): + self.edit("command-line", lambda d: d.update(platforms=["macos", "linux"], + minTableProVersion={"macos": "0.37.0", "linux": "0.1.0-beta.1"})) + self.assertEqual([f.message for f in self.run_validator().report.errors], []) + + def test_app_version_takes_only_a_numbered_pre_release(self): + self.edit("command-line", lambda d: d.update(platforms=["macos", "linux"], + minTableProVersion={"linux": "0.1.0-beta"})) + self.assertTrue(self.run_validator().report.errors) + def test_min_version_for_unlisted_platform(self): self.edit("command-line", lambda d: d.update(minTableProVersion={"ios": "1.0"})) self.assertError(self.run_validator(), "ios is not in platforms")