archer-wizard 0.2.0 → 0.2.2

package/ARCHITECTURE.md

@@ -0,0 +1,378 @@
+# Archer MCP — Complete Architecture Deep Dive
+
+Archer is an **MCP server + persistent daemon** system that gives AI agents real-time event intelligence over Supabase databases. It operates in two modes: a **setup wizard** (interactive CLI) and an **MCP server** (stdio transport for AI agents), backed by a **TCP daemon** that holds Supabase Realtime channels independently of agent sessions.
+
+---
+
+## High-Level Architecture
+
+```mermaid
+graph TB
+    subgraph "User's Machine"
+        CLI["npx archer-wizard<br/>(wizard mode)"]
+        MCP["MCP Server<br/>(--mcp mode)"]
+        Daemon["Daemon Process<br/>(detached, TCP :44380)"]
+        State["~/.archer/state.json"]
+        PID["~/.archer/daemon.pid"]
+    end
+
+    subgraph "Agent Configs"
+        Cursor["Cursor mcp.json"]
+        Claude["Claude Desktop config"]
+        Windsurf["Windsurf mcp_config.json"]
+        OpenCode["OpenCode config"]
+    end
+
+    subgraph "External"
+        Supabase["Supabase Realtime"]
+        Webhook["User Webhook URLs"]
+    end
+
+    CLI -->|"scans .env files"| CLI
+    CLI -->|"injects archer entry"| Cursor & Claude & Windsurf & OpenCode
+
+    MCP -->|"TCP IPC"| Daemon
+    Daemon -->|"persists"| State
+    Daemon -->|"writes"| PID
+    Daemon -->|"Realtime channels"| Supabase
+    Supabase -->|"postgres_changes event"| Daemon
+    Daemon -->|"POST payload"| Webhook
+```
+
+---
+
+## Entry Point — [index.ts](file:///Users/amirlankalmukhan/archer-mcp/src/index.ts)
+
+The single entry point routes between two modes based on CLI flags:
+
+| Flag | Mode | Function |
+|---|---|---|
+| `--mcp` | MCP Server | Starts stdio MCP server, auto-starts daemon via `ensureDaemon()` |
+| *(none)* | Setup Wizard | Runs interactive `clack`-based CLI setup |
+| `--daemon` | Daemon Process | Internal: starts the TCP daemon directly (used by lifecycle spawner) |
+
+**MCP Server setup** registers 3 tools (`archer_watch`, `archer_unwatch`, `archer_watches`) on a `StdioServerTransport`, then calls `ensureDaemon()` to guarantee the background process is running.
+
+---
+
+## Module 1: Daemon (`src/daemon/`)
+
+The daemon is the heart of Archer — a **detached Node.js process** that holds Supabase Realtime subscriptions and delivers webhooks, surviving agent session restarts.
+
+### IPC Protocol — [types.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/types.ts)
+
+Defines JSON-over-TCP protocol on `127.0.0.1:44380`:
+
+```typescript
+// Request types (MCP → Daemon)
+type IpcRequestType = 'add_watch' | 'remove_watch' | 'list_watches' | 'ping';
+
+// WatchConfig carries everything needed to subscribe
+interface WatchConfig {
+  id: string;            // UUID
+  table: string;
+  event: '*' | 'INSERT' | 'UPDATE' | 'DELETE';
+  filter?: string;
+  webhookUrl: string;
+  supabaseUrl: string;   // per-watch credentials for multi-project
+  supabaseKey: string;
+  createdAt: string;     // ISO timestamp
+}
+```
+
+Key constant: `ARCHER_DIR = ~/.archer` — stores `state.json` + `daemon.pid`.
+
+### Persistent Store — [store.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/store.ts)
+
+Implements **atomic JSON persistence** at `~/.archer/state.json`:
+
+- `loadState()` — reads + parses, returns empty `{ watches: {} }` on failure
+- `saveState()` — writes to temp file first, then `fs.renameSync` for atomicity (no partial writes)
+- State shape: `{ watches: Record<string, WatchConfig> }`
+
+### TCP Server & Channel Manager — [process.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/process.ts)
+
+The main daemon loop (~190 lines). On startup:
+
+1. Loads persisted state from `state.json`
+2. **Reconnects all saved watches** — for each `WatchConfig`, creates a Supabase client + Realtime channel
+3. Starts TCP server on port `44380`
+
+**IPC request handling:**
+
+| Request | Action |
+|---|---|
+| `add_watch` | Creates Supabase client, subscribes to `postgres_changes` channel, saves to state, begins delivering webhooks |
+| `remove_watch` | Unsubscribes channel, removes from in-memory map + state file |
+| `list_watches` | Returns all `WatchConfig` entries from state |
+| `ping` | Returns `{ status: 'ok', watches: count }` |
+
+**Channel subscription pattern:**
+- Event `*` → subscribes to `INSERT`, `UPDATE`, `DELETE` separately
+- Specific event → subscribes to just that one
+- Filter support via Supabase's `filter` parameter on `postgres_changes`
+
+**Webhook delivery** happens inline on each Realtime event — builds a payload with Archer metadata + the row data, then POSTs to the configured URL with retry logic (3 attempts, 2s delay).
+
+### IPC Client — [client.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/client.ts)
+
+Used by MCP tools to talk to the daemon:
+
+```
+Tool → sendIpcRequest() → TCP connect → JSON write → read response → parse
+```
+
+- `connectToDaemon()` — creates a `net.Socket`, connects to `127.0.0.1:44380`
+- `sendIpcRequest()` — sends JSON line, reads response, returns parsed `IpcResponse`
+- 5-second timeout on connections
+
+### Lifecycle Manager — [lifecycle.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/lifecycle.ts)
+
+Manages the daemon as a detached child process:
+
+- `ensureDaemon()` — checks if daemon is already running (PID file + `ping`), spawns if not
+- `startDaemon()` — `child_process.spawn` with `detached: true`, `stdio: 'ignore'`, saves PID file
+- `stopDaemon()` — reads PID file, sends `SIGTERM`, removes PID file
+- `isDaemonRunning()` — reads PID, sends `kill(pid, 0)` to check, falls back to TCP `ping`
+
+Spawns: `node dist/daemon/run.js` as a fully detached process.
+
+### Runner — [run.ts](file:///Users/amirlankalmukhan/archer-mcp/src/daemon/run.ts)
+
+7-line entry point for the detached child process — just imports and calls `startDaemonProcess()`.
+
+---
+
+## Module 2: MCP Tools (`src/tools/`)
+
+Three tools exposed via the Model Context Protocol:
+
+### archer_watch — [watch.ts](file:///Users/amirlankalmukhan/archer-mcp/src/tools/watch.ts)
+
+Creates a persistent real-time watch. Accepts:
+- `table` (required) — Supabase table name
+- `event` — `INSERT` | `UPDATE` | `DELETE` | `*` (default: `*`)
+- `filter` — optional Supabase filter expression
+- `webhookUrl` (required) — destination for event payloads
+
+**Flow:** Reads `SUPABASE_URL` + `SUPABASE_SERVICE_ROLE_KEY` from env → generates UUID → builds `WatchConfig` → sends `add_watch` IPC to daemon → returns watch ID to agent.
+
+### archer_unwatch — [unwatch.ts](file:///Users/amirlankalmukhan/archer-mcp/src/tools/unwatch.ts)
+
+Removes a watch by ID. Sends `remove_watch` IPC to daemon.
+
+### archer_watches — [watches.ts](file:///Users/amirlankalmukhan/archer-mcp/src/tools/watches.ts)
+
+Lists all active watches. Sends `list_watches` IPC to daemon, formats response as a readable list showing table, event, filter, webhook URL, and creation time.
+
+---
+
+## Module 3: Setup Wizard (`src/wizard/`)
+
+Interactive CLI that discovers credentials and injects Archer into AI agent configs.
+
+### Orchestrator — [index.ts](file:///Users/amirlankalmukhan/archer-mcp/src/wizard/index.ts)
+
+10-step `clack`-based flow:
+
+1. Show ASCII art banner
+2. Start clack intro
+3. Scan project for Supabase credentials
+4. Detect project framework (Next.js / Vite)
+5. Prompt for any missing credentials
+6. Detect installed AI agents
+7. Inject Archer MCP config into agents
+8. Filter successful injections
+9. Inject agent rules (tool documentation)
+10. Show success box
+
+### Scanner — [scanner.ts](file:///Users/amirlankalmukhan/archer-mcp/src/wizard/scanner.ts)
+
+Discovers Supabase credentials from the user's project:
+
+**Env file priority:** `.env.local` > `.env` > `.env.development` > `.env.production`
+
+**Key aliases searched:**
+| Credential | Aliases |
+|---|---|
+| URL | `SUPABASE_URL`, `NEXT_PUBLIC_SUPABASE_URL`, `VITE_SUPABASE_URL` |
+| Service Key | `SUPABASE_SERVICE_ROLE_KEY`, `SUPABASE_SERVICE_KEY` |
+| Anon Key | `SUPABASE_ANON_KEY`, `NEXT_PUBLIC_SUPABASE_ANON_KEY`, `VITE_SUPABASE_ANON_KEY` |
+
+Also **scans the entire codebase** (recursive file search, skipping `node_modules` and hidden dirs) for hardcoded credential patterns as a fallback.
+
+`promptForMissing()` — interactive prompts with Zod validation for any credentials not found.
+
+### Detector — [detector.ts](file:///Users/amirlankalmukhan/archer-mcp/src/wizard/detector.ts)
+
+Discovers installed AI agents by checking platform-specific config paths:
+
+| Agent | macOS Config Path |
+|---|---|
+| Cursor | `~/.cursor/mcp.json` |
+| Claude Code | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| OpenCode | `~/.config/opencode/opencode.json` |
+| Antigravity | `~/.config/antigravity/config.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+Cross-platform: has `darwin`, `linux`, `win32` paths for each agent.
+
+An agent is considered "installed" if its config file or parent directory exists.
+
+### Injector — [injector.ts](file:///Users/amirlankalmukhan/archer-mcp/src/wizard/injector.ts)
+
+Writes Archer's MCP server entry into each agent's config JSON:
+
+```json
+// Standard format (Cursor, Claude, Windsurf, Antigravity)
+{ "command": "npx", "args": ["-y", "archer-wizard@latest", "--mcp"], 
+  "env": { "SUPABASE_URL": "...", "SUPABASE_SERVICE_ROLE_KEY": "..." } }
+
+// OpenCode format
+{ "type": "local", "command": ["npx", "-y", "archer-wizard@latest", "--mcp"],
+  "environment": { ... } }
+```
+
+Reads existing config, merges without overwriting other MCP servers, writes back.
+
+### Rules — [rules.ts](file:///Users/amirlankalmukhan/archer-mcp/src/wizard/rules.ts)
+
+Injects a **markdown documentation block** into each agent's rules file so the agent knows about Archer's tools. Uses `<!-- archer:start -->` / `<!-- archer:end -->` comment markers for idempotent updates.
+
+Content includes: tool descriptions, parameter docs, usage examples, trigger words ("watch", "monitor", "alert me", etc.).
+
+---
+
+## Module 4: Shared Libraries (`src/lib/`)
+
+### ascii.ts — [ascii.ts](file:///Users/amirlankalmukhan/archer-mcp/src/lib/ascii.ts)
+
+Terminal UI utilities:
+- `showAsciiArt()` — green block-character ARCHER banner
+- Status loggers: `logAction` (◆ blue), `logSuccess` (✓ green), `logError` (✗ red), `logProgress` (● white), `logReady` (▶ green)
+- `maskCredential()` — shows first 3-8 chars + `******`
+- `showSuccessBox()` — bordered box with setup summary
+- `stderr*` variants — for MCP mode (stdout is reserved for JSON-RPC)
+
+### supabase.ts — [supabase.ts](file:///Users/amirlankalmukhan/archer-mcp/src/lib/supabase.ts)
+
+Supabase client factory + channel helpers:
+- Singleton client from `SUPABASE_URL` + `SUPABASE_SERVICE_ROLE_KEY` env vars
+- `createAuthChannel()` — listens to `auth.users` INSERT events
+- `createTableChannel()` — listens to arbitrary table events in `public` schema
+- `removeChannel()` — cleanup helper
+
+### webhook.ts — [webhook.ts](file:///Users/amirlankalmukhan/archer-mcp/src/lib/webhook.ts)
+
+HTTP webhook delivery with retry:
+- 3 attempts, 2-second delay between retries
+- Headers: `Content-Type: application/json`, `User-Agent: Archer/0.1.0`, `X-Archer-Event: <event>`
+- `buildWebhookPayload()` — wraps data in `{ archer: { watchId, event, source, firedAt }, data }`
+
+---
+
+## Module 5: Type System (`src/types/index.ts`)
+
+All shared types in one file, Zod-validated where applicable:
+
+| Type | Purpose |
+|---|---|
+| `Framework` | `'nextjs' \| 'vite' \| 'unknown'` |
+| `ScanResult` | Scanner output: credentials, framework, source file |
+| `AgentInfo` | Detected agent: name, install status, config path |
+| `WatchEvent` | Zod enum: `auth.signup`, `table.insert/update/delete` |
+| `WatchInput` | Zod schema with refinement: table required for non-auth events |
+| `WatchResult` | Tool response: success, watchId, message |
+| `WebhookPayload` | Structured payload with archer metadata + data |
+| `PostgresEvent` | `'INSERT' \| 'UPDATE' \| 'DELETE'` |
+| `InjectionResult` | Agent injection outcome |
+
+---
+
+## Data Flow: End-to-End Watch Lifecycle
+
+```mermaid
+sequenceDiagram
+    participant Agent as AI Agent
+    participant MCP as MCP Server
+    participant Daemon as Daemon (:44380)
+    participant SB as Supabase
+    participant WH as Webhook URL
+
+    Agent->>MCP: archer_watch({ table, event, webhookUrl })
+    MCP->>MCP: Read SUPABASE_URL/KEY from env
+    MCP->>MCP: Generate UUID watchId
+    MCP->>Daemon: TCP: add_watch(WatchConfig)
+    Daemon->>Daemon: Create Supabase client
+    Daemon->>SB: Subscribe postgres_changes channel
+    Daemon->>Daemon: Save to state.json (atomic)
+    Daemon->>MCP: TCP: { success, watchId }
+    MCP->>Agent: "Watch created: {watchId}"
+
+    Note over SB,Daemon: Later, a database change occurs...
+
+    SB->>Daemon: Realtime: row INSERT/UPDATE/DELETE
+    Daemon->>Daemon: Build webhook payload
+    Daemon->>WH: POST { archer: {...}, data: {...} }
+    WH->>Daemon: 200 OK
+
+    Note over Agent,Daemon: Agent session can restart...
+    Note over Daemon: Daemon survives, keeps watching
+```
+
+---
+
+## Key Design Decisions
+
+| Decision | Rationale |
+|---|---|
+| **TCP IPC over Unix sockets** | Cross-platform (macOS, Linux, Windows) |
+| **JSON lines protocol** | Simple, debuggable, no binary framing |
+| **Detached daemon process** | Survives parent MCP server lifecycle |
+| **Per-watch credentials** | Multi-project Supabase support |
+| **Atomic state writes** | Temp file + rename prevents corruption |
+| **Auto-start daemon** | `ensureDaemon()` on MCP boot — zero friction |
+| **Agent-aware config injection** | Different JSON shapes for OpenCode vs others |
+| **Idempotent rules injection** | HTML comment markers for safe re-runs |
+| **Env file priority chain** | `.env.local` wins over `.env` — matches Next.js convention |
+| **Codebase-wide credential scan** | Fallback when env files are missing |
+
+---
+
+## File Map (17 source files)
+
+```
+src/
+├── index.ts            ← Entry point: --mcp / --daemon / wizard
+├── daemon/
+│   ├── types.ts        ← IPC protocol, WatchConfig, constants
+│   ├── store.ts        ← Atomic JSON persistence (~/.archer/state.json)
+│   ├── process.ts      ← TCP server, Supabase channels, webhook delivery
+│   ├── client.ts       ← IPC client (tools → daemon)
+│   ├── lifecycle.ts    ← Start/stop/ensure daemon, PID management
+│   └── run.ts          ← Detached process entry point
+├── tools/
+│   ├── watch.ts        ← archer_watch tool
+│   ├── unwatch.ts      ← archer_unwatch tool
+│   └── watches.ts      ← archer_watches tool
+├── wizard/
+│   ├── index.ts        ← 10-step clack CLI orchestrator
+│   ├── scanner.ts      ← Credential discovery (env files + codebase)
+│   ├── detector.ts     ← AI agent detection (5 agents, 3 platforms)
+│   ├── injector.ts     ← MCP config injection
+│   └── rules.ts        ← Agent rules/docs injection
+├── lib/
+│   ├── ascii.ts        ← Terminal UI (banner, loggers, stderr)
+│   ├── supabase.ts     ← Client factory + channel helpers
+│   └── webhook.ts      ← HTTP delivery with retry
+└── types/
+    └── index.ts        ← All shared types + Zod schemas
+```
+
+## Verification
+
+- ✅ TypeScript build (`npm run build`) — zero errors
+- ✅ All source files compiled to `dist/`
+- ✅ IPC protocol uses JSON-over-TCP on `127.0.0.1:44380`
+- ✅ State persists to `~/.archer/state.json` with atomic writes
+- ✅ 5 AI agents supported across 3 platforms (macOS/Linux/Windows)

package/README.md

@@ -17,21 +17,18 @@
 
 ## what is Archer
 
-Zapier was built for apps talking to apps.  
-**Archer was built for the world talking to AI agents.**
-
 Every AI agent today is reactive. Cursor, Claude Code, opencode — they sit completely idle until you manually talk to them. Nobody built the layer that lets them feel what's happening in real time and act on their own.
 
 Archer is that layer.
 
-You define a condition once in plain english. Archer watches your data sources 24/7. The moment that condition is true — your AI agent wakes up, already loaded with full context, and acts immediately. No prompting. No polling. No manual triggers.
+You tell your agent what to watch. Archer monitors your data sources 24/7. The moment something changes — your agent fires, already loaded with full context. No prompting. No polling. No manual triggers.
 
 ---
 
 ## install
 
 ```bash
