@fdcn/sourcefed 0.2.1 → 0.2.3

package/dist/cli.js

@@ -1,10 +1,8 @@
 #!/usr/bin/env node
 
 // packages/cli/src/index.ts
-import os7 from "node:os";
 import { realpathSync } from "node:fs";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // packages/daemon/dist/index.js
 import { link, mkdir, open, readFile, rename, rm, writeFile } from "node:fs/promises";
@@ -116,9 +114,9 @@ function _isValidObjectKey(object$1, key) {
 }
 // @__NO_SIDE_EFFECTS__
 function _joinExpects(values$1, separator) {
-  const list = [...new Set(values$1)];
-  if (list.length > 1) return `(${list.join(` ${separator} `)})`;
-  return list[0] ?? "never";
+  const list2 = [...new Set(values$1)];
+  if (list2.length > 1) return `(${list2.join(` ${separator} `)})`;
+  return list2[0] ?? "never";
 }
 var EMOJI_REGEX = new RegExp("^(?:[\\u{1F1E6}-\\u{1F1FF}]{2}|\\u{1F3F4}[\\u{E0061}-\\u{E007A}]{2}[\\u{E0030}-\\u{E0039}\\u{E0061}-\\u{E007A}]{1,3}\\u{E007F}|(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|(?![\\p{Emoji_Modifier_Base}\\u{1F1E6}-\\u{1F1FF}])\\p{Emoji_Presentation})(?:\\u200D(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|(?![\\p{Emoji_Modifier_Base}\\u{1F1E6}-\\u{1F1FF}])\\p{Emoji_Presentation}))*)+$", "u");
 // @__NO_SIDE_EFFECTS__
