specforge-mcp 0.1.0

package/dist/engine/context-merger.js

@@ -0,0 +1,197 @@
+// engine/context-merger.ts — Context ingestion business logic (SPEC-036)
+// Pure functions: detectMissingAreas, buildRequestPrompt, mergeContext, detectConflicts.
+// ---------------------------------------------------------------------------
+// Missing area detection
+// ---------------------------------------------------------------------------
+/** ArchitecturePattern values that indicate "not yet known". */
+const UNKNOWN_ARCH_PATTERNS = new Set(['custom']);
+/**
+ * Inspect the current knowledge and return a list of areas that need
+ * additional documentation from the user.
+ */
+export function detectMissingAreas(knowledge) {
+    const missing = [];
+    if (knowledge.language === 'unknown') {
+        missing.push('programming language / tech stack');
+    }
+    // 'custom' is the closest sentinel for "undetected architecture"
+    if (UNKNOWN_ARCH_PATTERNS.has(knowledge.architecture.primary)) {
+        missing.push('architecture diagram / design decisions');
+    }
+    if (knowledge.architecture.boundaries.length === 0) {
+        missing.push('module boundaries / bounded contexts');
+    }
+    if (knowledge.apiContracts.length === 0) {
+        missing.push('API contracts (REST, GraphQL, etc.)');
+    }
+    const hasEntities = knowledge.conventions.entities !== undefined || knowledge.conventions.models !== undefined;
+    if (!hasEntities) {
+        missing.push('data models / entities');
+    }
+    if (knowledge.externalServices.length === 0) {
+        missing.push('third-party integrations / external services');
+    }
+    if (knowledge.environments.length === 0) {
+        missing.push('deployment environments');
+    }
+    return missing;
+}
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+function detectAgentStyle(conventions) {
+    const keys = Object.keys(conventions);
+    if (keys.some((k) => k.includes('claude'))) {
+        return 'claude-code';
+    }
+    if (keys.some((k) => k.includes('cursor'))) {
+        return 'cursor';
+    }
+    if (keys.some((k) => k.includes('windsurf'))) {
+        return 'windsurf';
+    }
+    return 'generic';
+}
+/**
+ * Build an agent-idiomatic prompt that asks the user to share reference docs.
+ * The prompt explains what types of files are accepted and what areas need coverage.
+ */
+export function buildRequestPrompt(missingAreas, knowledge) {
+    const style = detectAgentStyle(knowledge.conventions);
+    const areasList = missingAreas.map((a) => `  - ${a}`).join('\n');
+    const formatNote = 'You can share any format I can read: images (screenshots, wireframes), ' +
+        'PDFs, Word/Excel documents, Markdown files, plain text, or URLs.';
+    switch (style) {
+        case 'claude-code':
+            return [
+                'I need some reference documentation to understand your project better.',
+                '',
+                'Please attach or paste any of the following:',
+                areasList,
+                '',
+                formatNote,
+                '',
+                'Once you share these documents, I will extract the relevant knowledge ' +
+                    'and store it so you never need to re-explain it.',
+            ].join('\n');
+        case 'cursor':
+        case 'windsurf':
+            return [
+                'To work with your project effectively, I need some context documents.',
+                '',
+                'Please open and attach from your workspace:',
+                areasList,
+                '',
+                formatNote,
+                '',
+                'After you share them, I will persist the extracted knowledge for future sessions.',
+            ].join('\n');
+        case 'generic':
+        default:
+            return [
+                'To get started, could you share some documentation about your project?',
+                '',
+                'Things that would help:',
+                areasList,
+                '',
+                formatNote,
+            ].join('\n');
+    }
+}
+// ---------------------------------------------------------------------------
+// Conflict detection
+// ---------------------------------------------------------------------------
+/**
+ * Compare auto-detected knowledge with contributed context and return
+ * a list of conflicting fields that the agent must resolve.
+ */
+export function detectConflicts(existing, contributed) {
+    const conflicts = [];
+    // Detect API contract type conflicts.
+    // ProjectKnowledge.apiContracts uses 'openapi'|'graphql'|'trpc'|'grpc'|'rest-informal'.
+    // ContributedContext.apiContracts uses 'rest'|'graphql'|'trpc'|'grpc'|'websocket'.
+    // We compare as strings to allow cross-union comparison without type errors.
+    if (contributed.apiContracts && contributed.apiContracts.length > 0) {
+        const existingTypes = existing.apiContracts.map((c) => c.type);
+        for (const contrib of contributed.apiContracts) {
+            const contribType = contrib.type;
+            if (existingTypes.length > 0 && !existingTypes.includes(contribType)) {
+                conflicts.push({
+                    field: 'apiContracts.type',
+                    autoDetectedValue: existingTypes.join(', '),
+                    contributedValue: contribType,
+                    recommendation: `Auto-detection found ${existingTypes.join(', ')} API contracts but the ` +
+                        `contributed context mentions ${contribType}. ` +
+                        `Verify which is authoritative and update init_project if needed.`,
+                });
+                break; // One conflict per field is enough
+            }
+        }
+    }
+    // Architecture primary pattern conflict.
+    // Skip when architecture is 'custom' (undetected) — no conflict there.
+    if (contributed.architectureNotes && !UNKNOWN_ARCH_PATTERNS.has(existing.architecture.primary)) {
+        const notes = contributed.architectureNotes.toLowerCase();
+        const detected = existing.architecture.primary.toLowerCase();
+        // Simple heuristic: if the notes mention a different prominent pattern
+        const patterns = ['hexagonal', 'clean', 'layered', 'microservices', 'monolith', 'event-driven'];
+        for (const pattern of patterns) {
+            if (notes.includes(pattern) && !detected.includes(pattern)) {
+                conflicts.push({
+                    field: 'architecture.primary',
+                    autoDetectedValue: existing.architecture.primary,
+                    contributedValue: pattern,
+                    recommendation: `Auto-detection classified the architecture as "${existing.architecture.primary}" ` +
+                        `but the contributed notes mention "${pattern}". ` +
+                        `Review and consider re-running init_project with additional context.`,
+                });
+                break;
+            }
+        }
+    }
+    return conflicts;
+}
+// ---------------------------------------------------------------------------
+// Context merge
+// ---------------------------------------------------------------------------
+/**
+ * Merge contributed context into existing knowledge.
+ * Auto-detected values are NEVER overwritten — conflicts are reported instead.
+ * Returns the list of fields that were successfully merged and any conflicts found.
+ */
+export function mergeContext(existing, contributed) {
+    const merged = [];
+    const conflicts = detectConflicts(existing, contributed);
+    // Entities
+    if (contributed.entities && contributed.entities.length > 0) {
+        merged.push('entities');
+    }
+    // API contracts: only add types not already detected
+    if (contributed.apiContracts && contributed.apiContracts.length > 0) {
+        const hasConflict = conflicts.some((c) => c.field === 'apiContracts.type');
+        if (!hasConflict) {
+            merged.push('apiContracts');
+        }
+    }
+    // Architecture notes: only if no primary pattern already detected
+    if (contributed.architectureNotes) {
+        const hasConflict = conflicts.some((c) => c.field === 'architecture.primary');
+        if (!hasConflict) {
+            merged.push('architectureNotes');
+        }
+    }
+    if (contributed.techDecisions && contributed.techDecisions.length > 0) {
+        merged.push('techDecisions');
+    }
+    if (contributed.userFlows && contributed.userFlows.length > 0) {
+        merged.push('userFlows');
+    }
+    if (contributed.nonFunctionalRequirements && contributed.nonFunctionalRequirements.length > 0) {
+        merged.push('nonFunctionalRequirements');
+    }
+    if (contributed.additionalContext) {
+        merged.push('additionalContext');
+    }
+    return { merged, conflicts };
+}
+//# sourceMappingURL=context-merger.js.map

