Files
taskgraph_ts/docs/architecture.md
glm-5.1 bde1cc4e70 Decompose monolithic architecture.md into modular docs/architecture/ documents
The 751-line architecture.md violated the SDD process modular documentation
target (~500 lines). It also had duplicate TaskGraph class definitions (one
monolith, one decomposed) that directly contradicted each other, and embedded
consumer-specific tool dispatch mappings that belong in downstream projects.

Changes:
- Split into 8 focused documents + 7 ADR records + redirect page
- Removed the monolithic TaskGraph class (kept only decomposed version)
- Moved CLI→plugin dispatch mapping out (belongs in plugin architecture)
- Extracted implementation code (frontmatter splitter, findCycles, DAG
  propagation) into WHAT/WHY descriptions per architect role spec
- Added proper ADR format for all resolved design decisions
- Fixed review issues: C_fail mapping, DuplicateNodeError/DuplicateEdgeError
  types, ValidationError/GraphValidationError definitions, mutation error
  handling contract, enum naming convention, validation timing clarification
2026-04-26 06:38:52 +00:00

15 lines
1.3 KiB
Markdown

# Architecture
> **This document has been decomposed into modular documents.** See [docs/architecture/](architecture/) for the current architecture specification.
The monolithic architecture document was split to follow the SDD process's modular documentation pattern (~500 line target per document). The content now lives in:
- [architecture/README.md](architecture/README.md) — Overview, problem statement, consumer context
- [architecture/graph-model.md](architecture/graph-model.md) — Edge direction, construction, defaults, metadata
- [architecture/api-surface.md](architecture/api-surface.md) — TaskGraph class, standalone functions, return types
- [architecture/schemas.md](architecture/schemas.md) — TypeBox schemas, enums, numeric methods
- [architecture/cost-benefit.md](architecture/cost-benefit.md) — EV math, risk, DAG propagation, findCycles
- [architecture/frontmatter.md](architecture/frontmatter.md) — Parsing, serialization, supply chain security
- [architecture/errors-validation.md](architecture/errors-validation.md) — Error types, validation levels
- [architecture/build-distribution.md](architecture/build-distribution.md) — Dependencies, project structure, targets
- [architecture/decisions/](architecture/decisions/) — ADR records for design decisions