valuation

Financial Valuation

Read sourced valuation evidence or run deterministic financial models using OloLand's computation engines.

Usage

/valuation <deal_id> read [method]
/valuation <deal_id> run <method>
/valuation <deal_id> refresh <method>

Arguments

• deal_id (required) — The deal ID to value.
• action (required for mutation) — read, run, or refresh. Only the literal run or refresh action authorizes the named engine calls for this invocation. If the action is omitted, or an older invocation supplies a method in this position, treat the request as read; never infer mutation from the method name.
• method — Valuation method: dcf, lbo, monte-carlo, comps, or all. It defaults to dcf only for read. run and refresh require an explicit method; ask the user to name one rather than defaulting a write-like operation. comps is read-only, so reject run comps and refresh comps as unsupported without calling a model engine.

Examples:

/valuation deal123 read all
/valuation deal123 run dcf
/valuation deal123 refresh lbo
/valuation deal123 refresh all

Execution

1. Parse action before selecting any tool. Treat the literal run or refresh action as permission to execute only the requested mutating engines and only at the call counts below. read, an omitted action, or a legacy method-only invocation must use governed reads and must not create a candidate run.
2. For dcf only, fetch the persisted DCF with get_dcf_valuation. For an explicit DCF run/refresh, call run_deal_model exactly once with stages=["dcf"], even when an older usable DCF exists; do not call it again as part of a later LBO/all step. (The all method owns its single combined stages=["dcf", "lbo"] call in step 6.) Treat its result as an unpublished candidate run, not as the current decision artifact: this lightweight tool does not itself create an eligible publication. Re-fetch get_dcf_valuation separately. Call the candidate current/published only if the governed read returns a publication, receipt, matching snapshot, and the same DCF run identity; otherwise present the candidate and current governed model in separate labeled sections and state that Full Analysis (or another explicit publication workflow) is required before the candidate becomes current. Do not launch Full Analysis automatically. Without an explicit run/refresh request, preserve the request as read-only and use the governed DCF when that read returns a usable, meaningful model with the required identity; report it as unavailable only when that governed read is missing, unusable, or not meaningful.
3. For model-run outputs (DCF, LBO, and Monte Carlo), require run/publication/snapshot/receipt identity before calling an output current, published, or governed, or including it in a combined decision range or football field. An explicitly requested fresh model result may be shown before publication as a separate unpublished candidate, including its returned range, only when it carries its own candidate run/simulation identity and returned assumption provenance. State which publication/receipt fields are absent, and never call that candidate current, use it as bid input, or combine it with governed outputs. If neither the full governed identity nor an explicit candidate identity is returned, or enterprise value is ev_not_meaningful, report the model result as unavailable/not meaningful; do not substitute from a latest snapshot.