@maccesar/titools 5.1.1 → 5.2.1

package/skills/ti-synthengine/references/source-notes.md

@@ -0,0 +1,109 @@
+# Maintaining the synthesis snapshot
+
+These references mirror the **public TiSynthEngine 1.0.0 release** at
+`e7cbbe8a6f9ab38088fd8029c7b43cef6501101f`, recorded in
+[source-snapshot.json](source-snapshot.json). The clean local checkout and remote
+main matched that commit on 2026-10-24. The repository is public; the Android
+and iOS releases are published, neither draft nor prerelease. Module availability
+is independent of publishing a new TiTools version.
+
+## Public downloads and artifact provenance
+
+| Platform | Published release | Package SHA-256 |
+| --- | --- | --- |
+| Android | [android-1.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/android-1.0.0) | `cf3510f290eca6dd00e8e0742a7db4f09dd2b8c4ef9270ed1f34d30eb32389cf` |
+| iOS / Mac Catalyst | [ios-1.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/ios-1.0.0) | `bc2e3f88c2945df721dd2196dfbb852c64aa98954b04460adf56ca41c75e6e91` |
+
+Both platform tags and `v1.0.0` point at the reviewed commit; only the two
+platform tags have GitHub release pages. Downloaded ZIPs were independently
+hashed and inspected: module ID `ti.synthengine`, version `1.0.0`, minimum
+Titanium `13.2.0.GA`; Android includes four ABIs and the Apple manifest enables
+Mac Catalyst. See the [guide](guide.md) for Android API35 and iOS15 requirements,
+app-root ZIP installation and both `tiapp.xml` declarations. These checks do not
+constitute a fresh device installation or audio acceptance run.
+
+## Sources and permitted transformations
+
+Eight official Markdown documents are mirrored into nine parts, including the
+ordered examples/advanced-examples split. The current snapshot inventories all
+complete JSON reports, bundled example assets and linked raw-evidence archives.
+The new [performance review](performance-review.json) and its raw archive are
+preserved alongside historical reports; none is replaced by a favorable summary.
+Read snapshot records for exact counts and hashes. Example JavaScript and raw
+reports/archives remain byte-identical to source.
+
+Each Markdown part and the example README have a local-commit provenance header and recorded navigation transformations. Native-backed corrections to stale official prose are also declared as reversible `link_fixes`; the source hash still identifies the original official text, not the corrected mirror. Reversible `link_fixes` rebase links into the split advanced examples, preserve [curated recipes](recipes.md), and resolve current example links to bundled assets. The example README points back to this skill's current API and guides. All three example JavaScript files remain byte-identical to source; none requires a historical GitHub snapshot.
+
+The fidelity regression strips provenance/navigation, concatenates example parts, reverses declared transformations and compares the complete source hash. Raw records must remain byte-identical. Update transformations intentionally; never change hashes merely to hide unexplained source drift.
+
+## Protected curated content
+
+[Retro recipes](recipes.md) and [interaction/instrument recipes](recipes-interaction.md) are TiTools contributions. Preserve their acoustic intent, lifecycle ownership and entry links when upstream docs change. Their native sequence examples keep the original millisecond onsets and total envelopes through separate `duration` and `length`; no JavaScript timer schedules notes. The repeated chord is now one centered native chord sequence; the separate one-off layered chord retains its per-voice stereo pans.
+
+Focused executable recipe tests inspect submitted intervals, envelope lengths, pitch and cancellation IDs. They do not render audio or measure native callback timing.
+
+## Current contract and acceptance boundaries
+
+`start` configures one engine, up to 32 shared voices and one to four preallocated sequence slots. `playSequence` is the only successive-sound scheduler and returns a positive ID or zero. Sequence edits, state queries and cancellation name that ID. Global `setTempo` governs beat timing and synchronized modulation; millisecond sequences retain fixed times. Finite playback is the default, and circular patterns explicitly opt into looping.
+
+Selective `music`, `effects`, `ui` and `ambience` categories feed one shared effect chain; an explicit per-voice send overrides category selection. Live spatial position, noise clock, low-pass cutoff and compatible continuous voice controls ramp over 10 ms while preserving history. Priorities protect higher-priority voices without reserved quotas. See the [API](api.md) for exact limits, source compatibility, return values and event delivery.
+
+The [performance review](performance-review.json) documents the accepted
+control-thread changes: partial sequence-bank preparation and removal of idle
+allocations/orphan held-position metadata. The Apple rendering bundle was
+rejected after a physical stereo regression, and production returned to the
+stable callback. Earlier candidate timings and fidelity checks remain evidence
+of that rejected candidate, not a promised Apple render speedup. Current matched
+Apple bypass measurements and actual hardware/rate/block-size scope are in the
+report; global performance acceptance remains open.
+
+Historical statistics, Studio/unified transport, physical/Frontier measurements
+and Android FIR8 correction reports keep their original artifact and acceptance
+boundaries. The short Android Sim80 headphone result had zero backend xruns and
+accepted listening; it does not close the distinct ten-minute maximum-load,
+bypass, memory and strict Frontier presentation criteria. Current evidence and
+rejected candidates must not be combined into a general pass. This skill update
+did not rerun devices, install binaries or alter native source.
+
+The October 23 native findings were independently rechecked against the
+published source on October 24. These current differences remain explicit;
+hash fidelity alone cannot establish them:
+
+- iOS timed tone/chord command construction still rounds accepted zero attack
+  and release to at least one sample; Android preserves zero. Validator
+  acceptance does not establish identical sample envelopes.
+- iOS early tempo/sequence/processing rejections and incompatible held spatial/
+  modulation edits can bypass rejection counters. Android also leaves some
+  unknown/retired sequence-stop returns uncounted. The recorded reason sum is
+  consistent with recorded totals, not a complete API-call rejection tally.
+- Sequence cutoff coefficients currently refresh every 16 samples on Android
+  and every 8 samples on Apple; both use note length but do not promise identical
+  sample output. See [engine details](audio-engine.md).
+- Android `getDefaults()` includes capabilities and additional limit metadata
+  that the current iOS dictionary omits. Both expose the corresponding APIs;
+  detect methods rather than requiring Android-only metadata flags. Sequence
+  intervals use different beat and millisecond ranges; see [API](api.md).
+- Remaining stale official claims are corrected only where verified against
+  current native behavior, with exact reversible transformations. Corrections
+  already adopted upstream are removed from the transformation list.
+
+
+These findings are skill corrections and module implementation findings, not
+native fixes. No module code, public range or hardware acceptance was changed.
+A validator corpus establishes accepted/rejected dictionaries, not sample-identical
+rendering on a physical device. Consumer scenarios and exact native locators
+are recorded in the maintainer's October 23 audit evidence.
+
+## Upstream documents outside the mirror set
+
+The official index is replaced by this skill's task routing. Dependency/license notices remain in the official module and binary packages. Both are recorded with hashes and reasons in `excluded_documents`, so changed or newly added documents still require review.
+
+## Verification after a reviewed update
+
+Run the focused mirror/link and recipe tests, then:
+
+```sh
+node scripts/verify-module-snapshot.mjs --source /path/to/TiSynthEngine --skill ti-synthengine
+```
+
+The verifier checks source/mirror hashes, exclusions, new documents, base HEAD and the exact tracked/untracked worktree fingerprint. Refresh that fingerprint only after the source changes are finished. No npm version, publication or native-device acceptance follows from this procedure.

