@yasserkhanorg/e2e-agents 0.10.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/README.md +112 -584
  2. package/dist/agent/api_catalog.d.ts +11 -0
  3. package/dist/agent/api_catalog.d.ts.map +1 -0
  4. package/dist/agent/api_catalog.js +210 -0
  5. package/dist/agent/llm_agents_flow.d.ts +15 -0
  6. package/dist/agent/llm_agents_flow.d.ts.map +1 -0
  7. package/dist/agent/llm_agents_flow.js +434 -0
  8. package/dist/agent/native_flow.d.ts +6 -0
  9. package/dist/agent/native_flow.d.ts.map +1 -0
  10. package/dist/agent/native_flow.js +179 -0
  11. package/dist/agent/pipeline.d.ts +2 -25
  12. package/dist/agent/pipeline.d.ts.map +1 -1
  13. package/dist/agent/pipeline.js +30 -1329
  14. package/dist/agent/pipeline_types.d.ts +54 -0
  15. package/dist/agent/pipeline_types.d.ts.map +1 -0
  16. package/dist/agent/pipeline_types.js +4 -0
  17. package/dist/agent/pipeline_utils.d.ts +12 -0
  18. package/dist/agent/pipeline_utils.d.ts.map +1 -0
  19. package/dist/agent/pipeline_utils.js +156 -0
  20. package/dist/agent/process_runner.d.ts +10 -0
  21. package/dist/agent/process_runner.d.ts.map +1 -0
  22. package/dist/agent/process_runner.js +92 -0
  23. package/dist/agent/spec_generator.d.ts +5 -0
  24. package/dist/agent/spec_generator.d.ts.map +1 -0
  25. package/dist/agent/spec_generator.js +253 -0
  26. package/dist/agent/validation_runner.d.ts +5 -0
  27. package/dist/agent/validation_runner.d.ts.map +1 -0
  28. package/dist/agent/validation_runner.js +77 -0
  29. package/dist/agentic/playwright_runner.js +1 -1
  30. package/dist/cli/commands/analyze.d.ts +3 -0
  31. package/dist/cli/commands/analyze.d.ts.map +1 -0
  32. package/dist/cli/commands/analyze.js +77 -0
  33. package/dist/cli/commands/feedback.d.ts +3 -0
  34. package/dist/cli/commands/feedback.d.ts.map +1 -0
  35. package/dist/cli/commands/feedback.js +39 -0
  36. package/dist/cli/commands/finalize.d.ts +3 -0
  37. package/dist/cli/commands/finalize.d.ts.map +1 -0
  38. package/dist/cli/commands/finalize.js +41 -0
  39. package/dist/cli/commands/generate.d.ts +4 -0
  40. package/dist/cli/commands/generate.d.ts.map +1 -0
  41. package/dist/cli/commands/generate.js +108 -0
  42. package/dist/cli/commands/heal.d.ts +3 -0
  43. package/dist/cli/commands/heal.d.ts.map +1 -0
  44. package/dist/cli/commands/heal.js +60 -0
  45. package/dist/cli/commands/impact.d.ts +4 -0
  46. package/dist/cli/commands/impact.d.ts.map +1 -0
  47. package/dist/cli/commands/impact.js +26 -0
  48. package/dist/cli/commands/llm_health.d.ts +2 -0
  49. package/dist/cli/commands/llm_health.d.ts.map +1 -0
  50. package/dist/cli/commands/llm_health.js +38 -0
  51. package/dist/cli/commands/plan.d.ts +4 -0
  52. package/dist/cli/commands/plan.d.ts.map +1 -0
  53. package/dist/cli/commands/plan.js +83 -0
  54. package/dist/cli/commands/traceability.d.ts +4 -0
  55. package/dist/cli/commands/traceability.d.ts.map +1 -0
  56. package/dist/cli/commands/traceability.js +77 -0
  57. package/dist/cli/parse_args.d.ts +6 -0
  58. package/dist/cli/parse_args.d.ts.map +1 -0
  59. package/dist/cli/parse_args.js +216 -0
  60. package/dist/cli/types.d.ts +70 -0
  61. package/dist/cli/types.d.ts.map +1 -0
  62. package/dist/cli/types.js +4 -0
  63. package/dist/cli/usage.d.ts +2 -0
  64. package/dist/cli/usage.d.ts.map +1 -0
  65. package/dist/cli/usage.js +86 -0
  66. package/dist/cli.js +26 -1060
  67. package/dist/esm/agent/api_catalog.js +199 -0
  68. package/dist/esm/agent/llm_agents_flow.js +421 -0
  69. package/dist/esm/agent/native_flow.js +175 -0
  70. package/dist/esm/agent/pipeline.js +8 -1307
  71. package/dist/esm/agent/pipeline_types.js +3 -0
  72. package/dist/esm/agent/pipeline_utils.js +146 -0
  73. package/dist/esm/agent/process_runner.js +83 -0
  74. package/dist/esm/agent/spec_generator.js +249 -0
  75. package/dist/esm/agent/validation_runner.js +73 -0
  76. package/dist/esm/agentic/playwright_runner.js +1 -1
  77. package/dist/esm/cli/commands/analyze.js +74 -0
  78. package/dist/esm/cli/commands/feedback.js +36 -0
  79. package/dist/esm/cli/commands/finalize.js +38 -0
  80. package/dist/esm/cli/commands/generate.js +105 -0
  81. package/dist/esm/cli/commands/heal.js +57 -0
  82. package/dist/esm/cli/commands/impact.js +23 -0
  83. package/dist/esm/cli/commands/llm_health.js +35 -0
  84. package/dist/esm/cli/commands/plan.js +80 -0
  85. package/dist/esm/cli/commands/traceability.js +73 -0
  86. package/dist/esm/cli/parse_args.js +210 -0
  87. package/dist/esm/cli/types.js +3 -0
  88. package/dist/esm/cli/usage.js +83 -0
  89. package/dist/esm/cli.js +20 -1054
  90. package/dist/esm/mcp-server.js +18 -1
  91. package/dist/mcp-server.d.ts.map +1 -1
  92. package/dist/mcp-server.js +17 -0
  93. package/package.json +2 -4