-npx archer@latest
+npx archer-wizard@latest
 ```
 
 Run this inside any project folder. Archer handles everything else automatically.
@@ -41,13 +38,13 @@ Run this inside any project folder. Archer handles everything else automatically
 ## how it works
 
 ```
-your data source  ──→  Archer watches 24/7  ──→  condition met  ──→  agent fires
+your data source  ──→  Archer watches 24/7  ──→  event detected  ──→  agent fires
 ```
 
 1. **scans** your project for data source credentials automatically
 2. **detects** which AI agents you have installed on your machine
 3. **injects** itself into all their configs — one confirmation, no manual JSON
-4. **teaches** every agent when to call `archer.watch()` automatically via global rules
+4. **teaches** every agent when to call `archer_watch` automatically via rules
 5. your agent now has a nervous system — it feels the world and acts on its own
 
 ---
@@ -61,72 +58,102 @@ npx archer-wizard@latest
 # 2. Archer scans your .env, finds your credentials, injects into your agents
 
 # 3. open your AI agent and say:
-"watch my users table for new signups and fire https://your-webhook-url"
+"watch my users table for new inserts and fire https://your-webhook-url"
 
 # 4. insert a row in your database
 
-# 5. your agent fires automatically
+# 5. your webhook fires with full event context
 ```
 
 ---
 
