| <div align="center"> | |
| ``` | |
| ▲ ▲ | |
| ▐▓▓▓▓▓▌ | |
| ▐▓▓▓▓▓▓▌ | |
| ▀▓▓▓▓▀ | |
| ``` | |
| # SNAPKITTY BOT | |
| ### The SnapKitty fortress in your Discord server. | |
| [](../LICENSE) | |
| [](https://discord.gg/dugymT3rj) | |
| [](https://www.typescriptlang.org) | |
| [](https://prisma.io) | |
| [](https://collectivekitty.com) | |
| **[collectivekitty.com](https://collectivekitty.com) · [DEVFLOW-FINANCE](https://github.com/SNAPKITTYWEST/DEVFLOW-FINANCE) · [Invite Bot](https://discord.gg/dugymT3rj)** | |
| </div> | |
| --- | |
| ## What This Is | |
| SnapKitty Bot brings all 11 sovereign agents into Discord. Ask any agent a question, manage money pools, check your fundability tier, read the live Bifrost audit trail — all from slash commands. | |
| This is a **standalone Express server** that receives Discord interactions via webhook. It connects to the same Neon PostgreSQL database as the main SnapKitty OS and routes `/ask` queries through the Ollama-powered reasoning engine at `collectivekitty.com`. | |
| --- | |
| ## Commands | |
| | Command | What it does | | |
| |---------|-------------| | |
| | `/ask [agent] [message]` | Route any question to any of the 11 agents | | |
| | `/pool create` | Create a named money pool | | |
| | `/pool list` | See all active pools and balances | | |
| | `/pool fund` | Add capital to a pool | | |
| | `/pool close` | Archive a pool | | |
| | `/tier` | Current fundability tier status and blockers | | |
| | `/agents` | Full agent directory in plain English | | |
| | `/status` | System health — Bifrost, DB, infrastructure | | |
| | `/seal` | Last decision seal hash | | |
| | `/audit` | Last 5 Bifrost events with risk scores | | |
| | `/merkle` | Merkle root and WORM chain entry count | | |
| --- | |
| ## The 11 Agents | |
| | Agent | Key | Domain | | |
| |-------|-----|--------| | |
| | **RELAY** | `bridge` | Human-Machine Bridge — start here | | |
| | **AXIOM** | `finance` | GL · Triple-Entry · Money Pools | | |
| | **VAULT** | `treasury` | Reserves · Payments · **Veto authority** | | |
| | **NEXUS** | `crm` | Pipeline · Deals · Forecast | | |
| | **FORGE** | `procurement` | Vendors · POs · Spend | | |
| | **HERALD** | `bifrost` | Event Routing · Traces | | |
| | **TENSOR** | `ml` | Risk Scoring · Anomaly Detection | | |
| | **SENTINEL** | `risk` | Compliance · Threat Score | | |
| | **LEDGE** | `auditor` | WORM Ledger · Audit Chain | | |
| | **ATLAS** | `operator` | Health · **Tier gate authority** | | |
| | **QUILL** | `scriptwriter` | Reports · Decks · Copy | | |
| --- | |
| ## Setup | |
| ### 1. Clone and install | |
| ```bash | |
| git clone https://github.com/SNAPKITTYWEST/myapplication.git | |
| cd myapplication | |
| npm install | |
| npx prisma generate | |
| ``` | |
| ### 2. Configure environment | |
| ```bash | |
| cp .env.example .env | |
| ``` | |
| Fill in `.env`: | |
| ```env | |
| DISCORD_PUBLIC_KEY= # from Discord Developer Portal → your app → General Information | |
| DISCORD_APP_ID= # same page | |
| DISCORD_BOT_TOKEN= # Bot → Token | |
| DATABASE_URL= # Neon PostgreSQL connection string | |
| SNAPKITTY_API_URL=https://collectivekitty.com | |
| PORT=3001 | |
| ``` | |
| ### 3. Register slash commands (once) | |
| ```bash | |
| npm run register | |
| ``` | |
| ### 4. Run the bot | |
| ```bash | |
| # Development | |
| npm run dev | |
| # Production | |
| npm run build && npm start | |
| ``` | |
| ### 5. Connect to Discord | |
| In the [Discord Developer Portal](https://discord.com/developers/applications): | |
| - Go to **General Information** → set **Interactions Endpoint URL** to your server: | |
| ``` | |
| https://your-domain.com/interactions | |
| ``` | |
| - Discord will verify the endpoint with a PING. If it responds with PONG, you're live. | |
| For local development, use [ngrok](https://ngrok.com) or [Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/) to expose `localhost:3001`. | |
| --- | |
| ## Architecture | |
| ``` | |
| Discord → POST /interactions | |
| │ | |
| ├── verifyKey() — Ed25519 signature validation | |
| │ | |
| ├── /ask → askAgent() → Ollama at collectivekitty.com → reply | |
| ├── /pool → Prisma → Neon PostgreSQL → reply | |
| ├── /tier → Prisma → live deal/vendor/pool counts → reply | |
| ├── /status → Prisma → Bifrost event counts → reply | |
| ├── /seal → Prisma → last BifrostEvent → reply | |
| └── /audit → Prisma → last 5 BifrostEvents → reply | |
| ``` | |
| The bot validates every Discord request with Ed25519 before processing. Unauthenticated requests are rejected with 401. | |
| --- | |
| ## Part of the SnapKitty Fortress | |
| This bot is the **Discord interface layer** of the SnapKitty Sovereign OS. | |
| The full system lives in [DEVFLOW-FINANCE](https://github.com/SNAPKITTYWEST/DEVFLOW-FINANCE): | |
| - Rust core with SHA-256 WORM ledger and 5-tier state machine | |
| - Next.js War Room where agents think out loud in real time | |
| - Bifrost event pipeline, Plaid banking, Stripe Issuing | |
| - Local Ollama LLM reasoning (no OpenAI dependency) | |
| --- | |
| <div align="center"> | |
| *SnapKitty Sovereign OS — built in the open, proven in chain.* | |
| **[collectivekitty.com](https://collectivekitty.com) · [DEVFLOW-FINANCE](https://github.com/SNAPKITTYWEST/DEVFLOW-FINANCE) · [Discord](https://discord.gg/dugymT3rj)** | |
| </div> | |
|  | |