[codex] add canonical connector plugin metadata

README.md

@@ -7,6 +7,13 @@ Each plugin lives under `plugins/<name>/` with a required
 `skills/`, `.app.json`, `.mcp.json`, plugin-level `agents/`, `commands/`,
 `hooks.json`, `assets/`, and other supporting files.
 
+For app-backed plugins, `.app.json` is also the source of truth for connector
+identity. When a plugin is the canonical 1:1 curated plugin for a connector,
+set `apps.<app-name>.canonical` to `true`. This allows downstream consumers to
+derive a definitive `connector id -> plugin` mapping without assuming every
+plugin that references a connector is the official base plugin for that
+connector.
+
 Highlighted richer examples in this repo include:
 
 - `plugins/figma` for `use_figma`, Code to Canvas, Code Connect, and design system rules

plugins/canva/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "canva": {
-      "id": "connector_68df33b1a2d081918778431a9cfca8ba"
+      "id": "connector_68df33b1a2d081918778431a9cfca8ba",
+      "canonical": true
     }
   }
 }

plugins/figma/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "figma": {
-      "id": "connector_68df038e0ba48191908c8434991bbac2"
+      "id": "connector_68df038e0ba48191908c8434991bbac2",
+      "canonical": true
     }
   }
 }

plugins/github/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "github": {
-      "id": "connector_76869538009648d5b282a4bb21c3d157"
+      "id": "connector_76869538009648d5b282a4bb21c3d157",
+      "canonical": true
     }
   }
 }

plugins/gmail/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "gmail": {
-      "id": "connector_2128aebfecb84f64a069897515042a44"
+      "id": "connector_2128aebfecb84f64a069897515042a44",
+      "canonical": true
     }
   }
 }

plugins/google-calendar/.app.json

@@ -2,7 +2,8 @@
   "apps":
   {
     "google-calendar": {
-      "id": "connector_947e0d954944416db111db556030eea6"
+      "id": "connector_947e0d954944416db111db556030eea6",
+      "canonical": true
     }
   }
 }

plugins/google-drive/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "google-drive": {
-      "id": "connector_5f3c8c41a1e54ad7a76272c89e2554fa"
+      "id": "connector_5f3c8c41a1e54ad7a76272c89e2554fa",
+      "canonical": true
     }
   }
 }

plugins/jam/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "jam": {
-      "id": "connector_6923e677f37c8191845e4e0b658dd718"
+      "id": "connector_6923e677f37c8191845e4e0b658dd718",
+      "canonical": true
     }
   }
 }

plugins/outlook-calendar/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "outlook-calendar": {
-      "id": "connector_e6a7394682e24467ac68c60696f275a4"
+      "id": "connector_e6a7394682e24467ac68c60696f275a4",
+      "canonical": true
     }
   }
 }

plugins/outlook-email/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "outlook-email": {
-      "id": "connector_4aaab2856305417b993eca9a216aaf6e"
+      "id": "connector_4aaab2856305417b993eca9a216aaf6e",
+      "canonical": true
     }
   }
 }

plugins/sharepoint/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "sharepoint": {
-      "id": "connector_1e4f6a44acf14e3ca1d96672f8c945bc"
+      "id": "connector_1e4f6a44acf14e3ca1d96672f8c945bc",
+      "canonical": true
     }
   }
 }

plugins/stripe/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "stripe": {
-      "id": "connector_690ab09fa43c8191bca40280e4563238"
+      "id": "connector_690ab09fa43c8191bca40280e4563238",
+      "canonical": true
     }
   }
 }

plugins/teams/.app.json

@@ -1,7 +1,8 @@
 {
   "apps": {
     "teams": {
-      "id": "connector_246af0940da3457da0e751171dc1ce60"
+      "id": "connector_246af0940da3457da0e751171dc1ce60",
+      "canonical": true
     }
   }
 }