Skip to main content

Crate dpm_model

Crate dpm_model 

Source
Expand description

Authoritative domain types and structural validation for execution plans.

Structs§

AcceptanceCriterion
Observable evidence required for submitted work.
ActivityEntry
An activity record addressed by its position in the activity feed.
ActivityGap
Records the feed no longer holds because retention removed them.
ActivityInput
What a caller asks to record as one activity record.
ActivityKindParseError
An activity kind word no record has.
ActivityPage
A bounded page of the activity feed.
ActivityRecord
One recorded activity record.
ActivityTally
What one run’s activity amounts to, kept so retention cannot erase the fact of its silence or the boundary that makes retries safe.
ActorId
Local principal identity; kind and name jointly distinguish actors.
Artifact
Reference to evidence with its creating principal and timestamp.
ArtifactId
Stable UUID identifying a ArtifactId.
AssetId
Stable UUID identifying a AssetId.
AssetRequirement
One explicit asset needed to perform a task.
BasisStatus
A successor’s effective basis on one provisional edge, with its derived state.
BeyondCalendar
A time or amount of working time outside the compiled window.
CalendarDefinition
Weekly working periods and dated exceptions of one named calendar.
CalendarException
Local dates, inclusive, whose working periods replace the weekly pattern.
Calendars
Workspace calendars; present only when some work follows working time.
ClaimRelease
An owner giving back an unstarted claim.
ClockTime
Minutes after local midnight, from 00:00 to 24:00 inclusive.
ContractObservation
The contract a run executes against, as observed at its start.
Decision
A question or choice included in work context, optionally blocking execution.
DecisionId
Stable UUID identifying a DecisionId.
DecisionOption
One structured alternative of a decision; decide must select exactly one option key.
Dependency
Independently addressable temporal constraint between two work items.
DependencyBasis
Immutable reference to the predecessor attempt a successor’s execution relies on.
DependencyId
Stable UUID identifying a DependencyId.
DependencyWaiver
Recorded decision to stop enforcing a soft constraint.
ExactSource
The exact, immutable source content a run’s source references resolved to when it started.
ExecutionEvents
Times recorded by a task’s own lifecycle commands; never supplied by plan authors.
ExecutionRecord
Execution records protected as one value by reviewed plan changes.
ExecutionStep
One inspectable action and the observable result it should produce.
ExternalIdentity
Identity of an external object, independent of its display label and URL.
ExternalLink
One work item’s link to an external object; it is context, never evidence or a gate.
ExternalObservation
An attributed report of external state; it never changes local work status.
ExternalReference
External object known to the workspace, with its display data and local links.
ExternalReferenceId
Stable UUID identifying a ExternalReferenceId.
Handoff
Authorized transfer of claimed or started work between owners.
Key
Human-readable identifier, unique within its entity category.
KindCalendars
Default calendar name per actor kind.
LatestActivity
The most recent activity record a run received.
LifecycleEntry
A lifecycle fact addressed by its position in the lifecycle feed.
LifecycleEvent
One recorded lifecycle fact. A run’s start is its first one, with the run’s identity as its own.
LifecyclePage
A bounded page of the lifecycle feed.
LineageId
Stable UUID identifying a LineageId.
NormalizedActivity
An activity record’s text after the size bound, with whether it was cut and what it was.
ObjectKey
What decides whether two records name one external object.
ObservationParseError
An observation word no run has.
OperationId
Stable UUID identifying a OperationId.
Plan
Authoritative graph and revision; scheduling and completion views are derived.
Project
Project objective, optionally nested under another project.
ProjectId
Stable UUID identifying a ProjectId.
Requirement
Traceable motivation for one or more work items.
RequirementId
Stable UUID identifying a RequirementId.
ResolvedCalendar
Calendar and actor kind a projection uses for one work item.
ReviewRejection
Independent review explaining why submitted work needs another attempt.
Risk
Identified uncertainty with probability and related work.
RiskId
Stable UUID identifying a RiskId.
RunEventId
Stable UUID identifying a RunEventId.
RunFeedHeads
The positions of a run store’s durable facts.
RunId
Stable UUID identifying a RunId.
RunLink
An explicit association of a committed project operation with the run that performed it.
RunProvenance
What the recorder attests about the runtime a run executed in, fixed when the run starts.
RunRecord
A run as recorded when it started.
RunSession
The external runtime session a run belongs to, named by the provider’s own identifiers.
RunSnapshot
Everything a store holds about one run, before any clock or plan is applied.
RunStart
What a caller asks to record when a run starts; the application adds what it observes.
RunStateParseError
A state word no run has.
RunTransition
What a caller asks to record as a run’s next lifecycle transition.
RunView
A run with its derived observation, evaluated at one clock reading.
ScheduleInputs
Priority and uncertainty inputs used to derive schedule projections.
SiblingOrder
Lexicographic fractional position. Concurrent equal positions use the work ID as a tie-breaker. Digits may contain zero internally; a nonzero final digit leaves room before every position.
StartRelease
Release of an edge for the successor’s start, and the predecessor attempt it was measured from.
SubmissionAttempt
One submission of a task, identified by its 1-based ordinal within that task.
ThreePointEstimate
Ordered non-negative duration estimates in elapsed hours.
Timeline
Execution events and derived completion times of every work item at one clock reading.
WeekPattern
Local working periods per weekday, ordered and non-overlapping.
WorkCondition
Applicability of work, and of everything it contains, to one option of a decision.
WorkContract
The authored scope an executor must satisfy.
WorkInstructions
Author-supplied procedure and scope for an executable task, not execution authorization.
WorkItem
Execution contract and authoritative lifecycle for a unit of work.
WorkItemId
Stable UUID identifying a WorkItemId.
WorkLink
Typed non-gating link, identified by its kind and unordered endpoint pair.
WorkingPeriod
A local working period on one day, written {"from": "08:00", "to": "12:00"}; to may be 24:00.
WorkingTime
Working spans of one calendar within a window, or every hour for the always calendar.
Workspace
Top-level namespace for a plan.
WorkspaceAsset
Shared asset identity independent of local paths and remote addresses.
WorkspaceId
Stable UUID identifying a WorkspaceId.

