@yasserkhanorg/impact-gate 2.0.0

package/dist/crew/protocol.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Agent Crew Protocol — core interfaces for inter-agent communication and execution.
+ */
+import type { ProviderUsageStats } from '../provider_interface.js';
+import type { AgentRole } from './types.js';
+import type { CrewContext } from './context.js';
+export interface AgentMessage {
+    id: string;
+    from: AgentRole;
+    to: AgentRole | 'broadcast';
+    type: 'task' | 'result' | 'escalation' | 'finding';
+    payload: unknown;
+    correlationId: string;
+    timestamp: number;
+}
+export interface AgentTask {
+    role: AgentRole;
+    action: string;
+    input: unknown;
+}
+export interface AgentResult {
+    role: AgentRole;
+    status: 'success' | 'partial' | 'failed';
+    output: unknown;
+    usage?: ProviderUsageStats;
+    warnings: string[];
+}
+export interface Agent {
+    role: AgentRole;
+    execute(task: AgentTask, ctx: CrewContext): Promise<AgentResult>;
+    onMessage?(msg: AgentMessage): Promise<void>;
+}
+/**
+ * AgentPlugin — interface for external agent plugins loaded from config.
+ *
+ * Plugins register into crew workflow phases alongside built-in agents.
+ * The CrewContext interface is a public API contract once plugins exist:
+ * field additions are non-breaking, field removals or type changes are breaking.
+ */
+export interface AgentPlugin extends Agent {
+    /** Which workflow phase to run in (e.g., 'strategize', 'understand') */
+    phase: string;
+    /** Run after these agents complete (dependency ordering) */
+    runAfter?: AgentRole[];
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/crew/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/crew/protocol.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,GAAG,WAAW,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjE,SAAS,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACtC,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B"}

package/dist/crew/protocol.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/crew/provider.d.ts

@@ -0,0 +1,17 @@
+import type { LLMProvider } from '../provider_interface.js';
+import type { BudgetLedger } from '../budget_ledger.js';
+import type { AgentRole } from './types.js';
+export interface CrewProviderOptions {
+    providerOverride?: string;
+    budgetUSD?: number;
+    agentRole?: AgentRole;
+    modelRoutingProviderType?: string;
+    modelRoutingOverrides?: Record<string, string>;
+}
+export declare function getCrewProvider(providerOverride?: string, budgetUSD?: number, opts?: {
+    agentRole?: AgentRole;
+    modelRoutingProviderType?: string;
+    modelRoutingOverrides?: Record<string, string>;
+    budgetLedger?: BudgetLedger;
+}): Promise<LLMProvider>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/crew/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/crew/provider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAG1D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,wBAAsB,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IACxF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B,GAAG,OAAO,CAAC,WAAW,CAAC,CA0BvB"}

package/dist/crew/provider.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCrewProvider = getCrewProvider;
+/**
+ * Shared provider creation for crew agents — ensures consistent provider
+ * instantiation and prevents usage stats fragmentation.
+ */
+const provider_factory_js_1 = require("../provider_factory.js");
+const base_provider_js_1 = require("../base_provider.js");
+const model_router_js_1 = require("../model_router.js");
+async function getCrewProvider(providerOverride, budgetUSD, opts) {
+    let effectiveOverride = providerOverride;
+    // Apply model routing if configured and agent role is provided
+    if (opts?.agentRole && opts?.modelRoutingProviderType) {
+        const router = new model_router_js_1.ModelRouter(opts.modelRoutingProviderType, opts.modelRoutingOverrides);
+        const model = router.getModel(opts.agentRole);
+        if (model) {
+            // Override uses provider:model format (e.g., "anthropic:claude-haiku-4-5-20251001")
+            effectiveOverride = `${opts.modelRoutingProviderType}:${model}`;
+        }
+    }
+    const provider = effectiveOverride
+        ? await provider_factory_js_1.LLMProviderFactory.createFromString(effectiveOverride)
+        : await provider_factory_js_1.LLMProviderFactory.createFromEnv();
+    if (provider instanceof base_provider_js_1.BaseProvider) {
+        if (opts?.budgetLedger) {
+            provider.setBudgetLedger(opts.budgetLedger);
+        }
+        else if (budgetUSD !== undefined) {
+            provider.setBudget(budgetUSD);
+        }
+    }
+    return provider;
+}

package/dist/crew/sanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeForPrompt(value: string): string;
+export declare function sanitizeArray(values: string[]): string[];
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/crew/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/crew/sanitize.ts"],"names":[],"mappings":"AAqBA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAExD"}

package/dist/crew/sanitize.js

@@ -0,0 +1,31 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeForPrompt = sanitizeForPrompt;
+exports.sanitizeArray = sanitizeArray;
+/**
+ * Sanitize strings before interpolating into LLM prompts.
+ * Strips common prompt injection patterns while preserving useful content.
+ */
+const INJECTION_PATTERNS = [
+    /ignore\s+(all\s+)?previous\s+instructions/gi,
+    /disregard\s+(all\s+)?(above|prior|previous)/gi,
+    /system\s*:\s*/gi,
+    /\[INST\]/gi,
+    /<<SYS>>/gi,
+    /<\|im_start\|>/gi,
+    /\bHuman\s*:\s*/gi,
+    /\bAssistant\s*:\s*/gi,
+];
+const MAX_FIELD_LENGTH = 2000;
+function sanitizeForPrompt(value) {
+    let sanitized = value.slice(0, MAX_FIELD_LENGTH);
+    for (const pattern of INJECTION_PATTERNS) {
+        sanitized = sanitized.replace(pattern, '[filtered]');
+    }
+    return sanitized;
+}
+function sanitizeArray(values) {
+    return values.map((v) => sanitizeForPrompt(v));
+}

package/dist/crew/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Crew data types — structured test design, cross-impact analysis, and findings.
+ */
+export type TestCaseType = 'happy-path' | 'edge-case' | 'boundary' | 'negative' | 'state-transition' | 'race-condition' | 'permission' | 'accessibility' | 'performance';
+export interface TestCase {
+    name: string;
+    type: TestCaseType;
+    preconditions: string[];
+    steps: string[];
+    expectedOutcome: string;
+    priority: 'P0' | 'P1' | 'P2';
+    rationale: string;
+}
+export interface TestDesign {
+    flowId: string;
+    flowName: string;
+    testCases: TestCase[];
+}
+export interface CrossImpact {
+    sourceFamily: string;
+    affectedFamily: string;
+    sharedDependency: string;
+    riskLevel: 'high' | 'medium' | 'low';
+    evidence: string;
+}
+export interface Finding {
+    id: string;
+    type: 'bug' | 'gap' | 'risk' | 'flaky';
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    source: AgentRole;
+    summary: string;
+    details: string;
+    relatedFlows: string[];
+}
+export interface RegressionRisk {
+    familyId: string;
+    filePattern: string;
+    riskScore: number;
+    reason: string;
+    historicalFailures: number;
+}
+export interface StrategyEntry {
+    flowId: string;
+    flowName: string;
+    priority: 'P0' | 'P1' | 'P2';
+    approach: 'full-test' | 'smoke-test' | 'skip' | 'manual-review';
+    rationale: string;
+    testCategories: TestCaseType[];
+    crossImpactRisk: 'high' | 'medium' | 'low' | 'none';
+}
+export type AgentRole = 'strategist' | 'test-designer' | 'cross-impact' | 'regression-advisor' | 'impact-analyst' | 'coverage-evaluator' | 'generator' | 'executor' | 'healer' | 'explorer';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/crew/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAClB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,kBAAkB,GAClB,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,aAAa,CAAC;AAEpB,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,eAAe,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACvD;AAED,MAAM,MAAM,SAAS,GACf,YAAY,GACZ,eAAe,GACf,cAAc,GACd,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,QAAQ,GACR,UAAU,CAAC"}

package/dist/crew/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/crew/workflows.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Predefined workflow definitions — playbooks that compose agents into phases.
+ *
+ * Data flow through full-qa workflow:
+ *
+ *   preprocess (built-in)
+ *     → populates: familyGroups, routeFamilies, manifest, apiSurface, specIndex, context
+ *
+ *   understand (parallel):
+ *     impact-analyst      → writes: impactedFlows
+ *     cross-impact        → writes: crossImpacts
+ *     regression-advisor  → writes: regressionRisks
+ *
+ *   strategize (sequential):
+ *     strategist           → reads: impactedFlows, crossImpacts, regressionRisks
+ *                          → writes: strategyEntries
+ *     test-designer        → reads: strategyEntries, impactedFlows, crossImpacts, apiSurface, specIndex
+ *                          → writes: testDesigns
+ *
+ *   execute (parallel):
+ *     generator            → reads: impactedFlows, testDesigns, apiSurface
+ *                          → writes: generatedSpecs
+ *
+ *   validate (sequential):
+ *     executor             → reads: generatedSpecs, impactedFlows
+ *     healer               → reads: generatedSpecs, impactedFlows
+ */
+import type { AgentRole } from './types.js';
+export type WorkflowPhase = {
+    name: string;
+    handler: 'built-in';
+    parallel?: never;
+    sequential?: never;
+} | {
+    name: string;
+    handler?: never;
+    parallel: AgentRole[];
+    sequential?: never;
+} | {
+    name: string;
+    handler?: never;
+    parallel?: never;
+    sequential: AgentRole[];
+};
+export interface WorkflowDef {
+    name: string;
+    description: string;
+    phases: WorkflowPhase[];
+}
+export type WorkflowName = 'full-qa' | 'quick-check' | 'design-only';
+export declare const WORKFLOWS: Record<WorkflowName, WorkflowDef>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/crew/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/crew/workflows.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,aAAa,GACnB;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAC,GACzE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAC,GAC1E;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAC,CAAC;AAEjF,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAErE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CA8BvD,CAAC"}

package/dist/crew/workflows.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOWS = void 0;
+exports.WORKFLOWS = {
+    'full-qa': {
+        name: 'full-qa',
+        description: 'Full multi-agent QA analysis: understand → strategize → execute → validate',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst', 'cross-impact', 'regression-advisor'] },
+            { name: 'strategize', sequential: ['strategist', 'test-designer'] },
+            { name: 'execute', parallel: ['generator'] },
+            { name: 'validate', sequential: ['executor', 'healer'] },
+        ],
+    },
+    'quick-check': {
+        name: 'quick-check',
+        description: 'Quick impact analysis with strategy recommendations',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst'] },
+            { name: 'strategize', sequential: ['strategist'] },
+        ],
+    },
+    'design-only': {
+        name: 'design-only',
+        description: 'Impact analysis through test design — no generation or execution',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst', 'cross-impact'] },
+            { name: 'strategize', sequential: ['strategist', 'test-designer'] },
+        ],
+    },
+};

