Research specifications, falsification protocols, and scientific manuscripts for FunnelScript, an experimental language for expressing and executing stateful marketing-system models. The compiler, CLI, tests, bundled Marketing Standard Library, and Web Studio live in the application repository.
FunnelScript language branding and logo usage rules are maintained in the application visual identity guide. The research repository retains the same wordmark without introducing a separate scientific-project identity.
| Capability or claim | Status | Evidence |
|---|---|---|
| Typed World syntax, event-driven transitions, guards, and event payloads | Implemented in the reference interpreter | World rules, events, evals |
| Seeded Bernoulli/Uniform sampling and local event scheduling | Implemented; assumption-driven only | Stochastic specification, evaluation |
Source imports and first std:marketing/lead_response.fnl module |
Implemented, one exported entity/agent per module | Library contract, evaluation |
Installed CLI starter and source-tagged v0.2.0a1 preview |
Published via Git tag; CI and clean-directory Git install verified | Preview specification, attestation |
| Market digital twin, fitted human behavior, causal lift prediction, PyMC/OmniTwin adapter | Research intent; not validated or shipped as the World runtime | Paper and limitations |
Live marketing actions, fpm registry, PyPI distribution |
Not shipped | Ecosystem proposal, preview limits |
The source preview is reproducible for a given model, event sequence, and seed. This does not establish statistical calibration, economic realism, or out-of-sample predictive accuracy.
The public v0.2.0a1 tag can be installed without cloning the research repository. Python 3.12+ and uv are required:
uvx --from "git+https://github.com/funnelscript/funnelscript@v0.2.0a1" funnelscript --version
uvx --from "git+https://github.com/funnelscript/funnelscript@v0.2.0a1" funnelscript init-world first.fnl
uvx --from "git+https://github.com/funnelscript/funnelscript@v0.2.0a1" funnelscript check first.fnl
uvx --from "git+https://github.com/funnelscript/funnelscript@v0.2.0a1" funnelscript run-world first.fnl --event '{"name":"Prospect.Impression","time":0,"payload":{"cpc":2.0,"conversion_probability":0.7,"order_value":100.0}}' --seed 1This models one assumed lead journey, not a market population. The application tutorial covers the result and local module extension. A Git tag is not a PyPI release or a standalone GitHub Release object.
- Domain-neutral event kernel and evaluation
- World declarations and evaluation
- World rules and evaluation
- Local event emission and evaluation
- Typed guards and evaluation
- Typed event payloads and evaluation
- Stochastic operators and evaluation
- Marketing source library and evaluation
- Installed developer preview and documentation contract and evaluation
- Reference EBNF, JSON Schema
- Bundled contributor agent skills, resource integrity contract and evaluation
- Research manuscript, LaTeX source, and bibliography
- Exploratory notebook and engineering notes: exploratory, not evidence of calibrated market forecasting
- Accepted decisions, debates, and unproven hypotheses
- Marketing Systems Engineering, fpm concept, and ecosystem growth plan: design proposals where not corroborated by the interpreter
Follow the research contribution guide. This repository has a standard-library documentation-link check: python3 -m unittest discover -s tests -v. Runtime and frontend changes belong in the application contribution workflow.
MIT.