openplanter 0.1.3 → 0.2.1

package/dist/investigation-tools/investigation-automation.d.ts

@@ -0,0 +1,144 @@
+/**
+ * investigation-automation.ts — Cross-reference engine, insider network expansion,
+ * compliance risk reports, global entity resolver, and jurisdiction risk scoring.
+ *
+ * Tools: cross_reference_engine, insider_network_expander, compliance_risk_report,
+ *        global_entity_resolver, jurisdiction_risk_scorer
+ */
+import { type Provenance, type ConfidenceScore } from "./shared-crypto.js";
+export interface CrossReference {
+    entityA: {
+        name: string;
+        source: string;
+        type: string;
+    };
+    entityB: {
+        name: string;
+        source: string;
+        type: string;
+    };
+    matchScore: number;
+    matchType: "exact" | "fuzzy" | "alias" | "structural";
+    evidence: string[];
+    confidence: ConfidenceScore;
+}
+export interface CrossReferenceResult {
+    matches: CrossReference[];
+    totalEntitiesA: number;
+    totalEntitiesB: number;
+    provenance: Provenance;
+}
+export interface ExpandedConnection {
+    fromEntity: string;
+    toEntity: string;
+    connectionType: string;
+    depth: number;
+    pathDescription: string;
+    confidence: ConfidenceScore;
+    sources: string[];
+}
+export interface NetworkExpansionResult {
+    newConnections: ExpandedConnection[];
+    originalNodes: number;
+    expandedNodes: number;
+    provenance: Provenance;
+}
+export interface RiskFactor {
+    category: string;
+    description: string;
+    severity: "low" | "medium" | "high" | "critical";
+    score: number;
+    evidence: string;
+}
+export interface ComplianceReport {
+    subject: string;
+    overallRisk: "low" | "medium" | "high" | "critical";
+    overallScore: number;
+    riskFactors: RiskFactor[];
+    recommendations: string[];
+    generatedAt: string;
+    provenance: Provenance;
+}
+export interface ResolvedEntity {
+    canonicalName: string;
+    type: string;
+    jurisdiction: string;
+    aliases: string[];
+    identifiers: Record<string, string>;
+    confidence: ConfidenceScore;
+    sources: string[];
+}
+export interface GlobalEntityResult {
+    resolved: ResolvedEntity[];
+    unresolved: string[];
+    provenance: Provenance;
+}
+export interface JurisdictionRisk {
+    jurisdiction: string;
+    country: string;
+    riskScore: number;
+    riskLevel: "low" | "medium" | "high" | "critical";
+    factors: Array<{
+        factor: string;
+        score: number;
+    }>;
+    cpiScore: number | null;
+    fatfStatus: string;
+    taxHaven: boolean;
+}
+export interface JurisdictionRiskResult {
+    assessments: JurisdictionRisk[];
+    provenance: Provenance;
+}
+export interface EntityInput {
+    name: string;
+    source: string;
+    type: string;
+    properties?: Record<string, string>;
+}
+export declare function crossReferenceEntities(opts: {
+    entitiesA: EntityInput[];
+    entitiesB: EntityInput[];
+    threshold?: number;
+    test?: boolean;
+}): CrossReferenceResult;
+export declare function expandInsiderNetwork(opts: {
+    entities: Array<{
+        name: string;
+        type: string;
+        connections?: string[];
+    }>;
+    knownConnections: Array<{
+        from: string;
+        to: string;
+        type: string;
+    }>;
+    maxDepth?: number;
+    test?: boolean;
+}): NetworkExpansionResult;
+export declare function generateComplianceReport(opts: {
+    subject: string;
+    findings: Array<{
+        category: string;
+        description: string;
+        severity: "low" | "medium" | "high" | "critical";
+        evidence: string;
+    }>;
+    test?: boolean;
+}): ComplianceReport;
+export declare function resolveGlobalEntities(opts: {
+    entities: Array<{
+        name: string;
+        type: string;
+        source: string;
+        jurisdiction?: string;
+        identifiers?: Record<string, string>;
+    }>;
+    threshold?: number;
+    test?: boolean;
+}): GlobalEntityResult;
+export declare function scoreJurisdictionRisk(opts: {
+    jurisdictions: string[];
+    test?: boolean;
+}): JurisdictionRiskResult;
+//# sourceMappingURL=investigation-automation.d.ts.map

