Struct RoadmapFilter 

pub struct RoadmapFilter {
    pub period_from: Option<String>,
    pub period_to: Option<String>,
    pub owner: Option<String>,
    pub status: Option<String>,
    pub labels: Vec<String>,
    pub query: Option<String>,
}

The normalized cross-surface roadmap filter (data-model §3).

All criteria are optional, so the default value is the empty filter; an empty filter narrows nothing and selects every initiative. The field names are the serialized names (see the serde attributes) and are stable: they are what the MCP tool arguments and the local portable DTO carry, so a renamed field would be a breaking change to every surface at once.

Unknown serialized fields are refused (deny_unknown_fields), which is deliberate: with a permissive reader a typo’d key ("ownerr") would silently drop the criterion and return more rows than asked for. A filter is a strict input; the forward-compatibility budget this mission spends is on the preserved initiative extensions, not on a query language.

Fields

period_from: Option<String>

Inclusive lower bound on the initiative target date (YYYY-MM-DD).

period_to: Option<String>

Inclusive upper bound on the initiative target date (YYYY-MM-DD).

owner: Option<String>

Owner identity to match; compared trimmed and case-insensitively.

status: Option<String>

Initiative status to match; compared trimmed and case-insensitively.

labels: Vec<String>

Labels the initiative must all carry; each compared trimmed and case-insensitively, order irrelevant.

query: Option<String>

Free text matched case-insensitively against name/outcome/owner/status/labels.

Implementations

impl RoadmapFilter

pub fn is_empty(&self) -> bool

Whether this filter carries no criterion at all — the documented “no filter” value.

RoadmapFilter::default() is the empty filter, so a call site that supports “show everything” has one value to pass rather than four Nones it must keep in step. A blank query counts as absent because it narrows nothing; blank owner/status/labels are refusals and so are assumed absent here once Self::validate has run.

pub fn validate(&self) -> Result<()>

Validate the filter’s syntax before any projection runs.

Refuses: a period_from/period_to that is not a YYYY-MM-DD calendar date (the shared crate::model::validate_date rule, the same one the record’s own loader uses), a period whose lower bound is after its upper bound, and a present-but-blank owner, status, or labels entry. A well-formed value that names no initiative is not refused — it matches nothing (see the module docs).

pub fn matches(&self, initiative: &InitiativeConfiguration) -> bool

Whether one initiative record satisfies every criterion this filter sets.

Purely read-only: it inspects the record and mutates nothing. An empty filter matches every record.

Trait Implementations

impl Clone for RoadmapFilter

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RoadmapFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RoadmapFilter

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RoadmapFilter

where RoadmapFilter: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for RoadmapFilter

impl PartialEq for RoadmapFilter

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for RoadmapFilter

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RoadmapFilter