@@ -566,6 +564,11 @@ var MonitorService = class {
     return this.transact((registry2) => {
       const monitor = registry2.monitors.find((entry) => entry.id === id);
       if (!monitor) return { error: `monitor ${id} was not found` };
+      const identity = monitorIdentity(monitor.target, monitor.source);
+      const duplicate = registry2.monitors.find(
+        (entry) => entry.id !== id && entry.enabled && monitorIdentity(entry.target, entry.source) === identity
+      );
+      if (duplicate) return { error: `monitor ${id} duplicates active monitor ${duplicate.id} for the same source` };
       monitor.enabled = true;
       monitor.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
       return monitor;
@@ -912,31 +915,31 @@ var JsonMonitorEventQueue = class {
   eventsFile;
   queue = Promise.resolve();
   async enqueue(input) {
-    return this.transact((events) => {
+    return this.transact((events2) => {
       const queued = createQueuedMonitorEvent(input.monitor, input.event);
-      const existing = events.find((event) => event.id === queued.id);
+      const existing = events2.find((event) => event.id === queued.id);
       if (existing) return existing;
-      events.push(queued);
+      events2.push(queued);
       return queued;
     });
   }
   async read(target) {
-    const events = await this.loadEvents();
-    return events.filter((event) => sameTarget2(event.target, target));
+    const events2 = await this.loadEvents();
+    return events2.filter((event) => sameTarget2(event.target, target));
   }
   async acknowledge(target, eventIDs) {
-    await this.transact((events) => {
+    await this.transact((events2) => {
       const ids = new Set(eventIDs);
-      for (let index = events.length - 1; index >= 0; index -= 1) {
-        if (sameTarget2(events[index].target, target) && ids.has(events[index].id)) events.splice(index, 1);
+      for (let index = events2.length - 1; index >= 0; index -= 1) {
+        if (sameTarget2(events2[index].target, target) && ids.has(events2[index].id)) events2.splice(index, 1);
       }
     });
   }
   async transact(operation) {
     const next = this.queue.then(async () => {
-      const events = await this.loadEvents();
-      const result = await operation(events);
-      await this.saveEvents(events);
+      const events2 = await this.loadEvents();
+      const result = await operation(events2);
+      await this.saveEvents(events2);
       return result;
     });
     this.queue = next.then(() => void 0, () => void 0);
@@ -953,10 +956,10 @@ var JsonMonitorEventQueue = class {
       throw error2;
     }
   }
-  async saveEvents(events) {
+  async saveEvents(events2) {
     await mkdir(this.stateDir, { recursive: true, mode: 448 });
     const temporary = `${this.eventsFile}.${process.pid}.tmp`;
-    await writeFile(temporary, `${JSON.stringify(events, null, 2)}
+    await writeFile(temporary, `${JSON.stringify(events2, null, 2)}
 `, { mode: 384 });
     await rename(temporary, this.eventsFile);
   }
@@ -2148,7 +2151,7 @@ async function confirmStillFailing(repo, prNumber, failed) {
     return /FAIL|ERROR|CANCEL/i.test(state);
   });
 }
-async function appendGithubCiEvent(repo, prNumber, cursor, events, rollup) {
+async function appendGithubCiEvent(repo, prNumber, cursor, events2, rollup) {
   const ciState = rollup.map((check) => check.conclusion ?? check.state ?? "PENDING").sort().join(",");
   if (!ciState || ciState === cursor.ciState) return;
   const previousCiState = cursor.ciState;
@@ -2159,7 +2162,7 @@ async function appendGithubCiEvent(repo, prNumber, cursor, events, rollup) {
   const failureState = failed.map((check) => `${check.name ?? check.context ?? "check"}:${check.conclusion ?? check.state ?? "FAILURE"}`).sort().join(",");
   if (failed.length > 0 && failureState !== cursor.ciFailureState) {
     const names = failed.map((check) => check.name ?? check.context ?? "check").join(", ");
-    events.push({
+    events2.push({
       kind: "ci",
       id: `ci:${failureState}`,
       repo,
@@ -2172,13 +2175,13 @@ async function appendGithubCiEvent(repo, prNumber, cursor, events, rollup) {
   }
   cursor.ciFailureState = failureState;
 }
-function appendGithubConflictEvent(repo, prNumber, cursor, events, mergeable) {
+function appendGithubConflictEvent(repo, prNumber, cursor, events2, mergeable) {
   if (mergeable === cursor.mergeable) return;
   const previousMergeable = cursor.mergeable;
   cursor.mergeable = mergeable;
   if (previousMergeable === void 0) return;
   if (mergeable !== "CONFLICTING" && mergeable !== "DIRTY") return;
-  events.push({
+  events2.push({
     kind: "conflict",
     id: `conflict:${mergeable}`,
     repo,
@@ -2188,7 +2191,7 @@ function appendGithubConflictEvent(repo, prNumber, cursor, events, mergeable) {
     actionable: true
   });
 }
-function appendGithubReviews(repo, prNumber, cursor, events, reviews, historyPrimed) {
+function appendGithubReviews(repo, prNumber, cursor, events2, reviews, historyPrimed) {
   const ref = `#${prNumber}`;
   for (const review of reviews) {
     const id = "rev:" + String(review.id ?? `${review.author?.login}-${review.submittedAt}`);
@@ -2199,7 +2202,7 @@ function appendGithubReviews(repo, prNumber, cursor, events, reviews, historyPri
     let actionable = false;
     if (review.state === "CHANGES_REQUESTED") actionable = true;
     if (review.state === "COMMENTED" && review.body?.trim()) actionable = true;
-    events.push({
+    events2.push({
       kind: "review",
       id,
       repo,
@@ -2211,7 +2214,7 @@ function appendGithubReviews(repo, prNumber, cursor, events, reviews, historyPri
     });
   }
 }
-function appendGithubStateEvent(repo, prNumber, cursor, events, prState) {
+function appendGithubStateEvent(repo, prNumber, cursor, events2, prState) {
   const isTerminal = prState === "MERGED" || prState === "CLOSED";
   if (prState === cursor.prState) return isTerminal;
   const previousPrState = cursor.prState;
@@ -2219,7 +2222,7 @@ function appendGithubStateEvent(repo, prNumber, cursor, events, prState) {
   if (previousPrState !== void 0 && isTerminal) {
     let summary = `PR #${prNumber} was CLOSED without merging`;
     if (prState === "MERGED") summary = `PR #${prNumber} was MERGED`;
-    events.push({
+    events2.push({
       kind: "merged",
       id: `state:${prState}`,
       repo,
@@ -2232,14 +2235,14 @@ function appendGithubStateEvent(repo, prNumber, cursor, events, prState) {
   }
   return isTerminal;
 }
-function appendComments(repo, prNumber, cursor, events, comments, idPrefix, historyPrimed, summary, body) {
+function appendComments(repo, prNumber, cursor, events2, comments, idPrefix, historyPrimed, summary, body) {
   for (const comment of comments) {
     const id = idPrefix + String(comment.id);
     if (cursor.commentIds.includes(id)) continue;
     cursor.commentIds.push(id);
     if (!historyPrimed) continue;
     const text = body(comment);
-    events.push({
+    events2.push({
       kind: "comment",
       id,
       repo,
@@ -2269,22 +2272,22 @@ async function pollGithub(repo, prNumber, cursorRaw) {
   const parsedCursor = /* @__PURE__ */ safeParse22(GithubCursorSchema, cursorRaw);
   let cursor = emptyGithubCursor();
   if (parsedCursor.success) cursor = parsedCursor.output;
-  const events = [];
+  const events2 = [];
   const ref = `#${prNumber}`;
   if (!githubToken()) {
     if (!warnedMissingToken) {
       warnedMissingToken = true;
       console.warn("[sourcefed] GH_TOKEN or GITHUB_TOKEN is not set; GitHub monitors will not poll");
     }
-    return { events, cursor, terminal: false };
+    return { events: events2, cursor, terminal: false };
   }
   const data = await fetchPrData(repo, prNumber);
-  if (!data) return { events, cursor, terminal: false };
+  if (!data) return { events: events2, cursor, terminal: false };
   let historyPrimed = cursor.historyPrimed;
   if (!historyPrimed) historyPrimed = Boolean(cursor.reviewIds.length || cursor.commentIds.length || cursor.ciState || cursor.mergeable || cursor.prState);
   const lineCommentsPrimed = cursor.lineCommentsPrimed;
   const conversationCommentsPrimed = cursor.conversationCommentsPrimed;
-  appendGithubReviews(repo, prNumber, cursor, events, data.reviews ?? [], historyPrimed);
+  appendGithubReviews(repo, prNumber, cursor, events2, data.reviews ?? [], historyPrimed);
   if (!cursor.historyPrimed) cursor.historyPrimed = true;
   const lineComments = await fetchGithubComments(`repos/${repo}/pulls/${prNumber}/comments`);
   if (lineComments) {
@@ -2292,7 +2295,7 @@ async function pollGithub(repo, prNumber, cursorRaw) {
       repo,
       prNumber,
       cursor,
-      events,
+      events2,
       lineComments,
       "c:",
       lineCommentsPrimed,
@@ -2311,7 +2314,7 @@ async function pollGithub(repo, prNumber, cursorRaw) {
       repo,
       prNumber,
       cursor,
-      events,
+      events2,
       conversationComments,
       "issue:",
       conversationCommentsPrimed,
@@ -2320,12 +2323,12 @@ async function pollGithub(repo, prNumber, cursorRaw) {
     );
     cursor.conversationCommentsPrimed = true;
   }
-  await appendGithubCiEvent(repo, prNumber, cursor, events, data.statusCheckRollup ?? []);
+  await appendGithubCiEvent(repo, prNumber, cursor, events2, data.statusCheckRollup ?? []);
   const mergeable = data.mergeable ?? data.mergeStateStatus ?? "UNKNOWN";
-  appendGithubConflictEvent(repo, prNumber, cursor, events, mergeable);
+  appendGithubConflictEvent(repo, prNumber, cursor, events2, mergeable);
   const prState = data.state ?? "OPEN";
-  const terminal = appendGithubStateEvent(repo, prNumber, cursor, events, prState);
-  return { events, cursor, terminal };
+  const terminal = appendGithubStateEvent(repo, prNumber, cursor, events2, prState);
+  return { events: events2, cursor, terminal };
 }
 var githubPollMonitor = new PollMonitor({
   run: async (source, cursor) => {
@@ -3103,11 +3106,11 @@ function jiraChangeValue(item, side) {
 function formatJiraChangelogItem(item) {
   return `${item.field}: ${jiraChangeValue(item, "from")} \u2192 ${jiraChangeValue(item, "to")}`;
 }
-function isTerminalStatus(status) {
-  if (typeof status !== "string") return false;
+function isTerminalStatus(status2) {
+  if (typeof status2 !== "string") return false;
   const terminalStatus = process.env.SOURCEFED_JIRA_TERMINAL_STATUS;
   if (!terminalStatus) return false;
-  return status.trim().toLowerCase() === terminalStatus.trim().toLowerCase();
+  return status2.trim().toLowerCase() === terminalStatus.trim().toLowerCase();
 }
 var TRACKED_CHANGE_FIELDS = /* @__PURE__ */ new Set(["summary", "status", "assignee", "priority", "labels"]);
 function meaningfulChangelogItems(items) {
@@ -3133,12 +3136,12 @@ function jiraChangelogEvent(issueKey, history) {
     terminal
   };
 }
-function appendJiraChangelog(issueKey, cursor, events, histories) {
+function appendJiraChangelog(issueKey, cursor, events2, histories) {
   const total = histories.length;
   if (cursor.changelogCount !== 0 && total > cursor.changelogCount) {
     for (const history of histories.slice(cursor.changelogCount)) {
       const event = jiraChangelogEvent(issueKey, history);
-      if (event) events.push(event);
+      if (event) events2.push(event);
     }
   }
   cursor.changelogCount = total;
@@ -3149,7 +3152,7 @@ function adfText(node) {
   if (Array.isArray(node.content)) return node.content.map(adfText).join("");
   return "";
 }
-function appendJiraComments(issueKey, cursor, events, comments) {
+function appendJiraComments(issueKey, cursor, events2, comments) {
   const freshComments = [];
   for (const comment of comments) {
     const id = Number(comment.id);
@@ -3162,7 +3165,7 @@ function appendJiraComments(issueKey, cursor, events, comments) {
   }
   for (const comment of freshComments) {
     const body = adfText(comment.body);
-    events.push({
+    events2.push({
       kind: "comment",
       id: `comment:${comment.id}`,
       issueKey,
@@ -3175,11 +3178,11 @@ function appendJiraComments(issueKey, cursor, events, comments) {
     cursor.commentIds.push(Number(comment.id));
   }
 }
-function appendJiraDescription(issueKey, cursor, events, description) {
+function appendJiraDescription(issueKey, cursor, events2, description) {
   let descriptionVersion = "none";
   if (description) descriptionVersion = JSON.stringify(description).slice(0, 40);
   if (cursor.descriptionVersion !== void 0 && descriptionVersion !== cursor.descriptionVersion) {
-    events.push({
+    events2.push({
       kind: "description",
       id: `description:${descriptionVersion}`,
       issueKey,
@@ -3213,15 +3216,15 @@ async function pollJira(issueKey, cursorRaw) {
   const parsedCursor = /* @__PURE__ */ safeParse23(JiraCursorSchema, cursorRaw);
   let cursor = emptyJiraCursor();
   if (parsedCursor.success) cursor = parsedCursor.output;
-  const events = [];
+  const events2 = [];
   const comments = await jiraFetch(`/issue/${issueKey}/comment?maxResults=50&orderBy=-created`);
-  appendJiraComments(issueKey, cursor, events, comments.comments ?? []);
+  appendJiraComments(issueKey, cursor, events2, comments.comments ?? []);
   const issue2 = await jiraFetch(`/issue/${issueKey}?expand=changelog&fields=status,description`);
   const statusName = issue2.fields?.status?.name;
-  appendJiraDescription(issueKey, cursor, events, issue2.fields?.description);
+  appendJiraDescription(issueKey, cursor, events2, issue2.fields?.description);
   const changelog = issue2.changelog?.histories ?? [];
-  appendJiraChangelog(issueKey, cursor, events, changelog);
-  return { events, cursor, terminal: isTerminalStatus(statusName) };
+  appendJiraChangelog(issueKey, cursor, events2, changelog);
+  return { events: events2, cursor, terminal: isTerminalStatus(statusName) };
 }
 var jiraPollMonitor = new PollMonitor2({
   run: async (source, cursor) => {
@@ -4135,9 +4138,9 @@ function parseSlackReadResult(result, cursorRaw) {
     if (!cursor.latestTs) return true;
     return messageTimestamp(message.ts) > messageTimestamp(cursor.latestTs);
   });
-  let events = [];
+  let events2 = [];
   if (cursor.primed) {
-    events = freshMessages.map((message) => {
+    events2 = freshMessages.map((message) => {
       let text = "[message without text]";
       if (message.text?.trim()) text = message.text.trim();
       let author = users.get(message.user);
@@ -4160,7 +4163,7 @@ function parseSlackReadResult(result, cursorRaw) {
     if (messageTimestamp(message.ts) > messageTimestamp(latestTs)) latestTs = message.ts;
   }
   cursor.latestTs = latestTs;
-  return { events, cursor };
+  return { events: events2, cursor };
 }
 var SLACK_API = "https://slack.com/api";
 var warnedMissingToken2 = false;
@@ -4351,14 +4354,17 @@ function sourceForInput(type, input) {
   return source.build(input);
 }
 function sourceForWebhookPath(pathname) {
-  const sources = Object.values(SOURCE_MAP);
-  for (const source of sources) {
+  const sources2 = Object.values(SOURCE_MAP);
+  for (const source of sources2) {
     if (source.webhook?.path === pathname) return source;
   }
   return void 0;
 }
 async function serveHttp(options) {
+  const active = /* @__PURE__ */ new Set();
   const server = createServer((incoming, outgoing) => {
+    active.add(outgoing);
+    outgoing.on("close", () => active.delete(outgoing));
     void handle(incoming, outgoing, options.handler);
   });
   server.requestTimeout = 0;
@@ -4377,6 +4383,10 @@ async function serveHttp(options) {
   return {
     port,
     async stop() {
+      for (const outgoing of active) {
+        outgoing.destroy();
+      }
+      active.clear();
       server.closeIdleConnections?.();
       await new Promise((resolve) => {
         server.close(() => resolve());
@@ -4659,10 +4669,10 @@ var SourcefedDaemon = class {
     this.observers.add(onEvent);
     return () => this.observers.delete(onEvent);
   }
-  appendLog(target, events) {
+  appendLog(target, events2) {
     const key = targetKey(target);
     const existing = this.deliveryLog.get(key) ?? [];
-    const merged = [...events.reverse(), ...existing];
+    const merged = [...events2.reverse(), ...existing];
     this.deliveryLog.set(key, merged.slice(0, DELIVERY_LOG_LIMIT));
   }
   emit(target) {
@@ -4722,9 +4732,16 @@ function monitorView(monitor) {
     label: definition.label(monitor.source),
     detail: definition.detail(monitor.source),
     describe: definition.describe(monitor.source),
-    unresponsive: definition.unresponsive(monitor)
+    unresponsive: definition.unresponsive(monitor),
+    lastPolledAt: cursorTime(monitor.cursors.__lastPolledAt ?? monitor.cursors.__lastAttemptAt),
+    webhookHeartbeatAt: cursorTime(monitor.cursors.__webhookHeartbeatAt)
   };
 }
+function cursorTime(value) {
+  const numeric = Number(value);
+  if (!Number.isFinite(numeric) || numeric <= 0) return void 0;
+  return new Date(numeric).toISOString();
+}
 function logEntryView(queued) {
   const definition = sourceDefinition(queued.event.source);
   return {
@@ -4815,16 +4832,16 @@ var HttpDaemonClient = class {
     });
     let buffered = [];
     let delivering = Promise.resolve();
-    const deliver = (events) => {
-      if (!callbacks?.has(onEvents) || events.length === 0) return Promise.resolve();
-      delivering = delivering.then(() => deliverWithRetry(events, 0)).catch((error2) => {
+    const deliver = (events2) => {
+      if (!callbacks?.has(onEvents) || events2.length === 0) return Promise.resolve();
+      delivering = delivering.then(() => deliverWithRetry(events2, 0)).catch((error2) => {
         console.error(`[sourcefed] event delivery failed: ${error2 instanceof Error ? error2.message : String(error2)}`);
       });
       return delivering;
     };
-    const deliverWithRetry = async (events, attempt) => {
+    const deliverWithRetry = async (events2, attempt) => {
       try {
-        await onEvents(events);
+        await onEvents(events2);
       } catch (error2) {
         if (attempt >= 2) {
           console.error(`[sourcefed] event delivery failed after retries; re-draining queue: ${error2 instanceof Error ? error2.message : String(error2)}`);
@@ -4833,7 +4850,7 @@ var HttpDaemonClient = class {
           return;
         }
         await sleep(250 * (attempt + 1));
-        await deliverWithRetry(events, attempt + 1);
+        await deliverWithRetry(events2, attempt + 1);
       }
     };
     const performDrain = async () => {
@@ -5038,8 +5055,8 @@ function eventStream(daemon, target) {
   const stream = new ReadableStream({
     start(controller) {
       const encoder = new TextEncoder();
-      unsubscribe = daemon.subscribe(target, (events) => {
-        controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: "event", target, events })}
+      unsubscribe = daemon.subscribe(target, (events2) => {
+        controller.enqueue(encoder.encode(`data: ${JSON.stringify({ type: "event", target, events: events2 })}
 
 `));
       });
@@ -5065,6 +5082,73 @@ function eventStream(daemon, target) {
   });
 }
 
+// packages/cli/src/utils/flags.ts
+function flag(args, name) {
+  const index = args.indexOf(`--${name}`);
+  return index >= 0 ? args[index + 1] : void 0;
+}
+
+// packages/cli/src/utils/net.ts
+function isLoopback(hostname) {
+  return hostname === "127.0.0.1" || hostname === "::1" || hostname === "localhost";
+}
+
+// packages/cli/src/utils/daemon.ts
+function createDaemon() {
+  return new SourcefedDaemon({
+    stateDir: process.env.SOURCEFED_STATE_DIR
+  });
+}
+
+// packages/cli/src/utils/webhooks.ts
+async function startWebhookServer(runtime) {
+  const enabled = Boolean(
+    process.env.SOURCEFED_ENABLE_WEBHOOKS === "1" || process.env.SOURCEFED_WEBHOOK_PORT || process.env.SOURCEFED_GITHUB_WEBHOOK_SECRET || process.env.SOURCEFED_SLACK_SIGNING_SECRET
+  );
+  if (!enabled) return void 0;
+  try {
+    return await serveHttp({
+      hostname: process.env.SOURCEFED_WEBHOOK_HOST ?? "127.0.0.1",
+      port: Number(process.env.SOURCEFED_WEBHOOK_PORT ?? 8788),
+      handler: (request) => runtime.webhook(request)
+    });
+  } catch (error2) {
+    console.error(`[sourcefed] webhook listener unavailable; continuing with MCP and polling: ${error2 instanceof Error ? error2.message : String(error2)}`);
+    return void 0;
+  }
+}
+
+// packages/cli/src/commands/daemon.ts
+async function runDaemon(args) {
+  const port = Number(flag(args, "port") ?? process.env.SOURCEFED_DAEMON_PORT ?? 18787);
+  const hostname = flag(args, "host") ?? process.env.SOURCEFED_DAEMON_HOST ?? "127.0.0.1";
+  const token = process.env.SOURCEFED_DAEMON_TOKEN;
+  if (!isLoopback(hostname) && !token) {
+    throw new Error("binding the daemon to a non-loopback address requires SOURCEFED_DAEMON_TOKEN");
+  }
+  const daemon = createDaemon();
+  await daemon.start();
+  let server;
+  try {
+    server = await serveHttp({
+      hostname,
+      port,
+      handler: (request) => handleDaemonHttpRequest(daemon, request, { token })
+    });
+    const webhookServer = await startWebhookServer(daemon.runtime);
+    console.error(webhookServer ? `[sourcefed] webhook listener on http://${process.env.SOURCEFED_WEBHOOK_HOST ?? "127.0.0.1"}:${webhookServer.port}` : "[sourcefed] no separate webhook listener (webhooks served on daemon port)");
+  } catch (error2) {
+    await daemon.stop();
+    throw error2;
+  }
+  console.error(`[sourcefed] daemon on http://${hostname}:${server.port} (rpc, events, webhooks)`);
+  await new Promise(() => {
+  });
+}
+
+// packages/cli/src/commands/mcp.ts
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+
 // packages/mcp/dist/index.js
 import process3 from "node:process";
 import { link as link5, mkdir as mkdir5, open as open5, readFile as readFile5, rename as rename5, rm as rm5, writeFile as writeFile5 } from "node:fs/promises";
@@ -5331,9 +5415,9 @@ function nullish(input) {
   return input === null || input === void 0;
 }
 function cleanRegex(source) {
-  const start = source.startsWith("^") ? 1 : 0;
+  const start2 = source.startsWith("^") ? 1 : 0;
   const end = source.endsWith("$") ? source.length - 1 : source.length;
-  return source.slice(start, end);
+  return source.slice(start2, end);
 }
 function floatSafeRemainder(val, step) {
   const ratio = val / step;
@@ -14869,19 +14953,19 @@ var MCP_NAME_HEADER_SOURCE = {
   "resources/read": "uri"
 };
 function stripHttpOws(value) {
-  let start = 0;
-  while (start < value.length) {
-    const code = value.codePointAt(start);
+  let start2 = 0;
+  while (start2 < value.length) {
+    const code = value.codePointAt(start2);
     if (code !== 9 && code !== 32) break;
-    start += 1;
+    start2 += 1;
   }
   let end = value.length;
-  while (end > start) {
+  while (end > start2) {
     const code = value.codePointAt(end - 1);
     if (code !== 9 && code !== 32) break;
     end -= 1;
   }
-  return start === 0 && end === value.length ? value : value.slice(start, end);
+  return start2 === 0 && end === value.length ? value : value.slice(start2, end);
 }
 function validateStandardRequestHeaders(request, route) {
   if (route.messageKind !== "request") return;
@@ -23640,11 +23724,11 @@ var require_dist = /* @__PURE__ */ __commonJSMin(((exports, module) => {
     if (!f) throw new Error(`Unknown format "${name}"`);
     return f;
   };
-  function addFormats2(ajv, list, fs, exportName) {
+  function addFormats2(ajv, list2, fs, exportName) {
     var _a3;
     var _b;
     (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 || (_b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`);
-    for (const f of list) ajv.addFormat(f, fs[f]);
+    for (const f of list2) ajv.addFormat(f, fs[f]);
   }
   module.exports = exports = formatsPlugin;
   Object.defineProperty(exports, "__esModule", { value: true });
@@ -23912,11 +23996,11 @@ data: ${JSON.stringify({
     const readable = new ReadableStream({
       start(streamController) {
         controller = streamController;
-        const ack = stampSubscriptionId({
+        const ack2 = stampSubscriptionId({
           method: "notifications/subscriptions/acknowledged",
           params: { notifications: honored }
         }, subscriptionId);
-        writeNotification(ack.method, ack.params);
+        writeNotification(ack2.method, ack2.params);
         unsubscribe = bus.subscribe((event) => {
           if (closed || !listenFilterAccepts(honored, event)) return;
           const note = stampSubscriptionId(serverEventToNotification(event), subscriptionId);
@@ -25602,7 +25686,7 @@ var WebStandardStreamableHTTPServerTransport = class {
   /**
   * Helper to create a JSON error response
   */
-  createJsonErrorResponse(status, code, message, options) {
+  createJsonErrorResponse(status2, code, message, options) {
     const error2 = {
       code,
       message
@@ -25613,7 +25697,7 @@ var WebStandardStreamableHTTPServerTransport = class {
       error: error2,
       id: null
     }, {
-      status,
+      status: status2,
       headers: {
         "Content-Type": "application/json",
         ...options?.headers
@@ -27665,7 +27749,7 @@ async function confirmStillFailing2(repo, prNumber, failed) {
     return /FAIL|ERROR|CANCEL/i.test(state);
   });
 }
-async function appendGithubCiEvent2(repo, prNumber, cursor, events, rollup) {
+async function appendGithubCiEvent2(repo, prNumber, cursor, events2, rollup) {
   const ciState = rollup.map((check) => check.conclusion ?? check.state ?? "PENDING").sort().join(",");
   if (!ciState || ciState === cursor.ciState) return;
   const previousCiState = cursor.ciState;
@@ -27676,7 +27760,7 @@ async function appendGithubCiEvent2(repo, prNumber, cursor, events, rollup) {
   const failureState = failed.map((check) => `${check.name ?? check.context ?? "check"}:${check.conclusion ?? check.state ?? "FAILURE"}`).sort().join(",");
   if (failed.length > 0 && failureState !== cursor.ciFailureState) {
     const names = failed.map((check) => check.name ?? check.context ?? "check").join(", ");
-    events.push({
+    events2.push({
       kind: "ci",
       id: `ci:${failureState}`,
       repo,
@@ -27689,13 +27773,13 @@ async function appendGithubCiEvent2(repo, prNumber, cursor, events, rollup) {
   }
   cursor.ciFailureState = failureState;
 }
-function appendGithubConflictEvent2(repo, prNumber, cursor, events, mergeable) {
+function appendGithubConflictEvent2(repo, prNumber, cursor, events2, mergeable) {
   if (mergeable === cursor.mergeable) return;
   const previousMergeable = cursor.mergeable;
   cursor.mergeable = mergeable;
   if (previousMergeable === void 0) return;
   if (mergeable !== "CONFLICTING" && mergeable !== "DIRTY") return;
-  events.push({
+  events2.push({
     kind: "conflict",
     id: `conflict:${mergeable}`,
     repo,
@@ -27705,7 +27789,7 @@ function appendGithubConflictEvent2(repo, prNumber, cursor, events, mergeable) {
     actionable: true
   });
 }
-function appendGithubReviews2(repo, prNumber, cursor, events, reviews, historyPrimed) {
+function appendGithubReviews2(repo, prNumber, cursor, events2, reviews, historyPrimed) {
   const ref = `#${prNumber}`;
   for (const review of reviews) {
     const id = "rev:" + String(review.id ?? `${review.author?.login}-${review.submittedAt}`);
@@ -27716,7 +27800,7 @@ function appendGithubReviews2(repo, prNumber, cursor, events, reviews, historyPr
     let actionable = false;
     if (review.state === "CHANGES_REQUESTED") actionable = true;
     if (review.state === "COMMENTED" && review.body?.trim()) actionable = true;
-    events.push({
+    events2.push({
       kind: "review",
       id,
       repo,
@@ -27728,7 +27812,7 @@ function appendGithubReviews2(repo, prNumber, cursor, events, reviews, historyPr
     });
   }
 }
-function appendGithubStateEvent2(repo, prNumber, cursor, events, prState) {
+function appendGithubStateEvent2(repo, prNumber, cursor, events2, prState) {
   const isTerminal = prState === "MERGED" || prState === "CLOSED";
   if (prState === cursor.prState) return isTerminal;
   const previousPrState = cursor.prState;
@@ -27736,7 +27820,7 @@ function appendGithubStateEvent2(repo, prNumber, cursor, events, prState) {
   if (previousPrState !== void 0 && isTerminal) {
     let summary = `PR #${prNumber} was CLOSED without merging`;
     if (prState === "MERGED") summary = `PR #${prNumber} was MERGED`;
-    events.push({
+    events2.push({
       kind: "merged",
       id: `state:${prState}`,
       repo,
@@ -27749,14 +27833,14 @@ function appendGithubStateEvent2(repo, prNumber, cursor, events, prState) {
   }
   return isTerminal;
 }
-function appendComments2(repo, prNumber, cursor, events, comments, idPrefix, historyPrimed, summary, body) {
+function appendComments2(repo, prNumber, cursor, events2, comments, idPrefix, historyPrimed, summary, body) {
   for (const comment of comments) {
     const id = idPrefix + String(comment.id);
     if (cursor.commentIds.includes(id)) continue;
     cursor.commentIds.push(id);
     if (!historyPrimed) continue;
     const text = body(comment);
-    events.push({
+    events2.push({
       kind: "comment",
       id,
       repo,
@@ -27786,22 +27870,22 @@ async function pollGithub2(repo, prNumber, cursorRaw) {
   const parsedCursor = /* @__PURE__ */ safeParse2222(GithubCursorSchema2, cursorRaw);
   let cursor = emptyGithubCursor2();
   if (parsedCursor.success) cursor = parsedCursor.output;
-  const events = [];
+  const events2 = [];
   const ref = `#${prNumber}`;
   if (!githubToken2()) {
     if (!warnedMissingToken3) {
       warnedMissingToken3 = true;
       console.warn("[sourcefed] GH_TOKEN or GITHUB_TOKEN is not set; GitHub monitors will not poll");
     }
-    return { events, cursor, terminal: false };
+    return { events: events2, cursor, terminal: false };
   }
   const data = await fetchPrData2(repo, prNumber);
-  if (!data) return { events, cursor, terminal: false };
+  if (!data) return { events: events2, cursor, terminal: false };
   let historyPrimed = cursor.historyPrimed;
   if (!historyPrimed) historyPrimed = Boolean(cursor.reviewIds.length || cursor.commentIds.length || cursor.ciState || cursor.mergeable || cursor.prState);
   const lineCommentsPrimed = cursor.lineCommentsPrimed;
   const conversationCommentsPrimed = cursor.conversationCommentsPrimed;
-  appendGithubReviews2(repo, prNumber, cursor, events, data.reviews ?? [], historyPrimed);
+  appendGithubReviews2(repo, prNumber, cursor, events2, data.reviews ?? [], historyPrimed);
   if (!cursor.historyPrimed) cursor.historyPrimed = true;
   const lineComments = await fetchGithubComments2(`repos/${repo}/pulls/${prNumber}/comments`);
   if (lineComments) {
@@ -27809,7 +27893,7 @@ async function pollGithub2(repo, prNumber, cursorRaw) {
       repo,
       prNumber,
       cursor,
-      events,
+      events2,
       lineComments,
       "c:",
       lineCommentsPrimed,
@@ -27828,7 +27912,7 @@ async function pollGithub2(repo, prNumber, cursorRaw) {
       repo,
       prNumber,
       cursor,
-      events,
+      events2,
       conversationComments,
       "issue:",
       conversationCommentsPrimed,
@@ -27837,12 +27921,12 @@ async function pollGithub2(repo, prNumber, cursorRaw) {
     );
     cursor.conversationCommentsPrimed = true;
   }
-  await appendGithubCiEvent2(repo, prNumber, cursor, events, data.statusCheckRollup ?? []);
+  await appendGithubCiEvent2(repo, prNumber, cursor, events2, data.statusCheckRollup ?? []);
   const mergeable = data.mergeable ?? data.mergeStateStatus ?? "UNKNOWN";
-  appendGithubConflictEvent2(repo, prNumber, cursor, events, mergeable);
+  appendGithubConflictEvent2(repo, prNumber, cursor, events2, mergeable);
   const prState = data.state ?? "OPEN";
-  const terminal = appendGithubStateEvent2(repo, prNumber, cursor, events, prState);
-  return { events, cursor, terminal };
+  const terminal = appendGithubStateEvent2(repo, prNumber, cursor, events2, prState);
+  return { events: events2, cursor, terminal };
 }
 var githubPollMonitor2 = new PollMonitor4({
   run: async (source, cursor) => {
@@ -28620,11 +28704,11 @@ function jiraChangeValue2(item, side) {
 function formatJiraChangelogItem2(item) {
   return `${item.field}: ${jiraChangeValue2(item, "from")} \u2192 ${jiraChangeValue2(item, "to")}`;
 }
-function isTerminalStatus2(status) {
-  if (typeof status !== "string") return false;
+function isTerminalStatus2(status2) {
+  if (typeof status2 !== "string") return false;
   const terminalStatus = process.env.SOURCEFED_JIRA_TERMINAL_STATUS;
   if (!terminalStatus) return false;
-  return status.trim().toLowerCase() === terminalStatus.trim().toLowerCase();
+  return status2.trim().toLowerCase() === terminalStatus.trim().toLowerCase();
 }
 var TRACKED_CHANGE_FIELDS2 = /* @__PURE__ */ new Set(["summary", "status", "assignee", "priority", "labels"]);
 function meaningfulChangelogItems2(items) {
@@ -28650,12 +28734,12 @@ function jiraChangelogEvent2(issueKey, history) {
     terminal
   };
 }
-function appendJiraChangelog2(issueKey, cursor, events, histories) {
+function appendJiraChangelog2(issueKey, cursor, events2, histories) {
   const total = histories.length;
   if (cursor.changelogCount !== 0 && total > cursor.changelogCount) {
     for (const history of histories.slice(cursor.changelogCount)) {
       const event = jiraChangelogEvent2(issueKey, history);
-      if (event) events.push(event);
+      if (event) events2.push(event);
     }
   }
   cursor.changelogCount = total;
@@ -28666,7 +28750,7 @@ function adfText2(node) {
   if (Array.isArray(node.content)) return node.content.map(adfText2).join("");
   return "";
 }
-function appendJiraComments2(issueKey, cursor, events, comments) {
+function appendJiraComments2(issueKey, cursor, events2, comments) {
   const freshComments = [];
   for (const comment of comments) {
     const id = Number(comment.id);
@@ -28679,7 +28763,7 @@ function appendJiraComments2(issueKey, cursor, events, comments) {
   }
   for (const comment of freshComments) {
     const body = adfText2(comment.body);
-    events.push({
+    events2.push({
       kind: "comment",
       id: `comment:${comment.id}`,
       issueKey,
@@ -28692,11 +28776,11 @@ function appendJiraComments2(issueKey, cursor, events, comments) {
     cursor.commentIds.push(Number(comment.id));
   }
 }
-function appendJiraDescription2(issueKey, cursor, events, description) {
+function appendJiraDescription2(issueKey, cursor, events2, description) {
   let descriptionVersion = "none";
   if (description) descriptionVersion = JSON.stringify(description).slice(0, 40);
   if (cursor.descriptionVersion !== void 0 && descriptionVersion !== cursor.descriptionVersion) {
-    events.push({
+    events2.push({
       kind: "description",
       id: `description:${descriptionVersion}`,
       issueKey,
@@ -28730,15 +28814,15 @@ async function pollJira2(issueKey, cursorRaw) {
   const parsedCursor = /* @__PURE__ */ safeParse232(JiraCursorSchema2, cursorRaw);
   let cursor = emptyJiraCursor2();
   if (parsedCursor.success) cursor = parsedCursor.output;
-  const events = [];
+  const events2 = [];
   const comments = await jiraFetch2(`/issue/${issueKey}/comment?maxResults=50&orderBy=-created`);
-  appendJiraComments2(issueKey, cursor, events, comments.comments ?? []);
+  appendJiraComments2(issueKey, cursor, events2, comments.comments ?? []);
   const issue2 = await jiraFetch2(`/issue/${issueKey}?expand=changelog&fields=status,description`);
   const statusName = issue2.fields?.status?.name;
-  appendJiraDescription2(issueKey, cursor, events, issue2.fields?.description);
+  appendJiraDescription2(issueKey, cursor, events2, issue2.fields?.description);
   const changelog = issue2.changelog?.histories ?? [];
-  appendJiraChangelog2(issueKey, cursor, events, changelog);
-  return { events, cursor, terminal: isTerminalStatus2(statusName) };
+  appendJiraChangelog2(issueKey, cursor, events2, changelog);
+  return { events: events2, cursor, terminal: isTerminalStatus2(statusName) };
 }
 var jiraPollMonitor2 = new PollMonitor22({
   run: async (source, cursor) => {
@@ -29652,9 +29736,9 @@ function parseSlackReadResult2(result, cursorRaw) {
     if (!cursor.latestTs) return true;
     return messageTimestamp2(message.ts) > messageTimestamp2(cursor.latestTs);
   });
-  let events = [];
+  let events2 = [];
   if (cursor.primed) {
-    events = freshMessages.map((message) => {
+    events2 = freshMessages.map((message) => {
       let text = "[message without text]";
       if (message.text?.trim()) text = message.text.trim();
       let author = users.get(message.user);
@@ -29677,7 +29761,7 @@ function parseSlackReadResult2(result, cursorRaw) {
     if (messageTimestamp2(message.ts) > messageTimestamp2(latestTs)) latestTs = message.ts;
   }
   cursor.latestTs = latestTs;
-  return { events, cursor };
+  return { events: events2, cursor };
 }
 var SLACK_API2 = "https://slack.com/api";
 var warnedMissingToken22 = false;
@@ -30019,9 +30103,9 @@ function buildServer(daemon) {
     async (uri, variables) => {
       const target = decodeTarget2(String(variables.targetId));
       if (!target) throw new Error("invalid Sourcefed target resource");
-      const events = await daemon.readEvents(target);
+      const events2 = await daemon.readEvents(target);
       return {
-        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ events }) }]
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify({ events: events2 }) }]
       };
     }
   );
@@ -30034,6 +30118,275 @@ function errorResult(error2) {
   return { content: [{ type: "text", text: error2 }], isError: true };
 }
 
+// packages/cli/src/commands/mcp.ts
+async function runMcp(args) {
+  const mode = args[0] ?? "--stdio";
+  if (mode === "--stdio") {
+    const daemon2 = createDaemon();
+    const mcp2 = createSourcefedStdio(daemon2);
+    await daemon2.start();
+    const webhookServer = await startWebhookServer(mcp2.runtime);
+    await serveStdio(mcp2.factory);
+    await webhookServer?.stop();
+    await mcp2.close();
+    return;
+  }
+  if (mode !== "--http") {
+    throw new Error("mcp expects --stdio or --http");
+  }
+  const port = Number(flag(args, "port") ?? process.env.SOURCEFED_MCP_PORT ?? 18788);
+  const hostname = flag(args, "host") ?? process.env.SOURCEFED_MCP_HOST ?? "127.0.0.1";
+  const token = process.env.SOURCEFED_DAEMON_TOKEN;
+  if (!isLoopback(hostname) && !token) {
+    throw new Error("binding the MCP server to a non-loopback address requires SOURCEFED_DAEMON_TOKEN");
+  }
+  const daemon = createDaemon();
+  const mcp = createSourcefedMcp(daemon);
+  await daemon.start();
+  let server;
+  try {
+    server = await serveHttp({
+      hostname,
+      port,
+      handler: (request) => {
+        const url2 = new URL(request.url);
+        if (url2.pathname === "/mcp" && token && request.headers.get("authorization") !== `Bearer ${token}`) {
+          return new Response("unauthorized", { status: 401 });
+        }
+        return url2.pathname === "/mcp" ? mcp.handler.fetch(request) : daemon.webhook(request);
+      }
+    });
+  } catch (error2) {
+    await mcp.close();
+    throw error2;
+  }
+  console.error(`[sourcefed] MCP server on http://${hostname}:${server.port}/mcp`);
+  await new Promise(() => {
+  });
+}
+
+// packages/cli/src/commands/monitor/index.ts
+import os7 from "node:os";
+
+// packages/cli/src/utils/format.ts
+function printMonitors(monitors) {
+  if (monitors.length === 0) {
+    console.log(dim("no monitors for this target"));
+    return;
+  }
+  for (const monitor of monitors) {
+    const status2 = monitor.enabled ? green("enabled") : red("stopped");
+    const delivery = dim(monitor.delivery);
+    console.log(`${monitor.icon} ${monitor.describe}  ${status2}  ${delivery}`);
+  }
+}
+function printLogs(logs2) {
+  if (logs2.length === 0) {
+    console.log(dim("no notifications sent yet"));
+    return;
+  }
+  for (const entry of logs2) {
+    const time3 = dim(new Date(entry.at).toLocaleString());
+    const marker = entry.actionable ? yellow("\u25B6") : dim("\xB7");
+    console.log(`${marker} ${entry.icon} ${time3} ${entry.describe}`);
+    console.log(`    ${entry.summary}`);
+    if (entry.body) console.log(dim(`    ${entry.body}`));
+  }
+}
+function printResult(result) {
+  console.log(JSON.stringify(result, null, 2));
+}
+function green(text) {
+  return `\x1B[32m${text}\x1B[0m`;
+}
+function red(text) {
+  return `\x1B[31m${text}\x1B[0m`;
+}
+function yellow(text) {
+  return `\x1B[33m${text}\x1B[0m`;
+}
+function dim(text) {
+  return `\x1B[2m${text}\x1B[0m`;
+}
+
+// packages/cli/src/commands/monitor/ack.ts
+async function ack(context) {
+  const eventIDs = (flag(context.args, "event-id") ?? "").split(",").filter(Boolean);
+  if (eventIDs.length === 0) throw new Error("ack requires --event-id <id>[,<id>...]");
+  printResult(await context.client.request("monitor.ack", { target: context.target, eventIDs }));
+}
+
+// packages/cli/src/commands/monitor/create.ts
+async function create(context) {
+  const sourceType = flag(context.args, "source-type");
+  const sourceTypes = await context.client.request("daemon.sourceTypes");
+  if (!sourceType || !sourceTypes.sourceTypes?.includes(sourceType)) {
+    throw new Error(`create requires --source-type ${sourceTypes.sourceTypes?.join("|") ?? "unknown"}`);
+  }
+  const input = {
+    name: flag(context.args, "name") ?? sourceType,
+    sourceType,
+    target: context.target
+  };
+  const keyMap = {
+    "issue-key": "issueKey",
+    repo: "repo",
+    "channel-id": "channelId",
+    "thread-ts": "threadTs",
+    "thread-url": "threadUrl"
+  };
+  for (const key of Object.keys(keyMap)) {
+    const value = flag(context.args, key);
+    if (value) input[keyMap[key]] = value;
+  }
+  const prNumber = flag(context.args, "pr-number");
+  if (prNumber) input.prNumber = Number(prNumber);
+  const pollIntervalSec = flag(context.args, "poll-interval-sec");
+  if (pollIntervalSec) input.pollIntervalSec = Number(pollIntervalSec);
+  printResult(await context.client.request("monitor.create", input));
+}
+
+// packages/cli/src/commands/monitor/events.ts
+async function events(context) {
+  printResult(await context.client.request("monitor.events", { target: context.target }));
+}
+
+// packages/cli/src/commands/monitor/follow.ts
+async function follow(context) {
+  console.error(`[sourcefed] following events for ${context.target.kind}:${context.target.id}; Ctrl+C to stop`);
+  const listener = await context.client.subscribe(context.target, async (events2) => {
+    for (const entry of events2) {
+      const time3 = dim(new Date(entry.event.at).toLocaleString());
+      const marker = entry.event.actionable ? yellow("\u25B6") : dim("\xB7");
+      console.log(`${marker} ${time3} ${entry.event.summary}`);
+      if (entry.event.body) console.log(dim(`    ${entry.event.body}`));
+    }
+  });
+  await new Promise(() => {
+  });
+  await listener.close();
+}
+
+// packages/cli/src/commands/monitor/list.ts
+async function list(context) {
+  const result = await context.client.request("monitor.list", { target: context.target });
+  printMonitors(result?.monitors ?? []);
+}
+
+// packages/cli/src/commands/monitor/logs.ts
+async function logs(context) {
+  const result = await context.client.request("monitor.logs", { target: context.target });
+  printLogs(result?.logs ?? []);
+}
+
+// packages/cli/src/commands/monitor/remove.ts
+async function remove(context) {
+  if (!context.args.includes("--yes")) throw new Error("remove is destructive: pass --yes to confirm");
+  const id = flag(context.args, "id");
+  if (!id) throw new Error("remove requires --id");
+  printResult(await context.client.request("monitor.remove", { target: context.target, id }));
+}
+
+// packages/cli/src/commands/monitor/sources.ts
+async function sources(context) {
+  printResult(await context.client.request("daemon.sourceTypes"));
+}
+
+// packages/cli/src/commands/monitor/start.ts
+async function start(context) {
+  const id = flag(context.args, "id");
+  if (!id) throw new Error("start requires --id");
+  printResult(await context.client.request("monitor.start", { target: context.target, id }));
+}
+
+// packages/cli/src/commands/monitor/status.ts
+async function status(context) {
+  const id = flag(context.args, "id");
+  if (!id) throw new Error("status requires --id");
+  printResult(await context.client.request("monitor.status", { target: context.target, id }));
+}
+
+// packages/cli/src/commands/monitor/stop.ts
+async function stop(context) {
+  const id = flag(context.args, "id");
+  if (!id) throw new Error("stop requires --id");
+  printResult(await context.client.request("monitor.stop", { target: context.target, id }));
+}
+
+// packages/cli/src/commands/monitor/index.ts
+var SUBCOMMANDS = {
+  list,
+  logs,
+  sources,
+  status,
+  stop,
+  start,
+  remove,
+  events,
+  follow,
+  ack,
+  create
+};
+var SUBCOMMAND_NAMES = Object.keys(SUBCOMMANDS).join(", ");
+async function runMonitor(argv) {
+  const [subcommand, ...args] = argv;
+  const target = {
+    kind: flag(args, "target-kind") ?? "cli",
+    id: flag(args, "target-id") ?? process.env.SOURCEFED_TARGET_ID ?? os7.hostname()
+  };
+  const client = await connectDaemonClient({
+    name: "sourcefed-cli",
+    url: process.env.SOURCEFED_DAEMON_URL ?? defaultDaemonUrl()
+  });
+  const run = subcommand ? SUBCOMMANDS[subcommand] : void 0;
+  if (!run) {
+    await client.close();
+    throw new Error(`monitor expects ${SUBCOMMAND_NAMES}`);
+  }
+  try {
+    await run({ client, target, args });
+  } finally {
+    await client.close();
+  }
+}
+
+// packages/cli/src/utils/setup.ts
+import { execFile } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+function setupSpec() {
+  const manifest = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+  if (manifest.name === "@fdcn/sourcefed" && manifest.version) return `@fdcn/sourcefed@${manifest.version}`;
+  return "@fdcn/sourcefed@latest";
+}
+async function setupHost(name, args, spec) {
+  console.error(`[sourcefed] installing ${spec} into ${name}`);
+  try {
+    await execFile(name, args);
+    console.error(`[sourcefed] ${name} configured \u2014 restart ${name} to load the plugin`);
+  } catch (error2) {
+    const code = error2 && typeof error2 === "object" && "code" in error2 ? String(error2.code) : "";
+    if (code === "ENOENT") {
+      console.error(`[sourcefed] ${name} is not on PATH \u2014 install it manually:`);
+      console.error(name === "opencode" ? `  add "${spec}" to the plugin array in ~/.config/opencode/opencode.jsonc and tui.json` : `  run: pi install ${spec}`);
+      return;
+    }
+    throw error2;
+  }
+}
+
+// packages/cli/src/commands/setup.ts
+async function runSetup(args) {
+  const spec = setupSpec();
+  const requested = args[0] ?? "all";
+  if (requested === "opencode" || requested === "all") {
+    await setupHost("opencode", ["plugin", spec, "--global"], spec);
+  }
+  if (requested === "pi" || requested === "all") {
+    await setupHost("pi", ["install", `npm:${spec}`], `npm:${spec}`);
+  }
+}
+
 // packages/cli/src/skills/command.ts
 import { readFile as readFile7, readdir as readdir2, stat as stat2 } from "node:fs/promises";
 import path9 from "node:path";
@@ -30042,7 +30395,7 @@ import path9 from "node:path";
 import { statSync } from "node:fs";
 import { readdir, readFile as readFile6, stat } from "node:fs/promises";
 import path8 from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // packages/cli/src/skills/frontmatter.ts
 function parseFrontmatter(content) {
@@ -30122,7 +30475,7 @@ async function discoverSkills() {
   return skills;
 }
 function skillRoot() {
-  let dir = path8.dirname(fileURLToPath(import.meta.url));
+  let dir = path8.dirname(fileURLToPath2(import.meta.url));
   for (let depth = 0; depth < 6; depth++) {
     const marker = path8.join(dir, "data");
     if (statSync(marker, { throwIfNoEntry: false })?.isDirectory()) return dir;
@@ -30130,7 +30483,7 @@ function skillRoot() {
     if (parent === dir) break;
     dir = parent;
   }
-  return path8.dirname(fileURLToPath(import.meta.url));
+  return path8.dirname(fileURLToPath2(import.meta.url));
 }
 
 // packages/cli/src/skills/command.ts
@@ -30226,252 +30579,31 @@ ${content}
 }
 
 // packages/cli/src/index.ts
+var COMMANDS = {
+  daemon: runDaemon,
+  mcp: runMcp,
+  monitor: runMonitor,
+  skills: runSkillsCommand,
+  setup: runSetup
+};
 async function main(argv = process.argv.slice(2)) {
-  const [command, subcommand, ...rest] = argv;
-  if (command === "daemon") {
-    await runDaemon([subcommand, ...rest].filter((value) => value !== void 0));
-    return;
-  }
-  if (command === "mcp") {
-    await runMcp([subcommand, ...rest].filter((value) => value !== void 0));
-    return;
-  }
-  if (command === "monitor") {
-    await runMonitor(subcommand, rest);
-    return;
-  }
-  if (command === "skills") {
-    await runSkillsCommand([subcommand, ...rest].filter((value) => value !== void 0));
-    return;
-  }
-  printUsage();
-  process.exitCode = 1;
-}
-function createDaemon() {
-  return new SourcefedDaemon({
-    stateDir: process.env.SOURCEFED_STATE_DIR
-  });
-}
-async function runDaemon(args) {
-  const port = Number(flag(args, "port") ?? process.env.SOURCEFED_DAEMON_PORT ?? 18787);
-  const hostname = flag(args, "host") ?? process.env.SOURCEFED_DAEMON_HOST ?? "127.0.0.1";
-  const token = process.env.SOURCEFED_DAEMON_TOKEN;
-  if (!isLoopback(hostname) && !token) {
-    throw new Error("binding the daemon to a non-loopback address requires SOURCEFED_DAEMON_TOKEN");
-  }
-  const daemon = createDaemon();
-  await daemon.start();
-  let server;
-  try {
-    server = await serveHttp({
-      hostname,
-      port,
-      handler: (request) => handleDaemonHttpRequest(daemon, request, { token })
-    });
-    const webhookServer = await startWebhookServer(daemon.runtime);
-    console.error(webhookServer ? `[sourcefed] webhook listener on http://${process.env.SOURCEFED_WEBHOOK_HOST ?? "127.0.0.1"}:${webhookServer.port}` : "[sourcefed] no separate webhook listener (webhooks served on daemon port)");
-  } catch (error2) {
-    await daemon.stop();
-    throw error2;
-  }
-  console.error(`[sourcefed] daemon on http://${hostname}:${server.port} (rpc, events, webhooks)`);
-  await new Promise(() => {
-  });
-}
-function isLoopback(hostname) {
-  return hostname === "127.0.0.1" || hostname === "::1" || hostname === "localhost";
-}
-async function runMcp(args) {
-  const mode = args[0] ?? "--stdio";
-  if (mode === "--stdio") {
-    const daemon2 = createDaemon();
-    const mcp2 = createSourcefedStdio(daemon2);
-    await daemon2.start();
-    const webhookServer = await startWebhookServer(mcp2.runtime);
-    await serveStdio(mcp2.factory);
-    await webhookServer?.stop();
-    await mcp2.close();
-    return;
-  }
-  if (mode !== "--http") {
-    throw new Error("mcp expects --stdio or --http");
-  }
-  const port = Number(flag(args, "port") ?? process.env.SOURCEFED_MCP_PORT ?? 18788);
-  const hostname = flag(args, "host") ?? process.env.SOURCEFED_MCP_HOST ?? "127.0.0.1";
-  const token = process.env.SOURCEFED_DAEMON_TOKEN;
-  if (!isLoopback(hostname) && !token) {
-    throw new Error("binding the MCP server to a non-loopback address requires SOURCEFED_DAEMON_TOKEN");
-  }
-  const daemon = createDaemon();
-  const mcp = createSourcefedMcp(daemon);
-  await daemon.start();
-  let server;
-  try {
-    server = await serveHttp({
-      hostname,
-      port,
-      handler: (request) => {
-        const url2 = new URL(request.url);
-        if (url2.pathname === "/mcp" && token && request.headers.get("authorization") !== `Bearer ${token}`) {
-          return new Response("unauthorized", { status: 401 });
-        }
-        return url2.pathname === "/mcp" ? mcp.handler.fetch(request) : daemon.webhook(request);
-      }
-    });
-  } catch (error2) {
-    await mcp.close();
-    throw error2;
-  }
-  console.error(`[sourcefed] MCP server on http://${hostname}:${server.port}/mcp`);
-  await new Promise(() => {
-  });
-}
-async function startWebhookServer(runtime) {
-  const enabled = Boolean(
-    process.env.SOURCEFED_ENABLE_WEBHOOKS === "1" || process.env.SOURCEFED_WEBHOOK_PORT || process.env.SOURCEFED_GITHUB_WEBHOOK_SECRET || process.env.SOURCEFED_SLACK_SIGNING_SECRET
-  );
-  if (!enabled) return void 0;
-  try {
-    return await serveHttp({
-      hostname: process.env.SOURCEFED_WEBHOOK_HOST ?? "127.0.0.1",
-      port: Number(process.env.SOURCEFED_WEBHOOK_PORT ?? 8788),
-      handler: (request) => runtime.webhook(request)
-    });
-  } catch (error2) {
-    console.error(`[sourcefed] webhook listener unavailable; continuing with MCP and polling: ${error2 instanceof Error ? error2.message : String(error2)}`);
-    return void 0;
-  }
-}
-async function runMonitor(subcommand, args) {
-  const target = {
-    kind: flag(args, "target-kind") ?? "cli",
-    id: flag(args, "target-id") ?? process.env.SOURCEFED_TARGET_ID ?? os7.hostname()
-  };
-  const clientOptions = {
-    name: "sourcefed-cli",
-    url: process.env.SOURCEFED_DAEMON_URL ?? defaultDaemonUrl()
-  };
-  const client = await connectDaemonClient(clientOptions);
-  try {
-    if (subcommand === "list") {
-      const result = await client.request("monitor.list", { target });
-      printMonitors(result?.monitors ?? []);
-      return;
-    }
-    if (subcommand === "logs") {
-      const result = await client.request("monitor.logs", { target });
-      printLogs(result?.logs ?? []);
-      return;
-    }
-    if (subcommand === "sources") {
-      printResult(await client.request("daemon.sourceTypes"));
-      return;
-    }
-    const id = flag(args, "id");
-    if ((subcommand === "status" || subcommand === "stop" || subcommand === "start" || subcommand === "remove") && !id) throw new Error(`${subcommand} requires --id`);
-    if (subcommand === "status" || subcommand === "stop" || subcommand === "start") {
-      printResult(await client.request(`monitor.${subcommand}`, { target, id }));
-      return;
-    }
-    if (subcommand === "remove") {
-      if (!args.includes("--yes")) throw new Error("remove is destructive: pass --yes to confirm");
-      printResult(await client.request("monitor.remove", { target, id }));
-      return;
-    }
-    if (subcommand === "events") {
-      printResult(await client.request("monitor.events", { target }));
-      return;
-    }
-    if (subcommand === "ack") {
-      const eventIDs = (flag(args, "event-id") ?? "").split(",").filter(Boolean);
-      if (eventIDs.length === 0) throw new Error("ack requires --event-id <id>[,<id>...]");
-      printResult(await client.request("monitor.ack", { target, eventIDs }));
-      return;
-    }
-    if (subcommand === "create") {
-      const sourceType = flag(args, "source-type");
-      const sourceTypes = await client.request("daemon.sourceTypes");
-      if (!sourceType || !sourceTypes.sourceTypes?.includes(sourceType)) {
-        throw new Error(`create requires --source-type ${sourceTypes.sourceTypes?.join("|") ?? "unknown"}`);
-      }
-      const input = {
-        name: flag(args, "name") ?? sourceType,
-        sourceType,
-        target
-      };
-      const keyMap = {
-        "issue-key": "issueKey",
-        repo: "repo",
-        "channel-id": "channelId",
-        "thread-ts": "threadTs",
-        "thread-url": "threadUrl"
-      };
-      for (const key of Object.keys(keyMap)) {
-        const value = flag(args, key);
-        if (value) input[keyMap[key]] = value;
-      }
-      const prNumber = flag(args, "pr-number");
-      if (prNumber) input.prNumber = Number(prNumber);
-      const pollIntervalSec = flag(args, "poll-interval-sec");
-      if (pollIntervalSec) input.pollIntervalSec = Number(pollIntervalSec);
-      printResult(await client.request("monitor.create", input));
-      return;
-    }
-  } finally {
-    await client.close();
-  }
-  throw new Error("monitor expects create, list, status, stop, start, remove, events, ack, logs, or sources");
-}
-function flag(args, name) {
-  const index = args.indexOf(`--${name}`);
-  return index >= 0 ? args[index + 1] : void 0;
-}
-function printMonitors(monitors) {
-  if (monitors.length === 0) {
-    console.log(dim("no monitors for this target"));
-    return;
-  }
-  for (const monitor of monitors) {
-    const status = monitor.enabled ? green("enabled") : red("stopped");
-    const delivery = dim(monitor.delivery);
-    console.log(`${monitor.icon} ${monitor.describe}  ${status}  ${delivery}`);
-  }
-}
-function printLogs(logs) {
-  if (logs.length === 0) {
-    console.log(dim("no notifications sent yet"));
+  const [command, ...args] = argv;
+  const run = command ? COMMANDS[command] : void 0;
+  if (!run) {
+    printUsage();
+    process.exitCode = 1;
     return;
   }
-  for (const entry of logs) {
-    const time3 = dim(new Date(entry.at).toLocaleString());
-    const marker = entry.actionable ? yellow("\u25B6") : dim("\xB7");
-    console.log(`${marker} ${entry.icon} ${time3} ${entry.describe}`);
-    console.log(`    ${entry.summary}`);
-    if (entry.body) console.log(dim(`    ${entry.body}`));
-  }
-}
-function green(text) {
-  return `\x1B[32m${text}\x1B[0m`;
-}
-function red(text) {
-  return `\x1B[31m${text}\x1B[0m`;
-}
-function yellow(text) {
-  return `\x1B[33m${text}\x1B[0m`;
-}
-function dim(text) {
-  return `\x1B[2m${text}\x1B[0m`;
-}
-function printResult(result) {
-  console.log(JSON.stringify(result, null, 2));
+  await run(args);
 }
 function printUsage() {
   console.error("sourcefed daemon [--port PORT] [--host HOST]");
   console.error("sourcefed mcp --stdio|--http [--port PORT]");
-  console.error("sourcefed monitor create|list|status|stop|start|remove|events|ack|logs|sources [options]");
+  console.error("sourcefed monitor create|list|status|stop|start|remove|events|follow|ack|logs|sources [options]");
   console.error("sourcefed skills [list|get <name>|path [name]]");
+  console.error("sourcefed setup [opencode|pi]");
 }
-if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath2(import.meta.url)) {
+if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath3(import.meta.url)) {
   main().catch((error2) => {
     console.error(error2 instanceof Error ? error2.message : String(error2));
     process.exitCode = 1;