From 4ea8431cd0c88f8698bd5c419ead570dd5794664 Mon Sep 17 00:00:00 2001 From: turtle89431 Date: Sat, 26 Sep 2026 11:11:23 -0700 Subject: [PATCH] init --- .agents/skills | 1 + .claude/agents/code-simplifer.md | 47 + .claude/agents/localize-review.md | 88 + .claude/agents/python-review.md | 51 + .claude/agents/react-review.md | 57 + .claude/skills/comfyui-node-i18n/SKILL.md | 203 + .claude/skills/comfyui-react-widget/SKILL.md | 458 ++ .codex/agents/code-simplifer.toml | 43 + .codex/agents/localize-review.toml | 86 + .codex/agents/python-review.toml | 49 + .codex/agents/react-review.toml | 55 + .github/ISSUE_TEMPLATE/bug_report.md | 29 + .github/ISSUE_TEMPLATE/feature_request.md | 19 + .github/PULL_REQUEST_TEMPLATE/checklist.md | 46 + .github/workflows/publish.yml | 43 + .gitignore | 23 + .husky/commit-msg | 1 + .husky/pre-commit | 7 + AGENTS.md | 107 + CHANGELOG.md | 256 + CLAUDE.md | 1 + LICENSE | 674 ++ Moxie-clean.json | 1220 ++++ Moxie-consolidated.json | 583 ++ Moxie.json | 1435 ++++ README.md | 556 ++ __init__.py | 152 + config.yaml.example | 9 + .../chunks/create-react-widget-casv3vjq.js | 1 + dist/release/chunks/index-1bfnvmkx.js | 2 + dist/release/chunks/index-32kveqpf.js | 10 + dist/release/chunks/index-dtsnfbjr.js | 2 + dist/release/chunks/index-dzqmqdeq.js | 2 + dist/release/chunks/index-mq288fp7.js | 58 + dist/release/chunks/index-v2752ewf.js | 2 + dist/release/chunks/index-y3kz7k0j.js | 2 + dist/release/chunks/index-ysqpnr4j.js | 2 + .../chunks/multitrack-utils-xhqpxq5r.js | 1 + .../release/chunks/timeline-utils-eytt5wbd.js | 1 + dist/release/index.js | 2 + .../Bernini Edit with MultiTrack.jpg | Bin 0 -> 115204 bytes .../Bernini Edit with MultiTrack.json | 3254 +++++++++ .../Bernini R2V or RV2V with MultiTrack.jpg | Bin 0 -> 50474 bytes .../Bernini R2V or RV2V with MultiTrack.json | 2942 ++++++++ .../Bernini S2V 1voice with Multitrack.jpg | Bin 0 -> 278038 bytes .../Bernini S2V 1voice with Multitrack.json | 2563 +++++++ .../Bernini S2V 2voice with Multitrack.jpg | Bin 0 -> 357831 bytes .../Bernini S2V 2voice with Multitrack.json | 2976 ++++++++ .../LTX2.3 3DLora with Multitrack.jpg | Bin 0 -> 70962 bytes .../LTX2.3 3DLora with Multitrack.json | 4260 +++++++++++ ...LTX2.3 LoopSegment with TimelineEditor.jpg | Bin 0 -> 1472403 bytes ...TX2.3 LoopSegment with TimelineEditor.json | 6474 +++++++++++++++++ .../LTX2.3 R2V With TimelineEditor.jpg | Bin 0 -> 671675 bytes .../LTX2.3 R2V With TimelineEditor.json | 4113 +++++++++++ ...X2.3 SingleSegment with TimelineEditor.jpg | Bin 0 -> 580729 bytes ...2.3 SingleSegment with TimelineEditor.json | 4323 +++++++++++ .../MiniMaxH3_AllInOne_LatentUpscale.jpg | Bin 0 -> 109595 bytes .../MiniMaxH3_AllInOne_LatentUpscale.json | 4145 +++++++++++ ...MiniMaxH3_v1.3.1_Easy_Project_AllInOne.jpg | Bin 0 -> 115528 bytes ...iniMaxH3_v1.3.1_Easy_Project_AllInOne.json | 1427 ++++ .../MinimaxH3_AllInOne_Simple.jpg | Bin 0 -> 182173 bytes .../MinimaxH3_AllInOne_Simple.json | 3644 ++++++++++ .../MinimaxH3_ForLoop_MultiShot.jpg | Bin 0 -> 124623 bytes .../MinimaxH3_ForLoop_MultiShot.json | 4409 +++++++++++ ...Wan2.2 LoopSegment with TimelineEditor.jpg | Bin 0 -> 684461 bytes ...an2.2 LoopSegment with TimelineEditor.json | 5707 +++++++++++++++ .../WanScail V2 with MultiTrack.jpg | Bin 0 -> 89069 bytes .../WanScail V2 with MultiTrack.json | 4449 +++++++++++ frontend/.eslintrc.json | 24 + frontend/build.ts | 128 + frontend/bun.lock | 1711 +++++ frontend/commitlint.config.ts | 10 + frontend/components.json | 21 + frontend/messages/en.json | 462 ++ frontend/messages/zh.json | 462 ++ frontend/package.json | 54 + frontend/postcss.config.js | 5 + frontend/src/components/ui/badge.tsx | 34 + frontend/src/components/ui/button.tsx | 57 + frontend/src/components/ui/carousel.tsx | 260 + frontend/src/components/ui/checkbox.tsx | 28 + frontend/src/components/ui/color-picker.tsx | 1986 +++++ frontend/src/components/ui/context-menu.tsx | 206 + .../src/components/ui/custom-lucide-icon.tsx | 39 + frontend/src/components/ui/dialog.tsx | 123 + frontend/src/components/ui/input.tsx | 22 + frontend/src/components/ui/number-input.tsx | 186 + frontend/src/components/ui/popover.tsx | 34 + frontend/src/components/ui/resizable.tsx | 58 + frontend/src/components/ui/select.tsx | 211 + frontend/src/components/ui/skeleton.tsx | 15 + frontend/src/components/ui/slider.tsx | 70 + frontend/src/components/ui/tabs.tsx | 53 + frontend/src/components/ui/textarea.tsx | 21 + frontend/src/components/ui/tooltip.tsx | 42 + .../widgets/MultiImagesLoaderWidget.tsx | 240 + .../components/widgets/MultiTrackWidget.tsx | 1613 ++++ .../widgets/ProjectVideoCombineWidget.tsx | 995 +++ .../widgets/PromptEnhancerAccountBar.tsx | 226 + .../widgets/SamplingPreviewWidget.tsx | 374 + .../src/components/widgets/TimelineWidget.tsx | 645 ++ .../components/widgets/compareVideoWidget.tsx | 1229 ++++ frontend/src/components/widgets/index.ts | 9 + .../widgets/mediaSelector/MediaSelector.tsx | 1274 ++++ .../widgets/multitrack/AudioTrack.tsx | 285 + .../widgets/multitrack/MultiTrackRuler.tsx | 206 + .../multitrack/MultiTrackSegmentBlock.tsx | 646 ++ .../multitrack/MultiTrackTaskMarker.tsx | 93 + .../widgets/multitrack/MultiTrackToolbar.tsx | 314 + .../widgets/multitrack/PreviewArea.tsx | 1501 ++++ .../multitrack/PreviewAudioPlayback.tsx | 127 + .../multitrack/PreviewFloatingToolbar.tsx | 220 + .../multitrack/PromptContentEditor.tsx | 887 +++ .../multitrack/SplitTaskSegmentDialog.tsx | 111 + .../multitrack/SubtitleSettingsPanel.tsx | 635 ++ .../widgets/multitrack/SubtitleTrack.tsx | 172 + .../widgets/multitrack/TaskSegmentEditor.tsx | 1329 ++++ .../widgets/multitrack/TrackArea.tsx | 886 +++ .../widgets/multitrack/TrackAudioControls.tsx | 61 + .../widgets/multitrack/TrackGapAddButton.tsx | 72 + .../widgets/multitrack/TrackReorderHandle.tsx | 27 + .../widgets/multitrack/VideoPreview.tsx | 256 + .../widgets/multitrack/VideoTrack.tsx | 286 + .../widgets/panorama/PanoramaCanvas.tsx | 262 + .../widgets/panorama/PanoramaImagePreview.tsx | 48 + .../panorama/PanoramaViewerOverlay.tsx | 190 + .../widgets/timeline/AudioTrack.tsx | 693 ++ .../widgets/timeline/AudioWaveform.tsx | 168 + .../components/widgets/timeline/EditPanel.tsx | 909 +++ .../widgets/timeline/InsertButton.tsx | 29 + .../widgets/timeline/MaintainTrack.tsx | 1047 +++ .../widgets/timeline/PromptEditDialog.tsx | 407 ++ .../widgets/timeline/PromptTrack.tsx | 280 + .../widgets/timeline/SegmentBlock.tsx | 294 + .../widgets/timeline/TimelineRuler.tsx | 199 + .../components/widgets/timeline/Toolbar.tsx | 228 + .../components/widgets/timeline/TrackRow.tsx | 112 + frontend/src/env.d.ts | 22 + frontend/src/hooks/use-canvas-scale.ts | 26 + .../src/hooks/use-delayed-intersection.ts | 56 + frontend/src/hooks/use-element-width.ts | 19 + .../src/hooks/use-expanded-image-preview.ts | 42 + frontend/src/hooks/use-latest-ref.ts | 7 + frontend/src/hooks/use-multitrack-history.ts | 122 + .../hooks/use-multitrack-resolution-input.ts | 40 + .../src/hooks/use-parent-video-playback.ts | 60 + .../src/hooks/use-pause-media-on-page-exit.ts | 24 + frontend/src/hooks/use-proximity-hover.ts | 244 + .../hooks/use-sampling-preview-progress.ts | 130 + frontend/src/index.ts | 129 + frontend/src/lib/add-stylesheet.ts | 14 + frontend/src/lib/audio-utils.ts | 51 + frontend/src/lib/comfy-api.ts | 83 + frontend/src/lib/compare-video-node-size.ts | 22 + frontend/src/lib/compare-video-node.ts | 43 + frontend/src/lib/constants.ts | 12 + frontend/src/lib/create-react-widget.ts | 170 + frontend/src/lib/font-weight.ts | 6 + frontend/src/lib/graph-utils.ts | 122 + frontend/src/lib/i18n.ts | 48 + frontend/src/lib/image-utils.ts | 48 + frontend/src/lib/media-upload.ts | 11 + frontend/src/lib/media-url.ts | 49 + frontend/src/lib/model-download.ts | 76 + .../src/lib/multi-images-loader-node-size.ts | 13 + frontend/src/lib/multitrack-segment-style.ts | 73 + frontend/src/lib/multitrack-utils.ts | 1826 +++++ frontend/src/lib/panorama-camera.ts | 72 + .../src/lib/project-sampling-preview-node.tsx | 164 + .../lib/project-video-combine-node-size.ts | 22 + .../src/lib/prompt-enhancer-account-node.ts | 48 + frontend/src/lib/prompt-enhancer-account.ts | 146 + frontend/src/lib/shape-context.tsx | 145 + frontend/src/lib/smart-split.ts | 169 + frontend/src/lib/springs.ts | 37 + frontend/src/lib/subtitle-recognition.ts | 182 + frontend/src/lib/subtitle-speech.ts | 207 + frontend/src/lib/subtitle-srt.ts | 76 + frontend/src/lib/sync-play.ts | 180 + frontend/src/lib/task-image-utils.ts | 172 + frontend/src/lib/timeline-node-size.ts | 175 + frontend/src/lib/timeline-utils.ts | 319 + frontend/src/lib/utils.ts | 6 + frontend/src/lib/uuid.ts | 11 + frontend/src/lib/video-utils.ts | 76 + frontend/src/lib/workflow-submission.ts | 151 + frontend/src/stores/media-list-store.ts | 177 + frontend/src/styles/globals.css | 304 + frontend/src/tests/AudioTrack.test.tsx | 300 + frontend/src/tests/EditPanel.test.tsx | 226 + frontend/src/tests/MediaSelector.test.tsx | 510 ++ .../tests/MultiImagesLoaderWidget.test.tsx | 166 + frontend/src/tests/MultiTrackRuler.test.ts | 33 + .../src/tests/MultiTrackRulerDrag.test.tsx | 98 + .../src/tests/MultiTrackSegmentBlock.test.tsx | 497 ++ .../src/tests/MultiTrackTaskMarker.test.tsx | 76 + frontend/src/tests/MultiTrackToolbar.test.tsx | 288 + frontend/src/tests/MultiTrackWidget.test.tsx | 2448 +++++++ frontend/src/tests/PanoramaCanvas.test.tsx | 296 + .../src/tests/PanoramaViewerOverlay.test.tsx | 138 + frontend/src/tests/PreviewArea.test.tsx | 1645 +++++ .../src/tests/PreviewAudioPlayback.test.tsx | 67 + .../src/tests/PreviewFloatingToolbar.test.tsx | 172 + .../tests/ProjectVideoCombineWidget.test.tsx | 951 +++ .../src/tests/SamplingPreviewWidget.test.tsx | 327 + .../src/tests/SubtitleSettingsPanel.test.tsx | 316 + frontend/src/tests/SubtitleTrack.test.tsx | 160 + frontend/src/tests/TaskSegmentEditor.test.tsx | 1542 ++++ frontend/src/tests/TimelineWidget.test.tsx | 111 + frontend/src/tests/TrackArea.test.tsx | 1210 +++ .../src/tests/TrackAudioControls.test.tsx | 68 + frontend/src/tests/TrackGapAddButton.test.ts | 19 + frontend/src/tests/VideoPreview.test.tsx | 313 + frontend/src/tests/VideoTrack.test.tsx | 348 + frontend/src/tests/audio-utils.test.ts | 16 + .../src/tests/compare-video-node-size.test.ts | 38 + .../src/tests/compare-video-widget.test.ts | 679 ++ frontend/src/tests/context-menu.test.tsx | 36 + .../src/tests/create-react-widget.test.tsx | 220 + frontend/src/tests/i18n.test.ts | 10 + frontend/src/tests/media-list-store.test.ts | 83 + frontend/src/tests/media-upload.test.ts | 17 + frontend/src/tests/media-url.test.ts | 45 + .../tests/multitrack-segment-style.test.ts | 36 + frontend/src/tests/multitrack-utils.test.ts | 2208 ++++++ frontend/src/tests/panorama-camera.test.ts | 59 + .../project-sampling-preview-node.test.tsx | 112 + .../tests/prompt-enhancer-account.test.tsx | 222 + frontend/src/tests/select.test.tsx | 54 + frontend/src/tests/smart-split.test.ts | 116 + .../src/tests/subtitle-recognition.test.ts | 149 + frontend/src/tests/subtitle-speech.test.ts | 207 + frontend/src/tests/subtitle-srt.test.ts | 112 + frontend/src/tests/sync-play.test.ts | 130 + frontend/src/tests/timeline-node-size.test.ts | 170 + frontend/src/tests/timeline-utils.test.ts | 103 + .../src/tests/workflow-submission.test.ts | 116 + frontend/src/types/multitrack.ts | 156 + frontend/src/types/project.ts | 42 + frontend/src/types/timeline.ts | 120 + frontend/tailwind.config.ts | 17 + frontend/tsconfig.json | 22 + frontend/vitest.config.ts | 20 + models/audio_vae/README.txt | 7 + models/clip/README.txt | 4 + models/diffusion/README.txt | 4 + models/loras/README.txt | 4 + models/vae/README.txt | 4 + modules/__init__.py | 1 + modules/asr/__init__.py | 1 + modules/asr/qwen_asr.py | 233 + modules/asr/subtitle_recognition.py | 82 + modules/asr/whisper_asr.py | 222 + modules/motion_context/__init__.py | 3 + modules/motion_context/core.py | 966 +++ modules/motion_context/drift_control_av.py | 444 ++ modules/omnishotcut/__init__.py | 263 + modules/omnishotcut/architecture/__init__.py | 1 + modules/omnishotcut/architecture/backbone.py | 134 + modules/omnishotcut/architecture/model.py | 155 + modules/omnishotcut/architecture/model_lf.py | 155 + .../architecture/position_encoding.py | 73 + .../omnishotcut/architecture/transformer.py | 310 + modules/omnishotcut/config/__init__.py | 0 .../omnishotcut/config/argument_setting.py | 100 + .../config/label_correspondence.py | 126 + modules/omnishotcut/datasets/__init__.py | 10 + .../omnishotcut/datasets/compression_utils.py | 95 + modules/omnishotcut/datasets/dataloader.py | 280 + modules/omnishotcut/datasets/transforms.py | 347 + modules/omnishotcut/datasets/utils.py | 68 + modules/omnishotcut/datasets/utils_lf.py | 68 + modules/omnishotcut/util/__init__.py | 1 + modules/omnishotcut/util/misc.py | 376 + modules/omnishotcut/util/visualization.py | 262 + modules/prompt_relay/encode.py | 93 + modules/prompt_relay/patches.py | 167 + modules/prompt_relay/utils.py | 201 + modules/selflift/__init__.py | 132 + modules/selflift/diagnostics.py | 32 + modules/selflift/h3_latent_upscale.py | 503 ++ modules/selflift/h3_tiling.py | 402 + modules/selflift/sampling.py | 656 ++ moxie_combine.py | 58 + moxie_loader.py | 269 + moxie_preview.py | 1135 +++ moxie_project.py | 135 + nodes/__init__.py | 11 + nodes/audio.py | 127 + nodes/basic.py | 4601 ++++++++++++ nodes/common.py | 128 + nodes/image.py | 332 + nodes/ltx.py | 309 + nodes/ltxv.py | 295 + nodes/minimax.py | 2886 ++++++++ nodes/project.py | 2347 ++++++ nodes/subtitle.py | 124 + nodes/video.py | 1335 ++++ nodes/wan.py | 291 + presets/h3_sample.json.example | 54 + pyproject.toml | 16 + routes.py | 787 ++ .../easy-media-multitrack-workflow/README.md | 133 + .../easy-media-multitrack-workflow/SKILL.md | 51 + .../agents/openai.yaml | 4 + .../templates/v1.3.0-blank-workflow.json | 1431 ++++ .../references/execution-api.md | 80 + .../references/multitrack-schema.md | 297 + .../references/template-workflow.md | 80 + .../references/upload-api.md | 59 + .../scripts/customize_template.py | 289 + .../scripts/patch_workflow.py | 768 ++ .../scripts/submit_workflow.py | 121 + tests/fixtures/panorama_camera_cases.json | 7 + tests/test_audio_gain.py | 19 + tests/test_audio_merge.py | 145 + tests/test_bernini_s2v_conditioning.py | 415 ++ tests/test_common_nodes.py | 137 + tests/test_easy_save_video.py | 962 +++ tests/test_h3_audio_lock.py | 145 + tests/test_h3_latent_upscale.py | 259 + tests/test_h3_motion_context.py | 419 ++ tests/test_h3_presets.py | 95 + tests/test_h3_project.py | 1013 +++ tests/test_h3_tiling.py | 198 + tests/test_llm_api.py | 913 +++ tests/test_ltx_nodes.py | 601 ++ tests/test_ltxv_make_ref_video.py | 81 + tests/test_media.py | 70 + tests/test_minimax_node.py | 6008 +++++++++++++++ tests/test_minimax_utils.py | 134 + tests/test_model_memory.py | 40 + tests/test_models.py | 532 ++ tests/test_multitrack_info_output.py | 6187 ++++++++++++++++ tests/test_multitrack_workflow_skill.py | 420 ++ tests/test_panorama.py | 156 + tests/test_project_memory.py | 336 + tests/test_prompt_builder.py | 103 + tests/test_prompt_relay_encode.py | 60 + tests/test_sam3_refs_composite.py | 217 + tests/test_sampling_preview.py | 402 + tests/test_selflift_sampling.py | 245 + tests/test_slot_input_containers.py | 203 + tests/test_speech.py | 262 + tests/test_stage_timing.py | 180 + tests/test_subtitle_recognition.py | 128 + tests/test_subtitle_recognition_node.py | 189 + tests/test_subtitles.py | 954 +++ tests/test_timeline_prompt_override.py | 257 + tests/test_video_merge_boundary.py | 549 ++ tests/test_video_passthrough.py | 38 + tests/test_workflow_submission.py | 188 + tiny_vae.py | 193 + utils/__init__.py | 13 + utils/audio.py | 357 + utils/audio_gain.py | 16 + utils/bernini.py | 245 + utils/bernini_s2v.py | 232 + utils/bernini_s2v_model_patch.py | 475 ++ utils/h3_conditioning_cache.py | 728 ++ utils/h3_presets.py | 251 + utils/h3_project.py | 1657 +++++ utils/image.py | 141 + utils/llm_api.py | 1293 ++++ utils/log.py | 117 + utils/media.py | 198 + utils/minimax.py | 165 + utils/model_memory.py | 51 + utils/models.py | 840 +++ utils/multitrack.py | 658 ++ utils/panorama.py | 135 + utils/project_memory.py | 171 + utils/prompt_builder.py | 970 +++ utils/prompt_override.py | 706 ++ utils/sampling_preview.py | 373 + utils/speech.py | 214 + utils/subtitles.py | 1029 +++ utils/video.py | 1602 ++++ utils/workflow_submission.py | 183 + web/js/preview_override/preview_override.css | 222 + web/js/preview_override/preview_override.js | 1054 +++ web/js/utility.js | 272 + 382 files changed, 174410 insertions(+) create mode 100644 .agents/skills create mode 100644 .claude/agents/code-simplifer.md create mode 100644 .claude/agents/localize-review.md create mode 100644 .claude/agents/python-review.md create mode 100644 .claude/agents/react-review.md create mode 100644 .claude/skills/comfyui-node-i18n/SKILL.md create mode 100644 .claude/skills/comfyui-react-widget/SKILL.md create mode 100644 .codex/agents/code-simplifer.toml create mode 100644 .codex/agents/localize-review.toml create mode 100644 .codex/agents/python-review.toml create mode 100644 .codex/agents/react-review.toml create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md create mode 100644 .github/PULL_REQUEST_TEMPLATE/checklist.md create mode 100644 .github/workflows/publish.yml create mode 100644 .gitignore create mode 100644 .husky/commit-msg create mode 100644 .husky/pre-commit create mode 100644 AGENTS.md create mode 100644 CHANGELOG.md create mode 100644 CLAUDE.md create mode 100644 LICENSE create mode 100644 Moxie-clean.json create mode 100644 Moxie-consolidated.json create mode 100644 Moxie.json create mode 100644 README.md create mode 100644 __init__.py create mode 100644 config.yaml.example create mode 100644 dist/release/chunks/create-react-widget-casv3vjq.js create mode 100644 dist/release/chunks/index-1bfnvmkx.js create mode 100644 dist/release/chunks/index-32kveqpf.js create mode 100644 dist/release/chunks/index-dtsnfbjr.js create mode 100644 dist/release/chunks/index-dzqmqdeq.js create mode 100644 dist/release/chunks/index-mq288fp7.js create mode 100644 dist/release/chunks/index-v2752ewf.js create mode 100644 dist/release/chunks/index-y3kz7k0j.js create mode 100644 dist/release/chunks/index-ysqpnr4j.js create mode 100644 dist/release/chunks/multitrack-utils-xhqpxq5r.js create mode 100644 dist/release/chunks/timeline-utils-eytt5wbd.js create mode 100644 dist/release/index.js create mode 100644 example_workflows/Bernini Edit with MultiTrack.jpg create mode 100644 example_workflows/Bernini Edit with MultiTrack.json create mode 100644 example_workflows/Bernini R2V or RV2V with MultiTrack.jpg create mode 100644 example_workflows/Bernini R2V or RV2V with MultiTrack.json create mode 100644 example_workflows/Bernini S2V 1voice with Multitrack.jpg create mode 100644 example_workflows/Bernini S2V 1voice with Multitrack.json create mode 100644 example_workflows/Bernini S2V 2voice with Multitrack.jpg create mode 100644 example_workflows/Bernini S2V 2voice with Multitrack.json create mode 100644 example_workflows/LTX2.3 3DLora with Multitrack.jpg create mode 100644 example_workflows/LTX2.3 3DLora with Multitrack.json create mode 100644 example_workflows/LTX2.3 LoopSegment with TimelineEditor.jpg create mode 100644 example_workflows/LTX2.3 LoopSegment with TimelineEditor.json create mode 100644 example_workflows/LTX2.3 R2V With TimelineEditor.jpg create mode 100644 example_workflows/LTX2.3 R2V With TimelineEditor.json create mode 100644 example_workflows/LTX2.3 SingleSegment with TimelineEditor.jpg create mode 100644 example_workflows/LTX2.3 SingleSegment with TimelineEditor.json create mode 100644 example_workflows/MiniMaxH3_AllInOne_LatentUpscale.jpg create mode 100644 example_workflows/MiniMaxH3_AllInOne_LatentUpscale.json create mode 100644 example_workflows/MiniMaxH3_v1.3.1_Easy_Project_AllInOne.jpg create mode 100644 example_workflows/MiniMaxH3_v1.3.1_Easy_Project_AllInOne.json create mode 100644 example_workflows/MinimaxH3_AllInOne_Simple.jpg create mode 100644 example_workflows/MinimaxH3_AllInOne_Simple.json create mode 100644 example_workflows/MinimaxH3_ForLoop_MultiShot.jpg create mode 100644 example_workflows/MinimaxH3_ForLoop_MultiShot.json create mode 100644 example_workflows/Wan2.2 LoopSegment with TimelineEditor.jpg create mode 100644 example_workflows/Wan2.2 LoopSegment with TimelineEditor.json create mode 100644 example_workflows/WanScail V2 with MultiTrack.jpg create mode 100644 example_workflows/WanScail V2 with MultiTrack.json create mode 100644 frontend/.eslintrc.json create mode 100644 frontend/build.ts create mode 100644 frontend/bun.lock create mode 100644 frontend/commitlint.config.ts create mode 100644 frontend/components.json create mode 100644 frontend/messages/en.json create mode 100644 frontend/messages/zh.json create mode 100644 frontend/package.json create mode 100644 frontend/postcss.config.js create mode 100644 frontend/src/components/ui/badge.tsx create mode 100644 frontend/src/components/ui/button.tsx create mode 100644 frontend/src/components/ui/carousel.tsx create mode 100644 frontend/src/components/ui/checkbox.tsx create mode 100644 frontend/src/components/ui/color-picker.tsx create mode 100644 frontend/src/components/ui/context-menu.tsx create mode 100644 frontend/src/components/ui/custom-lucide-icon.tsx create mode 100644 frontend/src/components/ui/dialog.tsx create mode 100644 frontend/src/components/ui/input.tsx create mode 100644 frontend/src/components/ui/number-input.tsx create mode 100644 frontend/src/components/ui/popover.tsx create mode 100644 frontend/src/components/ui/resizable.tsx create mode 100644 frontend/src/components/ui/select.tsx create mode 100644 frontend/src/components/ui/skeleton.tsx create mode 100644 frontend/src/components/ui/slider.tsx create mode 100644 frontend/src/components/ui/tabs.tsx create mode 100644 frontend/src/components/ui/textarea.tsx create mode 100644 frontend/src/components/ui/tooltip.tsx create mode 100644 frontend/src/components/widgets/MultiImagesLoaderWidget.tsx create mode 100644 frontend/src/components/widgets/MultiTrackWidget.tsx create mode 100644 frontend/src/components/widgets/ProjectVideoCombineWidget.tsx create mode 100644 frontend/src/components/widgets/PromptEnhancerAccountBar.tsx create mode 100644 frontend/src/components/widgets/SamplingPreviewWidget.tsx create mode 100644 frontend/src/components/widgets/TimelineWidget.tsx create mode 100644 frontend/src/components/widgets/compareVideoWidget.tsx create mode 100644 frontend/src/components/widgets/index.ts create mode 100644 frontend/src/components/widgets/mediaSelector/MediaSelector.tsx create mode 100644 frontend/src/components/widgets/multitrack/AudioTrack.tsx create mode 100644 frontend/src/components/widgets/multitrack/MultiTrackRuler.tsx create mode 100644 frontend/src/components/widgets/multitrack/MultiTrackSegmentBlock.tsx create mode 100644 frontend/src/components/widgets/multitrack/MultiTrackTaskMarker.tsx create mode 100644 frontend/src/components/widgets/multitrack/MultiTrackToolbar.tsx create mode 100644 frontend/src/components/widgets/multitrack/PreviewArea.tsx create mode 100644 frontend/src/components/widgets/multitrack/PreviewAudioPlayback.tsx create mode 100644 frontend/src/components/widgets/multitrack/PreviewFloatingToolbar.tsx create mode 100644 frontend/src/components/widgets/multitrack/PromptContentEditor.tsx create mode 100644 frontend/src/components/widgets/multitrack/SplitTaskSegmentDialog.tsx create mode 100644 frontend/src/components/widgets/multitrack/SubtitleSettingsPanel.tsx create mode 100644 frontend/src/components/widgets/multitrack/SubtitleTrack.tsx create mode 100644 frontend/src/components/widgets/multitrack/TaskSegmentEditor.tsx create mode 100644 frontend/src/components/widgets/multitrack/TrackArea.tsx create mode 100644 frontend/src/components/widgets/multitrack/TrackAudioControls.tsx create mode 100644 frontend/src/components/widgets/multitrack/TrackGapAddButton.tsx create mode 100644 frontend/src/components/widgets/multitrack/TrackReorderHandle.tsx create mode 100644 frontend/src/components/widgets/multitrack/VideoPreview.tsx create mode 100644 frontend/src/components/widgets/multitrack/VideoTrack.tsx create mode 100644 frontend/src/components/widgets/panorama/PanoramaCanvas.tsx create mode 100644 frontend/src/components/widgets/panorama/PanoramaImagePreview.tsx create mode 100644 frontend/src/components/widgets/panorama/PanoramaViewerOverlay.tsx create mode 100644 frontend/src/components/widgets/timeline/AudioTrack.tsx create mode 100644 frontend/src/components/widgets/timeline/AudioWaveform.tsx create mode 100644 frontend/src/components/widgets/timeline/EditPanel.tsx create mode 100644 frontend/src/components/widgets/timeline/InsertButton.tsx create mode 100644 frontend/src/components/widgets/timeline/MaintainTrack.tsx create mode 100644 frontend/src/components/widgets/timeline/PromptEditDialog.tsx create mode 100644 frontend/src/components/widgets/timeline/PromptTrack.tsx create mode 100644 frontend/src/components/widgets/timeline/SegmentBlock.tsx create mode 100644 frontend/src/components/widgets/timeline/TimelineRuler.tsx create mode 100644 frontend/src/components/widgets/timeline/Toolbar.tsx create mode 100644 frontend/src/components/widgets/timeline/TrackRow.tsx create mode 100644 frontend/src/env.d.ts create mode 100644 frontend/src/hooks/use-canvas-scale.ts create mode 100644 frontend/src/hooks/use-delayed-intersection.ts create mode 100644 frontend/src/hooks/use-element-width.ts create mode 100644 frontend/src/hooks/use-expanded-image-preview.ts create mode 100644 frontend/src/hooks/use-latest-ref.ts create mode 100644 frontend/src/hooks/use-multitrack-history.ts create mode 100644 frontend/src/hooks/use-multitrack-resolution-input.ts create mode 100644 frontend/src/hooks/use-parent-video-playback.ts create mode 100644 frontend/src/hooks/use-pause-media-on-page-exit.ts create mode 100644 frontend/src/hooks/use-proximity-hover.ts create mode 100644 frontend/src/hooks/use-sampling-preview-progress.ts create mode 100644 frontend/src/index.ts create mode 100644 frontend/src/lib/add-stylesheet.ts create mode 100644 frontend/src/lib/audio-utils.ts create mode 100644 frontend/src/lib/comfy-api.ts create mode 100644 frontend/src/lib/compare-video-node-size.ts create mode 100644 frontend/src/lib/compare-video-node.ts create mode 100644 frontend/src/lib/constants.ts create mode 100644 frontend/src/lib/create-react-widget.ts create mode 100644 frontend/src/lib/font-weight.ts create mode 100644 frontend/src/lib/graph-utils.ts create mode 100644 frontend/src/lib/i18n.ts create mode 100644 frontend/src/lib/image-utils.ts create mode 100644 frontend/src/lib/media-upload.ts create mode 100644 frontend/src/lib/media-url.ts create mode 100644 frontend/src/lib/model-download.ts create mode 100644 frontend/src/lib/multi-images-loader-node-size.ts create mode 100644 frontend/src/lib/multitrack-segment-style.ts create mode 100644 frontend/src/lib/multitrack-utils.ts create mode 100644 frontend/src/lib/panorama-camera.ts create mode 100644 frontend/src/lib/project-sampling-preview-node.tsx create mode 100644 frontend/src/lib/project-video-combine-node-size.ts create mode 100644 frontend/src/lib/prompt-enhancer-account-node.ts create mode 100644 frontend/src/lib/prompt-enhancer-account.ts create mode 100644 frontend/src/lib/shape-context.tsx create mode 100644 frontend/src/lib/smart-split.ts create mode 100644 frontend/src/lib/springs.ts create mode 100644 frontend/src/lib/subtitle-recognition.ts create mode 100644 frontend/src/lib/subtitle-speech.ts create mode 100644 frontend/src/lib/subtitle-srt.ts create mode 100644 frontend/src/lib/sync-play.ts create mode 100644 frontend/src/lib/task-image-utils.ts create mode 100644 frontend/src/lib/timeline-node-size.ts create mode 100644 frontend/src/lib/timeline-utils.ts create mode 100644 frontend/src/lib/utils.ts create mode 100644 frontend/src/lib/uuid.ts create mode 100644 frontend/src/lib/video-utils.ts create mode 100644 frontend/src/lib/workflow-submission.ts create mode 100644 frontend/src/stores/media-list-store.ts create mode 100644 frontend/src/styles/globals.css create mode 100644 frontend/src/tests/AudioTrack.test.tsx create mode 100644 frontend/src/tests/EditPanel.test.tsx create mode 100644 frontend/src/tests/MediaSelector.test.tsx create mode 100644 frontend/src/tests/MultiImagesLoaderWidget.test.tsx create mode 100644 frontend/src/tests/MultiTrackRuler.test.ts create mode 100644 frontend/src/tests/MultiTrackRulerDrag.test.tsx create mode 100644 frontend/src/tests/MultiTrackSegmentBlock.test.tsx create mode 100644 frontend/src/tests/MultiTrackTaskMarker.test.tsx create mode 100644 frontend/src/tests/MultiTrackToolbar.test.tsx create mode 100644 frontend/src/tests/MultiTrackWidget.test.tsx create mode 100644 frontend/src/tests/PanoramaCanvas.test.tsx create mode 100644 frontend/src/tests/PanoramaViewerOverlay.test.tsx create mode 100644 frontend/src/tests/PreviewArea.test.tsx create mode 100644 frontend/src/tests/PreviewAudioPlayback.test.tsx create mode 100644 frontend/src/tests/PreviewFloatingToolbar.test.tsx create mode 100644 frontend/src/tests/ProjectVideoCombineWidget.test.tsx create mode 100644 frontend/src/tests/SamplingPreviewWidget.test.tsx create mode 100644 frontend/src/tests/SubtitleSettingsPanel.test.tsx create mode 100644 frontend/src/tests/SubtitleTrack.test.tsx create mode 100644 frontend/src/tests/TaskSegmentEditor.test.tsx create mode 100644 frontend/src/tests/TimelineWidget.test.tsx create mode 100644 frontend/src/tests/TrackArea.test.tsx create mode 100644 frontend/src/tests/TrackAudioControls.test.tsx create mode 100644 frontend/src/tests/TrackGapAddButton.test.ts create mode 100644 frontend/src/tests/VideoPreview.test.tsx create mode 100644 frontend/src/tests/VideoTrack.test.tsx create mode 100644 frontend/src/tests/audio-utils.test.ts create mode 100644 frontend/src/tests/compare-video-node-size.test.ts create mode 100644 frontend/src/tests/compare-video-widget.test.ts create mode 100644 frontend/src/tests/context-menu.test.tsx create mode 100644 frontend/src/tests/create-react-widget.test.tsx create mode 100644 frontend/src/tests/i18n.test.ts create mode 100644 frontend/src/tests/media-list-store.test.ts create mode 100644 frontend/src/tests/media-upload.test.ts create mode 100644 frontend/src/tests/media-url.test.ts create mode 100644 frontend/src/tests/multitrack-segment-style.test.ts create mode 100644 frontend/src/tests/multitrack-utils.test.ts create mode 100644 frontend/src/tests/panorama-camera.test.ts create mode 100644 frontend/src/tests/project-sampling-preview-node.test.tsx create mode 100644 frontend/src/tests/prompt-enhancer-account.test.tsx create mode 100644 frontend/src/tests/select.test.tsx create mode 100644 frontend/src/tests/smart-split.test.ts create mode 100644 frontend/src/tests/subtitle-recognition.test.ts create mode 100644 frontend/src/tests/subtitle-speech.test.ts create mode 100644 frontend/src/tests/subtitle-srt.test.ts create mode 100644 frontend/src/tests/sync-play.test.ts create mode 100644 frontend/src/tests/timeline-node-size.test.ts create mode 100644 frontend/src/tests/timeline-utils.test.ts create mode 100644 frontend/src/tests/workflow-submission.test.ts create mode 100644 frontend/src/types/multitrack.ts create mode 100644 frontend/src/types/project.ts create mode 100644 frontend/src/types/timeline.ts create mode 100644 frontend/tailwind.config.ts create mode 100644 frontend/tsconfig.json create mode 100644 frontend/vitest.config.ts create mode 100644 models/audio_vae/README.txt create mode 100644 models/clip/README.txt create mode 100644 models/diffusion/README.txt create mode 100644 models/loras/README.txt create mode 100644 models/vae/README.txt create mode 100644 modules/__init__.py create mode 100644 modules/asr/__init__.py create mode 100644 modules/asr/qwen_asr.py create mode 100644 modules/asr/subtitle_recognition.py create mode 100644 modules/asr/whisper_asr.py create mode 100644 modules/motion_context/__init__.py create mode 100644 modules/motion_context/core.py create mode 100644 modules/motion_context/drift_control_av.py create mode 100644 modules/omnishotcut/__init__.py create mode 100644 modules/omnishotcut/architecture/__init__.py create mode 100644 modules/omnishotcut/architecture/backbone.py create mode 100644 modules/omnishotcut/architecture/model.py create mode 100644 modules/omnishotcut/architecture/model_lf.py create mode 100644 modules/omnishotcut/architecture/position_encoding.py create mode 100644 modules/omnishotcut/architecture/transformer.py create mode 100644 modules/omnishotcut/config/__init__.py create mode 100644 modules/omnishotcut/config/argument_setting.py create mode 100644 modules/omnishotcut/config/label_correspondence.py create mode 100644 modules/omnishotcut/datasets/__init__.py create mode 100644 modules/omnishotcut/datasets/compression_utils.py create mode 100644 modules/omnishotcut/datasets/dataloader.py create mode 100644 modules/omnishotcut/datasets/transforms.py create mode 100644 modules/omnishotcut/datasets/utils.py create mode 100644 modules/omnishotcut/datasets/utils_lf.py create mode 100644 modules/omnishotcut/util/__init__.py create mode 100644 modules/omnishotcut/util/misc.py create mode 100644 modules/omnishotcut/util/visualization.py create mode 100644 modules/prompt_relay/encode.py create mode 100644 modules/prompt_relay/patches.py create mode 100644 modules/prompt_relay/utils.py create mode 100644 modules/selflift/__init__.py create mode 100644 modules/selflift/diagnostics.py create mode 100644 modules/selflift/h3_latent_upscale.py create mode 100644 modules/selflift/h3_tiling.py create mode 100644 modules/selflift/sampling.py create mode 100644 moxie_combine.py create mode 100644 moxie_loader.py create mode 100644 moxie_preview.py create mode 100644 moxie_project.py create mode 100644 nodes/__init__.py create mode 100644 nodes/audio.py create mode 100644 nodes/basic.py create mode 100644 nodes/common.py create mode 100644 nodes/image.py create mode 100644 nodes/ltx.py create mode 100644 nodes/ltxv.py create mode 100644 nodes/minimax.py create mode 100644 nodes/project.py create mode 100644 nodes/subtitle.py create mode 100644 nodes/video.py create mode 100644 nodes/wan.py create mode 100644 presets/h3_sample.json.example create mode 100644 pyproject.toml create mode 100644 routes.py create mode 100644 skills/easy-media-multitrack-workflow/README.md create mode 100644 skills/easy-media-multitrack-workflow/SKILL.md create mode 100644 skills/easy-media-multitrack-workflow/agents/openai.yaml create mode 100644 skills/easy-media-multitrack-workflow/assets/templates/v1.3.0-blank-workflow.json create mode 100644 skills/easy-media-multitrack-workflow/references/execution-api.md create mode 100644 skills/easy-media-multitrack-workflow/references/multitrack-schema.md create mode 100644 skills/easy-media-multitrack-workflow/references/template-workflow.md create mode 100644 skills/easy-media-multitrack-workflow/references/upload-api.md create mode 100644 skills/easy-media-multitrack-workflow/scripts/customize_template.py create mode 100644 skills/easy-media-multitrack-workflow/scripts/patch_workflow.py create mode 100644 skills/easy-media-multitrack-workflow/scripts/submit_workflow.py create mode 100644 tests/fixtures/panorama_camera_cases.json create mode 100644 tests/test_audio_gain.py create mode 100644 tests/test_audio_merge.py create mode 100644 tests/test_bernini_s2v_conditioning.py create mode 100644 tests/test_common_nodes.py create mode 100644 tests/test_easy_save_video.py create mode 100644 tests/test_h3_audio_lock.py create mode 100644 tests/test_h3_latent_upscale.py create mode 100644 tests/test_h3_motion_context.py create mode 100644 tests/test_h3_presets.py create mode 100644 tests/test_h3_project.py create mode 100644 tests/test_h3_tiling.py create mode 100644 tests/test_llm_api.py create mode 100644 tests/test_ltx_nodes.py create mode 100644 tests/test_ltxv_make_ref_video.py create mode 100644 tests/test_media.py create mode 100644 tests/test_minimax_node.py create mode 100644 tests/test_minimax_utils.py create mode 100644 tests/test_model_memory.py create mode 100644 tests/test_models.py create mode 100644 tests/test_multitrack_info_output.py create mode 100644 tests/test_multitrack_workflow_skill.py create mode 100644 tests/test_panorama.py create mode 100644 tests/test_project_memory.py create mode 100644 tests/test_prompt_builder.py create mode 100644 tests/test_prompt_relay_encode.py create mode 100644 tests/test_sam3_refs_composite.py create mode 100644 tests/test_sampling_preview.py create mode 100644 tests/test_selflift_sampling.py create mode 100644 tests/test_slot_input_containers.py create mode 100644 tests/test_speech.py create mode 100644 tests/test_stage_timing.py create mode 100644 tests/test_subtitle_recognition.py create mode 100644 tests/test_subtitle_recognition_node.py create mode 100644 tests/test_subtitles.py create mode 100644 tests/test_timeline_prompt_override.py create mode 100644 tests/test_video_merge_boundary.py create mode 100644 tests/test_video_passthrough.py create mode 100644 tests/test_workflow_submission.py create mode 100644 tiny_vae.py create mode 100644 utils/__init__.py create mode 100644 utils/audio.py create mode 100644 utils/audio_gain.py create mode 100644 utils/bernini.py create mode 100644 utils/bernini_s2v.py create mode 100644 utils/bernini_s2v_model_patch.py create mode 100644 utils/h3_conditioning_cache.py create mode 100644 utils/h3_presets.py create mode 100644 utils/h3_project.py create mode 100644 utils/image.py create mode 100644 utils/llm_api.py create mode 100644 utils/log.py create mode 100644 utils/media.py create mode 100644 utils/minimax.py create mode 100644 utils/model_memory.py create mode 100644 utils/models.py create mode 100644 utils/multitrack.py create mode 100644 utils/panorama.py create mode 100644 utils/project_memory.py create mode 100644 utils/prompt_builder.py create mode 100644 utils/prompt_override.py create mode 100644 utils/sampling_preview.py create mode 100644 utils/speech.py create mode 100644 utils/subtitles.py create mode 100644 utils/video.py create mode 100644 utils/workflow_submission.py create mode 100644 web/js/preview_override/preview_override.css create mode 100644 web/js/preview_override/preview_override.js create mode 100644 web/js/utility.js diff --git a/.agents/skills b/.agents/skills new file mode 100644 index 0000000..454b842 --- /dev/null +++ b/.agents/skills @@ -0,0 +1 @@ +../.claude/skills \ No newline at end of file diff --git a/.claude/agents/code-simplifer.md b/.claude/agents/code-simplifer.md new file mode 100644 index 0000000..33fe14b --- /dev/null +++ b/.claude/agents/code-simplifer.md @@ -0,0 +1,47 @@ +--- +name: code-simplifier +description: Simplifies and refines code for clarity, consistency, and maintainability while preserving behavior. Focus on recently modified code unless instructed otherwise. +model: sonnet +tools: [Read, Write, Edit, Bash, Grep, Glob] +--- + +# Code Simplifier Agent + +You simplify code while preserving functionality. + +## Principles + +1. clarity over cleverness +2. consistency with existing repo style +3. preserve behavior exactly +4. simplify only where the result is demonstrably easier to maintain + +## Simplification Targets + +### Structure + +- extract deeply nested logic into named functions +- replace complex conditionals with early returns where clearer +- simplify callback chains with `async` / `await` +- remove dead code and unused imports + +### Readability + +- prefer descriptive names +- avoid nested ternaries +- break long chains into intermediate variables when it improves clarity +- use destructuring when it clarifies access + +### Quality + +- remove stray `console.log` +- remove commented-out code +- consolidate duplicated logic +- unwind over-abstracted single-use helpers + +## Approach + +1. read the changed files +2. identify simplification opportunities +3. apply only functionally equivalent changes +4. verify no behavioral change was introduced \ No newline at end of file diff --git a/.claude/agents/localize-review.md b/.claude/agents/localize-review.md new file mode 100644 index 0000000..c83ca8f --- /dev/null +++ b/.claude/agents/localize-review.md @@ -0,0 +1,88 @@ +--- +name: localize-review +description: Review project localization setup. Use when auditing i18n configuration, checking locales folder structure, validating node localization completeness, or verifying frontend message key alignment between en/zh. +--- + +You are a localization reviewer for a ComfyUI custom node project with both Python backend and React frontend. + +## Project Context + +- Backend: Python nodes with `comfy_api.latest` (V3) API +- Frontend: React v19, bundled with Bun +- Frontend messages location: `frontend/messages/{en,zh}.json` +- Backend node definitions: `nodes/*.py` + +## Review Checklist + +### 1. Locales Folder Structure + +Project root **must** contain `locales/` folder with at minimum: + +| Language | nodeDefs.json | main.json | settings.json | +|----------|--------------|-----------|---------------| +| en/ | Optional | Optional | Optional | +| zh/ | ✅ Required | Optional | Optional | + +- [ ] `locales/` folder exists at project root +- [ ] `locales/zh/nodeDefs.json` exists + +### 2. nodeDefs.json Format + +- [ ] JSON is valid (parseable) +- [ ] Node display names are localized +- [ ] Input tooltips are localized (if present in schema) +- [ ] Output display names are localized (if present in schema) + +### 3. Backend Node Localization Completeness + +For each registered node in `__init__.py` → `get_node_list()`: + +- [ ] Node `display_name` localized +- [ ] Node `description` localized +- [ ] All inputs with `tooltip` have corresponding localization +- [ ] All outputs with `display_name` have corresponding localization + +### 4. Frontend Messages Alignment + +Location: `frontend/messages/en.json` and `frontend/messages/zh.json` + +- [ ] Both files exist +- [ ] All top-level sections exist in both files +- [ ] All keys exist in both files (no missing keys in either language) +- [ ] Key count matches between en and zh +- [ ] `bun build` succeeds after any message file changes + +### 5. Common Issues to Flag + +- Missing `locales/` directory +- Incomplete key sets between language files +- Invalid JSON syntax +- Missing tooltip localizations for nodes that define them +- Build failures after message file edits + +### 6. Quote Handling in Translations + +JSON values must use double quotes, so when the translation itself contains double quotes: +- **Problem**: `"tooltip": "提示 \"文字\""` causes JSON parse failure +- **Solution**: Use single quotes for the inner quotes or escape them properly +- **Rule**: Always wrap translation strings in double quotes; if the translated text contains double quotes, escape them with `\\"` (JSON string escaping) + +### 7. Key Synchronization Review + +When reviewing translations, verify: +- [ ] No keys were renamed or removed without updating all locales +- [ ] No new keys added to one locale but missing from others +- [ ] Key count matches exactly between `en` and `zh` files +- [ ] Key order is consistent (aids debugging and diff review) + +## Output + +For each issue found, report: +1. **File & location** +2. **Severity**: Critical / Major / Minor +3. **Issue** description +4. **Suggested fix** + +End with a brief summary table: +| Category | Item | Status | +|----------|------|--------| \ No newline at end of file diff --git a/.claude/agents/python-review.md b/.claude/agents/python-review.md new file mode 100644 index 0000000..d3b3f3a --- /dev/null +++ b/.claude/agents/python-review.md @@ -0,0 +1,51 @@ +--- +name: python-review +description: Review Python backend code. Use when auditing node definitions, checking ComfyUI V3 API compliance, reviewing execute() logic, or validating node schema correctness. +--- + +You are a Python code reviewer specializing in ComfyUI V3 custom node development. + +## Project Context + +- Backend: Python, using the `comfy_api.latest` (V3) API +- Node base class: `io.ComfyNode` +- Schema defined via `io.Schema` in `define_schema()` +- Extension class: `io.ComfyExtension`, entrypoint is `async def comfy_entrypoint()` +- Node registration via `get_node_list()` returning `list[type[io.ComfyNode]]` + +## Review Checklist + +### ComfyUI V3 API Compliance +- [ ] Node inherits from `io.ComfyNode` +- [ ] `define_schema()` is a `@classmethod` returning `io.Schema` +- [ ] `execute()` is a `@classmethod` returning `io.NodeOutput` +- [ ] `node_id` is unique and uses `PascalCase` +- [ ] `category` follows `EasyUse/` convention within `nodes/basic.py` +- [ ] Custom types use `io.Custom(io_type="TYPE_NAME")` +- [ ] Optional inputs use `io.*.Input(..., optional=True)` +- [ ] Extension class overrides `get_node_list()` with `@override` +- [ ] All node classes defined in `nodes/` are registered in `__init__.py` via `get_node_list()` +- [ ] New nodes added to `nodes/*.py` must be imported and included in the extension's `get_node_list()` method + +### Python Quality +- [ ] No bare `except:` clauses — always catch specific exceptions +- [ ] No silently swallowed exceptions +- [ ] No mutable default arguments +- [ ] Type hints present on public methods +- [ ] No unused imports +- [ ] No `print()` debug statements left in production code (use logging) + +### Security (OWASP) +- [ ] No `eval()` / `exec()` on untrusted input +- [ ] No path traversal via user-controlled file paths (use `pathlib.Path` and validate) +- [ ] No hardcoded credentials or secrets +- [ ] File I/O uses context managers (`with open(...)`) + +### Output +For each issue found, report: +1. **File & line** (if known) +2. **Severity**: Critical / Major / Minor +3. **Issue** description +4. **Suggested fix** with code snippet + +End with a brief summary table. diff --git a/.claude/agents/react-review.md b/.claude/agents/react-review.md new file mode 100644 index 0000000..65434d2 --- /dev/null +++ b/.claude/agents/react-review.md @@ -0,0 +1,57 @@ +--- +name: react-review +description: Review React/TypeScript frontend code. Use when auditing components, checking shadcn/ui usage, reviewing hooks, validating TypeScript strictness, or auditing ComfyUI frontend extension patterns. +--- + +You are a React/TypeScript code reviewer specializing in ComfyUI frontend extensions. + +## Project Context + +- **Framework**: React v19, functional components only +- **UI Library**: shadcn/ui + Tailwind CSS v4 +- **Icons**: Lucide +- **Build**: Bun + `build.ts` +- **Testing**: Vitest +- **Import alias**: `@/*` maps to `src/` +- **File naming**: `PascalCase.tsx` for components, `kebab-case.ts` for modules + +## Review Checklist + +### React / TypeScript +- [ ] Only functional components with hooks — no class components +- [ ] No `any` type without explicit justification +- [ ] Strict TypeScript: no implicit `any`, no non-null assertions without reason +- [ ] Props interfaces defined (not inline `{}` type) +- [ ] `useEffect` has correct dependency arrays — no missing/extra deps +- [ ] No state updates after unmount (use cleanup in `useEffect`) +- [ ] `key` props on list items use stable IDs, not array index (unless list is static) +- [ ] Expensive computations wrapped in `useMemo` / `useCallback` where appropriate + +### shadcn/ui Compliance +- [ ] Use shadcn/ui equivalents: `