@maccesar/titools 5.2.3 → 5.2.5

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

@@ -1,83 +1,50 @@
 {
   "module": "ti.synthengine",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "repository": "https://github.com/macCesar/TiSynthEngine",
-  "commit": "4a45f21230ffc5a8838fbd5fc108dd3ab470362a",
-  "reviewed_on": "2026-10-29",
+  "commit": "ec04f4e634075c41b55f66279eabcd78b9652d58",
+  "reviewed_on": "2026-11-02",
   "files": [
     {
       "source": "documentation/api.md",
       "destination": "references/api.md",
-      "source_sha256": "0eae9bb5d07500fd33a9b767bd0036a491a2947954cd5c3b7fa51035ba375857",
-      "mirrored_sha256": "051a499208a68078f2cfb6e7293f8abfac539c6b0156d9d1291beedc0d341ae6",
+      "source_sha256": "b58d60cf38a96157e523722d1f9cb9508f785cc2de9c2c1ff306e328c77df9dc",
+      "mirrored_sha256": "b19142e8356eb80f62202bdf3bdd9c2fa0301ae205761e89f0f9dab981c26fb2",
       "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.stepDurationMs`. The reviewed iOS result omits those two metadata entries while implementing the corresponding methods and millisecond sequences. Both platforms report `limits.maxSequences`, `limits.priority` and `limits.effectSend`. 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": "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."
-        }
-      ]
+      "link_fixes": []
     },
     {
       "source": "documentation/audio-engine.md",
       "destination": "references/audio-engine.md",
-      "source_sha256": "17fb01f7e32a91cc44a3b5c0f30efcd7b5c3d9ec6c49369f7c789e1f22a8b442",
-      "mirrored_sha256": "30f14c5cc7b296e708bdb06b84e6d32475abbf7827af587466b9fdaf86bc8547",
+      "source_sha256": "3e7728703a9f82631f5c4ba2641b1a9735c0d3988ef9001b8e4a4f5e47d1818d",
+      "mirrored_sha256": "a43c94c7f72913438d529a1cbd8a13dcb6df0da317ee548b5064fdf587f7f5ab",
       "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": "The [performance review](../docs/validation/performance-review.json) separates measured host improvements, exact compatibility checks and pending device acceptance. Its [raw evidence](../docs/validation/performance-review-evidence.zip) retains rejected prototypes and the investigation of idle/stereo regressions. The Apple FIR, stable-control cache and exact idle-effects bypass were evaluated as one atomic candidate and then rejected after physical 32-stereo timing regressed. All three production changes were removed together; the full-score publication and control-memory fixes remain.",
+          "mirrored_markdown": "The [performance review](performance-review.json) separates measured host improvements, exact compatibility checks and pending device acceptance. Its [raw evidence](performance-review-evidence.zip) retains rejected prototypes and the investigation of idle/stereo regressions. The Apple FIR, stable-control cache and exact idle-effects bypass were evaluated as one atomic candidate and then rejected after physical 32-stereo timing regressed. All three production changes were removed together; the full-score publication and control-memory fixes remain."
         },
         {
-          "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)."
+          "original_markdown": "The [Studio technical validation report](../docs/validation/studio-validation.json) records the calibration and corrected full-chain host benchmark, including failed deadline acceptance and pending device checks. Its host performance result must not be presented as hardware realtime acceptance.",
+          "mirrored_markdown": "The [Studio technical validation report](studio-validation.json) records the calibration and corrected full-chain host benchmark, including failed deadline acceptance and pending device checks. Its host performance result must not be presented as hardware realtime acceptance."
         },
         {
-          "original_markdown": "`tools/build_ios_render_host.py` compiles the actual Objective-C render-block body and voice/transport helpers on macOS. It replaces hardware/session/Titanium startup and fixes only the noise-seed/disabled-diagnostic clock. Output and semantic state are compared against a separately archived reference from the same platform. This is an Apple renderer test; it does not execute AVAudioEngine or establish iPad scheduling, route recovery, footprint or listening acceptance.",
-          "mirrored_markdown": "`tools/build_ios_render_host.py` compiles the actual Objective-C render-block body and voice/transport helpers on macOS. It replaces hardware/session/Titanium startup and fixes only the noise-seed/disabled-diagnostic clock. Output and semantic state are compared against a separately archived reference from the same platform. This is an Apple renderer test; it does not execute AVAudioEngine or establish iPad scheduling, route recovery, footprint or listening acceptance.\n\nThe commands below reproduce the historical pre-pipeline performance review. Use its archived candidate source when requiring exact PCM/state equality with `7ab3110`; the current 1.0.2 renderer intentionally removes the old final-output delay and changes overload behavior, so it cannot satisfy that earlier exact-output comparison. For the later correction, use the [audio pipeline validation](audio-pipeline-validation.md) protocol: align only the former output delay, compare no-overload PCM within the declared tolerance, and retain overload differences separately. The module's `tools/compare_output_pcm.py` checks the corresponding matched Android/Apple capture sets; host comparisons do not establish physical output latency."
+          "original_markdown": "Public API 1.1.0 uses one renderer, at most 32 voices and capacity for 1-4 sequences. `bus` categories and per-voice sends share one effects chain. 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](../docs/validation/physical-validation.json) and [the performance summary](stats-performance.md). Host timing, bypass comparisons, memory accounting, actual Android/iOS builds and the remaining device/listening checks are separate evidence. The cited Studio and unified-transport benchmarks are historical observations. In the pre-variation layout, effects buffers at 192 kHz used approximately 13.1 MiB and four maximum-size triple-bank transports used 8,627,712 bytes (8.23 MiB), excluding renderer voices and queues. Version 1.1.0 grows those four transports to 9,537,152 bytes (9.10 MiB) on the measured 64-bit macOS layout, an increase of 909,440 bytes; see [variation storage measurements](native-variation-validation.md#storage-and-callback-work). These structure sizes are not a new whole-process or physical-device measurement. Total accounting must also include renderer voices/tails, command queues, effects, bridge/canonical options and recovery peaks. The 32 MiB additional-memory target remains a target, not a certified bound for version 1.1.0.",
+          "mirrored_markdown": "Public API 1.1.0 uses one renderer, at most 32 voices and capacity for 1-4 sequences. `bus` categories and per-voice sends share one effects chain. 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). Host timing, bypass comparisons, memory accounting, actual Android/iOS builds and the remaining device/listening checks are separate evidence. The cited Studio and unified-transport benchmarks are historical observations. In the pre-variation layout, effects buffers at 192 kHz used approximately 13.1 MiB and four maximum-size triple-bank transports used 8,627,712 bytes (8.23 MiB), excluding renderer voices and queues. Version 1.1.0 grows those four transports to 9,537,152 bytes (9.10 MiB) on the measured 64-bit macOS layout, an increase of 909,440 bytes; see [variation storage measurements](native-variation-validation.md#storage-and-callback-work). These structure sizes are not a new whole-process or physical-device measurement. Total accounting must also include renderer voices/tails, command queues, effects, bridge/canonical options and recovery peaks. The 32 MiB additional-memory target remains a target, not a certified bound for version 1.1.0."
         }
       ]
     },
     {
       "source": "documentation/examples.md",
       "destination": "references/examples.md",
-      "source_sha256": "48104b9d413050d439ee605c92a2456a50b42c4c80e2d7c2c05706eecc7db215",
-      "mirrored_sha256": "cda3b082a746230ed7f48b5a9ccef62c24f2b9a5ecf2fe848ac97000dad3eb6f",
+      "source_sha256": "1b3be798d8f606381696d9e00cda330c11475402397e4760dcbc3041a39ef404",
+      "mirrored_sha256": "51d74ad017afe090cb0ef0596251026554fcdca5d75c7e844d4e18ece5c68d2e",
       "links": [],
       "link_fixes": [
+        {
+          "original_markdown": "Every snippet on this page uses the TiSynthEngine 1.1.0 contract. Unless a snippet includes startup code, it assumes the engine is already running.",
+          "mirrored_markdown": "Every snippet on this page uses the TiSynthEngine 1.1.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": "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."
@@ -87,20 +54,12 @@
           "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": "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 the statistics methods `getStats`, `enableStats`, `disableStats` and `resetStats`. 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 the statistics methods `getStats`, `enableStats`, `disableStats` and `resetStats`. For a service-level statistics recipe, see [read engine statistics](guide.md#read-engine-statistics)."
         },
         {
-          "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 })`."
+          "original_markdown": "\n\n## Sustained game motor\n",
+          "mirrored_markdown": "\n\nContinue with [advanced examples](advanced-examples.md).\n## Sustained game motor\n"
         }
       ],
       "source_parts": [
@@ -111,8 +70,8 @@
     {
       "source": "documentation/examples.md",
       "destination": "references/advanced-examples.md",
-      "source_sha256": "48104b9d413050d439ee605c92a2456a50b42c4c80e2d7c2c05706eecc7db215",
-      "mirrored_sha256": "f515e00d2dfa7cb984158f03f435b5b370cdcddf6f32305172e9a38843c300c2",
+      "source_sha256": "1b3be798d8f606381696d9e00cda330c11475402397e4760dcbc3041a39ef404",
+      "mirrored_sha256": "e41a547bfb6d23b8e3460092e64eb8292587e8d15863ba1abe30daf7bbc8f163",
       "links": [],
       "link_fixes": [],
       "source_parts": [
@@ -123,8 +82,8 @@
     {
       "source": "documentation/guide.md",
       "destination": "references/guide.md",
-      "source_sha256": "6241f84ba84e20c0516bf01bc0850f9625d2b41f0bef39289c056e687b21ee37",
-      "mirrored_sha256": "be2c4e48d4be645fc716fcb610aead2c2849f04fdaa6763ac073266673309aa6",
+      "source_sha256": "0edc2fb8bccb4412d80e00d63a5a631b455d0ede6178c16642e63e37ce3dd77e",
+      "mirrored_sha256": "ccc8e263b9c7a09811bb116aad758bd6e847b2f6a567c35129bd86466e5b7aa2",
       "links": [],
       "link_fixes": [
         {
@@ -144,24 +103,16 @@
           "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": "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": "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."
+          "original_markdown": "The diagnostics include `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 diagnostics include `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."
         }
       ]
     },
     {
       "source": "documentation/recommendations.md",
       "destination": "references/recommendations.md",
-      "source_sha256": "de212dae8b2b362c241cc2b63c7e11cad9db1ff758fd52ffba4fd26ac66bf794",
-      "mirrored_sha256": "58d9dd491ac63ad60fb48551fa7c558682fd4f5cd4403cf03d72c4ef7ebf794c",
+      "source_sha256": "f72c3df9c36df0cbdb843bbe2c6799ae537324ece499fe6d1a2de80e43df5261",
+      "mirrored_sha256": "56f6783408dee02778b5ff1aa20751254740286c3dbafb46654def0ed5182f94",
       "links": [],
       "link_fixes": [
         {
@@ -169,25 +120,25 @@
           "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": "Measure the complete workload on each target device, including held voices, binaural, LFOs, all enabled effects and tails. The [historical statistics benchmark](stats-performance.md) predates these features; the [current technical report](../docs/validation/studio-validation.json) includes an unmet full-chain host deadline criterion. Neither is a guarantee of game-frame rate, physical audio deadlines, heat or battery life.\n",
+          "mirrored_markdown": "Measure the complete workload on each target device, including held voices, binaural, LFOs, all enabled effects and tails. The [historical statistics benchmark](stats-performance.md) predates these features; the [current technical report](studio-validation.json) includes an unmet full-chain host deadline criterion. Neither is a guarantee of game-frame rate, physical audio deadlines, heat or battery life.\n"
         }
       ]
     },
     {
       "source": "documentation/sound-design.md",
       "destination": "references/sound-design.md",
-      "source_sha256": "d7dbf023a72b2baaf726c20f6e240795f25095e63124264d8a13d9202b42e1d0",
-      "mirrored_sha256": "96514d9bbbbb3e3cf9d8940edab961c6c6a0268979dc16204528fde28d7db9dd",
+      "source_sha256": "ac3f4552065051bc5291d8838945ed256ad3b0da7857e1f1cb5f54f5962ebfae",
+      "mirrored_sha256": "7daf9a50dbac8eabcdb5c69079d78c0747aefa7602f24c1c66c1536faa6edbdc",
       "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": "# Sound design with TiSynthEngine",
+          "mirrored_markdown": "# Sound design with TiSynthEngine\n\nAdditional [curated recipes](recipes.md) provide application sound and interaction variants."
+        },
+        {
+          "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 `updateNote` 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 `updateNote` 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.",
@@ -196,18 +147,14 @@
         {
           "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": "e2156e5dea77bda95d9f9305bf2c8c359d54d5832f56062cf2d2ebe6c2b583b9",
-      "mirrored_sha256": "183a99e6b37427bd7c85e234706daf38c9feacfe4e796a6aba0ffbf9b54d9144",
+      "source_sha256": "37fd3173ccfce393ab354713df66fbcc99c7281131ea45de1b3aae1e2d6f2160",
+      "mirrored_sha256": "e38bec8838cfda912fd16610d92c13e9395e65d5794ac02a58bff39a7b79c5aa",
       "links": [],
       "link_fixes": [
         {
@@ -217,43 +164,52 @@
         {
           "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)."
+        }
+      ]
+    },
+    {
+      "source": "documentation/stats-performance.md",
+      "destination": "references/stats-performance.md",
+      "source_sha256": "085142b6ade7b4f7b5965f6a638f967fdceba5ab1f26fb85e8cb496d5b886b6a",
+      "mirrored_sha256": "037c3b8a99c5eea1cc133e4b0418268617d904d6fd5848da0a95a0d52f442340",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "[Unified validation evidence](../docs/validation/unified-validation.json) records native binary hashes, contract and regression results, the five-rate ten-minute simulated transport clock test, consumer checks and remaining acceptance work. Nine reference renders and thirty rate/wave cases match the archived renderer sample for sample with the new functions inactive. The effects history optimization also preserves its five-rate render hashes.",
+          "mirrored_markdown": "[Unified validation evidence](unified-validation.json) records native binary hashes, contract and regression results, the five-rate ten-minute simulated transport clock test, consumer checks and remaining acceptance work. Nine reference renders and thirty rate/wave cases match the archived renderer sample for sample with the new functions inactive. The effects history optimization also preserves its five-rate render hashes."
+        },
+        {
+          "original_markdown": "[Unified bypass measurements](../docs/validation/unified-bypass-performance.json) retain the complete matched trials against `937e774`, with four sequence slots preallocated in the current engine. Initial stereo regressions prompted changes to inactive voice scans, send ramps, constant controls and compiler inlining. These are measurements of the Android callback on macOS, not iOS callback or physical output results.",
+          "mirrored_markdown": "[Unified bypass measurements](unified-bypass-performance.json) retain the complete matched trials against `937e774`, with four sequence slots preallocated in the current engine. Initial stereo regressions prompted changes to inactive voice scans, send ramps, constant controls and compiler inlining. These are measurements of the Android callback on macOS, not iOS callback or physical output results."
         },
         {
-          "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": "A later source-frozen recheck includes the physical-phase constant-control and exact Android FIR optimizations. Three configurations remain within the screening limits. One-voice stereo still exceeds the total-time screen after the same warmed ten-pair protocol (+3.49% total, +1.73% p95). A focused layout comparison restored the previous voice offsets but improved total time by less than 0.5%, so that candidate was rejected. This latest-source host screen remains open. The [complete recheck and layout trials](../docs/validation/bypass-physical-recheck-evidence.zip) and summary in the JSON report preserve this result separately from the earlier source.",
+          "mirrored_markdown": "A later source-frozen recheck includes the physical-phase constant-control and exact Android FIR optimizations. Three configurations remain within the screening limits. One-voice stereo still exceeds the total-time screen after the same warmed ten-pair protocol (+3.49% total, +1.73% p95). A focused layout comparison restored the previous voice offsets but improved total time by less than 0.5%, so that candidate was rejected. This latest-source host screen remains open. The [complete recheck and layout trials](bypass-physical-recheck-evidence.zip) and summary in the JSON report preserve this result separately from the earlier source."
         },
         {
-          "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": "[Physical validation evidence](../docs/validation/physical-validation.json) records the device protocol, measurements and remaining acceptance work. The isolated diagnostic uses separate app identifiers and preserves the applications' saved data. Its callback histogram and memory queries exist only in temporary instrumented module copies; they are excluded from production packages. Reproduction tools are in `tools/device-validation/`.",
+          "mirrored_markdown": "[Physical validation evidence](physical-validation.json) records the device protocol, measurements and remaining acceptance work. The isolated diagnostic uses separate app identifiers and preserves the applications' saved data. Its callback histogram and memory queries exist only in temporary instrumented module copies; they are excluded from production packages. Reproduction tools are in `tools/device-validation/`."
         },
         {
-          "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": "[Frontier physical measurements](../docs/validation/frontier-physical-validation.json) cover Arcade and simulations starting with 20 or 80 large asteroids on both devices. The [iPad raw reports](../docs/validation/frontier-ipad-evidence.zip) retain actual Metal presentation timestamps; the [Android raw reports](../docs/validation/frontier-android-evidence.zip) retain SurfaceFlinger presentations aligned with native realtime/monotonic clocks. Arcade and simulation20 satisfy the predefined equivalent-load coverage and presentation/FPS limits. Strict simulation80 matching reaches 47.5% coverage on iPad and 45% on Android against the required 50%, so those comparisons remain inconclusive. Exploratory matching remains separate from the primary result; no causal audio-driven FPS improvement is claimed.",
+          "mirrored_markdown": "[Frontier physical measurements](frontier-physical-validation.json) cover Arcade and simulations starting with 20 or 80 large asteroids on both devices. The [iPad raw reports](frontier-ipad-evidence.zip) retain actual Metal presentation timestamps; the [Android raw reports](frontier-android-evidence.zip) retain SurfaceFlinger presentations aligned with native realtime/monotonic clocks. Arcade and simulation20 satisfy the predefined equivalent-load coverage and presentation/FPS limits. Strict simulation80 matching reaches 47.5% coverage on iPad and 45% on Android against the required 50%, so those comparisons remain inconclusive. Exploratory matching remains separate from the primary result; no causal audio-driven FPS improvement is claimed."
         },
         {
-          "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": "The [Android Sim80 correction](../docs/validation/android-sim80-correction.json) reuses FIR coefficients across eight consecutive samples of a voice while preserving partial-sum rounding, sequence boundaries, mix order, ramps and tails. Stereo output and other Android ABIs retain their previous render path. In the short headphone diagnostic at 48 kHz/256 frames, with the same 512-frame output buffer and volume120/160, the corrected candidate reached 32 voices/25 tails and reported zero output xruns. CPU p95 occupied [96.5%,97.0%) of the deadline; 80 CPU-timed and 104 wall-timed callbacks still exceeded one block deadline. Output buffering absorbed those overruns in this run. Cesar then accepted live manual Sim80 with headphones as clean, without perceptible distortion. This is acceptance of that short scene, not the ten-minute maximum-load render criterion. The [raw correction reports](../docs/validation/android-sim80-correction-evidence.zip) retain the original, intermediate and corrected captures separately. Private PCM/profiling interfaces remain excluded from production packages. Full multiplatform acceptance remains open.",
+          "mirrored_markdown": "The [Android Sim80 correction](android-sim80-correction.json) reuses FIR coefficients across eight consecutive samples of a voice while preserving partial-sum rounding, sequence boundaries, mix order, ramps and tails. Stereo output and other Android ABIs retain their previous render path. In the short headphone diagnostic at 48 kHz/256 frames, with the same 512-frame output buffer and volume120/160, the corrected candidate reached 32 voices/25 tails and reported zero output xruns. CPU p95 occupied [96.5%,97.0%) of the deadline; 80 CPU-timed and 104 wall-timed callbacks still exceeded one block deadline. Output buffering absorbed those overruns in this run. Cesar then accepted live manual Sim80 with headphones as clean, without perceptible distortion. This is acceptance of that short scene, not the ten-minute maximum-load render criterion. The [raw correction reports](android-sim80-correction-evidence.zip) retain the original, intermediate and corrected captures separately. Private PCM/profiling interfaces remain excluded from production packages. Full multiplatform acceptance remains open."
         },
         {
-          "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."
+          "original_markdown": "This is a historical statistics-only comparison, before sustained voices, native sequence transport, master effects and the two additional voice LFOs. It is not a performance measurement of those features. See [current technical validation](../docs/validation/studio-validation.json) for newer evidence and its device/deadline limits.",
+          "mirrored_markdown": "This is a historical statistics-only comparison, before sustained voices, native sequence transport, master effects and the two additional voice LFOs. It is not a performance measurement of those features. See [current technical validation](studio-validation.json) for newer evidence and its device/deadline limits."
         },
         {
-          "original_markdown": "Confirm both entries in `tiapp.xml` pin 1.0.0. Then remove the application's build output and rebuild so Titanium does not reuse an archive from an earlier build. The module directories should be:\n\n```text\nmodules/android/ti.synthengine/1.0.0/\nmodules/iphone/ti.synthengine/1.0.0/\n```",
-          "mirrored_markdown": "`apiVersion` describes the unchanged 1.0.0 API contract; it is not the module package version. Confirm both entries in `tiapp.xml` pin module version 1.0.2. Then remove the application's build output and rebuild so Titanium does not reuse an archive from an earlier build. The module directories should be:\n\n```text\nmodules/android/ti.synthengine/1.0.2/\nmodules/iphone/ti.synthengine/1.0.2/\n```"
+          "original_markdown": "[Raw trials and investigation](../docs/validation/stats-performance.json). Reproduce with `tests/stats_benchmark_host.cpp` and `tools/benchmark_stats.py`; see [engine test instructions](audio-engine.md#engine-statistics).\n",
+          "mirrored_markdown": "[Raw trials and investigation](stats-performance.json). Reproduce with `tests/stats_benchmark_host.cpp` and `tools/benchmark_stats.py`; see [engine test instructions](audio-engine.md#engine-statistics).\n"
         }
       ]
     },
     {
-      "source": "documentation/stats-performance.md",
-      "destination": "references/stats-performance.md",
-      "source_sha256": "3d6d35b9e0e49a778777d406418eaba04ebd57da871a322da28fae0190c5cb17",
-      "mirrored_sha256": "4dbd8a85cbce7c08369c4c9b5d4d2c0cf6a8e0dd0fa508b9c6aaf95774f7be12",
-      "links": [],
-      "link_fixes": []
-    },
-    {
-      "source": "documentation/stats-performance.json",
+      "source": "docs/validation/stats-performance.json",
       "destination": "references/stats-performance.json",
       "source_sha256": "bd0cf07295d0d8f1120e66f527e9ca6d9a014efdc43dff5675716e8e26abe5b3",
       "mirrored_sha256": "bd0cf07295d0d8f1120e66f527e9ca6d9a014efdc43dff5675716e8e26abe5b3",
@@ -261,7 +217,7 @@
       "link_fixes": []
     },
     {
-      "source": "documentation/studio-validation.json",
+      "source": "docs/validation/studio-validation.json",
       "destination": "references/studio-validation.json",
       "source_sha256": "b6abcf9229b8bb812cb4da467e3c495ab66c41041fb7562ca3c371d79671509b",
       "mirrored_sha256": "b6abcf9229b8bb812cb4da467e3c495ab66c41041fb7562ca3c371d79671509b",
@@ -269,7 +225,7 @@
       "link_fixes": []
     },
     {
-      "source": "documentation/unified-bypass-performance.json",
+      "source": "docs/validation/unified-bypass-performance.json",
       "destination": "references/unified-bypass-performance.json",
       "source_sha256": "12622f00804bd866be90ac40579b868e8f6fcbd35635bf8000febb21adef2563",
       "mirrored_sha256": "12622f00804bd866be90ac40579b868e8f6fcbd35635bf8000febb21adef2563",
@@ -277,7 +233,7 @@
       "link_fixes": []
     },
     {
-      "source": "documentation/unified-validation.json",
+      "source": "docs/validation/unified-validation.json",
       "destination": "references/unified-validation.json",
       "source_sha256": "4754da69159f4ab35544d0f0a8ef6e5568dda9e74162b1c2dad2bb807d905fd8",
       "mirrored_sha256": "4754da69159f4ab35544d0f0a8ef6e5568dda9e74162b1c2dad2bb807d905fd8",
@@ -285,7 +241,7 @@
       "link_fixes": []
     },
     {
-      "source": "documentation/physical-validation.json",
+      "source": "docs/validation/physical-validation.json",
       "destination": "references/physical-validation.json",
       "links": [],
       "link_fixes": [],
@@ -293,7 +249,7 @@
       "mirrored_sha256": "73233c11a1d2aa06654a06486ef52a08d961473d83b0c5b2a44e19a6eac28c0b"
     },
     {
-      "source": "documentation/frontier-physical-validation.json",
+      "source": "docs/validation/frontier-physical-validation.json",
       "destination": "references/frontier-physical-validation.json",
       "links": [],
       "link_fixes": [],
@@ -307,12 +263,12 @@
       "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.2 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.2 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": "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 requires module version 1.1.0 and public API 1.1.0 for native finite-tone repetition, attack variation and the recommended note/statistics methods. 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 requires module version 1.1.0 and public API 1.1.0 for native finite-tone repetition, attack variation and the recommended note/statistics methods. 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": "4. Copy the entire `example/` folder into the test app's `Resources/`, including [app.js](app.js), [sequenceScore.js](lib/sequenceScore.js) and [sequenceOwner.js](lib/sequenceOwner.js). It needs no images or audio files.\n5. 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": "4. Copy the entire `example/` folder into the test app's `Resources/`, including [app.js](app.js), [sequenceScore.js](lib/sequenceScore.js) and [sequenceOwner.js](lib/sequenceOwner.js). It needs no images or audio files.\n5. 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.",
@@ -325,10 +281,18 @@
         {
           "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": "The ATTACK VARIATION button submits the same metal-strike recipe on each press. With `capabilities.variation === true` and `variationSchemaVersion === 1`, the renderer chooses pitch, FM depth and level once per admitted attack. Older packages receive the original recipe without the dictionary. This button uses independent timed events; the [variation guide](../documentation/native-variation.md) separately demonstrates sustained ownership and native sequence retriggers. Physical listening acceptance remains separate from host correctness checks.",
+          "mirrored_markdown": "The ATTACK VARIATION button submits the same metal-strike recipe on each press. With `capabilities.variation === true` and `variationSchemaVersion === 1`, the renderer chooses pitch, FM depth and level once per admitted attack. Older packages receive the original recipe without the dictionary. This button uses independent timed events; the [variation guide](../../references/native-variation.md) separately demonstrates sustained ownership and native sequence retriggers. Physical listening acceptance remains separate from host correctness checks."
+        },
+        {
+          "original_markdown": "`playTone` remains a standalone Boolean operation and rejects `intervalMs`; `repeatTone` always returns a numeric ID or 0 and requires the interval. Independent JavaScript calls remain supported, including finite bursts scheduled by an application's own event clock. See [the full contract and standalone burst example](../documentation/api.md#finite-tone-repetition).\n",
+          "mirrored_markdown": "`playTone` remains a standalone Boolean operation and rejects `intervalMs`; `repeatTone` always returns a numeric ID or 0 and requires the interval. Independent JavaScript calls remain supported, including finite bursts scheduled by an application's own event clock. See [the full contract and standalone burst example](../../references/api.md#finite-tone-repetition).\n"
         }
       ],
-      "source_sha256": "80f2a69a634453e974281cbdac17e97fbc713a228e79379e8cea592c366bb9be",
-      "mirrored_sha256": "f036b0ca42b118a9c807324464b1dceda76eb94cab60450f7d3b3822e7f8cfdc"
+      "source_sha256": "e191a701a3a913c85b15503fd256e0aec085eb731a587b1bf4faa43865c81982",
+      "mirrored_sha256": "88d93d5ffbf8bb4c7bdb6d72f4ee5fe96332704987127ff66d99beeed9677d9a"
     },
     {
       "source": "example/app.js",
@@ -336,8 +300,8 @@
       "kind": "example-asset",
       "links": [],
       "link_fixes": [],
-      "source_sha256": "1d121412dd2146d75d6b8c1665a28411b9e9c13e626f00284c88f3ba555f3b7e",
-      "mirrored_sha256": "1d121412dd2146d75d6b8c1665a28411b9e9c13e626f00284c88f3ba555f3b7e"
+      "source_sha256": "f8e2ed90f072f516bb4ca796fb6dd8443600585526455e416fface49535ccb40",
+      "mirrored_sha256": "f8e2ed90f072f516bb4ca796fb6dd8443600585526455e416fface49535ccb40"
     },
     {
       "source": "example/lib/sequenceScore.js",
@@ -358,7 +322,7 @@
       "mirrored_sha256": "2c7a639aa9e7347872240556734165a749e4abb44f19cb14546d9ae822e1c5b3"
     },
     {
-      "source": "documentation/bypass-physical-recheck-evidence.zip",
+      "source": "docs/validation/bypass-physical-recheck-evidence.zip",
       "destination": "references/bypass-physical-recheck-evidence.zip",
       "kind": "evidence-archive",
       "links": [],
@@ -367,7 +331,7 @@
       "mirrored_sha256": "910eb9eafebd7d46797192053ec7f4f9f3fc88c6bfd1b83b07acefd1e51603a2"
     },
     {
-      "source": "documentation/frontier-android-evidence.zip",
+      "source": "docs/validation/frontier-android-evidence.zip",
       "destination": "references/frontier-android-evidence.zip",
       "kind": "evidence-archive",
       "links": [],
@@ -376,7 +340,7 @@
       "mirrored_sha256": "217a06978982d601ad10796865b22dbac69f202e4bf91ae07ba268734d4fef08"
     },
     {
-      "source": "documentation/frontier-ipad-evidence.zip",
+      "source": "docs/validation/frontier-ipad-evidence.zip",
       "destination": "references/frontier-ipad-evidence.zip",
       "kind": "evidence-archive",
       "links": [],
@@ -385,7 +349,7 @@
       "mirrored_sha256": "56369b202d279efbf4f9a720a0a99dba2f398410cb8e042ef1200a3a63be245b"
     },
     {
-      "source": "documentation/android-sim80-correction.json",
+      "source": "docs/validation/android-sim80-correction.json",
       "destination": "references/android-sim80-correction.json",
       "links": [],
       "link_fixes": [],
@@ -393,7 +357,7 @@
       "mirrored_sha256": "675c2201b9e0bfad7c8bf6255f8a9440eb45ef0a915c24eee9e47db12745a1c0"
     },
     {
-      "source": "documentation/android-sim80-correction-evidence.zip",
+      "source": "docs/validation/android-sim80-correction-evidence.zip",
       "destination": "references/android-sim80-correction-evidence.zip",
       "links": [],
       "link_fixes": [],
@@ -402,7 +366,7 @@
       "kind": "evidence-archive"
     },
     {
-      "source": "documentation/performance-review.json",
+      "source": "docs/validation/performance-review.json",
       "destination": "references/performance-review.json",
       "links": [],
       "link_fixes": [],
@@ -410,7 +374,7 @@
       "mirrored_sha256": "e822b3361bb5cdb31e635863d84b179ef41edfe6a1214ae99ca3a9d327d21d3a"
     },
     {
-      "source": "documentation/performance-review-evidence.zip",
+      "source": "docs/validation/performance-review-evidence.zip",
       "destination": "references/performance-review-evidence.zip",
       "links": [],
       "link_fixes": [],
@@ -422,15 +386,69 @@
       "source": "documentation/audio-pipeline-validation.md",
       "destination": "references/audio-pipeline-validation.md",
       "source_sha256": "7359d85de63e9fe94f85477e03a22fc1531c8acaabe30333e7ff2515cc5ec3e9",
-      "mirrored_sha256": "f2a90a8423a3761664ca2957f3ce3ccb2792e1b090c2b7a011709689b12a588d",
+      "mirrored_sha256": "71f668b1467fa8afc92cddd627f688247ef6f48f2bf8a0ebdc2a2b05427e3521",
       "links": [],
       "link_fixes": []
+    },
+    {
+      "source": "documentation/instruments-and-effects.md",
+      "destination": "references/instruments-and-effects.md",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "6c9b96c406c54426a1d37a85b42909a50621cc647d08d37fa89c19283b3acfa0",
+      "mirrored_sha256": "ced9d66af8528bf8a88463f953ff3892ef4234be5551cade9a210a91fd53e746"
+    },
+    {
+      "source": "documentation/native-variation.md",
+      "destination": "references/native-variation.md",
+      "links": [],
+      "link_fixes": [
+        {
+          "original_markdown": "Both renderers use [`shared/synth_variation.h`](../shared/synth_variation.h): stable schema slots, integer-defined SplitMix64 finalization and exact uint32-to-uniform conversion. Parsing prepares a fixed 144-byte configuration outside the audio callback. The callback performs bounded arithmetic without allocation, locks, JavaScript calls or entropy services.",
+          "mirrored_markdown": "Both renderers use [`shared/synth_variation.h`](https://github.com/macCesar/TiSynthEngine/blob/7cd035409453b01df2736aef56f2316d94ca019c/shared/synth_variation.h): stable schema slots, integer-defined SplitMix64 finalization and exact uint32-to-uniform conversion. Parsing prepares a fixed 144-byte configuration outside the audio callback. The callback performs bounded arithmetic without allocation, locks, JavaScript calls or entropy services."
+        }
+      ],
+      "source_sha256": "650d2c675dc4b4e09a85521812b7fedd3b02cb993a451378a8082e2b7782303a",
+      "mirrored_sha256": "a34c4100b5f28888252855ce0e68494097cbca4df76ee9298cfcd05efa14e839"
+    },
+    {
+      "source": "documentation/native-variation-proposal.md",
+      "destination": "references/native-variation-proposal.md",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "17b74434b0e03e5353b71c693d4ec722dede92fee8aed142003e67f60e158e27",
+      "mirrored_sha256": "bcb2ab5cdc13d0c5c47a9b8d81a1c1eaae3af5a1c85a3f8cf85ca3ae2b300b1d"
+    },
+    {
+      "source": "documentation/native-variation-validation.md",
+      "destination": "references/native-variation-validation.md",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "df18826824984cb440d7412b547663ba6b8a7152bc347508114d7af982c90e68",
+      "mirrored_sha256": "bab57291d98d537a42adf4992121dce1887bcb1b4affecf94c4174168a5629dc"
+    },
+    {
+      "source": "documentation/native-tone-repetition-validation.md",
+      "destination": "references/native-tone-repetition-validation.md",
+      "links": [],
+      "link_fixes": [],
+      "source_sha256": "b29758b5ec3b50650c4e30e8c408cb9bc680cad3fc158e543c3f6eec00c268a1",
+      "mirrored_sha256": "186b3baaff1c7bbbf8977f0ad5e00b632f63155ea29c2903554c8ac1738259dd"
+    },
+    {
+      "source": "index.d.ts",
+      "destination": "assets/index.d.ts",
+      "links": [],
+      "link_fixes": [],
+      "kind": "declaration-asset",
+      "source_sha256": "0b1dd381258bd4891090c2e2b56bbeb66f0be66daa1c9fbab6145a9dc09a0620",
+      "mirrored_sha256": "0b1dd381258bd4891090c2e2b56bbeb66f0be66daa1c9fbab6145a9dc09a0620"
     }
   ],
   "excluded_documents": [
     {
       "source": "documentation/index.md",
-      "source_sha256": "9c9cab76618b15e77b8de43dd7bd33cd35be0fe50ad4fb28d5e1a71fe0708fa2",
+      "source_sha256": "23b00db329fb53cd445e71a2e746ab8dbfdfe8d5c827c60929ff06af3b3757c3",
       "reason": "Upstream documentation index; SKILL.md is the distributed navigation entry point."
     },
     {
@@ -439,10 +457,10 @@
       "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": "working-tree",
-  "reviewed_worktree_sha256": "0226827bb8c35cf62435f0d7b64d2a3f02427417c9084f2bddfdadb0a90b68d3",
-  "api_version": "1.0.0",
-  "public_packages": [
+  "source_state": "committed",
+  "api_version": "1.1.0",
+  "published_version": "1.1.0",
+  "historical_public_packages": [
     {
       "platform": "android",
       "version": "1.0.2",
@@ -494,5 +512,31 @@
         "ios/README.html": "b3ed190cbb3ca9022943f2f71d5e927fde7f8d8a75c2a23ab3aa51324a07a5dc"
       }
     }
+  ],
+  "public_packages": [
+    {
+      "platform": "android",
+      "version": "1.1.0",
+      "release_url": "https://github.com/macCesar/TiSynthEngine/releases/tag/android-1.1.0",
+      "download_url": "https://github.com/macCesar/TiSynthEngine/releases/download/android-1.1.0/ti.synthengine-android-1.1.0.zip",
+      "filename": "ti.synthengine-android-1.1.0.zip",
+      "sha256": "69dea7daaa8b5dd77f7a3d4d6e6ad801e2a0bd48f9e2c79b9caf584dd56e36eb",
+      "downloaded_on_utc": "2026-11-02",
+      "crc_verified": true,
+      "release_target_commit": "7cd035409453b01df2736aef56f2316d94ca019c",
+      "types_match_source": true
+    },
+    {
+      "platform": "iphone",
+      "version": "1.1.0",
+      "release_url": "https://github.com/macCesar/TiSynthEngine/releases/tag/ios-1.1.0",
+      "download_url": "https://github.com/macCesar/TiSynthEngine/releases/download/ios-1.1.0/ti.synthengine-iphone-1.1.0.zip",
+      "filename": "ti.synthengine-iphone-1.1.0.zip",
+      "sha256": "c426fed49d78926f8dd4e176addaebf0cb0fe4592c5eb48c842aef833ad798b4",
+      "downloaded_on_utc": "2026-11-02",
+      "crc_verified": true,
+      "release_target_commit": "7cd035409453b01df2736aef56f2316d94ca019c",
+      "types_match_source": true
+    }
   ]
 }