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,50 @@
---
id: setup/project-init
name: Initialize project with package.json, tsconfig, build tooling, and source skeleton
status: pending
depends_on: []
scope: moderate
risk: low
impact: project
level: implementation
---
## Description
Set up the TypeScript project from scratch. The repo currently has only `AGENTS.md` and `docs/`. Initialize everything needed for a pure TypeScript ESM library targeting DAG-based workflow orchestration.
Per [build-distribution.md](../docs/architecture/build-distribution.md):
- Package name: `@alkdev/flowgraph`
- ESM primary, CJS compat via tsup
- Targets: Node 18+, Deno, Bun, Browser (pure JS, no native addons)
- Build: `tsup` for ESM + CJS + declarations
- Dependencies: `graphology`, `graphology-dag`, `@alkdev/typebox`, `@alkdev/ujsx`, `@preact/signals-core`
- Peer dependencies: `@alkdev/operations`
## Acceptance Criteria
- [ ] `package.json` exists with name `@alkdev/flowgraph`, ESM primary (`"type": "module"`), full exports map per build-distribution spec
- [ ] All production dependencies listed: `graphology`, `graphology-dag`, `@alkdev/typebox`, `@alkdev/ujsx`, `@preact/signals-core`
- [ ] Peer dependency: `@alkdev/operations`
- [ ] Dev dependencies include: `typescript`, `vitest`, `@vitest/coverage-v8`, `tsup`, `@types/node`
- [ ] `tsconfig.json` configured for ES2022 target, Node16 module resolution, strict mode with `noUncheckedIndexedAccess`, `noUnusedLocals`, `noUnusedParameters`, `noFallthroughCasesInSwitch`, `erasableSyntaxOnly`
- [ ] `tsup.config.ts` with named entry points matching exports map (index, component/index, host/index, schema/index, graph/index, reactive/index, analysis/index, error/index)
- [ ] `vitest.config.ts` with `@` alias, globals, V8 coverage
- [ ] `.gitignore` covers `node_modules/`, `dist/`, `*.js.map`
- [ ] `src/` directory skeleton created per build-distribution spec with all module directories and empty index.ts barrel files
- [ ] `test/` directory with placeholder test files per module structure
- [ ] `npm install` succeeds without errors
- [ ] `npx tsc --noEmit` succeeds (empty source files, but config is valid)
- [ ] `npm run build` succeeds via tsup (produces dist/ output with ESM + CJS + .d.ts)
## References
- docs/architecture/build-distribution.md — project structure, dependencies, exports map, tsup config, tsconfig, vitest config
## Notes
> To be filled by implementation agent
## Summary
> To be filled on completion