From 1901e56ddce7391715541222a2dd7b98c9bcd376 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=CE=A7=CE=B3=CF=86=CF=84=20Kompanion?=
 <chigammaphitau@chelydra.at>
Date: Mon, 13 Oct 2025 00:05:01 +1300
Subject: [PATCH] feat: docker compose, shared infra docs, js-engine note

---
 .gitignore        | 5 +++++
 docs/JS-ENGINE.md | 6 ++++++
 2 files changed, 11 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 docs/JS-ENGINE.md

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..6942323
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+/build*/
+/.venv/
+*.o
+*.pyc
+.DS_Store
diff --git a/docs/JS-ENGINE.md b/docs/JS-ENGINE.md
new file mode 100644
index 0000000..c6ba05b
--- /dev/null
+++ b/docs/JS-ENGINE.md
@@ -0,0 +1,6 @@
+# JS Engine Integration (QuickJS)
+
+- Embed QuickJS for safe, deterministic, sandboxed transforms.
+- No network, no filesystem by default; expose only Kompanion tool FFI shims.
+- Use for text filters, parsers, light data munging; scripts under `~/.config/kompanion/js/`.
+- FFI bridge: `js.callTool(name, args)` → JSON-RPC.