openplanter 0.2.8 → 0.3.0

package/dist/investigation-tools/state-mp-holdings-scraper.d.ts

@@ -0,0 +1,49 @@
+/**
+ * state-mp-holdings-scraper.ts -- State MP Register of Interests Scraper
+ *
+ * Scrapes state parliament register of members' interests for NSW, VIC, QLD,
+ * and WA. Extracts shareholdings in ASX tickers and flags mining/energy
+ * sector overlaps.
+ *
+ * Data sources:
+ *   - NSW: https://www.parliament.nsw.gov.au/members/pages/register-of-disclosures.aspx
+ *   - VIC: https://www.parliament.vic.gov.au/members/register-of-interests
+ *   - QLD: https://www.parliament.qld.gov.au/Members/Register-of-Members-Interests
+ *   - WA:  https://www.parliament.wa.gov.au/Parliament/memblist.nsf/WAllMembersFlat
+ *
+ * DISCLAIMER:
+ *   This tool is provided for research and educational purposes only.
+ *   Users are solely responsible for ensuring compliance with all applicable
+ *   laws, regulations, and website terms before using this tool.
+ */
+export interface MpHolding {
+    ticker: string | null;
+    company: string;
+    shares: string;
+    date: string;
+    mining_energy_flag: boolean;
+}
+export interface StateMp {
+    mp_name: string;
+    state: string;
+    party: string;
+    electorate: string;
+    chamber: string;
+    holdings: MpHolding[];
+    sources: string[];
+}
+export interface StateMpResult {
+    scraped_at: string;
+    states_requested: string[];
+    states_scraped: string[];
+    total_mps: number;
+    total_holdings: number;
+    mining_energy_flagged: number;
+    members: StateMp[];
+}
+export declare function scrapeStateMpHoldings(opts: {
+    states: string[];
+    tickerFilter?: string;
+}): Promise<StateMpResult>;
+export declare function sampleData(states: string[]): StateMpResult;
+//# sourceMappingURL=state-mp-holdings-scraper.d.ts.map

package/dist/investigation-tools/state-mp-holdings-scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-mp-holdings-scraper.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/state-mp-holdings-scraper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiCH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AA+KD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CA0CzB;AAID,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CA0D1D"}

package/dist/investigation-tools/state-mp-holdings-scraper.js

