Initial Commit

openspec/archive/2026-04-19-enterprise-fsm/tasks.md

@@ -0,0 +1,47 @@
+# Tasks: enterprise-fsm
+
+## 1. Scaffold
+
+- [x] 1.1 `universal/control-flow/fsm/`; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.
+
+## 2. Errors + schemas
+
+- [x] 2.1 `src/fsm-utils.ts` — `createFsmError`, validation helpers.
+- [x] 2.2 Zod schemas for `MachineConfig`, `StateConfig`, `TransitionDefinition`.
+
+## 3. Core FSM
+
+- [x] 3.1 `src/fsm.types.ts` — full type surface.
+- [x] 3.2 `src/fsm.ts` — `createMachine`, `StateMachine` with listener API, sync/async guards + actions, snapshot/restore.
+- [x] 3.3 `src/fsm-hooks.ts` — hook map + handler signatures.
+- [x] 3.4 OTel histogram + counter.
+
+## 4. Hierarchical
+
+- [x] 4.1 `src/hierarchy/hierarchical-fsm.ts`.
+
+## 5. Parallel regions
+
+- [x] 5.1 `src/parallel/parallel-fsm.ts` with sync points.
+
+## 6. History states
+
+- [x] 6.1 `src/history/history-state.ts` — shallow + deep history.
+
+## 7. Deferred events
+
+- [x] 7.1 `src/deferred/deferred-queue.ts` — bounded queue with drop-oldest/drop-newest policy.
+
+## 8. Visualisation
+
+- [x] 8.1 `src/visualization/fsm-visualizer.ts` — DOT + Mermaid.
+
+## 9. Docs / barrel / subpath exports / README
+
+## 10. Benchmarks
+
+- [x] 10.1 `transition.bench.ts` at 10 / 100 / 1 000 state configurations.
+
+## 11. Ship gate
+
+- [x] 11.1 Verification sequence; fold + archive.