From 16c7f5d0c8cd2b597cdc96754599ff296df9d31f Mon Sep 17 00:00:00 2001 From: Fuat Date: Tue, 28 Apr 2026 21:59:30 +0300 Subject: [PATCH] fix(plugin-dev): document repository as string-only in manifest docs The plugin manifest schema accepts only a string URL for `repository`. Object form (npm-style {"type": "git", "url": "..."}) fails install with `repository: Invalid input: expected string, received object`. manifest-reference.md documented the field as supporting both, and two complete-example blocks (one in the same file, one in advanced-plugin.md) used the object form. Update the docs to string-only and rewrite both examples to match. --- .../examples/advanced-plugin.md | 5 +---- .../references/manifest-reference.md | 19 +++---------------- 2 files changed, 4 insertions(+), 20 deletions(-) diff --git a/plugins/plugin-dev/skills/plugin-structure/examples/advanced-plugin.md b/plugins/plugin-dev/skills/plugin-structure/examples/advanced-plugin.md index a7c069691e..bed5a72e13 100644 --- a/plugins/plugin-dev/skills/plugin-structure/examples/advanced-plugin.md +++ b/plugins/plugin-dev/skills/plugin-structure/examples/advanced-plugin.md @@ -113,10 +113,7 @@ enterprise-devops/ "url": "https://company.com/teams/devops" }, "homepage": "https://docs.company.com/plugins/devops", - "repository": { - "type": "git", - "url": "https://github.com/company/devops-plugin.git" - }, + "repository": "https://github.com/company/devops-plugin", "license": "Apache-2.0", "keywords": [ "devops", diff --git a/plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md b/plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md index 40c9c2f363..34d38fb37d 100644 --- a/plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md +++ b/plugins/plugin-dev/skills/plugin-structure/references/manifest-reference.md @@ -132,28 +132,18 @@ Link to plugin documentation or landing page. #### repository -**Type**: String (URL) or Object +**Type**: String (URL) **Example**: `"https://github.com/user/plugin-name"` Source code repository location. -**String format**: ```json { "repository": "https://github.com/user/plugin-name" } ``` -**Object format** (detailed): -```json -{ - "repository": { - "type": "git", - "url": "https://github.com/user/plugin-name.git", - "directory": "packages/plugin-name" - } -} -``` +The `repository` field accepts a plain URL string only. The npm-style object form (`{"type": "git", "url": "..."}`) is not supported and fails manifest validation with `repository: Invalid input: expected string, received object`. **Use cases**: - Source code access @@ -495,10 +485,7 @@ Full configuration with all features: "url": "https://company.com/devops" }, "homepage": "https://docs.company.com/plugins/devops", - "repository": { - "type": "git", - "url": "https://github.com/company/devops-plugin.git" - }, + "repository": "https://github.com/company/devops-plugin", "license": "Apache-2.0", "keywords": [ "devops",