Crate dpm_engine 

Validated commands and consistent execution projections for humans and agents.

Structs

AffectedWork

Work whose execution context contains a replaced decision or its replacement.

AgingWork

One task in progress and how long it has been held.

ApplicabilityChange

Work whose membership in the active graph a proposal changes.

AppliedCalibration

The factors a calibrated status applied to a copy of the plan; the stored plan and its estimates are unchanged.

AppliedFactor

The estimate factor for one executor kind.

AppliedReviewDelay

The review wait added for tasks still awaiting verification.

BasisReport

Derived validity of recorded provisional bases, read from the snapshot’s attempt records.

CalibrationReport

Calibration of estimates and waits, and flow metrics, at one clock reading.

CalibrationRules

Thresholds and units of a calibration report.

ChangePreview

Validated, read-only review of a proposed plan against one revision.

ClaimOutcomes

Counts of claim episodes by how they ended.

Durations

Distribution of elapsed durations.

EntityChange

One entity-level semantic difference, including explicit additions and removals.

EstimateCalibration

Actual against estimated execution time.

EstimateSample

One verified task’s actual execution time against its estimate.

Exclusion

Items left out of one measurement for one reason.

ExecutionContext

Resolved domain records needed by an agent to execute a work contract without guessing references.

ExternalLinkRequest

Link request recording the resolved reference identifier so the operation log is explicit.

FlowReport

Flow metrics at one clock reading.

ForecastSpread

Two measures of the finish’s spread, which differ wherever near-critical paths matter.

GateReport

Shared eligibility of one lifecycle transition for queries, commands and terminal projections.

HistoryCoverage

Extent of the operation log the report read.

HolderOutcomes

Episodes of one holder kind.

InapplicableWork

Work outside the active graph, with the derived reason.

MilestoneForecast

Sampled finish of one milestone, in elapsed hours after the clock reading.

NextWorkCandidate

Ready task with a reproducible priority score and its explanation.

NextWorkQuery

Eligibility and scheduling inputs for a work recommendation.

NextWorkResult

Versioned next result: global ranking, then scope, then limit.

OpenChoices

Open decisions whose options decide which conditional work applies.

Operation

Audit envelope for one successfully applied command.

OperationFacts

What a committed operation records about itself, as the project store returned it.

OutsideScope

Eligible work that the scope excluded, kept visible rather than hidden.

PathStep

One activity on the mean critical path.

PertApproximationReport

The analytic approximation and the path it follows.

ProgressProjection

Derived progress values, never persisted as replacement domain objects.

ProgressSummary

Execution progress is distinct from independent acceptance of the result. The default is no reported progress and no acceptance.

ProvisionalRelease

A provisional edge released on a predecessor’s pending attempt; a start records it as basis.

RatioGroup

Distribution of actual/estimated ratios in one group.

ReasonCount

How many items one reason left out.

Reliability

How claims ended: each claim, or handoff to a new holder, opens one episode.

RiskForecast

Sampled and analytic schedule risk of the remaining work.

ScenarioForecast

Remaining forecast if the open decisions select these options now.

ScheduleProjection

The authoritative remaining-work schedule projection of one snapshot at one clock reading.

ScheduleSpan

Scheduled range of one work item in elapsed hours, with whether the critical path touches it.

ScheduleUncertainty

Seeded Monte Carlo completion percentiles, in elapsed hours.

ScheduledRelation

One outstanding constraint and how tightly it binds its successor.

ScheduledTimes

Critical-path times of one work item the active graph schedules, in elapsed hours after the evaluation time.

ScheduledWork

One row of the schedule projection.

ScopeMember

A resolved scope entry, echoed so callers see exactly which entities were applied.

ScopedCandidate

A candidate within scope, carrying its position in the unfiltered ranking.

StatusSummary

Execution counts and remaining schedule projections.

Throughput

Tasks verified in recent periods, counted by their verification time.

WaitGroup

Distribution of elapsed waits for one actor kind.

WaitReport

Waits grouped by the kind of actor that ended them.

WeekCount

Tasks verified in one ISO week.

WorkExplanation

Execution contract, prerequisites, and derived reason for a work item.

WorkScope

Project and asset membership filter; an empty axis does not filter.

Enums

Advisory

Advice about the caller’s situation, shown beside the ranking.

Command

A semantic state change; adapters must use the engine to apply it.

CriticalityBasis

Which projection a candidate’s criticality component comes from.

EdgeRelaxation

How a reviewed change weakens an edge that touches the applying actor’s own work.

EngineError

A rejected command or failed execution projection.

ExclusionReason

Why recorded work or a decision was left out of a measurement.

HourBasis

How actual execution time is counted.

LinkRefusal

Why an operation cannot be attributed to a run.

ProgressScope

Whether a work item’s own conditions let it count toward progress.

RelaxedConstraint

A constraint that a reviewed change would relax for work the applying actor owns.

RunError

Why a run request was refused.

ScopeError

A scope key that does not name an entity in the current plan.

Transition

