Struct FileCardSubscriber 

pub struct FileCardSubscriber { /* private fields */ }

A subscriber that mirrors events to a local directory using the same two-tier layout as FileCardStore:

• {root}/{pkg}/{card_id}.toml — Card TOML
• {root}/{pkg}/{card_id}.samples.jsonl — samples sidecar
• {root}/_aliases.toml — global alias table

Implementations

impl FileCardSubscriber

pub fn new(root: PathBuf) -> Self

Construct a subscriber rooted at root. The canonical URI is computed once and returned from Self::describe.

pub fn locate_card(&self, card_id: &str) -> Result<Option<PathBuf>, String>

Scan the subscriber root for a Card with card_id under any {pkg} subdirectory. Returns Ok(None) when the root itself does not exist yet (subscribers are write-once lazy).

Trait Implementations

impl CardSubscriber for FileCardSubscriber

fn has_card(&self, card_id: &str) -> Result<bool, String>

Delegates to FileCardSubscriber::locate_card. A non-existent root (subscriber has never been written to) returns Ok(false), which is the correct “backfill needed” answer.

fn on_event(&self, ev: &CardEvent) -> Result<(), String>

Handle one event. Returning Err records a failure in SubscriberStats and emits a tracing::warn!, but does not propagate to the caller of the _with_store API.

fn describe(&self) -> String

Canonical identity URI for this subscriber. Used as the key in SubscriberStats and as the match target for CardEventBus::publish_to.