v1.1.2

Quartermaster v1.1.2

Quartermaster v1.1.2 brings refined taxonomy classification, calibrated visual concept mining across large scan libraries, clean gallery deduplication, and self-healing index maintenance on startup.

---

⚡ What’s New & Improved in 1.1.2

🌿 Quixel Gallery & Ingest Deduplication

• Single-Media Gallery Ingest: Fixed Fab search parsing to discard redundant multi-resolution thumbnail crops, keeping gallery carousels clean and distinct.
• Corpus Deduplication: Consolidated duplicate catalog ingestion paths to guarantee 1-to-1 asset identity.

🏷️ Expanded 3D Asset Taxonomy

• Rich Surface & Anatomy Vocabulary: Expanded keyword matching across 3D Environments, Characters, Anatomy (skulls, bones, anatomy), Foliage, and Terrain (dirt, mud, clay, quarry).
• Intelligent Scanned Asset Routing: Quixel photogrammetry scans correctly default to 3D Environments & Props rather than falling through to generic utilities.

👁️ Calibrated Visual Concept Mining

• Z-Score Calibration (threshold_z: 2.0): Adjusted the zero-shot outlier gate so concept distributions stay tightly controlled even across homogeneous libraries of 5,000+ scanned surfaces. Top concept share sits at a healthy ~11.4%, eliminating false-positive character tags.

🛠️ Self-Healing Index Maintenance

• Startup Orphan Sweeper: init_db() now automatically cleans dangling search index rows and orphaned image vectors on startup, with full support for shared-cover multi-asset references.
• Preservation Test Coverage: Added automated regression testing for shared-cover vector lifecycles across database restarts.

---

📦 Release Assets

Asset	Platform	Description
Quartermaster-windows-x64.zip	Windows x64	Standalone Windows distribution (Quartermaster.exe + Quartermaster-mcp.exe).
Quartermaster-linux-x64.tar.gz	Linux x64	Standalone Linux distribution (Quartermaster + Quartermaster-mcp).
Quartermaster-Bridge.unitypackage	Cross-Platform	Unity Editor window bridge for in-engine browsing and direct importing.

v1.1.1

Quartermaster v1.1.1

Quartermaster v1.1.1 is a patch release addressing runtime pacing and provenance accuracy for Quixel Megascans catalog sync.

---

⚡ Fixes & Improvements in 1.1.1

• Quixel Sync Runtime Fix: Fixed a NameError on pacing sleep calls during Quixel Megascans & Megaplants catalog synchronization.
• Recommendations Note Alignment: Updated MCP get_stack_recommendations summary note to accurately reflect vault_owned packages vs catalog_grant assets.
• Automatic FTS Orphan Pruning: init_db() now automatically cleans dangling search index rows on startup.
• Vision Pass Expansion: Updated vision image collectors, concept mining, and status reporters in src/vision.py to support all sources (unity, fab, and quixel).

---

📦 Release Assets

Asset	Platform	Description
Quartermaster-windows-x64.zip	Windows x64	Standalone Windows distribution (Quartermaster.exe + Quartermaster-mcp.exe).
Quartermaster-linux-x64.tar.gz	Linux x64	Standalone Linux distribution (Quartermaster + Quartermaster-mcp).
Quartermaster-Bridge.unitypackage	Cross-Platform	Unity Editor window bridge for in-engine browsing and direct importing.

v1.1.0

Quartermaster v1.1.0

Quartermaster v1.1.0 adds Quixel Megascans & Megaplants catalog sync, native Linux standalone distribution, and strict vault provenance labeling.

---

⚡ What’s New in 1.1.0

🌿 Quixel Megascans & Megaplants Sync

• Catalog Stream: Directly stream and index the complete Megascans catalog from Fab with cursor pagination, rate-limit backoff, and polite inter-page pacing.
• 1-Click Sync Button: New 🌿 Sync Quixel button in the Desktop GUI sync panel (or python -m src.store_client sync-quixel via CLI).
• Multimodal Taxonomy: Reclassifies raw scans accurately into Foliage & Nature, Terrain & Landscape, and 3D Environments & Props.
• Full Vector Indexing: BGE text neural embeddings and CLIP visual features across all synced Megascans assets.

🏷️ Vault Provenance & Ownership Separation

• Strict Invariant Guarantee: Preserves the distinction between assets you have already acquired to your library vs 1-click free catalog grants.
• Three Independent Provenance Tiers:
  • source="unity": Unity Asset Store (Owned)
  • source="fab": Fab / Unreal Marketplace (Owned)
  • source="quixel": Quixel Megascans (Catalog Claim)
• MCP Provenance Field: search_owned_assets returns an explicit "ownership" field ("vault_owned" vs "catalog_grant") so AI agents know whether an asset is in your library or requires a 1-click claim.
• Desktop UI Badges: Gold Quixel (Catalog) badge, Blue Fab (Owned) badge, and Green Unity (Owned) badge.

🐧 Native Linux Support

• Standalone Binary: Fully packaged Quartermaster-linux-x64.tar.gz with zero Python or environment setup required.
• XDG Standard Compliance: App data, database, and auth tokens resolve to $XDG_DATA_HOME/quartermaster or ~/.local/share/quartermaster.
• Unity Cache Discovery: Scans ~/.local/share/unity3d/Asset Store-5.x on Linux alongside %APPDATA%/Unity on Windows.
• Dynamic Browser Discovery: Uses $PATH binaries (google-chrome, chromium, microsoft-edge) plus Snap/Flatpak fallback paths.
• Desktop Environment Guard: Automatic fallback for GNOME / Wayland desktop environments lacking a system tray.

