Research runs
The run model, company research versioning, and why CRs are versioned.
A research run is a batch job that researches one or more companies against a single offering. It is the primary unit of work in Client Path.
Run lifecycle
A run moves through these statuses:
| Status | Meaning |
|---|---|
| Queued | Run has been created and is waiting for workers to pick it up |
| In progress | Workers are actively researching companies |
| Completed | All company research is done |
| Failed | One or more companies encountered an unrecoverable error |
What a run contains
Each run records:
- The offering version and methodology version active at the time it started.
- The company profile version active at the time it started.
- A list of company research records, one per company included in the run.
- A rollup report once all companies are complete: a cross-company summary with cohort analysis.
Company research (CR)
A company research (CR) is the per-company unit within a run. Each CR contains:
- Findings: discrete pieces of intelligence extracted from public sources.
- A report: a prose narrative synthesising the findings.
- A propensity score: 0-100, derived by evaluating findings against the methodology rubric.
- An outreach draft: an AI-written message anchored to the top findings (if enabled).
Versioning and immutability
Company research records are versioned. Once a CR completes, its findings, report, and score are fixed. If you re-research a company (start a new run including that company), a new CR record is created and the old one is preserved.
This versioning is intentional:
- It lets you compare how a company's profile has changed across runs.
- It means findings and scores in reports are always traceable to the exact run inputs (offering version, methodology version, company profile version).
Concurrent runs
You can have multiple active runs at once. For example, you might run one batch against your "Enterprise" offering while another runs against "SMB". Each run is independent.
Run scope
A single run can include as many companies as needed. Very large batches (hundreds of companies) are queued and worked through progressively.
See also: findings, propensity scoring, rollup, starting a run.