fix: resolve 4 major architectural deadlock and OS dependency bugs

bootstrap.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+
+# Prevent git from hanging on auth prompts for submodules
+export GIT_TERMINAL_PROMPT=0
+
+echo "[1/4] Checking and Initializing Agent Config (.env.agent)..."
+if [ ! -f ".agent/config/.env.agent" ]; then
+    if [ -f ".agent/config/.env.agent.template" ]; then
+        cp ".agent/config/.env.agent.template" ".agent/config/.env.agent"
+        echo "   -> Created .agent/config/.env.agent from template."
+    else
+        echo "   -> Warning: Template missing."
+    fi
+else
+    echo "   -> .env.agent already exists."
+fi
+
+echo "[2/4] Updating Git Submodules..."
+git submodule update --init --recursive
+
+echo "[3/4] Bypassing Restrictions and Installing AI Local Dependencies..."
+cd .agent/env || exit
+npm install
+cd ../..
+
+echo "[4/4] Installing Universal AI Workflow Tool (get-shit-done-cc) Globally..."
+npm install -g get-shit-done-cc@latest
+
+echo ""
+echo "========================================================"
+echo "[OK] Zero-Click Bootstrap Complete. AI Agents are ready!"
+echo "--------------------------------------------------------"
+echo "[!] ACTION REQUIRED: "
+echo "Please open '.agent/config/.env.agent' to set up "
+echo "your Vikunja Project ID and Gitea Wiki URL tracking."
+echo "========================================================"