@alpsckr/unitycli 0.4.1 → 0.4.2

package/docs/extensions.md

@@ -16,6 +16,8 @@ Bridge 与 AI Skill 是两个独立安装对象。先用安装协议发现并选
 unitycli init help
 unitycli init discover
 unitycli init package --project C:\path\UnityProject
+# 仅在用户批准正常关闭这个准确项目后使用
+unitycli init package --project C:\path\UnityProject --close-editor
 unitycli init package --project C:\path\UnityProject --check
 ```
 
@@ -24,7 +26,7 @@ Bridge 安装内容：
 - `Packages/unitycli.install.json` — 安装元数据（项目 hash、source hash、managed-file hash、版本与支持范围）
 - `Packages/com.alpsckr.unitycli/unitycli.files.json` — 受管文件路径清单
 
-Skill 使用`init skill`安装到用户选择的`.agents`或Claude workspace/user目标，不属于Unity项目Package安装。
+Skill 使用`init skill --target <SkillDirectory>`安装到用户明确目录，或使用`.agents`/Claude workspace/user预设；它不属于Unity项目Package安装，Bridge失败也不阻止这个独立效果。
 
 ### 项目能力发现
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpsckr/unitycli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Windows-first CLI for UnityCLI automation.",
   "type": "module",
   "bin": {

package/schemas/init.schema.json

@@ -52,7 +52,7 @@
       "properties": {
         "action": { "const": "init_help" },
         "audience": { "const": "ai" },
-        "protocolVersion": { "type": "integer", "minimum": 1 },
+        "protocolVersion": { "const": 2 },
         "aiInstructions": { "type": "array", "minItems": 1, "items": { "type": "string" } },
         "commands": { "type": "object", "additionalProperties": { "type": "string" } },
         "nextCommand": { "type": "string" },
@@ -67,16 +67,87 @@
         "action": { "const": "init_discover" },
         "cwd": { "type": "string" },
         "repositoryRoot": { "type": ["string", "null"] },
-        "limits": { "type": "object" },
-        "scan": { "type": "object" },
-        "unityProjects": { "type": "array" },
-        "skillWorkspaces": { "type": "array" },
-        "skillCopies": { "type": "array" },
-        "shadowingRisks": { "type": "array" },
-        "requiredDecisions": { "type": "array", "minItems": 4 },
+        "unityProjects": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": { "type": "string" },
+              "unityVersion": { "type": "string" },
+              "relation": { "enum": ["cwd", "ancestor", "descendant"] },
+              "depth": { "type": "integer", "minimum": 0 },
+              "bridge": {
+                "type": "object",
+                "properties": {
+                  "status": { "enum": ["installed", "missing", "damaged", "drifted", "conflict", "unverifiable", "not-inspected"] },
+                  "installedVersion": { "type": "string" },
+                  "availableVersion": { "type": "string" },
+                  "reasonCode": { "type": "string" },
+                  "message": { "type": "string" }
+                },
+                "required": ["status"],
+                "additionalProperties": false
+              },
+              "editor": {
+                "type": "object",
+                "properties": {
+                  "status": { "enum": ["running", "stopped", "unverifiable", "not-inspected"] },
+                  "processCount": { "type": "integer", "minimum": 0 },
+                  "message": { "type": "string" }
+                },
+                "required": ["status"],
+                "additionalProperties": false
+              }
+            },
+            "required": ["path", "unityVersion", "relation", "depth", "bridge", "editor"],
+            "additionalProperties": false
+          }
+        },
+        "skill": {
+          "type": "object",
+          "properties": {
+            "workspace": { "type": "string" },
+            "recommendedTarget": { "type": "string" },
+            "explicitTargetSupported": { "const": true },
+            "status": { "enum": ["installed", "missing", "drifted", "damaged"] },
+            "targetPath": { "type": "string" },
+            "sourceHash": { "$ref": "#/$defs/sha256" },
+            "hash": { "$ref": "#/$defs/sha256" },
+            "message": { "type": "string" }
+          },
+          "required": ["workspace", "recommendedTarget", "explicitTargetSupported", "status", "targetPath", "sourceHash"],
+          "additionalProperties": false
+        },
+        "requiredDecisions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": { "enum": ["bridgeProjects", "closeEditor"] },
+              "question": { "type": "string" },
+              "choices": { "type": "array", "items": { "type": "string" } },
+              "projectPath": { "type": "string" },
+              "multiple": { "type": "boolean" }
+            },
+            "required": ["id", "question", "multiple"],
+            "additionalProperties": false
+          }
+        },
+        "scan": {
+          "type": "object",
+          "properties": {
+            "scannedDirectories": { "type": "integer", "minimum": 0, "maximum": 2000 },
+            "truncated": { "type": "boolean" },
+            "maxDescendantDepth": { "const": 4 },
+            "maxScannedDirectories": { "const": 2000 },
+            "maxUnityProjects": { "const": 100 }
+          },
+          "required": ["scannedDirectories", "truncated", "maxDescendantDepth", "maxScannedDirectories", "maxUnityProjects"],
+          "additionalProperties": false
+        },
         "nextActions": { "$ref": "#/$defs/nextActions" }
       },
-      "required": ["action", "cwd", "repositoryRoot", "limits", "scan", "unityProjects", "skillWorkspaces", "skillCopies", "shadowingRisks", "requiredDecisions", "nextActions"],
+      "required": ["action", "cwd", "repositoryRoot", "unityProjects", "skill", "requiredDecisions", "nextActions"],
       "additionalProperties": false
     },
     "packageData": {
@@ -85,6 +156,15 @@
         "action": { "enum": ["init_package", "init_package_check"] },
         "projectPath": { "type": "string" },
         "projectIdentity": { "type": "object" },
+        "editorClose": {
+          "type": "object",
+          "properties": {
+            "status": { "enum": ["not-running", "closed"] },
+            "requested": { "type": "integer", "minimum": 0 }
+          },
+          "required": ["status", "requested"],
+          "additionalProperties": false
+        },
         "package": {
           "type": "object",
           "properties": { "status": { "enum": ["installed", "missing", "damaged", "drifted", "conflict"] } },
@@ -102,6 +182,7 @@
         "agent": { "enum": [".agents", "claude"] },
         "scope": { "enum": ["workspace", "user"] },
         "workspace": { "type": "string" },
+        "target": { "type": "string" },
         "changes": { "type": "array" },
         "skill": {
           "type": "object",
@@ -117,7 +198,11 @@
         },
         "nextActions": { "$ref": "#/$defs/nextActions" }
       },
-      "required": ["action", "agent", "scope", "skill", "nextActions"],
+      "required": ["action", "skill", "nextActions"],
+      "oneOf": [
+        { "type": "object", "required": ["agent", "scope"] },
+        { "type": "object", "required": ["target"] }
+      ],
       "additionalProperties": false
     }
   }

package/skills/unitycli/SKILL.md

@@ -27,7 +27,7 @@ FeedbackMode: off
 unitycli init help
 ```
 
