pS-usage: captures held by live ReaSampler 9000 instances are un-prunable — instances publish usage_<guid> ext-state records (ComponentState v11), prune unions live holds into referenced

CMakeLists.txt

@@ -337,6 +337,17 @@ target_include_directories(provenance PUBLIC src)
 add_library(assignment_request STATIC src/assignment_request.cpp)
 target_include_directories(assignment_request PUBLIC src)
 
+# ---------------------------------------------------------------------------
+# 2j'') Pure sample_usage library — NO REAPER, NO SWELL, NO VST3. The pS-usage seam:
+#       the per-instance usage record the INSTRUMENT writes ("usage_<guid>" ext-state,
+#       the one sanctioned VST-side write) and the EXTENSION reads at prune time. Owns
+#       the wire round-trip, the publish plan (copy-collision fail-safe resolution),
+#       and the liveness fold (which records count against the live FX enumeration).
+#       Linked by BOTH artifacts — the mirror of assignment_request, reversed direction.
+# ---------------------------------------------------------------------------
+add_library(sample_usage STATIC src/sample_usage.cpp)
+target_include_directories(sample_usage PUBLIC src)
+
 # ---------------------------------------------------------------------------
 # 2l) Pure drag_out library — NO REAPER, NO SWELL, NO OS/OLE. The Milestone 11
 #     native-OS-drag-out decision core: the gesture-boundary decision (drag state +
@@ -708,6 +719,14 @@ add_executable(assignment_request_tests tests/test_assignment_request.cpp)
 target_link_libraries(assignment_request_tests PRIVATE assignment_request)
 add_test(NAME assignment_request_tests COMMAND assignment_request_tests)
 
+# sample_usage (pS-usage): the instance-usage wire + publish plan + liveness fold. The
+# tests are the prune-protection proof at the pure layer: a capture held by a live
+# instance lands in the referenced union and pruneOrphans can never emit it (links
+# prune_reconcile for the composed proof).
+add_executable(sample_usage_tests tests/test_sample_usage.cpp)
+target_link_libraries(sample_usage_tests PRIVATE sample_usage prune_reconcile)
+add_test(NAME sample_usage_tests COMMAND sample_usage_tests)
+
 # sampler_core: the S3 heart. Links ONLY sampler_core (+ its peaks dep) — NEITHER the
 # VST3 SDK nor the REAPER SDK — which is the structural proof of the plain-data
 # boundary (a VST3/REAPER type in the core would fail to compile/link here).
@@ -1016,8 +1035,9 @@ add_library(reaper_reasampler MODULE
     src/tooltip.cpp
     src/card_meta.cpp
     src/card_drag.cpp
+    src/usage_scan.cpp
 )
-target_link_libraries(reaper_reasampler PRIVATE bank_model capture_paths peaks bank_grid mode_switch tab_strip view_mode_model insert_plan render_settings batch_capture tail_control realtime_record bank_book wav_trim owned_manifest prune_reconcile prune_button app_version provenance drag_out instrument_drop theme component_geometry action_bar footer_bar overflow_menu mode_enable tooltip card_meta card_drag assignment_request bank_sync)
+target_link_libraries(reaper_reasampler PRIVATE bank_model capture_paths peaks bank_grid mode_switch tab_strip view_mode_model insert_plan render_settings batch_capture tail_control realtime_record bank_book wav_trim owned_manifest prune_reconcile prune_button app_version provenance drag_out instrument_drop theme component_geometry action_bar footer_bar overflow_menu mode_enable tooltip card_meta card_drag assignment_request bank_sync sample_usage)
 target_include_directories(reaper_reasampler PRIVATE ${SDK_INC} ${WDL_INC})
 # OUTPUT_NAME is channel-derived (Phase V, V4): "reaper_reasampler" (stable, default) or
 # "reaper_reasampler_beta" (beta). REAPER dlopen's any reaper_* module, so both channels'
@@ -1173,11 +1193,13 @@ if(WIN32 AND EXISTS "${VST3_SDK}/public.sdk/source/main/pluginfactory.cpp")
     # knob_deck + curve_popup + master_gain (Wave B FB1, r11): the pure deck layout/hit-test,
     # the curve-popup sheet geometry, and the master-gain taper the recomposed Sample face
     # draws + routes against (master_gain also rides in via sample_map for the v8 wire cap).
+    # sample_usage (pS-usage): the usage-record wire + publish plan the processor's
+    # reloadInstrument publishes through the bridge (the one sanctioned VST-side write).
     target_link_libraries(reasampler_vst PRIVATE vst3_sdk editor_geometry bridge_marshal
         sample_map capture_paths embed_strip app_version capture_browser keyboard_strip
         waveform_view bank_sync browser_scroll note_entry param_slider
         theme component_geometry bank_grid trigger_seam envelope_overlay envelope_edit
-        knob_deck curve_popup master_gain)
+        knob_deck curve_popup master_gain sample_usage)
     # SDK_INC gives reaper_vst3_interfaces.h + reaper_plugin_functions.h for the bridge;
     # WDL_INC gives LICE for the editor. The VST3 SDK headers come from vst3_sdk PUBLIC.
     target_include_directories(reasampler_vst PRIVATE ${SDK_INC} ${WDL_INC})