@aibuildinfra/proofgraph 1.0.0

package/dist/engine/graphTraversal.js

@@ -0,0 +1,74 @@
+/**
+ * ProofGraph Relationship Traversal & Path Discovery Engine
+ */
+export class GraphTraversalEngine {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    findRelationships(entityId, relationshipType, depth = 2) {
+        const origin = this.store.getEntity(entityId);
+        const filter = relationshipType ? [relationshipType.toUpperCase()] : undefined;
+        const traversal = this.store.traverse(entityId, {
+            maxDepth: depth,
+            relationshipFilter: filter,
+        });
+        const direct = this.store.getRelationships(entityId, relationshipType);
+        return {
+            origin,
+            direct_relationships: direct,
+            traversal_nodes: traversal.nodes,
+            traversal_edges: traversal.edges,
+        };
+    }
+    explainConnection(sourceEntityId, targetEntityId) {
+        const fromEntity = this.store.getEntity(sourceEntityId);
+        const toEntity = this.store.getEntity(targetEntityId);
+        if (!fromEntity || !toEntity)
+            return null;
+        const traversal = this.store.traverse(sourceEntityId, {
+            maxDepth: 3,
+            targetId: targetEntityId,
+        });
+        if (traversal.paths.length === 0) {
+            return {
+                from_entity: fromEntity,
+                to_entity: toEntity,
+                hops: 0,
+                path_sequence: [],
+                relationships: [],
+                connecting_evidence: [],
+                summary: `No direct or 3-hop relationship path found between ${fromEntity.name} and ${toEntity.name}.`,
+            };
+        }
+        const shortestPath = traversal.paths[0];
+        const connectingEvidence = [];
+        for (const edge of shortestPath.edges) {
+            if (edge.evidence_ids) {
+                for (const evId of edge.evidence_ids) {
+                    const ev = this.store.getEvidence(evId);
+                    if (ev)
+                        connectingEvidence.push(ev);
+                }
+            }
+        }
+        // Build human-readable narrative
+        const steps = [];
+        for (let i = 0; i < shortestPath.edges.length; i++) {
+            const edge = shortestPath.edges[i];
+            const src = this.store.getEntity(edge.source_id)?.name || edge.source_id;
+            const tgt = this.store.getEntity(edge.target_id)?.name || edge.target_id;
+            steps.push(`${src} --[${edge.relationship}]--> ${tgt}`);
+        }
+        return {
+            from_entity: fromEntity,
+            to_entity: toEntity,
+            hops: shortestPath.edges.length,
+            path_sequence: shortestPath.path,
+            relationships: shortestPath.edges,
+            connecting_evidence: connectingEvidence,
+            summary: steps.join(' THEN '),
+        };
+    }
+}
+//# sourceMappingURL=graphTraversal.js.map

package/dist/engine/graphTraversal.js.map

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

package/dist/engine/resolver.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ProofGraph Entity Resolution Engine
+ * Multi-signal entity resolution without false-positive merges
+ */
+import { Entity, EntityResolutionCandidate } from '../types/index.js';
+import { GraphStore } from '../storage/graphStore.js';
+export declare function jaroWinklerSimilarity(s1: string, s2: string): number;
+export declare function normalizeSlug(text: string): string;
+export declare class EntityResolver {
+    private store;
+    constructor(store: GraphStore);
+    resolve(query: {
+        name?: string;
+        domain?: string;
+        github?: string;
+        npm?: string;
+        email?: string;
+    }): EntityResolutionCandidate[];
+    findCanonical(query: string): Entity | undefined;
+}

package/dist/engine/resolver.js

