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
2.6 KiB
2.6 KiB
id: capability.infotech.issue-tracking name: External Issue Tracker Connector summary: Backend-agnostic CLI/Python connector to Forgejo (and SQLite cache) with work-record UUID ↔ external issue mapping. Not the fleet work origin. owner: issue-core status: draft domain: infotech tags:
- issue-tracking
- connector
- work-record
maturity:
discovery:
current: D4
target: D5
confidence: high
rationale: INTENT.md, SCOPE.md, CAPABILITY-issue-tracking.yaml, mapping design,
boundary-sync policy, AGENT_INTEGRATION.md.
availability:
current: A2
target: A3
confidence: high
rationale: Python package + CLI (list/create/project/map) installable via pip;
mapping store shipped; MCP not yet available.
external_evidence:
completeness:
level: C2
confidence: medium
basis: scope_vs_intent_and_consumer_expectations
satisfied_expectations:
- Forgejo + local SQLite backends
- CLI with JSON output; project/map commands
- work_record_uuid optional on TaskSpec
- credential handling via env vars (FORGEJO_TOKEN preferred; GITEA_API_TOKEN deprecated alias; ISSUE_CORE_API_KEY) broken_expectations: [] out_of_scope_expectations:
- Fleet task origin / intake promotion (work-record canon)
- Default IssueSink for internal findings (activity-core) reliability: level: R1 confidence: low basis: consumer_quality_signals known_reliability_risks:
- manual backend configuration (auto-detect planned)
- no built-in issue locking beyond assignee+state
- inward boundary sync not shipped discovery: intent: Project and operate on external issue trackers with a stable link to work-record UUIDs; never replace file-first work records as coordination substrate. includes:
- unified Python API and CLI over Gitea/SQLite issue operations
- work_record_issue_map store + project/map/push-status
- local offline cache and backend sync
- credential handling via environment variables excludes:
- originating workplans/tasks/intake
- MCP server (planned)
- multi-agent fleet board semantics on Forgejo assumptions: [] use_cases: [] research_memos: [] availability: current_level: A2 target_level: A3 current_artifacts:
- Python package (
issue_core) - '
issueCLI (including project/map)' target_artifacts: [] consumption_modes: - cli
- library import
- rest (optional
[api]extra) relations: depends_on: [] supports: [] related_to: - capability.activity.event-coordinate evidence: documentation:
- INTENT.md
- SCOPE.md
- CAPABILITY-issue-tracking.yaml
- docs/uuid-external-id-mapping.md
- docs/boundary-sync-and-status-mapping.md