chore(dev): add stable worker and cache commands (#494)

Author: MaxEriksson2000

Taskfile.yml

@@ -10,7 +10,7 @@ tasks:
 
   worker:
     cmds:
-      - uv run arq src.intric.worker.arq.WorkerSettings
+      - uv run worker
     dir: ./backend
 
   frontend:

backend/pyproject.toml

@@ -63,6 +63,7 @@ dependencies = [
 
 [project.scripts]
 start = "intric.server.main:start"
+worker = "intric.worker.cli:start"
 
 [dependency-groups]
 dev = [

backend/src/intric/worker/cli.py

@@ -0,0 +1,9 @@
+import sys
+
+from arq.cli import cli
+
+WORKER_SETTINGS = "src.intric.worker.arq.WorkerSettings"
+
+
+def start() -> None:
+    cli(args=[WORKER_SETTINGS, *sys.argv[1:]], prog_name="worker")

docs/CONTRIBUTING.md

@@ -41,7 +41,7 @@ cd backend && uv run python init_db.py
 # Start development servers (3 terminals)
 cd backend && uv run start              # Terminal 1
 cd frontend && bun run dev                 # Terminal 2
-cd backend && uv run arq src.intric.worker.arq.WorkerSettings  # Terminal 3
+cd backend && uv run worker             # Terminal 3
 ```
 
 ### 2. Make Your First Contribution

docs/INSTALLATION.md

@@ -80,7 +80,7 @@ bun run dev
 **Terminal 3 - Worker (Optional, for document processing and for the crawler & apps to work):**
 ```bash
 cd backend
-uv run arq src.intric.worker.arq.WorkerSettings
+uv run worker
 ```
 
 ## Verify Installation

frontend/package.json

@@ -4,6 +4,8 @@
   "scripts": {
     "build": "NODE_ENV=production FORCE_COLOR=1 bun run --filter @intric/ui build && NODE_ENV=production FORCE_COLOR=1 bun run --filter @intric/web build",
     "dev": "NODE_ENV=development FORCE_COLOR=1 bun run --elide-lines=0 --filter @intric/web --filter @intric/ui dev",
+    "dev:clean": "bun run clean:cache && bun run dev",
+    "clean:cache": "rm -rf apps/web/node_modules/.vite apps/web/.svelte-kit packages/ui/.svelte-kit",
     "lint": "FORCE_COLOR=1 bun run --filter '*' lint",
     "check": "NODE_ENV=production FORCE_COLOR=1 bun run --filter '*' check",
     "format": "FORCE_COLOR=1 bun run --filter '*' format",