@contractspec/example.workflow-system 1.44.0

package/dist/entities/instance.js

@@ -0,0 +1,168 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/instance.ts
+/**
+* Instance status enum - lifecycle of a workflow instance.
+*/
+const InstanceStatusEnum = defineEntityEnum({
+	name: "InstanceStatus",
+	values: [
+		"PENDING",
+		"RUNNING",
+		"WAITING",
+		"PAUSED",
+		"COMPLETED",
+		"CANCELLED",
+		"FAILED",
+		"TIMEOUT"
+	],
+	schema: "workflow",
+	description: "Status of a workflow instance."
+});
+/**
+* Step execution status enum.
+*/
+const StepExecutionStatusEnum = defineEntityEnum({
+	name: "StepExecutionStatus",
+	values: [
+		"PENDING",
+		"ACTIVE",
+		"COMPLETED",
+		"SKIPPED",
+		"FAILED",
+		"TIMEOUT"
+	],
+	schema: "workflow",
+	description: "Status of a step execution."
+});
+/**
+* WorkflowInstance entity - a running instance of a workflow.
+*
+* When a workflow is triggered, an instance is created. The instance
+* tracks the current state and all data associated with this execution.
+*/
+const WorkflowInstanceEntity = defineEntity({
+	name: "WorkflowInstance",
+	description: "A running instance of a workflow definition.",
+	schema: "workflow",
+	map: "workflow_instance",
+	fields: {
+		id: field.id({ description: "Unique instance ID" }),
+		workflowDefinitionId: field.foreignKey(),
+		referenceId: field.string({
+			isOptional: true,
+			description: "External reference (e.g., order ID)"
+		}),
+		referenceType: field.string({
+			isOptional: true,
+			description: "Type of reference (e.g., \"Order\")"
+		}),
+		status: field.enum("InstanceStatus", { default: "PENDING" }),
+		currentStepId: field.string({
+			isOptional: true,
+			description: "Current step being executed"
+		}),
+		contextData: field.json({ description: "Data context for this instance" }),
+		triggeredBy: field.foreignKey({ description: "User who triggered the workflow" }),
+		triggerSource: field.string({
+			isOptional: true,
+			description: "Source of trigger (e.g., \"api\", \"ui\")"
+		}),
+		organizationId: field.foreignKey(),
+		priority: field.int({
+			default: 0,
+			description: "Processing priority (higher = more urgent)"
+		}),
+		dueAt: field.dateTime({
+			isOptional: true,
+			description: "When this instance should complete"
+		}),
+		outcome: field.string({
+			isOptional: true,
+			description: "Final outcome (e.g., \"approved\", \"rejected\")"
+		}),
+		resultData: field.json({
+			isOptional: true,
+			description: "Final result data"
+		}),
+		errorMessage: field.string({
+			isOptional: true,
+			description: "Error message if failed"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		startedAt: field.dateTime({ isOptional: true }),
+		completedAt: field.dateTime({ isOptional: true }),
+		workflowDefinition: field.belongsTo("WorkflowDefinition", ["workflowDefinitionId"], ["id"]),
+		currentStep: field.belongsTo("WorkflowStep", ["currentStepId"], ["id"]),
+		stepExecutions: field.hasMany("StepExecution"),
+		approvalRequests: field.hasMany("ApprovalRequest")
+	},
+	indexes: [
+		index.on(["organizationId", "status"]),
+		index.on(["workflowDefinitionId", "status"]),
+		index.on(["referenceType", "referenceId"]),
+		index.on(["triggeredBy", "status"]),
+		index.on(["status", "dueAt"]),
+		index.on(["createdAt"])
+	],
+	enums: [InstanceStatusEnum]
+});
+/**
+* StepExecution entity - tracks execution of a step within an instance.
+*/
+const StepExecutionEntity = defineEntity({
+	name: "StepExecution",
+	description: "Execution record of a step within a workflow instance.",
+	schema: "workflow",
+	map: "step_execution",
+	fields: {
+		id: field.id({ description: "Unique execution ID" }),
+		workflowInstanceId: field.foreignKey(),
+		workflowStepId: field.foreignKey(),
+		status: field.enum("StepExecutionStatus", { default: "PENDING" }),
+		executionOrder: field.int({
+			default: 0,
+			description: "Order of execution within instance"
+		}),
+		inputData: field.json({
+			isOptional: true,
+			description: "Data when entering step"
+		}),
+		outputData: field.json({
+			isOptional: true,
+			description: "Data when exiting step"
+		}),
+		actionTaken: field.string({
+			isOptional: true,
+			description: "Action that caused transition (e.g., \"approve\")"
+		}),
+		transitionedTo: field.string({
+			isOptional: true,
+			description: "Step key transitioned to"
+		}),
+		executedBy: field.string({
+			isOptional: true,
+			description: "User who completed this step"
+		}),
+		errorMessage: field.string({ isOptional: true }),
+		errorDetails: field.json({ isOptional: true }),
+		retryCount: field.int({ default: 0 }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		startedAt: field.dateTime({ isOptional: true }),
+		completedAt: field.dateTime({ isOptional: true }),
+		workflowInstance: field.belongsTo("WorkflowInstance", ["workflowInstanceId"], ["id"], { onDelete: "Cascade" }),
+		workflowStep: field.belongsTo("WorkflowStep", ["workflowStepId"], ["id"])
+	},
+	indexes: [
+		index.on(["workflowInstanceId", "executionOrder"]),
+		index.on(["workflowInstanceId", "workflowStepId"]),
+		index.on(["status"])
+	],
+	enums: [StepExecutionStatusEnum]
+});
+
+//#endregion
+export { InstanceStatusEnum, StepExecutionEntity, StepExecutionStatusEnum, WorkflowInstanceEntity };
+//# sourceMappingURL=instance.js.map

package/dist/entities/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","names":[],"sources":["../../src/entities/instance.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Instance status enum - lifecycle of a workflow instance.\n */\nexport const InstanceStatusEnum = defineEntityEnum({\n  name: 'InstanceStatus',\n  values: [\n    'PENDING', // Created but not started\n    'RUNNING', // Currently executing\n    'WAITING', // Waiting for approval/event\n    'PAUSED', // Manually paused\n    'COMPLETED', // Successfully completed\n    'CANCELLED', // Cancelled by user\n    'FAILED', // Failed due to error\n    'TIMEOUT', // Timed out\n  ] as const,\n  schema: 'workflow',\n  description: 'Status of a workflow instance.',\n});\n\n/**\n * Step execution status enum.\n */\nexport const StepExecutionStatusEnum = defineEntityEnum({\n  name: 'StepExecutionStatus',\n  values: [\n    'PENDING', // Not yet started\n    'ACTIVE', // Currently active\n    'COMPLETED', // Successfully completed\n    'SKIPPED', // Skipped due to condition\n    'FAILED', // Failed\n    'TIMEOUT', // Timed out\n  ] as const,\n  schema: 'workflow',\n  description: 'Status of a step execution.',\n});\n\n/**\n * WorkflowInstance entity - a running instance of a workflow.\n *\n * When a workflow is triggered, an instance is created. The instance\n * tracks the current state and all data associated with this execution.\n */\nexport const WorkflowInstanceEntity = defineEntity({\n  name: 'WorkflowInstance',\n  description: 'A running instance of a workflow definition.',\n  schema: 'workflow',\n  map: 'workflow_instance',\n  fields: {\n    id: field.id({ description: 'Unique instance ID' }),\n\n    // Parent workflow\n    workflowDefinitionId: field.foreignKey(),\n\n    // Reference\n    referenceId: field.string({\n      isOptional: true,\n      description: 'External reference (e.g., order ID)',\n    }),\n    referenceType: field.string({\n      isOptional: true,\n      description: 'Type of reference (e.g., \"Order\")',\n    }),\n\n    // Current state\n    status: field.enum('InstanceStatus', { default: 'PENDING' }),\n    currentStepId: field.string({\n      isOptional: true,\n      description: 'Current step being executed',\n    }),\n\n    // Context data - passed through the workflow\n    contextData: field.json({ description: 'Data context for this instance' }),\n\n    // Trigger info\n    triggeredBy: field.foreignKey({\n      description: 'User who triggered the workflow',\n    }),\n    triggerSource: field.string({\n      isOptional: true,\n      description: 'Source of trigger (e.g., \"api\", \"ui\")',\n    }),\n\n    // Ownership\n    organizationId: field.foreignKey(),\n\n    // Priority\n    priority: field.int({\n      default: 0,\n      description: 'Processing priority (higher = more urgent)',\n    }),\n\n    // Deadlines\n    dueAt: field.dateTime({\n      isOptional: true,\n      description: 'When this instance should complete',\n    }),\n\n    // Results\n    outcome: field.string({\n      isOptional: true,\n      description: 'Final outcome (e.g., \"approved\", \"rejected\")',\n    }),\n    resultData: field.json({\n      isOptional: true,\n      description: 'Final result data',\n    }),\n    errorMessage: field.string({\n      isOptional: true,\n      description: 'Error message if failed',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n    startedAt: field.dateTime({ isOptional: true }),\n    completedAt: field.dateTime({ isOptional: true }),\n\n    // Relations\n    workflowDefinition: field.belongsTo(\n      'WorkflowDefinition',\n      ['workflowDefinitionId'],\n      ['id']\n    ),\n    currentStep: field.belongsTo('WorkflowStep', ['currentStepId'], ['id']),\n    stepExecutions: field.hasMany('StepExecution'),\n    approvalRequests: field.hasMany('ApprovalRequest'),\n  },\n  indexes: [\n    index.on(['organizationId', 'status']),\n    index.on(['workflowDefinitionId', 'status']),\n    index.on(['referenceType', 'referenceId']),\n    index.on(['triggeredBy', 'status']),\n    index.on(['status', 'dueAt']),\n    index.on(['createdAt']),\n  ],\n  enums: [InstanceStatusEnum],\n});\n\n/**\n * StepExecution entity - tracks execution of a step within an instance.\n */\nexport const StepExecutionEntity = defineEntity({\n  name: 'StepExecution',\n  description: 'Execution record of a step within a workflow instance.',\n  schema: 'workflow',\n  map: 'step_execution',\n  fields: {\n    id: field.id({ description: 'Unique execution ID' }),\n\n    // Parent\n    workflowInstanceId: field.foreignKey(),\n    workflowStepId: field.foreignKey(),\n\n    // Status\n    status: field.enum('StepExecutionStatus', { default: 'PENDING' }),\n\n    // Execution order\n    executionOrder: field.int({\n      default: 0,\n      description: 'Order of execution within instance',\n    }),\n\n    // Input/Output\n    inputData: field.json({\n      isOptional: true,\n      description: 'Data when entering step',\n    }),\n    outputData: field.json({\n      isOptional: true,\n      description: 'Data when exiting step',\n    }),\n\n    // Action taken\n    actionTaken: field.string({\n      isOptional: true,\n      description: 'Action that caused transition (e.g., \"approve\")',\n    }),\n    transitionedTo: field.string({\n      isOptional: true,\n      description: 'Step key transitioned to',\n    }),\n\n    // Executor\n    executedBy: field.string({\n      isOptional: true,\n      description: 'User who completed this step',\n    }),\n\n    // Error\n    errorMessage: field.string({ isOptional: true }),\n    errorDetails: field.json({ isOptional: true }),\n\n    // Retries\n    retryCount: field.int({ default: 0 }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n    startedAt: field.dateTime({ isOptional: true }),\n    completedAt: field.dateTime({ isOptional: true }),\n\n    // Relations\n    workflowInstance: field.belongsTo(\n      'WorkflowInstance',\n      ['workflowInstanceId'],\n      ['id'],\n      { onDelete: 'Cascade' }\n    ),\n    workflowStep: field.belongsTo('WorkflowStep', ['workflowStepId'], ['id']),\n  },\n  indexes: [\n    index.on(['workflowInstanceId', 'executionOrder']),\n    index.on(['workflowInstanceId', 'workflowStepId']),\n    index.on(['status']),\n  ],\n  enums: [StepExecutionStatusEnum],\n});\n"],"mappings":"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"}

package/dist/entities/step.d.ts

@@ -0,0 +1,50 @@
+import * as _contractspec_lib_schema300 from "@contractspec/lib.schema";
+
+//#region src/entities/step.d.ts
+/**
+ * Step type enum - what kind of step this is.
+ */
+declare const StepTypeEnum: _contractspec_lib_schema300.EntityEnumDef;
+/**
+ * Approval mode enum - how approvals are handled.
+ */
+declare const ApprovalModeEnum: _contractspec_lib_schema300.EntityEnumDef;
+/**
+ * WorkflowStep entity - defines a step in a workflow.
+ *
+ * Each step represents a state in the workflow state machine,
+ * with transitions defined by the `transitions` JSON field.
+ */
+declare const WorkflowStepEntity: _contractspec_lib_schema300.EntitySpec<{
+  id: _contractspec_lib_schema300.EntityScalarField;
+  workflowDefinitionId: _contractspec_lib_schema300.EntityScalarField;
+  name: _contractspec_lib_schema300.EntityScalarField;
+  key: _contractspec_lib_schema300.EntityScalarField;
+  description: _contractspec_lib_schema300.EntityScalarField;
+  type: _contractspec_lib_schema300.EntityEnumField;
+  position: _contractspec_lib_schema300.EntityScalarField;
+  transitions: _contractspec_lib_schema300.EntityScalarField;
+  approvalMode: _contractspec_lib_schema300.EntityEnumField;
+  approverRoles: _contractspec_lib_schema300.EntityScalarField;
+  approverUserIds: _contractspec_lib_schema300.EntityScalarField;
+  escalationConfig: _contractspec_lib_schema300.EntityScalarField;
+  assigneeRoles: _contractspec_lib_schema300.EntityScalarField;
+  taskTemplate: _contractspec_lib_schema300.EntityScalarField;
+  conditionExpression: _contractspec_lib_schema300.EntityScalarField;
+  waitDuration: _contractspec_lib_schema300.EntityScalarField;
+  waitForEvent: _contractspec_lib_schema300.EntityScalarField;
+  actionType: _contractspec_lib_schema300.EntityScalarField;
+  actionConfig: _contractspec_lib_schema300.EntityScalarField;
+  timeoutSeconds: _contractspec_lib_schema300.EntityScalarField;
+  slaSeconds: _contractspec_lib_schema300.EntityScalarField;
+  notifyOnEnter: _contractspec_lib_schema300.EntityScalarField;
+  notifyOnExit: _contractspec_lib_schema300.EntityScalarField;
+  metadata: _contractspec_lib_schema300.EntityScalarField;
+  createdAt: _contractspec_lib_schema300.EntityScalarField;
+  updatedAt: _contractspec_lib_schema300.EntityScalarField;
+  workflowDefinition: _contractspec_lib_schema300.EntityRelationField;
+  executions: _contractspec_lib_schema300.EntityRelationField;
+}>;
+//#endregion
+export { ApprovalModeEnum, StepTypeEnum, WorkflowStepEntity };
+//# sourceMappingURL=step.d.ts.map

package/dist/entities/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","names":[],"sources":["../../src/entities/step.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,YAcX,EAAA,2BAAA,CAduB,aAcvB;AAKF;AAkBA;;cAlBa,kBAUX,2BAAA,CAV2B;;;;;;;cAkBhB,gDAAkB;MAwH7B,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;+DAxH6B;EAAA,UAAA,+CAAA"}

package/dist/entities/step.js

@@ -0,0 +1,135 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/step.ts
+/**
+* Step type enum - what kind of step this is.
+*/
+const StepTypeEnum = defineEntityEnum({
+	name: "StepType",
+	values: [
+		"START",
+		"APPROVAL",
+		"TASK",
+		"CONDITION",
+		"PARALLEL",
+		"WAIT",
+		"ACTION",
+		"END"
+	],
+	schema: "workflow",
+	description: "Type of workflow step."
+});
+/**
+* Approval mode enum - how approvals are handled.
+*/
+const ApprovalModeEnum = defineEntityEnum({
+	name: "ApprovalMode",
+	values: [
+		"ANY",
+		"ALL",
+		"MAJORITY",
+		"SEQUENTIAL"
+	],
+	schema: "workflow",
+	description: "How multiple approvers are handled."
+});
+/**
+* WorkflowStep entity - defines a step in a workflow.
+*
+* Each step represents a state in the workflow state machine,
+* with transitions defined by the `transitions` JSON field.
+*/
+const WorkflowStepEntity = defineEntity({
+	name: "WorkflowStep",
+	description: "A single step/state in a workflow definition.",
+	schema: "workflow",
+	map: "workflow_step",
+	fields: {
+		id: field.id({ description: "Unique step ID" }),
+		workflowDefinitionId: field.foreignKey(),
+		name: field.string({ description: "Human-readable step name" }),
+		key: field.string({ description: "Unique key within workflow (e.g., \"manager_approval\")" }),
+		description: field.string({ isOptional: true }),
+		type: field.enum("StepType", { default: "TASK" }),
+		position: field.int({
+			default: 0,
+			description: "Order for display"
+		}),
+		transitions: field.json({ description: "Map of action -> next step key" }),
+		approvalMode: field.enum("ApprovalMode", {
+			default: "ANY",
+			isOptional: true
+		}),
+		approverRoles: field.string({
+			isArray: true,
+			description: "Roles that can approve"
+		}),
+		approverUserIds: field.string({
+			isArray: true,
+			description: "Specific users that can approve"
+		}),
+		escalationConfig: field.json({
+			isOptional: true,
+			description: "Escalation rules"
+		}),
+		assigneeRoles: field.string({
+			isArray: true,
+			description: "Roles that can be assigned"
+		}),
+		taskTemplate: field.json({
+			isOptional: true,
+			description: "Template for task creation"
+		}),
+		conditionExpression: field.string({
+			isOptional: true,
+			description: "Expression for branching"
+		}),
+		waitDuration: field.int({
+			isOptional: true,
+			description: "Wait duration in seconds"
+		}),
+		waitForEvent: field.string({
+			isOptional: true,
+			description: "Event name to wait for"
+		}),
+		actionType: field.string({
+			isOptional: true,
+			description: "Action to execute"
+		}),
+		actionConfig: field.json({
+			isOptional: true,
+			description: "Action parameters"
+		}),
+		timeoutSeconds: field.int({
+			isOptional: true,
+			description: "Step timeout"
+		}),
+		slaSeconds: field.int({
+			isOptional: true,
+			description: "SLA deadline"
+		}),
+		notifyOnEnter: field.json({
+			isOptional: true,
+			description: "Notification config when entering step"
+		}),
+		notifyOnExit: field.json({
+			isOptional: true,
+			description: "Notification config when exiting step"
+		}),
+		metadata: field.json({ isOptional: true }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		workflowDefinition: field.belongsTo("WorkflowDefinition", ["workflowDefinitionId"], ["id"], { onDelete: "Cascade" }),
+		executions: field.hasMany("StepExecution")
+	},
+	indexes: [
+		index.unique(["workflowDefinitionId", "key"]),
+		index.on(["workflowDefinitionId", "position"]),
+		index.on(["type"])
+	],
+	enums: [StepTypeEnum, ApprovalModeEnum]
+});
+
+//#endregion
+export { ApprovalModeEnum, StepTypeEnum, WorkflowStepEntity };
+//# sourceMappingURL=step.js.map

package/dist/entities/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","names":[],"sources":["../../src/entities/step.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Step type enum - what kind of step this is.\n */\nexport const StepTypeEnum = defineEntityEnum({\n  name: 'StepType',\n  values: [\n    'START', // Entry point\n    'APPROVAL', // Requires human approval\n    'TASK', // Task to be completed\n    'CONDITION', // Branching based on conditions\n    'PARALLEL', // Parallel execution\n    'WAIT', // Wait for event/time\n    'ACTION', // Automated action\n    'END', // Terminal state\n  ] as const,\n  schema: 'workflow',\n  description: 'Type of workflow step.',\n});\n\n/**\n * Approval mode enum - how approvals are handled.\n */\nexport const ApprovalModeEnum = defineEntityEnum({\n  name: 'ApprovalMode',\n  values: [\n    'ANY', // Any one approver can approve\n    'ALL', // All approvers must approve\n    'MAJORITY', // Majority must approve\n    'SEQUENTIAL', // Approvers must approve in order\n  ] as const,\n  schema: 'workflow',\n  description: 'How multiple approvers are handled.',\n});\n\n/**\n * WorkflowStep entity - defines a step in a workflow.\n *\n * Each step represents a state in the workflow state machine,\n * with transitions defined by the `transitions` JSON field.\n */\nexport const WorkflowStepEntity = defineEntity({\n  name: 'WorkflowStep',\n  description: 'A single step/state in a workflow definition.',\n  schema: 'workflow',\n  map: 'workflow_step',\n  fields: {\n    id: field.id({ description: 'Unique step ID' }),\n\n    // Parent workflow\n    workflowDefinitionId: field.foreignKey(),\n\n    // Identity\n    name: field.string({ description: 'Human-readable step name' }),\n    key: field.string({\n      description: 'Unique key within workflow (e.g., \"manager_approval\")',\n    }),\n    description: field.string({ isOptional: true }),\n\n    // Type\n    type: field.enum('StepType', { default: 'TASK' }),\n\n    // Position in UI\n    position: field.int({ default: 0, description: 'Order for display' }),\n\n    // State machine transitions (JSON: { \"approve\": \"next_step\", \"reject\": \"rejected\" })\n    transitions: field.json({ description: 'Map of action -> next step key' }),\n\n    // Approval configuration (when type is APPROVAL)\n    approvalMode: field.enum('ApprovalMode', {\n      default: 'ANY',\n      isOptional: true,\n    }),\n    approverRoles: field.string({\n      isArray: true,\n      description: 'Roles that can approve',\n    }),\n    approverUserIds: field.string({\n      isArray: true,\n      description: 'Specific users that can approve',\n    }),\n    escalationConfig: field.json({\n      isOptional: true,\n      description: 'Escalation rules',\n    }),\n\n    // Task configuration (when type is TASK)\n    assigneeRoles: field.string({\n      isArray: true,\n      description: 'Roles that can be assigned',\n    }),\n    taskTemplate: field.json({\n      isOptional: true,\n      description: 'Template for task creation',\n    }),\n\n    // Condition configuration (when type is CONDITION)\n    conditionExpression: field.string({\n      isOptional: true,\n      description: 'Expression for branching',\n    }),\n\n    // Wait configuration (when type is WAIT)\n    waitDuration: field.int({\n      isOptional: true,\n      description: 'Wait duration in seconds',\n    }),\n    waitForEvent: field.string({\n      isOptional: true,\n      description: 'Event name to wait for',\n    }),\n\n    // Action configuration (when type is ACTION)\n    actionType: field.string({\n      isOptional: true,\n      description: 'Action to execute',\n    }),\n    actionConfig: field.json({\n      isOptional: true,\n      description: 'Action parameters',\n    }),\n\n    // Timeout & SLA\n    timeoutSeconds: field.int({\n      isOptional: true,\n      description: 'Step timeout',\n    }),\n    slaSeconds: field.int({ isOptional: true, description: 'SLA deadline' }),\n\n    // Notifications\n    notifyOnEnter: field.json({\n      isOptional: true,\n      description: 'Notification config when entering step',\n    }),\n    notifyOnExit: field.json({\n      isOptional: true,\n      description: 'Notification config when exiting step',\n    }),\n\n    // Metadata\n    metadata: field.json({ isOptional: true }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    workflowDefinition: field.belongsTo(\n      'WorkflowDefinition',\n      ['workflowDefinitionId'],\n      ['id'],\n      { onDelete: 'Cascade' }\n    ),\n    executions: field.hasMany('StepExecution'),\n  },\n  indexes: [\n    index.unique(['workflowDefinitionId', 'key']),\n    index.on(['workflowDefinitionId', 'position']),\n    index.on(['type']),\n  ],\n  enums: [StepTypeEnum, ApprovalModeEnum],\n});\n"],"mappings":";;;;;;AAUA,MAAa,eAAe,iBAAiB;CAC3C,MAAM;CACN,QAAQ;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,QAAQ;CACR,aAAa;CACd,CAAC;;;;AAKF,MAAa,mBAAmB,iBAAiB;CAC/C,MAAM;CACN,QAAQ;EACN;EACA;EACA;EACA;EACD;CACD,QAAQ;CACR,aAAa;CACd,CAAC;;;;;;;AAQF,MAAa,qBAAqB,aAAa;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,GAAG,EAAE,aAAa,kBAAkB,CAAC;EAG/C,sBAAsB,MAAM,YAAY;EAGxC,MAAM,MAAM,OAAO,EAAE,aAAa,4BAA4B,CAAC;EAC/D,KAAK,MAAM,OAAO,EAChB,aAAa,2DACd,CAAC;EACF,aAAa,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAG/C,MAAM,MAAM,KAAK,YAAY,EAAE,SAAS,QAAQ,CAAC;EAGjD,UAAU,MAAM,IAAI;GAAE,SAAS;GAAG,aAAa;GAAqB,CAAC;EAGrE,aAAa,MAAM,KAAK,EAAE,aAAa,kCAAkC,CAAC;EAG1E,cAAc,MAAM,KAAK,gBAAgB;GACvC,SAAS;GACT,YAAY;GACb,CAAC;EACF,eAAe,MAAM,OAAO;GAC1B,SAAS;GACT,aAAa;GACd,CAAC;EACF,iBAAiB,MAAM,OAAO;GAC5B,SAAS;GACT,aAAa;GACd,CAAC;EACF,kBAAkB,MAAM,KAAK;GAC3B,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,eAAe,MAAM,OAAO;GAC1B,SAAS;GACT,aAAa;GACd,CAAC;EACF,cAAc,MAAM,KAAK;GACvB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,qBAAqB,MAAM,OAAO;GAChC,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,cAAc,MAAM,IAAI;GACtB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,cAAc,MAAM,OAAO;GACzB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,YAAY,MAAM,OAAO;GACvB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,cAAc,MAAM,KAAK;GACvB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,gBAAgB,MAAM,IAAI;GACxB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,YAAY,MAAM,IAAI;GAAE,YAAY;GAAM,aAAa;GAAgB,CAAC;EAGxE,eAAe,MAAM,KAAK;GACxB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,cAAc,MAAM,KAAK;GACvB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,UAAU,MAAM,KAAK,EAAE,YAAY,MAAM,CAAC;EAG1C,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAG5B,oBAAoB,MAAM,UACxB,sBACA,CAAC,uBAAuB,EACxB,CAAC,KAAK,EACN,EAAE,UAAU,WAAW,CACxB;EACD,YAAY,MAAM,QAAQ,gBAAgB;EAC3C;CACD,SAAS;EACP,MAAM,OAAO,CAAC,wBAAwB,MAAM,CAAC;EAC7C,MAAM,GAAG,CAAC,wBAAwB,WAAW,CAAC;EAC9C,MAAM,GAAG,CAAC,OAAO,CAAC;EACnB;CACD,OAAO,CAAC,cAAc,iBAAiB;CACxC,CAAC"}

package/dist/entities/workflow.d.ts

@@ -0,0 +1,41 @@
+import * as _contractspec_lib_schema463 from "@contractspec/lib.schema";
+
+//#region src/entities/workflow.d.ts
+/**
+ * Workflow status enum - the lifecycle state of a workflow definition.
+ */
+declare const WorkflowStatusEnum: _contractspec_lib_schema463.EntityEnumDef;
+/**
+ * Workflow trigger type enum - what initiates a workflow.
+ */
+declare const WorkflowTriggerTypeEnum: _contractspec_lib_schema463.EntityEnumDef;
+/**
+ * WorkflowDefinition entity - defines a workflow blueprint.
+ *
+ * A workflow definition specifies the structure, steps, and rules
+ * for a business process. Instances are created from definitions.
+ */
+declare const WorkflowDefinitionEntity: _contractspec_lib_schema463.EntitySpec<{
+  id: _contractspec_lib_schema463.EntityScalarField;
+  name: _contractspec_lib_schema463.EntityScalarField;
+  key: _contractspec_lib_schema463.EntityScalarField;
+  description: _contractspec_lib_schema463.EntityScalarField;
+  version: _contractspec_lib_schema463.EntityScalarField;
+  status: _contractspec_lib_schema463.EntityEnumField;
+  triggerType: _contractspec_lib_schema463.EntityEnumField;
+  triggerConfig: _contractspec_lib_schema463.EntityScalarField;
+  initialStepId: _contractspec_lib_schema463.EntityScalarField;
+  featureFlagKey: _contractspec_lib_schema463.EntityScalarField;
+  settings: _contractspec_lib_schema463.EntityScalarField;
+  metadata: _contractspec_lib_schema463.EntityScalarField;
+  organizationId: _contractspec_lib_schema463.EntityScalarField;
+  createdBy: _contractspec_lib_schema463.EntityScalarField;
+  createdAt: _contractspec_lib_schema463.EntityScalarField;
+  updatedAt: _contractspec_lib_schema463.EntityScalarField;
+  publishedAt: _contractspec_lib_schema463.EntityScalarField;
+  steps: _contractspec_lib_schema463.EntityRelationField;
+  instances: _contractspec_lib_schema463.EntityRelationField;
+}>;
+//#endregion
+export { WorkflowDefinitionEntity, WorkflowStatusEnum, WorkflowTriggerTypeEnum };
+//# sourceMappingURL=workflow.d.ts.map

package/dist/entities/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","names":[],"sources":["../../src/entities/workflow.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,kBAKX,EAAA,2BAAA,CAL6B,aAK7B;AAKF;AAaA;;cAba,yBAKX,2BAAA,CALkC;;;;;;;cAavB,sDAAwB;MA2EnC,2BAAA,CAAA;;;;;;;;;;yDA3EmC;EAAA,QAAA,+CAAA"}

package/dist/entities/workflow.js

@@ -0,0 +1,102 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/workflow.ts
+/**
+* Workflow status enum - the lifecycle state of a workflow definition.
+*/
+const WorkflowStatusEnum = defineEntityEnum({
+	name: "WorkflowStatus",
+	values: [
+		"DRAFT",
+		"ACTIVE",
+		"DEPRECATED",
+		"ARCHIVED"
+	],
+	schema: "workflow",
+	description: "Status of a workflow definition."
+});
+/**
+* Workflow trigger type enum - what initiates a workflow.
+*/
+const WorkflowTriggerTypeEnum = defineEntityEnum({
+	name: "WorkflowTriggerType",
+	values: [
+		"MANUAL",
+		"EVENT",
+		"SCHEDULED",
+		"API"
+	],
+	schema: "workflow",
+	description: "What triggers workflow instantiation."
+});
+/**
+* WorkflowDefinition entity - defines a workflow blueprint.
+*
+* A workflow definition specifies the structure, steps, and rules
+* for a business process. Instances are created from definitions.
+*/
+const WorkflowDefinitionEntity = defineEntity({
+	name: "WorkflowDefinition",
+	description: "A workflow blueprint that defines the process structure.",
+	schema: "workflow",
+	map: "workflow_definition",
+	fields: {
+		id: field.id({ description: "Unique workflow definition ID" }),
+		name: field.string({ description: "Human-readable workflow name" }),
+		key: field.string({ description: "Unique key for referencing (e.g., \"purchase_approval\")" }),
+		description: field.string({
+			isOptional: true,
+			description: "Detailed description"
+		}),
+		version: field.int({
+			default: 1,
+			description: "Version number for versioning definitions"
+		}),
+		status: field.enum("WorkflowStatus", { default: "DRAFT" }),
+		triggerType: field.enum("WorkflowTriggerType", { default: "MANUAL" }),
+		triggerConfig: field.json({
+			isOptional: true,
+			description: "Trigger-specific configuration"
+		}),
+		initialStepId: field.string({
+			isOptional: true,
+			description: "First step when workflow starts"
+		}),
+		featureFlagKey: field.string({
+			isOptional: true,
+			description: "Feature flag to control availability"
+		}),
+		settings: field.json({
+			isOptional: true,
+			description: "Workflow-wide settings"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Custom metadata"
+		}),
+		organizationId: field.foreignKey({ description: "Owning organization" }),
+		createdBy: field.foreignKey({ description: "User who created this workflow" }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		publishedAt: field.dateTime({
+			isOptional: true,
+			description: "When workflow was activated"
+		}),
+		steps: field.hasMany("WorkflowStep"),
+		instances: field.hasMany("WorkflowInstance")
+	},
+	indexes: [
+		index.unique([
+			"organizationId",
+			"key",
+			"version"
+		]),
+		index.on(["organizationId", "status"]),
+		index.on(["key", "version"])
+	],
+	enums: [WorkflowStatusEnum, WorkflowTriggerTypeEnum]
+});
+
+//#endregion
+export { WorkflowDefinitionEntity, WorkflowStatusEnum, WorkflowTriggerTypeEnum };
+//# sourceMappingURL=workflow.js.map

package/dist/entities/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","names":[],"sources":["../../src/entities/workflow.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Workflow status enum - the lifecycle state of a workflow definition.\n */\nexport const WorkflowStatusEnum = defineEntityEnum({\n  name: 'WorkflowStatus',\n  values: ['DRAFT', 'ACTIVE', 'DEPRECATED', 'ARCHIVED'] as const,\n  schema: 'workflow',\n  description: 'Status of a workflow definition.',\n});\n\n/**\n * Workflow trigger type enum - what initiates a workflow.\n */\nexport const WorkflowTriggerTypeEnum = defineEntityEnum({\n  name: 'WorkflowTriggerType',\n  values: ['MANUAL', 'EVENT', 'SCHEDULED', 'API'] as const,\n  schema: 'workflow',\n  description: 'What triggers workflow instantiation.',\n});\n\n/**\n * WorkflowDefinition entity - defines a workflow blueprint.\n *\n * A workflow definition specifies the structure, steps, and rules\n * for a business process. Instances are created from definitions.\n */\nexport const WorkflowDefinitionEntity = defineEntity({\n  name: 'WorkflowDefinition',\n  description: 'A workflow blueprint that defines the process structure.',\n  schema: 'workflow',\n  map: 'workflow_definition',\n  fields: {\n    id: field.id({ description: 'Unique workflow definition ID' }),\n\n    // Identity\n    name: field.string({ description: 'Human-readable workflow name' }),\n    key: field.string({\n      description: 'Unique key for referencing (e.g., \"purchase_approval\")',\n    }),\n    description: field.string({\n      isOptional: true,\n      description: 'Detailed description',\n    }),\n    version: field.int({\n      default: 1,\n      description: 'Version number for versioning definitions',\n    }),\n\n    // Status\n    status: field.enum('WorkflowStatus', { default: 'DRAFT' }),\n\n    // Trigger\n    triggerType: field.enum('WorkflowTriggerType', { default: 'MANUAL' }),\n    triggerConfig: field.json({\n      isOptional: true,\n      description: 'Trigger-specific configuration',\n    }),\n\n    // Initial step\n    initialStepId: field.string({\n      isOptional: true,\n      description: 'First step when workflow starts',\n    }),\n\n    // Feature flag integration\n    featureFlagKey: field.string({\n      isOptional: true,\n      description: 'Feature flag to control availability',\n    }),\n\n    // Configuration\n    settings: field.json({\n      isOptional: true,\n      description: 'Workflow-wide settings',\n    }),\n    metadata: field.json({ isOptional: true, description: 'Custom metadata' }),\n\n    // Ownership\n    organizationId: field.foreignKey({ description: 'Owning organization' }),\n    createdBy: field.foreignKey({\n      description: 'User who created this workflow',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n    publishedAt: field.dateTime({\n      isOptional: true,\n      description: 'When workflow was activated',\n    }),\n\n    // Relations\n    steps: field.hasMany('WorkflowStep'),\n    instances: field.hasMany('WorkflowInstance'),\n  },\n  indexes: [\n    index.unique(['organizationId', 'key', 'version']),\n    index.on(['organizationId', 'status']),\n    index.on(['key', 'version']),\n  ],\n  enums: [WorkflowStatusEnum, WorkflowTriggerTypeEnum],\n});\n"],"mappings":";;;;;;AAUA,MAAa,qBAAqB,iBAAiB;CACjD,MAAM;CACN,QAAQ;EAAC;EAAS;EAAU;EAAc;EAAW;CACrD,QAAQ;CACR,aAAa;CACd,CAAC;;;;AAKF,MAAa,0BAA0B,iBAAiB;CACtD,MAAM;CACN,QAAQ;EAAC;EAAU;EAAS;EAAa;EAAM;CAC/C,QAAQ;CACR,aAAa;CACd,CAAC;;;;;;;AAQF,MAAa,2BAA2B,aAAa;CACnD,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,GAAG,EAAE,aAAa,iCAAiC,CAAC;EAG9D,MAAM,MAAM,OAAO,EAAE,aAAa,gCAAgC,CAAC;EACnE,KAAK,MAAM,OAAO,EAChB,aAAa,4DACd,CAAC;EACF,aAAa,MAAM,OAAO;GACxB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,SAAS,MAAM,IAAI;GACjB,SAAS;GACT,aAAa;GACd,CAAC;EAGF,QAAQ,MAAM,KAAK,kBAAkB,EAAE,SAAS,SAAS,CAAC;EAG1D,aAAa,MAAM,KAAK,uBAAuB,EAAE,SAAS,UAAU,CAAC;EACrE,eAAe,MAAM,KAAK;GACxB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,eAAe,MAAM,OAAO;GAC1B,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,gBAAgB,MAAM,OAAO;GAC3B,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,UAAU,MAAM,KAAK;GACnB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,UAAU,MAAM,KAAK;GAAE,YAAY;GAAM,aAAa;GAAmB,CAAC;EAG1E,gBAAgB,MAAM,WAAW,EAAE,aAAa,uBAAuB,CAAC;EACxE,WAAW,MAAM,WAAW,EAC1B,aAAa,kCACd,CAAC;EAGF,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAC5B,aAAa,MAAM,SAAS;GAC1B,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,OAAO,MAAM,QAAQ,eAAe;EACpC,WAAW,MAAM,QAAQ,mBAAmB;EAC7C;CACD,SAAS;EACP,MAAM,OAAO;GAAC;GAAkB;GAAO;GAAU,CAAC;EAClD,MAAM,GAAG,CAAC,kBAAkB,SAAS,CAAC;EACtC,MAAM,GAAG,CAAC,OAAO,UAAU,CAAC;EAC7B;CACD,OAAO,CAAC,oBAAoB,wBAAwB;CACrD,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,40 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "workflow-system";
+  readonly title: "Workflow / Approval System";
+  readonly summary: "State-machine driven approvals with RBAC, audit trail, notifications, and jobs.";
+  readonly tags: readonly ["workflow", "approval", "state-machine", "rbac"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.workflow-system";
+    readonly goalDocId: "docs.examples.workflow-system.goal";
+    readonly usageDocId: "docs.examples.workflow-system.usage";
+    readonly constraintsDocId: "docs.examples.workflow-system.constraints";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.workflow-system";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly presentations: "./presentations";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "specs", "builder", "markdown", "evolution"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EA+BI,EAAA,iBAAA"}

package/dist/example.js

@@ -0,0 +1,51 @@
+//#region src/example.ts
+const example = {
+	id: "workflow-system",
+	title: "Workflow / Approval System",
+	summary: "State-machine driven approvals with RBAC, audit trail, notifications, and jobs.",
+	tags: [
+		"workflow",
+		"approval",
+		"state-machine",
+		"rbac"
+	],
+	kind: "template",
+	visibility: "public",
+	docs: {
+		rootDocId: "docs.examples.workflow-system",
+		goalDocId: "docs.examples.workflow-system.goal",
+		usageDocId: "docs.examples.workflow-system.usage",
+		constraintsDocId: "docs.examples.workflow-system.constraints"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.workflow-system",
+		feature: "./feature",
+		contracts: "./contracts",
+		presentations: "./presentations",
+		handlers: "./handlers",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: [
+				"playground",
+				"specs",
+				"builder",
+				"markdown",
+				"evolution"
+			]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'workflow-system',\n  title: 'Workflow / Approval System',\n  summary:\n    'State-machine driven approvals with RBAC, audit trail, notifications, and jobs.',\n  tags: ['workflow', 'approval', 'state-machine', 'rbac'],\n  kind: 'template',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.workflow-system',\n    goalDocId: 'docs.examples.workflow-system.goal',\n    usageDocId: 'docs.examples.workflow-system.usage',\n    constraintsDocId: 'docs.examples.workflow-system.constraints',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.workflow-system',\n    feature: './feature',\n    contracts: './contracts',\n    presentations: './presentations',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAY;EAAiB;EAAO;CACvD,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACZ,kBAAkB;EACnB;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}