Skip to main content
Repurchase Engine

​
Welcome

Welcome to the Repurchase Forecasting module, a core application of the Village Operating System. At Village Labs, we’ve built our powerful Repurchase Engine to give you unparalleled insight into your long-term ESOP sustainability. We designed it to be a high-fidelity forecasting tool that moves beyond simple spreadsheets, allowing you to model complex scenarios with confidence and precision. This documentation will guide you through the architecture, data models, and simulation pipeline that power our engine.

Quick Start

Get your first simulation running in 5 minutes

System Architecture

Understand how the engine works

Data Models

Explore the core data structures

API Reference

Integrate the engine into your applications

​
Key Features

Process census data through a step-by-step annual cycle, modeling every aspect of ESOP administration from share releases to repurchase obligations.
Every input scenario and simulation run is permanently versioned, providing complete reproducibility and temporal analysis capabilities.
Accurately model leveraged ESOPs with multiple debt tranches using loan-by-loan share release mechanics.
Deep integration with AI agents through a high-level toolkit designed for natural language interactions and scenario analysis.

​
Core Capabilities

Repurchase Forecasting

Project long-term repurchase obligations with precision

Cash Flow Planning

Model trust cash flows and contribution requirements

Share Pool Management

Track allocated, unallocated, and suspense shares

Diversification Planning

Simulate statutory diversification requirements

Scenario Analysis

Compare multiple planning scenarios side-by-side

Turnover Projection

Forecast employee terminations using predictive models

​
Design Philosophy

The Repurchase Engine is built on three core design principles:
1

Separation of Concerns

Distinguish between PlanRules (the legal “constitution”) and OperatingAssumptions (annual strategy), mirroring how plan sponsors actually operate.
2

Immutability

Maintain a temporal, stateful database where nothing is ever overwritten—ensuring complete reproducibility and audit trails.
3

Abstraction

Expose high-level user intents to AI agents, creating a stable integration that survives internal engine changes.

​
Who Uses the Repurchase Engine?

ESOP Plan Sponsors

Model long-term repurchase obligations and cash requirements

ESOP Trustees

Ensure compliance and sustainable trust operations

Financial Advisors

Provide data-driven guidance to ESOP clients

Third-Party Administrators

Deliver accurate forecasting for plan administration

​
Get Started

Understand ESOP Basics

New to ESOPs? Start here for foundational concepts.

Run Your First Simulation

Follow our quickstart guide to run a simulation.
Need Help? Contact our support team at [email protected] or check out our GitHub repository.