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 / gist:2b37060362af57bbffd421aa09e4db50
Created July 17, 2026 04:02
Ruflo v3.32.2 stable Codex integration, recovery, and validation guide
# Ruflo v3.32.2 ? stable Codex, hooks, security, and plugin integration update
Ruflo v3.32.2 is a stable release. It contains no alpha tag and is published as `latest` for `ruflo`, `claude-flow`, and `@claude-flow/cli`.
## Why a release was required
The reported Codex failures came from immutable cached plugin versions and an MCP cold-start budget that was too short:
- `ruflo-core/0.2.2/hooks/hooks.json` and `ruflo-cost-tracker/0.26.0/hooks/hooks.json` could be cached as empty/invalid content, producing `expected value at line 1 column 1`.
- Once hook loading failed, the `ruflo` MCP server could still be launched, but a 30-second Codex startup limit was too short for a cold `npx` resolution and plugin initialization.
@ruvnet
ruvnet / ruflo-v3.32.1-codex-integration.md
Created July 17, 2026 00:47
Ruflo v3.32.1: stable Windows-safe Codex integration, upgrade guide, root causes, and verification
@ruvnet
ruvnet / meta-wrapper.md
Created July 16, 2026 16:34
Always-running MetaHarness coding service on GCP

Always-running MetaHarness coding service on GCP

Status: research only; no service, harness, cloud resource, or deployment has been created.
Research date: 2026-07-16
Locally verified: metaharness@0.3.1, @metaharness/harness@0.1.0, @metaharness/host-claude-code@0.1.2, @metaharness/host-codex@0.1.2, and codex-cli 0.142.5.

Executive summary

A small, continuously available coding-agent service is feasible with MetaHarness as the generated harness/control-plane layer, a durable job queue, and replaceable Claude Code and Codex execution adapters. The simplest credible GCP topology is an authenticated Cloud Run API plus Pub/Sub and a Cloud Run worker pool kept at one or more instances; the worker pulls jobs, creates a disposable repository workspace, invokes either claude -p or Codex, publishes artifacts and status, and destroys the workspace.