package/dist/investigation-tools/investigation-automation.d.ts.map

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

package/dist/investigation-tools/investigation-automation.js

@@ -0,0 +1,345 @@
+/**
+ * investigation-automation.ts — Cross-reference engine, insider network expansion,
+ * compliance risk reports, global entity resolver, and jurisdiction risk scoring.
+ *
+ * Tools: cross_reference_engine, insider_network_expander, compliance_risk_report,
+ *        global_entity_resolver, jurisdiction_risk_scorer
+ */
+import { isoNow, tokenSortRatio, normalizePerson, normalizeCompany } from "./shared.js";
+import { makeProvenance, computeConfidence, } from "./shared-crypto.js";
+// ── Mock Data ────────────────────────────────────────────────────
+const MOCK_XREF = {
+    matches: [
+        {
+            entityA: { name: "John C. Smith", source: "SEC Form 4", type: "person" },
+            entityB: { name: "SMITH, John Charles", source: "APH Register", type: "person" },
+            matchScore: 88, matchType: "fuzzy",
+            evidence: ["Name fuzzy match 88%", "Same employer: TechCorp"],
+            confidence: { score: 85, factors: ["name_match", "employer_match"] },
+        },
+    ],
+    totalEntitiesA: 10, totalEntitiesB: 15,
+    provenance: makeProvenance("cross_reference_engine", "test://mock", ["test_mode"]),
+};
+const MOCK_EXPANSION = {
+    newConnections: [
+        {
+            fromEntity: "John Smith", toEntity: "Crypto PAC",
+            connectionType: "political_donation", depth: 2,
+            pathDescription: "John Smith -> TechCorp Inc -> Crypto PAC (via FEC donation)",
+            confidence: { score: 78, factors: ["fec_record", "employer_match"] },
+            sources: ["FEC API", "OpenCorporates"],
+        },
+    ],
+    originalNodes: 5, expandedNodes: 12,
+    provenance: makeProvenance("insider_network_expander", "test://mock", ["test_mode"]),
+};
+const MOCK_COMPLIANCE = {
+    subject: "TechCorp Inc Investigation",
+    overallRisk: "high",
+    overallScore: 78,
+    riskFactors: [
+        { category: "Insider Trading", description: "CEO sold shares 7 days before negative earnings", severity: "critical", score: 95, evidence: "SEC Form 4 filing + earnings date correlation" },
+        { category: "Political Connection", description: "Congress member purchased shares during committee oversight", severity: "high", score: 82, evidence: "House stock disclosure + committee membership" },
+    ],
+    recommendations: [
+        "File SEC whistleblower tip regarding CEO share sale timing",
+        "Cross-reference congressional committee schedule with trade dates",
+        "Monitor for additional insider transactions in 30-day window",
+    ],
+    generatedAt: isoNow(),
+    provenance: makeProvenance("compliance_risk_report", "test://mock", ["test_mode"]),
+};
+const MOCK_GLOBAL_ENTITY = {
+    resolved: [
+        {
+            canonicalName: "JOHN CHARLES SMITH",
+            type: "person",
+            jurisdiction: "US,AU",
+            aliases: ["John C. Smith", "SMITH, John Charles", "J.C. Smith"],
+            identifiers: { sec_cik: "0001234567", aph_member_id: "AU-12345" },
+            confidence: { score: 90, factors: ["name_match", "cross_source", "identifier_link"] },
+            sources: ["SEC EDGAR", "APH Register", "OpenCorporates"],
+        },
+    ],
+    unresolved: [],
+    provenance: makeProvenance("global_entity_resolver", "test://mock", ["test_mode"]),
+};
+const JURISDICTION_RISK_DB = {
+    us: { jurisdiction: "US", country: "United States", riskScore: 20, riskLevel: "low", cpiScore: 69, fatfStatus: "Member", taxHaven: false },
+    au: { jurisdiction: "AU", country: "Australia", riskScore: 18, riskLevel: "low", cpiScore: 73, fatfStatus: "Member", taxHaven: false },
+    gb: { jurisdiction: "GB", country: "United Kingdom", riskScore: 22, riskLevel: "low", cpiScore: 71, fatfStatus: "Member", taxHaven: false },
+    sg: { jurisdiction: "SG", country: "Singapore", riskScore: 25, riskLevel: "low", cpiScore: 83, fatfStatus: "Member", taxHaven: false },
+    ch: { jurisdiction: "CH", country: "Switzerland", riskScore: 35, riskLevel: "medium", cpiScore: 82, fatfStatus: "Member", taxHaven: true },
+    ky: { jurisdiction: "KY", country: "Cayman Islands", riskScore: 72, riskLevel: "high", cpiScore: null, fatfStatus: "Non-Member", taxHaven: true },
+    pa: { jurisdiction: "PA", country: "Panama", riskScore: 78, riskLevel: "high", cpiScore: 36, fatfStatus: "Grey List", taxHaven: true },
+    vg: { jurisdiction: "VG", country: "British Virgin Islands", riskScore: 80, riskLevel: "critical", cpiScore: null, fatfStatus: "Non-Member", taxHaven: true },
+    sc: { jurisdiction: "SC", country: "Seychelles", riskScore: 75, riskLevel: "high", cpiScore: 70, fatfStatus: "Non-Member", taxHaven: true },
+    ae: { jurisdiction: "AE", country: "United Arab Emirates", riskScore: 55, riskLevel: "medium", cpiScore: 67, fatfStatus: "Grey List", taxHaven: false },
+};
+export function crossReferenceEntities(opts) {
+    if (opts.test)
+        return MOCK_XREF;
+    const threshold = opts.threshold ?? 75;
+    const matches = [];
+    for (const a of opts.entitiesA) {
+        for (const b of opts.entitiesB) {
+            if (a.type !== b.type)
+                continue;
+            const normalizer = a.type === "person" ? normalizePerson : normalizeCompany;
+            const normA = normalizer(a.name);
+            const normB = normalizer(b.name);
+            const exactMatch = normA.toUpperCase() === normB.toUpperCase();
+            const fuzzy = tokenSortRatio(normA, normB);
+            if (!exactMatch && fuzzy < threshold)
+                continue;
+            const evidence = [];
+            const factors = [];
+            if (exactMatch) {
+                evidence.push("Exact name match after normalization");
+                factors.push(["exact_match", 50]);
+            }
+            else {
+                evidence.push(`Name fuzzy match ${fuzzy}%`);
+                factors.push(["fuzzy_match", fuzzy / 2]);
+            }
+            if (a.properties && b.properties) {
+                for (const [key, valA] of Object.entries(a.properties)) {
+                    const valB = b.properties[key];
+                    if (valB && valA.toLowerCase() === valB.toLowerCase()) {
+                        evidence.push(`Shared property ${key}: ${valA}`);
+                        factors.push([`${key}_match`, 20]);
+                    }
+                }
+            }
+            matches.push({
+                entityA: { name: a.name, source: a.source, type: a.type },
+                entityB: { name: b.name, source: b.source, type: b.type },
+                matchScore: exactMatch ? 100 : fuzzy,
+                matchType: exactMatch ? "exact" : "fuzzy",
+                evidence,
+                confidence: computeConfidence(factors),
+            });
+        }
+    }
+    matches.sort((a, b) => b.matchScore - a.matchScore);
+    return {
+        matches,
+        totalEntitiesA: opts.entitiesA.length,
+        totalEntitiesB: opts.entitiesB.length,
+        provenance: makeProvenance("cross_reference_engine"),
+    };
+}
+// ── insider_network_expander ─────────────────────────────────────
+export function expandInsiderNetwork(opts) {
+    if (opts.test)
+        return MOCK_EXPANSION;
+    const maxDepth = opts.maxDepth ?? 2;
+    const entityMap = new Map(opts.entities.map((e) => [e.name, e]));
+    const adj = new Map();
+    for (const conn of opts.knownConnections) {
+        if (!adj.has(conn.from))
+            adj.set(conn.from, new Set());
+        if (!adj.has(conn.to))
+            adj.set(conn.to, new Set());
+        adj.get(conn.from).add(conn.to);
+        adj.get(conn.to).add(conn.from);
+    }
+    const newConnections = [];
+    const originalNames = new Set(opts.entities.map((e) => e.name));
+    const allNodes = new Set(originalNames);
+    for (const entity of opts.entities) {
+        if (!entity.connections)
+            continue;
+        for (const conn of entity.connections) {
+            if (originalNames.has(conn))
+                continue;
+            allNodes.add(conn);
+            newConnections.push({
+                fromEntity: entity.name,
+                toEntity: conn,
+                connectionType: "expanded_connection",
+                depth: 1,
+                pathDescription: `${entity.name} -> ${conn} (via entity metadata)`,
+                confidence: computeConfidence([["metadata_link", 60]]),
+                sources: ["entity_metadata"],
+            });
+        }
+    }
+    for (const conn of opts.knownConnections) {
+        const neighbors1 = adj.get(conn.to) ?? new Set();
+        for (const hop2 of neighbors1) {
+            if (originalNames.has(hop2) || hop2 === conn.from)
+                continue;
+            allNodes.add(hop2);
+            newConnections.push({
+                fromEntity: conn.from,
+                toEntity: hop2,
+                connectionType: `indirect_via_${conn.to}`,
+                depth: 2,
+                pathDescription: `${conn.from} -> ${conn.to} -> ${hop2}`,
+                confidence: computeConfidence([["graph_path", 40], ["known_connection", 30]]),
+                sources: ["graph_traversal"],
+            });
+        }
+    }
+    return {
+        newConnections,
+        originalNodes: originalNames.size,
+        expandedNodes: allNodes.size,
+        provenance: makeProvenance("insider_network_expander"),
+    };
+}
+// ── compliance_risk_report ───────────────────────────────────────
+export function generateComplianceReport(opts) {
+    if (opts.test)
+        return MOCK_COMPLIANCE;
+    const severityScores = { low: 20, medium: 50, high: 75, critical: 95 };
+    const riskFactors = opts.findings.map((f) => ({
+        ...f,
+        score: severityScores[f.severity],
+    }));
+    const overallScore = riskFactors.length > 0
+        ? Math.round(riskFactors.reduce((sum, f) => sum + f.score, 0) / riskFactors.length)
+        : 0;
+    let overallRisk;
+    if (overallScore >= 80)
+        overallRisk = "critical";
+    else if (overallScore >= 60)
+        overallRisk = "high";
+    else if (overallScore >= 40)
+        overallRisk = "medium";
+    else
+        overallRisk = "low";
+    const recommendations = [];
+    for (const f of riskFactors) {
+        if (f.severity === "critical") {
+            recommendations.push(`URGENT: Investigate ${f.category} — ${f.description}`);
+        }
+        else if (f.severity === "high") {
+            recommendations.push(`Review ${f.category} findings and gather additional evidence`);
+        }
+    }
+    if (riskFactors.some((f) => f.category.toLowerCase().includes("insider"))) {
+        recommendations.push("Consider filing SEC whistleblower tip");
+    }
+    if (riskFactors.some((f) => f.category.toLowerCase().includes("politic"))) {
+        recommendations.push("Cross-reference congressional committee schedules");
+    }
+    return {
+        subject: opts.subject,
+        overallRisk,
+        overallScore,
+        riskFactors,
+        recommendations,
+        generatedAt: isoNow(),
+        provenance: makeProvenance("compliance_risk_report"),
+    };
+}
+// ── global_entity_resolver ───────────────────────────────────────
+export function resolveGlobalEntities(opts) {
+    if (opts.test)
+        return MOCK_GLOBAL_ENTITY;
+    const threshold = opts.threshold ?? 80;
+    const n = opts.entities.length;
+    const parent = Array.from({ length: n }, (_, i) => i);
+    function find(x) {
+        while (parent[x] !== x) {
+            parent[x] = parent[parent[x]];
+            x = parent[x];
+        }
+        return x;
+    }
+    function union(a, b) {
+        const ra = find(a), rb = find(b);
+        if (ra !== rb)
+            parent[rb] = ra;
+    }
+    for (let i = 0; i < n; i++) {
+        for (let j = i + 1; j < n; j++) {
+            const a = opts.entities[i], b = opts.entities[j];
+            if (a.type !== b.type)
+                continue;
+            const normalizer = a.type === "person" ? normalizePerson : normalizeCompany;
+            const score = tokenSortRatio(normalizer(a.name), normalizer(b.name));
+            let idMatch = false;
+            if (a.identifiers && b.identifiers) {
+                for (const [key, val] of Object.entries(a.identifiers)) {
+                    if (b.identifiers[key] === val) {
+                        idMatch = true;
+                        break;
+                    }
+                }
+            }
+            if (score >= threshold || idMatch)
+                union(i, j);
+        }
+    }
+    const clusters = new Map();
+    for (let i = 0; i < n; i++) {
+        const root = find(i);
+        const members = clusters.get(root) ?? [];
+        members.push(i);
+        clusters.set(root, members);
+    }
+    const resolved = [];
+    for (const [root, members] of clusters) {
+        const primary = opts.entities[root];
+        const normalizer = primary.type === "person" ? normalizePerson : normalizeCompany;
+        const allNames = members.map((m) => opts.entities[m].name);
+        const allSources = [...new Set(members.map((m) => opts.entities[m].source))];
+        const allJurisdictions = [...new Set(members.map((m) => opts.entities[m].jurisdiction).filter(Boolean))];
+        const mergedIds = {};
+        for (const m of members) {
+            const ids = opts.entities[m].identifiers;
+            if (ids)
+                Object.assign(mergedIds, ids);
+        }
+        const factors = [["name_match", 40]];
+        if (allSources.length > 1)
+            factors.push(["cross_source", 30]);
+        if (Object.keys(mergedIds).length > 0)
+            factors.push(["identifier_link", 20]);
+        resolved.push({
+            canonicalName: normalizer(primary.name),
+            type: primary.type,
+            jurisdiction: allJurisdictions.join(","),
+            aliases: [...new Set(allNames)],
+            identifiers: mergedIds,
+            confidence: computeConfidence(factors),
+            sources: allSources,
+        });
+    }
+    return { resolved, unresolved: [], provenance: makeProvenance("global_entity_resolver") };
+}
+// ── jurisdiction_risk_scorer ─────────────────────────────────────
+export function scoreJurisdictionRisk(opts) {
+    const assessments = opts.jurisdictions.map((j) => {
+        const code = j.toLowerCase().trim();
+        const data = JURISDICTION_RISK_DB[code];
+        if (data) {
+            const factors = [];
+            if (data.taxHaven)
+                factors.push({ factor: "Tax haven jurisdiction", score: 30 });
+            if (data.fatfStatus === "Grey List")
+                factors.push({ factor: "FATF grey list", score: 25 });
+            if (data.fatfStatus === "Non-Member")
+                factors.push({ factor: "Not FATF member", score: 20 });
+            if (data.cpiScore !== null && data.cpiScore < 50)
+                factors.push({ factor: `Low CPI score (${data.cpiScore})`, score: 15 });
+            return { ...data, factors };
+        }
+        return {
+            jurisdiction: j.toUpperCase(),
+            country: j,
+            riskScore: 50,
+            riskLevel: "medium",
+            factors: [{ factor: "Unknown jurisdiction", score: 50 }],
+            cpiScore: null,
+            fatfStatus: "Unknown",
+            taxHaven: false,
+        };
+    });
+    return { assessments, provenance: makeProvenance("jurisdiction_risk_scorer") };
+}
+//# sourceMappingURL=investigation-automation.js.map

