flowgraph/tasks/setup-project-init.md at 466b121f7754e9d7356f5efc2403a9fd07632fae

Files

glm-5.1 466b121f77 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.

2026-05-21 20:24:44 +00:00

2.4 KiB

Raw Blame History

id, name, status, depends_on, scope, risk, impact, level

name

status

depends_on

scope

risk

impact

level

setup/project-init

Initialize project with package.json, tsconfig, build tooling, and source skeleton

pending

moderate

low

project

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:

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

2.4 KiB Raw Blame History