@@ -0,0 +1,168 @@
+/**
+ * ProofGraph Entity Resolution Engine
+ * Multi-signal entity resolution without false-positive merges
+ */
+export function jaroWinklerSimilarity(s1, s2) {
+    const str1 = s1.toLowerCase().trim();
+    const str2 = s2.toLowerCase().trim();
+    if (str1 === str2)
+        return 1.0;
+    if (!str1.length || !str2.length)
+        return 0.0;
+    const matchDistance = Math.floor(Math.max(str1.length, str2.length) / 2) - 1;
+    const str1Matches = new Array(str1.length).fill(false);
+    const str2Matches = new Array(str2.length).fill(false);
+    let matches = 0;
+    let transpositions = 0;
+    for (let i = 0; i < str1.length; i++) {
+        const start = Math.max(0, i - matchDistance);
+        const end = Math.min(i + matchDistance + 1, str2.length);
+        for (let j = start; j < end; j++) {
+            if (str2Matches[j])
+                continue;
+            if (str1[i] !== str2[j])
+                continue;
+            str1Matches[i] = true;
+            str2Matches[j] = true;
+            matches++;
+            break;
+        }
+    }
+    if (matches === 0)
+        return 0.0;
+    let k = 0;
+    for (let i = 0; i < str1.length; i++) {
+        if (!str1Matches[i])
+            continue;
+        while (!str2Matches[k])
+            k++;
+        if (str1[i] !== str2[k])
+            transpositions++;
+        k++;
+    }
+    const jaro = (matches / str1.length + matches / str2.length + (matches - transpositions / 2) / matches) / 3.0;
+    // Prefix scale for Winkler
+    let prefix = 0;
+    for (let i = 0; i < Math.min(4, Math.min(str1.length, str2.length)); i++) {
+        if (str1[i] === str2[i])
+            prefix++;
+        else
+            break;
+    }
+    return jaro + prefix * 0.1 * (1 - jaro);
+}
+export function normalizeSlug(text) {
+    return text
+        .toLowerCase()
+        .replace(/https?:\/\//g, '')
+        .replace(/[^\w\s-]/g, '')
+        .replace(/[\s_-]+/g, '')
+        .trim();
+}
+export class EntityResolver {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    resolve(query) {
+        const allEntities = this.store.getAllEntities();
+        const candidates = [];
+        const targetName = query.name || '';
+        const normTargetName = normalizeSlug(targetName);
+        const targetDomain = query.domain ? query.domain.toLowerCase().replace(/^www\./, '') : '';
+        const targetGithub = query.github ? query.github.toLowerCase() : '';
+        const targetNpm = query.npm ? query.npm.toLowerCase() : '';
+        for (const entity of allEntities) {
+            // 1. Name Signal
+            let maxNameScore = 0;
+            const entityNames = [entity.name, ...entity.aliases];
+            for (const name of entityNames) {
+                if (name.toLowerCase() === targetName.toLowerCase()) {
+                    maxNameScore = 1.0;
+                    break;
+                }
+                const normEntityName = normalizeSlug(name);
+                if (normEntityName === normTargetName && normTargetName.length > 2) {
+                    maxNameScore = Math.max(maxNameScore, 0.96);
+                }
+                const sim = jaroWinklerSimilarity(name, targetName);
+                maxNameScore = Math.max(maxNameScore, sim);
+            }
+            // 2. Domain Signal
+            let domainScore = 0;
+            const entityUrl = entity.canonical_url || entity.metadata?.domain || '';
+            if (targetDomain && entityUrl) {
+                const cleanEntityDomain = entityUrl.toLowerCase().replace(/^https?:\/\//, '').replace(/^www\./, '').split('/')[0];
+                if (cleanEntityDomain === targetDomain) {
+                    domainScore = 1.0;
+                }
+                else if (cleanEntityDomain.includes(targetDomain) || targetDomain.includes(cleanEntityDomain)) {
+                    domainScore = 0.8;
+                }
+            }
+            // 3. GitHub Signal
+            let githubScore = 0;
+            const entityGithub = entity.metadata?.github || entity.metadata?.github_org || '';
+            if (targetGithub && entityGithub) {
+                if (entityGithub.toLowerCase().includes(targetGithub) || targetGithub.includes(entityGithub.toLowerCase())) {
+                    githubScore = 1.0;
+                }
+            }
+            // 4. npm Scope Signal
+            let npmScore = 0;
+            const entityNpm = entity.metadata?.npm || entity.metadata?.npm_scope || '';
+            if (targetNpm && entityNpm) {
+                if (entityNpm.toLowerCase().includes(targetNpm) || targetNpm.includes(entityNpm.toLowerCase())) {
+                    npmScore = 1.0;
+                }
+            }
+            // Weighted composite score calculation
+            let totalWeight = 0;
+            let weightedSum = 0;
+            if (targetName) {
+                const weight = 0.45;
+                weightedSum += maxNameScore * weight;
+                totalWeight += weight;
+            }
+            if (targetDomain) {
+                const weight = 0.25;
+                weightedSum += domainScore * weight;
+                totalWeight += weight;
+            }
+            if (targetGithub) {
+                const weight = 0.15;
+                weightedSum += githubScore * weight;
+                totalWeight += weight;
+            }
+            if (targetNpm) {
+                const weight = 0.15;
+                weightedSum += npmScore * weight;
+                totalWeight += weight;
+            }
+            const matchScore = totalWeight > 0 ? Number((weightedSum / totalWeight).toFixed(3)) : 0;
+            // Only include candidates above minimum recognition threshold (0.50)
+            if (matchScore >= 0.50) {
+                candidates.push({
+                    entity,
+                    match_score: matchScore,
+                    signals: {
+                        name: Number(maxNameScore.toFixed(3)),
+                        domain: Number(domainScore.toFixed(3)),
+                        github: Number(githubScore.toFixed(3)),
+                        npm: Number(npmScore.toFixed(3)),
+                    },
+                });
+            }
+        }
+        candidates.sort((a, b) => b.match_score - a.match_score);
+        return candidates;
+    }
+    findCanonical(query) {
+        const candidates = this.resolve({ name: query });
+        if (candidates.length > 0 && candidates[0].match_score >= 0.85) {
+            return candidates[0].entity;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/engine/resolver.js.map

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

package/dist/engine/schemaOrg.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ProofGraph Schema.org Structured Data Generator & Validator
+ * Produces compliant JSON-LD grounded purely in verified facts
+ */
+import { Entity } from '../types/index.js';
+export declare class SchemaOrgGenerator {
+    static generateOrganization(entity: Entity): Record<string, any>;
+    static generateSoftwareApplication(entity: Entity): Record<string, any>;
+    static generateService(entity: Entity): Record<string, any>;
+    static generateArticle(entity: Entity): Record<string, any>;
+    static generateForEntity(entity: Entity): Record<string, any>;
+}

package/dist/engine/schemaOrg.js

@@ -0,0 +1,105 @@
+/**
+ * ProofGraph Schema.org Structured Data Generator & Validator
+ * Produces compliant JSON-LD grounded purely in verified facts
+ */
+export class SchemaOrgGenerator {
+    static generateOrganization(entity) {
+        const meta = entity.metadata || {};
+        const schema = {
+            '@context': 'https://schema.org',
+            '@type': 'Organization',
+            '@id': entity.canonical_url || `https://aibuildinfra.com/#${entity.id}`,
+            'name': entity.name,
+            'description': entity.description,
+        };
+        if (entity.canonical_url) {
+            schema['url'] = entity.canonical_url;
+        }
+        if (entity.aliases.length > 0) {
+            schema['alternateName'] = entity.aliases;
+        }
+        const sameAs = [];
+        if (meta.github)
+            sameAs.push(meta.github);
+        if (meta.npm)
+            sameAs.push(`https://www.npmjs.com/package/${meta.npm}`);
+        if (meta.mcp_registry)
+            sameAs.push(meta.mcp_registry);
+        if (meta.linkedin)
+            sameAs.push(meta.linkedin);
+        if (meta.twitter)
+            sameAs.push(meta.twitter);
+        if (sameAs.length > 0) {
+            schema['sameAs'] = sameAs;
+        }
+        return schema;
+    }
+    static generateSoftwareApplication(entity) {
+        const meta = entity.metadata || {};
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'SoftwareApplication',
+            'name': entity.name,
+            'description': entity.description,
+            'applicationCategory': meta.category || 'DeveloperApplication',
+            'operatingSystem': meta.os || 'Cross-platform',
+            'offers': {
+                '@type': 'Offer',
+                'price': '0',
+                'priceCurrency': 'USD',
+            },
+            'url': entity.canonical_url,
+            'codeRepository': meta.github || meta.repository,
+            'softwareVersion': meta.version || '1.0.0',
+        };
+    }
+    static generateService(entity) {
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'Service',
+            'name': entity.name,
+            'description': entity.description,
+            'provider': {
+                '@type': 'Organization',
+                'name': entity.metadata?.provider || 'AI Build Infra',
+            },
+            'serviceType': entity.metadata?.serviceType || 'Agentic AI Architecture',
+        };
+    }
+    static generateArticle(entity) {
+        return {
+            '@context': 'https://schema.org',
+            '@type': 'TechArticle',
+            'headline': entity.name,
+            'description': entity.description,
+            'author': {
+                '@type': 'Organization',
+                'name': entity.metadata?.author || 'AI Build Infra',
+            },
+            'datePublished': entity.metadata?.published_at || entity.created_at,
+        };
+    }
+    static generateForEntity(entity) {
+        switch (entity.type) {
+            case 'Organization':
+                return this.generateOrganization(entity);
+            case 'Project':
+            case 'Product':
+            case 'Package':
+                return this.generateSoftwareApplication(entity);
+            case 'Service':
+                return this.generateService(entity);
+            case 'Article':
+                return this.generateArticle(entity);
+            default:
+                return {
+                    '@context': 'https://schema.org',
+                    '@type': 'Thing',
+                    'name': entity.name,
+                    'description': entity.description,
+                    'url': entity.canonical_url,
+                };
+        }
+    }
+}
+//# sourceMappingURL=schemaOrg.js.map

package/dist/engine/schemaOrg.js.map

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

package/dist/engine/tokenOptimizer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ProofGraph Token Budget & Evidence Compression Engine
+ * Guarantees Minimum Sufficient Context and prevents context bloating
+ */
+import { Evidence, Source, Claim, Entity, EvidencePacket, SourceTrustClass } from '../types/index.js';
+export declare const TRUST_CLASS_WEIGHTS: Record<SourceTrustClass, number>;
+export declare function estimateTokens(text: string | object): number;
+export declare class TokenOptimizer {
+    static rankEvidence(evidenceList: Evidence[], sources: Map<string, Source>, claimStatement?: string): Evidence[];
+    static deduplicateEvidence(evidenceList: Evidence[]): Evidence[];
+    static buildPacket(options: {
+        question?: string;
+        entities: Entity[];
+        claims: Claim[];
+        evidence: Evidence[];
+        sources: Map<string, Source>;
+        relationships?: Array<{
+            source_id: string;
+            target_id: string;
+            relationship: string;
+            confidence: number;
+        }>;
+        maxTokens?: number;
+    }): EvidencePacket;
+}

package/dist/engine/tokenOptimizer.js

@@ -0,0 +1,166 @@
+/**
+ * ProofGraph Token Budget & Evidence Compression Engine
+ * Guarantees Minimum Sufficient Context and prevents context bloating
+ */
+import { jaroWinklerSimilarity } from './resolver.js';
+export const TRUST_CLASS_WEIGHTS = {
+    standards_body: 1.0,
+    official_registry: 0.98,
+    official_source: 0.95,
+    government_source: 0.95,
+    github_repository: 0.90,
+    package_registry: 0.90,
+    academic_source: 0.88,
+    established_publication: 0.80,
+    industry_directory: 0.70,
+    community_source: 0.50,
+    social_media: 0.35,
+    unknown_source: 0.20,
+};
+export function estimateTokens(text) {
+    const str = typeof text === 'string' ? text : JSON.stringify(text);
+    // Standard approximation: ~4 characters per token
+    return Math.ceil(str.length / 4);
+}
+export class TokenOptimizer {
+    static rankEvidence(evidenceList, sources, claimStatement) {
+        return [...evidenceList].sort((a, b) => {
+            const sourceA = sources.get(a.source_id);
+            const sourceB = sources.get(b.source_id);
+            const trustA = sourceA ? TRUST_CLASS_WEIGHTS[sourceA.trust_class] || 0.5 : 0.5;
+            const trustB = sourceB ? TRUST_CLASS_WEIGHTS[sourceB.trust_class] || 0.5 : 0.5;
+            let relevanceA = a.confidence;
+            let relevanceB = b.confidence;
+            if (claimStatement) {
+                const simA = jaroWinklerSimilarity(a.excerpt, claimStatement);
+                const simB = jaroWinklerSimilarity(b.excerpt, claimStatement);
+                relevanceA = relevanceA * 0.7 + simA * 0.3;
+                relevanceB = relevanceB * 0.7 + simB * 0.3;
+            }
+            const scoreA = trustA * 0.35 +
+                relevanceA * 0.30 +
+                (a.directness || 0.8) * 0.20 +
+                (a.supports_claim ? 0.15 : 0.05);
+            const scoreB = trustB * 0.35 +
+                relevanceB * 0.30 +
+                (b.directness || 0.8) * 0.20 +
+                (b.supports_claim ? 0.15 : 0.05);
+            return scoreB - scoreA;
+        });
+    }
+    static deduplicateEvidence(evidenceList) {
+        const clustered = [];
+        const visited = new Set();
+        for (let i = 0; i < evidenceList.length; i++) {
+            if (visited.has(evidenceList[i].id))
+                continue;
+            const primary = { ...evidenceList[i] };
+            const corroborating = [];
+            for (let j = i + 1; j < evidenceList.length; j++) {
+                if (visited.has(evidenceList[j].id))
+                    continue;
+                const other = evidenceList[j];
+                const sim = jaroWinklerSimilarity(primary.excerpt, other.excerpt);
+                // If excerpt is nearly identical (> 0.88 similarity), cluster as corroboration
+                if (sim > 0.88) {
+                    visited.add(other.id);
+                    corroborating.push(other.source_id);
+                }
+            }
+            if (corroborating.length > 0) {
+                primary.corroborating_sources = [
+                    ...(primary.corroborating_sources || []),
+                    ...corroborating,
+                ];
+            }
+            clustered.push(primary);
+            visited.add(primary.id);
+        }
+        return clustered;
+    }
+    static buildPacket(options) {
+        const budget = options.maxTokens || 1500;
+        const sourcesConsidered = options.evidence.length;
+        // 1. Deduplicate & rank evidence
+        const deduped = this.deduplicateEvidence(options.evidence);
+        const ranked = this.rankEvidence(deduped, options.sources, options.claims[0]?.statement);
+        // Calculate raw estimated tokens if all uncompressed sources were dumped
+        let rawTextAccumulator = '';
+        for (const ev of options.evidence) {
+            rawTextAccumulator += `${ev.title} ${ev.excerpt} ${ev.url} `;
+        }
+        const rawEstimatedTokens = Math.max(estimateTokens(rawTextAccumulator) * 5, 4500); // Raw full pages would be 5x larger
+        // 2. Budget partition calculation
+        const entityBudget = Math.floor(budget * 0.12);
+        const claimBudget = Math.floor(budget * 0.15);
+        const evidenceBudget = Math.floor(budget * 0.55);
+        const provenanceBudget = Math.floor(budget * 0.12);
+        // 3. Compact Entities
+        const compactEntities = options.entities.map(e => ({
+            id: e.id,
+            name: e.name,
+            type: e.type,
+            canonical_url: e.canonical_url,
+            description: e.description.length > 180 ? e.description.substring(0, 177) + '...' : e.description,
+        }));
+        // 4. Compact Claims
+        const compactClaims = options.claims.map(c => ({
+            id: c.id,
+            claim: c.statement,
+            status: c.status,
+            confidence: c.confidence,
+        }));
+        // 5. Select Evidence within budget
+        const packedEvidence = [];
+        const packedProvenance = [];
+        let currentEvidenceTokens = 0;
+        for (const ev of ranked) {
+            const source = options.sources.get(ev.source_id);
+            const excerpt = ev.excerpt.length > 250 ? ev.excerpt.substring(0, 247) + '...' : ev.excerpt;
+            const evItem = {
+                evidence_id: ev.id,
+                source: ev.publisher || source?.publisher || source?.title || 'Unknown Source',
+                source_type: ev.source_type,
+                url: ev.url,
+                excerpt,
+                confidence: ev.confidence,
+                retrieved_at: ev.retrieved_at,
+                corroborating_count: ev.corroborating_sources?.length || 0,
+            };
+            const itemTokens = estimateTokens(evItem);
+            if (currentEvidenceTokens + itemTokens <= evidenceBudget || packedEvidence.length === 0) {
+                packedEvidence.push(evItem);
+                currentEvidenceTokens += itemTokens;
+                // Add Provenance
+                packedProvenance.push({
+                    claim_id: ev.claim_id || 'claim:general',
+                    evidence_id: ev.id,
+                    source_id: ev.source_id,
+                    url: ev.url,
+                    content_hash: ev.content_hash,
+                    retrieved_at: ev.retrieved_at,
+                });
+            }
+        }
+        const packet = {
+            question: options.question,
+            entities: compactEntities,
+            claims: compactClaims,
+            relationships: options.relationships || [],
+            evidence: packedEvidence,
+            provenance: packedProvenance,
+            metrics: {
+                sources_considered: sourcesConsidered,
+                sources_returned: packedEvidence.length,
+                raw_estimated_tokens: rawEstimatedTokens,
+                returned_tokens: 0,
+                compression_ratio: 0,
+            },
+        };
+        const returnedTokens = estimateTokens(packet);
+        packet.metrics.returned_tokens = returnedTokens;
+        packet.metrics.compression_ratio = Number((returnedTokens / Math.max(rawEstimatedTokens, returnedTokens)).toFixed(3));
+        return packet;
+    }
+}
+//# sourceMappingURL=tokenOptimizer.js.map

package/dist/engine/tokenOptimizer.js.map

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

package/dist/engine/webPresence.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ProofGraph Web Presence & Digital Footprint Analyzer
+ */
+import { Source } from '../types/index.js';
+import { GraphStore } from '../storage/graphStore.js';
+export interface WebPresenceAnalysis {
+    entity_id: string;
+    entity_name: string;
+    domain?: string;
+    breakdown: {
+        official_references: Source[];
+        third_party_references: Source[];
+        github_references: Source[];
+        package_references: Source[];
+        registry_references: Source[];
+        documentation_references: Source[];
+        social_references: Source[];
+        case_studies: Source[];
+    };
+    detected_anomalies: string[];
+    summary: {
+        total_sources: number;
+        official_count: number;
+        third_party_count: number;
+        footprint_diversity: number;
+    };
+}
+export declare class WebPresenceAnalyzer {
+    private store;
+    constructor(store: GraphStore);
+    analyze(entityIdOrName: string, domainHint?: string): WebPresenceAnalysis;
+}