openplanter 0.1.0

package/dist/investigation-tools/hotcopper-scraper.js

@@ -0,0 +1,318 @@
+/**
+ * hotcopper-scraper.ts – HotCopper Forum Scraper for ASX Ticker Sentiment & Rumor Extraction
+ *
+ * Scrapes HotCopper (https://hotcopper.com.au), Australia's largest stock
+ * market forum, for posts related to a given ASX ticker. Extracts post
+ * metadata, performs basic keyword-based sentiment analysis, and flags
+ * rumor-type posts that may be relevant to insider-trading investigations.
+ *
+ * DISCLAIMER:
+ *   This tool is provided for research and educational purposes only.
+ *   Scraping HotCopper may violate their Terms of Service. Users are
+ *   solely responsible for ensuring compliance with all applicable laws,
+ *   regulations, and website terms before using this tool. The authors
+ *   accept no liability for misuse.
+ */
+import { fetchHtml, parseDate, sentimentScore, isRumor, isoNow, } from "./shared.js";
+// ── Constants ───────────────────────────────────────────────────
+const BASE_URL = "https://hotcopper.com.au";
+const DISCUSSION_URL = BASE_URL + "/asx/{ticker}/discussion/";
+const THREAD_URL_PREFIX = BASE_URL + "/threads/";
+const MAX_POST_TEXT_LEN = 500;
+/** ASX ticker pattern (1–3 uppercase letters, optionally with dot prefix). */
+const TICKER_RE = /\b([A-Z][A-Z0-9]{1,2}(?:\.[A-Z]{1,3})?)\b/g;
+/** Common English words and abbreviations that match the ticker pattern. */
+const NOISE_WORDS = new Set([
+    "I", "A", "IT", "IS", "AT", "TO", "IN", "ON", "OR", "AN", "IF",
+    "UP", "DO", "GO", "SO", "NO", "AS", "BY", "BE", "HE", "WE", "RE",
+    "MY", "US", "AM", "OF", "THE", "AND", "FOR", "BUT", "NOT", "ALL",
+    "ANY", "CAN", "HAS", "HER", "WAS", "ONE", "OUR", "OUT", "YOU",
+    "HAD", "HOT", "OIL", "OLD", "RED", "SIT", "TOP", "TWO", "WAR",
+    "ANN", "CEO", "CFO", "ASX", "ETF", "IPO", "AGM", "EPS", "ROE",
+    "IMO", "LOL", "FYI", "TBA", "AUD", "USD", "NZD", "GBP", "EUR",
+    "BUY", "NEW", "LOW", "HIGH", "DAY", "NAV", "P&L",
+]);
+/** CSS selectors to try when extracting thread body content. */
+const THREAD_BODY_SELECTORS = [
+    "article.message-body",
+    "div.message-body",
+    "div.bbWrapper",
+    "div.messageText",
+    "blockquote.messageText",
+    "div.message-content",
+    "article",
+];
+// ── Helpers ─────────────────────────────────────────────────────
+/**
+ * Parse HotCopper's DD/MM/YY date string into a Date.
+ * Falls back to the shared parseDate for other formats.
+ */
+function parseHcDate(raw) {
+    return parseDate(raw);
+}
+/**
+ * Find ASX-style ticker symbols mentioned in text, excluding the primary ticker.
+ */
+function extractTickerMentions(text, primaryTicker) {
+    const found = new Set();
+    let match;
+    // Reset regex state for global matching
+    const re = new RegExp(TICKER_RE.source, TICKER_RE.flags);
+    while ((match = re.exec(text)) !== null) {
+        found.add(match[1]);
+    }
+    found.delete(primaryTicker.toUpperCase());
+    // Filter out noise words
+    const filtered = [];
+    for (const t of found) {
+        if (!NOISE_WORDS.has(t)) {
+            filtered.push(t);
+        }
+    }
+    return filtered.sort();
+}
+/** Truncate text to max length, breaking at the last space. */
+function truncate(text, maxLen = MAX_POST_TEXT_LEN) {
+    if (text.length <= maxLen)
+        return text;
+    const cut = text.slice(0, maxLen);
+    const spaceIdx = cut.lastIndexOf(" ");
+    return (spaceIdx > 0 ? cut.slice(0, spaceIdx) : cut) + "…";
+}
+/**
+ * Fetch a page, returning a CheerioAPI or null on failure.
+ * Handles errors gracefully without throwing.
+ */
+async function fetchPage(url, delay, userAgent) {
+    try {
+        return await fetchHtml(url, { delay, userAgent });
+    }
+    catch {
+        return null;
+    }
+}
+// ── Scraping Logic ──────────────────────────────────────────────
+/**
+ * Parse posts from a single HotCopper discussion listing page.
+ *
+ * @returns A tuple of `[posts, shouldContinue]`. `shouldContinue` is false
+ *   when all remaining posts are older than the cutoff date.
+ */
+function parseDiscussionPage($, ticker, cutoff) {
+    const posts = [];
+    const tickerUpper = ticker.toUpperCase();
+    const rows = $("table tr");
+    rows.each((_i, row) => {
+        const cells = $(row).find("td");
+        if (cells.length < 6)
+            return; // continue
+        // Date — typically the last cell
+        const dateText = $(cells[cells.length - 1]).text().trim();
+        const postDate = parseHcDate(dateText);
+        if (postDate === null)
+            return;
+        // Check cutoff
+        if (postDate.getTime() < cutoff.getTime()) {
+            // Signal to stop after processing this page
+            return;
+        }
+        // Subject link — find the first anchor with /threads/ in href
+        let foundSubject = false;
+        let subjectHref = "";
+        let subjectText = "";
+        cells.each((_j, cell) => {
+            if (foundSubject)
+                return;
+            const link = $(cell).find('a[href*="/threads/"]').first();
+            if (link.length > 0) {
+                foundSubject = true;
+                subjectHref = link.attr("href") ?? "";
+                subjectText = link.text().trim();
+            }
+        });
+        if (!foundSubject)
+            return;
+        // Clean title — remove "Re:" prefix
+        const threadTitle = subjectText.replace(/^Re:\s*/i, "");
+        // Build full URL
+        let threadUrl = subjectHref;
+        if (threadUrl.startsWith("/")) {
+            threadUrl = BASE_URL + threadUrl;
+        }
+        // Poster — look for link with "users=" in href
+        let poster = "";
+        const posterLink = $(row).find('a[href*="users="]').first();
+        if (posterLink.length > 0) {
+            poster = posterLink.text().trim();
+        }
+        // Sentiment and analysis on the title text
+        const combinedText = threadTitle;
+        const score = sentimentScore(combinedText);
+        const tickers = extractTickerMentions(combinedText, tickerUpper);
+        const rumor = isRumor(combinedText);
+        posts.push({
+            thread_title: threadTitle,
+            post_author: poster,
+            post_date: formatDateStr(postDate),
+            post_text: truncate(threadTitle),
+            sentiment_score: round3(score),
+            ticker_mentions: tickers,
+            url: threadUrl,
+            is_rumor: rumor,
+        });
+    });
+    // Determine shouldContinue: check if the last row's date is before cutoff
+    let shouldContinue = true;
+    const lastRow = rows.last();
+    if (lastRow.length > 0) {
+        const lastCells = lastRow.find("td");
+        if (lastCells.length >= 6) {
+            const lastDateText = $(lastCells[lastCells.length - 1]).text().trim();
+            const lastDate = parseHcDate(lastDateText);
+            if (lastDate !== null && lastDate.getTime() < cutoff.getTime()) {
+                shouldContinue = false;
+            }
+        }
+    }
+    return [posts, shouldContinue];
+}
+/**
+ * Fetch a thread page and extract the post body text.
+ */
+async function scrapeThreadContent(url, delay, userAgent) {
+    const $ = await fetchPage(url, delay, userAgent);
+    if ($ === null)
+        return "";
+    // Try several selectors for post content
+    for (const selector of THREAD_BODY_SELECTORS) {
+        const elements = $(selector);
+        if (elements.length > 0) {
+            const textParts = [];
+            for (const el of elements.toArray()) {
+                textParts.push($(el).text().trim());
+            }
+            return textParts.join(" ");
+        }
+    }
+    // Fallback: extract text from main content area
+    const main = $("main").length > 0 ? $("main") : $("#content");
+    if (main.length > 0) {
+        return main.text().trim().slice(0, 2000);
+    }
+    return "";
+}
+/** Format a Date as YYYY-MM-DD. */
+function formatDateStr(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, "0");
+    const day = String(d.getDate()).padStart(2, "0");
+    return `${y}-${m}-${day}`;
+}
+/** Round a number to 3 decimal places. */
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+// ── Main Scraper ────────────────────────────────────────────────
+/**
+ * Scrape HotCopper discussion pages for the given ASX ticker.
+ *
+ * @param opts - Scraper options.
+ * @returns Structured result with posts, daily sentiment, flagged rumors, etc.
+ */
+export async function scrapeHotcopper(opts) {
+    const ticker = opts.ticker.toUpperCase().trim();
+    const days = opts.days ?? 7;
+    const maxPages = opts.maxPages ?? 5;
+    const delay = opts.delay ?? 2.0;
+    const userAgent = opts.userAgent;
+    const scrapeThreadBodies = opts.scrapeThreadBodies ?? false;
+    const now = new Date();
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const allPosts = [];
+    for (let pageNum = 1; pageNum <= maxPages; pageNum++) {
+        const baseUrl = DISCUSSION_URL.replace("{ticker}", ticker.toLowerCase());
+        const url = pageNum === 1 ? baseUrl : `${baseUrl}page-${pageNum}`;
+        const pageDelay = pageNum > 1 ? delay : 0.0;
+        const $ = await fetchPage(url, pageDelay, userAgent);
+        if ($ === null)
+            break;
+        const [posts, shouldContinue] = parseDiscussionPage($, ticker, cutoff);
+        allPosts.push(...posts);
+        if (!shouldContinue)
+            break;
+    }
+    // Optionally fetch full thread text for richer sentiment
+    if (scrapeThreadBodies) {
+        const seenUrls = new Set();
+        for (const post of allPosts) {
+            if (seenUrls.has(post.url))
+                continue;
+            seenUrls.add(post.url);
+            const body = await scrapeThreadContent(post.url, delay, userAgent);
+            if (body) {
+                post.post_text = truncate(body);
+                post.sentiment_score = round3(sentimentScore(body));
+                post.ticker_mentions = extractTickerMentions(body, ticker);
+                post.is_rumor = isRumor(body);
+            }
+        }
+    }
+    // De-duplicate by URL + date + author
+    const seen = new Set();
+    const uniquePosts = [];
+    for (const p of allPosts) {
+        const key = `${p.url}|${p.post_date}|${p.post_author}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            uniquePosts.push(p);
+        }
+    }
+    // Aggregate daily sentiment
+    const dailyMap = new Map();
+    for (const p of uniquePosts) {
+        const existing = dailyMap.get(p.post_date) ?? [];
+        existing.push(p);
+        dailyMap.set(p.post_date, existing);
+    }
+    const dailySentiment = [];
+    const sortedDates = [...dailyMap.keys()].sort();
+    for (const dateStr of sortedDates) {
+        const dayPosts = dailyMap.get(dateStr);
+        const scores = dayPosts.map((p) => p.sentiment_score);
+        const avg = scores.length > 0
+            ? scores.reduce((a, b) => a + b, 0) / scores.length
+            : 0.0;
+        // Notable posts: highest absolute sentiment
+        const notable = [...dayPosts]
+            .sort((a, b) => Math.abs(b.sentiment_score) - Math.abs(a.sentiment_score))
+            .slice(0, 3);
+        dailySentiment.push({
+            date: dateStr,
+            post_count: dayPosts.length,
+            avg_sentiment: round3(avg),
+            notable_posts: notable.map((n) => ({
+                title: n.thread_title,
+                sentiment: n.sentiment_score,
+                url: n.url,
+            })),
+        });
+    }
+    // Flagged rumors
+    const flaggedRumors = uniquePosts.filter((p) => p.is_rumor);
+    // Overall sentiment
+    const allScores = uniquePosts.map((p) => p.sentiment_score);
+    const overall = allScores.length > 0
+        ? round3(allScores.reduce((a, b) => a + b, 0) / allScores.length)
+        : 0.0;
+    return {
+        ticker,
+        scraped_at: isoNow(),
+        period: `${days} days`,
+        total_posts: uniquePosts.length,
+        posts: uniquePosts,
+        daily_sentiment: dailySentiment,
+        flagged_rumors: flaggedRumors,
+        overall_sentiment: overall,
+    };
+}
+//# sourceMappingURL=hotcopper-scraper.js.map

package/dist/investigation-tools/hotcopper-scraper.js.map

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

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

@@ -0,0 +1,15 @@
+export * as shared from "./shared.js";
+export * as entityResolver from "./entity-resolver.js";
+export * as insiderSuspicionScorer from "./insider-suspicion-scorer.js";
+export * as timelineLinker from "./timeline-linker.js";
+export * as aphHoldings from "./aph-holdings.js";
+export * as asicOfficerLookup from "./asic-officer-lookup.js";
+export * as asxCalendarFetcher from "./asx-calendar-fetcher.js";
+export * as asxParser from "./asx-parser.js";
+export * as bulkAsxAnnouncements from "./bulk-asx-announcements.js";
+export * as hotcopperScraper from "./hotcopper-scraper.js";
+export * as multiForumScraper from "./multi-forum-scraper.js";
+export * as priceFetcher from "./price-fetcher.js";
+export * as volumeScanner from "./volume-scanner.js";
+export * as insiderGraph from "./insider-graph.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC"}

package/dist/investigation-tools/index.js

@@ -0,0 +1,15 @@
+export * as shared from "./shared.js";
+export * as entityResolver from "./entity-resolver.js";
+export * as insiderSuspicionScorer from "./insider-suspicion-scorer.js";
+export * as timelineLinker from "./timeline-linker.js";
+export * as aphHoldings from "./aph-holdings.js";
+export * as asicOfficerLookup from "./asic-officer-lookup.js";
+export * as asxCalendarFetcher from "./asx-calendar-fetcher.js";
+export * as asxParser from "./asx-parser.js";
+export * as bulkAsxAnnouncements from "./bulk-asx-announcements.js";
+export * as hotcopperScraper from "./hotcopper-scraper.js";
+export * as multiForumScraper from "./multi-forum-scraper.js";
+export * as priceFetcher from "./price-fetcher.js";
+export * as volumeScanner from "./volume-scanner.js";
+export * as insiderGraph from "./insider-graph.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/investigation-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,sBAAsB,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,kBAAkB,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,oBAAoB,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,iBAAiB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC"}

package/dist/investigation-tools/insider-graph.d.ts

@@ -0,0 +1,173 @@
+/**
+ * insider-graph.ts — Entity-event relationship graph builder for insider trading investigations.
+ *
+ * Builds directed graphs of people, companies, events, and tickers with weighted edges
+ * representing relationships (shareholdings, directorships, trades, announcements, etc.).
+ * Supports pathfinding (Dijkstra), neighbourhood queries, community detection, and
+ * suspicion-path analysis connecting trade events to information sources.
+ *
+ * Migrated from tools/insider_graph.py — all graph algorithms implemented from scratch
+ * with no external dependencies.
+ */
+export declare const VALID_NODE_TYPES: Set<string>;
+export declare const EDGE_TYPE_DEFAULTS: Record<string, number>;
+/** Event sub-types treated as "information sources" for suspicion analysis. */
+export declare const INFO_SOURCE_EVENT_SUBTYPES: Set<string>;
+/** Input node definition for graph construction. */
+export interface GraphNode {
+    id: string;
+    type?: string;
+    label?: string;
+    subtype?: string;
+    properties?: Record<string, unknown>;
+}
+/** Input edge definition for graph construction. */
+export interface GraphEdge {
+    source: string;
+    target: string;
+    type?: string;
+    weight?: number;
+    properties?: Record<string, unknown>;
+}
+/** Canonical input schema containing nodes and edges. */
+export interface GraphData {
+    nodes?: GraphNode[];
+    edges?: GraphEdge[];
+}
+/** Detail about a single edge along a path. */
+export interface EdgeDetail {
+    from: string;
+    to: string;
+    type?: string;
+    weight?: number;
+}
+/** Result of a shortest-path query. */
+export interface PathResult {
+    found: boolean;
+    source: string;
+    target: string;
+    path: string[];
+    length: number | null;
+    edges?: EdgeDetail[];
+    error?: string;
+}
+/** Single connection entry in a neighbourhood query. */
+export interface ConnectionEntry {
+    id: string;
+    type?: string;
+    label: string;
+    distance: number;
+}
+/** Result of a neighbourhood / connections query. */
+export interface ConnectionsResult {
+    node: string;
+    depth?: number;
+    total?: number;
+    connections: ConnectionEntry[];
+    error?: string;
+}
+/** A member of a cluster (connected component). */
+export interface ClusterMember {
+    id: string;
+    type?: string;
+    label: string;
+}
+/** A single cluster (connected component). */
+export interface Cluster {
+    cluster_id: number;
+    size: number;
+    members: ClusterMember[];
+}
+/** Result of a connected-component / cluster query. */
+export interface ClusterResult {
+    total_clusters: number;
+    clusters: Cluster[];
+}
+/** A node with high betweenness centrality. */
+export interface CentralNode {
+    id: string;
+    label: string;
+    type?: string;
+    centrality: number;
+}
+/** Summary statistics for the graph. */
+export interface StatsResult {
+    total_nodes: number;
+    total_edges: number;
+    node_types: Record<string, number>;
+    edge_types: Record<string, number>;
+    density: number;
+    connected_components: number;
+    diameter: number | null;
+    key_central_nodes: CentralNode[];
+}
+/** A single suspicion path from trade event to information source. */
+export interface SuspicionPath {
+    info_source: string;
+    info_source_label: string;
+    path: string[];
+    length: number;
+    edges: EdgeDetail[];
+}
+/** Result of a suspicion-analysis query. */
+export interface SuspicionResult {
+    trade_event: string;
+    total_paths?: number;
+    paths?: SuspicionPath[];
+    error?: string;
+}
+/**
+ * Lightweight directed graph with adjacency-list storage.
+ *
+ * Stores node attributes and edge attributes. Supports both directed
+ * and undirected-view operations required for insider-graph analysis.
+ */
+export declare class DiGraph {
+    private _nodes;
+    private _adj;
+    private _pred;
+    /** Add a node (or update its attributes if it already exists). */
+    addNode(id: string, attrs?: Record<string, unknown>): void;
+    /** Add a directed edge (or update its attributes if it already exists). */
+    addEdge(source: string, target: string, attrs?: Record<string, unknown>): void;
+    hasNode(id: string): boolean;
+    getNodeData(id: string): Record<string, unknown> | undefined;
+    getEdgeData(u: string, v: string): Record<string, unknown> | undefined;
+    numberOfNodes(): number;
+    numberOfEdges(): number;
+    /** All node IDs. */
+    nodeIds(): string[];
+    /** Iterate over nodes with their attribute dicts. */
+    nodesWithData(): Array<[string, Record<string, unknown>]>;
+    /** Iterate over edges as [source, target, attrs] triples. */
+    edgesWithData(): Array<[string, string, Record<string, unknown>]>;
+    /** Outgoing neighbours (directed). */
+    successors(node: string): string[];
+    /** Incoming neighbours (directed). */
+    predecessors(node: string): string[];
+    /** All neighbours (undirected view — union of successors and predecessors). */
+    undirectedNeighbors(node: string): string[];
+}
+/** Construct a DiGraph from the canonical input JSON schema. */
+export declare function buildGraph(data: GraphData): DiGraph;
+/** Dijkstra shortest path between source and target (undirected view). */
+export declare function findShortestPath(G: DiGraph, source: string, target: string): PathResult;
+/** All nodes reachable within `depth` hops (undirected neighbourhood, BFS). */
+export declare function findConnections(G: DiGraph, node: string, depth?: number): ConnectionsResult;
+/** Connected components (on the undirected projection) as clusters. */
+export declare function findClusters(G: DiGraph): ClusterResult;
+/**
+ * Find paths connecting a trade event to any information-source event
+ * (announcement, report, meeting). Highlights how an insider may have
+ * received material non-public information before executing a trade.
+ */
+export declare function suspicionAnalysis(G: DiGraph, tradeEventId: string): SuspicionResult;
+/** Compute summary statistics for the graph. */
+export declare function graphStats(G: DiGraph): StatsResult;
+/** Node-link JSON suitable for D3.js force-directed graphs. */
+export declare function exportJson(G: DiGraph): string;
+/** GraphML format for Gephi / yEd. */
+export declare function exportGraphml(G: DiGraph): string;
+/** Map of export format names to their exporter functions. */
+export declare const EXPORTERS: Record<string, (G: DiGraph) => string>;
+//# sourceMappingURL=insider-graph.d.ts.map

package/dist/investigation-tools/insider-graph.d.ts.map

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