package/dist/esm/cli/usage.js ADDED
@@ -0,0 +1,83 @@
1
+ // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
2
+ // See LICENSE.txt for license information.
3
+ export function printUsage() {
4
+ console.log([
5
+ 'Usage:',
6
+ ' e2e-ai-agents impact --path <app-root> [options]',
7
+ ' e2e-ai-agents plan --path <app-root> [options]',
8
+ ' e2e-ai-agents suggest --path <app-root> [options]',
9
+ ' e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
10
+ ' e2e-ai-agents finalize-generated-tests --path <app-root> [options]',
11
+ ' e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
12
+ ' e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
13
+ ' e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
14
+ ' e2e-ai-agents generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
15
+ ' e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
16
+ ' e2e-ai-agents llm-health',
17
+ '',
18
+ 'Options:',
19
+ ' --config <path> Path to e2e-ai-agents.config.json (auto-discovered if present)',
20
+ ' --path <app-root> Path to the web app (required)',
21
+ ' --profile <name> default | mattermost',
22
+ ' --mattermost Shortcut for --profile mattermost',
23
+ ' --tests-root <path> Path to tests root (optional)',
24
+ ' --framework <name> auto | playwright | cypress | selenium',
25
+ ' --patterns <globs> Comma-separated test patterns',
26
+ ' --flow-patterns <g> Comma-separated flow discovery patterns',
27
+ ' --flow-exclude <g> Comma-separated flow exclude patterns',
28
+ ' --flow-catalog <path> Path to flow catalog JSON',
29
+ ' --allow-fallback Allow impact analysis without diff',
30
+ ' --pipeline Run Playwright AI pipeline for missing P0/P1 flows',
31
+ ' --pipeline-scenarios Number of scenarios per flow (default 3)',
32
+ ' --pipeline-output Output directory for generated tests',
33
+ ' --pipeline-base-url Base URL for Playwright runs',
34
+ ' --pipeline-browser Browser: chrome|chromium|firefox|webkit',
35
+ ' --pipeline-headless Run in headless mode',
36
+ ' --pipeline-headed Run in headed mode',
37
+ ' --pipeline-project Playwright project name',
38
+ ' --pipeline-parallel Enable parallel mode in generator',
39
+ ' --pipeline-dry-run Do not execute pipeline (report only)',
40
+ ' --pipeline-mcp Use Playwright MCP server for exploration/healing',
41
+ ' --pipeline-mcp-allow-fallback Allow non-MCP fallback if official MCP setup fails',
42
+ ' --pipeline-mcp-only Require MCP for UI exploration (fail if unavailable)',
43
+ ' --pipeline-mcp-timeout-ms <n> Timeout per MCP CLI invocation in milliseconds',
44
+ ' --pipeline-mcp-retries <n> Retry count for retryable MCP CLI failures',
45
+ ' --spec <path> Optional spec PDF for context',
46
+ ' --since <git-ref> Git ref for impact analysis (default HEAD~1)',
47
+ ' --time <minutes> Time limit in minutes',
48
+ ' --budget-usd <amount> Max LLM budget in USD',
49
+ ' --budget-tokens <n> Max LLM tokens',
50
+ ' --llm-provider <name> LLM provider: auto | anthropic | openai | ollama',
51
+ ' --policy-min-confidence <n> Minimum confidence for targeted suite',
52
+ ' --policy-safe-merge-confidence <n> Confidence needed for safe-to-merge',
53
+ ' --policy-force-full-on-warnings <n> Escalate to full at warning count',
54
+ ' --policy-risky-patterns <globs> Comma-separated risky file globs',
55
+ ' --policy-enforcement-mode <mode> advisory | warn | block',
56
+ ' --policy-block-actions <actions> Comma-separated CI actions to block/warn',
57
+ ' --ci-comment-path <path> Write CI markdown summary',
58
+ ' --github-output <path> Write GitHub Actions outputs',
59
+ ' --fail-on-must-add-tests Exit non-zero on must-add-tests decision',
60
+ ' --feedback-input <path> Path to recommendation feedback JSON',
61
+ ' --traceability-report <path> Path to Playwright JSON report for traceability capture',
62
+ ' --traceability-capture-output <path> Output path for generated traceability ingest JSON',
63
+ ' --traceability-coverage-map <path> Optional coverage map (test<->files) to enrich traceability capture',
64
+ ' --traceability-changed-files <path> Optional changed-files list/JSON fallback for traceability capture',
65
+ ' --traceability-input <path> Path to traceability ingest JSON payload',
66
+ ' --traceability-min-hits <n> Minimum signal hits required per file mapping',
67
+ ' --traceability-max-files-per-test <n> Cap max mapped files per test',
68
+ ' --traceability-max-age-days <n> Drop stale mappings older than N days',
69
+ ' --branch <name> Optional handoff branch (prefixed with codex/)',
70
+ ' --commit-message <m> Commit message for finalize-generated-tests',
71
+ ' --create-pr Open PR with gh after commit',
72
+ ' --pr-title <title> PR title for finalize-generated-tests',
73
+ ' --pr-body <body> PR body for finalize-generated-tests',
74
+ ' --pr-base <branch> PR base branch for finalize-generated-tests',
75
+ ' (auto-heal-pr defaults to base=master)',
76
+ ' --dry-run Preview actions without mutating git state',
77
+ ' --max-attempts <n> Max fix attempts per scenario (default: 3)',
78
+ ' --scenarios <path|json> Scenarios file/JSON for generate command',
79
+ ' --apply Apply data-testid patches and generate tests',
80
+ ' (legacy shortcut; prefer approve-and-generate)',
81
+ ' --help Show help',
82
+ ].join('\n'));
83
+ }