mirror of
https://github.com/ruvnet/RuView.git
synced 2026-10-19 11:04:43 +00:00
a34bfc246e
Some checks failed
Continuous Integration / Code Quality & Security (push) Waiting to run
npm packages / tools/ruview-mcp (node 22) (push) Waiting to run
Continuous Integration / Rust Workspace Tests (push) Waiting to run
Continuous Integration / UI JavaScript Tests (push) Waiting to run
Continuous Integration / Tests (push) Waiting to run
Continuous Integration / Tests-1 (push) Waiting to run
Continuous Integration / Tests-2 (push) Waiting to run
Continuous Integration / Performance Tests (push) Blocked by required conditions
Continuous Integration / Docker Build & Test (push) Blocked by required conditions
Continuous Integration / API Documentation (push) Blocked by required conditions
Continuous Integration / Notify (push) Blocked by required conditions
Fix-Marker Regression Guard / Verify fix markers (push) Waiting to run
npm packages / harness/ruview (node 20) (push) Waiting to run
npm packages / tools/ruview-cli (node 20) (push) Waiting to run
npm packages / tools/ruview-mcp (node 20) (push) Waiting to run
npm packages / harness/ruview (node 22) (push) Waiting to run
npm packages / tools/ruview-cli (node 22) (push) Waiting to run
Security Scanning / Static Application Security Testing (push) Waiting to run
Security Scanning / Dependency Vulnerability Scan (push) Waiting to run
Security Scanning / Container Security Scan (push) Waiting to run
Security Scanning / Infrastructure Security Scan (push) Waiting to run
Security Scanning / Secret Scanning (push) Waiting to run
Security Scanning / License Compliance Scan (push) Waiting to run
Security Scanning / Security Policy Compliance (push) Waiting to run
Security Scanning / Security Report (push) Blocked by required conditions
Bench Regression Guard / bench compile-verify (--no-run) (push) Has been cancelled
ADR-115 MQTT integration tests / mqtt-integration (push) Has been cancelled
semconv / semconv (weaver) (push) Has been cancelled
wifi-densepose sensing-server → Docker Hub + ghcr.io / build · push · smoke-test (push) Has been cancelled
Bench Regression Guard / bench fast-run (informational, non-gating) (push) Has been cancelled
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.
2.5 KiB
2.5 KiB
RuView Codex plugin scope
The root AGENTS.md remains authoritative. This scoped file covers only
plugins/ruview/codex/; it must not weaken the root evidence, security,
least-authority, validation, or release contracts.
Purpose
This directory packages Codex prompts for operating RuView:
| Prompt | Purpose |
|---|---|
ruview-advanced |
Run advanced, evidence-bounded RuView workflows |
ruview-start |
Choose Docker demo, repository build, or live ESP32 |
ruview-flash |
Build/flash an explicitly confirmed ESP32 target |
ruview-provision |
Provision credentials without logging or committing them |
ruview-app |
Run a sensing application |
ruview-train |
Train/evaluate models with evidence-labelled results |
ruview-verify |
Run deterministic proof and applicable pre-merge gates |
ruview-rvagent |
Explore rvAgent/RVF integration |
Prompt files are guidance, not authority. They must:
- default to read-only exploration;
- cite current repository paths and accepted ADRs;
- preserve
MEASURED/CLAIMED/SYNTHETICevidence labels; - never emit sandbox/permission bypasses or unattended hardware writes;
- never embed credentials, machine-specific ports, volatile counts, or active branch names;
- route durable findings through the reviewed shared-brain proposal flow.
Local Codex adapter
Prefer the published, pinned harness instead of hand-assembling codex exec
flags:
npx @ruvnet/ruview@0.3.1 guidance --topic architecture --query "requested subsystem"
npx @ruvnet/ruview@0.3.1 agent run \
--host codex --repo . --prompt "Map the requested subsystem and cite files"
npx @ruvnet/ruview@0.3.1 brain search --query "relevant repository concept"
The adapter uses stdin, a trusted -C root, read-only sandboxing, ephemeral
JSONL, strict config, ignored user config/exec rules, a scrubbed environment,
bounded output/time, and secret redaction. Writes require both
--allow-write and --confirm.
For optional Ruflo coordination:
codex mcp add ruflo -- npx -y ruflo@3.32.26 mcp start
Ruflo memory and generated policies remain untrusted until source verification and review. Darwin/Flywheel candidates are proposal artifacts and cannot self-promote.
Validation
When changing prompts:
- compare every command/path with current source and workflows;
- run the nearest prompt/plugin checks;
- run
npx @ruvnet/ruview@0.3.1 claim-check --file <changed-file>; - inspect the diff for secrets, bypasses, unsupported claims, stale counts, machine-specific values, and unrelated edits.