Skip to main content

Taiga

Taiga is the first external board adapter. Nexus keeps its own authoritative board and projects to Taiga via the TaigaBoardProvider (nexus-board-taiga).

What the adapter does​

  • Create Taiga user stories from Nexus board items
  • Update Taiga user-story statuses as Nexus statuses change
  • Add comments (agent progress, handoffs)
  • Receive Taiga webhooks and reconcile external changes

Status mapping​

Nexus internal board statuses map to Taiga user-story status names:

Nexus statusTaiga status
plannedNew
ready_for_agentReady
runningIn progress
waiting_humanReady for test
blockedBlocked
doneDone

"Ready for Agent" and "Blocked" are custom statuses an operator may add in Taiga. If they are absent, the adapter best-effort skips setting them on create.

Authentication​

The adapter talks to the Taiga REST API using a normal auth token sent as Authorization: Bearer <token>. It logs in with a service-account username/password and caches/refreshes the token, or accepts a static auth_token directly.

Rate limits​

Taiga has no fixed documented per-minute cap, but the adapter still applies client-side rate limiting (governor, default 60 requests/min) and backoff so bursts of board updates stay well-behaved.

Webhooks​

Taiga supports webhooks for project / user-story events. Taiga signs webhook payloads with HMAC-SHA1, sent in the X-TAIGA-WEBHOOK-SIGNATURE header. Nexus verifies the signature (hmac + sha1), then the worker reconciles the change into the internal board (board_links maps internal ↔ external IDs).

Config​

Stored in the integrations collection:

{
  "_id": "integration_taiga",
  "kind": "taiga",
  "config": {
    "base_url": "https://taiga.nexusapp.dev",
    "project_id": "42",
    "username": "nexus-bot",
    "password": "secret://taiga-service-password"
  }
}

Instead of username + password, you can provide a static auth_token:

{
  "_id": "integration_taiga",
  "kind": "taiga",
  "config": {
    "base_url": "https://taiga.nexusapp.dev",
    "project_id": "42",
    "auth_token": "secret://taiga-auth-token"
  }
}

Deployment​

Taiga is deployed in Kubernetes at https://taiga.nexusapp.dev, namespace nexus-taiga (Helm chart unxwares/taiga).