@yasserkhanorg/e2e-agents 1.10.1 → 1.10.2

package/dist/cli/defaults.js

@@ -10,6 +10,42 @@ exports.resolveDefaults = resolveDefaults;
 const fs_1 = require("fs");
 const child_process_1 = require("child_process");
 const path_1 = require("path");
+function detectPytestFramework(appPath) {
+    const resolvedPath = (0, path_1.resolve)(appPath);
+    const pytestIni = (0, path_1.join)(resolvedPath, 'pytest.ini');
+    if ((0, fs_1.existsSync)(pytestIni)) {
+        return 'pytest';
+    }
+    const conftest = (0, path_1.join)(resolvedPath, 'conftest.py');
+    if ((0, fs_1.existsSync)(conftest)) {
+        return 'pytest';
+    }
+    const pyproject = (0, path_1.join)(resolvedPath, 'pyproject.toml');
+    if ((0, fs_1.existsSync)(pyproject)) {
+        try {
+            const content = (0, fs_1.readFileSync)(pyproject, 'utf-8');
+            if (content.includes('pytest')) {
+                return 'pytest';
+            }
+        }
+        catch {
+            // ignore malformed or unreadable file
+        }
+    }
+    const setupCfg = (0, path_1.join)(resolvedPath, 'setup.cfg');
+    if ((0, fs_1.existsSync)(setupCfg)) {
+        try {
+            const content = (0, fs_1.readFileSync)(setupCfg, 'utf-8');
+            if (content.includes('[tool:pytest]') || content.includes('[pytest]')) {
+                return 'pytest';
+            }
+        }
+        catch {
+            // ignore malformed or unreadable file
+        }
+    }
+    return undefined;
+}
 /**
  * Detect the test framework from package.json dependencies.
  */
