Jann/investment-sandbox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Closes #017 - Fix KaTeX rendering corruption and inject detailed blueprint contents

Browse Source
This commit is contained in:
Antigravity Agent
2026-06-14 12:41:18 +02:00
parent 94ccf63a38
commit 2f0599a3cd
6 changed files with 154 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
DEV_LOG.md
View File

@@ -182,3 +182,23 @@ This document tracks all modifications, npm packages, active compilation states,
### Active Bugs / Compile Status ### Active Bugs / Compile Status
* **Active Bugs**: None. * **Active Bugs**: None.
* **Type Checker Status**: Verified 100% clean compilation (`npx tsc --noEmit` returns exit code 0). * **Type Checker Status**: Verified 100% clean compilation (`npx tsc --noEmit` returns exit code 0).
---
## [2026-06-14] - Master-Pattern KaTeX Fix & Deep Blueprint Injection (#ISSUE-017)
### Added
* **Detailed Mathematics in Operational Blueprints**: Expanded and injected formal quantitative formulas, parameter definitions, and estimation window thresholds inside:
* `components/modules/scanner/ScannerBlueprintModal.tsx` (Welles Wilder RSI-14 EMA smoothing, 52-Week Drop thresholds, and FMP Valuation Overlay to Forward P/E transitions).
* `components/modules/events/EconometricsBlueprintModal.tsx` (Event Studies layout, 120-day Estimation Window, 10-day Gap Isolation Shield, and Cumulative Abnormal Returns CAR aggregation formulas).
* `components/modules/tech/TechBlueprintModal.tsx` (AI CapEx cycle parameters, SEC 10-Q filing parsers, Monetization Gap, and Supply-Chain Velocity Index formulas).
### Modified
* **KaTeX "Kaputt-repariert" Mitigation**: Audited and rewritten `components/modules/crypto/CryptoMathModal.tsx` to completely resolve formatting corruption by establishing the golden master single-backslash pattern and converting all double backslashes (`\\`) in math strings to single backslashes (`\`), with correct matrix formatting.
* **System-Wide Variable Unification**: Unified and wrapped all mathematical variables (such as `S_1`, `S_2`, `S_3`, `S_i`, `S_j`, `w`, `k` in Crypto, and other parameters across Scanner, Macro, and Econometrics modals) inside native `<InlineMath>` components.
* **`QUANT_ROADMAP.md`**: Updated Section 1 and registered Phase 5.5.
### Active Bugs / Compile Status
* **Active Bugs**: None.
* **Type Checker Status**: Verified 100% clean type verification (`npx tsc --noEmit` returns exit code 0).

3
QUANT_ROADMAP.md
View File

@@ -26,6 +26,9 @@ This document serves as the permanent, centralized system architecture design an
* **Phase 5.0: Native KaTeX Rig & Dual-Handbook System** * **Phase 5.0: Native KaTeX Rig & Dual-Handbook System**
* *Features*: Refactored all 8 sandbox modules to feature a unified twin-modal header layout (`📖 Quantitative Handbook` and `⚙️ Operational Blueprint`). Replaced all inline string-escaped LaTeX with native React `react-katex` calls to completely eliminate escaping anomalies. Authored 8 new functional operational blueprints explaining scanner, whale, and math mechanics. * *Features*: Refactored all 8 sandbox modules to feature a unified twin-modal header layout (`📖 Quantitative Handbook` and `⚙️ Operational Blueprint`). Replaced all inline string-escaped LaTeX with native React `react-katex` calls to completely eliminate escaping anomalies. Authored 8 new functional operational blueprints explaining scanner, whale, and math mechanics.
* *Status*: **Fully Operational (Production Lock)**. * *Status*: **Fully Operational (Production Lock)**.
* **Phase 5.5: Master-Pattern KaTeX Fix & Operational Blueprint Injection**
* *Features*: Completely repaired remaining KaTeX rendering corruption in `CryptoMathModal.tsx` by converting it to the golden master single-backslash pattern. Unified math variables wrapping in text blocks across all math modals. Injected ultra-detailed operational specification matrices (Welles Wilder EMAs, Event Study isolation shields, abnormal returns, CAR, Monetization Gap, and Supply-Chain Velocity Index) directly into the operational blueprint modals for the Scanner, Econometrics, and Tech Silo modules.
* *Status*: **Fully Operational (Production Lock)**.
--- ---

44
components/modules/crypto/CryptoMathModal.tsx
View File

@@ -62,15 +62,15 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
</p> </p>
<div className="grid grid-cols-3 gap-3 text-xs text-slate-400 font-mono text-center"> <div className="grid grid-cols-3 gap-3 text-xs text-slate-400 font-mono text-center">
<div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50"> <div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50">
<span className="block text-rose-400 font-bold">State 1 (S1)</span> <span className="block text-rose-400 font-bold">State 1 (<InlineMath math="S_1" />)</span>
<span>Bearish Squeeze / Crackdown</span> <span>Bearish Squeeze / Crackdown</span>
</div> </div>
<div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50"> <div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50">
<span className="block text-slate-300 font-bold">State 2 (S2)</span> <span className="block text-slate-300 font-bold">State 2 (<InlineMath math="S_2" />)</span>
<span>Consolidation / Mean Reversion</span> <span>Consolidation / Mean Reversion</span>
</div> </div>
<div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50"> <div className="bg-slate-950/40 p-3 rounded-lg border border-slate-800/50">
<span className="block text-emerald-400 font-bold">State 3 (S3)</span> <span className="block text-emerald-400 font-bold">State 3 (<InlineMath math="S_3" />)</span>
<span>Parabolic Bull Run</span> <span>Parabolic Bull Run</span>
</div> </div>
</div> </div>
@@ -83,9 +83,9 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
Calculates transition probabilities over rolling 90-day return vectors: Calculates transition probabilities over rolling 90-day return vectors:
</p> </p>
<div className="bg-slate-950/40 p-4 rounded-xl border border-slate-800/60 my-2"> <div className="bg-slate-950/40 p-4 rounded-xl border border-slate-800/60 my-2">
<BlockMath math="P = \\begin{bmatrix} p_{11} & p_{12} & p_{13} \\\\ p_{21} & p_{22} & p_{23} \\\\ p_{31} & p_{32} & p_{33} \\end{bmatrix}" /> <BlockMath math="P = \begin{bmatrix} p_{11} & p_{12} & p_{13} \\ p_{21} & p_{22} & p_{23} \\ p_{31} & p_{32} & p_{33} \end{bmatrix}" />
<p className="text-[11px] text-slate-400 font-mono mt-2 text-center"> <p className="text-[11px] text-slate-400 font-mono mt-2 text-center">
{"where "}<InlineMath math="p_{ij} = P(X_{t+1} = S_j \\mid X_t = S_i)" />{" represents the frequency probability of moving from State i to State j."} where <InlineMath math="p_{ij} = P(X_{t+1} = S_j \mid X_t = S_i)" /> represents the frequency probability of moving from State <InlineMath math="S_i" /> to State <InlineMath math="S_j" />.
</p> </p>
</div> </div>
</div> </div>
@@ -97,13 +97,13 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
When external alpha inputs (e.g. Funding Rate anomalies, Whale inflows) occur, state probabilities are updated using Bayes' theorem: When external alpha inputs (e.g. Funding Rate anomalies, Whale inflows) occur, state probabilities are updated using Bayes' theorem:
</p> </p>
<div className="bg-slate-950/40 p-4 rounded-xl border border-slate-800/60 my-2"> <div className="bg-slate-950/40 p-4 rounded-xl border border-slate-800/60 my-2">
<BlockMath math="P(S_i \\mid \\text{Alpha}) = \\frac{P(\\text{Alpha} \\mid S_i) \\times P(S_i)}{\\sum_{j=1}^3 P(\\text{Alpha} \\mid S_j) \\times P(S_j)}" /> <BlockMath math="P(S_i \mid \text{Alpha}) = \frac{P(\text{Alpha} \mid S_i) \times P(S_i)}{\sum_{j=1}^3 P(\text{Alpha} \mid S_j) \times P(S_j)}" />
<p className="text-[11px] text-slate-400 mt-2 font-mono leading-relaxed"> <p className="text-[11px] text-slate-400 mt-2 font-mono leading-relaxed">
{"Where:"} Where:
<br /> <br />
{"- "}<InlineMath math="P(S_i)" />{" is the prior state probability from the Markov transition matrix."} - <InlineMath math="P(S_i)" /> is the prior state probability from the Markov transition matrix.
<br /> <br />
{"- "}<InlineMath math="P(\\text{Alpha} \\mid S_i)" />{" is the conditional likelihood of observing this whale spike / funding squeeze in State i."} - <InlineMath math="P(\text{Alpha} \mid S_i)" /> is the conditional likelihood of observing this whale spike / funding squeeze in State <InlineMath math="S_i" />.
</p> </p>
</div> </div>
</div> </div>
@@ -125,7 +125,7 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
<p className="text-xs text-slate-400 leading-relaxed pt-2"> <p className="text-xs text-slate-400 leading-relaxed pt-2">
The Random Forest ensemble evaluates 10 non-linear decision trees to output the short-term and medium-term trend probabilities: The Random Forest ensemble evaluates 10 non-linear decision trees to output the short-term and medium-term trend probabilities:
</p> </p>
<BlockMath math="P_{\\text{ML}} = \\frac{1}{M} \\sum_{m=1}^{M} T_m(FR_t, OI_t, LS_t, W_t)" /> <BlockMath math="P_{\text{ML}} = \frac{1}{M} \sum_{m=1}^{M} T_m(FR_t, OI_t, LS_t, W_t)" />
</div> </div>
</div> </div>
@@ -138,23 +138,23 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
<div className="bg-slate-950/40 p-5 rounded-2xl border border-slate-850 space-y-4"> <div className="bg-slate-950/40 p-5 rounded-2xl border border-slate-850 space-y-4">
<div> <div>
<p className="text-xs text-slate-350 mb-2 font-semibold">1. Prior Distribution (Accuracy History):</p> <p className="text-xs text-slate-350 mb-2 font-semibold">1. Prior Distribution (Accuracy History):</p>
<BlockMath math="\\theta \\sim \\text{Beta}(\\alpha_{\\text{prior}}, \\beta_{\\text{prior}})" /> <BlockMath math="\theta \sim \text{Beta}(\alpha_{\text{prior}}, \beta_{\text{prior}})" />
<p className="text-[10px] text-slate-500 font-mono"> <p className="text-[10px] text-slate-500 font-mono">
where <InlineMath math="\\alpha_{\\text{prior}}" /> represents historical prediction successes and <InlineMath math="\\beta_{\\text{prior}}" /> represents false alarms. where <InlineMath math="\alpha_{\text{prior}}" /> represents historical prediction successes and <InlineMath math="\beta_{\text{prior}}" /> represents false alarms.
</p> </p>
</div> </div>
<div> <div>
<p className="text-xs text-slate-350 mb-2 font-semibold">2. Likelihood Formulation (Binomial pseudo-observations):</p> <p className="text-xs text-slate-350 mb-2 font-semibold">2. Likelihood Formulation (Binomial pseudo-observations):</p>
<BlockMath math="P(x \\mid \\theta) = \\binom{w}{k} \\theta^k (1 - \\theta)^{w - k}" /> <BlockMath math="P(x \mid \theta) = \binom{w}{k} \theta^k (1 - \theta)^{w - k}" />
<p className="text-[10px] text-slate-500 font-mono"> <p className="text-[10px] text-slate-500 font-mono">
where <InlineMath math="k = P_{\\text{ML}} \\times w" /> is the number of simulated successes and <InlineMath math="w - k = (1 - P_{\\text{ML}}) \\times w" /> is the number of simulated failures. where <InlineMath math="k = P_{\text{ML}} \times w" /> is the number of simulated successes and <InlineMath math="w - k = (1 - P_{\text{ML}}) \times w" /> is the number of simulated failures.
</p> </p>
</div> </div>
<div> <div>
<p className="text-xs text-slate-350 mb-2 font-semibold">3. Conjugate Posterior Update:</p> <p className="text-xs text-slate-350 mb-2 font-semibold">3. Conjugate Posterior Update:</p>
<BlockMath math="\\alpha_{\\text{post}} = \\alpha_{\\text{prior}} + k, \\quad \\beta_{\\text{post}} = \\beta_{\\text{prior}} + (w - k)" /> <BlockMath math="\alpha_{\text{post}} = \alpha_{\text{prior}} + k, \quad \beta_{\text{post}} = \beta_{\text{prior}} + (w - k)" />
</div> </div>
</div> </div>
</div> </div>
@@ -163,20 +163,20 @@ export default function CryptoMathModal({ isOpen, onClose }: CryptoMathModalProp
<div className="space-y-3"> <div className="space-y-3">
<h4 className="text-xs font-bold text-cyan-400 uppercase tracking-wider font-mono">F. Mathematical Proof of Posterior Mean Integration</h4> <h4 className="text-xs font-bold text-cyan-400 uppercase tracking-wider font-mono">F. Mathematical Proof of Posterior Mean Integration</h4>
<p className="text-xs leading-relaxed text-slate-400"> <p className="text-xs leading-relaxed text-slate-400">
To resolve a single operational point-estimate from our posterior distribution, we integrate out the continuous parameter <InlineMath math="\\theta" /> to calculate the mathematical expectation of the posterior distribution: To resolve a single operational point-estimate from our posterior distribution, we integrate out the continuous parameter <InlineMath math="\theta" /> to calculate the mathematical expectation of the posterior distribution:
</p> </p>
<div className="bg-slate-950/40 p-5 rounded-2xl border border-slate-850 space-y-4"> <div className="bg-slate-950/40 p-5 rounded-2xl border border-slate-850 space-y-4">
<p className="text-xs text-slate-350 font-semibold">Posterior Expectation Integral Proof:</p> <p className="text-xs text-slate-350 font-semibold">Posterior Expectation Integral Proof:</p>
<BlockMath math="\\mathbb{E}[\\theta \\mid \\text{Data}] = \\int_{0}^{1} \\theta \\cdot P(\\theta \\mid \\text{Data}) \\, d\\theta = \\int_{0}^{1} \\theta \\cdot \\frac{\\theta^{\\alpha_{\\text{post}}-1}(1-\\theta)^{\\beta_{\\text{post}}-1}}{\\text{B}(\\alpha_{\\text{post}}, \\beta_{\\text{post}})} \\, d\\theta" /> <BlockMath math="\mathbb{E}[\theta \mid \text{Data}] = \int_{0}^{1} \theta \cdot P(\theta \mid \text{Data}) \, d\theta = \int_{0}^{1} \theta \cdot \frac{\theta^{\alpha_{\text{post}}-1}(1-\theta)^{\beta_{\text{post}}-1}}{\text{B}(\alpha_{\text{post}}, \beta_{\text{post}})} \, d\theta" />
<p className="text-xs text-slate-400 leading-relaxed"> <p className="text-xs text-slate-400 leading-relaxed">
Using the definition of the Beta function <InlineMath math="\\text{B}(a, b) = \\frac{\\Gamma(a)\\Gamma(b)}{\\Gamma(a+b)}" /> and the recurrence relation <InlineMath math="\\Gamma(x+1) = x\\Gamma(x)" />: Using the definition of the Beta function <InlineMath math="\text{B}(a, b) = \frac{\Gamma(a)\Gamma(b)}{\Gamma(a+b)}" /> and the recurrence relation <InlineMath math="\Gamma(x+1) = x\Gamma(x)" />:
</p> </p>
<BlockMath math="\\mathbb{E}[\\theta \\mid \\text{Data}] = \\frac{\\text{B}(\\alpha_{\\text{post}} + 1, \\beta_{\\text{post}})}{\\text{B}(\\alpha_{\\text{post}}, \\beta_{\\text{post}})} = \\frac{\\Gamma(\\alpha_{\\text{post}} + 1)\\Gamma(\\beta_{\\text{post}})}{\\Gamma(\\alpha_{\\text{post}} + \\beta_{\\text{post}} + 1)} \\cdot \\frac{\\Gamma(\\alpha_{\\text{post}} + \\beta_{\\text{post}})}{\\Gamma(\\alpha_{\\text{post}})\\Gamma(\\beta_{\\text{post}})}" /> <BlockMath math="\mathbb{E}[\theta \mid \text{Data}] = \frac{\text{B}(\alpha_{\text{post}} + 1, \beta_{\text{post}})}{\text{B}(\alpha_{\text{post}}, \beta_{\text{post}})} = \frac{\Gamma(\alpha_{\text{post}} + 1)\Gamma(\beta_{\text{post}})}{\Gamma(\alpha_{\text{post}} + \beta_{\text{post}} + 1)} \cdot \frac{\Gamma(\alpha_{\text{post}} + \beta_{\text{post}})}{\Gamma(\alpha_{\text{post}})\Gamma(\beta_{\text{post}})}" />
<BlockMath math="\\mathbb{E}[\\theta \\mid \\text{Data}] = \\frac{\\alpha_{\\text{post}}\\Gamma(\\alpha_{\\text{post}})\\Gamma(\\beta_{\\text{post}})}{(\\alpha_{\\text{post}} + \\beta_{\\text{post}})\\Gamma(\\alpha_{\\text{post}} + \\beta_{\\text{post}})} \\cdot \\frac{\\Gamma(\\alpha_{\\text{post}} + \\beta_{\\text{post}})}{\\Gamma(\\alpha_{\\text{post}})\\Gamma(\\beta_{\\text{post}})} = \\frac{\\alpha_{\\text{post}}}{\\alpha_{\\text{post}} + \\beta_{\\text{post}}}" /> <BlockMath math="\mathbb{E}[\theta \mid \text{Data}] = \frac{\alpha_{\text{post}}\Gamma(\alpha_{\text{post}})\Gamma(\beta_{\text{post}})}{(\alpha_{\text{post}} + \beta_{\text{post}})\Gamma(\alpha_{\text{post}} + \beta_{\text{post}})} \cdot \frac{\Gamma(\alpha_{\text{post}} + \beta_{\text{post}})}{\Gamma(\alpha_{\text{post}})\Gamma(\beta_{\text{post}})} = \frac{\alpha_{\text{post}}}{\alpha_{\text{post}} + \beta_{\text{post}}}" />
<p className="text-xs text-slate-350 font-semibold pt-2">Expanded Workstation Implementation Formula:</p> <p className="text-xs text-slate-350 font-semibold pt-2">Expanded Workstation Implementation Formula:</p>
<BlockMath math="P_{\\text{Posterior}} = \\frac{\\alpha_{\\text{prior}} + (P_{\\text{ML}} \\times w)}{\\alpha_{\\text{prior}} + \\beta_{\\text{prior}} + w}" /> <BlockMath math="P_{\text{Posterior}} = \frac{\alpha_{\text{prior}} + (P_{\text{ML}} \times w)}{\alpha_{\text{prior}} + \beta_{\text{prior}} + w}" />
<p className="text-[10px] text-slate-500 font-mono leading-relaxed"> <p className="text-[10px] text-slate-500 font-mono leading-relaxed">
This formulation ensures that if the prior model is highly accurate (large <InlineMath math="\\alpha_{\\text{prior}}" />), the raw ML signal is smoothed towards historical baseline expectations. If historical errors are high, the prior variance restricts overreaction to noisy signals. This formulation ensures that if the prior model is highly accurate (large <InlineMath math="\alpha_{\text{prior}}" />), the raw ML signal is smoothed towards historical baseline expectations. If historical errors are high, the prior variance restricts overreaction to noisy signals.
</p> </p>
</div> </div>
</div> </div>

51
components/modules/events/EconometricsBlueprintModal.tsx
View File

@@ -1,5 +1,7 @@
import React from 'react'; import React from 'react';
import { Settings, X } from 'lucide-react'; import { Settings, X } from 'lucide-react';
import 'katex/dist/katex.min.css';
import { BlockMath, InlineMath } from 'react-katex';
interface EconometricsBlueprintModalProps { interface EconometricsBlueprintModalProps {
isOpen: boolean; isOpen: boolean;
@@ -25,7 +27,7 @@ export default function EconometricsBlueprintModal({ isOpen, onClose }: Economet
return ( return (
<div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in"> <div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in">
<div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-4xl h-[80vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-355"> <div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-5xl h-[85vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-355">
{/* Modal Header */} {/* Modal Header */}
<div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60"> <div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60">
@@ -49,33 +51,48 @@ export default function EconometricsBlueprintModal({ isOpen, onClose }: Economet
<div className="border-b border-slate-800/80 pb-3"> <div className="border-b border-slate-800/80 pb-3">
<h3 className="text-base font-bold text-slate-200">Event Studies &amp; Models</h3> <h3 className="text-base font-bold text-slate-200">Event Studies &amp; Models</h3>
<p className="text-xs text-slate-400 mt-1">Operational details of the econometric event study solver.</p> <p className="text-xs text-slate-400 mt-1">Operational details of the econometric event study solver, timeline configuration, and abnormal returns calculations.</p>
</div> </div>
{/* Core Mechanics */} {/* Core Mechanics */}
<div className="grid grid-cols-1 md:grid-cols-3 gap-4"> <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">1. Event Window Parameter Configuration</h4> <h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">1. Event Window Configuration</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Allows defining the timeline partitions for analysis: <p>
* **Estimation Window**: Historical baseline period (e.g. 120 days) used to estimate the normal asset return relationships. Allows defining the timeline partitions for analysis. The **120-day Estimation Window** serves to isolate market beta (<InlineMath math="\beta_i" />) and baseline alpha (<InlineMath math="\alpha_i" />) from standard market returns using OLS estimation:
* **Gap Window**: Separation buffer (e.g. 10 days) to prevent event-related leakages from skewing parameters. </p>
* **Event Window**: Analysis window surrounding the event day (e.g. [-5, +5]). <BlockMath math="R_{it} = \alpha_i + \beta_i R_{mt} + \epsilon_{it}" />
<p>
The **10-day Gap Window** acts as a strict mathematical **Isolation Shield** to prevent information leakage, pre-event front-running, or insider-related abnormal volatility from contaminating the baseline parameters.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">2. Abnormal Returns (AR)</h4> <h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">2. Abnormal Returns (AR)</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Computes daily differences between the actual stock return and its expected "normal" return (using market-adjusted models or CAPM parameters derived during the estimation window). <p>
Computes daily differences between the actual stock return (<InlineMath math="R_{it}" />) and its expected normal return:
</p>
<BlockMath math="AR_{it} = R_{it} - (\hat{\alpha}_i + \hat{\beta}_i R_{mt})" />
<p>
where <InlineMath math="\hat{\alpha}_i" /> and <InlineMath math="\hat{\beta}_i" /> are the OLS parameters estimated over the estimation window, and <InlineMath math="R_{mt}" /> represents the actual market benchmark index return on day <InlineMath math="t" />. This isolates the asset's idiosyncratic reaction to event-specific shocks.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">3. Cumulative Abnormal Returns (CAR)</h4> <h4 className="text-xs font-bold text-indigo-400 uppercase tracking-wider font-mono">3. Cumulative Abnormal Returns (CAR)</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Integrates and sums the daily abnormal returns across the event window. Determines whether an event (e.g. earnings release, regulatory fine, supply-chain shock) created statistically significant excess wealth changes. <p>
Integrates and sums the daily abnormal returns across the specified event window to track the cumulative market shocks:
</p> </p>
<BlockMath math="CAR_i(t_1, t_2) = \sum_{t=t_1}^{t_2} AR_{it}" />
<p>
where <InlineMath math="t_1" /> and <InlineMath math="t_2" /> define the bounds of the event window. This determines whether an event (e.g. earnings release, regulatory fine, supply-chain shock) created statistically significant excess wealth changes.
</p>
</div>
</div> </div>
</div> </div>
@@ -87,7 +104,7 @@ export default function EconometricsBlueprintModal({ isOpen, onClose }: Economet
<strong className="text-indigo-400 font-semibold">Event Parameters Input Mask:</strong> Edit estimation days, gap days, event horizons, and click **"Run Event Study Solver"**. Initiates server-side calculations. <strong className="text-indigo-400 font-semibold">Event Parameters Input Mask:</strong> Edit estimation days, gap days, event horizons, and click **"Run Event Study Solver"**. Initiates server-side calculations.
</p> </p>
<p> <p>
<strong className="text-indigo-400 font-semibold">CAR Event Charts:</strong> Renders a Recharts line chart illustrating the trajectory of Cumulative Abnormal Returns ($CAR$) across the event window. A significant deviation from zero indicates market inefficiency or corporate information shocks. <strong className="text-indigo-400 font-semibold">CAR Event Charts:</strong> Renders a Recharts line chart illustrating the trajectory of Cumulative Abnormal Returns (<InlineMath math="CAR" />) across the event window. A significant deviation from zero indicates market inefficiency or corporate information shocks.
</p> </p>
</div> </div>
</div> </div>

46
components/modules/scanner/ScannerBlueprintModal.tsx
View File

@@ -1,5 +1,7 @@
import React from 'react'; import React from 'react';
import { Settings, X } from 'lucide-react'; import { Settings, X } from 'lucide-react';
import 'katex/dist/katex.min.css';
import { BlockMath, InlineMath } from 'react-katex';
interface ScannerBlueprintModalProps { interface ScannerBlueprintModalProps {
isOpen: boolean; isOpen: boolean;
@@ -25,7 +27,7 @@ export default function ScannerBlueprintModal({ isOpen, onClose }: ScannerBluepr
return ( return (
<div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in"> <div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in">
<div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-4xl h-[80vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-350"> <div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-5xl h-[85vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-350">
{/* Modal Header */} {/* Modal Header */}
<div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60"> <div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60">
@@ -49,30 +51,50 @@ export default function ScannerBlueprintModal({ isOpen, onClose }: ScannerBluepr
<div className="border-b border-slate-800/80 pb-3"> <div className="border-b border-slate-800/80 pb-3">
<h3 className="text-base font-bold text-slate-200">Scanner Metrics &amp; Signals</h3> <h3 className="text-base font-bold text-slate-200">Scanner Metrics &amp; Signals</h3>
<p className="text-xs text-slate-400 mt-1">Operational details of the anomaly scanner and valuation filters.</p> <p className="text-xs text-slate-400 mt-1">Operational details of the anomaly scanner, technical velocity thresholds, and valuation overlays.</p>
</div> </div>
{/* Core Mechanics */} {/* Core Mechanics */}
<div className="grid grid-cols-1 md:grid-cols-3 gap-4"> <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">1. 52-Week Drop Mechanics</h4> <h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">1. 52-Week Drop Mechanics</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Filters the stock database for liquid companies trading at significant percentage discounts relative to their 52-week peak. Isolates severe drawdowns caused by asymmetric market overreactions. <p>
Filters the stock database for liquid companies trading at significant percentage discounts relative to their 52-week peak. The core threshold computes:
</p>
<BlockMath math="\Delta_{52w} = \frac{P_{\text{current}} - P_{52w\_high}}{P_{52w\_high}}" />
<p>
An alert is triggered when the price deviation exceeds a designated threshold (e.g. <InlineMath math="\Delta_{52w} \le -0.30" />), representing a 30% drop from the rolling high. It isolates severe drawdowns caused by asymmetric market overreactions, validating whether the pricing is a statistical dislocation or a permanent valuation impairment.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">2. Welles Wilder RSI-14 Velocity</h4> <h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">2. Welles Wilder RSI-14 Velocity</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Uses the smoothed Wilder Relative Strength Index to identify deep oversold thresholds (RSI &lt; 25). Momentum velocity measures standard deviation shocks in the indicator to forecast buy-exhaustion and selloff capitulations. <p>
Uses the smoothed Welles Wilder Relative Strength Index to identify deep oversold thresholds (RSI <InlineMath math="< 30" />). Wilder smoothing calculations utilize modified EMAs for trend velocity:
</p>
<BlockMath math="S_{\text{gain}, t} = \frac{1}{14} U_t + \left(1 - \frac{1}{14}\right) S_{\text{gain}, t-1}" />
<BlockMath math="S_{\text{loss}, t} = \frac{1}{14} D_t + \left(1 - \frac{1}{14}\right) S_{\text{loss}, t-1}" />
<p>
where <InlineMath math="U_t" /> and <InlineMath math="D_t" /> represent upward and downward price changes. Relative Strength is <InlineMath math="\text{RS} = S_{\text{gain}, t} / S_{\text{loss}, t}" />. Momentum velocity measures standard deviation shocks in the indicator to forecast buy-exhaustion and selloff capitulations.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">3. FMP Valuation Overlay</h4> <h4 className="text-xs font-bold text-emerald-400 uppercase tracking-wider font-mono">3. FMP Valuation Overlay</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Parses active valuation multiples: Price-to-Earnings (P/E), Price-to-Book (P/B), Dividend Yield, and Price/Earnings-to-Growth (PEG) ratios. Analyzes whether the selloff is justified fundamentally or is a dislocation from value. <p>
Integrates trailing Price-to-Earnings (P/E), Price-to-Book (P/B), and Dividend Yield (%), alongside the PEG-to-Forward P/E transition. Detail how PEG resolves to a growth rate and computes implicit Forward P/E:
</p> </p>
<BlockMath math="g_{\text{implicit}} = \frac{\text{Trailing PE}}{\text{PEG} \times 100}" />
<BlockMath math="\text{Forward PE} = \frac{\text{Trailing PE}}{1 + g_{\text{implicit}}}" />
<p>
When the pricing drop matches these valuation filters, the system triggers a **High-Conviction Value Alert** to signal structural undervaluation rather than a value trap.
</p>
</div>
</div> </div>
</div> </div>

44
components/modules/tech/TechBlueprintModal.tsx
View File

@@ -1,5 +1,7 @@
import React from 'react'; import React from 'react';
import { Settings, X } from 'lucide-react'; import { Settings, X } from 'lucide-react';
import 'katex/dist/katex.min.css';
import { BlockMath, InlineMath } from 'react-katex';
interface TechBlueprintModalProps { interface TechBlueprintModalProps {
isOpen: boolean; isOpen: boolean;
@@ -25,7 +27,7 @@ export default function TechBlueprintModal({ isOpen, onClose }: TechBlueprintMod
return ( return (
<div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in"> <div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-900/85 backdrop-blur-md p-4 sm:p-6 md:p-8 animate-fade-in">
<div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-4xl h-[80vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-355"> <div className="bg-slate-900 border border-slate-800/80 rounded-3xl w-full max-w-5xl h-[85vh] flex flex-col overflow-hidden shadow-2xl relative text-slate-355">
{/* Modal Header */} {/* Modal Header */}
<div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60"> <div className="flex justify-between items-center px-6 py-4 bg-slate-950/45 border-b border-slate-800/60">
@@ -49,30 +51,48 @@ export default function TechBlueprintModal({ isOpen, onClose }: TechBlueprintMod
<div className="border-b border-slate-800/80 pb-3"> <div className="border-b border-slate-800/80 pb-3">
<h3 className="text-base font-bold text-slate-200">CapEx Cycle &amp; Infrastructure Indicators</h3> <h3 className="text-base font-bold text-slate-200">CapEx Cycle &amp; Infrastructure Indicators</h3>
<p className="text-xs text-slate-400 mt-1">Operational details of tech overcapacity diagnosis.</p> <p className="text-xs text-slate-400 mt-1">Operational details of tech overcapacity diagnosis, segment monetization, and supply-chain metrics.</p>
</div> </div>
{/* Core Mechanics */} {/* Core Mechanics */}
<div className="grid grid-cols-1 md:grid-cols-3 gap-4"> <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">1. Monetization Gap &amp; ROI-to-CapEx</h4> <h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">1. Monetization Gap &amp; ROI-to-CapEx</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Monitors segment revenues (e.g. Azure, AWS, Google Cloud, Meta Family of Apps) against capital spending growth. A negative monetization gap signals segment revenues are growing slower than capital investments. A collapsing ROI-to-CapEx ratio highlights write-down risks. <p>
Monitors segment revenues (Azure, AWS, Google Cloud, Meta Family of Apps) against capital spending growth. The **Monetization Gap** is defined as the cloud-segment revenue growth percentage minus the absolute CapEx growth percentage:
</p>
<BlockMath math="G_{\text{monetization}} = \Delta \text{Rev}_{\text{segment}} - \Delta \text{CapEx}" />
<p>
A negative monetization gap (<InlineMath math="G_{\text{monetization}} < 0" />) signals that cloud revenues are growing slower than capital investments, indicating potential write-down risks.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">2. Supply-Chain Velocity Index</h4> <h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">2. Supply-Chain Velocity Index</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Compares cloud buyers' future purchase obligations (disclosed in notes of 10-Q reports) against Nvidia's spot inventory turnover speeds. A collapsing velocity index indicates buyers are cutting back forward purchase commitments relative to hardware supplier stockpiles. <p>
Data origins are automated parsers indexing SEC 10-Q filings for forward capital allocations. The **Supply-Chain Velocity Index** maps the buyers' forward purchase commitments against the hardware supplier's (Nvidia) spot inventory:
</p>
<BlockMath math="V_{\text{sc}} = \frac{\sum_{j \in \text{Buyers}} \text{Purchase Obligations}_{j, t}}{\text{Inventory}_{\text{supplier}, t}}" />
<p>
This compares forward commitments to the supplier's balance sheet inventory levels to diagnose macro overcapacity and demand corrections 3-6 months in advance.
</p> </p>
</div> </div>
</div>
<div className="p-4 rounded-xl border border-slate-800/60 bg-slate-950/40 space-y-2"> <div className="p-5 rounded-2xl border border-slate-800/60 bg-slate-950/40 space-y-3 flex flex-col">
<h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">3. Cluster Leverage (D/E &amp; CapEx/Dep)</h4> <h4 className="text-xs font-bold text-teal-400 uppercase tracking-wider font-mono">3. Cluster Leverage (D/E &amp; CapEx/Dep)</h4>
<p className="text-xs text-slate-400 leading-relaxed font-sans"> <div className="text-xs text-slate-400 leading-relaxed font-sans space-y-2 flex-1">
Monitors CapEx-to-depreciation ratios (ratios &gt; 3x indicate hyper-aggressive server capacity additions) alongside Debt-to-Equity changes to assess whether the AI cluster construction is funded by leverage, exposing firms to massive future amortization drag. <p>
Monitors CapEx-to-depreciation ratios alongside Debt-to-Equity changes:
</p> </p>
<BlockMath math="R_{\text{capex-dep}} = \frac{\text{CapEx}}{\text{Depreciation}}" />
<p>
Ratios exceeding <InlineMath math="3\times" /> indicate hyper-aggressive server capacity expansion. When this occurs alongside rising Debt-to-Equity ratios, it indicates that cluster construction is funded by leverage, exposing firms to massive future amortization drag.
</p>
</div>
</div> </div>
</div> </div>