Add PR validation workflow and docs

.github/workflows/validate-plugin-pr.yml

@@ -0,0 +1,51 @@
+name: Validate Plugin PR
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    if: ${{ !github.event.pull_request.draft }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pyyaml pillow
+
+      - name: Validate PR contents
+        id: validate
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        continue-on-error: true
+        run: |
+          set -o pipefail
+          python scripts/validate_pr.py 2>&1 | tee validation.log
+          echo "exit_code=${PIPESTATUS[0]}" >> "$GITHUB_OUTPUT"
+
+      - name: Comment on PR (validation failure)
+        if: ${{ steps.validate.outputs.exit_code != '0' }}
+        uses: actions/github-script@v7
+        with:
+          script-file: scripts/comment_validation_failure.js
+
+      - name: Fail job if validation failed
+        if: ${{ steps.validate.outputs.exit_code != '0' }}
+        run: exit 1

TAGS.md

@@ -0,0 +1,89 @@
+# Recommended tags
+
+Use short, lowercase tags. Prefer existing tags from this list. Recommended: up to 5 tags.
+
+## Core capabilities
+
+- `memory`
+- `storage`
+- `files`
+- `tools`
+- `workflow`
+- `automation`
+- `jobs`
+- `scheduling`
+
+## AI / LLM
+
+- `llm`
+- `prompting`
+- `embeddings`
+- `rag`
+- `agents`
+- `monologue`
+
+## Search / Retrieval
+
+- `search`
+- `web-search`
+- `browser`
+- `scraping`
+- `documents`
+
+## Web / APIs
+
+- `api`
+- `http`
+- `web`
+- `webhooks`
+- `oauth`
+- `ui`
+
+## Data / Databases
+
+- `database`
+- `sql`
+- `sqlite`
+- `postgres`
+- `redis`
+- `vector-db`
+
+## Integrations
+
+- `integration`
+- `github`
+- `google`
+- `notion`
+- `jira`
+
+## Communication
+
+- `email`
+- `slack`
+- `discord`
+- `telegram`
+
+## Security
+
+- `security`
+- `auth`
+- `secrets`
+
+## Dev / Ops
+
+- `development`
+- `cli`
+- `monitoring`
+- `docker`
+- `framework`
+
+## Media
+
+- `image`
+- `audio`
+- `video`
+
+## Others
+
+- `example`
+- `template`

plugins/_example1/plugin.yaml

@@ -0,0 +1,6 @@
+title: Example Plugin
+description: Example plugin template to demonstrate the plugin system
+github: https://github.com/ctxos/ctx-plugin-example
+tags:
+  - example
+  - template

scripts/comment_validation_failure.js

@@ -0,0 +1,37 @@
+const fs = require('fs');
+
+const marker = '<!-- ctx-plugins-validation -->';
+const raw = fs.readFileSync('validation.log', 'utf8');
+const max = 60000;
+const text = raw.length > max ? raw.slice(0, max) + '\n... (truncated)\n' : raw;
+const body = `${marker}\n## Plugin submission validation failed\n\n\`\`\`\n${text}\n\`\`\`\n\nPush an update to this PR to re-run validation.`;
+
+const { owner, repo } = context.repo;
+const issue_number = context.payload.pull_request.number;
+
+const comments = await github.paginate(github.rest.issues.listComments, {
+  owner,
+  repo,
+  issue_number,
+  per_page: 100,
+});
+
+const existing = comments.find(
+  (c) => (c.user?.type === 'Bot') && (c.body || '').includes(marker)
+);
+
+if (existing) {
+  await github.rest.issues.updateComment({
+    owner,
+    repo,
+    comment_id: existing.id,
+    body,
+  });
+} else {
+  await github.rest.issues.createComment({
+    owner,
+    repo,
+    issue_number,
+    body,
+  });
+}