decompose architecture into 38 atomic tasks across 12 parallel generations

Decompose the reviewed architecture specs into taskgraph-managed tasks:
- 2 setup tasks (project init, test infrastructure)
- 4 schema tasks (enums, node attrs, edge attrs, graph schemas)
- 1 error hierarchy task
- 6 graph tasks (FlowGraph class, 3 construction paths, queries, validation)
- 5 analysis tasks (type-compat, build-type-edges, ordering, template-validation, defaults)
- 5 component tasks (Operation, Sequential, Parallel, Conditional, Map)
- 2 host config tasks (GraphologyHostConfig, ReactiveHostConfig)
- 4 reactive tasks (WorkflowRoot, node-status, max-concurrency, retry-semantics)
- 3 review tasks (foundation, reactive-and-hosts, complete-library)
- 5 meta cluster tasks (schema, graph, component, reactive, analysis layers)
- 1 API exports task

Validated with taskgraph: zero cycles, 38 tasks, 12 parallel generations.
Critical path: 12 tasks through reactive execution layer.
This commit is contained in:
2026-05-21 20:24:44 +00:00
parent 907c33650f
commit 466b121f77
38 changed files with 1623 additions and 0 deletions

View File

@@ -0,0 +1,51 @@
---
id: review/complete-library
name: Final review — validate full library against architecture docs, build, and exports
status: pending
depends_on:
- api/public-exports
- review/foundation
- review/reactive-and-hosts
scope: broad
risk: low
impact: project
level: review
---
## Description
Final review of the complete library. Verify the full API surface matches architecture docs, all construction paths work, reactive execution is correct, and the library achieves its purpose: DAG-based operation orchestration with ujsx template composition and reactive execution.
## Acceptance Criteria
- [ ] Public API matches [flowgraph-api.md](../docs/architecture/flowgraph-api.md) exactly — no missing exports, no extra exports
- [ ] All construction paths work: fromSpecs, fromCallEvents, fromJSON, incremental
- [ ] Operation graph: correct node and edge structure, type-compatibility edges
- [ ] Call graph: correct event processing, status transitions, abort cascading
- [ ] Analysis functions: typeCompat produces correct results for compatible/incompatible/unknown schemas
- [ ] Template validation: catches missing operations, cycles, type mismatches
- [ ] GraphologyHostConfig: renders templates to correct DAG structure
- [ ] ReactiveHostConfig: renders templates to correct signal graph
- [ ] WorkflowReactiveRoot: signal lifecycle, event log projection, abort, dispose all work
- [ ] Conditional as error boundary: failure caught, else-branch activated
- [ ] Consumer integration walkthrough per [consumer-integration.md](../docs/architecture/consumer-integration.md) is executable
- [ ] `npm run build` produces correct ESM + CJS + declarations for all entry points
- [ ] `npm pack` produces valid package with correct exports
- [ ] All tests pass: `npm test`
- [ ] TypeScript strict mode compilation succeeds: `npx tsc --noEmit`
- [ ] No gray-matter, no js-yaml, no Zod in dependencies
- [ ] Test coverage > 90% for src/
## References
- docs/architecture/README.md — full overview
- docs/architecture/consumer-integration.md — end-to-end walkthrough
- docs/architecture/build-distribution.md — package structure, build configuration
## Notes
> To be filled by implementation agent
## Summary
> To be filled on completion