@yasserkhanorg/impact-gate 2.0.0

package/dist/prompts/generation_profile.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Dynamic generation profile — replaces hardcoded Mattermost references with
+ * project-specific configuration. Enables impact-gate to generate tests for any project.
+ */
+import type { KnowledgeGraph } from '../knowledge/kg_types.js';
+import type { TestType } from '../knowledge/route_families.js';
+export interface GenerationProfile {
+    projectName: string;
+    testFramework: string;
+    importStatement: string;
+    conventions: string[];
+    copyrightHeader?: string;
+    testMode: TestType;
+}
+/**
+ * Resolves the generation profile from config and optional KG metadata.
+ * - If profile='mattermost' or Mattermost is detected, returns Mattermost profile.
+ * - If KG is present, derives project-specific profile from it.
+ * - Otherwise, returns generic Playwright profile.
+ */
+export declare function resolveGenerationProfile(config?: {
+    profile?: string;
+    testMode?: TestType;
+}, kg?: KnowledgeGraph | null): GenerationProfile;
+/**
+ * Checks if a profile is the Mattermost profile (for backward compatibility checks).
+ */
+export declare function isMattermostProfile(profile: GenerationProfile): boolean;
+//# sourceMappingURL=generation_profile.d.ts.map

package/dist/prompts/generation_profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation_profile.d.ts","sourceRoot":"","sources":["../../src/prompts/generation_profile.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,gCAAgC,CAAC;AAG7D,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACtB;AA8CD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,CAAC,EAAE;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,EAChD,EAAE,CAAC,EAAE,cAAc,GAAG,IAAI,GAC3B,iBAAiB,CAmCnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAEvE"}

package/dist/prompts/generation_profile.js

