feat: add source-cited RuView guidance MCP tool (#1469)

Add a read-only guidance CLI/MCP surface with reviewed capability maturity, repository citations, validation commands, limitations, and shared-brain evidence. Bump @ruvnet/ruview to 0.3.1 and add release-tarball smoke coverage.
This commit is contained in:
rUv
2026-07-29 01:32:45 -04:00
committed by GitHub
parent 1ae8583441
commit a34bfc246e
24 changed files with 671 additions and 40 deletions
+13 -6
View File
@@ -45,18 +45,25 @@ from the current tree when needed.
## RuView contributor harness
`@ruvnet/ruview@0.3.0` is the runtime-dependency-free contributor interface
`@ruvnet/ruview@0.3.1` is the runtime-dependency-free contributor interface
defined by ADR-283.
```bash
npx @ruvnet/ruview@0.3.0 doctor
npx @ruvnet/ruview@0.3.0 agent run \
npx @ruvnet/ruview@0.3.1 doctor
npx @ruvnet/ruview@0.3.1 guidance --topic homecore --query "restore and plugins"
npx @ruvnet/ruview@0.3.1 agent run \
--host codex --repo . --prompt "Find the nearest tests and cite files"
npx @ruvnet/ruview@0.3.0 brain search --query "community memory"
npx @ruvnet/ruview@0.3.0 brain verify --repo .
npx @ruvnet/ruview@0.3.0 mcp start
npx @ruvnet/ruview@0.3.1 brain search --query "community memory"
npx @ruvnet/ruview@0.3.1 brain verify --repo .
npx @ruvnet/ruview@0.3.1 mcp start
```
Start unfamiliar repository work with `ruview_guidance`. It returns reviewed
capability maturity, source paths, focused validation commands, and known
limitations; it checks citations in a local clone and may attach bounded
matches from the reviewed brain. Guidance and retrieved text are evidence, not
authority.
The Codex adapter invokes `codex exec -` with the trusted checkout as `-C`,
read-only sandboxing, ephemeral JSONL output, strict config parsing, and user
config/exec rules ignored. Prompts use stdin; the child environment and output