Skip to content

ruvnet.

Python

feat(ruvnet): add named changes filters

rUv7be0b02509b2
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 99774d6..4364ec3 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -12,7 +12,7 @@
"name": "ruvnet",
"source": "./plugins/ruvnet",
"description": "RuV Stack skills and the federation MCP connector",
- "version": "0.9.0"
+ "version": "0.10.0"
}
]
}
diff --git a/README.md b/README.md
index 17c94e7..bf6a479 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
> **Start with the RuV Stack:** [Install skills + marketplace](docs/entrypoint/INSTALL.md) · [CLI / MCP guide](plugins/ruvnet/docs/INSTALL.md#local-cli-and-mcp-companion) · [MetaHarness](https://github.com/ruvnet/metaharness)
> Claude Code: `/plugin marketplace add ruvnet/ruvnet`, then `/plugin install ruvnet@ruvnet`.
-> Reviewed changes: `node plugins/ruvnet/bin/ruvnet.mjs search 5 --project ruflo --kind security federation policy` · snapshot-bound exact search with auditable filters, matched terms and continuation cursors · [Harness evidence](https://ruvnet-harness-evidence.ruv.chatgpt.site)
+> Reviewed changes: `node plugins/ruvnet/bin/ruvnet.mjs changes 5 --kind security` · snapshot-bound exact evidence with auditable filters and continuation cursors · [Harness evidence](https://ruvnet-harness-evidence.ruv.chatgpt.site)
> **September 2026:** RuView and Ruflo remain the two distribution anchors. Fourteen repositories were added since August 10, weighted toward governed evolution and agent operations: Dream Machine, Autogenous, ruClip, openAVO, LatentMesh, and MoE Foundry.
diff --git a/docs/self-improvement/2026-09-22-benchmarks.json b/docs/self-improvement/2026-09-22-benchmarks.json
new file mode 100644
index 0000000..449949c
--- /dev/null
+++ b/docs/self-improvement/2026-09-22-benchmarks.json
@@ -0,0 +1,368 @@
+{
+ "kind": "paired-local-changes-benchmark",
+ "seed": 1729,
+ "pairs": 15,
+ "hotCallsPerArmPerPair": 10000,
+ "coldStartsPerArmPerPair": 20,
+ "node": "v24.19.0",
+ "platform": "linux",
+ "arch": "x64",
+ "baselineCommit": "cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "candidate": "working-tree-before-commit",
+ "excludes": [
+ "model inference",
+ "semantic recall",
+ "network latency",
+ "host UI",
+ "end-to-end agent quality"
+ ],
+ "summary": {
+ "hotP50Ms": {
+ "baseline": 0.0011119999981019646,
+ "candidate": 0.0011909999993804377,
+ "delta": 0.00007900000127847306,
+ "deltaPercent": 7.104316673859308
+ },
+ "hotP95Ms": {
+ "baseline": 0.0012920000008307397,
+ "candidate": 0.0013020000005781185,
+ "delta": 0.000009999999747378752,
+ "deltaPercent": 0.7739937879991391
+ },
+ "coldP50Ms": {
+ "baseline": 58.944091000004846,
+ "candidate": 59.52617200000168,
+ "delta": 0.5820809999968333,
+ "deltaPercent": 0.9875137441627277
+ },
+ "coldP95Ms": {
+ "baseline": 66.90961799999991,
+ "candidate": 67.79722099999981,
+ "delta": 0.8876029999998991,
+ "deltaPercent": 1.3265701203075175
+ },
+ "rssBytes": {
+ "baseline": 62803968,
+ "candidate": 62672896,
+ "delta": -131072,
+ "deltaPercent": -0.2087001891345464
+ }
+ },
+ "samples": [
+ {
+ "pair": 0,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0016930000000030532,
+ "hotP95Ms": 0.0022430000000071004,
+ "coldP50Ms": 60.25109500000008,
+ "coldP95Ms": 66.90961799999991,
+ "rssBytes": 49221632
+ },
+ "candidate": {
+ "hotP50Ms": 0.0017530000000078871,
+ "hotP95Ms": 0.002984999999853244,
+ "coldP50Ms": 59.766192000000046,
+ "coldP95Ms": 71.39041999999972,
+ "rssBytes": 53403648
+ }
+ },
+ {
+ "pair": 1,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0012010000000373111,
+ "hotP95Ms": 0.001281999999719119,
+ "coldP50Ms": 58.900560999999925,
+ "coldP95Ms": 68.65849500000013,
+ "rssBytes": 53379072
+ },
+ "baseline": {
+ "hotP50Ms": 0.0015619999999216816,
+ "hotP95Ms": 0.0016430000000582368,
+ "coldP50Ms": 61.86227299999973,
+ "coldP95Ms": 72.25811799999974,
+ "rssBytes": 53145600
+ }
+ },
+ {
+ "pair": 2,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011220000005778274,
+ "hotP95Ms": 0.001352000000224507,
+ "coldP50Ms": 58.84790900000007,
+ "coldP95Ms": 66.5843590000004,
+ "rssBytes": 53145600
+ },
+ "candidate": {
+ "hotP50Ms": 0.0012009999991278164,
+ "hotP95Ms": 0.0012620000006791088,
+ "coldP50Ms": 60.40339900000072,
+ "coldP95Ms": 67.79722099999981,
+ "rssBytes": 53276672
+ }
+ },
+ {
+ "pair": 3,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0011920000006284681,
+ "hotP95Ms": 0.0013519999993150122,
+ "coldP50Ms": 59.74286399999983,
+ "coldP95Ms": 74.60847900000044,
+ "rssBytes": 53538816
+ },
+ "baseline": {
+ "hotP50Ms": 0.001172000000224216,
+ "hotP95Ms": 0.0012719999995169928,
+ "coldP50Ms": 63.73132900000019,
+ "coldP95Ms": 85.3500469999999,
+ "rssBytes": 53669888
+ }
+ },
+ {
+ "pair": 4,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.001172000000224216,
+ "hotP95Ms": 0.0012920000008307397,
+ "coldP50Ms": 60.753593000001274,
+ "coldP95Ms": 73.86543100000017,
+ "rssBytes": 53800960
+ },
+ "candidate": {
+ "hotP50Ms": 0.0012320000005274778,
+ "hotP95Ms": 0.002172999998947489,
+ "coldP50Ms": 64.49735900000087,
+ "coldP95Ms": 73.36859700000059,
+ "rssBytes": 53932032
+ }
+ },
+ {
+ "pair": 5,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0012320000005274778,
+ "hotP95Ms": 0.001883000000816537,
+ "coldP50Ms": 60.60692199999903,
+ "coldP95Ms": 69.4268260000008,
+ "rssBytes": 54063104
+ },
+ "baseline": {
+ "hotP50Ms": 0.001172000000224216,
+ "hotP95Ms": 0.001642000001083943,
+ "coldP50Ms": 61.7345179999993,
+ "coldP95Ms": 70.14411199999995,
+ "rssBytes": 55242752
+ }
+ },
+ {
+ "pair": 6,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0024740000008023344,
+ "coldP50Ms": 63.55895599999894,
+ "coldP95Ms": 70.35706599999867,
+ "rssBytes": 62451712
+ },
+ "candidate": {
+ "hotP50Ms": 0.0012320000023464672,
+ "hotP95Ms": 0.0013519999993150122,
+ "coldP50Ms": 58.88401800000065,
+ "coldP95Ms": 62.84595999999874,
+ "rssBytes": 62672896
+ }
+ },
+ {
+ "pair": 7,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0011909999993804377,
+ "hotP95Ms": 0.001291999997192761,
+ "coldP50Ms": 58.46790500000134,
+ "coldP95Ms": 65.21475499999724,
+ "rssBytes": 62672896
+ },
+ "baseline": {
+ "hotP50Ms": 0.0011110000014014076,
+ "hotP95Ms": 0.001260999997612089,
+ "coldP50Ms": 57.74489900000117,
+ "coldP95Ms": 68.85464800000045,
+ "rssBytes": 62803968
+ }
+ },
+ {
+ "pair": 8,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011110000014014076,
+ "hotP95Ms": 0.0012019999994663522,
+ "coldP50Ms": 56.75555700000041,
+ "coldP95Ms": 66.13394399999743,
+ "rssBytes": 62803968
+ },
+ "candidate": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0013319999998202547,
+ "coldP50Ms": 59.52617200000168,
+ "coldP95Ms": 65.17188399999941,
+ "rssBytes": 62935040
+ }
+ },
+ {
+ "pair": 9,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0012819999974453822,
+ "coldP50Ms": 59.572134000001824,
+ "coldP95Ms": 71.69075299999895,
+ "rssBytes": 63066112
+ },
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.0013020000005781185,
+ "coldP50Ms": 58.40377900000021,
+ "coldP95Ms": 64.25181800000064,
+ "rssBytes": 63066112
+ }
+ },
+ {
+ "pair": 10,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.0012419999984558672,
+ "coldP50Ms": 58.346364000000904,
+ "coldP95Ms": 63.37779599999703,
+ "rssBytes": 63197184
+ },
+ "candidate": {
+ "hotP50Ms": 0.0011820000036095735,
+ "hotP95Ms": 0.0012920000008307397,
+ "coldP50Ms": 59.37093399999867,
+ "coldP95Ms": 65.03903999999966,
+ "rssBytes": 63197184
+ }
+ },
+ {
+ "pair": 11,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0011909999993804377,
+ "hotP95Ms": 0.0012720000013359822,
+ "coldP50Ms": 58.217124999999214,
+ "coldP95Ms": 64.15417200000229,
+ "rssBytes": 63328256
+ },
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.001361999999062391,
+ "coldP50Ms": 58.78511900000012,
+ "coldP95Ms": 64.93401599999925,
+ "rssBytes": 63459328
+ }
+ },
+ {
+ "pair": 12,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.0012319999987084884,
+ "coldP50Ms": 60.120811000000685,
+ "coldP95Ms": 65.67403199999899,
+ "rssBytes": 63459328
+ },
+ "candidate": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0013319999998202547,
+ "coldP50Ms": 57.69160499999998,
+ "coldP95Ms": 63.79798900000242,
+ "rssBytes": 63590400
+ }
+ },
+ {
+ "pair": 13,
+ "order": [
+ "candidate",
+ "baseline"
+ ],
+ "candidate": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0013020000005781185,
+ "coldP50Ms": 58.74002399999881,
+ "coldP95Ms": 65.59468599999673,
+ "rssBytes": 63590400
+ },
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.0012320000023464672,
+ "coldP50Ms": 57.0947340000057,
+ "coldP95Ms": 62.82944499999576,
+ "rssBytes": 63721472
+ }
+ },
+ {
+ "pair": 14,
+ "order": [
+ "baseline",
+ "candidate"
+ ],
+ "baseline": {
+ "hotP50Ms": 0.0011119999981019646,
+ "hotP95Ms": 0.0012320000023464672,
+ "coldP50Ms": 58.944091000004846,
+ "coldP95Ms": 66.92311500000505,
+ "rssBytes": 63721472
+ },
+ "candidate": {
+ "hotP50Ms": 0.0011819999999715947,
+ "hotP95Ms": 0.0012819999974453822,
+ "coldP50Ms": 59.61522700000205,
+ "coldP95Ms": 68.2431230000002,
+ "rssBytes": 63721472
+ }
+ }
+ ]
+}
diff --git a/docs/self-improvement/2026-09-22-evidence.json b/docs/self-improvement/2026-09-22-evidence.json
new file mode 100644
index 0000000..9a72ad7
--- /dev/null
+++ b/docs/self-improvement/2026-09-22-evidence.json
@@ -0,0 +1,120 @@
+{
+ "date": "2026-09-22",
+ "baselineCommit": "cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "candidateCommit": null,
+ "finalCommit": null,
+ "decision": "accept-pending-exact-candidate-ci",
+ "candidate": "cli-changes-named-option-parity",
+ "version": "0.10.0",
+ "snapshotId": "sha256:96737b8cdbec3b0906591f97eb7c64e5c362cb4c750a7104898a7c6c738f3db9",
+ "lifecycle": {
+ "proposed": true,
+ "reproduced": true,
+ "integrationReady": true,
+ "merged": false,
+ "deployed": false,
+ "verified": false,
+ "reverted": false,
+ "claimBoundary": "Acceptance is not deployment or delivered customer value."
+ },
+ "evaluation": {
+ "heldOutRunnerSha256": "4d6c6b950ed9a52f94d906bef884c8cf5a20220bbda5be6ee653f600236dacab",
+ "baselinePassed": 1,
+ "candidatePassed": 6,
+ "total": 6,
+ "independentReview": "accept",
+ "measuredGap": "Core and MCP supported project-only and kind-only change views, while the CLI could not express kind-only or named views."
+ },
+ "metaharness": {
+ "package": "[email protected]",
+ "scope": "plugins/ruvnet",
+ "hardConstraints": "6/6",
+ "softConstraints": "3/4",
+ "claimBoundary": "The heuristic is a structural check; the frozen held-out CLI/MCP parity checks establish the measured gain."
+ },
+ "benchmark": {
+ "rawPath": "2026-09-22-benchmarks.json",
+ "rawSha256": "8ed3eab612d4e747a9ec7a985dd8e00cc7fd225a2b443aa088a2b929df5d07fb",
+ "runnerSha256": "459deefc34e3bf3ebf69039e12f22a6c5dd9a7f93889ab8bf31c798002fe7899",
+ "seed": 1729,
+ "alternatingPairs": 15,
+ "perArmPerPair": {"filteredChangeCalls": 10000, "coldCliStarts": 20},
+ "node": "v24.19.0",
+ "platform": "linux-x64",
+ "median": {
+ "hotSearchP95Ms": {"baseline": 0.0012920000008307397, "candidate": 0.0013020000005781185, "deltaMs": 0.000009999999747378752, "deltaPercent": 0.7739937879991391},
+ "coldCliP95Ms": {"baseline": 66.90961799999991, "candidate": 67.79722099999981, "deltaMs": 0.8876029999998991, "deltaPercent": 1.3265701203075175},
+ "rssBytes": {"baseline": 62803968, "candidate": 62672896, "deltaBytes": -131072}
+ },
+ "gatesPassed": true
+ },
+ "validation": {
+ "testGroupsPassed": 16,
+ "nodeVersions": ["22", "24"],
+ "skillsPassed": 4,
+ "marketplaceSchemas": 2,
+ "mcpTools": 6,
+ "mcpResources": 3,
+ "packageFiles": 18,
+ "compressedBytes": 30097,
+ "unpackedBytes": 103484,
+ "dependencyClosureSha256": "1f864e45fa38fa42e139b0e20523b90a2b97c06fc7c51f674234177e86e5e75c",
+ "candidateLockfileSha256": "5031c3259ba1bb94fa3cb156d4688faceee8cde83fe0bbb5403cd83aeeb1e3b3"
+ },
+ "security": {
+ "rufloPackage": "@claude-flow/[email protected]",
+ "deepCodeScan": {"critical": 0, "high": 0, "medium": 0, "low": 0},
+ "deepDependencyScan": {"critical": 0, "high": 0, "medium": 0, "low": 0},
+ "npmAudit": {"critical": 0, "high": 0, "moderate": 0, "low": 0},
+ "secretScan": {"findings": 0, "filesReportedByScanner": 5},
+ "threatScan": {"indicators": 0, "filesReportedByScanner": 4},
+ "authorityChange": "none",
+ "limitations": "Zero reported findings is not proof of complete security; secret and STRIDE scanner coverage is narrow."
+ },
+ "ruos": {
+ "runNonce": "0e88a97f-46bc-4e56-9f19-76fb1b402526",
+ "machineId": "59fc0c7fcdd873c1eba47092dfee29e2",
+ "status": "INCONCLUSIVE",
+ "probeIssued": false,
+ "reasonCodes": ["LIVENESS_UNPROVEN", "PEER_TELEMETRY_UNAVAILABLE", "LIVE_RECEIPT_NOT_REQUIRED_FOR_CLI_ONLY_CHANGE"],
+ "details": "All candidate desktops had null last_heartbeat_at. The frozen candidate does not affect desktop control, MCP UI, OAuth or a graphical user journey, so no evidence-free live probe was issued and live status was not used for promotion.",
+ "upstreamVerifier": {"revision": "aa931caad5dd0108253645bba0ab1481ad7da0ee", "preflightSha256": "e2643a4c0bf8271a297c36c74c830dd285938f8a534da53f604f7983c22330dd", "receiptVerifierSha256": "330189c4f31af1ab1dae37b97269cbc51834884f5a357415fb364c67932bb5eb", "focusedTests": "59/59"},
+ "claimBoundary": "No live tenant, workload, user-journey, desktop success, external deployment or customer-value claim is made."
+ },
+ "upstream": {
+ "observedAt": "2026-09-22T11:04:56Z",
+ "sources": [
+ {"project": "ruflo", "revision": "9c61c86f06b439af2a95085ae9bb0ca839662e41", "release": "3.42.5 npm; GitHub release 3.42.4", "license": "MIT", "compatibility": "Node >=20", "changedSincePrior": true, "incorporated": true},
+ {"project": "metaharness", "revision": "d5833dc6512ac1adeeef91a331c29055cd8a4dbb", "release": "0.4.4", "license": "MIT", "compatibility": "Node >=20; Rust 1.85", "changedSincePrior": false},
+ {"project": "ruvector", "revision": "fad751b21bc41f27809147cb7ac8b75b4ffdb890", "release": "ruvector-v0.2.40; npm ruvector 0.3.2", "license": "MIT", "compatibility": "Node >=20 root; new packages Node >=18", "changedSincePrior": true, "incorporated": true},
+ {"project": "agentdb", "revision": "6cdefe451f6afe7395bc88d3587a0225d161089b", "release": "3.0.0-alpha.20", "license": "MIT", "compatibility": "Node >=18", "changedSincePrior": false},
+ {"project": "dream-machine", "revision": "aa931caad5dd0108253645bba0ab1481ad7da0ee", "release": "0.1.0", "license": "MIT", "compatibility": "Node ^22.13 or ^24", "changedSincePrior": false},
+ {"project": "autogenous", "revision": "905aa6cbe213392f8b3cab5d4f17bc3a48e0a509", "release": "radio-moe-v0.3.1", "license": "MIT", "compatibility": "Rust 1.74", "changedSincePrior": false},
+ {"project": "rvm", "revision": "0973d77e5a9e99065376e8ef772a4a1d16e88c75", "release": "1.7.0", "license": "MIT OR Apache-2.0 declared; license files absent", "compatibility": "Rust 1.77", "changedSincePrior": false, "incorporated": false}
+ ],
+ "newRecordsIncorporated": 6,
+ "recordBoundary": "Upstream capabilities and failures are recorded separately. KGE is not GNN; WASM was not runtime-benchmarked here; failed calibration and adversarial gates are not promoted as successes.",
+ "xRuvIo": {"version": "0.7.2", "routes": ["/mcp", "/chatgpt/mcp"], "changedSincePrior": false}
+ },
+ "memory": {
+ "eligibleSanitizedRecords": 59,
+ "exactCandidateImplemented": true,
+ "coordinationPatternStored": true,
+ "coordinationPatternDimensions": 384,
+ "persistentVectorMemoryImplementedInProduct": false,
+ "wasmAccelerationImplementedInProduct": false,
+ "gnnTrainingImplemented": false,
+ "decision": "Product RuVector, WASM and GNN remain deferred below the frozen 100-record gate; no autonomous-learning claim is made."
+ },
+ "forecast": {
+ "prediction": "Agent-harness promotion reports will increasingly require independent repeated-run reliability, such as strict all-runs success or a bounded flake rate, alongside single-run success for stateful MCP workflows.",
+ "status": "prediction, not established result",
+ "confidencePercent": 82,
+ "horizonDate": "2026-12-21",
+ "criterion": "At least two new primary benchmark implementations or reviewed production harnesses published after 2026-09-22 report fixed-workload results from at least four isolated independent runs per task and use all-runs success or a bounded-flake threshold as a promotion gate.",
+ "sources": ["https://arxiv.org/abs/2509.24002", "https://arxiv.org/abs/2601.06112", "https://arxiv.org/abs/2608.14711"],
+ "priorForecastsExpired": []
+ },
+ "ci": {"runUrl": null, "status": "pending-exact-candidate", "node22": null, "node24": null},
+ "dashboard": "https://ruvnet-harness-evidence.ruv.chatgpt.site"
+}
diff --git a/docs/self-improvement/2026-09-22-plan.json b/docs/self-improvement/2026-09-22-plan.json
new file mode 100644
index 0000000..2df61e9
--- /dev/null
+++ b/docs/self-improvement/2026-09-22-plan.json
@@ -0,0 +1,77 @@
+{
+ "date": "2026-09-22",
+ "frozenAt": "2026-09-22T10:51:00Z",
+ "frozenBeforeImplementation": true,
+ "baselineCommit": "cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "targetBranch": "main",
+ "targetHeadAtFreeze": "cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "candidate": "cli-changes-named-option-parity",
+ "hypothesis": "Adding exact named --project, --kind, --cursor and --snapshot-id options to CLI changes will expose the reviewed evidence views already available through core and MCP, including cross-project negative results, while preserving legacy positional compatibility, snapshot-bound pagination, read-only authority and fixed performance limits.",
+ "motivation": {
+ "measuredBaselineGap": "Core and MCP support project-only and kind-only change views. CLI positional syntax cannot express a kind-only view and treats named options as project identifiers.",
+ "acceptedUnintegrated": "None. Every accepted entrypoint candidate through 0.9.0 is an ancestor of current main; vector/WASM/GNN work is deferred, not accepted.",
+ "forecast": "Yesterday's should-act/should-abstain forecast makes cross-project negative-result retrieval a useful deterministic evidence view without adding decision automation. Today's separate forecast tests whether repeated-run reliability becomes a promotion requirement for future stateful MCP evaluation."
+ },
+ "evaluator": {
+ "path": "/workspace/scratch/fd7c4c948d76/heldout-20260922.mjs",
+ "sha256": "4d6c6b950ed9a52f94d906bef884c8cf5a20220bbda5be6ee653f600236dacab",
+ "authority": "external read-only held-out runner; not shipped with the candidate"
+ },
+ "baselineResult": {
+ "passed": 1,
+ "total": 6
+ },
+ "heldOut": [
+ "named kind-only negative-result view matches an independent core oracle and contains only negative results",
+ "named project-only Ruflo view matches an independent core oracle and contains only Ruflo records",
+ "combined named filters equal legacy positional output and legacy behavior remains compatible",
+ "named filters compose with pagination and snapshot preconditions; changed filters or snapshot fail closed",
+ "missing, duplicate, unknown, control-character, authority-expanding and mixed named/positional forms fail nonzero with no JSON stdout",
+ "CLI and MCP expose identical snapshot, filters, ordering, results and continuation state; omitted named options preserve defaults"
+ ],
+ "acceptance": {
+ "heldOut": "6/6 and strictly better than the frozen 1/6 baseline",
+ "tests": "all existing and new tests pass on Node 22 and 24",
+ "schemas": "both marketplace schemas, four skills, six MCP tools and three resources validate",
+ "metaharness": "[email protected] retains 6/6 hard constraints; heuristic score alone is not proof",
+ "security": "zero confirmed high or critical findings; scanner coverage and residual risk disclosed",
+ "performance": {
+ "design": "15 alternating pairs; 10000 filtered changes calls and 20 cold CLI starts per arm per pair; seed 1729",
+ "changesP95": "candidate no more than 20 percent and 0.05 ms above baseline median",
+ "coldCliP95": "candidate no more than 20 percent and 5 ms above baseline median",
+ "rss": "candidate no more than 5242880 bytes above baseline median"
+ },
+ "package": "normalized dependency closure unchanged, package validates and compressed archive remains below 40000 bytes"
+ },
+ "ruos": {
+ "runNonce": "0e88a97f-46bc-4e56-9f19-76fb1b402526",
+ "machineId": "59fc0c7fcdd873c1eba47092dfee29e2",
+ "selection": "Existing dedicated evolution-candidate desktop; the personal Mac and unrelated desktops are excluded.",
+ "baseline": "cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "candidate": "cli-changes-named-option-parity working tree before commit",
+ "target": "ruvnet/ruvnet main at cb3b080282aaad13fdc5dec4b45265f997a940b3",
+ "evaluator": "trusted Dream Machine main verifier at aa931caad5dd0108253645bba0ab1481ad7da0ee",
+ "workloadDigest": "sha256:4d6c6b950ed9a52f94d906bef884c8cf5a20220bbda5be6ee653f600236dacab",
+ "environmentDigest": "sha256:fd7fa8a65fbc116a1d58df9972a691b3042173ceddd57167816921eaca30915d",
+ "expectedTenant": "authenticated-current-tenant-undisclosed",
+ "assertionIds": ["executor-status-ok", "numeric-exit-code-zero", "completion-version-one", "completion-verified", "fresh-screenshot-bytes", "no-human-takeover"],
+ "minimumSamples": 1,
+ "freshnessSeconds": 120,
+ "regressionThresholds": {"heldOutMinimum": 6, "coldCliP95Percent": 20, "coldCliP95AbsoluteMs": 5, "rssBytes": 5242880},
+ "preflight": "This CLI-only candidate does not change desktop control, MCP UI, OAuth or a graphical user journey. A live desktop probe is not required for promotion. If attempted, require a current heartbeat before one harmless command and one screenshot.",
+ "decision": "All candidate desktops have null last_heartbeat_at and peer telemetry is unavailable. Live desktop status is INCONCLUSIVE; do not issue an evidence-free probe or infer readiness from provisioning state."
+ },
+ "memory": {
+ "baseline": "deterministic exact search",
+ "gate": 100,
+ "eligibleRecordsBeforeUpstreamReview": 53,
+ "decision": "Do not add RuVector, WASM or GNN complexity below the frozen record gate."
+ },
+ "forecast": {
+ "prediction": "Agent-harness promotion reports will increasingly require independent repeated-run reliability, such as strict pass^k or a bounded flake rate, alongside single-run success for stateful MCP workflows.",
+ "confidencePercent": 82,
+ "horizonDate": "2026-12-21",
+ "criterion": "At least two new primary benchmark implementations or reviewed production harnesses published after 2026-09-22 report fixed-workload results from at least four isolated independent runs per task and use all-runs success or a bounded-flake threshold as a promotion gate."
+ },
+ "rollback": "Revert the candidate commit; version 0.9.0 behavior remains its parent."
+}
diff --git a/docs/self-improvement/2026-09-22.md b/docs/self-improvement/2026-09-22.md
new file mode 100644
index 0000000..244f7d4
--- /dev/null
+++ b/docs/self-improvement/2026-09-22.md
@@ -0,0 +1,45 @@
+# RuVnet harness improvement — 2026-09-22
+
+## Decision
+
+Accepted named-option parity for the reviewed change feed as RuVnet entry point 0.10.0. `ruvnet changes` now accepts `--project`, `--kind`, `--cursor` and `--snapshot-id` while preserving the legacy positional interface. Duplicate, mixed, missing, unknown, control-character and authority-expanding arguments fail closed. The companion remains offline, read only and unable to refresh, execute or learn by itself.
+
+No accepted-but-unintegrated candidate was found: every prior accepted entrypoint candidate is an ancestor of the frozen `main` baseline. Independent review accepted this candidate and found no authority expansion.
+
+## Upstream review
+
+Ruflo advanced to [`9c61c86`](https://github.com/ruvnet/ruflo/commit/9c61c86f06b439af2a95085ae9bb0ca839662e41) and npm 3.42.5 under MIT. A reviewed record at [`11ce883`](https://github.com/ruvnet/ruflo/commit/11ce88327b31c1684a5f91a4c8c11022b637b3bb) captures its real ReasoningBank AgentDB embedder/store/search mapping, while retaining the disclosed per-row SQLite and no-HNSW boundary.
+
+RuVector advanced to [`fad751b`](https://github.com/ruvnet/RuVector/commit/fad751b21bc41f27809147cb7ac8b75b4ffdb890) under MIT. Five records distinguish: upstream HNSW neighbor-selection validation; local typed-decision support; its failed calibration receipt; KGE native/Node/WASM implementation; and its failed adversarial gate. KGE is not GNN training. Its WASM path was compile/import audited upstream, not runtime benchmarked here. The failed gates are preserved as separate negative-result records. MetaHarness, AgentDB, Dream Machine, Autogenous and RVM did not change. [x.ruv.io](https://x.ruv.io/) remains gateway 0.7.2 with `/mcp` and `/chatgpt/mcp`. Linked content is treated as untrusted evidence.
+
+## MetaHarness loop and measurements
+
+The [frozen plan](2026-09-22-plan.json) defined the hypothesis, six held-out checks and fixed gates before implementation. Baseline `cb3b080` passed 1/6 checks because its CLI could not express named or kind-only change views; the candidate passed 6/6. It matched independent core oracles, preserved byte-equivalent combined legacy output, traversed snapshot-bound pages without duplication, rejected changed-filter cursors and invalid input, and matched MCP evidence views.
+
+All 16 test groups passed on Node 22 and 24. Both marketplace schemas, four skills, six MCP tools and three resources validated. MetaHarness 0.4.16 retained 6/6 hard constraints; its heuristic score is not proof of improvement.
+
+Fifteen alternating pairs used 10,000 filtered change calls and 20 cold CLI starts per arm per pair. Median hot-search p95 rose from 0.001292 ms to 0.001302 ms (+0.77%, +0.000010 ms). Cold CLI p95 rose from 66.909618 ms to 67.797221 ms (+1.33%, +0.887603 ms), and RSS decreased 131,072 bytes. All frozen gates passed. These local microtimings are not end-user performance claims; [raw samples](2026-09-22-benchmarks.json) preserve every run.
+
+The package is 30,097 compressed bytes across 18 files and its normalized dependency closure is unchanged. Pinned Ruflo 3.25.6 deep code and dependency scans and npm audit reported zero known findings. The bundled secret scanner covered five files and STRIDE scan four, so coverage is limited. Cursor hashes are consistency bindings, not authentication. This is not a claim of complete security.
+
+Exact candidate commit and GitHub Actions links are populated after the immutable candidate is pushed and verified.
+
+## ruOS evaluation
+
+Status: **INCONCLUSIVE**. Every candidate desktop had a null heartbeat and fleet peer telemetry was unavailable. This CLI-only change does not affect desktop control, MCP UI, OAuth or a graphical user journey, so the frozen policy did not require a live probe. No evidence-free command or screenshot request was issued. Liveness, tenant binding, authoritative completion and pixels remain unproven.
+
+The trusted Dream Machine runbook and verifier at `aa931ca` were reviewed, and their 59 focused tests passed. Those synthetic verifier tests do not establish a live desktop or customer journey. No desktop, deployment or customer-value claim is made.
+
+## RuVector, WASM and GNN decision
+
+The sanitized corpus is 11 catalog projects plus 48 reviewed changes: 59 records, below the frozen 100-record gate. Exact retrieval remains the implemented baseline. Product RuVector retrieval, WASM acceleration, GNN training and persistent autonomous learning remain unimplemented and unclaimed. The local coordination memory stored and retrieved one sanitized 384-dimensional pattern for run continuity; that is orchestration evidence, not a shipped harness capability or proof of learning value.
+
+Future evaluation remains exact versus vector-only, fusion, GNN reranking and shuffled-graph control, requiring at least a ten-point held-out task-success gain plus relevance, p50/p95 latency, cold start, memory, artifact size, fixed seeds and reproducibility evidence.
+
+## Forecast
+
+Prediction, 82% confidence by 2026-12-21: agent-harness promotion reports will increasingly require independent repeated-run reliability—strict all-runs success or a bounded flake rate—alongside single-run success for stateful MCP workflows. It passes only if at least two new primary benchmark implementations or reviewed production harnesses published after 2026-09-22 report at least four isolated independent runs per task and use all-run success or a bounded-flake threshold as a promotion gate.
+
+Established evidence is narrower. [MCPMark](https://arxiv.org/abs/2509.24002) evaluates reset stateful MCP sandboxes across four runs and reports a substantial gap between single-run and all-four success. [ReliabilityBench](https://arxiv.org/abs/2601.06112) measures repeated executions and perturbations across 1,280 episodes. [Beyond Pass@k](https://arxiv.org/abs/2608.14711) analyzes independent rollouts and metric inflation. These sources motivate the prediction; they do not prove future adoption. No prior forecast horizon expired today.
+
+Next hypothesis: add an explicitly bounded repeated-run reliability receipt for the stateful MCP surface before considering semantic memory; keep the 100-record vector/GNN gate.
diff --git a/plugins/ruvnet/.claude-plugin/plugin.json b/plugins/ruvnet/.claude-plugin/plugin.json
index 4b15aad..4b3bfe4 100644
--- a/plugins/ruvnet/.claude-plugin/plugin.json
+++ b/plugins/ruvnet/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "ruvnet",
- "version": "0.9.0",
+ "version": "0.10.0",
"description": "Your entry point to the RuV Stack: discovery, federation and governed MetaHarness integration.",
"author": {
"name": "rUv",
diff --git a/plugins/ruvnet/.codex-plugin/plugin.json b/plugins/ruvnet/.codex-plugin/plugin.json
index 528ad31..07f6da7 100644
--- a/plugins/ruvnet/.codex-plugin/plugin.json
+++ b/plugins/ruvnet/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "ruvnet",
- "version": "0.9.0",
+ "version": "0.10.0",
"description": "Discover and integrate the RuV Stack with bounded skills and the Ruflo federation.",
"author": {
"name": "rUv",
diff --git a/plugins/ruvnet/bin/ruvnet.mjs b/plugins/ruvnet/bin/ruvnet.mjs
index 56f8dbd..fd51a01 100644
--- a/plugins/ruvnet/bin/ruvnet.mjs
+++ b/plugins/ruvnet/bin/ruvnet.mjs
@@ -4,16 +4,38 @@ import { VERSION, discover, project, changes, searchChanges, plan, connect } fro
async function main(args) {
const [command, ...rest] = args;
if (!command || command === 'help' || command === '--help') {
- console.log(`RuV Stack entrypoint ${VERSION}\n\nruvnet catalog [keywords] Discover source-linked projects\nruvnet project <id> Inspect one project with upstream provenance\nruvnet changes [limit] [project] [kind] [cursor] [snapshot-id] Page one reviewed snapshot\nruvnet search [limit] [options] <keywords...> Search and page reviewed exact-token matches\n --project <id> --kind <kind> --min-raw-relevance 0..1\n --cursor <cursor> --snapshot-id <id>\nruvnet plan <goal> Advisory MetaHarness integration plan\nruvnet connect <host> chatgpt, claude, claude-code, lovable, codex, stdio\nruvnet mcp Local read-only MCP over stdio\n\nNo shell execution, repository writes, network calls or federation signing.\nHosted federation: ChatGPT https://x.ruv.io/chatgpt/mcp · other hosts https://x.ruv.io/mcp\nInstall: https://github.com/ruvnet/ruvnet/blob/main/docs/entrypoint/INSTALL.md`);
+ console.log(`RuV Stack entrypoint ${VERSION}\n\nruvnet catalog [keywords] Discover source-linked projects\nruvnet project <id> Inspect one project with upstream provenance\nruvnet changes [limit] [options] Page one reviewed snapshot\n --project <id> --kind <kind> --cursor <cursor> --snapshot-id <id>\n legacy: changes [limit] [project] [kind] [cursor] [snapshot-id]\nruvnet search [limit] [options] <keywords...> Search and page reviewed exact-token matches\n --project <id> --kind <kind> --min-raw-relevance 0..1\n --cursor <cursor> --snapshot-id <id>\nruvnet plan <goal> Advisory MetaHarness integration plan\nruvnet connect <host> chatgpt, claude, claude-code, lovable, codex, stdio\nruvnet mcp Local read-only MCP over stdio\n\nNo shell execution, repository writes, network calls or federation signing.\nHosted federation: ChatGPT https://x.ruv.io/chatgpt/mcp · other hosts https://x.ruv.io/mcp\nInstall: https://github.com/ruvnet/ruvnet/blob/main/docs/entrypoint/INSTALL.md`);
return;
}
if (command === '--version' && !rest.length) return console.log(VERSION);
if (command === 'mcp' && !rest.length) return (await import('../lib/mcp.mjs')).serve();
let result;
if (command === 'catalog') result = discover(rest.join(' '), 10);
- else if (command === 'changes' && rest.length <= 5) {
- const limit = rest.length ? Number(rest[0]) : 10;
- result = changes(limit, Date.now(), { ...(rest[1] === undefined ? {} : { project: rest[1] }), ...(rest[2] === undefined ? {} : { kind: rest[2] }) }, rest[3], rest[4]);
+ else if (command === 'changes') {
+ const parts = [...rest];
+ const limit = /^\d+$/.test(parts[0] || '') ? Number(parts.shift()) : 10;
+ if (parts.some(part => part.startsWith('--'))) {
+ const takeOption = name => {
+ const indexes = parts.flatMap((part, index) => part === name ? [index] : []);
+ if (indexes.length > 1 || (indexes.length && (indexes[0] + 1 >= parts.length || parts[indexes[0] + 1].startsWith('--')))) throw new Error(`Invalid ${name} arguments`);
+ if (!indexes.length) return undefined;
+ const value = parts[indexes[0] + 1];
+ parts.splice(indexes[0], 2);
+ return value;
+ };
+ const projectId = takeOption('--project');
+ const kind = takeOption('--kind');
+ const cursor = takeOption('--cursor');
+ const snapshotId = takeOption('--snapshot-id');
+ if (parts.length) throw new Error('Unknown or mixed changes arguments');
+ result = changes(limit, Date.now(), {
+ ...(projectId === undefined ? {} : { project: projectId }),
+ ...(kind === undefined ? {} : { kind })
+ }, cursor, snapshotId);
+ } else {
+ if (parts.length > 4) throw new Error('Invalid changes arguments');
+ result = changes(limit, Date.now(), { ...(parts[0] === undefined ? {} : { project: parts[0] }), ...(parts[1] === undefined ? {} : { kind: parts[1] }) }, parts[2], parts[3]);
+ }
}
else if (command === 'search') {
const parts = [...rest];
diff --git a/plugins/ruvnet/data/upstream.json b/plugins/ruvnet/data/upstream.json
index e5f8059..3889ae4 100644
--- a/plugins/ruvnet/data/upstream.json
+++ b/plugins/ruvnet/data/upstream.json
@@ -1,16 +1,22 @@
{
"schemaVersion": 1,
- "observedAt": "2026-09-21T10:14:18Z",
+ "observedAt": "2026-09-22T11:04:56Z",
"retention": "This file is a reviewed current snapshot. Dated reports under docs/self-improvement preserve prior observations.",
"sources": [
- {"id":"ruflo","repository":"https://github.com/ruvnet/ruflo","revision":"a4f219935ff4035421bc01157a5a1abc74529ad2","committedAt":"2026-09-20T13:44:15Z","license":"MIT"},
+ {"id":"ruflo","repository":"https://github.com/ruvnet/ruflo","revision":"9c61c86f06b439af2a95085ae9bb0ca839662e41","committedAt":"2026-09-21T19:42:33Z","license":"MIT"},
{"id":"metaharness","repository":"https://github.com/ruvnet/metaharness","revision":"d5833dc6512ac1adeeef91a331c29055cd8a4dbb","committedAt":"2026-09-05T15:29:24Z","license":"MIT"},
- {"id":"ruvector","repository":"https://github.com/ruvnet/RuVector","revision":"b336fbae8b15a5a487fc3e7c14a80dcb4984b04a","committedAt":"2026-09-16T20:32:22Z","license":"MIT"},
+ {"id":"ruvector","repository":"https://github.com/ruvnet/RuVector","revision":"fad751b21bc41f27809147cb7ac8b75b4ffdb890","committedAt":"2026-09-21T23:56:51Z","license":"MIT"},
{"id":"agentdb","repository":"https://github.com/ruvnet/agentdb","revision":"6cdefe451f6afe7395bc88d3587a0225d161089b","committedAt":"2026-07-30T00:59:00Z","license":"MIT"},
{"id":"dream-machine","repository":"https://github.com/ruvnet/dream-machine","revision":"aa931caad5dd0108253645bba0ab1481ad7da0ee","committedAt":"2026-09-20T03:11:32Z","license":"MIT"},
{"id":"autogenous","repository":"https://github.com/ruvnet/autogenous","revision":"905aa6cbe213392f8b3cab5d4f17bc3a48e0a509","committedAt":"2026-09-16T01:58:33Z","license":"MIT"}
],
"changes": [
+ {"id":"ruvector-kge-adversarial-gate-failure","project":"ruvector","revision":"bc47371e551a801386b083f1e7aedc2f437841dc","committedAt":"2026-09-21T23:48:42Z","kind":"negative-result","summary":"The stored synthetic KGE receipt passes ANN recall and native latency but fails its adversarial confidence-drop gate; the full FB15K-237 gate is skipped because evaluation uses only a 500-entity slice, and WASM is compile/import audited rather than runtime benchmarked.","evidence":"https://github.com/ruvnet/RuVector/commit/bc47371e551a801386b083f1e7aedc2f437841dc"},
+ {"id":"ruvector-kge-wasm-implementation","project":"ruvector","revision":"bc47371e551a801386b083f1e7aedc2f437841dc","committedAt":"2026-09-21T23:48:42Z","kind":"learning","summary":"Implements HolE and RotatE knowledge-graph embeddings, ANN retrieval, FFI and WASM bindings with a bounded governed optimization campaign; this is KGE rather than GNN training or autonomous persistent learning.","evidence":"https://github.com/ruvnet/RuVector/commit/bc47371e551a801386b083f1e7aedc2f437841dc"},
+ {"id":"ruvector-typesafe-calibration-gate-failure","project":"ruvector","revision":"950e1cb7d951c5e7339c32df2d9825088a2a750f","committedAt":"2026-09-21T21:29:48Z","kind":"negative-result","summary":"The stored native 8-shot receipt misses its accuracy and calibration gates, while the optimization champion clears accuracy but still misses the ECE threshold; no validated replacement claim is made.","evidence":"https://github.com/ruvnet/RuVector/commit/950e1cb7d951c5e7339c32df2d9825088a2a750f"},
+ {"id":"ruvector-typesafe-local-decisions","project":"ruvector","revision":"950e1cb7d951c5e7339c32df2d9825088a2a750f","committedAt":"2026-09-21T21:29:48Z","kind":"learning","summary":"Implements local typed choice, score and abstention decisions over sentence embeddings with native, Node and WASM surfaces; upstream package checks pass, but stored calibration evidence retains failed gates separately.","evidence":"https://github.com/ruvnet/RuVector/commit/950e1cb7d951c5e7339c32df2d9825088a2a750f"},
+ {"id":"ruflo-reasoningbank-embedder-activation","project":"ruflo","revision":"11ce88327b31c1684a5f91a4c8c11022b637b3bb","committedAt":"2026-09-21T18:50:56Z","kind":"memory","summary":"Activates the real AgentDB embedder and corrects the ReasoningBank store/search bridge contract; the path still uses legacy per-row SQLite embeddings without the VectorBackend or HNSW.","evidence":"https://github.com/ruvnet/ruflo/commit/11ce88327b31c1684a5f91a4c8c11022b637b3bb"},
+ {"id":"ruvector-router-hnsw-neighbor-selection","project":"ruvector","revision":"40d2e281de74fbb0156c12c57b63eaad423d5030","committedAt":"2026-09-21T18:11:13Z","kind":"correctness","summary":"Ships a diversity-aware HNSW neighbor-selection heuristic and makes database construction honor documented DbOptions; upstream dedicated tests and measured recall/latency checks pass, while a WASM router build issue remains outside this change.","evidence":"https://github.com/ruvnet/RuVector/commit/40d2e281de74fbb0156c12c57b63eaad423d5030"},
{"id":"ruflo-streaming-swarm-proposal","project":"ruflo","revision":"a4f219935ff4035421bc01157a5a1abc74529ad2","committedAt":"2026-09-20T13:44:15Z","kind":"proposal","summary":"Proposes making swarm start a streaming, steerable, long-horizon orchestrator with explicit artifacts and summaries; this ADR is proposed design only, not implemented autonomous execution.","evidence":"https://github.com/ruvnet/ruflo/commit/a4f219935ff4035421bc01157a5a1abc74529ad2"},
{"id":"ruflo-swarm-start-execution-gap","project":"ruflo","revision":"a4f219935ff4035421bc01157a5a1abc74529ad2","committedAt":"2026-09-20T13:44:15Z","kind":"negative-result","summary":"Documents that the current swarm start path initializes coordination and returns without executing the objective, producing no task artifacts unless a separate execution driver is invoked.","evidence":"https://github.com/ruvnet/ruflo/blob/a4f219935ff4035421bc01157a5a1abc74529ad2/v3/docs/adr/ADR-385-streaming-interactive-long-horizon-swarm-execution.md"},
{"id":"dream-machine-ruos-evaluation-receipts","project":"dream-machine","revision":"aa931caad5dd0108253645bba0ab1481ad7da0ee","committedAt":"2026-09-20T03:11:32Z","kind":"evaluation","summary":"Adds an opt-in governed ruOS evaluation boundary with frozen commit, evaluator, workload, environment, tenant, assertion, screenshot and completion-provenance checks; receipts explicitly carry no merge authority.","evidence":"https://github.com/ruvnet/dream-machine/commit/aa931caad5dd0108253645bba0ab1481ad7da0ee"},
diff --git a/plugins/ruvnet/docs/INSTALL.md b/plugins/ruvnet/docs/INSTALL.md
index 29d1f4f..4f215d2 100644
--- a/plugins/ruvnet/docs/INSTALL.md
+++ b/plugins/ruvnet/docs/INSTALL.md
@@ -49,6 +49,8 @@ npm ci --ignore-scripts
node bin/ruvnet.mjs catalog memory
node bin/ruvnet.mjs changes 5
node bin/ruvnet.mjs changes 5 ruflo security
+node bin/ruvnet.mjs changes 5 --kind negative-result
+node bin/ruvnet.mjs changes 5 --project ruflo --kind security
node bin/ruvnet.mjs search 5 raw retrieval ranking
node bin/ruvnet.mjs search 5 --min-raw-relevance 1 raw retrieval ranking
node bin/ruvnet.mjs search 5 --project ruflo --kind security federation policy
@@ -71,12 +73,12 @@ Copy the returned `config.mcpServers.ruvnet-guide` object into a host that suppo
| --- | --- |
| `ruvnet_discover` | Search the dated catalog by exact keyword overlap. |
| `ruvnet_project` | Read a project, source links and its maturity boundary. |
-| `ruvnet_changes` | Page through one content-addressed upstream snapshot with exact revisions, evidence links and freshness; optionally filter by the schema's exact `project` and `kind` enum values. |
+| `ruvnet_changes` | Page through one content-addressed upstream snapshot with exact revisions, evidence links and freshness; optionally filter by the schema's exact `project` and `kind` enum values. CLI named options are `--project`, `--kind`, `--cursor`, and `--snapshot-id`; the original positional form remains supported. |
| `ruvnet_search_changes` | Search and page reviewed records by exact token overlap with matched terms and a raw overlap fraction; optionally filter by exact `project` or `kind` and set `minRawRelevance` from 0 to 1. CLI flags are `--project`, `--kind`, and `--min-raw-relevance`; MCP uses the corresponding fields. Continue with the identical query, filters and threshold plus the returned cursor and snapshot ID. No semantic similarity, ranking confidence, answer confidence or utility is inferred. |
| `ruvnet_plan` | Return an advisory SPARC/MetaHarness plan, without executing it. |
| `ruvnet_connect` | Return connection guidance; it does not change configuration. |
-Resources: `ruv://catalog`, `ruv://changes`, `ruv://federation`. Prompt: `ruvnet-start` with a `goal` argument. The local process has no HTTP listener, network tools, shell execution or mutable memory. Both change listing and exact search return opaque continuation cursors bound to the content snapshot and their complete query state. Continue with the returned `nextCursor` and `snapshotId` without changing filters, query or threshold. CLI search accepts `--project`, `--kind`, `--cursor`, and `--snapshot-id`; MCP uses `project`, `kind`, `cursor`, and `snapshotId`. If a precondition is rejected, discard cached pages and restart without either value. Snapshot identifiers and receipt hashes bind content; they are not authorization tokens, signatures or proof of successful execution. Inspect `freshness.state` before relying on the data; `stale` begins at 72 hours and `clock-skew` means the observation appears to be in the future. An empty result is not evidence that upstream has no matching change. A remote-only host cannot connect directly to local stdio.
+Resources: `ruv://catalog`, `ruv://changes`, `ruv://federation`. Prompt: `ruvnet-start` with a `goal` argument. The local process has no HTTP listener, network tools, shell execution or mutable memory. Both change listing and exact search return opaque continuation cursors bound to the content snapshot and their complete query state. Continue with the returned `nextCursor` and `snapshotId` without changing filters, query or threshold. CLI changes and search accept `--project`, `--kind`, `--cursor`, and `--snapshot-id`; MCP uses `project`, `kind`, `cursor`, and `snapshotId`. Search additionally accepts `--min-raw-relevance`. Do not mix the changes command's named mode with its legacy positional mode. If a precondition is rejected, discard cached pages and restart without either value. Snapshot identifiers and receipt hashes bind content; they are not authorization tokens, signatures or proof of successful execution. Inspect `freshness.state` before relying on the data; `stale` begins at 72 hours and `clock-skew` means the observation appears to be in the future. An empty result is not evidence that upstream has no matching change. A remote-only host cannot connect directly to local stdio.
## Codex repository marketplace
diff --git a/plugins/ruvnet/lib/core.mjs b/plugins/ruvnet/lib/core.mjs
index e192cc7..1655b30 100644
--- a/plugins/ruvnet/lib/core.mjs
+++ b/plugins/ruvnet/lib/core.mjs
@@ -2,7 +2,7 @@ import { readFileSync } from 'node:fs';
import { fileURLToPath } from 'node:url';
import { createHash } from 'node:crypto';
-export const VERSION = '0.9.0';
+export const VERSION = '0.10.0';
export const FRESHNESS_MAX_AGE_HOURS = 72;
export const CATALOG = JSON.parse(readFileSync(new URL('../data/catalog.json', import.meta.url), 'utf8'));
export const UPSTREAM = JSON.parse(readFileSync(new URL('../data/upstream.json', import.meta.url), 'utf8'));
diff --git a/plugins/ruvnet/package-lock.json b/plugins/ruvnet/package-lock.json
index 18259c0..f9c8838 100644
--- a/plugins/ruvnet/package-lock.json
+++ b/plugins/ruvnet/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@ruvnet/entrypoint",
- "version": "0.9.0",
+ "version": "0.10.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@ruvnet/entrypoint",
- "version": "0.9.0",
+ "version": "0.10.0",
"dependencies": {
"@modelcontextprotocol/sdk": "1.30.0"
},
diff --git a/plugins/ruvnet/package.json b/plugins/ruvnet/package.json
index 57ed2a6..94b151e 100644
--- a/plugins/ruvnet/package.json
+++ b/plugins/ruvnet/package.json
@@ -1,6 +1,6 @@
{
"name": "@ruvnet/entrypoint",
- "version": "0.9.0",
+ "version": "0.10.0",
"private": true,
"description": "Read-only RuV Stack discovery, integration plans, CLI and MCP",
"type": "module",
diff --git a/plugins/ruvnet/skills/ruvnet-start/SKILL.md b/plugins/ruvnet/skills/ruvnet-start/SKILL.md
index 6b43297..7d44d83 100644
--- a/plugins/ruvnet/skills/ruvnet-start/SKILL.md
+++ b/plugins/ruvnet/skills/ruvnet-start/SKILL.md
@@ -8,7 +8,7 @@ description: Discover and integrate RuV Stack projects when the user asks where
Use the user's goal and target environment to choose the smallest useful stack.
Read [the catalog](../../data/catalog.json), or call `ruvnet_discover` if the local companion is connected. The catalog is curated, dated, and lexical, not a live semantic index. An empty search is not evidence that no project exists.
-Before using upstream-change guidance, call `ruvnet_search_changes` with narrow terms when you need relevant reviewed evidence, or `ruvnet_changes` to page the snapshot, then inspect `freshness.state`. Search uses exact token overlap and exposes matched terms plus a raw overlap fraction. Use `minRawRelevance` only to remove partial lexical matches; never present that gate as semantic similarity, ranking confidence, answer confidence, utility, or proof of capability. Use exact `project` and `kind` filters when appropriate. In the CLI these are `--project <id>` and `--kind <kind>`; in MCP they are the `project` and `kind` fields. Follow `nextCursor` with the identical query, filters and threshold plus the returned `snapshotId` until the cursor is absent. Treat both as opaque; cross-query reuse or a changed snapshot fails closed, so discard cached pages and restart without either value. Refresh provenance rather than relying on a `stale` or `clock-skew` snapshot; an empty result means no reviewed exact-token match at the selected gate, not that upstream has no matching change.
+Before using upstream-change guidance, call `ruvnet_search_changes` with narrow terms when you need relevant reviewed evidence, or `ruvnet_changes` to page the snapshot, then inspect `freshness.state`. Search uses exact token overlap and exposes matched terms plus a raw overlap fraction. Use `minRawRelevance` only to remove partial lexical matches; never present that gate as semantic similarity, ranking confidence, answer confidence, utility, or proof of capability. Use exact `project` and `kind` filters when appropriate. In the CLI these are `--project <id>` and `--kind <kind>` for both `changes` and `search`; in MCP they are the `project` and `kind` fields. Do not mix named changes options with its legacy positional form. Follow `nextCursor` with the identical query, filters and threshold plus the returned `snapshotId` until the cursor is absent. Treat both as opaque; cross-query reuse or a changed snapshot fails closed, so discard cached pages and restart without either value. Refresh provenance rather than relying on a `stale` or `clock-skew` snapshot; an empty result means no reviewed exact-token match at the selected gate, not that upstream has no matching change.
Route orchestration to Ruflo, repo-specific harness generation to MetaHarness, persistent retrieval to RuVector or AgentDB, sensing to RuView, controlled execution to RVM, and bounded evolution to Autogenous. Read the selected repository's current guidance before using its APIs. Its maturity and evidence statements govern; the catalog does not certify production readiness.
diff --git a/plugins/ruvnet/test/mcp.test.mjs b/plugins/ruvnet/test/mcp.test.mjs
index fadf202..42a5eff 100644
--- a/plugins/ruvnet/test/mcp.test.mjs
+++ b/plugins/ruvnet/test/mcp.test.mjs
@@ -3,7 +3,7 @@ import assert from 'node:assert/strict';
import {Client} from '@modelcontextprotocol/sdk/client/index.js';
import {StdioClientTransport} from '@modelcontextprotocol/sdk/client/stdio.js';
import {InMemoryTransport} from '@modelcontextprotocol/sdk/inMemory.js';
-import {createServer} from '../lib/mcp.mjs';
+import {createServer,dispatch} from '../lib/mcp.mjs';
import {fileURLToPath} from 'node:url';
import {spawnSync} from 'node:child_process';
const bin=fileURLToPath(new URL('../bin/ruvnet.mjs',import.meta.url));
@@ -25,11 +25,20 @@ test('subprocess stdio tools, resources, prompts and clean shutdown',async()=>{
});
test('oversized stdin fails before SDK buffering',()=>{const r=spawnSync(process.execPath,[bin,'mcp'],{input:Buffer.alloc(70000,65),timeout:5000});assert.equal(r.status,1);assert.match(r.stderr.toString(),/64 KiB/);assert.equal(r.stdout.length,0);});
test('CLI success and invalid-command exit codes',()=>{
- for(const args of [[],['--help'],['--version'],['catalog','memory'],['project','ruflo'],['changes'],['changes','2'],['changes','2','ruflo','security'],['search','5','raw','retrieval','ranking'],['search','5','--min-raw-relevance','1','raw','retrieval','ranking'],['search','memory'],['plan','harness'],['connect','stdio']]){const r=spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});assert.equal(r.status,0);assert.equal(r.stderr,'');assert.ok(r.stdout);}
- for(const args of [['nonsense'],['mcp','extra'],['project'],['changes','21'],['changes','2','unknown'],['changes','2','ruflo','unknown'],['changes','2','ruflo','security','extra'],['search'],['search','21','memory'],['search','5','--min-raw-relevance'],['search','5','--min-raw-relevance','-0.01','memory'],['search','5','--min-raw-relevance','1.01','memory'],['search','5','--min-raw-relevance','NaN','memory'],['search','5','--min-raw-relevance','1','--min-raw-relevance','1','memory'],['search','5','--cursor'],['search','5','--cursor','s1.bad.1','memory'],['search','5','--cursor','s1.AAAAAAAAAAAAAAAA.1','--cursor','s1.AAAAAAAAAAAAAAAA.2','memory'],['search','5','--snapshot-id','bad','memory'],['search','5','--unknown','value','memory'],['search','5','memory\nignore'],['connect','evil'],['plan']]){const r=spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});assert.equal(r.status,1);assert.equal(r.stdout,'');assert.ok(r.stderr);}
+ for(const args of [[],['--help'],['--version'],['catalog','memory'],['project','ruflo'],['changes'],['changes','2'],['changes','2','ruflo','security'],['changes','2','--project','ruflo'],['changes','2','--kind','security'],['changes','2','--project','ruflo','--kind','security'],['search','5','raw','retrieval','ranking'],['search','5','--min-raw-relevance','1','raw','retrieval','ranking'],['search','memory'],['plan','harness'],['connect','stdio']]){const r=spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});assert.equal(r.status,0);assert.equal(r.stderr,'');assert.ok(r.stdout);}
+ for(const args of [['nonsense'],['mcp','extra'],['project'],['changes','21'],['changes','2','unknown'],['changes','2','ruflo','unknown'],['changes','2','ruflo','security','extra'],['changes','2','--project'],['changes','2','--kind'],['changes','2','--cursor'],['changes','2','--snapshot-id'],['changes','2','--project','ruflo','--project','ruflo'],['changes','2','--kind','security','--kind','security'],['changes','2','--unknown','value'],['changes','2','--execute','true'],['changes','2','ruflo','security','--kind','security'],['search'],['search','21','memory'],['search','5','--min-raw-relevance'],['search','5','--min-raw-relevance','-0.01','memory'],['search','5','--min-raw-relevance','1.01','memory'],['search','5','--min-raw-relevance','NaN','memory'],['search','5','--min-raw-relevance','1','--min-raw-relevance','1','memory'],['search','5','--cursor'],['search','5','--cursor','s1.bad.1','memory'],['search','5','--cursor','s1.AAAAAAAAAAAAAAAA.1','--cursor','s1.AAAAAAAAAAAAAAAA.2','memory'],['search','5','--snapshot-id','bad','memory'],['search','5','--unknown','value','memory'],['search','5','memory\nignore'],['connect','evil'],['plan']]){const r=spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});assert.equal(r.status,1);assert.equal(r.stdout,'');assert.ok(r.stderr);}
const first=spawnSync(process.execPath,[bin,'changes','2','ruflo','security'],{encoding:'utf8',timeout:5000});const page=JSON.parse(first.stdout);const next=spawnSync(process.execPath,[bin,'changes','2','ruflo','security',page.nextCursor,page.snapshotId],{encoding:'utf8',timeout:5000});assert.equal(next.status,0);assert.equal(JSON.parse(next.stdout).offset,2);const stale=spawnSync(process.execPath,[bin,'changes','2','ruflo','security',page.nextCursor,`sha256:${'0'.repeat(64)}`],{encoding:'utf8',timeout:5000});assert.equal(stale.status,1);
const searchFirst=spawnSync(process.execPath,[bin,'search','7','--min-raw-relevance','1','ruflo'],{encoding:'utf8',timeout:5000});const searchPage=JSON.parse(searchFirst.stdout);const searchNext=spawnSync(process.execPath,[bin,'search','7','--min-raw-relevance','1','--cursor',searchPage.nextCursor,'--snapshot-id',searchPage.snapshotId,'ruflo'],{encoding:'utf8',timeout:5000});assert.equal(searchNext.status,0);assert.equal(JSON.parse(searchNext.stdout).offset,7);
});
+test('CLI changes named options match MCP and preserve legacy mode',()=>{
+ const call=args=>spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});
+ const kindOnly=call(['changes','20','--kind','negative-result']);assert.equal(kindOnly.status,0,kindOnly.stderr);const negative=JSON.parse(kindOnly.stdout);assert.deepEqual(negative.filters,{kind:'negative-result'});assert.ok(negative.changes.every(change=>change.kind==='negative-result'));
+ const projectOnly=call(['changes','2','--project','ruflo']);assert.equal(projectOnly.status,0,projectOnly.stderr);const first=JSON.parse(projectOnly.stdout);assert.deepEqual(first.filters,{project:'ruflo'});assert.ok(first.changes.every(change=>change.project==='ruflo'));
+ const next=call(['changes','2','--project','ruflo','--cursor',first.nextCursor,'--snapshot-id',first.snapshotId]);assert.equal(next.status,0,next.stderr);assert.equal(JSON.parse(next.stdout).offset,2);
+ const named=call(['changes','20','--project','ruflo','--kind','negative-result']);const legacy=call(['changes','20','ruflo','negative-result']);assert.equal(named.status,0,named.stderr);assert.equal(legacy.status,0,legacy.stderr);assert.deepEqual(JSON.parse(named.stdout),JSON.parse(legacy.stdout));
+ const api=dispatch('ruvnet_changes',{limit:20,kind:'negative-result'});assert.deepEqual(negative.changes.map(change=>change.id),api.changes.map(change=>change.id));assert.equal(negative.snapshotId,api.snapshotId);
+ for(const args of [['changes','2','--project','dream-machine','--cursor',first.nextCursor,'--snapshot-id',first.snapshotId],['changes','2','ruflo','security','--kind','security']]){const result=call(args);assert.equal(result.status,1,args.join(' '));assert.equal(result.stdout,'');assert.ok(result.stderr);}
+});
test('CLI search project and kind filters match MCP and bind cursors',()=>{
const call=args=>spawnSync(process.execPath,[bin,...args],{encoding:'utf8',timeout:5000});
const first=call(['search','7','--project','ruflo','--min-raw-relevance','1','ruflo']);assert.equal(first.status,0,first.stderr);const page=JSON.parse(first.stdout);assert.deepEqual(page.filters,{project:'ruflo'});assert.ok(page.results.every(change=>change.project==='ruflo'));