@mflrevan/ucp 0.1.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/README.md +31 -38
  2. package/bridge/com.ucp.bridge/CHANGELOG.md +56 -0
  3. package/bridge/com.ucp.bridge/CHANGELOG.md.meta +7 -0
  4. package/bridge/com.ucp.bridge/Editor/Bridge/BridgeServer.cs +573 -0
  5. package/bridge/com.ucp.bridge/Editor/Bridge/BridgeServer.cs.meta +2 -0
  6. package/bridge/com.ucp.bridge/Editor/Bridge.meta +8 -0
  7. package/bridge/com.ucp.bridge/Editor/Controllers/AssetController.cs +499 -0
  8. package/bridge/com.ucp.bridge/Editor/Controllers/AssetController.cs.meta +2 -0
  9. package/bridge/com.ucp.bridge/Editor/Controllers/BuildController.cs +230 -0
  10. package/bridge/com.ucp.bridge/Editor/Controllers/BuildController.cs.meta +2 -0
  11. package/bridge/com.ucp.bridge/Editor/Controllers/CompilationController.cs +26 -0
  12. package/bridge/com.ucp.bridge/Editor/Controllers/CompilationController.cs.meta +2 -0
  13. package/bridge/com.ucp.bridge/Editor/Controllers/EditorSettingsController.cs +435 -0
  14. package/bridge/com.ucp.bridge/Editor/Controllers/EditorSettingsController.cs.meta +2 -0
  15. package/bridge/com.ucp.bridge/Editor/Controllers/FileController.cs +130 -0
  16. package/bridge/com.ucp.bridge/Editor/Controllers/FileController.cs.meta +2 -0
  17. package/bridge/com.ucp.bridge/Editor/Controllers/HierarchyController.cs +319 -0
  18. package/bridge/com.ucp.bridge/Editor/Controllers/HierarchyController.cs.meta +2 -0
  19. package/bridge/com.ucp.bridge/Editor/Controllers/LogsController.cs +291 -0
  20. package/bridge/com.ucp.bridge/Editor/Controllers/LogsController.cs.meta +2 -0
  21. package/bridge/com.ucp.bridge/Editor/Controllers/MaterialController.cs +295 -0
  22. package/bridge/com.ucp.bridge/Editor/Controllers/MaterialController.cs.meta +2 -0
  23. package/bridge/com.ucp.bridge/Editor/Controllers/PlayModeController.cs +38 -0
  24. package/bridge/com.ucp.bridge/Editor/Controllers/PlayModeController.cs.meta +2 -0
  25. package/bridge/com.ucp.bridge/Editor/Controllers/PrefabController.cs +242 -0
  26. package/bridge/com.ucp.bridge/Editor/Controllers/PrefabController.cs.meta +2 -0
  27. package/bridge/com.ucp.bridge/Editor/Controllers/PropertyController.cs +551 -0
  28. package/bridge/com.ucp.bridge/Editor/Controllers/PropertyController.cs.meta +2 -0
  29. package/bridge/com.ucp.bridge/Editor/Controllers/SceneController.cs +70 -0
  30. package/bridge/com.ucp.bridge/Editor/Controllers/SceneController.cs.meta +2 -0
  31. package/bridge/com.ucp.bridge/Editor/Controllers/ScreenshotController.cs +125 -0
  32. package/bridge/com.ucp.bridge/Editor/Controllers/ScreenshotController.cs.meta +2 -0
  33. package/bridge/com.ucp.bridge/Editor/Controllers/ScriptController.cs +104 -0
  34. package/bridge/com.ucp.bridge/Editor/Controllers/ScriptController.cs.meta +2 -0
  35. package/bridge/com.ucp.bridge/Editor/Controllers/SnapshotController.cs +227 -0
  36. package/bridge/com.ucp.bridge/Editor/Controllers/SnapshotController.cs.meta +2 -0
  37. package/bridge/com.ucp.bridge/Editor/Controllers/TestRunnerController.cs +180 -0
  38. package/bridge/com.ucp.bridge/Editor/Controllers/TestRunnerController.cs.meta +2 -0
  39. package/bridge/com.ucp.bridge/Editor/Controllers/VcsController.cs +611 -0
  40. package/bridge/com.ucp.bridge/Editor/Controllers/VcsController.cs.meta +2 -0
  41. package/bridge/com.ucp.bridge/Editor/Controllers.meta +8 -0
  42. package/bridge/com.ucp.bridge/Editor/Protocol/CommandRouter.cs +45 -0
  43. package/bridge/com.ucp.bridge/Editor/Protocol/CommandRouter.cs.meta +2 -0
  44. package/bridge/com.ucp.bridge/Editor/Protocol/MessageTypes.cs +80 -0
  45. package/bridge/com.ucp.bridge/Editor/Protocol/MessageTypes.cs.meta +2 -0
  46. package/bridge/com.ucp.bridge/Editor/Protocol/MiniJson.cs +358 -0
  47. package/bridge/com.ucp.bridge/Editor/Protocol/MiniJson.cs.meta +2 -0
  48. package/bridge/com.ucp.bridge/Editor/Protocol.meta +8 -0
  49. package/bridge/com.ucp.bridge/Editor/Scripts/IUCPScript.cs +37 -0
  50. package/bridge/com.ucp.bridge/Editor/Scripts/IUCPScript.cs.meta +2 -0
  51. package/bridge/com.ucp.bridge/Editor/Scripts.meta +8 -0
  52. package/bridge/com.ucp.bridge/Editor/UCP.Bridge.Editor.asmdef +16 -0
  53. package/bridge/com.ucp.bridge/Editor/UCP.Bridge.Editor.asmdef.meta +7 -0
  54. package/bridge/com.ucp.bridge/Editor.meta +8 -0
  55. package/bridge/com.ucp.bridge/Runtime/UCP.Bridge.Runtime.asmdef +14 -0
  56. package/bridge/com.ucp.bridge/Runtime/UCP.Bridge.Runtime.asmdef.meta +7 -0
  57. package/bridge/com.ucp.bridge/Runtime.meta +8 -0
  58. package/bridge/com.ucp.bridge/Tests/Editor/ControllerSmokeTests.cs +194 -0
  59. package/bridge/com.ucp.bridge/Tests/Editor/ControllerSmokeTests.cs.meta +2 -0
  60. package/bridge/com.ucp.bridge/Tests/Editor/UCP.Bridge.Editor.Tests.asmdef +12 -0
  61. package/bridge/com.ucp.bridge/Tests/Editor/UCP.Bridge.Editor.Tests.asmdef.meta +7 -0
  62. package/bridge/com.ucp.bridge/Tests/Editor.meta +8 -0
  63. package/bridge/com.ucp.bridge/Tests.meta +8 -0
  64. package/bridge/com.ucp.bridge/package.json +27 -0
  65. package/bridge/com.ucp.bridge/package.json.meta +7 -0
  66. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # @mflrevan/ucp
