From 99653915bb2916cd69abfb5123eb5d4288096f43 Mon Sep 17 00:00:00 2001
From: mahmoud karzoun <135722882+mkarson1997@users.noreply.github.com>
Date: Fri, 4 Sep 2026 17:37:44 +0300
Subject: [PATCH] docs: add machine-readable citation metadata

---
 CITATION.cff | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 CITATION.cff

diff --git a/CITATION.cff b/CITATION.cff
new file mode 100644
index 0000000..e8d8ade
--- /dev/null
+++ b/CITATION.cff
@@ -0,0 +1,27 @@
+cff-version: 1.2.0
+message: "If you use Karzoun FlowForge in engineering work, research, or a publication, please cite the project using this metadata."
+title: "Karzoun FlowForge"
+type: software
+authors:
+  - family-names: Karzoun
+    given-names: Mahmoud
+repository-code: "https://github.com/mkarson1997/karzoun-flowforge"
+url: "https://github.com/mkarson1997/karzoun-flowforge"
+version: 0.1.0
+date-released: 2026-09-04
+license: Apache-2.0
+keywords:
+  - workflow-engine
+  - distributed-systems
+  - typescript
+  - postgresql
+  - opentelemetry
+preferred-citation:
+  type: software
+  authors:
+    - family-names: Karzoun
+      given-names: Mahmoud
+  title: "Karzoun FlowForge"
+  version: 0.1.0
+  year: 2026
+  url: "https://github.com/mkarson1997/karzoun-flowforge"