@alternative-path/qa-path-mcp 1.0.0

package/dist/__tests__/utils/mcp-error-mapper.test.js

@@ -0,0 +1,240 @@
+import { mapApiErrorToMcpResponse, mapApiResponseToMcpError, } from "../../utils/mcp-error-mapper.js";
+describe("mcp-error-mapper", () => {
+    describe("mapApiErrorToMcpResponse", () => {
+        it("should return null for errors without response (network errors)", () => {
+            const err = { message: "Network error" };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).toBeNull();
+        });
+        it("should return null for 5xx errors (infrastructure failures)", () => {
+            const err = {
+                response: {
+                    status: 500,
+                    data: { error: "Internal server error" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).toBeNull();
+        });
+        it("should map 400 to BAD_REQUEST", () => {
+            const err = {
+                response: {
+                    status: 400,
+                    data: { message: "Invalid request data" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.success).toBe(false);
+            expect(parsed.error_code).toBe("BAD_REQUEST");
+            expect(parsed.message).toBe("Invalid request data");
+        });
+        it("should map 403 to FORBIDDEN", () => {
+            const err = {
+                response: {
+                    status: 403,
+                    data: { message: "Permission denied" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("FORBIDDEN");
+        });
+        it("should map 404 to NOT_FOUND", () => {
+            const err = {
+                response: {
+                    status: 404,
+                    data: { message: "Resource not found" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("NOT_FOUND");
+        });
+        it("should map 409 to CONFLICT", () => {
+            const err = {
+                response: {
+                    status: 409,
+                    data: { message: "Duplicate entry" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("CONFLICT");
+        });
+        it("should use code field from error data if present", () => {
+            const err = {
+                response: {
+                    status: 409,
+                    data: { code: "DUPLICATE_NAME", message: "Name already exists" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("DUPLICATE_NAME");
+        });
+        it("should map 422 to VALIDATION_FAILED", () => {
+            const err = {
+                response: {
+                    status: 422,
+                    data: { message: "Validation failed" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("VALIDATION_FAILED");
+        });
+        it("should map unknown 4xx status to REQUEST_FAILED", () => {
+            const err = {
+                response: {
+                    status: 418,
+                    data: { message: "I'm a teapot" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("REQUEST_FAILED");
+        });
+        it("should extract message from error field if message not present", () => {
+            const err = {
+                response: {
+                    status: 400,
+                    data: { error: "Error message" },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.message).toBe("Error message");
+        });
+        it("should use err.message as fallback if no data fields", () => {
+            const err = {
+                response: {
+                    status: 400,
+                    data: {},
+                },
+                message: "Request failed",
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.message).toBe("Request failed");
+        });
+        it("should propagate errors array if present", () => {
+            const err = {
+                response: {
+                    status: 400,
+                    data: {
+                        message: "Validation failed",
+                        errors: [
+                            { field: "name", message: "Name is required" },
+                            { field: "prefix", message: "Prefix is invalid" },
+                        ],
+                    },
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.errors).toHaveLength(2);
+            expect(parsed.errors[0].field).toBe("name");
+        });
+        it("should use fallback error code if unable to derive", () => {
+            const err = {
+                response: {
+                    status: 499, // Unknown status
+                    data: {},
+                },
+            };
+            const result = mapApiErrorToMcpResponse(err, "CUSTOM_FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("REQUEST_FAILED");
+        });
+    });
+    describe("mapApiResponseToMcpError", () => {
+        it("should return null when success is not false", () => {
+            const apiResult = { success: true, data: {} };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).toBeNull();
+        });
+        it("should return null when success is undefined", () => {
+            const apiResult = { data: {} };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).toBeNull();
+        });
+        it("should return error response when success is false", () => {
+            const apiResult = {
+                success: false,
+                message: "Operation failed",
+            };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.success).toBe(false);
+            expect(parsed.message).toBe("Operation failed");
+        });
+        it("should use code field from response if present", () => {
+            const apiResult = {
+                success: false,
+                code: "CONFLICT",
+                message: "Duplicate entry",
+            };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("CONFLICT");
+        });
+        it("should use fallback error code if code not present", () => {
+            const apiResult = {
+                success: false,
+                message: "Operation failed",
+            };
+            const result = mapApiResponseToMcpError(apiResult, "CUSTOM_FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error_code).toBe("REQUEST_FAILED");
+        });
+        it("should extract message from error field if message not present", () => {
+            const apiResult = {
+                success: false,
+                error: "Error occurred",
+            };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.message).toBe("Error occurred");
+        });
+        it("should use default message if neither message nor error present", () => {
+            const apiResult = {
+                success: false,
+            };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.message).toBe("Request failed");
+        });
+        it("should propagate errors array if present", () => {
+            const apiResult = {
+                success: false,
+                message: "Validation failed",
+                errors: [
+                    { field: "name", message: "Name is required" },
+                ],
+            };
+            const result = mapApiResponseToMcpError(apiResult, "FALLBACK");
+            expect(result).not.toBeNull();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.errors).toHaveLength(1);
+            expect(parsed.errors[0].field).toBe("name");
+        });
+    });
+});
+//# sourceMappingURL=mcp-error-mapper.test.js.map

package/dist/__tests__/utils/mcp-error-mapper.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error-mapper.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/mcp-error-mapper.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/utils/mcp-response.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-response.test.d.ts.map

package/dist/__tests__/utils/mcp-response.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/mcp-response.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/utils/mcp-response.test.js

@@ -0,0 +1,72 @@
+import { jsonResponse, textResponse } from "../../utils/mcp-response.js";
+describe("mcp-response", () => {
+    describe("jsonResponse", () => {
+        it("should return correct MCP response structure", () => {
+            const result = jsonResponse({ success: true, message: "Test" });
+            expect(result).toHaveProperty("content");
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toHaveProperty("type", "text");
+            expect(result.content[0]).toHaveProperty("text");
+        });
+        it("should stringify object with proper formatting", () => {
+            const obj = { success: true, message: "Test", data: { id: 1 } };
+            const result = jsonResponse(obj);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toEqual(obj);
+        });
+        it("should format JSON with 2-space indentation", () => {
+            const obj = { success: true, data: { nested: { value: "test" } } };
+            const result = jsonResponse(obj);
+            const text = result.content[0].text;
+            expect(text).toContain("  "); // 2-space indentation
+            expect(text).toMatch(/\n\s{2}"success"/); // Proper indentation
+        });
+        it("should handle empty objects", () => {
+            const result = jsonResponse({});
+            expect(result.content[0].text).toBe("{}");
+        });
+        it("should handle objects with null values", () => {
+            const obj = { data: null, message: "test" };
+            const result = jsonResponse(obj);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.data).toBeNull();
+        });
+        it("should handle arrays", () => {
+            const obj = { items: [1, 2, 3] };
+            const result = jsonResponse(obj);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.items).toEqual([1, 2, 3]);
+        });
+        it("should handle complex nested structures", () => {
+            const obj = {
+                success: true,
+                data: {
+                    user: {
+                        id: "123",
+                        name: "Test User",
+                        roles: ["admin", "user"],
+                    },
+                },
+                errors: null,
+            };
+            const result = jsonResponse(obj);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toEqual(obj);
+        });
+    });
+    describe("textResponse", () => {
+        it("should return correct MCP response structure", () => {
+            const result = textResponse("Hello world");
+            expect(result).toHaveProperty("content");
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toHaveProperty("type", "text");
+            expect(result.content[0].text).toBe("Hello world");
+        });
+        it("should pass through markdown or pre-formatted text unchanged", () => {
+            const markdown = "**Summary**\n\n<details>\n<summary>JSON</summary>\n```json\n{}\n```\n</details>";
+            const result = textResponse(markdown);
+            expect(result.content[0].text).toBe(markdown);
+        });
+    });
+});
+//# sourceMappingURL=mcp-response.test.js.map

package/dist/__tests__/utils/mcp-response.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response.test.js","sourceRoot":"","sources":["../../../src/__tests__/utils/mcp-response.test.ts"],"names":[],"mappings":"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"}

package/dist/agents/test-planner-context.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Embedded test planning context for the x-test-planner agent.
+ * This content is the same as CURSOR_CONTEXT_TEST_PLANNING.md but is bundled
+ * in the MCP server so the agent always uses a consistent, non-editable context.
+ */
+export declare const TEST_PLANNER_CONTEXT = "# Cursor Context for Test Planning\n\nThis file provides a comprehensive, reusable context for test planning, test case/scenario creation, and automation workflow design. Use this as a template for any new project or feature to ensure consistency, completeness, and efficiency in your QA process.\n\n---\n\n## 1. Test Plan Structure\n\nA standard test plan should include the following sections:\n\n- **Reference Template:**\n  - Use your organization's standard test plan template (e.g. Confluence or internal wiki) as a reference for section structure and best practices.\n\n- **Project & Stakeholder Details**\n  - QA start dates, stakeholders, design/epic/BDD links, QA owner\n- **Objective**\n  - Short summary of the project/feature and underlying changes\n- **Test Scope**\n  - In Scope: Features, platforms, workflows to be tested\n  - Out of Scope: Exclusions, legacy flows, non-impacted areas\n  - In Scope - Automation: What will be automated\n  - Out of Scope - Automation: What will not be automated and why\n- **Data Validation Coverage**\n  - Types of data, edge cases, negative data, and how data coverage is ensured\n- **Assumptions and Dependencies**\n  - Environment, APIs, roles, external systems, etc.\n- **Objectives**\n  - Functional, performance, security, UI/UX, data validation\n- **Test Strategy**\n  - Types of testing (unit, functional, UI, API, DB, performance, UAT, etc.)\n  - Approach: Happy path, edge/negative, integration, data, exploratory\n- **Phase Plan**\n  - Phased approach to testing (happy path, integration, edge, regression, etc.)\n- **Manual & Automated Testing**\n  - What will be covered manually vs. automated\n- **Migration/Backfilling**\n  - Data migration/validation if applicable\n- **Regression**\n  - Impacted areas, regression suite, integration points\n- **Functional Testing Considerations**\n  - Business rules, UI/UX, data, error handling, new/changed workflows\n- **Integration & Dependencies**\n  - APIs, external systems, user management, logging\n- **Non-Functional Testing**\n  - Performance, security, compatibility, scalability\n- **Automation & Test Coverage**\n  - Reuse, prioritization, data, coverage goals\n- **Operational & Monitoring**\n  - Audit logs, error monitoring, post-release validation\n- **User Scenarios & Test Cases**\n  - Table of detailed test cases and scenarios\n- **Automation Workflows**\n  - Table of automation flows covering multiple test cases\n- **Release and Revert Plan**\n- **Post Release Production Validation**\n- **Approval Table**\n\n---\n\n## 2. Test Case & Scenario Writing\n\n- **Test Case Table Columns:**\n  - Test Case ID\n  - Title\n  - Objective\n  - Steps (detailed, step-by-step)\n  - Expected Result\n  - Test Data (if applicable)\n\n- **Best Practices:**\n  - Be specific and unambiguous\n  - Cover both positive and negative scenarios\n  - Include cases that are most likely to result into bugs\n  - Include edge cases and data variations\n  - Link to requirements/user stories where possible\n  - Use clear, actionable language\n  - Be as detailed as possible\n  - Define the test steps with granularity and details\n  - Include places to look out for in the expected results and be very specific.\n  - If there are multiple places where an outcome can be or should be validated, include all those places as part of the expected result or create new test case for that.\n  - While creating test cases add test steps as well keeping in mind that the person executing these testacses and steps can only access the application using the front-end. So, add steps that can be followed from the applicaiton/navigation. Try to be as accurate with the test steps as you can.\n\n- **Example Test Case Table (Markdown):**\n\n| Test Case ID | Title | Objective | Steps | Expected Result | Test Data |\n|--------------|-------|-----------|-------|----------------|-----------|\n| TC-01 | Upload Supported Document | Verify upload and queueing of supported document types | 1. Login as user<br>2. Upload Termsheet.pdf<br>3. Queue for extraction | Document appears in dashboard with correct status and metadata | Termsheet.pdf |\n\n---\n\n## 3. Automation Workflow Design\n\n- **Workflow Table Columns:**\n  - Workflow Name\n  - Test Cases Covered (from the list of test cases generated in above sections)\n  - Workflow Steps (should cover multiple test cases per flow)\n\n- **Best Practices:**\n  - Design workflows to maximize coverage with minimal complexity\n  - Avoid overly complex flows; keep steps maintainable\n  - Reuse login, navigation, and setup steps\n  - Validate both UI and backend (API, DB) where possible\n\n- **Example Automation Workflow Table (Markdown):**\n\n| Workflow Name | Test Cases Covered | Workflow Steps |\n|--------------|--------------------|----------------|\n| Document Upload, Extraction, and Review | TC-01, TC-03, TC-04, ... | 1. Login<br>2. Upload document<br>3. Queue for extraction<br>... |\n\n---\n\n## 4. Test Data Management\n\n- Use a variety of data: valid, invalid, edge, corrupted, large/small, etc.\n- Document test data in the test case table or as a separate section\n- For automation, use data-driven approaches where possible\n\n---\n\n## 5. General Best Practices\n\n- Always link test cases to requirements/user stories/epics\n- Keep test cases atomic and independent\n- Regularly review and update test cases and workflows\n- Prioritize automation for repetitive, high-value, and regression scenarios\n- Ensure auditability and traceability (who tested what, when, and why)\n- Include negative, boundary, and exploratory tests\n- Validate error handling, security, and access control\n- Document assumptions, dependencies, and environment details\n\n---\n\n## 6. Example Section Templates\n\n### Test Case Table\n\n| Test Case ID | Title | Objective | Steps | Expected Result | Test Data |\n|--------------|-------|-----------|-------|----------------|-----------|\n| TC-01 | ... | ... | ... | ... | ... |\n\n### Automation Workflow Table\n\n| Workflow Name | Test Cases Covered | Workflow Steps |\n|---------------|-------------------|----------------|\n| ... | ... | ... |\n\n---\n\n## 7. Section for Abbreviations\n\n### Abbreviations\n - Include a section towards the end to have abbreviations and their full forms listed\n - List the abbreviations as bullet points\n - If you are you not able to find a full form for any abbreviation, the use the confluence or the internet to search for that term\n\n- **Example Abbreviation Section:**\nPCDO - Private Credit and Deal Orientation\nCLO - Collateralized Loan Obligation\n\n---\n\n## 8. How to Use This Context\n\n- When starting a new test planning effort, use this as your base context\n- Fill in project-specific details, requirements, and data as needed\n- Use the tables and best practices to guide your test plan, test case, and automation workflow creation\n- Make use of the details provided with the prompt\n- **If additional information is provided with the prompt (such as BDD links, TDD links, JIRA story/task links, or Confluence links), ensure you utilize this information by thoroughly reviewing all referenced artifacts. This includes:**\n  - Visiting all provided BDD, TDD, JIRA, and Confluence links.\n  - For Confluence pages, review all child pages and any referenced or linked Confluence pages.\n  - For JIRA artifacts, review all linked JIRA issues and any referenced Confluence pages.\n  - Read all comments on both Confluence and JIRA items.\n  - Follow all references recursively to ensure complete context is gathered for the test plan.\n\n---\n\n## 8A. Test Planning Deep-Dive Checklist\n\n**When preparing the Test Plan, Test Cases, Testing Strategy, or any other relevant section, use the following checklist to guide your analysis. Answer as many of these as are applicable, and use the answers to enrich the relevant sections of your test plan.**\n\n### Functional Testing\n1. Does the design/change affect the current workflow that it is being developed for?\n2. Does the design/change affect any other transaction?\n   - List of affected transactions\n3. Does the design/change affect any existing report/calculation?\n4. List of affected reports/calculations\n5. Is there a need to create separate reporting for the design/change?\n6. Is there any existing data point that could be affected?\n7. Does it affect any other functionality?\n   - List of affected functionalities\n8. Are there any new business rules or validations introduced?\n9. How should the system behave in case of missing/invalid data?\n10. Are there any UI/UX changes? If yes, how do they impact usability?\n11. What are the expected inputs and outputs for each function or transaction?\n\n### Integration & Dependencies\n1. Any integration area affected?\n2. List of affected integration areas\n3. Does the change introduce any dependencies on third-party services or external systems?\n4. Are there any upstream or downstream data dependencies?\n5. Do any existing integrations require modification or additional validation?\n6. Are there any database schema changes? If yes, how will backward compatibility be handled?\n\n### Non-Functional Testing\n1. What are the performance benchmarks/considerations?\n2. How much time is allowed during processing?\n3. What are the payload size considerations?\n4. Are there security considerations (authentication, authorization, data encryption)?\n5. What are the scalability and concurrency requirements?\n6. Does the system handle expected and unexpected failures gracefully?\n7. Is failover or disaster recovery testing required?\n8. Are there any regulatory or compliance requirements?\n9. Are there browser/device compatibility considerations (for web or mobile applications)?\n\n### Automation & Test Coverage\n1. Are there reusable test cases from previous releases that apply to this change?\n2. Are there specific scenarios that should be prioritized for automation?\n3. What test data is required, and how will it be managed?\n4. Will exploratory testing be needed in addition to scripted test cases?\n5. Are API endpoints available for testing/automation?\n\n### Operational & Monitoring\n1. Are debug/audit logs available?\n2. How will errors be logged and monitored in production?\n3. Are there any alerting mechanisms in place for failures?\n4. What are the rollback procedures if the deployment fails?\n5. How will post-production validation be performed?\n6. What is the frequency of jobs run?\n7. What access/rights are required for QA teams?\n8. Is there a need for specific capabilities/entitlements for testing?\n\n---\n\n- **Test Strategy**\n  - Types of testing (unit, functional, UI, API, DB, performance, UAT, etc.)\n  - Approach: Happy path, edge/negative, integration, data, exploratory\n  - **Sample Test Strategy (for inspiration):**\n\n    We will start with the happy flow scenarios for the Transaction management. Here we plan to cover 65-70% of our functional requirements. Then we will move on to test the migrated data testing that will be performed at the Database layer. As migration is a major event in the functionality to be available to the users. This is critical to do as existing transaction need to be present in the system. Then, we will test integration areas such that the consumers of the transactional data are in sync with the changing transactions, for this API testing approach will be used as the integration will be done using APIs. This strategy ensures that the we have confidence in the end-to end functional, data and integration areas.\n\n    Then, we will move on to covering the edge case scenarios around the transaction management, which are more prone to break the workflow. This phase is to make sure the system is resilient to failures and error.\n\n    Finally, we will perform exploratory testing to uncover issues or perform validations to ensure completeness.\n\n    **Phase 1: Happy Flow Validation (Foundation Testing)**\n    We will begin by validating the happy flow scenarios for Transaction Management, covering approximately 65-70% of the functional requirements. This phase ensures that the fundamental workflows behave as expected under standard conditions.\n    *Why this first?*\n     - Establishes baseline functional correctness.\n     - Allows early defect detection and reduces rework in later stages.\n     - Enables smoother collaboration with development teams in case of issues.\n\n    **Phase 2: Migrated Data Validation (Data Integrity Testing)**\n    Once core functionality is validated, we will focus on migrated data testing at the database layer. Since data migration is a key event enabling this functionality, it is critical to verify that existing transactions are accurately present and available in the system post-migration.\n    *Why now?*\n     - Ensures historical transactions remain intact post-migration.\n     - Prevents discrepancies before proceeding to further functional and integration tests.\n\n    **Phase 3: Integration Testing (System Connectivity & Data Flow Testing)**\n    Next, we will validate integration areas, ensuring that consumers of transactional data are in sync with the changing transactions. This will be performed through API testing, as integration is API-driven.\n    *Why at this stage?*\n     - By now, we have confidence in functional correctness and data integrity.\n     - Ensures seamless interaction between the transaction system and external consumers.\n     - Helps detect system-wide inconsistencies before moving to deeper validation.\n\n    **Phase 4: Edge Case & Negative Scenario Testing (Resilience & Failure Handling)**\n    At this stage, we will cover edge case scenarios, which are more prone to breaking the workflow. This includes boundary conditions, invalid inputs, concurrency issues, and error handling.\n    *Why now?*\n     - Functional and integration correctness is already established, allowing us to focus on resilience.\n     - Helps assess the system's robustness in handling unexpected inputs and failures.\n\n    **Phase 5: Exploratory Testing (Final Validations & Completeness Check)**\n    Finally, we will perform exploratory testing to uncover issues that may not have been covered in structured test cases. This includes usability assessments, performance bottlenecks, and overlooked functional gaps.\n    *Why at the end?*\n     - Ensures real-world scenarios and human intuition-driven testing before deployment.\n     - Helps identify potential last-minute gaps or overlooked issues.\n\n**This context is designed to make your test planning fast, consistent, and high quality.**";
+//# sourceMappingURL=test-planner-context.d.ts.map

package/dist/agents/test-planner-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-planner-context.d.ts","sourceRoot":"","sources":["../../src/agents/test-planner-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,iycAoR2D,CAAC"}