@qa-gentic/stlc-agents 1.0.14 → 1.0.16

package/src/stlc_agents/agent_gherkin_generator/server.py

@@ -27,7 +27,6 @@ from stlc_agents.shared.auth import get_auth_headers, get_signed_in_user
 from stlc_agents.agent_gherkin_generator.tools.ado_gherkin import (
     fetch_feature_hierarchy as _fetch_feature,
     fetch_work_item_for_gherkin as _fetch_wi_for_gherkin,
-    fetch_epic_hierarchy as _fetch_epic,
     attach_feature_file as _attach_feature,
     attach_work_item_file as _attach_wi_file,
     validate_gherkin_content as _validate_gherkin,
@@ -43,7 +42,7 @@ app = Server("qa-gherkin-generator")
 # ---------------------------------------------------------------------------
 
 def _validate_hierarchy_response(result: dict, scope: str) -> dict:
-    """Validate fetch_feature_hierarchy / fetch_epic_hierarchy / fetch_work_item_for_gherkin
+    """Validate fetch_feature_hierarchy / fetch_work_item_for_gherkin
     response quality before returning to the user.
 
     Checks:
@@ -168,54 +167,17 @@ def _validate_attach_response(result: dict, scope: str) -> dict:
 @app.list_tools()
 async def list_tools() -> list[types.Tool]:
     return [
-        # ── Epic-scoped fetch (NEW — must be listed FIRST so routing fires before Feature path) ──
-        types.Tool(
-            name="fetch_epic_hierarchy",
-            description=(
-                "Fetch an Epic work item from Azure DevOps along with ALL child Features, "
-                "every Feature's child PBIs/Bugs, and every linked test case (including full "
-                "test steps). ALWAYS use this tool as Step 1 when the user provides an Epic ID. "
-                "Never fall through to fetch_feature_hierarchy when an Epic ID is given. "
-                "The response contains: epic metadata, a 'features' list where each entry "
-                "includes the Feature's own metadata plus its 'child_work_items' (PBIs/Bugs) "
-                "and 'existing_test_cases'. Analyse ALL child Features and ALL child PBIs/Bugs "
-                "before generating any Gherkin scenarios — the full hierarchy is the only "
-                "correct input for Epic-scope regression suites. "
-                "Generates one .feature file per child Feature; attaches each via "
-                "attach_gherkin_to_feature. "
-                "IMPORTANT: Manual test cases (create_and_link_test_cases) MUST NOT be created "
-                "for the Epic itself — inform the user that test cases can only be created for "
-                "PBIs, Bugs, or Features."
-            ),
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "epic_id": {
-                        "type": "integer",
-                        "description": "ADO Epic work item ID",
-                    },
-                    "organization_url": {
-                        "type": "string",
-                        "description": "e.g. https://dev.azure.com/myorg",
-                    },
-                    "project_name": {
-                        "type": "string",
-                        "description": "ADO project name",
-                    },
-                },
-                "required": ["epic_id", "organization_url", "project_name"],
-            },
-        ),
-
-        # ── Existing: Feature-scoped fetch ───────────────────────────────────
+        # ── Feature-scoped fetch ─────────────────────────────────────────────
         types.Tool(
             name="fetch_feature_hierarchy",
             description=(
-                "Fetch a Feature work item from Azure DevOps along with all child PBIs/Bugs, "
-                "their linked test cases with full test steps, and a Gherkin best-practice "
-                "reference example. Use this as Step 1 when the user provides a Feature ID "
-                "or when you need the full cross-PBI flow map. "
-                "For a single PBI or Bug ID, use fetch_work_item_for_gherkin instead."
+                "Fetch a Feature work item from Azure DevOps along with all child PBIs/Bugs "
+                "and their linked test cases. Use this as Step 1 when the user provides a "
+                "Feature ID. Generates 5–10 scenarios covering the full Feature. "
+                "For a single PBI or Bug ID, use fetch_work_item_for_gherkin instead. "
+                "For an Epic ID: do NOT call any fetch tool — instead tell the user: "
+                "'Epic-scoped Gherkin generation is not supported. Please provide a Feature ID "
+                "or PBI/Bug ID. To find child Features, look up the Epic in Azure DevOps.'"
             ),
             inputSchema={
                 "type": "object",
@@ -228,7 +190,7 @@ async def list_tools() -> list[types.Tool]:
             },
         ),
 
