@fdcn/sourcefed 0.3.7 → 0.4.0

package/dist/data/core/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: core
-description: Core sourcefed usage guide. Read this before creating monitors. Covers monitor creation per source (Jira issue, GitHub PR, Slack thread), event delivery and acknowledgement semantics, daemon modes, CLI usage, and troubleshooting. Use when the user asks to watch or monitor a Jira ticket, GitHub PR, Slack thread, or when sourcefed monitor events arrive in the session.
+description: Core sourcefed usage guide. Read this before creating monitors. Covers monitor creation per source (Jira issue, GitHub PR, Slack thread, Yab feed), event delivery and acknowledgement semantics, daemon modes, CLI usage, and troubleshooting. Use when the user asks to watch or monitor a Jira ticket, GitHub PR, Slack thread, a feed or inbox they are signed in to in Yab, or when sourcefed monitor events arrive in the session.
 ---
 
 # Sourcefed core
 
-Sourcefed lets you create **monitors** that watch a Jira issue, GitHub PR, or
-Slack thread or direct-message conversation and route NEW events into the session you're currently working in,
+Sourcefed lets you create **monitors** that watch a Jira issue, GitHub PR,
+Slack thread or direct-message conversation, or a feed read through Yab, and route NEW events into the session you're currently working in,
 so you can react to them as they happen.
 
 Every monitor is detect-only: it routes events into the session and never
@@ -21,6 +21,7 @@ affect that session's monitors.
 - **GitHub PR**: `monitor_create({ name: "PR #42", sourceType: "github", repo: "owner/repo", prNumber: 42 })`
 - **Slack thread**: `monitor_create({ name: "thread", sourceType: "slack", threadUrl: "<thread-url>" })`
 - **Whole Slack DM**: `monitor_create({ name: "DM with Alex", sourceType: "slack", channelId: "D0123456789" })`
+- **Yab feed**: `monitor_create({ name: "inbox", sourceType: "yab", url: "https://mail.google.com/mail/u/0/feed/atom", space: "Personal", match: "interview|offer", exclude: "newsletter" })`
 
 You will be notified of:
 
@@ -30,9 +31,13 @@ You will be notified of:
 - **Slack thread**: new replies in the thread.
 - **Slack DM**: new top-level messages in the DM. Slack monitors are always detect-only
   and never reply.
+- **Yab feed**: each new entry of an Atom, RSS or JSON feed, read through the user's Yab
+  browser with their sign-ins (so private feeds like Gmail's unread-inbox feed work).
+  `space` picks the Yab space; `match`/`exclude` are case-insensitive regexes over the
+  entry's title, summary and author. Yab must be running.
 
 GitHub and Slack use webhook delivery when configured and fall back to polling
-when unavailable. Jira always uses polling. You can lower `pollIntervalSec`
+when unavailable. Jira and Yab always use polling. You can lower `pollIntervalSec`
 (min 15) for time-sensitive work, but prefer the default to avoid hammering
 APIs.
 

package/dist/data/core/references/commands.md

@@ -26,13 +26,17 @@ sourcefed skills path [name]                Print skill directory path
 
 ```text
 --name NAME           Human-readable monitor name (defaults to the source type)
---source-type TYPE    jira | github | slack
+--source-type TYPE    jira | github | slack | yab
 --issue-key KEY       Jira issue key (jira)
 --repo OWNER/NAME     GitHub repository (github)
 --pr-number N         GitHub PR number (github)
 --channel-id ID       Slack channel or DM ID; a D… ID alone monitors the whole DM
 --thread-ts TS        Slack parent message timestamp; omit for a whole-DM monitor
 --thread-url URL      Slack thread URL (slack)
+--url URL             Atom, RSS or JSON feed URL read through Yab (yab)
+--space NAME          Yab space whose sign-ins to use (yab)
+--match REGEX         Only deliver entries matching this case-insensitive regex (yab)
+--exclude REGEX       Skip entries matching this case-insensitive regex (yab)
 --poll-interval-sec N Poll interval in seconds (min 15)
 --target-kind KIND    Target kind for ownership scoping (default: cli)
 --target-id ID        Target id for ownership scoping (default: hostname)
@@ -54,6 +58,7 @@ SOURCEFED_JIRA_TERMINAL_STATUS  Jira status that auto-removes monitors
 GH_TOKEN / GITHUB_TOKEN         GitHub token for direct API polling
 SOURCEFED_GITHUB_WEBHOOK_SECRET GitHub webhook secret (enables webhooks)
 SOURCEFED_SLACK_SIGNING_SECRET  Slack signing secret (enables webhooks)
+SOURCEFED_YAB_COMMAND           Yab binary for yab monitors (default /Applications/yab.app/Contents/MacOS/yab)
 SOURCEFED_SKILLS_DIR            Override the bundled skills directory
 ```
 

package/dist/data/sourcefed/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: sourcefed
-description: Live Jira, GitHub, and Slack monitoring for agent hosts. Create monitors that route new issue comments, PR reviews, CI failures, and Slack thread or DM messages into the current session as they happen.
+description: Live Jira, GitHub, Slack, and Yab feed monitoring for agent hosts. Create monitors that route new issue comments, PR reviews, CI failures, Slack thread or DM messages, and new entries of feeds read through Yab into the current session as they happen.
 hidden: true
 ---
 
 # Sourcefed
 
 Sourcefed turns external collaboration threads into live agent input: create a
-monitor for a Jira issue, GitHub PR, Slack thread, or Slack DM and NEW events are routed
+monitor for a Jira issue, GitHub PR, Slack thread, Slack DM, or a feed read through Yab and NEW events are routed
 into the session you are working in, so you can react to them as they happen.
 
 This file is a discovery stub, not the usage guide. Before running any
@@ -25,6 +25,7 @@ releases, which is why it just points at `skills get core`.
 ## When to load this skill
 
 - A user asks to monitor a Jira ticket, GitHub PR, Slack thread, or Slack DM.
+- A user wants to hear about new entries in a feed or inbox they are signed in to in Yab.
 - You found or are working on a Jira ticket, PR, thread, or DM and want new
   activity routed into your session.
 - You opened a PR and want to be notified of reviews, comments, CI failures,

package/dist/guidance.md

@@ -1,6 +1,7 @@
 # sourcefed monitors
 
-Monitors watch a Jira issue, GitHub PR, or Slack thread and bring new events into this session.
+Monitors watch a Jira issue, GitHub PR, Slack thread, or a feed read through Yab and bring new events
+into this session.
 
 Create one with `monitor_create` when:
 
@@ -9,7 +10,10 @@ Create one with `monitor_create` when:
 - 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).
+  (new messages; read-only, never replies);
+- the user wants new entries of a feed they are signed in to in Yab (unread Gmail, a job board's RSS):
+  `{ name: "<feed>", sourceType: "yab", url: "https://mail.google.com/mail/u/0/feed/atom", space: "Personal", match: "interview|offer" }`
+  (each new entry; `match`/`exclude` are case-insensitive regexes; Yab must be running).
 
 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.