v1.0.0 — LeadForge first stable release

v1.0.0 — 2026-05-02

First stable release. All milestones (M0–M13) complete.

Highlights

• Full end-to-end generation: recipe → simulated world → relational bundle with deterministic reproducibility.
• 90-day daily-step simulation engine with churn, stage advancement, conversion hazards, and touch emission.
• 5 motif families (fit-dominant, intent-dominant, sales-execution-sensitive, demo/trial-mediated, buying-committee-friction) with stochastic rewiring.
• Exposure filtering: student_public (leakage-safe) and research_instructor (full truth) modes.
• CLI: generate, inspect, validate, list-recipes — all fully wired.
• Validation harness: determinism, exposure monotonicity, realism bounds, difficulty profiles, cross-seed drift detection.

Published datasets

• HuggingFace: shaypal5/leadforge-lead-scoring-v1
• Kaggle Intro: derelictpanda/leadforge-lead-scoring-intro-v1
• Kaggle Intermediate: derelictpanda/leadforge-lead-scoring-intermediate-v1
• Kaggle Advanced: derelictpanda/leadforge-lead-scoring-advanced-v1

Install

```bash
pip install leadforge
```

Post-milestone improvements (since M13)

• Direct conversion bypass (PR #45): pre-SQL leads can now convert via a rare direct path, fixing the deterministic is_sql → converts invariant.
• Configurable label window (PR #43): label_window_days controls conversion label derivation in the simulation.
• Generalized task support (PR #40, #42): primary_task threaded through bundle, validation, and pipelines; dataset card prose adapts to non-conversion tasks.
• Pipeline extraction (PR #29, #34): build pipeline functions extracted into leadforge.pipelines with proper RNG conventions.
• Latent-aware touch intensity (PR #31): LatentDecayIntensity mechanism creates causal link between latent traits and touch patterns.
• Canonical validation module (PR #26): reusable lead scoring validation with sklearn pipeline.

Development history

Milestone changelog (no intermediate versions were published)

Milestone 0.5.0 — Validation Harness & CLI Complete (2026-04-29)

Milestone 0.4.0 — Simulation Engine & End-to-End Generation (2026-04-28)

Milestone 0.3.0 — World Structure & Mechanisms (2026-04-25)

Milestone 0.2.0 — Config, Recipes & Narrative (2026-04-20)

Milestone 0.1.0 — Project Foundation (2026-04-18)

See CHANGELOG.md for full details.