m365-roadmap-mcp 0.3.0__py3-none-any.whl → 0.3.1__py3-none-any.whl

m365_roadmap_mcp/server.py

@@ -27,7 +27,8 @@ mcp = FastMCP(
         "- platform: filter by platform ('Web', 'Desktop', 'iOS', 'Android', 'Mac')\n"
         "- rollout_date: filter by rollout start date (e.g. 'December 2026')\n"
         "- preview_date: filter by preview availability date (e.g. 'July 2026')\n"
-        "- modified_within_days: show only features modified within N days\n\n"
+        "- modified_within_days: show only features modified within N days\n"
+        "- include_facets: include taxonomy facets with counts (default: False)\n\n"
         "Tips:\n"
         "- To get feature details, use feature_id with the roadmap ID.\n"
         "- To check cloud availability, use cloud_instance with a feature_id or "
@@ -35,7 +36,8 @@ mcp = FastMCP(
         "supported instances.\n"
         "- To list recent additions, use added_within_days (e.g. 30 for last month).\n"
         "- To filter by release phase or platform, use release_phase or platform filters.\n"
-        "- To search by dates, use rollout_date or preview_date with partial date strings."
+        "- To search by dates, use rollout_date or preview_date with partial date strings.\n"
+        "- To discover available filter values, use include_facets=True (optionally with limit=0)."
     ),
 )
 

m365_roadmap_mcp/tools/search.py

@@ -1,8 +1,55 @@
 """Search tool for querying and filtering M365 Roadmap features."""
 
+from collections import Counter
 from datetime import datetime, timedelta, timezone
 
 from ..feeds.m365_api import fetch_features
