From d980223f35a99afb3196aa3ec7e4eed1287064d1 Mon Sep 17 00:00:00 2001
From: Ahmed Janabi <ahmed541991@gmail.com>
Date: Sun, 30 Aug 2026 17:18:06 +0400
Subject: [PATCH] chore: add Orca worktree setup script

Adds orca.yaml: python -m venv .venv + pip install -e '.[dev,all]'
(pyproject.toml is the source of truth, not requirements.txt), plus
seeding .vps.env from the main checkout. Does not run docker compose
up (binds 8080/8770/8088) or pull Ollama models.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KGrTtVfqhwAk7xYqgZamdB
---
 orca.yaml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 orca.yaml

diff --git a/orca.yaml b/orca.yaml
new file mode 100644
index 0000000..55db262
--- /dev/null
+++ b/orca.yaml
@@ -0,0 +1,26 @@
+scripts:
+  setup: |
+    #!/usr/bin/env bash
+    set -euo pipefail
+    MAIN="${ORCA_ROOT_PATH:-$(dirname "$(git rev-parse --git-common-dir)")}"
+    seed() {  # seed <relative-path> [template-to-fall-back-to]
+      local rel="$1" tpl="${2:-}"
+      if [ -f "$MAIN/$rel" ]; then
+        mkdir -p "$(dirname "$rel")"; cp -p "$MAIN/$rel" "$rel"; echo "  seeded $rel"
+      elif [ -n "$tpl" ] && [ -f "$tpl" ]; then
+        cp "$tpl" "$rel"; echo "  WARNING: no real $rel in main checkout -- copied $tpl"
+      else
+        echo "  SKIP: no $rel in main checkout and no template"
+      fi
+    }
+
+    echo "== python venv + editable install =="
+    python3 -m venv .venv
+    .venv/bin/python -m pip install --upgrade pip
+    .venv/bin/pip install -e '.[dev,all]'
+
+    echo "== Seed env file from the main checkout =="
+    seed .vps.env
+
+    echo "Worktree setup complete."
+    echo "Not run automatically: docker compose up (binds 8080/8770/8088), ollama pull, pw serve"