package/dist/engine/context-merger.js.map

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

package/dist/engine/contradiction-detector.d.ts

@@ -0,0 +1,16 @@
+import type { ConflictReport, Contradiction, SpecAnalysisInput } from '../types/index.js';
+export type { SpecAnalysisInput as SpecInput };
+/**
+ * Detect semantic contradictions between a list of specs.
+ * Each spec is compared against every other spec for all known patterns.
+ */
+export declare function detectContradictions(specs: SpecAnalysisInput[]): Contradiction[];
+/**
+ * Build a full ConflictReport from a list of specs.
+ */
+export declare function buildConflictReport(specs: SpecAnalysisInput[]): ConflictReport;
+/**
+ * Format a ConflictReport as a markdown string.
+ */
+export declare function formatConflictReport(report: ConflictReport): string;
+//# sourceMappingURL=contradiction-detector.d.ts.map

package/dist/engine/contradiction-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction-detector.d.ts","sourceRoot":"","sources":["../../src/engine/contradiction-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EAEb,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,IAAI,SAAS,EAAE,CAAC;AAkF/C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,aAAa,EAAE,CA6ChF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,cAAc,CAwB9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyBnE"}

package/dist/engine/contradiction-detector.js

@@ -0,0 +1,158 @@
+// ---------------------------------------------------------------------------
+// Contradiction patterns
+// ---------------------------------------------------------------------------
+const CONTRADICTION_PATTERNS = [
+    {
+        name: 'offline-vs-realtime',
+        sideA: ['offline', 'offline-first', 'no internet', 'without internet', 'disconnected'],
+        sideB: ['real-time', 'realtime', 'online', 'sync', 'synchronization', 'live', 'streaming'],
+        severity: 'blocker',
+        descriptionTemplate: '{specA} requires offline capability while {specB} requires real-time synchronization — these are mutually exclusive without explicit conflict resolution.',
+        recommendation: 'Define a clear synchronization strategy: optimistic updates with eventual consistency, or restrict real-time features to connected mode only.',
+    },
+    {
+        name: 'sync-vs-async',
+        sideA: ['synchronous', 'blocking', 'sequential', 'serial'],
+        sideB: ['asynchronous', 'async', 'non-blocking', 'concurrent', 'parallel', 'event-driven'],
+        severity: 'warning',
+        descriptionTemplate: '{specA} implies synchronous execution while {specB} implies asynchronous processing — mixing these requires careful interface design.',
+        recommendation: 'Decide on a unified execution model. If both are needed, document clearly which parts are sync vs async and add adapters at boundaries.',
+    },
+    {
+        name: 'simple-vs-complex',
+        sideA: ['simple', 'minimal', 'lightweight', 'basic', 'mvp'],
+        sideB: ['complex', 'enterprise', 'advanced', 'comprehensive', 'full-featured', 'sophisticated'],
+        severity: 'warning',
+        descriptionTemplate: '{specA} targets simplicity/MVP while {specB} targets enterprise complexity — these have opposing design priorities.',
+        recommendation: 'Clarify which spec defines the North Star. Consider a phased approach: start minimal, extend to complex in a later iteration.',
+    },
+    {
+        name: 'performance-vs-security',
+        sideA: ['fast', 'performance', 'speed', 'low latency', 'optimized', 'cache'],
+        sideB: ['security', 'encrypted', 'encryption', 'audit', 'compliant', 'zero-trust'],
+        severity: 'warning',
+        descriptionTemplate: '{specA} prioritizes performance while {specB} prioritizes security — these often create architectural tradeoffs.',
+        recommendation: 'Define explicit performance budgets for security operations. Benchmark encryption overhead. Consider hardware acceleration for crypto.',
+    },
+    {
+        name: 'local-vs-cloud',
+        sideA: ['local', 'on-premise', 'self-hosted', 'air-gapped', 'desktop', 'embedded'],
+        sideB: ['cloud', 'remote', 'saas', 'hosted', 'serverless', 'managed service'],
+        severity: 'blocker',
+        descriptionTemplate: '{specA} requires local/on-premise deployment while {specB} assumes cloud/remote infrastructure — these are incompatible deployment targets.',
+        recommendation: 'Choose a single deployment model or build explicit abstraction layers that support both. Hybrid architectures significantly increase complexity.',
+    },
+];
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check if content contains any keyword from the provided list.
+ */
+function containsAny(content, keywords) {
+    const lower = content.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw.toLowerCase()));
+}
+/**
+ * Build a contradiction description from a pattern and two spec IDs.
+ */
+function buildDescription(template, specA, specB) {
+    return template.replace('{specA}', specA).replace('{specB}', specB);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect semantic contradictions between a list of specs.
+ * Each spec is compared against every other spec for all known patterns.
+ */
+export function detectContradictions(specs) {
+    if (specs.length < 2) {
+        return [];
+    }
+    const contradictions = [];
+    for (let i = 0; i < specs.length; i++) {
+        for (let j = i + 1; j < specs.length; j++) {
+            const specA = specs[i];
+            const specB = specs[j];
+            // Guard — TypeScript noUncheckedIndexedAccess
+            if (!specA || !specB) {
+                continue;
+            }
+            const combinedA = `${specA.title} ${specA.content}`;
+            const combinedB = `${specB.title} ${specB.content}`;
+            for (const pattern of CONTRADICTION_PATTERNS) {
+                const aHasSideA = containsAny(combinedA, pattern.sideA);
+                const bHasSideB = containsAny(combinedB, pattern.sideB);
+                const aHasSideB = containsAny(combinedA, pattern.sideB);
+                const bHasSideA = containsAny(combinedB, pattern.sideA);
+                if ((aHasSideA && bHasSideB) || (aHasSideB && bHasSideA)) {
+                    // Determine which spec "owns" which side for accurate description
+                    const [ownerA, ownerB] = aHasSideA && bHasSideB ? [specA.id, specB.id] : [specB.id, specA.id];
+                    contradictions.push({
+                        specA: ownerA,
+                        specB: ownerB,
+                        description: buildDescription(pattern.descriptionTemplate, ownerA, ownerB),
+                        severity: pattern.severity,
+                        recommendation: pattern.recommendation,
+                        pattern: pattern.name,
+                    });
+                }
+            }
+        }
+    }
+    return contradictions;
+}
+/**
+ * Build a full ConflictReport from a list of specs.
+ */
+export function buildConflictReport(specs) {
+    const contradictions = detectContradictions(specs);
+    const specsWithConflicts = [...new Set(contradictions.flatMap((c) => [c.specA, c.specB]))];
+    const blockerCount = contradictions.filter((c) => c.severity === 'blocker').length;
+    const warningCount = contradictions.filter((c) => c.severity === 'warning').length;
+    let summary;
+    if (contradictions.length === 0) {
+        summary = 'No contradictions detected between specs.';
+    }
+    else if (blockerCount > 0) {
+        summary = `${contradictions.length} contradiction(s) found — ${blockerCount} blocker(s) require immediate resolution before implementation.`;
+    }
+    else {
+        summary = `${contradictions.length} contradiction(s) found — ${warningCount} warning(s) can coexist with tradeoffs but should be documented.`;
+    }
+    return {
+        contradictions,
+        summary,
+        specsWithConflicts,
+        blockerCount,
+        warningCount,
+    };
+}
+/**
+ * Format a ConflictReport as a markdown string.
+ */
+export function formatConflictReport(report) {
+    if (report.contradictions.length === 0) {
+        return `## Contradiction Report\n\nNo contradictions detected between specs.`;
+    }
+    const lines = [
+        `## Contradiction Report`,
+        ``,
+        `**Summary:** ${report.summary}`,
+        `**Blockers:** ${report.blockerCount} | **Warnings:** ${report.warningCount}`,
+        `**Specs with conflicts:** ${report.specsWithConflicts.join(', ')}`,
+        ``,
+        `---`,
+        ``,
+    ];
+    for (const c of report.contradictions) {
+        const icon = c.severity === 'blocker' ? '[BLOCKER]' : '[WARNING]';
+        lines.push(`### ${icon} ${c.pattern} — ${c.specA} vs ${c.specB}`);
+        lines.push(`**Description:** ${c.description}`);
+        lines.push(`**Recommendation:** ${c.recommendation}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=contradiction-detector.js.map

package/dist/engine/contradiction-detector.js.map

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

package/dist/engine/decision-store.d.ts

@@ -0,0 +1,17 @@
+import type { Decision, DecisionCategory } from '../types/index.js';
+/**
+ * Find active decisions that may conflict with a proposed change.
+ * Uses keyword overlap between the proposal and decision.what + decision.why.
+ */
+export declare function findConflictingDecisions(proposal: string, decisions: Decision[]): Decision[];
+/**
+ * Basic full-text search in decision.what and decision.why.
+ * Returns decisions containing any token from the query.
+ */
+export declare function searchDecisions(query: string, decisions: Decision[]): Decision[];
+/**
+ * Infer the most likely DecisionCategory from the content of a decision.
+ * Falls back to 'process' when no keywords match.
+ */
+export declare function categorizeDecision(what: string, why: string): DecisionCategory;
+//# sourceMappingURL=decision-store.d.ts.map

package/dist/engine/decision-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-store.d.ts","sourceRoot":"","sources":["../../src/engine/decision-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA4FpE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAW5F;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAUhF;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAuB9E"}

package/dist/engine/decision-store.js

@@ -0,0 +1,156 @@
+// engine/decision-store.ts — Search and conflict detection for decisions (SPEC-040)
+// Pure functions — no I/O. All persistence is in storage/decision-store.ts.
+// ---------------------------------------------------------------------------
+// Keyword maps
+// ---------------------------------------------------------------------------
+const STACK_KEYWORDS = [
+    'react',
+    'vue',
+    'angular',
+    'svelte',
+    'next',
+    'nuxt',
+    'remix',
+    'node',
+    'deno',
+    'bun',
+    'python',
+    'java',
+    'kotlin',
+    'swift',
+    'flutter',
+    'expo',
+    'typescript',
+    'javascript',
+    'rust',
+    'go',
+    'postgres',
+    'mysql',
+    'mongodb',
+    'redis',
+    'sqlite',
+];
+const ARCHITECTURE_KEYWORDS = [
+    'monolith',
+    'microservice',
+    'monorepo',
+    'serverless',
+    'event-driven',
+    'cqrs',
+    'ddd',
+    'hexagonal',
+    'clean architecture',
+    'layered',
+    'rest',
+    'graphql',
+    'grpc',
+    'message queue',
+    'kafka',
+    'rabbitmq',
+];
+const UX_KEYWORDS = [
+    'design system',
+    'ui',
+    'ux',
+    'component library',
+    'accessibility',
+    'dark mode',
+    'mobile first',
+    'responsive',
+    'navigation',
+    'routing',
+    'animation',
+    'form',
+    'layout',
+    'typography',
+];
+const BUSINESS_KEYWORDS = [
+    'pricing',
+    'billing',
+    'subscription',
+    'freemium',
+    'enterprise',
+    'compliance',
+    'gdpr',
+    'hipaa',
+    'sla',
+    'support plan',
+    'revenue',
+    'launch date',
+    'mvp',
+    'rollout',
+    'market',
+];
+// ---------------------------------------------------------------------------
+// findConflictingDecisions
+// ---------------------------------------------------------------------------
+/**
+ * Find active decisions that may conflict with a proposed change.
+ * Uses keyword overlap between the proposal and decision.what + decision.why.
+ */
+export function findConflictingDecisions(proposal, decisions) {
+    const proposalWords = tokenize(proposal);
+    return decisions.filter((d) => {
+        if (d.status !== 'active') {
+            return false;
+        }
+        const decisionWords = tokenize(`${d.what} ${d.why}`);
+        const overlap = proposalWords.filter((w) => decisionWords.includes(w));
+        return overlap.length >= 2;
+    });
+}
+// ---------------------------------------------------------------------------
+// searchDecisions
+// ---------------------------------------------------------------------------
+/**
+ * Basic full-text search in decision.what and decision.why.
+ * Returns decisions containing any token from the query.
+ */
+export function searchDecisions(query, decisions) {
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0) {
+        return [];
+    }
+    return decisions.filter((d) => {
+        const text = `${d.what} ${d.why} ${d.alternatives.join(' ')}`.toLowerCase();
+        return queryTokens.some((token) => text.includes(token));
+    });
+}
+// ---------------------------------------------------------------------------
+// categorizeDecision
+// ---------------------------------------------------------------------------
+/**
+ * Infer the most likely DecisionCategory from the content of a decision.
+ * Falls back to 'process' when no keywords match.
+ */
+export function categorizeDecision(what, why) {
+    const text = `${what} ${why}`.toLowerCase();
+    const stackScore = STACK_KEYWORDS.filter((kw) => text.includes(kw)).length;
+    const archScore = ARCHITECTURE_KEYWORDS.filter((kw) => text.includes(kw)).length;
+    const uxScore = UX_KEYWORDS.filter((kw) => text.includes(kw)).length;
+    const businessScore = BUSINESS_KEYWORDS.filter((kw) => text.includes(kw)).length;
+    const max = Math.max(stackScore, archScore, uxScore, businessScore);
+    if (max === 0) {
+        return 'process';
+    }
+    if (archScore === max) {
+        return 'architecture';
+    }
+    if (stackScore === max) {
+        return 'stack';
+    }
+    if (uxScore === max) {
+        return 'ux';
+    }
+    return 'business';
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length >= 3);
+}
+//# sourceMappingURL=decision-store.js.map

package/dist/engine/decision-store.js.map

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

package/dist/engine/dep-auditor/abandonment-data.d.ts

@@ -0,0 +1,4 @@
+import type { DepAbandonedInfo, DepAuditEntry } from '../../types/index.js';
+export declare function getAbandonedInfo(name: string): DepAbandonedInfo;
+export declare function classifyEntry(entry: DepAuditEntry): 'critical' | 'warning' | 'clean';
+//# sourceMappingURL=abandonment-data.d.ts.map

package/dist/engine/dep-auditor/abandonment-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandonment-data.d.ts","sourceRoot":"","sources":["../../../src/engine/dep-auditor/abandonment-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAgB5E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAW/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAapF"}

package/dist/engine/dep-auditor/abandonment-data.js

@@ -0,0 +1,37 @@
+// Heuristic abandonment registry — no npm registry calls.
+const KNOWN_ABANDONED = {
+    request: { months: 60, alternative: 'axios or native fetch' },
+    gulp: { months: 48, alternative: 'vite or esbuild' },
+    grunt: { months: 72, alternative: 'vite or esbuild' },
+    bower: { months: 84, alternative: 'npm workspaces' },
+    tslint: { months: 60, alternative: 'eslint with typescript-eslint' },
+    'babel-eslint': { months: 60, alternative: '@babel/eslint-parser or typescript-eslint' },
+    moment: { months: 24, alternative: 'dayjs or date-fns (moment in maintenance mode)' },
+    'node-uuid': { months: 84, alternative: 'uuid (v9+)' },
+    'uglify-js': { months: 48, alternative: 'esbuild or terser' },
+    coffeescript: { months: 60, alternative: 'TypeScript' },
+};
+export function getAbandonedInfo(name) {
+    const entry = KNOWN_ABANDONED[name];
+    if (!entry) {
+        return { isAbandoned: false, reason: 'No abandonment signals detected.' };
+    }
+    return {
+        isAbandoned: true,
+        lastReleaseAge: entry.months,
+        reason: `Package has had no meaningful release in ~${entry.months} months and is considered deprecated.`,
+        suggestedAlternative: entry.alternative,
+    };
+}
+export function classifyEntry(entry) {
+    const hasCriticalVuln = entry.vulns.some((v) => v.severity === 'critical' || v.severity === 'high');
+    const hasLicenseIssue = entry.license.compatibility === 'critical';
+    if (hasCriticalVuln || hasLicenseIssue || entry.abandoned.isAbandoned) {
+        return hasCriticalVuln || hasLicenseIssue ? 'critical' : 'warning';
+    }
+    const hasWarning = entry.vulns.some((v) => v.severity === 'medium' || v.severity === 'low') ||
+        entry.license.compatibility === 'warning' ||
+        entry.license.compatibility === 'unknown';
+    return hasWarning ? 'warning' : 'clean';
+}
+//# sourceMappingURL=abandonment-data.js.map

package/dist/engine/dep-auditor/abandonment-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandonment-data.js","sourceRoot":"","sources":["../../../src/engine/dep-auditor/abandonment-data.ts"],"names":[],"mappings":"AAGA,0DAA0D;AAC1D,MAAM,eAAe,GAA6D;IAChF,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE;IAC7D,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;IACpD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE;IACrD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACpD,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE;IACpE,cAAc,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE;IACxF,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACrF,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;IACtD,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE;IAC7D,YAAY,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE;CACxD,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC;IAC5E,CAAC;IACD,OAAO;QACL,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,KAAK,CAAC,MAAM;QAC5B,MAAM,EAAE,6CAA6C,KAAK,CAAC,MAAM,uCAAuC;QACxG,oBAAoB,EAAE,KAAK,CAAC,WAAW;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM,CAC1D,CAAC;IACF,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,KAAK,UAAU,CAAC;IACnE,IAAI,eAAe,IAAI,eAAe,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QACtE,OAAO,eAAe,IAAI,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,CAAC;IACD,MAAM,UAAU,GACd,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC;QACxE,KAAK,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;QACzC,KAAK,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC;IAC5C,OAAO,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1C,CAAC"}