Track project · 04

Migrate TaskFlow Lite to TypeScript

Move the working JavaScript TaskFlow Lite into TypeScript without hiding the runtime boundaries.

Definition of done

What you are building

Build plan

Work through it one observable step at a time

01
Enable strict TypeScript settings.
02
Define the smallest useful `Task` and `TaskStatus` types from actual runtime data.
03
Migrate functions one at a time and remove implicit `any`.
04
Represent loading/success/error UI state as a discriminated union.
05
Use `unknown` for parsed or external data and narrow before access.
06
Add Zod at one real runtime boundary and compare it with TypeScript-only safety.
07
Add an exhaustiveness check to one state switch.
08
Run typecheck, then intentionally create three type errors and explain each diagnostic.

Evidence

Do not rely on “it seems to work”

Evidence to collect

A clean Git diff or file-tree changeCommands used and their exit/resultBrowser, HTTP, database, test, container, or CI evidence that proves the behaviorOne deliberate failure, the evidence you used, and the root-cause fixA short explanation of why the final responsibility lives in the chosen layer

Project exit ticket

Close the project only when these are true

Completion

I can demonstrate every deliverable.I can reproduce one key part without the walkthrough.I can explain one trade-off I deliberately chose.I can show one failure that my tests, constraints, or runbook now protects against.