Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 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

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.yml
index 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.json
index 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.md
index 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 it
diff --git a/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.json b/plugins/ruflo-ai-team/directory/.claude-plugin/plugin.json
index 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.json
index 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.md
index 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 tests
diff --git a/plugins/ruflo-arena/scripts/smoke.sh b/plugins/ruflo-arena/scripts/smoke.sh
index 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 rule
step "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.json
index 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.md
index 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 tests
diff --git a/plugins/ruflo-graph-intelligence/README.md b/plugins/ruflo-graph-intelligence/README.md
index 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.json
index 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.md
index 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, changelog
diff --git a/plugins/ruflo-metaharness/scripts/smoke.sh b/plugins/ruflo-metaharness/scripts/smoke.sh
index 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 -u
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
PASS=0
@@ -32,10 +32,10 @@ else
bad "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'"
else
miss=""
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; do
diff --git a/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md b/plugins/ruflo-metaharness/skills/harness-bench/SKILL.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.json
index 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.md
index 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.md
index 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.mjs
new file mode 100644
index 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.sh
index 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'"; else
miss=""
for k in mcp scaffolding contract-bootstrap; do
grep -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 hooks
step "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 1
diff --git a/plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjs b/plugins/ruflo-plugin-creator/scripts/test-scaffold-mod.mjs
new file mode 100644
index 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.md
index 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
## Steps
1. **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.tmpl
similarity index 100%
rename from plugins/ruflo-plugin-creator/templates/mod/.claude-plugin/plugin.json
rename to plugins/ruflo-plugin-creator/templates/mod/plugin.json.tmpl
diff --git a/plugins/ruflo-workflows/.claude-plugin/plugin.json b/plugins/ruflo-workflows/.claude-plugin/plugin.json
index 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.md
index 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.sh
index 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'"; else
miss=""
for k in mcp workflow-templates pause-resume lifecycle; do
grep -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.json
index 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.md
index 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 it
diff --git a/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.json b/plugins/ruflo-x-gateway/directory/.claude-plugin/plugin.json
index 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.mjs
new file mode 100644
index 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')