π The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
fix(plugins): clean claude.ai plugin-validator findings (nested manifest, unknown keys, XML tags in skill descriptions)
ra457cbf4dc27
diff --git a/.github/workflows/all-plugins-smoke.yml b/.github/workflows/all-plugins-smoke.ymlindex ca90e0c3d5..f30ab91d29 100644--- a/.github/workflows/all-plugins-smoke.yml+++ b/.github/workflows/all-plugins-smoke.yml@@ -18,6 +18,7 @@ on:- 'plugins/**'- 'scripts/smoke-all-plugins.mjs'- 'scripts/audit-plugin-mcp-prefix.mjs'+ - 'scripts/check-plugin-manifests.mjs'- 'scripts/sync-mod-screen.mjs'- 'scripts/check-guard-tool-names.mjs'- 'scripts/guard-tool-names.allow.json'@@ -31,6 +32,7 @@ on:- 'plugins/**'- 'scripts/smoke-all-plugins.mjs'- 'scripts/audit-plugin-mcp-prefix.mjs'+ - 'scripts/check-plugin-manifests.mjs'- 'scripts/sync-mod-screen.mjs'- 'scripts/check-guard-tool-names.mjs'- 'scripts/guard-tool-names.allow.json'@@ -109,6 +111,12 @@ jobs:# violations that escape per-plugin coverage (new plugin without# smoke, new skill without smoke-list update, etc.).+ - name: claude.ai plugin-validator static check+ run: node scripts/check-plugin-manifests.mjs+ # Unknown plugin.json keys, nested .claude-plugin/plugin.json under a+ # plugin, and <tag>-like text in SKILL.md descriptions: the three+ # things the claude.ai upload validator skips or warns on.+- name: Fleet-wide plugin.json manifest audit (iter 88)run: node scripts/audit-plugin-manifest.mjs# Scans every plugins/*/.claude-plugin/plugin.json for: valid JSON,diff --git a/plugins/ruflo-ai-team/.claude-plugin/plugin.json b/plugins/ruflo-ai-team/.claude-plugin/plugin.jsonindex c222fbb8ba..77b16682d1 100644--- a/plugins/ruflo-ai-team/.claude-plugin/plugin.json+++ b/plugins/ruflo-ai-team/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-ai-team","description": "Give Claude a tenant-isolated AI team that divides work, coordinates progress, recalls approved context, and returns evidence-backed results.",- "version": "0.2.2",+ "version": "0.2.3","author": {"name": "ruvnet","url": "https://github.com/ruvnet"@@ -10,7 +10,7 @@"privacyPolicyUrl": "https://team.ruv.io/privacy","supportUrl": "https://team.ruv.io/support","repository": "https://github.com/ruvnet/ruflo",- "documentationUrl": "https://github.com/ruvnet/ruflo/tree/feat/ruflo-ai-team/plugins/ruflo-ai-team",+ "documentationUrl": "https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-ai-team","termsOfServiceUrl": "https://team.ruv.io/terms","icon": ".claude-plugin/icon.svg","license": "MIT",diff --git a/plugins/ruflo-ai-team/CHANGELOG.md b/plugins/ruflo-ai-team/CHANGELOG.mdindex 98982e4b99..bc719e3282 100644--- a/plugins/ruflo-ai-team/CHANGELOG.md+++ b/plugins/ruflo-ai-team/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-ai-team`.+## 0.2.3 β 2026-10-09+- fix: documentationUrl points at the main branch path, not the feat/ruflo-ai-team branch+## 0.2.2 β 2026-10-05- fix: shared textsOf reports truncation and every guard fails closed on itdiff --git a/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.json b/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.jsonindex 5090d4afee..d07b4bb1a7 100644--- a/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.json+++ b/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.json@@ -1,13 +1,13 @@{"name": "ruflo-ai-team","description": "Give Claude a tenant-isolated AI team that divides work, coordinates progress, recalls approved context, and returns evidence-backed results.",- "version": "0.1.0",+ "version": "0.1.1","author": { "name": "ruvnet", "url": "https://github.com/ruvnet" },"homepage": "https://team.ruv.io","privacyPolicyUrl": "https://team.ruv.io/privacy","supportUrl": "https://team.ruv.io/support","repository": "https://github.com/ruvnet/ruflo",- "documentationUrl": "https://github.com/ruvnet/ruflo/tree/feat/ruflo-ai-team/plugins/ruflo-ai-team",+ "documentationUrl": "https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-ai-team","termsOfServiceUrl": "https://team.ruv.io/terms","icon": ".claude-plugin/icon.svg","license": "MIT",diff --git a/plugins/ruflo-arena/.claude-plugin/plugin.json b/plugins/ruflo-arena/.claude-plugin/plugin.jsonindex 298ed7175e..a2362b82a5 100644--- a/plugins/ruflo-arena/.claude-plugin/plugin.json+++ b/plugins/ruflo-arena/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "ruflo-arena",- "version": "0.2.3",+ "version": "0.2.4","description": "Competitive ruliology for Ruflo swarms β arenas, tournaments, and adaptive co-evolution of program strategies (ADR-147/148). Strategies-as-programs compete under payoff games; tournaments produce Wolfram-style competitive arrays; hill-climb and mutual co-evolution discover winners empirically.","author": {"name": "ruvnet",@@ -21,10 +21,5 @@"mod","function-hooks"],- "categories": [- "intelligence",- "swarm",- "simulation"- ],"repository": "https://github.com/ruvnet/ruflo"}diff --git a/plugins/ruflo-arena/CHANGELOG.md b/plugins/ruflo-arena/CHANGELOG.mdindex 02ce25e39c..fa6079c58f 100644--- a/plugins/ruflo-arena/CHANGELOG.md+++ b/plugins/ruflo-arena/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; this is the whole history.+## 0.2.4 β 2026-10-09+- chore: drop the unused `categories` key from plugin.json (claude.ai plugin validator warns on it; nothing read it)+## 0.2.3 β 2026-10-05- fix: vitest suites in agntcy, arena and graph-intelligence are *.spec.ts so claude plugin test collects only the kit testsdiff --git a/plugins/ruflo-arena/scripts/smoke.sh b/plugins/ruflo-arena/scripts/smoke.shindex 55293d89e3..408559f995 100755--- a/plugins/ruflo-arena/scripts/smoke.sh+++ b/plugins/ruflo-arena/scripts/smoke.sh@@ -8,9 +8,9 @@ step() { printf "β %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "0. plugin.json declares 0.2.3"+step "0. plugin.json declares 0.2.4"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-[[ "$v" == "0.2.3" ]] && ok || bad "expected 0.2.3, got '$v'"+[[ "$v" == "0.2.4" ]] && ok || bad "expected 0.2.4, got '$v'"# M1. The mod (ADR-445 pattern): hooks module registered, files within the 500-line rulestep "M1. mod: hooks.json names register.ts, every hook file is present and under 500 lines"diff --git a/plugins/ruflo-graph-intelligence/.claude-plugin/plugin.json b/plugins/ruflo-graph-intelligence/.claude-plugin/plugin.jsonindex 9370177014..0a8fabc753 100644--- a/plugins/ruflo-graph-intelligence/.claude-plugin/plugin.json+++ b/plugins/ruflo-graph-intelligence/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-graph-intelligence","description": "RuFlo Graph Intelligence Engine β real-time relationship intelligence with complexity-aware execution. Single-entry personalized PageRank, streaming delta updates, witness-signed reasoning artifacts, federation-distributable PR vectors. Built on [email protected].",- "version": "0.2.0-alpha.4",+ "version": "0.2.0-alpha.5","author": {"name": "ruvnet","url": "https://github.com/ruvnet"@@ -25,12 +25,6 @@"function-hooks","guard"],- "categories": [- "intelligence",- "graph",- "memory",- "substrate"- ],"repository": "https://github.com/ruvnet/ruflo","userConfig": {"guard": {diff --git a/plugins/ruflo-graph-intelligence/CHANGELOG.md b/plugins/ruflo-graph-intelligence/CHANGELOG.mdindex eeb86040a6..f86dd66db0 100644--- a/plugins/ruflo-graph-intelligence/CHANGELOG.md+++ b/plugins/ruflo-graph-intelligence/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; this is the whole history.+## 0.2.0-alpha.5 β 2026-10-09+- chore: drop the unused `categories` key from plugin.json (claude.ai plugin validator warns on it; nothing read it)+## 0.2.0-alpha.4 β 2026-10-05- fix: vitest suites in agntcy, arena and graph-intelligence are *.spec.ts so claude plugin test collects only the kit testsdiff --git a/plugins/ruflo-graph-intelligence/README.md b/plugins/ruflo-graph-intelligence/README.mdindex c5e2c064c0..9cf681e1cc 100644--- a/plugins/ruflo-graph-intelligence/README.md+++ b/plugins/ruflo-graph-intelligence/README.md@@ -2,7 +2,7 @@Graph Intelligence Engine for RuFlo: single-entry personalized PageRank, streaming delta updates and witness-signed reasoning artifacts (ADR-123), built on sublinear-time-solver. Library: `npm test`, `npm run build`.-## As a mod (0.2.0-alpha.4)+## As a mod (0.2.0-alpha.5)A function-hook mod ships beside the skills (ADR-445 pattern). Needs a Claude Code with mods (2.1.287+); older builds ignore it. No network, no process spawning: it only tightens calls to this plugin's own tools and reads through tools already connected.diff --git a/plugins/ruflo-metaharness/.claude-plugin/plugin.json b/plugins/ruflo-metaharness/.claude-plugin/plugin.jsonindex 51fdc7fa4b..d481d9eba4 100644--- a/plugins/ruflo-metaharness/.claude-plugin/plugin.json+++ b/plugins/ruflo-metaharness/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-metaharness","description": "MetaHarness integration for ruflo β surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150's architectural constraint that MetaHarness remains an optional augmentation, never a required runtime dependency. As a mod (ADR-445): confirms flywheel promotion, keeps secrets out of inputs, /metaharness-mod, and a status file the console shows",- "version": "0.2.4",+ "version": "0.2.5","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-metaharness/CHANGELOG.md b/plugins/ruflo-metaharness/CHANGELOG.mdindex 56419f148c..4b6b765ed3 100644--- a/plugins/ruflo-metaharness/CHANGELOG.md+++ b/plugins/ruflo-metaharness/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; this is the whole history.+## 0.2.5 β 2026-10-09+- fix: seven harness-* skill descriptions no longer carry angle-bracket placeholders (claude.ai strips them as XML tags)+## 0.2.4 β 2026-10-07- fix: run the installed ruflo CLI before `npx @claude-flow/cli@latest` in cost-tracker, adr and metaharness- chore: 3.55.0 versions, leaf pins, lockfiles, plugin bumps, changelogdiff --git a/plugins/ruflo-metaharness/scripts/smoke.sh b/plugins/ruflo-metaharness/scripts/smoke.shindex 64eda20087..44fd4a468c 100755--- a/plugins/ruflo-metaharness/scripts/smoke.sh+++ b/plugins/ruflo-metaharness/scripts/smoke.sh@@ -1,5 +1,5 @@#!/usr/bin/env bash-# Structural smoke test for ruflo-metaharness v0.2.4 (ADR-150 Phase 1).+# Structural smoke test for ruflo-metaharness v0.2.5 (ADR-150 Phase 1).set -uROOT="$(cd "$(dirname "$0")/.." && pwd)"PASS=0@@ -32,10 +32,10 @@ elsebad "extraction-regex-rot: EXPECTED_TOOLS=$EXPECTED_TOOLS EXPECTED_SUBS=$EXPECTED_SUBS"fi-step "1. plugin.json declares 0.2.4 with adr-150 keywords"+step "1. plugin.json declares 0.2.5 with adr-150 keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.2.4" ]]; then- bad "expected 0.2.4, got '$v'"+if [[ "$v" != "0.2.5" ]]; then+ bad "expected 0.2.5, got '$v'"elsemiss=""for k in ruflo metaharness harness scorecard genome mcp-scan threat-model router adr-150 adr-148 adr-149 optional-dependency graceful-degradation subprocess phase-1-mvp; dodiff --git a/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md b/plugins/ruflo-metaharness/skills/harness-bench/SKILL.mdindex 0981031957..35d716dfc8 100644--- a/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md@@ -1,6 +1,6 @@---name: harness-bench-description: Manage `@metaharness/darwin` bench suites β `bench create <repo>` scaffolds a JSON suite from a repo's test corpus; `bench verify <suite.json>` checks suite well-formedness. Bench suites are the fixed evaluation corpora that `harness-evolve --bench <suite.json>` scores variants against, decoupling evolution from the repo's natural tests. Degrades gracefully when @metaharness/darwin is absent.+description: Manage `@metaharness/darwin` bench suites β `bench create {repo}` scaffolds a JSON suite from a repo's test corpus; `bench verify {suite.json}` checks suite well-formedness. Bench suites are the fixed evaluation corpora that `harness-evolve --bench {suite.json}` scores variants against, decoupling evolution from the repo's natural tests. Degrades gracefully when @metaharness/darwin is absent.argument-hint: "--op create --repo <path> [--out <path>] | --op verify --suite <path>"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md b/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.mdindex f224e45955..96d4260b0b 100644--- a/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-evolve/SKILL.md@@ -1,6 +1,6 @@---name: harness-evolve-description: Run `@metaharness/darwin evolve <repo>` to mutate a harness's seven policy surfaces (planner/contextBuilder/reviewer/retryPolicy/toolPolicy/memoryPolicy/scorePolicy), sandbox-score each variant, and promote only measured wins. The model is frozen; the harness evolves. Closes the loop ADR-150 opens (score+genome describe; evolve changes). Degrades gracefully when @metaharness/darwin is absent (ADR-150 + ADR-153 architectural constraints).+description: Run `@metaharness/darwin evolve {repo}` to mutate a harness's seven policy surfaces (planner/contextBuilder/reviewer/retryPolicy/toolPolicy/memoryPolicy/scorePolicy), sandbox-score each variant, and promote only measured wins. The model is frozen; the harness evolves. Closes the loop ADR-150 opens (score+genome describe; evolve changes). Degrades gracefully when @metaharness/darwin is absent (ADR-150 + ADR-153 architectural constraints).argument-hint: "--repo <path> [--generations 3] [--children 3] [--concurrency 2] [--sandbox real|mock|agent] [--selection pareto|quality-diversity|...] [--mutator deterministic|ruvllm] [--diagnose] [--confirm]"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md b/plugins/ruflo-metaharness/skills/harness-genome/SKILL.mdindex db27cc57a4..a9b4d68053 100644--- a/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-genome/SKILL.md@@ -1,6 +1,6 @@---name: harness-genome-description: 7-section repo readiness report from `metaharness genome <path>`. Returns repo_type / agent_topology / risk_score / mcp_surface / test_confidence / publish_readiness. Pure-read; degrades gracefully (ADR-150).+description: 7-section repo readiness report from `metaharness genome {path}`. Returns repo_type / agent_topology / risk_score / mcp_surface / test_confidence / publish_readiness. Pure-read; degrades gracefully (ADR-150).argument-hint: "[--path .] [--alert-on-risk-above 0.5] [--format table|json]"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md b/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.mdindex 9322e92b9c..189f6b7c91 100644--- a/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-mcp-scan/SKILL.md@@ -1,6 +1,6 @@---name: harness-mcp-scan-description: Static security scan of a harness's declared MCP surface via `harness mcp-scan <path>`. Reads `.mcp/servers.json` + `.harness/claims.json`. Pure-read, no dispatch. Exits 1 on findings at or above `--fail-on` severity.+description: Static security scan of a harness's declared MCP surface via `harness mcp-scan {path}`. Reads `.mcp/servers.json` + `.harness/claims.json`. Pure-read, no dispatch. Exits 1 on findings at or above `--fail-on` severity.argument-hint: "[--path .] [--fail-on low|medium|high] [--format table|json]"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md b/plugins/ruflo-metaharness/skills/harness-mint/SKILL.mdindex 566ed20f40..b166b05718 100644--- a/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-mint/SKILL.md@@ -1,6 +1,6 @@---name: harness-mint-description: Scaffold a custom AI agent harness via `metaharness new <name> --template <id> --host <id>`. Defaults to DRY-RUN (no writes) unless --confirm is passed. Refuses to write to the calling repo root or anywhere inside it. Honors ADR-150 architectural constraint + ruflo's "destructive-action confirmation" pattern.+description: Scaffold a custom AI agent harness via `metaharness new {name} --template {id} --host {id}`. Defaults to DRY-RUN (no writes) unless --confirm is passed. Refuses to write to the calling repo root or anywhere inside it. Honors ADR-150 architectural constraint + ruflo's "destructive-action confirmation" pattern.argument-hint: "--name <id> --template <vertical:coding|minimal|β¦> [--host claude-code|codex|β¦] [--target /abs/path] [--confirm] [--format table|json]"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-score/SKILL.md b/plugins/ruflo-metaharness/skills/harness-score/SKILL.mdindex 7cd356ad05..9c0f93dabd 100644--- a/plugins/ruflo-metaharness/skills/harness-score/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-score/SKILL.md@@ -1,6 +1,6 @@---name: harness-score-description: 5-dimension harness readiness scorecard from `metaharness score <path>`. Returns harnessFit / compileConfidence / taskCoverage / toolSafety / memoryUsefulness + estCostPerRunUsd + scaffoldReady. Pure-read; subprocess invocation; degrades gracefully when MetaHarness is absent (ADR-150 architectural constraint).+description: 5-dimension harness readiness scorecard from `metaharness score {path}`. Returns harnessFit / compileConfidence / taskCoverage / toolSafety / memoryUsefulness + estCostPerRunUsd + scaffoldReady. Pure-read; subprocess invocation; degrades gracefully when MetaHarness is absent (ADR-150 architectural constraint).argument-hint: "[--path .] [--alert-on-fit-below 70] [--format table|json]"allowed-tools: Bash---diff --git a/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md b/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.mdindex da30872ef1..fd6178a83c 100644--- a/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md+++ b/plugins/ruflo-metaharness/skills/harness-threat-model/SKILL.md@@ -1,6 +1,6 @@---name: harness-threat-model-description: Enterprise-review-grade threat model from `harness threat-model <path>`. Categorizes MCP-surface threats; emits `worst: 'clean'|'low'|'medium'|'high'` + per-threat findings. Pure-read.+description: Enterprise-review-grade threat model from `harness threat-model {path}`. Categorizes MCP-surface threats; emits `worst: 'clean'|'low'|'medium'|'high'` + per-threat findings. Pure-read.argument-hint: "[--path .] [--fail-on clean|low|medium|high] [--format table|json]"allowed-tools: Bash---diff --git a/plugins/ruflo-plugin-creator/.claude-plugin/plugin.json b/plugins/ruflo-plugin-creator/.claude-plugin/plugin.jsonindex 385e4541b4..c81cff5774 100644--- a/plugins/ruflo-plugin-creator/.claude-plugin/plugin.json+++ b/plugins/ruflo-plugin-creator/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-plugin-creator","description": "Scaffold, validate, and publish new Claude Code plugins with the canonical plugin contract β now including governed Claude Code mods (function hooks), ADR + smoke + Compatibility + namespace coordination + MCP-tool drift warnings. As a mod (ADR-445): /creator-mod (status, reserved names, a plugin contract check) and a status file the console shows",- "version": "0.4.1",+ "version": "0.4.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-plugin-creator/CHANGELOG.md b/plugins/ruflo-plugin-creator/CHANGELOG.mdindex 3aa8ec562c..1700d95f80 100644--- a/plugins/ruflo-plugin-creator/CHANGELOG.md+++ b/plugins/ruflo-plugin-creator/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; this is the whole history.+## 0.4.2 β 2026-10-09+- fix: the mod template's manifest is plugin.json.tmpl, so the claude.ai validator no longer reads templates/mod as a nested plugin; scripts/scaffold-mod.mjs scaffolds it and a smoke step validates and tests the result+## 0.4.1 β 2026-10-05- feat: status contract in the create-mod template (0.4.1)diff --git a/plugins/ruflo-plugin-creator/README.md b/plugins/ruflo-plugin-creator/README.mdindex eae3156399..80eb610411 100644--- a/plugins/ruflo-plugin-creator/README.md+++ b/plugins/ruflo-plugin-creator/README.md@@ -24,7 +24,7 @@ Scaffold, validate, and publish new Claude Code plugins with proper structure, M- `create-plugin` -- Generate plugin structure with skills, commands, agents, ADR-0001, smoke test, and contract sections- `validate-plugin` -- Validate plugin format and catch issues before publishing-- `create-mod` -- Scaffold a Claude Code mod (function hooks) from `templates/mod/`: hybrid `hooks.json` with a classic fallback that stands down while the module runs, a host adapter over literal `$` calls, `userConfig`, engine-kit tests, tsconfig. Validated with `claude plugin validate` and `claude plugin test` (ruflo ADR-404)+- `create-mod` -- Scaffold a Claude Code mod (function hooks) from `templates/mod/` (`scripts/scaffold-mod.mjs <name> <dir>`; the manifest is `plugin.json.tmpl` so validators do not read it as a nested plugin): hybrid `hooks.json` with a classic fallback that stands down while the module runs, a host adapter over literal `$` calls, `userConfig`, engine-kit tests, tsconfig. Validated with `claude plugin validate` and `claude plugin test` (ruflo ADR-404)## Compatibility@@ -83,4 +83,4 @@ Function-hook mod (ADR-445, pattern of `ruflo-agentdb`), loaded from `hooks/hook- **Status file**: `.claude-flow/creator-mod/status.json` (`{version, updatedMs, checked, reserved, lastTarget}`).- **Safety**: no network, no process spawning.- **Scaffold status contract** (0.4.1): `/create-mod` scaffolds `hooks/status.ts`, which writes `.claude-flow/<name>-mod/status.json` with the fields the console's Mods section reads: `version: 1`, `summary`, `modVersion`, `guard`, `calls` (a number), `blocked`, `lastDenied` (only once the mod has refused something), plus `updatedMs`/`startedMs`. The scaffold's `tests/status.test.ts` asserts that shape; the steps are in `skills/create-mod/SKILL.md`.-- **Test**: `claude plugin validate plugins/ruflo-plugin-creator`, `claude plugin test plugins/ruflo-plugin-creator`, `bash plugins/ruflo-plugin-creator/scripts/smoke.sh`. The runner sweeps in `templates/mod/tests` (the scaffold's own test, which only passes against the scaffold: `claude plugin test plugins/ruflo-plugin-creator/templates/mod`), so expect that one file to fail from the plugin root.+- **Test**: `claude plugin validate plugins/ruflo-plugin-creator`, `claude plugin test plugins/ruflo-plugin-creator`, `bash plugins/ruflo-plugin-creator/scripts/smoke.sh`. The runner sweeps in `templates/mod/tests` (the scaffold's own test, which only passes against a scaffolded mod), so expect that one file to fail from the plugin root. `node plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjs` scaffolds a mod from the template and holds it to `claude plugin validate` and `claude plugin test`.diff --git a/plugins/ruflo-plugin-creator/scripts/scaffold-mod.mjs b/plugins/ruflo-plugin-creator/scripts/scaffold-mod.mjsnew file mode 100644index 0000000000..29ef029bc8--- /dev/null+++ b/plugins/ruflo-plugin-creator/scripts/scaffold-mod.mjs@@ -0,0 +1,41 @@+#!/usr/bin/env node+// Scaffold a Claude Code mod from templates/mod into <dest> (must not exist or be empty).+// Usage: node scaffold-mod.mjs <name> <dest>+// The template keeps its manifest as plugin.json.tmpl: a real .claude-plugin/plugin.json under+// templates/ is mistaken for a second plugin by the claude.ai upload validator.+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs'+import { dirname, join, resolve } from 'node:path'+import { fileURLToPath } from 'node:url'++export function scaffoldMod(name, dest) {+ if (!/^[a-z][a-z0-9-]{0,40}$/.test(name)) throw new Error(`name must be kebab-case, at most 41 characters: ${name}`)+ const out = resolve(dest)+ if (existsSync(out) && readdirSync(out).length > 0) throw new Error(`${out} is not empty`)+ const template = join(dirname(fileURLToPath(import.meta.url)), '..', 'templates', 'mod')+ mkdirSync(out, { recursive: true })+ cpSync(template, out, { recursive: true })+ mkdirSync(join(out, '.claude-plugin'), { recursive: true })+ renameSync(join(out, 'plugin.json.tmpl'), join(out, '.claude-plugin', 'plugin.json'))+ const statusDir = name.endsWith('-mod') ? name : `${name}-mod`+ const upper = name.toUpperCase().replace(/-/g, '_')+ const walk = (dir) => {+ for (const entry of readdirSync(dir)) {+ const p = join(dir, entry)+ if (statSync(p).isDirectory()) { walk(p); continue }+ const before = readFileSync(p, 'utf8')+ const after = before+ .replaceAll('.claude-flow/my-mod/', `.claude-flow/${statusDir}/`)+ .replaceAll('MY_MOD', upper)+ .replaceAll('my-mod', name)+ if (after !== before) writeFileSync(p, after)+ }+ }+ walk(out)+ return out+}++if (process.argv[1] && fileURLToPath(import.meta.url) === resolve(process.argv[1])) {+ const [name, dest] = process.argv.slice(2)+ if (!name || !dest) { console.error('usage: scaffold-mod.mjs <name> <dest>'); process.exit(2) }+ console.log(scaffoldMod(name, dest))+}diff --git a/plugins/ruflo-plugin-creator/scripts/smoke.sh b/plugins/ruflo-plugin-creator/scripts/smoke.shindex 6987fc8dbd..55f5597e54 100755--- a/plugins/ruflo-plugin-creator/scripts/smoke.sh+++ b/plugins/ruflo-plugin-creator/scripts/smoke.sh@@ -7,9 +7,9 @@ step() { printf "β %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares 0.4.1 with new keywords"+step "1. plugin.json declares 0.4.2 with new keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.4.1" ]]; then bad "expected 0.4.1, got '$v'"; else+if [[ "$v" != "0.4.2" ]]; then bad "expected 0.4.2, got '$v'"; elsemiss=""for k in mcp scaffolding contract-bootstrap; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"@@ -84,7 +84,7 @@ T="$ROOT/templates/mod"grep -q '"modules": \["./register.ts"\]' "$T/hooks/hooks.json" && grep -q '"UserPromptSubmit"' "$T/hooks/hooks.json" \&& grep -q "MY_MOD_ACTIVE" "$T/hooks/classic.cjs" && grep -q "my-mod-status" "$T/hooks/register.ts" \&& grep -q "claude-code/testing" "$T/tests/register.test.ts" && [[ -f "$ROOT/skills/create-mod/SKILL.md" ]] \- && ! grep -qE '\$\[' "$T/hooks/register.ts" && ok || bad "templates/mod incomplete"+ && ! grep -qE '\$\[' "$T/hooks/register.ts" && [[ -f "$T/plugin.json.tmpl" && ! -e "$T/.claude-plugin" ]] && ok || bad "templates/mod incomplete"# M1. The mod (ADR-445): hooks module registered, files within the 500-line rule, no network or process access in the hooksstep "M1. mod: hooks.json names register.ts, every hook file is present and under 500 lines"@@ -104,5 +104,8 @@ process.exit(require(process.argv[1]).userConfig === undefined ? 0 : 1)step "M3. mod: hooks never touch the network or spawn a process"if grep -nE '\$\.(http|process)\.|child_process|fetch\(' "$ROOT"/hooks/*.ts >/dev/null; then bad "network or process call in hooks"; else ok; fi+step "M4. a scaffolded mod passes claude plugin validate and claude plugin test"+node "$ROOT/scripts/test-scaffold-mod.mjs" >/dev/null && ok || bad "scaffolded mod does not validate/test"+printf "\n%s passed, %s failed\n" "$PASS" "$FAIL"[[ $FAIL -eq 0 ]] || exit 1diff --git a/plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjs b/plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjsnew file mode 100644index 0000000000..14c9b96ccc--- /dev/null+++ b/plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjs@@ -0,0 +1,31 @@+#!/usr/bin/env node+// Scaffold a mod from the template and hold it to `claude plugin validate` and `claude plugin test`.+// Skips (exit 0, says so) when the claude CLI is not installed.+import { mkdtempSync, readFileSync, rmSync, existsSync } from 'node:fs'+import { tmpdir } from 'node:os'+import { join } from 'node:path'+import { spawnSync } from 'node:child_process'+import { scaffoldMod } from './scaffold-mod.mjs'++const claude = spawnSync('claude', ['--version'], { encoding: 'utf8' })+if (claude.status !== 0) { console.log('skip: claude CLI not available'); process.exit(0) }++const root = mkdtempSync(join(tmpdir(), 'scaffold-mod-'))+let failed = false+try {+ const dir = scaffoldMod('demo-mod', join(root, 'demo-mod'))+ const manifest = JSON.parse(readFileSync(join(dir, '.claude-plugin', 'plugin.json'), 'utf8'))+ const check = (label, ok) => { if (!ok) { failed = true; console.error(`FAIL: ${label}`) } else console.log(`ok: ${label}`) }+ check('manifest at .claude-plugin/plugin.json named demo-mod', manifest.name === 'demo-mod')+ check('no plugin.json.tmpl left behind', !existsSync(join(dir, 'plugin.json.tmpl')))+ check('no my-mod / MY_MOD left', !/my-mod|MY_MOD/.test(readFileSync(join(dir, 'hooks', 'register.ts'), 'utf8')))+ for (const sub of ['validate', 'test']) {+ const r = spawnSync('claude', ['plugin', sub, dir], { encoding: 'utf8' })+ check(`claude plugin ${sub}`, r.status === 0)+ if (r.status !== 0) console.error((r.stdout || '') + (r.stderr || ''))+ if (sub === 'validate') check('claude plugin validate reports no warnings', !/β |warning/i.test(r.stdout || ''))+ }+} finally {+ rmSync(root, { recursive: true, force: true })+}+process.exit(failed ? 1 : 0)diff --git a/plugins/ruflo-plugin-creator/skills/create-mod/SKILL.md b/plugins/ruflo-plugin-creator/skills/create-mod/SKILL.mdindex a6a45b1eb0..246f5d04ec 100644--- a/plugins/ruflo-plugin-creator/skills/create-mod/SKILL.md+++ b/plugins/ruflo-plugin-creator/skills/create-mod/SKILL.md@@ -12,8 +12,8 @@ Scaffold a mod the governed way, instead of an ad-hoc one: the template already## Steps1. **Name it.** kebab-case `<name>`. Commands it registers are namespaced `<name>-<verb>`; never register a built-in's name (`/diff`, `/help`) or another plugin's (`/ruos*`, `ruflo-*`).-2. **Copy the template** `plugins/ruflo-plugin-creator/templates/mod/` to the target folder. Replace `my-mod` everywhere (plugin.json `name`, the command, `MY_MOD_ACTIVE` β `<NAME>_ACTIVE` in both `hooks/register.ts` and `hooks/classic.cjs`).-3. **Keep the status contract.** `hooks/status.ts` writes `.claude-flow/<name>-mod/status.json`, the file the console's Mods section reads. The folder must be `<name>-mod` (lowercase, digits, hyphens, at most 41 characters): replace `my-mod` in `STATUS_PATH` with `<name>-mod`. Fields: `version: 1` (required, anything else is ignored), `summary` (one line), `modVersion`, `guard` (boolean), `calls` (a **number**, not a per-tool object), `blocked` (number), `lastDenied` (a short reason, only once the mod has refused something), plus `updatedMs`/`startedMs`. Other fields are not shown. `tests/status.test.ts` asserts the shape.+2. **Scaffold from the template** with `node plugins/ruflo-plugin-creator/scripts/scaffold-mod.mjs <name> <target-dir>`. It copies `templates/mod/`, turns the manifest template `plugin.json.tmpl` into `.claude-plugin/plugin.json` (the template keeps it under a non-manifest name so plugin validators do not mistake `templates/mod` for a second plugin), and replaces `my-mod` everywhere (plugin.json `name`, the command, `MY_MOD_ACTIVE` β `<NAME>_ACTIVE` in both `hooks/register.ts` and `hooks/classic.cjs`, the status folder). Doing it by hand: copy the folder, move `plugin.json.tmpl` to `.claude-plugin/plugin.json`, and make the same replacements.+3. **Keep the status contract.** `hooks/status.ts` writes `.claude-flow/<name>-mod/status.json`, the file the console's Mods section reads. The folder must be `<name>-mod` (lowercase, digits, hyphens, at most 41 characters): the scaffold script already sets `STATUS_PATH` to `<name>-mod`. Fields: `version: 1` (required, anything else is ignored), `summary` (one line), `modVersion`, `guard` (boolean), `calls` (a **number**, not a per-tool object), `blocked` (number), `lastDenied` (a short reason, only once the mod has refused something), plus `updatedMs`/`startedMs`. Other fields are not shown. `tests/status.test.ts` asserts the shape.4. **Write the behaviour** in pure functions taking the `Host` (see `hooks/host.ts`). In `register.ts`, build the host from literal `$.noun.method(...)` calls only β the engine reads a module's `$` uses off its source, and `claude plugin validate` refuses `$` passed around, computed (`$[noun]`), or deeper than `$.noun.method(input)`.5. **Keep the rules:**- Observe with `const r = await next(e); β¦; return r`; rewrite with `next({ ...e, β¦ })`; answer (`{ deny }`) only when you mean to stop the chain.diff --git a/plugins/ruflo-plugin-creator/templates/mod/.claude-plugin/plugin.json b/plugins/ruflo-plugin-creator/templates/mod/plugin.json.tmplsimilarity index 100%rename from plugins/ruflo-plugin-creator/templates/mod/.claude-plugin/plugin.jsonrename to plugins/ruflo-plugin-creator/templates/mod/plugin.json.tmpldiff --git a/plugins/ruflo-workflows/.claude-plugin/plugin.json b/plugins/ruflo-workflows/.claude-plugin/plugin.jsonindex 4f969c57d0..82bc54d257 100644--- a/plugins/ruflo-workflows/.claude-plugin/plugin.json+++ b/plugins/ruflo-workflows/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-workflows","description": "Workflow automation across two surfaces: the 10 workflow_* MCP tools (create/run/execute/status/list/pause/resume/cancel/delete/template) with full state-machine lifecycle (created β running β paused β completed/cancelled), and native Claude Code Workflow JS orchestration (.claude/workflows/*.js β agent/parallel/pipeline/phase fan-out). Includes GAIA benchmark component for Princeton HAL leaderboard submissions.",- "version": "0.6.4",+ "version": "0.6.5","author": {"name": "ruvnet","url": "https://github.com/ruvnet"@@ -30,61 +30,6 @@"function-hooks","guard"],- "components": {- "gaia": {- "description": "GAIA benchmark component β run, submit, validate, and track Princeton HAL leaderboard scores",- "commands": [- "gaia",- "gaia-run",- "gaia-submit",- "gaia-leaderboard",- "gaia-validate",- "gaia-history",- "gaia-cost"- ],- "skills": [- "gaia-submission",- "gaia-debugging",- "gaia-architecture-comparison"- ],- "agents": [- "gaia-benchmark-runner",- "gaia-submission-coordinator"- ],- "cli_backend": "@claude-flow/cli gaia-bench",- "scripts": [- "scripts/gaia-audit.mjs"- ],- "adrs": [- "ADR-133",- "ADR-135",- "ADR-136",- "ADR-167"- ],- "memory_namespaces": [- "gaia-runs",- "gaia-submissions",- "gaia-patterns",- "gaia-debug-patterns"- ]- },- "native_workflows": {- "description": "Native Claude Code Workflow JS orchestration β deterministic subagent fan-out via agent/parallel/pipeline/phase, authored as .claude/workflows/*.js named workflows",- "location": ".claude/workflows/*.js",- "api": [- "agent",- "parallel",- "pipeline",- "phase",- "log"- ],- "invocation": "Workflow tool β Workflow({ name }) | Workflow({ scriptPath }) | Workflow({ resumeFromRunId })",- "reference_workflow": ".claude/workflows/plugin-contract-audit.js",- "adrs": [- "ADR-0002"- ]- }- },"userConfig": {"guard": {"type": "string",diff --git a/plugins/ruflo-workflows/CHANGELOG.md b/plugins/ruflo-workflows/CHANGELOG.mdindex 45c711bfea..03eb8622ca 100644--- a/plugins/ruflo-workflows/CHANGELOG.md+++ b/plugins/ruflo-workflows/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-workflows`.+## 0.6.5 β 2026-10-09+- chore: drop the unused `components` key from plugin.json (claude.ai plugin validator warns on it; nothing read it)+## 0.6.4 β 2026-10-07- feat: workflow-create documents the two ADR steps (requires ADR, records ADR) that use the project's own ADRs through ruflo-console's ADRs page (ADR-480)diff --git a/plugins/ruflo-workflows/scripts/smoke.sh b/plugins/ruflo-workflows/scripts/smoke.shindex 7f401f6e00..b995f39a1f 100755--- a/plugins/ruflo-workflows/scripts/smoke.sh+++ b/plugins/ruflo-workflows/scripts/smoke.sh@@ -7,9 +7,9 @@ step() { printf "β %s ... " "$1"; }ok() { printf "PASS\n"; PASS=$((PASS+1)); }bad() { printf "FAIL: %s\n" "$1"; FAIL=$((FAIL+1)); }-step "1. plugin.json declares 0.6.4 with lifecycle keywords"+step "1. plugin.json declares 0.6.5 with lifecycle keywords"v=$(grep -E '"version"' "$ROOT/.claude-plugin/plugin.json" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)-if [[ "$v" != "0.6.4" ]]; then bad "expected 0.6.4, got '$v'"; else+if [[ "$v" != "0.6.5" ]]; then bad "expected 0.6.5, got '$v'"; elsemiss=""for k in mcp workflow-templates pause-resume lifecycle; dogrep -q "\"$k\"" "$ROOT/.claude-plugin/plugin.json" || miss="$miss $k"diff --git a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json b/plugins/ruflo-x-gateway/.claude-plugin/plugin.jsonindex a0b94100e8..b5c3e216a7 100644--- a/plugins/ruflo-x-gateway/.claude-plugin/plugin.json+++ b/plugins/ruflo-x-gateway/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-x-gateway","description": "Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP MCP surface with OAuth-protected publishing and five ruv:// reference resources.",- "version": "0.9.4",+ "version": "0.9.5","author": {"name": "ruvnet","url": "https://github.com/ruvnet"diff --git a/plugins/ruflo-x-gateway/CHANGELOG.md b/plugins/ruflo-x-gateway/CHANGELOG.mdindex 3c97b4d225..85c8c7634e 100644--- a/plugins/ruflo-x-gateway/CHANGELOG.md+++ b/plugins/ruflo-x-gateway/CHANGELOG.md@@ -2,6 +2,9 @@Newest first. One `## <version> β <date>` heading per version, then `feat:`, `fix:`, `breaking:` and `chore:` bullets (ADR-478). Built from git history; older versions: `git log -- plugins/ruflo-x-gateway`.+## 0.9.5 β 2026-10-09+- fix: the directory bundle (0.8.2) documentationUrl points at the main branch path, not the feat/ruflo-ai-team branch+## 0.9.4 β 2026-10-05- fix: shared textsOf reports truncation and every guard fails closed on itdiff --git a/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.json b/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.jsonindex 6a461c932a..f749249015 100644--- a/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.json+++ b/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "ruflo-x-gateway","description": "Coordinate AI-agent swarms through signed federation messages, channels, and work claims. The remote Claude connector exposes a directory-safe Streamable HTTP MCP surface with OAuth-protected publishing and five ruv:// reference resources.",- "version": "0.8.1",+ "version": "0.8.2","author": {"name": "ruvnet","url": "https://github.com/ruvnet"@@ -10,7 +10,7 @@"privacyPolicyUrl": "https://x.ruv.io/privacy","supportUrl": "https://x.ruv.io/support","repository": "https://github.com/ruvnet/ruflo",- "documentationUrl": "https://github.com/ruvnet/ruflo/tree/feat/ruflo-ai-team/plugins/ruflo-x-gateway",+ "documentationUrl": "https://github.com/ruvnet/ruflo/tree/main/plugins/ruflo-x-gateway","termsOfServiceUrl": "https://x.ruv.io/terms","icon": ".claude-plugin/icon.svg","license": "MIT",diff --git a/scripts/check-plugin-manifests.mjs b/scripts/check-plugin-manifests.mjsnew file mode 100644index 0000000000..beb56dd091--- /dev/null+++ b/scripts/check-plugin-manifests.mjs@@ -0,0 +1,101 @@+#!/usr/bin/env node+// Static check that mirrors what the claude.ai plugin-upload validator reports.+// Run: node scripts/check-plugin-manifests.mjs [--root plugins]+//+// 1. Unknown top-level keys in .claude-plugin/plugin.json. The SDK strips them on upload.+// Allowed list source: the fields `claude plugin validate` (Claude Code 2.1.289) accepts at load+// time (probed key by key), plus `types` (Claude Code's mod type contract; see below), minus the+// store-listing fields (documentationUrl, icon, privacyPolicyUrl, supportUrl, termsOfServiceUrl),+// which the local validator accepts but the claude.ai validator strips. Keep that listing data in+// the plugin README and the directory submission JSON, not in plugin.json.+// EXCEPTION (verified 2026-10-09 on the claude.ai directory Listing tab for ruflo-ai-team): the+// directory builds its store listing (icon, documentation, support, privacy, terms) FROM those+// plugin.json keys, so they are allowlisted below as DIRECTORY_CONSUMED and only reported as notes.+// The claude.ai upload validator still warns about them; that warning is expected.+// 2. A plugin.json nested under .claude-plugin/ anywhere below a plugin root other than the root+// manifest (the validator mistakes it for a second plugin). Templates use plugin.json.tmpl.+// 3. XML-looking tags (<word>, </word>) in a SKILL.md frontmatter description: claude.ai strips them.+import { readdirSync, readFileSync, existsSync, statSync } from 'node:fs'+import { join, relative, sep } from 'node:path'++const ALLOWED = new Set([+ 'name', 'version', 'description', 'author', 'homepage', 'repository', 'license', 'keywords',+ 'commands', 'agents', 'skills', 'hooks', 'mcpServers', 'outputStyles', 'lspServers', 'userConfig',+ 'channels', 'dependencies', 'settings', 'monitors', 'themes', 'displayName',+])+// Known to Claude Code (mod type contract, read by `claude plugin validate` and the engine) but+// stripped by the claude.ai SDK. The only exception: a mod plugin needs it so its `$.<noun>` calls+// are checked against the contract. Never add to this list without a consumer that reads the key.+const CLAUDE_CODE_ONLY = new Set(['types'])+const DIRECTORY_CONSUMED = new Set(['documentationUrl', 'icon', 'privacyPolicyUrl', 'supportUrl', 'termsOfServiceUrl'])++const rootArg = process.argv.indexOf('--root')+const root = rootArg > 0 ? process.argv[rootArg + 1] : join(process.cwd(), 'plugins')+// Plugin roots the marketplace points at below a plugin dir (e.g. ./plugins/ruflo-ai-team/directory):+// each is a real plugin root, so its manifest is checked like any other and is not a "nested" one.+const marketplaceRoots = new Set()+try {+ const mkt = JSON.parse(readFileSync(join(root, '..', '.claude-plugin', 'marketplace.json'), 'utf8'))+ for (const p of mkt.plugins ?? []) if (typeof p.source === 'string') marketplaceRoots.add(p.source.replace(/^\.\//, '').replace(/^plugins\//, ''))+} catch { /* no marketplace next to the plugins dir */ }+const errors = []+const notes = []+const SKIP = new Set(['node_modules', '.git', 'dist'])++function walk(dir, fn) {+ for (const name of readdirSync(dir)) {+ if (SKIP.has(name)) continue+ const p = join(dir, name)+ const s = statSync(p)+ if (s.isDirectory()) { fn(p, true); walk(p, fn) } else fn(p, false)+ }+}++export function frontmatterDescription(text) {+ const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text)+ if (!m) return ''+ const lines = m[1].split(/\r?\n/)+ const i = lines.findIndex((l) => /^description\s*:/.test(l))+ if (i < 0) return ''+ let out = lines[i].replace(/^description\s*:\s*/, '')+ for (let j = i + 1; j < lines.length && /^\s+\S|^\s*$/.test(lines[j]); j++) out += ' ' + lines[j].trim()+ return out+}++for (const plugin of readdirSync(root).sort()) {+ const dir = join(root, plugin)+ if (!statSync(dir).isDirectory()) continue+ const manifests = [['', join(dir, '.claude-plugin', 'plugin.json')]]+ for (const r of marketplaceRoots) if (r.startsWith(plugin + '/')) manifests.push([r.slice(plugin.length + 1) + '/', join(root, r, '.claude-plugin', 'plugin.json')])+ for (const [prefix, manifest] of manifests) {+ if (!existsSync(manifest)) continue+ let json+ try { json = JSON.parse(readFileSync(manifest, 'utf8')) } catch (e) { errors.push(`${plugin}: ${prefix}plugin.json is not valid JSON (${e.message})`); continue }+ for (const key of Object.keys(json)) {+ if (ALLOWED.has(key)) continue+ if (CLAUDE_CODE_ONLY.has(key)) { notes.push(`${plugin}: '${key}' is Claude Code only (claude.ai strips it); kept on purpose`); continue }+ if (DIRECTORY_CONSUMED.has(key)) { notes.push(`${plugin}: '${prefix}${key}' is a directory-consumed store-listing key (claude.ai upload warns; expected)`); continue }+ errors.push(`${plugin}: unknown ${prefix}plugin.json key '${key}'`)+ }+ }+ walk(dir, (p, isDir) => {+ const rel = relative(dir, p).split(sep).join('/')+ const isMarketplaceRoot = [...marketplaceRoots].some((r) => r === `${plugin}/${rel.replace(/\/?\.claude-plugin\/plugin\.json$/, '')}`)+ if (!isDir && /(^|\/)\.claude-plugin\/plugin\.json$/.test(rel) && rel !== '.claude-plugin/plugin.json' && !isMarketplaceRoot) {+ errors.push(`${plugin}: nested manifest ${rel} (validator expects only .claude-plugin/plugin.json at the plugin root)`)+ }+ if (!isDir && /(^|\/)skills\/[^/]+\/SKILL\.md$/.test(rel)) {+ const d = frontmatterDescription(readFileSync(p, 'utf8'))+ const tag = /<\/?[A-Za-z!][^<>]*>/.exec(d)+ if (tag) errors.push(`${plugin}: ${rel} description contains tag-like text '${tag[0]}'`)+ }+ })+}++for (const n of notes) console.log(`note: ${n}`)+if (errors.length) {+ for (const e of errors) console.error(`FAIL: ${e}`)+ console.error(`${errors.length} problem(s)`)+ process.exit(1)+}+console.log('plugin manifests ok')