-        # ── NEW: PBI/Bug-scoped fetch ────────────────────────────────────────
+        # ── PBI/Bug-scoped fetch ─────────────────────────────────────────────
         types.Tool(
             name="fetch_work_item_for_gherkin",
             description=(
@@ -236,9 +198,9 @@ async def list_tools() -> list[types.Tool]:
                 "a scoped Gherkin feature file for that work item alone. "
                 "Use this when the user provides a PBI or Bug ID and wants a focused .feature "
                 "file covering only that work item's acceptance criteria (3–9 scenarios). "
-                "Returns the work item's AC, linked test cases with full steps, parent Feature "
-                "metadata, a suggested file name, and the Gherkin best-practice reference. "
-                "For Feature IDs, use fetch_feature_hierarchy instead."
+                "Returns the work item's AC, linked test case titles, and parent Feature metadata. "
+                "For Feature IDs, use fetch_feature_hierarchy instead. "
+                "For Epic IDs, do not call this tool — tell the user to provide a Feature or PBI ID."
             ),
             inputSchema={
                 "type": "object",
@@ -367,17 +329,7 @@ async def list_tools() -> list[types.Tool]:
 @app.call_tool()
 async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
     try:
-        if name == "fetch_epic_hierarchy":
-            result = await asyncio.to_thread(
-                _fetch_epic,
-                arguments["organization_url"],
-                arguments["project_name"],
-                arguments["epic_id"],
-            )
-            # ── Pre-output validation ─────────────────────────────────────
-            result["_validation"] = _validate_hierarchy_response(result, "epic")
-
-        elif name == "fetch_feature_hierarchy":
+        if name == "fetch_feature_hierarchy":
             result = await asyncio.to_thread(
                 _fetch_feature,
                 arguments["organization_url"],

package/src/stlc_agents/agent_gherkin_generator/tools/ado_gherkin.py

@@ -255,11 +255,6 @@ def fetch_work_item_for_gherkin(
             fields.get("Microsoft.VSTS.TCM.ReproSteps", "") or ""
         ),
         "state": fields.get("System.State", ""),
-        "priority": fields.get("Microsoft.VSTS.Common.Priority", ""),
-        "story_points": fields.get("Microsoft.VSTS.Scheduling.StoryPoints", ""),
-        "tags": fields.get("System.Tags", ""),
-        "area_path": fields.get("System.AreaPath", ""),
-        "iteration_path": fields.get("System.IterationPath", ""),
     }
 
     # ── Collect linked TC IDs ────────────────────────────────────────────────
@@ -309,8 +304,6 @@ def fetch_work_item_for_gherkin(
         "existing_test_cases_count": len(test_cases),
         "suggested_file_name": suggested_file_name,
         "scope": "work_item",
-        "scenario_count_rule": f"{_SCENARIO_MIN_WI}–{_SCENARIO_MAX_WI} scenarios for a single PBI/Bug",
-        "best_practice_example": _GHERKIN_EXAMPLE,
     }
 
 
@@ -393,20 +386,19 @@ def attach_work_item_file(
         "work_item_id": work_item_id,
         "file_name": file_name,
         "attachment_url": attachment_url,
-        "validation": validation,
+        "warnings": validation["warnings"],
     }
 
 
 # ─────────────────────────────────────────────────────────────────────────────
-# INTERNAL HELPER — shared by fetch_feature_hierarchy and fetch_epic_hierarchy
+# INTERNAL HELPER — used by fetch_feature_hierarchy
 # ─────────────────────────────────────────────────────────────────────────────
 
 def _fetch_feature_data(org_url: str, project: str, feature_id: int) -> dict:
     """
     Core logic: fetch one Feature + its child PBIs/Bugs + their test cases.
     Returns the same shape as the old fetch_feature_hierarchy body.
-    Called by both fetch_feature_hierarchy (single feature) and
-    fetch_epic_hierarchy (once per child feature of an epic).
+    Called by fetch_feature_hierarchy.
     """
     org_url = org_url.rstrip("/")
     headers = get_auth_headers()
@@ -431,10 +423,6 @@ def _fetch_feature_data(org_url: str, project: str, feature_id: int) -> dict:
             fields.get("Microsoft.VSTS.Common.AcceptanceCriteria", "") or ""
         ),
         "state": fields.get("System.State", ""),
-        "priority": fields.get("Microsoft.VSTS.Common.Priority", ""),
-        "area_path": fields.get("System.AreaPath", ""),
-        "iteration_path": fields.get("System.IterationPath", ""),
-        "tags": fields.get("System.Tags", ""),
     }
 
     # ── Fetch child PBIs / Bugs ──────────────────────────────────────────────
