@yasserkhanorg/e2e-agents 0.3.2

package/README.md

@@ -0,0 +1,620 @@
+# @yasserkhanorg/e2e-agents
+
+Framework-agnostic LLM provider library with MCP server for autonomous E2E testing.
+
+[![npm](https://img.shields.io/npm/v/%40yasserkhanorg%2Fe2e-agents)](https://www.npmjs.com/package/@yasserkhanorg/e2e-agents)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![GitHub](https://img.shields.io/badge/github-yasserfaraazkhan%2Fe2e--agents-blue?logo=github)](https://github.com/yasserfaraazkhan/e2e-agents)
+
+## Overview
+
+Pluggable LLM provider abstraction for test automation with:
+- **Anthropic Claude** — Advanced reasoning, vision support
+- **OpenAI GPT** — Official OpenAI API integration
+- **Ollama** — Free, local, privacy-first
+- **MCP Server** — 6 tools for test discovery, generation, and healing
+- **Custom Providers** — Extend with any OpenAI-compatible API
+
+## Installation
+
+```bash
+npm install @yasserkhanorg/e2e-agents
+```
+
+## Module Formats (CJS + ESM)
+
+This package ships both CommonJS and ESM builds:
+- `require('@yasserkhanorg/e2e-agents')` loads the CommonJS build from `dist/index.js`.
+- `import ... from '@yasserkhanorg/e2e-agents'` loads the ESM build from `dist/esm/index.js`.
+- `./mcp` follows the same pattern (`dist/mcp-server.js` for CJS, `dist/esm/mcp-server.js` for ESM).
+
+Node.js >= 20 is required.
+
+## Quick Links
+
+📖 **[Comprehensive Guide](E2E_AI_TESTING.md)** - In-depth documentation including:
+- How to use e2e-ai-agents in your projects
+- Real-world examples for Playwright, Cypress, Selenium
+- How Mattermost uses this package
+- Cost optimization and best practices
+
+## Quick Start
+
+### Use Claude
+
+```typescript
+import { AnthropicProvider } from '@yasserkhanorg/e2e-agents';
+
+const claude = new AnthropicProvider({
+    apiKey: process.env.ANTHROPIC_API_KEY
+});
+
+const response = await claude.generateText('Analyze test failure');
+console.log(response.text);
+console.log(`Cost: $${response.cost.toFixed(4)}`);
+```
+
+### Use OpenAI
+
+```typescript
+import { OpenAIProvider } from '@yasserkhanorg/e2e-agents';
+
+const openai = new OpenAIProvider({
+    apiKey: process.env.OPENAI_API_KEY,
+    model: 'gpt-4'
+});
+
+const response = await openai.generateText('Summarize test failure');
+console.log(response.text);
+```
+
+Tip: for accurate OpenAI cost tracking, set `costPer1MInputTokens` and `costPer1MOutputTokens` in the `OpenAIProvider` config.
+
+### Use Ollama (Free)
+
+```typescript
+import { OllamaProvider } from '@yasserkhanorg/e2e-agents';
+
+const ollama = new OllamaProvider({
+    model: 'deepseek-r1:7b'
+});
+
+const response = await ollama.generateText('Generate test case');
+console.log(response.text); // Free!
+```
+
+### Use Custom Provider (OpenAI-compatible endpoint)
+
+```typescript
+import { CustomProvider } from '@yasserkhanorg/e2e-agents';
+
+const custom = new CustomProvider({
+    baseUrl: 'https://your-llm-gateway.example.com/v1',
+    auth: { Authorization: `Bearer ${process.env.CUSTOM_API_KEY}` },
+    model: 'your-model-name',
+    requestFormat: 'openai'
+});
+
+const response = await custom.generateText('Generate test case');
+console.log(response.text);
+```
+
+`requestFormat` can be `'openai'`, `'anthropic'`, or `'custom'` (with `transformRequest`/`transformResponse`).
+
+### Factory Pattern
+
+```typescript
+import { LLMProviderFactory } from '@yasserkhanorg/e2e-agents';
+
+// Auto-detect from environment
+const provider = LLMProviderFactory.create({
+    type: 'anthropic',
+    config: { apiKey: process.env.ANTHROPIC_API_KEY }
+});
+```
+
+### Hybrid Mode (Free + Premium)
+
+```typescript
+const provider = LLMProviderFactory.createHybrid({
+    primary: { type: 'ollama', config: { model: 'deepseek-r1:7b' } },
+    fallback: { type: 'anthropic', config: { apiKey: process.env.ANTHROPIC_API_KEY } },
+    useFallbackFor: ['vision'] // Only use Claude for vision
+});
+
+await provider.generateText('Analyze code'); // Uses Ollama (free)
+await provider.analyzeImage([...], 'Compare screenshots'); // Uses Claude (vision)
+```
+
+## CLI: Impact and Gap Analysis
+
+Run AI-driven impact analysis or gap analysis on any frontend repo.
+
+```bash
+npx e2e-ai-agents impact --path /path/to/webapp
+npx e2e-ai-agents gap --path /path/to/webapp
+npx e2e-ai-agents suggest --path /path/to/webapp
+npx e2e-ai-agents approve-and-generate --path /path/to/webapp
+npx e2e-ai-agents finalize-generated-tests --path /path/to/webapp
+npx e2e-ai-agents feedback --path /path/to/webapp --feedback-input ./feedback.json
+npx e2e-ai-agents traceability-capture --path /path/to/webapp --traceability-report ./playwright-report.json
+npx e2e-ai-agents traceability-ingest --path /path/to/webapp --traceability-input ./traceability-input.json
+```
+
+If tests live outside the app root:
+
+```bash
+npx e2e-ai-agents impact --path /path/to/webapp --tests-root /path/to/e2e-tests
+```
+
+Optional config file `e2e-ai-agents.config.json` (JSON):
+
+```json
+{
+  "path": ".",
+  "testsRoot": ".",
+  "flowCatalogPath": ".e2e-ai-agents/flows.json",
+  "mode": "impact",
+  "framework": "auto",
+  "timeLimitMinutes": 10,
+  "budget": { "maxUSD": 2, "maxTokens": 20000 },
+  "artifacts": { "mode": "commit", "specsDir": ".e2e-ai-agents/reports" },
+  "selectors": { "patchOnApply": true },
+  "testDiscovery": { "patterns": ["tests/**/*.spec.ts"] },
+  "flowDiscovery": {
+    "patterns": ["channels/src/components/**/*.{tsx,jsx}"],
+    "exclude": ["**/components/**/stories/**"]
+  },
+  "catalogScoring": {
+    "priorityScores": { "P0": 10, "P1": 6, "P2": 3 },
+    "fileMatchWeight": 1
+  },
+  "impact": {
+    "allowFallback": false,
+    "dependencyGraph": {
+      "enabled": true,
+      "maxDepth": 3,
+      "maxExpandedFiles": 1000,
+      "filePatterns": ["**/*.{ts,tsx,js,jsx}"],
+      "excludePatterns": ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/build/**"],
+      "aliasRoots": ["src", "channels/src"],
+      "pathAliases": {
+        "@app/*": ["src/*"],
+        "@channels/*": ["channels/src/*"]
+      }
+    },
+    "traceability": {
+      "enabled": true,
+      "manifestPath": ".e2e-ai-agents/traceability.json",
+      "minSignalsPerTest": 1
+    },
+    "subsystemRisk": {
+      "enabled": false,
+      "mapPath": ".e2e-ai-agents/subsystem-risk-map.json",
+      "maxRulesPerFile": 4
+    }
+  },
+  "pipeline": {
+    "enabled": false,
+    "scenarios": 3,
+    "outputDir": "specs/functional/ai-assisted",
+    "heal": true,
+    "mcp": false
+  },
+  "llm": { "provider": "anthropic", "fallback": "ollama" },
+  "policy": {
+    "minConfidenceForTargeted": 60,
+    "safeMergeMinConfidence": 85,
+    "forceFullOnWarningsAtOrAbove": 2,
+    "forceFullOnP0WithGaps": true,
+    "forceFullOnRiskyFiles": true,
+    "riskyFilePatterns": ["**/auth/**", "**/permissions/**", "**/security/**", "**/*.sql"]
+  },
+  "flags": { "defaultState": "on" },
+  "audience": { "defaultRoles": ["member"] },
+  "blastRadius": {
+    "memberBonus": 1,
+    "guestBonus": 1,
+    "adminOnlyPenalty": -1,
+    "flagOffPenalty": -2
+  }
+}
+```
+
+Notes:
+- If no framework config is found, provide `testDiscovery.patterns` or `--patterns`.
+- Use `flowDiscovery.patterns` or `--flow-patterns` to customize flow scanning.
+- Use `testsRoot` when tests live outside the app root.
+- Use `flowCatalogPath` or `--flow-catalog` to provide a flow catalog for deterministic P0/P1 mapping.
+- Impact mode expects a git diff; use `--since` or add `"impact": { "allowFallback": true }` to fall back to scanning.
+- Impact analysis now uses static reverse dependency graph expansion (configurable via `impact.dependencyGraph`) to propagate changed-file impact, including alias imports via `aliasRoots` and `pathAliases`.
+- Impact analysis can use coverage-style traceability manifests (`impact.traceability`) for file->test mapping with heuristic fallback for uncovered flows.
+- Impact analysis can apply subsystem-aware risk boosts and priority floors from a map (`impact.subsystemRisk`) to capture known high-blast-radius areas.
+- Diffing is computed from `merge-base(<since>, HEAD)` when available, which is the standard PR-impact baseline.
+- Reports are written under `testsRoot/.e2e-ai-agents/reports` (or app root if `testsRoot` is not set).
+- Use `approve-and-generate` for explicit approval before patching `data-testid` and generating/healing tests.
+- `--apply` remains available as a legacy shortcut for direct `gap` execution.
+- Use `--pipeline` to run the Playwright generation pipeline.
+- If `e2e-test-gen-cli.ts` exists in `testsRoot`, it is used as the advanced runner.
+- If it is absent, `@yasserkhanorg/e2e-agents` falls back to package-native generation with strategy-based templates, quality guardrails (`no test.describe`, single tag), and iterative heal attempts.
+- Use `--pipeline-mcp` (or `"pipeline": { "mcp": true }`) to run exploration/healing via Playwright MCP.
+- `suggest` writes `.e2e-ai-agents/plan.json` with `runSet` (`smoke|targeted|full`) and confidence.
+- `suggest` also writes `.e2e-ai-agents/ci-summary.md` with CI status: `run-now`, `must-add-tests`, or `safe-to-merge`.
+- CLI policy overrides: `--policy-min-confidence`, `--policy-safe-merge-confidence`, `--policy-force-full-on-warnings`, `--policy-risky-patterns`.
+- GitHub Actions output wiring: `--github-output $GITHUB_OUTPUT`.
+- Optional merge gating: `--fail-on-must-add-tests` exits non-zero when uncovered P0/P1 gaps are detected. Leave this flag unset for advisory-only mode.
+- `impact/gap` now include actionable `testSuggestions` with linked source files and skeleton test code.
+- `impact/gap` now include `impactModel` metadata (`flowMapping`, `testMapping`, `confidenceClass`, traceability stats, dependency graph stats).
+- `impact/gap` now include optional `impactModel.subsystemRisk` stats (map status, matched files/rules, boosted flows).
+- `feedback` appends outcomes to `.e2e-ai-agents/feedback.json` and recomputes `.e2e-ai-agents/calibration.json`.
+- `feedback` also computes intelligent flaky scores into `.e2e-ai-agents/flaky-tests.json`.
+- `traceability-capture` converts Playwright JSON execution report + optional coverage map into `.e2e-ai-agents/traceability-input.json`.
+- `traceability-ingest` merges CI execution mappings into `.e2e-ai-agents/traceability.json` and persists rolling counts in `.e2e-ai-agents/traceability-state.json`.
+- Traceability capture flags: `--traceability-report`, `--traceability-capture-output`, `--traceability-coverage-map`, `--traceability-changed-files`.
+- Traceability ingest tuning flags: `--traceability-min-hits`, `--traceability-max-files-per-test`, `--traceability-max-age-days`.
+- Optional ownership routing for flaky alerts: `.e2e-ai-agents/subsystem-owners.json`.
+- `suggest` automatically consumes optional operational manifests:
+  - `.e2e-ai-agents/flaky-tests.json`
+  - `.e2e-ai-agents/quality-gates.json`
+- `plan.json` includes `nextActions` commands for run/approve-and-generate/heal/finalize/PR handoff.
+- `finalize-generated-tests` stages generated artifacts from `gap.json`, commits, and can open a PR with `--create-pr`.
+- Generated Mattermost Playwright tests use standalone `test(...)` style (no `test.describe`) and a single tag string.
+
+Programmatic API:
+
+```typescript
+import {analyzeImpact, findGaps, recommendTests, captureTraceability, ingestTraceability} from '@yasserkhanorg/e2e-agents';
+
+await analyzeImpact({path: '/path/to/webapp'});
+await findGaps({path: '/path/to/webapp'});
+const suggestion = await recommendTests({path: '/path/to/webapp'});
+console.log(suggestion.plan.runSet);
+
+const captured = captureTraceability({
+  path: '/path/to/webapp',
+  testsRoot: '/path/to/e2e-tests/playwright',
+  reportPath: '/path/to/playwright-report.json',
+});
+
+ingestTraceability({
+  path: '/path/to/webapp',
+  testsRoot: '/path/to/e2e-tests/playwright',
+  payload: JSON.parse(require('fs').readFileSync(captured.outputPath, 'utf8')),
+});
+```
+
+Feedback API:
+
+```typescript
+import {appendFeedbackAndRecompute} from '@yasserkhanorg/e2e-agents';
+
+appendFeedbackAndRecompute('/path/to/webapp', {
+  timestamp: new Date().toISOString(),
+  runSet: 'targeted',
+  recommendedTests: ['specs/channels/realtime.spec.ts'],
+  executedTests: ['specs/channels/realtime.spec.ts'],
+  failedTests: ['specs/channels/realtime.spec.ts'],
+  escapedFailures: []
+});
+```
+
+Traceability ingest API:
+
+```typescript
+import {ingestTraceability} from '@yasserkhanorg/e2e-agents';
+
+ingestTraceability({
+  path: '/path/to/webapp',
+  testsRoot: '/path/to/e2e-tests/playwright',
+  payload: {
+    runs: [
+      {
+        test: 'specs/channels/channels.switch.spec.ts',
+        touchedFiles: ['channels/src/components/channel_switcher/channel_switcher.tsx']
+      }
+    ]
+  },
+  options: {minHits: 2}
+});
+```
+
+Automation API:
+
+```typescript
+import {handoffGeneratedTests} from '@yasserkhanorg/e2e-agents';
+
+handoffGeneratedTests({
+  appPath: '/path/to/webapp',
+  testsRoot: '/path/to/e2e-tests/playwright',
+  createPr: true,
+});
+```
+
+CI integration template:
+
+- [GitHub Actions example](examples/github-actions/pr-impact.yml)
+- The example uses Node 22 (`actions/setup-node@v4` with `node-version: 22`).
+- The example captures Playwright JSON output via `traceability-capture` and ingests it with `traceability-ingest`.
+- Feedback payload example: [examples/feedback.sample.json](examples/feedback.sample.json)
+- Subsystem owners example: [examples/subsystem-owners.sample.json](examples/subsystem-owners.sample.json)
+- Traceability ingest payload schema: [schemas/traceability-input.schema.json](schemas/traceability-input.schema.json)
+- Traceability ingest payload example: [examples/traceability-input.sample.json](examples/traceability-input.sample.json)
+- Traceability manifest example: [examples/traceability.sample.json](examples/traceability.sample.json)
+- Subsystem risk map schema: [schemas/subsystem-risk-map.schema.json](schemas/subsystem-risk-map.schema.json)
+- Subsystem risk map example: [examples/subsystem-risk-map.sample.json](examples/subsystem-risk-map.sample.json)
+- End-to-end verification steps: [examples/verification/README.md](examples/verification/README.md)
+
+Traceability manifest example (`.e2e-ai-agents/traceability.json`):
+
+```json
+{
+  "schemaVersion": "1.0.0",
+  "tests": [
+    {
+      "test": "specs/channels/channels.switch.spec.ts",
+      "touchedFiles": ["channels/src/components/channel_switcher/channel_switcher.tsx"]
+    }
+  ]
+}
+```
+
+Traceability ingest input example (`traceability-input.json`):
+
+```json
+{
+  "runs": [
+    {
+      "test": "specs/channels/channels.switch.spec.ts",
+      "touchedFiles": ["channels/src/components/channel_switcher/channel_switcher.tsx"]
+    }
+  ]
+}
+```
+
+Flow catalog entries can also include optional audience and flag metadata:
+
+```json
+{
+  "id": "messaging.realtime",
+  "priority": "P0",
+  "audience": ["member", "guest"],
+  "flags": [
+    "EnableSomething",
+    { "name": "EnableEnterpriseOnly", "source": "config", "defaultState": "off" }
+  ],
+  "tests": ["specs/functional/channels/realtime.spec.ts"]
+}
+```
+
+## Extending with Custom Frameworks
+
+### 1. Create Custom Provider
+
+```typescript
+import { LLMProvider } from '@yasserkhanorg/e2e-agents';
+
+export class MyCustomProvider implements LLMProvider {
+    async generateText(prompt: string) {
+        // Your API call here
+        return {
+            text: '...',
+            cost: 0.001,
+            tokens: { input: 100, output: 50 }
+        };
+    }
+
+    async analyzeImage(images, prompt) {
+        throw new Error('Vision not supported');
+    }
+
+    async streamText(prompt) {
+        // Generator implementation
+        yield 'chunk1';
+        yield 'chunk2';
+    }
+
+    getUsageStats() {
+        return { /* ... */ };
+    }
+}
+```
+
+### 2. Register with Factory
+
+```typescript
+import { LLMProviderFactory } from '@yasserkhanorg/e2e-agents';
+
+LLMProviderFactory.register('my-provider', (config) => {
+    return new MyCustomProvider(config);
+});
+
+// Use it
+const provider = LLMProviderFactory.create({
+    type: 'my-provider',
+    config: { apiKey: '...' }
+});
+```
+
+### 3. Integrate with Test Framework
+
+```typescript
+// Playwright example
+import { test } from '@playwright/test';
+import { LLMProviderFactory } from '@yasserkhanorg/e2e-agents';
+
+const llm = LLMProviderFactory.create({
+    type: 'anthropic',
+    config: { apiKey: process.env.ANTHROPIC_API_KEY }
+});
+
+test('use LLM to verify UI', async ({ page }) => {
+    await page.goto('https://example.com');
+    const screenshot = await page.screenshot();
+
+    const analysis = await llm.analyzeImage(
+        [{ data: screenshot.toString('base64'), mimeType: 'image/png' }],
+        'Is the login button visible and correctly styled?'
+    );
+
+    console.log(analysis.text);
+});
+```
+
+## MCP Server Integration
+
+For Playwright test agents (v1.56+):
+
+```typescript
+import { E2EAgentsMCPServer } from '@yasserkhanorg/e2e-agents/mcp';
+
+const server = new E2EAgentsMCPServer();
+const tools = server.getTools();
+
+// Available tools:
+// - discover_tests: Find tests needed for code changes
+// - read_file: Read repository files
+// - write_file: Create/update test files
+// - run_tests: Execute tests
+// - get_git_changes: Detect changed files
+// - get_repository_context: Gather metadata
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+ANTHROPIC_API_KEY=sk-ant-...
+ANTHROPIC_MODEL=claude-sonnet-4-5-20250929
+
+OPENAI_API_KEY=sk-...
+OPENAI_MODEL=gpt-4
+OPENAI_BASE_URL=https://api.openai.com/v1
+OPENAI_ORG_ID=org_...
+
+OLLAMA_BASE_URL=http://localhost:11434
+OLLAMA_MODEL=deepseek-r1:7b
+```
+
+Note: If `OLLAMA_BASE_URL` points to the root host (for example, `http://localhost:11434`), it will be normalized to `/v1`.
+
+### Setup
+
+**Claude:**
+1. Get key: https://console.anthropic.com
+2. Export: `export ANTHROPIC_API_KEY=sk-ant-...`
+
+**OpenAI:**
+1. Get key: https://platform.openai.com
+2. Export: `export OPENAI_API_KEY=sk-...`
+
+**Ollama:**
+1. Install: `curl -fsSL https://ollama.com/install.sh | sh`
+2. Pull: `ollama pull deepseek-r1:7b`
+3. Run: `ollama serve`
+
+## Error Handling
+
+```typescript
+import { LLMProviderError, UnsupportedCapabilityError } from '@yasserkhanorg/e2e-agents';
+
+try {
+    await provider.analyzeImage([...], 'Analyze');
+} catch (error) {
+    if (error instanceof UnsupportedCapabilityError) {
+        console.log(`Not supported by: ${error.provider}`);
+    } else if (error instanceof LLMProviderError) {
+        console.log(`API error: ${error.message}`);
+    }
+}
+```
+
+## Performance Comparison
+
+| Feature | Claude | OpenAI | Ollama |
+|---------|--------|--------|--------|
+| Vision | ✅ | ✅ (model dependent) | ❌ |
+| Cost | $3-15/1M tokens | Model dependent | Free |
+| Speed | ~800ms | ~1000ms | ~3000ms |
+| Streaming | ✅ | ✅ | ✅ |
+| Local | ❌ | ❌ | ✅ |
+
+## Cost Optimization
+
+```typescript
+const stats = provider.getUsageStats();
+console.log(`Tokens: ${stats.totalTokens.toLocaleString()}`);
+console.log(`Cost: $${stats.totalCost.toFixed(2)}`);
+console.log(`Avg speed: ${stats.averageResponseTimeMs.toFixed(0)}ms`);
+```
+
+## Performance & Optimization (v0.3.0+)
+
+### Logging Configuration
+
+Control logging verbosity with the `LOG_LEVEL` environment variable:
+
+```bash
+# Production: errors only
+LOG_LEVEL=ERROR npm start
+
+# Development: all messages
+LOG_LEVEL=DEBUG npm start
+```
+
+Supported levels: `ERROR`, `WARN`, `INFO`, `DEBUG` (default: `INFO`)
+
+### Caching
+
+The library includes a simple TTL cache for repository context:
+
+```typescript
+import { SimpleCache } from '@yasserkhanorg/e2e-agents/agent/cache_utils';
+
+// Create a 10-minute cache
+const cache = new SimpleCache(10 * 60 * 1000);
+
+// Store and retrieve
+cache.set('key', {data: 'value'});
+const value = cache.get('key');
+
+// Check stats
+const {size, entries} = cache.stats();
+```
+
+### Performance Metrics (v0.3.0)
+
+Improvements from code quality refactoring:
+
+- **40% faster** stats calculation (incremental updates)
+- **30% faster** API key validation (pre-compiled patterns)
+- **90% faster** repository context (cache hits)
+- **15% smaller** bundle size (code deduplication)
+- **44 comprehensive tests** (80%+ coverage)
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed improvements.
+
+## Learn More
+
+For comprehensive documentation on:
+- Real-world usage examples
+- Integration with different frameworks
+- How Mattermost uses e2e-ai-agents in production
+- Cost optimization strategies
+- Security features and best practices
+
+👉 **See [E2E_AI_TESTING.md](E2E_AI_TESTING.md)**
+
+## Production Usage
+
+This package is used in production by Mattermost for:
+- ✅ Automated test generation
+- ✅ Test validation and healing
+- ✅ UI screenshot analysis
+- ✅ Test data generation
+
+See the [Mattermost e2e-test-gen implementation](https://github.com/mattermost/mattermost/tree/master/e2e-tests/playwright) for a complete example.
+
+## License
+
+Apache 2.0

package/dist/agent/analysis.d.ts

@@ -0,0 +1,62 @@
+import type { AgentConfig, AudienceRole } from './config.js';
+import { type BlastRadius, type FlagHit } from './flags.js';
+export type FlowPriority = 'P0' | 'P1' | 'P2';
+export interface FileAnalysis {
+    relativePath: string;
+    extension: string;
+    exists: boolean;
+    content: string | null;
+    isUI: boolean;
+    isScreen: boolean;
+    isComponent: boolean;
+    isState: boolean;
+    isStyle: boolean;
+    hasInteractions: boolean;
+    keywords: string[];
+    flowId: string;
+    flowName: string;
+    flowKind: 'screen' | 'flow';
+    audience: AudienceRole[];
+    flags: FlagHit[];
+    subsystemRisk?: {
+        rules: string[];
+        scoreDelta: number;
+        priorityFloor?: FlowPriority;
+        reasons: string[];
+    };
+}
+export interface FlowImpact {
+    id: string;
+    name: string;
+    kind: 'screen' | 'flow';
+    score: number;
+    priority: FlowPriority;
+    reasons: string[];
+    keywords: string[];
+    files: string[];
+    audience?: AudienceRole[];
+    flags?: FlagHit[];
+    blastRadius?: BlastRadius;
+    priorityFloor?: FlowPriority;
+    subsystemRiskBoost?: number;
+    subsystemRiskRules?: string[];
+}
+export interface ImpactAnalysisResult {
+    files: FileAnalysis[];
+    flows: FlowImpact[];
+    warnings: string[];
+    subsystemRisk: {
+        source: 'map';
+        enabled: boolean;
+        mapPath: string;
+        mapFound: boolean;
+        rulesLoaded: number;
+        filesMatched: number;
+        ruleMatches: number;
+        boostedFlows: number;
+    };
+}
+export declare function analyzeFiles(appRoot: string, relativePaths: string[], config: AgentConfig): ImpactAnalysisResult;
+export declare function isTestFilePath(relativePath: string): boolean;
+export declare function scanRepositoryFlows(appRoot: string, limit?: number, patterns?: string[], exclude?: string[]): string[];
+//# sourceMappingURL=analysis.d.ts.map

package/dist/agent/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/agent/analysis.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,WAAW,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AACvE,OAAO,EAAqE,KAAK,WAAW,EAAE,KAAK,OAAO,EAAC,MAAM,YAAY,CAAC;AAY9H,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,YAAY,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE;QACX,MAAM,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AA6HD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,oBAAoB,CA+IhH;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAsCnH"}