Files
Fusion 063a839790 feat: implement repository clone mode with SSH key support
- Add clone_mode and branch fields to tool_instances
- Add ssh_key_id to git_repositories for per-repo SSH key assignment
- Implement host-side git cloning with branch selection (default: main)
- Mount SSH keys into containers for git operations in clone mode
- Add dirty state check on clone-mode instance deletion with confirmation
- Update SessionsPage with mount/clone selector, branch input, SSH key display
- Add SSH key selector to repository creation form
- Add dirty delete confirmation modal with changed files list
- Update API schemas and endpoints for new fields
- Sync delta specs to main specs (git-repo, tool-instances, repo-clone-mode)
- Archive completed OpenSpec change: repo-clone-mode-with-ssh
- Document git requirement for custom tool types

Quality gates: Frontend typecheck and build passed
OpenSpec: repo-clone-mode-with-ssh archived with all tasks complete
2026-05-22 22:56:35 +02:00

2.3 KiB

1. Database Migration

  • 1.1 Create Alembic migration to add new columns to tool_configs table
  • 1.2 Add columns: start_command (text), port (integer), working_directory (text), environment_variables (jsonb), volumes (jsonb)
  • 1.3 Run migration locally and verify

2. Backend Model Updates

  • 2.1 Update ToolConfig model with new fields
  • 2.2 Update Pydantic schemas (ToolConfigCreate, ToolConfigResponse)
  • 2.3 Add validation for port range (1-65535)
  • 2.4 Add JSON validation for environment_variables and volumes

3. Backend API Updates

  • 3.1 Update list_configs endpoint to return new fields
  • 3.2 Update create_config endpoint to accept new fields
  • 3.3 Update update_config endpoint to handle new fields
  • 3.4 Add validation error handling with clear messages

4. Frontend Types and API

  • 4.1 Update ToolConfig interface with new fields
  • 4.2 Update API client functions to handle new fields
  • 4.3 Add type definitions for JSON fields

5. Frontend UI - Split Pane Layout

  • 5.1 Create split-pane layout component (left list, right detail)
  • 5.2 Implement left panel: scrollable list grouped by tool type
  • 5.3 Implement right panel: detail/edit form with tabs/sections
  • 5.4 Add responsive design (stack on mobile)
  • 5.5 Add "New Config" button and blank form state

6. Frontend UI - Form Fields

  • 6.1 Add Basic section: key, value, config_type, file_path
  • 6.2 Add Runtime section: start_command, port, working_directory
  • 6.3 Add Advanced section: environment_variables (JSON editor)
  • 6.4 Add Advanced section: volumes (JSON editor)
  • 6.5 Implement JSON validation with visual feedback
  • 6.6 Add form validation and error display

7. Integration and Testing

  • 7.1 Test creating config with all new fields
  • 7.2 Test updating existing config
  • 7.3 Test JSON validation (valid/invalid cases)
  • 7.4 Test responsive layout on different screen sizes
  • 7.5 Verify backward compatibility with old configs

8. Quality Gates

  • 8.1 Run backend linting (ruff)
  • 8.2 Run backend type checking (mypy)
  • 8.3 Run frontend type checking (tsc)
  • 8.4 Run frontend linting (eslint)
  • 8.5 Build frontend and verify
  • 8.6 Commit and push changes