Skip to content

Instantly share code, notes, and snippets.

View ruvnet's full-sized avatar
πŸ’­
hacking the multiverse.

rUv ruvnet

πŸ’­
hacking the multiverse.
View GitHub Profile
@ruvnet
ruvnet / watermark-explainer.md
Last active August 16, 2026 01:41
The Invisible Signature β€” how AI text watermarking works (plain-language guide to @claude-flow/watermark)

The Invisible Signature β€” how AI text watermarking works

A plain-language guide to the method behind ai-text-watermark / @claude-flow/watermark. Live playground & animated explainer: https://ruvnet.github.io/ai-text-watermark/ Β· Source: https://github.com/ruvnet/ai-text-watermark


The problem

As of August 2026 the EU AI Act asks AI providers to mark AI-generated text so it can be recognised later. But a paragraph is just words β€” there's nowhere to stamp a logo without wrecking the sentence. The mark has to hide inside the choices the model was already making: invisible to a reader, unmistakable to anyone with a secret key.

@ruvnet
ruvnet / ADR-323-RuView-Physics-Pose-Refinement.md
Created August 15, 2026 21:12
RuView ADR-323: native Rust physics-constrained pose refinement, architecture, safeguards, validation, and rollout gates

RuView ADR-323: Physics-constrained pose refinement in native Rust

RuView now has an audit-first physics boundary between RF pose inference and semantic publication. The implementation was merged in RuView PR #1617 as merge commit 1d50518a7.

The short version is:

Physics may identify inconsistency, reduce confidence, abstain, or propose a tightly bounded correction. It may never turn a weak RF observation into stronger evidence merely because the result looks physically plausible.

The full decision is ADR-323: Native Rust physics-constrained pose refinement.

@ruvnet
ruvnet / dm-gist.md
Created August 13, 2026 21:56
Dream Machine v0.1.0 β€” nightly, evidence-gated repository evolution (npx dream-machine)
@ruvnet
ruvnet / meta-proxy-tutorial.md
Created August 13, 2026 18:09
Meta Proxy (ruflo proxy) β€” technical tutorial: architecture, install/verify pipeline, data planes, full CLI reference

Meta Proxy β€” a technical tour of ruflo proxy

ruflo ships a local, OpenAI-compatible LLM proxy called Meta Proxy (binary name meta-proxy). This is a walkthrough of what it actually does, how it's built, and how to run it β€” grounded directly in the shipped CLI source (v3/@claude-flow/cli/src/commands/proxy.ts, proxy-lifecycle.ts, src/proxy/*.ts) and its governing ADRs (ADR-304, ADR-307, ADR-313/314/315) in ruvnet/ruflo.

@ruvnet
ruvnet / dream-machine-tutorial.md
Last active August 13, 2026 17:18
The Dream Machine β€” a tutorial on Ruflo's nightly Dream Cycle v3 evolution loop

The Dream Machine β€” a tutorial on Ruflo's nightly evolution loop

This is the technical walkthrough. For the visual version, see the scrollytelling artifact.

What it actually is

Not a workflow file in the repo. A /schedule cloud routine (trig_01HpEqAcEP7wzrxy3TzakrQ2, "Ruflo Nightly Dream Cycle", cron 0 6 * * * UTC) β€” a fully isolated cloud session with its own fresh git

@ruvnet
ruvnet / ruvector-pr-sweep-2026-08-13.md
Created August 13, 2026 15:13
RuVector PR sweep 2026-08-13: CI shard-split root cause found & fixed, two research PRs merged with corrected claims, external PR closed with credit

RuVector PR Sweep β€” 2026-08-13

A multi-agent Claude review swept the four most recent open PRs in ruvnet/ruvector, then integrated the findings, published them as PR comments, and merged/closed each PR per verdict. Three PRs merged, one closed with credit, two follow-up issues filed β€” and one long-standing CI mystery solved at the root.

Headline: the CI shard split was never sharding

PR #822 β€” ci: split platform crates from workspace catch-all β†’ MERGED (6c7cb709d)

The review found the root cause behind every failed shard-split iteration (iters 228–240): the catch-all shard's --exclude list lived inside a YAML folded scalar (>-) with #-prefixed lines mixed in. Those # lines are content, not YAML comments β€” folding joins everything onto one line, and the shell truncates the expanded command at the first #. Net effect: 0 of 162 exclude flags ever reached cargo, and core-and-rest has been runn

@ruvnet
ruvnet / v2235-plain-language-release-notes.md
Created August 12, 2026 02:10
RuView v2235 β€” plain-language release notes: issue-fix batch + certificate-spine wiring

What's in this release

This release is a batch of bug fixes from a review of the 10 most recent user-reported issues, plus a follow-up that finishes wiring together the "trust layer" preview from the last major release β€” closing the gap where the pieces existed and were tested, but weren't actually connected to each other yet.

Bugs fixed

  • The UI could falsely claim a real ESP32 sensor was connected when it wasn't.
@ruvnet
ruvnet / adr-382-writeup.md
Created August 12, 2026 02:09
ADR-382 β€” Init scaffold content drift remediation (ruflo v3.38.0)
@ruvnet
ruvnet / pr1579-release-notes-plain.md
Last active August 11, 2026 17:10
WiFi Sensing Trust Layer β€” plain-language preview release notes (RuView PR #1579)

WiFi Sensing "Trust Layer" β€” Preview Release Notes

Covers the work in RuView PR #1579, not yet merged.

What this is

Today, when RuView's WiFi sensing gives you an answer ("someone is in the room"), you have to just trust it. This release starts building the plumbing for the system to instead say either: "here's my answer, and here's proof it's trustworthy right now" β€” or, when it's not sure β€” "I don't know" β€” instead of quietly guessing.

@ruvnet
ruvnet / ruflo-3.35.0-explained.md
Last active August 10, 2026 21:32
ruflo v3.35.0 explained β€” MetaHarness dependency fix, ADR-381 sequential-evidence governance, and 3 concurrency bugs found+fixed in review

ruflo v3.35.0, explained in plain language

This release folds in two PRs: #2956 (the main MetaHarness work) and #2957 (version bump + a small test fix). This write-up walks through what changed, why it mattered, and β€” the part worth reading closely β€” three real bugs a pre-merge code review found and got fixed before they shipped.


Part 1: The dependency bug β€” "zero packages on a clean install"

MetaHarness is a separate, optional toolkit (@metaharness/darwin, @metaharness/flywheel, @metaharness/radio) that ruflo can use for extra capabilities β€” things like scoring how "ready" a codebase is for AI agents, or self-optimizing its own retrieval settings over time. Critically, ruflo is designed to work completely fine without any of it installed β€” MetaHarness is an augmentation, never a requirement.