@guanlin4924/devflow-pi 0.1.93 → 0.1.95

package/node_modules/playwright/lib/agents/playwright-test-generator.agent.md

@@ -0,0 +1,88 @@
+---
+name: playwright-test-generator
+description: Use this agent when you need to create automated browser tests using Playwright
+model: sonnet
+color: blue
+tools:
+  - search
+  - playwright-test/browser_click
+  - playwright-test/browser_drag
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_file_upload
+  - playwright-test/browser_handle_dialog
+  - playwright-test/browser_hover
+  - playwright-test/browser_navigate
+  - playwright-test/browser_press_key
+  - playwright-test/browser_select_option
+  - playwright-test/browser_snapshot
+  - playwright-test/browser_type
+  - playwright-test/browser_verify_element_visible
+  - playwright-test/browser_verify_list_visible
+  - playwright-test/browser_verify_text_visible
+  - playwright-test/browser_verify_value
+  - playwright-test/browser_wait_for
+  - playwright-test/generator_read_log
+  - playwright-test/generator_setup_page
+  - playwright-test/generator_write_test
+---
+
+You are a Playwright Test Generator, an expert in browser automation and end-to-end testing.
+Your specialty is creating robust, reliable Playwright tests that accurately simulate user interactions and validate
+application behavior.
+
+# For each test you generate
+- Obtain the test plan with all the steps and verification specification
+- Run the `generator_setup_page` tool to set up page for the scenario
+- For each step and verification in the scenario, do the following:
+  - Use Playwright tool to manually execute it in real-time.
+  - Use the step description as the intent for each Playwright tool call.
+- Retrieve generator log via `generator_read_log`
+- Immediately after reading the test log, invoke `generator_write_test` with the generated source code
+  - File should contain single test
+  - File name must be fs-friendly scenario name
+  - Test must be placed in a describe matching the top-level test plan item
+  - Test title must match the scenario name
+  - Includes a comment with the step text before each step execution. Do not duplicate comments if step requires
+    multiple actions.
+  - Always use best practices from the log when generating tests.
+
+   <example-generation>
+   For following plan:
+
+   ```markdown file=specs/plan.md
+   ### 1. Adding New Todos
+   **Seed:** `tests/seed.spec.ts`
+
+   #### 1.1 Add Valid Todo
+   **Steps:**
+   1. Click in the "What needs to be done?" input field
+
+   #### 1.2 Add Multiple Todos
+   ...
+   ```
+
+   Following file is generated:
+
+   ```ts file=add-valid-todo.spec.ts
+   // spec: specs/plan.md
+   // seed: tests/seed.spec.ts
+
+   test.describe('Adding New Todos', () => {
+     test('Add Valid Todo', async { page } => {
+       // 1. Click in the "What needs to be done?" input field
+       await page.click(...);
+
+       ...
+     });
+   });
+   ```
+   </example-generation>
+
+<example>
+  Context: User wants to generate a test for the test plan item.
+  <test-suite><!-- Verbatim name of the test spec group w/o ordinal like "Multiplication tests" --></test-suite>
+  <test-name><!-- Name of the test case without the ordinal like "should add two numbers" --></test-name>
+  <test-file><!-- Name of the file to save the test into, like tests/multiplication/should-add-two-numbers.spec.ts --></test-file>
+  <seed-file><!-- Seed file path from test plan --></seed-file>
+  <body><!-- Test case content including steps and expectations --></body>
+</example>

package/node_modules/playwright/lib/agents/playwright-test-heal.prompt.md

@@ -0,0 +1,6 @@
+---
+agent: playwright-test-healer
+description: Fix tests
+---
+
+Run all my tests and fix the failing ones.

package/node_modules/playwright/lib/agents/playwright-test-healer.agent.md

