tegwick
ee9b85215d
Prefer Forgejo as the self-hosted forge product. Keep Gitea only as the Gitea-compatible API identifier (module backends/gitea, type string gitea). FORGEJO_TOKEN is preferred; GITEA_* remains a deprecated alias. INTENT/SCOPE quote ACT-ADR-005: issue-core is not the fleet ops claim queue. Connector docs describe repo work record → hub index → optional Forgejo projection, not activity-core → issue-core → harness. Assistant: grok Assistant-Session: 01a09dc6-3f0d-7c93-8b11-8e83c0623d49
83 lines
No EOL
2.2 KiB
YAML
83 lines
No EOL
2.2 KiB
YAML
schema_version: open-reuse.integration.v0.1
|
|
id: issue-core-gitea
|
|
name: issue-core Forgejo Backend
|
|
description: >
|
|
Pluggable remote backend that maps the issue-core unified issue model onto the
|
|
Forgejo issues API (Gitea-compatible) for external-tracker projection and
|
|
synchronization. Gitea is not a second supported product.
|
|
status: registered
|
|
owner: issue-core
|
|
|
|
local:
|
|
repo: issue-core
|
|
path: integration/gitea-backend.integration.yaml
|
|
system: issue-core
|
|
|
|
upstream:
|
|
name: Forgejo (Gitea-compatible API)
|
|
project_url: https://codeberg.org/forgejo/forgejo
|
|
homepage: https://forgejo.org/
|
|
version_policy: gitea-api-v1
|
|
monitor:
|
|
releases: true
|
|
tags: true
|
|
security_advisories: true
|
|
license_changes: true
|
|
|
|
reuse:
|
|
primary_reuse_mode: adapter
|
|
secondary_reuse_modes:
|
|
- plugin
|
|
risk_level: medium
|
|
rationale: >
|
|
Forgejo (Gitea-compatible) REST API is wrapped behind the RemoteBackend
|
|
interface; local task lifecycle semantics remain stable across backend swaps.
|
|
|
|
boundary:
|
|
type: adapter
|
|
local_adapter: issue_core.backends.gitea.backend.GiteaBackend
|
|
local_interface: issue_core.core.interfaces.RemoteBackend
|
|
reused_surface: Forgejo (Gitea-compatible) /api/v1 issues, labels, milestones, comments
|
|
contracts:
|
|
- issue-core.backend.v1
|
|
fragility_points:
|
|
- Gitea API field changes
|
|
- issue state mapping differences
|
|
- pagination and rate-limit behavior
|
|
- authentication token scopes
|
|
|
|
validation:
|
|
harness: python3 -m pytest tests/test_gitea_backend.py
|
|
skip_without_runtime: true
|
|
checks:
|
|
- API client request shaping
|
|
- issue state mapping
|
|
- error handling for rate limits
|
|
policy: required-before-update
|
|
|
|
update_policy:
|
|
default_action: require-maintainer-review
|
|
auto_eligible: false
|
|
|
|
risks:
|
|
sensitivity:
|
|
- Gitea API breaking changes
|
|
- authentication model changes
|
|
- rate-limit policy changes
|
|
- license changes
|
|
escalation_triggers:
|
|
- validation failure
|
|
- Gitea major release
|
|
- production sync errors
|
|
|
|
maintenance:
|
|
maintainers:
|
|
- issue-core
|
|
escalation_conditions:
|
|
- Gitea API compatibility failure
|
|
- validation failure
|
|
- production backend sync regression
|
|
|
|
audit:
|
|
registered_at: "2026-06-24"
|
|
registered_by: open-reuse |