alex/headquarter
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(openspec): add FN-007 Git Connection Model change

Browse Source 
- Add proposal, design, specs, and tasks for git connection model
- Include provider adapter, credential storage, SSH key lifecycle specs
- Add repository connection API and git operations specifications
This commit is contained in:
Alex
2026-05-16 13:43:49 +02:00
parent e071e3418d
commit 024278a3d2
10 changed files with 349 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
openspec/changes/git-connection-model/specs/repository-connection/spec.md
+42
View File
@@ -0,0 +1,42 @@
## ADDED Requirements
### Requirement: Repository connections can be created
The system SHALL allow users to create connections to Git repositories.
#### Scenario: Connect GitHub repository
- **WHEN** a user provides a GitHub repository URL and access token
- **THEN** the system validates the URL and token
- **AND** creates a RepositoryConnection record
- **AND** generates an SSH key pair
- **AND** registers the deploy key with GitHub
#### Scenario: Connect GitLab repository
- **WHEN** a user provides a GitLab repository URL and access token
- **THEN** the system validates the URL and token
- **AND** creates a RepositoryConnection record
- **AND** generates an SSH key pair
- **AND** registers the deploy key with GitLab
#### Scenario: Reject invalid URL
- **WHEN** a user provides an invalid repository URL
- **THEN** the system returns a 400 error with validation message
### Requirement: Repository connections can be listed and retrieved
The system SHALL allow users to list and view their repository connections.
#### Scenario: List connections
- **WHEN** a user requests their repository connections
- **THEN** the system returns a list with status and metadata
#### Scenario: Get connection details
- **WHEN** a user requests a specific connection
- **THEN** the system returns full details including SSH public key
### Requirement: Repository connections can be deleted
The system SHALL allow users to delete repository connections.
#### Scenario: Delete connection
- **WHEN** a user deletes a connection
- **THEN** the system removes the deploy key from the provider
- **AND** deletes the SSH key pair
- **AND** marks the connection as deleted