archer-wizard 0.1.0

package/dist/wizard/rules.js

@@ -0,0 +1,94 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { logSuccess, logError } from '../lib/ascii.js';
+import { getRulesPath } from './detector.js';
+// ─── Rule Content ───────────────────────────────────────────
+const RULE_CONTENT = `
+# Archer — Event Intelligence for AI Agents
+
+Archer is connected to this project's Supabase instance.
+
+## Available Tool: archer.watch
+
+You can watch real-time events from Supabase using the \`archer.watch\` MCP tool.
+
+### Parameters
+
+- **source**: always \`"supabase"\`
+- **event**: one of \`"auth.signup"\`, \`"table.insert"\`, \`"table.update"\`, \`"table.delete"\`
+- **table**: the table name (required for table events)
+- **condition**: optional filter like \`"email ends with @gmail.com"\`
+- **webhookUrl**: URL to receive POST notifications
+
+### Examples
+
+1. Watch for new user signups:
+   \`\`\`
+   archer.watch({ source: "supabase", event: "auth.signup", webhookUrl: "https://hooks.example.com/signups" })
+   \`\`\`
+
+2. Watch for inserts to the orders table:
+   \`\`\`
+   archer.watch({ source: "supabase", event: "table.insert", table: "orders", webhookUrl: "https://hooks.example.com/orders" })
+   \`\`\`
+
+3. Watch with a condition:
+   \`\`\`
+   archer.watch({ source: "supabase", event: "table.insert", table: "users", condition: "email ends with @company.com", webhookUrl: "https://hooks.example.com/vip" })
+   \`\`\`
+
+When the user asks to "watch" or "monitor" something in their database, use this tool.
+`.trim();
+// ─── Archer Block Markers ───────────────────────────────────
+const BLOCK_START = '<!-- archer:start -->';
+const BLOCK_END = '<!-- archer:end -->';
+function wrapInBlock(content) {
+    return `${BLOCK_START}\n${content}\n${BLOCK_END}`;
+}
+// ─── Replace or Append Block ────────────────────────────────
+function insertContent(existingContent, newBlock) {
+    const startIdx = existingContent.indexOf(BLOCK_START);
+    const endIdx = existingContent.indexOf(BLOCK_END);
+    if (startIdx !== -1 && endIdx !== -1) {
+        // Replace existing block
+        return (existingContent.slice(0, startIdx) +
+            newBlock +
+            existingContent.slice(endIdx + BLOCK_END.length));
+    }
+    // Append to end
+    const separator = existingContent.endsWith('\n') ? '\n' : '\n\n';
+    return existingContent + separator + newBlock + '\n';
+}
+// ─── Write Rules to Agent ───────────────────────────────────
+function writeRulesForAgent(agent, cwd) {
+    try {
+        const rulesPath = getRulesPath(agent.name, cwd);
+        const dir = path.dirname(rulesPath);
+        const wrappedContent = wrapInBlock(RULE_CONTENT);
+        // Ensure directory exists
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Read existing content or start fresh
+        let existingContent = '';
+        if (fs.existsSync(rulesPath)) {
+            existingContent = fs.readFileSync(rulesPath, 'utf-8');
+        }
+        const finalContent = insertContent(existingContent, wrappedContent);
+        fs.writeFileSync(rulesPath, finalContent, 'utf-8');
+        logSuccess(`wrote rules to ${agent.name} → ${rulesPath}`);
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logError(`failed to write rules for ${agent.name}: ${message}`);
+        return false;
+    }
+}
+// ─── Main Rules Injector ────────────────────────────────────
+export function injectRules(agents, cwd) {
+    for (const agent of agents) {
+        writeRulesForAgent(agent, cwd);
+    }
+}
+//# sourceMappingURL=rules.js.map

package/dist/wizard/rules.js.map

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

package/dist/wizard/scanner.d.ts

