@maccesar/titools 5.2.5 → 5.4.0

package/CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to TiTools
 
-TiTools distributes thirteen Titanium SDK skills, a research agent and slash
+TiTools distributes fourteen Titanium SDK skills, a research agent and slash
 commands through an npm CLI and a Claude Code marketplace plugin. Product
 content lives in `skills/`, `agents/` and `commands/`; CLI source lives in
 `bin/` and `lib/`. Both channels use this source tree.

package/README.md

@@ -6,7 +6,7 @@
 
 </div>
 
-TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 13 skills — 8 specialist skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering reuse and simplification, Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling and resource automation, UI/UX patterns, 2D games, and native sound synthesis.
+TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 14 skills — 9 specialist skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`, `ti-create-release`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering reuse and simplification, Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling and resource automation, UI/UX patterns, 2D games, and native sound synthesis.
 
 The reference files are maintained against official documentation whenever an official source exists, so the assistant can retrieve current framework behavior instead of guessing from generic training data. As of v5.0.0 those sources are the Titanium SDK's own API definitions and the rewritten guides at [titaniumsdk.com](https://titaniumsdk.com). [Where the references come from](#where-the-references-come-from) has the detail.
 
@@ -36,7 +36,7 @@ The fastest way to get started with Claude Code. One command to add the marketpl
 ```
 
 What you get:
-- All 13 TiTools skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`, `ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`)
+- All 14 TiTools skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`, `ti-create-release`, `ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`)
 - ti-pro research agent
 - Session hook that auto-detects Titanium projects (`tiapp.xml`, Alloy, PurgeTSS, `ti.game`, `ti.synthengine`)
 - Slash commands: `/ti-check`, `/ti-new-screen`, `/ti-audit`