package/dist/investigation-tools/investigation-automation.js.map

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

package/dist/investigation-tools/monitoring-tools.d.ts

@@ -0,0 +1,102 @@
+/**
+ * monitoring-tools.ts — Real-time monitoring for whale alerts, dark pool activity,
+ * corporate filings, and real estate records.
+ *
+ * Tools: whale_alert_monitor, dark_pool_activity, corporate_filings_monitor, real_estate_records
+ */
+import { type Provenance } from "./shared-crypto.js";
+export interface WhaleTransaction {
+    blockchain: string;
+    txHash: string;
+    timestamp: string;
+    from: {
+        address: string;
+        label: string;
+    };
+    to: {
+        address: string;
+        label: string;
+    };
+    amount: number;
+    amountUsd: number;
+    symbol: string;
+    transactionType: string;
+}
+export interface WhaleAlertResult {
+    transactions: WhaleTransaction[];
+    total: number;
+    provenance: Provenance;
+}
+export interface DarkPoolTrade {
+    symbol: string;
+    date: string;
+    volume: number;
+    avgPrice: number;
+    totalValue: number;
+    darkPoolPct: number;
+    exchange: string;
+    shortVolume: number;
+    shortPct: number;
+}
+export interface DarkPoolResult {
+    trades: DarkPoolTrade[];
+    total: number;
+    provenance: Provenance;
+}
+export interface FilingAlert {
+    company: string;
+    ticker: string;
+    filingType: string;
+    filingDate: string;
+    description: string;
+    url: string;
+    significance: "routine" | "notable" | "urgent";
+}
+export interface FilingMonitorResult {
+    alerts: FilingAlert[];
+    total: number;
+    provenance: Provenance;
+}
+export interface PropertyRecord {
+    address: string;
+    ownerName: string;
+    ownerType: string;
+    assessedValue: number;
+    salePrice: number | null;
+    saleDate: string | null;
+    propertyType: string;
+    county: string;
+    state: string;
+    parcellId: string;
+}
+export interface PropertyResult {
+    records: PropertyRecord[];
+    total: number;
+    provenance: Provenance;
+}
+export declare function monitorWhaleAlerts(opts: {
+    minUsd?: number;
+    blockchain?: string;
+    symbol?: string;
+    limit?: number;
+    apiKey?: string;
+    test?: boolean;
+}): Promise<WhaleAlertResult>;
+export declare function fetchDarkPoolActivity(opts: {
+    ticker: string;
+    daysBack?: number;
+    test?: boolean;
+}): Promise<DarkPoolResult>;
+export declare function monitorCorporateFilings(opts: {
+    tickers: string[];
+    formTypes?: string[];
+    daysBack?: number;
+    test?: boolean;
+}): Promise<FilingMonitorResult>;
+export declare function searchPropertyRecords(opts: {
+    ownerName?: string;
+    address?: string;
+    state?: string;
+    test?: boolean;
+}): Promise<PropertyResult>;
+//# sourceMappingURL=monitoring-tools.d.ts.map

package/dist/investigation-tools/monitoring-tools.d.ts.map

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