contradiction-mcp 0.1.0

package/dist/domain/entities/source.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export const StandardSourceTypes = [
+    'github',
+    'document',
+    'email',
+    'calendar',
+    'spreadsheet',
+    'database',
+    'website',
+    'crm',
+    'manual',
+];
+export const SourceSchema = z.object({
+    id: z.string().min(1),
+    externalId: z.string().nullable().optional(),
+    type: z.string().min(1),
+    name: z.string().min(1),
+    uri: z.string().nullable().optional(),
+    lastFetchedAt: z.coerce.date().nullable().optional(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+    trustScore: z.number().min(0.0).max(1.0).default(1.0),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+export const CreateSourceInputSchema = z.object({
+    id: z.string().min(1).optional(),
+    externalId: z.string().nullable().optional(),
+    type: z.string().min(1),
+    name: z.string().min(1),
+    uri: z.string().nullable().optional(),
+    lastFetchedAt: z.coerce.date().nullable().optional(),
+    trustScore: z.number().min(0.0).max(1.0).default(1.0).optional(),
+    metadata: z.record(z.string(), z.unknown()).default({}).optional(),
+});
+//# sourceMappingURL=source.js.map

package/dist/domain/entities/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/domain/entities/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,UAAU;IACV,OAAO;IACP,UAAU;IACV,aAAa;IACb,UAAU;IACV,SAAS;IACT,KAAK;IACL,QAAQ;CACA,CAAC;AAkBX,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnE,CAAC,CAAC"}

package/dist/domain/types/common.d.ts

@@ -0,0 +1,46 @@
+export type EntityId = string;
+export type ISODateString = string;
+export interface Timestamps {
+    createdAt: Date;
+    updatedAt?: Date;
+}
+export type JsonValue = string | number | boolean | null | {
+    [key: string]: JsonValue;
+} | JsonValue[];
+export type Metadata = Record<string, unknown>;
+export declare class ContradictionError extends Error {
+    readonly code: string;
+    readonly isOperational: boolean;
+    readonly details?: unknown;
+    constructor(message: string, code?: string, isOperational?: boolean, details?: unknown);
+    toSafeObject(): {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export declare class ValidationError extends ContradictionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class NotFoundError extends ContradictionError {
+    constructor(entityName: string, id: string);
+}
+export declare class DatabaseError extends ContradictionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ConfigurationError extends ContradictionError {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends ContradictionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class AuthorizationError extends ContradictionError {
+    constructor(message: string, details?: unknown);
+}
+export declare class ConnectorError extends ContradictionError {
+    constructor(message: string, details?: unknown);
+}
+export declare function toSafeError(error: unknown): {
+    code: string;
+    message: string;
+};

package/dist/domain/types/common.js

@@ -0,0 +1,74 @@
+export class ContradictionError extends Error {
+    code;
+    isOperational;
+    details;
+    constructor(message, code = 'INTERNAL_ERROR', isOperational = true, details) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        this.isOperational = isOperational;
+        this.details = details;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    toSafeObject() {
+        return {
+            code: this.code,
+            message: this.message,
+            ...(this.details ? { details: this.details } : {}),
+        };
+    }
+}
+export class ValidationError extends ContradictionError {
+    constructor(message, details) {
+        super(message, 'VALIDATION_ERROR', true, details);
+    }
+}
+export class NotFoundError extends ContradictionError {
+    constructor(entityName, id) {
+        super(`${entityName} with id '${id}' not found`, 'NOT_FOUND', true, { entityName, id });
+    }
+}
+export class DatabaseError extends ContradictionError {
+    constructor(message, details) {
+        super(message, 'DATABASE_ERROR', true, details);
+    }
+}
+export class ConfigurationError extends ContradictionError {
+    constructor(message) {
+        super(message, 'CONFIGURATION_ERROR', false);
+    }
+}
+export class AuthenticationError extends ContradictionError {
+    constructor(message, details) {
+        super(message, 'AUTHENTICATION_ERROR', true, details);
+    }
+}
+export class AuthorizationError extends ContradictionError {
+    constructor(message, details) {
+        super(message, 'AUTHORIZATION_ERROR', true, details);
+    }
+}
+export class ConnectorError extends ContradictionError {
+    constructor(message, details) {
+        super(message, 'CONNECTOR_ERROR', true, details);
+    }
+}
+export function toSafeError(error) {
+    if (error instanceof ContradictionError && error.isOperational) {
+        return {
+            code: error.code,
+            message: error.message,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: 'INTERNAL_ERROR',
+            message: error.message,
+        };
+    }
+    return {
+        code: 'UNKNOWN_ERROR',
+        message: String(error),
+    };
+}
+//# sourceMappingURL=common.js.map

package/dist/domain/types/common.js.map

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

package/dist/httpServer.d.ts

@@ -0,0 +1,25 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import { RateLimiter } from './services/rateLimiter.js';
+import { HealthService } from './services/healthService.js';
+export interface HttpServerOptions {
+    server: McpServer;
+    healthService: HealthService;
+    port: number;
+    host: string;
+    apiKey?: string;
+    rateLimiter?: RateLimiter;
+}
+export declare class McpHttpServer {
+    private httpServer;
+    private readonly server;
+    private readonly healthService;
+    private readonly port;
+    private readonly host;
+    private readonly apiKey?;
+    private readonly rateLimiter;
+    private transport;
+    constructor(options: HttpServerOptions);
+    start(): Promise<void>;
+    getPort(): number;
+    stop(): Promise<void>;
+}

package/dist/httpServer.js

@@ -0,0 +1,164 @@
+import http from 'node:http';
+import { NodeStreamableHTTPServerTransport, localhostHostValidation, localhostOriginValidation, } from '@modelcontextprotocol/node';
+import { RateLimiter, RateLimitExceededError } from './services/rateLimiter.js';
+import { globalMetrics } from './services/metricsService.js';
+import { logger } from './utils/logger.js';
+export class McpHttpServer {
+    httpServer = null;
+    server;
+    healthService;
+    port;
+    host;
+    apiKey;
+    rateLimiter;
+    transport = null;
+    constructor(options) {
+        this.server = options.server;
+        this.healthService = options.healthService;
+        this.port = options.port;
+        this.host = options.host;
+        this.apiKey = options.apiKey;
+        this.rateLimiter = options.rateLimiter ?? new RateLimiter({ windowMs: 60000, maxRequests: 60 });
+    }
+    async start() {
+        this.transport = new NodeStreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // stateless Streamable HTTP
+        });
+        await this.server.connect(this.transport);
+        const validateHost = localhostHostValidation();
+        const validateOrigin = localhostOriginValidation();
+        this.httpServer = http.createServer(async (req, res) => {
+            const startTime = performance.now();
+            const clientIp = req.socket.remoteAddress || 'unknown';
+            const url = req.url || '/';
+            // Security Headers
+            res.setHeader('X-Content-Type-Options', 'nosniff');
+            res.setHeader('X-Frame-Options', 'DENY');
+            res.setHeader('Referrer-Policy', 'no-referrer');
+            res.setHeader('Content-Security-Policy', "default-src 'none'");
+            // Localhost validation if binding to loopback
+            if (this.host === '127.0.0.1' || this.host === 'localhost') {
+                if (!validateHost(req, res) || !validateOrigin(req, res)) {
+                    return;
+                }
+            }
+            // Rate Limiting Check
+            try {
+                this.rateLimiter.check(clientIp);
+            }
+            catch (err) {
+                if (err instanceof RateLimitExceededError) {
+                    res.writeHead(429, {
+                        'Content-Type': 'application/json',
+                        'Retry-After': String(err.retryAfterSeconds),
+                    });
+                    res.end(JSON.stringify({ error: err.message, retryAfter: err.retryAfterSeconds }));
+                    return;
+                }
+            }
+            // Authentication Check for remote endpoints
+            if (this.apiKey) {
+                const authHeader = req.headers['authorization'];
+                const apiKeyHeader = req.headers['x-api-key'];
+                const token = apiKeyHeader ||
+                    (authHeader && authHeader.startsWith('Bearer ') ? authHeader.substring(7) : null);
+                if (token !== this.apiKey && url !== '/health' && url !== '/ready') {
+                    res.writeHead(401, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Unauthorized: Invalid or missing API key' }));
+                    return;
+                }
+            }
+            // 1. Health endpoint (Liveness)
+            if (url === '/health' && req.method === 'GET') {
+                try {
+                    const health = await this.healthService.getHealth();
+                    res.writeHead(health.status === 'healthy' ? 200 : 503, {
+                        'Content-Type': 'application/json',
+                    });
+                    res.end(JSON.stringify(health, null, 2));
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    res.writeHead(503, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ status: 'unhealthy', error: msg }));
+                }
+                return;
+            }
+            // 2. Readiness endpoint
+            if (url === '/ready' && req.method === 'GET') {
+                try {
+                    const readiness = this.healthService.getReadiness();
+                    res.writeHead(readiness.status === 'ready' ? 200 : 503, {
+                        'Content-Type': 'application/json',
+                    });
+                    res.end(JSON.stringify(readiness, null, 2));
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    res.writeHead(503, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ status: 'not_ready', error: msg }));
+                }
+                return;
+            }
+            // 3. Metrics endpoint
+            if (url === '/metrics' && req.method === 'GET') {
+                const snapshot = globalMetrics.getSnapshot();
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(snapshot, null, 2));
+                return;
+            }
+            // 4. MCP Streamable HTTP endpoint (/mcp or root)
+            if (url.startsWith('/mcp') || url === '/') {
+                try {
+                    await this.transport.handleRequest(req, res);
+                    const duration = Math.round(performance.now() - startTime);
+                    logger.debug('Handled MCP Streamable HTTP request', { url, durationMs: duration });
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    logger.error('Error handling MCP Streamable HTTP request', { error: msg });
+                    if (!res.headersSent) {
+                        res.writeHead(500, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'Internal server error processing MCP request' }));
+                    }
+                }
+                return;
+            }
+            // 404 for other paths
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: `Not found: ${url}` }));
+        });
+        return new Promise((resolve) => {
+            this.httpServer.listen(this.port, this.host, () => {
+                logger.info(`Contradiction MCP HTTP Server listening at http://${this.host}:${this.port}/mcp`, {
+                    port: this.port,
+                    host: this.host,
+                    authRequired: Boolean(this.apiKey),
+                });
+                resolve();
+            });
+        });
+    }
+    getPort() {
+        const address = this.httpServer?.address();
+        if (address && typeof address === 'object') {
+            return address.port;
+        }
+        return this.port;
+    }
+    async stop() {
+        if (this.httpServer) {
+            if (typeof this.httpServer.closeAllConnections === 'function') {
+                this.httpServer.closeAllConnections();
+            }
+            await new Promise((resolve) => {
+                this.httpServer.close(() => resolve());
+            });
+        }
+        if (this.transport) {
+            await this.transport.close();
+        }
+        logger.info('Contradiction MCP HTTP Server stopped');
+    }
+}
+//# sourceMappingURL=httpServer.js.map

