taskgraph_ts/tasks/implementation/cost-benefit/risk-analysis.md at 131e3e929b50de5749c864fbd04c4e5e3ffda52d

Files

glm-5.1 131e3e929b Decompose architecture into 28 atomic implementation tasks

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.

2026-04-27 08:30:05 +00:00

2.0 KiB

Raw Blame History

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

name

status

depends_on

scope

risk

impact

level

cost-benefit/risk-analysis

Implement riskPath, riskDistribution, and shouldDecomposeTask functions

pending

cost-benefit/ev-calculation

analysis/critical-path

schema/numeric-methods-and-defaults

moderate

low

component

implementation

Description

Implement the three risk analysis functions: riskPath, riskDistribution, and shouldDecomposeTask. These are standalone composable functions that serve different analysis use cases.

Acceptance Criteria

riskPath(graph: TaskGraph): RiskPathResult:
- Calls weightedCriticalPath with weight function riskWeight * impactWeight
- Returns { path: string[], totalRisk: number }
- totalRisk is the sum of weight values along the path
riskDistribution(graph: TaskGraph): RiskDistributionResult:
- Groups all tasks by their risk attribute
- Returns { trivial: string[], low: string[], medium: string[], high: string[], critical: string[], unspecified: string[] }
- Tasks with risk: undefined (not assessed) go in unspecified
- No duplicate task IDs in any bucket
shouldDecomposeTask(attrs: TaskGraphNodeAttributes): DecomposeResult:
- Pure function — takes node attributes (not a graph)
- Internally calls resolveDefaults for risk and scope (nullable fields)
- Flags decomposition when: risk >= "high" OR scope >= "broad"
- Returns { shouldDecompose: boolean, reasons: string[] }
- Unassessed tasks (null/undefined risk or scope) are never flagged — default values are below threshold
- Provides specific reasons: e.g., "risk: high — failure probability 0.35", "scope: broad — cost estimate 4.0"
Unit tests for all three functions with known inputs/outputs

References

docs/architecture/api-surface.md — risk analysis functions
docs/architecture/cost-benefit.md — riskPath, riskDistribution, shouldDecomposeTask, decomposition threshold

Notes

To be filled by implementation agent

Summary

To be filled on completion

2.0 KiB Raw Blame History