Enhance character setup and shop cosmetics functionality

[kiyarose]

This pull request introduces significant improvements to the character customization system, enhances asset syncing workflows, and adds support for shop cosmetics in the application. The main themes are new character customization features, improvements to asset management, UI updates to integrate character features, and documentation for both character and shop systems.

Summary of most important changes:
The release adds a desk character customization system, including new database schema and UI routes, and integrates character display throughout the app. Asset syncing is updated to handle character SVGs and regenerate manifests automatically. A new in-app shop system is documented, and supporting scripts and documentation are provided for both features.

---

Character Customization System

• Added a new character customization system, including a singleton characterAppearance table in the Dexie database (src/db/schema.ts), a /character-lab route, and UI components for character display and editing throughout the app (src/App.tsx, src/features/character/CharacterCorner.tsx). [1] [2] [3] [4] [5] [6] [7] [8] [9]
• Added a comprehensive guide for character customization and animation iteration, detailing source files, control conventions, and recommended validation flows (docs/CHARACTER_CUSTOMIZATION.md).

Asset Management Improvements

• Updated the asset sync script to copy character SVGs from asset/char/ to public/asset/char/ and automatically regenerate the character manifest after syncing assets (scripts/sync-assets.mjs). [1] [2]
• Updated documentation to clarify the asset sync process for character SVGs and manifest generation, and to reference the new customization features in the main agent/asset documentation (AGENTS.md).

Shop System Documentation

• Added a new asset/shop/README.md documenting the JSON schema, asset contracts, and workflow for the in-app Shoppe item catalog, including support for themes, stamps, cursors, and images.

UI Integration and Cosmetic Effects

• Integrated character display into main layouts and navigation, including the use of DeskCharacterLayout, CharacterNavIcon, and cosmetic effects for shop items throughout the app (src/App.tsx). [1] [2] [3] [4]

Version and Script Updates

• Bumped the application version to 1.9.5 and updated package.json scripts to include a new pose:lab command for character pose iteration (VERSION, package.json). [1] [2]