feat: extract headless workflow engine

README.md

@@ -0,0 +1,28 @@
+# GovOPlaN Workflow Engine
+
+<!-- govoplan-repository-type:start -->
+**Repository type:** module (platform).
+<!-- govoplan-repository-type:end -->
+
+Headless workflow definition and execution services for GovOPlaN modules.
+
+Workflow Engine owns the canonical BPMN/native graph model, immutable
+definition revisions, runtime instances and evidence, migrations, validation,
+execution adapters, dispatch, retries, and recovery. It intentionally provides
+no primary navigation or visual editor. Modules can depend on runtime module ID
+`workflow_engine` and the versioned `workflow.*` interfaces without installing
+the optional `govoplan-workflow` editor.
+
+The extraction preserves the existing `workflow_*` tables, Alembic revision
+IDs, `/api/v1/workflow` routes, `workflow:*` permissions, instance IDs, and
+audit references. See [the engine/editor split](docs/ENGINE_EDITOR_SPLIT.md)
+for the ownership and compatibility policy.
+See [the module concept](docs/CONCEPT.md) and
+[BPMN interoperability contract](docs/BPMN_INTEROPERABILITY.md) for runtime
+semantics and adapter boundaries.
+
+## Checks
+
+```bash
+/mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests
+```