package/dist/httpServer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,94 @@
+import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
+import { config } from './config/env.js';
+import { logger } from './utils/logger.js';
+import { DatabaseManager } from './storage/database.js';
+import { HealthService } from './services/healthService.js';
+import { AnalysisService } from './services/analysisService.js';
+import { DiscoveryService } from './discovery/discoveryService.js';
+import { ConnectorRegistry } from './connectors/connectorRegistry.js';
+import { GitHubClient } from './connectors/github/githubClient.js';
+import { GitHubConnector } from './connectors/github/githubConnector.js';
+import { DocumentConnector } from './connectors/document/documentConnector.js';
+import { WebsiteConnector } from './connectors/website/websiteConnector.js';
+import { SyncService } from './connectors/syncService.js';
+import { createMcpServer } from './server.js';
+async function main() {
+    logger.info('Starting Contradiction MCP server...', {
+        env: config.NODE_ENV,
+        server: config.SERVER_NAME,
+        version: config.SERVER_VERSION,
+    });
+    const dbManager = new DatabaseManager(config.DATABASE_PATH);
+    try {
+        dbManager.initialize();
+    }
+    catch (error) {
+        logger.error('Failed to start server due to database initialization failure', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        process.exit(1);
+    }
+    const healthService = new HealthService(dbManager, config);
+    const analysisService = new AnalysisService(dbManager);
+    const discoveryService = new DiscoveryService(dbManager);
+    // Initialize connector registry and register connectors
+    const connectorRegistry = new ConnectorRegistry();
+    const githubClient = new GitHubClient({ token: config.GITHUB_TOKEN });
+    const githubConnector = new GitHubConnector(githubClient);
+    connectorRegistry.register(githubConnector);
+    const documentConnector = new DocumentConnector();
+    connectorRegistry.register(documentConnector);
+    const websiteConnector = new WebsiteConnector();
+    connectorRegistry.register(websiteConnector);
+    const syncService = new SyncService(dbManager, connectorRegistry, discoveryService);
+    const server = createMcpServer({
+        healthService,
+        analysisService,
+        discoveryService,
+        dbManager,
+        connectorRegistry,
+        syncService,
+        name: config.SERVER_NAME,
+        version: config.SERVER_VERSION,
+    });
+    let httpServer = null;
+    const shutdown = async (signal) => {
+        logger.info(`Received ${signal}, shutting down gracefully...`);
+        try {
+            if (httpServer) {
+                await httpServer.stop();
+            }
+            await server.close();
+            dbManager.close();
+            logger.info('Contradiction MCP server stopped cleanly');
+            process.exit(0);
+        }
+        catch (err) {
+            logger.error('Error during graceful shutdown', { error: String(err) });
+            process.exit(1);
+        }
+    };
+    process.on('SIGINT', () => void shutdown('SIGINT'));
+    process.on('SIGTERM', () => void shutdown('SIGTERM'));
+    if (config.MCP_TRANSPORT === 'http') {
+        const { McpHttpServer } = await import('./httpServer.js');
+        httpServer = new McpHttpServer({
+            server,
+            healthService,
+            port: config.HTTP_PORT,
+            host: config.HTTP_HOST,
+            apiKey: config.API_KEY,
+        });
+        await httpServer.start();
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info('Contradiction MCP server running and listening via stdio transport');
+    }
+}
+main().catch((error) => {
+    logger.error('Fatal error in server process', { error: String(error) });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/intelligence/authorityScorer.d.ts

@@ -0,0 +1,20 @@
+import { Claim } from '../domain/entities/claim.js';
+import { Source } from '../domain/entities/source.js';
+export interface AuthorityScoreBreakdown {
+    roleScore: number;
+    trustScore: number;
+    locationScore: number;
+    directnessScore: number;
+}
+export interface AuthorityScoreResult {
+    score: number;
+    breakdown: AuthorityScoreBreakdown;
+    reasoning: string[];
+}
+export declare class AuthorityScorer {
+    /**
+     * Deterministically calculates an authority score between 0.0 and 1.0 for a claim
+     * based on source role, source trust, document location/type, and directness of evidence.
+     */
+    scoreAuthority(claim: Claim, source?: Source | null): AuthorityScoreResult;
+}

package/dist/intelligence/authorityScorer.js

@@ -0,0 +1,103 @@
+export class AuthorityScorer {
+    /**
+     * Deterministically calculates an authority score between 0.0 and 1.0 for a claim
+     * based on source role, source trust, document location/type, and directness of evidence.
+     */
+    scoreAuthority(claim, source) {
+        const reasoning = [];
+        // 1. Source Role Score (weight: 0.40)
+        let roleScore;
+        const role = (claim.sourceRole || 'unknown').toLowerCase();
+        switch (role) {
+            case 'authoritative':
+                roleScore = 1.0;
+                reasoning.push('Explicit authoritative role designation (score: 1.00)');
+                break;
+            case 'deployment':
+                roleScore = 0.95;
+                reasoning.push('Deployment specification role provides primary operational truth (score: 0.95)');
+                break;
+            case 'configuration':
+                roleScore = 0.9;
+                reasoning.push('Configuration source role indicates runtime authority (score: 0.90)');
+                break;
+            case 'documentation':
+                roleScore = 0.55;
+                reasoning.push('Documentation source role is secondary to operational configuration (score: 0.55)');
+                break;
+            case 'generated':
+                roleScore = 0.45;
+                reasoning.push('Generated or synthetic artifact (score: 0.45)');
+                break;
+            case 'example':
+                roleScore = 0.25;
+                reasoning.push('Example or template code has low production authority (score: 0.25)');
+                break;
+            case 'historical':
+                roleScore = 0.15;
+                reasoning.push('Historical marker significantly degrades authority (score: 0.15)');
+                break;
+            default:
+                roleScore = 0.5;
+                reasoning.push('Default/unknown role score applied (score: 0.50)');
+                break;
+        }
+        // 2. Source Trust Score (weight: 0.25)
+        const trustScore = source?.trustScore ?? 1.0;
+        reasoning.push(`Source '${source?.name || 'unknown'}' trust score: ${trustScore.toFixed(2)}`);
+        // 3. Document Location / Type Heuristic (weight: 0.20)
+        let locationScore;
+        const metadata = claim.metadata || {};
+        const filePath = typeof metadata.filePath === 'string' ? metadata.filePath.toLowerCase() : '';
+        const uri = typeof metadata.uri === 'string' ? metadata.uri.toLowerCase() : '';
+        if (filePath.endsWith('dockerfile') || filePath.includes('.github/workflows')) {
+            locationScore = 0.95;
+            reasoning.push(`Location '${filePath}' is a deployment/CI pipeline spec (score: 0.95)`);
+        }
+        else if (filePath.endsWith('package.json') ||
+            filePath.endsWith('pom.xml') ||
+            filePath.endsWith('cargo.toml')) {
+            locationScore = 0.9;
+            reasoning.push(`Location '${filePath}' is a project manifest specification (score: 0.90)`);
+        }
+        else if (filePath.endsWith('.env') ||
+            filePath.endsWith('.yaml') ||
+            filePath.endsWith('.json')) {
+            locationScore = 0.85;
+            reasoning.push(`Location '${filePath}' is structured configuration (score: 0.85)`);
+        }
+        else if (filePath.endsWith('.md') || filePath.endsWith('.txt') || uri.includes('/docs/')) {
+            locationScore = 0.5;
+            reasoning.push(`Location '${filePath || uri}' is documentation text (score: 0.50)`);
+        }
+        else {
+            locationScore = 0.6;
+            reasoning.push('Generic file location score (score: 0.60)');
+        }
+        // 4. Evidence Directness Score (weight: 0.15)
+        let directnessScore = 0.5;
+        if (metadata.line !== undefined ||
+            (metadata.startLine !== undefined && metadata.endLine !== undefined)) {
+            directnessScore += 0.25;
+            reasoning.push('Exact line provenance provides direct verifiable evidence');
+        }
+        if (typeof metadata.snippet === 'string' && metadata.snippet.trim().length > 0) {
+            directnessScore += 0.25;
+            reasoning.push('Verbatim snippet available');
+        }
+        directnessScore = Math.min(1.0, directnessScore);
+        // Weighted composite authority score
+        const score = Number((roleScore * 0.4 + trustScore * 0.25 + locationScore * 0.2 + directnessScore * 0.15).toFixed(4));
+        return {
+            score,
+            breakdown: {
+                roleScore,
+                trustScore,
+                locationScore,
+                directnessScore,
+            },
+            reasoning,
+        };
+    }
+}
+//# sourceMappingURL=authorityScorer.js.map

package/dist/intelligence/authorityScorer.js.map

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

package/dist/intelligence/entityResolver.d.ts

@@ -0,0 +1,33 @@
+export interface EntityMatchResult {
+    isMatch: boolean;
+    confidence: number;
+    matchType: 'EXACT' | 'NORMALIZED' | 'ALIAS' | 'SUFFIX_PREFIX' | 'URL_HOST' | 'NONE';
+    reason: string;
+    isAmbiguous: boolean;
+}
+export interface CandidateMatch {
+    candidate: string;
+    confidence: number;
+    matchType: string;
+}
+export interface EntityResolverOptions {
+    customAliases?: Record<string, string[]>;
+    minConfidenceThreshold?: number;
+}
+export declare class EntityResolver {
+    private readonly defaultAliases;
+    constructor();
+    private registerDefaultAliases;
+    /**
+     * Canonicalizes an entity name by stripping delimiters, common redundant words, and casing.
+     */
+    normalize(raw: string): string;
+    /**
+     * Compares two entity references across sources.
+     */
+    resolveEntityMatch(entityA: string, entityB: string, options?: EntityResolverOptions): EntityMatchResult;
+    /**
+     * Evaluates query against multiple candidate entities, sorting by confidence.
+     */
+    findMatches(query: string, candidates: string[], options?: EntityResolverOptions): CandidateMatch[];
+}