openplanter 0.1.0

package/dist/investigation-tools/multi-forum-scraper.js

@@ -0,0 +1,415 @@
+/**
+ * multi-forum-scraper.ts – Multi-Forum Scraper for ASX Ticker Sentiment & Rumor Extraction
+ *
+ * Scrapes multiple forums and social media platforms for posts related to a
+ * given ASX ticker. Supported sources:
+ *
+ *   - HotCopper  (https://hotcopper.com.au)
+ *   - Stockhead  (https://stockhead.com.au)
+ *   - Twitter / X via Nitter  (https://nitter.net)
+ *
+ * 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 the above websites may violate their respective 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, sentimentLabel, isRumor, isoNow, BULLISH_KEYWORDS, BEARISH_KEYWORDS, RUMOR_KEYWORDS, } from "./shared.js";
+// ── Constants ───────────────────────────────────────────────────
+const HOTCOPPER_BASE_URL = "https://hotcopper.com.au";
+const HOTCOPPER_DISCUSSION_URL = HOTCOPPER_BASE_URL + "/asx/{ticker}/discussion/";
+const STOCKHEAD_SEARCH_URL = "https://stockhead.com.au/search/?q={ticker}";
+const NITTER_SEARCH_URL = "https://nitter.net/search?q=%24{ticker}+ASX";
+/** All supported scraping sites. */
+export const SUPPORTED_SITES = ["hotcopper", "stockhead", "twitter"];
+const MAX_POST_TEXT_LEN = 500;
+const DEFAULT_DELAY = 1.5;
+// ── Helpers ─────────────────────────────────────────────────────
+/** 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) + "…";
+}
+/** Round a number to 3 decimal places. */
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+/** 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}`;
+}
+/**
+ * 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);
+}
+/**
+ * Return list of matched keywords from built-in + extra keyword sets.
+ *
+ * Rumor keywords are matched by substring, sentiment keywords by word
+ * boundary, and extra user-supplied keywords by substring.
+ */
+function matchKeywords(text, extraKeywords) {
+    const textLower = text.toLowerCase();
+    const matched = new Set();
+    // Check built-in rumor keywords (substring match)
+    for (const kw of RUMOR_KEYWORDS) {
+        if (textLower.includes(kw.toLowerCase())) {
+            matched.add(kw);
+        }
+    }
+    // Check sentiment keywords (word-level match)
+    const words = new Set(textLower.match(/[a-z]+/g) ?? []);
+    const allSentimentKw = [...BULLISH_KEYWORDS, ...BEARISH_KEYWORDS].sort();
+    for (const kw of allSentimentKw) {
+        if (words.has(kw)) {
+            matched.add(kw);
+        }
+    }
+    // Check extra user-supplied keywords (substring match)
+    for (const kw of extraKeywords) {
+        if (textLower.includes(kw.toLowerCase())) {
+            matched.add(kw);
+        }
+    }
+    return [...matched].sort();
+}
+/**
+ * Build a normalised post record.
+ */
+function makePost(source, ticker, date, author, title, textSnippet, url, extraKeywords) {
+    const combined = `${title} ${textSnippet}`;
+    const score = sentimentScore(combined);
+    return {
+        source,
+        ticker: ticker.toUpperCase(),
+        date,
+        author,
+        title,
+        text_snippet: truncate(textSnippet),
+        sentiment: sentimentLabel(score),
+        sentiment_score: round3(score),
+        rumor_flag: isRumor(combined),
+        keywords_matched: matchKeywords(combined, extraKeywords),
+        url,
+    };
+}
+/**
+ * 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;
+    }
+}
+// ── Site Scrapers ───────────────────────────────────────────────
+/**
+ * Scrape HotCopper discussion pages for the given ticker.
+ *
+ * This is a single-page scraper used by the multi-forum aggregator.
+ * For a full multi-page HotCopper scraper with thread body fetching,
+ * see {@link ../hotcopper-scraper.js}.
+ */
+export async function scrapeHotcopper(ticker, days, delay, extraKeywords, userAgent) {
+    const tickerUpper = ticker.toUpperCase();
+    const now = new Date();
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const posts = [];
+    const url = HOTCOPPER_DISCUSSION_URL.replace("{ticker}", ticker.toLowerCase());
+    const $ = await fetchPage(url, delay, userAgent);
+    if ($ === null)
+        return posts;
+    const rows = $("table tr");
+    rows.each((_i, row) => {
+        const cells = $(row).find("td");
+        if (cells.length < 6)
+            return;
+        // Date — typically last cell
+        const dateText = $(cells[cells.length - 1]).text().trim();
+        const postDate = parseHcDate(dateText);
+        if (postDate === null)
+            return;
+        if (postDate.getTime() < cutoff.getTime())
+            return;
+        // Subject link
+        let subjectHref = "";
+        let subjectText = "";
+        let found = false;
+        cells.each((_j, cell) => {
+            if (found)
+                return;
+            const link = $(cell).find('a[href*="/threads/"]').first();
+            if (link.length > 0) {
+                subjectHref = link.attr("href") ?? "";
+                subjectText = link.text().trim();
+                found = true;
+            }
+        });
+        if (!found)
+            return;
+        const threadTitle = subjectText.replace(/^Re:\s*/i, "");
+        let threadUrl = subjectHref;
+        if (threadUrl.startsWith("/")) {
+            threadUrl = HOTCOPPER_BASE_URL + threadUrl;
+        }
+        // Poster
+        let poster = "";
+        const posterLink = $(row).find('a[href*="users="]').first();
+        if (posterLink.length > 0) {
+            poster = posterLink.text().trim();
+        }
+        posts.push(makePost("hotcopper", tickerUpper, formatDateStr(postDate), poster, threadTitle, threadTitle, threadUrl, extraKeywords));
+    });
+    return posts;
+}
+/**
+ * Scrape Stockhead search results for the given ticker.
+ */
+export async function scrapeStockhead(ticker, days, delay, extraKeywords, userAgent) {
+    const tickerUpper = ticker.toUpperCase();
+    const now = new Date();
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const posts = [];
+    const url = STOCKHEAD_SEARCH_URL.replace("{ticker}", tickerUpper);
+    const $ = await fetchPage(url, delay, userAgent);
+    if ($ === null)
+        return posts;
+    // Stockhead search results are typically article cards
+    let articles = $("article, div.search-result, div.post-item, li.result-item");
+    if (articles.length === 0) {
+        // Fallback: try generic heading + link patterns
+        articles = $("h2, h3, h4");
+    }
+    articles.each((_i, article) => {
+        // Extract title
+        const titleEl = $(article).find("h2, h3, h4, a").first();
+        if (titleEl.length === 0)
+            return;
+        const title = titleEl.text().trim();
+        if (!title)
+            return;
+        // Extract link
+        let articleUrl = "";
+        const linkEl = $(article).is("a")
+            ? $(article)
+            : $(article).find("a[href]").first();
+        if (linkEl.length === 0) {
+            const parentLink = titleEl.closest("a");
+            if (parentLink.length > 0) {
+                articleUrl = parentLink.attr("href") ?? "";
+            }
+        }
+        else {
+            articleUrl = linkEl.attr("href") ?? "";
+        }
+        if (articleUrl.startsWith("/")) {
+            articleUrl = "https://stockhead.com.au" + articleUrl;
+        }
+        // Extract snippet
+        let snippet = title;
+        const excerptEl = $(article).find('p, span[class*="excerpt"], div[class*="excerpt"]').first();
+        if (excerptEl.length > 0) {
+            const excerptText = excerptEl.text().trim();
+            if (excerptText)
+                snippet = excerptText;
+        }
+        else {
+            const pEl = $(article).find("p").first();
+            if (pEl.length > 0) {
+                const pText = pEl.text().trim();
+                if (pText)
+                    snippet = pText;
+            }
+        }
+        // Extract date
+        let dateStr = "";
+        const timeEl = $(article).find("time").first();
+        if (timeEl.length > 0 && timeEl.attr("datetime")) {
+            try {
+                const dt = new Date(timeEl.attr("datetime").replace("Z", "+00:00"));
+                if (!isNaN(dt.getTime())) {
+                    if (dt.getTime() < cutoff.getTime())
+                        return;
+                    dateStr = formatDateStr(dt);
+                }
+            }
+            catch {
+                dateStr = formatDateStr(now);
+            }
+        }
+        if (!dateStr) {
+            dateStr = formatDateStr(now);
+        }
+        // Author
+        let author = "Stockhead";
+        const authorEl = $(article).find('[class*="author"]').first();
+        if (authorEl.length > 0) {
+            const authorText = authorEl.text().trim();
+            if (authorText)
+                author = authorText;
+        }
+        posts.push(makePost("stockhead", tickerUpper, dateStr, author, title, snippet, articleUrl, extraKeywords));
+    });
+    return posts;
+}
+/**
+ * Scrape Twitter/X posts via Nitter for the given ticker.
+ */
+export async function scrapeTwitter(ticker, days, delay, extraKeywords, userAgent) {
+    const tickerUpper = ticker.toUpperCase();
+    const now = new Date();
+    const cutoff = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const posts = [];
+    const url = NITTER_SEARCH_URL.replace("{ticker}", tickerUpper);
+    const $ = await fetchPage(url, delay, userAgent);
+    if ($ === null)
+        return posts;
+    // Nitter tweet containers
+    let tweetEls = $("div.timeline-item, div.tweet-card, div.tweet");
+    if (tweetEls.length === 0) {
+        // Alternative selectors
+        tweetEls = $("article, div.post");
+    }
+    tweetEls.each((_i, tweetEl) => {
+        // Username
+        const userEl = $(tweetEl).find('[class*="username"]').first();
+        const username = userEl.length > 0 ? userEl.text().trim() : "unknown";
+        // Tweet text
+        let textEl = $(tweetEl).find('[class*="content"]').first();
+        if (textEl.length === 0) {
+            textEl = $(tweetEl).find("p").first();
+        }
+        if (textEl.length === 0)
+            return;
+        const text = textEl.text().trim();
+        if (!text)
+            return;
+        // Date
+        let dateStr = "";
+        const timeEl = $(tweetEl).find("time").first();
+        if (timeEl.length > 0 && timeEl.attr("datetime")) {
+            try {
+                const dt = new Date(timeEl.attr("datetime").replace("Z", "+00:00"));
+                if (!isNaN(dt.getTime())) {
+                    if (dt.getTime() < cutoff.getTime())
+                        return;
+                    dateStr = formatDateStr(dt);
+                }
+            }
+            catch {
+                dateStr = formatDateStr(now);
+            }
+        }
+        if (!dateStr) {
+            dateStr = formatDateStr(now);
+        }
+        // Tweet URL
+        let tweetUrl = "";
+        const tweetLink = $(tweetEl).find('a[href*="/status/"]').first();
+        if (tweetLink.length > 0) {
+            const href = tweetLink.attr("href") ?? "";
+            if (href.startsWith("/")) {
+                tweetUrl = "https://nitter.net" + href;
+            }
+            else {
+                tweetUrl = href;
+            }
+        }
+        posts.push(makePost("twitter", tickerUpper, dateStr, username, "", text, tweetUrl, extraKeywords));
+    });
+    return posts;
+}
+// ── Aggregation ─────────────────────────────────────────────────
+/**
+ * Build an aggregate summary across all scraped posts.
+ */
+export function aggregateSummary(posts) {
+    // Posts per source
+    const sourceCounts = {};
+    for (const p of posts) {
+        sourceCounts[p.source] = (sourceCounts[p.source] ?? 0) + 1;
+    }
+    // Sentiment distribution
+    const sentimentDist = { bullish: 0, bearish: 0, neutral: 0 };
+    for (const p of posts) {
+        const label = p.sentiment;
+        if (label in sentimentDist) {
+            sentimentDist[label] += 1;
+        }
+    }
+    // Rumor count
+    const rumorCount = posts.filter((p) => p.rumor_flag).length;
+    // Overall average sentiment score
+    const scores = posts.map((p) => p.sentiment_score);
+    const avgScore = scores.length > 0
+        ? round3(scores.reduce((a, b) => a + b, 0) / scores.length)
+        : 0.0;
+    return {
+        total_posts: posts.length,
+        posts_per_source: sourceCounts,
+        sentiment_distribution: sentimentDist,
+        average_sentiment_score: avgScore,
+        rumor_count: rumorCount,
+    };
+}
+// ── Main Scraper ────────────────────────────────────────────────
+/** Map of site names to their scraper functions. */
+const SCRAPERS = {
+    hotcopper: scrapeHotcopper,
+    stockhead: scrapeStockhead,
+    twitter: scrapeTwitter,
+};
+/**
+ * Scrape multiple forums and social media for ASX ticker sentiment and rumor data.
+ *
+ * @param opts - Scraper options.
+ * @returns Structured result with posts from all requested sites and aggregate summary.
+ */
+export async function scrapeMultiForum(opts) {
+    const ticker = opts.ticker.toUpperCase().trim();
+    const sites = opts.sites ?? SUPPORTED_SITES;
+    const days = opts.days ?? 7;
+    const extraKeywords = opts.extraKeywords ?? [];
+    const delay = opts.delay ?? DEFAULT_DELAY;
+    const userAgent = opts.userAgent;
+    const allPosts = [];
+    for (const site of sites) {
+        const scraperFn = SCRAPERS[site];
+        if (!scraperFn)
+            continue;
+        try {
+            const sitePosts = await scraperFn(ticker, days, delay, extraKeywords, userAgent);
+            allPosts.push(...sitePosts);
+        }
+        catch {
+            // Continue with other sites on failure
+            continue;
+        }
+    }
+    const summary = aggregateSummary(allPosts);
+    return {
+        ticker,
+        scraped_at: isoNow(),
+        period: `${days} days`,
+        sites_requested: sites,
+        posts: allPosts,
+        summary,
+    };
+}
+//# sourceMappingURL=multi-forum-scraper.js.map

