@alpsckr/unitycli 0.4.0 → 0.4.2

package/dist/cli-commands/package.js

@@ -2,150 +2,117 @@ import { resolve } from "node:path";
 import { getBoolean, getString } from "../args.js";
 import { failure, success } from "../output.js";
 import { ProjectIdentityError, resolveProjectIdentity } from "../project-identity.js";
-import { StructuredToolError } from "../tools/errors.js";
-/** 安装 Core package、Agent Skill 和自动检测 Extension，并只返回文件系统 readback。 */
-export async function handleInit(flags, runtime, requestId) {
-    if (flags.unity !== undefined) {
-        return failure(requestId, "E_OBSOLETE_OPTION", "init --unity has been removed; init only copies package and Skill files.", [
-            "Remove --unity and run init against the Unity project path.",
-            "Open or refresh that project in Unity after init completes."
-        ]);
-    }
-    const allowedFlags = new Set(["project", "agent", "pkg-only", "skill-only", "check", "timeout-ms", "raw"]);
-    const unknownFlag = Object.keys(flags).find((flag) => !allowedFlags.has(flag));
-    if (unknownFlag) {
-        return failure(requestId, "E_UNKNOWN_OPTION", `Unknown option for init: --${unknownFlag}.`, ["Run unitycli --help for the supported init options."]);
-    }
-    const projectPath = resolve(getString(flags, "project") ?? process.cwd());
-    const { checkPackageBridge, ensurePackageBridge, preparePackageBridgeInstall, PackageManagerError } = await import("../package-manager.js");
-    const { agentSkillInstaller, detectAgentKinds, findSkillSourcePath, parseAgentList, SkillInstallerError } = await import("./skill-installer.js");
-    const agentFlag = getString(flags, "agent");
-    const pkgOnly = getBoolean(flags, "pkg-only");
-    const skillOnly = getBoolean(flags, "skill-only");
-    const isCheck = getBoolean(flags, "check");
-    let checkIdentity;
-    if (isCheck) {
+import { closeUnityProjectProcesses, findUnityProjectProcesses } from "../unity-project-processes.js";
+import { handleInitDiscover } from "./init-discovery.js";
+import { handleInitHelp } from "./init-help.js";
+import { handleInitSkill } from "./init-skill.js";
+function initTimeout(flags) {
+    const raw = getString(flags, "timeout-ms");
+    if (raw === undefined)
+        return 60_000;
+    const value = Number(raw);
+    return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+}
+/** 只处理明确 Unity 项目的 canonical Bridge Package 安装或只读检查。 */
+async function handleInitPackage(args, flags, runtime, requestId) {
+    if (args.length)
+        return failure(requestId, "E_INIT_ARGUMENT_UNEXPECTED", "init package does not accept positional arguments.", ["Run `unitycli init package --project <UnityProject>` without additional positional arguments."]);
+    const projectFlag = getString(flags, "project");
+    if (!projectFlag)
+        return failure(requestId, "E_INIT_PROJECT_REQUIRED", "init package requires --project <UnityProject>.", ["Pass the root of one existing Unity project."], { option: "--project" });
+    const timeoutMs = initTimeout(flags);
+    if (timeoutMs === undefined)
+        return failure(requestId, "E_INIT_TIMEOUT_INVALID", "init package --timeout-ms must be a positive integer.", ["Pass --timeout-ms <positive-integer>."], { option: "--timeout-ms" });
+    const check = getBoolean(flags, "check");
+    const closeEditor = getBoolean(flags, "close-editor");
+    if (check && closeEditor)
+        return failure(requestId, "E_INIT_CLOSE_EDITOR_CHECK_FORBIDDEN", "init package --check is read-only and cannot close Unity Editor.", ["Remove either --check or --close-editor."], { option: "--close-editor" });
+    const absoluteDeadlineMs = Date.now() + timeoutMs;
+    const remaining = () => Math.max(0, absoluteDeadlineMs - Date.now());
+    try {
+        const identity = resolveProjectIdentity(resolve(projectFlag));
+        const { ensurePackageBridge, inspectPackageBridge, preparePackageBridgeInstall, PackageManagerError } = await import("../package-manager.js");
+        if (check) {
+            const inspection = await inspectPackageBridge(identity.canonicalProjectPath);
+            const nextActions = inspection.status === "installed" ? []
+                : inspection.status === "conflict"
+                    ? ["Resolve the reported assembly conflict, then rerun the same init package command."]
+                    : ["Run `unitycli init package --project <UnityProject>` to converge the Bridge package to the bundled version."];
+            return success(requestId, { action: "init_package_check", projectPath: identity.canonicalProjectPath, package: inspection, nextActions });
+        }
+        const findEditors = runtime.findUnityProjectProcesses ?? findUnityProjectProcesses;
+        let editors;
         try {
-            checkIdentity = resolveProjectIdentity(projectPath);
+            const observationBudgetMs = Math.min(3_000, remaining());
+            if (observationBudgetMs < 1)
+                throw new Error("installation deadline elapsed before Editor observation");
+            editors = await findEditors(identity.instanceId, identity.canonicalProjectPath, observationBudgetMs);
         }
-        catch (error) {
-            if (error instanceof ProjectIdentityError)
-                return failure(requestId, error.code, error.message, ["Pass the root of an existing Unity project."], error.details);
-            throw error;
+        catch {
+            throw new PackageManagerError("E_EDITOR_STATE_UNVERIFIABLE", "The exact target Unity Editor process state could not be verified before package installation.", ["Verify the target project is not open in Unity, then rerun init package."], { phase: "editor-observation" });
         }
-    }
-    const agentDetectionPath = checkIdentity?.canonicalProjectPath ?? projectPath;
-    const effectiveAgentFlag = agentFlag ?? (!pkgOnly ? (await detectAgentKinds(agentDetectionPath)).join(",") || undefined : undefined);
-    if (skillOnly && !effectiveAgentFlag)
-        return failure(requestId, "INVALID_INIT_FLAGS", "--skill-only requires --agent or an existing .pi/.claude/.agents directory in the project.", ["Create the target Agent directory first, or pass --agent <pi|claude|.agents> explicitly."]);
-    if (pkgOnly && skillOnly)
-        return failure(requestId, "INVALID_INIT_FLAGS", "--pkg-only and --skill-only are mutually exclusive.", ["Use exactly one init scope flag."]);
-    if (pkgOnly && agentFlag)
-        return failure(requestId, "INVALID_INIT_FLAGS", "--pkg-only and --agent are mutually exclusive; --pkg-only installs only the unity package.", ["Remove --agent or --pkg-only."]);
-    let agents = [];
-    try {
-        if (effectiveAgentFlag)
-            agents = parseAgentList(effectiveAgentFlag);
-    }
-    catch (error) {
-        if (error instanceof SkillInstallerError)
-            return failure(requestId, error.code, error.message, error.nextActions);
-        throw error;
-    }
-    // check 不写项目文件；canonical identity 保证 alias 与 install 共用同一 named mutex。
-    if (isCheck) {
-        try {
-            const canonicalProjectPath = checkIdentity.canonicalProjectPath;
-            const checkDeadlineMs = Date.now() + Math.max(1, Number(getString(flags, "timeout-ms")) || 60_000);
-            const result = { action: "init_check", projectPath: canonicalProjectPath };
-            if (!skillOnly) {
+        let editorClose;
+        if (editors.length > 0 && !closeEditor) {
+            throw new PackageManagerError("E_INIT_EDITOR_RUNNING", "The exact target Unity project is open and may hold Bridge package files.", ["Ask the user whether to close this exact Unity project, then rerun with --close-editor after approval."], { editorCount: editors.length });
+        }
+        if (closeEditor) {
+            if (editors.length === 0)
+                editorClose = { status: "not-running", requested: 0 };
+            else {
+                const closeEditors = runtime.closeUnityProjectProcesses ?? closeUnityProjectProcesses;
+                let closeResult;
                 try {
-                    result.package = { status: "installed", bridge: await checkPackageBridge(canonicalProjectPath), nextActions: ["Unity package com.alpsckr.unitycli is installed via copy mode in Packages/com.alpsckr.unitycli/."] };
+                    const closeBudgetMs = remaining();
+                    if (closeBudgetMs < 1)
+                        throw new Error("installation deadline elapsed before Editor close");
+                    closeResult = await closeEditors(editors, closeBudgetMs);
                 }
-                catch (error) {
-                    if (!(error instanceof PackageManagerError))
-                        throw error;
-                    result.package = { status: "not_installed", code: error.code, message: error.message };
+                catch {
+                    throw new PackageManagerError("E_EDITOR_CLOSE_FAILED", "The exact target Unity Editor could not be closed normally.", ["Close the exact target project normally, then rerun init package without --close-editor."], { phase: "editor-close" });
                 }
-            }
-            if (agents.length > 0) {
-                try {
-                    result.skills = await agentSkillInstaller.checkForAgents(agents, await findSkillSourcePath(), canonicalProjectPath, checkDeadlineMs);
-                }
-                catch (error) {
-                    if (error instanceof SkillInstallerError)
-                        return failure(requestId, error.code, error.message, error.nextActions);
-                    throw error;
+                if (closeResult.remaining > 0) {
+                    throw new PackageManagerError("E_EDITOR_CLOSE_BLOCKED", "The exact target Unity Editor remained open after a normal close request.", ["Resolve any unsaved-scene or modal prompt in Unity, close the project normally, then rerun init package."], { requested: closeResult.requested, remaining: closeResult.remaining });
                 }
+                editorClose = { status: "closed", requested: closeResult.requested };
             }
-            if (!skillOnly) {
-                const { checkExtensionBundles } = await import("../extensions/installer.js");
-                const physicalState = await checkExtensionBundles(canonicalProjectPath);
-                result.extensionPhysicalState = physicalState;
-                result.extensionSummary = {
-                    total: physicalState.length,
-                    dependencyInstalled: physicalState.filter((item) => item.dependencyInstalled).length,
-                    installed: physicalState.filter((item) => item.installed).length,
-                    unhealthy: physicalState.filter((item) => !item.installed || !item.dependencyInstalled).length
-                };
-                const { autoDetectExtensions } = await import("./extension-auto-detect.js");
-                result.extensions = await autoDetectExtensions(canonicalProjectPath, true);
-            }
-            return success(requestId, result);
-        }
-        catch (error) {
-            if (error instanceof ProjectIdentityError)
-                return failure(requestId, error.code, error.message, ["Pass the root of an existing Unity project."], error.details);
-            throw error;
-        }
-    }
-    try {
-        // 所有可预见校验和源/目标决议必须在唯一 effect barrier 前完成。
-        const identity = resolveProjectIdentity(projectPath);
-        const bridgePlan = skillOnly ? undefined : await preparePackageBridgeInstall(projectPath);
-        const skillSource = agents.length > 0 ? await findSkillSourcePath() : undefined;
-        const { autoDetectExtensions, autoDetectSummary } = await import("./extension-auto-detect.js");
-        const extensionPlan = !skillOnly && !pkgOnly ? await autoDetectExtensions(projectPath, true) : undefined;
-        const absoluteDeadlineMs = Date.now() + Math.max(1, Number(getString(flags, "timeout-ms")) || 60_000);
-        {
-            const result = { action: "init", projectPath: identity.canonicalProjectPath, projectIdentity: identity };
-            if (bridgePlan) {
-                const bridge = await ensurePackageBridge(projectPath, bridgePlan, { absoluteDeadlineMs });
-                const bridgeReadback = await checkPackageBridge(projectPath);
-                result.status = "package_installed";
-                result.package = { status: "package_installed", bridge, readback: bridgeReadback };
-                result.resolve = "filesystem_proven";
-            }
-            if (skillSource) {
-                if (Date.now() >= absoluteDeadlineMs)
-                    throw new PackageManagerError("E_EXECUTION_TIMEOUT", "The immutable init deadline elapsed before skill installation.");
-                const skills = await agentSkillInstaller.installForAgents(agents, skillSource, identity.canonicalProjectPath, absoluteDeadlineMs);
-                result.skills = await agentSkillInstaller.checkForAgents(agents, skillSource, identity.canonicalProjectPath, absoluteDeadlineMs);
-                result.skillChanges = skills.filter((item) => item.status === "updated").map((item) => ({ agent: item.agent, action: "overwritten", previousHash: item.previousHash, newHash: item.newHash }));
-            }
-            if (extensionPlan) {
-                if (Date.now() >= absoluteDeadlineMs)
-                    throw new PackageManagerError("E_EXECUTION_TIMEOUT", "The immutable init deadline elapsed before extension installation.");
-                const installed = await autoDetectExtensions(projectPath);
-                const { checkExtensionBundles } = await import("../extensions/installer.js");
-                result.extensions = installed;
-                result.extensionSummary = autoDetectSummary(installed);
-                result.extensionPhysicalState = await checkExtensionBundles(projectPath);
-            }
-            result.nextActions = ["Open or refresh the Unity project to import the copied package."];
-            return success(requestId, result);
         }
+        if (remaining() < 1)
+            throw new PackageManagerError("E_EXECUTION_TIMEOUT", "The immutable init deadline elapsed before Bridge package publication.", ["Inspect the project package state before submitting init again."]);
+        const plan = await preparePackageBridgeInstall(identity.canonicalProjectPath);
+        if (remaining() < 1)
+            throw new PackageManagerError("E_EXECUTION_TIMEOUT", "The immutable init deadline elapsed during Bridge package prevalidation.", ["Inspect the project package state before submitting init again."]);
+        const install = await ensurePackageBridge(identity.canonicalProjectPath, plan, { absoluteDeadlineMs });
+        const readback = await inspectPackageBridge(identity.canonicalProjectPath);
+        if (readback.status !== "installed")
+            throw new PackageManagerError("INIT_CHECK_FAILED", "Bridge package installation did not reach an installed readback state.", ["Inspect the returned package state before submitting init again."], { package: readback });
+        return success(requestId, {
+            action: "init_package",
+            projectPath: identity.canonicalProjectPath,
+            projectIdentity: identity,
+            ...(editorClose ? { editorClose } : {}),
+            package: { status: "installed", install, readback },
+            nextActions: ["Open or refresh this Unity project to import the copied Bridge package."],
+        });
     }
     catch (error) {
         if (error instanceof ProjectIdentityError)
             return failure(requestId, error.code, error.message, ["Pass the root of an existing Unity project."], error.details);
-        if (error instanceof SkillInstallerError)
-            return failure(requestId, error.code, error.message, error.nextActions);
+        const { PackageManagerError } = await import("../package-manager.js");
         if (error instanceof PackageManagerError)
-            return failure(requestId, error.code, error.message, error.nextActions);
-        if (error instanceof StructuredToolError)
-            return failure(requestId, error.code, error.message, error.nextActions, error.details, error.transient === undefined ? undefined : { transient: error.transient, retryAfterMs: error.retryAfterMs });
-        return failure(requestId, "E_EXECUTION_TIMEOUT", "The init result cannot be confirmed after the local operation stopped. Inspect the package, Skill, and extension state before retrying.", ["Check the project business state before submitting init again."], { reason: error instanceof Error ? error.message : String(error) });
+            return failure(requestId, error.code, error.message, error.nextActions, error.details, { transient: error.transient, retryAfterMs: error.retryAfterMs });
+        return failure(requestId, "INIT_PACKAGE_FAILED", error instanceof Error ? error.message : String(error), ["Inspect the project and bundled package source before retrying."]);
     }
 }
+/** 唯一 init 控制面分发；不保留裸 init 或旧混装 flag。 */
+export async function handleInit(command, args, flags, runtime, requestId) {
+    if (command === "help")
+        return handleInitHelp(args, flags, requestId);
+    if (command === "discover")
+        return handleInitDiscover(args, flags, runtime, requestId);
+    if (command === "package")
+        return handleInitPackage(args, flags, runtime, requestId);
+    if (command === "skill")
+        return handleInitSkill(args, flags, runtime, requestId);
+    return failure(requestId, "UNKNOWN_INIT_COMMAND", command ? `Unknown init command: ${command}.` : "init requires help, discover, package, or skill.", ["Run `unitycli init help`."]);
+}
 //# sourceMappingURL=package.js.map

package/dist/cli-commands/package.js.map

@@ -1 +1 @@
-{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/cli-commands/package.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/cli-commands/package.ts"],"names":[],"mappings":"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"}

package/dist/cli-commands/skill-installer.d.ts

@@ -1,28 +1,38 @@
 /** Supported agent identifiers for skill installation. */
-export type AgentKind = "pi" | "claude" | ".agents";
+export type AgentKind = "claude" | ".agents";
 /** All valid agent kinds. */
 export declare const AGENT_KINDS: readonly AgentKind[];
-/** Result of installing a skill for a single agent. */
-export interface SkillInstallResult {
-    agent: AgentKind;
+/** 一个明确Skill bundle目标的安装结果。 */
+export interface SkillTargetInstallResult {
     targetPath: string;
     status: "installed" | "skipped" | "updated";
-    /** Populated when status is "skipped" (hash match). */
     hash?: string;
-    /** Populated when status is "updated" (hash mismatch, overwritten). */
     previousHash?: string;
     newHash?: string;
 }
-/** Result of checking a skill for a single agent. */
-export interface SkillCheckResult {
+/** 一个预设agent目标的安装结果。 */
+export interface SkillInstallResult extends SkillTargetInstallResult {
     agent: AgentKind;
+}
+/** 一个明确Skill bundle目标的检查结果。 */
+export interface SkillTargetCheckResult {
     targetPath: string;
     status: "installed" | "missing" | "outdated";
     hash?: string;
     sourceHash?: string;
 }
-/** 探测项目中已存在的 Agent 目录,用于 init 默认安装 Skill。 */
-export declare function detectAgentKinds(projectRoot: string): Promise<AgentKind[]>;
+/** 一个预设agent目标的检查结果。 */
+export interface SkillCheckResult extends SkillTargetCheckResult {
+    agent: AgentKind;
+}
+export interface SkillTargetInspection {
+    status: "installed" | "missing" | "drifted" | "damaged";
+    targetPath: string;
+    sourceHash: string;
+    hash?: string;
+    message?: string;
+}
+export declare function resolveSkillTarget(basePath: string, agent: AgentKind): string;
 /**
  * Resolve the source SKILL.md path by walking up from the current CLI module
  * location to find the package root that contains
@@ -34,6 +44,8 @@ export declare function resolveSkillSourcePath(metaUrl?: string): string;
  * package root contains the published UnityCLI Skill bundle.
  */
 export declare function findSkillSourcePath(startDir?: string): Promise<string>;
+/** 仅测试使用：在读取既有target前制造底层文件系统失败。 */
+export declare function setBeforeSkillTargetLoadForTest(hook: (() => Promise<void>) | undefined): void;
 /** 仅测试使用：在 target 保持完整时、首次发布写入前制造等待或失败。 */
 export declare function setBeforeSkillPublishForTest(hook: (() => Promise<void>) | undefined): void;
 /** 仅测试使用：在 staging 已发布、readback 前制造损坏。 */
@@ -42,13 +54,17 @@ export declare function setAfterSkillPublishForTest(hook: (() => Promise<void>)
 export declare function setBeforeSkillRollbackForTest(hook: (() => Promise<void>) | undefined): void;
 /** 仅测试使用：模拟新 target 已提交、previous 尚未清理时进程中断。 */
 export declare function setBeforeSkillPreviousCleanupForTest(hook: (() => Promise<void>) | undefined): void;
+/** 不获取安装 mutex、不写文件，只读比较一个明确 Skill target 与 bundled source。 */
+export declare function inspectSkillTarget(sourcePath: string, targetPath: string): Promise<SkillTargetInspection>;
+export declare function installSkillTarget(sourcePath: string, targetRoot: string, installRoot: string, absoluteDeadlineMs?: number): Promise<SkillTargetInstallResult>;
+export declare function checkSkillTarget(sourcePath: string, targetRoot: string, absoluteDeadlineMs?: number): Promise<SkillTargetCheckResult>;
 export interface SkillInstaller {
     /** Agent kind this installer handles. */
     readonly agent: AgentKind;
     /** Resolve the target SKILL.md path for the given project root. */
     resolveTargetPath(projectRoot: string): string;
     /** Install the complete runtime Skill bundle within one immutable deadline. */
-    install(sourcePath: string, projectRoot: string, absoluteDeadlineMs?: number): Promise<SkillInstallResult>;
+    install(sourcePath: string, projectRoot: string, absoluteDeadlineMs?: number, installRoot?: string): Promise<SkillInstallResult>;
     /** Check the complete runtime Skill bundle without writing. */
     check(sourcePath: string, projectRoot: string, absoluteDeadlineMs?: number): Promise<SkillCheckResult>;
 }
@@ -61,9 +77,9 @@ export declare class AgentSkillInstallerRegistry {
     agents(): AgentKind[];
     /**
      * Install the skill for the specified agents.
-     * @param agents Comma-separated or array of agent kinds (e.g. "pi,claude")
+     * @param agents Comma-separated or array of agent kinds (e.g. "claude,.agents")
      */
-    installForAgents(agents: string | AgentKind[], sourcePath: string, projectRoot: string, absoluteDeadlineMs?: number): Promise<SkillInstallResult[]>;
+    installForAgents(agents: string | AgentKind[], sourcePath: string, projectRoot: string, absoluteDeadlineMs?: number, installRoot?: string): Promise<SkillInstallResult[]>;
     /**
      * Check skill status for the specified agents.
      * @param agents Comma-separated or array of agent kinds