m365-roadmap-mcp 0.3.0__tar.gz → 0.3.1__tar.gz

{m365_roadmap_mcp-0.3.0 → m365_roadmap_mcp-0.3.1}/PKG-INFO

@@ -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 → m365_roadmap_mcp-0.3.1}/README.md

@@ -163,6 +163,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 → m365_roadmap_mcp-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "m365-roadmap-mcp"
-version = "0.3.0"
+version = "0.3.1"
 description = "MCP server for querying the Microsoft 365 Roadmap"
 readme = "README.md"
 license = "MIT"

{m365_roadmap_mcp-0.3.0 → m365_roadmap_mcp-0.3.1}/src/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-0.3.0 → m365_roadmap_mcp-0.3.1}/src/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 → m365_roadmap_mcp-0.3.1}/tests/test_tools.py

@@ -587,3 +587,75 @@ async def test_december_2026_includes_universal_print():
     # This should be true if the original issue is fixed
     assert result["total_found"] > 0, "Should return features for December CY2026"
     assert has_universal_print, "Universal Print feature should be in December CY2026 results"
+
+
+@pytest.mark.asyncio
+async def test_include_facets_basic():
+    """include_facets=True returns facets with counts."""
+    from m365_roadmap_mcp.tools.search import search_roadmap
+
+    result = await search_roadmap(include_facets=True, limit=10)
+
+    # Basic response structure
+    assert "total_found" in result
+    assert "features" in result
+    assert "filters_applied" in result
+    assert "facets" in result
+
+    # Verify facets structure
+    facets = result["facets"]
+    assert "products" in facets
+    assert "statuses" in facets
+    assert "release_phases" in facets
+    assert "platforms" in facets
+    assert "cloud_instances" in facets
+
+    # Each facet should be a list of dicts with name and count
+    for facet_category in facets.values():
+        assert isinstance(facet_category, list)
+        if len(facet_category) > 0:
+            assert "name" in facet_category[0]
+            assert "count" in facet_category[0]
+            assert isinstance(facet_category[0]["count"], int)
+
+
+@pytest.mark.asyncio
+async def test_include_facets_with_limit_zero():
+    """include_facets=True with limit=0 returns only facets, no features."""
+    from m365_roadmap_mcp.tools.search import search_roadmap
+
+    result = await search_roadmap(include_facets=True, limit=0)
+
+    assert result["total_found"] > 0  # Should have matched features
+    assert len(result["features"]) == 0  # But no features returned
+    assert "facets" in result
+    assert len(result["facets"]["products"]) > 0  # Should have product facets
+
+
+@pytest.mark.asyncio
+async def test_include_facets_with_filter():
+    """Facets are computed from filtered results, not all features."""
+    from m365_roadmap_mcp.tools.search import search_roadmap
+
+    # Get facets for Teams features only
+    result = await search_roadmap(product="Teams", include_facets=True, limit=10)
+
+    assert "facets" in result
+    # Verify facets reflect the filtered results
+    # The total counts in facets should be <= total_found
+    products = result["facets"]["products"]
+    total_product_mentions = sum(p["count"] for p in products)
+    # Each feature can have multiple product tags, so this is >= total_found
+    assert total_product_mentions >= result["total_found"]
+
+
+@pytest.mark.asyncio
+async def test_include_facets_false():
+    """include_facets=False (default) does not include facets."""
+    from m365_roadmap_mcp.tools.search import search_roadmap
+
+    result = await search_roadmap(include_facets=False, limit=10)
+
+    assert "total_found" in result
+    assert "features" in result
+    assert "facets" not in result