Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

chore(ruflo-ruos): marketplace entry (handed over by integration owner); ADR mod contract

ruvb928e71ef169
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index f046371478..bdb3540a99 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -215,6 +215,11 @@
"name": "ruflo-music",
"source": "./plugins/ruflo-music",
"description": "AI music generation via Cognitum Music (cogmusic MCP) \u2014 compose lyrics/prompts, generate tracks, separate stems, extract MIDI, and master through your own music.cognitum.one account"
+ },
+ {
+ "name": "ruflo-ruos",
+ "source": "./plugins/ruflo-ruos",
+ "description": "Run ruflo swarm agents on your own ruOS cloud desktops via the tenant-authenticated fleet MCP or per-tenant SSH; optional, removable"
}
]
}
diff --git a/v3/docs/adr/ADR-405-ruos-desktops-as-swarm-hosts.md b/v3/docs/adr/ADR-405-ruos-desktops-as-swarm-hosts.md
index c677bc9837..01df3984c0 100644
--- a/v3/docs/adr/ADR-405-ruos-desktops-as-swarm-hosts.md
+++ b/v3/docs/adr/ADR-405-ruos-desktops-as-swarm-hosts.md
@@ -130,7 +130,13 @@ If the CLI cannot be resolved, or policy denies a call, the ledger degrades to t
- ruflo works identically when the plugin is absent. The PR changes no file under `v3/`, apart from this ADR.
- The plugin has no npm dependencies.
- The ruflo CLI is resolved at runtime and is optional.
-- The `$.ruos` and `$.ruflo` Claude Code mod nouns are feature-detected and never required. `$.ruos.desktops()` makes no network calls and may be stale, so freshness always comes from `desktop_status`.
+- The `$.ruos` and `$.ruflo` Claude Code mod nouns are never required. `$.ruos.desktops()` makes no network calls and may be stale, so freshness always comes from `desktop_status`.
+- **Mod part (deferred until mods-planner lands `segment`).** The planned contract follows `claude plugin validate`, which allows only flat `$.noun.method(input)` calls and rejects feature detection:
+ - status segment: `$.ruflo.segment({ id: 'ruos', text })`, with `text: null` to clear;
+ - read-only `$.ruos` calls: `desktops()`, `lite()`, `lastAudit({n})`, `viewOpen({machine})`, `viewClose()`, `viewIsOpen()`, from `@cognitum/[email protected]`;
+ - every call wrapped in try/catch with a fallback;
+ - types vendored from ruos-desktop `packages/ruos/mod/ruos/types/index.d.ts`, with a parity test.
+ `/ruflo-ruos:view` delegates to `/ruos view`.
## Failure modes