package/dist/investigation-tools/multi-forum-scraper.js.map

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

package/dist/investigation-tools/price-fetcher.d.ts

@@ -0,0 +1,81 @@
+/**
+ * price-fetcher.ts – ASX OHLCV price fetcher with anomaly detection.
+ *
+ * Fetches historical OHLCV data from Yahoo Finance for Australian (ASX)
+ * tickers, computes derived metrics, and flags trading anomalies.
+ */
+/** Raw OHLCV bar from Yahoo Finance. */
+export interface OhlcvBar {
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+}
+/** OHLCV bar with computed metrics and anomaly flags. */
+export interface PriceMetrics {
+    ticker: string;
+    date: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    dailyReturnPct: number | null;
+    volumeRatio: number | null;
+    volatility: number | null;
+    gapPct: number | null;
+    anomalyFlags: string[];
+}
+/** Per-ticker summary of the requested period. */
+export interface TickerSummary {
+    ticker: string;
+    avgVolume: number;
+    avgReturn: number;
+    maxReturn: number;
+    minReturn: number;
+    anomalyCount: number;
+    periodReturn: number;
+}
+export declare const ANOMALY_THRESHOLDS: {
+    readonly volume_spike: 2;
+    readonly price_surge: 5;
+    readonly price_drop: -5;
+    readonly gap_up: 3;
+    readonly gap_down: -3;
+    readonly volatility_spike_factor: 2;
+};
+export declare const ROLLING_VOLUME_WINDOW = 20;
+export declare const ROLLING_VOLATILITY_WINDOW = 20;
+export declare const VOLATILITY_BASELINE_WINDOW = 60;
+export declare const VALID_PERIODS: Set<string>;
+export declare const VALID_INTERVALS: Set<string>;
+/**
+ * Fetch OHLCV data from Yahoo Finance for the given ASX tickers.
+ *
+ * Each ticker is automatically suffixed with `.AX` if needed.
+ * Returns a mapping of clean ticker → OhlcvBar[].
+ */
+export declare function fetchOhlcv(tickers: string[], period?: string, interval?: string): Promise<Map<string, OhlcvBar[]>>;
+/**
+ * Compute derived metrics and anomaly flags for an array of OHLCV bars.
+ *
+ * Metrics:
+ * - `dailyReturnPct`: percentage change in close vs previous close
+ * - `volumeRatio`:    current volume / 20-day rolling mean volume
+ * - `volatility`:     20-day rolling sample std of daily returns
+ * - `gapPct`:         percentage gap between open and previous close
+ * - `anomalyFlags`:   list of triggered threshold names
+ */
+export declare function computeMetrics(ticker: string, bars: OhlcvBar[]): PriceMetrics[];
+/**
+ * Merge per-ticker data into a flat array of PriceMetrics.
+ * Optionally filter to only rows with at least one anomaly flag.
+ */
+export declare function buildOutput(allData: Map<string, OhlcvBar[]>, anomaliesOnly?: boolean): PriceMetrics[];
+/**
+ * Produce a per-ticker summary from OHLCV data.
+ */
+export declare function buildSummary(allData: Map<string, OhlcvBar[]>): TickerSummary[];
+//# sourceMappingURL=price-fetcher.d.ts.map

package/dist/investigation-tools/price-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-fetcher.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/price-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAuBD,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,eAAO,MAAM,aAAa,aAExB,CAAC;AAEH,eAAO,MAAM,eAAe,aAG1B,CAAC;AA+FH;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,GAAE,MAAc,EACtB,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAiClC;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EAAE,GACf,YAAY,EAAE,CAsFhB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAChC,aAAa,GAAE,OAAe,GAC7B,YAAY,EAAE,CAYhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAC/B,aAAa,EAAE,CA0CjB"}