Repository navigation
Releases
NewsAlerts v2.12.0
NewsAlerts v2.12.0 — Release Notes
Release Date: October 2026
Type: Minor Release (MINOR — Dual Independent In-App Audio & Telegram Topbar Alert Controls)
Single Source of Truth: VERSION (2.12.0)
🚀 Overview
NewsAlerts v2.12.0 introduces a Dual Independent Alert Controls Architecture with dedicated topbar toggles:
- Dedicated Topbar Telegram Alert Toggle (
#btn-telegram): Adds an institutional topbar icon combining the iconic Telegram paper airplane with an alert bell badge. Traders can now mute or resume Telegram mobile & desktop push notifications with a single click directly from the header without opening Settings. - Decoupled In-App Audio Bell (
#btn-mute): Decouples the primary audio bell toggle so it strictly governs local PC waveform audio alert chimes (alerts.mute). When active momentum day traders are operating directly in front of the workstation, they can silence noisy Telegram phone alerts with 1 click while preserving essential zero-latency PC audio chimes. - Synchronized State & Hotkeys: Bidirectional synchronization connects the topbar Telegram button directly with Settings → Alerts → Enable Telegram Alerts. Supports customizable hotkeys for both local audio mute and Telegram push notification toggling.
🌟 Key Changes & Improvements
1. Dedicated Topbar Telegram Alerts Toggle (Issue #65)
- Added
#btn-telegramimmediately adjacent to the audio bell in the topbar header. - Custom Vector Icon: Custom high-DPI SVG combining the Telegram paper airplane pointing northeast with a docked alert bell badge.
- Institutional Status Feedback:
- Active State: Rendered in Telegram Blue (
#29b6f6) with soft border glow and interactive hover states. - Paused State: Switches to a slashed vector strike (
tgBellOff) with red-tinted background (rgba(246, 70, 93, 0.14)), red border (#ff6b7e), and pulsing alert warning glow (pausePulse).
- Active State: Rendered in Telegram Blue (
- One-Click Instant Execution: Toggling updates
alerts.telegram_enabledin real-time, persists toconfig.json, and reflects immediately across the terminal UI.
2. Fully Decoupled Alert Engine
- In-App Audio Chimes: Governed exclusively by
alerts.mute. Muting local sound chimes no longer suppresses Telegram push alerts if Telegram is enabled. - Telegram Push Notifications: Governed exclusively by
alerts.telegram_enabled(and tape-specific filters/cooldowns). Silencing Telegram at your desk leaves local workstation audio bells fully functional. - Updated backend dispatch in
app/screener.py,app/tape.py,app/api.py, andapp/main.py.
3. Keyboard Shortcut & Hotkey Integration
- Default
mhotkey preserved for rapid In-App Audio Mute. - Added
toggle_telegramhotkey action in keyboard shortcuts configuration, allowing traders to map any preferred key combination to instant Telegram toggling.
4. Startup Alert State Synchronization (Bug Fix)
- Resolved an issue where closing the app with Alerts muted resulted in the topbar alert button displaying as active upon re-opening.
- Both
#btn-muteand#btn-telegramnow immediately synchronize their icons, titles, and.pausedCSS classes against persisted configuration duringinit().
🎯 Closed Issues
🧪 Verification & Test Suite
- Added comprehensive unit tests in
tests/test_alert_controls.pyverifying independent audio and Telegram alert states. - Verified all 66 unit tests pass (
make test/python -m unittest discover tests). - Verified Python syntax compilation across
app,run_app.py, andtests. - Zero secrets committed.
NewsAlerts v2.11.2
NewsAlerts v2.11.2 — Release Notes
Release Date: October 2026
Type: Patch Release (PATCH — Prominent Table Imagery & Universal make env Targets)
Single Source of Truth: VERSION (2.11.2)
🚀 Overview
NewsAlerts v2.11.2 delivers a significant readability upgrade to documentation and developer ergonomics across platforms:
- Prominent Interface Showcase Tables: Refactored the core terminal feature tables in
README.mdanddocs/SPEC.mdto prioritize large, native-resolution screenshots over cramped text, allocating 68% of the width to interface captures and 32% to capability summaries. Screenshots are now immediately readable directly on the page without requiring users to click thumbnails. - Dedicated Cross-Platform
make envTargets: Decoupled virtual environment creation and package installation from binary builds. Developers can now runmake envon any OS (ormake env-win,make env-linux,make env-mac) to configure Python dependencies, whilemake buildfocuses strictly on compiling standalone distribution executables and packages.
🌟 Key Changes & Improvements
1. High-Visibility Feature Showcase Tables (Issue #63)
- Replaced Markdown pipe tables with responsive HTML
<table>elements with fixed column percentage weighting:- Interface Captures (
width="68%"/width="100%"image): Screenshots render at full native width with high-DPI clarity, rounded borders, and subtle institutional drop shadows. - Terminal Capabilities (
width="32%"text): Crisp executive summaries and bullet points aligned neatly alongside the corresponding UI panel.
- Interface Captures (
- Fully synchronized across both
README.mdanddocs/SPEC.md.
2. Universal & OS-Specific make env Targets
make env: Universal auto-detection target. Inspects the host OS (Windows,Linux,macOS), checks or creates the local.venv, upgradespip, and installs all dependencies fromrequirements.txt.make env-win: Dedicated Windows target invoking PowerShell automation.make env-linux: Dedicated Linux target preparingpython3 -m venvand installing packages.make env-mac: Dedicated macOS target preparing Apple Silicon Python virtual environments..\build.ps1 -Task env: Added native PowerShell environment preparation task for Windows developers who do not usemake.
3. Decoupled make build Workflow
- Refactored
make buildto strictly focus on binary compilation (PyInstallerstandalone.exe/.app/ dual package directories) without performing background dependency installations.
🎯 Closed Issues
- Resolves #63: feat(docs): optimize feature showcase tables for prominent imagery and universal make env targets (Resolving PR: #64)
🧪 Verification & Test Suite
- Verified
make env,make env-win, and.\build.ps1 -Task envon Windows. - Verified
make helpdisplays clean target breakdown. - Verified HTML table rendering in Chrome browser with large, crisp screenshots.
- Unit tests:
63/63 tests passed(make test). - Zero secrets committed.
NewsAlerts v2.11.1
NewsAlerts v2.11.1 — Release Notes
Release Date: October 2026
Type: Patch Release (PATCH — Toggleable Opt-Out for BamSEC Filings Visibility & Utilization)
Single Source of Truth: VERSION (2.11.1)
🚀 Overview
NewsAlerts v2.11.1 introduces an institutional opt-out configuration capability for the BamSEC SEC Filings module. While enabled and opt-in by default for rapid catalyst diligence, traders who prefer a streamlined, pure Benzinga/PR wire feed can now completely disable BamSEC with a single setting. When disabled, all BamSEC visual elements are cleanly unmounted from the DOM, and all underlying background scraper calls and timers are halted.
🌟 Key New Features & Capabilities
1. Toggleable Opt-Out Setting (Issue #61)
- Settings → General Toggle:
- Added an intuitive checkbox: "Enable BamSEC Filings" (Opt-in or fully remove BamSEC filings, badges, and background network calls across the terminal).
- Config key
news.bamsec_enableddefaults totrue(opt-in). - When unchecked, dependent settings (such as
Display Layout Mode) are automatically disabled and dimmed.
2. Complete DOM & UI Cleanliness
- When opted out (
news.bamsec_enabled = false):- The
[📑 BamSEC ↗]external launch button next to TradingView chart button is completely omitted. - The
📑 N SECcount badge next to the borrow tag is completely omitted. - The collapsible top drawer accordion and the sub-tabs navigation are completely removed.
- The layout mode switch button (
⊞ Tabs View/⊟ Drawer View) is omitted. - The News pane renders purely as an unencumbered wire news stream.
- The
3. Immediate Network & Scraper Call Suppression
- Backend
Api.get_bamsec()evaluatesnews.bamsec_enabled. When disabled, it immediately returns{"disabled": True}without initializing scraper sessions or performing HTTP requests to BamSEC. - Frontend polling timers in
News.select()and ticker change handlers bypass BamSEC loading entirely when disabled.
4. Reactive Dynamic Reconfiguration
- Saving settings immediately invokes
News.onConfigChanged():- Toggling BamSEC off clears cached data, unmounts drawer/tabs, and re-renders the header cleanly without requiring an application restart.
- Toggling BamSEC back on restores the drawer/tabs and immediately fetches filings for the active ticker.
🎯 Closed Issues
- Resolves #61: feat(settings): toggleable opt-out for BamSEC filings visibility and utilization (Resolving PR: #62)
🧪 Verification & Test Suite
- Python compilation:
compileall app run_app.pypassed with 0 errors. - Unit tests:
63/63 tests passedintests/test_bamsec.pyand full suite. - Verified dynamic live update on settings save without page reload.
NewsAlerts v2.11.0
NewsAlerts v2.11.0 — Release Notes
Release Date: October 2026
Type: Minor Release (MINOR — BamSEC Real-Time SEC Filings, Drawer & Sub-Tabs Layouts)
Single Source of Truth: VERSION (2.11.0)
🚀 Overview
NewsAlerts v2.11.0 introduces native integration with BamSEC (by AlphaSense), providing day traders with instant, real-time access to official SEC EDGAR filings directly alongside catalyst wire news. Traders can now spot offerings, dilution risks, shelf registrations (S-1/S-3/F-3/424B), insider accumulation (Form 3/4/13D), and material press releases (8-K/6-K) without leaving the terminal.
🌟 Key New Features & Capabilities
1. Real-Time BamSEC SEC Filings Integration (Issue #57)
- Automatic Scraper & Caching Service (
app/bamsec.py):- Live fetch and structured extraction of US equity filings directly from BamSEC with in-memory TTL caching (120s) and multi-threaded safety.
- Automatically parses filing categories:
- News (6-K / 8-K): Press releases, dividend declarations, asset sales.
- Offerings & Dilution (S-1, S-3, F-3, 424B, DRS, RW): Secondary offerings, warrant issuances, shelf registrations.
- Ownership & Insiders (Form 3, Form 4, SC 13D, SC 13G): Major activist stakes and insider purchases.
- Financials (10-K, 10-Q, 20-F): Quarterly and annual earnings reports.
- Proxies & Other: Proxy statements (DEF 14A) and regulatory communications.
2. Dual Display Modes: Collapsible Drawer & Sub-Tabs
- ⚡ Collapsible Accordion Drawer (Top of Wire News):
- Collapsible card at the top of the news panel showing filing totals and quick summary counts (
News,Dilution,Insiders). - Expanding the drawer reveals category filter pills and filing rows with color-coded institutional badges.
- State is saved persistently in
App.config.news.bamsec_drawer_open.
- Collapsible card at the top of the news panel showing filing totals and quick summary counts (
- 📑 Sub-Tabs View (
📰 Wire News/📑 BamSEC Filings):- Dedicated sub-tab bar under the ticker inspector.
- Full-featured BamSEC explorer with real-time keyword search, category filters, and grouped filing cards.
- Clicking any symbol from the screener or tape defaults back to the
📰 Wire Newstab for immediate catalyst analysis.
- On-The-Fly Layout Toggle:
- Click
⊞ Tabs Viewor⊟ Drawer Viewright in the news bar to toggle between layouts instantly. - Configurable default mode in Settings → General.
- Click
3. One-Click BamSEC Launching & Direct Filing Links
- Header Action Button (
[📑 BamSEC ↗]): Docked next to the TradingView chart button to jump directly to the company's full directory on BamSEC.com. - Inline Filing Links: Clicking any filing row opens the document view on BamSEC in the browser.
- Filing Count Badge (
📑 17 SEC): Interactive badge next to the borrow tag to open filings immediately.
4. Chrome Full-Screen (F11) Showcase & Privacy Protocol
- Documented in
AGENTS.mdSection 6: native Chrome full-screen (F11) uncropped documentation captures, mandatory credential scrambling, and pitch brochure hero showcases.
🎯 Closed Issues
- Resolves #57: feat(news): integrate BamSEC SEC filings and catalyst links
🧪 Verification & Test Suite
- Python syntax compilation:
compileall app run_app.pypassed with 0 errors. - Unit tests:
60/60 tests passed(including 6 new tests intests/test_bamsec.py). - Security audit: Verified zero private tokens, cookies, or secrets staged.
NewsAlerts v2.10.3
NewsAlerts v2.10.3 — Release Notes
Release Date: October 2026
Type: Patch Release (PATCH — Ban Symbol API Routes & Optimistic UI Synchronization)
Single Source of Truth: VERSION (2.10.3)
🚀 Overview
NewsAlerts v2.10.3 fixes an unhandled TypeError during inline 🚫 symbol blacklisting on the Running Momentum Tape and Screener grid caused by missing server API routes. In addition, UI synchronization is now executed optimistically and synchronously so row buttons, topbar badges, and table filters instantly reflect banned/unbanned state without lag or freezing.
🛠️ Key Bug Fixes & Enhancements
1. Ban & Filter Banned API Route Registration (Issue #54)
- Server Routes (
app/server.py):- Registered
/api/ban_symbol(POST),/api/unban_symbol(POST), and/api/toggle_filter_banned(POST) endpoints routing directly toapi.ban_symbol(),api.unban_symbol(), andapi.toggle_filter_banned().
- Registered
- Client API Mapping (
web/js/util.js):- Implemented
ban_symbol(symbol),unban_symbol(symbol), andtoggle_filter_banned(enabled)helpers in_api. - Resolved
TypeError: App.api().ban_symbol is not a functionwhich previously aborted execution and prevented downstream UI updates.
- Implemented
2. Optimistic & Resilient UI Synchronization (web/js/app.js)
- Instant UI Refresh:
- When clicking 🚫 on Tape or Screener,
App.config.banned_symbolsis updated in memory and UI renderers (updateFilterBannedButton(),Screener.renderTable(),Tape.renderAll(),News.renderHead()) are executed immediately before network dispatch. - Buttons immediately reflect the red
.is-bannedactive state (or the row is hidden if filter is active), and topbar counter increments instantly.
- When clicking 🚫 on Tape or Screener,
- Safe Network Dispatch:
- Backend API invocations (
App.api().ban_symbol(),App.api().unban_symbol(),App.api().toggle_filter_banned()) are wrapped intry...catchblocks to protect client responsiveness against temporary network glitches.
- Backend API invocations (
3. Tape Alert Count Filter (web/js/tape.js)
- Banned Event Suppression in Header:
- Updated
Tape.updateNewBtn()to filter out banned symbols when calculating visible alert count (vis) whilefilter_bannedis active.
- Updated
🎯 Closed Issues
- Resolves #54: fix(tape): wire ban_symbol API routes and update UI synchronously on symbol ban/unban
🧪 Verification & Test Suite
- Syntax compilation:
compileall app run_app.pypassed with 0 errors. - Unit tests:
50/50 tests passed(including 3 new server route tests for/api/ban_symbol,/api/unban_symbol, and/api/toggle_filter_banned). - Secret audit: Verified 0 sensitive tokens in staged changes.
NewsAlerts v2.10.2
NewsAlerts v2.10.2 — Release Notes
Release Date: October 2026
Type: Patch Release (PATCH — Topbar Banned Count Sync & Terminal Showcase Media)
Single Source of Truth: VERSION (2.10.2)
🚀 Overview
NewsAlerts v2.10.2 fixes a client-side badge desynchronization bug in the top banner [🚫 Banned: ON (N)] toggle pill and updates the flagship terminal showcase assets across the documentation, README, and GitHub Wiki with live institutional captures.
🛠️ Key Bug Fixes & Enhancements
1. Topbar Banned Filter Count Synchronization (Issue #48)
- Settings Save Reaction:
- Exposed
App.updateFilterBannedButton()globally. - Wired
#settings-save.onclickto automatically invokeApp.updateFilterBannedButton()upon saving configuration changes. - When new symbols (e.g.
CLIK) are added to or removed from the Banned Stocks list in Settings, the topbar filter badge immediately reflects the exact total count (e.g.Banned: ON (2)) without requiring manual toggling OFF and ON again.
- Exposed
- Resilient Symbol Matching:
- Standardized symbol qualification across Screener (
web/js/screener.js), Tape (web/js/tape.js), and News wire (web/js/news.js) to match against both bare ticker symbols (e.g.CLIK) and exchange-qualified formats (e.g.NASDAQ:CLIK).
- Standardized symbol qualification across Screener (
2. High-Resolution Terminal & Settings Showcase Media (Issue #48)
- Flagship Terminal Screenshot (
docs/img/terminal.png):- Updated to live institutional terminal capture featuring the active
[🚫 Banned: ON]pill, 1-click blacklisting buttons, live momentum prints, and Screener grid. - Integrated into
README.md,docs/wiki/Home.md, anddocs/wiki/Catalyst-News-Wire-&-Benzinga.md.
- Updated to live institutional terminal capture featuring the active
- Banned Stocks Settings Manager (
docs/img/banned_stocks.png):- Added dedicated interface screenshot displaying the Banned Stocks interactive chip list, manual
+ Add Symbolinput bar, and active toggle switch. - Embedded into
README.mdshowcase table,docs/wiki/Real-Time-Momentum-Screener.md, anddocs/wiki/Running-Momentum-Tape.md.
- Added dedicated interface screenshot displaying the Banned Stocks interactive chip list, manual
🎯 Closed Issues
- Resolves #48: fix(settings): refresh topbar banned badge count on save and update terminal showcase screenshots
NewsAlerts v2.10.1
NewsAlerts v2.10.1 — Release Notes
Release Date: October 2026
Type: Patch Release (PATCH — Momentum Tape Squeeze Filter Precision & 5-Min Watchlist Auto-Sync)
Single Source of Truth: VERSION (2.10.1)
🚀 Overview
NewsAlerts v2.10.1 resolves critical false-positive surge triggers in the Running Momentum Tape Engine and introduces 5-Minute Periodic Auto-Refresh Synchronization for TradingView Cloud Watchlists.
In previous versions, micro-cap stocks with high intraday percentage changes (such as STAK) could repeatedly trigger Squeeze Alert - Up 5% in 5min and Up 10% in 10min on the tape even while consolidating tightly or declining from premarket highs. Version 2.10.1 establishes rigorous rolling-window upward progression rules, eliminates invalid premarket server-velocity fallbacks, and ensures watchlists auto-synchronize symbol counts without manual button clicks.
🛠️ Key Bug Fixes & Enhancements
1. Elimination of False Squeeze Alerts on Flat & Declining Stocks (Issue #46)
-
Pre/Post-Market Server-Velocity Isolation:
- Identified that TradingView screener
change|5andchange|15fields return static deltas against yesterday's regular session close during extended hours (e.g.STAKreturned ~9.68% and ~11.43%). - Restricted TradingView
change|5andchange|15velocity evaluation strictly to regular market sessions (session == "reg"). In premarket and postmarket sessions, surge velocity is now exclusively calculated from verified in-memory tick-by-tick rolling history (st.hist).
- Identified that TradingView screener
-
Strict Rolling-Window Surge Geometry:
- Enforces upward chronological validation: the window low must occur before the surge high (
t_min < t_max). Downward moves or selloffs from peaks can never trigger a squeeze alert. - Enforces crest proximity: current price must be actively near the surge peak (
price >= max_p * 0.975). Stocks that dumped from peaks (e.g.STAKdown -13% from $2.13) are strictly rejected.
- Enforces upward chronological validation: the window low must occur before the surge high (
-
Anti-Spam Price Progression Rule:
- Once alerted at price
$P_{alert}$ , the tape will never re-fire at the same or lower price. - Ongoing surge alerts require a progressive price advancement of at least
$+1.0%$ above the previous alert price ($P_{new} \ge P_{alert} \times 1.01$ ). - Once the time window has elapsed, re-alerting requires a completely new local low formed after the previous alert followed by a fresh
$+up_pct%$ surge.
- Once alerted at price
-
Removed Flawed Intraday Fallback:
- Eliminated the fallback
not st.hist and session_chg >= up_pctwhich previously treated any stock up$+5%$ or$+10%$ on the day as having surged in 5 minutes.
- Eliminated the fallback
2. TradingView Watchlist 5-Minute Auto-Refresh Synchronization (Issue #46)
- Integrated an automatic background synchronization interval (
setInterval) running every 5 minutes (300,000 ms) ininitWatchlistControl(). - Automatically queries TradingView Cloud Watchlists (
/api/tv_watchlists), refreshing symbol counts and titles (e.g., updating when stocks are removed externally in TradingView). - Preserves the currently selected watchlist in the dropdown without disruption or jumping.
- Background sync runs silently without disruptive toasts; manual clicks on the
🔄button continue to provide visual spinning feedback and confirmation toasts.
🎯 Closed Issues
- Resolves #46: fix(tape): eliminate false squeeze alerts on declining stocks and add 5-minute watchlist auto-refresh
NewsAlerts v2.10.0
NewsAlerts v2.10.0 — Release Notes
Release Date: October 2026
Type: Minor Release (MINOR — Broker Closing-Only & Banned Stock Filter Engine)
Single Source of Truth: VERSION (2.10.0)
🚀 Overview
NewsAlerts v2.10.0 introduces the Broker Closing-Only & Banned Stock Filter Engine, specifically addressing a critical pain point for day traders using Interactive Brokers (IBKR) and other active retail/institutional brokerages: un-tradeable stocks placed into "closing-only" or margin-restricted status (such as YMAT on NASDAQ.SCM).
Because broker risk departments restrict high-risk micro-caps internally without broadcasting public market feed flags, traders previously suffered rejected orders and wasted attention. Version 2.10.0 gives traders total control with an instant Top Banner Toggle Switch, 1-Click 🚫 Symbol Blacklisting, and a Dedicated Settings Manager.
🛠️ Key Additions & Architectural Enhancements
1. Interactive Topbar Filter Toggle ([🚫 Banned: ON / OFF])
- Docked directly in the main navigation banner alongside the session selectors.
- Features vibrant institutional color feedback:
- Inactive (
OFF): Clean dark badge (Banned: OFF). - Active (
ON (N)): Vibrant red/amber institutional badge (Banned: ON (N)) displaying the active banned count with subtle glowing border.
- Inactive (
- Instantly hides all banned symbols across both the Momentum Screener grid and the Running Tape stream without page reload.
- Suppresses audible chimes and Telegram notifications for all banned tickers while the filter is active.
2. 1-Click Symbol Blacklisting (🚫)
- Added a compact
🚫button directly adjacent to ticker symbols in:- Screener Rows: Click 🚫 next to any symbol to ban it immediately.
- Running Tape Events: Click 🚫 on any momentum card to ban the symbol directly from the tape.
- News Headline Banner: Click 🚫 on the active inspected ticker in the catalyst pane header.
- Popout Tape Window: Works seamlessly in detached multi-monitor floating tape windows.
- Provides immediate visual toast confirmation. When the filter is active, banned symbols immediately disappear from active tables.
3. Settings Banned Stocks Manager (Settings → 🚫 Banned Stocks)
- Dedicated settings tab allowing traders to:
- Toggle global filter activation state.
- View all banned symbols as interactive chips with one-click
✕removal buttons. - Manually add tickers via text input (with automatic uppercase sanitization and Enter key support).
- Clear all banned tickers with a single click.
- Shows real-time symbol count badges.
- Persists state in
%APPDATA%\NewsAlerts\config.jsonunderbanned_symbols(pre-seeded withYMAT) andfilter_banned.
🎯 Closed Issues
- Resolves #44: feat(screener): add closing-only banned stock filter toggle and 1-click symbol blacklisting
NewsAlerts v2.9.0
NewsAlerts v2.9.0 — Release Notes
Release Date: October 2026
Type: Minor Release (MINOR — New Distribution Formats & Setup Installer)
Single Source of Truth: VERSION (2.9.0)
🚀 Overview
NewsAlerts v2.9.0 introduces the Dual Distribution Model, providing day traders with two distinct packaging formats:
- High-Performance Unpacked Application & Setup Installer: Pre-extracted directory targeting
%LOCALAPPDATA%\Programs\NewsAlertswith an Inno Setup installer wizard (NewsAlerts-Setup-v2.9.0.exe). This eliminates PyInstaller%TEMP%extraction and real-time antivirus interception delays, accelerating cold startup from ~2.0s down to sub-300ms (<0.2s warm starts). - Portable Standalone Executable: The traditional single-file binary (
NewsAlerts.exe) for drop-in, zero-installation use cases and USB drives.
⚡ Performance Benchmarks
| Metric | Standalone Portable (--onefile) |
Installed / Unpacked (--onedir) |
Improvement |
|---|---|---|---|
| Cold Launch Time | ~1.8s – 2.4s | ~0.3s – 0.4s | ~5x faster |
| Warm Launch Time | ~1.1s | < 0.2s (Instant) | ~5.5x faster |
| Antivirus Scan Delay | High (every launch in %TEMP%) |
Zero (scanned once during install) | Complete elimination |
| Windows OS Page Cache | Ineffective across unique temp paths | Full utilization (SysMain/RAM cache) |
Immediate asset read |
🛠️ Key Additions & Architectural Enhancements
1. Dual-Target PyInstaller Pipeline (NewsAlerts.spec)
- Generates both the portable single-executable (
dist/NewsAlerts.exe) and the unpacked application bundle (dist/NewsAlerts-App/) simultaneously in a single 25-second build pass.
2. Inno Setup Windows Installer (installer/NewsAlerts.iss)
- Modern, lightweight installer (~13.5 MB compressed with LZMA2).
- Per-user installation into
%LOCALAPPDATA%\Programs\NewsAlerts(no UAC / Administrator elevation required). - Generates Start Menu (
{autoprograms}) and Desktop shortcuts with proper application icon. - Registers a clean uninstaller in Windows Settings → Installed Apps.
3. Build & Make Automation
- PowerShell (
build.ps1):.\build.ps1 -Task build— Builds both portable and unpacked targets..\build.ps1 -Task run-app— Launches unpacked app directly fromdist\NewsAlerts-App\..\build.ps1 -Task install-local— Installs directly into%LOCALAPPDATA%\Programs\NewsAlertsand creates desktop shortcuts..\build.ps1 -Task installer— Compiles Inno Setup installer viaiscc.
- Universal Makefile (
Makefile):- Added targets:
run-app,install-local, andinstaller.
- Added targets:
4. macOS Native Application Bundle & DMG Installer
install.shautomatically constructs a native macOS~/Applications/NewsAlerts.appbundle with Apple Silicon support, Apple.icnsicon, andInfo.plist, making NewsAlerts searchable in Spotlight and launchable from Launchpad and Dock.- Release workflow generates native Apple Disk Image (
NewsAlerts-macOS-arm64.dmg) with drag-and-drop installer into/Applications.
5. GitHub Actions CI/CD Integration (.github/workflows/release.yml)
- Windows release runner installs Inno Setup via Chocolatey (
choco install innosetup --no-progress). - Publishes official installer executable
NewsAlerts-Setup-v2.9.0.exealongside the portable zipNewsAlerts-Windows-x64.zipand native macOS DMGNewsAlerts-macOS-arm64.dmgin GitHub Releases.
6. Secrets Storage Transparency & One-Click Native Folder Launch
- Added real-time filesystem transparency in Settings → About and Settings → Backup & Sync, displaying the active resolved OS directory (
APP_DIR) alongside an interactive 📂 Open Folder button to launch Explorer / Finder directly. - Clarified credential management status (
config.jsonvs optionalkeys.tomloverride).
7. Universal US-Listed Stock Coverage (Fix for Foreign-Incorporated Issuers)
- Removed restrictive
country == "United States"filter from base scanner queries. All stocks listed on major US exchanges (NASDAQ,NYSE,AMEX) are now fully covered regardless of corporate jurisdiction (e.g.SAIQ,GCT,TOP, Canadian/BVI/Cayman issuers). - Resolves issue where valid US-listed momentum runners were omitted from screener and news custom inspection.
🎯 Closed Issues
NewsAlerts v2.8.1
NewsAlerts v2.8.1 Release Notes
Release Date: 2026-10-23
Release Tag: v2.8.1
SemVer Specification: 2.8.1 (Major: 2, Minor: 8, Patch: 1)
🚀 Overview
NewsAlerts v2.8.1 resolves a critical UI freeze and cross-thread deadlock that occurred when saving settings after tuning audio chimes or reviewing configuration options. In addition, it optimizes configuration updates by eliminating redundant background network calls (re-authentication and 15MB bulk asset fetches) when credentials have not changed.
🎯 Closed Issues
- Issue #37:
fix(settings): eliminate cross-thread UI deadlock on save settings and redundant background syncs— Resolves in PR #38.
🛠️ Bug Fixes & Architectural Hardening
1. Eliminated Cross-Thread WinForms Deadlock (set_on_top)
- Root Cause: When clicking "Save Settings",
Settings.applyUi()dispatchedPOST /api/set_on_top. In the backend WSGI worker thread, assigningpywebview'swindow.on_topcalledwinforms.py:1006(i.TopMost = on_top) off the main UI thread without proper message marshaling, freezing the COM / WinForms event loop and leaving the entire application unresponsive. - Resolution:
- In
app/api.py,set_on_topnow interacts directly with Win32user32.SetWindowPoson Windows using the form's HWND (HWND_TOPMOST/HWND_NOTOPMOSTwithSWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE), which is completely thread-safe and non-blocking. - Caches
_on_top_stateto immediately short-circuit redundant calls. - In
web/js/settings.js,Settings._currentOnTopcaches the current window state and only dispatches/api/set_on_topwhenalways_on_tophas actually changed.
- In
2. Guarded Against Redundant Network Operations on Settings Save
- TradingView Session Guard (
tv_client.py):set_cookies()now verifies whethersessionidandsessionid_signhave actually changed before clearing cookies and spawning a background auth verification HTTP request. - Alpaca Bulk Asset Sync Guard (
borrow.py):update_credentials()now verifies whetherkey_id,secret_key, andmodehave changed before spawning a new thread to download and process 14,000+ US equity records.
🧪 Verification & Quality Gate
- Python syntax compilation passed cleanly across all runtime modules (
app/*.py,run_app.py,tests/*.py). - Unit test suite expanded to 39 unit tests, all passing at 100%.
- Verified secret leak gate with zero credentials committed.