@@ -0,0 +1,56 @@
+---
+name: playwright-test-healer
+description: Use this agent when you need to debug and fix failing Playwright tests
+model: sonnet
+color: red
+tools:
+  - search
+  - edit
+  - playwright-test/browser_console_messages
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_generate_locator
+  - playwright-test/browser_network_request
+  - playwright-test/browser_network_requests
+  - playwright-test/browser_snapshot
+  - playwright-test/test_debug
+  - playwright-test/test_list
+  - playwright-test/test_run
+---
+
+You are the Playwright Test Healer, an expert test automation engineer specializing in debugging and
+resolving Playwright test failures. Your mission is to systematically identify, diagnose, and fix
+broken Playwright tests using a methodical approach.
+
+Your workflow:
+1. **Initial Execution**: Run all tests using `test_run` tool to identify failing tests
+2. **Debug failed tests**: For each failing test run `test_debug`.
+3. **Error Investigation**: When the test pauses on errors, use available Playwright MCP tools to:
+   - Examine the error details
+   - Capture page snapshot to understand the context
+   - Analyze selectors, timing issues, or assertion failures
+4. **Root Cause Analysis**: Determine the underlying cause of the failure by examining:
+   - Element selectors that may have changed
+   - Timing and synchronization issues
+   - Data dependencies or test environment problems
+   - Application changes that broke test assumptions
+5. **Code Remediation**: Edit the test code to address identified issues, focusing on:
+   - Updating selectors to match current application state
+   - Fixing assertions and expected values
+   - Improving test reliability and maintainability
+   - For inherently dynamic data, utilize regular expressions to produce resilient locators
+6. **Verification**: Restart the test after each fix to validate the changes
+7. **Iteration**: Repeat the investigation and fixing process until the test passes cleanly
+
+Key principles:
+- Be systematic and thorough in your debugging approach
+- Document your findings and reasoning for each fix
+- Prefer robust, maintainable solutions over quick hacks
+- Use Playwright best practices for reliable test automation
+- If multiple errors exist, fix them one at a time and retest
+- Provide clear explanations of what was broken and how you fixed it
+- You will continue this process until the test runs successfully without any failures or errors.
+- If the error persists and you have high level of confidence that the test is correct, mark this test as test.fixme()
+  so that it is skipped during the execution. Add a comment before the failing step explaining what is happening instead
+  of the expected behavior.
+- Do not ask user questions, you are not interactive tool, do the most reasonable thing possible to pass the test.
+- Never wait for networkidle or use other discouraged or deprecated apis

package/node_modules/playwright/lib/agents/playwright-test-plan.prompt.md

@@ -0,0 +1,9 @@
+---
+agent: playwright-test-planner
+description: Create test plan
+---
+
+Create test plan for "add to cart" functionality of my app.
+
+- Seed file: `${seedFile}`
+- Test plan: `specs/coverage.plan.md`

package/node_modules/playwright/lib/agents/playwright-test-planner.agent.md

@@ -0,0 +1,74 @@
+---
+name: playwright-test-planner
+description: Use this agent when you need to create comprehensive test plan for a web application or website
+model: sonnet
+color: green
+tools:
+  - search
+  - playwright-test/browser_click
+  - playwright-test/browser_close
+  - playwright-test/browser_console_messages
+  - playwright-test/browser_drag
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_file_upload
+  - playwright-test/browser_handle_dialog
+  - playwright-test/browser_hover
+  - playwright-test/browser_navigate
+  - playwright-test/browser_navigate_back
+  - playwright-test/browser_network_request
+  - playwright-test/browser_network_requests
+  - playwright-test/browser_press_key
+  - playwright-test/browser_run_code_unsafe
+  - playwright-test/browser_select_option
+  - playwright-test/browser_snapshot
+  - playwright-test/browser_take_screenshot
+  - playwright-test/browser_type
+  - playwright-test/browser_wait_for
+  - playwright-test/planner_setup_page
+  - playwright-test/planner_save_plan
+---
+
+You are an expert web test planner with extensive experience in quality assurance, user experience testing, and test
+scenario design. Your expertise includes functional testing, edge case identification, and comprehensive test coverage
+planning.
+
+You will:
+
+1. **Navigate and Explore**
+   - Invoke the `planner_setup_page` tool once to set up page before using any other tools
+   - Explore the browser snapshot
+   - Do not take screenshots unless absolutely necessary
+   - Use `browser_*` tools to navigate and discover interface
+   - Thoroughly explore the interface, identifying all interactive elements, forms, navigation paths, and functionality
+
+2. **Analyze User Flows**
+   - Map out the primary user journeys and identify critical paths through the application
+   - Consider different user types and their typical behaviors
+
+3. **Design Comprehensive Scenarios**
+
+   Create detailed test scenarios that cover:
+   - Happy path scenarios (normal user behavior)
+   - Edge cases and boundary conditions
+   - Error handling and validation
+
+4. **Structure Test Plans**
+
+   Each scenario must include:
+   - Clear, descriptive title
+   - Detailed step-by-step instructions
+   - Expected outcomes where appropriate
+   - Assumptions about starting state (always assume blank/fresh state)
+   - Success criteria and failure conditions
+
+5. **Create Documentation**
+
+   Submit your test plan using `planner_save_plan` tool.
+
+**Quality Standards**:
+- Write steps that are specific enough for any tester to follow
+- Include negative testing scenarios
+- Ensure scenarios are independent and can be run in any order
+
+**Output Format**: Always save the complete test plan as a markdown file with clear headings, numbered steps, and
+professional formatting suitable for sharing with development and QA teams.