@@ -469,8 +457,6 @@ def _fetch_feature_data(org_url: str, project: str, feature_id: int) -> dict:
                     cf.get("Microsoft.VSTS.Common.AcceptanceCriteria", "") or ""
                 ),
                 "state": cf.get("System.State", ""),
-                "priority": cf.get("Microsoft.VSTS.Common.Priority", ""),
-                "story_points": cf.get("Microsoft.VSTS.Scheduling.StoryPoints", ""),
             })
 
             child_tc_map[child_id] = [
@@ -505,109 +491,7 @@ def fetch_feature_hierarchy(org_url: str, project: str, feature_id: int) -> dict
     reference example.
     """
     result = _fetch_feature_data(org_url, project, feature_id)
-    return {
-        **result,
-        "scope": "feature",
-        "scenario_count_rule": (
-            f"{_SCENARIO_MIN_FEATURE}–{_SCENARIO_MAX_FEATURE} scenarios for a Feature"
-        ),
-        "best_practice_example": _GHERKIN_EXAMPLE,
-    }
-
-
-# ─────────────────────────────────────────────────────────────────────────────
-# PUBLIC TOOL — Epic entry point (new)
-# ─────────────────────────────────────────────────────────────────────────────
-
-def fetch_epic_hierarchy(org_url: str, project: str, epic_id: int) -> dict:
-    """
-    Fetch an Epic work item with ALL child Features, their child PBIs/Bugs,
-    and every linked test case (including full test steps). Use this as Step 1 when the user provides an Epic ID.
-    
-    Hierarchy resolved:
-        Epic
-        └── Feature  (one _fetch_feature_data call per feature)
-            └── PBI / Bug
-                └── Test Cases
-    """
-    org_url = org_url.rstrip("/")
-    headers = get_auth_headers()
-
-    # ── Fetch the Epic ───────────────────────────────────────────────────────
-    resp = requests.get(
-        f"{org_url}/{project}/_apis/wit/workitems/{epic_id}",
-        headers=headers,
-        params={"$expand": "relations", "api-version": _API},
-        timeout=30,
-    )
-    resp.raise_for_status()
-    data = resp.json()
-    fields = data.get("fields", {})
-
-    epic = {
-        "id": data["id"],
-        "type": fields.get("System.WorkItemType", ""),
-        "title": fields.get("System.Title", ""),
-        "description": _strip_html(fields.get("System.Description", "") or ""),
-        "acceptance_criteria": _strip_html(
-            fields.get("Microsoft.VSTS.Common.AcceptanceCriteria", "") or ""
-        ),
-        "state": fields.get("System.State", ""),
-        "priority": fields.get("Microsoft.VSTS.Common.Priority", ""),
-        "area_path": fields.get("System.AreaPath", ""),
-        "iteration_path": fields.get("System.IterationPath", ""),
-        "tags": fields.get("System.Tags", ""),
-    }
-
-    # ── Walk child Features and delegate to the shared helper ────────────────
-    features: list[dict] = []
-    total_children = 0
-    total_test_cases = 0
-
-    for rel in data.get("relations", []):
-        if rel.get("rel") != "System.LinkTypes.Hierarchy-Forward":
-            continue
-        child_url = rel["url"]
-        child_id = int(child_url.split("/")[-1])
-
-        # Peek at work item type before doing the full fetch
-        try:
-            peek = requests.get(
-                f"{child_url}?api-version={_API}",
-                headers=get_auth_headers(),
-                timeout=30,
-            )
-            if not peek.ok:
-                continue
-            child_type = peek.json().get("fields", {}).get("System.WorkItemType", "")
-            if child_type != "Feature":
-                continue  # skip non-Feature children (e.g. orphan PBIs directly under Epic)
-        except Exception:
-            continue
-
-        # Full deep fetch via shared helper
-        try:
-            feature_data = _fetch_feature_data(org_url, project, child_id)
-        except Exception:
-            continue
-
-        features.append(feature_data)
-        total_children += feature_data["child_work_items_count"]
-        total_test_cases += feature_data["existing_test_cases_count"]
-
-    return {
-        "epic": epic,
-        "features": features,
-        "features_count": len(features),
-        "total_child_work_items_count": total_children,
-        "total_existing_test_cases_count": total_test_cases,
-        "scope": "epic",
-        "scenario_count_rule": (
-            f"{_SCENARIO_MIN_FEATURE}–{_SCENARIO_MAX_FEATURE} scenarios per Feature "
-            f"when generating at Epic scope"
-        ),
-        "best_practice_example": _GHERKIN_EXAMPLE,
-    }
+    return {**result, "scope": "feature"}
 
 
 # ---------------------------------------------------------------------------
@@ -685,7 +569,7 @@ def attach_feature_file(
         "feature_id": feature_id,
         "file_name": file_name,
         "attachment_url": attachment_url,
-        "validation": validation,
+        "warnings": validation["warnings"],
     }
 
 
@@ -706,14 +590,9 @@ def _fetch_test_cases(org_url: str, project: str, tc_ids: List[int]) -> list:
             if not resp.ok:
                 continue
             f = resp.json().get("fields", {})
-            steps = _parse_steps_xml(f.get("Microsoft.VSTS.TCM.Steps", ""))
             results.append({
                 "id": tc_id,
                 "title": f.get("System.Title", ""),
-                "state": f.get("System.State", ""),
-                "priority": f.get("Microsoft.VSTS.Common.Priority", ""),
-                "steps": steps,
-                "steps_count": len(steps),
             })
         except Exception:
             continue

package/src/stlc_agents/agent_jira_manager/server.py

@@ -3,7 +3,6 @@ Agent 5: QA Jira Manager — MCP Server
 
 Tools:
   fetch_jira_issue           — Fetch a Jira issue with acceptance criteria and coverage hints
-  fetch_jira_epic_hierarchy  — Fetch an Epic with all child issues
   create_and_link_test_cases — Create test case issues in Jira and link them to the source issue
   get_linked_test_cases      — Return test cases already linked to a Jira issue
 
@@ -32,7 +31,6 @@ from mcp import types
 from stlc_agents.shared_jira.auth import get_auth_headers, get_cloud_id, get_signed_in_user
 from stlc_agents.agent_jira_manager.tools.jira_workitem import (
     fetch_work_item as _fetch_work_item,
-    fetch_epic_hierarchy as _fetch_epic_hierarchy,
     create_test_case as _create_test_case,
     link_test_cases_to_issue as _link_test_cases,
     get_linked_test_cases as _get_linked_test_cases,
@@ -182,29 +180,6 @@ async def list_tools() -> list[types.Tool]:
                 "required": ["issue_key"],
             },
         ),
-        types.Tool(
-            name="fetch_jira_epic_hierarchy",
-            description=(
-                "Fetch a Jira Epic with all child issues (Stories, Tasks, Bugs, Sub-tasks). "
-                "Use this when the caller passes an Epic key. "
-                "Returns the Epic fields and a children list with key, type, summary, "
-                "status, priority, and assignee for each child."
-            ),
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "epic_key": {
-                        "type": "string",
-                        "description": "Epic issue key, e.g. 'PROJ-10'",
-                    },
-                    "cloud_id": {
-                        "type": "string",
-                        "description": "Atlassian cloud ID. Leave blank to use JIRA_CLOUD_ID env var.",
-                    },
-                },
-                "required": ["epic_key"],
-            },
-        ),
         types.Tool(
             name="create_and_link_test_cases",
             description=(
@@ -320,13 +295,6 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
             )
             result["_validation"] = _validate_fetch_response(result)
 
-        elif name == "fetch_jira_epic_hierarchy":
-            result = await asyncio.to_thread(
-                _fetch_epic_hierarchy,
-                cloud_id,
-                arguments["epic_key"],
-            )
-
         elif name == "create_and_link_test_cases":
             issue_key = arguments["issue_key"]
             test_cases = arguments["test_cases"]

package/src/stlc_agents/agent_jira_manager/tools/jira_workitem.py

@@ -5,7 +5,6 @@ All functions use get_auth_headers() from shared_jira/auth.py — no credentials
 
 Public API:
   fetch_work_item(cloud_id, issue_key)                    -> dict
-  fetch_epic_hierarchy(cloud_id, epic_key)                -> dict
   create_test_case(cloud_id, project_key, title, steps, priority, labels, epic_link) -> dict
   link_test_cases_to_issue(cloud_id, issue_key, tc_keys)  -> dict
   get_linked_test_cases(cloud_id, issue_key)              -> dict
@@ -64,16 +63,15 @@ def fetch_work_item(cloud_id: str, issue_key: str) -> dict:
 
     issue_type = (fields.get("issuetype") or {}).get("name", "")
 
-    # Epic guard
+    # Epic guard — Epics are not supported for test case operations
     if issue_type == "Epic":
         return {
             "error": "epic_use_hierarchy",
             "issue_type": issue_type,
             "issue_key": issue_key,
             "message": (
-                f"{issue_key} is an Epic. Use fetch_epic_hierarchy to walk its "
-                "child Stories/Tasks/Bugs, then call create_and_link_test_cases "
-                "on each individual child issue."
+                f"{issue_key} is an Epic. Epic-scoped operations are not supported. "
+                "Please provide a child Story, Task, or Bug key instead."
             ),
         }
 
@@ -91,13 +89,8 @@ def fetch_work_item(cloud_id: str, issue_key: str) -> dict:
         "acceptance_criteria": acceptance_criteria,
         "status": (fields.get("status") or {}).get("name", ""),
         "priority": (fields.get("priority") or {}).get("name", ""),
-        "assignee": (fields.get("assignee") or {}).get("displayName", ""),
         "labels": fields.get("labels", []),
-        "story_points": fields.get("customfield_10016") or fields.get("customfield_10028"),
         "project_key": (fields.get("project") or {}).get("key", ""),
-        "project_name": (fields.get("project") or {}).get("name", ""),
-        "fix_versions": [v.get("name", "") for v in (fields.get("fixVersions") or [])],
-        "components": [c.get("name", "") for c in (fields.get("components") or [])],
         "epic_key": fields.get("customfield_10014", ""),  # Epic Link
     }
 
@@ -129,74 +122,6 @@ def fetch_work_item(cloud_id: str, issue_key: str) -> dict:
     }
 
 
-# ---------------------------------------------------------------------------
-# fetch_epic_hierarchy
-# ---------------------------------------------------------------------------
-
-def fetch_epic_hierarchy(cloud_id: str, epic_key: str) -> dict:
-    """Fetch an Epic with all child issues (Stories, Tasks, Bugs, Sub-tasks)."""
-    headers = get_auth_headers()
-
-    # Fetch the Epic itself
-    epic_resp = requests.get(
-        f"{_base(cloud_id)}/issue/{epic_key}",
-        headers=headers,
-        params={"fields": "summary,issuetype,status,priority,project"},
-        timeout=30,
-    )
-    epic_resp.raise_for_status()
-    epic_data = epic_resp.json()
-    epic_fields = epic_data.get("fields", {})
-
-    if (epic_fields.get("issuetype") or {}).get("name", "") != "Epic":
-        return {
-            "error": "not_an_epic",
-            "issue_key": epic_key,
-            "message": f"{epic_key} is not an Epic. Use fetch_work_item instead.",
-        }
-
-    # JQL: all issues whose parent is this epic (next-gen / team-managed projects)
-    # "Epic Link" field is deprecated/removed in newer Jira Cloud instances
-    # GET /rest/api/3/search is deprecated (410 Gone) — use POST /rest/api/3/search/jql
-    jql = f'parent = {epic_key}'
-    search_resp = requests.post(
-        f"{_base(cloud_id)}/search/jql",
-        headers=get_auth_headers(),
-        json={
-            "jql": jql,
-            "fields": ["summary", "issuetype", "status", "priority", "assignee", "issuelinks"],
-            "maxResults": 200,
-        },
-        timeout=30,
-    )
-    search_resp.raise_for_status()
-    issues = search_resp.json().get("issues", [])
-
-    children = [
-        {
-            "key": i["key"],
-            "id": i["id"],
-            "type": (i.get("fields", {}).get("issuetype") or {}).get("name", ""),
-            "summary": i.get("fields", {}).get("summary", ""),
-            "status": (i.get("fields", {}).get("status") or {}).get("name", ""),
-            "priority": (i.get("fields", {}).get("priority") or {}).get("name", ""),
-            "assignee": (i.get("fields", {}).get("assignee") or {}).get("displayName", ""),
-        }
-        for i in issues
-    ]
-
-    return {
-        "epic": {
-            "key": epic_data["key"],
-            "id": epic_data["id"],
-            "summary": epic_fields.get("summary", ""),
-            "project_key": (epic_fields.get("project") or {}).get("key", ""),
-        },
-        "children": children,
-        "child_count": len(children),
-    }
-
-
 # ---------------------------------------------------------------------------
 # create_test_case
 # ---------------------------------------------------------------------------

package/src/stlc_agents/agent_playwright_generator/server.py

@@ -23,7 +23,7 @@ CI/CD Telemetry:
   before they are permanently committed to the repository.
 """
 from __future__ import annotations
-import asyncio, json, re, sys, os
+import asyncio, json, re, sys, os, uuid
 from pathlib import Path
 from dotenv import load_dotenv
 from mcp.server import Server
@@ -35,6 +35,13 @@ from stlc_agents.agent_playwright_generator.tools.ado_attach import attach_file_
 load_dotenv()
 app = Server("qa-playwright-generator")
 
+# ---------------------------------------------------------------------------
+# File content cache — keeps large TS blobs out of conversation history.
+# generate_playwright_code and scaffold_locator_repository store files here
+# keyed by a short cache_key; get_generated_files retrieves them on demand.
+# ---------------------------------------------------------------------------
+_file_cache: dict[str, dict] = {}
+
 
 # ---------------------------------------------------------------------------
 # Pre-output validation helpers
@@ -227,9 +234,8 @@ async def list_tools() -> list[types.Tool]:
             description=(
                 "Attach generated TypeScript files to an ADO work item (Feature, PBI, or Bug). "
                 "NEVER pass an Epic ID — attachments on Epics are invisible in normal ADO workflow "
-                "views. If you have an Epic ID, use qa-gherkin-generator:fetch_epic_hierarchy "
-                "to walk its child Features and PBIs/Bugs, then call this tool once per Feature "
-                "or PBI/Bug work item ID."
+                "views. If you have an Epic ID, look up the child Features and PBIs/Bugs in ADO "
+                "and call this tool once per Feature or PBI/Bug work item ID."
             ),
             inputSchema={
                 "type": "object",
@@ -290,7 +296,7 @@ async def list_tools() -> list[types.Tool]:
                         "type": "string",
                         "description": (
                             "Content of the generated *.steps.ts file to validate. "
-                            "Pass the value from generate_playwright_code['files']['<feature>.steps.ts']."
+                            "Retrieve it via get_generated_files(cache_key)['files']['<feature>.steps.ts']."
                         ),
                     },
                     "gherkin_content": {
@@ -317,6 +323,26 @@ async def list_tools() -> list[types.Tool]:
                 "required": ["steps_ts_content"],
             },
         ),
