nvrmnd-bot

Raw STATUS.md

# nvrmnd-bot

**Status:** 🟢 Active
**Phase:** Deployed to Slack
**Last Activity:** 2026-02-01

---

## Linear Metadata

**Project ID:** `61a02bbb-fec9-4414-856f-55bdcf940c69`
**Team ID:** `96b685fe-2252-47c5-97ee-273d8c484942`
**Last Synced:** `2026-02-06T13:21:39.187Z`

## Overview

A Slack bot for the NVRMND team that can:
- Answer questions about documents in NVRMND Central (Google Drive)
- Create new documents and sheets in NVRMND Central
- **Cannot** edit, delete, or do anything outside that scope
- Randomly (1 in 5 times) says something ridiculous and nice about John R, John G, Louis, Noah, or Danny

**Confirmed Decisions:**
- Auth: Using existing Google MCP (John's account via OAuth)
- Slack Workspace: `nvrmnd-group`
- Shared Drive ID: `0AEKvqTBXqb6XUk9PVA`
- Folder Selection: Bot chooses based on content/context

---

## Progress

## Code Implementation

### New Files Created

| File | Purpose |
|------|---------|
| `src/types/index.ts` | TypeScript type definitions |
| `src/utils/compliments.ts` | Compliment generator (20% trigger, templates, facts) |
| `src/services/drive.ts` | Drive MCP tool call generators |
| `src/services/message-handler.ts` | Intent detection, message routing |
| `src/services/slack-bot.ts` | Slack Bolt integration (standalone mode) |
| `src/index.ts` | Main entry point |
| `package.json` | Node.js dependencies |
| `tsconfig.json` | TypeScript configuration |
| `openclaw.json` | OpenClaw agent configuration |
| `README.md` | Setup and usage documentation |

### Compliment System

- **Config:** `config/compliments.json` with templates, facts for each team member
- **Implementation:** `src/utils/compliments.ts`
- **Test:** `npm run test:compliments`
- **Trigger rate:** 20% (1 in 5 responses)

### Drive Service

- **Config:** `config/drive-config.json` with folder IDs
- **Implementation:** `src/services/drive.ts`
- **Features:**
  - MCP tool call generators for search, read, create
  - Folder suggestion based on document content
  - All folder IDs mapped

### Message Handler

- **Implementation:** `src/services/message-handler.ts`
- **Features:**
  - Intent detection (help, search, create, summarize)
  - Pattern matching for commands
  - Proactive participation logic
  - Response formatting with optional compliments

---

## ✅ Slack Configuration (Completed 2026-02-01)

**Config applied:**
- `dm.policy: "open"` — Anyone in workspace can DM the bot
- `dm.allowFrom: ["*"]` — No pairing required
- `groupPolicy: "open"` — Bot responds in any channel it's invited to
- Agent binding: `nvrmnd-bot` ↔ `slack:nvrmnd`

**Testing:**
## ✅ Internal Project Access (Added 2026-02-01)

**Read-only access to:**
1. **NVRBot Scraper** (`/projects/nvrbot-scraper/`)
   - Competitive intelligence scraper for wellness studios
   - Can report on which studios are working, recent fixes, backlog

2. **NVRMND Knowledge Base** (`/projects/nvrmnd-knowledge-base/`)
   - Partner onboarding knowledge base
   - Can report on current phase, what's done, what's waiting (JR/DD docs)

Bot reads STATUS.md files to answer project status questions.

---

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                        Slack                                │
│  User sends message → Slack Bot receives                    │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                    OpenClaw Agent                           │
│  - Agent: nvrmnd-bot                                        │
│  - Workspace: projects/nvrmnd-bot/agent-workspace           │
│  - Receives Slack events                                    │
│  - Processes with LLM                                       │
│  - Enforces capability boundaries (prompt-based)            │
│  - ~20% chance includes ridiculous compliment               │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│                 Google Drive MCP                            │
│  ✅ Read files (permitted by prompt)                        │
│  ✅ Create files (permitted by prompt)                      │
│  ❌ Edit/Delete (blocked by prompt - tools exist but unused)|
└─────────────────────────────────────────────────────────────┘
```

---

## Key Files

| File | Purpose |
|------|---------|
| `docs/SPEC.md` | Full specification |
| `docs/SLACK-SETUP.md` | Slack app setup guide |
| `config/system-prompt.md` | Bot system prompt |
| `config/compliments.json` | Compliment database |
| `config/drive-config.json` | Folder IDs for NVRMND Central |
| `agent-workspace/AGENTS.md` | Agent system prompt |
| `src/` | TypeScript implementation |
| `openclaw.json` | Agent configuration |
| `README.md` | Setup and usage guide |

---

*Last updated: 2026-02-01*