@litfamily/litgravity 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +46 -0
- package/README.md +19 -3
- package/README_ko-KR.md +19 -3
- package/TRADEMARK.md +12 -0
- package/package.json +3 -2
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/liveness.mjs +81 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +364 -0
- package/plugin/hooks/lib/rewind/collect.mjs +359 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +39 -1
- package/plugin/hooks/pre-invocation.mjs +93 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +55 -6
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +277 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +160 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +3 -2
- package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
- package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
- package/plugin/skills/lit-plan/templates/plan.md +3 -0
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/review-work/SKILL.md +1 -1
- package/plugin/skills/start-work/SKILL.md +2 -2
|
@@ -1,100 +1,67 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Runtime, pre-warm and BLOCKED states
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
call for a fetched original, optional Python audio analysis, and host programs such as Chrome. LitGravity
|
|
5
|
-
keeps the first three in its own cache and never installs any of them while a film is being made. A
|
|
6
|
-
headless `agy -p` run refuses the shell command an install needs, and a half-finished install in the middle
|
|
7
|
-
of a render would look like a broken engine. The cache is filled once, by the pre-warm command below, and
|
|
8
|
-
every render after that only reads it.
|
|
3
|
+
## What is installed where
|
|
9
4
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
| Piece | Location | Put there by |
|
|
5
|
+
| Piece | Where | Installed by |
|
|
13
6
|
| --- | --- | --- |
|
|
14
|
-
| Engine code,
|
|
15
|
-
| opentype.js 2.0.0
|
|
16
|
-
| Galmuri9
|
|
17
|
-
| Pretendard Regular
|
|
18
|
-
| librosa venv (Tier 2, optional) | `<cache>/audio-<digest
|
|
19
|
-
| Word-timing models (Tier 3) | not
|
|
20
|
-
| Chrome, ffmpeg, img2webp and dwebp, gifski
|
|
21
|
-
|
|
22
|
-
`<cache>` is `$LITGRAVITY_MOTION_RUNTIME
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
##
|
|
41
|
-
|
|
42
|
-
Run this once, from a terminal or as a `run_command` the user allows in an interactive agy session:
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
npx @litfamily/litgravity runtime install motion
|
|
46
|
-
npx @litfamily/litgravity runtime status motion
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
Both call `scripts/motion-runtime.mjs` (`install --json` / `status --json`) and read
|
|
50
|
-
`{name, ready, cache, missing}`. The install takes an mkdir lock in the cache (a stale lock older than 20
|
|
51
|
-
minutes is cleared), installs the npm package, fetches the missing fonts and verifies every hash. The same
|
|
52
|
-
script runs by hand as `node "$SKILL_ROOT/scripts/motion-runtime.mjs" status` for a readable report, and
|
|
53
|
-
`install --audio` adds the optional venv. On an air-gapped machine `LITGRAVITY_MOTION_MIRROR` points at a
|
|
54
|
-
mirror that serves every pinned file under its sha256 (and the npm tarball under its file name);
|
|
55
|
-
`LITGRAVITY_MOTION_PYTHON` picks the interpreter for the audio venv.
|
|
56
|
-
|
|
57
|
-
## Checking readiness
|
|
58
|
-
|
|
59
|
-
`node "$SKILL_ROOT/scripts/motion-doctor.mjs"` (add `--json` for data) runs six read-only probes and prints
|
|
60
|
-
one line each:
|
|
61
|
-
|
|
62
|
-
| Line | What it reports |
|
|
63
|
-
| --- | --- |
|
|
64
|
-
| `MOTION_CHROME` | the Chrome binary and version, or not found (set `CHROME_PATH`) |
|
|
65
|
-
| `MOTION_FFMPEG` | ffmpeg and the preview encoder rung it supports; without it stills and sheets still work |
|
|
66
|
-
| `MOTION_WEBGL2` | the renderer string from a real headless probe and the flags that got it |
|
|
67
|
-
| `MOTION_SOFTWARE_GL` | whether that renderer is software GL (slower, samples lowered) or unknown |
|
|
68
|
-
| `MOTION_PREWARM` | ready, or the missing pieces and the pre-warm command |
|
|
69
|
-
| `MOTION_COVER` | img2webp and dwebp for cover loops, the gifski fallback, or BLOCKED_NO_COVER_ENCODER |
|
|
70
|
-
|
|
71
|
-
The probe's Chrome profile is a fresh temporary folder removed afterwards. `npx @litfamily/litgravity doctor`
|
|
72
|
-
shows the same picture at plugin level: rows for Chrome, ffmpeg and libwebp, and an engine row for
|
|
73
|
-
`motion` with the command that fixes it.
|
|
74
|
-
|
|
75
|
-
## Exit codes on this path
|
|
7
|
+
| Engine code, GLSL passes, scenes, bundled fonts | this skill directory (the plugin) | the LitGravity package |
|
|
8
|
+
| opentype.js 2.0.0 (pinned in `engine/package-lock.json`) | `<cache>/node-<lockdigest>-<platform>-<arch>/` | `litgravity motion-runtime install` (`npm ci --omit=dev --ignore-scripts`) |
|
|
9
|
+
| Galmuri9, MesloLGS NF and their licence files | `<cache>/fonts/` (pinned URL, sha256-verified) | same command |
|
|
10
|
+
| Pretendard Regular / Bold | `../lit-pptx/fonts/pretendard/` (reused by path, hash-checked) | the package |
|
|
11
|
+
| librosa venv (Tier 2, optional) | `<cache>/audio-<digest>/` from `engine/audio/requirements.lock` with `pip install --require-hashes --only-binary=:all:` | `litgravity motion-runtime install --audio` |
|
|
12
|
+
| Word-timing models (Tier 3, optional) | not in this release | `--word-timing` prints the size and pins, then stops |
|
|
13
|
+
| Chrome, ffmpeg, img2webp and dwebp (libwebp), gifski (optional cover fallback) | host tools, never bundled | the user |
|
|
14
|
+
|
|
15
|
+
`<cache>` is `$LITGRAVITY_MOTION_RUNTIME`, otherwise `${XDG_CACHE_HOME:-~/.cache}/litgravity/motion-runtime`.
|
|
16
|
+
|
|
17
|
+
## Pre-warm, never first use
|
|
18
|
+
|
|
19
|
+
The cache is written only by `litgravity motion-runtime install`; `litgravity install` (and the
|
|
20
|
+
global npm postinstall, which runs it) attempts the same pre-warm and prints one receipt line if it
|
|
21
|
+
fails, without failing the install. A agy plugin install runs no lifecycle step, so
|
|
22
|
+
there the explicit command is the pre-warm. A render session only reads the cache: it never runs
|
|
23
|
+
npm, pip or a download, because a sandboxed session usually has no network or no write access
|
|
24
|
+
outside the workspace, and a half-finished install would look like a broken engine.
|
|
25
|
+
|
|
26
|
+
`litgravity doctor` (and `npm run doctor` in a checkout) prints the seven probes: Chrome,
|
|
27
|
+
ffmpeg with the preview encoder rung, the WebGL2 renderer from a real headless probe, the software-GL
|
|
28
|
+
or unknown-renderer warning, the pre-warm state naming anything missing and the fix command,
|
|
29
|
+
the cover encoder (img2webp and dwebp, or the gifski fallback) that cover mode needs, and the
|
|
30
|
+
house styles (each one valid, the default named).
|
|
31
|
+
`litgravity motion-runtime status` prints the pre-warm state alone.
|
|
32
|
+
|
|
33
|
+
## Exit codes
|
|
76
34
|
|
|
77
35
|
| Exit | Name | Meaning | Fix |
|
|
78
36
|
| --- | --- | --- | --- |
|
|
79
|
-
| 0 | OK | the mode finished; for `make`, the gate passed |
|
|
80
|
-
| 10 | BLOCKED_NO_CHROME | Chrome is missing or
|
|
81
|
-
| 11 | BLOCKED_NO_WEBGL2 | Chrome
|
|
82
|
-
| 12 | BLOCKED_NO_FFMPEG_FOR_VIDEO | ffmpeg
|
|
83
|
-
| 13 | GATE_FAIL_QA | the gate or the pre-flight failed; see `gate-report.txt` | fix the named rule
|
|
84
|
-
| 14 | BLOCKED_DEPS_NOT_PREWARMED |
|
|
85
|
-
| 15 | BLOCKED_FONT_FETCH | a required font is missing
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
37
|
+
| 0 | OK | the mode finished; for `make`, the gate passed | — |
|
|
38
|
+
| 10 | BLOCKED_NO_CHROME | Chrome is missing or cannot launch headless; the message carries the launcher's first error line | install Chrome or set `CHROME_PATH` |
|
|
39
|
+
| 11 | BLOCKED_NO_WEBGL2 | Chrome runs but no flag rung gives a WebGL2 context, not even SwiftShader | GPU drivers; nothing can render without WebGL2 |
|
|
40
|
+
| 12 | BLOCKED_NO_FFMPEG_FOR_VIDEO | ffmpeg missing; stills and sheet were still written | install ffmpeg |
|
|
41
|
+
| 13 | GATE_FAIL_QA | the gate (or the pre-flight gate) failed; see `gate-report.txt` | fix the named rule; next round |
|
|
42
|
+
| 14 | BLOCKED_DEPS_NOT_PREWARMED | engine dependencies (or Tier-3 models) missing from the cache | `litgravity motion-runtime install` outside the session |
|
|
43
|
+
| 15 | BLOCKED_FONT_FETCH | a required font is missing or its sha256 differs | same command |
|
|
44
|
+
|
|
45
|
+
Each state names its real cause. A sandbox that refuses `listen` is not a blocked state: frames are
|
|
46
|
+
pulled over CDP from the same readback buffer, and the report names that egress.
|
|
47
|
+
|
|
48
|
+
## Chrome flags (MO-A-51)
|
|
49
|
+
|
|
50
|
+
Tried in order, each counting only if a page gets WebGL2: macOS `--use-angle=metal
|
|
51
|
+
--enable-gpu-rasterization --ignore-gpu-blocklist`; Linux `--use-angle=gl --enable-gpu-rasterization
|
|
52
|
+
--ignore-gpu-blocklist`; Windows `--use-angle=d3d11 --enable-gpu-rasterization`; then the software rung
|
|
53
|
+
`--use-angle=swiftshader --enable-unsafe-swiftshader`. Every rung adds the three anti-throttling
|
|
54
|
+
flags. The rung that worked is recorded as `chromeFlags`. The Chrome profile lives in the run's own
|
|
55
|
+
`.run/chrome/` directory and is removed when the render ends. Every launch also passes
|
|
56
|
+
`--use-mock-keychain` and `--password-store=basic`, so Chrome never asks the OS keychain for its
|
|
57
|
+
safe-storage item (on macOS a fresh profile would otherwise raise a keychain dialog).
|
|
91
58
|
|
|
92
59
|
## Audio tiers
|
|
93
60
|
|
|
94
|
-
- **Tier 1
|
|
95
|
-
- **Tier 2
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
- **Tier 3
|
|
100
|
-
|
|
61
|
+
- **Tier 1 (default):** text reading time on a 100 BPM grid (or the brief's `bpm`).
|
|
62
|
+
- **Tier 2:** an audio file in the brief and a ready venv: librosa beat grid, cuts on detected
|
|
63
|
+
beats, audio muxed into the MP4. A missing venv, a venv whose pins changed, or a failed analysis
|
|
64
|
+
falls back to Tier 1 with the warning "audio analysis not prewarmed: run litgravity
|
|
65
|
+
motion-runtime install --audio" (or the analysis error). It is never repaired in the session.
|
|
66
|
+
- **Tier 3:** `--word-timing` only; exits 14 in this release. Never MMS_FA or madmom weights,
|
|
67
|
+
never aubio or essentia, at any tier.
|
|
@@ -1,121 +1,152 @@
|
|
|
1
1
|
# Sound
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
the
|
|
7
|
-
produces the same bytes.
|
|
3
|
+
Every film gets a sound plan in `treatment.json` (`sound: { mode, plan, genre?, palette?, events }`), on
|
|
4
|
+
both render paths. The renderer muxes whatever track the plan names, then audits the decoded stream
|
|
5
|
+
after the encode. Nothing here downloads a sample, a model or a library, and nothing borrows a melody:
|
|
6
|
+
the score and the bed are synthesized in product code, deterministically, from the treatment.
|
|
8
7
|
|
|
9
|
-
##
|
|
8
|
+
## Modes
|
|
10
9
|
|
|
11
|
-
| `sound.mode` |
|
|
10
|
+
| `sound.mode` | What is muxed | When |
|
|
12
11
|
| --- | --- | --- |
|
|
13
|
-
| `
|
|
14
|
-
| `
|
|
15
|
-
| `
|
|
16
|
-
| `
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
12
|
+
| `score` | A layered score built for this film: drums, bass, chords, lead, arrangement FX and the on-screen events as separate stems, mixed and mastered | The default under a bare `lit`, on the type path and the stage path alike |
|
|
13
|
+
| `generated` | One of the style's preset beds: a pad chord progression with a pulse and the accents the beats ask for | Minimal films only (`register: minimal`) |
|
|
14
|
+
| `supplied` | The user's own audio file (`sound.file`), padded or trimmed to the film | The user gave a track |
|
|
15
|
+
| `authored` | A WAV the model wrote itself into the stage dir (`sound.file`) | The treatment calls for sound the bed cannot make |
|
|
16
|
+
| `none` | No audio stream | Only when the user asked for silence, or the `channel` plays muted by design |
|
|
17
|
+
|
|
18
|
+
A supplied or authored track is always muxed, whatever the state of the optional audio-analysis
|
|
19
|
+
tier; that tier only adds a beat grid for timing. Say in the reply that the score or bed is
|
|
20
|
+
generated, in plain words ("an original score generated for this film"), and name any supplied track
|
|
21
|
+
by its file name.
|
|
22
|
+
Never switch a film to `none` to get past a check: that is a downgrade and the done-check records it.
|
|
23
|
+
|
|
24
|
+
## Score
|
|
25
|
+
|
|
26
|
+
The score is produced like a house track, from the film itself, so two films never share one.
|
|
27
|
+
|
|
28
|
+
- **Genre.** `house` (120-126 BPM, four-on-the-floor, offbeat bass), `tech-house` (124-128, rolling
|
|
29
|
+
sixteenth bass), `deep-house` (118-122, pads, light swing) or `garage` (130-134, broken kick, heavy
|
|
30
|
+
swing). The style picks one (swiss-signal house, terminalcore tech-house, tidal deep-house, paper
|
|
31
|
+
garage); `sound.genre` names another when the film asks for it. Launch and hero films stay in
|
|
32
|
+
house or tech-house.
|
|
33
|
+
- **Key, tempo, progression.** Seeded from the film's request, idea, turn, protagonist and beats:
|
|
34
|
+
one of twelve keys, major or minor, a tempo inside the genre's band and one of six progressions per
|
|
35
|
+
mode with sevenths and ninths. The last bar resolves home.
|
|
36
|
+
- **Arrangement from the beats.** The shots before `story.beat` are the intro and the build; the drop
|
|
37
|
+
lands on the turn, on a downbeat (the bar grid is placed so a bar line falls on the turn's `t0`);
|
|
38
|
+
with three or more shots after the turn the first is a break and the rest drop again; the last shot
|
|
39
|
+
is the outro. A riser runs into every section change (two bars into the drop), an impact lands on the
|
|
40
|
+
drop, a downlifter follows it, a reverse swell of the coming chord breathes into every other change,
|
|
41
|
+
the kick drops out for the half bar before the drop, and the snare rolls
|
|
42
|
+
into it.
|
|
43
|
+
- **Stems.** `kick`, `clap`, `hats` (closed and open), `perc`, `bass` (sub and line), `chords` (stab or
|
|
44
|
+
pad), `lead` (a motif from the key's pentatonic), `fx` (risers, downlifters, impacts, reverse swells)
|
|
45
|
+
and `events` (the on-screen events), each its own buffer with its own pattern.
|
|
46
|
+
- **Mix.** Per-stem gain and pan, a high-pass on every stem but kick and bass, the bass, chords and lead
|
|
47
|
+
ducked under the kick (sidechain, measured and reported in dB), sends to a reverb and a tempo delay
|
|
48
|
+
(dotted eighth left, eighth right), bus compression, then the shared master stage below.
|
|
49
|
+
|
|
50
|
+
Write `sound.plan` as the producer's brief for this film (what the drop is, where it breaks), and
|
|
51
|
+
the beats' `sound` fields with the cue words below. `motion.mjs sound` writes `sound/score.wav`, every
|
|
52
|
+
stem and both returns as `sound/stems/<name>.wav`, and `sound-cues.json` with the genre, key, tempo,
|
|
53
|
+
progression, sections, FX, each stem's level, the sidechain depth, the bus settings and every cue.
|
|
54
|
+
|
|
55
|
+
## Palettes (minimal films)
|
|
56
|
+
|
|
57
|
+
`sound.palette` is `{ "timbre": "<timbre>", "key": "<pitch class>", "mode": "<major|minor>", "tempo": <60-160> }`.
|
|
58
|
+
The key is one of the twelve pitch classes (sharps or flats), the mode sets the chord
|
|
59
|
+
progression (major: I–V–vi–IV; minor: i–VI–III–VII, always resolving home on the last chord), and
|
|
60
|
+
the tempo sets the pulse grid in BPM. A minimal film's generated bed takes one of the house style's beds exactly
|
|
61
|
+
(`studio.md`); the first is the default, and the other two let two films in one style differ:
|
|
62
|
+
|
|
63
|
+
| Style | Default bed | Alternatives |
|
|
64
|
+
| --- | --- | --- |
|
|
65
|
+
| `swiss-signal` | glass, A minor, 104 | pulse-synth, D minor, 112; soft-keys, C major, 96 |
|
|
66
|
+
| `tidal` | felt-strings, D major, 84 | glass, F# minor, 76; soft-keys, Bb major, 72 |
|
|
67
|
+
| `terminalcore` | pulse-synth, E minor, 120 | glass, B minor, 132; pulse-synth, A minor, 100 |
|
|
68
|
+
| `paper` | soft-keys, F major, 96 | felt-strings, G major, 88; glass, C major, 108 |
|
|
36
69
|
|
|
37
|
-
|
|
38
|
-
|
|
70
|
+
Pick the bed for the film's mood and pace: a slower or tenderer film takes the slower bed, a launch
|
|
71
|
+
the brighter one. Two films in one style still sound like one house; the beds, the beats' cue words
|
|
72
|
+
and the events make each film's sound its own.
|
|
39
73
|
|
|
40
|
-
| Timbre |
|
|
74
|
+
| Timbre | Character | Pad | Pulse | Accents |
|
|
41
75
|
| --- | --- | --- | --- | --- |
|
|
42
|
-
| `soft-keys` |
|
|
43
|
-
| `glass` |
|
|
44
|
-
| `pulse-synth` |
|
|
45
|
-
| `felt-strings` |
|
|
46
|
-
|
|
47
|
-
As a starting point: intimate or reflective films lean on `soft-keys` or `felt-strings`, clean diagrams and
|
|
48
|
-
precise explainers on `glass`, and graphic fast-cut pieces on `pulse-synth`.
|
|
49
|
-
|
|
50
|
-
## Asking for accents
|
|
76
|
+
| `soft-keys` | Warm, close, unhurried | Rounded electric-piano partials, gently detuned, low-passed | A felt kick on every beat | Felt piano strike for cadences; a soft noise-and-thump hit |
|
|
77
|
+
| `glass` | Bright, airy, precise | Bell-like odd partials with an octave shimmer, wide detune | A small tick on every beat and a sub note every bar | Inharmonic bell partials for hits and cadences |
|
|
78
|
+
| `pulse-synth` | Driving, graphic | Filtered saw pad | Eighth-note bass on the chord root under a firm kick | Plucked saw cadence; a noise snap hit; a pitched riser |
|
|
79
|
+
| `felt-strings` | Slow, tender, wide | Bowed-string partials with vibrato | A brushed noise pulse on every beat | A felt strike for cadences; a soft hit |
|
|
51
80
|
|
|
52
|
-
|
|
81
|
+
`soft-keys` carries the warm paper style, `felt-strings` the calm tidal one, `glass` the precise
|
|
82
|
+
swiss-signal one and `pulse-synth` the terminal one.
|
|
53
83
|
|
|
54
|
-
|
|
55
|
-
start when one lies within 0.5 s, else on the beat's start.
|
|
56
|
-
- **rise**: rise, riser, swell, build, build-up, lift, 상승, 고조, 빌드업. A filtered noise swell that ends on
|
|
57
|
-
the beat's end (snapped to a cut within 0.5 s) and starts up to 1 s before it, never before the beat.
|
|
58
|
-
- **cadence**: cadence, resolve, resolution, close, closing, ending, final chord, 종지, 마무리, 해결. A struck
|
|
59
|
-
tonic chord at 60 % of the beat, ringing to the beat's end, or to the film's end on the last beat.
|
|
84
|
+
## Cues
|
|
60
85
|
|
|
61
|
-
|
|
62
|
-
path and from the brief's shots on the type path.
|
|
86
|
+
Accents appear only where a beat's free-text `sound` field asks for one. The words that ask are:
|
|
63
87
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
88
|
+
- **hit** — hit, impact, cut, stab, accent, 타격, 히트, 컷, 강세. The hit lands on the cut nearest
|
|
89
|
+
the beat's start when one is within 0.5 s, otherwise on the beat's start.
|
|
90
|
+
- **rise** — rise, riser, swell, build, build-up, lift, 상승, 고조, 빌드업. A filtered noise swell
|
|
91
|
+
that ends exactly on the beat's end boundary (the next change) and starts up to 1 s before it.
|
|
92
|
+
- **cadence** — cadence, resolve, resolution, close, ending, final chord, 종지, 마무리, 해결. A struck
|
|
93
|
+
tonic chord at the start of the beat's last 40 %, ringing into the film's end on the last beat.
|
|
69
94
|
|
|
70
|
-
|
|
95
|
+
A beat whose `sound` field names none of these gets pad and pulse only.
|
|
71
96
|
|
|
72
|
-
|
|
73
|
-
picture sample for sample.
|
|
74
|
-
- It is normalized to −16 LUFS integrated, measured in product code per ITU-R BS.1770-4 (K-weighting,
|
|
75
|
-
400 ms blocks with 75 % overlap, the −70 LUFS absolute and −10 LU relative gates), through a
|
|
76
|
-
deterministic soft limiter that keeps the sample peak at or under −2 dBFS.
|
|
77
|
-
- The pad sounds within the first quarter second; the bed never opens on silence.
|
|
78
|
-
- A supplied or authored track is converted to the film's exact length, with a 50 ms fade where it is
|
|
79
|
-
trimmed or padded. The encode never uses `-shortest`, so audio can never cut the picture short.
|
|
80
|
-
- Audio is encoded as AAC at 256 kb/s.
|
|
97
|
+
## Events
|
|
81
98
|
|
|
82
|
-
|
|
99
|
+
Cue words tie accents to cuts. Events tie sounds to what moves inside a shot: a latch clicks when the
|
|
100
|
+
lid opens, a card lands, a cursor types, a progress bar completes. A score or generated bed on the stage
|
|
101
|
+
path lists them in `sound.events`:
|
|
83
102
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
| Rule | Passes when |
|
|
87
|
-
| --- | --- |
|
|
88
|
-
| `SOUND-STREAM` | an audio stream is present |
|
|
89
|
-
| `SOUND-DURATION` | its length is within ±0.1 s of the video |
|
|
90
|
-
| `SOUND-PEAK` | the sample peak is at or under −0.5 dBFS |
|
|
91
|
-
| `SOUND-HEAD` | no stretch below −50 dBFS RMS (50 ms windows) lasts longer than 1.5 s in the first 3 s |
|
|
92
|
-
| `SOUND-LOUDNESS` | reported; a generated bed outside −16 ± 2 LUFS warns |
|
|
93
|
-
|
|
94
|
-
A missing stream when sound was planned, or a silent head on a generated bed, is exit 20 `SOUND_INVALID`.
|
|
95
|
-
A silent head on a supplied or authored track only warns, since the user's music may open quietly. An
|
|
96
|
-
authored file outside the stage folder, or a track that cannot be read or converted, is also exit 20 with
|
|
97
|
-
the field named.
|
|
98
|
-
|
|
99
|
-
## Hearing it before the render
|
|
100
|
-
|
|
101
|
-
```bash
|
|
102
|
-
node "$SKILL_ROOT/scripts/motion.mjs" sound --out <dir>
|
|
103
|
+
```json
|
|
104
|
+
"events": [{ "t": 6.42, "on": "the lid clicks open", "kind": "tap" }]
|
|
103
105
|
```
|
|
104
106
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
107
|
+
- `t`: the second the event happens on screen, read from the page's own timing (the same expression
|
|
108
|
+
the page draws with), never guessed from the beat;
|
|
109
|
+
- `on`: what happens at that frame, as a viewer would see it;
|
|
110
|
+
- `kind`: `tap` (a short click with a pitched body: a key, a latch, a landing), `hit` (the cut hit),
|
|
111
|
+
`whoosh` (air that ends on the event: something flies in) or `chime` (two notes of the key:
|
|
112
|
+
something completes).
|
|
113
|
+
|
|
114
|
+
At least two events, and at least half of them 0.1 s or more away from every cut, so the sound follows
|
|
115
|
+
the picture rather than only the edit. An event never snaps to a cut: it sounds at its own `t`. Each
|
|
116
|
+
one appears in `sound-cues.json` as `kind: "event"` with `sound`, `on` and `fromCut`. `sound-cues.json` lists
|
|
117
|
+
every cue with `kind`, `t` (seconds), `beatIndex`, `target` (the beat boundary or cut it serves)
|
|
118
|
+
and `delta` (`t − target`), plus the palette, key, tempo, loudness, peak, sample count and the
|
|
119
|
+
bed's sha256. Look question 6 ("does the sound follow the cuts and the events?") is answered from
|
|
120
|
+
this file and the stills: each asked-for accent should sit on its cut with a delta within one frame,
|
|
121
|
+
every cut the treatment marks for sound should have a cue, and each event's frame should show what its
|
|
122
|
+
`on` says.
|
|
123
|
+
|
|
124
|
+
## Loudness and limits
|
|
125
|
+
|
|
126
|
+
- 48 kHz, 16-bit, stereo WAV of exactly `round(frameCount × 48000 / fps)` samples.
|
|
127
|
+
- Integrated loudness −16 LUFS ± 2, measured in product code per ITU-R BS.1770-4 (K-weighting at
|
|
128
|
+
48 kHz, 400 ms blocks with 75 % overlap, −70 LUFS absolute and −10 LU relative gates). A
|
|
129
|
+
deterministic lookahead limiter (5 ms ahead, both channels linked, 80 ms release) keeps the track's
|
|
130
|
+
sample peak at or under −2 dBFS by turning the gain down before a peak, never by bending the
|
|
131
|
+
waveform, so the AAC encode does not push the decoded peak over the audit's −0.5 dBFS.
|
|
132
|
+
- The intro is audible from the first quarter second, so the track never opens on silence.
|
|
133
|
+
- The muxed stream is decoded and gated when `mode` is not `none`: a stream is present, its
|
|
134
|
+
duration is within ±0.1 s of the video, and its sample peak is at or under −0.5 dBFS. For a
|
|
135
|
+
score or a generated bed, no stretch below −50 dBFS RMS (50 ms windows) may last longer than 1.5 s in the
|
|
136
|
+
first 3 s; that failure, or a missing stream when sound was planned, is exit 20
|
|
137
|
+
(`SOUND_INVALID`). For a supplied or authored track the head rule only warns.
|
|
138
|
+
- Audio is encoded as AAC at 256 kb/s. A supplied or authored track is padded or trimmed to the
|
|
139
|
+
video's duration with a 50 ms fade; the encode never uses `-shortest`, so the audio can never cut
|
|
140
|
+
the film short.
|
|
141
|
+
|
|
142
|
+
## Commands
|
|
114
143
|
|
|
115
144
|
```bash
|
|
116
|
-
node "$SKILL_ROOT/scripts/motion
|
|
145
|
+
node "$SKILL_ROOT/scripts/motion.mjs" sound --out <dir>
|
|
117
146
|
```
|
|
118
147
|
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
148
|
+
reads `<dir>/treatment.json` and writes the score (`<dir>/sound/score.wav` and its stems) or a minimal
|
|
149
|
+
film's bed (`<dir>/sound/bed.wav`), and `<dir>/sound-cues.json`, so the track can be heard and its cues
|
|
150
|
+
checked before a render. The render rebuilds the track at the film's exact frame count and cut times,
|
|
151
|
+
so the muxed track always matches the film sample for sample. Two builds from the same treatment give
|
|
152
|
+
the same bytes.
|