Files

T

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

Raw Blame History

Repository Clone Mode Specification

Purpose

Support host-side repository cloning for tool instances, enabling isolated development environments with full git history and SSH key access for container git operations.

Requirements

Requirement: Host-side repository cloning

The system SHALL clone repositories on the host filesystem before container startup when clone mode is selected.

Scenario: Clone repository with branch selection

GIVEN a repository with a remote URL and SSH key
WHEN an instance is created in clone mode with branch="feature-x"
THEN the system runs git clone --branch feature-x <remote_url> <instance_dir>/repo-clone/
AND the clone includes full history

Scenario: Clone repository with default branch

GIVEN a repository with a remote URL and SSH key
WHEN an instance is created in clone mode without specifying a branch
THEN the system defaults to branch="main"
AND runs git clone --branch main <remote_url> <instance_dir>/repo-clone/

Requirement: SSH key preparation for containers

The system SHALL decrypt and prepare SSH keys for container mounting.

Scenario: Prepare SSH key files

GIVEN a repository with an associated SSH key
WHEN a clone-mode instance is started
THEN the private key is decrypted and written to instance_dir/.ssh/id_ed25519 with mode 600
AND the public key is written to instance_dir/.ssh/id_ed25519.pub
AND an SSH config is written to instance_dir/.ssh/config with StrictHostKeyChecking no

Requirement: Repository dirty state detection

The system SHALL detect uncommitted changes in cloned repositories.

Scenario: Detect clean repository

GIVEN a cloned repository with no changes
WHEN dirty state is checked
THEN the result indicates no uncommitted changes

Scenario: Detect dirty repository

GIVEN a cloned repository with modified files
WHEN dirty state is checked
THEN the result indicates uncommitted changes with file details

Dependencies

Database models: GitRepository, ToolInstance, SSHKey
Docker Compose volume mounting
Git installed on host and in containers

Quality Gates

pytest must pass
mypy . must pass
ruff check . must pass
npm run typecheck must pass
npm run lint must pass

2.3 KiB Raw Blame History