@@ -17,6 +53,10 @@ function detectFramework(appPath) {
     const resolvedPath = (0, path_1.resolve)(appPath);
     const pkgPath = (0, path_1.join)(resolvedPath, 'package.json');
     if (!(0, fs_1.existsSync)(pkgPath)) {
+        const pytestFramework = detectPytestFramework(resolvedPath);
+        if (pytestFramework) {
+            return pytestFramework;
+        }
         return 'auto';
     }
     try {
@@ -28,6 +68,9 @@ function detectFramework(appPath) {
         if (allDeps.cypress) {
             return 'cypress';
         }
+        if (allDeps.supertest) {
+            return 'supertest';
+        }
         if (allDeps['selenium-webdriver'] || allDeps.webdriverio) {
             return 'selenium';
         }
@@ -35,6 +78,10 @@ function detectFramework(appPath) {
     catch {
         // ignore malformed package.json
     }
+    const pytestFramework = detectPytestFramework(resolvedPath);
+    if (pytestFramework) {
+        return pytestFramework;
+    }
     return 'auto';
 }
 /**

package/dist/cli/parse_args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAE7F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AA4JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAuFpD"}
+{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAE7F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AA6JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAyFpD"}

package/dist/cli/parse_args.js

@@ -133,6 +133,7 @@ const FLAGS = {
     '--patterns': { key: 'testPatterns', type: 'csv' },
     '--flow-patterns': { key: 'flowPatterns', type: 'csv' },
     '--flow-exclude': { key: 'flowExclude', type: 'csv' },
+    '--plugins': { key: 'plugins', type: 'csv' },
     '--policy-risky-patterns': { key: 'policyRiskyPatterns', type: 'csv' },
     '--policy-block-actions': {
         key: 'policyBlockActions',
@@ -180,7 +181,8 @@ function parseArgs(argv) {
     if (COMMANDS.has(command)) {
         parsed.command = command;
     }
-    for (let i = 1; i < argv.length; i += 1) {
+    const startIndex = parsed.command ? 1 : 0;
+    for (let i = startIndex; i < argv.length; i += 1) {
         const arg = argv[i];
         const canonical = ALIAS_MAP[arg];
         if (!canonical) {

package/dist/cli/types.d.ts

@@ -74,6 +74,7 @@ export interface ParsedArgs {
     trainYes?: boolean;
     serverPath?: string;
     crewWorkflow?: string;
+    plugins?: string[];
     gateThreshold?: number;
     bootstrapKgPath?: string;
     bootstrapScaffoldFramework?: boolean;

package/dist/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"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"}

package/dist/cli/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CA+FjC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CAyGjC"}

package/dist/cli/usage.js

@@ -6,23 +6,32 @@ exports.printUsage = printUsage;
 function printUsage() {
     console.log([
         'Usage:',
-        '  e2e-ai-agents init [--yes]',
-        '  e2e-ai-agents impact --path <app-root> [options]',
-        '  e2e-ai-agents plan --path <app-root> [options]',
-        '  e2e-ai-agents suggest --path <app-root> [options]',
-        '  e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
-        '  e2e-ai-agents finalize-generated-tests --path <app-root> [options]',
-        '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
-        '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
-        '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
-        '  e2e-ai-agents generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
-        '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
-        '  e2e-ai-agents train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
-        '  e2e-ai-agents crew --path <app-root> [--crew-workflow <name>]',
-        '  e2e-ai-agents gate --path <app-root> --threshold <n> [--since <ref>]',
-        '  e2e-ai-agents cost-report [--path <app-root>]',
-        '  e2e-ai-agents bootstrap --path <app-root> [options]',
-        '  e2e-ai-agents llm-health',
+        '  e2e-ai-agents <command> [options]',
+        '',
+        'Core CI workflow:',
+        '  impact --path <app-root> [options]',
+        '  plan --path <app-root> [options]',
+        '  suggest --path <app-root> [options]',
+        '  gate --path <app-root> --threshold <n> [--since <ref>]',
+        '',
+        'Optional AI workflow:',
+        '  analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
+        '  generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
+        '  heal --path <app-root> --traceability-report <json> [options]',
+        '  finalize-generated-tests --path <app-root> [options]',
+        '',
+        'Setup and calibration:',
+        '  init [--yes]',
+        '  train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
+        '  bootstrap --path <app-root> [options]',
+        '  feedback --path <app-root> --feedback-input <json>',
+        '  traceability-capture --path <app-root> --traceability-report <json>',
+        '  traceability-ingest --path <app-root> --traceability-input <json>',
+        '  cost-report [--path <app-root>]',
+        '  llm-health',
+        '',
+        'Advanced / experimental:',
+        '  crew --path <app-root> [--crew-workflow <name>] [--plugins <paths>]',
         '',
         'Options:',
         '  --config <path>       Path to e2e-ai-agents.config.json (auto-discovered if present)',
@@ -30,10 +39,11 @@ function printUsage() {
         '  --profile <name>     default | mattermost',
         '  --mattermost         Shortcut for --profile mattermost',
         '  --tests-root <path>   Path to tests root (optional)',
-        '  --framework <name>    auto | playwright | cypress | selenium',
+        '  --framework <name>    auto | playwright | cypress | pytest | supertest | selenium',
         '  --patterns <globs>    Comma-separated test patterns',
         '  --flow-patterns <g>   Comma-separated flow discovery patterns',
         '  --flow-exclude <g>    Comma-separated flow exclude patterns',
+        '  --plugins <paths>     Comma-separated plugin module paths for crew workflows',
         '  --flow-catalog <path> Path to flow catalog JSON',
         '  --allow-fallback      Allow impact analysis without diff',
         '  --pipeline            Run Playwright AI pipeline for missing P0/P1 flows',

package/dist/cli.js

@@ -59,10 +59,14 @@ async function main() {
         await (0, train_js_1.runTrainCommand)(args, autoConfig);
         return;
     }
-    if (args.help || !args.command) {
+    if (args.help) {
         (0, usage_js_1.printUsage)();
         process.exit(0);
     }
+    if (!args.command) {
+        (0, usage_js_1.printUsage)();
+        process.exit(1);
+    }
     if (args.command === 'llm-health') {
         await (0, llm_health_js_1.runLlmHealth)();
         return;

package/dist/esm/agent/config.js

@@ -335,7 +335,12 @@ function normalizeProfile(value) {
     return undefined;
 }
 function normalizeFramework(value) {
-    if (value === 'auto' || value === 'playwright' || value === 'cypress' || value === 'selenium') {
+    if (value === 'auto' ||
+        value === 'playwright' ||
+        value === 'cypress' ||
+        value === 'pytest' ||
+        value === 'supertest' ||
+        value === 'selenium') {
         return value;
     }
     return undefined;

package/dist/esm/cache/cached_provider.js

@@ -77,6 +77,9 @@ export class CachedProvider {
     resetUsageStats() {
         this.inner.resetUsageStats();
     }
+    async checkHealth() {
+        return this.inner.checkHealth();
+    }
 }
 // Re-export for convenience
 export { ResponseCache, TTL } from './response_cache.js';

package/dist/esm/cli/commands/crew.js

@@ -65,6 +65,7 @@ export async function runCrewCommand(args, autoConfig) {
         providerOverride: args.llmProvider,
         budgetUSD: args.budgetUSD,
         dryRun: degraded || args.dryRun,
+        plugins: args.plugins,
     };
     // Create orchestrator and register all agents
     const orchestrator = new CrewOrchestrator();

package/dist/esm/cli/commands/init.js

@@ -45,10 +45,10 @@ function buildConfig(answers) {
 function printNextSteps() {
     console.log('');
     console.log('  Next steps:');
-    console.log('    1. Set your API key:  export ANTHROPIC_API_KEY=sk-ant-...');
-    console.log('    2. Test connectivity:  npx e2e-ai-agents llm-health');
-    console.log('    3. Run impact analysis: npx e2e-ai-agents impact');
-    console.log('    4. Add to CI: see examples/github-actions/pr-impact.yml');
+    console.log('    1. Start with impact analysis:  npx e2e-ai-agents impact --path .');
+    console.log('    2. Build a coverage plan:      npx e2e-ai-agents plan --path .');
+    console.log('    3. Optional AI setup:          export ANTHROPIC_API_KEY=sk-ant-...');
+    console.log('    4. Verify provider health:     npx e2e-ai-agents llm-health');
     console.log('');
 }
 export async function runInitCommand(yes = false) {
@@ -88,7 +88,7 @@ export async function runInitCommand(yes = false) {
     try {
         const appPath = await ask(rl, '  Path to your web app root', '.');
         const detectedFramework = detectFramework(appPath);
-        const framework = await ask(rl, '  Test framework (auto | playwright | cypress | selenium)', detectedFramework);
+        const framework = await ask(rl, '  Test framework (auto | playwright | cypress | pytest | supertest | selenium)', detectedFramework);
         const detectedTestsRoot = detectTestsRoot(appPath);
         const testsRoot = await ask(rl, '  Path to tests root (relative to app root, "." if same)', detectedTestsRoot || '.');
         const detectedBranch = detectGitDefaultBranch(appPath);

package/dist/esm/cli/commands/llm_health.js

@@ -1,75 +1,19 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
-import { AnthropicProvider } from '../../anthropic_provider.js';
-import { OpenAIProvider } from '../../openai_provider.js';
-import { OllamaProvider } from '../../ollama_provider.js';
-import { LLMProviderError } from '../../provider_interface.js';
-async function checkAnthropic() {
-    if (!process.env.ANTHROPIC_API_KEY) {
-        return null;
-    }
-    const model = process.env.ANTHROPIC_MODEL || 'claude-sonnet-4-5-20250929';
-    try {
-        const provider = new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY, model });
-        const response = await provider.generateText('Reply with OK.', { maxTokens: 8, timeout: 15000 });
-        return { provider: 'Anthropic', model, ok: true, response: response.text.trim() };
-    }
-    catch (error) {
-        const message = error instanceof LLMProviderError || error instanceof Error ? error.message : String(error);
-        return { provider: 'Anthropic', model, ok: false, error: message };
-    }
-}
-async function checkOpenAI() {
-    if (!process.env.OPENAI_API_KEY) {
-        return null;
-    }
-    const model = process.env.OPENAI_MODEL || 'gpt-4o';
-    try {
-        const provider = new OpenAIProvider({ apiKey: process.env.OPENAI_API_KEY, model });
-        const response = await provider.generateText('Reply with OK.', { maxTokens: 8, timeout: 15000 });
-        return { provider: 'OpenAI', model, ok: true, response: response.text.trim() };
-    }
-    catch (error) {
-        const message = error instanceof LLMProviderError || error instanceof Error ? error.message : String(error);
-        return { provider: 'OpenAI', model, ok: false, error: message };
-    }
-}
-async function checkOllama() {
-    const baseUrl = process.env.OLLAMA_HOST || 'http://localhost:11434';
-    const model = process.env.OLLAMA_MODEL || 'llama3';
-    try {
-        const provider = new OllamaProvider({ baseUrl, model });
-        const response = await provider.generateText('Reply with OK.', { maxTokens: 8, timeout: 15000 });
-        return { provider: 'Ollama', model, ok: true, response: response.text.trim() };
-    }
-    catch (error) {
-        const message = error instanceof LLMProviderError || error instanceof Error ? error.message : String(error);
-        return { provider: 'Ollama', model, ok: false, error: message };
-    }
-}
+import { LLMProviderFactory } from '../../provider_factory.js';
 export async function runLlmHealth() {
-    const checks = await Promise.allSettled([checkAnthropic(), checkOpenAI(), checkOllama()]);
-    const results = [];
-    for (const check of checks) {
-        if (check.status === 'fulfilled' && check.value) {
-            results.push(check.value);
-        }
-    }
-    if (results.length === 0) {
-        console.error('No LLM providers configured. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or OLLAMA_HOST.');
-        process.exit(1);
-    }
-    let anyFailed = false;
-    for (const r of results) {
-        if (r.ok) {
-            console.log(`${r.provider} OK (${r.model}) -> ${r.response}`);
-        }
-        else {
-            console.error(`${r.provider} failed (${r.model}): ${r.error}`);
-            anyFailed = true;
+    try {
+        const provider = await LLMProviderFactory.createFromEnv();
+        const health = await provider.checkHealth();
+        if (!health.healthy) {
+            console.error(`${provider.name} failed: ${health.message}`);
+            process.exit(1);
         }
+        console.log(`${provider.name} OK -> ${health.message}`);
     }
-    if (anyFailed) {
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`LLM health check failed: ${message}`);
         process.exit(1);
     }
 }

package/dist/esm/cli/defaults.js

@@ -3,6 +3,42 @@
 import { existsSync, readFileSync } from 'fs';
 import { execFileSync } from 'child_process';
 import { join, resolve } from 'path';
+function detectPytestFramework(appPath) {
+    const resolvedPath = resolve(appPath);
+    const pytestIni = join(resolvedPath, 'pytest.ini');
+    if (existsSync(pytestIni)) {
+        return 'pytest';
+    }
+    const conftest = join(resolvedPath, 'conftest.py');
+    if (existsSync(conftest)) {
+        return 'pytest';
+    }
+    const pyproject = join(resolvedPath, 'pyproject.toml');
+    if (existsSync(pyproject)) {
+        try {
+            const content = readFileSync(pyproject, 'utf-8');
+            if (content.includes('pytest')) {
+                return 'pytest';
+            }
+        }
+        catch {
+            // ignore malformed or unreadable file
+        }
+    }
+    const setupCfg = join(resolvedPath, 'setup.cfg');
+    if (existsSync(setupCfg)) {
+        try {
+            const content = readFileSync(setupCfg, 'utf-8');
+            if (content.includes('[tool:pytest]') || content.includes('[pytest]')) {
+                return 'pytest';
+            }
+        }
+        catch {
+            // ignore malformed or unreadable file
+        }
+    }
+    return undefined;
+}
 /**
  * Detect the test framework from package.json dependencies.
  */
@@ -10,6 +46,10 @@ export function detectFramework(appPath) {
     const resolvedPath = resolve(appPath);
     const pkgPath = join(resolvedPath, 'package.json');
     if (!existsSync(pkgPath)) {
+        const pytestFramework = detectPytestFramework(resolvedPath);
+        if (pytestFramework) {
+            return pytestFramework;
+        }
         return 'auto';
     }
     try {
@@ -21,6 +61,9 @@ export function detectFramework(appPath) {
         if (allDeps.cypress) {
             return 'cypress';
         }
+        if (allDeps.supertest) {
+            return 'supertest';
+        }
         if (allDeps['selenium-webdriver'] || allDeps.webdriverio) {
             return 'selenium';
         }
@@ -28,6 +71,10 @@ export function detectFramework(appPath) {
     catch {
         // ignore malformed package.json
     }
+    const pytestFramework = detectPytestFramework(resolvedPath);
+    if (pytestFramework) {
+        return pytestFramework;
+    }
     return 'auto';
 }
 /**

package/dist/esm/cli/parse_args.js

@@ -127,6 +127,7 @@ const FLAGS = {
     '--patterns': { key: 'testPatterns', type: 'csv' },
     '--flow-patterns': { key: 'flowPatterns', type: 'csv' },
     '--flow-exclude': { key: 'flowExclude', type: 'csv' },
+    '--plugins': { key: 'plugins', type: 'csv' },
     '--policy-risky-patterns': { key: 'policyRiskyPatterns', type: 'csv' },
     '--policy-block-actions': {
         key: 'policyBlockActions',
@@ -174,7 +175,8 @@ export function parseArgs(argv) {
     if (COMMANDS.has(command)) {
         parsed.command = command;
     }
-    for (let i = 1; i < argv.length; i += 1) {
+    const startIndex = parsed.command ? 1 : 0;
+    for (let i = startIndex; i < argv.length; i += 1) {
         const arg = argv[i];
         const canonical = ALIAS_MAP[arg];
         if (!canonical) {

package/dist/esm/cli/usage.js

@@ -3,23 +3,32 @@
 export function printUsage() {
     console.log([
         'Usage:',
-        '  e2e-ai-agents init [--yes]',
-        '  e2e-ai-agents impact --path <app-root> [options]',
-        '  e2e-ai-agents plan --path <app-root> [options]',
-        '  e2e-ai-agents suggest --path <app-root> [options]',
-        '  e2e-ai-agents heal --path <app-root> --traceability-report <json> [options]',
-        '  e2e-ai-agents finalize-generated-tests --path <app-root> [options]',
-        '  e2e-ai-agents feedback --path <app-root> --feedback-input <json>',
-        '  e2e-ai-agents traceability-capture --path <app-root> --traceability-report <json>',
-        '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
-        '  e2e-ai-agents generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
-        '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
-        '  e2e-ai-agents train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
-        '  e2e-ai-agents crew --path <app-root> [--crew-workflow <name>]',
-        '  e2e-ai-agents gate --path <app-root> --threshold <n> [--since <ref>]',
-        '  e2e-ai-agents cost-report [--path <app-root>]',
-        '  e2e-ai-agents bootstrap --path <app-root> [options]',
-        '  e2e-ai-agents llm-health',
+        '  e2e-ai-agents <command> [options]',
+        '',
+        'Core CI workflow:',
+        '  impact --path <app-root> [options]',
+        '  plan --path <app-root> [options]',
+        '  suggest --path <app-root> [options]',
+        '  gate --path <app-root> --threshold <n> [--since <ref>]',
+        '',
+        'Optional AI workflow:',
+        '  analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
+        '  generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
+        '  heal --path <app-root> --traceability-report <json> [options]',
+        '  finalize-generated-tests --path <app-root> [options]',
+        '',
+        'Setup and calibration:',
+        '  init [--yes]',
+        '  train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
+        '  bootstrap --path <app-root> [options]',
+        '  feedback --path <app-root> --feedback-input <json>',
+        '  traceability-capture --path <app-root> --traceability-report <json>',
+        '  traceability-ingest --path <app-root> --traceability-input <json>',
+        '  cost-report [--path <app-root>]',
+        '  llm-health',
+        '',
+        'Advanced / experimental:',
+        '  crew --path <app-root> [--crew-workflow <name>] [--plugins <paths>]',
         '',
         'Options:',
         '  --config <path>       Path to e2e-ai-agents.config.json (auto-discovered if present)',
@@ -27,10 +36,11 @@ export function printUsage() {
         '  --profile <name>     default | mattermost',
         '  --mattermost         Shortcut for --profile mattermost',
         '  --tests-root <path>   Path to tests root (optional)',
-        '  --framework <name>    auto | playwright | cypress | selenium',
+        '  --framework <name>    auto | playwright | cypress | pytest | supertest | selenium',
         '  --patterns <globs>    Comma-separated test patterns',
         '  --flow-patterns <g>   Comma-separated flow discovery patterns',
         '  --flow-exclude <g>    Comma-separated flow exclude patterns',
+        '  --plugins <paths>     Comma-separated plugin module paths for crew workflows',
         '  --flow-catalog <path> Path to flow catalog JSON',
         '  --allow-fallback      Allow impact analysis without diff',
         '  --pipeline            Run Playwright AI pipeline for missing P0/P1 flows',

package/dist/esm/cli.js

@@ -57,10 +57,14 @@ async function main() {
         await runTrainCommand(args, autoConfig);
         return;
     }
-    if (args.help || !args.command) {
+    if (args.help) {
         printUsage();
         process.exit(0);
     }
+    if (!args.command) {
+        printUsage();
+        process.exit(1);
+    }
     if (args.command === 'llm-health') {
         await runLlmHealth();
         return;

package/dist/esm/prompts/coverage.js

@@ -15,7 +15,7 @@ export function buildCoveragePrompt(ctx) {
     })
         .join('\n\n');
     return [
-        `You are evaluating whether existing ${ctx.profile?.projectName || 'Mattermost'} ${ctx.profile?.testFramework || 'Playwright'} E2E tests cover the impacted flows.`,
+        `You are evaluating whether existing ${ctx.profile?.projectName || 'the project'} ${ctx.profile?.testFramework || 'Playwright'} E2E tests cover the impacted flows.`,
         '',
         `IMPACTED FLOWS (${ctx.flows.length}):`,
         flowsBlock,
@@ -38,7 +38,7 @@ export function buildCoveragePrompt(ctx) {
         '  Wrong: "test the new isEditing state"',
         '  Right: "test editing a scheduled message while it is in pending state"',
         '- For add_scenarios, specify which existing spec file to extend in targetSpec.',
-        `- For create_spec, suggest a path following ${ctx.profile?.projectName || 'Mattermost'} conventions.`,
+        `- For create_spec, suggest a path following ${ctx.profile?.projectName || 'the project'} conventions.`,
         '- Prefer adding scenarios to existing specs over creating new spec files.',
         '',
         'SEMANTIC MATCHING RULES (critical for accuracy):',

package/dist/esm/prompts/cross-impact.js

@@ -15,7 +15,7 @@ export function buildCrossImpactPrompt(ctx) {
         .join('\n');
     const changedBlock = ctx.changedFiles.map((f) => sanitizeForPrompt(f)).join('\n');
     return [
-        `You are analyzing code changes in ${ctx.projectName || 'Mattermost'} to identify cross-family ripple effects.`,
+        `You are analyzing code changes in ${ctx.projectName || 'the project'} to identify cross-family ripple effects.`,
         'When a change in one route family could affect another family through shared dependencies,',
         'that is a cross-impact.',
         '',

package/dist/esm/prompts/generation.js

@@ -36,7 +36,7 @@ function buildAssertionPatternsBlock(patterns) {
 }
 export function buildGenerationPrompt(ctx) {
     const profile = ctx.profile;
-    const isMM = profile ? isMattermostProfile(profile) : true;
+    const isMM = profile ? isMattermostProfile(profile) : false;
     const relevantClasses = resolveRelevantPageObjects(ctx.apiSurface, ctx.decision);
     const apiBlock = relevantClasses.length > 0
         ? formatApiSurfaceForPrompt(ctx.apiSurface, relevantClasses)
@@ -52,9 +52,9 @@ export function buildGenerationPrompt(ctx) {
         : `ADD scenarios to the EXISTING spec at: ${ctx.specPath}`;
     const routeFamilyTag = ctx.decision.routeFamily;
     // Build prompt based on profile
-    const projectName = profile?.projectName || 'Mattermost';
+    const projectName = profile?.projectName || 'Project';
     const testFramework = profile?.testFramework || 'Playwright';
-    const importStatement = profile?.importStatement || '@mattermost/playwright-lib';
+    const importStatement = profile?.importStatement || '@playwright/test';
     // API test mode prompt
     if (profile?.testMode === 'api') {
         return buildApiTestPrompt(ctx, profile, scenariosBlock, routeFamilyTag);
@@ -226,7 +226,7 @@ export function parseGenerationResponse(text, expectedPath, mode, flowId, profil
     if (!code.includes('test(') && !code.includes('it(') && !code.includes('describe(')) {
         return null;
     }
-    const importStatement = profile?.importStatement || '@mattermost/playwright-lib';
+    const importStatement = profile?.importStatement || '@playwright/test';
     // Auto-add import if missing
     if (!code.includes(importStatement)) {
         if (profile?.testMode === 'api') {

package/dist/esm/prompts/heal.js

@@ -28,9 +28,9 @@ export function buildHealPrompt(ctx) {
     const consoleBlock = ctx.consoleErrors && ctx.consoleErrors.length > 0
         ? `\nRecent console errors from test run:\n${ctx.consoleErrors.slice(-3).map((e) => `  - ${sanitizeForPrompt(e)}`).join('\n')}`
         : '';
-    const importLib = ctx.profile?.importStatement || '@mattermost/playwright-lib';
-    const isMM = ctx.profile ? isMattermostProfile(ctx.profile) : true;
-    const projectLabel = ctx.profile?.projectName || 'Mattermost';
+    const importLib = ctx.profile?.importStatement || '@playwright/test';
+    const isMM = ctx.profile ? isMattermostProfile(ctx.profile) : false;
+    const projectLabel = ctx.profile?.projectName || 'Project';
     const frameworkLabel = ctx.profile?.testFramework || 'Playwright';
     const constraints = isMM
         ? [
@@ -71,7 +71,7 @@ export function buildHealPrompt(ctx) {
  * (e.g. contain test.describe, test.only, wrong imports).
  */
 export function buildQualityFixPrompt(specPath, qualityIssues, profile) {
-    const importLib = profile?.importStatement || '@mattermost/playwright-lib';
+    const importLib = profile?.importStatement || '@playwright/test';
     const frameworkLabel = profile?.testFramework || 'Playwright';
     return [
         `Fix quality issues in this ${frameworkLabel} spec file. Make minimal edits only.`,

package/dist/esm/prompts/impact.js

@@ -24,7 +24,7 @@ export function buildImpactPrompt(ctx) {
     })
         .join('\n\n');
     return [
-        `You are analyzing code changes in ${ctx.projectName || 'Mattermost'} to identify impacted user-facing flows.`,
+        `You are analyzing code changes in ${ctx.projectName || 'the project'} to identify impacted user-facing flows.`,
         '',
         `ROUTE FAMILY: ${ctx.family.id}`,
         `ROUTES: ${familyRoutes}`,

package/dist/esm/prompts/test-designer.js

@@ -25,7 +25,7 @@ export function buildTestDesignerPrompt(ctx) {
         : 'None detected.';
     const categories = ctx.strategy.testCategories.join(', ');
     return [
-        `You are a senior QA engineer designing comprehensive test cases for a ${ctx.profile?.projectName || 'Mattermost'} user flow.`,
+        `You are a senior QA engineer designing comprehensive test cases for a ${ctx.profile?.projectName || 'project'} user flow.`,
         '',
         `FLOW: ${ctx.flow.flowName}`,
         `Flow ID: ${ctx.flow.flowId}`,