Expand description
Authoritative domain types and structural validation for execution plans.
Structs§
- Acceptance
Criterion - Observable evidence required for submitted work.
- Activity
Entry - An activity record addressed by its position in the activity feed.
- Activity
Gap - Records the feed no longer holds because retention removed them.
- Activity
Input - What a caller asks to record as one activity record.
- Activity
Kind Parse Error - An activity kind word no record has.
- Activity
Page - A bounded page of the activity feed.
- Activity
Record - One recorded activity record.
- Activity
Tally - 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.
- Artifact
Id - Stable UUID identifying a ArtifactId.
- AssetId
- Stable UUID identifying a AssetId.
- Asset
Requirement - One explicit asset needed to perform a task.
- Basis
Status - A successor’s effective basis on one provisional edge, with its derived state.
- Beyond
Calendar - A time or amount of working time outside the compiled window.
- Calendar
Definition - Weekly working periods and dated exceptions of one named calendar.
- Calendar
Exception - Local dates, inclusive, whose working periods replace the weekly pattern.
- Calendars
- Workspace calendars; present only when some work follows working time.
- Claim
Release - An owner giving back an unstarted claim.
- Clock
Time - Minutes after local midnight, from
00:00to24:00inclusive. - Contract
Observation - The contract a run executes against, as observed at its start.
- Decision
- A question or choice included in work context, optionally blocking execution.
- Decision
Id - Stable UUID identifying a DecisionId.
- Decision
Option - One structured alternative of a decision;
decidemust select exactly one option key. - Dependency
- Independently addressable temporal constraint between two work items.
- Dependency
Basis - Immutable reference to the predecessor attempt a successor’s execution relies on.
- Dependency
Id - Stable UUID identifying a DependencyId.
- Dependency
Waiver - Recorded decision to stop enforcing a soft constraint.
- Exact
Source - The exact, immutable source content a run’s source references resolved to when it started.
- Execution
Events - Times recorded by a task’s own lifecycle commands; never supplied by plan authors.
- Execution
Record - Execution records protected as one value by reviewed plan changes.
- Execution
Step - One inspectable action and the observable result it should produce.
- External
Identity - Identity of an external object, independent of its display label and URL.
- External
Link - One work item’s link to an external object; it is context, never evidence or a gate.
- External
Observation - An attributed report of external state; it never changes local work status.
- External
Reference - External object known to the workspace, with its display data and local links.
- External
Reference Id - Stable UUID identifying a ExternalReferenceId.
- Handoff
- Authorized transfer of claimed or started work between owners.
- Key
- Human-readable identifier, unique within its entity category.
- Kind
Calendars - Default calendar name per actor kind.
- Latest
Activity - The most recent activity record a run received.
- Lifecycle
Entry - A lifecycle fact addressed by its position in the lifecycle feed.
- Lifecycle
Event - One recorded lifecycle fact. A run’s start is its first one, with the run’s identity as its own.
- Lifecycle
Page - A bounded page of the lifecycle feed.
- Lineage
Id - Stable UUID identifying a LineageId.
- Normalized
Activity - An activity record’s text after the size bound, with whether it was cut and what it was.
- Object
Key - What decides whether two records name one external object.
- Observation
Parse Error - An observation word no run has.
- Operation
Id - Stable UUID identifying a OperationId.
- Plan
- Authoritative graph and revision; scheduling and completion views are derived.
- Project
- Project objective, optionally nested under another project.
- Project
Id - Stable UUID identifying a ProjectId.
- Requirement
- Traceable motivation for one or more work items.
- Requirement
Id - Stable UUID identifying a RequirementId.
- Resolved
Calendar - Calendar and actor kind a projection uses for one work item.
- Review
Rejection - Independent review explaining why submitted work needs another attempt.
- Risk
- Identified uncertainty with probability and related work.
- RiskId
- Stable UUID identifying a RiskId.
- RunEvent
Id - Stable UUID identifying a RunEventId.
- RunFeed
Heads - 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.
- RunState
Parse Error - 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.
- Schedule
Inputs - Priority and uncertainty inputs used to derive schedule projections.
- Sibling
Order - 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.
- Start
Release - Release of an edge for the successor’s start, and the predecessor attempt it was measured from.
- Submission
Attempt - One submission of a task, identified by its 1-based ordinal within that task.
- Three
Point Estimate - Ordered non-negative duration estimates in elapsed hours.
- Timeline
- Execution events and derived completion times of every work item at one clock reading.
- Week
Pattern - Local working periods per weekday, ordered and non-overlapping.
- Work
Condition - Applicability of work, and of everything it contains, to one option of a decision.
- Work
Contract - The authored scope an executor must satisfy.
- Work
Instructions - Author-supplied procedure and scope for an executable task, not execution authorization.
- Work
Item - Execution contract and authoritative lifecycle for a unit of work.
- Work
Item Id - Stable UUID identifying a WorkItemId.
- Work
Link - Typed non-gating link, identified by its kind and unordered endpoint pair.
- Working
Period - A local working period on one day, written
{"from": "08:00", "to": "12:00"};tomay be24:00. - Working
Time - Working spans of one calendar within a window, or every hour for the
alwayscalendar. - Workspace
- Top-level namespace for a plan.
- Workspace
Asset - Shared asset identity independent of local paths and remote addresses.
- Workspace
Id - Stable UUID identifying a WorkspaceId.
Enums§
- Activity
Kind - What a reported activity record describes.
- Actor
Kind - Principal category recorded in an audit operation.
- Actor
Parse Error - A principal spelled other than
human:NAME,agent:NAMEorservice:NAME. - Applicability
- Whether work belongs to the active execution graph, derived from decisions and constraints.
- Artifact
Kind - Category of externally stored work evidence.
- Asset
Access - The access a task needs; this describes scope, not an authorization grant.
- Asset
Kind - WorkspaceAsset category supporting both code and non-code work.
- Attempt
Outcome - Independent review result of one submission attempt.
- Basis
Source - Operation that recorded a dependency basis.
- Basis
State - Derived validity of a recorded basis; never stored.
- Calendar
Rules - A calendar’s weekly and exception rules, or a built-in.
- Calendar
Source - How a calendar was chosen for work, from the most to the least specific rule.
- Decision
Status - Lifecycle of a recorded choice or question that can optionally gate execution.
- Dependency
Kind - Temporal lower bound relating two activity endpoints.
- Dependency
Policy - 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.
- Estimate
Error - Invalid duration uncertainty supplied by a plan author.
- Event
Time - When an event that has occurred happened.
- External
Link Role - How linked work relates to an external object.
- External
Object Kind - 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.
- External
Provider - Tracker or forge family; its row in the provider table decides namespaces, kinds, number spaces and identifier spelling.
- External
State - 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.
- Join
Policy - 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.
- Lineage
Status - Whether a run was recorded in the history the project store now continues.
- Observation
- How completely DPM observes the executor.
- Observed
Status - What an observer can honestly say about a run at one clock reading.
- Order
Error - 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.
- Risk
Impact - 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.
- Start
Basis - Which predecessor result releases a finish-to-start edge for the successor’s start.
- Validation
Error - A graph invariant violated by external or edited domain data.
- Work
Kind - Whether work is executable or a derived grouping/condition.
- Work
Link Kind - Contextual relationship between work items; never an execution or schedule constraint.
- Work
Status - 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
commitis 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.