+        types.Tool(
+            name="get_generated_files",
+            description=(
+                "Retrieve the full TypeScript file contents that were generated by a previous "
+                "call to generate_playwright_code or scaffold_locator_repository. "
+                "Use the cache_key returned by those tools. Call this only when you are about "
+                "to attach files to ADO (attach_code_to_work_item) or write them to Helix-QA "
+                "(qa-helix-writer:write_helix_files). Do not call this just to inspect the output."
+            ),
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "cache_key": {
+                        "type": "string",
+                        "description": "The cache_key value returned by generate_playwright_code or scaffold_locator_repository.",
+                    },
+                },
+                "required": ["cache_key"],
+            },
+        ),
     ]
 
 
@@ -336,6 +362,13 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
                 arguments.get("context_map"),
                 arguments.get("helix_project_root"),
             )
+            # Cache files; return manifest so TS content stays out of conversation
+            cache_key = uuid.uuid4().hex[:8]
+            _file_cache[cache_key] = result.pop("files")
+            result["cache_key"] = cache_key
+            result["files_manifest"] = list(_file_cache[cache_key].keys())
+            result.pop("healing_layers", None)
+            result.pop("scaffold_note", None)
         elif name == "scaffold_locator_repository":
             result = await asyncio.to_thread(
                 _scaffold_locator_repository,
@@ -347,8 +380,25 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
                 arguments.get("enable_visual_regression", True),
                 arguments.get("ai_healing_provider", "anthropic"),
             )