Enums§

ActivityKind
What a reported activity record describes.
ActorKind
Principal category recorded in an audit operation.
ActorParseError
A principal spelled other than human:NAME, agent:NAME or service:NAME.
Applicability
Whether work belongs to the active execution graph, derived from decisions and constraints.
ArtifactKind
Category of externally stored work evidence.
AssetAccess
The access a task needs; this describes scope, not an authorization grant.
AssetKind
WorkspaceAsset category supporting both code and non-code work.
AttemptOutcome
Independent review result of one submission attempt.
BasisSource
Operation that recorded a dependency basis.
BasisState
Derived validity of a recorded basis; never stored.
CalendarRules
A calendar’s weekly and exception rules, or a built-in.
CalendarSource
How a calendar was chosen for work, from the most to the least specific rule.
DecisionStatus
Lifecycle of a recorded choice or question that can optionally gate execution.
DependencyKind
Temporal lower bound relating two activity endpoints.
DependencyPolicy
Whether an authorized reviewer may temporarily set a constraint aside.
Endpoint
One end of an activity; zero-duration milestones start and finish at the same event.
EstimateError
Invalid duration uncertainty supplied by a plan author.
EventTime
When an event that has occurred happened.
ExternalLinkRole
How linked work relates to an external object.
ExternalObjectKind
Category of external object. The provider table maps each kind to a number space, so a kind separates identity only where the provider numbers it separately.
ExternalProvider
Tracker or forge family; its row in the provider table decides namespaces, kinds, number spaces and identifier spelling.
ExternalState
External lifecycle state as last reported by an actor; the local lifecycle stays authoritative.
Holding
The record through which an actor held a task at or before some time.
JoinPolicy
How a merge point treats incoming constraints whose predecessor is not selected.
LagBasis
Whether a lag counts elapsed hours or working hours of the successor’s calendar.
LineageStatus
Whether a run was recorded in the history the project store now continues.
Observation
How completely DPM observes the executor.
ObservedStatus
What an observer can honestly say about a run at one clock reading.
OrderError
A requested insertion cannot be represented between its supplied bounds.
Orphan
Why a run that is not finished no longer matches the task it executes.
Priority
Human priority, separate from scheduling criticality.
Release
State of a constraint that waits for an event plus elapsed lag, at one clock reading.
RiskImpact
Qualitative consequence of a risk.
RunSource
An exact, immutable reference to the source a run executes against.
RunState
Where a run stands according to its last recorded transition.
StartBasis
Which predecessor result releases a finish-to-start edge for the successor’s start.
ValidationError
A graph invariant violated by external or edited domain data.
WorkKind
Whether work is executable or a derived grouping/condition.
WorkLinkKind
Contextual relationship between work items; never an execution or schedule constraint.
WorkStatus
Authoritative lifecycle for tasks; aggregate completion is a query projection.

Constants§

ALWAYS
Built-in calendar counting every hour, the elapsed-time behaviour of a plan without calendars.
MAX_ACTIVITY_BATCH
Most activity records one request may carry.
MAX_ACTIVITY_TEXT_BYTES
Longest activity text kept; longer text is truncated and flagged, and a digest of the whole text stays with the record so a retry is still compared against everything that was sent.
MAX_CALENDAR_HOURS
Largest estimate or lag, in hours, a plan with calendars may state: about 24 years of Standard working time, far below the reach of a projection window, so one task can never put every forecast out of range.
MAX_DETAIL_BYTES
Longest detail text a lifecycle transition accepts.
MAX_PROVENANCE_BYTES
Longest model or version a run’s provenance accepts.
MAX_SOURCES
Most exact source references one run may carry.
MAX_WINDOW_HOURS
Longest window a calendar is compiled over: a century, of which schedule projections reach at least three quarters ahead of their clock reading. Work that needs more calendar than this is out of range rather than an unbounded allocation; validation refuses calendars closed for longer than five years, so only extreme durations or lags reach it.
STANDARD
Built-in calendar matching Microsoft Project’s Standard: Monday to Friday, 08:00-12:00 and 13:00-17:00. A plan may redefine it.

Functions§

basis_dependents
Effective bases of other work that rely on attempts of this predecessor.
basis_status
Effective basis of a work item on each provisional edge, derived from attempt records.
completion
Derive completed task, milestone and package identities at a clock reading.
is_exact_commit
Whether commit is a full lowercase hexadecimal object name of 40 or 64 digits.
standard_definition
Microsoft Project’s Standard calendar: Monday to Friday, 08:00-12:00 and 13:00-17:00.