@@ -0,0 +1,286 @@
+/**
+ * state-mp-holdings-scraper.ts -- State MP Register of Interests Scraper
+ *
+ * Scrapes state parliament register of members' interests for NSW, VIC, QLD,
+ * and WA. Extracts shareholdings in ASX tickers and flags mining/energy
+ * sector overlaps.
+ *
+ * Data sources:
+ *   - NSW: https://www.parliament.nsw.gov.au/members/pages/register-of-disclosures.aspx
+ *   - VIC: https://www.parliament.vic.gov.au/members/register-of-interests
+ *   - QLD: https://www.parliament.qld.gov.au/Members/Register-of-Members-Interests
+ *   - WA:  https://www.parliament.wa.gov.au/Parliament/memblist.nsf/WAllMembersFlat
+ *
+ * DISCLAIMER:
+ *   This tool is provided for research and educational purposes only.
+ *   Users are solely responsible for ensuring compliance with all applicable
+ *   laws, regulations, and website terms before using this tool.
+ */
+import { fetchHtml, isoNow, normalizeTicker, isValidTicker, } from "./shared.js";
+// ── Constants ────────────────────────────────────────────────────
+const MINING_ENERGY_KEYWORDS = [
+    "mining", "resources", "minerals", "petroleum", "coal", "gas",
+    "lithium", "iron ore", "copper", "gold", "nickel", "uranium",
+    "energy", "oil", "exploration", "drilling", "rare earth",
+    "santos", "woodside", "bhp", "rio tinto", "fortescue",
+    "pilbara", "mineral", "ore", "crude",
+];
+const STATE_URLS = {
+    NSW: "https://www.parliament.nsw.gov.au/members/pages/register-of-disclosures.aspx",
+    VIC: "https://www.parliament.vic.gov.au/members/register-of-interests",
+    QLD: "https://www.parliament.qld.gov.au/Members/Register-of-Members-Interests",
+    WA: "https://www.parliament.wa.gov.au/Parliament/memblist.nsf/WAllMembersFlat",
+};
+const DEFAULT_DELAY = 1.5;
+// ── Helpers ──────────────────────────────────────────────────────
+function isMiningEnergy(companyName) {
+    const lower = companyName.toLowerCase();
+    return MINING_ENERGY_KEYWORDS.some((kw) => lower.includes(kw));
+}
+function extractTickerFromName(name) {
+    // Try to find a parenthesised ticker like "(BHP)" or "ASX: BHP"
+    const paren = name.match(/\(([A-Z]{2,6})\)/);
+    if (paren && isValidTicker(paren[1]))
+        return normalizeTicker(paren[1]);
+    const asxLabel = name.match(/ASX[:\s]+([A-Z]{2,6})/i);
+    if (asxLabel && isValidTicker(asxLabel[1]))
+        return normalizeTicker(asxLabel[1]);
+    return null;
+}
+// ── State-specific scrapers ──────────────────────────────────────
+async function scrapeNsw() {
+    const members = [];
+    try {
+        const $ = await fetchHtml(STATE_URLS.NSW, { delay: DEFAULT_DELAY });
+        // NSW register page typically lists members with links to their PDFs
+        // We scrape the listing page for names and party info
+        const rows = $("table tr, .member-list li, .content-body a").toArray();
+        for (const row of rows) {
+            const link = $(row).find("a").first();
+            if (!link.length)
+                continue;
+            const text = link.text().trim();
+            if (!text || text.length < 3)
+                continue;
+            // Skip navigation/header links
+            if (/^(home|back|register|next|prev)/i.test(text))
+                continue;
+            const href = link.attr("href") ?? "";
+            const sourceUrl = href.startsWith("http")
+                ? href
+                : `https://www.parliament.nsw.gov.au${href}`;
+            members.push({
+                mp_name: text,
+                state: "NSW",
+                party: "",
+                electorate: "",
+                chamber: "",
+                holdings: [],
+                sources: [sourceUrl],
+            });
+        }
+    }
+    catch (err) {
+        console.error(`[state_mp_holdings] NSW scrape error: ${err}`);
+    }
+    return members;
+}
+async function scrapeVic() {
+    const members = [];
+    try {
+        const $ = await fetchHtml(STATE_URLS.VIC, { delay: DEFAULT_DELAY });
+        $("table tr").each((_i, row) => {
+            const cells = $(row).find("td");
+            if (cells.length < 2)
+                return;
+            const name = cells.eq(0).text().trim();
+            if (!name || name.length < 3)
+                return;
+            const party = cells.length >= 3 ? cells.eq(2).text().trim() : "";
+            const electorate = cells.length >= 2 ? cells.eq(1).text().trim() : "";
+            const link = cells.eq(0).find("a").first();
+            const href = link.attr("href") ?? "";
+            const sourceUrl = href.startsWith("http")
+                ? href
+                : `https://www.parliament.vic.gov.au${href}`;
+            members.push({
+                mp_name: name,
+                state: "VIC",
+                party,
+                electorate,
+                chamber: "",
+                holdings: [],
+                sources: [sourceUrl],
+            });
+        });
+    }
+    catch (err) {
+        console.error(`[state_mp_holdings] VIC scrape error: ${err}`);
+    }
+    return members;
+}
+async function scrapeQld() {
+    const members = [];
+    try {
+        const $ = await fetchHtml(STATE_URLS.QLD, { delay: DEFAULT_DELAY });
+        $("table tr, .register-item, .member-entry").each((_i, row) => {
+            const cells = $(row).find("td");
+            if (cells.length < 1)
+                return;
+            const name = cells.eq(0).text().trim();
+            if (!name || name.length < 3)
+                return;
+            const party = cells.length >= 3 ? cells.eq(2).text().trim() : "";
+            const electorate = cells.length >= 2 ? cells.eq(1).text().trim() : "";
+            const link = cells.eq(0).find("a").first();
+            const href = link.attr("href") ?? "";
+            const sourceUrl = href.startsWith("http")
+                ? href
+                : `https://www.parliament.qld.gov.au${href}`;
+            members.push({
+                mp_name: name,
+                state: "QLD",
+                party,
+                electorate,
+                chamber: "",
+                holdings: [],
+                sources: [sourceUrl],
+            });
+        });
+    }
+    catch (err) {
+        console.error(`[state_mp_holdings] QLD scrape error: ${err}`);
+    }
+    return members;
+}
+async function scrapeWa() {
+    const members = [];
+    try {
+        const $ = await fetchHtml(STATE_URLS.WA, { delay: DEFAULT_DELAY });
+        $("table tr").each((_i, row) => {
+            const cells = $(row).find("td");
+            if (cells.length < 2)
+                return;
+            const name = cells.eq(0).text().trim();
+            if (!name || name.length < 3)
+                return;
+            const party = cells.length >= 3 ? cells.eq(2).text().trim() : "";
+            const electorate = cells.length >= 2 ? cells.eq(1).text().trim() : "";
+            members.push({
+                mp_name: name,
+                state: "WA",
+                party,
+                electorate,
+                chamber: "",
+                holdings: [],
+                sources: [STATE_URLS.WA],
+            });
+        });
+    }
+    catch (err) {
+        console.error(`[state_mp_holdings] WA scrape error: ${err}`);
+    }
+    return members;
+}
+const STATE_SCRAPERS = {
+    NSW: scrapeNsw,
+    VIC: scrapeVic,
+    QLD: scrapeQld,
+    WA: scrapeWa,
+};
+// ── Main ─────────────────────────────────────────────────────────
+export async function scrapeStateMpHoldings(opts) {
+    const requestedStates = opts.states.map((s) => s.toUpperCase());
+    const validStates = requestedStates.filter((s) => s in STATE_SCRAPERS);
+    const allMembers = [];
+    const scrapedStates = [];
+    for (const state of validStates) {
+        try {
+            const scraperFn = STATE_SCRAPERS[state];
+            const members = await scraperFn();
+            allMembers.push(...members);
+            scrapedStates.push(state);
+        }
+        catch (err) {
+            console.error(`[state_mp_holdings] Failed to scrape ${state}: ${err}`);
+        }
+    }
+    // Apply ticker filter if provided
+    let filteredMembers = allMembers;
+    if (opts.tickerFilter) {
+        const filterTicker = normalizeTicker(opts.tickerFilter);
+        filteredMembers = allMembers.filter((m) => m.holdings.some((h) => h.ticker === filterTicker));
+    }
+    const totalHoldings = filteredMembers.reduce((acc, m) => acc + m.holdings.length, 0);
+    const miningFlagged = filteredMembers.reduce((acc, m) => acc + m.holdings.filter((h) => h.mining_energy_flag).length, 0);
+    return {
+        scraped_at: isoNow(),
+        states_requested: requestedStates,
+        states_scraped: scrapedStates,
+        total_mps: filteredMembers.length,
+        total_holdings: totalHoldings,
+        mining_energy_flagged: miningFlagged,
+        members: filteredMembers,
+    };
+}
+// ── Test/sample data ─────────────────────────────────────────────
+export function sampleData(states) {
+    return {
+        scraped_at: isoNow(),
+        states_requested: states,
+        states_scraped: ["NSW", "VIC", "QLD"],
+        total_mps: 4,
+        total_holdings: 7,
+        mining_energy_flagged: 3,
+        members: [
+            {
+                mp_name: "Sarah Mitchell",
+                state: "NSW",
+                party: "National Party",
+                electorate: "Upper Hunter",
+                chamber: "Legislative Assembly",
+                holdings: [
+                    { ticker: "BHP", company: "BHP Group Limited", shares: "2,500 ordinary shares", date: "2025-12-01", mining_energy_flag: true },
+                    { ticker: "CBA", company: "Commonwealth Bank of Australia", shares: "1,200 ordinary shares", date: "2025-12-01", mining_energy_flag: false },
+                ],
+                sources: ["https://www.parliament.nsw.gov.au/members/pages/register-of-disclosures.aspx"],
+            },
+            {
+                mp_name: "Tim Pallas",
+                state: "VIC",
+                party: "Australian Labor Party",
+                electorate: "Werribee",
+                chamber: "Legislative Assembly",
+                holdings: [
+                    { ticker: "WDS", company: "Woodside Energy Group", shares: "800 ordinary shares", date: "2025-11-15", mining_energy_flag: true },
+                    { ticker: "ANZ", company: "ANZ Banking Group", shares: "3,000 ordinary shares", date: "2025-11-15", mining_energy_flag: false },
+                ],
+                sources: ["https://www.parliament.vic.gov.au/members/register-of-interests"],
+            },
+            {
+                mp_name: "Scott Stewart",
+                state: "QLD",
+                party: "Australian Labor Party",
+                electorate: "Townsville",
+                chamber: "Legislative Assembly",
+                holdings: [
+                    { ticker: "FMG", company: "Fortescue Metals Group", shares: "5,000 ordinary shares", date: "2025-10-20", mining_energy_flag: true },
+                    { ticker: "WES", company: "Wesfarmers Limited", shares: "400 ordinary shares", date: "2025-10-20", mining_energy_flag: false },
+                ],
+                sources: ["https://www.parliament.qld.gov.au/Members/Register-of-Members-Interests"],
+            },
+            {
+                mp_name: "David Templeman",
+                state: "WA",
+                party: "Australian Labor Party",
+                electorate: "Mandurah",
+                chamber: "Legislative Assembly",
+                holdings: [
+                    { ticker: "STO", company: "Santos Limited", shares: "1,500 ordinary shares", date: "2025-09-30", mining_energy_flag: true },
+                ],
+                sources: ["https://www.parliament.wa.gov.au/Parliament/memblist.nsf/WAllMembersFlat"],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=state-mp-holdings-scraper.js.map

package/dist/investigation-tools/state-mp-holdings-scraper.js.map

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

package/dist/investigation-tools/stocktwits-asx-scraper.d.ts

@@ -0,0 +1,61 @@
+/**
+ * stocktwits-asx-scraper.ts -- Stocktwits ASX Sentiment Scraper
+ *
+ * Scrapes Stocktwits for ASX ticker sentiment, rumors, and discussion.
+ * Stocktwits has growing Australian usage; the API provides public
+ * streams for any ticker symbol.
+ *
+ * Data source: https://api.stocktwits.com/api/2/
+ *
+ * DISCLAIMER:
+ *   This tool is provided for research and educational purposes only.
+ *   Users are solely responsible for ensuring compliance with all applicable
+ *   laws, regulations, and website terms before using this tool.
+ */
+export interface StocktwitsPost {
+    id: number;
+    body: string;
+    created_at: string;
+    user: string;
+    user_followers: number;
+    sentiment: string | null;
+    sentiment_score: number;
+    is_rumor: boolean;
+    likes: number;
+    reshares: number;
+    url: string;
+}
+export interface StocktwitsSummary {
+    bullish_count: number;
+    bearish_count: number;
+    neutral_count: number;
+    total_count: number;
+    bullish_pct: number;
+    bearish_pct: number;
+    avg_sentiment: number;
+    top_contributors: Array<{
+        user: string;
+        posts: number;
+        avg_sentiment: number;
+    }>;
+}
+export interface StocktwitsResult {
+    scraped_at: string;
+    ticker: string;
+    symbol_used: string;
+    period_days: number;
+    format: string;
+    total_posts: number;
+    posts: StocktwitsPost[];
+    summary: StocktwitsSummary;
+    rumor_count: number;
+    overall_sentiment: number;
+    overall_sentiment_label: string;
+}
+export declare function scrapeStocktwits(opts: {
+    ticker: string;
+    days?: number;
+    format?: string;
+}): Promise<StocktwitsResult>;
+export declare function sampleData(ticker: string): StocktwitsResult;
+//# sourceMappingURL=stocktwits-asx-scraper.d.ts.map

package/dist/investigation-tools/stocktwits-asx-scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stocktwits-asx-scraper.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/stocktwits-asx-scraper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiCH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAqCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmH5B;AAID,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAiG3D"}

package/dist/investigation-tools/stocktwits-asx-scraper.js

@@ -0,0 +1,246 @@
+/**
+ * stocktwits-asx-scraper.ts -- Stocktwits ASX Sentiment Scraper
+ *
+ * Scrapes Stocktwits for ASX ticker sentiment, rumors, and discussion.
+ * Stocktwits has growing Australian usage; the API provides public
+ * streams for any ticker symbol.
+ *
+ * Data source: https://api.stocktwits.com/api/2/
+ *
+ * DISCLAIMER:
+ *   This tool is provided for research and educational purposes only.
+ *   Users are solely responsible for ensuring compliance with all applicable
+ *   laws, regulations, and website terms before using this tool.
+ */
+import { fetchWithDelay, isoNow, normalizeTicker, sentimentScore as sharedSentiment, sentimentLabel, isRumor, } from "./shared.js";
+// ── Constants ────────────────────────────────────────────────────
+// Stocktwits public API (no key required for basic access)
+const STOCKTWITS_STREAM_URL = "https://api.stocktwits.com/api/2/streams/symbol/{symbol}.json?limit=30";
+const STOCKTWITS_TRENDING_URL = "https://api.stocktwits.com/api/2/trending/symbols.json";
+const DEFAULT_DELAY = 1.0;
+// ASX tickers on Stocktwits often use .AX suffix or just the raw ticker
+const ASX_SYMBOL_FORMATS = [
+    "{ticker}.AX", // Most common ASX format
+    "{ticker}-AX", // Alternative format
+    "{ticker}.AU", // Sometimes used
+    "{ticker}", // Raw ticker
+];
+function mapSentimentLabel(basic) {
+    if (!basic)
+        return null;
+    if (basic === "Bullish")
+        return "bullish";
+    if (basic === "Bearish")
+        return "bearish";
+    return null;
+}
+function daysBetween(a, b) {
+    return Math.abs(Math.round((b.getTime() - a.getTime()) / (86400000)));
+}
+// ── Scraper ──────────────────────────────────────────────────────
+export async function scrapeStocktwits(opts) {
+    const ticker = normalizeTicker(opts.ticker);
+    const days = opts.days ?? 14;
+    const format = opts.format ?? "json";
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const posts = [];
+    let symbolUsed = ticker;
+    // Try each ASX symbol format until we get results
+    for (const fmt of ASX_SYMBOL_FORMATS) {
+        const symbol = fmt.replace("{ticker}", ticker);
+        const url = STOCKTWITS_STREAM_URL.replace("{symbol}", symbol);
+        try {
+            const resp = await fetchWithDelay(url, {
+                delay: DEFAULT_DELAY,
+                headers: { Accept: "application/json" },
+            });
+            if (!resp.ok)
+                continue;
+            const data = (await resp.json());
+            if (!data.messages || data.messages.length === 0)
+                continue;
+            symbolUsed = symbol;
+            for (const msg of data.messages) {
+                const createdAt = msg.created_at ? new Date(msg.created_at) : new Date();
+                if (createdAt < cutoff)
+                    continue;
+                const body = msg.body ?? "";
+                const userSentiment = mapSentimentLabel(msg.entities?.sentiment?.basic);
+                // Combine Stocktwits native sentiment with our keyword-based scoring
+                const kwScore = sharedSentiment(body);
+                const finalScore = userSentiment === "bullish"
+                    ? Math.max(kwScore, 0.5)
+                    : userSentiment === "bearish"
+                        ? Math.min(kwScore, -0.5)
+                        : kwScore;
+                posts.push({
+                    id: msg.id ?? 0,
+                    body: body.slice(0, 500),
+                    created_at: msg.created_at ?? isoNow(),
+                    user: msg.user?.username ?? "unknown",
+                    user_followers: msg.user?.followers ?? 0,
+                    sentiment: userSentiment ?? sentimentLabel(finalScore),
+                    sentiment_score: Math.round(finalScore * 100) / 100,
+                    is_rumor: isRumor(body),
+                    likes: msg.likes?.total ?? 0,
+                    reshares: msg.reshares?.reshared_count ?? 0,
+                    url: `https://stocktwits.com/symbol/${symbol}/message/${msg.id}`,
+                });
+            }
+            // We got results; stop trying other formats
+            if (posts.length > 0)
+                break;
+        }
+        catch (err) {
+            // Try next format
+            continue;
+        }
+    }
+    // Sort by date descending
+    posts.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+    // Build summary
+    const bullish = posts.filter((p) => p.sentiment === "bullish").length;
+    const bearish = posts.filter((p) => p.sentiment === "bearish").length;
+    const neutral = posts.length - bullish - bearish;
+    const avgSentiment = posts.length > 0
+        ? Math.round((posts.reduce((s, p) => s + p.sentiment_score, 0) / posts.length) * 100) / 100
+        : 0;
+    // Top contributors
+    const userPosts = {};
+    for (const p of posts) {
+        if (!userPosts[p.user])
+            userPosts[p.user] = { count: 0, totalSentiment: 0 };
+        userPosts[p.user].count++;
+        userPosts[p.user].totalSentiment += p.sentiment_score;
+    }
+    const topContributors = Object.entries(userPosts)
+        .map(([user, data]) => ({
+        user,
+        posts: data.count,
+        avg_sentiment: Math.round((data.totalSentiment / data.count) * 100) / 100,
+    }))
+        .sort((a, b) => b.posts - a.posts)
+        .slice(0, 5);
+    return {
+        scraped_at: isoNow(),
+        ticker,
+        symbol_used: symbolUsed,
+        period_days: days,
+        format,
+        total_posts: posts.length,
+        posts,
+        summary: {
+            bullish_count: bullish,
+            bearish_count: bearish,
+            neutral_count: neutral,
+            total_count: posts.length,
+            bullish_pct: posts.length > 0 ? Math.round((bullish / posts.length) * 100) : 0,
+            bearish_pct: posts.length > 0 ? Math.round((bearish / posts.length) * 100) : 0,
+            avg_sentiment: avgSentiment,
+            top_contributors: topContributors,
+        },
+        rumor_count: posts.filter((p) => p.is_rumor).length,
+        overall_sentiment: avgSentiment,
+        overall_sentiment_label: sentimentLabel(avgSentiment),
+    };
+}
+// ── Test/sample data ─────────────────────────────────────────────
+export function sampleData(ticker) {
+    const t = normalizeTicker(ticker || "BHP");
+    return {
+        scraped_at: isoNow(),
+        ticker: t,
+        symbol_used: `${t}.AX`,
+        period_days: 14,
+        format: "json",
+        total_posts: 5,
+        posts: [
+            {
+                id: 501234567,
+                body: `$${t}.AX about to moon! Insider buying before the ann. Load up! 🚀`,
+                created_at: "2026-02-25T10:30:00Z",
+                user: "AusTrader99",
+                user_followers: 1250,
+                sentiment: "bullish",
+                sentiment_score: 0.83,
+                is_rumor: true,
+                likes: 24,
+                reshares: 8,
+                url: `https://stocktwits.com/symbol/${t}.AX/message/501234567`,
+            },
+            {
+                id: 501234568,
+                body: `$${t}.AX strong quarterly results expected. Accumulating at these levels. Catalyst incoming.`,
+                created_at: "2026-02-24T14:15:00Z",
+                user: "ValueInvest_AU",
+                user_followers: 3400,
+                sentiment: "bullish",
+                sentiment_score: 0.67,
+                is_rumor: false,
+                likes: 45,
+                reshares: 12,
+                url: `https://stocktwits.com/symbol/${t}.AX/message/501234568`,
+            },
+            {
+                id: 501234569,
+                body: `$${t}.AX management dumping shares. This is the top. Short it.`,
+                created_at: "2026-02-23T08:45:00Z",
+                user: "BearishBob",
+                user_followers: 890,
+                sentiment: "bearish",
+                sentiment_score: -0.67,
+                is_rumor: false,
+                likes: 8,
+                reshares: 2,
+                url: `https://stocktwits.com/symbol/${t}.AX/message/501234569`,
+            },
+            {
+                id: 501234570,
+                body: `$${t}.AX heard speculation about a potential takeover target. Unconfirmed but watching closely.`,
+                created_at: "2026-02-22T16:00:00Z",
+                user: "MarketWhispers",
+                user_followers: 5600,
+                sentiment: "bullish",
+                sentiment_score: 0.50,
+                is_rumor: true,
+                likes: 67,
+                reshares: 23,
+                url: `https://stocktwits.com/symbol/${t}.AX/message/501234570`,
+            },
+            {
+                id: 501234571,
+                body: `$${t}.AX holding steady. Waiting for the next earnings report before making a move.`,
+                created_at: "2026-02-21T12:30:00Z",
+                user: "PatientCapital",
+                user_followers: 2100,
+                sentiment: "neutral",
+                sentiment_score: 0.0,
+                is_rumor: false,
+                likes: 12,
+                reshares: 3,
+                url: `https://stocktwits.com/symbol/${t}.AX/message/501234571`,
+            },
+        ],
+        summary: {
+            bullish_count: 3,
+            bearish_count: 1,
+            neutral_count: 1,
+            total_count: 5,
+            bullish_pct: 60,
+            bearish_pct: 20,
+            avg_sentiment: 0.27,
+            top_contributors: [
+                { user: "MarketWhispers", posts: 1, avg_sentiment: 0.50 },
+                { user: "ValueInvest_AU", posts: 1, avg_sentiment: 0.67 },
+                { user: "AusTrader99", posts: 1, avg_sentiment: 0.83 },
+                { user: "BearishBob", posts: 1, avg_sentiment: -0.67 },
+                { user: "PatientCapital", posts: 1, avg_sentiment: 0.0 },
+            ],
+        },
+        rumor_count: 2,
+        overall_sentiment: 0.27,
+        overall_sentiment_label: "bullish",
+    };
+}
+//# sourceMappingURL=stocktwits-asx-scraper.js.map