@fdcn/sourcefed 0.3.4 → 0.3.6

package/README.md

@@ -29,16 +29,11 @@ import { createSourcefedMcp } from "@fdcn/sourcefed/mcp"
 
 ## Host plugins
 
-OpenCode loads this package as both a server and a TUI plugin:
+OpenCode loads this package as both a server and a TUI plugin from one entry:
 
 ```json
 // ~/.config/opencode/opencode.jsonc
-{ "plugins": ["@fdcn/sourcefed@0.3.4"] }
-```
-
-```json
-// ~/.config/opencode/cli.json
-{ "plugins": ["@fdcn/sourcefed@0.3.4"] }
+{ "plugins": ["@fdcn/sourcefed@0.3.6"] }
 ```
 
 The package exposes `./server`, `./tui`, `./opencode`, `./opencode/tui`, and `./pi` entrypoints for hosts that load them directly.

package/dist/cli.js

@@ -44192,9 +44192,7 @@ async function runMonitor(argv) {
 
 // packages/cli/src/utils/setup.ts
 import { execFile } from "node:child_process";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import os8 from "node:os";
-import path8 from "node:path";
+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"));
@@ -44211,59 +44209,19 @@ async function setupHost(name, args, spec) {
     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 plugins array in ~/.config/opencode/opencode.jsonc and cli.json` : `  run: pi install ${spec}`);
+      console.error(name === "opencode" ? `  add "${spec}" to the plugins array in ~/.config/opencode/opencode.jsonc` : `  run: pi install ${spec}`);
       return false;
     }
     throw error2;
   }
 }
-function configureOpenCodeCliPlugin(spec) {
-  const file = openCodeCliConfigPath();
-  const config2 = readOpenCodeCliConfig(file);
-  const plugins = config2.plugins;
-  if (plugins === void 0) {
-    config2.plugins = [spec];
-  } else if (!Array.isArray(plugins)) {
-    throw new Error(`OpenCode CLI config has a non-array plugins setting: ${file}`);
-  } else if (!plugins.some((plugin) => isPluginEntry(plugin, spec))) {
-    config2.plugins = [...plugins, spec];
-  } else {
-    return;
-  }
-  mkdirSync(path8.dirname(file), { recursive: true });
-  writeFileSync(file, `${JSON.stringify(config2, null, 2)}
-`);
-}
-function openCodeCliConfigPath() {
-  const configHome = process.env.XDG_CONFIG_HOME ?? path8.join(os8.homedir(), ".config");
-  return path8.join(configHome, "opencode", "cli.json");
-}
-function readOpenCodeCliConfig(file) {
-  try {
-    const value = JSON.parse(readFileSync(file, "utf8"));
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      throw new Error(`OpenCode CLI config must contain a JSON object: ${file}`);
-    }
-    return value;
-  } catch (error2) {
-    if (error2 instanceof Error && "code" in error2 && error2.code === "ENOENT") return {};
-    if (error2 instanceof SyntaxError) throw new Error(`OpenCode CLI config is not valid JSON: ${file}`);
-    throw error2;
-  }
-}
-function isPluginEntry(value, spec) {
-  if (value === spec) return true;
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  return "package" in value && value.package === spec;
-}
 
 // packages/cli/src/commands/setup.ts
 async function runSetup(args) {
   const spec = setupSpec();
   const requested = args[0] ?? "all";
   if (requested === "opencode" || requested === "all") {
-    const installed = await setupHost("opencode", ["plugin", "add", spec], spec);
-    if (installed) configureOpenCodeCliPlugin(spec);
+    await setupHost("opencode", ["plugin", "add", spec], spec);
   }
   if (requested === "pi" || requested === "all") {
     await setupHost("pi", ["install", `npm:${spec}`], `npm:${spec}`);
@@ -44272,12 +44230,12 @@ async function runSetup(args) {
 
 // packages/cli/src/skills/command.ts
 import { readFile as readFile7, readdir as readdir2, stat as stat2 } from "node:fs/promises";
-import path10 from "node:path";
+import path9 from "node:path";
 
 // packages/cli/src/skills/discovery.ts
 import { statSync } from "node:fs";
 import { readdir, readFile as readFile6, stat } from "node:fs/promises";
-import path9 from "node:path";
+import path8 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // packages/cli/src/skills/frontmatter.ts
@@ -44325,7 +44283,7 @@ async function skillsDirs() {
   }
   const directories = [];
   for (const name of SKILL_DIRS) {
-    const candidate = path9.join(skillRoot(), name);
+    const candidate = path8.join(skillRoot(), name);
     try {
       if ((await stat(candidate)).isDirectory()) directories.push(candidate);
     } catch {
@@ -44337,7 +44295,7 @@ async function discoverSkills() {
   const skills = [];
   for (const dir of await skillsDirs()) {
     for (const entry of await readdir(dir)) {
-      const skillDir = path9.join(dir, entry);
+      const skillDir = path8.join(dir, entry);
       let entryStat;
       try {
         entryStat = await stat(skillDir);
@@ -44345,7 +44303,7 @@ async function discoverSkills() {
         continue;
       }
       if (!entryStat.isDirectory()) continue;
-      const skillFile = path9.join(skillDir, "SKILL.md");
+      const skillFile = path8.join(skillDir, "SKILL.md");
       try {
         const content = await readFile6(skillFile, "utf8");
         const parsed = parseFrontmatter(content);
@@ -44358,15 +44316,15 @@ async function discoverSkills() {
   return skills;
 }
 function skillRoot() {
-  let dir = path9.dirname(fileURLToPath2(import.meta.url));
+  let dir = path8.dirname(fileURLToPath2(import.meta.url));
   for (let depth = 0; depth < 6; depth++) {
-    const marker = path9.join(dir, "data");
+    const marker = path8.join(dir, "data");
     if (statSync(marker, { throwIfNoEntry: false })?.isDirectory()) return dir;
-    const parent = path9.dirname(dir);
+    const parent = path8.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return path9.dirname(fileURLToPath2(import.meta.url));
+  return path8.dirname(fileURLToPath2(import.meta.url));
 }
 
 // packages/cli/src/skills/command.ts
@@ -44413,7 +44371,7 @@ async function runGet(args) {
     output += `# ${skill.name}
 
 `;
-    output += await readFile7(path10.join(skill.dir, "SKILL.md"), "utf8");
+    output += await readFile7(path9.join(skill.dir, "SKILL.md"), "utf8");
     output += "\n";
     if (full) output += await supplementaryFiles(skill.dir);
   }
@@ -44436,7 +44394,7 @@ async function runPath(name) {
 async function supplementaryFiles(skillDir) {
   let output = "";
   for (const subdirName of ["references", "templates"]) {
-    const subdir = path10.join(skillDir, subdirName);
+    const subdir = path9.join(skillDir, subdirName);
     try {
       if (!(await stat2(subdir)).isDirectory()) continue;
     } catch {
@@ -44444,7 +44402,7 @@ async function supplementaryFiles(skillDir) {
     }
     const entries = (await readdir2(subdir)).sort();
     for (const entry of entries) {
-      const filePath = path10.join(subdir, entry);
+      const filePath = path9.join(subdir, entry);
       try {
         if (!(await stat2(filePath)).isFile()) continue;
       } catch {

package/dist/guidance.md

@@ -1,71 +1,20 @@
-# sourcefed — monitoring guidance
+# sourcefed monitors
 
-sourcefed is a monitor service. It lets you create **monitors** that watch a Jira issue, GitHub
-PR, or Slack thread and route NEW events into the host session where the monitor was created.
-The OpenCode and Pi adapters drive the Sourcefed daemon client (`@sourcefed/daemon`) for
-monitor tools and event delivery; the same daemon can be served through MCP (`@sourcefed/mcp`)
-or driven directly by the CLI.
+Monitors watch a Jira issue, GitHub PR, or Slack thread and bring new events into this session.
 
-All transports speak the same daemon JSON protocol over HTTP (`POST /rpc` +
-`GET /events` SSE). The MCP adapter adds the 2026 resource-subscription flow
-(`subscriptions/listen`, `notifications/resources/updated`, `monitor_events_ack`)
-on top. When `SOURCEFED_DAEMON_URL` is unset, the OpenCode and Pi adapters
-spawn one local HTTP daemon automatically (if none is running) and connect to it.
+Create one with `monitor_create` when:
 
-## When to create a monitor
+- you work on a Jira ticket: `{ name: "<key>", sourceType: "jira", issueKey: "PROJ-123" }`
+  (new comments, edits, status, assignee, priority, labels);
+- your branch has a PR: `{ name: "<pr>", sourceType: "github", repo: "owner/name", prNumber: 42 }`
+  (reviews, comments, CI failures, conflicts, merge or close);
+- you were given a Slack thread: `{ name: "<thread>", sourceType: "slack", threadUrl: "<url>" }`
+  (new messages; read-only, never replies).
 
-- **You found or are working on a Jira ticket** → create a Jira monitor for its issue key. You
-  will be notified of new comments, description edits, and summary/status/assignee/priority/label changes.
-- **You are on a branch with an active PR (or just opened one)** → create a GitHub monitor for
-  `repo#prNumber`. You will be notified of new reviews (including bot reviews), PR and
-  line-level comments, CI failures, merge conflicts, and the PR being merged or closed.
-- **You were given a Slack thread** → create a Slack monitor for the thread URL. It is
-  detect-only: it reads new messages and routes notifications into this session, but never replies.
+Keep the default `pollIntervalSec` unless the work is time-sensitive (min 15).
+`monitor_list`, `monitor_status { id }` and `monitor_stop { id }` act on this session's monitors.
+GitHub monitors end when the PR merges.
 
-## How to create one
-
-Use the `monitor_create` tool:
-
-- Jira: `monitor_create({ name: "<key>", sourceType: "jira", issueKey: "PROJ-12345" })`
-- GitHub: `monitor_create({ name: "<pr>", sourceType: "github", repo: "owner/name", prNumber: 42 })`
-- Slack: `monitor_create({ name: "<thread>", sourceType: "slack", threadUrl: "<slack-thread-url>" })`
-
-GitHub and Slack use webhook delivery when configured and fall back to polling when unavailable.
-Jira always uses polling. Slack monitors are
-always detect-only and never reply. You can lower
-`pollIntervalSec` (min 15) for time-sensitive work, but prefer the default to avoid hammering APIs.
-Actionable events trigger an agent turn. Stable all-passing CI is suppressed to avoid notification noise; other informational events are added as context only.
-
-The abstract `Monitor` consolidates transport fallback and recovery and composes whichever
-generic `PollMonitor` and `WebhookMonitor` transports a source exposes as class attributes.
-Each provider is its own package (`@sourcefed/provider-{jira,github,slack}`) with monitor and
-event modules; the built-in registry (`SOURCE_MAP`) is composed by the daemon, which imports
-the provider packages directly. Jira exposes only polling;
-GitHub and Slack expose both. Do not add source-specific transport branches to tools,
-scheduling, or the daemon.
-
-## Skills
-
-The CLI bundles skills that teach agents how to use sourcefed, in the agent-browser style: a
-thin discovery stub points at CLI-served content that always matches the installed version.
-
-```bash
-sourcefed skills           # list available skills
-sourcefed skills get core  # load the core usage guide (--full adds references)
-```
-
-## Lifecycle
-
-- Monitors belong to the target that created them; list, status, and stop only affect that target's monitors.
-- `monitor_list` — see monitors created by this session.
-- `monitor_status { id }` — detail on one of this session's monitors.
-- `monitor_stop { id }` — stop routing events for one of this session's monitors.
-- GitHub monitors remove themselves after the PR is merged. Jira monitors remove themselves when
-  `SOURCEFED_JIRA_TERMINAL_STATUS` matches the issue status; leave it unset to disable automatic Jira removal.
-
-## When an event arrives
-
-Events are fed into your session as a message (e.g. a new review comment, a CI failure, a Jira
-status change). Treat it like any new input: read it, decide whether it needs action, and act
-(or tell the user it needs a decision). If the event is non-actionable (e.g. CI all-passing),
-acknowledge it and move on — do not fabricate work from it.
+An event arrives as a message. Act on it if it needs action, or tell the user it needs a
+decision; acknowledge an informational one (such as CI passing) and move on. Never invent work
+from it. `sourcefed skills get core` has the full guide.

package/dist/opencode.js

@@ -24,6 +24,7 @@ import { fileURLToPath } from "node:url";
 import { Rpc } from "@opencode/plugin";
 var TARGET_KIND = "opencode-session";
 var GATE_TIMEOUT_MS = 3e3;
+var RESUBSCRIBE_MS = 15e3;
 var ChauffeurGate = Rpc.define({
   id: "chauffeur",
   methods: {
@@ -61,8 +62,15 @@ var OpenCodeBridge = class {
   listeners = /* @__PURE__ */ new Map();
   lastAttemptAt = 0;
   lastError;
+  timer;
+  /**
+   * Chauffeur or the CLI can create a monitor for a session here at any time,
+   * without this bridge's tools, so check for new targets periodically too.
+   */
   async start() {
     await this.ensureDaemon();
+    this.timer = setInterval(() => void this.refresh(), RESUBSCRIBE_MS);
+    this.timer.unref?.();
   }
   async ensureTarget(sessionID) {
     await this.ensureDaemon();
@@ -91,11 +99,17 @@ var OpenCodeBridge = class {
     return this.daemon.request(name.replace(/_/g, "."), { ...arguments_, target: this.target(sessionID) });
   }
   async close() {
+    clearInterval(this.timer);
+    this.timer = void 0;
     for (const pending of this.listeners.values()) await pending.then((listener) => listener.close(), () => void 0);
     this.listeners.clear();
     await this.daemon?.close();
     this.daemon = void 0;
   }
+  async refresh() {
+    if (!this.daemon) return this.ensureDaemon();
+    await this.resubscribe();
+  }
   async ensureDaemon() {
     if (this.daemon) return;
     if (Date.now() - this.lastAttemptAt < 15e3) return;
@@ -123,6 +137,7 @@ var OpenCodeBridge = class {
     }
   }
   async resubscribeTarget(sessionID) {
+    if (this.listeners.has(sessionID)) return;
     const exists = await this.session.get({ sessionID }).then(() => true, () => false);
     if (!exists) return;
     await this.ensureTarget(sessionID).catch((error) => {
@@ -325,12 +340,13 @@ var opencode_default = Plugin.define({
 
 // packages/sourcefed/src/server.ts
 var guidance = readFileSync(fileURLToPath2(new URL("./guidance.md", import.meta.url)), "utf8");
+var heading = guidance.split("\n", 1)[0] ?? guidance;
 var server_default = Plugin2.define({
   id: "sourcefed",
   async setup(ctx) {
     const cleanup = await setupSourcefed(ctx);
     await ctx.session.hook("context", (event) => {
-      if (!event.system.some((part) => part.type === "text" && part.text.includes("sourcefed"))) {
+      if (!event.system.some((part) => part.type === "text" && part.text.includes(heading))) {
         event.system.push({ type: "text", text: guidance });
       }
     });

package/dist/tui-compiled.mjs

@@ -59,38 +59,43 @@ function Sidebar(props) {
   void refresh();
   const timer = setInterval(() => void refresh(), REFRESH_MS);
   onCleanup(() => clearInterval(timer));
-  return (() => {
-    var _el$ = _$createElement("box"), _el$2 = _$createElement("box"), _el$3 = _$createElement("text"), _el$5 = _$createElement("text"), _el$6 = _$createTextNode(` (`), _el$7 = _$createTextNode(`)`);
-    _$insertNode(_el$, _el$2);
-    _$setProp(_el$, "flexDirection", "column");
-    _$setProp(_el$, "width", "100%");
-    _$setProp(_el$, "marginTop", 1);
-    _$insertNode(_el$2, _el$3);
-    _$insertNode(_el$2, _el$5);
-    _$setProp(_el$2, "flexDirection", "row");
-    _$setProp(_el$2, "width", "100%");
-    _$insertNode(_el$3, _$createTextNode(`Sourcefed`));
-    _$insertNode(_el$5, _el$6);
-    _$insertNode(_el$5, _el$7);
-    _$insert(_el$5, () => active().length, _el$7);
-    _$insert(_el$, _$createComponent(MonitorRows, {
-      monitors: active,
-      get tone() {
-        return palette();
-      },
-      compact: true
-    }), null);
-    _$effect((_p$) => {
-      var _v$ = palette().accent, _v$2 = palette().textMuted;
-      _v$ !== _p$.e && (_p$.e = _$setProp(_el$3, "fg", _v$, _p$.e));
-      _v$2 !== _p$.t && (_p$.t = _$setProp(_el$5, "fg", _v$2, _p$.t));
-      return _p$;
-    }, {
-      e: void 0,
-      t: void 0
-    });
-    return _el$;
-  })();
+  return _$createComponent(Show, {
+    get when() {
+      return active().length > 0;
+    },
+    get children() {
+      var _el$ = _$createElement("box"), _el$2 = _$createElement("box"), _el$3 = _$createElement("text"), _el$5 = _$createElement("text"), _el$6 = _$createTextNode(` (`), _el$7 = _$createTextNode(`)`);
+      _$insertNode(_el$, _el$2);
+      _$setProp(_el$, "flexDirection", "column");
+      _$setProp(_el$, "width", "100%");
+      _$setProp(_el$, "marginTop", 1);
+      _$insertNode(_el$2, _el$3);
+      _$insertNode(_el$2, _el$5);
+      _$setProp(_el$2, "flexDirection", "row");
+      _$setProp(_el$2, "width", "100%");
+      _$insertNode(_el$3, _$createTextNode(`Sourcefed`));
+      _$insertNode(_el$5, _el$6);
+      _$insertNode(_el$5, _el$7);
+      _$insert(_el$5, () => active().length, _el$7);
+      _$insert(_el$, _$createComponent(MonitorRows, {
+        monitors: active,
+        get tone() {
+          return palette();
+        },
+        compact: true
+      }), null);
+      _$effect((_p$) => {
+        var _v$ = palette().accent, _v$2 = palette().textMuted;
+        _v$ !== _p$.e && (_p$.e = _$setProp(_el$3, "fg", _v$, _p$.e));
+        _v$2 !== _p$.t && (_p$.t = _$setProp(_el$5, "fg", _v$2, _p$.t));
+        return _p$;
+      }, {
+        e: void 0,
+        t: void 0
+      });
+      return _el$;
+    }
+  });
 }
 function MonitorRows(props) {
   const visible = createMemo(() => props.monitors().slice(0, 4));
@@ -98,41 +103,26 @@ function MonitorRows(props) {
     var _el$8 = _$createElement("box");
     _$setProp(_el$8, "flexDirection", "column");
     _$setProp(_el$8, "width", "100%");
-    _$insert(_el$8, _$createComponent(Show, {
-      get when() {
-        return visible().length > 0;
-      },
-      get fallback() {
-        return (() => {
-          var _el$1 = _$createElement("text");
-          _$insertNode(_el$1, _$createTextNode(`No active monitors`));
-          _$effect((_$p) => _$setProp(_el$1, "fg", props.tone.textMuted, _$p));
-          return _el$1;
-        })();
-      },
-      get children() {
-        return visible().map((monitor) => (() => {
-          var _el$11 = _$createElement("box"), _el$12 = _$createElement("text"), _el$13 = _$createElement("text"), _el$14 = _$createTextNode(` `);
-          _$insertNode(_el$11, _el$12);
-          _$insertNode(_el$11, _el$13);
-          _$setProp(_el$11, "flexDirection", "row");
-          _$setProp(_el$11, "width", "100%");
-          _$insert(_el$12, () => monitor.icon);
-          _$insertNode(_el$13, _el$14);
-          _$insert(_el$13, () => monitor.name, null);
-          _$effect((_p$) => {
-            var _v$3 = monitorTone(monitor, props.tone), _v$4 = props.tone.textMuted;
-            _v$3 !== _p$.e && (_p$.e = _$setProp(_el$12, "fg", _v$3, _p$.e));
-            _v$4 !== _p$.t && (_p$.t = _$setProp(_el$13, "fg", _v$4, _p$.t));
-            return _p$;
-          }, {
-            e: void 0,
-            t: void 0
-          });
-          return _el$11;
-        })());
-      }
-    }), null);
+    _$insert(_el$8, () => visible().map((monitor) => (() => {
+      var _el$1 = _$createElement("box"), _el$10 = _$createElement("text"), _el$11 = _$createElement("text"), _el$12 = _$createTextNode(` `);
+      _$insertNode(_el$1, _el$10);
+      _$insertNode(_el$1, _el$11);
+      _$setProp(_el$1, "flexDirection", "row");
+      _$setProp(_el$1, "width", "100%");
+      _$insert(_el$10, () => monitor.icon);
+      _$insertNode(_el$11, _el$12);
+      _$insert(_el$11, () => monitor.name, null);
+      _$effect((_p$) => {
+        var _v$3 = monitorTone(monitor, props.tone), _v$4 = props.tone.textMuted;
+        _v$3 !== _p$.e && (_p$.e = _$setProp(_el$10, "fg", _v$3, _p$.e));
+        _v$4 !== _p$.t && (_p$.t = _$setProp(_el$11, "fg", _v$4, _p$.t));
+        return _p$;
+      }, {
+        e: void 0,
+        t: void 0
+      });
+      return _el$1;
+    })()), null);
     _$insert(_el$8, _$createComponent(Show, {
       get when() {
         return _$memo(() => !!props.compact)() && visible().length < props.monitors().length;

package/dist.dts/adapters/opencode/bridge.d.ts

@@ -8,11 +8,17 @@ export declare class OpenCodeBridge {
     private readonly listeners;
     private lastAttemptAt;
     private lastError;
+    private timer;
     constructor(session: SessionDomain, rpc?: RpcDomain | undefined);
+    /**
+     * Chauffeur or the CLI can create a monitor for a session here at any time,
+     * without this bridge's tools, so check for new targets periodically too.
+     */
     start(): Promise<void>;
     ensureTarget(sessionID: string): Promise<void>;
     callTool(name: string, arguments_: Record<string, unknown>, sessionID: string): Promise<unknown>;
     close(): Promise<void>;
+    private refresh;
     private ensureDaemon;
     /**
      * Monitors outlive this process, so after a restart nothing listens for their

package/dist.dts/packages/cli/src/utils/setup.d.ts

@@ -1,3 +1,2 @@
 export declare function setupSpec(): string;
 export declare function setupHost(name: string, args: string[], spec: string): Promise<boolean>;
-export declare function configureOpenCodeCliPlugin(spec: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fdcn/sourcefed",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Live Jira, GitHub, and Slack monitoring for agent hosts: CLI, daemon, MCP server, and host plugins.",
   "license": "MIT",
   "type": "module",