chore(deps): bump @eslint/js from 9.39.1 to 10.0.1 in /frontend

.claude/instructions.md

@@ -0,0 +1,95 @@
+- **NEVER commit or push without asking first**
+- Always run test suite before pushing to github
+- Always add a new test or update existing when a new feature is added or a bug is fixed
+- Ask every time you push if a release is required, if i answer yes, you decide if minor, major or patch and do it
+
+## Release Process
+- Creating a git tag automatically triggers a GitHub release
+- Use `git tag vX.Y.Z` to create the tag
+- Tag format: semantic versioning (vMAJOR.MINOR.PATCH)
+  - MAJOR: Breaking changes or major new features
+  - MINOR: New features, backward compatible
+  - PATCH: Bug fixes and small improvements
+- Push tags with `git push --tags`
+
+## Repository Wizard (New Implementation)
+
+### Overview
+Implemented a new step-based wizard for repository creation/import/editing with card-based visual UI.
+
+### Key Components Created
+1. **CompressionSettings.tsx** - Reusable compression configuration component
+   - Handles all compression algorithms (lz4, zstd, zlib, lzma, auto, obfuscate, none)
+   - Compression levels, auto-detect, obfuscate spec
+   - Shows final compression string preview
+
+2. **CommandPreview.tsx** - Shows Borg commands that will run
+   - Init command for create mode
+   - Create command preview
+   - Uses existing `generateBorgCreateCommand` utility
+
+3. **SourceDirectoriesInput.tsx** - Manages source directories
+   - Add/remove directories with validation
+   - FileExplorerDialog integration
+   - Warning when no directories configured
+
+4. **ExcludePatternInput.tsx** - Manages exclude patterns
+   - Add/remove patterns
+   - FileExplorerDialog integration
+
+### Wizard Structure (RepositoryWizard.tsx)
+
+**Step 1: Repository Location**
+- Name and mode (Full/Observe Only)
+- Visual cards: Borg UI Server (local) vs SSH Remote Storage
+- SSH connections dropdown (no manual host/port entry)
+- Path input with file browser
+
+**Step 2: Data Source** (only for full mode, not import/observe)
+- Visual cards: Borg UI Server (local) vs Remote Machine
+- For local: Shows SourceDirectoriesInput
+- For remote: SSH connections dropdown + note about remote execution
+
+**Step 3: Security**
+- Encryption (create mode)
+- Passphrase (required for encrypted)
+- Keyfile upload (import mode)
+- Remote path (optional borg executable path)
+
+**Step 4: Backup Configuration** (only for local data source)
+- CompressionSettings component
+- ExcludePatternInput component
+- Custom Borg flags
+
+**Step 5: Review**
+- CommandPreview component (local source only)
+- Summary card with all settings
+- Success/info alerts
+
+### Important Decisions
+- **NON-NEGOTIABLE**: Must reuse existing components (FileExplorerDialog, compression logic, command generation)
+- **SSH connections dropdown**: Use for both repository location AND data source
+- **Card-based UI**: Visual clarity preferred over text-heavy forms
+- **Step adaptation**: Steps dynamically adjust based on mode (full/observe/import)
+- **Validation**: Array.isArray() checks on sshConnections before .map() calls
+- **Client-to-client limitation**: If repository is on a remote client, data source can ONLY be:
+  - Local (Borg UI Server), OR
+  - The SAME remote client (same-machine backup)
+  - Backing up from one remote client to another is NOT supported (too much overhead)
+
+### Integration
+- Buttons in Repositories.tsx: "Create Repository (New)", "Import Existing (New)", "Create (Old)"
+- Old form still exists for comparison/fallback
+- Uses existing FileExplorerDialog, sshKeysAPI.getSSHConnections()
+
+### Data Flow
+- Repository location: Where backups are stored (local/SSH)
+- Data source: Where data comes from (local/remote machine)
+- Remote source submits `source_connection_id` to backend
+- Local source submits `source_directories` array
+
+### Current Status
+- Frontend complete and deployed
+- Backend needs implementation for remote source orchestration (future work)
+- Wizard handles create/import/edit modes
+- All original features from old form are included

.coveragerc

@@ -0,0 +1,98 @@
+# Coverage.py configuration for Borg UI
+# https://coverage.readthedocs.io/
+
+[run]
+# Source code to measure coverage for
+source = app
+
+# Write relative paths in coverage data (required for GitHub Actions)
+relative_files = true
+
+# Omit these files from coverage
+omit =
+    */tests/*
+    */test_*.py
+    */__pycache__/*
+    */node_modules/*
+    */venv/*
+    */env/*
+    */.venv/*
+    */migrations/*
+    */alembic/*
+    setup.py
+    */site-packages/*
+
+# Enable branch coverage (if statements, loops, etc.)
+branch = True
+
+# Measure coverage for code called by subprocess
+parallel = False
+
+# Store coverage data in this file
+data_file = .coverage
+
+[report]
+# Show lines that weren't covered
+show_missing = True
+
+# Precision for coverage percentages
+precision = 2
+
+# Skip files with 100% coverage in the report
+skip_covered = False
+
+# Skip empty files
+skip_empty = True
+
+# Fail if coverage is below this percentage
+fail_under = 0
+
+# Sort the report by these criteria
+sort = Cover
+
+# Exclude these lines from coverage
+exclude_lines =
+    # Have to re-enable the standard pragma
+    pragma: no cover
+
+    # Don't complain about missing debug-only code
+    def __repr__
+    def __str__
+
+    # Don't complain if tests don't hit defensive assertion code
+    raise AssertionError
+    raise NotImplementedError
+
+    # Don't complain if non-runnable code isn't run
+    if __name__ == .__main__.:
+    if TYPE_CHECKING:
+    if typing.TYPE_CHECKING:
+
+    # Don't complain about abstract methods
+    @abc.abstractmethod
+    @abstractmethod
+
+    # Don't complain about ellipsis in protocols/stubs
+    \.\.\.
+
+    # Don't complain about pass statements
+    pass
+
+[html]
+# Directory for HTML report
+directory = htmlcov
+
+# Title for HTML report
+title = Borg UI Coverage Report
+
+[xml]
+# Output file for XML report (for CI/CD tools)
+output = coverage.xml
+
+[json]
+# Output file for JSON report
+output = coverage.json
+
+# Pretty print JSON
+pretty_print = True
+show_contexts = True

.env.example

@@ -11,9 +11,34 @@ PORT=8081
 # Environment mode (production/development)
 ENVIRONMENT=production
 
+# Timezone configuration (default: host timezone via /etc/localtime mount)
+# Set to ensure correct timestamps in archive names and logs
+# Common timezones: America/New_York, America/Chicago, America/Los_Angeles,
+#                   Europe/London, Europe/Paris, Asia/Kolkata, Asia/Tokyo
+# Full list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+TZ=America/Chicago
+
 # Application version (auto-generated in CI/CD, use for local dev)
 # APP_VERSION=local-dev
 
+# =============================================================================
+# Reverse Proxy Configuration
+# =============================================================================
+
+# Base path for running behind reverse proxy in subfolder
+# Examples: BASE_PATH=/borg, BASE_PATH=/backup
+# Default: / (root path)
+# IMPORTANT:
+#   - Must start with / (e.g., /borg not borg)
+#   - No trailing slash (e.g., /borg not /borg/)
+#   - Rebuild required: docker-compose up -d --build
+# BASE_PATH=/
+
+# Nginx example:
+#   location /borg/ {
+#       proxy_pass http://localhost:8081/;
+#   }
+
 # =============================================================================
 # User/Group ID Configuration (for file permissions)
 # =============================================================================