Scriberr/devnotes/engine-worker-sprint-tracker.md

Sprint Run Tracker: Engine Worker Integration

Run ID: EWI

Status: planning only. No implementation has started.

This tracker belongs to devnotes/engine-worker-sprints.md and the implementation spec in devnotes/engine-worker-integration-spec.md.

EWI-Sprint 0: Integration Inventory and Commit Plan

Status: completed

Completed tasks:

• Inventoried server startup, config, schema, repository, queue, transcription stack, API placeholders, docs, Docker, and test fixtures.
• Documented the legacy adapter deletion targets.
• Documented API/service seams for create, submit, retry, cancel, transcript, events, logs, executions, models, and queue stats.
• Added structured logging requirements for config, provider, worker, queue, orchestration, and terminal states.
• Added a sprint-by-sprint commit plan for EWI-Sprints 1-10.

Artifacts:

• devnotes/engine-worker-sprint-0-inventory.md

Verification:

• Inventory-only sprint. No runtime code changed.
• Focused repository inspection completed with rg, find, and targeted source reads.

EWI-Sprint 1: Config and Engine Module Wiring

Status: completed

Completed tasks:

• Added local engine module wiring with require scriberr-engine v0.0.0 and replace scriberr-engine => ./references/engine.
• Added config.EngineConfig and config.WorkerConfig.
• Added config.LoadWithError() for startup-failing validation while retaining config.Load() for compatibility.
• Parsed and validated all SPEECH_ENGINE_* and TRANSCRIPTION_* env vars from the spec.
• Updated server startup to fail clearly on invalid config.
• Added structured startup logging for engine and worker configuration.
• Added focused config tests before implementation.

Artifacts:

• go.mod
• cmd/server/main.go
• internal/config/config.go
• internal/config/config_test.go

Verification:

• GOCACHE=/tmp/scriberr-go-cache go test ./internal/config passed.
• GOCACHE=/tmp/scriberr-go-cache go test ./internal/api ./internal/config ./internal/database ./internal/repository ./internal/transcription/... ./cmd/server ./pkg/logger ./pkg/middleware passed.
• GOCACHE=/tmp/scriberr-go-cache go vet ./internal/api ./internal/config ./internal/database ./internal/repository ./internal/transcription/... ./cmd/server ./pkg/logger ./pkg/middleware passed.
• git diff --check passed.

EWI-Sprint 2: Engine Provider Abstraction

Status: completed

Completed tasks:

• Added internal/transcription/engineprovider provider and registry interfaces.
• Added internal provider request/result/capability types so scriberr-engine types do not leak outside the provider boundary.
• Added static provider registry with deterministic capability aggregation.
• Added local provider wrapper for scriberr-engine/speech/engine.
• Mapped Scriberr transcription and diarization requests to local engine requests.
• Forced token timestamps for local transcription requests.
• Mapped engine words and diarization segments to public-safe internal result structs.
• Added model capability discovery from the engine model specs with install state through IsModelInstalled.
• Added provider error sanitization for paths and token-like values.
• Added focused fake-engine tests for mapping, empty words, capabilities, diarization speakers, close behavior, and sanitized errors.
• Updated the main module to go 1.26 because the local scriberr-engine module declares go 1.26.

Artifacts:

• internal/transcription/engineprovider/types.go
• internal/transcription/engineprovider/registry.go
• internal/transcription/engineprovider/local_provider.go
• internal/transcription/engineprovider/sanitize.go
• internal/transcription/engineprovider/*_test.go
• go.mod
• go.sum

Verification:

• GOCACHE=/tmp/scriberr-go-cache go test ./internal/transcription/engineprovider passed.
• GOCACHE=/tmp/scriberr-go-cache go vet ./internal/api ./internal/config ./internal/database ./internal/repository ./internal/transcription/... ./cmd/server ./pkg/logger ./pkg/middleware passed.
• GOCACHE=/tmp/scriberr-go-cache go test ./internal/api ./internal/config ./internal/database ./internal/repository ./internal/transcription/... ./cmd/server ./pkg/logger ./pkg/middleware passed with escalation because an existing webhook integration test opens a local httptest listener.
• git diff --check passed.
• Verified no non-provider Go package imports scriberr-engine.

EWI-Sprint 3: Queue Schema and Repository Methods

Status: not started

Planned artifacts:

• internal/models/transcription.go
• internal/database/schema.go
• internal/repository/*
• focused repository/database tests

Verification:

• Pending

EWI-Sprint 4: Durable Worker Service

Status: not started

Planned artifacts:

• internal/transcription/worker

Verification:

• Pending

EWI-Sprint 5: Orchestrator, Transcript Mapping, and Speaker Merge

Status: not started

Planned artifacts:

• internal/transcription/orchestrator
• transcript mapper and speaker merge tests

Verification:

• Pending

EWI-Sprint 6: API Wiring for Real Queue Execution

Status: not started

Planned artifacts:

• internal/api/transcription_handlers.go
• internal/api/events_handlers.go
• internal/api/response_models.go
• API tests for queue-backed behavior

Verification:

• Pending

EWI-Sprint 7: Server Startup, Shutdown, and Legacy Adapter Removal

Status: not started

Planned artifacts:

• cmd/server/main.go
• deleted or disabled legacy Python adapter stack
• lifecycle tests where practical

Verification:

• Pending

EWI-Sprint 8: Real Engine Integration Tests and Performance Smoke

Status: not started

Planned artifacts:

• gated real engine integration tests
• test-audio/jfk.wav smoke notes

Verification:

• Pending

EWI-Sprint 9: Docs, Docker, and Setup UX

Status: not started

Planned artifacts:

• README.md
• Docker compose files
• docs/troubleshooting updates

Verification:

• Pending

EWI-Sprint 10: Hardening, Cleanup, and Release Candidate

Status: not started

Planned artifacts:

• final tracker updates
• hardening fixes
• cleanup commits

Verification:

• Pending