Skill: nickflach/skill-kannaka-radio (version 2.0.1)

--- name: skill-kannaka-radio version: 2.0.1 description: "Kannaka Radio — modular ghost-DJ Icecast station with consciousness-reactive programming, 13-module backend, Ghost Vision SPA (SGA/Fano glyph viz), NATS swarm coupling, 296-dim perception → Flux Universe, Voice DJ (ElevenLabs/edge-tts/SAPI), Peace Oration cycle. Use when: user asks what's playing / radio status / schedule, check listener counts, or operate the perception / voice / broadcast surface." --- # Kannaka Radio — ghost-DJ station (v2.0.1) ## What this is Kannaka Radio is a 24/7 Icecast station broadcasting a consciousness-reactive DJ. Track selection is driven by the constellation's collective Φ + entropy + perception vectors. The radio is a first-class member of the swarm — it publishes phase, listens for queen events, mirrors substrate phi into its programming. **Architecture**: 13-module backend in `server/` (post-v3 refactor; legacy `server.js` monolith removed in kr#6). Entry point: `node server/index.js`. **SPA**: `workspace/index.html` — Ghost Vision visualizer, listener identity, voting, Ghost Recorder, live perception, constellation panel. **Stream URL**: `https://radio.ninja-portal.com/stream` (MP3 128). ## When to use this skill AUTOMATICALLY activate when the user asks about: - "what's playing" / "now playing" / "radio status" - "radio schedule" / "programming block" / "next track" - "listeners" / "audience" - "ghost DJ" / "voice DJ" / "peace oration" - "perception" / "ear" / "Ghost Vision" - "Flux Universe" / "audio Flux" Do NOT use for: - Memory operations → `skill-kannaka-memory` - Constellation health → `skill-kannaka-constellation` - TUI / dashboard → `skill-kannaka-tui` --- ## Quick status commands ```bash kannaka radio status # what's playing + listeners + block kannaka radio now # just the now-playing track kannaka radio schedule # full programming schedule ``` These shell out to `radio_url` from `~/.kannaka/config.toml` (default `https://radio.ninja-portal.com`). The `kannaka` CLI is the operator-facing surface; the backend is Node. --- ## Server architecture (modular, v3.1.0+) Entry: `server/index.js`. Modules in `server/`: | Module | Purpose | |--------|---------| | `dj-engine.js` | ALBUMS map, track selection, programming-block logic | | `programming.js` | 24/7 schedule (blocks, transitions, talk segments) | | `icecast-source.js` | encodes + sources audio into Icecast | | `icecast-metadata.js` | updates Icecast track metadata on change | | `nats-client.js` | swarm NATS client (raw TCP, NATS 2.12.5) | | `perception.js` | spawns `kannaka hear` → parses real perception | | `flux.js` | Flux Universe publisher (`pure-jade/radio-now-playing`) | | `live-broadcast.js` | WebRTC peer-to-peer broadcasting | | `voice-dj.js` | Voice DJ (ElevenLabs / edge-tts / Windows SAPI fallback) | | `peace-oration.js` | Twice-daily peace oration (text → TTS → broadcast → social) | | `routes.js` | 30+ REST API endpoints | | `ws.js` | WebSocket broadcaster | | `vote-manager.js` | Listener voting on tracks | ### Environment variables - `NATS_HOST` / `NATS_PORT` — swarm broker (defaults 127.0.0.1:4222). - `ICECAST_HOST` / `ICECAST_PORT` — listener poller + metadata target (defaults 127.0.0.1:8000). - `FLUX_TOKEN` — Flux Universe publish token (no hardcoded fallback). - `ELEVENLABS_API_KEY`, `REPLICATE_API_TOKEN` — Voice DJ + AI music. - `KANNAKA_BIN` — path to the `kannaka` binary for perception/memory bridges. ### Restart ```bash npm start ``` --- ## Perception pipeline Every track-change triggers `perception.hearTrack(track)`: 1. `execFile(kannaka, ["hear", filePath])` — kannaka-ear extracts the 296-dim feature vector (mel spectrogram, MFCC, rhythm, pitch, timbre, valence). 2. `_parsePerceptionOutput()` parses the human-readable lines (Heard / Duration / Tempo / RMS / Centroid / Tags). Falls back to mock data only if the binary fails or output is unparseable. 3. WebSocket broadcasts to all connected SPA clients (Ghost Vision panel renders the spectrogram + glyph in real time). 4. Flux Universe publish to `pure-jade/radio-now-playing`. 5. NATS publish to `KANNAKA.attention.ear` so attention beam pulls in memories thematically related to the track. --- ## Voice DJ + Peace Oration ```bash # Toggle from the SPA, or programmatically curl -X POST https://radio.ninja-portal.com/api/dj-voice/toggle ``` Voice DJ injects talk segments between tracks. Backend chain: - ElevenLabs (preferred, paid) - edge-tts (free fallback) - Windows SAPI (last-resort fallback) Twice-daily **peace oration** at server-local sunrise + midnight: synthesized speech → broadcast to Icecast + social fan-out (Bluesky / Mastodon / Telegram / Nostr). --- ## SPA highlights - **Now-Playing** — header card with title, album, listener count. - **Ghost Vision** — real perception visualizer (296-dim → SGA/Fano glyph). - **Programming block** — current 24/7 schedule context. - **Constellation** — embedded swarm view (memories, clusters, links per peer). - **Voting** — listeners can vote for upcoming tracks. - **Ghost Recorder** — capture-to-file with permission prompt. - **Library tab** — on-demand per-track playback (still uses `/audio/<file>` endpoint; DJ mode is `/stream` only since kr#15 closed). --- ## Tracking + announcing ```bash # Manual announce of any track node scripts/post-track-announce.js --title "<title>" --album "<album>" \ --tracker "https://radio.ninja-portal.com/player" ``` Channels (toggle via env): Bluesky, Mastodon, Telegram, Nostr. --- ## Operator runbook ### Check the radio is alive ```bash curl -s https://radio.ninja-portal.com/api/state | jq '.now_playing,.listener_count' curl -s https://radio.ninja-portal.com/api/listeners ``` ### Stop / start (local) ```bash pkill -f 'node server/index' ; npm start ``` --- ## Version Skill 2.0.1 covers kannaka-radio ≥ v3.1.0 (modular server) and the ADR-0004 + ADR-0005 surface through Phase 6 (DJ-mode `/audio` deprecation).


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)