openplanter 0.2.9 → 0.3.0

package/dist/investigation-tools/asx-options-flow.d.ts

@@ -0,0 +1,75 @@
+/**
+ * asx-options-flow.ts -- ASX Unusual Options Activity Scanner
+ *
+ * Fetches ASX unusual options activity data including call/put volume
+ * spikes. Identifies potential pre-announcement positioning through
+ * abnormal options flow.
+ *
+ * Data sources:
+ *   - ASX options market data
+ *   - Yahoo Finance options chains (.AX)
+ *
+ * Note: ASX options data is limited compared to US markets. This tool
+ * aggregates what's publicly available and uses Yahoo Finance as a
+ * supplementary source.
+ *
+ * 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 OptionContract {
+    type: "call" | "put";
+    strike: number;
+    expiry: string;
+    last_price: number;
+    bid: number;
+    ask: number;
+    volume: number;
+    open_interest: number;
+    implied_volatility: number;
+    in_the_money: boolean;
+}
+export interface UnusualActivity {
+    contract_type: "call" | "put";
+    strike: number;
+    expiry: string;
+    volume: number;
+    open_interest: number;
+    volume_oi_ratio: number;
+    implied_volatility: number;
+    flag_reason: string;
+    signal_strength: "low" | "medium" | "high" | "extreme";
+}
+export interface OptionsFlowSummary {
+    total_call_volume: number;
+    total_put_volume: number;
+    put_call_ratio: number;
+    total_call_oi: number;
+    total_put_oi: number;
+    avg_call_iv: number;
+    avg_put_iv: number;
+    iv_skew: number;
+    nearest_expiry: string;
+}
+export interface AsxOptionsFlowResult {
+    scraped_at: string;
+    ticker: string;
+    symbol: string;
+    period_days: number;
+    threshold: number;
+    total_contracts: number;
+    calls: OptionContract[];
+    puts: OptionContract[];
+    unusual_activity: UnusualActivity[];
+    summary: OptionsFlowSummary;
+    alert_level: "none" | "low" | "medium" | "high";
+    alert_message: string;
+}
+export declare function fetchOptionsFlow(opts: {
+    ticker: string;
+    days?: number;
+    threshold?: number;
+}): Promise<AsxOptionsFlowResult>;
+export declare function sampleData(ticker: string): AsxOptionsFlowResult;
+//# sourceMappingURL=asx-options-flow.d.ts.map

package/dist/investigation-tools/asx-options-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asx-options-flow.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/asx-options-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAqBH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;CACvB;AAmDD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyJhC;AAID,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAgF/D"}

package/dist/investigation-tools/asx-options-flow.js

@@ -0,0 +1,272 @@
+/**
+ * asx-options-flow.ts -- ASX Unusual Options Activity Scanner
+ *
+ * Fetches ASX unusual options activity data including call/put volume
+ * spikes. Identifies potential pre-announcement positioning through
+ * abnormal options flow.
+ *
+ * Data sources:
+ *   - ASX options market data
+ *   - Yahoo Finance options chains (.AX)
+ *
+ * Note: ASX options data is limited compared to US markets. This tool
+ * aggregates what's publicly available and uses Yahoo Finance as a
+ * supplementary source.
+ *
+ * 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 { fetchJson, isoNow, normalizeTicker, yahooTicker, } from "./shared.js";
+// ── Constants ────────────────────────────────────────────────────
+const YAHOO_OPTIONS_URL = "https://query1.finance.yahoo.com/v7/finance/options/{symbol}";
+const DEFAULT_THRESHOLD = 2.0; // Volume must be 2x average to flag
+const DEFAULT_DELAY = 1.0;
+function epochToDate(epoch) {
+    return new Date(epoch * 1000).toISOString().slice(0, 10);
+}
+function classifySignalStrength(volOiRatio, iv) {
+    if (volOiRatio > 10 || iv > 1.5)
+        return "extreme";
+    if (volOiRatio > 5 || iv > 1.0)
+        return "high";
+    if (volOiRatio > 2 || iv > 0.6)
+        return "medium";
+    return "low";
+}
+function determineAlertLevel(unusual) {
+    if (unusual.length === 0)
+        return "none";
+    const hasExtreme = unusual.some((u) => u.signal_strength === "extreme");
+    const hasHigh = unusual.some((u) => u.signal_strength === "high");
+    if (hasExtreme)
+        return "high";
+    if (hasHigh || unusual.length >= 3)
+        return "medium";
+    return "low";
+}
+// ── Fetcher ──────────────────────────────────────────────────────
+export async function fetchOptionsFlow(opts) {
+    const ticker = normalizeTicker(opts.ticker);
+    const symbol = yahooTicker(ticker);
+    const days = opts.days ?? 14;
+    const threshold = opts.threshold ?? DEFAULT_THRESHOLD;
+    const calls = [];
+    const puts = [];
+    const unusual = [];
+    try {
+        const url = YAHOO_OPTIONS_URL.replace("{symbol}", symbol);
+        const data = await fetchJson(url, { delay: DEFAULT_DELAY });
+        const result = data?.optionChain?.result?.[0];
+        if (result?.options) {
+            for (const chain of result.options) {
+                const expiry = chain.expirationDate
+                    ? epochToDate(chain.expirationDate)
+                    : "";
+                // Process calls
+                for (const c of chain.calls ?? []) {
+                    const contract = {
+                        type: "call",
+                        strike: c.strike ?? 0,
+                        expiry,
+                        last_price: c.lastPrice ?? 0,
+                        bid: c.bid ?? 0,
+                        ask: c.ask ?? 0,
+                        volume: c.volume ?? 0,
+                        open_interest: c.openInterest ?? 0,
+                        implied_volatility: Math.round((c.impliedVolatility ?? 0) * 100) / 100,
+                        in_the_money: c.inTheMoney ?? false,
+                    };
+                    calls.push(contract);
+                    // Check for unusual activity
+                    const volOiRatio = contract.open_interest > 0
+                        ? contract.volume / contract.open_interest
+                        : contract.volume > 0 ? 999 : 0;
+                    if (volOiRatio >= threshold || contract.implied_volatility > 0.8) {
+                        unusual.push({
+                            contract_type: "call",
+                            strike: contract.strike,
+                            expiry,
+                            volume: contract.volume,
+                            open_interest: contract.open_interest,
+                            volume_oi_ratio: Math.round(volOiRatio * 100) / 100,
+                            implied_volatility: contract.implied_volatility,
+                            flag_reason: volOiRatio >= threshold
+                                ? `Volume/OI ratio ${volOiRatio.toFixed(1)}x exceeds ${threshold}x threshold`
+                                : `High implied volatility: ${(contract.implied_volatility * 100).toFixed(0)}%`,
+                            signal_strength: classifySignalStrength(volOiRatio, contract.implied_volatility),
+                        });
+                    }
+                }
+                // Process puts
+                for (const p of chain.puts ?? []) {
+                    const contract = {
+                        type: "put",
+                        strike: p.strike ?? 0,
+                        expiry,
+                        last_price: p.lastPrice ?? 0,
+                        bid: p.bid ?? 0,
+                        ask: p.ask ?? 0,
+                        volume: p.volume ?? 0,
+                        open_interest: p.openInterest ?? 0,
+                        implied_volatility: Math.round((p.impliedVolatility ?? 0) * 100) / 100,
+                        in_the_money: p.inTheMoney ?? false,
+                    };
+                    puts.push(contract);
+                    const volOiRatio = contract.open_interest > 0
+                        ? contract.volume / contract.open_interest
+                        : contract.volume > 0 ? 999 : 0;
+                    if (volOiRatio >= threshold || contract.implied_volatility > 0.8) {
+                        unusual.push({
+                            contract_type: "put",
+                            strike: contract.strike,
+                            expiry,
+                            volume: contract.volume,
+                            open_interest: contract.open_interest,
+                            volume_oi_ratio: Math.round(volOiRatio * 100) / 100,
+                            implied_volatility: contract.implied_volatility,
+                            flag_reason: volOiRatio >= threshold
+                                ? `Volume/OI ratio ${volOiRatio.toFixed(1)}x exceeds ${threshold}x threshold`
+                                : `High implied volatility: ${(contract.implied_volatility * 100).toFixed(0)}%`,
+                            signal_strength: classifySignalStrength(volOiRatio, contract.implied_volatility),
+                        });
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(`[asx_options_flow] Fetch error: ${err}`);
+    }
+    // Sort unusual by signal strength
+    const strengthOrder = { extreme: 0, high: 1, medium: 2, low: 3 };
+    unusual.sort((a, b) => strengthOrder[a.signal_strength] - strengthOrder[b.signal_strength]);
+    // Build summary
+    const totalCallVol = calls.reduce((s, c) => s + c.volume, 0);
+    const totalPutVol = puts.reduce((s, p) => s + p.volume, 0);
+    const totalCallOi = calls.reduce((s, c) => s + c.open_interest, 0);
+    const totalPutOi = puts.reduce((s, p) => s + p.open_interest, 0);
+    const avgCallIv = calls.length > 0
+        ? Math.round((calls.reduce((s, c) => s + c.implied_volatility, 0) / calls.length) * 100) / 100
+        : 0;
+    const avgPutIv = puts.length > 0
+        ? Math.round((puts.reduce((s, p) => s + p.implied_volatility, 0) / puts.length) * 100) / 100
+        : 0;
+    const allExpiries = [...calls, ...puts].map((c) => c.expiry).filter(Boolean);
+    const nearestExpiry = allExpiries.sort()[0] ?? "";
+    const alertLevel = determineAlertLevel(unusual);
+    const alertMessage = alertLevel === "none"
+        ? `No unusual options activity detected for ${ticker}.`
+        : alertLevel === "high"
+            ? `HIGH ALERT: ${unusual.length} unusual option flow(s) detected for ${ticker}. Possible pre-announcement positioning.`
+            : `${unusual.length} unusual option flow(s) detected for ${ticker} at ${alertLevel} alert level.`;
+    return {
+        scraped_at: isoNow(),
+        ticker,
+        symbol,
+        period_days: days,
+        threshold,
+        total_contracts: calls.length + puts.length,
+        calls,
+        puts,
+        unusual_activity: unusual,
+        summary: {
+            total_call_volume: totalCallVol,
+            total_put_volume: totalPutVol,
+            put_call_ratio: totalCallVol > 0
+                ? Math.round((totalPutVol / totalCallVol) * 100) / 100
+                : 0,
+            total_call_oi: totalCallOi,
+            total_put_oi: totalPutOi,
+            avg_call_iv: avgCallIv,
+            avg_put_iv: avgPutIv,
+            iv_skew: Math.round((avgPutIv - avgCallIv) * 100) / 100,
+            nearest_expiry: nearestExpiry,
+        },
+        alert_level: alertLevel,
+        alert_message: alertMessage,
+    };
+}
+// ── Test/sample data ─────────────────────────────────────────────
+export function sampleData(ticker) {
+    const t = normalizeTicker(ticker || "BHP");
+    return {
+        scraped_at: isoNow(),
+        ticker: t,
+        symbol: `${t}.AX`,
+        period_days: 14,
+        threshold: 2.0,
+        total_contracts: 24,
+        calls: [
+            { type: "call", strike: 44.00, expiry: "2026-03-20", last_price: 1.85, bid: 1.80, ask: 1.90, volume: 2450, open_interest: 380, implied_volatility: 0.42, in_the_money: true },
+            { type: "call", strike: 45.00, expiry: "2026-03-20", last_price: 1.10, bid: 1.05, ask: 1.15, volume: 5200, open_interest: 620, implied_volatility: 0.48, in_the_money: false },
+            { type: "call", strike: 46.00, expiry: "2026-03-20", last_price: 0.55, bid: 0.50, ask: 0.60, volume: 8100, open_interest: 450, implied_volatility: 0.55, in_the_money: false },
+            { type: "call", strike: 48.00, expiry: "2026-04-17", last_price: 0.25, bid: 0.20, ask: 0.30, volume: 3200, open_interest: 180, implied_volatility: 0.62, in_the_money: false },
+        ],
+        puts: [
+            { type: "put", strike: 43.00, expiry: "2026-03-20", last_price: 0.65, bid: 0.60, ask: 0.70, volume: 1800, open_interest: 520, implied_volatility: 0.38, in_the_money: false },
+            { type: "put", strike: 42.00, expiry: "2026-03-20", last_price: 0.35, bid: 0.30, ask: 0.40, volume: 900, open_interest: 340, implied_volatility: 0.36, in_the_money: false },
+        ],
+        unusual_activity: [
+            {
+                contract_type: "call",
+                strike: 46.00,
+                expiry: "2026-03-20",
+                volume: 8100,
+                open_interest: 450,
+                volume_oi_ratio: 18.0,
+                implied_volatility: 0.55,
+                flag_reason: "Volume/OI ratio 18.0x exceeds 2.0x threshold",
+                signal_strength: "extreme",
+            },
+            {
+                contract_type: "call",
+                strike: 48.00,
+                expiry: "2026-04-17",
+                volume: 3200,
+                open_interest: 180,
+                volume_oi_ratio: 17.78,
+                implied_volatility: 0.62,
+                flag_reason: "Volume/OI ratio 17.8x exceeds 2.0x threshold",
+                signal_strength: "extreme",
+            },
+            {
+                contract_type: "call",
+                strike: 45.00,
+                expiry: "2026-03-20",
+                volume: 5200,
+                open_interest: 620,
+                volume_oi_ratio: 8.39,
+                implied_volatility: 0.48,
+                flag_reason: "Volume/OI ratio 8.4x exceeds 2.0x threshold",
+                signal_strength: "high",
+            },
+            {
+                contract_type: "call",
+                strike: 44.00,
+                expiry: "2026-03-20",
+                volume: 2450,
+                open_interest: 380,
+                volume_oi_ratio: 6.45,
+                implied_volatility: 0.42,
+                flag_reason: "Volume/OI ratio 6.4x exceeds 2.0x threshold",
+                signal_strength: "high",
+            },
+        ],
+        summary: {
+            total_call_volume: 18950,
+            total_put_volume: 2700,
+            put_call_ratio: 0.14,
+            total_call_oi: 1630,
+            total_put_oi: 860,
+            avg_call_iv: 0.52,
+            avg_put_iv: 0.37,
+            iv_skew: -0.15,
+            nearest_expiry: "2026-03-20",
+        },
+        alert_level: "high",
+        alert_message: `HIGH ALERT: 4 unusual option flow(s) detected for ${t}. Possible pre-announcement positioning.`,
+    };
+}
+//# sourceMappingURL=asx-options-flow.js.map

package/dist/investigation-tools/asx-options-flow.js.map

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

package/dist/investigation-tools/glassdoor-asx-analyzer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * glassdoor-asx-analyzer.ts -- Glassdoor ASX Company Review Analyzer
+ *
+ * Analyzes Glassdoor reviews for ASX-listed companies to detect
+ * sentiment spikes and morale shifts that may precede material news.
+ *
+ * Uses Google-indexed Glassdoor pages as Glassdoor blocks direct scraping.
+ * In live mode, searches for recent reviews via search engine indexing.
+ *
+ * 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.
+ *   Glassdoor's Terms of Service restrict automated scraping. This tool uses
+ *   only publicly indexed data from search engines.
+ */
+export interface GlassdoorReview {
+    date: string;
+    rating: number | null;
+    title: string;
+    pros: string;
+    cons: string;
+    sentiment_score: number;
+    sentiment_label: string;
+    pre_news_signals: string[];
+    url: string;
+}
+export interface MoraleTrend {
+    period: string;
+    avg_rating: number | null;
+    avg_sentiment: number;
+    review_count: number;
+    trend_direction: "improving" | "declining" | "stable";
+}
+export interface GlassdoorResult {
+    scraped_at: string;
+    company: string;
+    ticker: string;
+    period_days: number;
+    total_reviews: number;
+    reviews: GlassdoorReview[];
+    morale_trends: MoraleTrend[];
+    overall_sentiment: number;
+    overall_rating: number | null;
+    pre_news_signal_count: number;
+    sentiment_spike_detected: boolean;
+    summary: string;
+}
+export declare function analyzeGlassdoor(opts: {
+    ticker: string;
+    days?: number;
+    minReviews?: number;
+}): Promise<GlassdoorResult>;
+export declare function sampleData(ticker: string): GlassdoorResult;
+//# sourceMappingURL=glassdoor-asx-analyzer.d.ts.map

package/dist/investigation-tools/glassdoor-asx-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glassdoor-asx-analyzer.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/glassdoor-asx-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsCH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,OAAO,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAqDD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqF3B;AAID,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAwF1D"}