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.
1.9 KiB
1.9 KiB
id, name, status, depends_on, scope, risk, impact, level
| id | name | status | depends_on | scope | risk | impact | level | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| review/complete-library | Final review — validate full library against architecture docs | pending |
|
broad | low | project | review |
Description
Final review of the complete library. Verify the full API surface matches architecture docs, all analysis functions produce correct results, and the library achieves its stated purpose: pure TypeScript task graph library with graphology, replicating and extending the essential graph algorithms and cost-benefit math from the Rust CLI.
Acceptance Criteria
- Public API matches api-surface.md exactly — no missing exports, no extra exports
- All construction paths work: fromTasks, fromRecords, fromJSON, incremental
- DAG-propagation cost model produces results consistent with Python research model examples
- Independent model available as degenerate case (set
propagationMode: 'independent'ordefaultQualityRetention: 1.0) - Frontmatter parsing round-trips correctly:
parseFrontmatter(serializeFrontmatter(task))≈ task Value.Clean()andValue.Errors()used correctly throughout (noValue.Assert()where structured errors needed)- No gray-matter, no js-yaml, no Zod anywhere in the dependency tree
npm packproduces a valid package with correct exports- All tests pass:
npm test - TypeScript strict mode compilation succeeds with no errors
- Build output (
dist/) is correct: ESM + CJS + declarations
References
- docs/architecture/README.md
- docs/architecture/api-surface.md
- docs/architecture/build-distribution.md
- docs/architecture/cost-benefit.md
Notes
To be filled by implementation agent
Summary
To be filled on completion