headquarter/openspec/changes/git-connection-model/specs/repository-connection/spec.md at 09920c1ca1b31111fc3318231f000cf249e99e39

Files

T

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

- 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

2026-05-16 13:43:49 +02:00

1.6 KiB

Raw Blame History

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

1.6 KiB Raw Blame History