archer-wizard 0.1.1 → 0.2.0

package/dist/tools/watches.js

@@ -0,0 +1,33 @@
+import { sendCommand } from '../daemon/client.js';
+// ─── Execute List Watches (via daemon IPC) ──────────────────
+export async function executeListWatches() {
+    try {
+        const res = await sendCommand({ type: 'list_watches' });
+        if (!res.ok) {
+            return `❌ Failed to list watches: ${res.error}`;
+        }
+        if (res.type !== 'watch_list') {
+            return `❌ Unexpected response type: ${res.type}`;
+        }
+        if (res.watches.length === 0) {
+            return '📭 No active watches.';
+        }
+        const lines = [`📋 Active watches (${res.watches.length}):\n`];
+        for (const w of res.watches) {
+            lines.push(`  🔹 ${w.id}`);
+            lines.push(`     table: ${w.table}`);
+            lines.push(`     event: ${w.event}`);
+            if (w.filter)
+                lines.push(`     filter: ${w.filter}`);
+            if (w.webhookUrl)
+                lines.push(`     webhook: ${w.webhookUrl}`);
+            lines.push(`     created: ${w.createdAt}`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    catch (err) {
+        return `❌ Daemon error: ${err instanceof Error ? err.message : String(err)}\n\nIs the archer daemon running?`;
+    }
+}
+//# sourceMappingURL=watches.js.map

package/dist/tools/watches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watches.js","sourceRoot":"","sources":["../../src/tools/watches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,6BAA6B,GAAG,CAAC,KAAK,EAAE,CAAC;QAClD,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC9B,OAAO,+BAA+B,GAAG,CAAC,IAAI,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,sBAAsB,GAAG,CAAC,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;QAE/D,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC;IAChH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archer-wizard",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "event intelligence layer for AI agents",
   "type": "module",
   "bin": {
@@ -11,6 +11,7 @@
     "build": "tsc",
     "dev": "tsx src/index.ts",
     "dev:mcp": "tsx src/index.ts --mcp",
+    "dev:daemon": "tsx src/index.ts --daemon",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {

package/src/daemon/client.ts

@@ -0,0 +1,50 @@
+import net from 'node:net';
+import { DAEMON_PORT, DAEMON_HOST } from './types.js';
+import type { IpcRequest, IpcResponse } from './types.js';
+
+// ─── Send Command to Daemon ─────────────────────────────────
+
+export function sendCommand(req: IpcRequest): Promise<IpcResponse> {
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection({ host: DAEMON_HOST, port: DAEMON_PORT }, () => {
+      socket.write(JSON.stringify(req) + '\n');
+    });
+
+    let buffer = '';
+
+    socket.on('data', (data) => {
+      buffer += data.toString();
+      const newlineIdx = buffer.indexOf('\n');
+      if (newlineIdx !== -1) {
+        const line = buffer.slice(0, newlineIdx).trim();
+        socket.end();
+        try {
+          resolve(JSON.parse(line) as IpcResponse);
+        } catch (err) {
+          reject(new Error(`invalid daemon response: ${line}`));
+        }
+      }
+    });
+
+    socket.on('error', (err) => {
+      reject(new Error(`daemon connection failed: ${err.message}`));
+    });
+
+    // Timeout after 5 seconds
+    socket.setTimeout(5_000, () => {
+      socket.destroy();
+      reject(new Error('daemon response timeout'));
+    });
+  });
+}
+
+// ─── Check if Daemon is Running ─────────────────────────────
+
+export async function isDaemonRunning(): Promise<boolean> {
+  try {
+    const res = await sendCommand({ type: 'ping' });
+    return res.ok && res.type === 'pong';
+  } catch {
+    return false;
+  }
+}

package/src/daemon/lifecycle.ts

@@ -0,0 +1,126 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PID_FILE, ARCHER_DIR, LOG_FILE } from './types.js';
+import { isDaemonRunning } from './client.js';
+
+// ─── Start Daemon ───────────────────────────────────────────
+
+export async function startDaemon(): Promise<{ pid: number; alreadyRunning: boolean }> {
+  // Check if already running
+  if (await isDaemonRunning()) {
+    const pid = readPid();
+    return { pid: pid ?? 0, alreadyRunning: true };
+  }
+
+  // Ensure directory exists
+  if (!fs.existsSync(ARCHER_DIR)) {
+    fs.mkdirSync(ARCHER_DIR, { recursive: true });
+  }
+
+  // Resolve the daemon entry script
+  // In compiled mode this is dist/daemon/process.js
+  // In dev mode with tsx this is src/daemon/process.ts
+  const thisFile = fileURLToPath(import.meta.url);
+  const thisDir = path.dirname(thisFile);
+  
+  // Look for the daemon runner script
+  const daemonRunner = path.join(thisDir, 'run.js');
+  const daemonRunnerTs = path.join(thisDir, 'run.ts');
+  
+  let cmd: string;
+  let args: string[];
+
+  if (fs.existsSync(daemonRunner)) {
+    // Compiled mode
+    cmd = process.execPath; // node
+    args = [daemonRunner];
+  } else if (fs.existsSync(daemonRunnerTs)) {
+    // Dev mode — use tsx
+    cmd = 'npx';
+    args = ['tsx', daemonRunnerTs];
+  } else {
+    // Fallback: assume we're in dist/ and run process.js directly
+    const processJs = path.join(thisDir, 'process.js');
+    cmd = process.execPath;
+    args = [processJs, '--run-daemon'];
+  }
+
+  // Open log file for daemon output
+  const logFd = fs.openSync(LOG_FILE, 'a');
+
+  const child = spawn(cmd, args, {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    env: { ...process.env },
+  });
+
+  child.unref();
+  fs.closeSync(logFd);
+
+  const pid = child.pid ?? 0;
+
+  // Wait briefly for daemon to start, then verify
+  await sleep(500);
+  
+  const running = await isDaemonRunning();
+  if (!running) {
+    // Give it another moment
+    await sleep(1000);
+  }
+
+  return { pid, alreadyRunning: false };
+}
+
+// ─── Stop Daemon ────────────────────────────────────────────
+
+export async function stopDaemon(): Promise<boolean> {
+  const pid = readPid();
+  if (pid === null) return false;
+
+  try {
+    process.kill(pid, 'SIGTERM');
+    // Wait for it to die
+    await sleep(500);
+    return true;
+  } catch {
+    // Process already dead — clean up PID file
+    try { fs.unlinkSync(PID_FILE); } catch {}
+    return false;
+  }
+}
+
+// ─── Ensure Daemon is Running ───────────────────────────────
+
+export async function ensureDaemon(): Promise<{ pid: number }> {
+  const result = await startDaemon();
+  return { pid: result.pid };
+}
+
+// ─── Helpers ────────────────────────────────────────────────
+
+function readPid(): number | null {
+  try {
+    if (!fs.existsSync(PID_FILE)) return null;
+    const raw = fs.readFileSync(PID_FILE, 'utf-8').trim();
+    const pid = parseInt(raw, 10);
+    if (isNaN(pid)) return null;
+
+    // Check if process is alive
+    try {
+      process.kill(pid, 0); // Signal 0 = existence check
+      return pid;
+    } catch {
+      // Process is dead — clean up stale PID
+      try { fs.unlinkSync(PID_FILE); } catch {}
+      return null;
+    }
+  } catch {
+    return null;
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/src/daemon/process.ts

@@ -0,0 +1,207 @@
+import net from 'node:net';
+import { createClient, type RealtimeChannel, type SupabaseClient } from '@supabase/supabase-js';
+import { DAEMON_PORT, DAEMON_HOST, PID_FILE, ARCHER_DIR, LOG_FILE } from './types.js';
+import type { IpcRequest, IpcResponse, WatchConfig } from './types.js';
+import { loadWatches, addWatch, removeWatch } from './store.js';
+import fs from 'node:fs';
+
+// ─── Simple webhook delivery for daemon context ─────────────
+
+async function deliverWebhook(url: string, payload: unknown): Promise<void> {
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'User-Agent': 'Archer/0.2.0',
+    },
+    body: JSON.stringify(payload),
+  });
+  if (!res.ok) {
+    throw new Error(`webhook ${res.status} ${res.statusText}`);
+  }
+}
+
+// ─── Active Channel Registry ────────────────────────────────
+
+const channels = new Map<string, { client: SupabaseClient; channel: RealtimeChannel }>();
+
+// ─── Subscribe to a Watch ───────────────────────────────────
+
+function subscribe(watch: WatchConfig): void {
+  // Skip if already subscribed
+  if (channels.has(watch.id)) return;
+
+  const client = createClient(watch.supabaseUrl, watch.supabaseKey);
+
+  const channelName = `daemon-${watch.table}-${watch.id}`;
+  const channel = client
+    .channel(channelName)
+    .on(
+      'postgres_changes',
+      {
+        event: watch.event,
+        schema: 'public',
+        table: watch.table,
+        ...(watch.filter ? { filter: watch.filter } : {}),
+      },
+      async (payload) => {
+        log(`[event] ${watch.table} ${payload.eventType} → watch ${watch.id}`);
+
+        if (watch.webhookUrl) {
+          try {
+            await deliverWebhook(watch.webhookUrl, payload);
+            log(`[webhook] delivered to ${watch.webhookUrl}`);
+          } catch (err) {
+            log(`[webhook] failed: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+      },
+    )
+    .subscribe((status) => {
+      log(`[channel] ${channelName} → ${status}`);
+    });
+
+  channels.set(watch.id, { client, channel });
+}
+
+// ─── Unsubscribe from a Watch ───────────────────────────────
+
+async function unsubscribe(watchId: string): Promise<void> {
+  const entry = channels.get(watchId);
+  if (!entry) return;
+
+  await entry.client.removeChannel(entry.channel);
+  channels.delete(watchId);
+}
+
+// ─── Handle IPC Command ─────────────────────────────────────
+
+async function handleCommand(req: IpcRequest): Promise<IpcResponse> {
+  switch (req.type) {
+    case 'add_watch': {
+      const watches = addWatch(req.watch);
+      subscribe(req.watch);
+      return { ok: true, type: 'watch_added', watchId: req.watch.id };
+    }
+
+    case 'remove_watch': {
+      const { watches, removed } = removeWatch(req.watchId);
+      if (!removed) {
+        return { ok: false, error: `watch ${req.watchId} not found` };
+      }
+      await unsubscribe(req.watchId);
+      return { ok: true, type: 'watch_removed', watchId: req.watchId };
+    }
+
+    case 'list_watches': {
+      const watches = loadWatches();
+      return { ok: true, type: 'watch_list', watches };
+    }
+
+    case 'ping': {
+      return { ok: true, type: 'pong' };
+    }
+
+    default:
+      return { ok: false, error: 'unknown command' };
+  }
+}
+
+// ─── Logging ────────────────────────────────────────────────
+
+function log(message: string): void {
+  const ts = new Date().toISOString();
+  const line = `[${ts}] ${message}\n`;
+  try {
+    fs.appendFileSync(LOG_FILE, line);
+  } catch {
+    // If we can't write to log, just continue
+  }
+}
+
+// ─── Main: Start TCP Server ─────────────────────────────────
+
+export function startDaemonProcess(): void {
+  // Ensure directory exists
+  if (!fs.existsSync(ARCHER_DIR)) {
+    fs.mkdirSync(ARCHER_DIR, { recursive: true });
+  }
+
+  // Write PID file
+  fs.writeFileSync(PID_FILE, String(process.pid), 'utf-8');
+
+  log('daemon starting');
+
+  // Re-subscribe all persisted watches
+  const watches = loadWatches();
+  for (const watch of watches) {
+    subscribe(watch);
+    log(`[restore] re-subscribed watch ${watch.id} on ${watch.table}`);
+  }
+  log(`restored ${watches.length} watch(es)`);
+
+  // Create TCP server
+  const server = net.createServer((socket) => {
+    let buffer = '';
+
+    socket.on('data', async (data) => {
+      buffer += data.toString();
+
+      // Process complete JSON lines
+      let newlineIdx: number;
+      while ((newlineIdx = buffer.indexOf('\n')) !== -1) {
+        const line = buffer.slice(0, newlineIdx).trim();
+        buffer = buffer.slice(newlineIdx + 1);
+
+        if (!line) continue;
+
+        try {
+          const req = JSON.parse(line) as IpcRequest;
+          const res = await handleCommand(req);
+          socket.write(JSON.stringify(res) + '\n');
+        } catch (err) {
+          const errRes: IpcResponse = {
+            ok: false,
+            error: `parse error: ${err instanceof Error ? err.message : String(err)}`,
+          };
+          socket.write(JSON.stringify(errRes) + '\n');
+        }
+      }
+    });
+
+    socket.on('error', (err) => {
+      log(`[socket] error: ${err.message}`);
+    });
+  });
+
+  server.listen(DAEMON_PORT, DAEMON_HOST, () => {
+    log(`daemon listening on ${DAEMON_HOST}:${DAEMON_PORT} (pid ${process.pid})`);
+  });
+
+  server.on('error', (err) => {
+    log(`[server] error: ${err.message}`);
+    process.exit(1);
+  });
+
+  // Clean shutdown
+  const shutdown = () => {
+    log('daemon shutting down');
+    server.close();
+
+    // Unsubscribe all channels
+    for (const [id, entry] of channels) {
+      entry.client.removeChannel(entry.channel).catch(() => {});
+    }
+    channels.clear();
+
+    // Remove PID file
+    try {
+      fs.unlinkSync(PID_FILE);
+    } catch {}
+
+    process.exit(0);
+  };
+
+  process.on('SIGTERM', shutdown);
+  process.on('SIGINT', shutdown);
+}

package/src/daemon/run.ts

@@ -0,0 +1,6 @@
+// Daemon runner — this file is the entry point for the detached daemon process.
+// It gets spawned by lifecycle.ts and runs startDaemonProcess().
+
+import { startDaemonProcess } from './process.js';
+
+startDaemonProcess();

package/src/daemon/store.ts

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { ARCHER_DIR, STATE_FILE } from './types.js';
+import type { WatchConfig } from './types.js';
+
+// ─── Ensure Directory ───────────────────────────────────────
+
+function ensureDir(): void {
+  if (!fs.existsSync(ARCHER_DIR)) {
+    fs.mkdirSync(ARCHER_DIR, { recursive: true });
+  }
+}
+
+// ─── Load Watches ───────────────────────────────────────────
+
+export function loadWatches(): WatchConfig[] {
+  try {
+    if (!fs.existsSync(STATE_FILE)) return [];
+    const raw = fs.readFileSync(STATE_FILE, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed as WatchConfig[];
+  } catch {
+    return [];
+  }
+}
+
+// ─── Save Watches (atomic write) ────────────────────────────
+
+export function saveWatches(watches: WatchConfig[]): void {
+  ensureDir();
+  const tmp = STATE_FILE + '.tmp';
+  fs.writeFileSync(tmp, JSON.stringify(watches, null, 2) + '\n', 'utf-8');
+  fs.renameSync(tmp, STATE_FILE);
+}
+
+// ─── Add Watch ──────────────────────────────────────────────
+
+export function addWatch(watch: WatchConfig): WatchConfig[] {
+  const watches = loadWatches();
+  // Replace if same ID exists
+  const idx = watches.findIndex((w) => w.id === watch.id);
+  if (idx >= 0) {
+    watches[idx] = watch;
+  } else {
+    watches.push(watch);
+  }
+  saveWatches(watches);
+  return watches;
+}
+
+// ─── Remove Watch ───────────────────────────────────────────
+
+export function removeWatch(watchId: string): { watches: WatchConfig[]; removed: boolean } {
+  const watches = loadWatches();
+  const before = watches.length;
+  const filtered = watches.filter((w) => w.id !== watchId);
+  saveWatches(filtered);
+  return { watches: filtered, removed: filtered.length < before };
+}

package/src/daemon/types.ts

@@ -0,0 +1,41 @@
+// ─── Daemon Configuration ───────────────────────────────────
+
+import path from 'node:path';
+import os from 'node:os';
+
+export const DAEMON_PORT = 7481;
+export const DAEMON_HOST = '127.0.0.1';
+export const ARCHER_DIR = path.join(os.homedir(), '.archer');
+export const STATE_FILE = path.join(ARCHER_DIR, 'state.json');
+export const PID_FILE = path.join(ARCHER_DIR, 'daemon.pid');
+export const LOG_FILE = path.join(ARCHER_DIR, 'daemon.log');
+
+// ─── Watch State ────────────────────────────────────────────
+
+export interface WatchConfig {
+  id: string;
+  table: string;
+  event: 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+  filter?: string;
+  webhookUrl?: string;
+  createdAt: string;           // ISO timestamp
+  supabaseUrl: string;         // needed to re-subscribe
+  supabaseKey: string;         // service role key
+}
+
+// ─── IPC Protocol ───────────────────────────────────────────
+// JSON lines over TCP. Each message is JSON + '\n'.
+// Client sends a Request, daemon responds with a Response.
+
+export type IpcRequest =
+  | { type: 'add_watch'; watch: WatchConfig }
+  | { type: 'remove_watch'; watchId: string }
+  | { type: 'list_watches' }
+  | { type: 'ping' };
+
+export type IpcResponse =
+  | { ok: true; type: 'watch_added'; watchId: string }
+  | { ok: true; type: 'watch_removed'; watchId: string }
+  | { ok: true; type: 'watch_list'; watches: WatchConfig[] }
+  | { ok: true; type: 'pong' }
+  | { ok: false; error: string };