Task lifecycle transition whose relation gates are evaluated.

UnmetGate

Machine-readable reason preventing a lifecycle transition at the evaluated time.

Constants

BULK_WINDOW_SECONDS

Start and submit operations committed this close together, neither naming an occurrence time, were recorded after the fact in one sitting, so their interval says nothing about the work.

MAX_APPLIED_RATIO

Largest group median a calibrated forecast applies.

MAX_SCENARIOS

Scenario forecasts are computed only up to this many option combinations.

MIN_ACTUAL_SECONDS

Actual working time below this is no measurement: start and submit were recorded together, or the whole interval fell outside the task’s working hours.

MIN_AGENT_APPLIED_RATIO

Smallest group median a calibrated forecast applies to agents. Agents finishing human-scale estimates routinely measure 0.01-0.1, so their floor sits below that range; near-zero samples are already excluded by MIN_ACTUAL_SECONDS.

MIN_APPLIED_RATIO

Smallest group median a calibrated forecast applies to people and services; lower says the records, such as times typed in afterwards, not the estimates, are wrong.

MIN_SAMPLES

Samples a group needs before a calibrated forecast applies its median.

NEXT_RESULT_VERSION

Shape version of NextWorkResult; incremented on any incompatible field change.

REVIEW_FLOOR_SECONDS

A review recorded this soon after its submission was recorded together with it; no one reads and judges a result that fast, so it is no wait.

STALE_AFTER

How long a working or waiting run may go unheard before it is reported stale.

THROUGHPUT_WEEKS

ISO weeks the throughput history covers, the current one included.

Functions

advisories

Advice for an actor about to choose work: whether it already holds claims.

apply_command

Apply one validated semantic command atomically and return its audit operation.

apply_plan_change

Apply a reviewed full proposal as one delta operation.

authorize_run

Refuse an agent that is not the run’s executor; humans and services may record any run.

calibration

Measure estimates, waits and flow from a validated plan and its operation log in append order.

check_link

Check that attributing operation to record cannot be wrong.

check_run_transition

Check a move from the run’s current state.

completion

Derive completed task, milestone and package identities at a clock reading.

describe_applicability

Human-readable reason work is outside the active graph, naming decisions and work by key.

excluded_in_flight

Claimed, started, blocked or submitted work outside the status scope: a reviewed choice change excluded it, so it takes no transition until the plan changes again. status counts it as excluded_in_flight.

explain_work

Explain a validated work item at an adapter-supplied time, including derived completion.

gate_report

Explain whether a transition is permitted at an adapter-supplied time, without changing state.

in_status_scope

Whether work’s lifecycle counts in status lifecycle counts, complete and progress: its own conditions are selected. Views that list work behind those counts use this scope, so a list never shows work its count leaves out.

is_ready

Whether a planned task can be claimed at an adapter-supplied time.

is_unestimated

Whether work enters the remaining forecast at 0 h only because it has no estimate.

json_equivalent

Whether two JSON values carry the same data. Numbers compare by value: a client that decodes and re-encodes a reviewed change may write 2.0 as 2, and that is the state it was reviewed against, not a stale one.

min_applied_ratio

Smallest group median a calibrated forecast applies to an executor kind.

next_in_scope

Rank eligible work on the full graph at an adapter-supplied time, then partition it by scope and apply the limit.

next_work

Recommend only tasks claimable at an adapter-supplied time and compatible with capabilities.

observe_run_start

Validate a start against the plan and capture the contract it observes.

patch

Apply entity changes to current without any policy check.

plan_change

Turn a reviewed full proposal into the delta command the operation log records.

progress

Compute execution percentages without inferring work from elapsed time or changing the schedule.

project_run

Compute a run’s view at now.

propose_change

Validate a proposed plan without changing state, lifecycle, evidence or decision outcomes.

propose_revert

Review the change that undoes a recorded plan change, against the current plan.

protected_work

Work whose authored contract and position are fixed by execution, including its ancestors and transitive prerequisites. Adapters may use these anchors without duplicating review policy.

run_start_event

The transition identity of a run’s start, which is the run’s own identity.

schedule_projection

Project the remaining schedule; probabilistic adds the simulation status and next use.

schedule_span

Scheduled range of item, or None for work the timeline places outside the active graph; packages span their applicable descendants. This is the rule the terminal Gantt draws.

show_work

Return a work projection with aggregate completion reflected in its lifecycle.

status

Project validated lifecycle counts and remaining duration at an adapter-supplied time.

status_at_horizon

status whose forecast also states the probability of finishing the project, and of reaching each milestone, within horizon_hours elapsed hours of now.

status_calibrated

status whose forecasts scale each unfinished task’s estimate by its executor kind’s measured ratio and add the verifier kind’s measured review wait, each only when enough samples support it; calibration in the result states what was applied and why. The plan itself is never changed.

status_calibrated_at_horizon

status_calibrated with the horizon probabilities of status_at_horizon.

unestimated

Keys of every work item is_unestimated reports, in key order.