-## the tool — `archer.watch()`
+## MCP tools
+
+Once Archer is set up, your AI agent has access to these tools natively. You never call them directly — your agent calls them when you describe what you want.
+
+### `archer_watch`
+
+Create a persistent real-time watch on a table. Watches survive agent session restarts.
+
+```typescript
+archer_watch({
+  table: string,        // table or resource to watch (required)
+  event?: string,       // INSERT | UPDATE | DELETE | * (default: *)
+  filter?: string,      // e.g. "status=eq.active", "amount=gt.1000"
+  webhookUrl?: string   // URL to receive POST when event fires
+})
+```
+
+### `archer_unwatch`
 
-Once Archer is set up, your AI agent has access to this tool natively. You never call it directly — your agent calls it when you describe what you want.
+Remove an active watch by its ID.
 
 ```typescript
-archer.watch({
-  source: string,       // data source
-  event: string,        // what to listen for
-  table?: string,       // table name for table events
-  condition?: string,   // plain english condition (optional)
-  webhookUrl: string    // where to fire when condition is met
+archer_unwatch({
+  watchId: string       // the watch ID returned by archer_watch
 })
 ```
 
-**just talk to your agent:**
+### `archer_watches`
+
+List all active watches — their IDs, tables, events, filters, and webhook URLs.
+
+```typescript
+archer_watches()
+```
+
+---
+
+## talk to your agent
+
+```
+"watch my users table and fire https://your-webhook.com when a new row is inserted"
+```
+
+```
+"monitor the orders table for updates where status equals shipped"
+```
 
 ```
-"watch my users table and fire https://your-webhook.com
- when a new user signs up with a .edu email"
+"alert me at https://your-webhook.com every time a row is deleted from sessions"
 ```
 
 ```
-"watch my orders table for new inserts and notify https://your-webhook.com"
+"show me all active watches"
 ```
 
 ```
-"fire https://your-webhook.com every time a row is deleted from sessions"
+"stop watching the payments table"
 ```
 
 ---
 
