@maccesar/titools 4.5.0 → 4.7.0

package/README.md

@@ -6,7 +6,7 @@
 
 </div>
 
-TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 8 skills — 3 opinionated (`ti-expert`, `purgetss`, `ti-ui`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling, and UI/UX patterns.
+TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 9 skills — 4 opinionated (`ti-expert`, `purgetss`, `ti-ui`, `ti-game`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling, UI/UX patterns, and 2D game development with the `ti.game` module.
 
 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.
 
@@ -36,9 +36,9 @@ The fastest way to get started with Claude Code. One command to add the marketpl
 ```
 
 What you get:
-- All 3 TiTools skills (`ti-expert`, `purgetss`, `ti-ui`)
+- All 9 TiTools skills (`ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `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)
+- Session hook that auto-detects Titanium projects (`tiapp.xml`, Alloy, PurgeTSS, `ti.game`)
 - Slash commands: `/ti-check`, `/ti-new-screen`, `/ti-audit`
 - Auto-updates via marketplace (opt-in — see note below)
 
@@ -70,7 +70,7 @@ claude   # or gemini, or codex
 ```
 
 What gets installed:
-- The 8 TiTools skills to `~/.agents/skills/`
+- The 9 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`
@@ -91,7 +91,7 @@ Why NPM?
 | **Knowledge Index** | Not included                               | Included (`titools sync`) |
 | **Auto-updates**    | Marketplace (opt-in, enable in `/plugin`)  | SessionStart hook (daily) |
 | **Slash commands**  | `/ti-check`, `/ti-new-screen`, `/ti-audit` | Same three (`~/.claude/commands/`) |
-| **Session hook**    | Auto-detects Titanium projects             | Auto-update only          |
+| **Session hook**    | Auto-detects Titanium projects (Alloy/Classic, PurgeTSS, `ti.game`) | Auto-update only          |
 
 Having both installed is fine: the CLI detects an enabled marketplace plugin and skips its own skill symlinks and command copies, so nothing shows up twice. `titools doctor` reports which channel is serving Claude Code.
 
@@ -177,6 +177,7 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | ti-expert    | Architecture and implementation     | Starting point for most tasks           |
 | purgetss     | Utility-first styling               | UI styling and animations               |
 | ti-ui        | UI/UX patterns                      | Complex layouts, ListViews, platform UI |
+| ti-game      | 2D games with the `ti.game` module  | Sprites, physics, collisions, particles, camera |
 | ti-api       | Complete Titanium API reference     | 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    |
@@ -184,7 +185,8 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | alloy-howtos | Alloy CLI, configuration, debugging | alloy.jmk, config.json, custom XML tags |
 
 Notes:
-- The first three (`ti-expert`, `purgetss`, `ti-ui`) are opinionated workflow skills reflecting TiTools' Titanium conventions.
+- The first four (`ti-expert`, `purgetss`, `ti-ui`, `ti-game`) are opinionated workflow skills reflecting TiTools' Titanium conventions.
+- `ti-game` documents the `ti.game` native module (2D sprite engine on OpenGL ES 2.0, Android and iOS). Its API reference was verified against the module source; it applies to Alloy and Classic projects alike and does not depend on PurgeTSS.
 - The latter five are documentation-mirror skills sourced from the official Titanium SDK docs (`tidev/titanium-docs`) and audited against them via the internal `titools-skill-auditor`.
 - `purgetss` reference files are audited against the official PurgeTSS documentation, but its workflow conventions are opinionated.
 
@@ -254,9 +256,11 @@ These commands automatically invoke the relevant skills:
 The plugin includes a session start hook that auto-detects Titanium projects. When you open Claude Code in a directory with `tiapp.xml`, it automatically reports:
 
 ```
-Titanium Alloy + PurgeTSS project detected. TiTools skills are available and MUST be used...
+Titanium Alloy + PurgeTSS + ti.game project detected. TiTools skills are available and MUST be used...
 ```
 
+It reports Alloy vs Classic, whether PurgeTSS is configured, and whether the project declares the `ti.game` module — a game project also gets a line pointing at the `ti-game` skill.
+
 This ensures Claude knows it's a Titanium project from the first prompt, preventing it from writing generic code.
 
 ---
@@ -285,6 +289,7 @@ All skills include automatic project detection to ensure compatibility:
 | purgetss  | PurgeTSS installation | Checks for `purgetss/` folder, `config.cjs`, `utilities.tss`  |
 | ti-expert | Alloy vs Classic      | Checks for `app/` (Alloy) vs `Resources/` (Classic) structure |
 | ti-ui     | Titanium projects     | Checks for `tiapp.xml` (both Alloy and Classic)               |
+| ti-game   | ti.game module        | Checks for `<module>ti.game</module>` in `tiapp.xml` or `require('ti.game')` |
 
 Why this matters:
 - PurgeTSS suggestions are only provided if PurgeTSS is installed
@@ -422,6 +427,37 @@ Key rules:
 
 ---
 
+### ti-game
+
+2D game development with the `ti.game` native module — a sprite engine rendered with OpenGL ES 2.0, same JS API on Android and iOS. Works in Alloy and Classic projects.
+
+When it activates:
+- `tiapp.xml` declares `ti.game`, or any file calls `require('ti.game')`
+- Sprites, sprite sheets, TexturePacker atlases, frame animations, native tweens
+- Physics: gravity and velocity, solid platforms, one-way floors, bouncing, the arcade car model, Newtonian thrust
+- Collision groups, invisible trigger zones, hitbox tuning
+- Particle emitters, Verlet ropes, camera follow/zoom/shake/effects, low-latency sound
+- Drag & drop, pinch, rotate, multitouch controls
+
+Example prompts:
+```
+"Build a flappy-bird style game with ti.game."
+"My sprites won't collide — collisionGroup is set on both."
+"Add a camera that follows the player with a dead zone."
+"How do I make a top-down racer that drifts?"
+"Why does my game stutter when I move sprites from setInterval?"
+```
+
+Key rules:
+- JS describes the scene and reacts to events; the engine runs every frame. Never move a sprite from a timer — use velocity, gravity, a tween, `carMode` or `thrust`
+- Build the level inside a guarded `resize` handler, never from `Ti.Platform.displayCaps`
+- `solidWith` blocks, `collidesWith` reports — they are independent
+- A sprite with size but no sheet is an invisible trigger (scores, goals, walls)
+- Add a whole level with one `gameView.add([...])` call
+- There is no text in the engine: HUDs are `Ti.UI.Label` overlays
+
+---
+
 ## Usage examples and best practices
 
 ### Example prompts
@@ -517,7 +553,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 8 TiTools skills (global or local depending on context)
+- Installs the 9 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/`)

package/commands/ti-audit.md

@@ -9,5 +9,6 @@ Audit the current Titanium project by invoking the relevant TiTools skills:
 2. Invoke `ti-ui` — check for UI anti-patterns (Ti.UI.SIZE in ListViews, WebView inside TableView, missing accessibility)
 3. If PurgeTSS project, invoke `purgetss` — check for custom TSS that should be utility classes, unsupported classes, padding on Views
 4. Invoke `alloy-guides` — check for proper Alloy patterns (model usage, widget structure)
+5. 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
 
 Report findings grouped by severity: critical, warning, info.

package/commands/ti-check.md

@@ -8,8 +8,9 @@ Check the current Titanium project and report:
 1. Read `tiapp.xml` — report SDK version, app ID, deployment targets
 2. Check if Alloy project (app/views + app/controllers exist)
 3. Check if PurgeTSS is configured (purgetss/config.cjs exists)
-4. Check for common issues:
+4. Check whether the `ti.game` module is declared in `tiapp.xml` — report its version and whether the module is actually present under `modules/<platform>/ti.game/<version>/` or installed globally
+5. Check for common issues:
    - Missing icon files (DefaultIcon.png)
    - Empty modules section in tiapp.xml
    - Outdated SDK version
-5. Report a summary of findings
+6. Report a summary of findings

package/lib/commands/doctor.js

@@ -4,7 +4,7 @@
  */
 
 import chalk from 'chalk';
-import { existsSync, lstatSync, readFileSync, realpathSync } from 'fs';
+import { existsSync, lstatSync, readFileSync } from 'fs';
 import { join } from 'path';
 import os from 'os';
 import {

package/lib/commands/list.js

@@ -16,44 +16,144 @@ import {
 const CHECK = chalk.green('✓');
 const CROSS = chalk.red('✗');
 
+// Two lines of description per skill: enough to tell what a skill is for,
+// short enough that the list stays a list. Everything past that is the
+// skill's trigger text, which is written for the agent, not for this screen.
+const MAX_DESCRIPTION_LINES = 2;
+
+// Descriptions still need room to say something when the window is narrow.
+const MIN_DESCRIPTION_WIDTH = 24;
+
+/**
+ * Unquote a YAML scalar. Most skills here are single-quoted because the
+ * descriptions contain colons and apostrophes; without this, the quote is
+ * printed as part of the text.
+ * @param {string} value - Raw scalar as it appears after `description:`
+ * @returns {string} The value with its wrapping quotes and escapes resolved
+ */
+function unquote(value) {
+  const text = value.trim();
+  const quote = text[0];
+  if ((quote !== "'" && quote !== '"') || !text.endsWith(quote) || text.length < 2) {
+    return text;
+  }
+  const inner = text.slice(1, -1);
+  // In single-quoted YAML an apostrophe is escaped by doubling it.
+  return quote === "'" ? inner.replace(/''/g, "'") : inner.replace(/\\"/g, '"');
+}
+
 /**
- * Extract the skill's human-readable name and short description from SKILL.md.
- * Returns { description, installed } where description is the first sentence of
- * the frontmatter description, trimmed for terminal display.
+ * Wrap text into aligned lines, capped at maxLines with an ellipsis when it
+ * does not fit.
+ * @param {string} text - Text to wrap
+ * @param {number} width - Columns available for the text itself
+ * @param {number} maxLines - Hard cap on the number of lines
+ * @returns {string[]} Lines, none longer than width
  */
-function readSkillMetadata(skillDir) {
-  const skillMd = join(skillDir, 'SKILL.md');
-  if (!existsSync(skillMd)) {
-    return { description: null, installed: false };
+export function wrapDescription(text, width, maxLines = MAX_DESCRIPTION_LINES) {
+  const columns = Math.max(width, MIN_DESCRIPTION_WIDTH);
+  const lines = [];
+  let current = '';
+
+  for (let word of text.split(/\s+/).filter(Boolean)) {
+    // A single word wider than the column (a long URL) is broken by hand;
+    // otherwise the loop below could never place it and would spin.
+    while (word.length > columns) {
+      if (current) {
+        lines.push(current);
+        current = '';
+      }
+      lines.push(word.slice(0, columns));
+      word = word.slice(columns);
+    }
+
+    if (!current) {
+      current = word;
+    } else if (current.length + 1 + word.length <= columns) {
+      current += ` ${word}`;
+    } else {
+      lines.push(current);
+      current = word;
+    }
+  }
+  if (current) lines.push(current);
+
+  if (lines.length <= maxLines) return lines;
+
+  const kept = lines.slice(0, maxLines);
+  let last = kept[maxLines - 1];
+  if (last.length + 1 > columns) {
+    last = last.slice(0, columns - 1).replace(/\s+\S*$/, '');
   }
+  kept[maxLines - 1] = `${last.replace(/[,;:]$/, '')}…`;
+  return kept;
+}
+
+/**
+ * Extract the skill's short description from SKILL.md — the first sentence of
+ * the frontmatter description, unquoted and collapsed to a single line.
+ *
+ * The sentence ends at a period followed by whitespace, which avoids breaking
+ * on "SDK 13." and other version-number periods.
+ * @param {string} frontmatter - The YAML block between the --- fences
+ * @returns {string|null} The description, or null when there is none
+ */
+export function parseDescription(frontmatter) {
+  // The lookahead ends the value at the next top-level key, or at the end of
+  // the block. `(?![\s\S])` rather than `$`, which under the /m flag would
+  // match the first newline and cut a description written across two lines.
+  const descMatch = frontmatter.match(/^description:\s*([\s\S]+?)(?=\n[A-Za-z][\w-]*:|(?![\s\S]))/m);
+  if (!descMatch) return null;
+
+  const full = unquote(descMatch[1]).replace(/\s+/g, ' ').trim();
+  if (!full) return null;
+
+  const firstSentence = full.match(/^([^]*?\.)\s/);
+  if (firstSentence) return firstSentence[1].trim();
+  return full;
+}
 
+/**
+ * Read a description out of one SKILL.md.
+ * @param {string} skillMd - Path to a SKILL.md
+ * @returns {string|null} The first sentence, or null when unreadable
+ */
+function readDescription(skillMd) {
   try {
     const content = readFileSync(skillMd, 'utf8');
     const frontmatter = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!frontmatter) return { description: null, installed: true };
-
-    const descMatch = frontmatter[1].match(/description:\s*"([^"]+)"|description:\s*(.+)/);
-    if (!descMatch) return { description: null, installed: true };
-
-    const full = descMatch[1] || descMatch[2] || '';
-    // First sentence: period followed by whitespace (avoids breaking on "SDK 13."
-    // or other version-number periods). Falls back to a word-safe length cutoff.
-    let short;
-    const firstSentence = full.match(/^([^]*?\.)\s/);
-    if (firstSentence) {
-      short = firstSentence[1];
-    } else if (full.length > 80) {
-      const cut = full.slice(0, 80);
-      short = cut.slice(0, cut.lastIndexOf(' ')) + '…';
-    } else {
-      short = full;
-    }
-    return { description: short.trim(), installed: true };
+    if (!frontmatter) return null;
+    return parseDescription(frontmatter[1]);
   } catch {
-    return { description: null, installed: true };
+    return null;
   }
 }
 
+/**
+ * Read a skill's description, preferring the installed copy and falling back
+ * to the one bundled in this package.
+ *
+ * The fallback is what lets the list describe a skill that is not installed
+ * yet — which is exactly when someone runs `titools list` and needs to know
+ * what they would be installing. `skills/` ships in the npm tarball, so the
+ * bundled copy is there for every install channel.
+ * @param {string} skillDir - Where the skill would be installed
+ * @param {string} name - Skill name, used to find the bundled copy
+ * @returns {{description: string|null, installed: boolean}}
+ */
+function readSkillMetadata(skillDir, name) {
+  const installedMd = join(skillDir, 'SKILL.md');
+  if (existsSync(installedMd)) {
+    return { description: readDescription(installedMd), installed: true };
+  }
+
+  const bundledMd = new URL(`../../skills/${name}/SKILL.md`, import.meta.url);
+  return {
+    description: existsSync(bundledMd) ? readDescription(bundledMd) : null,
+    installed: false,
+  };
+}
+
 export async function listCommand() {
   console.log('');
   console.log(chalk.bold.blue(`Titanium skills (v${PACKAGE_VERSION})`));
@@ -61,21 +161,13 @@ export async function listCommand() {
 
   const skillsDir = getAgentsSkillsDir();
 
-  if (!existsSync(skillsDir)) {
-    console.log(chalk.yellow('No skills installed yet.'));
-    console.log('Install with:');
-    console.log(chalk.cyan('  titools install'));
-    console.log('');
-    return;
-  }
-
   const rows = [];
   let installedCount = 0;
   let maxNameLen = 0;
 
   for (const name of SKILLS) {
     const skillDir = join(skillsDir, name);
-    const { description, installed } = readSkillMetadata(skillDir);
+    const { description, installed } = readSkillMetadata(skillDir, name);
 
     if (installed) installedCount++;
     if (name.length > maxNameLen) maxNameLen = name.length;
@@ -83,18 +175,37 @@ export async function listCommand() {
     rows.push({ name, description, installed });
   }
 
+  // Where the description column starts: '  ' + mark + ' ' + padded name + ' '.
+  // Measured on the plain text, since chalk's colour codes take no columns.
+  const descriptionColumn = 2 + 1 + 1 + (maxNameLen + 2) + 1;
+  const available = (process.stdout.columns || 80) - descriptionColumn;
+
   // Print aligned rows
   for (const row of rows) {
     const mark = row.installed ? CHECK : CROSS;
     const paddedName = row.name.padEnd(maxNameLen + 2);
-    const desc = row.description
-      ? chalk.gray(row.description)
-      : chalk.gray(row.installed ? '(no description)' : 'not installed');
+    const text = row.description || (row.installed ? '(no description)' : 'not installed');
+    const [first, ...rest] = wrapDescription(text, available);
 
-    console.log(`  ${mark} ${chalk.cyan(paddedName)} ${desc}`);
+    console.log(`  ${mark} ${chalk.cyan(paddedName)} ${chalk.gray(first)}`);
+    for (const line of rest) {
+      console.log(`${' '.repeat(descriptionColumn)}${chalk.gray(line)}`);
+    }
   }
 
   console.log('');
+
+  if (installedCount === 0) {
+    // Naming the directory would point at somewhere that does not exist yet.
+    console.log(chalk.gray(`0/${SKILLS.length} installed`));
+    console.log('');
+    console.log(chalk.yellow('No skills installed yet.'));
+    console.log('Install with:');
+    console.log(chalk.cyan('  titools install'));
+    console.log('');
+    return;
+  }
+
   console.log(chalk.gray(`${installedCount}/${SKILLS.length} installed at ${skillsDir}`));
   console.log('');
   console.log(chalk.gray('Run `titools status` for installation health.'));

package/lib/commands/skills.js

@@ -8,7 +8,6 @@ import ora from 'ora';
 import {
   SKILLS,
   getPlatforms,
-  getAgentsSkillsDir,
 } from '../config.js';
 import select from '../prompts/selectCancel.js';
 import checkbox, { Separator } from '../prompts/checkboxCancel.js';
@@ -38,7 +37,6 @@ import { downloadRepoArchive } from '../downloader.js';
 import { createSkillSymlinks } from '../symlink.js';
 import { installHook } from '../hooks.js';
 import {
-  formatList,
   isTitaniumProject,
   readSkillDescription,
   shortenSkillDescription,
@@ -305,7 +303,7 @@ export async function skillsCommand(options) {
     if (!removeOnly) {
       // Install skills
       spinner.start('Installing skills...');
-      const skillsResult = await installSkills(repoDir, baseDir, skillsToInstall);
+      await installSkills(repoDir, baseDir, skillsToInstall);
       spinner.succeed(`${skillsToInstall.length} skill${skillsToInstall.length !== 1 ? 's' : ''} installed`);
 
       // If the user deselected some skills, sweep any previously-installed
@@ -415,7 +413,6 @@ export async function skillsCommand(options) {
           removedCount: symlinkResult.removed.length,
         };
       });
-      const anyRemoved = platformResults.some((result) => result.removedCount > 0);
 
       if (skillsResult.removed.length > 0) {
         console.log(chalk.green('✓'), `${skillsResult.removed.length} skills removed`);

package/lib/commands/status.js

@@ -4,7 +4,7 @@
  */
 
 import chalk from 'chalk';
-import { existsSync, readdirSync, lstatSync, readFileSync } from 'fs';
+import { existsSync, lstatSync, readFileSync } from 'fs';
 import { join } from 'path';
 import os from 'os';
 import {
@@ -14,7 +14,6 @@ import {
   getClaudeAgentsDir,
   getConfigDir,
   getPlatforms,
-  BLOCK_START,
 } from '../config.js';
 import { hasHook } from '../hooks.js';
 import { readLastCheck } from '../cache.js';

package/lib/commands/update.js

@@ -27,7 +27,7 @@ import {
   fetchLatestNpmVersion,
 } from '../downloader.js';
 import { createSkillSymlinks } from '../symlink.js';
-import { formatList, isTitaniumProject } from '../utils.js';
+import { isTitaniumProject } from '../utils.js';
 import { getAgentsSkillsDir } from '../config.js';
 import { existsSync } from 'fs';
 import { join, resolve } from 'path';

package/lib/config.js

@@ -33,6 +33,7 @@ export const SKILLS = [
   'ti-expert',
   'purgetss',
   'ti-ui',
+  'ti-game',
   'ti-api',
   'ti-guides',
   'ti-howtos',

package/lib/installer.js

@@ -7,7 +7,6 @@ import {
   copyFileSync,
   existsSync,
   mkdirSync,
-  readdirSync,
 } from 'fs';
 import { join } from 'path';
 import { remove, copy } from 'fs-extra';

package/lib/prompts/checkboxCancel.js

@@ -49,12 +49,6 @@ function toggle(item) {
   return isSelectable(item) ? { ...item, checked: !item.checked } : item;
 }
 
-function check(checked) {
-  return function (item) {
-    return isSelectable(item) ? { ...item, checked } : item;
-  };
-}
-
 function normalizeChoices(choices) {
   return choices.map((choice) => {
     if (Separator.isSeparator(choice)) return choice;

package/lib/symlink.js

@@ -4,7 +4,7 @@
  */
 
 import { mkdirSync, existsSync } from 'fs';
-import { symlink, readlink, unlink, lstat } from 'fs/promises';
+import { symlink, readlink } from 'fs/promises';
 import { join, dirname, relative } from 'path';
 import { copy, remove } from 'fs-extra';
 import { isWindows } from './platform.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "description": "Titanium SDK skills and agents for AI coding assistants (Claude Code, Gemini CLI, Codex CLI)",
   "main": "lib/index.js",
   "type": "module",
@@ -9,7 +9,7 @@
   },
   "scripts": {
     "test": "node --test test/**/*.test.js",
-    "lint": "eslint lib/**/*.js",
+    "lint": "eslint bin lib test",
     "format": "prettier --write lib/**/*.js"
   },
   "keywords": [
@@ -49,7 +49,9 @@
     "tar": "^7.5.7"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.5",
     "eslint": "^9.39.2",
+    "globals": "^16.5.0",
     "prettier": "^3.8.1"
   },
   "files": [

package/skills/purgetss/SKILL.md

@@ -427,7 +427,8 @@ Load these only when needed:
 - [iOS Large Titles](references/ios-large-titles.md) - Best practice for iOS Large Title navigation
 
 ### App Assets
-- [App Branding](references/app-branding.md) - `brand` command for launcher icons, adaptive, iOS 18+ Dark/Tinted, marketplace assets (v7.6.0)
+- [App Branding](references/app-branding.md) - `brand` command: the 14 pieces it regenerates (launcher, adaptive, iOS 18+ Dark/Tinted, marketplace, both splash sets), the per-piece `brand:` config, `--only`, `--optimize` (v7.13.0)
+- [Launch Background](references/launch-background.md) - Carrying `brand.background` into the iOS LaunchScreen and a launcher-only Android theme (`--notes` output)
 - [Multi-Density Images](references/multi-density-images.md) - `images` command for Android res-*dpi + iPhone @1x/@2x/@3x UI images (v7.6.0)
 - [SVG Pipeline](references/svg-pipeline.md) - SVG-aware compile-time image pipeline: `.svg` refs + numeric `w-*`/`h-*` classes compile to 8 density PNGs; `images.files`/`images.autoSync` (v7.11.0–v7.11.1)
 
@@ -444,7 +445,7 @@ Load these only when needed:
 - [Animation Advanced](references/animation-advanced.md) - Property inheritance, utility classes, implementation rules, complex UI example
 
 ### Release Notes
-- [Version History](references/version-history.md) - Release-by-release feature additions and behavior changes (v7.4.0 → v7.11.1)
+- [Version History](references/version-history.md) - Release-by-release feature additions and behavior changes (v7.4.0 → v7.13.1)
 
 > **💡 TEXT FONTS (Google Fonts, Roboto, etc.)**
 > For text fonts, see [Custom Fonts](references/custom-fonts.md).