@@ -0,0 +1,151 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGenerationProfile = resolveGenerationProfile;
+exports.isMattermostProfile = isMattermostProfile;
+const framework_adapter_js_1 = require("../adapters/framework_adapter.js");
+const MATTERMOST_PROFILE = {
+    projectName: 'Mattermost',
+    testFramework: 'Playwright',
+    importStatement: '@mattermost/playwright-lib',
+    conventions: [
+        'Import ONLY from "@mattermost/playwright-lib" — no other test framework imports.',
+        'Every test must call `await pw.initSetup()` first.',
+        'Use `await pw.testBrowser.login(user)` to log in — never hardcode credentials.',
+        'Use `expect` from "@mattermost/playwright-lib" — do NOT import from "@playwright/test".',
+        'Include the copyright header for new files.',
+    ],
+    copyrightHeader: [
+        '// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.',
+        '// See LICENSE.txt for license information.',
+    ].join('\n'),
+    testMode: 'ui',
+};
+const DEFAULT_PLAYWRIGHT_PROFILE = {
+    projectName: 'Project',
+    testFramework: 'Playwright',
+    importStatement: '@playwright/test',
+    conventions: [
+        'Import from "@playwright/test" for test and expect.',
+        'Use page fixtures provided by Playwright.',
+        'Prefer ARIA roles and data-testid attributes for selectors.',
+        'Write one test per scenario with a descriptive name.',
+    ],
+    testMode: 'ui',
+};
+const DEFAULT_API_PROFILE = {
+    projectName: 'Project',
+    testFramework: 'vitest + supertest',
+    importStatement: 'vitest',
+    conventions: [
+        'Import from "vitest" for test and expect.',
+        'Use supertest for HTTP request assertions.',
+        'Validate response status codes, headers, and body structure.',
+        'Test both success and error paths for each endpoint.',
+    ],
+    testMode: 'api',
+};
+/**
+ * Resolves the generation profile from config and optional KG metadata.
+ * - If profile='mattermost' or Mattermost is detected, returns Mattermost profile.
+ * - If KG is present, derives project-specific profile from it.
+ * - Otherwise, returns generic Playwright profile.
+ */
+function resolveGenerationProfile(config, kg) {
+    // Explicit Mattermost profile
+    if (config?.profile === 'mattermost') {
+        return { ...MATTERMOST_PROFILE };
+    }
+    // KG-based profile derivation
+    if (kg) {
+        const frameworks = kg.project.frameworks.map((f) => f.toLowerCase());
+        const isMattermost = kg.project.name.toLowerCase().includes('mattermost') ||
+            frameworks.includes('@mattermost/playwright-lib');
+        if (isMattermost) {
+            return { ...MATTERMOST_PROFILE };
+        }
+        const testMode = config?.testMode || deriveTestMode(frameworks);
+        const testFramework = deriveTestFramework(frameworks, testMode);
+        const importStatement = deriveImportStatement(frameworks, testMode);
+        return {
+            projectName: kg.project.name || 'Project',
+            testFramework,
+            importStatement,
+            conventions: buildConventions(testFramework, importStatement, testMode),
+            testMode,
+        };
+    }
+    // Default profiles based on test mode
+    if (config?.testMode === 'api') {
+        return { ...DEFAULT_API_PROFILE };
+    }
+    return { ...DEFAULT_PLAYWRIGHT_PROFILE };
+}
+/**
+ * Checks if a profile is the Mattermost profile (for backward compatibility checks).
+ */
+function isMattermostProfile(profile) {
+    return profile.importStatement === '@mattermost/playwright-lib';
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function deriveTestMode(frameworks) {
+    const uiSet = new Set(framework_adapter_js_1.UI_FRAMEWORKS);
+    const apiSet = new Set(framework_adapter_js_1.API_FRAMEWORKS);
+    const hasUiFramework = frameworks.some((f) => uiSet.has(f));
+    const hasApiFramework = frameworks.some((f) => apiSet.has(f));
+    if (hasUiFramework && hasApiFramework)
+        return 'both';
+    if (hasApiFramework && !hasUiFramework)
+        return 'api';
+    return 'ui';
+}
+function deriveTestFramework(frameworks, testMode) {
+    if (testMode === 'api') {
+        if (frameworks.includes('pytest'))
+            return 'pytest';
+        if (frameworks.includes('jest'))
+            return 'jest + supertest';
+        return 'vitest + supertest';
+    }
+    if (frameworks.includes('cypress'))
+        return 'Cypress';
+    if (frameworks.includes('selenium'))
+        return 'Selenium';
+    return 'Playwright';
+}
+function deriveImportStatement(frameworks, testMode) {
+    if (testMode === 'api') {
+        if (frameworks.includes('pytest'))
+            return 'pytest';
+        if (frameworks.includes('jest'))
+            return 'jest';
+        return 'vitest';
+    }
+    if (frameworks.includes('cypress'))
+        return 'cypress';
+    return '@playwright/test';
+}
+function buildConventions(testFramework, importStatement, testMode) {
+    const conventions = [];
+    if (testMode === 'api' || testMode === 'both') {
+        conventions.push(`Import from "${importStatement}" for test and expect.`);
+        conventions.push('Validate response status codes, headers, and body structure.');
+        conventions.push('Test both success and error paths for each endpoint.');
+    }
+    if (testMode === 'ui' || testMode === 'both') {
+        if (testFramework.includes('Playwright')) {
+            conventions.push('Import from "@playwright/test" for test and expect.');
+            conventions.push('Use page fixtures provided by Playwright.');
+        }
+        else if (testFramework.includes('Cypress')) {
+            conventions.push('Use cy.* commands for browser interaction.');
+        }
+        conventions.push('Prefer ARIA roles and data-testid attributes for selectors.');
+    }
+    conventions.push('Write one test per scenario with a descriptive name of what the user does and what is verified.');
+    conventions.push('NEVER fabricate test IDs. Use descriptive names only.');
+    return conventions;
+}

package/dist/prompts/heal.d.ts

@@ -0,0 +1,23 @@
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { GenerationProfile } from './generation_profile.js';
+export interface HealPromptContext {
+    specPath: string;
+    status: 'failed' | 'flaky';
+    decision?: FlowDecision;
+    failureDetail?: string;
+    /** Last 3 console errors from the test run */
+    consoleErrors?: string[];
+    profile?: GenerationProfile;
+}
+/**
+ * Builds a route-family-aware heal prompt for the playwright-test-healer agent.
+ * Enriches the base healer constraints with flow context so the agent understands
+ * what the test is supposed to verify, reducing hallucination during selector repair.
+ */
+export declare function buildHealPrompt(ctx: HealPromptContext): string;
+/**
+ * Builds a minimal quality-fix prompt for spec files that fail content validation
+ * (e.g. contain test.describe, test.only, wrong imports).
+ */
+export declare function buildQualityFixPrompt(specPath: string, qualityIssues: string[], profile?: GenerationProfile): string;
+//# sourceMappingURL=heal.d.ts.map

package/dist/prompts/heal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heal.d.ts","sourceRoot":"","sources":["../../src/prompts/heal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AAEjE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAG/D,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAgE9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAmBpH"}

package/dist/prompts/heal.js

@@ -0,0 +1,95 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHealPrompt = buildHealPrompt;
+exports.buildQualityFixPrompt = buildQualityFixPrompt;
+const sanitize_js_1 = require("../crew/sanitize.js");
+const generation_profile_js_1 = require("./generation_profile.js");
+/**
+ * Builds a route-family-aware heal prompt for the playwright-test-healer agent.
+ * Enriches the base healer constraints with flow context so the agent understands
+ * what the test is supposed to verify, reducing hallucination during selector repair.
+ */
+function buildHealPrompt(ctx) {
+    const flowBlock = ctx.decision
+        ? [
+            '',
+            'FLOW CONTEXT (use to understand test intent — do not change test objectives):',
+            `  Flow: ${(0, sanitize_js_1.sanitizeForPrompt)(ctx.decision.flowName)}`,
+            `  Route Family: ${ctx.decision.routeFamily}${ctx.decision.featureId ? ` / ${ctx.decision.featureId}` : ''}`,
+            `  Route: ${ctx.decision.specificRoute || '(family-level)'}`,
+            `  User Actions: ${(0, sanitize_js_1.sanitizeForPrompt)(ctx.decision.userActions.join('; ')) || 'not specified'}`,
+            `  Evidence: ${(0, sanitize_js_1.sanitizeForPrompt)(ctx.decision.evidence)}`,
+        ].join('\n')
+        : '';
+    const statusNote = ctx.status === 'flaky'
+        ? 'This test is FLAKY (passes sometimes, fails other times). Look for race conditions, missing waits, or order-dependent state.'
+        : 'This test is FAILING consistently. The selector, URL, or API call is likely broken.';
+    const failureBlock = ctx.failureDetail
+        ? `\nFailure detail:\n${(0, sanitize_js_1.sanitizeForPrompt)(ctx.failureDetail)}`
+        : '';
+    const consoleBlock = ctx.consoleErrors && ctx.consoleErrors.length > 0
+        ? `\nRecent console errors from test run:\n${ctx.consoleErrors.slice(-3).map((e) => `  - ${(0, sanitize_js_1.sanitizeForPrompt)(e)}`).join('\n')}`
+        : '';
+    const importLib = ctx.profile?.importStatement || '@playwright/test';
+    const isMM = ctx.profile ? (0, generation_profile_js_1.isMattermostProfile)(ctx.profile) : false;
+    const projectLabel = ctx.profile?.projectName || 'Project';
+    const frameworkLabel = ctx.profile?.testFramework || 'Playwright';
+    const constraints = isMM
+        ? [
+            `- Import ONLY from "${importLib}". Do not use "@playwright/test" directly.`,
+            '- Do not use test.describe or test.only.',
+            '- Keep a single tag string matching the route family (e.g. "@channels", "@scheduled_posts").',
+            `- Use only existing ${projectLabel} ${frameworkLabel} fixture and page-object APIs.`,
+            '- Do NOT invent new pw.* clients or page object methods that do not exist.',
+            '- Avoid brittle class selectors (.backstage-navbar, .admin-console__wrapper, .left-panel, .panel-card).',
+        ]
+        : [
+            `- Import from "${importLib}".`,
+            '- Keep a single tag string matching the route family.',
+            `- Use only existing ${projectLabel} ${frameworkLabel} page-object APIs.`,
+            '- Do NOT invent page object methods that do not exist.',
+        ];
+    return [
+        `Heal this specific ${frameworkLabel} test file and keep edits minimal.`,
+        '',
+        `Target test file: ${ctx.specPath}`,
+        `Status: ${ctx.status.toUpperCase()} — ${statusNote}`,
+        failureBlock,
+        consoleBlock,
+        flowBlock,
+        '',
+        'Healing constraints (must follow):',
+        ...constraints,
+        '- Prefer stable assertions using URL patterns, data-testid attributes, ARIA roles, and page-object methods.',
+        '- For flaky tests: add explicit waits (waitFor, expect().toBeVisible()) before interactions.',
+        '- Keep the test intent and scenario unchanged — only fix what is broken.',
+        '- If behavior is genuinely broken server-side, mark test.fixme with a clear comment explaining why.',
+        '',
+        'Run and fix this test until it compiles and passes, or mark test.fixme when the behavior is truly broken.',
+    ].filter((line) => line !== null).join('\n');
+}
+/**
+ * Builds a minimal quality-fix prompt for spec files that fail content validation
+ * (e.g. contain test.describe, test.only, wrong imports).
+ */
+function buildQualityFixPrompt(specPath, qualityIssues, profile) {
+    const importLib = profile?.importStatement || '@playwright/test';
+    const frameworkLabel = profile?.testFramework || 'Playwright';
+    return [
+        `Fix quality issues in this ${frameworkLabel} spec file. Make minimal edits only.`,
+        '',
+        `Target file: ${specPath}`,
+        '',
+        'Issues to fix:',
+        ...qualityIssues.map((issue) => `  - ${issue}`),
+        '',
+        'Rules:',
+        `- Import only from "${importLib}".`,
+        '- Remove test.describe wrappers (flatten to top-level test() calls).',
+        '- Remove test.only calls.',
+        '- Ensure each test has exactly one tag string.',
+        '- Do not change test logic — only fix structural quality issues.',
+    ].join('\n');
+}

package/dist/prompts/impact.d.ts

@@ -0,0 +1,31 @@
+import type { RouteFamily } from '../knowledge/route_families.js';
+import type { SpecEntry } from '../knowledge/spec_index.js';
+import { type ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+export interface ImpactPromptContext {
+    family: RouteFamily;
+    featureId?: string;
+    changedFiles: Array<{
+        path: string;
+        snippet?: string;
+    }>;
+    existingSpecs: SpecEntry[];
+    apiSurface: ApiSurfaceCatalog;
+    contextBlock: string;
+    projectName?: string;
+}
+export declare function buildImpactPrompt(ctx: ImpactPromptContext): string;
+export interface ImpactAgentResponse {
+    flows: Array<{
+        id: string;
+        name: string;
+        route?: string;
+        userActions?: string[];
+        priority?: string;
+        confidence?: number;
+        evidence?: string;
+        pageObjects?: string[];
+        changedFiles?: string[];
+    }>;
+}
+export declare function parseImpactResponse(text: string): ImpactAgentResponse | null;
+//# sourceMappingURL=impact.d.ts.map

package/dist/prompts/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/prompts/impact.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAG1D,OAAO,EAA4B,KAAK,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAE9F,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACtD,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CA0DlE;AAED,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,KAAK,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC,CAAC;CACN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAM5E"}

package/dist/prompts/impact.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildImpactPrompt = buildImpactPrompt;
+exports.parseImpactResponse = parseImpactResponse;
+const json_extract_js_1 = require("./json_extract.js");
+const spec_index_js_1 = require("../knowledge/spec_index.js");
+const api_surface_js_1 = require("../knowledge/api_surface.js");
+function buildImpactPrompt(ctx) {
+    const familyRoutes = ctx.family.routes.join(', ');
+    const featureNote = ctx.featureId ? `\nFEATURE: ${ctx.featureId}` : '';
+    const pageObjectNames = ctx.family.pageObjects || [];
+    const componentNames = ctx.family.components || [];
+    const allClassNames = [...pageObjectNames, ...componentNames];
+    const apiSurfaceBlock = allClassNames.length > 0
+        ? (0, api_surface_js_1.formatApiSurfaceForPrompt)(ctx.apiSurface, allClassNames)
+        : 'No page objects or components mapped for this family.';
+    const specsBlock = ctx.existingSpecs.length > 0
+        ? (0, spec_index_js_1.formatSpecsForPrompt)(ctx.existingSpecs)
+        : 'No existing specs found for this route family.';
+    const changedFilesBlock = ctx.changedFiles
+        .map((f) => {
+        if (f.snippet) {
+            return `${f.path}:\n\`\`\`\n${f.snippet}\n\`\`\``;
+        }
+        return f.path;
+    })
+        .join('\n\n');
+    return [
+        `You are analyzing code changes in ${ctx.projectName || 'the project'} to identify impacted user-facing flows.`,
+        '',
+        `ROUTE FAMILY: ${ctx.family.id}`,
+        `ROUTES: ${familyRoutes}`,
+        featureNote,
+        '',
+        `PAGE OBJECTS AND COMPONENTS:`,
+        apiSurfaceBlock,
+        '',
+        `EXISTING SPECS FOR THIS FAMILY (${ctx.existingSpecs.length}):`,
+        specsBlock,
+        '',
+        `CHANGED FILES (${ctx.changedFiles.length}):`,
+        changedFilesBlock,
+        '',
+        ctx.contextBlock,
+        '',
+        'For each changed file, identify impacted user-facing flows.',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"flows":[{"id":"<flow_id>","name":"<human readable name>","route":"<specific route from ROUTES>","userActions":["<what the user does>"],"priority":"P0|P1|P2","confidence":0-100,"evidence":"<why this flow is impacted>","pageObjects":["<page object used>"],"changedFiles":["<files>"]}]}',
+        '',
+        'Rules:',
+        '- ONLY use routes listed in ROUTES above.',
+        '- ONLY reference page objects and components listed above.',
+        '- Each flow must describe a specific user action, not a generic category.',
+        '- If you cannot determine the impacted flow with high confidence, return:',
+        '  {"id":"unknown","name":"cannot determine","confidence":0,"evidence":"<reason>","userActions":[],"changedFiles":["<files>"]}',
+        '- Do NOT default to /admin_console/reporting/system_analytics unless the changed files are literally analytics code.',
+        '- Do NOT invent routes, page objects, or methods that are not listed above.',
+        '- Keep at most 8 flows.',
+        '- Prioritize true user-impacting flows; avoid low-value internal buckets.',
+    ].filter(Boolean).join('\n');
+}
+function parseImpactResponse(text) {
+    return (0, json_extract_js_1.extractJsonFromResponse)(text, (obj) => obj != null && typeof obj === 'object' && Array.isArray(obj.flows));
+}

package/dist/prompts/json_extract.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared JSON extraction from LLM text responses.
+ * Handles fenced code blocks, bare JSON, and partial text.
+ */
+/**
+ * Extract and parse JSON from LLM response text.
+ * Tries fenced code blocks first, then raw text.
+ * Returns null if no valid JSON found.
+ *
+ * @param text - Raw LLM response text
+ * @param validate - Predicate to check if parsed object has the expected shape
+ */
+export declare function extractJsonFromResponse<T>(text: string, validate: (obj: unknown) => obj is T): T | null;
+//# sourceMappingURL=json_extract.d.ts.map

package/dist/prompts/json_extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_extract.d.ts","sourceRoot":"","sources":["../../src/prompts/json_extract.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAqBvG"}

package/dist/prompts/json_extract.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractJsonFromResponse = extractJsonFromResponse;
+/**
+ * Shared JSON extraction from LLM text responses.
+ * Handles fenced code blocks, bare JSON, and partial text.
+ */
+/**
+ * Extract and parse JSON from LLM response text.
+ * Tries fenced code blocks first, then raw text.
+ * Returns null if no valid JSON found.
+ *
+ * @param text - Raw LLM response text
+ * @param validate - Predicate to check if parsed object has the expected shape
+ */
+function extractJsonFromResponse(text, validate) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = fenced ? [fenced[1], text] : [text];
+    for (const candidate of candidates) {
+        const start = candidate.indexOf('{');
+        const end = candidate.lastIndexOf('}');
+        if (start < 0 || end <= start) {
+            continue;
+        }
+        const raw = candidate.slice(start, end + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (validate(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

package/dist/prompts/strategist.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Strategist prompt — designs overall test strategy from impact analysis,
+ * cross-impact data, and regression risk.
+ */
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { CrossImpact, RegressionRisk } from '../crew/types.js';
+export interface StrategistPromptContext {
+    impactedFlows: FlowDecision[];
+    crossImpacts: CrossImpact[];
+    regressionRisks: RegressionRisk[];
+}
+export declare function buildStrategistPrompt(ctx: StrategistPromptContext): string;
+export interface StrategistAgentResponse {
+    strategy: Array<{
+        flowId: string;
+        flowName: string;
+        priority: 'P0' | 'P1' | 'P2' | string;
+        approach: 'full-test' | 'smoke-test' | 'skip' | 'manual-review' | string;
+        rationale: string;
+        testCategories: string[];
+        crossImpactRisk: 'high' | 'medium' | 'low' | 'none' | string;
+    }>;
+}
+export declare function parseStrategistResponse(text: string): StrategistAgentResponse | null;
+//# sourceMappingURL=strategist.d.ts.map

package/dist/prompts/strategist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategist.d.ts","sourceRoot":"","sources":["../../src/prompts/strategist.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAC,WAAW,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAIjF,MAAM,WAAW,uBAAuB;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,cAAc,EAAE,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CA4D1E;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;QACtC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;QACzE,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;KAChE,CAAC,CAAC;CACN;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAMpF"}

package/dist/prompts/strategist.js

@@ -0,0 +1,65 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStrategistPrompt = buildStrategistPrompt;
+exports.parseStrategistResponse = parseStrategistResponse;
+const sanitize_js_1 = require("../crew/sanitize.js");
+const json_extract_js_1 = require("./json_extract.js");
+function buildStrategistPrompt(ctx) {
+    const flowsBlock = ctx.impactedFlows
+        .map((f) => {
+        const specs = f.existingSpecs.map((s) => `${s.path} (${s.coverageLevel})`).join(', ') || 'none';
+        return [
+            `- ${f.flowId} (${f.priority}): ${f.flowName}`,
+            `  Route Family: ${f.routeFamily}`,
+            `  Action: ${f.action}`,
+            `  Confidence: ${f.confidence}%`,
+            `  Existing Coverage: ${specs}`,
+            `  User Actions: ${(0, sanitize_js_1.sanitizeForPrompt)(f.userActions.join('; ') || 'unknown')}`,
+            `  Changed Files: ${f.changedFiles.join(', ')}`,
+        ].join('\n');
+    })
+        .join('\n\n');
+    const crossImpactBlock = ctx.crossImpacts.length > 0
+        ? ctx.crossImpacts.map((ci) => `- ${ci.sourceFamily} → ${ci.affectedFamily} (${ci.riskLevel}): ${ci.sharedDependency} — ${ci.evidence}`).join('\n')
+        : 'No cross-family impacts detected.';
+    const regressionBlock = ctx.regressionRisks.length > 0
+        ? ctx.regressionRisks.map((r) => `- ${r.familyId} (risk=${r.riskScore}): ${r.reason}`).join('\n')
+        : 'No regression risk data available.';
+    return [
+        'You are a senior QA strategist designing the overall test strategy for a code change.',
+        '',
+        `IMPACTED FLOWS (${ctx.impactedFlows.length}):`,
+        flowsBlock,
+        '',
+        'CROSS-FAMILY IMPACTS:',
+        crossImpactBlock,
+        '',
+        'REGRESSION RISK:',
+        regressionBlock,
+        '',
+        'TASK: Design a prioritized test strategy for each impacted flow.',
+        '',
+        'For each flow, decide:',
+        '1. Approach: full-test (comprehensive), smoke-test (critical path only), skip, or manual-review',
+        '2. Priority: P0 (critical path), P1 (important), P2 (nice to have)',
+        '3. Test categories to cover (from: happy-path, edge-case, boundary, negative, state-transition, race-condition, permission, accessibility, performance)',
+        '4. Cross-impact risk level based on shared dependencies',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"strategy":[{"flowId":"<id>","flowName":"<name>","priority":"P0|P1|P2","approach":"full-test|smoke-test|skip|manual-review","rationale":"<why this approach>","testCategories":["happy-path","edge-case",...],"crossImpactRisk":"high|medium|low|none"}]}',
+        '',
+        'Rules:',
+        '- P0 flows with create_spec or add_scenarios action should always get full-test.',
+        '- Flows with high cross-impact risk should be promoted to at least P1.',
+        '- Flows with high regression risk should include edge-case and boundary categories.',
+        '- Skip flows only if confidence < 30 AND no cross-impact risk.',
+        '- Include accessibility category for any flow involving interactive UI elements.',
+        '- Include permission category for any flow involving role-based features.',
+        '- Keep rationale concise (1-2 sentences) explaining why this approach was chosen.',
+    ].join('\n');
+}
+function parseStrategistResponse(text) {
+    return (0, json_extract_js_1.extractJsonFromResponse)(text, (obj) => obj != null && typeof obj === 'object' && Array.isArray(obj.strategy));
+}

package/dist/prompts/test-designer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Test Designer prompt — designs structured test cases across 9 categories.
+ * Replaces flat scenariosToAdd with rich TestCase[] that feed the Generator.
+ */
+import type { FlowDecision } from '../validation/output_schema.js';
+import { type ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+import type { SpecEntry } from '../knowledge/spec_index.js';
+import type { StrategyEntry, CrossImpact } from '../crew/types.js';
+import type { GenerationProfile } from './generation_profile.js';
+export interface TestDesignerPromptContext {
+    flow: FlowDecision;
+    strategy: StrategyEntry;
+    apiSurface: ApiSurfaceCatalog;
+    existingSpecs: SpecEntry[];
+    crossImpacts: CrossImpact[];
+    profile?: GenerationProfile;
+}
+export declare function buildTestDesignerPrompt(ctx: TestDesignerPromptContext): string;
+export interface TestDesignerAgentResponse {
+    testDesign: {
+        flowId: string;
+        flowName: string;
+        testCases: Array<{
+            name: string;
+            type: 'happy-path' | 'edge-case' | 'boundary' | 'negative' | 'state-transition' | 'race-condition' | 'permission' | 'accessibility' | 'performance' | string;
+            preconditions: string[];
+            steps: string[];
+            expectedOutcome: string;
+            priority: 'P0' | 'P1' | 'P2' | string;
+            rationale: string;
+        }>;
+    };
+}
+export declare function parseTestDesignerResponse(text: string): TestDesignerAgentResponse | null;
+//# sourceMappingURL=test-designer.d.ts.map

package/dist/prompts/test-designer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-designer.d.ts","sourceRoot":"","sources":["../../src/prompts/test-designer.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAA4B,KAAK,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAC9F,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAa,MAAM,kBAAkB,CAAC;AAE7E,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,CAuF9E;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC;YAC7J,aAAa,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,eAAe,EAAE,MAAM,CAAC;YACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;YACtC,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACN,CAAC;CACL;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAQxF"}