added documentaion and a hook build script to make onbaording easier

src/apps/cli/README.md

@@ -92,28 +92,39 @@ livesync-cli ./my-db pull folder/note.md ./note.md
 
 ## Installation
 
-### Build from source
+### Build from source
+
+```bash
+# Clone with submodules, because the shared core lives in src/lib
+git clone --recurse-submodules <repository-url>
+cd obsidian-livesync
+
+# If you already cloned without submodules, run this once instead
+git submodule update --init --recursive
+
+# Install dependencies from the repository root
+npm install
+
+# Build the CLI from its package directory
+cd src/apps/cli
+npm run build
+```
+
+If `src/lib` is missing, `npm run build` now stops early with a targeted message
+instead of a low-level Vite `ENOENT` error.
 
-```bash
-# Install dependencies (ensure you are in repository root directory, not src/apps/cli)
-# due to shared dependencies with webapp and main library
-npm install
-# Build the project (ensure you are in `src/apps/cli` directory)
-npm run build
-```
-
-Run the CLI:
-
-```bash
-# Run with npm script (from repository root)
-npm run --silent cli -- [database-path] [command] [args...]
+Run the CLI:
+
+```bash
+# Run with npm script (from repository root)
+npm run --silent cli -- [database-path] [command] [args...]
 # Run the built executable directly
 node src/apps/cli/dist/index.cjs [database-path] [command] [args...]
 ```
 
-### Docker
-
-A Docker image is provided for headless / server deployments. Build from the repository root:
+### Docker
+
+A Docker image is provided for headless / server deployments. Build from the repository root:
 
 ```bash
 docker build -f src/apps/cli/Dockerfile -t livesync-cli .