Break the @alkdev/taskgraph architecture specs into dependency-ordered implementation tasks across 8 component directories: setup, schema, error, graph, analysis, cost-benefit, frontmatter, api, and review. Each task has clear acceptance criteria referencing specific architecture docs. Three review tasks serve as quality gates at critical junction points (schemas-and-errors, graph-complete, complete-library). The dependency graph is validated acyclic with 9 topological levels enabling significant parallelism across independent work streams.
2.5 KiB
2.5 KiB
id, name, status, depends_on, scope, risk, impact, level
| id | name | status | depends_on | scope | risk | impact | level |
|---|---|---|---|---|---|---|---|
| setup/project-init | Initialize project with package.json, tsconfig, and build tooling | pending | moderate | low | project | implementation |
Description
Set up the TypeScript project from scratch. This is a greenfield project — the repo currently has only AGENTS.md and docs/. Initialize everything needed for a pure TypeScript ESM library: package.json, tsconfig.json, gitignore, and the src/ directory skeleton.
- Package name:
@alkdev/taskgraph - ESM primary, CJS compat
- Targets: Node 18+, Deno, Bun (pure JS, no native addons)
- Build:
tscfor declarations + bundler for distribution - Dependencies:
graphology,graphology-dag,graphology-metrics,graphology-components,graphology-operators,@alkdev/typebox,yaml
Acceptance Criteria
package.jsonexists with name@alkdev/taskgraph, ESM primary ("type": "module"), CJS compat config- All production dependencies listed per build-distribution.md dependencies table
- Dev dependencies include:
typescript,vitest(or agreed test runner),@types/node tsconfig.jsonconfigured for Node 18+ target, ESM module resolution, strict mode, declaration output.gitignorecoversnode_modules/,dist/,*.js.map,.envsrc/directory skeleton created per build-distribution.md project structure:src/index.tssrc/schema/index.ts,src/schema/enums.ts,src/schema/task.ts,src/schema/graph.ts,src/schema/results.tssrc/graph/index.ts,src/graph/construction.ts,src/graph/queries.ts,src/graph/mutation.tssrc/analysis/index.ts,src/analysis/critical-path.ts,src/analysis/bottleneck.ts,src/analysis/risk.ts,src/analysis/cost-benefit.ts,src/analysis/decompose.ts,src/analysis/defaults.tssrc/frontmatter/index.ts,src/frontmatter/parse.ts,src/frontmatter/serialize.tssrc/error/index.ts
test/directory created with placeholder test files per build-distribution specnpm installsucceeds without errorsnpx tsc --noEmitsucceeds (empty source files, but config is valid)
References
- docs/architecture/build-distribution.md — project structure, dependencies, targets
Notes
To be filled by implementation agent
Summary
To be filled on completion