Technical Debt Roadmap Execution

[ArthurCRodrigues]

Purpose

Coordinate the remediation work described in docs/roadmaps/TECHNICAL_DEBT_ROADMAP.md. The focus is to stabilize the existing pipeline architecture (Load Template → Export) before expanding features. Each sub-issue below maps 1:1 with the roadmap so work can be parallelized and tracked transparently.

Scope

• Use this tracker to stage work, discuss sequencing, and surface blockers across steps/services/templates/web layers.
• Sub-issues already contain detailed scope, impacted files, risks, and acceptance criteria drawn from the roadmap.
• Update the checklist as work lands; feel free to add blockers/notes inline.

Sub-Issue Checklist

• [TD] Fix Inverted Reporter Mode Assignment #216 – [TD] Fix Inverted Reporter Mode Assignment
• [TD] Implement DefaultReporter Output #217 – [TD] Implement DefaultReporter Output
• [TD] Remove Stale test_library Field #218 – [TD] Remove Stale test_library Field
• [TD] Fix FeedbackStep Contract #219 – [TD] Fix FeedbackStep Contract
• [TD] Decouple Sandbox Lifecycle from PreFlight #220 – [TD] Decouple Sandbox Lifecycle from PreFlight
• [TD] Make GraderService Stateless #221 – [TD] Make GraderService Stateless
• [TD] Resolve Language Before Running Tests #222 – [TD] Resolve Language Before Running Tests
• [TD] Unify Template Registration #223 – [TD] Unify Template Registration
• [TD] Add Typed PipelineExecution Accessors #224 – [TD] Add Typed PipelineExecution Accessors
• [TD] Split web_dev Template Monolith #225 – [TD] Split web_dev Template Monolith
• [TD] Standardize Language & Prep i18n #226 – [TD] Standardize Language & Prep i18n
• [TD] Remove Dead Parsers Package & AutograderResponse #227 – [TD] Remove Dead Parsers Package & AutograderResponse
• [TD] Align TestFunction required_file Contract #228 – [TD] Align TestFunction required_file Contract
• [TD] Replace print() Calls with Logging #229 – [TD] Replace print() Calls with Logging
• [TD] Decouple UpstashDriver Env Loading #230 – [TD] Decouple UpstashDriver Env Loading
• [TD] Standardize Template ABC Contract #231 – [TD] Standardize Template ABC Contract
• [TD] Introduce Step Registry for Pipeline Build #232 – [TD] Introduce Step Registry for Pipeline Build
• [TD] Formalize Exporter Plugin Interface #233 – [TD] Formalize Exporter Plugin Interface
• [TD] Separate PipelineExecution Summary Logic #234 – [TD] Separate PipelineExecution Summary Logic
• [TD] Standardize Step Error Handling #235 – [TD] Standardize Step Error Handling
• [TD] Decouple AiExecutor Batch Pattern #236 – [TD] Decouple AiExecutor Batch Pattern

How to Work This Board

1. Claim an open sub-issue, add context/assignee, and link PRs back to both the sub-issue and this tracker.
2. Keep docs/tests in sync with the scope outlined in each issue.
3. Use this parent issue for overall status updates, sequencing discussions, and cross-cutting risks (e.g., order dependencies between Items 17–21).

[ArthurCRodrigues]

Roadmap delivery update (4 non-good-first-issue technical-debt items):

• [TD] Make GraderService Stateless #221 -> PR [TD][GraderService] Make grading flow stateless (#221) #244 [TD][GraderService] Make grading flow stateless (#221) #244
• [TD] Unify Template Registration #223 -> PR [TD][Templates] Unify template registration in service layer (#223) #245 [TD][Templates] Unify template registration in service layer (#223) #245
• [TD] Add Typed PipelineExecution Accessors #224 -> PR [TD][PipelineExecution] Add typed accessors and step adoption (#224) #246 [TD][PipelineExecution] Add typed accessors and step adoption (#224) #246
• [TD] Standardize Template ABC Contract #231 -> PR [TD][Template ABC] Standardize template contract and validation (#231) #247 [TD][Template ABC] Standardize template contract and validation (#231) #247

Each issue was delivered via dedicated branch from origin/main, with linked PR and validation evidence posted on the issue.

Note: full pytest baseline in this environment is currently blocked by missing local dependency asyncpg during collection; all issue-scoped targeted test suites passed.