package/skills/ti-synthengine/references/source-snapshot.json

@@ -0,0 +1,452 @@
+{
+  "module": "ti.synthengine",
+  "version": "1.0.0",
+  "repository": "https://github.com/macCesar/TiSynthEngine",
+  "commit": "e7cbbe8a6f9ab38088fd8029c7b43cef6501101f",
+  "reviewed_on": "2026-10-24",
+  "files": [
+    {
+      "source": "documentation/api.md",
+      "destination": "references/api.md",
+      "source_sha256": "698d272a85e71692eb5de30586556e53ba19aea88de3b0e583c2d720b150f24b",
+      "mirrored_sha256": "f4d43d6e947ccfa5cd04f2f76b4b19a00372f9ce1045c155f8265867839bae34",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "`setStatsEnabled` also returns Boolean acceptance. `stopAll`, `resetStats` and `shutdown` do not return a value. `getDefaults` returns the contract object described below. `getStats` returns a new statistics snapshot.",
+          "mirrored_markdown": "`setStatsEnabled` also returns Boolean acceptance. `stopAll`, `resetStats` and `shutdown` do not return a value. `getDefaults` returns the contract object described below. `getStats` returns a new statistics snapshot. `getSequenceState` returns the applied sequence state or `null`."
+        },
+        {
+          "original_markdown": "Android additionally reports `capabilities` flags for native sequences, master processing and modulations, plus `limits.stepDurationMs`. The current iOS result omits those keys while implementing the corresponding methods and millisecond sequences. Detect a required method with `typeof synth.playSequence === 'function'` (and the other methods your feature needs); a missing capability flag is not proof that a method is unavailable. Both platforms report the `limits` object shown here.",
+          "mirrored_markdown": "Android additionally reports `capabilities: { nativeSequence: true, masterProcessing: true, modulations: true }` and `limits.maxSequences`, `limits.priority`, `limits.effectSend` and `limits.stepDurationMs`. The reviewed iOS result omits those metadata keys while implementing the corresponding methods and option ranges. Detect the required methods instead of requiring an Android-only flag. `limits.stepDuration` is in beats on both platforms; for millisecond sequences the accepted range is `4000 / sampleRate` through 60,000."
+        },
+        {
+          "original_markdown": "| `stepDuration`              |  0.000001 |              60,000 | sequence units                                                                        |",
+          "mirrored_markdown": "| `stepDuration`              | `20 / sampleRate` | 300 | beats; returned by both platforms |\n| `stepDurationMs` | `4000 / sampleRate` | 60,000 | ms; returned by Android only, accepted in ms sequences on both |"
+        },
+        {
+          "original_markdown": "| `spatialX`, `spatialY` | Fixed binaural position in \u22121\u20261; omitted for stereo. |",
+          "mirrored_markdown": "| `spatialX`, `spatialY` | Initial binaural position in \u22121\u20261; omitted for stereo. Compatible held-position updates are live. |"
+        },
+        {
+          "original_markdown": "Omitted attack/release values are shortened to fit an event smaller than the default envelope. Explicit values must satisfy the documented envelope rules. `getDefaults()` reports the baseline defaults, not these per-event adjustments.",
+          "mirrored_markdown": "Omitted attack/release values are shortened to fit an event smaller than the default envelope. Explicit values must satisfy the documented envelope rules. `getDefaults()` reports the baseline defaults, not these per-event adjustments.\n\nAt this source pin, the iOS timed tone/chord command builder converts accepted\nzero attack/release values to at least one sample. Android retains zero samples.\nThis differs from the shared validator accepting zero; do not promise identical\nzero-edge rendering. Held notes have the separately documented 3 ms minimum."
+        },
+        {
+          "original_markdown": "| `rejectedRequestCount`     | Rejected Boolean API requests, counted once per call.                                                                                   |",
+          "mirrored_markdown": "| `rejectedRequestCount`     | Counted API rejections, including sequence-publication rejection; not a complete rejected-call tally on every native path. |"
+        },
+        {
+          "original_markdown": "| `rejectedRequestsByReason` | `{ validation, engineStopped, queueFull }`; sum equals rejection total.                                                                 |",
+          "mirrored_markdown": "| `rejectedRequestsByReason` | `{ validation, engineStopped, queueFull }`; sum equals the recorded rejection total. |"
+        },
+        {
+          "original_markdown": "`renderLoad`, `peakRenderLoad`, `outputPeakDbFS`, `outputRmsDbFS`, `preLimiterPeakDb`, `maxLimiterReductionDb` and `limiterReductionDb` are `null` until enabled and measured, and after shutdown.",
+          "mirrored_markdown": "At this source pin, iOS early rejections in tempo/sequence operations and a\nstopped `setMasterProcessing` call can bypass rejection counters. Incompatible\nheld spatial-mode or modulation updates also have uncounted iOS returns.\nAndroid counts more of these cases, but an unknown/retired `stopSequence` return\ncan also be uncounted. The reason sum equals the recorded total, not every\nrejected request. These counters are diagnostics; the API return is authoritative.\n\n`renderLoad`, `peakRenderLoad`, `outputPeakDbFS`, `outputRmsDbFS`, `preLimiterPeakDb`, `maxLimiterReductionDb` and `limiterReductionDb` are `null` until enabled and measured, and after shutdown."
+        },
+        {
+          "original_markdown": "With a full pool, release voices are replaced first, then the oldest attack.",
+          "mirrored_markdown": "Within priority-eligible candidates in a full pool, release voices are replaced first, then the oldest attack."
+        }
+      ]
+    },
+    {
+      "source": "documentation/audio-engine.md",
+      "destination": "references/audio-engine.md",
+      "source_sha256": "2299982e6949f6f2efe7ddad6cc4d28ea1b54e0f31fff36617e0528c5823ac4d",
+      "mirrored_sha256": "1927993a7b8ebd5abc735d2cf124f45b96ae461e4fc3f9342ae5e62137d491fe",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Each voice has a smoothstep attack, an optional smoothstep decay to `sustain`, a hold at that level and a smoothstep release. `duration` includes the whole envelope. Defaults are adjusted to fit a short event, while an explicit envelope that cannot fit is rejected by the contract.",
+          "mirrored_markdown": "Each voice has a smoothstep attack, an optional smoothstep decay to `sustain`, a hold at that level and a smoothstep release. For timed tones and chords, `duration` includes the whole envelope: defaults are adjusted to fit a short event, while an explicit envelope that cannot fit is rejected. Held voices release on `noteOff`; sequence notes release at their gate/length deadline. Held/sequence ADSR has no timed-event duration budget, and their release may continue beyond the sequence interval."
+        },
+        {
+          "original_markdown": "With `filterHzEnd` the cutoff follows `from * (to / from) ^ t`, where `t` runs from 0 to 1 across the event, and coefficients are recomputed every eighth sample. Without a sweep they are computed once, when the note starts.",
+          "mirrored_markdown": "For timed tones and chords, `filterHzEnd` follows `from * (to / from) ^ t`, where `t` runs from 0 to 1 across the event, and coefficients are recomputed every eighth sample. Native sequence cutoff sweeps instead use note length and then hold their target through release. The current Android renderer refreshes them every sixteenth sample, also forcing the target at the release deadline; the Apple renderer refreshes them every eighth sample. These renderer paths do not establish sample-identical platform output. Held live cutoff/Q and modulation updates have their own ramp/control paths. Without a sweep or live modulation, coefficients are computed once at note start."
+        },
+        {
+          "original_markdown": "No physical-device ten-minute maximum-load acceptance is claimed by these API changes.",
+          "mirrored_markdown": "These API changes do not establish complete multiplatform ten-minute maximum-load acceptance; the measured iPad result and Android limits are recorded separately in [physical validation](physical-validation.json) and [the performance summary](stats-performance.md)."
+        }
+      ]
+    },
+    {
+      "source": "documentation/examples.md",
+      "destination": "references/examples.md",
+      "source_sha256": "48104b9d413050d439ee605c92a2456a50b42c4c80e2d7c2c05706eecc7db215",
+      "mirrored_sha256": "100e1576be75f98201fea8ff0ba599a9582a98c8a3a1469aa2b206eeacfeafde",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "For interactive instruments and native processing, begin with [held motors](#sustained-game-motor), [native sequences](#native-sequence-with-chords-and-edits), [master processing](#chorus-delay-reverb-and-creative-saturation) or [two LFOs](#two-voice-lfos). Use matching official packages and check method availability before enabling a feature.",
+          "mirrored_markdown": "For interactive instruments and native processing, begin with [held motors](advanced-examples.md#sustained-game-motor), [native sequences](advanced-examples.md#native-sequence-with-chords-and-edits), [master processing](advanced-examples.md#chorus-delay-reverb-and-creative-saturation) or [two LFOs](advanced-examples.md#two-voice-lfos). Use matching official packages and check method availability before enabling a feature."
+        },
+        {
+          "original_markdown": "The startup example uses `ambient` for game/UI feedback. On iOS it respects silent mode and mixes with other apps. The module default is `playback`; Android validates either value without changing its output. Shut down before changing the policy. Use the [interactive session controls](../example/README.md#audio-session) to compare them.",
+          "mirrored_markdown": "The startup example uses `ambient` for game/UI feedback. On iOS it respects silent mode and mixes with other apps. The module default is `playback`; Android validates either value without changing its output. Shut down before changing the policy. Use the [interactive session controls](../assets/example/README.md#audio-session) to compare them."
+        },
+        {
+          "original_markdown": "Follow the [interactive demo setup and test checklist](../example/README.md) to run [`example/app.js`](../example/app.js). It includes headphone positioning, session selection, pattern completion/replacement and all three statistics methods. For a service-level statistics recipe, see [read engine statistics](guide.md#read-engine-statistics).",
+          "mirrored_markdown": "Follow the [interactive demo setup and test checklist](../assets/example/README.md) to run [`example/app.js`](../assets/example/app.js). It includes headphone positioning, session selection, pattern completion/replacement and all three statistics methods. For a service-level statistics recipe, see [read engine statistics](guide.md#read-engine-statistics)."
+        },
+        {
+          "original_markdown": "# Examples\n\nEvery snippet on this page uses the TiSynthEngine 1.0.0 contract. Unless a snippet includes startup code, it assumes the engine is already running.",
+          "mirrored_markdown": "# Examples\n\nEvery snippet on this page uses the TiSynthEngine 1.0.0 contract. Unless a snippet includes startup code, it assumes the engine is already running.\n\nAdditional [curated recipes](recipes.md) provide application sound and interaction variants."
+        },
+        {
+          "original_markdown": "",
+          "mirrored_markdown": "Continue with [advanced examples](advanced-examples.md).\n"
+        },
+        {
+          "original_markdown": "`stopAll()` fades current voices but leaves pending pattern scheduling alone. `shutdown()` cancels the scheduler and releases the native stream.",
+          "mirrored_markdown": "`stopAll()` stops all native sequences, fades current voices and invalidates effect histories. `shutdown()` also releases the native stream. To stop only one sequence owner, use `stopSequence({ sequenceId })`."
+        }
+      ],
+      "source_parts": [
+        "references/examples.md",
+        "references/advanced-examples.md"
+      ]
+    },
+    {
+      "source": "documentation/examples.md",
+      "destination": "references/advanced-examples.md",
+      "source_sha256": "48104b9d413050d439ee605c92a2456a50b42c4c80e2d7c2c05706eecc7db215",
+      "mirrored_sha256": "3852693b9faa70d615d9cf0bd4720055532d850f55e1e7b9c6a1a31115dc0639",
+      "links": [],
+      "link_fixes": [],
+      "source_parts": [
+        "references/examples.md",
+        "references/advanced-examples.md"
+      ]
+    },
+    {
+      "source": "documentation/guide.md",
+      "destination": "references/guide.md",
+      "source_sha256": "dd03392e1d5f89e520f4be70dab2fbad8e86776bf3a60d6af93f0dc0695c8c69",
+      "mirrored_sha256": "dd6a9ac277f22f965db20dbbd47c82a676600ceedc174cbe0c7dc4a6a0ca3152",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Release on touch end and cancellation as well as ordinary key up. Retry a rejected release twice at 16 ms outside the audio callback, then shut down and report failure if publication remains blocked. Cancel retries during teardown. The [held motor example](examples.md#sustained-game-motor) implements this ownership policy. For pause/owner close, invalidate app scheduling and shut down; require a new start before future notes.",
+          "mirrored_markdown": "Release on touch end and cancellation as well as ordinary key up. Retry a rejected release twice at 16 ms outside the audio callback, then shut down and report failure if publication remains blocked. Cancel retries during teardown. The [held motor example](advanced-examples.md#sustained-game-motor) implements this ownership policy. For pause/owner close, invalidate app scheduling and shut down; require a new start before future notes."
+        },
+        {
+          "original_markdown": "`setMasterProcessing` merges partial updates, validates the entire result and returns publication acceptance. Continuous controls ramp over 10 ms. Disabling an effect closes input gradually and keeps its tail, bounded to 30 seconds with a final fade, then restores exact bypass. It does not undo a non-unity input gain. `stopAll` invalidates histories and stops the native sequence; `shutdown` stops the stream and frees its buffers. See the [processing example](examples.md#chorus-delay-reverb-and-creative-saturation) and [field ranges](api.md#setmasterprocessingoptions).",
+          "mirrored_markdown": "`setMasterProcessing` merges partial updates, validates the entire result and returns publication acceptance. Continuous controls ramp over 10 ms. Disabling an effect closes input gradually and keeps its tail, bounded to 30 seconds with a final fade, then restores exact bypass. It does not undo a non-unity input gain. `stopAll` invalidates histories and stops the native sequence; `shutdown` stops the stream and frees its buffers. See the [processing example](advanced-examples.md#chorus-delay-reverb-and-creative-saturation) and [field ranges](api.md#setmasterprocessingoptions)."
+        },
+        {
+          "original_markdown": "Delay and LFO sync follow global `setTempo` (initially 120); free settings retain milliseconds or hertz. The two extra voice LFOs target filter cutoff, square PWM or sine FM, with sine/triangle waves. They are independent of `lfoFreq`/`lfoDepth` pitch vibrato. See [two LFOs](examples.md#two-voice-lfos).",
+          "mirrored_markdown": "Delay and LFO sync follow global `setTempo` (initially 120); free settings retain milliseconds or hertz. The two extra voice LFOs target filter cutoff, square PWM or sine FM, with sine/triangle waves. They are independent of `lfoFreq`/`lfoDepth` pitch vibrato. See [two LFOs](advanced-examples.md#two-voice-lfos)."
+        },
+        {
+          "original_markdown": "See the [complete field contract](api.md#getstats), [measurement limits](stats-performance.md) and [interactive statistics controls](../example/README.md#statistics).",
+          "mirrored_markdown": "See the [complete field contract](api.md#getstats), [measurement limits](stats-performance.md) and [interactive statistics controls](../assets/example/README.md#statistics)."
+        },
+        {
+          "original_markdown": "The current diagnostics add `preLimiterPeakDb` (maximum signal before final limiting, in dBFS) and `maxLimiterReductionDb` (greatest limiter attenuation in dB) accumulated since reset. Unlike the approximately 200 ms window reduction field, brief peaks remain visible between UI polls. Enable measurements, reset before the scenario and keep `null`/absent fields distinct from measured zero. The [measurement example](examples.md#measure-peaks-and-limiter-reduction) shows opt-in polling and cleanup.",
+          "mirrored_markdown": "The current diagnostics add `preLimiterPeakDb` (maximum signal before final limiting, in dBFS) and `maxLimiterReductionDb` (greatest limiter attenuation in dB) accumulated since reset. Unlike the approximately 200 ms window reduction field, brief peaks remain visible between UI polls. Enable measurements, reset before the scenario and keep `null`/absent fields distinct from measured zero. The [measurement example](advanced-examples.md#measure-peaks-and-limiter-reduction) shows opt-in polling and cleanup."
+        },
+        {
+          "original_markdown": "`updateVoice` changes compatible pitch, volume, cutoff/Q, vibrato, PWM/FM and LFO targets with 10 ms ramps, without restarting oscillator/envelope phase. Source, table, filter type, noise clock, one-pole cutoff, ADSR and spatial position are fixed at attack. See [complete fields](api.md#updatevoiceoptions). A note that has ended or been stolen accepts updates as a no-op; there is no note-finished event or reserved slot. A `true` return means accepted publication, not proof that the sound is still active.",
+          "mirrored_markdown": "`updateVoice` changes compatible pitch, volume, cutoff/Q, vibrato, PWM/FM, LFO targets, noise clock, one-pole cutoff, effect send and stereo/spatial position with 10 ms ramps, without restarting oscillator/envelope phase or clearing spatial history. Source, table, filter type and ADSR are fixed at attack. Spatial edits require a voice started spatially; stereo pan edits require a stereo voice. See [complete fields](api.md#updatevoiceoptions). A note that has ended or been stolen accepts updates as a no-op; there is no note-finished event or reserved slot. A `true` return means accepted publication, not proof that the sound is still active."
+        },
+        {
+          "original_markdown": "Calls that create or change sound return `true` when accepted and `false` when rejected. During development, handle that result and inspect logcat or the Xcode console for the structured validation warning.",
+          "mirrored_markdown": "Timed and held sound calls and accepted edits return `true` when accepted and `false` when rejected. `playSequence` instead returns a positive sequence ID or `0`; state queries return their documented state or `null`, and lifecycle/cleanup methods follow their own return contracts. During development, handle the relevant result and inspect logcat or the Xcode console for the structured validation warning."
+        },
+        {
+          "original_markdown": "Master volume is ramped to avoid a step in the output. `stopAll()` fades active voices, but it does not cancel future steps in the current pattern. Start a new pattern or call `shutdown()` when future scheduling must stop as well.",
+          "mirrored_markdown": "Master volume is ramped to avoid a step in the output. `stopAll()` stops all native sequences, fades active voices and invalidates effect histories while leaving the engine available. Use `stopSequence({ sequenceId })` to stop only one owner and preserve unrelated sounds. `shutdown()` also stops the stream and releases its resources."
+        },
+        {
+          "original_markdown": "Supply the current position whenever an effect fires. A projectile launch cue can use the launch position; an impact uses the collision position. Repeated short motor events can use successive positions. A single active tone cannot move after submission because positions remain fixed, including on an identified sustained voice. Stereo `panEnd` movement cannot be combined with binaural; do not continually retrigger long sounds every frame to imitate movement.",
+          "mirrored_markdown": "Supply the current position whenever an effect fires. A projectile launch cue can use the launch position; an impact uses the collision position. Timed event positions remain fixed after submission. An identified sustained voice started spatially can instead change `spatialX`/`spatialY` through `updateVoice`, with 10 ms ramps and retained spatial history. A stereo voice cannot become spatial through an update. Stereo `panEnd` movement cannot be combined with binaural; do not continually retrigger long sounds every frame to imitate movement."
+        }
+      ]
+    },
+    {
+      "source": "documentation/recommendations.md",
+      "destination": "references/recommendations.md",
+      "source_sha256": "206593e03b860b2d1c39316bf286cd276307bdb0120be050c262b21749bcccd8",
+      "mirrored_sha256": "d574b349ab54e4e176f24075e1a04b826784c1908ab69db6d7b8725b5ceae431",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Fixed input/event gain does not decrease when unrelated voices start. If level dips, inspect `maxLimiterReductionDb` and `preLimiterPeakDb`, then consider same-pitch phase cancellation or the device's speaker protection. Eight coherent independent voices can still exceed the limiter threshold; module capacity is not a clean-mix loudness guarantee. See [measurement example](examples.md#measure-peaks-and-limiter-reduction).",
+          "mirrored_markdown": "Fixed input/event gain does not decrease when unrelated voices start. If level dips, inspect `maxLimiterReductionDb` and `preLimiterPeakDb`, then consider same-pitch phase cancellation or the device's speaker protection. Eight coherent independent voices can still exceed the limiter threshold; module capacity is not a clean-mix loudness guarantee. See [measurement example](advanced-examples.md#measure-peaks-and-limiter-reduction)."
+        },
+        {
+          "original_markdown": "Count release tails along with buttons pressed at the same instant. Timed-only events steal the slot with the least time remaining; sustained/transport voices prefer a releasing slot, then the oldest attack.",
+          "mirrored_markdown": "Count release tails along with buttons pressed at the same instant. Replacement first selects the lowest eligible priority; higher-priority voices are protected. Among that priority, timed-only events steal the slot with the least time remaining; sustained/transport voices prefer a releasing slot, then the oldest attack."
+        },
+        {
+          "original_markdown": "- Timed tones, chords and pattern steps last at most 60 seconds. Sustained `noteOn` voices last until release, replacement or shutdown.",
+          "mirrored_markdown": "- Timed tones and chords last at most 60 seconds including release. Sequence intervals and explicit note lengths use the sequence unit, at most 300 beats or 60,000 ms; sequence ADSR remains in milliseconds and release may extend beyond the interval. Sustained `noteOn` voices last until release, replacement or shutdown."
+        },
+        {
+          "original_markdown": "Keep chorus/delay/reverb mixes modest when dialogue or short game feedback must remain distinct. They process the whole mix, so enabling reverb for a victory chord also affects simultaneous shots and collisions. Use an isolated presentation context, or close effect input before returning to gameplay.",
+          "mirrored_markdown": "Keep chorus/delay/reverb mixes modest when dialogue or short game feedback must remain distinct. One shared chain processes selected categories, not necessarily the whole mix. Select `applyTo` categories and each event's `bus`; an explicit `effectSend` overrides category selection. For example, select `music` for a victory sequence and leave `effects` dry, or set an individual shot's send to 0. Input/master gains and the final limiter remain global."
+        }
+      ]
+    },
+    {
+      "source": "documentation/sound-design.md",
+      "destination": "references/sound-design.md",
+      "source_sha256": "dd543e07c825aaf67a0a5f85619088a8d02721a9d33dbf4579edf760dad3e262",
+      "mirrored_sha256": "f2e2207eeaae5e8061b37dfb5fac98ef9b9c050845b23a547b468ceba718e740",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Choose a held voice when the ending follows a player action instead of a fixed duration: motor, charge beam, pad or the last chord of a ceremony. `noteOn` starts a positive app-owned ID; `noteOff` begins release from the current level, and compatible `updateVoice` edits ramp over 10 ms. Distinct IDs remain independent events with fixed gain. Reserve enough capacity for their releases and unrelated effects, and release on cancellation as well as ordinary key up. See the [held motor recipe](examples.md#sustained-game-motor) for retry/cleanup handling.",
+          "mirrored_markdown": "Choose a held voice when the ending follows a player action instead of a fixed duration: motor, charge beam, pad or the last chord of a ceremony. `noteOn` starts a positive app-owned ID; `noteOff` begins release from the current level, and compatible `updateVoice` edits ramp over 10 ms. Distinct IDs remain independent events with fixed gain. Reserve enough capacity for their releases and unrelated effects, and release on cancellation as well as ordinary key up. See the [held motor recipe](advanced-examples.md#sustained-game-motor) for retry/cleanup handling."
+        },
+        {
+          "original_markdown": "The two additional voice LFOs move filter cutoff, square PWM or sine FM index using sine/triangle shapes. Cutoff movement creates slow breathing or rhythmic filtering; PWM adds changing harmonic color; a small FM-index modulation varies brightness. Free rates reach 20 Hz, and synced rates follow native transport tempo. These slots are separate from pitch vibrato. Avoid deep/high-rate modulation with strong resonance or high-frequency FM; safe parameter clamping does not guarantee a pleasant or alias-free sound. The [two-LFO example](examples.md#two-voice-lfos) shows a filtered PWM pad.",
+          "mirrored_markdown": "The two additional voice LFOs move filter cutoff, square PWM or sine FM index using sine/triangle shapes. Cutoff movement creates slow breathing or rhythmic filtering; PWM adds changing harmonic color; a small FM-index modulation varies brightness. Free rates reach 20 Hz, and synced rates follow native transport tempo. These slots are separate from pitch vibrato. Avoid deep/high-rate modulation with strong resonance or high-frequency FM; safe parameter clamping does not guarantee a pleasant or alias-free sound. The [two-LFO example](advanced-examples.md#two-voice-lfos) shows a filtered PWM pad."
+        },
+        {
+          "original_markdown": "All processors are off initially, with input gain 1. Enable one shared chain through `setMasterProcessing`; select `applyTo` categories such as `music` and `ambience` to keep explosions dry. Per-voice `effectSend` overrides that category selection. [Configuration](examples.md#chorus-delay-reverb-and-creative-saturation) and [exact ranges](api.md#setmasterprocessingoptions) explain chorus, delay, reverb and optional saturation.",
+          "mirrored_markdown": "All processors are off initially, with input gain 1. Enable one shared chain through `setMasterProcessing`; select `applyTo` categories such as `music` and `ambience` to keep explosions dry. Per-voice `effectSend` overrides that category selection. [Configuration](advanced-examples.md#chorus-delay-reverb-and-creative-saturation) and [exact ranges](api.md#setmasterprocessingoptions) explain chorus, delay, reverb and optional saturation."
+        },
+        {
+          "original_markdown": "# Sound design with TiSynthEngine\n\nTiSynthEngine generates sound with oscillators, without recorded samples. Pitch, waveform, envelope, movement and level define each sound, from interface feedback and musical cues to alarms, retro effects and simple percussion.",
+          "mirrored_markdown": "# Sound design with TiSynthEngine\n\nTiSynthEngine generates sound with oscillators, without recorded samples. Pitch, waveform, envelope, movement and level define each sound, from interface feedback and musical cues to alarms, retro effects and simple percussion.\n\nAdditional [curated recipes](recipes.md) provide application sound and interaction variants."
+        }
+      ]
+    },
+    {
+      "source": "documentation/troubleshooting.md",
+      "destination": "references/troubleshooting.md",
+      "source_sha256": "939960cde5860569699916208c0d3b352e60ba2a7603b5046dcefa9970294b70",
+      "mirrored_sha256": "70ee69508273b3c89d52a8c8feb6c58400433a5a50e298e38da5076ded19a8a8",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Check Boolean returns. A full public queue can reject `noteOff`; retry twice at 16 ms outside render, then shut down/report if still rejected. Cancel those retries on owner teardown. The [held motor example](examples.md#sustained-game-motor) implements this policy. Touch cancellation, pause and close need cleanup as well as normal key up.",
+          "mirrored_markdown": "Check Boolean returns. A full public queue can reject `noteOff`; retry twice at 16 ms outside render, then shut down/report if still rejected. Cancel those retries on owner teardown. The [held motor example](advanced-examples.md#sustained-game-motor) implements this policy. Touch cancellation, pause and close need cleanup as well as normal key up."
+        },
+        {
+          "original_markdown": "Enable diagnostics, reset deliberately, then inspect `preLimiterPeakDb` and `maxLimiterReductionDb`. They retain the native pre-limiter peak and greatest attenuation since reset, including brief interventions between UI polls. `limiterReductionDb` is a window measurement and can return to zero sooner. Older packages may omit the accumulated fields; disabled/unmeasured diagnostics return `null`. See [measurement example](examples.md#measure-peaks-and-limiter-reduction).",
+          "mirrored_markdown": "Enable diagnostics, reset deliberately, then inspect `preLimiterPeakDb` and `maxLimiterReductionDb`. They retain the native pre-limiter peak and greatest attenuation since reset, including brief interventions between UI polls. `limiterReductionDb` is a window measurement and can return to zero sooner. Older packages may omit the accumulated fields; disabled/unmeasured diagnostics return `null`. See [measurement example](advanced-examples.md#measure-peaks-and-limiter-reduction)."
+        },
+        {
+          "original_markdown": "| `conflicting_pitch_fields`          | Send only one of `note`, `frequency` or `rest: true`.",
+          "mirrored_markdown": "| `conflicting_pitch_fields`          | Timed/held calls use mutually exclusive `note`/`frequency`; each sequence step uses exactly one `notes` array, `frequencies` array or `rest: true`."
+        },
+        {
+          "original_markdown": "The envelope and filter rules apply to the final values of each sounding event. In a pattern that means the step over the pattern root, so a `sustain` on the root is fine when each step supplies a `decay`, and a root `filterHz` is rejected when no step has a `filterType`.",
+          "mirrored_markdown": "The envelope and filter rules apply to the final values of each sounding event. In a native sequence, each step's `overrides` merges over root `voice`: root `voice.sustain` is valid when every sounding step supplies compatible decay, and `voice.filterHz` needs a non-none filter type after merging. Timed tones/chords enforce their total-duration envelope budget; held and sequence ADSR has no sequence-interval budget."
+        },
+        {
+          "original_markdown": "- Positions are fixed for active voices. Later calls can use updated coordinates, but there is no method to move a voice already playing.",
+          "mirrored_markdown": "- Timed tones/chords and each sequence attack keep their specified position. A spatial held voice can move through `updateVoice({ voiceId, spatialX, spatialY })`; omitted coordinates retain their previous value, and the FIR ramps over 10 ms without clearing history. A stereo voice cannot be converted to spatial by an update."
+        },
+        {
+          "original_markdown": "Use the original positive `voiceId`, not the pitch or an ID that has already been reused. `noteOn` does not accept `duration` or temporal `*End` fields. `updateVoice` cannot change source, filter type, table, noise clock, ADSR or spatial position; restart with a new ID when those attack-time settings must change. Compatible continuous edits ramp for 10 ms.",
+          "mirrored_markdown": "Use the original positive `voiceId`, not the pitch or an ID that has already been reused. `noteOn` does not accept `duration` or temporal `*End` fields. Source, filter type, table, quantization and ADSR require a new attack. Compatible `updateVoice` controls include live noise clock, one-pole cutoff, spatial position for a spatial voice, stereo pan for a stereo voice, modulation and explicit effect send, in addition to pitch/volume/filter/vibrato/FM/pulse targets. Changed continuous controls ramp for 10 ms while retaining phase, envelope and spatial history; `noiseRate: 0` means white noise and `lowPassHz: 0` bypasses that filter."
+        },
+        {
+          "original_markdown": "Look for a structured warning in logcat or the Xcode console:\n\n```text\nevent=validation_warning method=playSequence key=steps reason=not_object action=rejected value=C4\n```",
+          "mirrored_markdown": "For methods that emit structured validation warnings, inspect logcat or the Xcode console:\n\n```text\nevent=validation_warning method=playTone key=duraton reason=unsupported_option action=rejected value=200\n```\n\nAlways check the return value: `playSequence` rejects with 0, while Boolean methods reject with `false`. Some sequence/control rejection paths do not emit a structured warning; absence of a new log entry does not establish acceptance."
+        },
+        {
+          "original_markdown": "Use whole milliseconds and integer waveform values where required.",
+          "mirrored_markdown": "Use integer milliseconds for timed tone/chord envelope fields and integer waveform values; native sequence intervals and lengths may be fractional."
+        }
+      ]
+    },
+    {
+      "source": "documentation/stats-performance.md",
+      "destination": "references/stats-performance.md",
+      "source_sha256": "3d6d35b9e0e49a778777d406418eaba04ebd57da871a322da28fae0190c5cb17",
+      "mirrored_sha256": "576910d2ee7e3026b083136713e8ceba0b4cbb774958bd65f3751612d9360467",
+      "links": [],
+      "link_fixes": []
+    },
+    {
+      "source": "documentation/stats-performance.json",
+      "destination": "references/stats-performance.json",
+      "source_sha256": "bd0cf07295d0d8f1120e66f527e9ca6d9a014efdc43dff5675716e8e26abe5b3",
+      "mirrored_sha256": "bd0cf07295d0d8f1120e66f527e9ca6d9a014efdc43dff5675716e8e26abe5b3",
+      "links": [],
+      "link_fixes": []
+    },
+    {
+      "source": "documentation/studio-validation.json",
+      "destination": "references/studio-validation.json",
+      "source_sha256": "b6abcf9229b8bb812cb4da467e3c495ab66c41041fb7562ca3c371d79671509b",
+      "mirrored_sha256": "b6abcf9229b8bb812cb4da467e3c495ab66c41041fb7562ca3c371d79671509b",
+      "links": [],
+      "link_fixes": []
+    },
+    {
+      "source": "documentation/unified-bypass-performance.json",
+      "destination": "references/unified-bypass-performance.json",
+      "source_sha256": "12622f00804bd866be90ac40579b868e8f6fcbd35635bf8000febb21adef2563",
+      "mirrored_sha256": "12622f00804bd866be90ac40579b868e8f6fcbd35635bf8000febb21adef2563",
+      "links": [],
+      "link_fixes": []
+    },
+    {
+      "source": "documentation/unified-validation.json",
+      "destination": "references/unified-validation.json",
+      "source_sha256": "4754da69159f4ab35544d0f0a8ef6e5568dda9e74162b1c2dad2bb807d905fd8",
+      "mirrored_sha256": "4754da69159f4ab35544d0f0a8ef6e5568dda9e74162b1c2dad2bb807d905fd8",
+      "links": [],
+      "link_fixes": []
+    },
+    {
+      "source": "documentation/physical-validation.json",
+      "destination": "references/physical-validation.json",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "73233c11a1d2aa06654a06486ef52a08d961473d83b0c5b2a44e19a6eac28c0b",
+      "mirrored_sha256": "73233c11a1d2aa06654a06486ef52a08d961473d83b0c5b2a44e19a6eac28c0b"
+    },
+    {
+      "source": "documentation/frontier-physical-validation.json",
+      "destination": "references/frontier-physical-validation.json",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "e64c6b853c6a648bb6ce74ca13f27db30c93f5e1a2b89a495d439dedf8bc1d9d",
+      "mirrored_sha256": "e64c6b853c6a648bb6ce74ca13f27db30c93f5e1a2b89a495d439dedf8bc1d9d"
+    },
+    {
+      "source": "example/README.md",
+      "destination": "assets/example/README.md",
+      "kind": "example-asset",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "The Classic Titanium app in [app.js](app.js) demonstrates the timed sounds, native sequences and statistics with the `sequenceend` event on Android and iOS. It uses the current 1.0.0 module packages, including binaural and statistics support. Held voices, master processing and voice LFOs have copyable examples in the [advanced documentation](../documentation/examples.md#sustained-game-motor); this reference app does not expose those newer controls. The default engine configuration is 16 voices, `conservative` mixing and the `playback` session; master volume starts at 100% and optional diagnostics start off.",
+          "mirrored_markdown": "The Classic Titanium app in [app.js](app.js) demonstrates the timed sounds, native sequences and statistics with the `sequenceend` event on Android and iOS. It uses the current 1.0.0 module packages, including binaural and statistics support. Held voices, master processing and voice LFOs have copyable examples in the [advanced documentation](../../references/advanced-examples.md#sustained-game-motor); this reference app does not expose those newer controls. The default engine configuration is 16 voices, `conservative` mixing and the `playback` session; master volume starts at 100% and optional diagnostics start off."
+        },
+        {
+          "original_markdown": "5. Build and run the test app with the Titanium CLI or your existing Titanium launch configuration. Use Titanium SDK 13.2.0.GA or newer, Android compile API 35 or newer, and iOS 15 or newer. See the [module installation guide](../documentation/guide.md#install-the-module).",
+          "mirrored_markdown": "5. Build and run the test app with the Titanium CLI or your existing Titanium launch configuration. Use Titanium SDK 13.2.0.GA or newer, Android compile API 35 or newer, and iOS 15 or newer. See the [module installation guide](../../references/guide.md#install-the-module)."
+        },
+        {
+          "original_markdown": "SPATIAL CHORD places the whole chord above/right. SPATIAL PATTERN places three broadband hits above/left, below/center and above/right using per-step coordinates. Neither sends stereo pan fields while binaural is active. The output remains two channels on a front plane, without rear positioning, distance attenuation or head tracking. See the [app integration guide](../documentation/guide.md#integrate-binaural-in-a-2d-app) for source mapping and amplitude sliders.",
+          "mirrored_markdown": "SPATIAL CHORD places the whole chord above/right. SPATIAL PATTERN places three broadband hits above/left, below/center and above/right using per-step coordinates. Neither sends stereo pan fields while binaural is active. The output remains two channels on a front plane, without rear positioning, distance attenuation or head tracking. See the [app integration guide](../../references/guide.md#integrate-binaural-in-a-2d-app) for source mapping and amplitude sliders."
+        },
+        {
+          "original_markdown": "Completion marks the final scheduled step; releases and shared effect tails can remain audible. See the [event contract](../documentation/api.md#sequenceend-event).",
+          "mirrored_markdown": "Completion marks the final scheduled step; releases and shared effect tails can remain audible. See the [event contract](../../references/api.md#sequenceend-event)."
+        },
+        {
+          "original_markdown": "The panel shows active/peak/spatial/tail voices, pending commands, replacements, request/publication rejections, priority drops, callback load, stereo output peak and backend underruns. It displays `n/a` for unmeasured or unavailable values, keeping them distinct from zero. Signal windows need about 200 ms of output after enabling. Native snapshots also include RMS, limiter reduction, sample rate, buffer and latency fields; consult the [complete field reference](../documentation/api.md#getstats) when integrating a full diagnostic view.",
+          "mirrored_markdown": "The panel shows active/peak/spatial/tail voices, pending commands, replacements, request/publication rejections, priority drops, callback load, stereo output peak and backend underruns. It displays `n/a` for unmeasured or unavailable values, keeping them distinct from zero. Signal windows need about 200 ms of output after enabling. Native snapshots also include RMS, limiter reduction, sample rate, buffer and latency fields; consult the [complete field reference](../../references/api.md#getstats) when integrating a full diagnostic view."
+        },
+        {
+          "original_markdown": "2. Build the current module source, or use the matching packages supplied with the public release when available. Development archives are `android/dist/ti.synthengine-android-1.0.0.zip` and `ios/dist/ti.synthengine-iphone-1.0.0.zip`. The existing private release is a separate snapshot and may lack current features.",
+          "mirrored_markdown": "2. Download matching official [Android 1.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/android-1.0.0) and [iOS 1.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/ios-1.0.0) packages, or build the matching module source. Source builds produce `android/dist/ti.synthengine-android-1.0.0.zip` and `ios/dist/ti.synthengine-iphone-1.0.0.zip`."
+        }
+      ],
+      "source_sha256": "c3c5041be11c3addfab7fb1248c0aaba81b311c1720c2861e47974412d743bcf",
+      "mirrored_sha256": "e7c522bc9a9ca52d4d103125226491c04d4a6bfab8433192a5a0dbfaef94428e"
+    },
+    {
+      "source": "example/app.js",
+      "destination": "assets/example/app.js",
+      "kind": "example-asset",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "1d121412dd2146d75d6b8c1665a28411b9e9c13e626f00284c88f3ba555f3b7e",
+      "mirrored_sha256": "1d121412dd2146d75d6b8c1665a28411b9e9c13e626f00284c88f3ba555f3b7e"
+    },
+    {
+      "source": "example/lib/sequenceScore.js",
+      "destination": "assets/example/lib/sequenceScore.js",
+      "kind": "example-asset",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "636c20d4ba81affc087b96cc70443798e7a473a47d6dda6820c60362fe81d60f",
+      "mirrored_sha256": "636c20d4ba81affc087b96cc70443798e7a473a47d6dda6820c60362fe81d60f"
+    },
+    {
+      "source": "example/lib/sequenceOwner.js",
+      "destination": "assets/example/lib/sequenceOwner.js",
+      "kind": "example-asset",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "2c7a639aa9e7347872240556734165a749e4abb44f19cb14546d9ae822e1c5b3",
+      "mirrored_sha256": "2c7a639aa9e7347872240556734165a749e4abb44f19cb14546d9ae822e1c5b3"
+    },
+    {
+      "source": "documentation/bypass-physical-recheck-evidence.zip",
+      "destination": "references/bypass-physical-recheck-evidence.zip",
+      "kind": "evidence-archive",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "910eb9eafebd7d46797192053ec7f4f9f3fc88c6bfd1b83b07acefd1e51603a2",
+      "mirrored_sha256": "910eb9eafebd7d46797192053ec7f4f9f3fc88c6bfd1b83b07acefd1e51603a2"
+    },
+    {
+      "source": "documentation/frontier-android-evidence.zip",
+      "destination": "references/frontier-android-evidence.zip",
+      "kind": "evidence-archive",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "217a06978982d601ad10796865b22dbac69f202e4bf91ae07ba268734d4fef08",
+      "mirrored_sha256": "217a06978982d601ad10796865b22dbac69f202e4bf91ae07ba268734d4fef08"
+    },
+    {
+      "source": "documentation/frontier-ipad-evidence.zip",
+      "destination": "references/frontier-ipad-evidence.zip",
+      "kind": "evidence-archive",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "56369b202d279efbf4f9a720a0a99dba2f398410cb8e042ef1200a3a63be245b",
+      "mirrored_sha256": "56369b202d279efbf4f9a720a0a99dba2f398410cb8e042ef1200a3a63be245b"
+    },
+    {
+      "source": "documentation/android-sim80-correction.json",
+      "destination": "references/android-sim80-correction.json",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "675c2201b9e0bfad7c8bf6255f8a9440eb45ef0a915c24eee9e47db12745a1c0",
+      "mirrored_sha256": "675c2201b9e0bfad7c8bf6255f8a9440eb45ef0a915c24eee9e47db12745a1c0"
+    },
+    {
+      "source": "documentation/android-sim80-correction-evidence.zip",
+      "destination": "references/android-sim80-correction-evidence.zip",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "faff448de458ef0cb5299e234177f17a914f7801c27581ab969a9010a68c3c5f",
+      "mirrored_sha256": "faff448de458ef0cb5299e234177f17a914f7801c27581ab969a9010a68c3c5f",
+      "kind": "evidence-archive"
+    },
+    {
+      "source": "documentation/performance-review.json",
+      "destination": "references/performance-review.json",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "e822b3361bb5cdb31e635863d84b179ef41edfe6a1214ae99ca3a9d327d21d3a",
+      "mirrored_sha256": "e822b3361bb5cdb31e635863d84b179ef41edfe6a1214ae99ca3a9d327d21d3a"
+    },
+    {
+      "source": "documentation/performance-review-evidence.zip",
+      "destination": "references/performance-review-evidence.zip",
+      "links": [],
+      "link_fixes": [],
+      "kind": "evidence-archive",
+      "source_sha256": "0539e799d66ed26ef5d64f727dd30bec55692bfd691584e25753999c545b8cf6",
+      "mirrored_sha256": "0539e799d66ed26ef5d64f727dd30bec55692bfd691584e25753999c545b8cf6"
+    }
+  ],
+  "excluded_documents": [
+    {
+      "source": "documentation/index.md",
+      "source_sha256": "7bdbf702ce26903d7a68e267d3451ec0bb728c822ad576393727daf4be9e039f",
+      "reason": "Upstream documentation index; SKILL.md is the distributed navigation entry point."
+    },
+    {
+      "source": "documentation/third-party-notices.md",
+      "source_sha256": "1ff6f3082dec146feb00d790a2abc6f1f97e2f455b2a31c0152a6faae578ddb9",
+      "reason": "Dependency and KEMAR notices remain with the official module and its binary packages; this skill redistributes documentation, not the native code or HRTF data. Re-review attribution when the source notice changes."
+    }
+  ],
+  "source_state": "committed",
+  "reviewed_worktree_sha256": "e4f60d0aa6d7f3d3b6a6494b1c861b99f649c6f9ec51abaf201b20f297327c95"
+}