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
@@ -2,7 +2,7 @@
| Field | Value |
|-------|-------|
| **Status** | Accepted — **implemented** (O1O9 in `@ruvnet/ruview@0.2.0`; security/community extension in `0.3.0`, ADR-283): fail-closed schemas and MCP policy, async dispatch, zero runtime dependencies, bounded/redacted local Claude/Codex adapters, reviewed shared brain, and replay-verified Darwin/Flywheel gate. 53/53 tests (MEASURED, `node --test test/*.test.mjs`, 2026-07-28); CI gate in `ruview-harness-flywheel.yml` |
| **Status** | Accepted — **implemented** (O1O9 in `@ruvnet/ruview@0.2.0`; security/community extension in `0.3.0`, ADR-283; source-cited guidance in `0.3.1`): fail-closed schemas and MCP policy, async dispatch, zero runtime dependencies, bounded/redacted local Claude/Codex adapters, reviewed shared brain, source-checked capability guidance, and replay-verified Darwin/Flywheel gate. CI gate: `ruview-harness-flywheel.yml` |
| **Date** | 2026-07-02 |
| **Deciders** | ruv |
| **Codename** | **RUVIEW-NPM-REVIEW-1** |
@@ -12,6 +12,12 @@ Extend `harness/ruview` as the single contributor automation boundary for
repository exploration, development, debugging, testing and release
preparation. The published package remains runtime-dependency-free.
Repository exploration starts with a read-only guidance tool. Its reviewed
catalog records capability maturity, fixed source paths, focused validation
commands, and explicit limitations. In a checkout those citations are checked
for existence; outside a checkout they are labelled as a packaged snapshot.
Optional shared-brain matches remain cited evidence rather than instructions.
Two local hosts are supported with executable contracts:
- Claude Code uses non-interactive `claude -p --safe-mode`, JSON output, no