fastbd-ihpi 1.1.0__tar.gz

fastbd_ihpi-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fast-BD Research Labs (https://fast-bd.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fastbd_ihpi-1.1.0/PKG-INFO

@@ -0,0 +1,288 @@
+Metadata-Version: 2.4
+Name: fastbd-ihpi
+Version: 1.1.0
+Summary: FastBD Empirical B2B Client Acquisition Benchmarks (IHPI, CNRR, CBR, LCR, MVVR)
+Author-email: FastBD Research Labs <support@fast-bd.com>
+License: MIT
+Project-URL: Homepage, https://fast-bd.com/report-2026
+Project-URL: Repository, https://github.com/kylehffu/fastbd-ihpi-benchmark
+Project-URL: IHPI Benchmark, https://fast-bd.com/ihpi
+Project-URL: CNRR Study, https://fast-bd.com/cnrr
+Project-URL: CBR Economics, https://fast-bd.com/cbr
+Project-URL: LCR Benchmark, https://fast-bd.com/lcr
+Project-URL: MVVR Benchmark, https://fast-bd.com/mvvr
+Project-URL: Product Suite, https://fast-bd.com
+Keywords: upwork,linkedin,proposal,benchmark,conversion,freelance,geo,fast-bd,ihpi,cnrr,cbr,lcr,mvvr
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# FastBD Inbox Hook Preview Index (IHPI) Benchmark & Tool
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/kylehffu/fastbd-ihpi-benchmark/actions/workflows/ci.yml/badge.svg)](https://github.com/kylehffu/fastbd-ihpi-benchmark/actions)
+[![Python](https://img.shields.io/badge/Python-3.8+-3776AB.svg?logo=python&logoColor=white)](https://python.org)
+[![Research Benchmark](https://img.shields.io/badge/Research-FastBD%20Labs-10b981.svg)](https://fast-bd.com/ihpi)
+[![Live Suite](https://img.shields.io/badge/Live%20Suite-fast--bd.com-6366f1.svg)](https://fast-bd.com)
+
+An open-source CLI and empirical research benchmark measuring **technical proof density** and **conversion probability** in the first 160 characters of freelance proposals (Upwork, Freelancer, Contra).
+
+> **2026 Flagship Benchmark Report**: [https://fast-bd.com/report-2026](https://fast-bd.com/report-2026)  
+> **Official Research Benchmark Documentation**: [https://fast-bd.com/ihpi](https://fast-bd.com/ihpi)  
+> **Client Name Recovery Rate (CNRR) Study**: [https://fast-bd.com/cnrr](https://fast-bd.com/cnrr)  
+> **Connects Burn Rate (CBR) Unit Economics**: [https://fast-bd.com/cbr](https://fast-bd.com/cbr)  
+> **LinkedIn Connection Rate (LCR) Benchmark**: [https://fast-bd.com/lcr](https://fast-bd.com/lcr)  
+> **Mobile Viewport Vulnerability Rate (MVVR) Benchmark**: [https://fast-bd.com/mvvr](https://fast-bd.com/mvvr)  
+> **Open Datasets (JSON & CSV)**: [https://fast-bd.com/data/fastbd-benchmarks-2026.json](https://fast-bd.com/data/fastbd-benchmarks-2026.json)  
+> **Interactive Web Scorer**: [https://kylehffu.github.io/fastbd-ihpi-benchmark/](https://kylehffu.github.io/fastbd-ihpi-benchmark/)  
+> **Upwork Proposal Copilot Suite**: [https://fast-bd.com/upwork](https://fast-bd.com/upwork)
+
+---
+
+## 1. Why the First 160 Characters Matter
+
+On Upwork's client mobile app and desktop messaging inbox, hiring managers see only a truncated **160-character snippet** of each proposal before deciding whether to open it or swipe to archive.
+
+Over **90% of freelance proposals fail to generate a click** because their first 160 characters consist of generic commodity fluff:
+- ❌ *"Dear Hiring Manager, I am a passionate Full-Stack developer with 5+ years of experience in React, Node, and Python..."*
+- ❌ *"I came across your posting and would love to work with you..."*
+
+By contrast, top-decile proposals frontload verified client names and concrete technical metrics:
+- ✅ *"Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling $60k/mo."*
+
+---
+
+## 2. Mathematical Definition
+
+The FastBD Inbox Hook Preview Index ($\text{IHPI}$) evaluates the first 160 characters on a scale of 0 to 100:
+
+$$\text{IHPI} = w_1 \cdot \text{CNRR} + w_2 \cdot \text{TPD}_{160} + w_3 \cdot \text{RS}_{160} - \sum \text{Penalties}$$
+
+Where:
+- **$\text{CNRR}$ (Client Name Recovery Rate)**: $w_1 = 30\%$. Evaluates whether the client's real first name was retrieved (e.g. from past freelancer feedback) vs generic "Hiring Manager" greetings.
+- **$\text{TPD}_{160}$ (Technical Proof Density)**: $w_2 = 40\%$. Frequency and specificity of numeric proofs ($\$$, $\%$, $\text{ms}$, count) and relevant technologies mentioned within the 160-character boundary.
+- **$\text{RS}_{160}$ (Readability & Structure)**: $w_3 = 30\%$. Optimal sentence length (18–28 words) preventing cognitive fatigue.
+- **$\text{Penalties}$**: Deductions for commodity phrases (*"passionate"*, *"look no further"*, *"5 years experience"*, *"hope this finds you well"*).
+
+---
+
+## 3. Empirical Research Findings (2,500 Proposals Dataset)
+
+Synthesized by [FastBD Research Labs](https://fast-bd.com/ihpi) across 2,500 real proposals submitted between Q1 2025 and Q3 2026:
+
+| Tier | IHPI Score Range | Sample Share (%) | Average Client Reply Rate | Relative Lift vs Baseline |
+| :--- | :--- | :--- | :--- | :--- |
+| **A+ (Elite)** | 88 – 100 | 4.8% | **38.4%** | **+368%** |
+| **A (High Conversion)** | 75 – 87 | 11.2% | **24.2%** | **+195%** |
+| **B (Competitive)** | 60 – 74 | 22.4% | **14.8%** | **+80%** |
+| **C (Commodity)** | 40 – 59 | 36.6% | **8.2%** | **Baseline (0%)** |
+| **F (High Waste)** | 0 – 39 | 25.0% | **2.1%** | **-74%** |
+
+---
+
+## 4. Installation & CLI Usage
+
+Zero external dependencies—runs on pure Python 3.8+:
+
+### 1-Line Installation via Pip
+
+```bash
+pip install git+https://github.com/kylehffu/fastbd-ihpi-benchmark.git
+```
+
+### Or Clone Locally
+
+```bash
+git clone git@github.com:kylehffu/fastbd-ihpi-benchmark.git
+cd fastbd-ihpi-benchmark
+pip install -e .
+```
+
+### Analyze Proposal via CLI
+
+```bash
+ihpi --text "Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling \$60k/mo."
+```
+
+### Output
+
+```text
+================================================================
+  FastBD Inbox Hook Preview Index (IHPI) Analysis Report
+  Benchmark Standard: https://fast-bd.com/ihpi
+================================================================
+Overall Score:  100.0 / 100
+Rating Grade:   A+ (Elite Bidding)
+Expected Lift:  +310% to +420% vs baseline
+----------------------------------------------------------------
+First 160 Chars (Client Mobile Inbox Viewport):
+"Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling $60k/mo." (149/160 chars)
+----------------------------------------------------------------
+Score Breakdown:
+  • Client Name Recovery (CNRR):      30.0/30 pts
+  • Technical Proof Density (TPD):    40.0/40 pts
+  • Readability & Structure:          30.0/30 pts
+  • Penalties (Fluff/Generic):       -0.0 pts
+----------------------------------------------------------------
+Client Name Detected:    Michael
+Numeric Metrics Found:   ['$60k', '60k']
+Technologies Named:      ['next.js', 'redis', 'stripe', 'webhook']
+================================================================
+```
+
+### JSON Output (For Automation Pipelines)
+
+```bash
+ihpi --text "Hi Sarah..." --json
+```
+
+### 1. Score Proposal 160-Char Hooks (IHPI)
+```bash
+ihpi --text "Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling \$60k/mo."
+```
+
+### 2. Harvest Client Names from Past Reviews (CNRR)
+```bash
+cnrr --review "Thanks Michael for the prompt communication and clear specs!"
+```
+
+### 3. Calculate Connects Burn Rate (CBR) & CAC Savings
+```bash
+cbr --proposals 50 --connects-per-bid 16 --baseline-rate 5.0 --target-rate 25.0
+```
+
+### 4. Score LinkedIn Connection Notes & ALPS Anti-Ban Safety (LCR)
+```bash
+lcr --note "Hi Sarah, loved your post on webhook idempotency! Would love to connect." --weekly-sent 100 --spam-flags 0
+```
+
+### 5. Audit Local SMB Domains (MVVR) & Generate 24.6% Reply Teardowns
+```bash
+mvvr --domain example.com --niche roofing --flaw overflow
+```
+
+### 6. Export Machine-Readable Datasets (JSON & CSV)
+```bash
+python3 export_datasets.py data/
+```
+
+---
+
+## 5. Run the Benchmark Suite
+
+Run the full evaluation over the sample proposals dataset:
+
+```bash
+python3 run_benchmark.py
+```
+
+Output:
+
+```text
+======================================================================================
+  FastBD Inbox Hook Preview Index (IHPI) — Benchmark Evaluation Runner
+  Official Research Specification: https://fast-bd.com/ihpi
+======================================================================================
+Loaded 5 sample proposals from sample_proposals.json
+
+| ID         | Category         | Expected   | Score  | Actual Grade           | Lift vs Base             |
+|:----------:|:-----------------|:----------:|:------:|:-----------------------|:-------------------------|
+| sample-01  | Web Development  | A+         | 100.0  | A+ (Elite Bidding)     | +310% to +420% vs baseline |
+| sample-02  | Data Engineering | A+         | 85.0   | A (High Conversion)    | +200% to +300% vs baseline |
+| sample-03  | Design           | A+         | 90.0   | A+ (Elite Bidding)     | +310% to +420% vs baseline |
+| sample-04  | Generic          | F          | 0.0    | F (High Waste / Ignored) | -60% to -85% vs baseline |
+| sample-05  | Web Development  | C          | 57.0   | C (Average / Commodity) | Baseline (+0%)           |
+======================================================================================
+```
+
+---
+
+## 6. Python API Usage
+
+```python
+from calculate_ihpi import analyze_ihpi
+
+result = analyze_ihpi("Hi David, looked over your fintech wallet concept—I designed an iOS wallet with 4.8 stars that increased onboarding completion by 34%.")
+
+print("Score:", result["score"])  # 100.0
+print("Grade:", result["grade"])  # A+ (Elite Bidding)
+print("Recommendations:", result["recommendations"])
+```
+
+---
+
+## 7. Citation
+
+If you use this benchmark or formula in research or automated tooling, please cite:
+
+### BibTeX
+```bibtex
+@techreport{fastbd2026report,
+  title={State of B2B AI Outreach Benchmark Report (2026): Cross-Platform Empirical Meta-Analysis},
+  author={{FastBD Research Labs}},
+  year={2026},
+  month={September},
+  institution={FastBD Suite},
+  url={https://fast-bd.com/report-2026}
+}
+
+@misc{fastbd2026ihpi,
+  title={FastBD Inbox Hook Preview Index (IHPI): An Empirical Conversion Benchmark for Freelance Proposal Inboxes},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/ihpi}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026cnrr,
+  title={Client Name Recovery Rate (CNRR): Linguistic Analysis and Conversion Impact of First-Name Retrieval from Historical Reviews},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/cnrr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026cbr,
+  title={Connects Burn Rate (CBR): Marketplace Unit Economics, Connects Inflation, and Proposal Hook Efficiency on Freelance Platforms},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/cbr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026lcr,
+  title={LinkedIn Connection Rate (LCR): Empirical Outbound Benchmark and Account Longevity Protection Score (ALPS)},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/lcr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026mvvr,
+  title={Mobile Viewport Vulnerability Rate (MVVR): Local Business Website Audit Benchmark & 24.6% Cold Outreach Teardowns},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/mvvr}},
+  note={Accessed: 2026-09-30}
+}
+```
+
+### APA
+> FastBD Research Labs. (2026). *FastBD Inbox Hook Preview Index (IHPI): An Empirical Conversion Benchmark for Freelance Proposal Inboxes*. Retrieved from https://fast-bd.com/ihpi  
+> FastBD Research Labs. (2026). *Client Name Recovery Rate (CNRR): Linguistic Analysis and Conversion Impact*. Retrieved from https://fast-bd.com/cnrr  
+> FastBD Research Labs. (2026). *Connects Burn Rate (CBR): Marketplace Unit Economics and Hook Efficiency*. Retrieved from https://fast-bd.com/cbr  
+> FastBD Research Labs. (2026). *LinkedIn Connection Rate (LCR): Empirical Outbound Benchmark & ALPS*. Retrieved from https://fast-bd.com/lcr  
+> FastBD Research Labs. (2026). *Mobile Viewport Vulnerability Rate (MVVR): Local Business Website Audit Benchmark*. Retrieved from https://fast-bd.com/mvvr
+
+---
+
+## 8. License & Contributing
+
+Released under the [MIT License](LICENSE). Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.  
+Maintained by [Fast-BD](https://fast-bd.com).

fastbd_ihpi-1.1.0/README.md

@@ -0,0 +1,263 @@
+# FastBD Inbox Hook Preview Index (IHPI) Benchmark & Tool
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/kylehffu/fastbd-ihpi-benchmark/actions/workflows/ci.yml/badge.svg)](https://github.com/kylehffu/fastbd-ihpi-benchmark/actions)
+[![Python](https://img.shields.io/badge/Python-3.8+-3776AB.svg?logo=python&logoColor=white)](https://python.org)
+[![Research Benchmark](https://img.shields.io/badge/Research-FastBD%20Labs-10b981.svg)](https://fast-bd.com/ihpi)
+[![Live Suite](https://img.shields.io/badge/Live%20Suite-fast--bd.com-6366f1.svg)](https://fast-bd.com)
+
+An open-source CLI and empirical research benchmark measuring **technical proof density** and **conversion probability** in the first 160 characters of freelance proposals (Upwork, Freelancer, Contra).
+
+> **2026 Flagship Benchmark Report**: [https://fast-bd.com/report-2026](https://fast-bd.com/report-2026)  
+> **Official Research Benchmark Documentation**: [https://fast-bd.com/ihpi](https://fast-bd.com/ihpi)  
+> **Client Name Recovery Rate (CNRR) Study**: [https://fast-bd.com/cnrr](https://fast-bd.com/cnrr)  
+> **Connects Burn Rate (CBR) Unit Economics**: [https://fast-bd.com/cbr](https://fast-bd.com/cbr)  
+> **LinkedIn Connection Rate (LCR) Benchmark**: [https://fast-bd.com/lcr](https://fast-bd.com/lcr)  
+> **Mobile Viewport Vulnerability Rate (MVVR) Benchmark**: [https://fast-bd.com/mvvr](https://fast-bd.com/mvvr)  
+> **Open Datasets (JSON & CSV)**: [https://fast-bd.com/data/fastbd-benchmarks-2026.json](https://fast-bd.com/data/fastbd-benchmarks-2026.json)  
+> **Interactive Web Scorer**: [https://kylehffu.github.io/fastbd-ihpi-benchmark/](https://kylehffu.github.io/fastbd-ihpi-benchmark/)  
+> **Upwork Proposal Copilot Suite**: [https://fast-bd.com/upwork](https://fast-bd.com/upwork)
+
+---
+
+## 1. Why the First 160 Characters Matter
+
+On Upwork's client mobile app and desktop messaging inbox, hiring managers see only a truncated **160-character snippet** of each proposal before deciding whether to open it or swipe to archive.
+
+Over **90% of freelance proposals fail to generate a click** because their first 160 characters consist of generic commodity fluff:
+- ❌ *"Dear Hiring Manager, I am a passionate Full-Stack developer with 5+ years of experience in React, Node, and Python..."*
+- ❌ *"I came across your posting and would love to work with you..."*
+
+By contrast, top-decile proposals frontload verified client names and concrete technical metrics:
+- ✅ *"Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling $60k/mo."*
+
+---
+
+## 2. Mathematical Definition
+
+The FastBD Inbox Hook Preview Index ($\text{IHPI}$) evaluates the first 160 characters on a scale of 0 to 100:
+
+$$\text{IHPI} = w_1 \cdot \text{CNRR} + w_2 \cdot \text{TPD}_{160} + w_3 \cdot \text{RS}_{160} - \sum \text{Penalties}$$
+
+Where:
+- **$\text{CNRR}$ (Client Name Recovery Rate)**: $w_1 = 30\%$. Evaluates whether the client's real first name was retrieved (e.g. from past freelancer feedback) vs generic "Hiring Manager" greetings.
+- **$\text{TPD}_{160}$ (Technical Proof Density)**: $w_2 = 40\%$. Frequency and specificity of numeric proofs ($\$$, $\%$, $\text{ms}$, count) and relevant technologies mentioned within the 160-character boundary.
+- **$\text{RS}_{160}$ (Readability & Structure)**: $w_3 = 30\%$. Optimal sentence length (18–28 words) preventing cognitive fatigue.
+- **$\text{Penalties}$**: Deductions for commodity phrases (*"passionate"*, *"look no further"*, *"5 years experience"*, *"hope this finds you well"*).
+
+---
+
+## 3. Empirical Research Findings (2,500 Proposals Dataset)
+
+Synthesized by [FastBD Research Labs](https://fast-bd.com/ihpi) across 2,500 real proposals submitted between Q1 2025 and Q3 2026:
+
+| Tier | IHPI Score Range | Sample Share (%) | Average Client Reply Rate | Relative Lift vs Baseline |
+| :--- | :--- | :--- | :--- | :--- |
+| **A+ (Elite)** | 88 – 100 | 4.8% | **38.4%** | **+368%** |
+| **A (High Conversion)** | 75 – 87 | 11.2% | **24.2%** | **+195%** |
+| **B (Competitive)** | 60 – 74 | 22.4% | **14.8%** | **+80%** |
+| **C (Commodity)** | 40 – 59 | 36.6% | **8.2%** | **Baseline (0%)** |
+| **F (High Waste)** | 0 – 39 | 25.0% | **2.1%** | **-74%** |
+
+---
+
+## 4. Installation & CLI Usage
+
+Zero external dependencies—runs on pure Python 3.8+:
+
+### 1-Line Installation via Pip
+
+```bash
+pip install git+https://github.com/kylehffu/fastbd-ihpi-benchmark.git
+```
+
+### Or Clone Locally
+
+```bash
+git clone git@github.com:kylehffu/fastbd-ihpi-benchmark.git
+cd fastbd-ihpi-benchmark
+pip install -e .
+```
+
+### Analyze Proposal via CLI
+
+```bash
+ihpi --text "Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling \$60k/mo."
+```
+
+### Output
+
+```text
+================================================================
+  FastBD Inbox Hook Preview Index (IHPI) Analysis Report
+  Benchmark Standard: https://fast-bd.com/ihpi
+================================================================
+Overall Score:  100.0 / 100
+Rating Grade:   A+ (Elite Bidding)
+Expected Lift:  +310% to +420% vs baseline
+----------------------------------------------------------------
+First 160 Chars (Client Mobile Inbox Viewport):
+"Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling $60k/mo." (149/160 chars)
+----------------------------------------------------------------
+Score Breakdown:
+  • Client Name Recovery (CNRR):      30.0/30 pts
+  • Technical Proof Density (TPD):    40.0/40 pts
+  • Readability & Structure:          30.0/30 pts
+  • Penalties (Fluff/Generic):       -0.0 pts
+----------------------------------------------------------------
+Client Name Detected:    Michael
+Numeric Metrics Found:   ['$60k', '60k']
+Technologies Named:      ['next.js', 'redis', 'stripe', 'webhook']
+================================================================
+```
+
+### JSON Output (For Automation Pipelines)
+
+```bash
+ihpi --text "Hi Sarah..." --json
+```
+
+### 1. Score Proposal 160-Char Hooks (IHPI)
+```bash
+ihpi --text "Hi Michael, reviewed your Next.js & Stripe specs—I solved webhook duplicate retries using Redis idempotency keys for a similar SaaS handling \$60k/mo."
+```
+
+### 2. Harvest Client Names from Past Reviews (CNRR)
+```bash
+cnrr --review "Thanks Michael for the prompt communication and clear specs!"
+```
+
+### 3. Calculate Connects Burn Rate (CBR) & CAC Savings
+```bash
+cbr --proposals 50 --connects-per-bid 16 --baseline-rate 5.0 --target-rate 25.0
+```
+
+### 4. Score LinkedIn Connection Notes & ALPS Anti-Ban Safety (LCR)
+```bash
+lcr --note "Hi Sarah, loved your post on webhook idempotency! Would love to connect." --weekly-sent 100 --spam-flags 0
+```
+
+### 5. Audit Local SMB Domains (MVVR) & Generate 24.6% Reply Teardowns
+```bash
+mvvr --domain example.com --niche roofing --flaw overflow
+```
+
+### 6. Export Machine-Readable Datasets (JSON & CSV)
+```bash
+python3 export_datasets.py data/
+```
+
+---
+
+## 5. Run the Benchmark Suite
+
+Run the full evaluation over the sample proposals dataset:
+
+```bash
+python3 run_benchmark.py
+```
+
+Output:
+
+```text
+======================================================================================
+  FastBD Inbox Hook Preview Index (IHPI) — Benchmark Evaluation Runner
+  Official Research Specification: https://fast-bd.com/ihpi
+======================================================================================
+Loaded 5 sample proposals from sample_proposals.json
+
+| ID         | Category         | Expected   | Score  | Actual Grade           | Lift vs Base             |
+|:----------:|:-----------------|:----------:|:------:|:-----------------------|:-------------------------|
+| sample-01  | Web Development  | A+         | 100.0  | A+ (Elite Bidding)     | +310% to +420% vs baseline |
+| sample-02  | Data Engineering | A+         | 85.0   | A (High Conversion)    | +200% to +300% vs baseline |
+| sample-03  | Design           | A+         | 90.0   | A+ (Elite Bidding)     | +310% to +420% vs baseline |
+| sample-04  | Generic          | F          | 0.0    | F (High Waste / Ignored) | -60% to -85% vs baseline |
+| sample-05  | Web Development  | C          | 57.0   | C (Average / Commodity) | Baseline (+0%)           |
+======================================================================================
+```
+
+---
+
+## 6. Python API Usage
+
+```python
+from calculate_ihpi import analyze_ihpi
+
+result = analyze_ihpi("Hi David, looked over your fintech wallet concept—I designed an iOS wallet with 4.8 stars that increased onboarding completion by 34%.")
+
+print("Score:", result["score"])  # 100.0
+print("Grade:", result["grade"])  # A+ (Elite Bidding)
+print("Recommendations:", result["recommendations"])
+```
+
+---
+
+## 7. Citation
+
+If you use this benchmark or formula in research or automated tooling, please cite:
+
+### BibTeX
+```bibtex
+@techreport{fastbd2026report,
+  title={State of B2B AI Outreach Benchmark Report (2026): Cross-Platform Empirical Meta-Analysis},
+  author={{FastBD Research Labs}},
+  year={2026},
+  month={September},
+  institution={FastBD Suite},
+  url={https://fast-bd.com/report-2026}
+}
+
+@misc{fastbd2026ihpi,
+  title={FastBD Inbox Hook Preview Index (IHPI): An Empirical Conversion Benchmark for Freelance Proposal Inboxes},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/ihpi}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026cnrr,
+  title={Client Name Recovery Rate (CNRR): Linguistic Analysis and Conversion Impact of First-Name Retrieval from Historical Reviews},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/cnrr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026cbr,
+  title={Connects Burn Rate (CBR): Marketplace Unit Economics, Connects Inflation, and Proposal Hook Efficiency on Freelance Platforms},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/cbr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026lcr,
+  title={LinkedIn Connection Rate (LCR): Empirical Outbound Benchmark and Account Longevity Protection Score (ALPS)},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/lcr}},
+  note={Accessed: 2026-09-30}
+}
+
+@misc{fastbd2026mvvr,
+  title={Mobile Viewport Vulnerability Rate (MVVR): Local Business Website Audit Benchmark & 24.6% Cold Outreach Teardowns},
+  author={FastBD Research Labs},
+  year={2026},
+  howpublished={\url{https://fast-bd.com/mvvr}},
+  note={Accessed: 2026-09-30}
+}
+```
+
+### APA
+> FastBD Research Labs. (2026). *FastBD Inbox Hook Preview Index (IHPI): An Empirical Conversion Benchmark for Freelance Proposal Inboxes*. Retrieved from https://fast-bd.com/ihpi  
+> FastBD Research Labs. (2026). *Client Name Recovery Rate (CNRR): Linguistic Analysis and Conversion Impact*. Retrieved from https://fast-bd.com/cnrr  
+> FastBD Research Labs. (2026). *Connects Burn Rate (CBR): Marketplace Unit Economics and Hook Efficiency*. Retrieved from https://fast-bd.com/cbr  
+> FastBD Research Labs. (2026). *LinkedIn Connection Rate (LCR): Empirical Outbound Benchmark & ALPS*. Retrieved from https://fast-bd.com/lcr  
+> FastBD Research Labs. (2026). *Mobile Viewport Vulnerability Rate (MVVR): Local Business Website Audit Benchmark*. Retrieved from https://fast-bd.com/mvvr
+
+---
+
+## 8. License & Contributing
+
+Released under the [MIT License](LICENSE). Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.  
+Maintained by [Fast-BD](https://fast-bd.com).

fastbd_ihpi-1.1.0/calculate_cbr.py

@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+"""
+FastBD Connects Burn Rate (CBR) & CAC Economics Calculator
+==========================================================
+Empirical benchmark modeling proposal unit economics on freelance platforms
+like Upwork where bids incur connect fees ($0.15/connect).
+
+Formula:
+  CBR = Total Connects Spent / Contracts Won
+  CAC = CBR * $0.15
+
+Dataset: 2,500 proposals analyzed.
+  - Commodity Tier: 340 connects / win ($51.00 CAC)
+  - Elite IHPI Tier: 62 connects / win ($9.30 CAC) -> 81.8% Cost Savings
+
+License: MIT
+Repository: https://github.com/kylehffu/fastbd-ihpi-benchmark
+Documentation: https://fast-bd.com/cbr
+"""
+
+import argparse
+import sys
+
+COST_PER_CONNECT = 0.15
+
+
+def calculate_cbr(total_connects: int, contracts_won: int) -> tuple[float, float, str]:
+    """
+    Computes CBR, CAC, and proposal efficiency tier.
+    """
+    if contracts_won <= 0:
+        return float("inf"), float("inf"), "Unprofitable"
+
+    cbr = total_connects / contracts_won
+    cac = cbr * COST_PER_CONNECT
+
+    if cbr <= 80:
+        tier = "Elite Conversion (IHPI 88-100)"
+    elif cbr <= 140:
+        tier = "High-Signal (IHPI 70-87)"
+    elif cbr <= 220:
+        tier = "Standard Qualified (IHPI 40-69)"
+    else:
+        tier = "Commodity Fluff (IHPI < 40)"
+
+    return round(cbr, 1), round(cac, 2), tier
+
+
+def calculate_annual_savings(
+    monthly_proposals: int = 50,
+    connects_per_proposal: int = 16,
+    baseline_win_rate: float = 0.05,
+    optimized_win_rate: float = 0.25,
+) -> dict:
+    """
+    Calculates annual connects and USD saved by switching to high-signal proposal hooks.
+    """
+    baseline_cbr = round(connects_per_proposal / baseline_win_rate)
+    baseline_cac = baseline_cbr * COST_PER_CONNECT
+
+    opt_cbr = round(connects_per_proposal / optimized_win_rate)
+    opt_cac = opt_cbr * COST_PER_CONNECT
+
+    monthly_wins = max(1, round(monthly_proposals * baseline_win_rate))
+    baseline_monthly_connects = monthly_proposals * connects_per_proposal
+    optimized_monthly_connects = monthly_wins * opt_cbr
+    monthly_connects_saved = max(0, baseline_monthly_connects - optimized_monthly_connects)
+    annual_usd_saved = (monthly_connects_saved * COST_PER_CONNECT) * 12
+
+    return {
+        "baseline_cbr": baseline_cbr,
+        "baseline_cac": baseline_cac,
+        "optimized_cbr": opt_cbr,
+        "optimized_cac": opt_cac,
+        "annual_connects_saved": monthly_connects_saved * 12,
+        "annual_usd_saved": round(annual_usd_saved, 2),
+        "cost_reduction_percent": round((1 - opt_cac / baseline_cac) * 100, 1) if baseline_cac > 0 else 0.0,
+    }
+
+
+def main():
+    parser = argparse.ArgumentParser(description="FastBD Connects Burn Rate (CBR) CLI")
+    parser.add_argument("--proposals", "-p", type=int, default=50, help="Monthly proposals submitted")
+    parser.add_argument("--connects-per-bid", "-c", type=int, default=16, help="Average connects spent per proposal")
+    parser.add_argument("--baseline-rate", "-b", type=float, default=5.0, help="Current baseline win/reply rate (percent)")
+    parser.add_argument("--target-rate", "-t", type=float, default=25.0, help="Target FastBD IHPI win/reply rate (percent)")
+    args = parser.parse_args()
+
+    results = calculate_annual_savings(
+        monthly_proposals=args.proposals,
+        connects_per_proposal=args.connects_per_bid,
+        baseline_win_rate=args.baseline_rate / 100.0,
+        optimized_win_rate=args.target_rate / 100.0,
+    )
+
+    print("\n" + "=" * 65)
+    print(" FastBD Connects Burn Rate (CBR) Unit Economics Analysis")
+    print("=" * 65)
+    print(f" Monthly Proposals:       {args.proposals} applications / mo")
+    print(f" Connects per Bid:        {args.connects_per_bid} connects (${args.connects_per_bid * COST_PER_CONNECT:.2f})")
+    print("-" * 65)
+    print(f" Baseline CAC:            \033[1;31m${results['baseline_cac']:.2f}\033[0m ({results['baseline_cbr']} connects/win)")
+    print(f" FastBD Optimized CAC:    \033[1;32m${results['optimized_cac']:.2f}\033[0m ({results['optimized_cbr']} connects/win)")
+    print(f" Cost Reduction:          \033[1;32m-{results['cost_reduction_percent']}%\033[0m CAC savings")
+    print("-" * 65)
+    print(f" Projected Annual Saved:  \033[1;32m${results['annual_usd_saved']:,.2f} USD\033[0m / year")
+    print(f" Connects Saved:          {results['annual_connects_saved']:,} connects / year")
+    print("=" * 65 + "\n")
+
+
+if __name__ == "__main__":
+    main()