@@ -70,7 +70,7 @@ claude   # or gemini, or codex
 ```
 
 What gets installed:
-- The 13 TiTools skills to `~/.agents/skills/`
+- The 14 TiTools skills to `~/.agents/skills/`
 - ti-pro agent for Claude Code
 - Platform symlinks for Claude Code (Gemini CLI and Codex CLI auto-discover from `~/.agents/skills/` — no symlinks needed)
 - Knowledge index in your project's `AGENTS.md`/`CLAUDE.md`/`GEMINI.md`
@@ -172,19 +172,20 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | ti-ui            | UI/UX patterns                      | Complex layouts, ListViews, platform UI                                                                                                                                                                                                                                                              |
 | ti-game          | 2D games with the `ti.game` module  | Sprites, physics, tile maps, HUDs, camera, focused keyboard/mouse/gamepad actions, Apple Metal/Catalyst                                                                                                                                                                                              |
 | ti-game-assets   | Visual and sound assets             | Image generation/editing, synthesis variants, stereo placement, alpha cleanup, manifests, parallax and complete exports                                                                                                                                                                              |
-| ti-synthengine   | Sound design with `ti.synthengine`  | Tones, finite-tone repetition, chords, retro/UI effects, alarms, sweeps, ADSR, filters, FM, binaural positioning, held voices, native sequences, master effects, LFOs, statistics, bounded attack variation, seeds, TypeScript declarations, instrument/effect fidelity and troubleshooting |
+| ti-synthengine   | Sound design with `ti.synthengine`  | TiSynth 2.0 reusable Sound presets, independent playback controls, tones/chords, held notes, native repetitions/patterns, ADSR, FM, filters, binaural positioning, shared effects, variation, TypeScript and troubleshooting |
 | ti-admob-unified | Advertising, privacy and mediation  | Official `ti.admob.unified` guides, copy-ready library, banners/fullscreen, UMP/ATT and selected-provider configuration                                                                                                                                                                              |
-| ti-api           | Complete Titanium API reference     | Looking up properties, methods, events                                                                                                                                                                                                                                                               |
+| ti-create-release | Native module releases | Build and verify ZIPs, follow repository release conventions, publish authorized GitHub releases and configure directory discovery |
+| ti-api           | Titanium API lookup     | Looking up properties, methods, events                                                                                                                                                                                                                                                               |
 | ti-guides        | SDK fundamentals                    | tiapp.xml, Hyperloop, distribution, JDK/Xcode compatibility, release notes                                                                                                                                                                                                                           |
 | ti-howtos        | Native feature integration          | Location, push, media, platform APIs                                                                                                                                                                                                                                                                 |
 | alloy-guides     | Alloy MVC framework reference       | Controllers, models, views, widgets                                                                                                                                                                                                                                                                  |
-| alloy-howtos     | Alloy CLI, configuration, debugging | alloy.jmk, config.json, custom XML tags                                                                                                                                                                                                                                                              |
+| alloy-howtos     | Alloy CLI, configuration, debugging | alloy.jmk, config.json, build constants and debugging                                                                                                                                                                                                                                                              |
 
 Notes:
-- The first eight (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`) are specialist workflow skills reflecting TiTools' Titanium conventions and native-module contracts.
+- The first nine (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`, `ti-create-release`) are specialist workflow skills reflecting TiTools' Titanium conventions and native-module contracts.
 - `ti-reuse-first` runs before the others. It asks whether a thing needs to exist and what already does it — a search order that stops at the first rung that holds — and sweeps an existing `app/` for near-identical controllers, single-listener events, wrappers around one call, and layout recomputed in JavaScript. It is deliberately two-sided: it says when adding a module or a Widget is the right answer, so the bias does not simply invert.
 - `ti-game` documents the `ti.game` native module (2D sprite engine using OpenGL ES 2.0 on Android and Metal on iPhone, iPad and Mac Catalyst). Its API reference was verified against the module source and records the reviewed upstream commit and fork documentation snapshot; it applies to Alloy and Classic projects alike and does not depend on PurgeTSS.
-- `ti-synthengine` translates sound requests into checked JavaScript for published Android/iOS `ti.synthengine` 1.1.0 / API 1.1.0, with compatibility guidance for 1.0.2 / API 1.0.0. Its 25-method surface includes finite-tone repetition, held voices, identified native sequences, tempo, categories/sends, master effects, live controls and diagnostics. Two curated recipe guides cover retro cues and interactive instruments. Official-source mirrors, validation reports, bundled examples, TypeScript declarations and raw evidence retain provenance; verified corrections are applied to official source prose before mirroring. Source notes distinguish reviewed source commits, published artifacts, platform differences and scoped listening/performance evidence.
+- `ti-synthengine` translates sound requests into checked JavaScript for published Android/iOS `ti.synthengine` 2.0.0. It covers reusable Sound definitions, independent held/repetition/pattern controls, atomic preset edits, temporary overrides, processing units and migration from supported direct methods. Practical references, curated recipes, runnable examples and TypeScript declarations support implementation and troubleshooting.
 - `ti-game-assets` treats images and sounds as essential game assets. It coordinates integrated `image_gen` artwork with `ti-synthengine` sound design, variants and stereo placement, and ships Pillow helpers for conservative alpha cleanup and per-world visual/audio manifests.
 - The latter five are documentation-mirror skills, audited against official sources via the internal `titools-skill-auditor`. See [Where the references come from](#where-the-references-come-from).
 - `purgetss` reference files are audited against the official PurgeTSS documentation and against the package source (the CLI and the generated `utilities.tss`), but its workflow conventions are opinionated.
@@ -193,24 +194,28 @@ Notes:
 
 ## Where the references come from
 
-The Titanium documentation was rewritten during 2026, and v5.0.0 moved TiTools onto the new sources. No skill, command or flag was renamed and the references answer the same questions. What changed is what they are checked against.
+The Titanium documentation was rewritten during 2026, and v5.0.0 moved TiTools onto the new sources. The current guide and UI skills follow what the new official site publishes. Historical recipes that have not been ported are excluded from these skills.
 
 | Source                                                                                | Feeds                                                    | Why it is the one                                                                                                      |
 | ------------------------------------------------------------------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
 | [`tidev/titanium-sdk`](https://github.com/tidev/titanium-sdk) → `apidoc/*.yml`        | `ti-api`                                                 | The API definitions the SDK team edits. Every other copy of the API is compiled from these.                            |
-| [`tidev/titaniumsdk.com`](https://github.com/tidev/titaniumsdk.com) → `content/docs/` | `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos` | The rewritten guides, and what [titaniumsdk.com](https://titaniumsdk.com) serves.                                      |
+| [`tidev/titaniumsdk.com`](https://github.com/tidev/titaniumsdk.com) → `content/docs/` | `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`, `ti-ui` | The rewritten guides, and what [titaniumsdk.com](https://titaniumsdk.com) serves.                                      |
 | `tidev/titaniumsdk.com` → `registry/sdk/<version>/`                                   | `ti-api`, as a cross-check                               | The API compiled per published release. It answers which version actually shipped an API, which the YAML alone cannot. |
-| [`tidev/titanium-docs`](https://github.com/tidev/titanium-docs)                       | all five, as an archive                                  | The previous corpus, now frozen. Kept for what the rewrite left out.                                                   |
+| [`tidev/titanium-docs`](https://github.com/tidev/titanium-docs)                       | historical provenance only                              | The previous corpus; excluded from current guide/UI content.                                                   |
 
 ### Why the API comes from the SDK
 
 The website does not write API documentation. It compiles it from `apidoc/*.yml` and commits the result, so it trails the SDK by construction. `ti-api` reads the YAML for what exists and the compiled registry for which release shipped it, and documents the newest GA rather than `main`. An API merged into the SDK today reaches these references when the release carrying it ships, because until then you cannot call it.
 
-### The archive is additive
+### Current guides and API verification
 
-`tidev/titanium-docs` is frozen and being archived upstream. TiDev's own migration audit classifies its 336 guide pages as 121 rewritten, 121 merged, 2 kept and 92 archived. Of those 92, 91 are release notes and the last is the discontinued Atom package, so no guide topic was dropped. The difference is density: 1390 KB of legacy prose became 219 KB.
+Use [llms.txt](https://titaniumsdk.com/llms.txt) to discover official routes and append `.md` to a guide URL to read its Markdown representation. The new documentation source is `tidev/titaniumsdk.com`.
 
-TiTools keeps the full corpus. The archive never overrides a live source on a question of fact, and nothing is deleted from a reference merely because the rewritten site no longer covers it. These skills still answer questions the official guides have not been rewritten to cover yet, such as the conditional `if=` attribute in Alloy XML and TSS, custom XML tags via `app/lib/`, and `alloy compile`.
+`ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos` and `ti-ui` include current official guide topics. They do not supplement missing sections with the old `titanium-docs` corpus or unpublished community recipes. Topics can return when the official site publishes them.
+
+A guide's scope does not guarantee every example is correct. References identify verified conflicts with released API/compiler contracts, including Alloy configuration precedence and hooks, notification registration and safe-area defaults. The core API baseline is SDK 13.4.1.GA, with explicit version links; unreleased SDK 14 features remain excluded. Native modules have independent versions and authorities.
+
+PurgeTSS and the native-module skills retain their own official sources and declared curated resources. Their source policies are independent of the website migration.
 
 ---
 
@@ -220,14 +225,14 @@ In addition to skills, this repository includes sub-agents for Claude Code. Sub-
 
 ### ti-pro
 
-Deep-dive research specialist that can combine the complete 13-skill TiTools catalog.
+Deep-dive research specialist that can combine the complete 14-skill TiTools catalog.
 
 | Aspect           | Details                                     |
 | ---------------- | ------------------------------------------- |
 | Location         | `~/.claude/agents/ti-pro.md`                |
 | Model            | Sonnet (comprehensive analysis)             |
 | Tools            | Read, Grep, Glob, Bash                      |
-| Preloaded Skills | All 13 skills registered in `lib/config.js` |
+| Preloaded Skills | All 14 skills registered in `lib/config.js` |
 
 When to use the agent vs skills:
 
@@ -269,7 +274,7 @@ TiTools provides slash commands for common tasks. Both channels ship them: the p
 These commands automatically invoke the relevant skills:
 - `/ti-check` reads `tiapp.xml`, validates declared native modules, and reports project health
 - `/ti-new-screen` uses `ti-expert` + `purgetss` to create properly structured files
-- `/ti-audit` routes all 13 skills: the reuse sweep first, core Titanium checks always, Alloy/PurgeTSS checks when detected, integration how-tos when used, `ti-game-assets` checks for game asset workflows, and `ti-game` / `ti-synthengine` / `ti-admob-unified` checks when those modules are declared
+- `/ti-audit` routes all 14 skills: the reuse sweep first, core Titanium checks always, Alloy/PurgeTSS checks when detected, integration how-tos when used, `ti-game-assets` checks for game asset workflows, and `ti-game` / `ti-synthengine` / `ti-admob-unified` checks when those modules are declared
 
 ---
 
@@ -331,11 +336,12 @@ Why this matters:
 | Whether to build it at all | `ti-reuse-first`, first                                                     |
 | Architecture and UI        | `ti-expert`, `ti-ui`, `purgetss` when configured                            |
 | Game assets                | `ti-game-assets` for visual and sound creation, preparation and integration |
+| Native module releases     | `ti-create-release` when preparing or publishing a module release |
 | Native modules             | `ti-game`, `ti-synthengine`, `ti-admob-unified` when declared or requested  |
 | Exact SDK/API guidance     | `ti-api`, `ti-guides`, `ti-howtos`                                          |
 | Alloy MVC and tooling      | `alloy-guides`, `alloy-howtos` for Alloy projects                           |
 
-All thirteen ship with TiTools; no second skill package is required.
+All fourteen ship with TiTools; no second skill package is required.
 
 ---
 
@@ -546,51 +552,41 @@ frequency and pause/audio/input ownership remain application policies.
 
 ### ti-synthengine
 
-Sound design and synthesis with the public native `ti.synthengine` 1.1.0 release (public API 1.1.0) for Android and iOS. It adds `repeatTone`, `updateTone`, `stopTone`, `updateNote`, `enableStats` and `disableStats`, plus capability-gated native attack variation. Published 1.0.2 / API 1.0.0 remains documented for compatibility; it does not support repetition or variation. Read the [skill entry point](skills/ti-synthengine/SKILL.md) for task routing, exact API references and source provenance.
+Sound design with public **TiSynth 2.0.0** for Android and iOS. Create reusable definitions with `createSound()`, then play finite effects, chords, held instruments, native repetitions or patterns. Returned controls own live edits and cancellation; definitions survive engine shutdown/start. Existing direct methods remain supported. Read the [skill entry point](skills/ti-synthengine/SKILL.md), [Sound interface](skills/ti-synthengine/references/sound-api.md) and [upgrade guide](skills/ti-synthengine/references/upgrade-2.0.0.md).
 
-Public repository: [macCesar/TiSynthEngine](https://github.com/macCesar/TiSynthEngine).
-Download [Android 1.1.0](https://github.com/macCesar/TiSynthEngine/releases/tag/android-1.1.0)
-and [iOS 1.1.0](https://github.com/macCesar/TiSynthEngine/releases/tag/ios-1.1.0),
+Download [Android 2.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/android-2.0.0)
+and [iOS 2.0.0](https://github.com/macCesar/TiSynthEngine/releases/tag/ios-2.0.0)
+from [macCesar/TiSynthEngine](https://github.com/macCesar/TiSynthEngine),
 copy the ZIPs into the Titanium app root and follow the [installation guide](skills/ti-synthengine/references/guide.md).
-Requires Titanium SDK 13.2.0.GA+, Android compile API35+, and iOS 15+; the Apple package also supports Mac Catalyst.
+Requires Titanium SDK 13.2.0.GA+, Android compile API 35+, and iOS 15+; the Apple package includes Mac Catalyst.
 
 When it activates:
+
 - `tiapp.xml` declares `ti.synthengine`, or code calls `require('ti.synthengine')`
-- Generated UI/game cues, instruments, alarms, chords, percussion, sweeps or binaural headphone placement
-- Finite-tone repetition and future-attack edits, held voices, simultaneous native sequences, shared tempo, selective effects/sends, priorities or live voice controls
-- Bounded native attack variation, deterministic seeds, complete effect playback or playable instrument adaptations
-- Rejected calls, startup glitches, voice/queue diagnostics, render-load measurements or source/artifact compatibility questions
+- UI/game cues, instruments, alarms, chords, percussion, ADSR, sweeps, FM, filters or binaural placement
+- Reusable Sound presets, atomic edits, native repetition/patterns, held-note controls or migration from direct methods
+- Shared effects, routing/sends, native attack variation, gain staging or audio diagnostics
 
 Example prompts:
+
 ```
-"Create a short sci-fi laser that sweeps left to right with ti.synthengine."
-"Build a playable xylophone without retriggering a bar on every touchmove."
-"Move a held spatial motor and change its noise clock and low-pass cutoff without restarting it."
-"Run music and a victory cue as independent native sequences, then cancel only the cue."
-"Apply reverb to music while keeping UI dry, and change the global tempo."
-"Explain what the Android Sim80 headphone result proves about performance."
-"Vary repeated impacts natively on public 1.1.0 and retain a clean fallback on published 1.0.2."
-"Repeat the original swept shot with repeatTone, edit its interval and stop future attacks without truncating sounding shots."
-"Use updateNote and enableStats/disableStats, and check this recipe against the bundled TypeScript declarations."
+"Create one reusable laser Sound and play it at each projectile's position."
+"Build a playable xylophone with independent note controls and touch-cancellation cleanup."
+"Repeat this complete swept shot natively, edit its interval and stop future attacks while sounding shots finish."
+"Run music and a victory pattern independently, then cancel only the victory control."
+"Migrate this app to createSound, getContract().version and setProcessing without changing envelopes or reverb time."
+"Change future preset executions with set(), and update only this playing repetition."
 ```
 
 Key rules:
-- Native variation requires both capability and schema announcements; [ranges, seeds and loop behavior](skills/ti-synthengine/references/native-variation.md) are distinct from live edits
-- Preserve complete effects and layer gains when adapting or repeating them; read [instruments and effects](skills/ti-synthengine/references/instruments-and-effects.md)
-- Read constants and exact ranges from the API; strict option dictionaries reject invalid fields or conflicting pitch sources
-- Timed tone/chord `duration` includes release. Native sequence intervals and note lengths are separate; held voices release through their IDs
-- Use `repeatTone` for the original finite-tone renderer and `playSequence` for ordered scores; retain each accepted ID. `stopTone` preserves admitted finite attacks, while `stopSequence` releases its emitted voices. `stopAll()` is global panic
-- Native repetition requires its capability and methods, integer `intervalMs` 1–60,000, and capacity for overlaps. Its 32 slots are independent of sequence capacity; all attacks share the voice pool
-- `updateTone` preserves the next deadline, validates merged recipes and changes future attacks. Independent gameplay calls and intentionally JavaScript-timed finite bursts remain supported; clear app-owned timers during teardown
-- Use `updateNote`, `enableStats` and `disableStats` in new 1.1.0 code. `updateVoice` and `setStatsEnabled(Boolean)` remain deprecated equivalent aliases; feature-detect the aliases when supporting 1.0.2
-- `setTempo` drives beat-based transport and synchronized modulation; millisecond sequences keep fixed timing
-- `bus`/`applyTo` select processed categories; explicit `effectSend` overrides that selection. One shared chain and final limiter remain global
-- Held spatial position, noise clock and one-pole cutoff support compatible 10 ms updates. A stereo voice cannot become spatial through an update
-- Omit both spatial coordinates for stereo; zero coordinates enable binaural center. Do not combine binaural coordinates with stereo pan fields
-- Start after layout, keep one lifecycle owner, handle Boolean acceptance and tone/sequence IDs, release held notes and owned repetitions on cancellation, and shut down during teardown
-- Current platform metadata, zero-envelope and diagnostic differences are documented. Host checks and a short accepted listening scene do not establish complete physical maximum-load acceptance
-
-The [retro recipes](skills/ti-synthengine/references/recipes.md) and [interaction/instrument recipes](skills/ti-synthengine/references/recipes-interaction.md) preserve acoustic intent, overlap budgets and cleanup. The [official declarations](skills/ti-synthengine/assets/index.d.ts) provide TypeScript signatures alongside the runtime API. [Repetition validation](skills/ti-synthengine/references/native-tone-repetition-validation.md) separates native checks, transport storage and bounded host measurements from device/listening acceptance. [Source notes](skills/ti-synthengine/references/source-notes.md) identify the reviewed native commit and evidence limits.
+
+- Put synthesis/routing in `sound` and pitch/type/timing in `playback`; execution overrides are flat. `set()` validates atomic future revisions and replaces arrays completely.
+- Tone/chord playback returns Boolean acceptance; held, repeat and pattern playback return controls or `false`. Invalid Sound configurations throw descriptive errors. Keep controls with their interaction owners.
+- Finite `duration` includes release. Pattern `interval` and `length` remain separate; repetitions preserve finite-envelope interpretation and use integer millisecond intervals.
+- `setProcessing()` uses milliseconds for delay `time` and reverb `decay`. Direct `setMasterProcessing()` retains its original units. Runtime metadata uses `version`.
+- Preserve grouped chord gains, layer levels, overlap budgets, stereo/spatial rules and native variation bounds. Use one engine owner and clean up notes, controls, listeners and polling during teardown.
+
+The [retro recipes](skills/ti-synthengine/references/recipes.md) and [interaction recipes](skills/ti-synthengine/references/recipes-interaction.md) preserve acoustic intent and cleanup. [Instruments and effects](skills/ti-synthengine/references/instruments-and-effects.md) explains complete playback and adaptations. The [TypeScript declarations](skills/ti-synthengine/assets/index.d.ts) complement runtime validation. [Source notes](skills/ti-synthengine/references/source-notes.md) retain practical platform caveats; diagnose performance on the intended device and keep technical measurements separate from listening acceptance.
 
 ---
 
@@ -689,7 +685,7 @@ Behavior depends on where you run it:
 | With `--local` flag        | Installs skills locally to `./.agents/skills/` in the current project |
 
 What it does:
-- Installs the 13 TiTools skills (global or local depending on context)
+- Installs the 14 TiTools skills (global or local depending on context)
 - Installs ti-pro agent for Claude Code
 - Installs the `/ti-check`, `/ti-new-screen` and `/ti-audit` slash commands into `~/.claude/commands/`
 - Detects installed AI platforms and lets you choose which to link (only Claude Code needs platform symlinks; Gemini CLI and Codex CLI auto-discover from `~/.agents/skills/`)
@@ -850,45 +846,9 @@ titools --version # CLI version only
 
 ---
 
-## Community-Discovered Patterns
-
-The TiTools skills include **Community-Discovered Patterns** — verified iOS behaviors not present in the official Titanium documentation. These sections are protected from removal during skill audits.
-
-### Large Title + ScrollView (iOS)
-
-When using Large Titles with a ScrollView inside NavigationWindow or TabGroup, three Window properties must be set together. Without all three, the ScrollView content overlaps behind the navigation bar — or the large title renders with a visible delay.
-
-| Class                            | Property                     | Purpose                                               |
-| -------------------------------- | ---------------------------- | ----------------------------------------------------- |
-| `auto-adjust-scroll-view-insets` | `autoAdjustScrollViewInsets` | Adjusts ScrollView insets to prevent content overlap  |
-| `extend-edges-all`               | `extendEdges`                | Content extends behind bars (blur/translucent effect) |
-| `large-title-enabled`            | `largeTitleEnabled`          | Large title that collapses on scroll                  |
-
-**Recommended:** set the base properties as global Window defaults in `config.cjs`:
-
-```js
-module.exports = {
-  theme: {
-    Window: {
-      ios: {
-        apply: 'auto-adjust-scroll-view-insets extend-edges-all status-bar-style-light-content'
-      }
-    }
-  }
-};
-```
-
-Then only add `large-title-enabled` per-window as needed:
-
-```xml
-<Window title="Home" class="large-title-enabled">
-  <ScrollView class="vertical w-screen" contentHeight="Ti.UI.SIZE">
-    <!-- Content starts below the nav bar automatically -->
-  </ScrollView>
-</Window>
-```
+## Curated resources
 
-This pattern is documented across four bundled TiTools skills: `ti-ui`, `ti-expert`, `purgetss`, and `ti-api`, which covers the underlying Window properties.
+Specialist skills such as PurgeTSS, native games and synthesis retain their declared practical resources and their own source authorities. The website-based guide/UI skills follow current official documentation only; they do not carry archived-only or community-only sections.
 
 ---
 
@@ -899,16 +859,17 @@ This pattern is documented across four bundled TiTools skills: `ti-ui`, `ti-expe
 | ti-reuse-first   | Reuse Before You Write        | 5 files (the ladder, Alloy reuse, indirection, PurgeTSS reuse, diagnostics)                                                                                                                          |
 | ti-expert        | Architecture + Implementation | 27 files (patterns, feedback surfaces, file type association, sharing, testing, security, etc.)                                                                                                      |
 | purgetss         | Setup + Critical Rules        | 39 files (Classic compatibility, grid, animations, icons, class-index, SVG pipeline, etc.)                                                                                                           |
-| ti-ui            | UI Rules + Platform Diffs     | 14 files (layouts, lists, gestures, etc.)                                                                                                                                                            |
+| ti-ui            | UI Rules + Platform Diffs     | 5 current official guides (native UI, layouts, lists, icons and platform conventions)                                                                                                                                                            |
 | ti-game          | Native 2D Game Workflow       | 12 files (API, input, source notes, setup, physics, patterns, recipes, tile maps, debugging, roadmap)                                                                                                |
 | ti-game-assets   | Visual and Sound Assets       | 10 guides and a manifest example; alpha and contract validation scripts                                                                                                                              |
 | ti-admob-unified | Unified Advertising           | 20 Markdown references including production, rewarded interstitial, mediation parity, integration library guidance, provenance and game monetization; source/hash checks and official example assets |
-| ti-synthengine   | Native Sound Synthesis        | 18 Markdown references (15 official parts, 2 curated recipe guides, maintenance notes), official TypeScript declarations, complete validation reports/evidence and a reversible source hash manifest                                   |
+| ti-synthengine   | Native Sound Synthesis        | TiSynth 2.0 Sound interface and migration, native parameter reference, practical sound design/recipes, runnable example and TypeScript declarations |
+| ti-create-release | Native Module Releases | Release workflow plus current module-directory discovery reference |
 | ti-api           | Titanium API                  | 20 references for core/platform APIs and native modules                                                                                                                                              |
-| ti-guides        | SDK Fundamentals              | 16 references for setup, configuration, CLI and distribution                                                                                                                                         |
-| ti-howtos        | Native Integrations           | 18 references for platform features and integration workflows                                                                                                                                        |
-| alloy-guides     | Alloy MVC                     | 11 references for controllers, views, models, styling and widgets                                                                                                                                    |
-| alloy-howtos     | Alloy CLI and Debugging       | 6 references for commands, configuration and practical workflows                                                                                                                                     |
+| ti-guides        | SDK Fundamentals              | 12 current references for setup, configuration, CLI and distribution                                                                                                                                         |
+| ti-howtos        | Native Integrations           | 9 current references for platform features and integration workflows                                                                                                                                        |
+| alloy-guides     | Alloy MVC                     | 10 references for current Alloy guides and independently sourced PurgeTSS integration                                                                                                                                    |
+| alloy-howtos     | Alloy CLI and Debugging       | 5 current references for app workflows, configuration and debugging                                                                                                                                     |
 
 ---
 

package/agents/ti-pro.md

@@ -10,6 +10,7 @@ skills:
   - ti-game-assets
   - ti-synthengine
   - ti-admob-unified
+  - ti-create-release
   - ti-api
   - ti-guides
   - ti-howtos
@@ -30,11 +31,12 @@ When invoked, research complex topics by consulting the applicable skills from t
 - `ti-reuse-first` - Whether the thing should exist at all, and what already does it; duplication and dead-structure sweeps
 - `ti-expert` - Architecture, patterns, conventions
 - `purgetss` - Utility-first styling classes (optional add-on; use when the project already has it or the user asks about it)
-- `ti-ui` - UI/UX patterns, layouts, gestures
+- `ti-ui` - Current official native UI, layout, list, icon and platform guides
 - `ti-game-assets` - Visual and sound asset contracts, raster generation, alpha/export validation, synthesis variants and stereo coordination when assets are involved
 - `ti-game` - Native `ti.game` architecture and API when the module is declared
-- `ti-synthengine` - Native synthesis, held voices, identified sequences/tempo, selective processing, live controls and platform/evidence limits when the module is declared or requested
+- `ti-synthengine` - TiSynth 2.0 reusable Sound definitions, independent playback controls, direct-method migration, timing/processing units, synthesis and platform caveats when the module is declared or requested
 - `ti-admob-unified` - Official unified advertising/privacy/mediation module contract and provider setup when declared or requested
+- `ti-create-release` - Native-module release-readiness and discovery research; read-only here, with publication reserved for an explicit user release request
 - `ti-api`, `ti-guides`, `ti-howtos` - Exact Titanium APIs, SDK fundamentals and native integrations
 - `alloy-guides`, `alloy-howtos` - Alloy MVC, CLI, configuration and compiler workflows when the project is Alloy
 

package/commands/ti-audit.md

@@ -11,24 +11,26 @@ Core Titanium audit:
 2. Invoke `ti-expert` — check architecture, navigation ownership, event/timer cleanup, memory leaks, bridge pressure, testing boundaries, adaptive layouts and code conventions.
 3. Invoke `ti-guides` — check `tiapp.xml`, CommonJS/Hyperloop usage, Titanium CLI/build assumptions, memory and bridge guidance, distribution settings, and toolchain compatibility.
 4. Invoke `ti-api` — verify every audited `Ti.*` API, event, property, constant and third-party module call against its exact signature. Do not report a suspected API defect from memory.
-5. Invoke `ti-ui` when the project creates Titanium UI — check layouts, list performance, event bubbling, gestures, animations, accessibility, orientation and platform-specific UI.
-6. Invoke `ti-howtos` when the project implements a native integration such as location, maps, push, camera, media, SQLite, HTTPClient, WebView, intents, Keychain/iCloud, Hyperloop or CI/CD — audit the complete integration and platform setup, not only the JavaScript call site.
+5. Invoke `ti-ui` when the project creates Titanium UI — check current layout, list, icon/launch-screen and platform-convention guidance. Use `ti-api` for event, gesture, animation, accessibility and orientation contracts.
+6. Invoke `ti-howtos` when the project implements a native integration such as location, maps, push, camera, media, SQLite, HTTPClient, native modules, Hyperloop or CLI plugins — audit the complete integration and platform setup, not only the JavaScript call site.
 
 Project-type audit:
 
-7. If the project is Alloy (`app/views/`, `app/controllers/`, `app/styles/`), invoke `alloy-guides` — check controllers, XML/TSS, models, collections, widgets, sync adapters and cleanup patterns.
-8. If the Alloy project uses `alloy.jmk`, `config.json`, `widget.json`, conditional views, custom XML tags or Alloy CLI workflows, invoke `alloy-howtos` — check configuration precedence, build hooks, generated structures and compilation/debugging conventions.
+7. If the project is Alloy (`app/views/`, `app/controllers/`, `app/styles/`), invoke `alloy-guides` — check controllers, XML/TSS, models, collections, widgets, persistence and cleanup patterns.
+8. If the Alloy project uses `alloy.jmk`, `config.json`, `widget.json`, conditional views or current Alloy CLI workflows, invoke `alloy-howtos` — check configuration precedence, build hooks, generated structures and compilation/debugging conventions.
 9. If the project uses PurgeTSS (`purgetss/`, `purgetss/config.cjs`, a PurgeTSS-generated `app.tss`, or `purgetss.{ui,colors,fonts}.js`), invoke `purgetss` and detect Alloy vs. Classic before applying findings. In Alloy, audit unsupported utility classes, padding on Views, unnecessary manual TSS, dynamic components, grids, icons and animations. In Classic, audit only the supported standalone asset/CommonJS commands and their `Resources/` outputs; do not require or recommend `alloy.jmk`, generated TSS, utility classes, or `$.UI.create()`.
 
 Native-module audit:
 
 10. If the project declares `ti.game`, invoke `ti-game` — check for sprites moved from timers instead of native properties, levels sized from `Ti.Platform.displayCaps` instead of the `resize` event, sprites added one by one instead of in one array, and timers or sounds left running when the window closes.
-11. If the project declares `ti.synthengine`, invoke `ti-synthengine` — check exact option/pitch/envelope contracts, Boolean acceptance and positive sequence IDs, native successive-note scheduling, per-owner sequence cancellation, held-note release/cancellation and compatible live updates. Check shared tempo versus millisecond timing, category/send selection, overlap/priority budgets, one lifecycle owner, delayed startup and teardown. Consult current source notes before assuming platform metadata/envelopes or rejection diagnostics match; separate host/load reports from scoped physical listening acceptance.
+11. If the project declares `ti.synthengine`, invoke `ti-synthengine` — check the installed module's `version`, Sound preset structure, flat execution overrides, atomic definition edits, interpretation-specific option/pitch/envelope contracts and error handling. Distinguish finite Boolean acceptance from held/repetition/pattern controls or `false`; verify per-owner release/cancellation, pattern `end` listeners, shutdown invalidation and definition reuse. Check native timing versus JavaScript timers, finite duration versus pattern interval/length, `setProcessing` millisecond units versus direct processing units, shared tempo, category/send selection, variation, overlap/priority budgets and one lifecycle owner. Existing direct methods retain their identifiers/events/return contracts; audit against the path actually used. Consult practical platform caveats and separate runtime measurements from listening acceptance.
 
 12. If the project has game art/sound inventories or asset-generation/export workflows, invoke `ti-game-assets` — check contracts per set, master provenance/transparency, protected alpha cleanup, frame/pivot alignment, complete derived exports, parallax layers, sound variants and semantic event bindings. Consult `ti-game` and `ti-synthengine` equally in their applicable domains; do not require module installation or new sounds for an image-only task.
 
 13. If the project declares `ti.admob.unified`/mediation complements or uses this module, invoke `ti-admob-unified` — verify public release/platform requirements, consent/request eligibility/initialization, ATT status versus permission, test IDs, independent banner lifecycle and deliberate fullscreen ownership. Check rewarded interstitial's reward introduction, visible Skip, reward-event credit and pending-context cancellation. Use the production guide for app IDs, app-ads.txt, privacy entry points and account readiness. Separate linking, Google test ads, selected-provider delivery and physical acceptance; preserve game frequency and pause/audio/input policy.
 
+For a native-module release-readiness review, consult `ti-create-release` in read-only mode to check source/artifact provenance and discovery metadata. An audit does not authorize publishing a release or changing GitHub metadata.
+
 If a conditional skill does not apply, record it as `not applicable` with the detected reason instead of inventing findings from it.
 
 Report findings grouped by severity: critical, warning, info.

package/docs/examples.md

@@ -37,19 +37,21 @@ an audio or advertising module.
 
 ## Native synthesis — ti-synthengine
 
-- "Install the public TiSynthEngine 1.1.0 Android/iOS packages and start audio after the window layout settles."
-- "Move a held spatial motor, process only music with reverb, and stop one native sequence without cancelling unrelated sounds."
-- "Use native attack variation with public 1.1.0: bounded noise/filter ranges, deterministic seeds and an old-package fallback."
-- "Repeat this complete layered effect natively without changing its envelope, sweep timing or gains."
-- "Use repeatTone for this finite shot, edit its interval with updateTone, and stop future attacks with stopTone while sounding shots finish."
-- "Use updateNote and enableStats/disableStats, checking the bundled TypeScript declarations and a 1.0.2 alias fallback."
-- "Keep these three standalone playTone calls as an intentional finite JavaScript burst and cancel their timers when the owner closes."
-
-Use the [synthesis skill](../skills/ti-synthengine/SKILL.md) for exact options,
-public downloads, bundled TypeScript declarations and scoped performance evidence.
-Native finite-tone repetitions, ordered sequences, held voices and standalone
-JavaScript events have distinct ownership and timing contracts. Public 1.0.2 /
-API 1.0.0 lacks repetition and variation; detect support before enabling them.
+- "Install the public TiSynthEngine 2.0.0 Android/iOS packages and start audio after the window layout settles."
+- "Create a reusable laser Sound with flat per-shot pitch and position overrides."
+- "Move a held spatial motor through its note control, then release it on touch cancellation."
+- "Play music and a victory pattern independently; stop only the cue and wait for its end event before replacing it."
+- "Repeat this complete layered effect natively without changing envelopes, sweep timing or gains."
+- "Change a reusable preset with set(), reset an optional leaf with null and keep active executions unchanged."
+- "Migrate playTone and setMasterProcessing to Sound objects and setProcessing, preserving timing and reverb units."
+- "Add bounded native attack variation and diagnose voice pressure with enableStats/disableStats."
+
+Use the [synthesis skill](../skills/ti-synthengine/SKILL.md) for checked Sound
+presets, controls, public downloads and TypeScript declarations. Finite events,
+held notes, native repetitions and patterns have distinct returns and cleanup.
+The [upgrade guide](../skills/ti-synthengine/references/upgrade-2.0.0.md) maps
+supported direct methods to the Sound interface and explains `version` metadata
+and processing units.
 
 ## Advertising — ti-admob-unified
 
@@ -96,3 +98,12 @@ existing components, then check scene input, native audio ownership and cleanup
 using the appropriate references."
 
 See [how the knowledge index works](knowledge-index.md) for reference discovery.
+
+
+## Native module releases — ti-create-release
+
+- "Prepare an iOS-only release of this Titanium module using its existing tag and build conventions."
+- "Publish the agreed Android/iOS ZIPs from the verified source commit and check the module's discovery topics and description."
+- "Review this fork's release readiness without publishing or changing GitHub metadata."
+
+Use [the release skill](../skills/ti-create-release/SKILL.md) for artifact provenance, authorized publication and directory discovery. App-store releases use their own workflows.

package/docs/knowledge-index.md

@@ -25,7 +25,7 @@ and generating an index in a consuming app are separate operations.
 
 ## Choose the relevant skills
 
-The catalog contains thirteen public skills:
+The catalog contains fourteen public skills:
 
 | Task | Skill |
 | --- | --- |
@@ -37,6 +37,7 @@ The catalog contains thirteen public skills:
 | Visual and sound asset production | `ti-game-assets` |
 | Native synthesis | `ti-synthengine` |
 | Unified advertising | `ti-admob-unified` |
+| Native module releases and discovery | `ti-create-release` |
 | Exact Titanium APIs | `ti-api` |
 | SDK fundamentals | `ti-guides` |
 | Native integrations | `ti-howtos` |

package/lib/config.js

@@ -38,6 +38,7 @@ export const SKILLS = [
   'ti-game-assets',
   'ti-synthengine',
   'ti-admob-unified',
+  'ti-create-release',
   'ti-api',
   'ti-guides',
   'ti-howtos',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "5.2.5",
+  "version": "5.4.0",
   "description": "Titanium SDK skills and agents for AI coding assistants, including native game and sound synthesis modules",
   "main": "lib/index.js",
   "type": "module",