feat: Add new tools and configurations for Castle platform

- Introduced `uv.lock` for dependency management with various packages including `pytest`, `colorama`, and `pluggy`.
- Added `pyrightconfig.json` for Python type checking configuration.
- Expanded `recommendations.md` with detailed scaling recommendations and project management strategies.
- Created shared `ruff.toml` for consistent linting across projects.
- Developed `Castle Tools` with various utilities including Android backup, browser automation, document conversion, and search tools.
- Implemented `backup-collect` and `schedule` tools for system administration tasks.
- Enhanced `search` functionality with indexing and querying capabilities using Tantivy.
- Added comprehensive documentation for each tool, including usage examples and installation instructions.

castle.yaml

@@ -0,0 +1,295 @@
+gateway:
+  port: 9000
+components:
+  # ── Services ──────────────────────────────────────────────
+  central-context:
+    description: Content storage API
+    run:
+      runner: python_uv_tool
+      cwd: central-context
+      env:
+        CENTRAL_CONTEXT_DATA_DIR: /data/castle/central-context
+        CENTRAL_CONTEXT_PORT: "9001"
+      tool: central-context
+    manage:
+      systemd: {}
+    expose:
+      http:
+        internal:
+          port: 9001
+        health_path: /health
+    proxy:
+      caddy:
+        path_prefix: /central-context
+
+  notification-bridge:
+    description: Desktop notification forwarder
+    run:
+      runner: python_uv_tool
+      cwd: notification-bridge
+      env:
+        CENTRAL_CONTEXT_URL: http://localhost:9001
+        BUCKET_NAME: notifications
+        PORT: "9002"
+      tool: notification-bridge
+    manage:
+      systemd: {}
+    expose:
+      http:
+        internal:
+          port: 9002
+        health_path: /health
+    proxy:
+      caddy:
+        path_prefix: /notifications
+
+  dashboard-api:
+    description: Castle dashboard API
+    run:
+      runner: python_uv_tool
+      cwd: dashboard-api
+      env:
+        DASHBOARD_API_CASTLE_ROOT: /data/repos/castle
+      tool: dashboard-api
+    manage:
+      systemd: {}
+    expose:
+      http:
+        internal:
+          port: 9020
+        health_path: /health
+    proxy:
+      caddy:
+        path_prefix: /api
+
+  # ── Jobs ──────────────────────────────────────────────────
+  protonmail:
+    description: ProtonMail email sync via Bridge
+    run:
+      runner: command
+      argv: ["protonmail", "sync"]
+      cwd: protonmail
+      env:
+        PROTONMAIL_USERNAME: paul@payne.io
+        PROTONMAIL_API_KEY: ${secret:PROTONMAIL_API_KEY}
+    tool:
+      tool_type: python_standalone
+      category: email
+      source: protonmail/
+    triggers:
+      - type: schedule
+        cron: "*/5 * * * *"
+    manage:
+      systemd: {}
+    install:
+      path:
+        alias: protonmail
+
+  backup-collect:
+    description: Collect files from various sources into backup directory
+    run:
+      runner: command
+      argv: ["backup-collect"]
+      env:
+        DBACKUP: /data/backup
+    tool:
+      tool_type: python_standalone
+      category: system
+      source: tools/system/
+      system_dependencies: [rsync]
+    triggers:
+      - type: schedule
+        cron: "0 2 * * *"
+    manage:
+      systemd: {}
+
+  backup-data:
+    description: Nightly restic backup of /data to /storage
+    run:
+      runner: command
+      argv: ["backup-data"]
+      env:
+        RESTIC_REPOSITORY: /storage/restic-data
+        RESTIC_PASSWORD_FILE: /home/payne/.config/restic-password
+    tool:
+      tool_type: script
+      category: system
+    triggers:
+      - type: schedule
+        cron: "30 3 * * *"
+    manage:
+      systemd: {}
+
+  # ── Frontend ──────────────────────────────────────────────
+  dashboard:
+    description: Castle web dashboard
+    run:
+      runner: node
+      cwd: dashboard
+      script: dev
+    expose:
+      http:
+        internal:
+          port: 5173
+    build:
+      commands:
+        - ["pnpm", "build"]
+      outputs:
+        - dist/
+
+  # ── Standalone tools ──────────────────────────────────────
+  devbox-connect:
+    description: SSH tunnel manager with auto-reconnect
+    tool:
+      tool_type: python_standalone
+      category: system
+      source: devbox-connect/
+    install:
+      path:
+        alias: devbox-connect
+
+  mboxer:
+    description: MBOX to EML email converter
+    tool:
+      tool_type: python_standalone
+      category: email
+      source: mboxer/
+    install:
+      path:
+        alias: mboxer
+
+  # ── Category tools (per-category packages) ────────────────
+  android-backup:
+    description: Backup Android device using ADB
+    tool:
+      tool_type: python_standalone
+      category: android
+      source: tools/android/
+      system_dependencies: [adb]
+    install:
+      path:
+        alias: android-backup
+
+  browser:
+    description: Browse the web using natural language via browser-use
+    tool:
+      tool_type: python_standalone
+      category: browser
+      source: tools/browser/
+    install:
+      path:
+        alias: browser
+
+  docx-extractor:
+    description: Extract content and metadata from Word .docx files
+    tool:
+      tool_type: python_standalone
+      category: search
+      source: tools/search/
+      system_dependencies: [pandoc]
+    install:
+      path:
+        alias: docx-extractor
+
+  docx2md:
+    description: Convert Word .docx files to Markdown
+    tool:
+      tool_type: python_standalone
+      category: document
+      source: tools/document/
+      system_dependencies: [pandoc]
+    install:
+      path:
+        alias: docx2md
+
+  gpt:
+    description: OpenAI text generation utility
+    tool:
+      tool_type: python_standalone
+      category: gpt
+      source: tools/gpt/
+    install:
+      path:
+        alias: gpt
+
+  html2text:
+    description: Convert HTML content to plain text
+    tool:
+      tool_type: python_standalone
+      category: document
+      source: tools/document/
+    install:
+      path:
+        alias: html2text
+
+  md2pdf:
+    description: Convert Markdown files to PDF
+    tool:
+      tool_type: python_standalone
+      category: document
+      source: tools/document/
+      system_dependencies: [pandoc, texlive-latex-base]
+    install:
+      path:
+        alias: md2pdf
+
+  mdscraper:
+    description: Combine text files into a single markdown document
+    tool:
+      tool_type: python_standalone
+      category: mdscraper
+      source: tools/mdscraper/
+    install:
+      path:
+        alias: mdscraper
+
+  pdf-extractor:
+    description: Extract content and metadata from PDF files
+    tool:
+      tool_type: python_standalone
+      category: search
+      source: tools/search/
+    install:
+      path:
+        alias: pdf-extractor
+
+  pdf2md:
+    description: Convert PDF files to Markdown
+    tool:
+      tool_type: python_standalone
+      category: document
+      source: tools/document/
+      system_dependencies: [pandoc, poppler-utils]
+    install:
+      path:
+        alias: pdf2md
+
+  schedule:
+    description: Manage systemd user timers and scheduled tasks
+    tool:
+      tool_type: python_standalone
+      category: system
+      source: tools/system/
+    install:
+      path:
+        alias: schedule
+
+  search:
+    description: Manage self-contained searchable collections of files
+    tool:
+      tool_type: python_standalone
+      category: search
+      source: tools/search/
+    install:
+      path:
+        alias: search
+
+  text-extractor:
+    description: Extract content and metadata from text files
+    tool:
+      tool_type: python_standalone
+      category: search
+      source: tools/search/
+    install:
+      path:
+        alias: text-extractor