issue-core/registry/capabilities/capability.infotech.issue-tracking.md
tegwick ee9b85215d
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Build and Publish Container Image / build-and-push (push) Successful in 34s
docs(ISSUE-WP-0006): Forgejo-only language and projection boundary
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
2026-09-14 04:52:58 +02:00

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)
    • 'issue CLI (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