Initial commit

2025-11-29 18:20:28 +08:00
commit b727790a9e
65 changed files with 16412 additions and 0 deletions
--- a/commands/schema-validation/check-plugin-entries.md
+++ b/commands/schema-validation/check-plugin-entries.md
@@ -0,0 +1,241 @@
+## Operation: Check Plugin Entries
+
+Validate plugin entries in marketplace configuration for completeness and format compliance.
+
+### Parameters from $ARGUMENTS
+
+- **marketplace**: Path to marketplace.json file (required)
+- **strict**: Require all recommended fields in plugin entries (optional, default: false)
+- **index**: Validate specific plugin entry by index (optional, validates all if not specified)
+
+### Workflow
+
+1. **Load Marketplace Configuration**
+   ```
+   Locate marketplace.json:
+     - Direct path: <marketplace>
+     - Relative: <marketplace>/marketplace.json
+     - Claude plugin: <marketplace>/.claude-plugin/marketplace.json
+
+   Validate JSON syntax first
+   ```
+
+2. **Extract Plugin Entries**
+   ```
+   Parse plugins array from marketplace.json
+   Count total entries
+   Determine which entries to validate (all or specific index)
+   ```
+
+3. **Validate Each Plugin Entry**
+   ```
+   For each plugin entry, execute .scripts/schema-differ.sh
+
+   Check required fields:
+     - name (string, lowercase-hyphen)
+     - source (string, valid format: ./path, github:, https://)
+     - description (string, non-empty)
+
+   Check recommended fields:
+     - version (string, semver)
+     - author (string or object)
+     - keywords (array, 3-7 items)
+     - license (string, SPDX identifier)
+
+   Validate field formats:
+     - name: lowercase-hyphen pattern
+     - version: semantic versioning
+     - source: valid source format
+     - license: SPDX identifier
+   ```
+
+4. **Aggregate Results**
+   ```
+   Per-entry summary:
+     - Entry index
+     - Plugin name
+     - Status: PASS/FAIL
+     - Missing required fields
+     - Missing recommended fields
+     - Format violations
+
+   Overall summary:
+     - Total entries
+     - Passed count
+     - Failed count
+     - Total issues
+   ```
+
+### Plugin Entry Required Fields
+
+- `name`: Unique plugin identifier (lowercase-hyphen)
+- `source`: Where to locate plugin (./path, github:user/repo, https://url)
+- `description`: Brief plugin description (non-empty)
+
+### Plugin Entry Recommended Fields
+
+- `version`: Plugin version (semver)
+- `author`: Plugin author (string or object)
+- `keywords`: Search keywords (array of 3-7 strings)
+- `license`: License identifier (SPDX)
+- `homepage`: Documentation URL
+- `repository`: Source code URL
+
+### Source Format Validation
+
+**Relative Path**:
+- Pattern: `./` or `../`
+- Example: `./plugins/my-plugin`
+
+**GitHub Format**:
+- Pattern: `github:owner/repo`
+- Example: `github:anthropics/claude-plugin`
+
+**Git URL**:
+- Pattern: `https://...git`
+- Example: `https://github.com/user/plugin.git`
+
+**Archive URL**:
+- Pattern: `https://....(zip|tar.gz|tgz)`
+- Example: `https://example.com/plugin.zip`
+
+### Examples
+
+```bash
+# Validate all plugin entries in marketplace
+/schema-validation entries marketplace:./test-marketplace
+
+# Validate with strict mode (require recommended fields)
+/schema-validation entries marketplace:marketplace.json strict:true
+
+# Validate specific plugin entry by index
+/schema-validation entries marketplace:marketplace.json index:0
+```
+
+### Error Handling
+
+- **Marketplace not found**: Show searched paths
+- **Invalid JSON**: Suggest running json validation
+- **No plugins array**: Error - required field
+- **Empty plugins array**: Warning - marketplace has no plugins
+- **Invalid index**: Error with valid range
+
+### Output Format
+
+**Success (all entries valid)**:
+```
+✅ Plugin Entries Validation: PASS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Marketplace: ./test-marketplace/marketplace.json
+Total Entries: 3
+
+Entry 0: code-review ✅
+  Required (3/3):
+    ✅ name: "code-review"
+    ✅ source: "./plugins/code-review"
+    ✅ description: "Automated code review..."
+
+  Recommended (4/4):
+    ✅ version: "2.0.0"
+    ✅ author: Present
+    ✅ keywords: 3 items
+    ✅ license: "MIT"
+
+Entry 1: deploy-tools ✅
+  Required (3/3):
+    ✅ name: "deploy-tools"
+    ✅ source: "github:company/deploy"
+    ✅ description: "Deployment automation..."
+
+  Recommended (3/4):
+    ✅ version: "1.5.0"
+    ✅ author: Present
+    ⚠️  keywords: Missing
+
+Entry 2: security-scan ✅
+  Required (3/3):
+    ✅ name: "security-scan"
+    ✅ source: "https://example.com/plugin.zip"
+    ✅ description: "Security vulnerability scanning..."
+
+Summary:
+  Total: 3 entries
+  Passed: 3 (100%)
+  Failed: 0
+  Warnings: 1 (non-blocking)
+
+Status: PASS
+```
+
+**Failure (validation errors)**:
+```
+❌ Plugin Entries Validation: FAIL
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Marketplace: marketplace.json
+Total Entries: 2
+
+Entry 0: my-plugin ❌
+  Required (2/3):
+    ❌ name: "My-Plugin"
+       Invalid: Must use lowercase-hyphen format
+       Expected: my-plugin
+
+    ❌ source: Missing (REQUIRED)
+
+    ✅ description: "My awesome plugin"
+
+  Recommended (1/4):
+    ✅ version: "1.0.0"
+    ❌ author: Missing
+    ❌ keywords: Missing
+    ❌ license: Missing
+
+  Issues: 5 (2 critical, 3 warnings)
+
+Entry 1: test-tool ✅
+  Required (3/3):
+    ✅ name: "test-tool"
+    ✅ source: "./plugins/test-tool"
+    ✅ description: "Testing utilities"
+
+  Recommended (2/4):
+    ⚠️  version: Missing
+    ⚠️  author: Missing
+
+Summary:
+  Total: 2 entries
+  Passed: 1 (50%)
+  Failed: 1 (50%)
+  Critical Issues: 2
+  Warnings: 5
+
+Status: FAIL
+
+Action Required:
+  Fix plugin entry #0 (my-plugin):
+    - Change name to lowercase-hyphen: "my-plugin"
+    - Add source field: "./plugins/my-plugin"
+    - Consider adding: author, keywords, license
+```
+
+**Empty Marketplace**:
+```
+⚠️  Plugin Entries Validation: WARNING
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Marketplace: marketplace.json
+
+⚠️  No plugin entries found
+    - plugins array is empty
+    - Add at least one plugin entry to marketplace
+
+Status: WARNING (empty marketplace)
+```
+
+### Integration
+
+This operation is called by:
+- `full-schema-validation.md` - When validating marketplace type
+- `validation-orchestrator` - Marketplace comprehensive validation
+- Direct user invocation for plugin entry checking
+
+**Request**: $ARGUMENTS