ruvnet-brain 0.5.0-dev β 1.6.2-dev
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -6
- package/bin/install.mjs +15 -13
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -4,14 +4,22 @@
|
|
|
4
4
|
|
|
5
5
|
# π§ RuvNet Brain
|
|
6
6
|
|
|
7
|
+
### RuvNet Brain version 1.6.2-dev β updated 2026-07-05
|
|
8
|
+
|
|
7
9
|
**A portable, source-grounded brain over Reuven Cohen's (rUv's) RuvNet stack β delivered as a Claude Code plugin that makes Claude _use_ the stack instead of fighting it.**
|
|
8
10
|
|
|
9
|
-
[](plugin/.claude-plugin/plugin.json)
|
|
12
|
+
[](https://www.npmjs.com/package/ruvnet-brain)
|
|
13
|
+
[](https://github.com/stuinfla/ruvnet-brain/releases/latest)
|
|
11
14
|
[](https://ruvnet-brain.vercel.app)
|
|
12
15
|
[](LICENSE)
|
|
13
16
|
[](#testing--proof)
|
|
14
17
|
|
|
18
|
+
> **Three independent things version separately here β by design, not drift. Every number below is live (read straight from its real source, never hand-typed), so none of them can go stale:**
|
|
19
|
+
> - **`plugin`** (badge above) β the Claude Code plugin itself: SKILL.md, the grounding hooks, the MCP server. Read live from [`plugin/.claude-plugin/plugin.json`](plugin/.claude-plugin/plugin.json). Updates often β this is where behavior fixes land.
|
|
20
|
+
> - **`installer (npm)`** (badge above) β the `npx ruvnet-brain` setup script. Read live from the [npm registry](https://www.npmjs.com/package/ruvnet-brain). Only moves when the installer script itself changes β rare.
|
|
21
|
+
> - **Brain Release** (the downloadable 512MB knowledge bundle, linked from the "download" badge above) β always resolves to [`releases/latest`](https://github.com/stuinfla/ruvnet-brain/releases/latest), currently `v0.5.0-dev`. Only moves when the underlying knowledge base is rebuilt β separate again from the two above.
|
|
22
|
+
|
|
15
23
|
<sub>Built by **[Stuart Kerr](https://isovision.ai)** at [Isovision.ai](https://isovision.ai) Β· free & fair use, to help everyone leverage the high end of agentic coding.</sub>
|
|
16
24
|
|
|
17
25
|
### [βΆ Come see it visually explained](https://ruvnet-brain.vercel.app)
|
|
@@ -68,12 +76,12 @@ WITHOUT the brain β drift | WITH RuvNet Brain β grounded
|
|
|
68
76
|
## Install β one line
|
|
69
77
|
|
|
70
78
|
```bash
|
|
71
|
-
npx
|
|
79
|
+
npx ruvnet-brain
|
|
72
80
|
```
|
|
73
81
|
|
|
74
|
-
That single command runs the whole setup, narrating _what it's doing and why_ at each step: it downloads the brain (~512 MB) from the [
|
|
82
|
+
That single command runs the whole setup, narrating _what it's doing and why_ at each step: it downloads the brain (~512 MB) from the [latest GitHub Release](https://github.com/stuinfla/ruvnet-brain/releases/latest), unpacks it to `~/.cache/ruvnet-brain/kb`, installs its local reader (no cloud calls, no API keys), and wires the Claude Code plugin β the `search_ruvnet` MCP tool + the `UserPromptSubmit` grounding hook β at user scope. Works the same on **macOS, Linux, and Windows**. It's safe to re-run, and the brain itself always fetches the current Release regardless of which install path you use β you install once; you don't keep re-downloading.
|
|
75
83
|
|
|
76
|
-
>
|
|
84
|
+
> Want the bleeding-edge installer, even ahead of the last npm publish? `npx github:stuinfla/ruvnet-brain` always runs straight off the latest GitHub commit.
|
|
77
85
|
|
|
78
86
|
<details><summary>Manual install (what the one-liner automates)</summary>
|
|
79
87
|
|
|
@@ -206,7 +214,7 @@ This is **`v0.5.0-dev`** β we don't claim βdone,β βcomplete,β or βze
|
|
|
206
214
|
- β
**Code-level depth** β the code-rich repos are indexed to full function bodies; βhow is it implemented?β returns the implementation. Verified in the shipped bundle (clean-room 3/3).
|
|
207
215
|
- β
**Routing holds** β named 47/48, described 26/28, scenario 7/8; behavioral L1βL4 all pass; private stores fenced out of the public bundle (zero-leak verified).
|
|
208
216
|
- β οΈ **Two routing residuals** (above) β surfaced, not hidden.
|
|
209
|
-
-
|
|
217
|
+
- β
**Published on npm** β `npx ruvnet-brain` (short form); `npx github:stuinfla/ruvnet-brain` always tracks the latest commit if you want it even fresher.
|
|
210
218
|
- β³ **The fully-autonomous engineering loop** ([ADR-0008](docs/adr/)) β the behavioral hook _drives_ the assess β SPARC β ADR/DDD β QA β score loop; a generalized always-loops-to-β₯98 engine is the next phase.
|
|
211
219
|
|
|
212
220
|
---
|
package/bin/install.mjs
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
// bin/install.mjs β the one-command installer for RuvNet Brain.
|
|
3
3
|
//
|
|
4
|
-
// npx
|
|
5
|
-
// npx ruvnet-brain
|
|
4
|
+
// npx ruvnet-brain # published on npm β shortest, recommended
|
|
5
|
+
// npx github:stuinfla/ruvnet-brain # always the latest commit, even ahead of the npm release
|
|
6
6
|
// node bin/install.mjs --local # from a repo clone that already has dist/ruvnet-brain.zip
|
|
7
7
|
//
|
|
8
8
|
// Goal: a newcomer runs ONE command and ends up with (a) the brain on disk and (b) the Claude Code
|
|
@@ -510,7 +510,7 @@ function runDemo() {
|
|
|
510
510
|
const ask = path.join(cacheDir, 'forge-ask-all.mjs');
|
|
511
511
|
if (!fs.existsSync(ask)) {
|
|
512
512
|
warn(`no brain found at ${cacheDir}.`);
|
|
513
|
-
info(`Install it first: ${c.bold('npx
|
|
513
|
+
info(`Install it first: ${c.bold('npx ruvnet-brain')}`);
|
|
514
514
|
return;
|
|
515
515
|
}
|
|
516
516
|
console.log(c.dim(`\nThis asks your installed brain ${DEMO_QUESTIONS.length} real questions and shows you the`));
|
|
@@ -551,8 +551,8 @@ function runDemo() {
|
|
|
551
551
|
console.log(`${c.green('β'.repeat(64))}`);
|
|
552
552
|
console.log(`\n Now try it for real: open Claude Code in any project and ask it something about`);
|
|
553
553
|
console.log(` RuVector, Ruflo, AgentDB, or SPARC β it'll ground the same way, automatically.`);
|
|
554
|
-
console.log(` Run this demo again any time: ${c.bold('npx
|
|
555
|
-
console.log(` Full health check: ${c.bold('npx
|
|
554
|
+
console.log(` Run this demo again any time: ${c.bold('npx ruvnet-brain --demo')}`);
|
|
555
|
+
console.log(` Full health check: ${c.bold('npx ruvnet-brain --doctor')}\n`);
|
|
556
556
|
}
|
|
557
557
|
|
|
558
558
|
// ββ `--doctor`: a standalone health check the user can run any time βββββββββββββββββββββββββββββββ
|
|
@@ -563,7 +563,7 @@ function doctor() {
|
|
|
563
563
|
info(`brain dir: ${c.bold(cacheDir)}`);
|
|
564
564
|
const present = fs.existsSync(path.join(cacheDir, 'forge-mcp-all.mjs'));
|
|
565
565
|
if (!present) {
|
|
566
|
-
warn('brain not found here β run the installer first: npx
|
|
566
|
+
warn('brain not found here β run the installer first: npx ruvnet-brain');
|
|
567
567
|
return;
|
|
568
568
|
}
|
|
569
569
|
have('node') ? ok('node present') : warn('node missing');
|
|
@@ -744,7 +744,7 @@ This machine has the RuvNet Brain. When a task touches rUv's stack β RuVector/
|
|
|
744
744
|
AgentDB, SPARC, agentic-flow, agenticow, QuDAG, SAFLA, RuLake β GROUND answers in real source via the
|
|
745
745
|
\`search_ruvnet\` MCP tool BEFORE asserting what any tool can do; training priors on this stack are stale.
|
|
746
746
|
Prefer rUv-native primitives (RVF over Pinecone/pgvector, Ruflo over LangChain, AgentDB over ad-hoc memory).
|
|
747
|
-
Not sure it's active? Run \`npx
|
|
747
|
+
Not sure it's active? Run \`npx ruvnet-brain --doctor\`.
|
|
748
748
|
${CLAUDE_MD_END}`;
|
|
749
749
|
|
|
750
750
|
async function offerClaudeMd() {
|
|
@@ -802,7 +802,8 @@ function success({ cacheDir, isCustom, plugin, env }) {
|
|
|
802
802
|
console.log(` nothing to copy in, nothing to git-ignore. ${c.dim('(Runs locally β it is not active in the claude.ai web app.)')}`);
|
|
803
803
|
console.log(`\n ${c.bold('How it runs:')} ${c.bold('automatically')} β you never call or configure anything. Ask normally; on rUv-stack work it`);
|
|
804
804
|
console.log(` grounds in real source and cites it, and if you drift to a classical default it steps in with the rUv option.`);
|
|
805
|
-
console.log(`\n ${c.bold('Keep it fresh:')} re-run ${c.bold('npx
|
|
805
|
+
console.log(`\n ${c.bold('Keep it fresh:')} re-run ${c.bold('npx ruvnet-brain')} any time β the brain itself always pulls the latest`);
|
|
806
|
+
console.log(` Release regardless (that part isn't cached). For the bleeding-edge installer too, use ${c.bold('npx github:stuinfla/ruvnet-brain')}.`);
|
|
806
807
|
|
|
807
808
|
// ββ one important expectation: the hook activates on the NEXT session ββ
|
|
808
809
|
console.log(`\n ${c.yellow(c.bold('One thing to know:'))} the grounding hook turns on at your ${c.bold('next')} Claude Code session.`);
|
|
@@ -824,8 +825,8 @@ function success({ cacheDir, isCustom, plugin, env }) {
|
|
|
824
825
|
console.log(`\n ${c.bold('What to expect (honestly):')}`);
|
|
825
826
|
console.log(` β’ On rUv-stack work (vectors, swarms, agent memory, SPARC) it grounds ${c.bold('every time')}.`);
|
|
826
827
|
console.log(` β’ On unrelated work, it stays quiet β Claude behaves normally. It only speaks up when it should.`);
|
|
827
|
-
console.log(` β’ Not sure it's on? Run ${c.bold('npx
|
|
828
|
-
β’ Want to see it answer, live, right now? ${c.bold('npx
|
|
828
|
+
console.log(` β’ Not sure it's on? Run ${c.bold('npx ruvnet-brain --doctor')} any time for a health check.
|
|
829
|
+
β’ Want to see it answer, live, right now? ${c.bold('npx ruvnet-brain --demo')} β 2 real questions, real cited answers.`);
|
|
829
830
|
|
|
830
831
|
console.log(`\n ${c.bold('Set it up your way:')} this default is ${c.bold('global')} β live in every VS Code project automatically,`);
|
|
831
832
|
console.log(` which is what most people want. Want it different (project-only, moved, with the build stack added,`);
|
|
@@ -844,9 +845,10 @@ By default this installs the LATEST published Release (it asks GitHub which one
|
|
|
844
845
|
and falls back to a known-good version if GitHub can't be reached.
|
|
845
846
|
|
|
846
847
|
Usage:
|
|
847
|
-
npx
|
|
848
|
-
npx github:stuinfla/ruvnet-brain
|
|
849
|
-
npx
|
|
848
|
+
npx ruvnet-brain Install the brain + Claude Code plugin (recommended, npm)
|
|
849
|
+
npx github:stuinfla/ruvnet-brain Same, but from the bleeding-edge GitHub commit
|
|
850
|
+
npx ruvnet-brain --doctor Health-check an existing install (green/red per part)
|
|
851
|
+
npx ruvnet-brain --demo Guided walkthrough β 2 real questions, real cited answers
|
|
850
852
|
node bin/install.mjs --version <tag> Install a specific Release tag (e.g. --version v0.4.0-dev)
|
|
851
853
|
node bin/install.mjs --pin Skip the latest-check; use the bundled known-good version
|
|
852
854
|
node bin/install.mjs --local Install from a repo clone's dist/ruvnet-brain.zip
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ruvnet-brain",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "One-command installer for RuvNet Brain
|
|
3
|
+
"version": "1.6.2-dev",
|
|
4
|
+
"description": "One-command installer for RuvNet Brain \u2014 a portable, source-grounded brain over rUv's RuvNet building blocks, delivered as a Claude Code plugin so Claude uses the stack instead of fighting it.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"ruvnet-brain": "bin/install.mjs"
|