2
2
 
3
- CLI for programmatic control of Unity Editor over WebSocket. Enables AI agents, CI/CD pipelines, and automation tools to interact with Unity projects.
3
+ Version `0.2.3` of the Unity Control Protocol CLI.
4
+
5
+ This package installs the `ucp` command, downloads the matching published binary for your platform during `postinstall`, and ships the matching Unity bridge payload inside the npm package.
4
6
 
5
7
  ## Install
6
8
 
@@ -8,69 +10,60 @@ CLI for programmatic control of Unity Editor over WebSocket. Enables AI agents,
8
10
  npm install -g @mflrevan/ucp
9
11
  ```
10
12
 
11
- The package automatically downloads the correct prebuilt binary for your platform (macOS, Linux, Windows).
13
+ ### pnpm
14
+
15
+ ```bash
16
+ pnpm add -g @mflrevan/ucp
17
+ pnpm approve-builds
18
+ ```
19
+
20
+ ## Supported platforms
21
+
22
+ - Windows x64
23
+ - macOS x64
24
+ - macOS arm64
25
+ - Linux x64
12
26
 
13
27
  ## Usage
14
28
 
15
29
  ```bash
16
30
  cd /path/to/MyUnityProject
17
- ucp connect # verify connection to Unity bridge
18
- ucp snapshot # capture full scene hierarchy
19
- ucp compile # trigger recompilation
20
- ucp play # enter play mode
21
- ucp write-file Assets/Scripts/MyScript.cs --content "..."
31
+ ucp doctor
32
+ ucp connect
33
+ ucp snapshot
34
+ ucp object get-fields --id 46894 --component Transform
35
+ ucp asset search -t Material
36
+ ucp build targets
22
37
  ```
23
38
 
24
- ## Requirements
25
-
26
- - Unity project with the UCP bridge package installed
27
- - Supported platforms: macOS (x64, ARM64), Linux (x64), Windows (x64)
28
-
29
- ### Install the Bridge
39
+ ## Bridge install
30
40
 
31
41
  ```bash
32
42
  ucp install
33
43
  ```
34
44
 
35
- Or add to `Packages/manifest.json`:
45
+ Or add this to `Packages/manifest.json`:
36
46
 
37
47
  ```json
38
48
  {
39
49
  "dependencies": {
40
- "com.ucp.bridge": "https://github.com/mflRevan/unity-control-protocol.git?path=unity-package/com.ucp.bridge"
50
+ "com.ucp.bridge": "https://github.com/mflRevan/unity-control-protocol.git?path=unity-package/com.ucp.bridge#v0.2.3"
41
51
  }
42
52
  }