@@ -0,0 +1,7 @@
+import type { ScanResult } from '../types/index.js';
+export declare function scanProject(cwd: string): Promise<ScanResult>;
+export declare function promptForMissing(scan: ScanResult): Promise<{
+    supabaseUrl: string;
+    serviceRoleKey: string;
+}>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/wizard/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/wizard/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAgI/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA8DlE;AAID,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAgD1D"}

package/dist/wizard/scanner.js

@@ -0,0 +1,201 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import * as clack from '@clack/prompts';
+import { z } from 'zod';
+import { logSuccess, logError, maskCredential } from '../lib/ascii.js';
+// ─── Env File Priority ──────────────────────────────────────
+const ENV_FILES = [
+    '.env.local',
+    '.env',
+    '.env.development',
+    '.env.production',
+];
+// ─── Key Aliases ────────────────────────────────────────────
+const SUPABASE_URL_ALIASES = [
+    'SUPABASE_URL',
+    'NEXT_PUBLIC_SUPABASE_URL',
+    'VITE_SUPABASE_URL',
+];
+const SERVICE_ROLE_KEY_ALIASES = [
+    'SUPABASE_SERVICE_ROLE_KEY',
+    'SUPABASE_SERVICE_KEY',
+];
+const ANON_KEY_ALIASES = [
+    'SUPABASE_ANON_KEY',
+    'NEXT_PUBLIC_SUPABASE_ANON_KEY',
+    'VITE_SUPABASE_ANON_KEY',
+];
+// ─── Validation Schemas ─────────────────────────────────────
+const SupabaseUrlSchema = z.string().url().startsWith('https://', {
+    message: 'SUPABASE_URL must start with https://',
+});
+const ServiceRoleKeySchema = z.string().min(1, {
+    message: 'SUPABASE_SERVICE_ROLE_KEY must be a non-empty string',
+});
+// ─── Parse Env File ─────────────────────────────────────────
+function parseEnvFile(filePath) {
+    const vars = new Map();
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        for (const rawLine of lines) {
+            const line = rawLine.trim();
+            if (!line || line.startsWith('#'))
+                continue;
+            const eqIndex = line.indexOf('=');
+            if (eqIndex === -1)
+                continue;
+            const key = line.slice(0, eqIndex).trim();
+            let value = line.slice(eqIndex + 1).trim();
+            // Strip surrounding quotes
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (key && value) {
+                vars.set(key, value);
+            }
+        }
+    }
+    catch {
+        // File doesn't exist or can't be read — skip silently
+    }
+    return vars;
+}
+// ─── Find Key By Aliases ────────────────────────────────────
+function findByAliases(envMap, aliases) {
+    for (const alias of aliases) {
+        const value = envMap.get(alias);
+        if (value)
+            return value;
+    }
+    return null;
+}
+// ─── Detect Framework ───────────────────────────────────────
+function detectFramework(cwd) {
+    let framework = 'unknown';
+    let hasSupabaseInstalled = false;
+    try {
+        const pkgPath = path.join(cwd, 'package.json');
+        const content = fs.readFileSync(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if ('next' in allDeps) {
+            framework = 'nextjs';
+        }
+        else if ('vite' in allDeps) {
+            framework = 'vite';
+        }
+        if ('@supabase/supabase-js' in allDeps) {
+            hasSupabaseInstalled = true;
+        }
+    }
+    catch {
+        // No package.json or parse error — defaults are fine
+    }
+    return { framework, hasSupabaseInstalled };
+}
+// ─── Main Scanner ───────────────────────────────────────────
+export async function scanProject(cwd) {
+    // Merge all env files (earlier files win)
+    const mergedEnv = new Map();
+    let foundInFile = null;
+    // Read in reverse so earlier files overwrite later ones
+    for (const file of [...ENV_FILES].reverse()) {
+        const filePath = path.join(cwd, file);
+        const vars = parseEnvFile(filePath);
+        for (const [key, value] of vars) {
+            mergedEnv.set(key, value);
+        }
+        if (vars.size > 0 && !foundInFile) {
+            foundInFile = file;
+        }
+    }
+    // Re-check which file had the first match (priority order)
+    for (const file of ENV_FILES) {
+        const filePath = path.join(cwd, file);
+        const vars = parseEnvFile(filePath);
+        if (vars.size > 0) {
+            foundInFile = file;
+            break;
+        }
+    }
+    const supabaseUrl = findByAliases(mergedEnv, SUPABASE_URL_ALIASES);
+    const serviceRoleKey = findByAliases(mergedEnv, SERVICE_ROLE_KEY_ALIASES);
+    const anonKey = findByAliases(mergedEnv, ANON_KEY_ALIASES);
+    const { framework, hasSupabaseInstalled } = detectFramework(cwd);
+    // Log found credentials
+    if (supabaseUrl) {
+        logSuccess(`SUPABASE_URL = ${maskCredential(supabaseUrl)}`);
+    }
+    else {
+        logError('missing SUPABASE_URL');
+    }
+    if (serviceRoleKey) {
+        logSuccess(`SUPABASE_SERVICE_ROLE_KEY = ${maskCredential(serviceRoleKey)}`);
+    }
+    else {
+        logError('missing SUPABASE_SERVICE_ROLE_KEY');
+    }
+    if (anonKey) {
+        logSuccess(`SUPABASE_ANON_KEY = ${maskCredential(anonKey)}`);
+    }
+    if (foundInFile) {
+        logSuccess(`found credentials in ${foundInFile}`);
+    }
+    return {
+        supabaseUrl,
+        serviceRoleKey,
+        anonKey,
+        framework,
+        hasSupabaseInstalled,
+        foundInFile,
+    };
+}
+// ─── Prompt for Missing Credentials ─────────────────────────
+export async function promptForMissing(scan) {
+    let supabaseUrl = scan.supabaseUrl;
+    let serviceRoleKey = scan.serviceRoleKey;
+    if (!supabaseUrl) {
+        const value = await clack.text({
+            message: 'Enter your SUPABASE_URL',
+            placeholder: 'https://your-project.supabase.co',
+            validate: (input) => {
+                const result = SupabaseUrlSchema.safeParse(input);
+                if (!result.success) {
+                    return result.error.issues[0]?.message ?? 'Invalid URL';
+                }
+                return undefined;
+            },
+        });
+        if (clack.isCancel(value)) {
+            process.exit(0);
+        }
+        supabaseUrl = value;
+    }
+    if (!serviceRoleKey) {
+        const value = await clack.text({
+            message: 'Enter your SUPABASE_SERVICE_ROLE_KEY',
+            placeholder: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
+            validate: (input) => {
+                const result = ServiceRoleKeySchema.safeParse(input);
+                if (!result.success) {
+                    return result.error.issues[0]?.message ?? 'Invalid key';
+                }
+                return undefined;
+            },
+        });
+        if (clack.isCancel(value)) {
+            process.exit(0);
+        }
+        serviceRoleKey = value;
+    }
+    return {
+        supabaseUrl: SupabaseUrlSchema.parse(supabaseUrl),
+        serviceRoleKey: ServiceRoleKeySchema.parse(serviceRoleKey),
+    };
+}
+//# sourceMappingURL=scanner.js.map

package/dist/wizard/scanner.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "archer-wizard",
+  "version": "0.1.0",
+  "description": "event intelligence layer for AI agents",
+  "type": "module",
+  "bin": {
+    "archer-wizard": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "dev:mcp": "tsx src/index.ts --mcp",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@supabase/supabase-js": "^2.99.1",
+    "@clack/prompts": "^1.1.0",
+    "picocolors": "^1.1.1",
+    "dotenv": "^17.3.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "tsx": "^4.21.0",
+    "@types/node": "^25.5.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+
+// ─── Mode Detection ─────────────────────────────────────────
+
+const isMcpMode = process.argv.includes('--mcp');
+
+if (isMcpMode) {
+  // ─── MCP Server Mode ─────────────────────────────────────
+  const { Server } = await import('@modelcontextprotocol/sdk/server/index.js');
+  const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+  const {
+    CallToolRequestSchema,
+    ListToolsRequestSchema,
+  } = await import('@modelcontextprotocol/sdk/types.js');
+  const { executeWatch, WATCH_TOOL_SCHEMA } = await import('./tools/watch.js');
+  const { stderrReady, stderrError } = await import('./lib/ascii.js');
+
+  const server = new Server(
+    {
+      name: 'archer',
+      version: '0.1.0',
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    },
+  );
+
+  // Register tool listing
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+      tools: [WATCH_TOOL_SCHEMA],
+    };
+  });
+
+  // Register tool execution
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    if (name === 'archer_watch') {
+      const result = executeWatch(args);
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    }
+
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: `unknown tool: ${name}` }),
+        },
+      ],
+      isError: true,
+    };
+  });
+
+  // Start server
+  try {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    stderrReady('archer MCP server running on stdio');
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    stderrError(`failed to start MCP server: ${message}`);
+    process.exit(1);
+  }
+} else {
+  // ─── Wizard Mode ─────────────────────────────────────────
+  const { runWizard } = await import('./wizard/index.js');
+
+  try {
+    await runWizard();
+  } catch (err) {
+    if (err instanceof Error && err.message.includes('cancel')) {
+      console.log('\n  cancelled.\n');
+      process.exit(0);
+    }
+    console.error(err);
+    process.exit(1);
+  }
+}