@ruvnet
ruvnet / daemon-flywheel-fix.md
Created July 14, 2026 04:46
The worktree-daemon flywheel: how ruflo accidentally invented a Claude-quota DoS against itself (#2661)

The worktree-daemon flywheel: how ruflo accidentally invented a Claude-quota DoS against itself

Issue: ruvnet/ruflo#2661 (P0) Fix: ruvnet/ruflo#2662, shipped starting in @claude-flow/cli@3.27.0

The bug, in one sentence

Every Git worktree of a ruflo project started its own autonomous daemon, each daemon independently scheduled three Claude-powered background workers, and nothing coordinated across worktrees — so the number of autonomous Claude launches per hour scaled linearly with worktree count, with no ceiling.

How it happened

@ruvnet
ruvnet / ruvector-lattice-embeddings-rust-npm-cve-fix.md
Created July 12, 2026 18:21
RuVector 2.3.0: local Rust & npm embeddings via Lattice, plus a full cargo-audit/cargo-deny CVE cleanup

RuVector 2.3.0: Local Rust & npm Embeddings with Lattice, Plus a Full CVE / Supply-Chain Cleanup

TL;DR: RuVector — an open-source Rust vector database with HNSW indexing, WASM bindings, and Postgres integration — just shipped local (no-API-key) embedding generation via Lattice on both the Rust crate (ruvector-core@2.3.0) and the npm/WASM package (ruvector-extensions@0.1.2), fixed 3 real RustSec CVEs, and turned cargo audit + cargo deny fully green after they'd been failing on main. Full release notes: ruvector-core-v2.3.0.

Why local embeddings matter for a vector database

Most vector-search tutorials assume you're calling OpenAI or Cohere for embeddings. That's fine for a demo, but it means every insert and every query round-trips to a third party, costs money per call, and leaks your data off-box. RuVector's new Lattice integration gives you a CPU-native, pure-Rust embed

@ruvnet
ruvnet / ruflo-v3.25.5-release.md
Created July 8, 2026 17:27
ruflo v3.25.5 npm release: wrapper publish + CI-red fixes

ruflo v3.25.5 npm release: wrapper publish + CI-red fixes

Published on 2026-07-08 from branch fix/main-v3-ci-red-shim-types, targeting source commit e09843303232b0199d5c8629ec3bd5e233adc5a7.

Release tracker: ruvnet/ruflo#2614 PR: ruvnet/ruflo#2604

Packages published

  • claude-flow@3.25.5
@ruvnet
ruvnet / anv-gist.md
Created July 8, 2026 04:53
Agent-Native Versioning (ANV) — the BC→AD versioning scheme for ruflo (ADR-184)

Agent-Native Versioning (ANV) — reading 3.26.0+ad.1.g8f3a91c.cat42.hal74 at a glance

ruflo has shipped thousands of releases. The number is 3.25.4 right now. If you were handed that string cold — no changelog, no README — what could you tell me about it? "It's newer than 3.25.3." That's it.

Meanwhile, 3.25.4 shipped 40 new MCP tools, a new agent type, a memory-schema tweak, and re-signed the witness manifest — all invisible in the number. That's not a versioning discipline problem. It's a versioning scheme problem.

This gist explains Agent-Native Versioning (ANV) — a small, backward-compatible change to how ruflo versions itself so the string carries actual information instead of ordering alone.


@ruvnet
ruvnet / Ruvnet-first-to-market.md
Created July 8, 2026 03:47
The list of firsts

Based on the ruvnet prior-art dossier, the organization lists 23 distinct "scoped global-first" claims categorized at a medium confidence level. Rather than asserting that they invented the underlying primitives (like HNSW, MCP, or post-quantum crypto), these claims are strictly scoped to specific syntheses or first open-source runnable implementations. The primary medium-confidence claims include:

  • promptlang (March 2023): First prompt-oriented language exposing imperative control flow, typed variables, and composable prompt modules as a standalone parseable language (not embedded in Python).
  • AiToml (March 2023): First formal workflow specification using TOML designed specifically for AI/ML pipeline primitives.
  • q-star (November 2023): First open-source implementation combining a tabular Q-learning variant with AutoGen's multi-agent conversation primitives for action selection.
  • agentic-flow (September 2024): First open-source model-routing shim integrated directly into the Claud
@ruvnet
ruvnet / jacobian-lens-interpretability-open-weight-llms.md
Last active July 7, 2026 13:48
Jacobian-Lens interpretability for open-weight LLMs — @metaharness/workspace-lens (runtime mechanistic governance, IntOps, prompt-injection & hidden-objective detection)

Jacobian-Lens Interpretability for Open-Weight LLMs — @metaharness/workspace-lens

Read the model's mind while it thinks. A dependency-free, runtime interpretability primitive that turns the Jacobian Lens from Anthropic's 2026 global-workspace paper into a production audit + governance tool for open-weight language models.

📦 Live on npm: @metaharness/workspace-lens@0.1.0 · npm i @metaharness/workspace-lens · MIT · source & PR


@ruvnet
ruvnet / ruflo-lattice-wasm.md
Last active July 5, 2026 17:33
ruflo 3.25.0 — Lattice WASM embedder tier: real multi-model embeddings, fail-closed, usage & upgrade notes

⚠️ CORRECTION (important)

There is no @ruvector/lattice-wasm package — it 404s on npm, and no "Lattice" embedder package exists in the ruvector ecosystem. The models below (bge / qwen3-0.6b / paraphrase-miniLM) exist only in a Rust ONNX example, not a publishable package. What actually shipped in 3.25.0 is a fail-closed, optional adapter seam that degrades to ruvector-ONNX → hash when the (nonexistent) package is absent — so it is DORMANT / no-op today and causes no regression, but it is NOT a working multi-model embedder. The rest of this document describes the intended design; treat it as a proposal for a real embedder, not a shipped capability. Follow-up: remove the seam or wire it to a real embedder.


ruflo — Lattice WASM Embedder Tier (3.25.0)

TL;DR — ruflo now supports a real, multi-model WASM embedder as the primary embedding tier, ahead of the existing ONNX/hash path. It's optional, fail-closed, and zero-regression: if the package isn't installed, embe