Phase 26: Twelve Labs Async Embedding

.github/workflows/go.yml

@@ -497,8 +497,11 @@ jobs:
           CHROMA_API_KEY: ${{ secrets.CHROMA_API_KEY }}
           CHROMA_TENANT: ${{ secrets.CHROMA_TENANT }}
           CHROMA_DATABASE: ${{ secrets.CHROMA_DATABASE }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Test local runtime cross-persistence
         run: make test-crosslang-local
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - name: Upload Test Results
         if: always()
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0

.planning/REQUIREMENTS.md

@@ -25,10 +25,10 @@
 
 ### Provider Enhancement
 
-- [ ] **TLA-01**: Twelve Labs provider detects async task responses from the sync endpoint and enters a polling loop
-- [ ] **TLA-02**: Async polling respects caller context for cancellation and timeout
-- [ ] **TLA-03**: Async polling handles terminal states (ready, failed) with appropriate error messages
-- [ ] **TLA-04**: Tests cover async task creation, polling, completion, failure, and context cancellation
+- [x] **TLA-01**: Twelve Labs provider detects async task responses from the sync endpoint and enters a polling loop
+- [x] **TLA-02**: Async polling respects caller context for cancellation and timeout
+- [x] **TLA-03**: Async polling handles terminal states (ready, failed) with appropriate error messages
+- [x] **TLA-04**: Tests cover async task creation, polling, completion, failure, and context cancellation
 
 ### Internal Cleanup
 
@@ -69,10 +69,10 @@
 | EFL-03 | Phase 24 | Pending |
 | ERR-01 | Phase 25 | Complete |
 | ERR-02 | Phase 25 | Complete |
-| TLA-01 | Phase 26 | Pending |
-| TLA-02 | Phase 26 | Pending |
-| TLA-03 | Phase 26 | Pending |
-| TLA-04 | Phase 26 | Pending |
+| TLA-01 | Phase 26 | Complete |
+| TLA-02 | Phase 26 | Complete |
+| TLA-03 | Phase 26 | Complete |
+| TLA-04 | Phase 26 | Complete |
 | DL-01 | Phase 27 | Pending |
 | DL-02 | Phase 27 | Pending |
 | MORPH-01 | Phase 28 | Pending |

.planning/ROADMAP.md

@@ -27,7 +27,7 @@ See: [v0.4.1 Archived Roadmap](milestones/v0.4.1-ROADMAP.md)
 - [x] **Phase 23: ORT EF Leak Fix** - Default ORT EF is properly closed when CreateCollection finds an existing collection (completed 2026-04-11)
 - [x] **Phase 24: GetOrCreateCollection EF Safety** - GetOrCreateCollection does not pass closed EFs to CreateCollection fallback (completed 2026-04-12)
 - [x] **Phase 25: Error Body Truncation** - Embedding provider error messages truncate raw HTTP bodies to safe display lengths (completed 2026-04-13)
-- [ ] **Phase 26: Twelve Labs Async Embedding** - Twelve Labs provider handles async task responses for long-running media
+- [x] **Phase 26: Twelve Labs Async Embedding** - Twelve Labs provider handles async task responses for long-running media (completed 2026-04-14)
 - [ ] **Phase 27: Download Stack Consolidation** - default_ef download code uses shared downloadutil instead of its own HTTP implementation
 - [ ] **Phase 28: Morph Test Fix** - Morph EF integration test handles upstream 404 gracefully
 - [ ] **Phase 29: Rank Expression Composition Robustness** - Reject silent footguns in rank composition (nil operands, degenerate RRF compositions)
@@ -126,10 +126,13 @@ Plans:
   2. Polling respects the caller's context.Context for cancellation and timeout
   3. Terminal states (ready, failed) are handled with appropriate result delivery or error messages
   4. Tests cover async task creation, polling to completion, polling to failure, and context cancellation
-**Plans**: TBD
+**Plans**: 4 plans
 
 Plans:
-- [ ] 26-01: TBD
+- [x] 26-01-PLAN.md — Async HTTP foundation: request/response types, polling fields, doTaskPost/doTaskGet helpers
+- [x] 26-02-PLAN.md — Polling loop, modality routing, and async orchestrator (pollTask + content.go branch)
+- [x] 26-03-PLAN.md — WithAsyncPolling option and GetConfig/FromConfig async round-trip
+- [x] 26-04-PLAN.md — Seven async tests (create, poll-ready, poll-failed, unexpected-status, ctx-cancel, maxWait, config round-trip)
 
 ### Phase 27: Download Stack Consolidation
 **Goal**: default_ef download code uses the shared downloadutil package instead of its own HTTP download implementation
@@ -200,7 +203,7 @@ Phase 24 depends on Phase 23. Phase 26 depends on Phase 25. Phase 29 depends on
 | 23. ORT EF Leak Fix | v0.4.2 | 1/1 | Complete    | 2026-04-11 |
 | 24. GetOrCreateCollection EF Safety | v0.4.2 | 1/1 | Complete    | 2026-04-12 |
 | 25. Error Body Truncation | v0.4.2 | 4/4 | Complete   | 2026-04-13 |
-| 26. Twelve Labs Async Embedding | v0.4.2 | 0/0 | Not started | - |
+| 26. Twelve Labs Async Embedding | v0.4.2 | 4/4 | Complete    | 2026-04-14 |
 | 27. Download Stack Consolidation | v0.4.2 | 0/0 | Not started | - |
 | 28. Morph Test Fix | v0.4.2 | 0/0 | Not started | - |
 | 29. Rank Expression Composition Robustness | v0.4.2 | 0/3 | Not started | - |

.planning/STATE.md

@@ -2,15 +2,15 @@
 gsd_state_version: 1.0
 milestone: v0.4.2
 milestone_name: Bug Fixes and Robustness
-status: ready
-stopped_at: Phase 25 shipped — PR #506
-last_updated: "2026-04-13T18:25:33.287Z"
-last_activity: "2026-04-13 -- Phase 25 shipped — PR #506"
+status: executing
+stopped_at: Phase 26 shipped — PR #509
+last_updated: "2026-04-14T12:47:58.488Z"
+last_activity: 2026-04-14
 progress:
   total_phases: 11
-  completed_phases: 6
-  total_plans: 10
-  completed_plans: 10
+  completed_phases: 7
+  total_plans: 14
+  completed_plans: 14
   percent: 100
 ---
 
@@ -21,22 +21,22 @@ progress:
 See: .planning/PROJECT.md (updated 2026-04-10)
 
 **Core value:** Go applications can use Chroma and embedding providers through a stable, portable API that minimizes provider-specific friction.
-**Current focus:** Phase 30 — v2-searchrequestoption-nil-consistency
+**Current focus:** Phase 26 — twelve-labs-async-embedding
 
 ## Current Position
 
 Phase: 30
 Plan: Not started
-Status: Phase 25 shipped — PR #506
-Last activity: 2026-04-13 -- Phase 25 shipped — PR #506
+Status: Phase 26 shipped — PR #509
+Last activity: 2026-04-14
 
 Progress: [██████████] 100%
 
 ## Performance Metrics
 
 **Velocity:**
 
-- Total plans completed: 10
+- Total plans completed: 14
 - Average duration: 23 min
 - Total execution time: 23 min
 
@@ -70,5 +70,5 @@ Decisions are logged in PROJECT.md Key Decisions table.
 
 ## Session
 
-**Last Date:** 2026-04-13T08:13:19.127Z
-**Stopped At:** Phase 25 shipped — PR #506
+**Last Date:** 2026-04-14T06:03:58.196Z
+**Stopped At:** Phase 26 shipped — PR #509