package/src/lib/ascii.ts

@@ -0,0 +1,109 @@
+import pc from 'picocolors';
+
+// ─── ASCII Art ──────────────────────────────────────────────
+
+export function showAsciiArt(): void {
+  const lines = [
+    '█████╗ ██████╗  ██████╗██╗  ██╗███████╗██████╗ ',
+    '██╔══██╗██╔══██╗██╔════╝██║  ██║██╔════╝██╔══██╗',
+    '███████║██████╔╝██║     ███████║█████╗  ██████╔╝',
+    '██╔══██║██╔══██╗██║     ██╔══██║██╔══╝  ██╔══██╗',
+    '██║  ██║██║  ██║╚██████╗██║  ██║███████╗██║  ██║',
+    '╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝',
+  ];
+
+  // Column boundaries for coloring:
+  // A: cols 0-5, R: 6-13, C: 14-21, H: 22-29, E: 30-37, R: 38-45
+  // ARCH = white, ER = green
+  const archEnd = 30; // columns 0-29 are A R C H
+  const erEnd = 46;   // columns 30-45 are E R
+
+  for (const line of lines) {
+    const archPart = line.slice(0, archEnd);
+    const erPart = line.slice(archEnd, erEnd);
+    const rest = line.slice(erEnd);
+    process.stdout.write(pc.white(archPart) + pc.green(erPart) + rest + '\n');
+  }
+
+  console.log();
+  console.log(pc.dim('  v0.1.0  ·  event intelligence for AI agents'));
+  console.log();
+}
+
+// ─── Status Logger ──────────────────────────────────────────
+
+export function logAction(message: string): void {
+  console.log(`${pc.blue('◆')}  ${message}`);
+}
+
+export function logSuccess(message: string): void {
+  console.log(`${pc.green('✓')}  ${message}`);
+}
+
+export function logError(message: string): void {
+  console.log(`${pc.red('✗')}  ${message}`);
+}
+
+export function logProgress(message: string): void {
+  console.log(`${pc.white('●')}  ${message}`);
+}
+
+export function logReady(message: string): void {
+  console.log(`${pc.green('▶')}  ${message}`);
+}
+
+// ─── Credential Masking ─────────────────────────────────────
+
+export function maskCredential(value: string): string {
+  if (value.length <= 8) {
+    return value.slice(0, 3) + '******';
+  }
+  return value.slice(0, 8) + '******';
+}
+
+// ─── Success Box ────────────────────────────────────────────
+
+export function showSuccessBox(agentCount: number): void {
+  const lines = [
+    '',
+    `   ${pc.green('▶')}  Archer is ready`,
+    '',
+    `   injected into ${agentCount} agent${agentCount !== 1 ? 's' : ''}`,
+    '   connected to your Supabase project',
+    '',
+    '   open your AI agent and say:',
+    `   ${pc.dim('"watch my users table for new signups"')}`,
+    '',
+  ];
+
+  const maxLen = 46;
+  console.log(`  ┌${'─'.repeat(maxLen)}┐`);
+  for (const line of lines) {
+    const stripped = line.replace(/\x1b\[[0-9;]*m/g, '');
+    const padding = maxLen - stripped.length;
+    console.log(`  │${line}${' '.repeat(Math.max(0, padding))}│`);
+  }
+  console.log(`  └${'─'.repeat(maxLen)}┘`);
+}
+
+// ─── Stderr Logger (for MCP mode) ───────────────────────────
+
+export function stderrLog(message: string): void {
+  process.stderr.write(`${message}\n`);
+}
+
+export function stderrAction(message: string): void {
+  process.stderr.write(`${pc.blue('◆')}  ${message}\n`);
+}
+
+export function stderrSuccess(message: string): void {
+  process.stderr.write(`${pc.green('✓')}  ${message}\n`);
+}
+
+export function stderrError(message: string): void {
+  process.stderr.write(`${pc.red('✗')}  ${message}\n`);
+}
+
+export function stderrReady(message: string): void {
+  process.stderr.write(`${pc.green('▶')}  ${message}\n`);
+}

package/src/lib/supabase.ts

@@ -0,0 +1,78 @@
+import { createClient, type SupabaseClient, type RealtimeChannel } from '@supabase/supabase-js';
+import { stderrError } from './ascii.js';
+import type { PostgresEvent } from '../types/index.js';
+
+// ─── Env Validation ─────────────────────────────────────────
+
+function getEnvVar(name: string): string {
+  const value = process.env[name];
+  if (!value) {
+    stderrError(`missing required env var: ${name}`);
+    throw new Error(`Missing env var: ${name}`);
+  }
+  return value;
+}
+
+// ─── Supabase Client ────────────────────────────────────────
+
+let _client: SupabaseClient | null = null;
+
+export function getSupabaseClient(): SupabaseClient {
+  if (_client) return _client;
+
+  const url = getEnvVar('SUPABASE_URL');
+  const key = getEnvVar('SUPABASE_SERVICE_ROLE_KEY');
+
+  _client = createClient(url, key, {
+    auth: {
+      autoRefreshToken: false,
+      persistSession: false,
+    },
+  });
+
+  return _client;
+}
+
+// ─── Realtime Channel Helpers ───────────────────────────────
+
+export function createAuthChannel(
+  channelName: string,
+  onEvent: (payload: Record<string, unknown>) => void,
+): RealtimeChannel {
+  const client = getSupabaseClient();
+
+  const channel = client
+    .channel(channelName)
+    .on('postgres_changes', { event: 'INSERT', schema: 'auth', table: 'users' }, (payload) => {
+      onEvent(payload.new as Record<string, unknown>);
+    })
+    .subscribe();
+
+  return channel;
+}
+
+export function createTableChannel(
+  channelName: string,
+  table: string,
+  event: PostgresEvent,
+  onEvent: (payload: Record<string, unknown>) => void,
+): RealtimeChannel {
+  const client = getSupabaseClient();
+
+  const channel = client
+    .channel(channelName)
+    .on('postgres_changes', { event, schema: 'public', table }, (payload) => {
+      const data = event === 'DELETE' ? payload.old : payload.new;
+      onEvent(data as Record<string, unknown>);
+    })
+    .subscribe();
+
+  return channel;
+}
+
+// ─── Cleanup ────────────────────────────────────────────────
+
+export async function removeChannel(channel: RealtimeChannel): Promise<void> {
+  const client = getSupabaseClient();
+  await client.removeChannel(channel);
+}