From 369b484239f6331e0a4ce4d9019b300836830ac1 Mon Sep 17 00:00:00 2001 From: KitsuneSemCalda Date: Sun, 18 Oct 2026 01:16:17 -0300 Subject: [PATCH 1/4] docs: rename Docs and clarify first edit --- CLAUDE.md | 28 ++++---- CONTRIBUTING.md | 10 +-- README.md | 61 ++++++++---------- apps/omamovie/qml/Main.qml | 2 +- apps/omamovie/src/export_encoder.hpp | 2 +- apps/omamovie/src/main.cpp | 2 +- .../src/platform/omarchy/recordings.hpp | 2 +- apps/omamovie/src/session_preview.cpp | 2 +- {Docs => docs}/Research/README.md | 0 .../Research/agentic-mcp-alternatives.md | 0 .../Research/agentic-mcp-architecture.md | 0 .../Research/agentic-mcp-criteria.md | 0 .../Research/agentic-mcp-protocol.md | 0 {Docs => docs}/Research/agentic-mcp-scope.md | 0 .../Research/agentic-mcp-sources.md | 2 +- {Docs => docs}/Research/agentic-mcp.md | 0 {Docs => docs}/Research/capcut.md | 0 .../Research/cuda-hybrid-systems.md | 0 {Docs => docs}/Research/cuda.md | 0 .../Research/davinci-interchange.md | 0 {Docs => docs}/Research/davinci-resolve.md | 0 .../evidence/2026-10-03-calculations.txt | 0 .../Research/evidence/2026-10-03-local.txt | 0 .../evidence/2026-10-03-make-test.txt | 0 .../evidence/2026-10-04-compositor-bench.cpp | 0 .../2026-10-04-decode-allocations.txt | 0 .../evidence/2026-10-04-gpu-effects.txt | 2 +- .../evidence/2026-10-04-grading-numerics.py | 0 .../2026-10-04-m2-m3-intel-recheck.md | 0 .../evidence/2026-10-04-make-test.txt | 0 .../evidence/2026-10-04-s3-decode-paths.txt | 0 .../2026-10-04-s5-minimal-compositing.txt | 0 .../evidence/2026-10-04-s6-libplacebo.txt | 0 .../evidence/2026-10-04-verification.md | 2 +- .../evidence/2026-10-05-m4-av-drift.txt | 0 .../evidence/2026-10-06-m4-hardware-gate.txt | 0 .../evidence/2026-10-06-m6-long-timeline.txt | 0 .../evidence/2026-10-07-m7-export.txt | 0 .../evidence/2026-10-07-m7-kill-recovery.txt | 0 .../2026-10-07-m7-project-open-save.txt | 0 ...2026-10-12-m6-forced-hardware-fallback.txt | 0 .../2026-10-12-m6-recordings-scan.txt | 0 .../evidence/2026-10-12-m6-trim-drag.txt | 0 .../evidence/2026-10-12-m7-cold-open.txt | 0 .../2026-10-12-timeline-anchor-reattach.txt | 0 .../2026-10-12-timeline-insert-clip.txt | 0 .../2026-10-13-m10-real-recordings.txt | 0 .../evidence/2026-10-13-m7-package-check.txt | 0 .../evidence/2026-10-13-m7-two-hour-1080p.txt | 0 .../2026-10-13-m8-speed-audio-cost.txt | 0 .../evidence/2026-10-14-async-scrub.txt | 0 .../evidence/2026-10-14-cross-editor-cuts.txt | 0 .../2026-10-14-cross-editor-export.txt | 2 +- ...-10-14-filmcraft-equivalent-benchmarks.txt | 0 .../2026-10-14-m10-effect-pass-cost.txt | 0 .../2026-10-14-m10-sustained-cycles.txt | 0 .../2026-10-14-m10-validation-layers.txt | 0 .../evidence/2026-10-14-m11-baseline.txt | 4 +- ...2026-10-14-professional-workload-spike.txt | 0 .../evidence/2026-10-14-session-stress.txt | 0 .../2026-10-14-timeline-5000-stalls.txt | 0 ...6-10-15-cross-editor-after-export-work.txt | 0 .../2026-10-15-export-transfer-baseline.md | 0 .../2026-10-15-kdenlive-dataset-import.txt | 0 .../2026-10-15-m7-long-export-cuts.txt | 0 .../evidence/2026-10-15-mlt-roundtrip.txt | 0 .../2026-10-16-export-transfer-phases.md | 0 .../2026-10-16-package-release-gate.md | 0 .../evidence/2026-10-17-first-edit-tour.md | 0 .../evidence/2026-10-17-native-smoke-crash.md | 0 .../2026-10-17-rc-correctness-pilot.md | 0 .../Research/evidence/2026-10-17-rc-cuts.txt | 0 .../evidence/2026-10-17-rc-long-25min.txt | 0 .../Research/evidence/2026-10-17-rc-whole.txt | 0 ...2026-10-17-release-tag-and-staged-smoke.md | 0 .../Research/final-cut-pro-decision.md | 0 .../Research/final-cut-pro-documentation.md | 0 .../Research/final-cut-pro-local-fit.md | 0 .../Research/final-cut-pro-sources.md | 0 .../Research/final-cut-pro-tests.md | 0 {Docs => docs}/Research/final-cut-pro.md | 0 {Docs => docs}/Research/gpu-effects-checks.md | 0 {Docs => docs}/Research/gpu-effects.md | 0 {Docs => docs}/Research/hardware-strategy.md | 0 .../Research/hardware-validation.md | 0 .../Research/hyprland-flicker-coverage.md | 0 .../Research/hyprland-flicker-gate.md | 0 .../Research/hyprland-flicker-hypotheses.md | 0 .../Research/hyprland-flicker-observations.md | 0 {Docs => docs}/Research/hyprland-flicker.md | 0 {Docs => docs}/Research/imovie.md | 0 .../Research/local-source-record.md | 0 .../long-form-editing-alternatives.md | 0 .../Research/long-form-editing-capacity.md | 0 .../Research/long-form-editing-decision.md | 0 .../Research/long-form-editing-foundations.md | 0 .../Research/long-form-editing-gate.md | 0 .../Research/long-form-editing-sources.md | 0 {Docs => docs}/Research/long-form-editing.md | 0 {Docs => docs}/Research/movie-maker.md | 0 {Docs => docs}/Research/omarchy-adapters.md | 0 .../Research/omarchy-integration.md | 0 {Docs => docs}/Research/opencl.md | 0 {Docs => docs}/Research/other-editors.md | 0 .../post-production-effects-candidates.md | 0 .../post-production-effects-editor-ideas.md | 0 .../post-production-effects-marketplace.md | 0 .../post-production-effects-question.md | 0 .../post-production-effects-verification.md | 0 .../Research/post-production-effects.md | 0 {Docs => docs}/Research/premiere-pro.md | 0 .../Research/skeptical-review-budget.md | 0 .../Research/skeptical-review-foundations.md | 0 .../Research/skeptical-review-protocols.md | 0 .../Research/skeptical-review-qt-queue.md | 0 .../Research/skeptical-review-quantitative.md | 0 .../Research/skeptical-review-revisions.md | 0 .../Research/skeptical-review-status.md | 0 {Docs => docs}/Research/skeptical-review.md | 2 +- {Docs => docs}/Research/sources.md | 0 {Docs => docs}/Research/synthesis.md | 0 {Docs => docs}/Research/vegas-pro-decision.md | 0 .../Research/vegas-pro-documentation.md | 0 {Docs => docs}/Research/vegas-pro-fit.md | 0 .../Research/vegas-pro-verification.md | 0 {Docs => docs}/Research/vegas-pro.md | 0 {Docs => docs}/Research/vulkan-boundaries.md | 0 {Docs => docs}/Research/vulkan.md | 0 {Docs => docs}/adr/0001-build-and-tests.md | 0 .../adr/0001-build-language-tests.md | 2 +- {Docs => docs}/adr/0001-conventions.md | 0 {Docs => docs}/adr/0002-decision.md | 0 .../adr/0002-time-representation.md | 2 +- {Docs => docs}/adr/0003-decision.md | 0 .../adr/0003-threading-and-job-system.md | 2 +- {Docs => docs}/adr/0004-amendment.md | 0 .../adr/0004-gpu-frames-sync-decode-policy.md | 2 +- {Docs => docs}/adr/0004-policy.md | 0 {Docs => docs}/adr/0005-alternatives.md | 0 {Docs => docs}/adr/0005-producers.md | 0 {Docs => docs}/adr/0005-qt-vulkan-interop.md | 0 {Docs => docs}/adr/0005-viewer.md | 0 {Docs => docs}/adr/0006-alternatives.md | 0 .../adr/0006-color-space-and-libplacebo.md | 0 {Docs => docs}/adr/0007-decision.md | 0 {Docs => docs}/adr/0007-project-format.md | 0 {Docs => docs}/adr/0008-project-ir.md | 2 +- {Docs => docs}/adr/0009-cache.md | 0 {Docs => docs}/adr/0010-canvas-coordinates.md | 0 {Docs => docs}/adr/0011-transitions.md | 0 {Docs => docs}/adr/0012-alternatives.md | 0 {Docs => docs}/adr/0012-color-grading.md | 0 {Docs => docs}/adr/0013-alternatives.md | 0 {Docs => docs}/adr/0013-clip-time-maps.md | 0 {Docs => docs}/adr/0014-alternatives.md | 0 {Docs => docs}/adr/0014-connected-clips.md | 0 {Docs => docs}/adr/0015-titles.md | 0 {Docs => docs}/adr/0016-integration.md | 0 {Docs => docs}/adr/0016-stack.md | 0 {Docs => docs}/adr/0016-video-effects.md | 0 {Docs => docs}/adr/0017-captions.md | 0 {Docs => docs}/adr/0018-cmake-build.md | 2 +- {Docs => docs}/adr/0018-decision.md | 0 .../adr/0019-media-color-interpretation.md | 0 .../adr/0020-async-execution-boundary.md | 0 {Docs => docs}/adr/0020-consequences.md | 0 {Docs => docs}/adr/README.md | 0 .../analysis-extensibility-conclusion.md | 0 .../analysis-extensibility-coupling.md | 0 .../analysis-extensibility-module-1.md | 0 .../analysis-extensibility-module-2.md | 0 .../analysis-extensibility-module-3.md | 0 .../analysis-extensibility-module-4.md | 2 +- .../analysis-extensibility-module-5.md | 0 .../analysis-extensibility-module-6.md | 0 .../analysis-extensibility-modules.md | 0 .../analysis-extensibility-overview.md | 0 .../analysis-extensibility-recommendations.md | 0 .../analysis/analysis-extensibility-scope.md | 0 .../analysis-extensibility-versions.md | 0 .../analysis/analysis-extensibility.md | 0 ...sis-flickering-hyprland-quickshell-code.md | 0 ...ickering-hyprland-quickshell-conclusion.md | 0 ...-flickering-hyprland-quickshell-context.md | 0 ...ckering-hyprland-quickshell-diagnostics.md | 0 ...ickering-hyprland-quickshell-hypotheses.md | 0 ...ckering-hyprland-quickshell-mitigations.md | 0 ...ickering-hyprland-quickshell-validation.md | 0 ...analysis-flickering-hyprland-quickshell.md | 0 .../analysis-implementation-conclusion.md | 0 .../analysis-implementation-data-flow.md | 0 .../analysis-implementation-dependencies.md | 0 .../analysis/analysis-implementation-gaps.md | 0 .../analysis-implementation-milestones.md | 4 +- .../analysis-implementation-overview.md | 0 .../analysis-implementation-strengths.md | 0 .../analysis-implementation-structure.md | 0 .../analysis-implementation-threading.md | 0 .../analysis/analysis-implementation.md | 0 .../analysis-integral-consolidado-matrix.md | 0 .../analysis-integral-consolidado-overview.md | 0 .../analysis-integral-consolidado-plan.md | 0 ...is-integral-consolidado-recommendations.md | 0 .../analysis-integral-consolidado-risks.md | 0 .../analysis-integral-consolidado-verdict.md | 0 .../analysis/analysis-integral-consolidado.md | 0 .../claude-context-audit-2026-10-15.md | 8 +-- .../analysis/m11-inventory-2026-10-14.md | 0 .../analysis/m11-paused-hardware-seek-note.md | 0 .../analysis/m11-transport-owner-note.md | 0 .../analysis/omamovie-2026-10-12-app.md | 2 +- .../analysis/omamovie-2026-10-12-core.md | 0 .../analysis/omamovie-2026-10-12-filmcraft.md | 0 .../omamovie-2026-10-12-foundation.md | 0 .../omamovie-2026-10-12-milestones.md | 0 .../omamovie-2026-10-12-performance.md | 0 .../omamovie-2026-10-12-priorities.md | 0 .../analysis/omamovie-2026-10-12-workflows.md | 0 .../analysis/omamovie-2026-10-12.md | 0 ...mamovie-2026-10-14-filmcraft-benchmarks.md | 0 {Docs => docs}/format-architecture.md | 0 {Docs => docs}/formats/edl.md | 0 {Docs => docs}/formats/fcpxml.md | 0 {Docs => docs}/formats/mlt.md | 0 .../implementation-plan-agent-assisted-mcp.md | 0 .../implementation-plan-async-interactive.md | 0 .../implementation-plan-audio-editing.md | 0 .../implementation-plan-code-cleanup.md | 0 .../implementation-plan-code-review-2.md | 0 .../implementation-plan-code-review-3.md | 0 .../implementation-plan-code-review-4.md | 0 .../implementation-plan-code-review-5.md | 0 .../implementation-plan-code-review.md | 0 ...lementation-plan-community-effect-packs.md | 0 ...ementation-plan-cross-editor-benchmarks.md | 2 +- ...plementation-plan-cross-editor-workflow.md | 0 .../implementation-plan-decisions-adrs.md | 0 ...implementation-plan-evidence-2026-10-14.md | 0 .../implementation-plan-filmcraft-breadth.md | 0 {Docs => docs}/implementation-plan-goal.md | 0 .../implementation-plan-hardware-matrix.md | 0 .../implementation-plan-m0-foundation.md | 0 .../implementation-plan-m1-hardware-spikes.md | 12 ++-- .../implementation-plan-m10-validation.md | 0 .../implementation-plan-m11-refactoring.md | 0 ...tation-plan-m12-gpu-export-architecture.md | 2 +- .../implementation-plan-m2-gpu-media.md | 0 .../implementation-plan-m3-compositor.md | 0 .../implementation-plan-m4-playback-audio.md | 0 .../implementation-plan-m5-timeline.md | 0 {Docs => docs}/implementation-plan-m6-ui.md | 2 +- .../implementation-plan-m7-project-export.md | 0 .../implementation-plan-m8-creator.md | 0 .../implementation-plan-m9-interop-color.md | 2 +- .../implementation-plan-milestone-overview.md | 0 .../implementation-plan-milestones.md | 0 .../implementation-plan-modular-effects.md | 0 .../implementation-plan-next-step.md | 0 .../implementation-plan-qa-delivery.md | 0 .../implementation-plan-qa-render-time.md | 0 .../implementation-plan-qa-timeline.md | 0 .../implementation-plan-qa-ui-fuzz.md | 0 {Docs => docs}/implementation-plan-qa.md | 0 {Docs => docs}/implementation-plan-risks.md | 0 .../implementation-plan-tests-quality.md | 0 .../implementation-plan-v1-onboarding.md | 2 +- .../implementation-plan-video-effects.md | 2 +- {Docs => docs}/implementation-plan.md | 0 {Docs => docs}/interop.md | 0 {Docs => docs}/m6-walkthrough.md | 0 {Docs => docs}/media/editor-test.webp | Bin {Docs => docs}/media/omamovie-logo.svg | 0 {Docs => docs}/mockups/ui-mockup.html | 2 +- docs/omarchy-window-rule.md | 9 +++ ...roject-analysis-2026-10-04-architecture.md | 0 .../project-analysis-2026-10-04-decision.md | 0 .../project-analysis-2026-10-04-model.md | 0 .../project-analysis-2026-10-04-priorities.md | 0 .../project-analysis-2026-10-04-scaling.md | 0 {Docs => docs}/project-analysis-2026-10-04.md | 0 {Docs => docs}/project-analysis-2026-10-07.md | 0 {Docs => docs}/releases/v0.1.0-rc.1.md | 0 {Docs => docs}/spikes/S1-findings.md | 0 .../spikes/S1-hardware-inventory.md | 2 +- {Docs => docs}/spikes/S1-results.md | 0 {Docs => docs}/spikes/S2-consequences.md | 0 {Docs => docs}/spikes/S2-ffmpeg-own-device.md | 2 +- {Docs => docs}/spikes/S2-results.md | 0 {Docs => docs}/spikes/S3-decode-paths.md | 2 +- {Docs => docs}/spikes/S3-findings.md | 0 {Docs => docs}/spikes/S3-results.md | 0 {Docs => docs}/spikes/S4-qt-shared-device.md | 0 {Docs => docs}/spikes/S4-viewer-handoff.md | 0 {Docs => docs}/spikes/S5-findings.md | 0 .../spikes/S5-minimal-compositing.md | 2 +- {Docs => docs}/spikes/S6-findings.md | 0 {Docs => docs}/spikes/S6-libplacebo.md | 2 +- .../spikes/professional-workload.md | 0 {Docs => docs}/spikes/session-stress.md | 0 {Docs => docs}/ui-design-1.md | 0 {Docs => docs}/ui-design-10.md | 0 {Docs => docs}/ui-design-11.md | 0 {Docs => docs}/ui-design-12.md | 0 {Docs => docs}/ui-design-13.md | 2 +- {Docs => docs}/ui-design-2-1.md | 0 {Docs => docs}/ui-design-2-2.md | 0 {Docs => docs}/ui-design-3.md | 0 {Docs => docs}/ui-design-4.md | 0 {Docs => docs}/ui-design-5.md | 0 {Docs => docs}/ui-design-6.md | 0 {Docs => docs}/ui-design-7.md | 0 {Docs => docs}/ui-design-8-1.md | 0 {Docs => docs}/ui-design-8-2.md | 0 {Docs => docs}/ui-design-9.md | 0 {Docs => docs}/ui-design-context-1.md | 2 +- {Docs => docs}/ui-design-context-2.md | 0 {Docs => docs}/ui-design-context-3.md | 0 {Docs => docs}/ui-design.md | 0 .../ui-ux-evaluation-2026-10-10-context.md | 0 .../ui-ux-evaluation-2026-10-10-gates.md | 0 ...i-ux-evaluation-2026-10-10-interactions.md | 0 .../ui-ux-evaluation-2026-10-10-resize.md | 0 ...i-ux-evaluation-2026-10-10-verification.md | 0 {Docs => docs}/ui-ux-evaluation-2026-10-10.md | 0 {Docs => docs}/ui-ux-tddo.md | 0 libs/compositor/src/look.hpp | 2 +- libs/gpu/include/oma/gpu/device.hpp | 2 +- libs/gpu/src/device.cpp | 4 +- libs/importers/include/oma/importers/edl.hpp | 2 +- .../include/oma/importers/fcpxml.hpp | 2 +- libs/importers/include/oma/importers/mlt.hpp | 2 +- libs/importers/include/oma/importers/otio.hpp | 2 +- libs/media/include/oma/media/video_frame.hpp | 2 +- libs/media/src/vulkan_device.hpp | 2 +- .../include/oma/project_ir/report.hpp | 2 +- scripts/changelog.sh | 4 +- scripts/m6-task-media.sh | 2 +- tests/project/test_edit_round_trip.cpp | 2 +- tests/support/lsan.supp | 2 +- tests/timeline/property_checker.hpp | 2 +- tests/timeline/property_invariants.hpp | 2 +- tests/timeline/property_ops.hpp | 2 +- tests/timeline/property_run.hpp | 2 +- tests/timeline/property_state.hpp | 2 +- tests/timeline/test_properties.cpp | 2 +- tools/bench/cross-editor/run.sh | 2 +- tools/bench/filmcraft-equivalent/spikes.sh | 2 +- tools/spikes/CMakeLists.txt | 2 +- tools/spikes/professional_workload.cpp | 2 +- tools/spikes/s1-inventory.sh | 2 +- tools/spikes/s2_ffmpeg_own_device.cpp | 2 +- tools/spikes/s3-decode-paths.sh | 2 +- tools/spikes/s4_qt_shared_device.cpp | 2 +- tools/spikes/s5_minimal_compositing.cpp | 2 +- tools/spikes/s6_libplacebo.cpp | 2 +- 355 files changed, 133 insertions(+), 131 deletions(-) rename {Docs => docs}/Research/README.md (100%) rename {Docs => docs}/Research/agentic-mcp-alternatives.md (100%) rename {Docs => docs}/Research/agentic-mcp-architecture.md (100%) rename {Docs => docs}/Research/agentic-mcp-criteria.md (100%) rename {Docs => docs}/Research/agentic-mcp-protocol.md (100%) rename {Docs => docs}/Research/agentic-mcp-scope.md (100%) rename {Docs => docs}/Research/agentic-mcp-sources.md (93%) rename {Docs => docs}/Research/agentic-mcp.md (100%) rename {Docs => docs}/Research/capcut.md (100%) rename {Docs => docs}/Research/cuda-hybrid-systems.md (100%) rename {Docs => docs}/Research/cuda.md (100%) rename {Docs => docs}/Research/davinci-interchange.md (100%) rename {Docs => docs}/Research/davinci-resolve.md (100%) rename {Docs => docs}/Research/evidence/2026-10-03-calculations.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-03-local.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-03-make-test.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-compositor-bench.cpp (100%) rename {Docs => docs}/Research/evidence/2026-10-04-decode-allocations.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-gpu-effects.txt (98%) rename {Docs => docs}/Research/evidence/2026-10-04-grading-numerics.py (100%) rename {Docs => docs}/Research/evidence/2026-10-04-m2-m3-intel-recheck.md (100%) rename {Docs => docs}/Research/evidence/2026-10-04-make-test.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-s3-decode-paths.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-s5-minimal-compositing.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-s6-libplacebo.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-04-verification.md (98%) rename {Docs => docs}/Research/evidence/2026-10-05-m4-av-drift.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-06-m4-hardware-gate.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-06-m6-long-timeline.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-07-m7-export.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-07-m7-kill-recovery.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-07-m7-project-open-save.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-m6-forced-hardware-fallback.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-m6-recordings-scan.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-m6-trim-drag.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-m7-cold-open.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-timeline-anchor-reattach.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-12-timeline-insert-clip.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-13-m10-real-recordings.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-13-m7-package-check.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-13-m7-two-hour-1080p.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-13-m8-speed-audio-cost.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-async-scrub.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-cross-editor-cuts.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-cross-editor-export.txt (98%) rename {Docs => docs}/Research/evidence/2026-10-14-filmcraft-equivalent-benchmarks.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-m10-effect-pass-cost.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-m10-sustained-cycles.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-m10-validation-layers.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-m11-baseline.txt (97%) rename {Docs => docs}/Research/evidence/2026-10-14-professional-workload-spike.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-session-stress.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-14-timeline-5000-stalls.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-15-cross-editor-after-export-work.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-15-export-transfer-baseline.md (100%) rename {Docs => docs}/Research/evidence/2026-10-15-kdenlive-dataset-import.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-15-m7-long-export-cuts.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-15-mlt-roundtrip.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-16-export-transfer-phases.md (100%) rename {Docs => docs}/Research/evidence/2026-10-16-package-release-gate.md (100%) rename {Docs => docs}/Research/evidence/2026-10-17-first-edit-tour.md (100%) rename {Docs => docs}/Research/evidence/2026-10-17-native-smoke-crash.md (100%) rename {Docs => docs}/Research/evidence/2026-10-17-rc-correctness-pilot.md (100%) rename {Docs => docs}/Research/evidence/2026-10-17-rc-cuts.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-17-rc-long-25min.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-17-rc-whole.txt (100%) rename {Docs => docs}/Research/evidence/2026-10-17-release-tag-and-staged-smoke.md (100%) rename {Docs => docs}/Research/final-cut-pro-decision.md (100%) rename {Docs => docs}/Research/final-cut-pro-documentation.md (100%) rename {Docs => docs}/Research/final-cut-pro-local-fit.md (100%) rename {Docs => docs}/Research/final-cut-pro-sources.md (100%) rename {Docs => docs}/Research/final-cut-pro-tests.md (100%) rename {Docs => docs}/Research/final-cut-pro.md (100%) rename {Docs => docs}/Research/gpu-effects-checks.md (100%) rename {Docs => docs}/Research/gpu-effects.md (100%) rename {Docs => docs}/Research/hardware-strategy.md (100%) rename {Docs => docs}/Research/hardware-validation.md (100%) rename {Docs => docs}/Research/hyprland-flicker-coverage.md (100%) rename {Docs => docs}/Research/hyprland-flicker-gate.md (100%) rename {Docs => docs}/Research/hyprland-flicker-hypotheses.md (100%) rename {Docs => docs}/Research/hyprland-flicker-observations.md (100%) rename {Docs => docs}/Research/hyprland-flicker.md (100%) rename {Docs => docs}/Research/imovie.md (100%) rename {Docs => docs}/Research/local-source-record.md (100%) rename {Docs => docs}/Research/long-form-editing-alternatives.md (100%) rename {Docs => docs}/Research/long-form-editing-capacity.md (100%) rename {Docs => docs}/Research/long-form-editing-decision.md (100%) rename {Docs => docs}/Research/long-form-editing-foundations.md (100%) rename {Docs => docs}/Research/long-form-editing-gate.md (100%) rename {Docs => docs}/Research/long-form-editing-sources.md (100%) rename {Docs => docs}/Research/long-form-editing.md (100%) rename {Docs => docs}/Research/movie-maker.md (100%) rename {Docs => docs}/Research/omarchy-adapters.md (100%) rename {Docs => docs}/Research/omarchy-integration.md (100%) rename {Docs => docs}/Research/opencl.md (100%) rename {Docs => docs}/Research/other-editors.md (100%) rename {Docs => docs}/Research/post-production-effects-candidates.md (100%) rename {Docs => docs}/Research/post-production-effects-editor-ideas.md (100%) rename {Docs => docs}/Research/post-production-effects-marketplace.md (100%) rename {Docs => docs}/Research/post-production-effects-question.md (100%) rename {Docs => docs}/Research/post-production-effects-verification.md (100%) rename {Docs => docs}/Research/post-production-effects.md (100%) rename {Docs => docs}/Research/premiere-pro.md (100%) rename {Docs => docs}/Research/skeptical-review-budget.md (100%) rename {Docs => docs}/Research/skeptical-review-foundations.md (100%) rename {Docs => docs}/Research/skeptical-review-protocols.md (100%) rename {Docs => docs}/Research/skeptical-review-qt-queue.md (100%) rename {Docs => docs}/Research/skeptical-review-quantitative.md (100%) rename {Docs => docs}/Research/skeptical-review-revisions.md (100%) rename {Docs => docs}/Research/skeptical-review-status.md (100%) rename {Docs => docs}/Research/skeptical-review.md (96%) rename {Docs => docs}/Research/sources.md (100%) rename {Docs => docs}/Research/synthesis.md (100%) rename {Docs => docs}/Research/vegas-pro-decision.md (100%) rename {Docs => docs}/Research/vegas-pro-documentation.md (100%) rename {Docs => docs}/Research/vegas-pro-fit.md (100%) rename {Docs => docs}/Research/vegas-pro-verification.md (100%) rename {Docs => docs}/Research/vegas-pro.md (100%) rename {Docs => docs}/Research/vulkan-boundaries.md (100%) rename {Docs => docs}/Research/vulkan.md (100%) rename {Docs => docs}/adr/0001-build-and-tests.md (100%) rename {Docs => docs}/adr/0001-build-language-tests.md (97%) rename {Docs => docs}/adr/0001-conventions.md (100%) rename {Docs => docs}/adr/0002-decision.md (100%) rename {Docs => docs}/adr/0002-time-representation.md (97%) rename {Docs => docs}/adr/0003-decision.md (100%) rename {Docs => docs}/adr/0003-threading-and-job-system.md (97%) rename {Docs => docs}/adr/0004-amendment.md (100%) rename {Docs => docs}/adr/0004-gpu-frames-sync-decode-policy.md (98%) rename {Docs => docs}/adr/0004-policy.md (100%) rename {Docs => docs}/adr/0005-alternatives.md (100%) rename {Docs => docs}/adr/0005-producers.md (100%) rename {Docs => docs}/adr/0005-qt-vulkan-interop.md (100%) rename {Docs => docs}/adr/0005-viewer.md (100%) rename {Docs => docs}/adr/0006-alternatives.md (100%) rename {Docs => docs}/adr/0006-color-space-and-libplacebo.md (100%) rename {Docs => docs}/adr/0007-decision.md (100%) rename {Docs => docs}/adr/0007-project-format.md (100%) rename {Docs => docs}/adr/0008-project-ir.md (97%) rename {Docs => docs}/adr/0009-cache.md (100%) rename {Docs => docs}/adr/0010-canvas-coordinates.md (100%) rename {Docs => docs}/adr/0011-transitions.md (100%) rename {Docs => docs}/adr/0012-alternatives.md (100%) rename {Docs => docs}/adr/0012-color-grading.md (100%) rename {Docs => docs}/adr/0013-alternatives.md (100%) rename {Docs => docs}/adr/0013-clip-time-maps.md (100%) rename {Docs => docs}/adr/0014-alternatives.md (100%) rename {Docs => docs}/adr/0014-connected-clips.md (100%) rename {Docs => docs}/adr/0015-titles.md (100%) rename {Docs => docs}/adr/0016-integration.md (100%) rename {Docs => docs}/adr/0016-stack.md (100%) rename {Docs => docs}/adr/0016-video-effects.md (100%) rename {Docs => docs}/adr/0017-captions.md (100%) rename {Docs => docs}/adr/0018-cmake-build.md (98%) rename {Docs => docs}/adr/0018-decision.md (100%) rename {Docs => docs}/adr/0019-media-color-interpretation.md (100%) rename {Docs => docs}/adr/0020-async-execution-boundary.md (100%) rename {Docs => docs}/adr/0020-consequences.md (100%) rename {Docs => docs}/adr/README.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-conclusion.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-coupling.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-module-1.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-module-2.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-module-3.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-module-4.md (96%) rename {Docs => docs}/analysis/analysis-extensibility-module-5.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-module-6.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-modules.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-overview.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-recommendations.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-scope.md (100%) rename {Docs => docs}/analysis/analysis-extensibility-versions.md (100%) rename {Docs => docs}/analysis/analysis-extensibility.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-code.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-conclusion.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-context.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-diagnostics.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-hypotheses.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-mitigations.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell-validation.md (100%) rename {Docs => docs}/analysis/analysis-flickering-hyprland-quickshell.md (100%) rename {Docs => docs}/analysis/analysis-implementation-conclusion.md (100%) rename {Docs => docs}/analysis/analysis-implementation-data-flow.md (100%) rename {Docs => docs}/analysis/analysis-implementation-dependencies.md (100%) rename {Docs => docs}/analysis/analysis-implementation-gaps.md (100%) rename {Docs => docs}/analysis/analysis-implementation-milestones.md (96%) rename {Docs => docs}/analysis/analysis-implementation-overview.md (100%) rename {Docs => docs}/analysis/analysis-implementation-strengths.md (100%) rename {Docs => docs}/analysis/analysis-implementation-structure.md (100%) rename {Docs => docs}/analysis/analysis-implementation-threading.md (100%) rename {Docs => docs}/analysis/analysis-implementation.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-matrix.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-overview.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-plan.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-recommendations.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-risks.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado-verdict.md (100%) rename {Docs => docs}/analysis/analysis-integral-consolidado.md (100%) rename {Docs => docs}/analysis/claude-context-audit-2026-10-15.md (96%) rename {Docs => docs}/analysis/m11-inventory-2026-10-14.md (100%) rename {Docs => docs}/analysis/m11-paused-hardware-seek-note.md (100%) rename {Docs => docs}/analysis/m11-transport-owner-note.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-app.md (98%) rename {Docs => docs}/analysis/omamovie-2026-10-12-core.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-filmcraft.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-foundation.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-milestones.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-performance.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-priorities.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12-workflows.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-12.md (100%) rename {Docs => docs}/analysis/omamovie-2026-10-14-filmcraft-benchmarks.md (100%) rename {Docs => docs}/format-architecture.md (100%) rename {Docs => docs}/formats/edl.md (100%) rename {Docs => docs}/formats/fcpxml.md (100%) rename {Docs => docs}/formats/mlt.md (100%) rename {Docs => docs}/implementation-plan-agent-assisted-mcp.md (100%) rename {Docs => docs}/implementation-plan-async-interactive.md (100%) rename {Docs => docs}/implementation-plan-audio-editing.md (100%) rename {Docs => docs}/implementation-plan-code-cleanup.md (100%) rename {Docs => docs}/implementation-plan-code-review-2.md (100%) rename {Docs => docs}/implementation-plan-code-review-3.md (100%) rename {Docs => docs}/implementation-plan-code-review-4.md (100%) rename {Docs => docs}/implementation-plan-code-review-5.md (100%) rename {Docs => docs}/implementation-plan-code-review.md (100%) rename {Docs => docs}/implementation-plan-community-effect-packs.md (100%) rename {Docs => docs}/implementation-plan-cross-editor-benchmarks.md (99%) rename {Docs => docs}/implementation-plan-cross-editor-workflow.md (100%) rename {Docs => docs}/implementation-plan-decisions-adrs.md (100%) rename {Docs => docs}/implementation-plan-evidence-2026-10-14.md (100%) rename {Docs => docs}/implementation-plan-filmcraft-breadth.md (100%) rename {Docs => docs}/implementation-plan-goal.md (100%) rename {Docs => docs}/implementation-plan-hardware-matrix.md (100%) rename {Docs => docs}/implementation-plan-m0-foundation.md (100%) rename {Docs => docs}/implementation-plan-m1-hardware-spikes.md (90%) rename {Docs => docs}/implementation-plan-m10-validation.md (100%) rename {Docs => docs}/implementation-plan-m11-refactoring.md (100%) rename {Docs => docs}/implementation-plan-m12-gpu-export-architecture.md (99%) rename {Docs => docs}/implementation-plan-m2-gpu-media.md (100%) rename {Docs => docs}/implementation-plan-m3-compositor.md (100%) rename {Docs => docs}/implementation-plan-m4-playback-audio.md (100%) rename {Docs => docs}/implementation-plan-m5-timeline.md (100%) rename {Docs => docs}/implementation-plan-m6-ui.md (99%) rename {Docs => docs}/implementation-plan-m7-project-export.md (100%) rename {Docs => docs}/implementation-plan-m8-creator.md (100%) rename {Docs => docs}/implementation-plan-m9-interop-color.md (98%) rename {Docs => docs}/implementation-plan-milestone-overview.md (100%) rename {Docs => docs}/implementation-plan-milestones.md (100%) rename {Docs => docs}/implementation-plan-modular-effects.md (100%) rename {Docs => docs}/implementation-plan-next-step.md (100%) rename {Docs => docs}/implementation-plan-qa-delivery.md (100%) rename {Docs => docs}/implementation-plan-qa-render-time.md (100%) rename {Docs => docs}/implementation-plan-qa-timeline.md (100%) rename {Docs => docs}/implementation-plan-qa-ui-fuzz.md (100%) rename {Docs => docs}/implementation-plan-qa.md (100%) rename {Docs => docs}/implementation-plan-risks.md (100%) rename {Docs => docs}/implementation-plan-tests-quality.md (100%) rename {Docs => docs}/implementation-plan-v1-onboarding.md (98%) rename {Docs => docs}/implementation-plan-video-effects.md (96%) rename {Docs => docs}/implementation-plan.md (100%) rename {Docs => docs}/interop.md (100%) rename {Docs => docs}/m6-walkthrough.md (100%) rename {Docs => docs}/media/editor-test.webp (100%) rename {Docs => docs}/media/omamovie-logo.svg (100%) rename {Docs => docs}/mockups/ui-mockup.html (99%) create mode 100644 docs/omarchy-window-rule.md rename {Docs => docs}/project-analysis-2026-10-04-architecture.md (100%) rename {Docs => docs}/project-analysis-2026-10-04-decision.md (100%) rename {Docs => docs}/project-analysis-2026-10-04-model.md (100%) rename {Docs => docs}/project-analysis-2026-10-04-priorities.md (100%) rename {Docs => docs}/project-analysis-2026-10-04-scaling.md (100%) rename {Docs => docs}/project-analysis-2026-10-04.md (100%) rename {Docs => docs}/project-analysis-2026-10-07.md (100%) rename {Docs => docs}/releases/v0.1.0-rc.1.md (100%) rename {Docs => docs}/spikes/S1-findings.md (100%) rename {Docs => docs}/spikes/S1-hardware-inventory.md (97%) rename {Docs => docs}/spikes/S1-results.md (100%) rename {Docs => docs}/spikes/S2-consequences.md (100%) rename {Docs => docs}/spikes/S2-ffmpeg-own-device.md (98%) rename {Docs => docs}/spikes/S2-results.md (100%) rename {Docs => docs}/spikes/S3-decode-paths.md (96%) rename {Docs => docs}/spikes/S3-findings.md (100%) rename {Docs => docs}/spikes/S3-results.md (100%) rename {Docs => docs}/spikes/S4-qt-shared-device.md (100%) rename {Docs => docs}/spikes/S4-viewer-handoff.md (100%) rename {Docs => docs}/spikes/S5-findings.md (100%) rename {Docs => docs}/spikes/S5-minimal-compositing.md (97%) rename {Docs => docs}/spikes/S6-findings.md (100%) rename {Docs => docs}/spikes/S6-libplacebo.md (98%) rename {Docs => docs}/spikes/professional-workload.md (100%) rename {Docs => docs}/spikes/session-stress.md (100%) rename {Docs => docs}/ui-design-1.md (100%) rename {Docs => docs}/ui-design-10.md (100%) rename {Docs => docs}/ui-design-11.md (100%) rename {Docs => docs}/ui-design-12.md (100%) rename {Docs => docs}/ui-design-13.md (74%) rename {Docs => docs}/ui-design-2-1.md (100%) rename {Docs => docs}/ui-design-2-2.md (100%) rename {Docs => docs}/ui-design-3.md (100%) rename {Docs => docs}/ui-design-4.md (100%) rename {Docs => docs}/ui-design-5.md (100%) rename {Docs => docs}/ui-design-6.md (100%) rename {Docs => docs}/ui-design-7.md (100%) rename {Docs => docs}/ui-design-8-1.md (100%) rename {Docs => docs}/ui-design-8-2.md (100%) rename {Docs => docs}/ui-design-9.md (100%) rename {Docs => docs}/ui-design-context-1.md (97%) rename {Docs => docs}/ui-design-context-2.md (100%) rename {Docs => docs}/ui-design-context-3.md (100%) rename {Docs => docs}/ui-design.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10-context.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10-gates.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10-interactions.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10-resize.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10-verification.md (100%) rename {Docs => docs}/ui-ux-evaluation-2026-10-10.md (100%) rename {Docs => docs}/ui-ux-tddo.md (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 09a6655..2ce3f20 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -9,16 +9,16 @@ without copying either interface or promising feature parity. ## Source of truth and context loading For mutable facts, use this order: **code and relevant tests → accepted ADRs → dated -benchmark/workload evidence → implementation plan → specialized Docs → this guide**. +benchmark/workload evidence → implementation plan → specialized docs → this guide**. An ADR records a decision, not proof that it shipped. Research is provisional. Resolve conflicts by checking current code, tests and dated evidence, then correct the stale doc. Load context progressively: this guide → one relevant skill if useful → the relevant -[implementation milestone](Docs/implementation-plan.md) and [next step](Docs/implementation-plan-next-step.md) -→ its [ADR](Docs/adr/README.md) → affected source/tests → evidence. Expand only when the -question requires it. Use [UI design](Docs/ui-design.md) for UX, -[format architecture](Docs/format-architecture.md) and [interop matrix](Docs/interop.md) -for formats, and [QA](Docs/implementation-plan-qa.md) for validation. [CONTRIBUTING.md](CONTRIBUTING.md) +[implementation milestone](docs/implementation-plan.md) and [next step](docs/implementation-plan-next-step.md) +→ its [ADR](docs/adr/README.md) → affected source/tests → evidence. Expand only when the +question requires it. Use [UI design](docs/ui-design.md) for UX, +[format architecture](docs/format-architecture.md) and [interop matrix](docs/interop.md) +for formats, and [QA](docs/implementation-plan-qa.md) for validation. [CONTRIBUTING.md](CONTRIBUTING.md) contains build commands and contribution process; `make help` lists current targets. ## Facts, goals, preferences and evidence @@ -26,9 +26,9 @@ contains build commands and contribution process; `make help` lists current targ **Facts** are checked in code: the app uses C++23, Qt Quick/QML, FFmpeg, Vulkan and PipeWire; inspect current implementations before describing a path. **Goals** include GPU-native export, clearer Session ownership and more explicit QML composition; the -[M12 plan](Docs/implementation-plan-m12-gpu-export-architecture.md) marks these as planned. +[M12 plan](docs/implementation-plan-m12-gpu-export-architecture.md) marks these as planned. **Maintainer preferences** below guide choices but may be challenged by code or evidence. -**Evidence** lives in `Docs/Research/evidence/`, tests and workload protocols, not here. +**Evidence** lives in `docs/Research/evidence/`, tests and workload protocols, not here. Use status terms precisely: *implemented* = connected code; *tested* = relevant test; *measured* = repeatable benchmark; *validated* = declared workload plus recorded result; @@ -81,13 +81,13 @@ scope. | PR, issue, release or repository health | the matching focused audit/resolution/release skill only | Do not invoke several reviewers for a routine edit. Skills supply reusable method, while -Docs and code supply OmaMovie's current decisions and facts. +The docs and code supply OmaMovie's current decisions and facts. ## Scope and completion Build the committed workflow before adding effect categories or competitor parity. The -[v0.1 release decision](Docs/implementation-plan-milestone-overview.md) covers only its -validated Intel/software scope; the [first-opening tour](Docs/implementation-plan-v1-onboarding.md) +[v0.1 release decision](docs/implementation-plan-milestone-overview.md) covers only its +validated Intel/software scope; the [first-opening tour](docs/implementation-plan-v1-onboarding.md) and bundled editable demo are in v0.1, while contextual tooltip and novice task gates remain open. AMD/NVIDIA, full HDR and other desired capabilities require their own evidence. Do not turn aesthetic refactoring into a release gate. @@ -95,7 +95,7 @@ own evidence. Do not turn aesthetic refactoring into a release gate. A change is done when its actual behavior and error/fallback path have proportional checks, affected integration/workload gates pass, documentation states the resulting scope accurately, and the report names any unverified claim. See -[CONTRIBUTING.md](CONTRIBUTING.md) for commands and [milestone rules](Docs/implementation-plan-milestones.md) +[CONTRIBUTING.md](CONTRIBUTING.md) for commands and [milestone rules](docs/implementation-plan-milestones.md) for release criteria. ## Older section references @@ -103,9 +103,9 @@ for release criteria. Older source comments cite sections of the former long guide. Resolve them through the sources here: §3–5 build/dependencies → `CONTRIBUTING.md`, ADR-0001/0018 and CMake; §6 time → ADR-0002; §7–9 GPU/media/compositor → ADR-0004/0005/0006 and M2/M3/M12; -§10–11 timeline/UI → M5/M6 and `Docs/ui-design.md`; §12–13 audio/concurrency → +§10–11 timeline/UI → M5/M6 and `docs/ui-design.md`; §12–13 audio/concurrency → ADR-0003/0020 and M4; §14–15 project/cache → ADR-0007/0009 and M7; -§16 interop → ADR-0008 and `Docs/interop.md`; §18–19 parser/errors → QA and code; +§16 interop → ADR-0008 and `docs/interop.md`; §18–19 parser/errors → QA and code; §20–26 agent/process/performance/tests → ADR index, evidence, milestones and `CONTRIBUTING.md`. Update a touched comment to its direct source rather than extending this compatibility map. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ef2520c..40f6619 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -26,11 +26,11 @@ make fuzz `scripts/check-includes.sh` verifies dependency boundaries not expressed by CMake. `scripts/package-check.sh` exercises the package in disposable containers. Benchmark and spike commands, their fixtures and measurement protocols live beside each task in -`Docs/Research/evidence/`, `Docs/spikes/` and `tools/bench/`; run only the relevant ones. +`docs/Research/evidence/`, `docs/spikes/` and `tools/bench/`; run only the relevant ones. Commit messages use Conventional Commits in English, with an imperative description under 100 characters. Check a range with `scripts/check-commits.sh`. Do not create a -release tag as part of normal implementation work; the [release plan](Docs/implementation-plan-m10-validation.md) +release tag as part of normal implementation work; the [release plan](docs/implementation-plan-m10-validation.md) and CI define its separate gates. ## Change protocol @@ -47,6 +47,6 @@ and CI define its separate gates. 5. Report what ran and what remains unverified. Do not silently ignore a relevant warning or failure. -Key sources: [implementation plan](Docs/implementation-plan.md), [ADR index](Docs/adr/README.md), -[UI design](Docs/ui-design.md), [format architecture](Docs/format-architecture.md), -[interop support levels](Docs/interop.md), and [QA plan](Docs/implementation-plan-qa.md). +Key sources: [implementation plan](docs/implementation-plan.md), [ADR index](docs/adr/README.md), +[UI design](docs/ui-design.md), [format architecture](docs/format-architecture.md), +[interop support levels](docs/interop.md), and [QA plan](docs/implementation-plan-qa.md). diff --git a/README.md b/README.md index c0a27a4..ea26af4 100644 --- a/README.md +++ b/README.md @@ -1,63 +1,56 @@ # OmaMovie -OmaMovie logo: a play button over three timeline clips +OmaMovie logo: a play button over three timeline clips -OmaMovie is a video editor under development for Omarchy. Its current editor shell lets you import local videos and pictures, arrange clips on a timeline, preview the result, and adjust clip audio. It saves and opens projects and exports MP4, Matroska, or WebM movies. +OmaMovie is a video editor for Omarchy and current Arch Linux. It is for people who want to assemble local video, audio and pictures into a movie, check the edit with sound, save their work and export a shareable file. The first public release candidate targets x86_64; [Intel Iris Xe and software rendering are the validated configurations](#release-candidate-scope). -![OmaMovie editor showing a preview, video clips, and an audio lane on the timeline](Docs/media/editor-test.webp) +![The OmaMovie editor with a video preview, two clips and an audio track on the timeline](docs/media/editor-test.webp) -*The running editor with synthetic test clips. The preview and timeline are captured from the GUI smoke test.* +*The editor running a synthetic test edit. The screenshot comes from the GUI smoke test.* -## Try the editor +## Make your first edit -On an Omarchy or current Arch Linux system, from this repository: +On Omarchy or a current Arch Linux system, clone this repository and run: ```sh make deps make run-gui ``` -`make deps` installs the packages declared in [PKGBUILD](PKGBUILD) using `pacman` and may request sudo. `make run-gui` builds and opens the Qt Quick editor. +`make deps` installs the dependencies in [PKGBUILD](PKGBUILD) through `pacman` and may request sudo. `make run-gui` builds and opens the editor. To install a system package instead, run `makepkg -si` from the repository root. -For a first edit: +The first-opening tour introduces the controls and opens a bundled, editable three-shot demo. You can use it to try an edit without finding media first: -1. Choose **New project**, then **Import** (`Ctrl+I`). Files imported while the timeline is empty are added to the storyline automatically. Once it has clips, new imports stay in the media library until you place them. -2. Select a library item and use **Add** (`E`) to append it. To use only part of it, open the source viewer (`Shift+O`), set In (`I`) and Out (`O`), then use **Add**. Escape returns to the sequence viewer. -3. Play or pause with Space, split at the playhead with `Ctrl+B`, and undo with `Ctrl+Z`. Save with `Ctrl+S` and export with `Ctrl+E`. +1. Play the demo with Space. Select a clip and move the playhead to the cut you want to change. +2. Split with `Ctrl+B`, then undo with `Ctrl+Z` if needed. Open the Command Palette with `Ctrl+K` to find actions and their shortcuts. +3. Save your copy as a `.omamovie` project with `Ctrl+S`. Export a movie with `Ctrl+E`, then choose a profile supported by your installed FFmpeg build. -You can also open a file directly: +For your own footage, start a **New project** and choose **Import** (`Ctrl+I`). Files imported into an empty timeline are added to the storyline. Later imports remain in the media library until you select one and use **Add** (`E`). In the source viewer (`Shift+O`), mark In (`I`) and Out (`O`) before adding a shorter range. Escape returns to the sequence viewer. The original media stays on disk and is not modified. -```sh -make run-gui GUI_FILE=/path/to/video.mp4 -``` - -The imported media stays on disk and is never modified. Projects are saved as `.omamovie` files and can be reopened with `Ctrl+O`. `Ctrl+K` opens the command palette, which lists every action and lets you change its shortcut. `Ctrl+E` offers the output formats supported by the installed FFmpeg build: MP4 (H.264/AAC), Matroska (H.264/AAC or HEVC/AAC), and WebM (VP9/Vorbis). H.264 can use the GPU encoder on validated Intel hardware (VA-API), with a software fallback. Other profiles use software encoders. All outputs use the project's size and frame rate. +## What you can do -## What works today +- Arrange clips with append, insert, overwrite, trim, split, delete and ripple edits; undo and redo the changes. +- Preview the sequence with sound, and adjust clip gain, fades and mute. +- Add titles, looks and transitions, then export MP4, Matroska or WebM using the available profiles. +- Save and reopen `.omamovie` projects. If a source file has moved, the editor keeps its missing reference so you can locate it. +- Import documented subsets of OTIO, FCPXML, EDL and MLT projects. See the [interop matrix](docs/interop.md) before using another editor's project as the source of an edit. -- Import and inspect local video, audio and still image files through FFmpeg. Import checks that the chosen video and audio streams can produce an initial frame or samples; later damage in a file may still cause a decode error. -- Append, insert, overwrite, split, trim, delete, and ripple edit clips with undo and redo. -- Preview the timeline with Vulkan compositing and audio clock playback; adjust clip gain, fades, and mute. -- Use visible transport and edit controls, or their keyboard shortcuts, in the editor shell. +## Install and release files -The viewer decodes in hardware on Intel (VA-API) and in software elsewhere; `OMA_PREVIEW_HARDWARE=0` forces software. The app has bounded OTIO, FCPXML, EDL and MLT import paths. See the [interop matrix](Docs/interop.md) for implemented subsets and evidence gaps; these are not general compatibility claims for every project made by those editors. +The [GitHub Releases page](https://github.com/KitsuneForgering/OmaMovie/releases) provides release candidates, source archives and checksums. The x86_64 Linux application archive contains the installed `usr/` tree; it uses system Qt, FFmpeg, Vulkan and other [package dependencies](PKGBUILD), so it is not a self-contained application. On current Arch/Omarchy, `makepkg -si` builds, tests and installs the package, launcher, icon and `.omamovie` file association. -## Install +The editor follows the active Omarchy theme and font. If Omarchy's window opacity makes the video viewer translucent, see the [Hyprland window rule](docs/omarchy-window-rule.md). -`makepkg -si` builds the package from the [PKGBUILD](PKGBUILD) and installs `omamovie`, its launcher entry, icon and the `.omamovie` file type. The editor follows the active Omarchy theme and font while it runs. +## Release candidate scope -### Full opacity on Hyprland +This release candidate is intended for real edits and feedback. Intel Iris Xe and the software path have been validated; AMD, NVIDIA and hybrid GPU machines have not. The viewer uses Intel VA-API decoding when available and software decoding elsewhere. Set `OMA_PREVIEW_HARDWARE=0` to force software decoding. H.264 export can use the Intel GPU encoder, with a software fallback; other export profiles use software encoders. Export uses the project's frame size and rate. -Omarchy makes ordinary windows slightly translucent, which blends the wallpaper into the viewer. OmaMovie's window class (Wayland app_id) is `omamovie`. To keep it opaque, as Omarchy does for DaVinci Resolve, add this to `~/.config/hypr/windows.lua`: - -```lua -o.window("^omamovie$", { tag = "-default-opacity", opacity = "1 1" }) -``` +Import checks that selected streams can decode an initial frame or samples, but damage later in a file may still cause a decode error. Cross-editor imports cover the subsets in the [interop matrix](docs/interop.md), rather than every project those editors can create. Export currently transfers rendered frames through host memory before encoding. -The package does not install this rule. It uses the Lua window-rule syntax of current Omarchy (`default/hypr/apps/davinci-resolve.lua`); older Hyprland configurations need their own syntax. Full opacity only stops the blending: it does not calibrate the display. +Please report unclear steps, incorrect output and crashes in [GitHub Issues](https://github.com/KitsuneForgering/OmaMovie/issues). Include your version, hardware, source format and steps to reproduce when possible. -## Build and development +## Development and documentation -Run `make test` for the library tests or `make help` for available targets. The [implementation plan](Docs/implementation-plan.md) tracks completed and pending milestones. [UI design](Docs/ui-design.md) describes the editor workflow. [Format boundaries](Docs/format-architecture.md), [contribution guide](CONTRIBUTING.md) and [agent guide](CLAUDE.md) point to architecture and development rules. +Run `make test` for the library tests or `make help` for available targets. The [implementation plan](docs/implementation-plan.md), [UI design](docs/ui-design.md), [format boundaries](docs/format-architecture.md), [contribution guide](CONTRIBUTING.md) and [agent guide](CLAUDE.md) provide deeper detail. License: [MIT](LICENSE). diff --git a/apps/omamovie/qml/Main.qml b/apps/omamovie/qml/Main.qml index 5628956..12ba3ff 100644 --- a/apps/omamovie/qml/Main.qml +++ b/apps/omamovie/qml/Main.qml @@ -5,7 +5,7 @@ import QtQuick.Layouts import QtQuick.Shapes import OmaMovie 1.0 -// Editor shell following Docs/ui-design.md: three fixed areas (library, viewer, timeline), +// Editor shell following docs/ui-design.md: three fixed areas (library, viewer, timeline), // adjustments in a bar and drawer above the viewer, a transport, and every command // registered once as an Action with its §8.1 shortcut. ApplicationWindow { diff --git a/apps/omamovie/src/export_encoder.hpp b/apps/omamovie/src/export_encoder.hpp index b4303d6..fa5f1ec 100644 --- a/apps/omamovie/src/export_encoder.hpp +++ b/apps/omamovie/src/export_encoder.hpp @@ -12,7 +12,7 @@ // The export's encoder as its own stage (code review part 5): the export job renders and reads // back frame n+1 while this stage encodes frame n, so a frame costs about the slower of the two // instead of their sum. Same-machine comparison: -// Docs/implementation-plan-cross-editor-benchmarks.md. +// docs/implementation-plan-cross-editor-benchmarks.md. // // Threading: one worker of its own pool (no ad hoc thread, §13) is the only user of the writer // until finish() returns. Frames move in through a queue of two (backpressure); the producer diff --git a/apps/omamovie/src/main.cpp b/apps/omamovie/src/main.cpp index 4de24c5..05cde37 100644 --- a/apps/omamovie/src/main.cpp +++ b/apps/omamovie/src/main.cpp @@ -428,7 +428,7 @@ int main(int argc, char** argv) { return session.exportedFile() == out ? 0 : 1; } if (timeline_audit) { - // M6 long-form gate (Docs/Research/long-form-editing.md): a storyline of N short clips + // M6 long-form gate (docs/Research/long-form-editing.md): a storyline of N short clips // built with the timeline's own commands, saved with libs/project and opened in the // editor; then routine edits, each timed from the call to the end of the next Qt frame // that started after it (model rebuild, QML bindings and rendering included). diff --git a/apps/omamovie/src/platform/omarchy/recordings.hpp b/apps/omamovie/src/platform/omarchy/recordings.hpp index 1de2b02..9ffcfe1 100644 --- a/apps/omamovie/src/platform/omarchy/recordings.hpp +++ b/apps/omamovie/src/platform/omarchy/recordings.hpp @@ -6,7 +6,7 @@ #include #include -// Omarchy screen recordings (Docs/Research/omarchy-integration.md §5). The rules mirror the +// Omarchy screen recordings (docs/Research/omarchy-integration.md §5). The rules mirror the // installed `omarchy-capture-screenrecording`, which is version-sensitive: keep them here, in // the app's platform adapter, and fall back to plain defaults. namespace omarchy { diff --git a/apps/omamovie/src/session_preview.cpp b/apps/omamovie/src/session_preview.cpp index bef8d35..0546f99 100644 --- a/apps/omamovie/src/session_preview.cpp +++ b/apps/omamovie/src/session_preview.cpp @@ -51,7 +51,7 @@ void Session::previewCommand(std::unique_ptr command) { if (!editor_ || !command) return clearEditScope(); // One timeline copy per preview, O(clips): within the long-form gate at 5,000 clips - // (Docs/Research/evidence/2026-10-12-m6-trim-drag.txt). + // (docs/Research/evidence/2026-10-12-m6-trim-drag.txt). tl::Editor trial{tl::Timeline(editor_->timeline())}; if (!trial.execute(std::move(command))) return clearEditScope(); diff --git a/Docs/Research/README.md b/docs/Research/README.md similarity index 100% rename from Docs/Research/README.md rename to docs/Research/README.md diff --git a/Docs/Research/agentic-mcp-alternatives.md b/docs/Research/agentic-mcp-alternatives.md similarity index 100% rename from Docs/Research/agentic-mcp-alternatives.md rename to docs/Research/agentic-mcp-alternatives.md diff --git a/Docs/Research/agentic-mcp-architecture.md b/docs/Research/agentic-mcp-architecture.md similarity index 100% rename from Docs/Research/agentic-mcp-architecture.md rename to docs/Research/agentic-mcp-architecture.md diff --git a/Docs/Research/agentic-mcp-criteria.md b/docs/Research/agentic-mcp-criteria.md similarity index 100% rename from Docs/Research/agentic-mcp-criteria.md rename to docs/Research/agentic-mcp-criteria.md diff --git a/Docs/Research/agentic-mcp-protocol.md b/docs/Research/agentic-mcp-protocol.md similarity index 100% rename from Docs/Research/agentic-mcp-protocol.md rename to docs/Research/agentic-mcp-protocol.md diff --git a/Docs/Research/agentic-mcp-scope.md b/docs/Research/agentic-mcp-scope.md similarity index 100% rename from Docs/Research/agentic-mcp-scope.md rename to docs/Research/agentic-mcp-scope.md diff --git a/Docs/Research/agentic-mcp-sources.md b/docs/Research/agentic-mcp-sources.md similarity index 93% rename from Docs/Research/agentic-mcp-sources.md rename to docs/Research/agentic-mcp-sources.md index 89fa195..58de572 100644 --- a/Docs/Research/agentic-mcp-sources.md +++ b/docs/Research/agentic-mcp-sources.md @@ -5,7 +5,7 @@ their protocol version is 2026-07-28, while individual page publication/update dates were not exposed except the dated 2026-07-28 release post and 2026-03-16 annotation post. These pages share the MCP project's evidential lineage and establish protocol behavior, not editing effectiveness or actual host support. -Local `README.md`, `CLAUDE.md`, `Docs/implementation-plan.md`, +Local `README.md`, `CLAUDE.md`, `docs/implementation-plan.md`, `libs/timeline/include/oma/timeline/editor.hpp` and `edit.hpp` were inspected from this working tree, which contains uncommitted changes. No MCP server, host integration, security test, user study or benchmark was executed. The diff --git a/Docs/Research/agentic-mcp.md b/docs/Research/agentic-mcp.md similarity index 100% rename from Docs/Research/agentic-mcp.md rename to docs/Research/agentic-mcp.md diff --git a/Docs/Research/capcut.md b/docs/Research/capcut.md similarity index 100% rename from Docs/Research/capcut.md rename to docs/Research/capcut.md diff --git a/Docs/Research/cuda-hybrid-systems.md b/docs/Research/cuda-hybrid-systems.md similarity index 100% rename from Docs/Research/cuda-hybrid-systems.md rename to docs/Research/cuda-hybrid-systems.md diff --git a/Docs/Research/cuda.md b/docs/Research/cuda.md similarity index 100% rename from Docs/Research/cuda.md rename to docs/Research/cuda.md diff --git a/Docs/Research/davinci-interchange.md b/docs/Research/davinci-interchange.md similarity index 100% rename from Docs/Research/davinci-interchange.md rename to docs/Research/davinci-interchange.md diff --git a/Docs/Research/davinci-resolve.md b/docs/Research/davinci-resolve.md similarity index 100% rename from Docs/Research/davinci-resolve.md rename to docs/Research/davinci-resolve.md diff --git a/Docs/Research/evidence/2026-10-03-calculations.txt b/docs/Research/evidence/2026-10-03-calculations.txt similarity index 100% rename from Docs/Research/evidence/2026-10-03-calculations.txt rename to docs/Research/evidence/2026-10-03-calculations.txt diff --git a/Docs/Research/evidence/2026-10-03-local.txt b/docs/Research/evidence/2026-10-03-local.txt similarity index 100% rename from Docs/Research/evidence/2026-10-03-local.txt rename to docs/Research/evidence/2026-10-03-local.txt diff --git a/Docs/Research/evidence/2026-10-03-make-test.txt b/docs/Research/evidence/2026-10-03-make-test.txt similarity index 100% rename from Docs/Research/evidence/2026-10-03-make-test.txt rename to docs/Research/evidence/2026-10-03-make-test.txt diff --git a/Docs/Research/evidence/2026-10-04-compositor-bench.cpp b/docs/Research/evidence/2026-10-04-compositor-bench.cpp similarity index 100% rename from Docs/Research/evidence/2026-10-04-compositor-bench.cpp rename to docs/Research/evidence/2026-10-04-compositor-bench.cpp diff --git a/Docs/Research/evidence/2026-10-04-decode-allocations.txt b/docs/Research/evidence/2026-10-04-decode-allocations.txt similarity index 100% rename from Docs/Research/evidence/2026-10-04-decode-allocations.txt rename to docs/Research/evidence/2026-10-04-decode-allocations.txt diff --git a/Docs/Research/evidence/2026-10-04-gpu-effects.txt b/docs/Research/evidence/2026-10-04-gpu-effects.txt similarity index 98% rename from Docs/Research/evidence/2026-10-04-gpu-effects.txt rename to docs/Research/evidence/2026-10-04-gpu-effects.txt index 0a8ce6c..ce095fb 100644 --- a/Docs/Research/evidence/2026-10-04-gpu-effects.txt +++ b/docs/Research/evidence/2026-10-04-gpu-effects.txt @@ -3,7 +3,7 @@ Machine: Intel Iris Xe (TGL GT2), Mesa 26.2.2-arch1.1, Vulkan 1.4. vulkaninfo: subTexelPrecisionBits = 8, maxImageDimension3D = 2048, maxUniformBufferRange = 1073741824. Numerics recheck (2026-10-04): ran - python3 Docs/Research/evidence/2026-10-04-grading-numerics.py + python3 docs/Research/evidence/2026-10-04-grading-numerics.py with NumPy 2.5.3. It exited 0 and reproduced every printed figure in section 2 below to the shown precision, including the no-overshoot and neutral-grey checks. This rechecks the synthetic numerical model, not grading against an independent color oracle. diff --git a/Docs/Research/evidence/2026-10-04-grading-numerics.py b/docs/Research/evidence/2026-10-04-grading-numerics.py similarity index 100% rename from Docs/Research/evidence/2026-10-04-grading-numerics.py rename to docs/Research/evidence/2026-10-04-grading-numerics.py diff --git a/Docs/Research/evidence/2026-10-04-m2-m3-intel-recheck.md b/docs/Research/evidence/2026-10-04-m2-m3-intel-recheck.md similarity index 100% rename from Docs/Research/evidence/2026-10-04-m2-m3-intel-recheck.md rename to docs/Research/evidence/2026-10-04-m2-m3-intel-recheck.md diff --git a/Docs/Research/evidence/2026-10-04-make-test.txt b/docs/Research/evidence/2026-10-04-make-test.txt similarity index 100% rename from Docs/Research/evidence/2026-10-04-make-test.txt rename to docs/Research/evidence/2026-10-04-make-test.txt diff --git a/Docs/Research/evidence/2026-10-04-s3-decode-paths.txt b/docs/Research/evidence/2026-10-04-s3-decode-paths.txt similarity index 100% rename from Docs/Research/evidence/2026-10-04-s3-decode-paths.txt rename to docs/Research/evidence/2026-10-04-s3-decode-paths.txt diff --git a/Docs/Research/evidence/2026-10-04-s5-minimal-compositing.txt b/docs/Research/evidence/2026-10-04-s5-minimal-compositing.txt similarity index 100% rename from Docs/Research/evidence/2026-10-04-s5-minimal-compositing.txt rename to docs/Research/evidence/2026-10-04-s5-minimal-compositing.txt diff --git a/Docs/Research/evidence/2026-10-04-s6-libplacebo.txt b/docs/Research/evidence/2026-10-04-s6-libplacebo.txt similarity index 100% rename from Docs/Research/evidence/2026-10-04-s6-libplacebo.txt rename to docs/Research/evidence/2026-10-04-s6-libplacebo.txt diff --git a/Docs/Research/evidence/2026-10-04-verification.md b/docs/Research/evidence/2026-10-04-verification.md similarity index 98% rename from Docs/Research/evidence/2026-10-04-verification.md rename to docs/Research/evidence/2026-10-04-verification.md index ae5077b..16dab06 100644 --- a/Docs/Research/evidence/2026-10-04-verification.md +++ b/docs/Research/evidence/2026-10-04-verification.md @@ -4,7 +4,7 @@ This is a bounded recheck of local evidence, not a rerun of the S3/S5 or GPU-eff ## Reproduced -- `python3 Docs/Research/evidence/2026-10-04-grading-numerics.py` with NumPy 2.5.3 exited 0. Every printed value matched section 2 of [gpu-effects.txt](2026-10-04-gpu-effects.txt) to the displayed precision: LGG/CDL `6.43e-15`, steep-curve table errors `2.25e-03` (256) and `1.58e-04` (1024), 33³ tetrahedral LUT maximum error `2.12e-02`, and zero reported grey-axis spread. These are synthetic numerical checks; they are not an independent color reference. +- `python3 docs/Research/evidence/2026-10-04-grading-numerics.py` with NumPy 2.5.3 exited 0. Every printed value matched section 2 of [gpu-effects.txt](2026-10-04-gpu-effects.txt) to the displayed precision: LGG/CDL `6.43e-15`, steep-curve table errors `2.25e-03` (256) and `1.58e-04` (1024), 33³ tetrahedral LUT maximum error `2.12e-02`, and zero reported grey-axis spread. These are synthetic numerical checks; they are not an independent color reference. - Independently recomputed the capacity arithmetic in [2026-10-03-calculations.txt](2026-10-03-calculations.txt) using Python's standard library: 4K RGBA16F is `63.28125 MiB`, one full-frame transfer at 60 fps is `3.981312 GB/s`, and three streams with eight frames each occupy `1518.75 MiB`, excluding other allocations. - `make test` in the current debug tree exited 0. The [complete output](2026-10-04-make-test.txt) contains the eight suite summaries: base 118, gpu 41, media 652, compositor 164, audio 89, timeline 292, playback 49, project 38 Cest-reported checks passed. One compositor hardware-decode branch printed `(skipped: no hardware decode here)`; a green suite is not validation of that path. The first attempted rerun exited 2 because `compositor_tests` was temporarily non-executable during a rebuild; each test binary then exited 0 individually, and the final `make test` passed. diff --git a/Docs/Research/evidence/2026-10-05-m4-av-drift.txt b/docs/Research/evidence/2026-10-05-m4-av-drift.txt similarity index 100% rename from Docs/Research/evidence/2026-10-05-m4-av-drift.txt rename to docs/Research/evidence/2026-10-05-m4-av-drift.txt diff --git a/Docs/Research/evidence/2026-10-06-m4-hardware-gate.txt b/docs/Research/evidence/2026-10-06-m4-hardware-gate.txt similarity index 100% rename from Docs/Research/evidence/2026-10-06-m4-hardware-gate.txt rename to docs/Research/evidence/2026-10-06-m4-hardware-gate.txt diff --git a/Docs/Research/evidence/2026-10-06-m6-long-timeline.txt b/docs/Research/evidence/2026-10-06-m6-long-timeline.txt similarity index 100% rename from Docs/Research/evidence/2026-10-06-m6-long-timeline.txt rename to docs/Research/evidence/2026-10-06-m6-long-timeline.txt diff --git a/Docs/Research/evidence/2026-10-07-m7-export.txt b/docs/Research/evidence/2026-10-07-m7-export.txt similarity index 100% rename from Docs/Research/evidence/2026-10-07-m7-export.txt rename to docs/Research/evidence/2026-10-07-m7-export.txt diff --git a/Docs/Research/evidence/2026-10-07-m7-kill-recovery.txt b/docs/Research/evidence/2026-10-07-m7-kill-recovery.txt similarity index 100% rename from Docs/Research/evidence/2026-10-07-m7-kill-recovery.txt rename to docs/Research/evidence/2026-10-07-m7-kill-recovery.txt diff --git a/Docs/Research/evidence/2026-10-07-m7-project-open-save.txt b/docs/Research/evidence/2026-10-07-m7-project-open-save.txt similarity index 100% rename from Docs/Research/evidence/2026-10-07-m7-project-open-save.txt rename to docs/Research/evidence/2026-10-07-m7-project-open-save.txt diff --git a/Docs/Research/evidence/2026-10-12-m6-forced-hardware-fallback.txt b/docs/Research/evidence/2026-10-12-m6-forced-hardware-fallback.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-m6-forced-hardware-fallback.txt rename to docs/Research/evidence/2026-10-12-m6-forced-hardware-fallback.txt diff --git a/Docs/Research/evidence/2026-10-12-m6-recordings-scan.txt b/docs/Research/evidence/2026-10-12-m6-recordings-scan.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-m6-recordings-scan.txt rename to docs/Research/evidence/2026-10-12-m6-recordings-scan.txt diff --git a/Docs/Research/evidence/2026-10-12-m6-trim-drag.txt b/docs/Research/evidence/2026-10-12-m6-trim-drag.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-m6-trim-drag.txt rename to docs/Research/evidence/2026-10-12-m6-trim-drag.txt diff --git a/Docs/Research/evidence/2026-10-12-m7-cold-open.txt b/docs/Research/evidence/2026-10-12-m7-cold-open.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-m7-cold-open.txt rename to docs/Research/evidence/2026-10-12-m7-cold-open.txt diff --git a/Docs/Research/evidence/2026-10-12-timeline-anchor-reattach.txt b/docs/Research/evidence/2026-10-12-timeline-anchor-reattach.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-timeline-anchor-reattach.txt rename to docs/Research/evidence/2026-10-12-timeline-anchor-reattach.txt diff --git a/Docs/Research/evidence/2026-10-12-timeline-insert-clip.txt b/docs/Research/evidence/2026-10-12-timeline-insert-clip.txt similarity index 100% rename from Docs/Research/evidence/2026-10-12-timeline-insert-clip.txt rename to docs/Research/evidence/2026-10-12-timeline-insert-clip.txt diff --git a/Docs/Research/evidence/2026-10-13-m10-real-recordings.txt b/docs/Research/evidence/2026-10-13-m10-real-recordings.txt similarity index 100% rename from Docs/Research/evidence/2026-10-13-m10-real-recordings.txt rename to docs/Research/evidence/2026-10-13-m10-real-recordings.txt diff --git a/Docs/Research/evidence/2026-10-13-m7-package-check.txt b/docs/Research/evidence/2026-10-13-m7-package-check.txt similarity index 100% rename from Docs/Research/evidence/2026-10-13-m7-package-check.txt rename to docs/Research/evidence/2026-10-13-m7-package-check.txt diff --git a/Docs/Research/evidence/2026-10-13-m7-two-hour-1080p.txt b/docs/Research/evidence/2026-10-13-m7-two-hour-1080p.txt similarity index 100% rename from Docs/Research/evidence/2026-10-13-m7-two-hour-1080p.txt rename to docs/Research/evidence/2026-10-13-m7-two-hour-1080p.txt diff --git a/Docs/Research/evidence/2026-10-13-m8-speed-audio-cost.txt b/docs/Research/evidence/2026-10-13-m8-speed-audio-cost.txt similarity index 100% rename from Docs/Research/evidence/2026-10-13-m8-speed-audio-cost.txt rename to docs/Research/evidence/2026-10-13-m8-speed-audio-cost.txt diff --git a/Docs/Research/evidence/2026-10-14-async-scrub.txt b/docs/Research/evidence/2026-10-14-async-scrub.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-async-scrub.txt rename to docs/Research/evidence/2026-10-14-async-scrub.txt diff --git a/Docs/Research/evidence/2026-10-14-cross-editor-cuts.txt b/docs/Research/evidence/2026-10-14-cross-editor-cuts.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-cross-editor-cuts.txt rename to docs/Research/evidence/2026-10-14-cross-editor-cuts.txt diff --git a/Docs/Research/evidence/2026-10-14-cross-editor-export.txt b/docs/Research/evidence/2026-10-14-cross-editor-export.txt similarity index 98% rename from Docs/Research/evidence/2026-10-14-cross-editor-export.txt rename to docs/Research/evidence/2026-10-14-cross-editor-export.txt index 410ea0f..819bebe 100644 --- a/Docs/Research/evidence/2026-10-14-cross-editor-export.txt +++ b/docs/Research/evidence/2026-10-14-cross-editor-export.txt @@ -17,7 +17,7 @@ Summary (median wall of completed runs, peak RSS, bytes, luma PSNR, frames): Findings: melt appends one frame (a near-copy of the last, 52.9 dB to it) to reach 20.02 s; OmaMovie keeps the source's 479. OmaMovie's round 2 VA-API run wrote a complete file and then hung: the viewer composited one GPU frame on two layers and the render thread deadlocked on the -frame lock it already held (core analysed; Docs/implementation-plan-code-review-4.md). +frame lock it already held (core analysed; docs/implementation-plan-code-review-4.md). OmaMovie spends ~2 s of system time per export against melt's ~0.4-0.9 s; not yet explained. Cross-editor export 2026-10-14 21:24:20 -0300, 5 repeats, order alternated per round diff --git a/Docs/Research/evidence/2026-10-14-filmcraft-equivalent-benchmarks.txt b/docs/Research/evidence/2026-10-14-filmcraft-equivalent-benchmarks.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-filmcraft-equivalent-benchmarks.txt rename to docs/Research/evidence/2026-10-14-filmcraft-equivalent-benchmarks.txt diff --git a/Docs/Research/evidence/2026-10-14-m10-effect-pass-cost.txt b/docs/Research/evidence/2026-10-14-m10-effect-pass-cost.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-m10-effect-pass-cost.txt rename to docs/Research/evidence/2026-10-14-m10-effect-pass-cost.txt diff --git a/Docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt b/docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt rename to docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt diff --git a/Docs/Research/evidence/2026-10-14-m10-validation-layers.txt b/docs/Research/evidence/2026-10-14-m10-validation-layers.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-m10-validation-layers.txt rename to docs/Research/evidence/2026-10-14-m10-validation-layers.txt diff --git a/Docs/Research/evidence/2026-10-14-m11-baseline.txt b/docs/Research/evidence/2026-10-14-m11-baseline.txt similarity index 97% rename from Docs/Research/evidence/2026-10-14-m11-baseline.txt rename to docs/Research/evidence/2026-10-14-m11-baseline.txt index 592cab9..f35fbec 100644 --- a/Docs/Research/evidence/2026-10-14-m11-baseline.txt +++ b/docs/Research/evidence/2026-10-14-m11-baseline.txt @@ -22,8 +22,8 @@ Seeking: omamovie --m4-seek-audit baseline_1080p60.mp4 30 Timeline scale: omamovie --m6-timeline-audit 1000 1000 clips: model build 2.4 ms, open 92.3 ms (save, load, reimport, UI), RSS 370 MB. -Sustained cycles (headless): Docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt. -Sizes and change coupling: Docs/analysis/m11-inventory-2026-10-14.md. +Sustained cycles (headless): docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt. +Sizes and change coupling: docs/analysis/m11-inventory-2026-10-14.md. Not recorded yet: screenshots and keyboard walkthroughs at wide, half-width and 640 px with a larger font (the GUI smoke checks the 640 px layout fits). diff --git a/Docs/Research/evidence/2026-10-14-professional-workload-spike.txt b/docs/Research/evidence/2026-10-14-professional-workload-spike.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-professional-workload-spike.txt rename to docs/Research/evidence/2026-10-14-professional-workload-spike.txt diff --git a/Docs/Research/evidence/2026-10-14-session-stress.txt b/docs/Research/evidence/2026-10-14-session-stress.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-session-stress.txt rename to docs/Research/evidence/2026-10-14-session-stress.txt diff --git a/Docs/Research/evidence/2026-10-14-timeline-5000-stalls.txt b/docs/Research/evidence/2026-10-14-timeline-5000-stalls.txt similarity index 100% rename from Docs/Research/evidence/2026-10-14-timeline-5000-stalls.txt rename to docs/Research/evidence/2026-10-14-timeline-5000-stalls.txt diff --git a/Docs/Research/evidence/2026-10-15-cross-editor-after-export-work.txt b/docs/Research/evidence/2026-10-15-cross-editor-after-export-work.txt similarity index 100% rename from Docs/Research/evidence/2026-10-15-cross-editor-after-export-work.txt rename to docs/Research/evidence/2026-10-15-cross-editor-after-export-work.txt diff --git a/Docs/Research/evidence/2026-10-15-export-transfer-baseline.md b/docs/Research/evidence/2026-10-15-export-transfer-baseline.md similarity index 100% rename from Docs/Research/evidence/2026-10-15-export-transfer-baseline.md rename to docs/Research/evidence/2026-10-15-export-transfer-baseline.md diff --git a/Docs/Research/evidence/2026-10-15-kdenlive-dataset-import.txt b/docs/Research/evidence/2026-10-15-kdenlive-dataset-import.txt similarity index 100% rename from Docs/Research/evidence/2026-10-15-kdenlive-dataset-import.txt rename to docs/Research/evidence/2026-10-15-kdenlive-dataset-import.txt diff --git a/Docs/Research/evidence/2026-10-15-m7-long-export-cuts.txt b/docs/Research/evidence/2026-10-15-m7-long-export-cuts.txt similarity index 100% rename from Docs/Research/evidence/2026-10-15-m7-long-export-cuts.txt rename to docs/Research/evidence/2026-10-15-m7-long-export-cuts.txt diff --git a/Docs/Research/evidence/2026-10-15-mlt-roundtrip.txt b/docs/Research/evidence/2026-10-15-mlt-roundtrip.txt similarity index 100% rename from Docs/Research/evidence/2026-10-15-mlt-roundtrip.txt rename to docs/Research/evidence/2026-10-15-mlt-roundtrip.txt diff --git a/Docs/Research/evidence/2026-10-16-export-transfer-phases.md b/docs/Research/evidence/2026-10-16-export-transfer-phases.md similarity index 100% rename from Docs/Research/evidence/2026-10-16-export-transfer-phases.md rename to docs/Research/evidence/2026-10-16-export-transfer-phases.md diff --git a/Docs/Research/evidence/2026-10-16-package-release-gate.md b/docs/Research/evidence/2026-10-16-package-release-gate.md similarity index 100% rename from Docs/Research/evidence/2026-10-16-package-release-gate.md rename to docs/Research/evidence/2026-10-16-package-release-gate.md diff --git a/Docs/Research/evidence/2026-10-17-first-edit-tour.md b/docs/Research/evidence/2026-10-17-first-edit-tour.md similarity index 100% rename from Docs/Research/evidence/2026-10-17-first-edit-tour.md rename to docs/Research/evidence/2026-10-17-first-edit-tour.md diff --git a/Docs/Research/evidence/2026-10-17-native-smoke-crash.md b/docs/Research/evidence/2026-10-17-native-smoke-crash.md similarity index 100% rename from Docs/Research/evidence/2026-10-17-native-smoke-crash.md rename to docs/Research/evidence/2026-10-17-native-smoke-crash.md diff --git a/Docs/Research/evidence/2026-10-17-rc-correctness-pilot.md b/docs/Research/evidence/2026-10-17-rc-correctness-pilot.md similarity index 100% rename from Docs/Research/evidence/2026-10-17-rc-correctness-pilot.md rename to docs/Research/evidence/2026-10-17-rc-correctness-pilot.md diff --git a/Docs/Research/evidence/2026-10-17-rc-cuts.txt b/docs/Research/evidence/2026-10-17-rc-cuts.txt similarity index 100% rename from Docs/Research/evidence/2026-10-17-rc-cuts.txt rename to docs/Research/evidence/2026-10-17-rc-cuts.txt diff --git a/Docs/Research/evidence/2026-10-17-rc-long-25min.txt b/docs/Research/evidence/2026-10-17-rc-long-25min.txt similarity index 100% rename from Docs/Research/evidence/2026-10-17-rc-long-25min.txt rename to docs/Research/evidence/2026-10-17-rc-long-25min.txt diff --git a/Docs/Research/evidence/2026-10-17-rc-whole.txt b/docs/Research/evidence/2026-10-17-rc-whole.txt similarity index 100% rename from Docs/Research/evidence/2026-10-17-rc-whole.txt rename to docs/Research/evidence/2026-10-17-rc-whole.txt diff --git a/Docs/Research/evidence/2026-10-17-release-tag-and-staged-smoke.md b/docs/Research/evidence/2026-10-17-release-tag-and-staged-smoke.md similarity index 100% rename from Docs/Research/evidence/2026-10-17-release-tag-and-staged-smoke.md rename to docs/Research/evidence/2026-10-17-release-tag-and-staged-smoke.md diff --git a/Docs/Research/final-cut-pro-decision.md b/docs/Research/final-cut-pro-decision.md similarity index 100% rename from Docs/Research/final-cut-pro-decision.md rename to docs/Research/final-cut-pro-decision.md diff --git a/Docs/Research/final-cut-pro-documentation.md b/docs/Research/final-cut-pro-documentation.md similarity index 100% rename from Docs/Research/final-cut-pro-documentation.md rename to docs/Research/final-cut-pro-documentation.md diff --git a/Docs/Research/final-cut-pro-local-fit.md b/docs/Research/final-cut-pro-local-fit.md similarity index 100% rename from Docs/Research/final-cut-pro-local-fit.md rename to docs/Research/final-cut-pro-local-fit.md diff --git a/Docs/Research/final-cut-pro-sources.md b/docs/Research/final-cut-pro-sources.md similarity index 100% rename from Docs/Research/final-cut-pro-sources.md rename to docs/Research/final-cut-pro-sources.md diff --git a/Docs/Research/final-cut-pro-tests.md b/docs/Research/final-cut-pro-tests.md similarity index 100% rename from Docs/Research/final-cut-pro-tests.md rename to docs/Research/final-cut-pro-tests.md diff --git a/Docs/Research/final-cut-pro.md b/docs/Research/final-cut-pro.md similarity index 100% rename from Docs/Research/final-cut-pro.md rename to docs/Research/final-cut-pro.md diff --git a/Docs/Research/gpu-effects-checks.md b/docs/Research/gpu-effects-checks.md similarity index 100% rename from Docs/Research/gpu-effects-checks.md rename to docs/Research/gpu-effects-checks.md diff --git a/Docs/Research/gpu-effects.md b/docs/Research/gpu-effects.md similarity index 100% rename from Docs/Research/gpu-effects.md rename to docs/Research/gpu-effects.md diff --git a/Docs/Research/hardware-strategy.md b/docs/Research/hardware-strategy.md similarity index 100% rename from Docs/Research/hardware-strategy.md rename to docs/Research/hardware-strategy.md diff --git a/Docs/Research/hardware-validation.md b/docs/Research/hardware-validation.md similarity index 100% rename from Docs/Research/hardware-validation.md rename to docs/Research/hardware-validation.md diff --git a/Docs/Research/hyprland-flicker-coverage.md b/docs/Research/hyprland-flicker-coverage.md similarity index 100% rename from Docs/Research/hyprland-flicker-coverage.md rename to docs/Research/hyprland-flicker-coverage.md diff --git a/Docs/Research/hyprland-flicker-gate.md b/docs/Research/hyprland-flicker-gate.md similarity index 100% rename from Docs/Research/hyprland-flicker-gate.md rename to docs/Research/hyprland-flicker-gate.md diff --git a/Docs/Research/hyprland-flicker-hypotheses.md b/docs/Research/hyprland-flicker-hypotheses.md similarity index 100% rename from Docs/Research/hyprland-flicker-hypotheses.md rename to docs/Research/hyprland-flicker-hypotheses.md diff --git a/Docs/Research/hyprland-flicker-observations.md b/docs/Research/hyprland-flicker-observations.md similarity index 100% rename from Docs/Research/hyprland-flicker-observations.md rename to docs/Research/hyprland-flicker-observations.md diff --git a/Docs/Research/hyprland-flicker.md b/docs/Research/hyprland-flicker.md similarity index 100% rename from Docs/Research/hyprland-flicker.md rename to docs/Research/hyprland-flicker.md diff --git a/Docs/Research/imovie.md b/docs/Research/imovie.md similarity index 100% rename from Docs/Research/imovie.md rename to docs/Research/imovie.md diff --git a/Docs/Research/local-source-record.md b/docs/Research/local-source-record.md similarity index 100% rename from Docs/Research/local-source-record.md rename to docs/Research/local-source-record.md diff --git a/Docs/Research/long-form-editing-alternatives.md b/docs/Research/long-form-editing-alternatives.md similarity index 100% rename from Docs/Research/long-form-editing-alternatives.md rename to docs/Research/long-form-editing-alternatives.md diff --git a/Docs/Research/long-form-editing-capacity.md b/docs/Research/long-form-editing-capacity.md similarity index 100% rename from Docs/Research/long-form-editing-capacity.md rename to docs/Research/long-form-editing-capacity.md diff --git a/Docs/Research/long-form-editing-decision.md b/docs/Research/long-form-editing-decision.md similarity index 100% rename from Docs/Research/long-form-editing-decision.md rename to docs/Research/long-form-editing-decision.md diff --git a/Docs/Research/long-form-editing-foundations.md b/docs/Research/long-form-editing-foundations.md similarity index 100% rename from Docs/Research/long-form-editing-foundations.md rename to docs/Research/long-form-editing-foundations.md diff --git a/Docs/Research/long-form-editing-gate.md b/docs/Research/long-form-editing-gate.md similarity index 100% rename from Docs/Research/long-form-editing-gate.md rename to docs/Research/long-form-editing-gate.md diff --git a/Docs/Research/long-form-editing-sources.md b/docs/Research/long-form-editing-sources.md similarity index 100% rename from Docs/Research/long-form-editing-sources.md rename to docs/Research/long-form-editing-sources.md diff --git a/Docs/Research/long-form-editing.md b/docs/Research/long-form-editing.md similarity index 100% rename from Docs/Research/long-form-editing.md rename to docs/Research/long-form-editing.md diff --git a/Docs/Research/movie-maker.md b/docs/Research/movie-maker.md similarity index 100% rename from Docs/Research/movie-maker.md rename to docs/Research/movie-maker.md diff --git a/Docs/Research/omarchy-adapters.md b/docs/Research/omarchy-adapters.md similarity index 100% rename from Docs/Research/omarchy-adapters.md rename to docs/Research/omarchy-adapters.md diff --git a/Docs/Research/omarchy-integration.md b/docs/Research/omarchy-integration.md similarity index 100% rename from Docs/Research/omarchy-integration.md rename to docs/Research/omarchy-integration.md diff --git a/Docs/Research/opencl.md b/docs/Research/opencl.md similarity index 100% rename from Docs/Research/opencl.md rename to docs/Research/opencl.md diff --git a/Docs/Research/other-editors.md b/docs/Research/other-editors.md similarity index 100% rename from Docs/Research/other-editors.md rename to docs/Research/other-editors.md diff --git a/Docs/Research/post-production-effects-candidates.md b/docs/Research/post-production-effects-candidates.md similarity index 100% rename from Docs/Research/post-production-effects-candidates.md rename to docs/Research/post-production-effects-candidates.md diff --git a/Docs/Research/post-production-effects-editor-ideas.md b/docs/Research/post-production-effects-editor-ideas.md similarity index 100% rename from Docs/Research/post-production-effects-editor-ideas.md rename to docs/Research/post-production-effects-editor-ideas.md diff --git a/Docs/Research/post-production-effects-marketplace.md b/docs/Research/post-production-effects-marketplace.md similarity index 100% rename from Docs/Research/post-production-effects-marketplace.md rename to docs/Research/post-production-effects-marketplace.md diff --git a/Docs/Research/post-production-effects-question.md b/docs/Research/post-production-effects-question.md similarity index 100% rename from Docs/Research/post-production-effects-question.md rename to docs/Research/post-production-effects-question.md diff --git a/Docs/Research/post-production-effects-verification.md b/docs/Research/post-production-effects-verification.md similarity index 100% rename from Docs/Research/post-production-effects-verification.md rename to docs/Research/post-production-effects-verification.md diff --git a/Docs/Research/post-production-effects.md b/docs/Research/post-production-effects.md similarity index 100% rename from Docs/Research/post-production-effects.md rename to docs/Research/post-production-effects.md diff --git a/Docs/Research/premiere-pro.md b/docs/Research/premiere-pro.md similarity index 100% rename from Docs/Research/premiere-pro.md rename to docs/Research/premiere-pro.md diff --git a/Docs/Research/skeptical-review-budget.md b/docs/Research/skeptical-review-budget.md similarity index 100% rename from Docs/Research/skeptical-review-budget.md rename to docs/Research/skeptical-review-budget.md diff --git a/Docs/Research/skeptical-review-foundations.md b/docs/Research/skeptical-review-foundations.md similarity index 100% rename from Docs/Research/skeptical-review-foundations.md rename to docs/Research/skeptical-review-foundations.md diff --git a/Docs/Research/skeptical-review-protocols.md b/docs/Research/skeptical-review-protocols.md similarity index 100% rename from Docs/Research/skeptical-review-protocols.md rename to docs/Research/skeptical-review-protocols.md diff --git a/Docs/Research/skeptical-review-qt-queue.md b/docs/Research/skeptical-review-qt-queue.md similarity index 100% rename from Docs/Research/skeptical-review-qt-queue.md rename to docs/Research/skeptical-review-qt-queue.md diff --git a/Docs/Research/skeptical-review-quantitative.md b/docs/Research/skeptical-review-quantitative.md similarity index 100% rename from Docs/Research/skeptical-review-quantitative.md rename to docs/Research/skeptical-review-quantitative.md diff --git a/Docs/Research/skeptical-review-revisions.md b/docs/Research/skeptical-review-revisions.md similarity index 100% rename from Docs/Research/skeptical-review-revisions.md rename to docs/Research/skeptical-review-revisions.md diff --git a/Docs/Research/skeptical-review-status.md b/docs/Research/skeptical-review-status.md similarity index 100% rename from Docs/Research/skeptical-review-status.md rename to docs/Research/skeptical-review-status.md diff --git a/Docs/Research/skeptical-review.md b/docs/Research/skeptical-review.md similarity index 96% rename from Docs/Research/skeptical-review.md rename to docs/Research/skeptical-review.md index 98c9783..2d8d756 100644 --- a/Docs/Research/skeptical-review.md +++ b/docs/Research/skeptical-review.md @@ -13,7 +13,7 @@ Qt queue integration, color/display correctness and multi-vendor validation rema Product fit and the UI proposals need task evidence. The earlier research did not justify universal zero-copy/real-time claims, an empty Linux market or competitor complaint rankings. -This review updates all `Docs/Research` topics and their dependent plan, UI, ADR and spike +This review updates all `docs/Research` topics and their dependent plan, UI, ADR and spike notes. It changes documentation, not pipeline behavior. Existing maintainer preferences and accepted ADR decisions are preserved; corrections to their evidence are explicitly dated. diff --git a/Docs/Research/sources.md b/docs/Research/sources.md similarity index 100% rename from Docs/Research/sources.md rename to docs/Research/sources.md diff --git a/Docs/Research/synthesis.md b/docs/Research/synthesis.md similarity index 100% rename from Docs/Research/synthesis.md rename to docs/Research/synthesis.md diff --git a/Docs/Research/vegas-pro-decision.md b/docs/Research/vegas-pro-decision.md similarity index 100% rename from Docs/Research/vegas-pro-decision.md rename to docs/Research/vegas-pro-decision.md diff --git a/Docs/Research/vegas-pro-documentation.md b/docs/Research/vegas-pro-documentation.md similarity index 100% rename from Docs/Research/vegas-pro-documentation.md rename to docs/Research/vegas-pro-documentation.md diff --git a/Docs/Research/vegas-pro-fit.md b/docs/Research/vegas-pro-fit.md similarity index 100% rename from Docs/Research/vegas-pro-fit.md rename to docs/Research/vegas-pro-fit.md diff --git a/Docs/Research/vegas-pro-verification.md b/docs/Research/vegas-pro-verification.md similarity index 100% rename from Docs/Research/vegas-pro-verification.md rename to docs/Research/vegas-pro-verification.md diff --git a/Docs/Research/vegas-pro.md b/docs/Research/vegas-pro.md similarity index 100% rename from Docs/Research/vegas-pro.md rename to docs/Research/vegas-pro.md diff --git a/Docs/Research/vulkan-boundaries.md b/docs/Research/vulkan-boundaries.md similarity index 100% rename from Docs/Research/vulkan-boundaries.md rename to docs/Research/vulkan-boundaries.md diff --git a/Docs/Research/vulkan.md b/docs/Research/vulkan.md similarity index 100% rename from Docs/Research/vulkan.md rename to docs/Research/vulkan.md diff --git a/Docs/adr/0001-build-and-tests.md b/docs/adr/0001-build-and-tests.md similarity index 100% rename from Docs/adr/0001-build-and-tests.md rename to docs/adr/0001-build-and-tests.md diff --git a/Docs/adr/0001-build-language-tests.md b/docs/adr/0001-build-language-tests.md similarity index 97% rename from Docs/adr/0001-build-language-tests.md rename to docs/adr/0001-build-language-tests.md index 086b520..b82d496 100644 --- a/Docs/adr/0001-build-language-tests.md +++ b/docs/adr/0001-build-language-tests.md @@ -16,7 +16,7 @@ concrete binary/source/license packaging check in M7 rather than treating this a ## Context The project needs a reproducible build, sanitizers, tests and linting from the first -commit (`Docs/implementation-plan.md`, M0). The original plan proposed CMake; the +commit (`docs/implementation-plan.md`, M0). The original plan proposed CMake; the maintainer prefers not to use CMake. The test framework was open (GoogleTest or Catch2); the maintainer chose Cest, a header-only framework they wrote. diff --git a/Docs/adr/0001-conventions.md b/docs/adr/0001-conventions.md similarity index 100% rename from Docs/adr/0001-conventions.md rename to docs/adr/0001-conventions.md diff --git a/Docs/adr/0002-decision.md b/docs/adr/0002-decision.md similarity index 100% rename from Docs/adr/0002-decision.md rename to docs/adr/0002-decision.md diff --git a/Docs/adr/0002-time-representation.md b/docs/adr/0002-time-representation.md similarity index 97% rename from Docs/adr/0002-time-representation.md rename to docs/adr/0002-time-representation.md index ce95ad7..d03dfa2 100644 --- a/Docs/adr/0002-time-representation.md +++ b/docs/adr/0002-time-representation.md @@ -22,7 +22,7 @@ No TimeMap implementation or accepted decision is changed by this note. `double` timestamps accumulate error, cannot represent 29.97 fps exactly and break equality comparisons. Real media is often VFR (phones, screen recordings) and mixes timebases (90 kHz in MPEG-TS, 1/30000 in MP4, audio samples at 44.1/48 kHz). Product -research (`Docs/Research/capcut.md` (historical research reference; see the dated review note)) showed speed ramps are a creator requirement, +research (`docs/Research/capcut.md` (historical research reference; see the dated review note)) showed speed ramps are a creator requirement, which means mapping timeline time to media time through a curve, not only a constant speed. ## Decision diff --git a/Docs/adr/0003-decision.md b/docs/adr/0003-decision.md similarity index 100% rename from Docs/adr/0003-decision.md rename to docs/adr/0003-decision.md diff --git a/Docs/adr/0003-threading-and-job-system.md b/docs/adr/0003-threading-and-job-system.md similarity index 97% rename from Docs/adr/0003-threading-and-job-system.md rename to docs/adr/0003-threading-and-job-system.md index e1d5672..6936734 100644 --- a/Docs/adr/0003-threading-and-job-system.md +++ b/docs/adr/0003-threading-and-job-system.md @@ -21,7 +21,7 @@ measure presentation/latency and recovery separately. No thread model is changed The UI thread must never block on decode, encode, thumbnails, waveforms, probing, cache, proxies or imports (CLAUDE.md §13). Threads created ad hoc inside components make cancellation, progress and shutdown unpredictable. Research showed that skimming and the -storyboard zoom depend on cancelling thumbnail work quickly (`Docs/Research/imovie.md` (historical research reference; see the dated review note)). +storyboard zoom depend on cancelling thumbnail work quickly (`docs/Research/imovie.md` (historical research reference; see the dated review note)). ## Decision diff --git a/Docs/adr/0004-amendment.md b/docs/adr/0004-amendment.md similarity index 100% rename from Docs/adr/0004-amendment.md rename to docs/adr/0004-amendment.md diff --git a/Docs/adr/0004-gpu-frames-sync-decode-policy.md b/docs/adr/0004-gpu-frames-sync-decode-policy.md similarity index 98% rename from Docs/adr/0004-gpu-frames-sync-decode-policy.md rename to docs/adr/0004-gpu-frames-sync-decode-policy.md index 6328d85..e5d52c6 100644 --- a/Docs/adr/0004-gpu-frames-sync-decode-policy.md +++ b/docs/adr/0004-gpu-frames-sync-decode-policy.md @@ -29,7 +29,7 @@ this accepted ADR or pipeline behavior as part of a documentation audit. ## Context The pipeline is GPU-first (CLAUDE.md §7): decoded frames should reach the compositor as Vulkan -images on OmaMovie's device, without a CPU copy. Spikes S1 and S2 (`Docs/spikes/`) measured the +images on OmaMovie's device, without a CPU copy. Spikes S1 and S2 (`docs/spikes/`) measured the reference machine (Intel Iris Xe, Mesa 26.2, FFmpeg 9.0.1): - VA-API decodes H.264, HEVC 8/10-bit, AV1 and VP9 by default; Vulkan Video is only exposed diff --git a/Docs/adr/0004-policy.md b/docs/adr/0004-policy.md similarity index 100% rename from Docs/adr/0004-policy.md rename to docs/adr/0004-policy.md diff --git a/Docs/adr/0005-alternatives.md b/docs/adr/0005-alternatives.md similarity index 100% rename from Docs/adr/0005-alternatives.md rename to docs/adr/0005-alternatives.md diff --git a/Docs/adr/0005-producers.md b/docs/adr/0005-producers.md similarity index 100% rename from Docs/adr/0005-producers.md rename to docs/adr/0005-producers.md diff --git a/Docs/adr/0005-qt-vulkan-interop.md b/docs/adr/0005-qt-vulkan-interop.md similarity index 100% rename from Docs/adr/0005-qt-vulkan-interop.md rename to docs/adr/0005-qt-vulkan-interop.md diff --git a/Docs/adr/0005-viewer.md b/docs/adr/0005-viewer.md similarity index 100% rename from Docs/adr/0005-viewer.md rename to docs/adr/0005-viewer.md diff --git a/Docs/adr/0006-alternatives.md b/docs/adr/0006-alternatives.md similarity index 100% rename from Docs/adr/0006-alternatives.md rename to docs/adr/0006-alternatives.md diff --git a/Docs/adr/0006-color-space-and-libplacebo.md b/docs/adr/0006-color-space-and-libplacebo.md similarity index 100% rename from Docs/adr/0006-color-space-and-libplacebo.md rename to docs/adr/0006-color-space-and-libplacebo.md diff --git a/Docs/adr/0007-decision.md b/docs/adr/0007-decision.md similarity index 100% rename from Docs/adr/0007-decision.md rename to docs/adr/0007-decision.md diff --git a/Docs/adr/0007-project-format.md b/docs/adr/0007-project-format.md similarity index 100% rename from Docs/adr/0007-project-format.md rename to docs/adr/0007-project-format.md diff --git a/Docs/adr/0008-project-ir.md b/docs/adr/0008-project-ir.md similarity index 97% rename from Docs/adr/0008-project-ir.md rename to docs/adr/0008-project-ir.md index b8090eb..43d4051 100644 --- a/Docs/adr/0008-project-ir.md +++ b/docs/adr/0008-project-ir.md @@ -39,4 +39,4 @@ a structured report (§16.4). Project files are untrusted input (§18). - The converter, not the importers, decides how IR maps onto timeline commands, so one importer per format stays small and testable without the app. -- Support levels per format and version are recorded in `Docs/interop.md` with their tests. +- Support levels per format and version are recorded in `docs/interop.md` with their tests. diff --git a/Docs/adr/0009-cache.md b/docs/adr/0009-cache.md similarity index 100% rename from Docs/adr/0009-cache.md rename to docs/adr/0009-cache.md diff --git a/Docs/adr/0010-canvas-coordinates.md b/docs/adr/0010-canvas-coordinates.md similarity index 100% rename from Docs/adr/0010-canvas-coordinates.md rename to docs/adr/0010-canvas-coordinates.md diff --git a/Docs/adr/0011-transitions.md b/docs/adr/0011-transitions.md similarity index 100% rename from Docs/adr/0011-transitions.md rename to docs/adr/0011-transitions.md diff --git a/Docs/adr/0012-alternatives.md b/docs/adr/0012-alternatives.md similarity index 100% rename from Docs/adr/0012-alternatives.md rename to docs/adr/0012-alternatives.md diff --git a/Docs/adr/0012-color-grading.md b/docs/adr/0012-color-grading.md similarity index 100% rename from Docs/adr/0012-color-grading.md rename to docs/adr/0012-color-grading.md diff --git a/Docs/adr/0013-alternatives.md b/docs/adr/0013-alternatives.md similarity index 100% rename from Docs/adr/0013-alternatives.md rename to docs/adr/0013-alternatives.md diff --git a/Docs/adr/0013-clip-time-maps.md b/docs/adr/0013-clip-time-maps.md similarity index 100% rename from Docs/adr/0013-clip-time-maps.md rename to docs/adr/0013-clip-time-maps.md diff --git a/Docs/adr/0014-alternatives.md b/docs/adr/0014-alternatives.md similarity index 100% rename from Docs/adr/0014-alternatives.md rename to docs/adr/0014-alternatives.md diff --git a/Docs/adr/0014-connected-clips.md b/docs/adr/0014-connected-clips.md similarity index 100% rename from Docs/adr/0014-connected-clips.md rename to docs/adr/0014-connected-clips.md diff --git a/Docs/adr/0015-titles.md b/docs/adr/0015-titles.md similarity index 100% rename from Docs/adr/0015-titles.md rename to docs/adr/0015-titles.md diff --git a/Docs/adr/0016-integration.md b/docs/adr/0016-integration.md similarity index 100% rename from Docs/adr/0016-integration.md rename to docs/adr/0016-integration.md diff --git a/Docs/adr/0016-stack.md b/docs/adr/0016-stack.md similarity index 100% rename from Docs/adr/0016-stack.md rename to docs/adr/0016-stack.md diff --git a/Docs/adr/0016-video-effects.md b/docs/adr/0016-video-effects.md similarity index 100% rename from Docs/adr/0016-video-effects.md rename to docs/adr/0016-video-effects.md diff --git a/Docs/adr/0017-captions.md b/docs/adr/0017-captions.md similarity index 100% rename from Docs/adr/0017-captions.md rename to docs/adr/0017-captions.md diff --git a/Docs/adr/0018-cmake-build.md b/docs/adr/0018-cmake-build.md similarity index 98% rename from Docs/adr/0018-cmake-build.md rename to docs/adr/0018-cmake-build.md index 2571b42..e862784 100644 --- a/Docs/adr/0018-cmake-build.md +++ b/docs/adr/0018-cmake-build.md @@ -39,7 +39,7 @@ CTest runs the suites and emits JUnit natively, and `CMAKE_EXPORT_COMPILE_COMMAN - One build system of record (CMake); GNU Make is sugar. `module.mk` files are removed. - The dependency-graph guard is reimplemented in CMake (`cmake/OmaDependencyGraph.cmake`); a test or a deliberate check must keep it honest. -- CI (`.github/workflows/ci.yml`, `release.yml`), the PKGBUILD, `Docs/implementation-plan.md` and +- CI (`.github/workflows/ci.yml`, `release.yml`), the PKGBUILD, `docs/implementation-plan.md` and CLAUDE.md §3/§4/§5.1/§5.2 are updated. `cmake` and `ninja` become `makedepends`. - The `--config`/preset names stay `debug`/`release`/`asan`/`tsan`, so muscle memory and CI matrices do not change. `build//omamovie` remains the executable path (the app's relative QML diff --git a/Docs/adr/0018-decision.md b/docs/adr/0018-decision.md similarity index 100% rename from Docs/adr/0018-decision.md rename to docs/adr/0018-decision.md diff --git a/Docs/adr/0019-media-color-interpretation.md b/docs/adr/0019-media-color-interpretation.md similarity index 100% rename from Docs/adr/0019-media-color-interpretation.md rename to docs/adr/0019-media-color-interpretation.md diff --git a/Docs/adr/0020-async-execution-boundary.md b/docs/adr/0020-async-execution-boundary.md similarity index 100% rename from Docs/adr/0020-async-execution-boundary.md rename to docs/adr/0020-async-execution-boundary.md diff --git a/Docs/adr/0020-consequences.md b/docs/adr/0020-consequences.md similarity index 100% rename from Docs/adr/0020-consequences.md rename to docs/adr/0020-consequences.md diff --git a/Docs/adr/README.md b/docs/adr/README.md similarity index 100% rename from Docs/adr/README.md rename to docs/adr/README.md diff --git a/Docs/analysis/analysis-extensibility-conclusion.md b/docs/analysis/analysis-extensibility-conclusion.md similarity index 100% rename from Docs/analysis/analysis-extensibility-conclusion.md rename to docs/analysis/analysis-extensibility-conclusion.md diff --git a/Docs/analysis/analysis-extensibility-coupling.md b/docs/analysis/analysis-extensibility-coupling.md similarity index 100% rename from Docs/analysis/analysis-extensibility-coupling.md rename to docs/analysis/analysis-extensibility-coupling.md diff --git a/Docs/analysis/analysis-extensibility-module-1.md b/docs/analysis/analysis-extensibility-module-1.md similarity index 100% rename from Docs/analysis/analysis-extensibility-module-1.md rename to docs/analysis/analysis-extensibility-module-1.md diff --git a/Docs/analysis/analysis-extensibility-module-2.md b/docs/analysis/analysis-extensibility-module-2.md similarity index 100% rename from Docs/analysis/analysis-extensibility-module-2.md rename to docs/analysis/analysis-extensibility-module-2.md diff --git a/Docs/analysis/analysis-extensibility-module-3.md b/docs/analysis/analysis-extensibility-module-3.md similarity index 100% rename from Docs/analysis/analysis-extensibility-module-3.md rename to docs/analysis/analysis-extensibility-module-3.md diff --git a/Docs/analysis/analysis-extensibility-module-4.md b/docs/analysis/analysis-extensibility-module-4.md similarity index 96% rename from Docs/analysis/analysis-extensibility-module-4.md rename to docs/analysis/analysis-extensibility-module-4.md index f60656e..f53bc78 100644 --- a/Docs/analysis/analysis-extensibility-module-4.md +++ b/docs/analysis/analysis-extensibility-module-4.md @@ -8,7 +8,7 @@ **Pontos de extensão projetados (não codificados ainda):** - **ProjectIR neutro**: `External project -> Importer -> ProjectIR -> converter -> OmaMovie project`. Deve ser independente de modelo interno ([§16.2](CLAUDE.md#162-projectir)). Extender p/ novo formato = novo importer. - **Preservação dados desconhecidos**: tipos `UnknownEffect`, `UnsupportedEffect`, `OpaqueExternalObject` mencionados ([§16.3](CLAUDE.md#163-preserving-external-data)) — ainda não vistos em headers. -- **Suporte por formato+versão** (0–5) + import report ([§16.4–§16.5](CLAUDE.md#164-import-report), [§16.5](CLAUDE.md#165-support-levels)), documentação `Docs/formats/.md` ([§16.6](CLAUDE.md#166-reverse-engineering-rules)). +- **Suporte por formato+versão** (0–5) + import report ([§16.4–§16.5](CLAUDE.md#164-import-report), [§16.5](CLAUDE.md#165-support-levels)), documentação `docs/formats/.md` ([§16.6](CLAUDE.md#166-reverse-engineering-rules)). - `oma-project` CLI ([§16.7](CLAUDE.md#167-oma-project-cli), [tools/oma-project](tools/oma-project)) existe? Verificar: `tools/oma-project/` existe (mencionado). Usa libs/project. **Avaliação:** Design excelente (separação clara). Implementação ainda faltante — **maior lacuna de extensibilidade atual**. Adicionar importer hoje exigiria criar project-ir + converter, respeitando fronteiras (importer não depende de modelo interno). diff --git a/Docs/analysis/analysis-extensibility-module-5.md b/docs/analysis/analysis-extensibility-module-5.md similarity index 100% rename from Docs/analysis/analysis-extensibility-module-5.md rename to docs/analysis/analysis-extensibility-module-5.md diff --git a/Docs/analysis/analysis-extensibility-module-6.md b/docs/analysis/analysis-extensibility-module-6.md similarity index 100% rename from Docs/analysis/analysis-extensibility-module-6.md rename to docs/analysis/analysis-extensibility-module-6.md diff --git a/Docs/analysis/analysis-extensibility-modules.md b/docs/analysis/analysis-extensibility-modules.md similarity index 100% rename from Docs/analysis/analysis-extensibility-modules.md rename to docs/analysis/analysis-extensibility-modules.md diff --git a/Docs/analysis/analysis-extensibility-overview.md b/docs/analysis/analysis-extensibility-overview.md similarity index 100% rename from Docs/analysis/analysis-extensibility-overview.md rename to docs/analysis/analysis-extensibility-overview.md diff --git a/Docs/analysis/analysis-extensibility-recommendations.md b/docs/analysis/analysis-extensibility-recommendations.md similarity index 100% rename from Docs/analysis/analysis-extensibility-recommendations.md rename to docs/analysis/analysis-extensibility-recommendations.md diff --git a/Docs/analysis/analysis-extensibility-scope.md b/docs/analysis/analysis-extensibility-scope.md similarity index 100% rename from Docs/analysis/analysis-extensibility-scope.md rename to docs/analysis/analysis-extensibility-scope.md diff --git a/Docs/analysis/analysis-extensibility-versions.md b/docs/analysis/analysis-extensibility-versions.md similarity index 100% rename from Docs/analysis/analysis-extensibility-versions.md rename to docs/analysis/analysis-extensibility-versions.md diff --git a/Docs/analysis/analysis-extensibility.md b/docs/analysis/analysis-extensibility.md similarity index 100% rename from Docs/analysis/analysis-extensibility.md rename to docs/analysis/analysis-extensibility.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-code.md b/docs/analysis/analysis-flickering-hyprland-quickshell-code.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-code.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-code.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-conclusion.md b/docs/analysis/analysis-flickering-hyprland-quickshell-conclusion.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-conclusion.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-conclusion.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-context.md b/docs/analysis/analysis-flickering-hyprland-quickshell-context.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-context.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-context.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-diagnostics.md b/docs/analysis/analysis-flickering-hyprland-quickshell-diagnostics.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-diagnostics.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-diagnostics.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-hypotheses.md b/docs/analysis/analysis-flickering-hyprland-quickshell-hypotheses.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-hypotheses.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-hypotheses.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-mitigations.md b/docs/analysis/analysis-flickering-hyprland-quickshell-mitigations.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-mitigations.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-mitigations.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell-validation.md b/docs/analysis/analysis-flickering-hyprland-quickshell-validation.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell-validation.md rename to docs/analysis/analysis-flickering-hyprland-quickshell-validation.md diff --git a/Docs/analysis/analysis-flickering-hyprland-quickshell.md b/docs/analysis/analysis-flickering-hyprland-quickshell.md similarity index 100% rename from Docs/analysis/analysis-flickering-hyprland-quickshell.md rename to docs/analysis/analysis-flickering-hyprland-quickshell.md diff --git a/Docs/analysis/analysis-implementation-conclusion.md b/docs/analysis/analysis-implementation-conclusion.md similarity index 100% rename from Docs/analysis/analysis-implementation-conclusion.md rename to docs/analysis/analysis-implementation-conclusion.md diff --git a/Docs/analysis/analysis-implementation-data-flow.md b/docs/analysis/analysis-implementation-data-flow.md similarity index 100% rename from Docs/analysis/analysis-implementation-data-flow.md rename to docs/analysis/analysis-implementation-data-flow.md diff --git a/Docs/analysis/analysis-implementation-dependencies.md b/docs/analysis/analysis-implementation-dependencies.md similarity index 100% rename from Docs/analysis/analysis-implementation-dependencies.md rename to docs/analysis/analysis-implementation-dependencies.md diff --git a/Docs/analysis/analysis-implementation-gaps.md b/docs/analysis/analysis-implementation-gaps.md similarity index 100% rename from Docs/analysis/analysis-implementation-gaps.md rename to docs/analysis/analysis-implementation-gaps.md diff --git a/Docs/analysis/analysis-implementation-milestones.md b/docs/analysis/analysis-implementation-milestones.md similarity index 96% rename from Docs/analysis/analysis-implementation-milestones.md rename to docs/analysis/analysis-implementation-milestones.md index 0c30f2c..6a2a779 100644 --- a/Docs/analysis/analysis-implementation-milestones.md +++ b/docs/analysis/analysis-implementation-milestones.md @@ -1,6 +1,6 @@ ## 6. Estado Atual vs Milestones (M0–M11) -Baseado em [Docs/implementation-plan.md](../implementation-plan.md) e código inspecionado: +Baseado em [docs/implementation-plan.md](../implementation-plan.md) e código inspecionado: | Milestone | Status (plan + código) | Evidências | |---|---|---| @@ -10,7 +10,7 @@ Baseado em [Docs/implementation-plan.md](../implementation-plan.md) e código in | M3 Compositor | ✅ Implementado (RenderGraph, CpuCompositor, VulkanCompositor, shaders SPIR-V, display encode sRGB). | [compositor](libs/compositor), [render_graph.hpp](libs/compositor/include/oma/compositor/render_graph.hpp), [ADR-0006](../adr/0006-color-space-and-libplacebo.md) | | M4 Playback/audio + preview | Parcial. Audio clock (PipeWire) existe, playback segue audio clock. Preview Qt/Vulkan com shared image (sem readback). Medições M4 com interpolated clock documentadas ([evidence 2026-10-06](../Research/evidence/2026-10-06-m4-hardware-gate.txt)). Itens: export thread safety/admission, device loss completo, 4K/HEVC/AV1 stress, long seeks. | [preview_item](apps/omamovie/src/preview_item.*), [session](apps/omamovie/src/session.*), [audio](libs/audio), [ADR-0005](../adr/0005-qt-vulkan-interop.md) | | M5 Timeline model | ✅ Core existe (model, commands, undo/redo, Editor, TimeMap, validate). GUI storyline edita via timeline Editor. | [timeline](libs/timeline), [model.hpp](libs/timeline/include/oma/timeline/model.hpp), [editor.hpp](libs/timeline/include/oma/timeline/editor.hpp), [ADR-0002](../adr/0002-time-representation.md), [ADR-0013](../adr/0013-clip-time-maps.md), [ADR-0014](../adr/0014-connected-clips.md) | -| M6 UI | Parcial — app Qt Quick existe (`apps/omamovie`), QML, SettingsDialog, drawer de ajustes mencionado em design. UI conceitual [Docs/ui-design.md](../ui-design.md). Completo conforme critérios M6? Não totalmente verificado (falta checar todos deliverables). | [apps/omamovie/qml](apps/omamovie/qml), [ui-design.md](../ui-design.md) | +| M6 UI | Parcial — app Qt Quick existe (`apps/omamovie`), QML, SettingsDialog, drawer de ajustes mencionado em design. UI conceitual [docs/ui-design.md](../ui-design.md). Completo conforme critérios M6? Não totalmente verificado (falta checar todos deliverables). | [apps/omamovie/qml](apps/omamovie/qml), [ui-design.md](../ui-design.md) | | M7 Project + export | Iniciado. `libs/project` salva/carrega formato nativo (ADR-0007) — **não yet wired to the app** ([CLAUDE.md §0](CLAUDE.md#0-repository-status)). Export ainda faltando. Migrações vN→vN+1 implementadas parcialmente (v2,v3 adicionados). | [project](libs/project), [ADR-0007](../adr/0007-project-format.md), [effects v4](../adr/0016-video-effects.md#implementation-notes-2026-10-07) | | M8–M11 | Posteriores. Effects stack (ADR-0016, native format 4) já implementado adiantadamente ([CLAUDE.md §0](CLAUDE.md#0-repository-status)), color grading (ADR-0012), transitions (ADR-0011), títulos (ADR-0015), captions model (ADR-0017). Export (M7) e interop (M9, project-ir/importers) pendentes. | [ADR-0016](../adr/0016-video-effects.md), [ADR-0012](../adr/0012-color-grading.md), [ADR-0011](../adr/0011-transitions.md), [ADR-0015](../adr/0015-titles.md), [ADR-0017](../adr/0017-captions.md) | diff --git a/Docs/analysis/analysis-implementation-overview.md b/docs/analysis/analysis-implementation-overview.md similarity index 100% rename from Docs/analysis/analysis-implementation-overview.md rename to docs/analysis/analysis-implementation-overview.md diff --git a/Docs/analysis/analysis-implementation-strengths.md b/docs/analysis/analysis-implementation-strengths.md similarity index 100% rename from Docs/analysis/analysis-implementation-strengths.md rename to docs/analysis/analysis-implementation-strengths.md diff --git a/Docs/analysis/analysis-implementation-structure.md b/docs/analysis/analysis-implementation-structure.md similarity index 100% rename from Docs/analysis/analysis-implementation-structure.md rename to docs/analysis/analysis-implementation-structure.md diff --git a/Docs/analysis/analysis-implementation-threading.md b/docs/analysis/analysis-implementation-threading.md similarity index 100% rename from Docs/analysis/analysis-implementation-threading.md rename to docs/analysis/analysis-implementation-threading.md diff --git a/Docs/analysis/analysis-implementation.md b/docs/analysis/analysis-implementation.md similarity index 100% rename from Docs/analysis/analysis-implementation.md rename to docs/analysis/analysis-implementation.md diff --git a/Docs/analysis/analysis-integral-consolidado-matrix.md b/docs/analysis/analysis-integral-consolidado-matrix.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-matrix.md rename to docs/analysis/analysis-integral-consolidado-matrix.md diff --git a/Docs/analysis/analysis-integral-consolidado-overview.md b/docs/analysis/analysis-integral-consolidado-overview.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-overview.md rename to docs/analysis/analysis-integral-consolidado-overview.md diff --git a/Docs/analysis/analysis-integral-consolidado-plan.md b/docs/analysis/analysis-integral-consolidado-plan.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-plan.md rename to docs/analysis/analysis-integral-consolidado-plan.md diff --git a/Docs/analysis/analysis-integral-consolidado-recommendations.md b/docs/analysis/analysis-integral-consolidado-recommendations.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-recommendations.md rename to docs/analysis/analysis-integral-consolidado-recommendations.md diff --git a/Docs/analysis/analysis-integral-consolidado-risks.md b/docs/analysis/analysis-integral-consolidado-risks.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-risks.md rename to docs/analysis/analysis-integral-consolidado-risks.md diff --git a/Docs/analysis/analysis-integral-consolidado-verdict.md b/docs/analysis/analysis-integral-consolidado-verdict.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado-verdict.md rename to docs/analysis/analysis-integral-consolidado-verdict.md diff --git a/Docs/analysis/analysis-integral-consolidado.md b/docs/analysis/analysis-integral-consolidado.md similarity index 100% rename from Docs/analysis/analysis-integral-consolidado.md rename to docs/analysis/analysis-integral-consolidado.md diff --git a/Docs/analysis/claude-context-audit-2026-10-15.md b/docs/analysis/claude-context-audit-2026-10-15.md similarity index 96% rename from Docs/analysis/claude-context-audit-2026-10-15.md rename to docs/analysis/claude-context-audit-2026-10-15.md index b3e3212..c4f9425 100644 --- a/Docs/analysis/claude-context-audit-2026-10-15.md +++ b/docs/analysis/claude-context-audit-2026-10-15.md @@ -5,7 +5,7 @@ implementation-plan/ADR/UX/evidence indexes, README, and the 20 `SKILL.md` entri local Skill-Library. The current guide is a router; `git show HEAD:CLAUDE.md` preserves the old text for historical references. This audit records placement decisions, not new implementation claims. The user's uncommitted stress command was already described by -`Docs/spikes/session-stress.md` and `tools/bench/stress/`; it was not discarded as work. +`docs/spikes/session-stress.md` and `tools/bench/stress/`; it was not discarded as work. ## Former guide disposition @@ -18,7 +18,7 @@ implementation claims. The user's uncommitted stress command was already describ | 6 time | MOVE TO ADR | ADR-0002 and `libs/base` own rational time and conversion rules | | 7 GPU/decode/color, 8 media frames, 9 compositor | MOVE TO ADR / OUTDATED | ADR-0004/0005/0006 and M12; old target treated export like a no-readback path while code reads NV12 back | | 10 timeline, 11 UI, 12 audio, 13 concurrency | MOVE TO DOCS / ADR | M4–M6, UI design, ADR-0003/0014/0020 and code; retain only stable engineering preferences | -| 14 project, 15 cache, 16 interop, 17 SQLite | MOVE TO DOCS / ADR / DELETE | ADR-0007/0008/0009, M7, `Docs/interop.md`; speculative SQLite guidance is not a current implementation fact | +| 14 project, 15 cache, 16 interop, 17 SQLite | MOVE TO DOCS / ADR / DELETE | ADR-0007/0008/0009, M7, `docs/interop.md`; speculative SQLite guidance is not a current implementation fact | | 18 parser safety, 19 logs/errors | MOVE TO DOCS / ADR | QA plan and base/media/project contracts; reusable review method belongs in skills, not an OmaMovie manifesto | | 20 ADR process, 21 agent rules | SHORTEN / MOVE TO CONTRIBUTING | ADR index and short change protocol retain the actionable part; blanket “ask before” list was too broad | | 22 C++ conventions, 25 test mechanics | MOVE TO CONTRIBUTING / ADR | ADR-0001, formatting config, tests and contributor guide; Cest macro details remain discoverable in tests | @@ -28,7 +28,7 @@ The older guide had a critical drift: its §7.2 described GPU readback as forbid playback/export, while `exporter.cpp` explicitly reads NV12/RGBA back and `video_writer.cpp` uploads to a VA-API surface. It also listed `ComputeBackend` and multi-backend types as architecture without checking their existence. Historical -`Docs/analysis/` pages and source comments still cite old section numbers; the router +`docs/analysis/` pages and source comments still cite old section numbers; the router contains a compact pointer map until touched comments are linked directly to ADRs/code. Do not mistake that compatibility map for active architectural authority. @@ -91,6 +91,6 @@ different outputs; invoking all four for a routine edit creates duplicate ceremo encoder input remain unvalidated or planned. Distinguish code presence from the support commitment in each public claim. - **Documentation drift:** README still calls OTIO/FCPXML wholly planned, while M9/code - implement bounded importers with fidelity gaps. `Docs/adr/README.md` still describes + implement bounded importers with fidelity gaps. `docs/adr/README.md` still describes ADR-0005 on-screen handoff as pending although its body and preview code say otherwise. These are independent documentation corrections; neither expands the support matrix. diff --git a/Docs/analysis/m11-inventory-2026-10-14.md b/docs/analysis/m11-inventory-2026-10-14.md similarity index 100% rename from Docs/analysis/m11-inventory-2026-10-14.md rename to docs/analysis/m11-inventory-2026-10-14.md diff --git a/Docs/analysis/m11-paused-hardware-seek-note.md b/docs/analysis/m11-paused-hardware-seek-note.md similarity index 100% rename from Docs/analysis/m11-paused-hardware-seek-note.md rename to docs/analysis/m11-paused-hardware-seek-note.md diff --git a/Docs/analysis/m11-transport-owner-note.md b/docs/analysis/m11-transport-owner-note.md similarity index 100% rename from Docs/analysis/m11-transport-owner-note.md rename to docs/analysis/m11-transport-owner-note.md diff --git a/Docs/analysis/omamovie-2026-10-12-app.md b/docs/analysis/omamovie-2026-10-12-app.md similarity index 98% rename from Docs/analysis/omamovie-2026-10-12-app.md rename to docs/analysis/omamovie-2026-10-12-app.md index a12c008..83c7dfd 100644 --- a/Docs/analysis/omamovie-2026-10-12-app.md +++ b/docs/analysis/omamovie-2026-10-12-app.md @@ -22,7 +22,7 @@ | ActionRegistry | implemented but incomplete as automation | `apps/omamovie/src/action_registry.cpp:47,228`; stable discrete IDs, no parameter schema | | Session and QML integration | architecture risk; implemented | `session.hpp:236`, `session.cpp`; many responsibilities and context-chain QML IDs | | GUI smoke/Qt Test | implemented but incomplete | `main.cpp:752`, `tests/app/main.cpp`; real-window smoke manual, QML tree not in PR CI | -| Benchmarks | implemented but incomplete | `Docs/Research/evidence/`, audit flags; no full 10k/3h or same-task comparator | +| Benchmarks | implemented but incomplete | `docs/Research/evidence/`, audit flags; no full 10k/3h or same-task comparator | | Interchange | planned | `implementation-plan-m9-interop-color.md`; no OTIO/FCPXML importer claim | | Media bins/search/proxies | planned | M8/M9 pilots; library and relink exist, scalable organization not proved | diff --git a/Docs/analysis/omamovie-2026-10-12-core.md b/docs/analysis/omamovie-2026-10-12-core.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-core.md rename to docs/analysis/omamovie-2026-10-12-core.md diff --git a/Docs/analysis/omamovie-2026-10-12-filmcraft.md b/docs/analysis/omamovie-2026-10-12-filmcraft.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-filmcraft.md rename to docs/analysis/omamovie-2026-10-12-filmcraft.md diff --git a/Docs/analysis/omamovie-2026-10-12-foundation.md b/docs/analysis/omamovie-2026-10-12-foundation.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-foundation.md rename to docs/analysis/omamovie-2026-10-12-foundation.md diff --git a/Docs/analysis/omamovie-2026-10-12-milestones.md b/docs/analysis/omamovie-2026-10-12-milestones.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-milestones.md rename to docs/analysis/omamovie-2026-10-12-milestones.md diff --git a/Docs/analysis/omamovie-2026-10-12-performance.md b/docs/analysis/omamovie-2026-10-12-performance.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-performance.md rename to docs/analysis/omamovie-2026-10-12-performance.md diff --git a/Docs/analysis/omamovie-2026-10-12-priorities.md b/docs/analysis/omamovie-2026-10-12-priorities.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-priorities.md rename to docs/analysis/omamovie-2026-10-12-priorities.md diff --git a/Docs/analysis/omamovie-2026-10-12-workflows.md b/docs/analysis/omamovie-2026-10-12-workflows.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12-workflows.md rename to docs/analysis/omamovie-2026-10-12-workflows.md diff --git a/Docs/analysis/omamovie-2026-10-12.md b/docs/analysis/omamovie-2026-10-12.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-12.md rename to docs/analysis/omamovie-2026-10-12.md diff --git a/Docs/analysis/omamovie-2026-10-14-filmcraft-benchmarks.md b/docs/analysis/omamovie-2026-10-14-filmcraft-benchmarks.md similarity index 100% rename from Docs/analysis/omamovie-2026-10-14-filmcraft-benchmarks.md rename to docs/analysis/omamovie-2026-10-14-filmcraft-benchmarks.md diff --git a/Docs/format-architecture.md b/docs/format-architecture.md similarity index 100% rename from Docs/format-architecture.md rename to docs/format-architecture.md diff --git a/Docs/formats/edl.md b/docs/formats/edl.md similarity index 100% rename from Docs/formats/edl.md rename to docs/formats/edl.md diff --git a/Docs/formats/fcpxml.md b/docs/formats/fcpxml.md similarity index 100% rename from Docs/formats/fcpxml.md rename to docs/formats/fcpxml.md diff --git a/Docs/formats/mlt.md b/docs/formats/mlt.md similarity index 100% rename from Docs/formats/mlt.md rename to docs/formats/mlt.md diff --git a/Docs/implementation-plan-agent-assisted-mcp.md b/docs/implementation-plan-agent-assisted-mcp.md similarity index 100% rename from Docs/implementation-plan-agent-assisted-mcp.md rename to docs/implementation-plan-agent-assisted-mcp.md diff --git a/Docs/implementation-plan-async-interactive.md b/docs/implementation-plan-async-interactive.md similarity index 100% rename from Docs/implementation-plan-async-interactive.md rename to docs/implementation-plan-async-interactive.md diff --git a/Docs/implementation-plan-audio-editing.md b/docs/implementation-plan-audio-editing.md similarity index 100% rename from Docs/implementation-plan-audio-editing.md rename to docs/implementation-plan-audio-editing.md diff --git a/Docs/implementation-plan-code-cleanup.md b/docs/implementation-plan-code-cleanup.md similarity index 100% rename from Docs/implementation-plan-code-cleanup.md rename to docs/implementation-plan-code-cleanup.md diff --git a/Docs/implementation-plan-code-review-2.md b/docs/implementation-plan-code-review-2.md similarity index 100% rename from Docs/implementation-plan-code-review-2.md rename to docs/implementation-plan-code-review-2.md diff --git a/Docs/implementation-plan-code-review-3.md b/docs/implementation-plan-code-review-3.md similarity index 100% rename from Docs/implementation-plan-code-review-3.md rename to docs/implementation-plan-code-review-3.md diff --git a/Docs/implementation-plan-code-review-4.md b/docs/implementation-plan-code-review-4.md similarity index 100% rename from Docs/implementation-plan-code-review-4.md rename to docs/implementation-plan-code-review-4.md diff --git a/Docs/implementation-plan-code-review-5.md b/docs/implementation-plan-code-review-5.md similarity index 100% rename from Docs/implementation-plan-code-review-5.md rename to docs/implementation-plan-code-review-5.md diff --git a/Docs/implementation-plan-code-review.md b/docs/implementation-plan-code-review.md similarity index 100% rename from Docs/implementation-plan-code-review.md rename to docs/implementation-plan-code-review.md diff --git a/Docs/implementation-plan-community-effect-packs.md b/docs/implementation-plan-community-effect-packs.md similarity index 100% rename from Docs/implementation-plan-community-effect-packs.md rename to docs/implementation-plan-community-effect-packs.md diff --git a/Docs/implementation-plan-cross-editor-benchmarks.md b/docs/implementation-plan-cross-editor-benchmarks.md similarity index 99% rename from Docs/implementation-plan-cross-editor-benchmarks.md rename to docs/implementation-plan-cross-editor-benchmarks.md index bdbfddd..1501dd0 100644 --- a/Docs/implementation-plan-cross-editor-benchmarks.md +++ b/docs/implementation-plan-cross-editor-benchmarks.md @@ -114,7 +114,7 @@ source for one editor. A famous name alone does not make a useful comparator. [M10](implementation-plan-m10-validation.md); benchmark runs are evidence, not CI pass/fail tests against another product. - [ ] Store raw results, commands, versions, fixture hashes and deviations under - `Docs/Research/evidence/`; publish a concise comparison with uncertainty, output + `docs/Research/evidence/`; publish a concise comparison with uncertainty, output correctness and explicit `not comparable` cells. Recheck candidate support when the experiment actually runs. diff --git a/Docs/implementation-plan-cross-editor-workflow.md b/docs/implementation-plan-cross-editor-workflow.md similarity index 100% rename from Docs/implementation-plan-cross-editor-workflow.md rename to docs/implementation-plan-cross-editor-workflow.md diff --git a/Docs/implementation-plan-decisions-adrs.md b/docs/implementation-plan-decisions-adrs.md similarity index 100% rename from Docs/implementation-plan-decisions-adrs.md rename to docs/implementation-plan-decisions-adrs.md diff --git a/Docs/implementation-plan-evidence-2026-10-14.md b/docs/implementation-plan-evidence-2026-10-14.md similarity index 100% rename from Docs/implementation-plan-evidence-2026-10-14.md rename to docs/implementation-plan-evidence-2026-10-14.md diff --git a/Docs/implementation-plan-filmcraft-breadth.md b/docs/implementation-plan-filmcraft-breadth.md similarity index 100% rename from Docs/implementation-plan-filmcraft-breadth.md rename to docs/implementation-plan-filmcraft-breadth.md diff --git a/Docs/implementation-plan-goal.md b/docs/implementation-plan-goal.md similarity index 100% rename from Docs/implementation-plan-goal.md rename to docs/implementation-plan-goal.md diff --git a/Docs/implementation-plan-hardware-matrix.md b/docs/implementation-plan-hardware-matrix.md similarity index 100% rename from Docs/implementation-plan-hardware-matrix.md rename to docs/implementation-plan-hardware-matrix.md diff --git a/Docs/implementation-plan-m0-foundation.md b/docs/implementation-plan-m0-foundation.md similarity index 100% rename from Docs/implementation-plan-m0-foundation.md rename to docs/implementation-plan-m0-foundation.md diff --git a/Docs/implementation-plan-m1-hardware-spikes.md b/docs/implementation-plan-m1-hardware-spikes.md similarity index 90% rename from Docs/implementation-plan-m1-hardware-spikes.md rename to docs/implementation-plan-m1-hardware-spikes.md index 6919e29..50fee95 100644 --- a/Docs/implementation-plan-m1-hardware-spikes.md +++ b/docs/implementation-plan-m1-hardware-spikes.md @@ -1,16 +1,16 @@ ### M1 — Hardware spikes Code in `tools/spikes/`, disposable; whatever proves its value moves to the libs in M2/M3. -Results in `Docs/spikes/Sn-.md` with numbers, driver versions and a conclusion. +Results in `docs/spikes/Sn-.md` with numbers, driver versions and a conclusion. | Spike | Question | Done when | Feeds | |---|---|---|---| -| **S1** Inventory ✅ | Which codecs/profiles does the Iris Xe decode and encode through Vulkan Video, VA-API and QSV? | Codec × API × bit depth table — **done**, see `Docs/spikes/S1-hardware-inventory.md`: VA-API is the default decode path; Vulkan Video is behind `ANV_DEBUG` on TigerLake; Vulkan compute codecs (ProRes, FFv1) work without flags | ADR-0004 | -| **S2** FFmpeg on OmaMovie's device ✅ | Does the installed FFmpeg accept a `VkDevice` created with Vulkan-Hpp and deliver `AVVkFrame` without readback? How does queue locking work? | H.264/HEVC/AV1 decoded into `AVVkFrame`, no explicit host transfer reported in the application mapping path — **prototype done; follow-up validation pending**, see `Docs/spikes/S2-ffmpeg-own-device.md`: VA-API → DMA-BUF → Vulkan on our device, exact luma, no `AV_HWFRAME_MAP_DIRECT`; queues via `VK_KHR_internally_synchronized_queues` | ADR-0004 | -| **S3** Decode/encode paths ✅ | VA-API vs. QSV (vs. flagged Vulkan Video, for reference) per codec on the Iris Xe; FFv1 vs. ProRes for proxies | Frame time, CPU and power per codec; written selection policy — **decode done** (2026-10-04), see `Docs/spikes/S3-decode-paths.md`: QSV adds nothing over VA-API (keep ADR-0004 order); hardware decode saves 5–6 cores at 1080p60, not throughput; ProRes (intra, CPU-encoded: `prores_ks_vulkan` output is invalid at 1080p) is the proxy candidate, FFv1 Vulkan decode runs at 19 fps. Power not measured (RAPL root-only); export encode paths moved to M7 | ADR-0004 | +| **S1** Inventory ✅ | Which codecs/profiles does the Iris Xe decode and encode through Vulkan Video, VA-API and QSV? | Codec × API × bit depth table — **done**, see `docs/spikes/S1-hardware-inventory.md`: VA-API is the default decode path; Vulkan Video is behind `ANV_DEBUG` on TigerLake; Vulkan compute codecs (ProRes, FFv1) work without flags | ADR-0004 | +| **S2** FFmpeg on OmaMovie's device ✅ | Does the installed FFmpeg accept a `VkDevice` created with Vulkan-Hpp and deliver `AVVkFrame` without readback? How does queue locking work? | H.264/HEVC/AV1 decoded into `AVVkFrame`, no explicit host transfer reported in the application mapping path — **prototype done; follow-up validation pending**, see `docs/spikes/S2-ffmpeg-own-device.md`: VA-API → DMA-BUF → Vulkan on our device, exact luma, no `AV_HWFRAME_MAP_DIRECT`; queues via `VK_KHR_internally_synchronized_queues` | ADR-0004 | +| **S3** Decode/encode paths ✅ | VA-API vs. QSV (vs. flagged Vulkan Video, for reference) per codec on the Iris Xe; FFv1 vs. ProRes for proxies | Frame time, CPU and power per codec; written selection policy — **decode done** (2026-10-04), see `docs/spikes/S3-decode-paths.md`: QSV adds nothing over VA-API (keep ADR-0004 order); hardware decode saves 5–6 cores at 1080p60, not throughput; ProRes (intra, CPU-encoded: `prores_ks_vulkan` output is invalid at 1080p) is the proxy candidate, FFv1 Vulkan decode runs at 19 fps. Power not measured (RAPL root-only); export encode paths moved to M7 | ADR-0004 | | **S4** Qt Quick on the same device ✅ | Can Qt Quick present a compositor image on the same device without a render-path readback? | The repeatable offscreen diagnostic checks identical physical/logical device and queue, borrowed compositor-image pixels and 60 frames with no validation errors. A prior static visible experiment passed bounded queue contention. Its test-pattern window was replaced after user feedback: `make run-gui` now opens real videos with a temporary software-frame upload. Production on-screen GPU handoff belongs to M4. See [S4](spikes/S4-qt-shared-device.md) | ADR-0005 | -| **S5** Minimal compositing ✅ | 2 videos + 1 image with transform/crop/opacity and YUV→RGB | 1080p60 frame time measured and recorded — **done** (2026-10-04), see `Docs/spikes/S5-minimal-compositing.md`: needed RGB image support (planar GBR from the decoder); sequential decode + composite p50 8.2–8.3 ms with VA-API (3–4 of 600 frames over 16.67 ms), 9.1–9.3 ms software with a tail to 22 ms; no presentation | M3 | -| **S6** libplacebo ✅ | Does it operate on OmaMovie's images/device without copies? Quality and cost? | Decision "use libplacebo for color/scaling/LUT or our own shaders" — **done** (2026-10-04), see `Docs/spikes/S6-libplacebo.md`: works on our device and images without copies (zero-flag queues); our shaders kept (display encode within 1 level of the formula vs 4; equal or lower cost); libplacebo is the candidate for HDR tone mapping and export scaling. Found and fixed three `gpu`/`media` defects on the way (sync-queue extension on zero-flag devices broke VA-API mapping; swapchain without surface; per-plane VA-API image formats) | ADR-0006 | +| **S5** Minimal compositing ✅ | 2 videos + 1 image with transform/crop/opacity and YUV→RGB | 1080p60 frame time measured and recorded — **done** (2026-10-04), see `docs/spikes/S5-minimal-compositing.md`: needed RGB image support (planar GBR from the decoder); sequential decode + composite p50 8.2–8.3 ms with VA-API (3–4 of 600 frames over 16.67 ms), 9.1–9.3 ms software with a tail to 22 ms; no presentation | M3 | +| **S6** libplacebo ✅ | Does it operate on OmaMovie's images/device without copies? Quality and cost? | Decision "use libplacebo for color/scaling/LUT or our own shaders" — **done** (2026-10-04), see `docs/spikes/S6-libplacebo.md`: works on our device and images without copies (zero-flag queues); our shaders kept (display encode within 1 level of the formula vs 4; equal or lower cost); libplacebo is the candidate for HDR tone mapping and export scaling. Found and fixed three `gpu`/`media` defects on the way (sync-queue extension on zero-flag devices broke VA-API mapping; swapchain without surface; per-plane VA-API image formats) | ADR-0006 | S7 (NVIDIA path) and S8 (AMD) need other hardware; they are scheduled for when a machine is available (§6). diff --git a/Docs/implementation-plan-m10-validation.md b/docs/implementation-plan-m10-validation.md similarity index 100% rename from Docs/implementation-plan-m10-validation.md rename to docs/implementation-plan-m10-validation.md diff --git a/Docs/implementation-plan-m11-refactoring.md b/docs/implementation-plan-m11-refactoring.md similarity index 100% rename from Docs/implementation-plan-m11-refactoring.md rename to docs/implementation-plan-m11-refactoring.md diff --git a/Docs/implementation-plan-m12-gpu-export-architecture.md b/docs/implementation-plan-m12-gpu-export-architecture.md similarity index 99% rename from Docs/implementation-plan-m12-gpu-export-architecture.md rename to docs/implementation-plan-m12-gpu-export-architecture.md index 1a8ef0b..105561b 100644 --- a/Docs/implementation-plan-m12-gpu-export-architecture.md +++ b/docs/implementation-plan-m12-gpu-export-architecture.md @@ -32,7 +32,7 @@ transport owner would need too many shared inputs, so it is not an automatic ext Count frames and bytes per boundary and time GPU waits/readbacks separately from render and encode. Record path and downgrade reason. Run the same pinned 1080p60 Intel fixture and at least one 4K fixture, with driver, codec, profile, resolution, rate, effects, - hardware/software choice and repeat count in `Docs/Research/evidence/`. Preserve the + hardware/software choice and repeat count in `docs/Research/evidence/`. Preserve the existing independent output decode. *Partial (2026-10-15):* explicit software-input, NV12 readback, writer row-copy and VA-API upload counts/bytes/timings are instrumented; a [single-run 1080p60/4K baseline](Research/evidence/2026-10-15-export-transfer-baseline.md) diff --git a/Docs/implementation-plan-m2-gpu-media.md b/docs/implementation-plan-m2-gpu-media.md similarity index 100% rename from Docs/implementation-plan-m2-gpu-media.md rename to docs/implementation-plan-m2-gpu-media.md diff --git a/Docs/implementation-plan-m3-compositor.md b/docs/implementation-plan-m3-compositor.md similarity index 100% rename from Docs/implementation-plan-m3-compositor.md rename to docs/implementation-plan-m3-compositor.md diff --git a/Docs/implementation-plan-m4-playback-audio.md b/docs/implementation-plan-m4-playback-audio.md similarity index 100% rename from Docs/implementation-plan-m4-playback-audio.md rename to docs/implementation-plan-m4-playback-audio.md diff --git a/Docs/implementation-plan-m5-timeline.md b/docs/implementation-plan-m5-timeline.md similarity index 100% rename from Docs/implementation-plan-m5-timeline.md rename to docs/implementation-plan-m5-timeline.md diff --git a/Docs/implementation-plan-m6-ui.md b/docs/implementation-plan-m6-ui.md similarity index 99% rename from Docs/implementation-plan-m6-ui.md rename to docs/implementation-plan-m6-ui.md index 7bd7cdb..c634197 100644 --- a/Docs/implementation-plan-m6-ui.md +++ b/docs/implementation-plan-m6-ui.md @@ -1,6 +1,6 @@ ### M6 — UI -Reference design: `Docs/ui-design.md`. +Reference design: `docs/ui-design.md`. UI/UX tasks and acceptance criteria: [TDDO](ui-ux-tddo.md). - [x] Qt Quick shell: MediaPanel, PreviewPanel, TimelineView, Inspector, TransportControls. *2026-10-04*: no permanent adjustments bar (the clip's context menu opens the drawers and marks active adjustments); the library sidebar hides in any window width, leaving the viewer centered. *Done (2026-10-06)*: `Main.qml` (2,913 lines) was split without behavior changes into `ProjectsScreen`, `MediaPanel`, `PreviewPanel`, `TransportControls`, `TimelineView`, the inspector drawers (`InfoDrawer`, `VolumeDrawer`, `ColorDrawer`, `CropDrawer`, `EffectsDrawer`, with `DrawerSlider` shared) and `SettingsDialog`/`CommandPalette`; `Main.qml` keeps the window, the action registry, dialogs and layout (603 lines). Each block moved only after checking that no id inside it was used outside (the clip-menu opener moved into `TimelineView`); the GUI smoke passed after every step. The panels still read the window's ids (`root`, `actions`, `session`) through QML's context chain; making those explicit properties is the next step if `pragma ComponentBehavior: Bound` or qmllint's unqualified-access check is adopted. diff --git a/Docs/implementation-plan-m7-project-export.md b/docs/implementation-plan-m7-project-export.md similarity index 100% rename from Docs/implementation-plan-m7-project-export.md rename to docs/implementation-plan-m7-project-export.md diff --git a/Docs/implementation-plan-m8-creator.md b/docs/implementation-plan-m8-creator.md similarity index 100% rename from Docs/implementation-plan-m8-creator.md rename to docs/implementation-plan-m8-creator.md diff --git a/Docs/implementation-plan-m9-interop-color.md b/docs/implementation-plan-m9-interop-color.md similarity index 98% rename from Docs/implementation-plan-m9-interop-color.md rename to docs/implementation-plan-m9-interop-color.md index 2c3c1df..d588270 100644 --- a/Docs/implementation-plan-m9-interop-color.md +++ b/docs/implementation-plan-m9-interop-color.md @@ -1,6 +1,6 @@ ### M9 — Interop and color -- [ ] `libs/project-ir` + importer framework + import report + `Docs/interop.md` with levels per format. *Started (2026-10-13)*: ADR-0008 accepted (IR shape; OTIO read by an own reader on simdjson, no new dependency). `libs/project-ir` holds the IR (tracks of clips, gaps and transitions in source time, opaque objects for anything unrepresented), `ir::validate` (unique media ids, known media, clips inside their media compared exactly across timebases, no negative durations; `tests/project-ir`) and the import report with §16.5 levels; `Docs/interop.md` lists every format at no proven level. *OTIO reader (2026-10-13)*: `libs/importers::import_otio` (bounded: 64 MiB, depth 64, 100,000 items) reads the pinned schema subset into ProjectIR with a report; `tests/importers` checks exact NTSC times, fractional frames, shared media, kept opaque effects/generators and refusals; `fuzz_otio` ran 2,000,000 inputs clean. Building it found `make fuzz` broken for the cube and subtitle targets (an `error_strings.cpp` split); fixed. *Converter (2026-10-13)*: `project::from_ir` builds a document through timeline commands with an app-supplied media resolver (this library cannot probe), tested on a hand-built IR (`tests/project/test_from_ir.cpp`). *CLI (2026-10-13)*: `oma-project import FILE.otio` prints the report from the same importer and converter, with media durations from the file and files checked but not probed (`tests/project/test_cli.sh`). A `convert` command waits for the probe-to-library mapping, which lives in `Session` today, to move somewhere the tool and the app can share. *In the app (2026-10-13)*: Import OpenTimelineIO… (palette) reads, probes each media file with the library import's rule (now `media_entry`, shared) and opens the result as an untitled, unsaved project; the import report opens when there are notes (`tests/app/test_import_timeline.cpp`, GUI smoke). `oma-project convert` now exists (see below); the report already names source objects the native format does not keep. Canvas (2026-10-14): an imported OTIO project took the 1920x1080 default whatever its media; it now takes the first picture's display size, rounded to even like a library import (app and `convert`; `tests/app/test_import_timeline.cpp`, `tests/project/test_cli.sh`). Open: fixtures from real application exports. +- [ ] `libs/project-ir` + importer framework + import report + `docs/interop.md` with levels per format. *Started (2026-10-13)*: ADR-0008 accepted (IR shape; OTIO read by an own reader on simdjson, no new dependency). `libs/project-ir` holds the IR (tracks of clips, gaps and transitions in source time, opaque objects for anything unrepresented), `ir::validate` (unique media ids, known media, clips inside their media compared exactly across timebases, no negative durations; `tests/project-ir`) and the import report with §16.5 levels; `docs/interop.md` lists every format at no proven level. *OTIO reader (2026-10-13)*: `libs/importers::import_otio` (bounded: 64 MiB, depth 64, 100,000 items) reads the pinned schema subset into ProjectIR with a report; `tests/importers` checks exact NTSC times, fractional frames, shared media, kept opaque effects/generators and refusals; `fuzz_otio` ran 2,000,000 inputs clean. Building it found `make fuzz` broken for the cube and subtitle targets (an `error_strings.cpp` split); fixed. *Converter (2026-10-13)*: `project::from_ir` builds a document through timeline commands with an app-supplied media resolver (this library cannot probe), tested on a hand-built IR (`tests/project/test_from_ir.cpp`). *CLI (2026-10-13)*: `oma-project import FILE.otio` prints the report from the same importer and converter, with media durations from the file and files checked but not probed (`tests/project/test_cli.sh`). A `convert` command waits for the probe-to-library mapping, which lives in `Session` today, to move somewhere the tool and the app can share. *In the app (2026-10-13)*: Import OpenTimelineIO… (palette) reads, probes each media file with the library import's rule (now `media_entry`, shared) and opens the result as an untitled, unsaved project; the import report opens when there are notes (`tests/app/test_import_timeline.cpp`, GUI smoke). `oma-project convert` now exists (see below); the report already names source objects the native format does not keep. Canvas (2026-10-14): an imported OTIO project took the 1920x1080 default whatever its media; it now takes the first picture's display size, rounded to even like a library import (app and `convert`; `tests/app/test_import_timeline.cpp`, `tests/project/test_cli.sh`). Open: fixtures from real application exports. - [ ] OTIO pilot first using a pinned library/schema and actual versioned exports; evaluate FCPXML, EDL and Kdenlive subsets with fixtures. For FCPXML, pin an exported version, cover both `.fcpxml` and applicable `.fcpxmld` bundles, and check rational timing, connected clips, gaps, media references and unsupported objects before claiming any support level. Report floating-to-rational conversion loss and unsupported effects. *FCPXML (2026-10-15)*: `import_fcpxml` reads 1.10/1.11 per Apple's reference (formats, assets with `media-rep`, the first project's spine of asset-clips, clips, gaps and transitions, connected clips by lane) to ProjectIR, in the app (Import Timeline…) and `oma-project import/convert`, `.fcpxmld` bundles included; rational times stay exact on the sequence grid, off-grid ones are rounded and reported, titles, effects, compound and multicam media are kept opaque and reported ([format notes](formats/fcpxml.md)). `fuzz_fcpxml` found a one-byte read past the end in the shared XML reader on its first run, fixed with a regression test. **Open**: no document exported by Final Cut Pro is checked (hand-written fixtures only, no Mac here), so the pinned-export requirement above stays open. - [ ] `oma-project diff | convert`. *`diff` (2026-10-13)*: compares the canonical dumps of two projects with Myers' O((N+M)D) line diff, keeping only each step's diagonals (O(D²) memory) and refusing past 2,000 edits rather than growing without bound; a property test checks 5,000 random pairs against a dynamic-programming LCS (minimal and consistent scripts), and a deliberate mutation of the backtrack fails it. Output lines are `-N:`/`+N:` with line numbers, exit 0/1/2 like diff(1). *`convert` (2026-10-14)*: `oma-project convert FILE.otio OUT.omamovie` runs the app's import (probe rule and OTIO-to-document now in `libs/ingest`, shared by both) and saves the project, refusing an existing output; `tests/project/test_cli.sh` converts a fixture and validates and dumps the result. *Field paths (2026-10-14)*: `diff` prints tab-separated `±line`, JSON path and text (`sequence.tracks[0].clips[0].duration.value`), from one O(lines) pass over each canonical dump (`tools/oma-project/line_paths.cpp`, `tests/oma-project/test_line_paths.cpp`); the CLI test changes one field and checks it is the only path reported. It covers native projects; external formats get it when their own dump exists. - [ ] Color management presets, `.cube` LUTs, scopes; HDR gated by independent vectors and an actual display/preview/export contract. `.cube` LUTs exist (ADR-0012). *Luma waveform (2026-10-13)*: the color drawer's More view shows a luma waveform (BT.709 Y' of the display-encoded picture) of the frame at the playhead, rendered at 256×144 by the CPU reference compositor from the same render graph as the viewer, so grading, looks and layers are measured; it refreshes 120 ms after the playhead stops or an edit, never while playing, and is hidden below 760 px. `tests/app/test_scopes.cpp` checks levels on a synthetic picture (black, white, pure green at 182) and the session path. Refresh cost (2026-10-13, release, temporary harness): request to published image p50 17 ms, p95 19 ms, max 20 ms for both a 320×180 and a 1920×1080 source, i.e. bounded by the test's 20 ms event-poll granularity rather than decode; an upper bound, off the UI thread, at most once per 120 ms. *Vectorscope (2026-10-13)*: from the same small render, BT.709 Cb/Cr of the display-encoded values on a 256 × 256 plane with a neutral cross; the test pattern's colour bars draw the expected hexagon, and pure red and blue land where the BT.709 equations put them (computed independently in the test). Both scopes show from 800 px. *RGB parade (2026-10-13)*: the waveform's title, or the palette's "Show RGB parade or luma waveform", switches it to red, green and blue waveforms in thirds of the same width (`tests/app/test_parade.cpp`). *Color interpretation (2026-10-13, ADR-0019)*: the Info drawer's "Read color as" (as the file says, BT.601, BT.709, BT.2020) and "Range" (as the file says, limited, full) set how a media item's YUV is read, one undoable edit for every clip of it, saved in format 7; `build_viewer_frame` (viewer, playback, scopes, export) and the filter previews apply it, RGB sources excepted (`tests/timeline/test_media_color.cpp`, `tests/project/test_media_color_format.cpp`, `tests/app/test_color_interpretation.cpp`, `test_color_session.cpp`). The conversion each choice selects is the one already checked against libswscale in `tests/compositor`. *Thumbnails (2026-10-14)*: library thumbnails are drawn with the media's reading (`VideoFrame::copy_rgba` takes a matrix/range, `tests/media/test_copy_rgba.cpp`); a non-Auto reading is part of the cache key, and after an edit or its undo the items whose reading changed are redrawn on the worker (`session_thumbnails.cpp`; `tests/app/test_thumbnail_color.cpp`: full-range patches read as limited redraw, reopen with that thumbnail and undo back, also under TSan). The two-up edge frames after a roll, slip or slide use the reading too (`tests/app/test_edge_frames.cpp`). Open: the HDR gate. diff --git a/Docs/implementation-plan-milestone-overview.md b/docs/implementation-plan-milestone-overview.md similarity index 100% rename from Docs/implementation-plan-milestone-overview.md rename to docs/implementation-plan-milestone-overview.md diff --git a/Docs/implementation-plan-milestones.md b/docs/implementation-plan-milestones.md similarity index 100% rename from Docs/implementation-plan-milestones.md rename to docs/implementation-plan-milestones.md diff --git a/Docs/implementation-plan-modular-effects.md b/docs/implementation-plan-modular-effects.md similarity index 100% rename from Docs/implementation-plan-modular-effects.md rename to docs/implementation-plan-modular-effects.md diff --git a/Docs/implementation-plan-next-step.md b/docs/implementation-plan-next-step.md similarity index 100% rename from Docs/implementation-plan-next-step.md rename to docs/implementation-plan-next-step.md diff --git a/Docs/implementation-plan-qa-delivery.md b/docs/implementation-plan-qa-delivery.md similarity index 100% rename from Docs/implementation-plan-qa-delivery.md rename to docs/implementation-plan-qa-delivery.md diff --git a/Docs/implementation-plan-qa-render-time.md b/docs/implementation-plan-qa-render-time.md similarity index 100% rename from Docs/implementation-plan-qa-render-time.md rename to docs/implementation-plan-qa-render-time.md diff --git a/Docs/implementation-plan-qa-timeline.md b/docs/implementation-plan-qa-timeline.md similarity index 100% rename from Docs/implementation-plan-qa-timeline.md rename to docs/implementation-plan-qa-timeline.md diff --git a/Docs/implementation-plan-qa-ui-fuzz.md b/docs/implementation-plan-qa-ui-fuzz.md similarity index 100% rename from Docs/implementation-plan-qa-ui-fuzz.md rename to docs/implementation-plan-qa-ui-fuzz.md diff --git a/Docs/implementation-plan-qa.md b/docs/implementation-plan-qa.md similarity index 100% rename from Docs/implementation-plan-qa.md rename to docs/implementation-plan-qa.md diff --git a/Docs/implementation-plan-risks.md b/docs/implementation-plan-risks.md similarity index 100% rename from Docs/implementation-plan-risks.md rename to docs/implementation-plan-risks.md diff --git a/Docs/implementation-plan-tests-quality.md b/docs/implementation-plan-tests-quality.md similarity index 100% rename from Docs/implementation-plan-tests-quality.md rename to docs/implementation-plan-tests-quality.md diff --git a/Docs/implementation-plan-v1-onboarding.md b/docs/implementation-plan-v1-onboarding.md similarity index 98% rename from Docs/implementation-plan-v1-onboarding.md rename to docs/implementation-plan-v1-onboarding.md index 0f11e11..65f7b9f 100644 --- a/Docs/implementation-plan-v1-onboarding.md +++ b/docs/implementation-plan-v1-onboarding.md @@ -24,7 +24,7 @@ smoke checks first opening, the palette handoff, the demo handoff, Escape, reope completion, persistence, and a 640 px window at 130% text. A headless app test edits the demo, saves, reopens and independently decodes its exported movie. Human task evidence is still required. -`Docs/ui-design-2-1.md`, `ui-design-6.md` and `ui-design-10.md` mention tooltips, but do not +`docs/ui-design-2-1.md`, `ui-design-6.md` and `ui-design-10.md` mention tooltips, but do not specify coverage or keyboard access. Preserve the existing sources of truth rather than adding a parallel shortcut list. diff --git a/Docs/implementation-plan-video-effects.md b/docs/implementation-plan-video-effects.md similarity index 96% rename from Docs/implementation-plan-video-effects.md rename to docs/implementation-plan-video-effects.md index 0e291fa..7d82899 100644 --- a/Docs/implementation-plan-video-effects.md +++ b/docs/implementation-plan-video-effects.md @@ -6,7 +6,7 @@ soften/sharpen), transitions (ADR-0011), grading (ADR-0012, 2026-10-04: lift/gam wheels stored as ASC CDL, monotone curves, tetrahedral 3D LUTs from `.cube` files with a fuzz target). Not done: "Auto" color, Ken Burns (keyframes), on-viewer handles, the cut editor (double click on a junction), scopes. Blur reworked (2026-10-04, research -`Docs/Research/gpu-effects.md`): the source is linearized and box-reduced once (across, then down), the gaussian +`docs/Research/gpu-effects.md`): the source is linearized and box-reduced once (across, then down), the gaussian runs on the reduced image (RGBA16F) and the composite reads it back bilinearly; maximum blur went from 52.6 to about 3 ms at 1080p and from 214 to 5.7 ms from a 2160p source, and its strength no longer depends on the file's resolution (evidence §5). Ken Burns through transform keyframes (M8, partial). diff --git a/Docs/implementation-plan.md b/docs/implementation-plan.md similarity index 100% rename from Docs/implementation-plan.md rename to docs/implementation-plan.md diff --git a/Docs/interop.md b/docs/interop.md similarity index 100% rename from Docs/interop.md rename to docs/interop.md diff --git a/Docs/m6-walkthrough.md b/docs/m6-walkthrough.md similarity index 100% rename from Docs/m6-walkthrough.md rename to docs/m6-walkthrough.md diff --git a/Docs/media/editor-test.webp b/docs/media/editor-test.webp similarity index 100% rename from Docs/media/editor-test.webp rename to docs/media/editor-test.webp diff --git a/Docs/media/omamovie-logo.svg b/docs/media/omamovie-logo.svg similarity index 100% rename from Docs/media/omamovie-logo.svg rename to docs/media/omamovie-logo.svg diff --git a/Docs/mockups/ui-mockup.html b/docs/mockups/ui-mockup.html similarity index 99% rename from Docs/mockups/ui-mockup.html rename to docs/mockups/ui-mockup.html index ef4199e..24cca82 100644 --- a/Docs/mockups/ui-mockup.html +++ b/docs/mockups/ui-mockup.html @@ -321,7 +321,7 @@

OmaMovie · interface mockup

-

Interactive prototype of Docs/ui-design.md and Docs/ui-ux-tddo.md. Media is fictitious. It explores layout and editing flows; it does not save projects, export video, or measure engine performance.

+

Interactive prototype of docs/ui-design.md and docs/ui-ux-tddo.md. Media is fictitious. It explores layout and editing flows; it does not save projects, export video, or measure engine performance.

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/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" From b22c898d5b04123adb5f0b481586af78b9caccd5 Mon Sep 17 00:00:00 2001 From: KitsuneSemCalda Date: Sun, 18 Oct 2026 01:23:11 -0300 Subject: [PATCH 2/4] test: wait for waveform in GUI smoke --- apps/omamovie/src/gui_smoke.cpp | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/apps/omamovie/src/gui_smoke.cpp b/apps/omamovie/src/gui_smoke.cpp index 34151d2..98bb4f6 100644 --- a/apps/omamovie/src/gui_smoke.cpp +++ b/apps/omamovie/src/gui_smoke.cpp @@ -80,6 +80,7 @@ class SmokeRun : public QObject { const char* name; std::function ready; std::function act; + qint64 timeout_ms = 8000; }; SmokeRun(QGuiApplication& app, std::vector steps) : app_(app), steps_(std::move(steps)) { @@ -96,7 +97,7 @@ class SmokeRun : public QObject { if (index_ >= steps_.size()) return; Step& step = steps_[index_]; if (!step.ready()) { - if (since_.elapsed() > 8000) { + if (since_.elapsed() > step.timeout_ms) { std::printf("GUI smoke: FAIL (timed out at '%s')\n", step.name); timer_.stop(); app_.exit(1); @@ -476,7 +477,13 @@ int run_gui_smoke(const SmokeContext& context) { {"sound import", after(100), [&] { session.open(QStringLiteral("tests/fixtures/generated/tone_44100.wav")); }}, - {"audio lanes", [&] { return lane_count() == 1; }, [&] { + {"audio lanes", [&] { + if (lane_count() != 1) return false; + // Noise reduction and normalization below need the asynchronous waveform. Wait for + // that result explicitly instead of relying on earlier edit steps taking long enough. + const auto media = static_cast(lane_clip(0).value("media").toDouble()); + return qobject_cast(session.waveforms())->get(media) != nullptr; + }, [&] { // Appended sound lands on the first lane; a connected sound at an occupied time gets a // new lane, and deleting the lane's only clip removes the lane again. bool ok = std::abs(lane_clip(0).value("start").toDouble()) < 1e-9 && @@ -511,7 +518,7 @@ int run_gui_smoke(const SmokeContext& context) { session.undo(); ok = ok && lane_count() == 1 && session.clips().front().toMap().value("hasAudio").toBool(); // Volume "More" on the sound: equalizer preset, noise reduction from the measured - // floor (the waveform is ready by now), and normalize (the quiet tone hits the + // floor (the waveform is ready), and normalize (the quiet tone hits the // maximum volume). session.selectClip(id); session.setClipEq(-6, 3, 2); @@ -529,7 +536,7 @@ int run_gui_smoke(const SmokeContext& context) { window->setProperty("drawer", QStringLiteral("volume")); window->setProperty("volumeMore", true); r.lanes = ok; - }}, + }, 30000}, {"volume more", after(300), [&] { screenshot(window, "OMA_GUI_SMOKE_LANES_SCREENSHOT"); window->setProperty("drawer", QString()); From 0ecdf607e1cb55c73186f7bce33caf8637a2fd6f Mon Sep 17 00:00:00 2001 From: KitsuneSemCalda Date: Sun, 18 Oct 2026 09:52:45 -0300 Subject: [PATCH 3/4] test: measure sustained RSS after driver warm-up --- .../2026-10-14-m10-sustained-cycles.txt | 9 +++++- tests/app/test_sustained.cpp | 29 +++++++++++++++---- 2 files changed, 31 insertions(+), 7 deletions(-) diff --git a/docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt b/docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt index 342fd3b..3581977 100644 --- a/docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt +++ b/docs/Research/evidence/2026-10-14-m10-sustained-cycles.txt @@ -14,9 +14,16 @@ OMA_SUSTAINED_CYCLES=30, debug build (every third cycle shown): Descriptors constant; resident memory settles near 150 MB after about nine cycles (allocator, Mesa and FFmpeg pools warming), then wanders within ~3 MB: no growth per cycle. -Default 8 cycles in the suite (fails on any descriptor growth after two warm-up cycles, or +At the time, the default was 8 cycles (failed on descriptor growth after two warm-up cycles, or 64 MiB of resident growth): debug 3.9 s, TSan 5 s (379 -> 424 MiB, tapering), ASan 7.8 s (resident bound skipped: quarantine grows ~40 MiB per cycle by design; LSan checks leaks). +The suite now defaults to 16 cycles: it still checks descriptors after cycle two, but compares +the median resident size of cycles 9–11 with cycles 14–16, requiring no more than 64 MiB of +growth. A local llvmpipe run held five descriptors through all 16 cycles; post-warm RSS +samples ranged from 311 to 389 MiB, while the early and late medians were 370 and 364 MiB. +This follows the observed cache warm-up and measures a trend despite allocator swings; the +new CI run supplies its own result. + Not covered: the long-form gate (hours of media, interaction latency percentiles, VRAM, cache and disk use) and a committed per-machine baseline. diff --git a/tests/app/test_sustained.cpp b/tests/app/test_sustained.cpp index 4e75ffc..460f4ef 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,24 @@ 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 From ff3f6ad15a8beffb38193bb5006610473ca065d0 Mon Sep 17 00:00:00 2001 From: KitsuneSemCalda Date: Sun, 18 Oct 2026 09:58:57 -0300 Subject: [PATCH 4/4] style: format sustained workload assertion --- tests/app/test_sustained.cpp | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/tests/app/test_sustained.cpp b/tests/app/test_sustained.cpp index 460f4ef..0acfdf1 100644 --- a/tests/app/test_sustained.cpp +++ b/tests/app/test_sustained.cpp @@ -95,7 +95,8 @@ bool cycles_hold_their_resources() { if (n == kFdWarm - 1) { fds = f; } - if (n >= kRssWarm - 1) rss_after_warm.push_back(r); + if (n >= kRssWarm - 1) + rss_after_warm.push_back(r); if (n >= kFdWarm && f > fds) { return false; } @@ -105,10 +106,12 @@ bool cycles_hold_their_resources() { 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::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; + if (last[1] > first[1] + (64 * 1024)) + return false; } return true; }