-            # ── Pre-output validation ─────────────────────────────────────
+            # ── Pre-output validation (reads files before we cache them) ──
             result["_validation"] = _validate_scaffold_output(result)
+            # Cache files; return manifest so TS content stays out of conversation
+            cache_key = uuid.uuid4().hex[:8]
+            _file_cache[cache_key] = result.pop("files")
+            result["cache_key"] = cache_key
+            result["files_manifest"] = list(_file_cache[cache_key].keys())
+            result.pop("healing_strategies", None)
+            result.pop("healing_layers", None)
+            result.pop("env_vars", None)
+        elif name == "get_generated_files":
+            cache_key = arguments["cache_key"]
+            if cache_key not in _file_cache:
+                result = {
+                    "error": f"Cache key '{cache_key}' not found. "
+                             "Re-run generate_playwright_code or scaffold_locator_repository.",
+                }
+            else:
+                result = {"cache_key": cache_key, "files": _file_cache[cache_key]}
         elif name == "attach_code_to_work_item":
             # ── Pre-attach input validation ────────────────────────────────
             input_validation = _validate_attach_inputs(arguments.get("files", []))
@@ -388,7 +438,7 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent]:
                                 f"Work item {wi_id} is an Epic. Playwright TypeScript files "
                                 "must NOT be attached directly to an Epic — attachments on Epics "
                                 "are effectively invisible in normal ADO workflow views. "
-                                "Use qa-gherkin-generator:fetch_epic_hierarchy to walk the child "
+                                "Use qa-gherkin-generator to walk the child "
                                 "Features and PBIs/Bugs, then call attach_code_to_work_item once "
                                 "per Feature or PBI/Bug work item ID."
                             ),