docs: re-audit gaps.md and parity docs against main (2026-10-12)

[vangel76]

Docs-only re-audit of docs/gaps.md and the parity docs against upstream/main 470ea7a (2026-10-12). Evidence is gh issue view states (216 open / 328 closed of 544 issues, 401 merged PRs), git log upstream/main, and the code (crates/ui-egui/src/i18n.rs, i18n/ui.rs, crates/media/src/lib.rs, crates/project/src/render_queue.rs, crates/script/src, .github/workflows, generated docs/effects.md). No generated file was edited. cargo xtask layers and cargo xtask assets pass; cargo fmt --all --check could not run here (ionice wrapper missing) but no .rs file changed.

Corrections (with evidence)

gaps.md (header and revision history updated)

• Open issues 134 to 216; total issues 313 to 544 (216 open / 328 closed); lines of Rust 329k to 361k (git ls-files '*.rs').
• Gap 3 / Stability: [Bug] Windows ARM64 / Adreno X1-85: UI panics after vkAllocateMemory fails and the GPU device is lost while scrubbing nested comps #591, Crash when dragging the viewer/timeline divider past the viewer's minimum height #306, Crash when dragging file over app when import file dialog is open #511 are closed; Export with --gpu fills VRAM (~14.5 of 16 GB, 1080p, 30 frames) and aborts with a failed allocation on a heavy comp (RX 7600 XT) #879 (--gpu export aborts on a failed allocation) added; open list is Adjusting Pan and Tilt on Chromatic Aberrations Instantly crashes the program. #580, Effectscraft crashes on startup #501, [CRASH] Timeline crash whether dragging it through video and/or while it's playing #426, EffectCraft won't quit without crashing on Intel Mac #341, [Bug] macOS 27 / Apple Silicon: app exits after ~10s without ever opening a window #234, Export with --gpu fills VRAM (~14.5 of 16 GB, 1080p, 30 frames) and aborts with a failed allocation on a heavy comp (RX 7600 XT) #879.
• Gap 1: Importing Adobe After Effects projects could be possible via "py-aep" #248 was closed as a duplicate of .aep support #190; open PRs feat(aep): Initial native After Effects (.aep / .aepx) project decoder and import (Early Stage) (#190) #251 and feat(aep): import After Effects projects through an external py-aep converter #860 noted.
• Gap 5 / Performance: EffectCraft - timeline scrubbing and interactions slow and not realtime responsive #329 closed by #329: scrubbing a long movie: superseded viewer frames call off their decodes #784, Linux: Audio Preview Starts Late #554 closed; Playback stutters even on cached frames + cache gap ahead of playhead; indicators vanish at 1/3 res #595 partly addressed (271000b nearest-first RAM-preview prefetch, fbe0f7e cache bars); Puppet pin tool preview is lagging #586 maintainers asked for details.
• Gap 6: Can't modify multiple layers simoultanously in linux #491, Effectcraft doesn't let me copy only specific transform elements and instead copies the entire layer in linux #493, EffectCrafter on Linux: Can't add a keyboard shortcut #467, Saved workspaces do not persist through app sessions #320, Dropping a panel onto a stacked panel doesn't make a tab #302, [BUG] My GPU isn't being detected in EffectCraft #596 closed; In Linux when renaming compositions or layers Effectcraft doesn't allow to use the arrows to move across the name #488 hardening (d689424), GPU compositor can't start on DirectX 12 (FXC fails on the pointwise kernel) #613 partial (e2a4749).
• Gap 8: all six listed issues (Masks are Broken #510, Mask issues #513, fix(render): first Intersect and Darken masks make an opaque solid transparent #527, Can't Change Roto Brush size #509, Mesh Warp can't actually be warped in the comp viewer #303, Bug: Pen/Vertex tools do not function on motion paths & cursor icons do not update #553) closed; replaced with the open mask/shape issues (Mask vertices cannot be multi-selected: no Shift-click, no marquee selection #1004, Composition viewer does not auto-pan when a dragged mask vertex reaches the panel edge (AE auto-scrolls) #999, [EffectCraft] Shape path vertex nodes covered by bounding box #1042, Shape paths: allow hiding transform bounds while editing vertices #1033, Shape layer - Convert to Bezier Path Problem #932, Shape layers: no visibility (eyeball) toggles for groups/paths/fills #959, Shape layers: can't add shape properties/operators (e.g. Repeater) #960).
• Gap 9: Apply Color LUT effect not working #514, Reset button in Fractal effect doesn't work #526, fix(keying): Frame Offset uses current-frame displacement for wire removal #533-fix(generate): animated Write-on drops earlier brush marks #536 closed; Cryptomatte: Selection can't be set in the UI (no field, no picking), and the GPU path takes ~9 s per 1440p frame #473 quoted-name fix (3b7f1ac) and Multi-layer EXR without an unnamed RGB layer: every channel is decoded twice per frame with EXtractoR / Cryptomatte (5–20× slower, ~10 GB RAM at 1440p) #474 shared decode (faffad3, 7aee1d6) noted; Turbulent Displace: changing Evolution can leave output unchanged #943 added.
• Gap 10: Blend modes in 32 bpc vs After Effects: classic modes apply opacity differently, and Overlay / Exclusion / Luminosity / Color Burn clamp over-range values #494, Project Settings: no Working Gamma 2.4 option (After Effects converts linear EXRs with a 2.4 power curve in that mode) #495, fix(viewer): split locked viewer retains previous display colors after profile changes #546, fix(viewer): passive Composition viewers skip the monitor color conversion #547, Working Gamma 2.4 doesn't reach float footage (OpenEXR), and Interpret As Linear Light encodes float footage twice #750 closed; ProRes 4444 is tagged bt709 but the pixels are sRGB encoded #340 still open.
• Gap 11: [Bug] Text is squeezed a bit when resolution is 4:3 #483, Text layer properties: Can't search for font by typing inside the font dropdown #583 closed; Composition viewer: text looks soft/jagged at "Fit" zoom (Auto → Half, minification without mipmaps) #417 mostly fixed by Text and viewer fidelity: glyph seams, overlay fringes, text raster scale, viewer minification (#415, #416, #390, #417) #444; Paragraph alignment (text) is inverted. #316 and When there is Chinese in the composition, the Chinese text displays incorrectly. #453 answered by maintainers, still open.
• Gap 12: 3D: Front, Bevel, Side and Back options #315 (fb5a5e9) and 3D space - Z-position not working #489 closed; 3d Issue not fully fixed [re-open] #307 renderer button (Fix 28 community-reported issues (crash, security, AE parity) #645).
• Gap 15: Suggestion: optional Nvidia CUDA / NVENC fast lane #498 answered (no-unsafe rule); open PR #804: hardware video decoding (NVDEC / VA-API / VideoToolbox / Media Foundation) via filmcraft-platform #819 adds hardware decode.
• Gap 16 / G9 / dimension table: menus now in 10 languages (ja, zh-hans, zh-hant, uk, es, pt-br, ru, fr, de, cs; 624 rows each), panels in 6 (ja, zh-hans, zh-hant, uk, pt-br, cs); Korean and Italian still absent; Hangul probe added (Korean (Hangul) text in the interface renders as boxes on macOS: no Hangul probe in install_script_fallbacks #599 closed, b28485c). Localization share ≈ 12% to ≈ 18% (175 / 10 over After Effects' 10 non-English languages, rows / 3,900).
• Gaps 17, 22, 23, 24: Any image imported gets imported as image sequence #431, MP3 audio layer goes silent in preview and export after working earlier; WAV of same sound plays #324, Add uncompressed single-file output #372 (#372: uncompressed QuickTime (raw RGB / ARGB) output module format #778), EffectCraft: Adding Scale to the Essential Graphics panel exposes independent X and Y values rather than uniform scaling. #338, Exported .fcgt template cannot be installed in FilmCraft (ZIP format rejected) #611, Cant bulk keyframe #355, Need for more Keyboard Short cuts #428 closed.
• G8: #include / #target landed (Scripting: support #include / //@include / #includepath in scripts and ScriptUI panels #759, crates/script/src/include.rs, tests_include.rs).
• Unchanged and verified: gap 4 (no workflow runs cargo xtask ci or tests on PRs; .github/workflows has release, packaging-lint, FreeBSD, Windows ARM64 only), gap 13 (MODEL_EXTENSIONS = gltf, glb, obj, stl, fbx), gap 17 (Media Browser lists AVI, is_importable has none), gap 20.

target-app-parity.md: same issue/crash/localization corrections in the area, dimension, mainstream and essentials tables (closed issues annotated "closed" rather than deleted); export formats 12 to 13 (OutputFormat::ALL, Uncompressed); built-in presets 8 to 31 (effects-parity.md measures 31); #include landed; 12 October counts added next to the 10 October snapshot (snapshot kept).
localization-parity.md: catalog row counts recounted (menus 624 each; panels ja 410, zh 506 x2, uk 505, pt-br 400, cs 501); Russian, French, German menu rows; Hangul probe; overall 12 to 18%.
ui-parity.md, hardware-parity.md, file-format-parity.md: closed issues (#302, #301, #320, #456, #457, #569, #355, #352, #553, #491, #467, #428, #336, #552, #351, #511, #583, #329, #591, #596, #554, #324, #514) marked closed; #486 now "panels in their own windows"; #498 answer and PR #819; #248/#251/#860.
effects-parity.md: parameters 3,014 to 3,017 (generated effects.md); #303, #514, #526, #533-#536, #494, #534 marked closed instead of "fix pending".
scripting-parity.md: estimate no longer counts #include / #target (#759).
ROADMAP.md (not in the request, but it repeated the stale numbers): 134 open / eight crash reports, localization 12%, language table.

Left to open PRs (not touched)

gaps.md rows 7 (pending in PR #1102), 14 (pending in PR #792) and 21 (pending in PR #1098). Note: target-app-parity.md, ROADMAP.md and effects-parity.md still say Object Matte and percentage guides / effect colour labels are missing, which is correct on main until those PRs merge.

Could not verify (left unchanged)

• "2,704 tests" (10 Oct count; would need a full cargo test).
• "587 menu entries" / "411 registered commands" / "618 fixed menu entries" (catalogs now have 624 rows each; the entry count was not re-derived).
• "23 never-crash PRs on 4 October", "179 issues closed 5-10 October" (my count of closes in that window is 241; method differs, kept as "as counted on 10 October"), "233 merged PRs / 1,142 commits" calibration (historical).
• All percentage estimates other than localization (≈ 91% breadth, ≈ 45% ready, per-area and audience tables); hour estimates; fidelity claim (one comparison, 168 samples; docs/fidelity untouched since).
• Whether the .aep owner decision is still pending (no maintainer statement found after the Importing Adobe After Effects projects could be possible via "py-aep" #248 reply).
• [EffectCraft] EffectCraft crashes laptops during caching and rendering #1079 ("crashes laptops during caching and rendering") not added to the crash list: unclear whether it is an app crash.
• ACES 2.0 / OCIO 2.5 "missing", Substance materials, mesh displacement, FBX animation/skinning gaps (not re-tested).
• Effect parameter total in docs/effects-parity.md row text for GPU counts (280 of 306) matches generated effects.md; other per-category counts not re-derived.

🤖 Generated with Claude Code

[echelon]

Merged. Thank you for the contribution, @vangel76! It landed on main together with a batch of other community PRs, after a full workspace build and test run. If you are not on our Discord yet, please join us: https://discord.gg/artcraft