@alpsckr/unitycli 0.4.0

package/dist/tools/package/embed.js.map

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

package/dist/tools/package/file-mutation-worker.d.ts

@@ -0,0 +1,6 @@
+export type PackageFileMutationOperation = "install" | "remove" | "deploy" | "restore";
+/**
+ * Package 文件 mutation 在独立 Worker 内执行。调用方只有在 Worker 已退出后才会拿到结果，
+ * 因而可以在随后提交 proof/failure 并安全释放跨进程 mutation lease。
+ */
+export declare function runPackageFileMutationWorker(operation: PackageFileMutationOperation, projectPath: string, plan: Record<string, unknown>, stopAtMs: number, signal: AbortSignal): Promise<Record<string, unknown>>;

package/dist/tools/package/file-mutation-worker.js

@@ -0,0 +1,154 @@
+import { Worker, isMainThread, parentPort, workerData } from "node:worker_threads";
+import { deployPackageSource, installPackage, removePackage, restoreDeployedPackage, } from "../../package-manager.js";
+/**
+ * Package 文件 mutation 在独立 Worker 内执行。调用方只有在 Worker 已退出后才会拿到结果，
+ * 因而可以在随后提交 proof/failure 并安全释放跨进程 mutation lease。
+ */
+export async function runPackageFileMutationWorker(operation, projectPath, plan, stopAtMs, signal) {
+    if (!Number.isFinite(stopAtMs) || stopAtMs <= Date.now())
+        throw deadlineError();
+    signal.throwIfAborted();
+    const worker = new Worker(new URL("./file-mutation-worker.js", import.meta.url), {
+        workerData: { operation, projectPath, plan, stopAtMs },
+    });
+    let result;
+    let workerError;
+    let aborted = false;
+    const abort = () => {
+        aborted = true;
+        void worker.terminate();
+    };
+    signal.addEventListener("abort", abort, { once: true });
+    try {
+        await new Promise((resolve, reject) => {
+            worker.once("message", (message) => { result = message; });
+            worker.once("error", (error) => { workerError = error; });
+            worker.once("exit", (code) => {
+                if (aborted) {
+                    reject(deadlineError());
+                    return;
+                }
+                if (workerError) {
+                    reject(workerError);
+                    return;
+                }
+                if (code !== 0 || !result) {
+                    reject(deadlineError());
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+    finally {
+        signal.removeEventListener("abort", abort);
+    }
+    if (!result)
+        throw deadlineError();
+    if (!result.ok) {
+        const error = new Error(result.error.message);
+        error.code = result.error.code;
+        error.nextActions = result.error.nextActions;
+        throw error;
+    }
+    return result.result;
+}
+/** Worker 只接受父进程冻结的计划；硬截止时间到达时直接结束当前 Worker。 */
+async function executeWorker(input) {
+    switch (input.operation) {
+        case "install":
+            return await installPackage(input.projectPath, {
+                name: requiredString(input.plan, "name"),
+                version: requiredString(input.plan, "version"),
+            });
+        case "remove":
+            return await removePackage(input.projectPath, requiredString(input.plan, "name"), {
+                force: requiredBoolean(input.plan, "force"),
+            });
+        case "deploy": {
+            const plannedBackupPath = optionalString(input.plan, "backupPath");
+            const expectedPreState = {
+                sourcePath: requiredString(input.plan, "sourcePath"),
+                sourceHash: requiredString(input.plan, "sourceHash"),
+                targetExists: requiredBoolean(input.plan, "previousTargetExists"),
+                ...(optionalString(input.plan, "previousTargetHash") ? { targetHash: optionalString(input.plan, "previousTargetHash") } : {}),
+                recordIdentity: requiredString(input.plan, "previousRecordIdentity"),
+                backupExists: requiredBoolean(input.plan, "previousBackupExists"),
+                ...(plannedBackupPath ? { backupPath: plannedBackupPath } : {}),
+                ...(optionalString(input.plan, "previousBackupHash") ? { backupHash: optionalString(input.plan, "previousBackupHash") } : {}),
+            };
+            return await deployPackageSource(input.projectPath, requiredString(input.plan, "sourcePath"), {
+                packageName: requiredString(input.plan, "packageName"),
+                ...(plannedBackupPath ? { plannedBackupPath } : {}),
+                expectedPreState,
+            });
+        }
+        case "restore": {
+            const backupPath = optionalString(input.plan, "backupPath");
+            const expectedPreState = {
+                targetPath: requiredString(input.plan, "targetPath"),
+                targetExists: requiredBoolean(input.plan, "expectedTargetExists"),
+                ...(optionalString(input.plan, "expectedTargetHash") ? { targetHash: optionalString(input.plan, "expectedTargetHash") } : {}),
+                recordIdentity: requiredString(input.plan, "expectedRecordIdentity"),
+                backupExists: requiredBoolean(input.plan, "expectedBackupExists"),
+                ...(backupPath ? { backupPath } : {}),
+                ...(optionalString(input.plan, "expectedBackupHash") ? { backupHash: optionalString(input.plan, "expectedBackupHash") } : {}),
+            };
+            return await restoreDeployedPackage(input.projectPath, requiredString(input.plan, "packageName"), { expectedPreState });
+        }
+    }
+}
+/** 读取 Worker 计划中的必填字符串，损坏计划不得进入文件 mutation。 */
+function requiredString(plan, key) {
+    const value = plan[key];
+    if (typeof value !== "string" || !value)
+        throw new Error(`Package file mutation plan is missing ${key}.`);
+    return value;
+}
+/** 读取 Worker 计划中的可选字符串；非字符串值一律视为损坏计划。 */
+function optionalString(plan, key) {
+    const value = plan[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" || !value)
+        throw new Error(`Package file mutation plan has an invalid ${key}.`);
+    return value;
+}
+/** 读取 Worker 计划中的必填布尔值。 */
+function requiredBoolean(plan, key) {
+    const value = plan[key];
+    if (typeof value !== "boolean")
+        throw new Error(`Package file mutation plan is missing ${key}.`);
+    return value;
+}
+/** 统一投影 Worker 硬截止时间错误。 */
+function deadlineError() {
+    const error = new Error("Package file mutation Worker did not settle before its reserved deadline.");
+    error.code = "E_EXECUTION_TIMEOUT";
+    error.nextActions = ["Inspect package files and the canonical request journal before submitting a new request."];
+    return error;
+}
+if (!isMainThread) {
+    const input = workerData;
+    const remainingMs = Math.max(1, input.stopAtMs - Date.now());
+    const timer = setTimeout(() => process.exit(124), remainingMs);
+    void executeWorker(input)
+        .then((result) => parentPort?.postMessage({ ok: true, result }))
+        .catch((error) => {
+        const candidate = error;
+        const failure = {
+            ok: false,
+            error: {
+                ...(typeof candidate?.code === "string" ? { code: candidate.code } : {}),
+                message: typeof candidate?.message === "string" && candidate.message ? candidate.message : "Package file mutation Worker failed.",
+                ...(Array.isArray(candidate?.nextActions) ? { nextActions: candidate.nextActions.filter((value) => typeof value === "string") } : {}),
+            },
+        };
+        parentPort?.postMessage(failure);
+    })
+        .finally(() => {
+        clearTimeout(timer);
+        parentPort?.close();
+    });
+}
+//# sourceMappingURL=file-mutation-worker.js.map

package/dist/tools/package/file-mutation-worker.js.map

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

package/dist/tools/package/info.d.ts

@@ -0,0 +1,19 @@
+export interface PackageInfoRequest {
+    name: string;
+    project?: string;
+}
+export interface PackageInfoEntry {
+    name: string;
+    requestedVersion?: string;
+    lockedVersion?: string;
+    source?: string;
+    url?: string;
+    hash?: string;
+    dependencies?: Record<string, string>;
+}
+export interface PackageInfoResult {
+    projectPath: string;
+    package: PackageInfoEntry;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageInfoRequest, PackageInfoResult>;
+export default _default;

package/dist/tools/package/info.js

@@ -0,0 +1,27 @@
+import { resolve } from "node:path";
+import { PackageManagerError, packageInfo, validatePackageName } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.info",
+    summary: "Show detailed info for one installed package by name.",
+    description: "Show detailed info for one installed package by name. Returns PACKAGE_NOT_FOUND if the package is not in the manifest; use package.list first.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "Inspect one package", argv: ["tools", "run", "package.info", "--input", "{\"name\":\"com.alpsckr.unitycli\",\"project\":\"./Dev/UnityProject\"}"] }
+    ],
+    /** 读取单个 package 条目；未找到时返回稳定 PACKAGE_NOT_FOUND。 */
+    async execute(request, context) {
+        const name = validatePackageName(request.name);
+        const projectPath = resolve(request.project ?? context.projectPath);
+        const info = await packageInfo(projectPath, name);
+        if (!info) {
+            throw new PackageManagerError("PACKAGE_NOT_FOUND", `Package not found: ${name}`, ["Run tools run package.list to inspect installed packages."]);
+        }
+        return { projectPath, package: info };
+    }
+});
+//# sourceMappingURL=info.js.map

package/dist/tools/package/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/tools/package/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsB1C,eAAe,UAAU,CAAwC;IAC/D,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,uDAAuD;IAChE,WAAW,EAAE,gJAAgJ;IAC7J,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,wEAAwE,CAAC,EAAE;KACpK;IACD,kDAAkD;IAClD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,mBAAmB,CAAC,mBAAmB,EAAE,sBAAsB,IAAI,EAAE,EAAE,CAAC,2DAA2D,CAAC,CAAC,CAAC;QAClJ,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/install.d.ts

@@ -0,0 +1,24 @@
+import { type LiveResolveResult } from "./live-resolve.js";
+export interface PackageInstallRequest {
+    name: string;
+    version?: string;
+}
+export interface PackageInstallResult {
+    action: "install";
+    package: string;
+    manifestPath: string;
+    manifestHash: string;
+    dependency: {
+        name: string;
+        version: string;
+        present: true;
+    };
+    files: {
+        proven: true;
+        manifestPath: string;
+        manifestHash: string;
+    };
+    resolve: LiveResolveResult;
+}
+declare const _default: import("../define.js").ToolDefinition<PackageInstallRequest, PackageInstallResult>;
+export default _default;

package/dist/tools/package/install.js

@@ -0,0 +1,65 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { installPackage, parsePackageSpec, readUnityManifestDependencies, validatePackageName } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+import { StructuredToolError } from "../errors.js";
+import { runPackageFileMutationWorker } from "./file-mutation-worker.js";
+import { runLivePackageResolve } from "./live-resolve.js";
+import { projectRelativePath } from "./public-result.js";
+/** manifest 写入、Resolve 与 PackageInfo readback 共用公开 requestId root。 */
+async function runPackageInstall(request, context) {
+    const spec = parsePackageSpec(validatePackageName(request.name), request.version);
+    if (context.execution.dryRun) {
+        await installPackage(context.projectPath, spec, { dryRun: true });
+        throw new StructuredToolError("E_TOOL_COMPLETION_PROOF_INVALID", "package.install dry-run does not have a live PackageInfo terminal.");
+    }
+    return runLivePackageResolve(context, "install", { name: spec.name, version: spec.version }, {
+        async prepare(signal) {
+            signal.throwIfAborted();
+            const prepared = await installPackage(context.projectPath, spec, { dryRun: true });
+            signal.throwIfAborted();
+            return { name: spec.name, version: prepared.installedVersion, manifestPath: prepared.manifestPath };
+        },
+        async apply(plan, signal, stopAtMs) {
+            const expected = installPlan(plan);
+            await runPackageFileMutationWorker("install", context.projectPath, plan, stopAtMs, signal);
+            return installBundle(context.projectPath, expected, expected.manifestPath);
+        },
+        async recover(plan, signal) {
+            signal.throwIfAborted();
+            const expected = installPlan(plan);
+            const bundle = await installBundle(context.projectPath, expected, expected.manifestPath);
+            signal.throwIfAborted();
+            return bundle;
+        },
+    });
+}
+async function installBundle(projectPath, plan, manifestPath) {
+    const dependencies = await readUnityManifestDependencies(projectPath);
+    if (dependencies[plan.name] !== plan.version)
+        throw new Error(`Manifest dependency ${plan.name} does not match the committed install plan.`);
+    const manifestHash = await hash(manifestPath);
+    const files = { proven: true, manifestPath, manifestHash };
+    const publicManifestPath = projectRelativePath(projectPath, manifestPath, "manifestPath");
+    const publicFiles = { ...files, manifestPath: publicManifestPath };
+    return {
+        expectedManifestSha256: manifestHash,
+        predicates: [{ name: plan.name, requestedVersion: plan.version, present: true }],
+        filesProof: files,
+        publicResultSeed: { action: "install", package: plan.name, manifestPath: publicManifestPath, manifestHash, dependency: { name: plan.name, version: plan.version, present: true }, files: publicFiles },
+    };
+}
+function installPlan(value) {
+    if (typeof value.name !== "string" || typeof value.version !== "string" || typeof value.manifestPath !== "string")
+        throw new Error("Durable package.install file plan is corrupt.");
+    return { name: value.name, version: value.version, manifestPath: value.manifestPath };
+}
+async function hash(path) { return createHash("sha256").update(await readFile(path)).digest("hex"); }
+export default defineTool({
+    name: "package.install", summary: "Install a package and prove it through the open Unity Editor.",
+    description: "Writes a prevalidated manifest dependency once, then requires a terminal live PackageInfo resolve proof.",
+    group: "package", destructiveHint: true, sideEffects: ["manifest-change", "session-affecting"], playModeSupport: "session-affecting", handler: "hybrid", supportStatus: "live-bridge", timeoutMs: 120_000,
+    examples: [{ description: "Install a package.", argv: ["tools", "run", "package.install", "--input", "{\"name\":\"com.unity.textmeshpro\",\"version\":\"3.0.7\"}"] }],
+    async execute(request, context) { return runPackageInstall(request, context); }
+});
+//# sourceMappingURL=install.js.map

package/dist/tools/package/install.js.map

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

package/dist/tools/package/list.d.ts

@@ -0,0 +1,27 @@
+export interface PackageListRequest {
+    project?: string;
+}
+export interface PackageListScopedRegistry {
+    name: string;
+    url: string;
+    scopes: string[];
+}
+export interface PackageListEntry {
+    name: string;
+    requestedVersion?: string;
+    lockedVersion?: string;
+    source?: string;
+    url?: string;
+    hash?: string;
+    dependencies?: Record<string, string>;
+}
+export interface PackageListResult {
+    projectPath: string;
+    manifestPath: string;
+    lockPath: string;
+    registry?: string;
+    scopedRegistries: PackageListScopedRegistry[];
+    packages: PackageListEntry[];
+}
+declare const _default: import("../define.js").ToolDefinition<PackageListRequest, PackageListResult>;
+export default _default;

package/dist/tools/package/list.js

@@ -0,0 +1,21 @@
+import { resolve } from "node:path";
+import { readSnapshot } from "../../package-manager.js";
+import { defineTool } from "../define.js";
+export default defineTool({
+    name: "package.list",
+    summary: "List installed packages and their requested/locked versions in the project manifest.",
+    description: "List installed packages and their requested/locked versions in the project manifest. Offline (reads manifest directly, no Unity needed). Use package.status for a manifest+lock summary or package.info for one package.",
+    group: "package",
+    destructiveHint: false,
+    playModeSupport: "supported",
+    handler: "offline",
+    supportStatus: "cli-only",
+    examples: [
+        { description: "List installed packages", argv: ["tools", "run", "package.list", "--input", "{\"project\":\"./Dev/UnityProject\"}"] }
+    ],
+    /** 读取 Unity manifest/lock 快照，不触发 Unity Editor 或 PackageManager resolve。 */
+    async execute(request, context) {
+        return readSnapshot(resolve(request.project ?? context.projectPath));
+    }
+});
+//# sourceMappingURL=list.js.map

package/dist/tools/package/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/package/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA+B1C,eAAe,UAAU,CAAwC;IAC/D,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,sFAAsF;IAC/F,WAAW,EAAE,0NAA0N;IACvO,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,WAAW;IAC5B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,UAAU;IACzB,QAAQ,EAAE;QACR,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,sCAAsC,CAAC,EAAE;KACtI;IACD,2EAA2E;IAC3E,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC5B,OAAO,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/package/live-resolve.d.ts

@@ -0,0 +1,46 @@
+import type { ToolContext } from "../define.js";
+export interface LiveResolvedPackage {
+    name: string;
+    version: string;
+    source: string;
+}
+export interface LiveResolveResult {
+    status: "resolved";
+    manifestHash: string;
+    lockHash: string;
+    packageSnapshotHash: string;
+    packageCount: number;
+    packages: LiveResolvedPackage[];
+}
+export interface PackageResolvePredicate {
+    name: string;
+    requestedVersion?: string;
+    version?: string;
+    present?: boolean;
+    resolvedPath?: string;
+    packageTreeHash?: string;
+}
+export interface PackageFileMutationBundle {
+    expectedManifestSha256: string;
+    predicates: PackageResolvePredicate[];
+    filesProof: Record<string, unknown>;
+    publicResultSeed: Record<string, unknown>;
+}
+export interface PackageFileMutationDriver {
+    /** effect 前构造确定性文件计划；redelivery 使用 journal 中同一计划。 */
+    prepare(signal: AbortSignal): Promise<Record<string, unknown>>;
+    /** commit barrier 后执行一次文件 mutation；生产实现必须在独立 Worker 退出后才返回。 */
+    apply(plan: Record<string, unknown>, signal: AbortSignal, stopAtMs: number): Promise<PackageFileMutationBundle>;
+    /** response/process loss 后只读恢复已持久化计划，禁止重做 mutation。 */
+    recover(plan: Record<string, unknown>, signal: AbortSignal): Promise<PackageFileMutationBundle>;
+}
+export interface LivePackageBinding {
+    instanceId: string;
+    expectedEditorSessionId: string;
+}
+/** Package Resolve 是首个 effect 时也必须走同一个公开 requestId root。 */
+export declare function runLivePackageResolve<T>(context: ToolContext, operation: string, input: Record<string, unknown>, files?: PackageFileMutationDriver, existingBinding?: LivePackageBinding): Promise<T>;
+/** 通过一次公开 editor.state 同时绑定 session 与 canonical project，文件 plan 不再读取 CLI CWD。 */
+export declare function bindLivePackageProject(context: ToolContext, operation: string): Promise<LivePackageBinding>;
+/** 仅为 durable request 等价比较生成稳定摘要，不参与授权。 */
+export declare function sha256CanonicalJson(value: unknown): string;