-严格执行返回的版本化`aiInstructions`，不要依赖本Skill记忆安装步骤。先运行`init discover`，再向用户询问要安装Bridge的Unity项目，以及Skill的agent、scope和常用workspace；不得静默选择。多个Bridge项目逐个严格串行安装，每次等待terminal并执行对应`--check`后才能继续；Skill通常只安装到用户选择的一个`.agents`或Claude workspace/user目标。第一次非预期CLI失败或业务check失败立即停止，不重试、纠参或继续后续effect。安装流程不得启动、关闭、重启或终止Unity Editor。用户完成选择后的明确安装调用即授权，不增加第二次确认。
+严格执行返回的版本化`aiInstructions`，不要依赖本Skill记忆安装步骤。先运行`init discover`；当前目录只有一个Unity项目时直接采用，用户已经指定的项目、scope、host或Skill目录都是最终决定，不得重复询问。未指定Skill目录时使用发现结果的当前workspace推荐目标；明确目录使用`init skill --target <SkillDirectory>`。准确目标Unity正在运行时只询问一次是否正常关闭；同意后使用`init package --close-editor`，不得强制终止，也不得替用户决定未保存场景弹窗。Bridge与Skill是独立授权效果，一个失败只阻断自身检查，不阻断另一个；每个成功效果都立即执行对应`--check`并最终汇总全部状态。安装流程不得启动或重启Unity。用户安装请求授权所选效果，除关闭Editor外不增加确认。
 
 ## 执行骨架
 

