Screen
diff --git a/docs/omarchy-window-rule.md b/docs/omarchy-window-rule.md
new file mode 100644
index 0000000..2b38bf1
--- /dev/null
+++ b/docs/omarchy-window-rule.md
@@ -0,0 +1,9 @@
+# Full opacity on Hyprland
+
+Omarchy makes ordinary windows slightly translucent, which can blend the wallpaper into OmaMovie's viewer. OmaMovie's window class (Wayland app ID) is `omamovie`. To keep the editor opaque, add this rule to `~/.config/hypr/windows.lua`:
+
+```lua
+o.window("^omamovie$", { tag = "-default-opacity", opacity = "1 1" })
+```
+
+The package does not install this rule. It uses the Lua window-rule syntax of current Omarchy; older Hyprland configurations need their own syntax. Full opacity stops wallpaper blending but does not calibrate the display.
diff --git a/Docs/project-analysis-2026-10-04-architecture.md b/docs/project-analysis-2026-10-04-architecture.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04-architecture.md
rename to docs/project-analysis-2026-10-04-architecture.md
diff --git a/Docs/project-analysis-2026-10-04-decision.md b/docs/project-analysis-2026-10-04-decision.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04-decision.md
rename to docs/project-analysis-2026-10-04-decision.md
diff --git a/Docs/project-analysis-2026-10-04-model.md b/docs/project-analysis-2026-10-04-model.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04-model.md
rename to docs/project-analysis-2026-10-04-model.md
diff --git a/Docs/project-analysis-2026-10-04-priorities.md b/docs/project-analysis-2026-10-04-priorities.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04-priorities.md
rename to docs/project-analysis-2026-10-04-priorities.md
diff --git a/Docs/project-analysis-2026-10-04-scaling.md b/docs/project-analysis-2026-10-04-scaling.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04-scaling.md
rename to docs/project-analysis-2026-10-04-scaling.md
diff --git a/Docs/project-analysis-2026-10-04.md b/docs/project-analysis-2026-10-04.md
similarity index 100%
rename from Docs/project-analysis-2026-10-04.md
rename to docs/project-analysis-2026-10-04.md
diff --git a/Docs/project-analysis-2026-10-07.md b/docs/project-analysis-2026-10-07.md
similarity index 100%
rename from Docs/project-analysis-2026-10-07.md
rename to docs/project-analysis-2026-10-07.md
diff --git a/Docs/releases/v0.1.0-rc.1.md b/docs/releases/v0.1.0-rc.1.md
similarity index 100%
rename from Docs/releases/v0.1.0-rc.1.md
rename to docs/releases/v0.1.0-rc.1.md
diff --git a/Docs/spikes/S1-findings.md b/docs/spikes/S1-findings.md
similarity index 100%
rename from Docs/spikes/S1-findings.md
rename to docs/spikes/S1-findings.md
diff --git a/Docs/spikes/S1-hardware-inventory.md b/docs/spikes/S1-hardware-inventory.md
similarity index 97%
rename from Docs/spikes/S1-hardware-inventory.md
rename to docs/spikes/S1-hardware-inventory.md
index 332e461..0a781de 100644
--- a/Docs/spikes/S1-hardware-inventory.md
+++ b/docs/spikes/S1-hardware-inventory.md
@@ -1,7 +1,7 @@
# S1 — Hardware inventory (Intel Iris Xe, TigerLake)
- **Date:** 2026-10-03
-- **Milestone:** M1 (`Docs/implementation-plan.md`)
+- **Milestone:** M1 (`docs/implementation-plan.md`)
- **Feeds:** ADR-0004 (GPU frame, synchronization, decode policy)
- **Reproduce:** `tools/spikes/s1-inventory.sh [output-dir]`
diff --git a/Docs/spikes/S1-results.md b/docs/spikes/S1-results.md
similarity index 100%
rename from Docs/spikes/S1-results.md
rename to docs/spikes/S1-results.md
diff --git a/Docs/spikes/S2-consequences.md b/docs/spikes/S2-consequences.md
similarity index 100%
rename from Docs/spikes/S2-consequences.md
rename to docs/spikes/S2-consequences.md
diff --git a/Docs/spikes/S2-ffmpeg-own-device.md b/docs/spikes/S2-ffmpeg-own-device.md
similarity index 98%
rename from Docs/spikes/S2-ffmpeg-own-device.md
rename to docs/spikes/S2-ffmpeg-own-device.md
index d0239a6..1c13582 100644
--- a/Docs/spikes/S2-ffmpeg-own-device.md
+++ b/docs/spikes/S2-ffmpeg-own-device.md
@@ -1,7 +1,7 @@
# S2 — FFmpeg decoding on a VkDevice created by OmaMovie
- **Date:** 2026-10-03
-- **Milestone:** M1 (`Docs/implementation-plan.md`)
+- **Milestone:** M1 (`docs/implementation-plan.md`)
- **Feeds:** ADR-0004 (GPU frame, synchronization, decode policy), ADR-0005 (Qt Quick ↔ compositor)
- **Code:** `tools/spikes/s2_ffmpeg_own_device.cpp` (`make spikes`)
- **Run:** `build/debug/spikes/s2_ffmpeg_own_device
[--mode vaapi|vulkan] [--frames N]`
diff --git a/Docs/spikes/S2-results.md b/docs/spikes/S2-results.md
similarity index 100%
rename from Docs/spikes/S2-results.md
rename to docs/spikes/S2-results.md
diff --git a/Docs/spikes/S3-decode-paths.md b/docs/spikes/S3-decode-paths.md
similarity index 96%
rename from Docs/spikes/S3-decode-paths.md
rename to docs/spikes/S3-decode-paths.md
index 86aba29..3b4c384 100644
--- a/Docs/spikes/S3-decode-paths.md
+++ b/docs/spikes/S3-decode-paths.md
@@ -1,7 +1,7 @@
# S3 — Decode paths and proxy intermediates (Intel Iris Xe, TigerLake)
- **Date:** 2026-10-04
-- **Milestone:** M1 (`Docs/implementation-plan.md`)
+- **Milestone:** M1 (`docs/implementation-plan.md`)
- **Feeds:** ADR-0004 (decode policy), ADR-0009 (cache/proxies), M8 proxies
- **Reproduce:** `tools/spikes/s3-decode-paths.sh [output-dir]` (`RUNS`, `SECS`)
- **Raw output:** [2026-10-04-s3-decode-paths.txt](../Research/evidence/2026-10-04-s3-decode-paths.txt)
diff --git a/Docs/spikes/S3-findings.md b/docs/spikes/S3-findings.md
similarity index 100%
rename from Docs/spikes/S3-findings.md
rename to docs/spikes/S3-findings.md
diff --git a/Docs/spikes/S3-results.md b/docs/spikes/S3-results.md
similarity index 100%
rename from Docs/spikes/S3-results.md
rename to docs/spikes/S3-results.md
diff --git a/Docs/spikes/S4-qt-shared-device.md b/docs/spikes/S4-qt-shared-device.md
similarity index 100%
rename from Docs/spikes/S4-qt-shared-device.md
rename to docs/spikes/S4-qt-shared-device.md
diff --git a/Docs/spikes/S4-viewer-handoff.md b/docs/spikes/S4-viewer-handoff.md
similarity index 100%
rename from Docs/spikes/S4-viewer-handoff.md
rename to docs/spikes/S4-viewer-handoff.md
diff --git a/Docs/spikes/S5-findings.md b/docs/spikes/S5-findings.md
similarity index 100%
rename from Docs/spikes/S5-findings.md
rename to docs/spikes/S5-findings.md
diff --git a/Docs/spikes/S5-minimal-compositing.md b/docs/spikes/S5-minimal-compositing.md
similarity index 97%
rename from Docs/spikes/S5-minimal-compositing.md
rename to docs/spikes/S5-minimal-compositing.md
index ad0a726..6a6412d 100644
--- a/Docs/spikes/S5-minimal-compositing.md
+++ b/docs/spikes/S5-minimal-compositing.md
@@ -1,7 +1,7 @@
# S5 — Minimal compositing on library code (Intel Iris Xe, TigerLake)
- **Date:** 2026-10-04
-- **Milestone:** M1 (`Docs/implementation-plan.md`), feeds M3/M4
+- **Milestone:** M1 (`docs/implementation-plan.md`), feeds M3/M4
- **Reproduce:** `make BUILD=release build/release/spikes/s5_minimal_compositing`, then
`build/release/spikes/s5_minimal_compositing software|hardware [frames]`
- **Raw output:** [2026-10-04-s5-minimal-compositing.txt](../Research/evidence/2026-10-04-s5-minimal-compositing.txt)
diff --git a/Docs/spikes/S6-findings.md b/docs/spikes/S6-findings.md
similarity index 100%
rename from Docs/spikes/S6-findings.md
rename to docs/spikes/S6-findings.md
diff --git a/Docs/spikes/S6-libplacebo.md b/docs/spikes/S6-libplacebo.md
similarity index 98%
rename from Docs/spikes/S6-libplacebo.md
rename to docs/spikes/S6-libplacebo.md
index 02228fe..11d4ea4 100644
--- a/Docs/spikes/S6-libplacebo.md
+++ b/docs/spikes/S6-libplacebo.md
@@ -1,7 +1,7 @@
# S6 — libplacebo on OmaMovie's device and images (Intel Iris Xe, TigerLake)
- **Date:** 2026-10-04
-- **Milestone:** M1 (`Docs/implementation-plan.md`)
+- **Milestone:** M1 (`docs/implementation-plan.md`)
- **Feeds:** [ADR-0006](../adr/0006-color-space-and-libplacebo.md)
- **Reproduce:** `make BUILD=release build/release/spikes/s6_libplacebo`, then
`build/release/spikes/s6_libplacebo <1080p-video>` (input: `h264.mp4` from
diff --git a/Docs/spikes/professional-workload.md b/docs/spikes/professional-workload.md
similarity index 100%
rename from Docs/spikes/professional-workload.md
rename to docs/spikes/professional-workload.md
diff --git a/Docs/spikes/session-stress.md b/docs/spikes/session-stress.md
similarity index 100%
rename from Docs/spikes/session-stress.md
rename to docs/spikes/session-stress.md
diff --git a/Docs/ui-design-1.md b/docs/ui-design-1.md
similarity index 100%
rename from Docs/ui-design-1.md
rename to docs/ui-design-1.md
diff --git a/Docs/ui-design-10.md b/docs/ui-design-10.md
similarity index 100%
rename from Docs/ui-design-10.md
rename to docs/ui-design-10.md
diff --git a/Docs/ui-design-11.md b/docs/ui-design-11.md
similarity index 100%
rename from Docs/ui-design-11.md
rename to docs/ui-design-11.md
diff --git a/Docs/ui-design-12.md b/docs/ui-design-12.md
similarity index 100%
rename from Docs/ui-design-12.md
rename to docs/ui-design-12.md
diff --git a/Docs/ui-design-13.md b/docs/ui-design-13.md
similarity index 74%
rename from Docs/ui-design-13.md
rename to docs/ui-design-13.md
index fa9010a..0c24928 100644
--- a/Docs/ui-design-13.md
+++ b/docs/ui-design-13.md
@@ -1,6 +1,6 @@
## 13. Next step
-Interactive mockup (HTML, fictitious data): `Docs/mockups/ui-mockup.html`.
+Interactive mockup (HTML, fictitious data): `docs/mockups/ui-mockup.html`.
Next, a QML prototype within M6, with fake data, to validate sizes, density and the
half-width behavior before wiring the engine.
diff --git a/Docs/ui-design-2-1.md b/docs/ui-design-2-1.md
similarity index 100%
rename from Docs/ui-design-2-1.md
rename to docs/ui-design-2-1.md
diff --git a/Docs/ui-design-2-2.md b/docs/ui-design-2-2.md
similarity index 100%
rename from Docs/ui-design-2-2.md
rename to docs/ui-design-2-2.md
diff --git a/Docs/ui-design-3.md b/docs/ui-design-3.md
similarity index 100%
rename from Docs/ui-design-3.md
rename to docs/ui-design-3.md
diff --git a/Docs/ui-design-4.md b/docs/ui-design-4.md
similarity index 100%
rename from Docs/ui-design-4.md
rename to docs/ui-design-4.md
diff --git a/Docs/ui-design-5.md b/docs/ui-design-5.md
similarity index 100%
rename from Docs/ui-design-5.md
rename to docs/ui-design-5.md
diff --git a/Docs/ui-design-6.md b/docs/ui-design-6.md
similarity index 100%
rename from Docs/ui-design-6.md
rename to docs/ui-design-6.md
diff --git a/Docs/ui-design-7.md b/docs/ui-design-7.md
similarity index 100%
rename from Docs/ui-design-7.md
rename to docs/ui-design-7.md
diff --git a/Docs/ui-design-8-1.md b/docs/ui-design-8-1.md
similarity index 100%
rename from Docs/ui-design-8-1.md
rename to docs/ui-design-8-1.md
diff --git a/Docs/ui-design-8-2.md b/docs/ui-design-8-2.md
similarity index 100%
rename from Docs/ui-design-8-2.md
rename to docs/ui-design-8-2.md
diff --git a/Docs/ui-design-9.md b/docs/ui-design-9.md
similarity index 100%
rename from Docs/ui-design-9.md
rename to docs/ui-design-9.md
diff --git a/Docs/ui-design-context-1.md b/docs/ui-design-context-1.md
similarity index 97%
rename from Docs/ui-design-context-1.md
rename to docs/ui-design-context-1.md
index aa07a3e..1611ca1 100644
--- a/Docs/ui-design-context-1.md
+++ b/docs/ui-design-context-1.md
@@ -3,7 +3,7 @@
The [2026-10-10 UI/UX evaluation](ui-ux-evaluation-2026-10-10.md) records the current
implementation, interaction checks and remaining gates against the product direction.
-> Product choices from 2026-10-02; evidence reviewed on 2026-10-03, with the decisions in §12. Based on `Docs/Research/imovie.md`
+> Product choices from 2026-10-02; evidence reviewed on 2026-10-03, with the decisions in §12. Based on `docs/Research/imovie.md`
> (principles), `movie-maker.md`, `capcut.md`, `davinci-resolve.md` and
> `omarchy-integration.md`. Implementation rules remain in `CLAUDE.md` §11.
>
diff --git a/Docs/ui-design-context-2.md b/docs/ui-design-context-2.md
similarity index 100%
rename from Docs/ui-design-context-2.md
rename to docs/ui-design-context-2.md
diff --git a/Docs/ui-design-context-3.md b/docs/ui-design-context-3.md
similarity index 100%
rename from Docs/ui-design-context-3.md
rename to docs/ui-design-context-3.md
diff --git a/Docs/ui-design.md b/docs/ui-design.md
similarity index 100%
rename from Docs/ui-design.md
rename to docs/ui-design.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10-context.md b/docs/ui-ux-evaluation-2026-10-10-context.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10-context.md
rename to docs/ui-ux-evaluation-2026-10-10-context.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10-gates.md b/docs/ui-ux-evaluation-2026-10-10-gates.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10-gates.md
rename to docs/ui-ux-evaluation-2026-10-10-gates.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10-interactions.md b/docs/ui-ux-evaluation-2026-10-10-interactions.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10-interactions.md
rename to docs/ui-ux-evaluation-2026-10-10-interactions.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10-resize.md b/docs/ui-ux-evaluation-2026-10-10-resize.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10-resize.md
rename to docs/ui-ux-evaluation-2026-10-10-resize.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10-verification.md b/docs/ui-ux-evaluation-2026-10-10-verification.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10-verification.md
rename to docs/ui-ux-evaluation-2026-10-10-verification.md
diff --git a/Docs/ui-ux-evaluation-2026-10-10.md b/docs/ui-ux-evaluation-2026-10-10.md
similarity index 100%
rename from Docs/ui-ux-evaluation-2026-10-10.md
rename to docs/ui-ux-evaluation-2026-10-10.md
diff --git a/Docs/ui-ux-tddo.md b/docs/ui-ux-tddo.md
similarity index 100%
rename from Docs/ui-ux-tddo.md
rename to docs/ui-ux-tddo.md
diff --git a/libs/compositor/src/look.hpp b/libs/compositor/src/look.hpp
index ddfbf99..1496d59 100644
--- a/libs/compositor/src/look.hpp
+++ b/libs/compositor/src/look.hpp
@@ -38,7 +38,7 @@ struct Look {
// `factor` (a factor x factor box average per texel), then a separable gaussian runs across and
// down on the reduced image, its taps clamped to it; the composite reads it back bilinearly.
// The gaussian's sigma shrinks with the factor, so the cost no longer grows with the blur radius
-// (Docs/Research/gpu-effects.md). Blur shows the blurred image; sharpen adds
+// (docs/Research/gpu-effects.md). Blur shows the blurred image; sharpen adds
// amount * (original - blurred).
// The factor is at least the source pixels per output pixel (a 2160p source shown at 1080p
// blurs at 1080p), else the reduced sigma stays below 2 * kReducedSigma, so 3 sigma fits the
diff --git a/libs/gpu/include/oma/gpu/device.hpp b/libs/gpu/include/oma/gpu/device.hpp
index cdd3d80..a3da66b 100644
--- a/libs/gpu/include/oma/gpu/device.hpp
+++ b/libs/gpu/include/oma/gpu/device.hpp
@@ -13,7 +13,7 @@
#include
#include
-// OmaMovie's Vulkan device (CLAUDE.md §5.1, §7; Docs/spikes/S2-ffmpeg-own-device.md).
+// OmaMovie's Vulkan device (CLAUDE.md §5.1, §7; docs/spikes/S2-ffmpeg-own-device.md).
//
// libs/gpu owns the single VkInstance/VkDevice of the process. FFmpeg (libs/media), the
// compositor and Qt Quick receive its raw handles; they never create their own device. The
diff --git a/libs/gpu/src/device.cpp b/libs/gpu/src/device.cpp
index 594521a..7121efb 100644
--- a/libs/gpu/src/device.cpp
+++ b/libs/gpu/src/device.cpp
@@ -2,7 +2,7 @@
#include "oma/base/log.hpp"
-// Vulkan-Hpp without exceptions, returning std::expected (Docs/spikes/S2-ffmpeg-own-device.md):
+// Vulkan-Hpp without exceptions, returning std::expected (docs/spikes/S2-ffmpeg-own-device.md):
// must come first and VULKAN_HPP_USE_STD_EXPECTED must be defined.
#include
#define VULKAN_HPP_NO_EXCEPTIONS
@@ -41,7 +41,7 @@ Error vk_error(vk::Result r, std::string what) {
}
// Extensions OmaMovie enables when the device has them. Interop and synchronization come first;
-// video extensions are only present on drivers that expose Vulkan Video (Docs/spikes/S1-*.md).
+// video extensions are only present on drivers that expose Vulkan Video (docs/spikes/S1-*.md).
constexpr std::array kFeaturelessExtensions = {
VK_KHR_EXTERNAL_MEMORY_FD_EXTENSION_NAME,
VK_EXT_EXTERNAL_MEMORY_DMA_BUF_EXTENSION_NAME,
diff --git a/libs/importers/include/oma/importers/edl.hpp b/libs/importers/include/oma/importers/edl.hpp
index 74b926b..1b1a0c8 100644
--- a/libs/importers/include/oma/importers/edl.hpp
+++ b/libs/importers/include/oma/importers/edl.hpp
@@ -4,7 +4,7 @@
// Premiere, Avid and others export. Read: TITLE and FCM headers, event lines (cut `C` and
// dissolve `D` on V, A, A2…, AA, B), `* FROM CLIP NAME:` and `* SOURCE FILE:` comments. Wipes,
// keys, motion (`M2`) lines and unknown comments are kept as opaque IR objects and reported.
-// Docs/interop.md has the support level; Docs/formats/edl.md the format notes.
+// docs/interop.md has the support level; docs/formats/edl.md the format notes.
#include "oma/base/error.hpp"
#include "oma/importers/otio.hpp"
diff --git a/libs/importers/include/oma/importers/fcpxml.hpp b/libs/importers/include/oma/importers/fcpxml.hpp
index 670d18a..51442fa 100644
--- a/libs/importers/include/oma/importers/fcpxml.hpp
+++ b/libs/importers/include/oma/importers/fcpxml.hpp
@@ -5,7 +5,7 @@
// 1.8, `media-rep` from 1.9) with their start and duration, the first sequence's spine
// (`asset-clip`, `clip`, `gap`, `transition`) and connected clips (`lane`) as further tracks.
// Titles, generators, effects and other projects are kept as opaque objects and reported.
-// Docs/formats/fcpxml.md has the format notes; Docs/interop.md the support level.
+// docs/formats/fcpxml.md has the format notes; docs/interop.md the support level.
#include "oma/base/error.hpp"
#include "oma/importers/otio.hpp"
diff --git a/libs/importers/include/oma/importers/mlt.hpp b/libs/importers/include/oma/importers/mlt.hpp
index 3cb318f..be4b10d 100644
--- a/libs/importers/include/oma/importers/mlt.hpp
+++ b/libs/importers/include/oma/importers/mlt.hpp
@@ -5,7 +5,7 @@
// (resource, in point, length), playlists of entries and blanks, the main (last) tractor's tracks,
// and melt's mixes (a nested tractor of two producers with a luma/mix transition) as dissolves.
// Filters, cross-track transitions and generators (colour, black) are kept as opaque objects and
-// reported. Docs/formats/mlt.md has the format notes; Docs/interop.md the support level.
+// reported. docs/formats/mlt.md has the format notes; docs/interop.md the support level.
#include "oma/base/error.hpp"
#include "oma/importers/otio.hpp"
diff --git a/libs/importers/include/oma/importers/otio.hpp b/libs/importers/include/oma/importers/otio.hpp
index 1b7e076..be8a8ad 100644
--- a/libs/importers/include/oma/importers/otio.hpp
+++ b/libs/importers/include/oma/importers/otio.hpp
@@ -4,7 +4,7 @@
// the schemas (Timeline.1, Stack.1, Track.1, Clip.1/2, Gap.1, Transition.1, ExternalReference.1,
// MissingReference.1, RationalTime.1, TimeRange.1). Other objects are kept as opaque IR objects
// and reported. OTIO stores times as floating-point rates and values: exact NTSC rates are
-// recognized, any other rounding is reported as a loss. Docs/interop.md has the support level.
+// recognized, any other rounding is reported as a loss. docs/interop.md has the support level.
#include "oma/base/error.hpp"
#include "oma/project_ir/ir.hpp"
diff --git a/libs/media/include/oma/media/video_frame.hpp b/libs/media/include/oma/media/video_frame.hpp
index fff12e0..0d0af62 100644
--- a/libs/media/include/oma/media/video_frame.hpp
+++ b/libs/media/include/oma/media/video_frame.hpp
@@ -15,7 +15,7 @@
namespace oma::media {
-// How a frame was decoded (Docs/spikes/S1-*.md, S2-*.md). Hardware paths deliver Vulkan images
+// How a frame was decoded (docs/spikes/S1-*.md, S2-*.md). Hardware paths deliver Vulkan images
// on OmaMovie's device without a CPU copy; software is the correctness reference and fallback.
enum class DecodePath : std::uint8_t {
Software,
diff --git a/libs/media/src/vulkan_device.hpp b/libs/media/src/vulkan_device.hpp
index 00c3354..1431312 100644
--- a/libs/media/src/vulkan_device.hpp
+++ b/libs/media/src/vulkan_device.hpp
@@ -11,7 +11,7 @@ class Device;
namespace oma::media::ff {
// Wraps OmaMovie's VkDevice in an FFmpeg AVHWDeviceContext so FFmpeg decodes, maps and allocates
-// on it instead of creating its own device (Docs/spikes/S2-ffmpeg-own-device.md). The Device
+// on it instead of creating its own device (docs/spikes/S2-ffmpeg-own-device.md). The Device
// must outlive the returned reference and everything derived from it.
[[nodiscard]] Result wrap_vulkan_device(const gpu::Device& device);
diff --git a/libs/project-ir/include/oma/project_ir/report.hpp b/libs/project-ir/include/oma/project_ir/report.hpp
index 3b49a5e..1b66a7d 100644
--- a/libs/project-ir/include/oma/project_ir/report.hpp
+++ b/libs/project-ir/include/oma/project_ir/report.hpp
@@ -9,7 +9,7 @@
namespace oma::ir {
-// Support levels (CLAUDE.md §16.5), declared per format and version in Docs/interop.md.
+// Support levels (CLAUDE.md §16.5), declared per format and version in docs/interop.md.
enum class SupportLevel : std::uint8_t {
Recognized = 0, // file recognized and version identified
Media = 1, // referenced media and clips
diff --git a/scripts/changelog.sh b/scripts/changelog.sh
index c329ddf..147ed63 100755
--- a/scripts/changelog.sh
+++ b/scripts/changelog.sh
@@ -8,8 +8,8 @@ tag="${1:?usage: scripts/changelog.sh }"
previous="$(git describe --tags --abbrev=0 "${tag}^" 2>/dev/null || true)"
# The first release has no previous tag. Use its reviewed product notes instead of
# publishing the entire development history as hundreds of commit subjects.
-if [[ -z $previous && -f Docs/releases/$tag.md ]]; then
- cat "Docs/releases/$tag.md"
+if [[ -z $previous && -f docs/releases/$tag.md ]]; then
+ cat "docs/releases/$tag.md"
exit 0
fi
range="${previous:+$previous..}$tag"
diff --git a/scripts/m6-task-media.sh b/scripts/m6-task-media.sh
index 6865236..e15bd63 100755
--- a/scripts/m6-task-media.sh
+++ b/scripts/m6-task-media.sh
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
-# Generates the media for the M6 manual task sessions (Docs/m6-walkthrough.md) into a folder
+# Generates the media for the M6 manual task sessions (docs/m6-walkthrough.md) into a folder
# outside the repository. Everything comes from lavfi: no copyrighted media.
# Usage: scripts/m6-task-media.sh [directory] (default: $XDG_VIDEOS_DIR or ~/Videos/omamovie-m6)
set -euo pipefail
diff --git a/tests/app/test_sustained.cpp b/tests/app/test_sustained.cpp
index 4e75ffc..0acfdf1 100644
--- a/tests/app/test_sustained.cpp
+++ b/tests/app/test_sustained.cpp
@@ -10,9 +10,12 @@
#include
#include
+#include
+#include
#include
#include
#include
+#include
#include "oma_test.hpp"
@@ -75,10 +78,13 @@ bool cycles_hold_their_resources() {
return false;
const int kCycles = qEnvironmentVariableIntValue("OMA_SUSTAINED_CYCLES") > 0
? qEnvironmentVariableIntValue("OMA_SUSTAINED_CYCLES")
- : 8;
- constexpr int kWarm = 2; // caches, thread pools and the driver settle in the first cycles
+ : 16;
+ constexpr int kFdWarm = 2;
+ // The measured Mesa/FFmpeg pools can settle around cycle nine; begin the RSS bound there,
+ // then watch seven more cycles for continuing growth. FDs should settle much sooner.
+ constexpr int kRssWarm = 9;
long fds = 0;
- long rss = 0;
+ std::vector rss_after_warm;
for (int n = 0; n < kCycles; ++n) {
if (!cycle(dir, n))
return false;
@@ -86,13 +92,27 @@ bool cycles_hold_their_resources() {
const long f = open_fds();
const long r = rss_kib();
std::printf(" cycle %d: %ld fds, %ld KiB resident\n", n, f, r);
- if (n == kWarm - 1) {
+ if (n == kFdWarm - 1) {
fds = f;
- rss = r;
- } else if (n >= kWarm && (f > fds || (kRssMeaningful && r > rss + (64 * 1024)))) {
+ }
+ if (n >= kRssWarm - 1)
+ rss_after_warm.push_back(r);
+ if (n >= kFdWarm && f > fds) {
return false;
}
}
+ // The software Vulkan driver's allocator can release tens of MiB between adjacent cycles.
+ // Compare windows instead of treating one RSS spike as sustained growth.
+ if (kRssMeaningful && rss_after_warm.size() >= 6) {
+ std::array first{rss_after_warm[0], rss_after_warm[1], rss_after_warm[2]};
+ const std::size_t end = rss_after_warm.size();
+ std::array last{rss_after_warm[end - 3], rss_after_warm[end - 2],
+ rss_after_warm[end - 1]};
+ std::sort(first.begin(), first.end());
+ std::sort(last.begin(), last.end());
+ if (last[1] > first[1] + (64 * 1024))
+ return false;
+ }
return true;
}
} // namespace
diff --git a/tests/project/test_edit_round_trip.cpp b/tests/project/test_edit_round_trip.cpp
index 054ac1e..44d7f74 100644
--- a/tests/project/test_edit_round_trip.cpp
+++ b/tests/project/test_edit_round_trip.cpp
@@ -1,6 +1,6 @@
// Every state the edit properties generate (tests/timeline/property_*.cpp, M10) saves and
// reloads unchanged: the project format is checked against the test-only canonical state, not
-// used as its own oracle (Docs/implementation-plan-qa-timeline.md).
+// used as its own oracle (docs/implementation-plan-qa-timeline.md).
#include "oma/project/document.hpp"
#include "property_checker.hpp"
#include "property_gen.hpp"
diff --git a/tests/support/lsan.supp b/tests/support/lsan.supp
index 6ebacd0..87b0254 100644
--- a/tests/support/lsan.supp
+++ b/tests/support/lsan.supp
@@ -10,7 +10,7 @@ leak:libLLVM
# FFmpeg 9.0.1: mapping VA-API frames into Vulkan (av_hwframe_map, direct or through DRM) leaves a
# reference cycle that keeps the VA-API device, its surface pool and the derived Vulkan frames
# context alive (~200 KB per decoder, constant per session). Reproduced with plain FFmpeg and an
-# FFmpeg-created Vulkan device, no OmaMovie code involved (Docs/spikes/S2-ffmpeg-own-device.md).
+# FFmpeg-created Vulkan device, no OmaMovie code involved (docs/spikes/S2-ffmpeg-own-device.md).
# Only reachable on machines with VA-API (not in CI). Remove once FFmpeg fixes the cycle.
leak:av_hwframe_map
leak:av_hwframe_ctx_create_derived
diff --git a/tests/timeline/property_checker.hpp b/tests/timeline/property_checker.hpp
index faa710f..99120ba 100644
--- a/tests/timeline/property_checker.hpp
+++ b/tests/timeline/property_checker.hpp
@@ -1,7 +1,7 @@
#pragma once
// Applies property steps to the shared fixture and checks each one
-// (Docs/implementation-plan-qa-timeline.md). It keeps the expected history: the canonical
+// (docs/implementation-plan-qa-timeline.md). It keeps the expected history: the canonical
// states an undo must return to and the ones a redo must bring back.
#include "fixture.hpp"
diff --git a/tests/timeline/property_invariants.hpp b/tests/timeline/property_invariants.hpp
index 6b52a3b..ec7446e 100644
--- a/tests/timeline/property_invariants.hpp
+++ b/tests/timeline/property_invariants.hpp
@@ -1,7 +1,7 @@
#pragma once
// Invariants checked after every successful step, written apart from Timeline::validate() so
-// they are an independent oracle (Docs/implementation-plan-qa-timeline.md). Each returns an
+// they are an independent oracle (docs/implementation-plan-qa-timeline.md). Each returns an
// empty string when the state holds, or what broke.
#include "oma/timeline/model.hpp"
diff --git a/tests/timeline/property_ops.hpp b/tests/timeline/property_ops.hpp
index ec1e243..4e26bd5 100644
--- a/tests/timeline/property_ops.hpp
+++ b/tests/timeline/property_ops.hpp
@@ -1,6 +1,6 @@
#pragma once
-// Stateful edit properties (M10, Docs/implementation-plan-qa-timeline.md): one generated step. It
+// Stateful edit properties (M10, docs/implementation-plan-qa-timeline.md): one generated step. It
// names clips by position, not ID, so a shrunk log still replays; an empty position is rejected.
#include "oma/timeline/editor.hpp"
diff --git a/tests/timeline/property_run.hpp b/tests/timeline/property_run.hpp
index f4bac1b..b232303 100644
--- a/tests/timeline/property_run.hpp
+++ b/tests/timeline/property_run.hpp
@@ -1,7 +1,7 @@
#pragma once
// Seeded runs, exact replay and shrinking for the edit properties
-// (Docs/implementation-plan-qa-timeline.md). A run's log replays with no random choices.
+// (docs/implementation-plan-qa-timeline.md). A run's log replays with no random choices.
#include "property_checker.hpp"
diff --git a/tests/timeline/property_state.hpp b/tests/timeline/property_state.hpp
index 1f73fc5..70cf06b 100644
--- a/tests/timeline/property_state.hpp
+++ b/tests/timeline/property_state.hpp
@@ -1,6 +1,6 @@
#pragma once
-// The test-only canonical state of a timeline (Docs/implementation-plan-qa-timeline.md): every
+// The test-only canonical state of a timeline (docs/implementation-plan-qa-timeline.md): every
// persisted edit field, exact times with their timebases, and nothing transient. Independent of
// the project format, which round trips are checked against separately.
diff --git a/tests/timeline/test_properties.cpp b/tests/timeline/test_properties.cpp
index 3478d2c..2dbb424 100644
--- a/tests/timeline/test_properties.cpp
+++ b/tests/timeline/test_properties.cpp
@@ -1,5 +1,5 @@
// Stateful edit properties (M10): seeded command streams over the shared fixture, checked after
-// every step and through a full undo/redo (Docs/implementation-plan-qa-timeline.md).
+// every step and through a full undo/redo (docs/implementation-plan-qa-timeline.md).
#include "fixture.hpp"
#include "property_invariants.hpp"
#include "property_run.hpp"
diff --git a/tools/bench/cross-editor/run.sh b/tools/bench/cross-editor/run.sh
index e29ac53..e40b456 100755
--- a/tools/bench/cross-editor/run.sh
+++ b/tools/bench/cross-editor/run.sh
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
# Same-machine export comparison of OmaMovie and MLT's melt (Kdenlive's engine): one scene of a
# BT.709 source through hardware and software H.264, every output checked by FFmpeg (protocol:
-# Docs/implementation-plan-cross-editor-benchmarks.md). Opens OmaMovie's window; run it idle.
+# docs/implementation-plan-cross-editor-benchmarks.md). Opens OmaMovie's window; run it idle.
# Usage: tools/bench/cross-editor/run.sh [repeats=5] [report-dir] [scene=whole|cuts] (scenes.sh)
set -euo pipefail
diff --git a/tools/bench/filmcraft-equivalent/spikes.sh b/tools/bench/filmcraft-equivalent/spikes.sh
index 799debc..2a86314 100644
--- a/tools/bench/filmcraft-equivalent/spikes.sh
+++ b/tools/bench/filmcraft-equivalent/spikes.sh
@@ -1,4 +1,4 @@
-# The M1 hardware spikes (Docs/spikes/), rerun to see whether drivers or code moved them.
+# The M1 hardware spikes (docs/spikes/), rerun to see whether drivers or code moved them.
# Sourced by run.sh ($repo, $spikes set there). The report gets each spike's summary; the full
# output goes to /spikes/.log. Test media the scripts generate is deleted.
diff --git a/tools/spikes/CMakeLists.txt b/tools/spikes/CMakeLists.txt
index 2fa44a2..c66754d 100644
--- a/tools/spikes/CMakeLists.txt
+++ b/tools/spikes/CMakeLists.txt
@@ -1,4 +1,4 @@
-# Disposable M1 spikes (Docs/spikes/). Opt-in: cmake --preset spikes. They need the Vulkan,
+# Disposable M1 spikes (docs/spikes/). Opt-in: cmake --preset spikes. They need the Vulkan,
# FFmpeg, libplacebo and Qt development files; the shell scripts (s1, s3) are not built.
pkg_check_modules(SPIKE_AV REQUIRED libavformat libavcodec libavutil)
diff --git a/tools/spikes/professional_workload.cpp b/tools/spikes/professional_workload.cpp
index bf6f89f..9b7ace8 100644
--- a/tools/spikes/professional_workload.cpp
+++ b/tools/spikes/professional_workload.cpp
@@ -1,5 +1,5 @@
// Three-source decode and composition stress diagnostic. It does not measure presentation,
-// audio, export, RAW debayering or HDR tone mapping. See Docs/spikes/professional-workload.md.
+// audio, export, RAW debayering or HDR tone mapping. See docs/spikes/professional-workload.md.
#include "oma/compositor/compositor.hpp"
#include "oma/gpu/device.hpp"
#include "oma/media/video_decoder.hpp"
diff --git a/tools/spikes/s1-inventory.sh b/tools/spikes/s1-inventory.sh
index b5e8824..590f3cd 100755
--- a/tools/spikes/s1-inventory.sh
+++ b/tools/spikes/s1-inventory.sh
@@ -1,6 +1,6 @@
#!/usr/bin/env bash
# Spike S1: inventory of the video decode/encode paths this machine actually supports.
-# Usage: tools/spikes/s1-inventory.sh [output-dir] (report in Docs/spikes/S1-hardware-inventory.md)
+# Usage: tools/spikes/s1-inventory.sh [output-dir] (report in docs/spikes/S1-hardware-inventory.md)
#
# A path counts as hardware only if FFmpeg reports the hardware pixel format as chosen by
# get_format(); FFmpeg silently falls back to software decoding otherwise, so "no error" is
diff --git a/tools/spikes/s2_ffmpeg_own_device.cpp b/tools/spikes/s2_ffmpeg_own_device.cpp
index 296bf81..f1258a4 100644
--- a/tools/spikes/s2_ffmpeg_own_device.cpp
+++ b/tools/spikes/s2_ffmpeg_own_device.cpp
@@ -12,7 +12,7 @@
// for the first frame copies a few luma samples back to compare with a software decode. That
// single copy is verification only; the hot path never reads frames back.
//
-// Disposable spike code (Docs/spikes/S2-*.md). What proves useful moves to libs/gpu and libs/media.
+// Disposable spike code (docs/spikes/S2-*.md). What proves useful moves to libs/gpu and libs/media.
// Vulkan-Hpp without exceptions, returning std::expected (needs first and
// VULKAN_HPP_USE_STD_EXPECTED; otherwise it falls back to its own ResultValue type).
diff --git a/tools/spikes/s3-decode-paths.sh b/tools/spikes/s3-decode-paths.sh
index f965608..e387780 100755
--- a/tools/spikes/s3-decode-paths.sh
+++ b/tools/spikes/s3-decode-paths.sh
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
# Spike S3: decode throughput and CPU cost per path (software, VA-API, QSV, flagged Vulkan
# Video) and FFv1 vs ProRes as proxy intermediates.
-# Usage: tools/spikes/s3-decode-paths.sh [output-dir] (report in Docs/spikes/S3-decode-paths.md)
+# Usage: tools/spikes/s3-decode-paths.sh [output-dir] (report in docs/spikes/S3-decode-paths.md)
#
# Decoding keeps hardware frames on the GPU (-hwaccel_output_format) and discards them, so
# the numbers are decoder throughput only: no mapping into OmaMovie's device, no compositing,
diff --git a/tools/spikes/s4_qt_shared_device.cpp b/tools/spikes/s4_qt_shared_device.cpp
index 6e33476..beafffa 100644
--- a/tools/spikes/s4_qt_shared_device.cpp
+++ b/tools/spikes/s4_qt_shared_device.cpp
@@ -1,6 +1,6 @@
// S4: offscreen Qt Quick sampling the compositor's RGBA16F image on OmaMovie's device.
// This diagnostic deliberately runs all queue users sequentially. It is not a UI render loop
-// or a display transform. See Docs/spikes/S4-qt-shared-device.md for scope and reproduction.
+// or a display transform. See docs/spikes/S4-qt-shared-device.md for scope and reproduction.
#include "oma/compositor/compositor.hpp"
#include "oma/gpu/device.hpp"
#include "oma/gpu/resources.hpp"
diff --git a/tools/spikes/s5_minimal_compositing.cpp b/tools/spikes/s5_minimal_compositing.cpp
index b9b01bb..3853060 100644
--- a/tools/spikes/s5_minimal_compositing.cpp
+++ b/tools/spikes/s5_minimal_compositing.cpp
@@ -2,7 +2,7 @@
// drive it. Usage: s5_minimal_compositing [software|hardware] [frames]
// Decode and composite run sequentially on one thread, so the two times are separable; a real
// scheduler overlaps them. render() waits for the GPU, so composite time is submit to completion.
-// No presentation. See Docs/spikes/S5-minimal-compositing.md.
+// No presentation. See docs/spikes/S5-minimal-compositing.md.
#include "oma/compositor/compositor.hpp"
#include "oma/gpu/device.hpp"
#include "oma/media/video_decoder.hpp"
diff --git a/tools/spikes/s6_libplacebo.cpp b/tools/spikes/s6_libplacebo.cpp
index 3d4ae9c..fc99376 100644
--- a/tools/spikes/s6_libplacebo.cpp
+++ b/tools/spikes/s6_libplacebo.cpp
@@ -5,7 +5,7 @@
// 3. Wraps a VA-API frame's planes (FFmpeg's timeline semaphores) and renders YUV->RGB with a
// downscale to 1280x720 at libplacebo's fast/default/high-quality presets; compares the cost
// with the compositor doing the same.
-// Disposable; see Docs/spikes/S6-libplacebo.md.
+// Disposable; see docs/spikes/S6-libplacebo.md.
#include "oma/compositor/compositor.hpp"
#include "oma/gpu/device.hpp"
#include "oma/gpu/resources.hpp"