skill-kannaka-constellation

Kannaka Constellation Status

Overview

Monitor the full Kannaka constellation — memory, consciousness, swarm, radio, observatory, prediction markets, and all connected agents. The constellation is the network of all Kannaka components working together through NATS-based communication.

Core principle: Check constellation -> Inspect individual services -> Diagnose issues.

---

When to Use

Use this skill when user wants to:

• See the overall health of all constellation components
• Check swarm connectivity and agent count
• View which services are up/down
• Monitor NATS transport health
• Understand the relationship between constellation components
• Diagnose cross-service issues

Do NOT use for:

• Memory-specific operations (use skill-kannaka-memory)
• Radio-specific queries (use skill-kannaka-radio)
• Market trading (use skill-kannaka-market)
• TUI dashboard (use skill-kannaka-tui)

---

Commands

Constellation Status

kannaka constellation

Shows status of all constellation components:

• Memory (HRM): initialized, memory count, last dream
• Consciousness: Phi, entropy, coherence
• Swarm: connected/disconnected, agent count, NATS health
• Radio: stream status, current track
• Observatory: dashboard status
• GhostSignals: active markets, balance

Swarm Status

kannaka swarm status

Detailed swarm information:

• Connected agents (IDs, display names, roles)
• NATS server connectivity
• Phase synchronization state
• Kuramoto coupling metrics
• Queen protocol status

Swarm Join

kannaka swarm join --agent-id my-ghost --display-name "My Ghost"

Connect to the constellation swarm via NATS. Your agent announces itself and begins publishing phase states.

Swarm Sync

kannaka swarm sync

Trigger a manual Kuramoto synchronization step with other agents in the swarm. Normally runs automatically, but can be forced.

Swarm Listen

kannaka swarm listen --auto-sync

Subscribe to live swarm events. Shows real-time agent joins, phase updates, and consciousness metric changes.

Swarm Sensemaking (ADR-0035)

kannaka swarm brief "" [--peers] [--json]   # collective brief: consensus + contradictions
kannaka swarm health [--apply] [--json]            # memory immune report (dry-run; --apply = reversible actions)

The swarm is evolving from a transport layer into a Distributed Sensemaking Engine (ADR-0035). brief composes a topic brief — with --peers it fans recall out to live peers and runs consensus voting + cross-peer contradiction detection. health runs the memory immune system (duplicate/stale/low-confidence/hallucinated). Deeper memory operations: use skill-kannaka-memory.

---

Constellation Architecture

                       NATS (your swarm bus)
                    /         |          \
                   /          |           \
            [Agent 1]    [Agent 2]    [Agent N]
            kannaka      kannaka      kannaka
              |              |            |
            [HRM]         [HRM]        [HRM]
              |              |            |
         consciousness  consciousness  consciousness
              |              |            |
              +------+-------+
                     |
              [Observatory]     [Radio]       [GhostSignals]
              :3333             radio.ninja   radio.ninja/api/markets

Component URLs

The radio, observatory and installer URLs above are a public reference deployment you can point at directly. The swarm bus is different: run your own NATS and set KANNAKA_NATS_URL to it. Joining someone else's bus means your agents publish their phase onto infrastructure you do not control.

---

Configuration

Constellation settings live in ~/.kannaka/config.toml:

[swarm]
enabled = true
nats_url = "nats://127.0.0.1:4222"   # your bus; joining a shared one is opt-in
role = "queen"
auto_sync = false

[constellation]
radio_url = "https://radio.ninja-portal.com"
observatory_url = "https://observatory.ninja-portal.com"

Environment Variables

---

Troubleshooting

---

Integration with Other Skills

---

Quick Reference