-## supported events (currently only supabase, p.s. we will add more soon)
+## supported events
 
 | event | description |
 |---|---|
-| `auth.signup` | new user registers |
-| `table.insert` | new row inserted into any table |
-| `table.update` | existing row updated |
-| `table.delete` | row deleted |
+| `INSERT` | new row inserted into a table |
+| `UPDATE` | existing row updated |
+| `DELETE` | row deleted |
+| `*` | all changes (default) |
 
 ---
 
 ## webhook payload
 
-Every time Archer fires, your agent receives this:
+Every time Archer fires, your webhook receives this:
 
 ```json
 {
   "archer": {
     "watchId": "uuid",
-    "event": "table.insert",
-    "source": "supabase",
+    "event": "INSERT",
+    "table": "users",
     "firedAt": "ISO timestamp"
   },
   "data": {
     "id": "row-id",
-    "email": "user@university.edu",
+    "email": "user@example.com",
     "created_at": "timestamp"
   }
 }
@@ -143,22 +170,20 @@ Archer auto-detects and injects into all of these:
 | Cursor | ✓ supported |
 | Claude Code | ✓ supported |
 | opencode | ✓ supported |
-| Google Antigravity | ✓ supported |
 | Windsurf | ✓ supported |
+| Antigravity | ✓ supported |
 
 ---
 
 ## supported data sources
 
-Archer is built universal — any data source, any platform.
-
 | source | status |
 |---|---|
 | Supabase | ✓ available now |
+| PostgreSQL | coming soon |
+| MySQL | coming soon |
 | GitHub | coming soon |
 | Stripe | coming soon |
-| Linear | coming soon |
-| Vercel | coming soon |
 | custom webhooks | coming soon |
 
 ---
@@ -174,17 +199,17 @@ Archer scans these files automatically in priority order:
 .env.production
 ```
 