+from ..models.feature import RoadmapFeature
+
+
+def compute_facets(features: list[RoadmapFeature]) -> dict:
+    """Compute facet counts from a list of features.
+
+    Args:
+        features: List of RoadmapFeature objects to analyze
+
+    Returns:
+        Dictionary with facet categories and counts
+    """
+    products = Counter()
+    statuses = Counter()
+    release_phases = Counter()
+    platforms = Counter()
+    cloud_instances = Counter()
+
+    for feature in features:
+        # Products (from tags)
+        for tag in feature.tags:
+            products[tag] += 1
+
+        # Status
+        if feature.status:
+            statuses[feature.status] += 1
+
+        # Release phases
+        for rp in feature.release_phases:
+            release_phases[rp] += 1
+
+        # Platforms
+        for p in feature.platforms:
+            platforms[p] += 1
+
+        # Cloud instances
+        for ci in feature.cloud_instances:
+            cloud_instances[ci] += 1
+
+    return {
+        "products": [{"name": k, "count": v} for k, v in products.most_common()],
+        "statuses": [{"name": k, "count": v} for k, v in statuses.most_common()],
+        "release_phases": [{"name": k, "count": v} for k, v in release_phases.most_common()],
+        "platforms": [{"name": k, "count": v} for k, v in platforms.most_common()],
+        "cloud_instances": [{"name": k, "count": v} for k, v in cloud_instances.most_common()],
+    }
 
 
 async def search_roadmap(
@@ -17,6 +64,7 @@ async def search_roadmap(
     rollout_date: str | None = None,
     preview_date: str | None = None,
     modified_within_days: int | None = None,
+    include_facets: bool = False,
     limit: int = 10,
 ) -> dict:
     """Search the Microsoft 365 Roadmap for features matching keywords and filters.
@@ -61,6 +109,10 @@ async def search_roadmap(
             against publicPreviewDate, e.g. "July 2026").
         modified_within_days: Optional number of days to look back for recently modified
             features (clamped to 1-365).
+        include_facets: When True, includes taxonomy facets (products, statuses,
+            release_phases, platforms, cloud_instances) with occurrence counts in
+            the response. Use with limit=0 to get only facets without features.
+            Facets are computed from matched results after filters are applied.
         limit: Maximum number of results to return (default: 10, max: 100).
             Ignored when feature_id is provided.
 
@@ -69,6 +121,7 @@ async def search_roadmap(
         - total_found: Number of features matching the filters (before applying limit)
         - features: List of matching feature objects (up to limit)
         - filters_applied: Summary of which filters were used
+        - facets: (Optional) Dictionary with facet categories and counts when include_facets=True
     """
     features = await fetch_features()
 
@@ -87,8 +140,9 @@ async def search_roadmap(
             "filters_applied": {"feature_id": feature_id},
         }
 
-    # Clamp limit to reasonable bounds
-    limit = max(1, min(limit, 100))
+    # Clamp limit to reasonable bounds (allow 0 when only requesting facets)
+    min_limit = 0 if include_facets else 1
+    limit = max(min_limit, min(limit, 100))
 
     # Compute recency cutoff if requested
     cutoff = None
@@ -141,13 +195,25 @@ async def search_roadmap(
                 continue
 
         # Rollout date filter (partial match against publicDisclosureAvailabilityDate)
+        # API uses "CY" prefix (e.g., "December CY2026") but users typically omit it
         if rollout_date_lower:
-            if not feature.public_disclosure_date or rollout_date_lower not in feature.public_disclosure_date.lower():
+            if not feature.public_disclosure_date:
+                continue
+            # Normalize by removing "cy" prefix for comparison
+            normalized_date = feature.public_disclosure_date.lower().replace(" cy", " ")
+            normalized_query = rollout_date_lower.replace(" cy", " ")
+            if normalized_query not in normalized_date:
                 continue
 
         # Preview date filter (partial match against publicPreviewDate)
+        # API uses "CY" prefix (e.g., "July CY2026") but users typically omit it
         if preview_date_lower:
-            if not feature.public_preview_date or preview_date_lower not in feature.public_preview_date.lower():
+            if not feature.public_preview_date:
+                continue
+            # Normalize by removing "cy" prefix for comparison
+            normalized_date = feature.public_preview_date.lower().replace(" cy", " ")
+            normalized_query = preview_date_lower.replace(" cy", " ")
+            if normalized_query not in normalized_date:
                 continue
 
         # Keyword search (title + description)
@@ -213,8 +279,15 @@ async def search_roadmap(
     if not filters_applied:
         filters_applied["note"] = "No filters applied, returning most recent features"
 
-    return {
+    # Build response
+    result = {
         "total_found": len(matched),
         "features": [f.to_dict() for f in matched[:limit]],
         "filters_applied": filters_applied,
     }
+
+    # Add facets if requested (computed from matched results)
+    if include_facets:
+        result["facets"] = compute_facets(matched)
+
+    return result

{m365_roadmap_mcp-0.3.0.dist-info → m365_roadmap_mcp-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: m365-roadmap-mcp
-Version: 0.3.0
+Version: 0.3.1
 Summary: MCP server for querying the Microsoft 365 Roadmap
 Project-URL: Homepage, https://github.com/jonnybottles/M365-roadmap-mcp-server
 Project-URL: Repository, https://github.com/jonnybottles/M365-roadmap-mcp-server
@@ -189,6 +189,11 @@ Provides a single **`search_roadmap`** tool that handles all M365 roadmap querie
 - **Cloud instance filter** -- Filter by cloud instance (GCC, GCC High, DoD)
 - **Feature lookup** -- Retrieve full metadata for a specific roadmap ID
 - **Recent additions** -- List features added within the last N days
+- **Release phase filter** -- Filter by release phase (General Availability, Preview, Targeted Release)
+- **Platform filter** -- Filter by platform (Web, Desktop, iOS, Android, Mac)
+- **Rollout date filter** -- Filter by rollout start date (e.g., "December 2026", "2026")
+- **Preview date filter** -- Filter by preview availability date (e.g., "July 2026")
+- **Recently modified** -- List features modified within the last N days
 
 ## Data Source
 

{m365_roadmap_mcp-0.3.0.dist-info → m365_roadmap_mcp-0.3.1.dist-info}/RECORD

@@ -1,6 +1,6 @@
 m365_roadmap_mcp/__init__.py,sha256=ydNG2ztexAZvnKchX4y1FnQ_atvfc1WGa4E8Y45lPjk,96
 m365_roadmap_mcp/__main__.py,sha256=D9mYXV4TlB361LHfDDwvxsybz0_7EUsseJ3pZkS9AOo,84
-m365_roadmap_mcp/server.py,sha256=jO47eBfPs8SOYySjs9WUR2u4NXChW_I4iCOOQdEjg9A,2785
+m365_roadmap_mcp/server.py,sha256=bRqk4b51sRdfrv1r5g-s4Qc-opVTurHryLLHKjn3RLI,2970
 m365_roadmap_mcp/feeds/__init__.py,sha256=mVerRhM3n8iwoiupqp4rhqOGOpR2WbtA6MErj5pLG3g,38
 m365_roadmap_mcp/feeds/m365_api.py,sha256=Elkx_4N42H8v-b93Y9jbt5y2zq6jB8gbWZAjQ3dwWVA,2594
 m365_roadmap_mcp/models/__init__.py,sha256=Ml_sDvBRyK40Pq4Of0pDExGEBTjyh0QWB4VLu_zKkks,112
@@ -9,9 +9,9 @@ m365_roadmap_mcp/tools/__init__.py,sha256=nsNOC46HR1ElncjDck0CjOyeCkh1ZugH8YOiaC
 m365_roadmap_mcp/tools/cloud.py,sha256=NuvztbKyMLc9pKZYD98kih23e09dAKnAeaEXZig2ky0,2562
 m365_roadmap_mcp/tools/details.py,sha256=jgIpi1BhraHPuMT9tQi3d8ikvLF0EZR7p_D7spNlWL0,1067
 m365_roadmap_mcp/tools/recent.py,sha256=Y9I5SS0I2MsV0i98QKtzXrL14AF5yfEyC3f6RiAxj-g,1709
-m365_roadmap_mcp/tools/search.py,sha256=Baoh9Gc7XsBlrsTXIoN_KVPYmEnW6ExMva9Wqad6kg8,9344
-m365_roadmap_mcp-0.3.0.dist-info/METADATA,sha256=ZRUqG71qDlw4uZTAwwIwfYZtamgYBSuUnnT04vCJJFs,7502
-m365_roadmap_mcp-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-m365_roadmap_mcp-0.3.0.dist-info/entry_points.txt,sha256=GNzyIHa06s1_7BMZzkI4Dsury7aBgUmOYiSXFGNgE6M,66
-m365_roadmap_mcp-0.3.0.dist-info/licenses/LICENSE,sha256=NNt5lEWzqGxqVCVmj-VEeWFxXhtbgCNwFhYcCUffWDI,1071
-m365_roadmap_mcp-0.3.0.dist-info/RECORD,,
+m365_roadmap_mcp/tools/search.py,sha256=IaRRHfWF3FixF709oiVgxxtYE4lXHuIWl0HMshFqnNA,12146
+m365_roadmap_mcp-0.3.1.dist-info/METADATA,sha256=kh3J7VH6yEyt6tOFf39rW1mXFG0qH45pRZ9b7y0KU3A,7932
+m365_roadmap_mcp-0.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+m365_roadmap_mcp-0.3.1.dist-info/entry_points.txt,sha256=GNzyIHa06s1_7BMZzkI4Dsury7aBgUmOYiSXFGNgE6M,66
+m365_roadmap_mcp-0.3.1.dist-info/licenses/LICENSE,sha256=NNt5lEWzqGxqVCVmj-VEeWFxXhtbgCNwFhYcCUffWDI,1071
+m365_roadmap_mcp-0.3.1.dist-info/RECORD,,