@alpsckr/unitycli 0.4.0 → 0.4.1

package/dist/cli-commands/init-discovery.js

@@ -0,0 +1,175 @@
+import { lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { failure, success } from "../output.js";
+import { findSkillSourcePath, inspectSkillTarget, resolveSkillTarget } from "./skill-installer.js";
+const maxDescendantDepth = 4;
+const maxScannedDirectories = 2000;
+const maxUnityProjects = 100;
+const maxWorkspaceCandidates = 20;
+const ignoredDirectories = new Set([".git", "node_modules", "library", "temp", "logs", "obj"]);
+async function directoryExists(path) { try {
+    return (await stat(path)).isDirectory();
+}
+catch {
+    return false;
+} }
+async function readUnityVersion(path) {
+    try {
+        return /^m_EditorVersion:\s*(.+?)\s*$/m.exec(await readFile(join(path, "ProjectSettings", "ProjectVersion.txt"), "utf8"))?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+async function unityProjectCandidate(path, relation, depth) {
+    try {
+        const info = await lstat(path);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            return undefined;
+        const [assets, manifest, unityVersion] = await Promise.all([
+            directoryExists(join(path, "Assets")),
+            readFile(join(path, "Packages", "manifest.json"), "utf8").then((text) => { JSON.parse(text); return true; }).catch(() => false),
+            readUnityVersion(path),
+        ]);
+        return assets && manifest && unityVersion ? { path: await realpath(path), unityVersion, relation, depth } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function pathIdentity(path) { return process.platform === "win32" ? path.toLowerCase() : path; }
+async function findRepositoryRoot(cwd) {
+    let current = cwd;
+    for (let depth = 0; depth < 64; depth += 1) {
+        try {
+            await lstat(join(current, ".git"));
+            return current;
+        }
+        catch { /* continue */ }
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+async function discoverUnityProjects(cwd) {
+    const projects = [];
+    const identities = new Set();
+    const add = (candidate) => {
+        if (!candidate || projects.length >= maxUnityProjects || identities.has(pathIdentity(candidate.path)))
+            return;
+        identities.add(pathIdentity(candidate.path));
+        projects.push(candidate);
+    };
+    let ancestor = cwd;
+    for (let depth = 0; depth < 64; depth += 1) {
+        add(await unityProjectCandidate(ancestor, depth === 0 ? "cwd" : "ancestor", depth));
+        const parent = dirname(ancestor);
+        if (parent === ancestor)
+            break;
+        ancestor = parent;
+    }
+    const queue = [{ path: cwd, depth: 0 }];
+    let scannedDirectories = 0;
+    let truncated = false;
+    for (let index = 0; index < queue.length; index += 1) {
+        const item = queue[index];
+        if (++scannedDirectories > maxScannedDirectories || projects.length >= maxUnityProjects) {
+            truncated = true;
+            break;
+        }
+        if (item.depth > 0)
+            add(await unityProjectCandidate(item.path, "descendant", item.depth));
+        if (item.depth >= maxDescendantDepth)
+            continue;
+        let entries;
+        try {
+            entries = await readdir(item.path, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries.sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0)) {
+            if (!entry.isDirectory() || entry.isSymbolicLink() || ignoredDirectories.has(entry.name.toLowerCase()))
+                continue;
+            if (queue.length >= maxScannedDirectories) {
+                truncated = true;
+                break;
+            }
+            queue.push({ path: join(item.path, entry.name), depth: item.depth + 1 });
+        }
+    }
+    projects.sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);
+    return { projects, scannedDirectories: Math.min(scannedDirectories, maxScannedDirectories), truncated };
+}
+function workspaceCandidates(cwd, repositoryRoot, projects) {
+    const values = [{ path: cwd, reason: "current-working-directory" }];
+    if (repositoryRoot && pathIdentity(repositoryRoot) !== pathIdentity(cwd))
+        values.push({ path: repositoryRoot, reason: "repository-root" });
+    for (const project of projects)
+        values.push({ path: dirname(project.path), reason: "unity-project-parent" });
+    const seen = new Set();
+    return values.filter((item) => { const id = pathIdentity(item.path); if (seen.has(id) || seen.size >= maxWorkspaceCandidates)
+        return false; seen.add(id); return true; });
+}
+export async function discoverInitEnvironment(cwdInput, userHomeInput) {
+    const cwd = await realpath(resolve(cwdInput));
+    const userHome = await realpath(resolve(userHomeInput));
+    const repositoryRoot = await findRepositoryRoot(cwd);
+    const discovery = await discoverUnityProjects(cwd);
+    const workspaces = workspaceCandidates(cwd, repositoryRoot, discovery.projects);
+    const sourcePath = await findSkillSourcePath();
+    const copies = [];
+    for (const workspace of workspaces)
+        for (const agent of [".agents", "claude"]) {
+            const targetPath = resolveSkillTarget(workspace.path, agent);
+            copies.push({ scope: "workspace", workspace: workspace.path, agent, ...await inspectSkillTarget(sourcePath, targetPath) });
+        }
+    for (const agent of [".agents", "claude"]) {
+        const targetPath = resolveSkillTarget(userHome, agent);
+        copies.push({ scope: "user", agent, ...await inspectSkillTarget(sourcePath, targetPath) });
+    }
+    const shadowingRisks = [".agents", "claude"].flatMap((agent) => {
+        const matches = copies.filter((copy) => copy.agent === agent && copy.status !== "missing");
+        if (matches.length < 2)
+            return [];
+        return [{
+                skill: "unitycli",
+                agent,
+                precedence: agent === "claude" ? ["user", "workspace"] : ["workspace", "user"],
+                copies: matches,
+                note: agent === "claude" ? "Claude personal skills override workspace skills." : "Generic Agent Skills commonly prefer workspace skills over user skills.",
+            }];
+    });
+    return {
+        action: "init_discover", cwd, repositoryRoot: repositoryRoot ?? null,
+        limits: { maxDescendantDepth, maxScannedDirectories, maxUnityProjects, maxWorkspaceCandidates },
+        scan: { scannedDirectories: discovery.scannedDirectories, truncated: discovery.truncated },
+        unityProjects: discovery.projects, skillWorkspaces: workspaces, skillCopies: copies,
+        shadowingRisks,
+        requiredDecisions: [
+            { id: "bridgeProjects", question: "Which discovered Unity projects should receive the UnityCLI Bridge?", choices: discovery.projects.map((project) => project.path), multiple: true },
+            { id: "skillAgent", question: "Which Skill host should be configured?", choices: [".agents", "claude"], multiple: false },
+            { id: "skillScope", question: "Should the Skill be installed for one workspace or for the current user?", choices: ["workspace", "user"], multiple: false },
+            { id: "skillWorkspace", question: "If workspace scope is selected, which directory is the user's normal AI working directory?", choices: workspaces.map((workspace) => workspace.path), multiple: false },
+        ],
+        nextActions: ["Ask the user every required decision before running any installation effect.", "Use the exact command templates returned by `unitycli init help` after the user answers."],
+    };
+}
+/** 从当前工作目录有界发现安装现场，不修改文件或进程。 */
+export async function handleInitDiscover(args, flags, requestId) {
+    if (args.length)
+        return failure(requestId, "E_INIT_ARGUMENT_UNEXPECTED", "init discover does not accept positional arguments.", ["Run `unitycli init discover` without additional arguments."]);
+    const unknown = Object.keys(flags).find((name) => name !== "pretty");
+    if (unknown)
+        return failure(requestId, "E_UNKNOWN_OPTION", `Unknown option for init discover: --${unknown}.`, ["Run `unitycli init discover` without options."], { option: `--${unknown}` });
+    try {
+        return success(requestId, await discoverInitEnvironment(process.cwd(), homedir()));
+    }
+    catch (error) {
+        return failure(requestId, "INIT_DISCOVERY_FAILED", error instanceof Error ? error.message : String(error), ["Run `unitycli init discover` from an existing readable working directory."]);
+    }
+}
+//# sourceMappingURL=init-discovery.js.map

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

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

package/dist/cli-commands/init-help.d.ts

@@ -0,0 +1,3 @@
+import type { CliResult } from "../types.js";
+/** 返回静态、自足、无现场读取的 AI 安装协议。 */
+export declare function handleInitHelp(args: string[], flags: Record<string, string | boolean>, requestId: string): CliResult;

package/dist/cli-commands/init-help.js

@@ -0,0 +1,37 @@
+import { failure, success } from "../output.js";
+const commands = {
+    discover: "unitycli init discover",
+    packageInstall: "unitycli init package --project <UnityProject>",
+    packageCheck: "unitycli init package --project <UnityProject> --check",
+    workspaceSkillInstall: "unitycli init skill --agent <.agents|claude> --scope workspace --workspace <path>",
+    workspaceSkillCheck: "unitycli init skill --agent <.agents|claude> --scope workspace --workspace <path> --check",
+    userSkillInstall: "unitycli init skill --agent <.agents|claude> --scope user",
+    userSkillCheck: "unitycli init skill --agent <.agents|claude> --scope user --check",
+};
+/** 返回静态、自足、无现场读取的 AI 安装协议。 */
+export function handleInitHelp(args, flags, requestId) {
+    if (args.length)
+        return failure(requestId, "E_INIT_ARGUMENT_UNEXPECTED", "init help does not accept positional arguments.", ["Run `unitycli init help` without additional arguments."]);
+    const unknown = Object.keys(flags).find((name) => name !== "pretty");
+    if (unknown)
+        return failure(requestId, "E_UNKNOWN_OPTION", `Unknown option for init help: --${unknown}.`, ["Run `unitycli init help` without options."], { option: `--${unknown}` });
+    return success(requestId, {
+        action: "init_help",
+        audience: "ai",
+        protocolVersion: 1,
+        aiInstructions: [
+            "Run `unitycli init discover` from the user's current working directory before making installation decisions.",
+            "Use discovery.requiredDecisions to ask the user which discovered Unity projects should receive the Bridge and which single Skill agent/scope/workspace target should be configured; do not infer or silently choose these values.",
+            "For multiple selected Unity projects, run one `init package` call at a time in strict serial order. Wait for and verify each terminal result before submitting the next call.",
+            "Install the UnityCLI Skill only once at the user-selected `.agents` or Claude workspace/user target unless the user explicitly requests more targets.",
+            "After every successful package or Skill installation, run the corresponding command with `--check` and verify its business status.",
+            "Stop immediately after the first unexpected CLI failure or failed business check. Report that terminal result and do not retry, change parameters, or continue with later installation effects.",
+            "Do not start, close, restart, or terminate Unity Editor as part of installation. Package import occurs when the user next opens or refreshes the selected project.",
+            "CLI installation calls are the authorized effects after the user answers the required decisions; do not add another confirmation gate.",
+        ],
+        commands,
+        nextCommand: commands.discover,
+        nextActions: [commands.discover],
+    });
+}
+//# sourceMappingURL=init-help.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-help.js","sourceRoot":"","sources":["../../src/cli-commands/init-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,QAAQ,GAAG;IACf,QAAQ,EAAE,wBAAwB;IAClC,cAAc,EAAE,gDAAgD;IAChE,YAAY,EAAE,wDAAwD;IACtE,qBAAqB,EAAE,mFAAmF;IAC1G,mBAAmB,EAAE,2FAA2F;IAChH,gBAAgB,EAAE,2DAA2D;IAC7E,cAAc,EAAE,mEAAmE;CAC3E,CAAC;AAEX,8BAA8B;AAC9B,MAAM,UAAU,cAAc,CAAC,IAAc,EAAE,KAAuC,EAAE,SAAiB;IACvG,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,SAAS,EAAE,4BAA4B,EAAE,iDAAiD,EAAE,CAAC,wDAAwD,CAAC,CAAC,CAAC;IACxL,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACrE,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,SAAS,EAAE,kBAAkB,EAAE,mCAAmC,OAAO,GAAG,EAAE,CAAC,2CAA2C,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;IACrL,OAAO,OAAO,CAAC,SAAS,EAAE;QACxB,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,CAAC;QAClB,cAAc,EAAE;YACd,8GAA8G;YAC9G,mOAAmO;YACnO,+KAA+K;YAC/K,uJAAuJ;YACvJ,oIAAoI;YACpI,iMAAiM;YACjM,oKAAoK;YACpK,wIAAwI;SACzI;QACD,QAAQ;QACR,WAAW,EAAE,QAAQ,CAAC,QAAQ;QAC9B,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACjC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { CliResult } from "../types.js";
+import { type AgentKind } from "./skill-installer.js";
+import type { Runtime } from "./types.js";
+export type SkillScope = "workspace" | "user";
+export declare function resolveInitSkillTarget(agent: AgentKind, scope: SkillScope, workspace: string | undefined, userHome: string): {
+    basePath: string;
+    targetPath: string;
+};
+/** 安装或只读检查一个明确 agent/scope Skill target。 */
+export declare function handleInitSkill(args: string[], flags: Record<string, string | boolean>, runtime: Runtime, requestId: string): Promise<CliResult>;

package/dist/cli-commands/init-skill.js

@@ -0,0 +1,105 @@
+import { lstat, realpath, rm } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { getBoolean, getString } from "../args.js";
+import { failure, success } from "../output.js";
+import { agentSkillInstaller, findSkillSourcePath, inspectSkillTarget, parseAgentList, resolveSkillTarget, SkillInstallerError } from "./skill-installer.js";
+export function resolveInitSkillTarget(agent, scope, workspace, userHome) {
+    const basePath = scope === "user" ? resolve(userHome) : resolve(workspace);
+    return { basePath, targetPath: resolveSkillTarget(basePath, agent) };
+}
+async function assertRealDirectory(path, label) {
+    try {
+        const info = await lstat(path);
+        if (!info.isDirectory() || info.isSymbolicLink())
+            throw new Error("not a real directory");
+        return await realpath(path);
+    }
+    catch {
+        throw new SkillInstallerError("E_SKILL_ROOT_INVALID", `${label} must be an existing real directory: ${path}`, [`Pass an existing non-linked ${label.toLowerCase()} path.`]);
+    }
+}
+async function rejectLinkedTargetAncestors(basePath, agent) {
+    const agentRoot = join(basePath, agent === ".agents" ? ".agents" : ".claude");
+    for (const path of [agentRoot, join(agentRoot, "skills"), join(agentRoot, "skills", "unitycli")]) {
+        try {
+            const info = await lstat(path);
+            if (info.isSymbolicLink() || !info.isDirectory())
+                throw new SkillInstallerError("E_SKILL_TARGET_UNSAFE", `Skill target ancestor must be a real directory: ${path}`, ["Replace the linked or non-directory target ancestor before retrying."]);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                continue;
+            throw error;
+        }
+    }
+}
+function timeout(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;
+}
+/** 安装或只读检查一个明确 agent/scope Skill target。 */
+export async function handleInitSkill(args, flags, runtime, requestId) {
+    if (args.length)
+        return failure(requestId, "E_INIT_ARGUMENT_UNEXPECTED", "init skill does not accept positional arguments.", ["Run `unitycli init skill` using only documented options."]);
+    const agentRaw = getString(flags, "agent");
+    const scopeRaw = getString(flags, "scope");
+    if (!agentRaw)
+        return failure(requestId, "E_INIT_AGENT_REQUIRED", "init skill requires --agent <.agents|claude>.", ["Choose the Skill host after asking the user."], { option: "--agent" });
+    let agent;
+    try {
+        const agents = parseAgentList(agentRaw);
+        if (agents.length !== 1)
+            throw new SkillInstallerError("E_INIT_AGENT_INVALID", "init skill accepts exactly one agent target.", ["Pass either --agent .agents or --agent claude."]);
+        agent = agents[0];
+    }
+    catch (error) {
+        if (error instanceof SkillInstallerError)
+            return failure(requestId, error.code, error.message, error.nextActions);
+        throw error;
+    }
+    if (scopeRaw !== "workspace" && scopeRaw !== "user")
+        return failure(requestId, "E_INIT_SCOPE_INVALID", "init skill requires --scope <workspace|user>.", ["Ask the user whether this Skill belongs to one workspace or the current user."], { option: "--scope", actual: scopeRaw ?? null });
+    const scope = scopeRaw;
+    const workspaceRaw = getString(flags, "workspace");
+    if (scope === "workspace" && !workspaceRaw)
+        return failure(requestId, "E_INIT_WORKSPACE_REQUIRED", "Workspace Skill scope requires --workspace <path>.", ["Pass the user's normal AI working directory."], { option: "--workspace" });
+    if (scope === "user" && workspaceRaw)
+        return failure(requestId, "E_INIT_WORKSPACE_FORBIDDEN", "User Skill scope does not accept --workspace.", ["Remove --workspace or choose --scope workspace."], { option: "--workspace" });
+    const timeoutMs = timeout(flags);
+    if (timeoutMs === undefined)
+        return failure(requestId, "E_INIT_TIMEOUT_INVALID", "init skill --timeout-ms must be a positive integer.", ["Pass --timeout-ms <positive-integer>."], { option: "--timeout-ms" });
+    try {
+        const baseCandidate = scope === "user" ? resolve(runtime.userHome ?? homedir()) : resolve(workspaceRaw);
+        const basePath = await assertRealDirectory(baseCandidate, scope === "user" ? "User home" : "Workspace");
+        await rejectLinkedTargetAncestors(basePath, agent);
+        const targetPath = resolveSkillTarget(basePath, agent);
+        const sourcePath = await findSkillSourcePath();
+        if (getBoolean(flags, "check")) {
+            const inspection = await inspectSkillTarget(sourcePath, targetPath);
+            const installCommand = scope === "workspace"
+                ? `unitycli init skill --agent ${agent} --scope workspace --workspace ${JSON.stringify(basePath)}`
+                : `unitycli init skill --agent ${agent} --scope user`;
+            return success(requestId, { action: "init_skill_check", agent, scope, ...(scope === "workspace" ? { workspace: basePath } : {}), skill: inspection, nextActions: inspection.status === "installed" ? [] : [installCommand] });
+        }
+        const installRoot = scope === "user"
+            ? join(runtime.dataDir, ".temp", "skill-install", agent === ".agents" ? "agents" : agent)
+            : join(basePath, agent === ".agents" ? ".agents" : ".claude", "skills", ".unitycli-install");
+        const deadlineMs = Date.now() + timeoutMs;
+        const changes = await agentSkillInstaller.installForAgents([agent], sourcePath, basePath, deadlineMs, installRoot);
+        const inspection = await inspectSkillTarget(sourcePath, targetPath);
+        if (inspection.status !== "installed")
+            throw new SkillInstallerError("E_SKILL_INSTALL_PROJECTION_INVALID", "Skill installation did not reach an installed readback state.", ["Inspect the reported target before retrying."]);
+        await rm(installRoot, { recursive: true, force: true });
+        return success(requestId, { action: "init_skill", agent, scope, ...(scope === "workspace" ? { workspace: basePath } : {}), changes, skill: inspection, nextActions: ["Run the same init skill command with --check."] });
+    }
+    catch (error) {
+        if (error instanceof SkillInstallerError)
+            return failure(requestId, error.code, error.message, error.nextActions);
+        return failure(requestId, "INIT_SKILL_FAILED", error instanceof Error ? error.message : String(error), ["Inspect the Skill source and selected target before retrying."]);
+    }
+}
+//# sourceMappingURL=init-skill.js.map

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

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

package/dist/cli-commands/instances.d.ts

@@ -0,0 +1,4 @@
+import type { CliResult } from "../types.js";
+import type { Runtime } from "./types.js";
+/** 顶层instances控制面：list纯读取，prune只授权当前Unity writer执行同一清理函数。 */
+export declare function handleInstances(command: string | undefined, flags: Record<string, string | boolean>, runtime: Runtime, requestId: string): Promise<CliResult>;

package/dist/cli-commands/instances.js

@@ -0,0 +1,90 @@
+import { executeBridgePayload, SessionSupervisor, SessionSupervisorError } from "../bridge/index.js";
+import { handleInstancesCommand, instanceSelectionFailure } from "../instances.js";
+import { failure, success } from "../output.js";
+const DEFAULT_PRUNE_TIMEOUT_MS = 30_000;
+/** 顶层instances控制面：list纯读取，prune只授权当前Unity writer执行同一清理函数。 */
+export async function handleInstances(command, flags, runtime, requestId) {
+    const subCommand = command ?? "list";
+    if (subCommand !== "prune")
+        return handleInstancesCommand(subCommand, flags, runtime.dataDir, requestId);
+    return runWriterOwnedPrune(flags, runtime, requestId);
+}
+async function runWriterOwnedPrune(flags, runtime, requestId) {
+    const rawTimeout = flags["timeout-ms"];
+    const timeoutMs = rawTimeout === undefined ? DEFAULT_PRUNE_TIMEOUT_MS : typeof rawTimeout === "string" ? Number(rawTimeout) : Number.NaN;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) {
+        return failure(requestId, "E_SCHEMA_INVALID", "instances prune --timeout-ms must be a positive integer.", ["Pass --timeout-ms <positive-integer>."]);
+    }
+    const startedAtMs = Date.now();
+    const supervisor = new SessionSupervisor(flags, runtime);
+    try {
+        const admission = await supervisor.acquireRootAdmission({
+            requestId,
+            command: "instances.prune",
+            input: {},
+            dryRun: false,
+            target: "editor",
+            completionContractIdentity: "instances-prune-v1",
+            timeoutMs,
+            admissionAbsoluteDeadlineMs: startedAtMs + timeoutMs,
+        });
+        const result = await executeBridgePayload(requestId, "internal.instances.prune", {}, { ...flags, instance: admission.instanceId }, { ...runtime, rootAdmission: admission }, undefined, {
+            mode: "execute",
+            mutation: true,
+            absoluteDeadlineMs: admission.executionAbsoluteDeadlineMs,
+        });
+        await supervisor.completeRootAdmission(admission);
+        if (!result.ok)
+            return result;
+        const normalized = pruneResult(result.data);
+        if (!normalized) {
+            return failure(requestId, "E_BRIDGE_RESPONSE_INVALID", "Unity returned an invalid instances prune result.", [
+                "Update the selected UnityCLI Package so it matches the current CLI, then retry instances prune.",
+            ]);
+        }
+        return success(requestId, normalized);
+    }
+    catch (error) {
+        const selection = instanceSelectionFailure(requestId, error);
+        if (selection)
+            return selection;
+        if (error instanceof SessionSupervisorError) {
+            return failure(requestId, error.code, error.message, error.nextActions, error.details, {
+                transient: error.transient,
+                retryAfterMs: error.retryAfterMs,
+            });
+        }
+        return failure(requestId, "BRIDGE_CONNECTION_FAILED", error instanceof Error ? error.message : String(error), [
+            "Open the target Unity project, then retry unitycli instances prune from that project or pass --instance <id|projectPath|alias>.",
+        ], undefined, { transient: true, retryAfterMs: 100 });
+    }
+}
+function pruneResult(value) {
+    if (!exactObject(value, ["removed", "remaining", "deferred", "scanned", "truncated", "retention"]))
+        return undefined;
+    const root = value;
+    if (![root.removed, root.remaining, root.deferred, root.scanned].every(nonnegativeInteger) || typeof root.truncated !== "boolean")
+        return undefined;
+    if (!exactObject(root.retention, ["offlineMax", "damagedMax", "maxAgeDays", "scanLimit", "deleteLimit"]))
+        return undefined;
+    const retention = root.retention;
+    if (retention.offlineMax !== 100 || retention.damagedMax !== 20 || retention.maxAgeDays !== 30
+        || retention.scanLimit !== 2000 || retention.deleteLimit !== 20)
+        return undefined;
+    return {
+        removed: root.removed,
+        remaining: root.remaining,
+        deferred: root.deferred,
+        scanned: root.scanned,
+        truncated: root.truncated,
+        retention: { offlineMax: 100, damagedMax: 20, maxAgeDays: 30, scanLimit: 2000, deleteLimit: 20 },
+    };
+}
+function exactObject(value, keys) {
+    return !!value && typeof value === "object" && !Array.isArray(value)
+        && Object.keys(value).length === keys.length && keys.every((key) => Object.prototype.hasOwnProperty.call(value, key));
+}
+function nonnegativeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+//# sourceMappingURL=instances.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../src/cli-commands/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAExC,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA2B,EAC3B,KAAuC,EACvC,OAAgB,EAChB,SAAiB;IAEjB,MAAM,UAAU,GAAG,OAAO,IAAI,MAAM,CAAC;IACrC,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,sBAAsB,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzG,OAAO,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,KAAuC,EAAE,OAAgB,EAAE,SAAiB;IAC7G,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IACzI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC,SAAS,EAAE,kBAAkB,EAAE,0DAA0D,EAAE,CAAC,uCAAuC,CAAC,CAAC,CAAC;IACvJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,oBAAoB,CAAC;YACtD,SAAS;YACT,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,QAAQ;YAChB,0BAA0B,EAAE,oBAAoB;YAChD,SAAS;YACT,2BAA2B,EAAE,WAAW,GAAG,SAAS;SACrD,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,0BAA0B,EAAE,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE;YACtL,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,kBAAkB,EAAE,SAAS,CAAC,2BAA2B;SAC1D,CAAC,CAAC;QACH,MAAM,UAAU,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,SAAS,EAAE,2BAA2B,EAAE,mDAAmD,EAAE;gBAC1G,iGAAiG;aAClG,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7D,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE;gBACrF,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;aACjC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC5G,iIAAiI;SAClI,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAiBD,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrH,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACpJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3H,MAAM,SAAS,GAAG,IAAI,CAAC,SAAoC,CAAC;IAC5D,IAAI,SAAS,CAAC,UAAU,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,KAAK,EAAE,IAAI,SAAS,CAAC,UAAU,KAAK,EAAE;WACzF,SAAS,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,WAAW,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACpF,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAiB;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAmB;QACnC,QAAQ,EAAE,IAAI,CAAC,QAAkB;QACjC,OAAO,EAAE,IAAI,CAAC,OAAiB;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;KACjG,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,IAAc;IACjD,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;WAC/D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1H,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC"}

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

@@ -1,4 +1,4 @@
 import type { CliResult } from "../types.js";
 import type { Runtime } from "./types.js";
-/** 安装 Core package、Agent Skill 和自动检测 Extension，并只返回文件系统 readback。 */
-export declare function handleInit(flags: Record<string, string | boolean>, runtime: Runtime, requestId: string): Promise<CliResult>;
+/** 唯一 init 控制面分发；不保留裸 init 或旧混装 flag。 */
+export declare function handleInit(command: string | undefined, args: string[], flags: Record<string, string | boolean>, runtime: Runtime, requestId: string): Promise<CliResult>;