---

📦 Release Assets

Asset	Platform	Description
Quartermaster-windows-x64.zip	Windows x64	Standalone Windows distribution (Quartermaster.exe + Quartermaster-mcp.exe).
Quartermaster-linux-x64.tar.gz	Linux x64	Standalone Linux distribution (Quartermaster + Quartermaster-mcp).
Quartermaster-Bridge.unitypackage	Cross-Platform	Unity Editor window bridge for in-engine browsing and direct importing.

Quartermaster v1.0.0

You search your library for a "dam" and get 0 results — even though you own concrete barriers, industrial floodgates, and river water shaders.

Store listings are full of generic marketing copy, packages are opaque archives, and finding what you already own takes longer than building from scratch.

Quartermaster indexes your Unity Asset Store and Fab entitlements alongside local .unitypackage archives and Epic's VaultCache into a local-first vault. It fuses keyword matching with offline text and visual neural embeddings, lints dependencies for pipeline conflicts, and exposes a native MCP interface so AI coding agents understand your actual asset library.

---

⚡ What’s in 1.0.0

🔍 3-Way Hybrid Search (FTS5 + BGE Text + CLIP Vision)

• Keyword Match: BM25 token retrieval across titles, publishers, and descriptions.
• Text Semantic Search: Offline BGE bi-encoder running on CPU to match natural language intent ("concrete structures for holding back water" → bridges, retaining walls, water packs).
• Cross-Modal CLIP Visual Search: Encodes gallery screenshots into CLIP ViT vectors to match visual aesthetics and rendering styles directly.
• LRU Cached Embeddings: Memoized query vectors cut warm end-to-end search latency from ~110 ms down to ~54 ms (~2× speedup).

🧠 Stack Intelligence & Dependency Linter

• Exclusivity Audits: Flags conflicting systems before import (e.g., competing terrain mesh blending shaders, duplicate sky/weather controllers, or conflicting vegetation renderers).
• Product-Family Grouping: Recognizes modular add-on ecosystems (MicroVerse, MicroSplat, Enviro, Gaia) so companion packs group cleanly rather than triggering false-positive conflict warnings.
• Prerequisite Tracking: Warns if an asset requires an uninstalled parent framework.

🤖 Complete Model Context Protocol (MCP) Suite

Exposes 9 tools to local AI agents (Claude Desktop, Cursor, Windsurf, Antigravity):

Tool	Purpose
search_owned_assets	3-way hybrid search across owned vault assets with engine and pipeline filters.
get_asset_details	Full listing metadata, package version, publisher links, and local on-disk paths.
list_asset_categories	Returns the 13 normalized library categories with asset counts.
audit_project	Inspects target Unity project manifests to detect active Render Pipeline (HDRP/URP/Built-in) and installed packages.
validate_stack	Lints a list of candidate asset IDs for exclusivity conflicts and missing prerequisites.
get_stack_recommendations	Maps a natural-language scene brief ("foggy pine valley with river") to compatible owned packs.
list_stack_recipes	Curated production stacks from data/recipes.json, resolved against the assets you actually own.
import_asset_to_project	Extracts .unitypackage archives directly into project folders with path-traversal sandboxing.
get_vault_stats	Totals by engine and category, plus counts of downloaded local assets vs cloud-only entitlements.

🖥️ Native Multi-Surface Interfaces

• Desktop GUI (Quartermaster): Responsive dark-mode desktop app with non-blocking async search threads, instant debounced queries, and global tray hotkey (Win+Alt+V on Windows).
• Console MCP Binary (Quartermaster-mcp): Dedicated stdio JSON-RPC binary with clean stderr stream handling. Run --register for instant one-command client discovery.
• Unity Editor Bridge (Quartermaster-Bridge.unitypackage): Search, browse, and import directly inside the Unity Editor.
• Localhost Web Dashboard (http://localhost:7890): Fast web UI hardened with SameSite cookies, CSRF defense, and subresource origin verification.

---

📦 Release Assets

Asset	Platform	Description
Quartermaster-windows-x64.zip	Windows x64	Standalone Windows distribution with Quartermaster.exe and Quartermaster-mcp.exe. Zero Python environment required.
Quartermaster-linux-x64.tar.gz	Linux x64	Standalone Linux distribution with Quartermaster and Quartermaster-mcp. Zero Python environment required.
Quartermaster-Bridge.unitypackage	Cross-Platform	Unity Editor window bridge for in-engine asset browsing and direct importing.

---

🚀 Quick Start (Standalone Binary)

Windows

1. Extract Quartermaster-windows-x64.zip.
2. Register the MCP server: .\Quartermaster-mcp.exe --register
3. Launch Quartermaster.exe.

Linux

1. Extract Quartermaster-linux-x64.tar.gz:

   tar -xzvf Quartermaster-linux-x64.tar.gz
   cd Quartermaster

2. Register the MCP server: ./Quartermaster-mcp --register
3. Launch ./Quartermaster.

---

🔒 Security & Local Data Model

• Local Data Storage: Database, auth tokens, logs, browser profiles, and image cache live in %LOCALAPPDATA%\Quartermaster (Windows) or ~/.local/share/quartermaster (Linux).
• Neural Model Weights: ONNX models are cached in standard user directories (~/.cache).
• Interactive Store Auth: Store logins execute in a standard browser window with your own MFA — zero automated credential scraping.
• Extraction Sandbox: import_asset_to_project enforces strict path traversal protection (../ stripping, absolute path normalization, control character rejection).