devflow-toolkit 0.3.0__py3-none-any.whl

devflow/core/state/__init__.py

@@ -0,0 +1,75 @@
+"""Workflow state, approvals and event replay."""
+
+from devflow.core.state.errors import (
+  ArtifactNotValidatedError,
+  ChangeLockedError,
+  ChangeNotFoundError,
+  InvalidEventLogError,
+  InvalidStateError,
+  InvalidTransitionError,
+  StaleArtifactError,
+  StateError,
+  UnsupportedStageError,
+)
+from devflow.core.state.events import (
+  WorkflowEvent,
+  append_event,
+  apply_event,
+  read_events,
+)
+from devflow.core.state.locator import (
+  ChangeLocation,
+  WorkflowLocator,
+)
+from devflow.core.state.manager import (
+  ApprovalResult,
+  ChangeStatus,
+  WorkflowStateManager,
+)
+from devflow.core.state.models import (
+  STAGE_ARTIFACTS,
+  STAGE_TARGETS,
+  WORKFLOW_STATUSES,
+  ApprovalRecord,
+  WorkflowState,
+  WorkflowStatus,
+)
+from devflow.core.state.transitions import (
+  artifact_blockers,
+  can_transition,
+  ensure_artifacts_ready,
+  ensure_transition,
+  required_artifacts,
+)
+
+__all__ = [
+  "STAGE_ARTIFACTS",
+  "STAGE_TARGETS",
+  "WORKFLOW_STATUSES",
+  "ApprovalRecord",
+  "ApprovalResult",
+  "ArtifactNotValidatedError",
+  "ChangeLockedError",
+  "ChangeLocation",
+  "ChangeNotFoundError",
+  "ChangeStatus",
+  "InvalidEventLogError",
+  "InvalidStateError",
+  "InvalidTransitionError",
+  "StaleArtifactError",
+  "StateError",
+  "UnsupportedStageError",
+  "WorkflowEvent",
+  "WorkflowLocator",
+  "WorkflowState",
+  "WorkflowStateManager",
+  "WorkflowStatus",
+  "append_event",
+  "apply_event",
+  "artifact_blockers",
+  "can_transition",
+  "ensure_artifacts_ready",
+  "ensure_transition",
+  "read_events",
+  "required_artifacts",
+]

devflow/core/state/errors.py

@@ -0,0 +1,39 @@
+"""Workflow state errors."""
+
+from __future__ import annotations
+
+
+class StateError(Exception):
+  """Raised when workflow state cannot be read or advanced."""
+
+
+class ChangeNotFoundError(StateError):
+  """Raised when a change directory or selector does not exist."""
+
+
+class InvalidStateError(StateError):
+  """Raised when workflow.yaml has an invalid structure."""
+
+
+class InvalidEventLogError(StateError):
+  """Raised when events.jsonl is malformed or out of sequence."""
+
+
+class InvalidTransitionError(StateError):
+  """Raised when a workflow transition is not allowed."""
+
+
+class ArtifactNotValidatedError(StateError):
+  """Raised when an artifact must be validated before approval."""
+
+
+class StaleArtifactError(StateError):
+  """Raised when an artifact changed after validation or approval."""
+
+
+class ChangeLockedError(StateError):
+  """Raised when another DevFlow operation holds the change lock."""
+
+
+class UnsupportedStageError(StateError):
+  """Raised when a stage is not part of the DevFlow lifecycle."""