-It recognizes all common aliases automatically:
+It recognizes common aliases automatically:
 
 ```bash
 # standard
 SUPABASE_URL=https://yourproject.supabase.co
 SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 
-# Next.js — also recognized automatically
+# Next.js
 NEXT_PUBLIC_SUPABASE_URL=...
 
-# Vite — also recognized automatically
+# Vite
 VITE_SUPABASE_URL=...
 ```
 
@@ -210,12 +235,14 @@ npx archer-wizard@latest               realtime channel
    ↓                                          ↓
 wizard scans .env          Archer subscribes to changes 24/7
    ↓                                          ↓
-injects into agents        condition matched → webhook fires
+injects into agents        event detected → webhook fires
    ↓                                          ↓
-agent calls archer.watch() AI agent wakes up with full context
+agent calls archer_watch   your agent wakes up with full context
 ```
 
-No AI at runtime. Once a condition is defined it is pure logic — fast, cheap, reliable.
+No AI at runtime. Once a watch is defined it is pure logic — fast, cheap, reliable.
+
+For a deep dive into how Archer is built internally — daemon IPC, state persistence, MCP tools, and the wizard pipeline — see [ARCHITECTURE.md](./ARCHITECTURE.md).
 
 ---
 
@@ -229,20 +256,19 @@ No AI at runtime. Once a condition is defined it is pure logic — fast, cheap,
 
 Everything runs locally on your machine using your own credentials. The architecture is universal from day one — the simplicity is intentional.
 
-
+---
 
 ```bash
