nessar/vac-optimizer
1
0 Fork 0
Code Issues 7 Pull Requests 4 Actions Packages Projects 1 Releases Wiki Activity

feat(docs): add explanation for separating plan explanations from calculation traces

Browse Source
This commit is contained in:
nessar committed 2026-08-31 21:21:37 +02:00
1 parent 609b3dece9
commit e7e0f210e9
2 files changed
+29
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/adr/0004-separate-plan-explanation-from-calculation-trace.md
+3
View File
@@ -0,0 +1,3 @@
# Separate Plan Explanations from Calculation Traces
VacOptimizer provides a stable plan explanation separately from the complete, untruncated calculation trace captured during the same planning run; on-demand counterfactual date analysis is identified as hypothetical and never presented as trace history. Explanation and tracing must not alter the planning outcome, so trace instrumentation is excluded from the planner deadline and the result may appear before the latest run's in-memory trace finishes loading; this narrows ADR 0003's ten-second hard limit to planning work rather than end-to-end trace delivery. This accepts additional transient memory and wall-clock time instead of inventing scalar day scores, truncating history, or reconstructing a trace by replay.