opencode/decisions.yaml

opencode/decisions.yaml

@@ -156,4 +156,29 @@ notes:
     integrations:
       - octoprint
       - template
+    status: superseded
+    superseded_by: 2026-08-07-octoprint-frozen-sensors-shown-via-idle-2
+  - id: 2026-08-07-octoprint-frozen-sensors-shown-via-idle-2
+    date: 2026-08-07
+    title: OctoPrint frozen sensors shown via idle-zero template helpers
+    decision: "OctoPrint duration sensors freeze when idle. The /printer-stats dashboard uses
+      template helpers (sensor.octoprint_elapsed, sensor.octoprint_time_left) reporting 0
+      while printing is off. Current Z stays on the raw sensor: the nozzle physically
+      remains at its height when idle."
+    rationale: "Elapsed and time-left are durations tied to a running print, so 0 while idle
+      is correct. Current Z is a physical position that persists — zeroing it would
+      falsely claim the nozzle is at the build plate. Helper template: {{ 0 if not
+      is_state('binary_sensor.octoprint_printing','on') else states('<source>')|float }}.
+      An earlier Z helper (octoprint_current_z_2) was created then deleted after this
+      distinction was realized."
+    entities:
+      - sensor.octoprint_elapsed
+      - sensor.octoprint_time_left
+      - binary_sensor.octoprint_printing
+      - sensor.octoprint_print_time
+      - sensor.octoprint_print_time_left
+      - sensor.octoprint_current_z
+    integrations:
+      - octoprint
+      - template
     status: active