chore(building-block-workflow): checkpoint pending development updates

Directory.Build.props

@@ -3,8 +3,8 @@
     <Authors>AgileWebs</Authors>
     <Company>AgileWebs</Company>
     <RepositoryType>git</RepositoryType>
-    <RepositoryUrl>http://192.168.10.100:3000/AgileWebs/building-block-workflow</RepositoryUrl>
-    <PackageProjectUrl>http://192.168.10.100:3000/AgileWebs/building-block-workflow</PackageProjectUrl>
+    <RepositoryUrl>https://gitea.dream-views.com/AgileWebs/building-block-workflow</RepositoryUrl>
+    <PackageProjectUrl>https://gitea.dream-views.com/AgileWebs/building-block-workflow</PackageProjectUrl>
     <PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance>
   </PropertyGroup>
 </Project>

docs/roadmap/feature-epics.md

@@ -0,0 +1,18 @@
+# Feature Epics
+
+## Repository
+building-block-workflow
+
+## Core Epics
+- Epic 1: Expand domain-aligned capabilities for restaurant operations.
+- Epic 2: Stabilize service contracts for containerized runtime integration.
+- Epic 3: Improve observability and operational readiness for demo compose environments.
+
+## Domain-Specific Candidate Features
+- Order lifecycle consistency and state transitions.
+- Kitchen queue and dispatch optimization hooks.
+- Operations control-plane policies (flags, service windows, overrides).
+- POS closeout and settlement summary alignment.
+
+## Documentation Contract
+Any code change in this repository must include docs updates in the same branch.

src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs

@@ -5,6 +5,10 @@ namespace BuildingBlock.Workflow.Contracts.Abstractions;
 
 public interface IWorkflowCapabilityContract
 {
+    Task<CreateWorkflowWorkItemResponse> CreateWorkflowWorkItemAsync(
+        CreateWorkflowWorkItemRequest request,
+        CancellationToken cancellationToken);
+
     Task<TransitionWorkflowStateResponse> TransitionWorkflowStateAsync(
         TransitionWorkflowStateRequest request,
         CancellationToken cancellationToken);

src/BuildingBlock.Workflow.Contracts/Requests/CreateWorkflowWorkItemRequest.cs

@@ -0,0 +1,11 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Requests;
+
+public sealed record CreateWorkflowWorkItemRequest(
+    string WorkItemId,
+    string WorkType,
+    int Priority,
+    DateTime RequestedAtUtc,
+    WorkflowState InitialState,
+    string CorrelationId);

src/BuildingBlock.Workflow.Contracts/Responses/CreateWorkflowWorkItemResponse.cs

@@ -0,0 +1,9 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Responses;
+
+public sealed record CreateWorkflowWorkItemResponse(
+    string WorkItemId,
+    WorkflowState State,
+    bool Created,
+    string? RejectionReason);