@weppy/roblox-mcp 2.6.4 → 2.7.1

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-    "version": "2.6.4"
+    "version": "2.7.1"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
-      "version": "2.6.4",
+      "version": "2.7.1",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 
 
+## [2.7.1] - 2026-05-05
+
+### Improvements
+
+- **Stability hardening** — Internal reliability improvements across the MCP server and Roblox Studio plugin. No behavior changes for existing workflows.
+
+## [2.7.0] - 2026-05-05
+
+### Features
+
+- **UI Studio launch** — A new workflow for iterating on Roblox Studio UI design together with an AI agent. From the UI Studio page in the dashboard, you can now use:
+  - **History tab** — Compare before/after snapshots and design suggestions for each request, side by side.
+  - **Analysis tab** — Snapshot comparison modal with batch selection and deletion.
+  - **Design Check** — Reviews your UI against design quality criteria and surfaces concrete improvements.
+
+### Improvements
+
+- **More accurate property types when syncing local edits back to Studio** — When you edit synced files locally and push the changes back to Studio, the server now resolves property types via class-aware metadata instead of guessing from value shape. Edits to enum, color, or vector properties on specific instances are no longer silently saved as the wrong type.
+
+### Bug Fixes
+
+- **Claude Code detection on Windows** — On Windows, Claude Code could be mis-detected and even a fresh install would fail with a confusing "already exists" error. Detection is now correct, and an existing valid registration is treated as success.
+
+- **Dashboard tooltips no longer clipped** — Tooltips inside scrollable areas (Settings, UI Studio history) were being cut off. They now display in full regardless of the surrounding container.
 
 
 

package/README.md

@@ -2,7 +2,7 @@
 
 > **WEPPY** is an MCP server that lets AI coding agents control a live Roblox Studio session - create and edit scripts, instances, terrain, lighting, assets, audio, and animations through natural language.
 