package/dist/custom_provider.d.ts

@@ -0,0 +1,20 @@
+import type { CustomConfig, GenerateOptions, ImageInput, LLMResponse, ProviderCapabilities } from './provider_interface.js';
+import { BaseProvider } from './base_provider.js';
+export declare class CustomProvider extends BaseProvider {
+    name: string;
+    private config;
+    capabilities: ProviderCapabilities;
+    constructor(config: CustomConfig);
+    generateText(prompt: string, options?: GenerateOptions): Promise<LLMResponse>;
+    analyzeImage(images: ImageInput[], prompt: string, options?: GenerateOptions): Promise<LLMResponse>;
+    private dispatchRequest;
+    private requestOpenAI;
+    private requestAnthropic;
+    private requestCustom;
+    streamText(): AsyncGenerator<string, void, unknown>;
+    checkHealth(): Promise<{
+        healthy: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=custom_provider.d.ts.map

package/dist/custom_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom_provider.d.ts","sourceRoot":"","sources":["../src/custom_provider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,YAAY,EACZ,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AA6DhD,qBAAa,cAAe,SAAQ,YAAY;IAC5C,IAAI,SAAY;IAChB,OAAO,CAAC,MAAM,CAAe;IAE7B,YAAY,EAAE,oBAAoB,CAAC;gBAEvB,MAAM,EAAE,YAAY;IAyB1B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAmC7E,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;YAyC3F,eAAe;YAiBf,aAAa;YA8Eb,gBAAgB;YA6EhB,aAAa;IAqBpB,UAAU,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;IAKpD,WAAW,IAAI,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC;CAOpE"}

package/dist/custom_provider.js

@@ -0,0 +1,277 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomProvider = void 0;
+const provider_interface_js_1 = require("./provider_interface.js");
+const provider_utils_js_1 = require("./provider_utils.js");
+const base_provider_js_1 = require("./base_provider.js");
+const logger_js_1 = require("./logger.js");
+function normalizeUrl(baseUrl, pathSuffix) {
+    const trimmed = baseUrl.replace(/\/+$/, '');
+    if (trimmed.endsWith(pathSuffix)) {
+        return trimmed;
+    }
+    return `${trimmed}${pathSuffix}`;
+}
+async function postJson(url, headers, body, timeoutMs, context) {
+    const controller = new AbortController();
+    const timer = timeoutMs ? setTimeout(() => controller.abort(), timeoutMs) : undefined;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                ...headers,
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Request timeout (${context})`);
+        }
+        throw error;
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+    }
+}
+class CustomProvider extends base_provider_js_1.BaseProvider {
+    constructor(config) {
+        super();
+        this.name = 'custom';
+        const validation = (0, provider_utils_js_1.validateAndSanitizeUrl)(config.baseUrl);
+        if (!validation.valid) {
+            throw new Error(`Invalid base URL: ${validation.warning}`);
+        }
+        if (validation.warning) {
+            logger_js_1.logger.warn(`HTTPS required for remote URLs: ${validation.warning}`);
+        }
+        this.config = config;
+        this.capabilities = {
+            vision: config.requestFormat !== 'custom',
+            streaming: false,
+            maxTokens: 0,
+            costPer1MInputTokens: 0,
+            costPer1MOutputTokens: 0,
+            supportsTools: false,
+            supportsPromptCaching: false,
+            typicalResponseTimeMs: 0,
+        };
+    }
+    async generateText(prompt, options) {
+        this.checkBudget();
+        const startTime = Date.now();
+        try {
+            if (prompt.length > 10 * 1024 * 1024) {
+                throw new Error('Prompt exceeds maximum size (10MB)');
+            }
+            const response = await this.dispatchRequest(prompt, options);
+            const responseTime = Date.now() - startTime;
+            const text = response.text;
+            const usage = response.usage;
+            const cost = response.cost;
+            this.updateStats(usage, responseTime, cost);
+            return {
+                text,
+                usage,
+                cost,
+                metadata: response.metadata,
+            };
+        }
+        catch (error) {
+            this.stats.failedRequests++;
+            throw new provider_interface_js_1.LLMProviderError((0, provider_utils_js_1.sanitizeErrorMessage)(error, 'generateText'), this.name, undefined, error);
+        }
+    }
+    async analyzeImage(images, prompt, options) {
+        if (this.config.requestFormat === 'custom') {
+            throw new provider_interface_js_1.UnsupportedCapabilityError(this.name, 'vision');
+        }
+        const startTime = Date.now();
+        try {
+            if (images.length === 0 || images.length > 20) {
+                throw new Error('Image count must be between 1 and 20');
+            }
+            if (prompt.length > 10 * 1024 * 1024) {
+                throw new Error('Prompt exceeds maximum size (10MB)');
+            }
+            const response = await this.dispatchRequest(prompt, options, images);
+            const responseTime = Date.now() - startTime;
+            const text = response.text;
+            const usage = response.usage;
+            const cost = response.cost;
+            this.updateStats(usage, responseTime, cost);
+            return {
+                text,
+                usage,
+                cost,
+                metadata: response.metadata,
+            };
+        }
+        catch (error) {
+            this.stats.failedRequests++;
+            throw new provider_interface_js_1.LLMProviderError((0, provider_utils_js_1.sanitizeErrorMessage)(error, 'analyzeImage'), this.name, undefined, error);
+        }
+    }
+    async dispatchRequest(prompt, options, images) {
+        switch (this.config.requestFormat) {
+            case 'openai':
+                return this.requestOpenAI(prompt, options, images);
+            case 'anthropic':
+                return this.requestAnthropic(prompt, options, images);
+            case 'custom':
+                return this.requestCustom(prompt, options);
+            default:
+                throw new Error(`Unsupported request format: ${this.config.requestFormat}`);
+        }
+    }
+    async requestOpenAI(prompt, options, images) {
+        const url = normalizeUrl(this.config.baseUrl, '/chat/completions');
+        const messages = [];
+        if (options?.systemPrompt) {
+            messages.push({ role: 'system', content: options.systemPrompt });
+        }
+        if (images && images.length > 0) {
+            const content = [
+                { type: 'text', text: prompt },
+            ];
+            for (const image of images) {
+                const mediaType = (image.mimeType || image.mediaType || 'image/png');
+                if (!['image/png', 'image/jpeg', 'image/webp'].includes(mediaType)) {
+                    throw new Error(`Unsupported image type: ${mediaType}`);
+                }
+                const data = image.data || image.base64 || '';
+                if (data.length > 20 * 1024 * 1024) {
+                    throw new Error('Image data exceeds maximum size (20MB)');
+                }
+                content.push({
+                    type: 'image_url',
+                    image_url: { url: `data:${mediaType};base64,${data}` },
+                });
+                if (image.description) {
+                    content.push({ type: 'text', text: `[Image: ${image.description}]` });
+                }
+            }
+            messages.push({ role: 'user', content });
+        }
+        else {
+            messages.push({ role: 'user', content: prompt });
+        }
+        const body = {
+            model: this.config.model,
+            messages,
+            max_tokens: options?.maxTokens,
+            temperature: options?.temperature,
+            top_p: options?.topP,
+            stop: options?.stopSequences,
+        };
+        const response = await postJson(url, this.config.auth, body, options?.timeout, 'openai');
+        const text = response.choices?.[0]?.message?.content || '';
+        const usage = {
+            inputTokens: response.usage?.prompt_tokens || 0,
+            outputTokens: response.usage?.completion_tokens || 0,
+            totalTokens: response.usage?.total_tokens || 0,
+        };
+        return {
+            text,
+            usage,
+            cost: 0,
+            metadata: {
+                finishReason: response.choices?.[0]?.finish_reason,
+            },
+        };
+    }
+    async requestAnthropic(prompt, options, images) {
+        const url = normalizeUrl(this.config.baseUrl, '/messages');
+        const content = [
+            { type: 'text', text: prompt },
+        ];
+        if (images && images.length > 0) {
+            for (const image of images) {
+                const mediaType = (image.mimeType || image.mediaType || 'image/png');
+                if (!['image/png', 'image/jpeg', 'image/webp', 'image/gif'].includes(mediaType)) {
+                    throw new Error(`Unsupported image type: ${mediaType}`);
+                }
+                const data = image.data || image.base64 || '';
+                if (data.length > 20 * 1024 * 1024) {
+                    throw new Error('Image data exceeds maximum size (20MB)');
+                }
+                content.push({
+                    type: 'image',
+                    source: {
+                        type: 'base64',
+                        media_type: mediaType,
+                        data,
+                    },
+                });
+                if (image.description) {
+                    content.push({ type: 'text', text: `[Image: ${image.description}]` });
+                }
+            }
+        }
+        const body = {
+            model: this.config.model,
+            max_tokens: options?.maxTokens || 4000,
+            temperature: options?.temperature,
+            top_p: options?.topP,
+            stop_sequences: options?.stopSequences,
+            system: options?.systemPrompt,
+            messages: [
+                {
+                    role: 'user',
+                    content,
+                },
+            ],
+        };
+        const response = await postJson(url, this.config.auth, body, options?.timeout, 'anthropic');
+        const text = (response.content || []).map((block) => block.text).join('\n');
+        const usage = {
+            inputTokens: response.usage?.input_tokens || 0,
+            outputTokens: response.usage?.output_tokens || 0,
+            totalTokens: (response.usage?.input_tokens || 0) + (response.usage?.output_tokens || 0),
+        };
+        return {
+            text,
+            usage,
+            cost: 0,
+            metadata: {
+                stopReason: response.stop_reason,
+            },
+        };
+    }
+    async requestCustom(prompt, options) {
+        if (!this.config.transformRequest || !this.config.transformResponse) {
+            throw new Error('Custom providers require transformRequest and transformResponse');
+        }
+        const body = this.config.transformRequest(prompt, options);
+        const response = await postJson(this.config.baseUrl, this.config.auth, body, options?.timeout, 'custom');
+        const transformed = this.config.transformResponse(response);
+        return {
+            text: transformed.text,
+            usage: transformed.usage,
+            cost: transformed.cost,
+            metadata: transformed.metadata,
+        };
+    }
+    // CustomProvider doesn't support streaming
+    async *streamText() {
+        throw new Error('Streaming not supported for custom providers');
+    }
+    // CustomProvider doesn't have built-in health checks
+    async checkHealth() {
+        return {
+            healthy: true,
+            message: 'Custom provider configured',
+        };
+    }
+}
+exports.CustomProvider = CustomProvider;

package/dist/engine/ai_enrichment.d.ts

@@ -0,0 +1,44 @@
+import type { LLMProvider } from '../provider_interface.js';
+import type { ImpactResult, SpecWithScenarios } from './impact_engine.js';
+import type { FeaturePriority } from '../knowledge/route_families.js';
+export interface EnrichedFeature {
+    familyId: string;
+    featureId?: string;
+    priority: FeaturePriority;
+    changedFiles: string[];
+    coverageStatus: string;
+    playwrightSpecs: string[];
+    cypressSpecs: string[];
+    userFlows: string[];
+    aiReasons: string[];
+    aiMissingScenarios: string[];
+    aiCoveredBy: string[];
+}
+export interface AIEnrichmentResult {
+    enrichedFeatures: EnrichedFeature[];
+    unboundFileInsights: Array<{
+        file: string;
+        likelyFeature: string;
+        reason: string;
+    }>;
+    warnings: string[];
+    providerName: string;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+export interface AIEnrichmentOptions {
+    deterministicImpact: ImpactResult;
+    diffs: Map<string, string>;
+    provider: LLMProvider;
+    specList: string[];
+    specDetails?: SpecWithScenarios[];
+    manifestSummary?: string;
+}
+/**
+ * Enriches a deterministic impact result with AI-generated reasons,
+ * missing test scenarios, and coverage insights.
+ */
+export declare function enrichImpactWithAI(options: AIEnrichmentOptions): Promise<AIEnrichmentResult>;
+//# sourceMappingURL=ai_enrichment.d.ts.map

package/dist/engine/ai_enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_enrichment.d.ts","sourceRoot":"","sources":["../../src/engine/ai_enrichment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,YAAY,EAAmB,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AAGpE,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IAC/B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,mBAAmB,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAClF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAChC,mBAAmB,EAAE,YAAY,CAAC;IAClC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAoLD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkIlG"}