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

Revert "docs: add Cognitum Media showcase and link it from the README"

ruvnet7d76560a106d
diff --git a/README.md b/README.md
index 03b7ba1291..92c8620461 100644
--- a/README.md
+++ b/README.md
@@ -21,12 +21,6 @@
**An agent meta-harness for Claude Code and Codex.**
-<!-- Showcase: governed agent authority applied outside a codebase -->
-[![Watch: Cognitum Media β€” a broadcast master produced end to end by AI, which the models were never allowed to publish](docs/assets/media/cognitum-media-v2-poster.png)](docs/showcase/cognitum-media.md)
-
-**[β–Ά Cognitum Media β€” governed authority outside of code](docs/showcase/cognitum-media.md)**
-A two-minute broadcast master, produced end to end by AI, that the creative models were never allowed to publish. The same separation that stops an agent from self-merging a PR.
-
</div>
> **Agent = Model + Harness.** The model writes; the harness gives it tools, memory, loops, sandboxes, and controls so it can actually work. **Ruflo is the harness** β€” the execution layer around Claude Code and Codex that adds 100+ specialized agents, coordinated swarms, self-learning memory, federated comms across machines, and enterprise security guardrails. So agents don't just run, they collaborate.
diff --git a/docs/assets/media/cognitum-media-v2-contact.png b/docs/assets/media/cognitum-media-v2-contact.png
deleted file mode 100644
index 4270e8fce0..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-contact.png and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-poster.png b/docs/assets/media/cognitum-media-v2-poster.png
deleted file mode 100644
index 3d4fcd306c..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-poster.png and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-01.jpg b/docs/assets/media/cognitum-media-v2-scene-01.jpg
deleted file mode 100644
index cbe1bd6687..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-01.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-02.jpg b/docs/assets/media/cognitum-media-v2-scene-02.jpg
deleted file mode 100644
index ac929daa28..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-02.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-03.jpg b/docs/assets/media/cognitum-media-v2-scene-03.jpg
deleted file mode 100644
index e0e0502423..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-03.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-04.jpg b/docs/assets/media/cognitum-media-v2-scene-04.jpg
deleted file mode 100644
index 9ef48a2ba4..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-04.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-05.jpg b/docs/assets/media/cognitum-media-v2-scene-05.jpg
deleted file mode 100644
index 5f5833e112..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-05.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-06.jpg b/docs/assets/media/cognitum-media-v2-scene-06.jpg
deleted file mode 100644
index b47e95e8fe..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-06.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-07.jpg b/docs/assets/media/cognitum-media-v2-scene-07.jpg
deleted file mode 100644
index be976d1de2..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-07.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-08.jpg b/docs/assets/media/cognitum-media-v2-scene-08.jpg
deleted file mode 100644
index 9653e8bda4..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-08.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-09.jpg b/docs/assets/media/cognitum-media-v2-scene-09.jpg
deleted file mode 100644
index f903c54e5e..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-09.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-10.jpg b/docs/assets/media/cognitum-media-v2-scene-10.jpg
deleted file mode 100644
index cd91696e47..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-10.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-11.jpg b/docs/assets/media/cognitum-media-v2-scene-11.jpg
deleted file mode 100644
index 54c4759b8c..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-11.jpg and /dev/null differ
diff --git a/docs/assets/media/cognitum-media-v2-scene-12.jpg b/docs/assets/media/cognitum-media-v2-scene-12.jpg
deleted file mode 100644
index cb69c0f0f5..0000000000
Binary files a/docs/assets/media/cognitum-media-v2-scene-12.jpg and /dev/null differ
diff --git a/docs/showcase/cognitum-media.md b/docs/showcase/cognitum-media.md
deleted file mode 100644
index 54583ff84c..0000000000
--- a/docs/showcase/cognitum-media.md
+++ /dev/null
@@ -1,319 +0,0 @@
-# Cognitum Media β€” governed authority outside of code
-
-A two-minute broadcast master, produced end to end by AI, in which the creative
-models were never allowed to publish it.
-
-This page is in Ruflo's docs for one reason: it is the clearest existing
-demonstration of the pattern Ruflo is built around β€” **generation authority and
-promotion authority are different things** β€” applied somewhere other than a
-codebase. The same separation that stops an agent from self-merging a pull
-request is what stops a generative model from putting itself on air.
-
-[![Cognitum Media V2 β€” one governed system from brief to broadcast](../assets/media/cognitum-media-v2-poster.png)](#watch-the-master)
-
----
-
-## At a glance
-
-| | |
-|---|---|
-| Title | *Cognitum Media in Motion* |
-| Runtime | 125.67 s delivered (134 s nominal, before transition overlap) |
-| Video | H.264, 1920Γ—1080, 24 fps |
-| Audio | AAC, 48 kHz, stereo |
-| Master | 87,597,854 bytes |
-| Scenes | 12 β€” 7 presenter, 5 generated interludes |
-| Presenters | 4 variants from 1 consented likeness |
-| Styles | 7 (nightly news, movie trailer, product launch, realistic cinematic, graphic illustration, editorial cartoon, documentary) |
-| Provider steps | 33 |
-| Estimated cost | $12.94 against a $20 declared cap |
-| Final state | `awaiting_approval` β€” publication unauthorized |
-
-**Objective, as declared in the spec:** *"Create an action paced cinematic
-demonstration of the complete governed Cognitum Media system with an improved
-rUv avatar, precise lip synchronization, right side feature graphics, real
-examples, movie interludes, sound design, and approval ready evidence."*
-
----
-
-## The production, scene by scene
-
-Twelve scenes alternate a presenter against generated b-roll. Every scene
-carries a feature panel on the right with a kicker, a headline, and three
-concrete capabilities. Timings below are the **delivered** ones β€” the spec's
-nominal 134 s becomes 125.67 s because each transition overlaps its neighbours.
-
-### 1 Β· `cold_open` β€” One operating system
-*Presenter (rUv) Β· nightly news Β· 0:00 β†’ fadeblack 0.8s*
-
-![Scene 1 β€” One operating system](../assets/media/cognitum-media-v2-scene-01.jpg)
-
-> I am rUv. This is Cognitum Media, one governed system for turning an approved
-> idea into finished broadcast media.
-
-Brief to broadcast Β· Creative AI with controls Β· Every action has a receipt
-
-### 2 Β· `movie_mission` β€” See the whole production
-*B-roll Β· movie trailer Β· 0:12 β†’ smoothleft 0.85s*
-
-![Scene 2 β€” See the whole production](../assets/media/cognitum-media-v2-scene-02.jpg)
-
-> The metaharness sees the whole mission before generation begins: story,
-> styles, assets, timing, cost, and required controls.
-
-Costed dependency graph Β· Scene timing locked Β· Approval gates declared
-
-### 3 Β· `creator_console` β€” Start with what you have
-*Presenter (rUv) Β· nightly news Β· 0:22 β†’ dissolve 0.7s*
-
-![Scene 3 β€” Start with what you have](../assets/media/cognitum-media-v2-scene-03.jpg)
-
-> Submit a campaign, document, live feed, or room signal. Cognitum converts it
-> into a complete production plan.
-
-Briefs and documents Β· Campaigns and live feeds Β· Approved room signals
-
-### 4 Β· `examples` β€” Many formats. One core.
-*B-roll Β· product launch Β· 0:34 β†’ radial 0.75s*
-
-![Scene 4 β€” Many formats, one core](../assets/media/cognitum-media-v2-scene-04.jpg)
-
-> The same foundation creates news packages, music videos, presenter explainers,
-> commercials, social clips, and spatial experiences.
-
-News and live channels Β· Music and commercials Β· Social and spatial media
-
-### 5 Β· `female_anchor` β€” Change the presentation
-*Presenter (female variant) Β· realistic cinematic Β· 0:44 β†’ smoothright 0.7s*
-
-![Scene 5 β€” Change the presentation](../assets/media/cognitum-media-v2-scene-05.jpg)
-
-> One approved presenter can become a female anchor, male correspondent,
-> realistic character, or illustrated host without losing governance.
-
-Female and male variants Β· Realistic or illustrated Β· Consent remains attached
-
-### 6 Β· `production_engine` β€” Generate with control
-*B-roll Β· graphic illustration Β· 0:56 β†’ circleopen 0.8s*
-
-![Scene 6 β€” Generate with control](../assets/media/cognitum-media-v2-scene-06.jpg)
-
-> Fal generates controlled visual assets and motion. MiniMax creates voice and
-> music. Cognitum keeps the workflow coherent.
-
-Fal visual generation Β· MiniMax voice and music Β· Private Cognitum assets
-
-### 7 Β· `field_host` β€” Remix without rebuilding
-*Presenter (male variant) Β· realistic cinematic Β· 1:06 β†’ smoothup 0.7s*
-
-![Scene 7 β€” Remix without rebuilding](../assets/media/cognitum-media-v2-scene-07.jpg)
-
-> Change the host, visual language, transition, music treatment, or channel
-> format while the production remains reproducible.
-
-Host and visual style Β· Music and transitions Β· Landscape or vertical
-
-### 8 Β· `action_network` β€” Run the full channel
-*B-roll Β· movie trailer Β· 1:18 β†’ fadeblack 0.9s*
-
-![Scene 8 β€” Run the full channel](../assets/media/cognitum-media-v2-scene-08.jpg)
-
-> Approved software schedules the program, sends it to destinations, watches
-> stream health, recovers failures, and archives every result.
-
-Schedule and distribute Β· Monitor and recover Β· Clip and archive
-
-### 9 Β· `cartoon_mode` β€” Creative does not mean loose
-*Presenter (cartoon variant) Β· editorial cartoon Β· 1:28 β†’ dissolve 0.7s*
-
-![Scene 9 β€” Creative does not mean loose](../assets/media/cognitum-media-v2-scene-09.jpg)
-
-> The style can shift completely. Editorial animation still carries the same
-> consent, provenance, spending limit, and approval policy.
-
-Cartoon and graphic art Β· Cinematic realism Β· The same policy envelope
-
-> **Note:** this frame also shows the one rendering defect in the master β€” the
-> headline is clipped to *"Creative does not mean loos"*. See
-> [Known defect](#known-defect).
-
-### 10 Β· `edit_suite` β€” Picture and sound aligned
-*B-roll Β· documentary Β· 1:40 β†’ smoothdown 0.7s*
-
-![Scene 10 β€” Picture and sound aligned](../assets/media/cognitum-media-v2-scene-10.jpg)
-
-> The finishing system aligns every cut, holds lip sync, mixes effects, ducks
-> music, and validates the decoded master.
-
-Frame accurate timing Β· Dialogue first mix Β· Decoded master validation
-
-### 11 Β· `authority` β€” Authority stays separate
-*Presenter (rUv) Β· nightly news Β· 1:50 β†’ smoothleft 0.75s*
-
-![Scene 11 β€” Authority stays separate](../assets/media/cognitum-media-v2-scene-11.jpg)
-
-> Creative AI cannot publish, spend freely, choose advertising, alter emergency
-> text, or take control of a broadcast.
-
-Creative AI proposes Β· Approved software acts Β· People control exceptions
-
-### 12 Β· `finale` β€” Ready for approval
-*Presenter (rUv) Β· nightly news Β· 2:02 β†’ fade 0.8s*
-
-![Scene 12 β€” Ready for approval](../assets/media/cognitum-media-v2-scene-12.jpg)
-
-> Cognitum Media delivers a validated master, reusable assets, and a receipt for
-> every decision. Creation moves fast. Control remains human.
-
-Validated master Β· Reusable production assets Β· Complete decision receipt
-
-### All twelve at once
-
-![Contact sheet β€” all twelve scenes](../assets/media/cognitum-media-v2-contact.png)
-
----
-
-## The part that matters to Ruflo
-
-The creative providers had **generation authority only**. Across the entire run
-they could not:
-
-- publish or schedule the output
-- deploy it to any destination
-- select advertising
-- alter ticker or emergency text
-- take control of a live broadcast
-- mutate billing, or spend past the declared cap
-
-The run terminated at `awaiting_approval` with `publication_authorized: false`.
-Producing a finished, validated, broadcast-ready master and *still* not being
-allowed to release it is the entire point β€” the same shape as an evaluation
-receipt in `@dream-machine/witness` that carries `authority: 'none'`, or a Ruflo
-agent that can propose a change but not merge it.
-
-```json
-"governance": {
- "approval_required": true,
- "publication_authorized": false,
- "approved_max_cost_usd": 20,
- "allow_personal_likeness": true
-}
-```
-
-### Consent travels with the likeness, not the render
-
-One recorded attestation β€” *"The presenter and rights holder authorizes Cognitum
-to use this likeness and stored voice alias for this production"* β€” covers all
-four presenters. The male, female and cartoon variants are derived from the same
-approved appearance asset and share a single `voice_alias`:
-
-| Character | Kind | Direction |
-|---|---|---|
-| `ruv` | original | the approved presenter |
-| `ruv_male` | male | confident cinematic field correspondent, tailored black broadcast wardrobe |
-| `ruv_female` | female | polished female technology anchor, premium newsroom wardrobe |
-| `ruv_cartoon` | cartoon | editorial graphic art with expressive linework |
-
-Changing the presentation does not shed the policy envelope. That is the claim
-scene 9 is making, and it is enforced in the spec rather than asserted in the
-script.
-
-### Audio is mastered to declared targets, not to taste
-
-| Setting | Value |
-|---|---|
-| Dialogue target | βˆ’16 LUFS |
-| True peak ceiling | βˆ’1.5 dBTP |
-| Music ducking under dialogue | 20 dB |
-| Score | 112 bpm, used as stings |
-
-Pronunciation is pinned in the spec too (`rUv` β†’ "roove", `Cognitum` β†’ "cog nee
-tum"), so voice generation cannot quietly drift on proper nouns.
-
----
-
-## Verification
-
-Every number on this page was checked against the artifacts rather than taken
-from the production notes.
-
-```console
-$ shasum -a 256 -c SHA256SUMS
-production-spec.json: OK
-ultimate_cognitum_media_v2_final-contact.png: OK
-ultimate_cognitum_media_v2_final-poster.png: OK
-ultimate_cognitum_media_v2_final-validation.json: OK
-ultimate_cognitum_media_v2_final.mp4: OK
-ultimate_cognitum_media_v2_final.vtt: OK
-```
-
-`ffprobe` on the master independently confirms the codec, resolution, frame
-rate, sample rate, channel count, duration and byte size claimed above. The
-decoded validation receipt reports:
-
-| Check | Result |
-|---|---|
-| `passed` | true |
-| Decoded frames | 3,016 (floor: 2,992) |
-| Black intervals | 0 |
-| Freeze intervals | 0 |
-| Mean audio | βˆ’20.5 dB |
-| Peak audio | βˆ’1.5 dB |
-| Consent recorded | true |
-| Publication authorized | **false** |
-
-Two caveats carried over from the source notes, preserved rather than rounded
-away: the cost is a **bounded estimate, not an invoice** β€” the provider API did
-not reconcile a billed figure β€” and captions ship as a WebVTT sidecar rather
-than burned into the picture.
-
----
-
-## Known defect
-
-Scene 9's panel headline is specified as *"Creative does not mean loose"* but
-renders in the master as **"Creative does not mean loos"**.
-
-It is the longest headline in the production at 28 characters; every other panel
-is 25 characters or fewer and renders intact. That points at a fixed-width
-truncation in the overlay renderer rather than a content error in the spec. The
-defect is baked into the delivered master, so it needs a re-render to fix β€” it
-is left visible here rather than cropped out.
-
----
-
-## Reproduce
-
-```bash
-npm run media -- plan production/cognitum-media-ultimate-v2/production-spec.json
-
-COGNITUM_MEDIA_API_URL=https://your-gateway.example \
-COGNITUM_MEDIA_API_KEY=cog_scoped_key \
-npm run media -- run production/cognitum-media-ultimate-v2/production-spec.json --confirm-spend
-```
-
-Acceptance: `ultimate_cognitum_media_v2_final-validation.json` reports `passed:
-true`, at least 2,992 decoded frames, audio present, and zero black and freeze
-intervals.
-
----
-
-## Watch the master
-
-The 84 MB master is deliberately **not** committed to this repository. It ships
-with the production artifacts:
-
-```
-cognitum-media-factory/production/cognitum-media-ultimate-v2/
-β”œβ”€β”€ ultimate_cognitum_media_v2_final.mp4 # 84 MB master
-β”œβ”€β”€ ultimate_cognitum_media_v2_final.vtt # caption sidecar
-β”œβ”€β”€ ultimate_cognitum_media_v2_final-validation.json
-β”œβ”€β”€ ultimate_cognitum_media_v2_final-poster.png
-β”œβ”€β”€ ultimate_cognitum_media_v2_final-contact.png
-β”œβ”€β”€ production-spec.json
-└── SHA256SUMS
-```
-
-<!-- Replace this block with the hosted player URL once the master is published. -->
-
-Output formats declared in the spec: `mp4`, `poster`, `vtt` β†’ `artifacts/ultimate-cognitum-media-v2`.