@maccesar/titools 5.1.1 → 5.2.1

package/skills/ti-game-assets/references/manifest.example.json

@@ -0,0 +1,429 @@
+{
+  "schema_version": 1,
+  "contracts": {
+    "demo-world": {
+      "notes": "Minimal example; declare other required families for the real game. Sound assets are separate from PNG frames.",
+      "resources": [
+        {
+          "resource": "ship",
+          "family": "players",
+          "variant": "scout",
+          "state": "intact",
+          "frames": 1
+        },
+        {
+          "resource": "ship",
+          "family": "players",
+          "variant": "scout",
+          "state": "damaged",
+          "frames": 1
+        },
+        {
+          "resource": "explosion",
+          "family": "ambient",
+          "variant": "metal",
+          "state": "burst",
+          "frames": 3
+        },
+        {
+          "resource": "sky-far",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "frames": 1
+        },
+        {
+          "resource": "sky-middle",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "frames": 1
+        },
+        {
+          "resource": "sky-near",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "frames": 1
+        }
+      ],
+      "sounds": [
+        {
+          "sound": "explosion-metal",
+          "variants": [
+            "a",
+            "b",
+            "c"
+          ]
+        }
+      ],
+      "parallax": true
+    }
+  },
+  "sets": [
+    {
+      "id": "world-one",
+      "contract": "demo-world",
+      "assets": [
+        {
+          "resource": "ship",
+          "family": "players",
+          "variant": "scout",
+          "state": "intact",
+          "id": "ship-scout-intact-0",
+          "frame": 0,
+          "source": "art/masters/ship-scout-intact-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "hd",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "ship",
+          "family": "players",
+          "variant": "scout",
+          "state": "damaged",
+          "id": "ship-scout-damaged-0",
+          "frame": 0,
+          "source": "art/masters/ship-scout-damaged-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "hd",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "explosion",
+          "family": "ambient",
+          "variant": "metal",
+          "state": "burst",
+          "id": "explosion-metal-burst-0",
+          "frame": 0,
+          "source": "art/masters/explosion-metal-burst-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "soft-fx",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "explosion",
+          "family": "ambient",
+          "variant": "metal",
+          "state": "burst",
+          "id": "explosion-metal-burst-1",
+          "frame": 1,
+          "source": "art/masters/explosion-metal-burst-1.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "soft-fx",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "explosion",
+          "family": "ambient",
+          "variant": "metal",
+          "state": "burst",
+          "id": "explosion-metal-burst-2",
+          "frame": 2,
+          "source": "art/masters/explosion-metal-burst-2.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "soft-fx",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "sky-far",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "id": "sky-far-base-idle-0",
+          "frame": 0,
+          "source": "art/masters/sky-far-base-idle-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "hd",
+          "transparency": false,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "sky-middle",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "id": "sky-middle-base-idle-0",
+          "frame": 0,
+          "source": "art/masters/sky-middle-base-idle-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "hd",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        },
+        {
+          "resource": "sky-near",
+          "family": "backgrounds",
+          "variant": "base",
+          "state": "idle",
+          "id": "sky-near-base-idle-0",
+          "frame": 0,
+          "source": "art/masters/sky-near-base-idle-0.png",
+          "dimensions": [
+            1024,
+            1024
+          ],
+          "canvas": [
+            1024,
+            1024
+          ],
+          "pivot": [
+            512,
+            512
+          ],
+          "style": "hd",
+          "transparency": true,
+          "provenance": {
+            "prompt": "Replace with the actual art-contract prompt",
+            "tool": "image_gen",
+            "reference_roles": {},
+            "lineage": "original"
+          }
+        }
+      ],
+      "sounds": [
+        {
+          "id": "explosion-metal-a",
+          "sound": "explosion-metal",
+          "variant": "a",
+          "source": "audio/recipes.js",
+          "reference": "explosions.metal.a",
+          "kind": "effect",
+          "design": {
+            "semantic_event": "explosion",
+            "timbre": "filtered noise and metallic body",
+            "envelope": "Specify validated attack/decay/sustain/release",
+            "variation": "related texture variants without immediate repeat",
+            "stereo": "bounded screen-position pan, coherent event layers",
+            "overlap": "derive voice budget and gain from busy scenes",
+            "owner": "existing project audio service"
+          },
+          "provenance": {
+            "contract": "Read current ti-synthengine API before implementing",
+            "rationale": "material-specific cue"
+          }
+        },
+        {
+          "id": "explosion-metal-b",
+          "sound": "explosion-metal",
+          "variant": "b",
+          "source": "audio/recipes.js",
+          "reference": "explosions.metal.b",
+          "kind": "effect",
+          "design": {
+            "semantic_event": "explosion",
+            "timbre": "filtered noise and metallic body",
+            "envelope": "Specify validated attack/decay/sustain/release",
+            "variation": "related texture variants without immediate repeat",
+            "stereo": "bounded screen-position pan, coherent event layers",
+            "overlap": "derive voice budget and gain from busy scenes",
+            "owner": "existing project audio service"
+          },
+          "provenance": {
+            "contract": "Read current ti-synthengine API before implementing",
+            "rationale": "material-specific cue"
+          }
+        },
+        {
+          "id": "explosion-metal-c",
+          "sound": "explosion-metal",
+          "variant": "c",
+          "source": "audio/recipes.js",
+          "reference": "explosions.metal.c",
+          "kind": "effect",
+          "design": {
+            "semantic_event": "explosion",
+            "timbre": "filtered noise and metallic body",
+            "envelope": "Specify validated attack/decay/sustain/release",
+            "variation": "related texture variants without immediate repeat",
+            "stereo": "bounded screen-position pan, coherent event layers",
+            "overlap": "derive voice budget and gain from busy scenes",
+            "owner": "existing project audio service"
+          },
+          "provenance": {
+            "contract": "Read current ti-synthengine API before implementing",
+            "rationale": "material-specific cue"
+          }
+        }
+      ],
+      "aliases": {
+        "player": "ship-scout-intact-0"
+      },
+      "parallax": [
+        {
+          "depth": "far",
+          "asset": "sky-far-base-idle-0",
+          "order": 0,
+          "transparent": false,
+          "repeat": "x",
+          "displacement": [
+            0.1,
+            0
+          ]
+        },
+        {
+          "depth": "middle",
+          "asset": "sky-middle-base-idle-0",
+          "order": 1,
+          "transparent": true,
+          "repeat": "x",
+          "displacement": [
+            0.4,
+            0
+          ]
+        },
+        {
+          "depth": "near",
+          "asset": "sky-near-base-idle-0",
+          "order": 2,
+          "transparent": true,
+          "repeat": "x",
+          "displacement": [
+            0.8,
+            0
+          ]
+        }
+      ],
+      "events": [
+        {
+          "event": "explosion-metal-a",
+          "visual": "explosion-metal-burst-0",
+          "sound": "explosion-metal-a",
+          "timing": "discrete"
+        },
+        {
+          "event": "explosion-metal-b",
+          "visual": "explosion-metal-burst-0",
+          "sound": "explosion-metal-b",
+          "timing": "discrete"
+        },
+        {
+          "event": "explosion-metal-c",
+          "visual": "explosion-metal-burst-0",
+          "sound": "explosion-metal-c",
+          "timing": "discrete"
+        }
+      ],
+      "exports": {
+        "note": "Declare real atlas/HUD/preview/density paths and exporter commands here"
+      }
+    }
+  ]
+}

package/skills/ti-game-assets/references/manifest.md

@@ -0,0 +1,39 @@
+# Manifest contract (schema version 1)
+
+Use `manifest.example.json` as a template, not a shipped asset library. Its paths are placeholders for actual project sources; validation must fail until those files exist. Paths resolve from the manifest directory or `--root`.
+
+```bash
+python3 scripts/validate_manifest.py path/to/manifest.json --root path/to/project
+```
+
+`contracts` maps names to required inventories. Each resource definition declares `resource`, `family`, `variant`, `state` and positive `frames`. Every frame 0..frames-1 must exist exactly once in each set using that contract. Define another contract when a game/world/level needs a different set; never force every world to match a remembered 44/45 file count. List omissions intentionally in the contract's notes. Families are `players`, `enemies`, `allies`, `obstacles`, `ammunition`, `rewards`, `ambient`, `backgrounds`, `technical`.
+
+Each set has `id`, `contract`, `assets`, `sounds`, `aliases`, optional `parallax` and `events`. Each PNG asset has a unique `id`, the contract identity fields, zero-based `frame`, existing `source`, positive integer `dimensions` and `canvas`, finite pixel `pivot`, `style` (`pixel-art`, `hard-surface`, `soft-fx`, `hd`), Boolean `transparency` and `provenance.prompt`. Record generator/tool, reference roles and edit lineage in provenance. Pixel art additionally requires `logical_size`.
+
+Masters retain their full common canvas. All states and frames for one resource/variant must share canvas, pivot and logical size. The validator checks PNG dimensions, nonempty alpha and declared transparency (true requires actual transparent pixels; false requires an opaque image); it cannot recognize a painted checkerboard, grid quality or artistic continuity. Review those visually. For trimmed derivatives, store source dimensions, crop offset, output dimensions and adjusted pivot in the alpha report/export inventory; never substitute a trimmed derivative for the aligned master.
+
+`aliases` maps alternate names directly to existing image or sound IDs, without hiding an ID or chaining aliases. Technical utilities are inventoried distinctly through their family, not mistaken for unique gameplay drawings. The count report separates unique visual resources, PNG frames, sound variants and aliases.
+
+## Sounds are assets
+
+Contract `sounds` entries declare a sound family and its required named variants. Each set supplies every variant exactly once. A sound entry has `id`, `sound`, `variant`, an existing `source` code/data file, a `reference` identifying the recipe/pattern within it, `kind` (`effect`, `sustained`, `music`, `ambient`, `ui`), `design` and `provenance`. Synthesized sounds do not need a WAV or PNG; their reusable source is the recipe and its parameters. Keep sound assets distinct from image frames.
+
+Record semantic purpose, waveform/timbre, envelope, pitch movement, filters/FM, duration, gain, voice/overlap budget, variation strategy, stereo placement and lifecycle owner in design when relevant. Record which `ti-synthengine` contract/references were consulted. The inventory validator proves source presence and variant completeness, not that a symbol exists or synthesis options are accepted: verify recipe references and calls against the current module contract separately.
+
+`events` maps a semantic `event` to an image ID, sound ID and `timing` (`discrete`, `sustained`, `music`). Use variant-specific bindings where needed. An explosion sound starts at the explosion event, not once per animation frame. Sound-only/UI events may live in the project's audio inventory without requiring a made-up visual; this audiovisual mapping is only for events having both.
+
+## Parallax and derived outputs
+
+When the contract declares `parallax: true`, provide exactly three independent background assets: `far`, `middle`, `near`. Each layer declares `asset`, integer `order` increasing with depth, Boolean `transparent` matching its source asset, `repeat` (`none`, `x`, `y`, `xy`) and finite `[x,y]` displacement. Review seams and actual native scrolling separately. Transparency of opaque distant skies and translucent nearer layers is a style choice declared here.
+
+Extend the manifest with project-specific `exports` (atlas/JSON/frame map, HUD/cards/previews/menu/densities), collision-overlay references and source-to-output dependencies. Reuse the project's validator/exporter for those formats. The bundled validator validates masters/inventory only; include its report and the project export checks in acceptance. Quantities are compared within a named contract, not across unlike contracts.
+
+For each export destination, record the selected resources/aliases and their actual consumer. Keep this selection distinct from the complete source inventory: menu icons, HD previews, Archive cards and covers can require different subsets. An unused source or alias is not a reason to generate a UI copy. Follow [integration.md](integration.md#export-only-what-each-consumer-uses) for selection, obsolete-density cleanup and package verification.
+
+## Optional reproducible sources and audio files
+
+For vector-authored artwork, `vector_source` points at the existing SVG with a finite, positive-extent `viewBox`; `source` remains the full-canvas PNG render checked for image geometry. Preserve the actual editable source and record generator/render settings. `build.files` optionally maps all source, generator and generated paths to lowercase SHA-256 hashes, checked against existing files. See [vector-sources.md](vector-sources.md).
+
+For offline audio, a sound can add `wav: {file, sample_rate, channels, sample_width, frames, loop}`. `sample_width` is bytes/sample; numeric header fields are positive integers and `loop` is Boolean. The validator checks nonempty PCM headers and complete payloads; signal/loop quality is a separate analysis. See [offline-audio.md](offline-audio.md).
+
+Project-specific `tiling` and ad policy metadata remain checked by project verifiers, not by this inventory helper. See [repeating-textures.md](repeating-textures.md) and [responsible-ads.md](responsible-ads.md).

package/skills/ti-game-assets/references/offline-audio.md

@@ -0,0 +1,33 @@
+# Procedural WAV sources and audio analysis
+
+Support both runtime `ti.synthengine` recipes and offline synthesized WAV assets. Preserve the project's chosen backend: Lander generates PCM WAV with Python's `wave`/`struct` and deterministic synthesis; Guardian uses native recipes with generated WAV fallback. Do not install a synthesizer module just to generate a WAV. The authoring agent (Claude Code, Codex CLI, etc.) is provenance, not the synthesis algorithm.
+
+Keep generator code, recipe parameters, seed, reference roles, sample rate, bit depth/sample width, channels, duration/frame count and loop/one-shot role. Store source and resulting file hashes. Choose formats compatible with the installed playback engine. Make fallback semantics match the requested cue, and preserve mute/preferences, pause, lifecycle and graceful failure. A mono WAV can still be spatialized if the playback backend supports it; do not assume that support.
+
+## Analysis and tools
+
+Inspect available tools/versions before use. `ffprobe` reports codec, sample format, rate, channels and duration. FFmpeg can decode/convert, measure peak/RMS/DC statistics and draw spectral views; that does not automatically identify the notes in noisy or polyphonic effects. Use FFT/autocorrelation or a dedicated pitch estimator for an appropriate signal, state window/hop and uncertainty, and distinguish a harmonic peak from the fundamental. Music note naming is an optional interpretation under an explicit tuning reference, not a reliable description of every noise effect.
+
+Examples (read/derived output only; choose new paths and inspect installed filter help):
+
+```bash
+ffprobe -v error -select_streams a:0 -show_entries stream=codec_name,sample_rate,channels,bits_per_sample:format=duration -of json cue.wav
+ffmpeg -hide_banner -i cue.wav -af astats -f null -
+ffmpeg -n -i cue.wav -lavfi showspectrumpic=s=1024x512 -frames:v 1 /tmp/cue-spectrum.png
+```
+
+Do not claim a historical project used FFmpeg unless its code/logs show it. Verified in this review: Lander's current generator writes WAV directly in Python; Guardian's `docs/scripts/generate-audio.js` writes RIFF/PCM directly in Node. Both can be analyzed with other tools without those tools being the original synthesizer.
+
+## Synthesis and loops
+
+For a changing frequency, integrate frequency into phase (`phase[n+1] = phase[n] + 2π f[n]/sampleRate`); multiplying a time-varying frequency by time produces a different sweep. Keep oscillators/modulation below meaningful aliasing limits or use a suitable band-limited method; square/saw/noise/FM require listening beyond a peak check. Mix with headroom and verify clipped samples, DC offset, peak, RMS and tails; do not solve every mix by normalization.
+
+A one-shot's fades/envelope must not automatically wrap around a loop. Measure amplitude continuity and local RMS through repeated joins, as well as phase/tangent continuity for tonal components. Integer cycles of tonal and modulation periods are one useful periodic construction, not a universal recipe for noisy loops. Check the complete mixed/noise signal too. Crossfading can help suitable ambience, but is not a substitute for reviewing the loop; detuned partials may introduce an unwanted amplitude beat.
+
+Lander's documented thruster pulse came from fades inside the WAV, despite gapless playback. It rebuilt the loops with periodic tonal/modulation components and tested with an old-file positive control (`docs/project/decisions.md`, 2026-08-18; `scripts/generate_game_assets.py`). Preserve this diagnostic lesson rather than its exact frequencies or durations.
+
+## Manifest and acceptance
+
+A sound may keep `source`/`reference` for its generator recipe and optionally declare `wav: {file, sample_rate, channels, sample_width, frames, loop}`. The validator checks an existing PCM WAV against those header fields and rejects empty/truncated payloads; it does not check pitch, clipping, loop quality or native playback. `sample_width` is bytes per sample. `loop` records intent, not a quality certificate. Use project analysis/tests and repeated listening to prove those properties.
+
+Report separately: file/contract checks, signal analysis, native playback and headphone/phone listening. Preserve reference rights/provenance; original sound design based on technical observations does not authorize redistributing reference recordings or ROM/sample data.

package/skills/ti-game-assets/references/prompts.md

@@ -0,0 +1,33 @@
+# Prompt starting points
+
+Replace brackets from the world's art contract. Attach only relevant references and explicitly identify their role. Use integrated `image_gen`, not a script/API, to create or edit raster art. These examples require review rather than guaranteeing generator compliance.
+
+## Pixel sprite
+
+“Create one individual [player ship], strict [64×64] logical pixel grid represented as uniform proportional blocks on a transparent HD canvas. [Palette], [orientation/perspective], [materials], clear silhouette at game size. No cast, ground or external drop shadow; internal shading only. Match [style reference] for this family. Use the maximum useful canvas with tight framing of the complete silhouette, only the transparent edge needed to prevent clipping, and pivot [coordinates]. No antialiased subpixel edges or painted checkerboard.” Keep the master, prepare nearest-neighbor logical output and inspect grid/palette. A shared state/animation canvas overrides independent tight framing when its contract requires alignment.
+
+For pixel-art effects, explicitly add: “Final atlas cell [32×32 impact / 64×64 explosion], visible phase extent [W×H], source-to-logical mapping [registered common grid / phase-specific grid]. Each logical pixel is one uniform square block of flat RGBA in the HD master, proportional to the actual final display size. No mixed block sizes, tiny HD texture or subpixel sparks. Smoke uses square clusters on the same grid, controlled partial-alpha steps and increasingly transparent outer clusters, with transparent gaps; no opaque grey backing shape or smooth painted smoke.” Inspect the actual reduced frame and neighboring phases with nearest-neighbor rendering; HD appearance alone is not acceptance.
+
+## Individual HD sprite
+
+“Create one individual [power-up/ship/asteroid] as a transparent HD master in [world style and palette]. [Reference A] defines materials and rendering; [reference B] defines composition. Use the highest suitable supported generation quality, [appropriate aspect ratio] and maximum useful canvas coverage. Closely frame the entire subject with only minimal transparent edge clearance; preserve every outline and [declared effect extent], without clipping. Crisp angles and clean contours, finely defined [textures/material reflections], smooth controlled gradients and internal shading, readable silhouette at [display size]. No external shadow or painted checkerboard.” Record actual output dimensions, inspect alpha/detail and keep the original pixels. Do not insert arbitrary occupancy percentages or force the HD master to the small display size.
+
+## HD reconstruction
+
+For a requested substantial mechanical reconstruction, use: “Create a freshly redrawn individual HD [ship/object]. [Original] defines recognizable design/topology only; [quality reference] defines the required finish. Rebuild the geometry with [required symmetry], precise straight panel lines, regular curved edges and concentric rings, defined bevels/joints/material textures, clean gradients and coherent [lighting]. Correct the original's warped shading and irregular curves. Use the highest useful native generation resolution and tight complete framing with real alpha. A near-identical copy with slight sharpening is insufficient.” Preserve deliberate design asymmetry where applicable; do not impose mechanical geometry on other styles. Inspect original, new master and final-size derivative together.
+
+## HD state edit
+
+“Edit the attached [exact target], preserving canvas, silhouette, scale, orientation and pivot. Add [damage] in [specified areas] using the same [palette/materials/texture]. Real transparency, no external shadow, no cropping. [Second image] is a composition reference only.” Inspect both states overlaid; regenerate exports.
+
+## Soft explosion
+
+“Create [frame description] of an explosion sequence in [style/palette]. Real transparent background with intentional faint smoke and [declared halo]. Common [canvas] and center [pivot] across frames, increasing radius [progression]. No ground/cast shadow.” Analyze alpha at all thresholds; preserve faint effect edges. Cleaning needs an explicit reviewed protected region.
+
+## Level and parallax with sound
+
+“Design [world] using [contract], with players, enemies, allies, obstacles, ammunition, rewards, ambient objects and backgrounds as required. Produce independent far, middle and near parallax layers; [axes] repeat seamlessly with [transparency] and [order/displacement].” Complete the manifest before integration. If shot/explosion/ambience synthesis is requested, map semantic events to existing `ti.synthengine` sounds/patterns, consult its current contract and preserve the native clock; never trigger each frame.
+
+## Sound family with variants and stereo
+
+“Create [three] related [metallic explosion] variants for [world/material] using `ti.synthengine`, keeping the same recognizable family and distinguishing texture/envelope rather than random volume alone. Place discrete events from their screen origin, keep event layers spatially coherent, preserve the current audio owner/clock/preferences and size the overlap budget from representative scenes. Inventory recipes and explain waveform/envelope/filter choices. Validate calls separately from device listening.” Read `sound-assets.md` and the current `ti-synthengine` references first.

package/skills/ti-game-assets/references/repeating-textures.md

@@ -0,0 +1,17 @@
+# Textures, tiles and seamless repetition
+
+Clarify what “symmetric” means: mirrored appearance, rotational symmetry, or periodic edges that repeat without a visible seam. A seamless texture need not be mirrored. Mirroring can join edges while leaving obvious center axes and repeated motifs, as Lander's terrain review found.
+
+Declare repeat axes (`x`, `y`, `xy`, none), period, logical scale, opacity and allowed neighbors. A sky may repeat only horizontally; a terrain interior may repeat both ways; a surface tile has a free top silhouette and only joins an interior below. Specify corner/edge/interior roles and index order when topology matters. Never validate every pair as if all pairs are reachable in the level.
+
+For raster creation request periodic edges and balanced visual density with integrated `image_gen`; inspect the result rather than assuming the prompt made it seamless. For authored SVG/procedural textures use periodic geometry and wrapped copies of border-crossing elements. With seeded stars/details, check spacing across the wrap boundary as well as inside the tile; otherwise a seam can create a cluster. Avoid modular placement rules that create diagonal bands.
+
+Generate 3×3 repeated previews and offset the image by half its width/height to expose central seams. Test all reachable horizontal/vertical adjacency pairs and top-to-interior joins. Compare RGBA edges with premultiplied RGB and alpha separately so invisible RGB does not create false seams. Compare the edge jump to ordinary adjacent-pixel differences and inspect gradients/tangent continuity: identical end pixels alone cannot certify an invisible join. Record measured tolerance for the style; no universal numeric seam threshold applies to every texture.
+
+Review at actual zoom/filtering and while native camera scrolling crosses the seam. Check larger patches for visible repetition, symmetry axes and brightness bands. Seam correctness and repetition fatigue are distinct concerns.
+
+Use independent full textures for repeated backgrounds where the renderer repeats whole textures; do not assume an atlas frame repeats safely. Consult the installed `ti-game` build for texture-repeat restrictions (including power-of-two when required), filtering, UV inset and tile-layer support. A non-repeated atlas need not obey repeat-texture dimensions. For a circular world, coordinate world width, texture period and parallax factors so every layer returns to the same phase at wrap. Keep motion native.
+
+Store project-specific `tiling` metadata (axes, period, allowed neighbors, edge roles and seam-preview paths) and validate it with the project's existing tile verifier. The bundled manifest validator checks inventory/parallax declarations, not rendered seam quality.
+
+Evidence: Lander `docs/art/terrain-tiles.md` separates surface/interior topology and warns about visible mirror axes. Guardian `docs/art/README.md`, `docs/scripts/verify-art.js` and `docs/project/context.md` document periodic backgrounds, wrap spacing and circular parallax phase.

package/skills/ti-game-assets/references/responsible-ads.md

@@ -0,0 +1,31 @@
+# Responsible monetization in the game flow
+
+Advertising is a game lifecycle/experience concern, not an image or sound asset format. Route here when the user requests monetization or the task touches existing ad transitions; do not initialize ads because assets are being generated. Use `ti-game` for native pause/cleanup and Titanium integration skills plus the installed ad-module documentation for exact APIs. For César's **TiAdmobUnified** module (`ti.admob.unified`), use the standalone `ti-admob-unified` skill: official installation/API/privacy/library/mediation guides govern technical integration and provider setup. Its first public 1.0.0 release is under preparation at the initial snapshot; do not assume publication. Inspect the installed version/source/examples; do not invent method names or edit a vendored upstream helper casually.
+
+## Protect play and navigation
+
+Choose deliberate natural breaks (for example, settled end-of-run results) rather than interrupting flight, combat, tutorial or a rapid retry. Do not queue an ad from a timer simply because a quota was reached. A load callback or foreground resume must not spring an old ad on a new screen. Failed/no-fill/skipped attempts should allow the user's intended action, without loops of loading screens or counting an exposure that never happened.
+
+Use one owner and prevent simultaneous presentations. At the selected boundary, ensure the native game is actually paused or the session is released as appropriate; stopping a JS decision timer does not stop native gravity or audio. Do not universally destroy a session that legitimately needs to resume. Restore the correct scene, clock, inputs and sound only after dismissal or a confirmed failure to present.
+
+Separate grace period, accumulated active play, cooldown since dismissal, per-hour/day quotas and eligible presentation points. Pause/background/menu time should not accidentally earn ad eligibility. Persist what the game's policy requires and handle restarts/date changes/clock rollback conservatively. Count a confirmed opening exactly once; count close separately. Do not copy Lander/Guardian's numeric thresholds as an industry optimum: those are an initial product configuration awaiting retention/fatigue evidence. Frequency caps are ceilings, not targets.
+
+## Failure and callbacks
+
+Guard continuations against screen destruction and duplicate/late callbacks. Bound the wait for an ad that never opens; a timeout must not unlock gameplay behind an ad confirmed open. Back/Menu/Retry should not each trigger another presentation. Preserve preload/backoff behavior without presenting from load callbacks. Exercise no module, no fill, load/show failure, repeated taps, late opening, actual dismissal, background/resume and destruction in both platforms.
+
+## Format choice and measurement
+
+Choose formats for the requested game: banners need safe placement away from controls and important visual/audio cues; rewarded ads need a clear voluntary offer, a predictable reward and completion handling without duplicate rewards. Do not silently replace an interstitial policy with paid continues, App Open, forced rewards or banners. Inventory the chosen policy and measure confirmed exposures, ads per active-play minute, abandonment around breaks, retries/retention and reward usage when applicable. Collect only authorized telemetry and keep experiments separate from normal persistent counters. No tested optimum follows from passing unit tests.
+
+Use test IDs while developing. Preserve the existing consent/privacy flow and ability to revisit choices; consult current UMP guidance and the installed module's exposed eligibility before requesting ads. Consent is not a universal Boolean substitute for actual request eligibility. This guide does not enable live monetization, change IDs or make legal conclusions.
+
+## Current policy sources
+
+Check these official sources again before proposing or changing a live placement; policies can change. Consulted 2026-10-11:
+
+- [AdMob: disallowed interstitial implementations](https://support.google.com/admob/answer/6201362?hl=en) — natural breaks, unexpected launches, navigation and excessive repeated placements.
+- [AdMob: recommended interstitial implementations](https://support.google.com/admob/answer/6201350?hl=en) — natural boundaries and preload considerations.
+- [Google UMP Android setup](https://developers.google.com/admob/android/privacy) — current consent updates, privacy options and request eligibility; consult corresponding iOS guidance and module documentation for platform parity.
+
+Project evidence: Lander `app/lib/game/AdDirector.js` and Guardian `app/lib/systems/ad-director.js` separate presentation from play. Their October decisions document final-result attempts, active-play counters, confirmed openings, cooldown after close and callback ownership. Treat their old proposals and newer implemented decisions distinctly.

package/skills/ti-game-assets/references/sound-assets.md

@@ -0,0 +1,42 @@
+# Create and refine sound assets
+
+Sound is an essential asset domain alongside images. `ti-game-assets` coordinates creation, variation, inventory, integration and acceptance of both. `ti-synthengine` governs synthesis and acoustic design with the **`ti.synthengine`** native contract; `ti-game` governs visual representation, movement and events. Neither domain is subordinate to the other.
+
+Read the installed `ti-synthengine` skill and its API, sound-design/recipes, audio-engine and lifecycle references relevant to the request before composing or editing sounds. Use integrated `image_gen` for raster drawings and native synthesis recipes/patterns for runtime sounds. For procedural WAV generators, file analysis, fallback and seamless loops read [offline-audio.md](offline-audio.md); preserve the project backend instead of requiring a native synthesis module. Do not treat `image_gen` as an audio generator. If requested sound cannot be represented by `ti.synthengine` (such as recorded speech or sample playback), explain the limitation and use the project's appropriate audio workflow when authorized; never invent synthesizer capabilities.
+
+## Synthesis knowledge to apply
+
+Use these concepts to explain the acoustic choices, then consult `ti-synthengine`'s `references/sound-design.md` and `references/recipes.md` for details and `references/api.md` for exact supported fields. These are design starting points, not another API manual.
+
+| Control | What to listen for | Useful game direction |
+| --- | --- | --- |
+| Waveform and harmonics | Sine is clean; triangle softer than square; square/saw have stronger harmonics; noise has no single pitch | Clean UI, retro rewards, buzzy alarms, impact/wind texture |
+| ADSR envelope | Attack shapes onset; decay falls to sustain; release shapes the tail | Fast impact vs. soft ambience, pluck vs. held propulsion; fit stages inside duration |
+| Pitch and sweep | Register and upward/downward motion change perceived energy | Laser zap, activation, power-down; distinguish actual pitch from noise-rate changes |
+| Filters and resonance | Low-pass darkens, high-pass thins, band-pass isolates a band; resonance can emphasize it | Material/body vs. hiss, explosion tails, wah or wind; watch resonant peaks |
+| FM | Modulator/carrier ratio and modulation depth change harmonic/metallic character | Bell/glass/metal attacks, electric-piano rewards; declining depth mellows the tail |
+| Detune and LFO | Nearby pitched voices beat; LFO adds pitch motion | Unison texture or vibrato; avoid adding voices or modulation without a perceptual purpose |
+| Layering and gain | Body and noise can combine; overlap and release tails add energy | One recognizable event with a controlled voice budget; check clipping and masking |
+| Pan and movement | Stereo position or sweep supports spatial meaning | Place impacts in the playfield, keep UI centered when appropriate, verify mono cues |
+
+Avoid equating lower frequency with a guaranteed bigger sound on a phone speaker. Listen for harmonics, attack, noise/body balance and intelligibility in context. Change one design dimension at a time when comparing candidates; keep level comparable so louder does not win by accident. Describe why each waveform, envelope and modulation creates the requested effect. Exact range, cross-field validity and module-specific limitations remain `ti-synthengine`'s responsibility.
+
+## Work from meaning to timbre
+
+Inspect the existing sound owner and inventory first. Define an acoustic palette per game/world/family, just as for art: retro/clean/metallic/organic texture, attack and decay character, pitch register, emotional role and density. Design shots, impacts, explosions, thrust, pickups, damage, UI, music and ambience only as required by the contract. Create or refine focused recipes and reusable parameter variants, not another global audio owner. Preserve prompts/design rationale and provenance with their source code/data.
+
+Make variation meaningful: material, enemy, weapon or reward function should guide timbre, envelope, pitch/filter/FM choices. Random pitch or volume alone may be insufficient. Choose among related variants without immediate repetition when that suits the event, and coordinate visual/audio variation indices when they describe the same outcome. Preserve a recognizable family sound and avoid distracting differences. These are design criteria, not universal counts or mandatory mechanics.
+
+## Stereo, overlap and lifecycle
+
+Where screen position matters, derive bounded pan from the event's horizontal position using the measured playfield width. Clamp to a deliberately chosen range and use center when position is unavailable. Capture coordinates before pooling/recycling an entity. Keep layers of one event at the same spatial position unless a deliberate sweep is part of the sound. When a static position is intended, consult the current contract for `pan`/`panEnd` behavior. Do not add frame timers or extra voices just for panning. Check mono/small-speaker audibility: stereo supports a cue, never carries its only meaning.
+
+Use accepted events, not every spawned projectile or animation frame, as sound triggers. Budget simultaneous voices including release tails, layers, enemies and music. Use event gates, priorities, family aggregation and gain staging when actual overlap calls for them; derive the values from the game, not from another project's constants. Sustained propulsion/ambience and music need a different ownership/timing strategy from discrete effects. Preserve the native clock, pause/background/resume behavior, mute/preferences and cleanup. Verify the module's real scheduling/cancellation limitations before proposing changes.
+
+Asteroids provides useful design evidence: related explosion variants, material/enemy profiles, stereo positions captured before recycling, family aggregation and overlap budgets. Those choices are examples rather than fixed caps, gates, gains, pan ranges or API wrappers for every game. Inspect a target project's current implementation; do not import Asteroids' balance or assumptions.
+
+## Validate and listen
+
+Check every recipe/pattern against the current strict option contract, envelope intersection, finite/ranged values, accepted results and lifecycle. If a project has a contract harness or DSP render tool, reuse it; do not certify a mock as native playback. Use a temporary diagnostic listening surface when appropriate, preserving app data and existing owners.
+
+Listen to individual variants and representative busy scenes on headphones and a physical phone speaker, including mono behavior, distinction between cues, clipping/fatigue and music/effect masking. Record technical validation, audition path and human acceptance separately. Simulation or DSP replay can catch problems but cannot certify device sound quality. No new sound library, module install or unrelated gameplay change is implied by an image-only request.