-**Action-based tool surface · Bidirectional sync · Automated playtest · Multi-place support**
+**Action-based tool surface · Bidirectional sync · Automated playtest · UI Studio · Multi-place support**
 
 **English** | [한국어](https://weppyai.com/ko) | [日本語](https://weppyai.com/ja) | [Español](https://weppyai.com/es) | [Português](https://weppyai.com/pt-br) | [Bahasa Indonesia](https://weppyai.com/id) | [Deutsch](https://weppyai.com/de)
 
@@ -87,7 +87,7 @@ AI works from a synchronized local mirror, so multi-file updates stay consistent
 - Basic: one-way sync (Studio -> Local)
 - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
 
-![Sync workflow - Studio and local files synchronized in real time](docs/assets/screenshots/plugin/sync/sync-overview.png)
+![Sync workflow - Studio and local files synchronized in real time](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/plugin/sync/sync-overview.png)
 
 ### 3) Playtest: Let AI run and verify tests automatically
 
@@ -97,19 +97,29 @@ AI can control Roblox Studio playtests directly. It can start and stop Play (F5)
 - "Write a test that verifies the SpawnLocation is above the ground and run it."
 - "Validate that the script I just changed runs without errors in playtest."
 
-![WEPPY Playtest Dashboard - Test history and detailed report](docs/assets/screenshots/dashboard/dashboard_playtest.png)
+![WEPPY Playtest Dashboard - Test history and detailed report](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_playtest.png)
 
-### 4) WEPPY Dashboard: Monitor AI work in real time
+### 4) UI Studio: Build and inspect in-game UI
 
-The MCP server provides a web dashboard where you can check connection status, tool execution history, sync state, and game change logs in real time.
+UI Studio lets AI agents create in-game UI that matches your game's style, or analyze the UI you already have and suggest improvements.
+
+- Clarify the UI goal with guided questions about purpose, screen, target devices, and visual direction
+- Create or refine game-style menus, HUDs, buttons, labels, image panels, and other Roblox UI elements directly in Studio
+- Capture the result, compare before/after changes, and follow dashboard suggestions for layout, readability, touch targets, and safe areas
+
+![WEPPY UI Studio - Roblox Studio showing AI-generated in-game UI](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_ui_roblox_studio.png)
+
+### 5) WEPPY Dashboard: Monitor AI work in real time
+
+The MCP server provides a web dashboard where you can check connection status, tool execution history, sync state, UI Studio history, and game change logs in real time.
 
 - Server/Plugin/Agent connection status at a glance
 - Compare every change the AI made via Before & After in Changelog
-- Analyze workflow with tool execution history and statistics
+- Analyze workflow with tool execution history, UI Studio captures, and statistics
 
-![WEPPY Dashboard Overview - Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY Dashboard Overview - Server status, recent changes, and session summary](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_overview.png)
 
-### 5) WEPPY Roblox Explorer: Browse Studio hierarchy in VSCode
+### 6) WEPPY Roblox Explorer: Browse Studio hierarchy in VSCode
 
 View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status - all without switching to Studio.
 WEPPY Roblox Explorer is a companion VSCode extension for sync data generated by WEPPY. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
@@ -119,13 +129,14 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
 - Click to open synced scripts and property files
 - Multi-place support with sync status indicators
 
-![WEPPY Roblox Explorer - Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer - Studio instance tree displayed in VSCode sidebar](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Use Cases
 
 - **Rapid prototyping**: Describe a game mechanic in natural language and watch AI build it in Studio
 - **Bulk refactoring**: Rename a module interface and update every dependent script in one request
 - **Terrain & environment**: Generate procedural terrain, set lighting/atmosphere, place assets - all from a single prompt
+- **UI design**: Generate in-game UI, capture previews, and iterate on Design Check suggestions
 - **Multi-file consistency**: AI reads the full project via Sync and applies changes across related scripts together
 - **Asset integration**: Search the Creator Store, insert models, and configure properties without leaving your editor
 
@@ -161,7 +172,7 @@ Yes. Any MCP-compatible AI client works.
 Yes. AI can create instances, write scripts, generate terrain, set up lighting, insert assets, configure physics, and more - all inside a live Roblox Studio session. It goes beyond code generation to executable actions.
 
 ### What is the difference between Basic and Pro?
-Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the Pro upgrade page.
+Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, UI Studio, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the Pro upgrade page.
 
 ### How is Weppy different from other Roblox MCP servers?
 Weppy uses action-based dispatching instead of separate tools for each function. This reduces AI token consumption significantly. It also provides bidirectional project sync and multi-place support, which most alternatives lack.
@@ -171,7 +182,7 @@ The server runs on localhost only (127.0.0.1:3002). Forbidden paths (CoreGui, Co
 
 ## Pro Upgrade
 
-Bidirectional Sync, advanced build capabilities, and AI token efficiency - all in one upgrade.
+Bidirectional Sync, UI Studio, advanced build capabilities, and AI token efficiency - all in one upgrade.
 
 [Pro Upgrade Guide](https://weppyai.com/en/plans)
 

package/install.ps1

@@ -112,7 +112,18 @@ function Test-McpJsonConfigured($configPath) {
     }
 }
 
-# Antigravity 설정에 canonical mcpServers 래퍼로 MCP 서버를 추가하고 legacy flat key를 정리
+# Require an explicit `@<tag>` so the installer can upgrade legacy bare
+# entries (`@weppy/roblox-mcp`) — those reuse npx cache and trap users on
+# outdated versions. Tagged entries (`@latest`, `@2.6.4`, …) are preserved.
+function Test-WeppyPackageSpec($value) {
+    if ([string]::IsNullOrWhiteSpace($value)) {
+        return $false
+    }
+    return $value -match '^@weppy/roblox-mcp@.+$'
+}
+
+# Add the MCP server under the canonical `mcpServers` wrapper in the Antigravity
+# config and strip any legacy flat key left over from earlier versions.
 function Add-AntigravityMcpConfig($configPath) {
     $parentDir = Split-Path $configPath -Parent
     if (-not (Test-Path $parentDir)) { New-Item -ItemType Directory -Path $parentDir -Force | Out-Null }
@@ -134,7 +145,7 @@ const next = { ...config };
 delete next['weppy-roblox-mcp'];
 next.mcpServers = {
   ...(mcpServers || {}),
-  'weppy-roblox-mcp': { command: 'npx', args: ['-y', '@weppy/roblox-mcp'] }
+  'weppy-roblox-mcp': { command: 'npx', args: ['-y', '@weppy/roblox-mcp@latest'] }
 };
 config = next;
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
@@ -153,7 +164,8 @@ function Test-AntigravityMcpConfigured($configPath) {
         $config = Get-Content -Path $configPath -Raw | ConvertFrom-Json
         $hasLegacyFlatKey = $config.PSObject.Properties.Name -contains 'weppy-roblox-mcp'
         $server = $config.mcpServers.'weppy-roblox-mcp'
-        $hasCanonicalArgs = ($server.args -is [System.Array]) -and ($server.args.Count -eq 2) -and ($server.args[0] -eq '-y') -and ($server.args[1] -eq '@weppy/roblox-mcp')
+        # Accept args[1] as the weppy package regardless of whether a version tag is appended.
+        $hasCanonicalArgs = ($server.args -is [System.Array]) -and ($server.args.Count -eq 2) -and ($server.args[0] -eq '-y') -and (Test-WeppyPackageSpec $server.args[1])
         return ($server.command -eq 'npx') -and $hasCanonicalArgs -and (-not $hasLegacyFlatKey)
     }
     catch {
@@ -174,7 +186,8 @@ const fs = require('fs');
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
 const serverName = 'weppy-roblox-mcp';
 const expectedCommand = 'npx';
-const expectedArgs = ['-y', '@weppy/roblox-mcp'];
+// Require an explicit `@<tag>` so the installer can upgrade legacy bare entries.
+const packageSpecPattern = /^@weppy\/roblox-mcp@.+$/;
 const headerPattern = new RegExp(
   '^\\s*\\[\\s*mcp_servers\\.' + serverName.replace(/[.*+?^${}()|[\]\\\\]/g, '\\$&') + '\\s*\\]\\s*(?:#.*)?$'
 );
@@ -568,8 +581,10 @@ try {
     !parsed.hasConflict &&
     parsed.command === expectedCommand &&
     Array.isArray(parsed.args) &&
-    parsed.args.length === expectedArgs.length &&
-    parsed.args.every((entry, index) => entry === expectedArgs[index]);
+    parsed.args.length === 2 &&
+    parsed.args[0] === '-y' &&
+    typeof parsed.args[1] === 'string' &&
+    packageSpecPattern.test(parsed.args[1]);
 
   process.exit(isConfigured ? 0 : 1);
 } catch {
@@ -595,7 +610,7 @@ const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf8')); } catch {}
 if (!config.mcpServers) config.mcpServers = {};
-config.mcpServers['weppy-roblox-mcp'] = { command: 'npx', args: ['-y', '@weppy/roblox-mcp'] };
+config.mcpServers['weppy-roblox-mcp'] = { command: 'npx', args: ['-y', '@weppy/roblox-mcp@latest'] };
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
 "@
     } finally {
@@ -627,7 +642,7 @@ catch {
 # ═══════════════════════════════════
 Write-Step "1/2" "Setup Roblox Studio Plugin"
 
-if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
+if (Confirm-Action "  Run npx -y @weppy/roblox-mcp@latest --setup?") {
     try {
         $npmCommandPath = Resolve-NpmCommand
         $npmDir = Split-Path $npmCommandPath -Parent
@@ -641,9 +656,11 @@ if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
         try {
             New-Item -ItemType Directory -Path $setupWorkingDir -Force | Out-Null
             Set-Location $setupWorkingDir
-            # stdin을 빈 파이프로 격리: irm|iex 대화형 모드에서 stdio MCP 서버가
-            # pwsh의 터미널 stdin을 상속받아 hang되는 문제를 방지한다
-            $null | & $npxPath -y @weppy/roblox-mcp --setup
+            # Isolate stdin with an empty pipe so the stdio MCP server does not inherit
+            # the interactive pwsh terminal stdin (which would cause it to hang under irm|iex).
+            # The @latest tag forces npx to resolve from the registry instead of
+            # reusing an older version pinned in the npm cache.
+            $null | & $npxPath -y "@weppy/roblox-mcp@latest" --setup
             if ($LASTEXITCODE -ne 0) {
                 Write-Warn "Setup encountered a warning (non-blocking)"
             } else {
@@ -675,9 +692,30 @@ $notDetected = @()
 
 $claudeProjectConfig = Join-Path (Get-Location).Path '.mcp.json'
 $claudeGlobalConfig = Join-Path $env:USERPROFILE '.claude\mcp.json'
-$claudeCodeConfigured = (Test-McpJsonConfigured $claudeProjectConfig) -or (Test-McpJsonConfigured $claudeGlobalConfig)
 $claudeCodeCliCommand = Resolve-OptionalCliCommand 'claude'
 
+# `claude mcp add` stores entries under ~/.claude.json or in local/user scope,
+# so prefer `claude mcp list` as the source of truth when the CLI is available
+# (the JSON path checks remain as a fallback). The entry counts as configured
+# only when its args carry an explicit `@<tag>` — legacy bare entries fall
+# through and get re-registered with the canonical `@latest` form.
+function Test-ClaudeCliConfigured($cliCommand) {
+    if (-not $cliCommand) { return $false }
+    try {
+        $listOutput = & $cliCommand mcp list 2>$null
+        if ($LASTEXITCODE -ne 0) { return $false }
+        $line = $listOutput | Select-String -Pattern '^weppy-roblox-mcp:' | Select-Object -First 1
+        if (-not $line) { return $false }
+        return ($line.Line -match '@weppy/roblox-mcp@')
+    } catch {
+        return $false
+    }
+}
+
+$claudeCodeConfigured = (Test-ClaudeCliConfigured $claudeCodeCliCommand) `
+    -or (Test-McpJsonConfigured $claudeProjectConfig) `
+    -or (Test-McpJsonConfigured $claudeGlobalConfig)
+
 if ($claudeCodeConfigured) {
     $detectedNames += 'Claude Code (configured)'
     $detectedTypes += 'claude-code'
@@ -762,7 +800,7 @@ else {
 
 if ($detectedNames.Count -eq 0) {
     Write-Warn "No AI apps detected"
-    Write-Info "Register MCP server manually: npx -y @weppy/roblox-mcp"
+    Write-Info "Register MCP server manually: npx -y @weppy/roblox-mcp@latest"
 }
 else {
     Write-Host ""
@@ -816,12 +854,40 @@ else {
                         Write-Ok "Already configured: $appName"
                     }
                     elseif ($claudeCodeCliCommand) {
-                        & $claudeCodeCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp"
-                        if ($LASTEXITCODE -ne 0) {
-                            # CLI 실패 시 (Windows에서 -- 파싱 문제 등) JSON config에 직접 쓰기로 폴백
-                            Add-McpToConfig $claudeGlobalConfig
+                        $claudeStderrFile = Join-Path ([System.IO.Path]::GetTempPath()) ("weppy-claude-{0}.err" -f ([System.Guid]::NewGuid().ToString("N")))
+                        try {
+                            # Best-effort remove any legacy bare entry so the subsequent add can
+                            # install the canonical `@latest` form.
+                            try { & $claudeCodeCliCommand mcp remove weppy-roblox-mcp *> $null } catch {}
+                            & $claudeCodeCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2> $claudeStderrFile
+                            $claudeExit = $LASTEXITCODE
+                            if ($claudeExit -eq 0) {
+                                Write-Ok "Registered: $appName"
+                            }
+                            else {
+                                $stderrContent = if (Test-Path $claudeStderrFile) { Get-Content $claudeStderrFile -Raw } else { '' }
+                                if ($stderrContent -match '(?i)already exists') {
+                                    # Already registered in another scope — not a failure
+                                    Write-Ok "Already configured: $appName"
+                                }
+                                else {
+                                    Write-Fail "Failed: $appName (exit=$claudeExit)"
+                                    Write-Host "    CLI: $claudeCodeCliCommand" -ForegroundColor DarkGray
+                                    if ($stderrContent) {
+                                        Write-Host "    stderr:" -ForegroundColor DarkGray
+                                        $stderrContent.TrimEnd("`r","`n").Split("`n") | ForEach-Object {
+                                            Write-Host "      $($_.TrimEnd())" -ForegroundColor DarkGray
+                                        }
+                                    }
+                                    # Fall back to writing the JSON config directly when the CLI fails for other reasons
+                                    Add-McpToConfig $claudeGlobalConfig
+                                    Write-Ok "Registered via fallback JSON: $appName"
+                                }
+                            }
+                        }
+                        finally {
+                            Remove-Item $claudeStderrFile -ErrorAction SilentlyContinue
                         }
-                        Write-Ok "Registered: $appName"
                     }
                     else {
                         Write-Fail "Failed: $appName (CLI/config unavailable)"
@@ -842,7 +908,7 @@ else {
                     }
                     elseif ($codexCliCommand) {
                         try { & $codexCliCommand mcp remove weppy-roblox-mcp *> $null } catch {}
-                        & $codexCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp"
+                        & $codexCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest"
                         if ($LASTEXITCODE -ne 0) {
                             throw 'codex mcp add failed'
                         }

package/install.sh

@@ -98,7 +98,7 @@ const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
 if (!config.mcpServers) config.mcpServers = {};
-config.mcpServers["weppy-roblox-mcp"] = { command: "npx", args: ["-y", "@weppy/roblox-mcp"] };
+config.mcpServers["weppy-roblox-mcp"] = { command: "npx", args: ["-y", "@weppy/roblox-mcp@latest"] };
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 '
 }
@@ -142,7 +142,7 @@ const next = { ...config };
 delete next["weppy-roblox-mcp"];
 next.mcpServers = {
   ...(mcpServers || {}),
-  "weppy-roblox-mcp": { command: "npx", args: ["-y", "@weppy/roblox-mcp"] }
+  "weppy-roblox-mcp": { command: "npx", args: ["-y", "@weppy/roblox-mcp@latest"] }
 };
 config = next;
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
@@ -161,13 +161,17 @@ function isJsonObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function hasExpectedCommandShape(value) {
+  // Require an explicit `@<tag>` so the installer can upgrade legacy bare
+  // entries (`@weppy/roblox-mcp`) — those reuse npx cache and trap users on
+  // outdated versions. Tagged entries (`@latest`, `@2.6.4`, …) are preserved.
   return (
     isJsonObject(value) &&
     value.command === "npx" &&
     Array.isArray(value.args) &&
     value.args.length === 2 &&
     value.args[0] === "-y" &&
-    value.args[1] === "@weppy/roblox-mcp"
+    typeof value.args[1] === "string" &&
+    /^@weppy\/roblox-mcp@.+$/.test(value.args[1])
   );
 }
 try {
@@ -191,7 +195,8 @@ const fs = require("fs");
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
 const serverName = "weppy-roblox-mcp";
 const expectedCommand = "npx";
-const expectedArgs = ["-y", "@weppy/roblox-mcp"];
+// Require an explicit `@<tag>` so the installer can upgrade legacy bare entries.
+const packageSpecPattern = /^@weppy\/roblox-mcp@.+$/;
 const headerPattern = new RegExp(
   "^\\s*\\[\\s*mcp_servers\\." + serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\s*\\]\\s*(?:#.*)?$",
 );
@@ -585,8 +590,10 @@ try {
     !parsed.hasConflict &&
     parsed.command === expectedCommand &&
     Array.isArray(parsed.args) &&
-    parsed.args.length === expectedArgs.length &&
-    parsed.args.every((entry, index) => entry === expectedArgs[index]);
+    parsed.args.length === 2 &&
+    parsed.args[0] === "-y" &&
+    typeof parsed.args[1] === "string" &&
+    packageSpecPattern.test(parsed.args[1]);
 
   process.exit(isConfigured ? 0 : 1);
 } catch {
@@ -640,7 +647,7 @@ success "Node.js $(node -v) detected"
 # ═══════════════════════════════════
 step "1/2" "Setup Roblox Studio Plugin"
 
-if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
+if confirm "  Run npx -y @weppy/roblox-mcp@latest --setup?"; then
   setup_tmp_dir=""
   if setup_tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/weppy-setup-XXXXXX" 2>/dev/null); then
     :
@@ -651,7 +658,9 @@ if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
   if [ -n "${setup_tmp_dir:-}" ] && [ -d "$setup_tmp_dir" ]; then
     # stdin을 /dev/null로 격리: curl|bash 파이프 모드에서 stdio MCP 서버가
     # bash의 남은 스크립트 바이트를 소비해버리는 문제를 방지한다
-    if (cd "$setup_tmp_dir" && npx -y @weppy/roblox-mcp --setup </dev/null); then
+    # The @latest tag forces npx to resolve from the registry instead of
+    # reusing an older version pinned in the npm cache.
+    if (cd "$setup_tmp_dir" && npx -y "@weppy/roblox-mcp@latest" --setup </dev/null); then
       success "Setup complete"
     else
       warn "Setup encountered a warning (non-blocking)"
@@ -671,7 +680,7 @@ fi
 step "2/2" "Register MCP with AI apps"
 printf "  Automatic registration: Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity\n"
 
-MCP_COMMAND='npx -y @weppy/roblox-mcp'
+MCP_COMMAND='npx -y @weppy/roblox-mcp@latest'
 
 # AI app detection
 declare -a DETECTED_NAMES=()
@@ -679,11 +688,25 @@ declare -a DETECTED_TYPES=()
 declare -a NOT_DETECTED=()
 
 # Claude Code
+# `claude mcp add` stores entries under ~/.claude.json or in local/user scope,
+# so prefer `claude mcp list` as the source of truth when the CLI is available
+# (the JSON path checks remain as a fallback).
 CLAUDE_PROJECT_MCP_CONFIG="$PWD/.mcp.json"
 CLAUDE_GLOBAL_MCP_CONFIG="$HOME/.claude/mcp.json"
 CLAUDE_CLI_COMMAND="$(resolve_optional_cli_command claude 2>/dev/null || true)"
 
-if is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
+is_claude_cli_configured() {
+  [ -n "$CLAUDE_CLI_COMMAND" ] || return 1
+  # The entry counts as configured only when its args carry an explicit `@tag`
+  # (e.g. `@latest`). Legacy bare entries fall through and get re-registered.
+  "$CLAUDE_CLI_COMMAND" mcp list 2>/dev/null \
+    | grep "^weppy-roblox-mcp:" \
+    | grep -q "@weppy/roblox-mcp@"
+}
+
+if is_claude_cli_configured \
+   || is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" \
+   || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
   DETECTED_NAMES+=("Claude Code (configured)")
   DETECTED_TYPES+=("claude-code")
 elif [ -n "$CLAUDE_CLI_COMMAND" ]; then
@@ -816,12 +839,34 @@ else
 
     case "$app_type" in
       claude-code)
-        if is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
+        if is_claude_cli_configured \
+           || is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" \
+           || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
           success "Already configured: $app_name"
-        elif [ -n "$CLAUDE_CLI_COMMAND" ] && "$CLAUDE_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp 2>/dev/null; then
-          success "Registered: $app_name"
+        elif [ -n "$CLAUDE_CLI_COMMAND" ]; then
+          claude_stderr_file=$(mktemp "${TMPDIR:-/tmp}/weppy-claude-XXXXXX.err" 2>/dev/null || echo "${HOME}/weppy-claude.err")
+          # Best-effort remove any legacy bare entry so the subsequent add can
+          # install the canonical `@latest` form. Ignore errors when nothing
+          # exists.
+          "$CLAUDE_CLI_COMMAND" mcp remove weppy-roblox-mcp >/dev/null 2>&1 || true
+          # Capture the CLI exit code immediately so it isn't overwritten by the
+          # subsequent grep check (which would otherwise leak its own exit code).
+          claude_exit_code=0
+          "$CLAUDE_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2>"$claude_stderr_file" || claude_exit_code=$?
+          if [ "$claude_exit_code" -eq 0 ]; then
+            success "Registered: $app_name"
+          elif grep -qi "already exists" "$claude_stderr_file"; then
+            # Already registered in another scope — not a failure
+            success "Already configured: $app_name"
+          else
+            fail "Failed: $app_name (exit=$claude_exit_code)"
+            printf "    CLI: %s\n" "$CLAUDE_CLI_COMMAND"
+            printf "    stderr:\n"
+            sed 's/^/      /' "$claude_stderr_file" || true
+          fi
+          rm -f "$claude_stderr_file"
         else
-          fail "Failed: $app_name"
+          fail "Failed: $app_name (claude CLI not found)"
         fi
         ;;
       claude-desktop)
@@ -846,7 +891,7 @@ else
         fi
         if is_codex_config_configured "$CODEX_CONFIG"; then
           :
-        elif [ -n "$CODEX_CLI_COMMAND" ] && "$CODEX_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp 2>/dev/null; then
+        elif [ -n "$CODEX_CLI_COMMAND" ] && "$CODEX_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2>/dev/null; then
           success "Registered: $app_name"
         elif is_codex_config_configured "$CODEX_CONFIG"; then
           success "Already configured: $app_name"

package/llms-full.txt

@@ -1,6 +1,6 @@
 # WEPPY — Canonical Web Docs
 
-> WEPPY is an MCP server that lets AI coding agents control a live Roblox Studio session and interact with scripts, instances, terrain, lighting, assets, audio, and animations.
+> WEPPY is an MCP server that lets AI coding agents control a live Roblox Studio session and interact with scripts, instances, terrain, lighting, assets, audio, animations, and UI Studio workflows.
 
 This package intentionally does not ship a standalone full documentation surface.
 
@@ -11,4 +11,3 @@ Canonical documentation lives on the web:
 - Pro plans: https://weppyai.com/en/plans
 
 For app-specific setup, open the web install page and choose the relevant AI client guide.
-

package/llms.txt

@@ -2,7 +2,7 @@
 
 > WEPPY is an MCP server that lets AI coding agents (Claude, Codex,
 > Cursor, Gemini) control a live Roblox Studio session — create and edit scripts,
-> instances, terrain, lighting, assets, audio, and animations via natural language.
+> instances, terrain, lighting, assets, audio, animations, and UI Studio workflows via natural language.
 
 ## What it does
 
@@ -14,6 +14,7 @@ terrain, and more — inside a live Studio session.
 - Action-based MCP tools covering the full Roblox Studio API surface
 - Bidirectional project sync between Roblox Studio and local files (Pro)
 - Automated playtest: AI starts/stops Play/Run, injects test scripts, collects logs
+- UI Studio: AI creates in-game UI that matches your game's style or analyzes existing UI and suggests improvements
 - Web dashboard: monitor AI actions, tool history, sync state, and changelog in real time at `http://localhost:3002`
 - Multi-place support (up to 3 places simultaneously)
 - Roblox Explorer VSCode extension for browsing Studio hierarchy
@@ -40,7 +41,7 @@ Safari / Firefox users should open the web install page and follow the browser-s
 ## Tiers
 
 - Basic (Free): MCP tool execution + one-way Studio -> Local sync
-- Pro: Bidirectional sync, bulk actions, terrain generation, spatial analysis, multi-place support, advanced tools
+- Pro: Bidirectional sync, UI Studio, bulk actions, terrain generation, spatial analysis, multi-place support, advanced tools
 
 ## Detailed docs
 
@@ -56,7 +57,7 @@ Safari / Firefox users should open the web install page and follow the browser-s
 ## Optional
 
 - Roblox Explorer VSCode extension (browse synced instance tree)
-- Pro subscription for bidirectional sync and advanced tools
+- Pro subscription for bidirectional sync, UI Studio, and advanced tools
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.6.4",
+  "version": "2.7.1",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "2.6.4",
+  "version": "2.7.1",
   "author": {
     "name": "hope1026"
   },

package/plugins/weppy-roblox-mcp/dashboard/dist/assets/{ChangelogDetailPage-DYQthxhC.js → ChangelogDetailPage-DxktONbL.js}

@@ -1 +1 @@
-import{r,a as R,u as M,b as B,c as V,j as e}from"./index-B-nqZCE3.js";import{I as G}from"./InfoLabel-CMSu30c4.js";import{G as D}from"./GameChangeDetail-DGphCFbI.js";import{T as m}from"./TooltipText-Bnvm1FcC.js";function F(n){const s={scriptsModified:0,scriptsCreated:0,instancesCreated:0,instancesDeleted:0,instancesMoved:0,propertiesChanged:0,lightingChanged:!1,terrainChanged:!1,assetsInserted:0};for(const l of n)switch(l.category){case"script":l.changeType==="create"?s.scriptsCreated++:s.scriptsModified++;break;case"instance":l.changeType==="create"?s.instancesCreated++:l.changeType==="delete"?s.instancesDeleted++:l.changeType==="move"&&s.instancesMoved++;break;case"property":s.propertiesChanged++;break;case"lighting":s.lightingChanged=!0;break;case"terrain":s.terrainChanged=!0;break;case"asset":s.assetsInserted++;break}return s}function P(n){const[s,l]=r.useState(""),[a,d]=r.useState(""),[u,q]=r.useState(),[w,y]=r.useState("completed"),[I,E]=r.useState([]),[L,O]=r.useState([]),[x,f]=r.useState([]),[p,_]=r.useState(),[j,b]=r.useState(),[v,S]=r.useState(),[C,N]=r.useState({scriptsModified:0,scriptsCreated:0,instancesCreated:0,instancesDeleted:0,instancesMoved:0,propertiesChanged:0,lightingChanged:!1,terrainChanged:!1,assetsInserted:0}),[T,g]=r.useState(!0),[k,h]=r.useState(null),i=r.useCallback(async()=>{if(n){g(!0),h(null);try{const[c,o]=await Promise.all([R.get(`/api/dashboard/changelog/${n}`),R.get(`/api/dashboard/changelog/${n}/changes`)]);l(c.entryId),d(c.startTime),q(c.endTime),y(c.status),E(c.entries),O(c.failures),_(c.contextSummary),b(c.replayMetadata),S(c.verificationSummary),f(o.changes),N(F(o.changes))}catch(c){h(c instanceof Error?c.message:"Failed to load changelog detail")}finally{g(!1)}}},[n]);return r.useEffect(()=>{i()},[i]),{entryId:s,startTime:a,endTime:u,status:w,entries:I,failures:L,changes:x,changeSummary:C,contextSummary:p,replayMetadata:j,verificationSummary:v,loading:T,error:k,refresh:i}}const U={script:"📝",instance:"🧱",property:"🎨",lighting:"🌅",terrain:"⛰️",asset:"📦"};function H(n){return U[n]??"❓"}const W="_page_q2jbi_2",Y="_header_q2jbi_10",z="_backLink_q2jbi_16",J="_headerTitle_q2jbi_29",Q="_headerTime_q2jbi_37",X="_statusActive_q2jbi_44",Z="_statusCompleted_q2jbi_49",ee="_section_q2jbi_54",te="_sectionTitle_q2jbi_61",ne="_summaryGrid_q2jbi_74",ae="_summaryCard_q2jbi_80",ie="_summaryCardActive_q2jbi_94",se="_summaryIcon_q2jbi_99",ce="_summaryCount_q2jbi_105",re="_summaryLabel_q2jbi_112",oe="_contextGrid_q2jbi_121",le="_contextRow_q2jbi_127",de="_contextKey_q2jbi_133",me="_contextValue_q2jbi_141",ge="_timelineFilter_q2jbi_149",he="_filterLabel_q2jbi_156",ue="_filterSelect_q2jbi_162",ye="_timeline_q2jbi_149",xe="_timelineEntry_q2jbi_182",fe="_timelineTime_q2jbi_199",pe="_timelineIcon_q2jbi_207",_e="_timelineBody_q2jbi_212",je="_timelineSummary_q2jbi_217",be="_timelineTarget_q2jbi_224",ve="_timelineConfidence_q2jbi_231",Se="_confidenceExact_q2jbi_240",Ce="_confidencePartial_q2jbi_245",Ne="_confidenceAfterOnly_q2jbi_250",Te="_confidenceIntentOnly_q2jbi_255",ke="_confidenceUnknown_q2jbi_260",qe="_timelineExpanded_q2jbi_266",we="_empty_q2jbi_338",Ie="_loading_q2jbi_347",Ee="_error_q2jbi_356",t={page:W,header:Y,backLink:z,headerTitle:J,headerTime:Q,statusActive:X,statusCompleted:Z,section:ee,sectionTitle:te,summaryGrid:ne,summaryCard:ae,summaryCardActive:ie,summaryIcon:se,summaryCount:ce,summaryLabel:re,contextGrid:oe,contextRow:le,contextKey:de,contextValue:me,timelineFilter:ge,filterLabel:he,filterSelect:ue,timeline:ye,timelineEntry:xe,timelineTime:fe,timelineIcon:pe,timelineBody:_e,timelineSummary:je,timelineTarget:be,timelineConfidence:ve,confidenceExact:Se,confidencePartial:Ce,confidenceAfterOnly:Ne,confidenceIntentOnly:Te,confidenceUnknown:ke,timelineExpanded:qe,empty:we,loading:Ie,error:Ee},$=[{key:"script",icon:"📝",labelKey:"changelog.category.script"},{key:"instance",icon:"🧱",labelKey:"changelog.category.instance"},{key:"property",icon:"🎨",labelKey:"changelog.category.property"},{key:"lighting",icon:"🌅",labelKey:"changelog.category.lighting"},{key:"terrain",icon:"⛰️",labelKey:"changelog.category.terrain"},{key:"asset",icon:"📦",labelKey:"changelog.category.asset"}];function A(n){if(!n)return"--:--";const s=new Date(n);return`${String(s.getHours()).padStart(2,"0")}:${String(s.getMinutes()).padStart(2,"0")}`}function Le(n){if(!n)return"--:--:--";const s=new Date(n);return`${String(s.getHours()).padStart(2,"0")}:${String(s.getMinutes()).padStart(2,"0")}:${String(s.getSeconds()).padStart(2,"0")}`}function Oe(n,s){if(!n||!s)return"";const l=new Date(s).getTime()-new Date(n).getTime();return l<0?"":`${Math.round(l/6e4)}min`}function Ae(n){switch(n){case"exact":return t.confidenceExact;case"partial":return t.confidencePartial;case"after-only":return t.confidenceAfterOnly;case"intent-only":return t.confidenceIntentOnly;default:return t.confidenceUnknown}}function Ke(n,s){switch(s){case"exact":return n("changelog.detail.confidence.exact","Exact");case"partial":return n("changelog.detail.confidence.partial","Partial");case"after-only":return n("changelog.detail.confidence.afterOnly","After only");case"intent-only":return n("changelog.detail.confidence.intentOnly","Intent only");default:return n("changelog.detail.confidence.unknown","Unknown")}}function Re(n,s){switch(s){case"exact":return n("changelog.detail.confidence.exact.tooltip","Both the before and after state were confirmed for this change.");case"partial":return n("changelog.detail.confidence.partial.tooltip","Only part of the before and after state could be confirmed for this change.");case"after-only":return n("changelog.detail.confidence.afterOnly.tooltip","Only the resulting state after the change could be confirmed.");case"intent-only":return n("changelog.detail.confidence.intentOnly.tooltip","Only the requested action was recorded, not the resulting state.");default:return n("changelog.detail.confidence.unknown.tooltip","This change could not be confidently classified from the available data.")}}function Ge(){var x,f,p,_,j,b,v,S,C,N,T,g,k,h;const{t:n}=M(),{id:s}=B(),l=V(),a=P(s),[d,u]=r.useState("all"),[q,w]=r.useState(null),y=r.useMemo(()=>[...d==="all"?a.changes:a.changes.filter(c=>c.category===d)].reverse(),[a.changes,d]);if(a.loading)return e.jsx("div",{className:t.loading,children:n("common.loading","Loading...")});if(a.error)return e.jsxs("div",{className:t.error,children:[a.error,e.jsx("br",{}),e.jsxs("span",{className:t.backLink,onClick:()=>l("/changelog"),children:["←"," ",n("changelog.detail.backToList","Back to list")]})]});const I=Oe(a.startTime,a.endTime),E=a.endTime?`${A(a.startTime)} → ${A(a.endTime)} (${I})`:`${A(a.startTime)} → ${n("changelog.card.inProgress","in progress")}`,L=!!((x=a.contextSummary)!=null&&x.intent||(f=a.contextSummary)!=null&&f.testScenario||(p=a.contextSummary)!=null&&p.expectedBehavior||(_=a.contextSummary)!=null&&_.observedBehavior),O=!!((j=a.verificationSummary)!=null&&j.label||(b=a.verificationSummary)!=null&&b.status||(v=a.verificationSummary)!=null&&v.testTimestamp);return e.jsxs("div",{className:t.page,children:[e.jsxs("div",{className:t.header,children:[e.jsxs("span",{className:t.backLink,onClick:()=>l("/changelog"),children:["←"," ",n("sidebar.changelog","Changelog")]}),e.jsx("span",{className:t.headerTitle,children:"|"}),e.jsx("span",{className:t.headerTime,children:E}),e.jsx(m,{text:a.status==="active"?n("changelog.card.active.tooltip","This session is still receiving new game changes."):n("changelog.card.completed.tooltip","This session has ended and no more changes are expected."),children:e.jsx("span",{className:a.status==="active"?t.statusActive:t.statusCompleted,children:a.status==="active"?n("changelog.card.active","Active"):n("changelog.card.completed","Completed")})})]}),e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.changeSummary.tooltip","Counts of extracted game changes grouped by category for this session."),children:e.jsx("span",{children:n("changelog.detail.changeSummary","Change Summary")})})}),e.jsx("div",{className:t.summaryGrid,children:$.map(i=>{const c=a.changeSummary;let o;switch(i.key){case"script":o=c.scriptsModified+c.scriptsCreated;break;case"instance":o=c.instancesCreated+c.instancesDeleted+c.instancesMoved;break;case"property":o=c.propertiesChanged;break;case"lighting":o=c.lightingChanged?1:0;break;case"terrain":o=c.terrainChanged?1:0;break;case"asset":o=c.assetsInserted;break;default:o=0}const K=d===i.key;return e.jsxs("div",{className:`${t.summaryCard} ${K?t.summaryCardActive:""}`,onClick:()=>u(K?"all":i.key),children:[e.jsx("span",{className:t.summaryIcon,children:i.icon}),e.jsx("div",{className:t.summaryCount,children:o}),e.jsx("div",{className:t.summaryLabel,children:n(i.labelKey,i.key)})]},i.key)})})]}),L&&e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.context.tooltip","Structured execution context captured for this changelog session."),children:e.jsx("span",{children:n("changelog.detail.context.title","Context Summary")})})}),e.jsxs("div",{className:t.contextGrid,children:[((S=a.contextSummary)==null?void 0:S.intent)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.card.sessionIntent","Session intent")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.intent})]}),((C=a.contextSummary)==null?void 0:C.testScenario)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.why","Why this test ran")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.testScenario})]}),((N=a.contextSummary)==null?void 0:N.expectedBehavior)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.expected","Expected")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.expectedBehavior})]}),((T=a.contextSummary)==null?void 0:T.observedBehavior)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.observed","Observed")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.observedBehavior})]})]})]}),O&&e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.verification.tooltip","Verification signals linked to this changelog session."),children:e.jsx("span",{children:n("changelog.detail.verification.title","Verification")})})}),e.jsxs("div",{className:t.contextGrid,children:[((g=a.verificationSummary)==null?void 0:g.label)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.label","Result")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.label})]}),((k=a.verificationSummary)==null?void 0:k.status)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.status","Status")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.status})]}),((h=a.verificationSummary)==null?void 0:h.testTimestamp)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.timestamp","Recorded at")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.testTimestamp})]})]})]}),e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.changeTimeline.tooltip","Chronological list of extracted game changes for this session."),children:e.jsx("span",{children:n("changelog.detail.changeTimeline","Change Timeline")})})}),e.jsxs("div",{className:t.timelineFilter,children:[e.jsx("span",{className:t.filterLabel,children:e.jsx(G,{label:`${n("changelog.detail.filterCategory","Category")}:`,tooltip:n("changelog.detail.filterCategory.tooltip","Filter the timeline to a single change category.")})}),e.jsxs("select",{className:t.filterSelect,value:d,onChange:i=>u(i.target.value),children:[e.jsx("option",{value:"all",children:n("tools.filter.all","All")}),$.map(i=>e.jsxs("option",{value:i.key,children:[i.icon," ",n(i.labelKey,i.key)]},i.key))]})]}),y.length===0?e.jsx("div",{className:t.empty,children:n("changelog.detail.noChanges","No changes in this category")}):e.jsx("div",{className:t.timeline,children:y.map((i,c)=>{const o=q===c;return e.jsxs("div",{children:[e.jsxs("div",{className:t.timelineEntry,onClick:()=>w(o?null:c),children:[e.jsx("span",{className:t.timelineTime,children:Le(i.timestamp)}),e.jsx("span",{className:t.timelineIcon,children:H(i.category)}),e.jsxs("div",{className:t.timelineBody,children:[e.jsxs("div",{className:t.timelineSummary,children:[i.summary,e.jsx(m,{text:Re(n,i.confidence),children:e.jsx("span",{className:`${t.timelineConfidence} ${Ae(i.confidence)}`,children:Ke(n,i.confidence)})})]}),e.jsx("div",{className:t.timelineTarget,children:i.target})]})]}),o&&e.jsx("div",{className:t.timelineExpanded,children:e.jsx(D,{change:i})})]},c)})})]})]})}export{Ge as Component};
+import{r,a as R,u as M,b as B,c as V,j as e}from"./index-FfT2oWAB.js";import{I as G}from"./InfoLabel-B9KT3kfU.js";import{G as D}from"./GameChangeDetail-D1kE2L_v.js";import{T as m}from"./TooltipText-Baw38jOU.js";function F(n){const s={scriptsModified:0,scriptsCreated:0,instancesCreated:0,instancesDeleted:0,instancesMoved:0,propertiesChanged:0,lightingChanged:!1,terrainChanged:!1,assetsInserted:0};for(const l of n)switch(l.category){case"script":l.changeType==="create"?s.scriptsCreated++:s.scriptsModified++;break;case"instance":l.changeType==="create"?s.instancesCreated++:l.changeType==="delete"?s.instancesDeleted++:l.changeType==="move"&&s.instancesMoved++;break;case"property":s.propertiesChanged++;break;case"lighting":s.lightingChanged=!0;break;case"terrain":s.terrainChanged=!0;break;case"asset":s.assetsInserted++;break}return s}function P(n){const[s,l]=r.useState(""),[a,d]=r.useState(""),[u,q]=r.useState(),[w,y]=r.useState("completed"),[I,E]=r.useState([]),[L,O]=r.useState([]),[x,f]=r.useState([]),[p,_]=r.useState(),[j,b]=r.useState(),[v,S]=r.useState(),[C,N]=r.useState({scriptsModified:0,scriptsCreated:0,instancesCreated:0,instancesDeleted:0,instancesMoved:0,propertiesChanged:0,lightingChanged:!1,terrainChanged:!1,assetsInserted:0}),[T,g]=r.useState(!0),[k,h]=r.useState(null),i=r.useCallback(async()=>{if(n){g(!0),h(null);try{const[c,o]=await Promise.all([R.get(`/api/dashboard/changelog/${n}`),R.get(`/api/dashboard/changelog/${n}/changes`)]);l(c.entryId),d(c.startTime),q(c.endTime),y(c.status),E(c.entries),O(c.failures),_(c.contextSummary),b(c.replayMetadata),S(c.verificationSummary),f(o.changes),N(F(o.changes))}catch(c){h(c instanceof Error?c.message:"Failed to load changelog detail")}finally{g(!1)}}},[n]);return r.useEffect(()=>{i()},[i]),{entryId:s,startTime:a,endTime:u,status:w,entries:I,failures:L,changes:x,changeSummary:C,contextSummary:p,replayMetadata:j,verificationSummary:v,loading:T,error:k,refresh:i}}const U={script:"📝",instance:"🧱",property:"🎨",lighting:"🌅",terrain:"⛰️",asset:"📦"};function H(n){return U[n]??"❓"}const W="_page_q2jbi_2",Y="_header_q2jbi_10",z="_backLink_q2jbi_16",J="_headerTitle_q2jbi_29",Q="_headerTime_q2jbi_37",X="_statusActive_q2jbi_44",Z="_statusCompleted_q2jbi_49",ee="_section_q2jbi_54",te="_sectionTitle_q2jbi_61",ne="_summaryGrid_q2jbi_74",ae="_summaryCard_q2jbi_80",ie="_summaryCardActive_q2jbi_94",se="_summaryIcon_q2jbi_99",ce="_summaryCount_q2jbi_105",re="_summaryLabel_q2jbi_112",oe="_contextGrid_q2jbi_121",le="_contextRow_q2jbi_127",de="_contextKey_q2jbi_133",me="_contextValue_q2jbi_141",ge="_timelineFilter_q2jbi_149",he="_filterLabel_q2jbi_156",ue="_filterSelect_q2jbi_162",ye="_timeline_q2jbi_149",xe="_timelineEntry_q2jbi_182",fe="_timelineTime_q2jbi_199",pe="_timelineIcon_q2jbi_207",_e="_timelineBody_q2jbi_212",je="_timelineSummary_q2jbi_217",be="_timelineTarget_q2jbi_224",ve="_timelineConfidence_q2jbi_231",Se="_confidenceExact_q2jbi_240",Ce="_confidencePartial_q2jbi_245",Ne="_confidenceAfterOnly_q2jbi_250",Te="_confidenceIntentOnly_q2jbi_255",ke="_confidenceUnknown_q2jbi_260",qe="_timelineExpanded_q2jbi_266",we="_empty_q2jbi_338",Ie="_loading_q2jbi_347",Ee="_error_q2jbi_356",t={page:W,header:Y,backLink:z,headerTitle:J,headerTime:Q,statusActive:X,statusCompleted:Z,section:ee,sectionTitle:te,summaryGrid:ne,summaryCard:ae,summaryCardActive:ie,summaryIcon:se,summaryCount:ce,summaryLabel:re,contextGrid:oe,contextRow:le,contextKey:de,contextValue:me,timelineFilter:ge,filterLabel:he,filterSelect:ue,timeline:ye,timelineEntry:xe,timelineTime:fe,timelineIcon:pe,timelineBody:_e,timelineSummary:je,timelineTarget:be,timelineConfidence:ve,confidenceExact:Se,confidencePartial:Ce,confidenceAfterOnly:Ne,confidenceIntentOnly:Te,confidenceUnknown:ke,timelineExpanded:qe,empty:we,loading:Ie,error:Ee},$=[{key:"script",icon:"📝",labelKey:"changelog.category.script"},{key:"instance",icon:"🧱",labelKey:"changelog.category.instance"},{key:"property",icon:"🎨",labelKey:"changelog.category.property"},{key:"lighting",icon:"🌅",labelKey:"changelog.category.lighting"},{key:"terrain",icon:"⛰️",labelKey:"changelog.category.terrain"},{key:"asset",icon:"📦",labelKey:"changelog.category.asset"}];function A(n){if(!n)return"--:--";const s=new Date(n);return`${String(s.getHours()).padStart(2,"0")}:${String(s.getMinutes()).padStart(2,"0")}`}function Le(n){if(!n)return"--:--:--";const s=new Date(n);return`${String(s.getHours()).padStart(2,"0")}:${String(s.getMinutes()).padStart(2,"0")}:${String(s.getSeconds()).padStart(2,"0")}`}function Oe(n,s){if(!n||!s)return"";const l=new Date(s).getTime()-new Date(n).getTime();return l<0?"":`${Math.round(l/6e4)}min`}function Ae(n){switch(n){case"exact":return t.confidenceExact;case"partial":return t.confidencePartial;case"after-only":return t.confidenceAfterOnly;case"intent-only":return t.confidenceIntentOnly;default:return t.confidenceUnknown}}function Ke(n,s){switch(s){case"exact":return n("changelog.detail.confidence.exact","Exact");case"partial":return n("changelog.detail.confidence.partial","Partial");case"after-only":return n("changelog.detail.confidence.afterOnly","After only");case"intent-only":return n("changelog.detail.confidence.intentOnly","Intent only");default:return n("changelog.detail.confidence.unknown","Unknown")}}function Re(n,s){switch(s){case"exact":return n("changelog.detail.confidence.exact.tooltip","Both the before and after state were confirmed for this change.");case"partial":return n("changelog.detail.confidence.partial.tooltip","Only part of the before and after state could be confirmed for this change.");case"after-only":return n("changelog.detail.confidence.afterOnly.tooltip","Only the resulting state after the change could be confirmed.");case"intent-only":return n("changelog.detail.confidence.intentOnly.tooltip","Only the requested action was recorded, not the resulting state.");default:return n("changelog.detail.confidence.unknown.tooltip","This change could not be confidently classified from the available data.")}}function Ge(){var x,f,p,_,j,b,v,S,C,N,T,g,k,h;const{t:n}=M(),{id:s}=B(),l=V(),a=P(s),[d,u]=r.useState("all"),[q,w]=r.useState(null),y=r.useMemo(()=>[...d==="all"?a.changes:a.changes.filter(c=>c.category===d)].reverse(),[a.changes,d]);if(a.loading)return e.jsx("div",{className:t.loading,children:n("common.loading","Loading...")});if(a.error)return e.jsxs("div",{className:t.error,children:[a.error,e.jsx("br",{}),e.jsxs("span",{className:t.backLink,onClick:()=>l("/changelog"),children:["←"," ",n("changelog.detail.backToList","Back to list")]})]});const I=Oe(a.startTime,a.endTime),E=a.endTime?`${A(a.startTime)} → ${A(a.endTime)} (${I})`:`${A(a.startTime)} → ${n("changelog.card.inProgress","in progress")}`,L=!!((x=a.contextSummary)!=null&&x.intent||(f=a.contextSummary)!=null&&f.testScenario||(p=a.contextSummary)!=null&&p.expectedBehavior||(_=a.contextSummary)!=null&&_.observedBehavior),O=!!((j=a.verificationSummary)!=null&&j.label||(b=a.verificationSummary)!=null&&b.status||(v=a.verificationSummary)!=null&&v.testTimestamp);return e.jsxs("div",{className:t.page,children:[e.jsxs("div",{className:t.header,children:[e.jsxs("span",{className:t.backLink,onClick:()=>l("/changelog"),children:["←"," ",n("sidebar.changelog","Changelog")]}),e.jsx("span",{className:t.headerTitle,children:"|"}),e.jsx("span",{className:t.headerTime,children:E}),e.jsx(m,{text:a.status==="active"?n("changelog.card.active.tooltip","This session is still receiving new game changes."):n("changelog.card.completed.tooltip","This session has ended and no more changes are expected."),children:e.jsx("span",{className:a.status==="active"?t.statusActive:t.statusCompleted,children:a.status==="active"?n("changelog.card.active","Active"):n("changelog.card.completed","Completed")})})]}),e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.changeSummary.tooltip","Counts of extracted game changes grouped by category for this session."),children:e.jsx("span",{children:n("changelog.detail.changeSummary","Change Summary")})})}),e.jsx("div",{className:t.summaryGrid,children:$.map(i=>{const c=a.changeSummary;let o;switch(i.key){case"script":o=c.scriptsModified+c.scriptsCreated;break;case"instance":o=c.instancesCreated+c.instancesDeleted+c.instancesMoved;break;case"property":o=c.propertiesChanged;break;case"lighting":o=c.lightingChanged?1:0;break;case"terrain":o=c.terrainChanged?1:0;break;case"asset":o=c.assetsInserted;break;default:o=0}const K=d===i.key;return e.jsxs("div",{className:`${t.summaryCard} ${K?t.summaryCardActive:""}`,onClick:()=>u(K?"all":i.key),children:[e.jsx("span",{className:t.summaryIcon,children:i.icon}),e.jsx("div",{className:t.summaryCount,children:o}),e.jsx("div",{className:t.summaryLabel,children:n(i.labelKey,i.key)})]},i.key)})})]}),L&&e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.context.tooltip","Structured execution context captured for this changelog session."),children:e.jsx("span",{children:n("changelog.detail.context.title","Context Summary")})})}),e.jsxs("div",{className:t.contextGrid,children:[((S=a.contextSummary)==null?void 0:S.intent)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.card.sessionIntent","Session intent")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.intent})]}),((C=a.contextSummary)==null?void 0:C.testScenario)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.why","Why this test ran")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.testScenario})]}),((N=a.contextSummary)==null?void 0:N.expectedBehavior)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.expected","Expected")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.expectedBehavior})]}),((T=a.contextSummary)==null?void 0:T.observedBehavior)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("playtest.context.observed","Observed")}),e.jsx("span",{className:t.contextValue,children:a.contextSummary.observedBehavior})]})]})]}),O&&e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.verification.tooltip","Verification signals linked to this changelog session."),children:e.jsx("span",{children:n("changelog.detail.verification.title","Verification")})})}),e.jsxs("div",{className:t.contextGrid,children:[((g=a.verificationSummary)==null?void 0:g.label)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.label","Result")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.label})]}),((k=a.verificationSummary)==null?void 0:k.status)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.status","Status")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.status})]}),((h=a.verificationSummary)==null?void 0:h.testTimestamp)&&e.jsxs("div",{className:t.contextRow,children:[e.jsx("span",{className:t.contextKey,children:n("changelog.detail.verification.timestamp","Recorded at")}),e.jsx("span",{className:t.contextValue,children:a.verificationSummary.testTimestamp})]})]})]}),e.jsxs("div",{className:t.section,children:[e.jsx("div",{className:t.sectionTitle,children:e.jsx(m,{text:n("changelog.detail.changeTimeline.tooltip","Chronological list of extracted game changes for this session."),children:e.jsx("span",{children:n("changelog.detail.changeTimeline","Change Timeline")})})}),e.jsxs("div",{className:t.timelineFilter,children:[e.jsx("span",{className:t.filterLabel,children:e.jsx(G,{label:`${n("changelog.detail.filterCategory","Category")}:`,tooltip:n("changelog.detail.filterCategory.tooltip","Filter the timeline to a single change category.")})}),e.jsxs("select",{className:t.filterSelect,value:d,onChange:i=>u(i.target.value),children:[e.jsx("option",{value:"all",children:n("tools.filter.all","All")}),$.map(i=>e.jsxs("option",{value:i.key,children:[i.icon," ",n(i.labelKey,i.key)]},i.key))]})]}),y.length===0?e.jsx("div",{className:t.empty,children:n("changelog.detail.noChanges","No changes in this category")}):e.jsx("div",{className:t.timeline,children:y.map((i,c)=>{const o=q===c;return e.jsxs("div",{children:[e.jsxs("div",{className:t.timelineEntry,onClick:()=>w(o?null:c),children:[e.jsx("span",{className:t.timelineTime,children:Le(i.timestamp)}),e.jsx("span",{className:t.timelineIcon,children:H(i.category)}),e.jsxs("div",{className:t.timelineBody,children:[e.jsxs("div",{className:t.timelineSummary,children:[i.summary,e.jsx(m,{text:Re(n,i.confidence),children:e.jsx("span",{className:`${t.timelineConfidence} ${Ae(i.confidence)}`,children:Ke(n,i.confidence)})})]}),e.jsx("div",{className:t.timelineTarget,children:i.target})]})]}),o&&e.jsx("div",{className:t.timelineExpanded,children:e.jsx(D,{change:i})})]},c)})})]})]})}export{Ge as Component};