specweave 1.0.593 → 2.0.3

package/dist/src/core/living-docs/operations/ops-generator.js

@@ -1,462 +0,0 @@
-/**
- * Operations Documentation Generator
- *
- * Generates operational documentation:
- * - Runbooks from hook scripts and patterns
- * - Monitoring guidance
- * - Incident templates
- * - SLA tracking
- */
-import * as fs from 'fs';
-import * as path from 'path';
-import { glob } from 'glob';
-import { consoleLogger } from '../../../utils/logger.js';
-/**
- * Generates operations documentation
- */
-export class OpsGenerator {
-    constructor(options) {
-        this.projectPath = options.projectPath;
-        this.logger = options.logger ?? consoleLogger;
-        this.opsPath = path.join(this.projectPath, '.specweave/docs/internal/operations');
-    }
-    /**
-     * Generate all operations documentation
-     */
-    async generate() {
-        const filesCreated = [];
-        // Ensure operations directory exists
-        fs.mkdirSync(this.opsPath, { recursive: true });
-        // 1. Generate Runbooks
-        this.logger.info('  Generating runbooks...');
-        const runbookResult = await this.generateRunbooks();
-        if (runbookResult.file) {
-            filesCreated.push(runbookResult.file);
-        }
-        // 2. Generate Monitoring documentation
-        this.logger.info('  Generating monitoring docs...');
-        const monitoringResult = await this.generateMonitoringDocs();
-        if (monitoringResult.file) {
-            filesCreated.push(monitoringResult.file);
-        }
-        // 3. Generate Incident templates
-        this.logger.info('  Generating incident templates...');
-        const incidentResult = await this.generateIncidentDocs();
-        if (incidentResult.file) {
-            filesCreated.push(incidentResult.file);
-        }
-        // 4. Generate SLA documentation
-        this.logger.info('  Generating SLA docs...');
-        const slaResult = await this.generateSLADocs();
-        if (slaResult.file) {
-            filesCreated.push(slaResult.file);
-        }
-        return {
-            filesCreated,
-            savedFiles: filesCreated, // Alias for consistency
-            runbooksFound: runbookResult.count,
-            monitoringConfigsFound: monitoringResult.count,
-        };
-    }
-    /**
-     * Generate runbooks from hooks and scripts
-     */
-    async generateRunbooks() {
-        const runbooks = [];
-        // Find hook scripts
-        const hookPaths = [
-            path.join(this.projectPath, 'plugins/specweave/hooks'),
-            path.join(this.projectPath, '.specweave/hooks'),
-        ];
-        for (const hookPath of hookPaths) {
-            if (!fs.existsSync(hookPath))
-                continue;
-            const scripts = await glob('**/*.sh', { cwd: hookPath, nodir: true });
-            for (const script of scripts) {
-                const info = this.parseHookScript(path.join(hookPath, script));
-                if (info) {
-                    runbooks.push({
-                        name: info.name,
-                        description: info.description,
-                        type: 'hook',
-                        source: script,
-                        steps: info.steps,
-                    });
-                }
-            }
-        }
-        // Find shell scripts in scripts/ folder
-        const scriptsPath = path.join(this.projectPath, 'scripts');
-        if (fs.existsSync(scriptsPath)) {
-            const scripts = await glob('**/*.sh', { cwd: scriptsPath, nodir: true });
-            for (const script of scripts) {
-                const info = this.parseHookScript(path.join(scriptsPath, script));
-                if (info) {
-                    runbooks.push({
-                        name: info.name,
-                        description: info.description,
-                        type: 'script',
-                        source: `scripts/${script}`,
-                        steps: info.steps,
-                    });
-                }
-            }
-        }
-        // Add standard runbooks based on detected patterns
-        const standardRunbooks = this.generateStandardRunbooks();
-        runbooks.push(...standardRunbooks);
-        // Generate documentation
-        const lines = [
-            '# Operational Runbooks',
-            '',
-            `*Generated: ${new Date().toLocaleDateString()} | Runbooks: ${runbooks.length}*`,
-            '',
-            '## Quick Reference',
-            '',
-            '| Runbook | Type | Description |',
-            '|---------|------|-------------|',
-        ];
-        for (const rb of runbooks) {
-            lines.push(`| [${rb.name}](#${rb.name.toLowerCase().replace(/\s+/g, '-')}) | ${rb.type} | ${rb.description.substring(0, 50)}... |`);
-        }
-        lines.push('', '## Runbook Details', '');
-        for (const rb of runbooks) {
-            lines.push(`### ${rb.name}`, '');
-            lines.push(`**Type**: ${rb.type}`);
-            if (rb.source) {
-                lines.push(`**Source**: \`${rb.source}\``);
-            }
-            lines.push('');
-            lines.push(rb.description, '');
-            if (rb.steps.length > 0) {
-                lines.push('**Steps**:', '');
-                for (let i = 0; i < rb.steps.length; i++) {
-                    lines.push(`${i + 1}. ${rb.steps[i]}`);
-                }
-                lines.push('');
-            }
-        }
-        lines.push('---', `*Last updated: ${new Date().toISOString()}*`);
-        const filePath = path.join(this.opsPath, 'RUNBOOKS.md');
-        fs.writeFileSync(filePath, lines.join('\n'));
-        return { file: filePath, count: runbooks.length };
-    }
-    /**
-     * Generate monitoring documentation
-     */
-    async generateMonitoringDocs() {
-        const monitoringConfigs = [];
-        // Check for common monitoring configurations
-        const prometheusPath = path.join(this.projectPath, 'prometheus.yml');
-        if (fs.existsSync(prometheusPath)) {
-            monitoringConfigs.push({
-                name: 'Prometheus',
-                type: 'metrics',
-                configFile: 'prometheus.yml',
-            });
-        }
-        const grafanaPath = path.join(this.projectPath, 'grafana');
-        if (fs.existsSync(grafanaPath)) {
-            monitoringConfigs.push({
-                name: 'Grafana',
-                type: 'dashboards',
-                configFile: 'grafana/',
-            });
-        }
-        // Check package.json for monitoring dependencies
-        const pkgPath = path.join(this.projectPath, 'package.json');
-        if (fs.existsSync(pkgPath)) {
-            try {
-                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-                const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-                if (deps['prom-client']) {
-                    monitoringConfigs.push({ name: 'Prometheus Client', type: 'metrics' });
-                }
-                if (deps['dd-trace']) {
-                    monitoringConfigs.push({ name: 'Datadog APM', type: 'tracing' });
-                }
-                if (deps['@opentelemetry/api']) {
-                    monitoringConfigs.push({ name: 'OpenTelemetry', type: 'tracing' });
-                }
-                if (deps['newrelic']) {
-                    monitoringConfigs.push({ name: 'New Relic', type: 'apm' });
-                }
-            }
-            catch { /* ignore */ }
-        }
-        // Generate documentation
-        const lines = [
-            '# Monitoring Documentation',
-            '',
-            `*Generated: ${new Date().toLocaleDateString()}*`,
-            '',
-            '## Monitoring Stack',
-            '',
-            '| Tool | Type | Config |',
-            '|------|------|--------|',
-        ];
-        for (const config of monitoringConfigs) {
-            lines.push(`| ${config.name} | ${config.type} | ${config.configFile || '-'} |`);
-        }
-        lines.push('', '## Key Metrics to Monitor', '');
-        lines.push('### Application Metrics', '');
-        lines.push('- Request latency (p50, p95, p99)');
-        lines.push('- Error rate');
-        lines.push('- Request throughput');
-        lines.push('- Active connections');
-        lines.push('');
-        lines.push('### Infrastructure Metrics', '');
-        lines.push('- CPU utilization');
-        lines.push('- Memory usage');
-        lines.push('- Disk I/O');
-        lines.push('- Network throughput');
-        lines.push('');
-        lines.push('### Business Metrics', '');
-        lines.push('- Feature usage rates');
-        lines.push('- User sessions');
-        lines.push('- Transaction volume');
-        lines.push('');
-        lines.push('## Alerting Guidelines', '');
-        lines.push('| Severity | Response Time | Examples |');
-        lines.push('|----------|---------------|----------|');
-        lines.push('| P1 - Critical | 15 min | Service down, data loss |');
-        lines.push('| P2 - High | 1 hour | Degraded performance, partial outage |');
-        lines.push('| P3 - Medium | 4 hours | Non-critical errors, capacity warnings |');
-        lines.push('| P4 - Low | 24 hours | Minor issues, optimization opportunities |');
-        lines.push('');
-        lines.push('---', `*Last updated: ${new Date().toISOString()}*`);
-        const filePath = path.join(this.opsPath, 'MONITORING.md');
-        fs.writeFileSync(filePath, lines.join('\n'));
-        return { file: filePath, count: monitoringConfigs.length };
-    }
-    /**
-     * Generate incident documentation templates
-     */
-    async generateIncidentDocs() {
-        const lines = [
-            '# Incident Management',
-            '',
-            `*Generated: ${new Date().toLocaleDateString()}*`,
-            '',
-            '## Incident Response Process',
-            '',
-            '```mermaid',
-            'graph LR',
-            '    A[Detect] --> B[Assess]',
-            '    B --> C[Triage]',
-            '    C --> D[Investigate]',
-            '    D --> E[Mitigate]',
-            '    E --> F[Resolve]',
-            '    F --> G[Post-mortem]',
-            '```',
-            '',
-            '## Incident Severity Levels',
-            '',
-            '| Level | Description | Response | Examples |',
-            '|-------|-------------|----------|----------|',
-            '| SEV1 | Critical - Complete outage | Immediate, all hands | Service unreachable |',
-            '| SEV2 | Major - Partial outage | < 30 min, on-call | Degraded performance |',
-            '| SEV3 | Minor - Limited impact | < 4 hours | Feature unavailable |',
-            '| SEV4 | Low - Minimal impact | Next business day | Minor bug |',
-            '',
-            '## Incident Template',
-            '',
-            '### Incident Report: [TITLE]',
-            '',
-            '**Date**: YYYY-MM-DD',
-            '**Severity**: SEV[1-4]',
-            '**Duration**: X hours',
-            '**Impact**: [Description of impact]',
-            '',
-            '#### Timeline',
-            '',
-            '| Time | Event |',
-            '|------|-------|',
-            '| HH:MM | Issue detected |',
-            '| HH:MM | Investigation started |',
-            '| HH:MM | Root cause identified |',
-            '| HH:MM | Mitigation applied |',
-            '| HH:MM | Resolved |',
-            '',
-            '#### Root Cause',
-            '',
-            '[Description of root cause]',
-            '',
-            '#### Resolution',
-            '',
-            '[Description of how it was resolved]',
-            '',
-            '#### Action Items',
-            '',
-            '- [ ] Prevent recurrence',
-            '- [ ] Improve detection',
-            '- [ ] Update documentation',
-            '',
-            '## Post-Mortem Process',
-            '',
-            '1. Schedule post-mortem within 48 hours',
-            '2. Gather all participants',
-            '3. Review timeline and facts',
-            '4. Identify root causes (5 Whys)',
-            '5. Define action items',
-            '6. Document and share learnings',
-            '',
-            '---',
-            `*Last updated: ${new Date().toISOString()}*`,
-        ];
-        const filePath = path.join(this.opsPath, 'INCIDENT-HISTORY.md');
-        fs.writeFileSync(filePath, lines.join('\n'));
-        return { file: filePath };
-    }
-    /**
-     * Generate SLA documentation
-     */
-    async generateSLADocs() {
-        const lines = [
-            '# Service Level Agreements (SLA)',
-            '',
-            `*Generated: ${new Date().toLocaleDateString()}*`,
-            '',
-            '## SLA Overview',
-            '',
-            '| Service | Target | Current | Status |',
-            '|---------|--------|---------|--------|',
-            '| Availability | 99.9% | TBD | 🟡 |',
-            '| Response Time (p95) | < 200ms | TBD | 🟡 |',
-            '| Error Rate | < 0.1% | TBD | 🟡 |',
-            '',
-            '## Definitions',
-            '',
-            '### Availability',
-            '',
-            'Percentage of time the service is operational and accessible.',
-            '',
-            '| Target | Monthly Downtime |',
-            '|--------|-----------------|',
-            '| 99.9% | 43.8 minutes |',
-            '| 99.95% | 21.9 minutes |',
-            '| 99.99% | 4.38 minutes |',
-            '',
-            '### Response Time',
-            '',
-            'Time from request receipt to response delivery.',
-            '',
-            '| Percentile | Target |',
-            '|------------|--------|',
-            '| p50 | < 50ms |',
-            '| p95 | < 200ms |',
-            '| p99 | < 500ms |',
-            '',
-            '### Error Rate',
-            '',
-            'Percentage of requests resulting in 5xx errors.',
-            '',
-            '## Error Budget',
-            '',
-            '```',
-            'Monthly Error Budget = (100% - SLA Target) * Total Minutes',
-            '',
-            'For 99.9% SLA:',
-            'Error Budget = 0.1% * 43,200 minutes = 43.2 minutes/month',
-            '```',
-            '',
-            '## Measurement',
-            '',
-            '- **Tool**: [Prometheus/Datadog/etc.]',
-            '- **Dashboard**: [Link to monitoring dashboard]',
-            '- **Reporting**: Monthly SLA report',
-            '',
-            '---',
-            `*Last updated: ${new Date().toISOString()}*`,
-        ];
-        const filePath = path.join(this.opsPath, 'SLA-TRACKING.md');
-        fs.writeFileSync(filePath, lines.join('\n'));
-        return { file: filePath };
-    }
-    // Helper methods
-    parseHookScript(filePath) {
-        try {
-            const content = fs.readFileSync(filePath, 'utf-8');
-            const name = path.basename(filePath, '.sh');
-            // Extract description from first comment block (skip shebang lines)
-            const descMatch = content.match(/^#(?!!)\s*(.+)/m);
-            const description = descMatch ? descMatch[1] : `Script: ${name}`;
-            // Extract major steps from comments
-            const steps = [];
-            const stepMatches = content.match(/^#\s*\d+[\.\)]\s*(.+)/gm);
-            if (stepMatches) {
-                for (const match of stepMatches) {
-                    steps.push(match.replace(/^#\s*\d+[\.\)]\s*/, ''));
-                }
-            }
-            return { name, description, steps };
-        }
-        catch {
-            return null;
-        }
-    }
-    generateStandardRunbooks() {
-        const runbooks = [];
-        // Check for npm project
-        if (fs.existsSync(path.join(this.projectPath, 'package.json'))) {
-            runbooks.push({
-                name: 'Application Restart',
-                description: 'Steps to safely restart the application',
-                type: 'standard',
-                steps: [
-                    'Check current service health',
-                    'Notify stakeholders',
-                    'Stop the service: `npm stop` or `systemctl stop app`',
-                    'Clear cache if needed: `npm cache clean --force`',
-                    'Start the service: `npm start` or `systemctl start app`',
-                    'Verify health: check logs and health endpoint',
-                    'Notify stakeholders of completion',
-                ],
-            });
-            runbooks.push({
-                name: 'Dependency Update',
-                description: 'Process for updating npm dependencies',
-                type: 'standard',
-                steps: [
-                    'Create a new branch: `git checkout -b deps-update`',
-                    'Check for updates: `npm outdated`',
-                    'Update dependencies: `npm update`',
-                    'Run tests: `npm test`',
-                    'Review changes: `git diff package-lock.json`',
-                    'Commit and create PR',
-                ],
-            });
-        }
-        // Check for Docker
-        if (fs.existsSync(path.join(this.projectPath, 'Dockerfile'))) {
-            runbooks.push({
-                name: 'Container Restart',
-                description: 'Steps to restart Docker containers',
-                type: 'standard',
-                steps: [
-                    'Check container status: `docker ps`',
-                    'Stop container: `docker-compose stop` or `docker stop <id>`',
-                    'Remove container (optional): `docker rm <id>`',
-                    'Rebuild if needed: `docker-compose build`',
-                    'Start container: `docker-compose up -d`',
-                    'Verify logs: `docker logs -f <id>`',
-                ],
-            });
-        }
-        // Add cleanup runbook
-        runbooks.push({
-            name: 'Cache Cleanup',
-            description: 'Clear various caches to resolve issues',
-            type: 'standard',
-            steps: [
-                'Clear npm cache: `npm cache clean --force`',
-                'Clear build artifacts: `rm -rf dist/ build/`',
-                'Clear node_modules if needed: `rm -rf node_modules && npm install`',
-                'Clear SpecWeave cache: `rm -rf .specweave/cache/`',
-                'Restart the application',
-            ],
-        });
-        return runbooks;
-    }
-}
-//# sourceMappingURL=ops-generator.js.map

package/dist/src/core/living-docs/operations/ops-generator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ops-generator.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/operations/ops-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/reflect-nudge/aggregator.d.ts

@@ -1,33 +0,0 @@
-/**
- * Reflect-nudge aggregator — groups refinement signals by target skill,
- * applies the ≥3 signal threshold, and ranks by severity × recency.
- *
- * Shared by the session-end nudge (picks the top suggestion) and the
- * `sw:reflect --status` dashboard section (lists everything above threshold).
- *
- * @module core/reflect-nudge/aggregator
- */
-import type { SignalSource } from '../../types/skill-signals.js';
-/** Minimum number of refinement signals a skill needs to surface. */
-export declare const REFINEMENT_SUGGESTION_THRESHOLD = 3;
-/** Per-skill aggregate used by both the nudge and the dashboard. */
-export interface SkillSuggestion {
-    slug: string;
-    totalCount: number;
-    countsBySource: Record<SignalSource, number>;
-    highestSeverity: 'low' | 'medium' | 'high';
-    severityScore: number;
-    lastDetectedAt: string;
-    sampleEvidence: string;
-}
-/**
- * Aggregate signals from disk and return skills meeting the threshold,
- * sorted by severity × recency (descending).
- *
- * `threshold` defaults to {@link REFINEMENT_SUGGESTION_THRESHOLD}. Pass `1`
- * for the nudge path (which wants the top suggestion regardless of total).
- */
-export declare function aggregateSuggestions(signalsFilePath: string, opts?: {
-    threshold?: number;
-}): Promise<SkillSuggestion[]>;
-//# sourceMappingURL=aggregator.d.ts.map

package/dist/src/core/reflect-nudge/aggregator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aggregator.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/aggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAEV,YAAY,EACb,MAAM,8BAA8B,CAAC;AAEtC,qEAAqE;AACrE,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAQD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,MAAM,EACvB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,eAAe,EAAE,CAAC,CAqB5B"}

package/dist/src/core/reflect-nudge/aggregator.js

@@ -1,80 +0,0 @@
-/**
- * Reflect-nudge aggregator — groups refinement signals by target skill,
- * applies the ≥3 signal threshold, and ranks by severity × recency.
- *
- * Shared by the session-end nudge (picks the top suggestion) and the
- * `sw:reflect --status` dashboard section (lists everything above threshold).
- *
- * @module core/reflect-nudge/aggregator
- */
-import { readSignals } from '../skill-signals/reader.js';
-/** Minimum number of refinement signals a skill needs to surface. */
-export const REFINEMENT_SUGGESTION_THRESHOLD = 3;
-const SEVERITY_RANK = {
-    high: 3,
-    medium: 2,
-    low: 1,
-};
-/**
- * Aggregate signals from disk and return skills meeting the threshold,
- * sorted by severity × recency (descending).
- *
- * `threshold` defaults to {@link REFINEMENT_SUGGESTION_THRESHOLD}. Pass `1`
- * for the nudge path (which wants the top suggestion regardless of total).
- */
-export async function aggregateSuggestions(signalsFilePath, opts = {}) {
-    const threshold = opts.threshold ?? REFINEMENT_SUGGESTION_THRESHOLD;
-    const file = await readSignals(signalsFilePath);
-    const refinements = file.signals.filter((s) => s.type === 'refinement');
-    const bySkill = new Map();
-    for (const sig of refinements) {
-        const list = bySkill.get(sig.targetSkill) ?? [];
-        list.push(sig);
-        bySkill.set(sig.targetSkill, list);
-    }
-    const suggestions = [];
-    for (const [slug, signals] of bySkill) {
-        if (signals.length < threshold)
-            continue;
-        suggestions.push(toSuggestion(slug, signals));
-    }
-    return suggestions.sort(compareBySeverityThenRecency);
-}
-function toSuggestion(slug, signals) {
-    const countsBySource = {
-        'judge-llm': 0,
-        rubric: 0,
-        'code-reviewer': 0,
-    };
-    let highestSeverity = 'low';
-    let lastDetectedAt = signals[0].detectedAt;
-    let mostRecent = signals[0];
-    for (const s of signals) {
-        countsBySource[s.source] += 1;
-        if (SEVERITY_RANK[s.severity] > SEVERITY_RANK[highestSeverity]) {
-            highestSeverity = s.severity;
-        }
-        if (s.detectedAt > lastDetectedAt) {
-            lastDetectedAt = s.detectedAt;
-            mostRecent = s;
-        }
-    }
-    return {
-        slug,
-        totalCount: signals.length,
-        countsBySource,
-        highestSeverity,
-        severityScore: SEVERITY_RANK[highestSeverity],
-        lastDetectedAt,
-        sampleEvidence: mostRecent.evidence,
-    };
-}
-function compareBySeverityThenRecency(a, b) {
-    const sev = b.severityScore - a.severityScore;
-    if (sev !== 0)
-        return sev;
-    if (a.lastDetectedAt === b.lastDetectedAt)
-        return 0;
-    return a.lastDetectedAt < b.lastDetectedAt ? 1 : -1;
-}
-//# sourceMappingURL=aggregator.js.map

package/dist/src/core/reflect-nudge/aggregator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"aggregator.js","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/aggregator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/reflect-nudge/eligibility.d.ts

@@ -1,27 +0,0 @@
-/**
- * Nudge eligibility — checks whether the session-end prompt should be
- * shown at /sw:done close time (AC-US3-01, AC-US3-02).
- *
- * @module core/reflect-nudge/eligibility
- */
-import { type SkillSuggestion } from './aggregator.js';
-export interface NudgeEligibility {
-    shouldNudge: boolean;
-    reason: 'disabled' | 'no-signal' | 'has-refinement' | 'has-learning';
-    topRefinement: SkillSuggestion | null;
-    hasHighConfidenceLearning: boolean;
-}
-export interface EligibilityOptions {
-    /** Project root — defaults to cwd. */
-    projectRoot?: string;
-    /** Increment ID, used to scope the learning-window check. */
-    incrementId: string;
-    /** Override the autoNudge config flag (for tests). */
-    autoNudge?: boolean;
-}
-/**
- * Evaluate whether to show the session-end nudge. Never throws; failure
- * to read state is treated as "no signal".
- */
-export declare function checkNudgeEligibility(opts: EligibilityOptions): Promise<NudgeEligibility>;
-//# sourceMappingURL=eligibility.d.ts.map

package/dist/src/core/reflect-nudge/eligibility.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eligibility.d.ts","sourceRoot":"","sources":["../../../../src/core/reflect-nudge/eligibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,CAAC;IACrE,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA2C3B"}