@fdcn/sourcefed 0.3.4 → 0.3.5

package/README.md

@@ -33,12 +33,12 @@ OpenCode loads this package as both a server and a TUI plugin:
 
 ```json
 // ~/.config/opencode/opencode.jsonc
-{ "plugins": ["@fdcn/sourcefed@0.3.4"] }
+{ "plugins": ["@fdcn/sourcefed@0.3.5"] }
 ```
 
 ```json
 // ~/.config/opencode/cli.json
-{ "plugins": ["@fdcn/sourcefed@0.3.4"] }
+{ "plugins": ["@fdcn/sourcefed@0.3.5"] }
 ```
 
 The package exposes `./server`, `./tui`, `./opencode`, `./opencode/tui`, and `./pi` entrypoints for hosts that load them directly.

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.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/package.json

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