package/skills/unitycli/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "unitycli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "owner": "alps-unity-cli maintainers",
   "updated_at": "2026-08-27",
   "status": "active",

package/skills/unitycli/references/operation-protocol.md

@@ -82,4 +82,4 @@ unitycli extensions remove <id> --project <path>
 unitycli extensions doctor --project <path>
 ```
 
-安装协议先使用`unitycli init help`学习，再由`init discover`只读发现现场。Bridge只用`init package --project <UnityProject>`安装，并用同命令加`--check`校验；Skill只用`init skill --agent <.agents|claude> --scope <workspace|user>`，workspace scope还必须传`--workspace <path>`，同命令加`--check`校验。不得使用裸`init`或混装Bridge与Skill。Unity project文件投影完成后，如任务要求Editor效果，仍需在已连接实例中完成import/compile和业务readback；安装协议本身不得管理Unity进程。
+安装协议先使用`unitycli init help`学习，再由`init discover`只读返回当前项目计划。Bridge使用`init package --project <UnityProject>`安装；准确目标Unity正在运行且用户同意正常关闭时增加`--close-editor`，不得强制终止或替用户处理未保存场景。Skill明确目录使用`init skill --target <SkillDirectory>`，预设目标仍可使用`init skill --agent <.agents|claude> --scope <workspace|user>`，workspace scope同时传`--workspace <path>`；每种形式都用原命令加`--check`校验。用户已指定的目标不得重复询问。Bridge与Skill是独立效果，一个失败不阻断另一个。不得使用裸`init`或把两种效果合并为一个命令。Unity project文件投影完成后，如任务要求Editor效果，仍需在已连接实例中完成import/compile和业务readback。

package/skills/unitycli/reports/output_quality_scorecard.md

@@ -24,7 +24,7 @@ The feedback output contract requires category, concise issue summary, optional
 | Feedback privacy negatives | PASS | Secret/endpoint/path negative matrix | Novel secret formats can still exist |
 | Concurrent JSONL validity | PASS | 16 parallel Windows PowerShell writers | Cross-session Windows desktop contention not measured |
 | Rolling bound | PASS | Main + 3 archives, each <= 64 KiB | Longitudinal retention utility not measured |
-| Installed bundle reachability | PASS | Public workspace/user install, drifted-update, check, and recorder smoke for `.agents` and Claude | Verified with isolated filesystem targets |
+| Installed bundle reachability | PASS | Public exact-target and preset workspace/user install, drifted-update, check, and recorder smoke | Verified with isolated filesystem targets |
 | Clean Agent interpretation | PASS | Black-box runtime discovery transcript and main-agent audit | Human adjudication unavailable |
 
 ## Rollback Boundary

package/skills/unitycli/reports/trust-report.md

@@ -36,7 +36,7 @@ The Skill does not add confirmation, intent review, or a predefined operation ra
 
 - Full repository tests: 876/876 PASS; targeted Skill/installer/docs regression: 61/61 PASS.
 - Recorder concurrency, rotation, privacy negatives, PowerShell 5.1 BOM, and non-ASCII stdout: PASS.
-- Public runtime install, drifted update, check, marker preservation, and installed-recorder smoke across `.claude` and `.agents`: PASS.
+- Public exact-target and preset runtime install, drifted update, check, marker preservation, and installed-recorder smoke: PASS.
 - Resource boundary: 963 estimated initial-load tokens (691 Skill body tokens), limit 1300.
 - Trigger fixture gate: 29/29 classifications.
 - Output assertion gate: 5/5 with-skill cases, 100% pass rate.

package/unitypkg/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.alpsckr.unitycli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "displayName": "UnityCLI",
   "description": "Editor package used by UnityCLI commands.",
   "unity": "2022.3",