43
53
  ```
44
54
 
45
- ## Commands
46
-
47
- | Command | Description |
48
- |---|---|
49
- | `ucp connect` | Verify connection to Unity bridge |
50
- | `ucp doctor` | Run health checks |
51
- | `ucp compile` | Trigger recompilation |
52
- | `ucp play` / `stop` / `pause` | Play mode control |
53
- | `ucp scene list\|active\|load` | Scene management |
54
- | `ucp snapshot` | Capture scene hierarchy |
55
- | `ucp screenshot` | Capture screenshot |
56
- | `ucp logs` | Stream console logs |
57
- | `ucp run-tests` | Run edit/play mode tests |
58
- | `ucp read-file` / `write-file` / `patch-file` | File operations |
59
- | `ucp exec list\|run` | Run automation scripts |
60
- | `ucp vcs *` | Version control (Plastic SCM) |
55
+ ## Release asset source
61
56
 
62
- All commands support `--json` for structured output.
57
+ The installer downloads from:
63
58
 
64
- ## Alternative Install Methods
59
+ `https://github.com/mflRevan/unity-control-protocol/releases/download/v<version>/...`
65
60
 
66
- - **cargo:** `cargo install --git https://github.com/mflRevan/unity-control-protocol --path cli`
67
- - **Binary:** [GitHub Releases](https://github.com/mflRevan/unity-control-protocol/releases)
68
- - **Source:** `git clone` + `cargo build --release`
61
+ That means npm publish depends on the matching GitHub release artifacts existing for the same tag.
69
62
 
70
63
  ## Links
71
64
 
72
- - [Full documentation](https://github.com/mflRevan/unity-control-protocol)
73
- - [GitHub Releases](https://github.com/mflRevan/unity-control-protocol/releases)
65
+ - Repository: https://github.com/mflRevan/unity-control-protocol
66
+ - Releases: https://github.com/mflRevan/unity-control-protocol/releases
74
67
 
75
68
  ## License
76
69
 
@@ -0,0 +1,56 @@
1
+ # Changelog
2
+
3
+ ## [0.2.3] - 2026-03-12
4
+
5
+ ### Fixed
6
+
7
+ - Fixed the release packaging pipeline so metadata validation no longer depends on optional website-only files
8
+
9
+ ## [0.2.2] - 2026-03-12
10
+
11
+ ### Changed
12
+
13
+ - The bridge is now intended to be consumed through CLI-managed local mounts by default, with tracked manifest installation remaining an explicit opt-in path
14
+
15
+ ## [0.2.1] - 2026-03-12
16
+
17
+ ### Added
18
+
19
+ - `LogsController` buffered history support for `logs/tail`, `logs/search`, and `logs/get`
20
+ - EditMode smoke coverage for buffered log truncation, regex filtering, and id-window filtering
21
+
22
+ ### Changed
23
+
24
+ - Snapshot responses remain shallow by default and log-heavy reads are now designed for summary-first inspection
25
+
26
+ ### Fixed
27
+
28
+ - EditMode test duration reporting now uses the editor uptime clock to avoid negative durations
29
+
30
+ ## [0.2.0] - 2026-03-12
31
+
32
+ ### Added
33
+
34
+ - Asset controller for asset search, inspection, field reads, writes, and ScriptableObject creation
35
+ - Property and hierarchy controllers for GameObject, component, and hierarchy manipulation
36
+ - Material controller for shader properties and keywords
37
+ - Prefab controller for status, overrides, apply, revert, unpack, and prefab creation
38
+ - Editor settings controller for player, quality, physics, lighting, tags, and layers
39
+ - Build controller for targets, scenes, scripting defines, and build execution
40
+
41
+ ## [0.1.0] - 2026-03-09
42
+
43
+ ### Added
44
+
45
+ - Initial WebSocket bridge server
46
+ - Play/stop/pause control
47
+ - Compilation trigger
48
+ - Scene management (list, load, active)
49
+ - State snapshots
50
+ - Screenshot capture (Game view)
51
+ - Console log streaming
52
+ - Test runner integration
53
+ - File read/write/patch operations
54
+ - JSON-RPC 2.0 protocol
55
+ - Lock file discovery mechanism
56
+ - Per-session token authentication
@@ -0,0 +1,7 @@
1
+ fileFormatVersion: 2
2
+ guid: 40d4771ee6083664b8ca936ef74671f9
3
+ TextScriptImporter:
4
+ externalObjects: {}
5
+ userData:
6
+ assetBundleName:
7
+ assetBundleVariant: