Risk Register

The risk register tracks the highest-impact technical and operational risks for bijux-cli and the expected mitigation path.

Visual Summary

flowchart LR
    routing["routing drift risk"] --> mitigation1["parser and routing law tests"]
    plugins["plugin lifecycle risk"] --> mitigation2["plugin diagnostics and integration checks"]
    persistence["state corruption risk"] --> mitigation3["state diagnostics and recovery workflow"]
    docs["documentation drift risk"] --> mitigation4["docs gates and checklist enforcement"]

Active Risks

• route and alias drift causing script regressions
• plugin compatibility handling regressions during lifecycle updates
• state-file mutation regressions causing config/history corruption
• documentation drift from command behavior after fast refactors

Mitigations

• maintain routing laws and golden command-surface tests
• keep plugin lifecycle integration contracts in regular validation loops
• require diagnostics and recovery checks for state write-path changes
• enforce docs shape and review checklist gates for contract changes

Code Anchors

• crates/bijux-cli/src/routing/
• crates/bijux-cli/src/features/plugins/
• crates/bijux-cli/src/features/config/
• crates/bijux-cli/tests/
• docs/bijux-cli/

Next Reads

• Architecture Risks
• Change Validation
• Failure Recovery