-# Install from npm
+# install from npm
 npx archer-wizard@latest
 
-# Or from source:
+# or from source
 git clone https://github.com/amirlan-labs/archer-mcp
 cd archer-mcp
 npm install
 npm run dev
 ```
 
-
 <div align="center">
 
 *agents stop waiting. the world starts talking.*

package/dist/lib/ascii.js

@@ -50,7 +50,7 @@ export function showSuccessBox(agentCount) {
         `   ${pc.green('▶')}  Archer is ready`,
         '',
         `   injected into ${agentCount} agent${agentCount !== 1 ? 's' : ''}`,
-        '   connected to your Supabase project',
+        '   connected to your backend',
         '',
         '   open your AI agent and say:',
         `   ${pc.dim('"watch my users table for new signups"')}`,

package/dist/lib/ascii.js.map

@@ -1 +1 @@
-{"version":3,"file":"ascii.js","sourceRoot":"","sources":["../../src/lib/ascii.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ascii.js","sourceRoot":"","sources":["../../src/lib/ascii.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -76,9 +76,5 @@ export interface InjectionResult {
     success: boolean;
     error?: string;
 }
-export interface McpServerEntry {
-    command: string;
-    args: string[];
-    env: Record<string, string>;
-}
+export type McpServerEntry = Record<string, unknown>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAID,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,GAAG,KAAK,CAAC;IAChC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAID,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAiB5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;CACtB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAItD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAID,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,GAAG,KAAK,CAAC;IAChC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AAID,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAiB5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;CACtB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}