package/node_modules/playwright/lib/cli/reportActions.js

@@ -0,0 +1,78 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var reportActions_exports = {};
+__export(reportActions_exports, {
+  mergeReports: () => mergeReports,
+  showReport: () => showReport
+});
+module.exports = __toCommonJS(reportActions_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_common = require("../common");
+var import_runner = require("../runner");
+const { gracefullyProcessExitDoNotHang } = require("playwright-core/lib/coreBundle").utils;
+async function showReport(report, host, port) {
+  await import_runner.html.showHTMLReport(report, host, port);
+}
+async function mergeReports(reportDir, opts) {
+  const configFile = opts.config;
+  const config = configFile ? await import_common.configLoader.loadConfigFromFile(configFile) : await import_common.configLoader.loadEmptyConfigForMergeReports();
+  const dir = import_path.default.resolve(process.cwd(), reportDir || "");
+  const dirStat = await import_fs.default.promises.stat(dir).catch((e) => null);
+  if (!dirStat)
+    throw new Error("Directory does not exist: " + dir);
+  if (!dirStat.isDirectory())
+    throw new Error(`"${dir}" is not a directory`);
+  let reporterDescriptions = resolveReporterOption(opts.reporter);
+  if (!reporterDescriptions && configFile)
+    reporterDescriptions = config.config.reporter;
+  if (!reporterDescriptions)
+    reporterDescriptions = [[import_common.config.defaultReporter]];
+  const rootDirOverride = configFile ? config.config.rootDir : void 0;
+  const result = await import_runner.merge.createMergedReport(config, dir, reporterDescriptions, rootDirOverride);
+  gracefullyProcessExitDoNotHang(result === "failed" ? 1 : 0);
+}
+function resolveReporterOption(reporter) {
+  if (!reporter || !reporter.length)
+    return void 0;
+  return reporter.split(",").map((r) => [resolveReporter(r)]);
+}
+function resolveReporter(id) {
+  if (import_common.builtInReporters.includes(id))
+    return id;
+  const localPath = import_path.default.resolve(process.cwd(), id);
+  if (import_fs.default.existsSync(localPath))
+    return localPath;
+  return require.resolve(id, { paths: [process.cwd()] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mergeReports,
+  showReport
+});

package/node_modules/playwright/lib/cli/testActions.js

@@ -0,0 +1,214 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var testActions_exports = {};
+__export(testActions_exports, {
+  clearCache: () => clearCache,
+  runTestServerAction: () => runTestServerAction,
+  runTests: () => runTests
+});
+module.exports = __toCommonJS(testActions_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_common = require("../common");
+var import_runner = require("../runner");
+const { gracefullyProcessExitDoNotHang } = require("playwright-core/lib/coreBundle").utils;
+const { startProfiling, stopProfiling } = require("playwright-core/lib/coreBundle").utils;
+async function runTests(args, opts) {
+  await startProfiling();
+  const cliOverrides = overridesFromOptions(opts);
+  cliOverrides.argv = process.argv;
+  const config = await import_common.configLoader.loadConfigFromFile(opts.config, cliOverrides, opts.deps === false);
+  const options = {
+    locations: args.length ? args : void 0,
+    grep: opts.grep,
+    grepInvert: opts.grepInvert,
+    onlyChanged: opts.onlyChanged === true ? "HEAD" : opts.onlyChanged,
+    listMode: !!opts.list,
+    projectFilter: opts.project || void 0,
+    passWithNoTests: !!opts.passWithNoTests,
+    lastFailed: !!opts.lastFailed,
+    lastFailedFile: opts.lastFailedFile,
+    testList: opts.testList ? import_path.default.resolve(process.cwd(), opts.testList) : void 0,
+    testListInvert: opts.testListInvert ? import_path.default.resolve(process.cwd(), opts.testListInvert) : void 0,
+    shardWeights: resolveShardWeightsOption()
+  };
+  import_runner.projectUtils.filterProjects(config.projects, options.projectFilter);
+  if (opts.ui || opts.uiHost || opts.uiPort) {
+    if (opts.onlyChanged)
+      throw new Error(`--only-changed is not supported in UI mode. If you'd like that to change, see https://github.com/microsoft/playwright/issues/15075 for more details.`);
+    const status2 = await import_runner.testServer.runUIMode(opts.config, cliOverrides, {
+      host: opts.uiHost,
+      port: opts.uiPort ? +opts.uiPort : void 0,
+      args,
+      grep: opts.grep,
+      grepInvert: opts.grepInvert,
+      project: opts.project || void 0,
+      reporter: Array.isArray(opts.reporter) ? opts.reporter : opts.reporter ? [opts.reporter] : void 0
+    });
+    await stopProfiling("runner");
+    const exitCode2 = status2 === "interrupted" ? 130 : status2 === "passed" ? 0 : 1;
+    gracefullyProcessExitDoNotHang(exitCode2);
+    return;
+  }
+  if (process.env.PWTEST_WATCH) {
+    if (opts.onlyChanged)
+      throw new Error(`--only-changed is not supported in watch mode. If you'd like that to change, file an issue and let us know about your usecase for it.`);
+    const status2 = await import_runner.watchMode.runWatchModeLoop(
+      import_common.configLoader.resolveConfigLocation(opts.config),
+      {
+        projects: opts.project,
+        files: args,
+        grep: opts.grep
+      }
+    );
+    await stopProfiling("runner");
+    const exitCode2 = status2 === "interrupted" ? 130 : status2 === "passed" ? 0 : 1;
+    gracefullyProcessExitDoNotHang(exitCode2);
+    return;
+  }
+  const status = await import_runner.testRunner.runAllTestsWithConfig(config, options);
+  await stopProfiling("runner");
+  const exitCode = status === "interrupted" ? 130 : status === "passed" ? 0 : 1;
+  gracefullyProcessExitDoNotHang(exitCode);
+}
+async function runTestServerAction(opts) {
+  const host = opts.host;
+  const port = opts.port ? +opts.port : void 0;
+  const status = await import_runner.testServer.runTestServer(opts.config, {}, { host, port });
+  const exitCode = status === "interrupted" ? 130 : status === "passed" ? 0 : 1;
+  gracefullyProcessExitDoNotHang(exitCode);
+}
+async function clearCache(opts) {
+  const runner = new import_runner.testRunner.TestRunner(import_common.configLoader.resolveConfigLocation(opts.config), {});
+  const { status } = await runner.clearCache(import_runner.runnerReporters.createErrorCollectingReporter(import_runner.base.terminalScreen));
+  const exitCode = status === "interrupted" ? 130 : status === "passed" ? 0 : 1;
+  gracefullyProcessExitDoNotHang(exitCode);
+}
+function overridesFromOptions(options) {
+  if (options.ui) {
+    options.debug = void 0;
+    options.trace = void 0;
+  }
+  const overrides = {
+    debug: options.debug,
+    failOnFlakyTests: options.failOnFlakyTests ? true : void 0,
+    forbidOnly: options.forbidOnly ? true : void 0,
+    fullyParallel: options.fullyParallel ? true : void 0,
+    globalTimeout: options.globalTimeout ? parseInt(options.globalTimeout, 10) : void 0,
+    maxFailures: options.x ? 1 : options.maxFailures ? parseInt(options.maxFailures, 10) : void 0,
+    outputDir: options.output ? import_path.default.resolve(process.cwd(), options.output) : void 0,
+    pause: !!process.env.PWPAUSE,
+    quiet: options.quiet ? options.quiet : void 0,
+    repeatEach: options.repeatEach ? parseInt(options.repeatEach, 10) : void 0,
+    retries: options.retries ? parseInt(options.retries, 10) : void 0,
+    reporter: resolveReporterOption(options.reporter),
+    additionalReporters: resolveReporterOption(options.addReporter),
+    shard: resolveShardOption(options.shard),
+    timeout: options.timeout ? parseInt(options.timeout, 10) : void 0,
+    tsconfig: options.tsconfig ? import_path.default.resolve(process.cwd(), options.tsconfig) : void 0,
+    ignoreSnapshots: options.ignoreSnapshots ? !!options.ignoreSnapshots : void 0,
+    updateSnapshots: options.updateSnapshots,
+    updateSourceMethod: options.updateSourceMethod,
+    use: {
+      trace: options.trace
+    },
+    workers: options.workers
+  };
+  if (options.browser) {
+    const browserOpt = options.browser.toLowerCase();
+    if (!["all", "chromium", "firefox", "webkit"].includes(browserOpt))
+      throw new Error(`Unsupported browser "${options.browser}", must be one of "all", "chromium", "firefox" or "webkit"`);
+    const browserNames = browserOpt === "all" ? ["chromium", "firefox", "webkit"] : [browserOpt];
+    overrides.projects = browserNames.map((browserName) => {
+      return {
+        name: browserName,
+        use: { browserName }
+      };
+    });
+  }
+  if (options.headed)
+    overrides.use.headless = false;
+  if (options.debug === "inspector") {
+    overrides.use.headless = false;
+    process.env.PWDEBUG = "1";
+  }
+  if (overrides.tsconfig && !import_fs.default.existsSync(overrides.tsconfig))
+    throw new Error(`--tsconfig "${options.tsconfig}" does not exist`);
+  return overrides;
+}
+function resolveReporterOption(reporter) {
+  if (!reporter || !reporter.length)
+    return void 0;
+  return reporter.split(",").map((r) => [resolveReporter(r)]);
+}
+function resolveShardOption(shard) {
+  if (!shard)
+    return void 0;
+  const shardPair = shard.split("/");
+  if (shardPair.length !== 2) {
+    throw new Error(
+      `--shard "${shard}", expected format is "current/all", 1-based, for example "3/5".`
+    );
+  }
+  const current = parseInt(shardPair[0], 10);
+  const total = parseInt(shardPair[1], 10);
+  if (isNaN(total) || total < 1)
+    throw new Error(`--shard "${shard}" total must be a positive number`);
+  if (isNaN(current) || current < 1 || current > total) {
+    throw new Error(
+      `--shard "${shard}" current must be a positive number, not greater than shard total`
+    );
+  }
+  return { current, total };
+}
+function resolveShardWeightsOption() {
+  const shardWeights = process.env.PWTEST_SHARD_WEIGHTS;
+  if (!shardWeights)
+    return void 0;
+  return shardWeights.split(":").map((w) => {
+    const weight = parseInt(w, 10);
+    if (isNaN(weight) || weight < 0)
+      throw new Error(`PWTEST_SHARD_WEIGHTS="${shardWeights}" weights must be non-negative numbers`);
+    return weight;
+  });
+}
+function resolveReporter(id) {
+  if (import_common.builtInReporters.includes(id))
+    return id;
+  const localPath = import_path.default.resolve(process.cwd(), id);
+  if (import_fs.default.existsSync(localPath))
+    return localPath;
+  return require.resolve(id, { paths: [process.cwd()] });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearCache,
+  runTestServerAction,
+  runTests
+});