@alpsckr/unitycli 0.4.0

package/dist/extensions/metadata/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Static built-in extension metadata for the UnityCLI.
+ *
+ * 此处只提供 Extension package 的离线 metadata（标题、描述和 providesTools 名单）。
+ * Extension Tool 的完整 descriptor/schema 由成功编译的 Live Editor 捕获到 static catalog，
+ * 执行前仍以当前 Live Editor registration 为准。
+ */
+import type { ExtensionMetadata } from "./types.js";
+export type { ExtensionMetadata } from "./types.js";
+/** Return all built-in extension metadata entries. */
+export declare function builtinExtensionMetadata(): ExtensionMetadata[];
+/** Find a single built-in extension by its id. */
+export declare function findExtensionById(id: string): ExtensionMetadata | undefined;
+/** Search extensions by keyword across id, title, description. */
+export declare function searchExtensions(keyword: string): ExtensionMetadata[];

package/dist/extensions/metadata/index.js

@@ -0,0 +1,41 @@
+/**
+ * Static built-in extension metadata for the UnityCLI.
+ *
+ * 此处只提供 Extension package 的离线 metadata（标题、描述和 providesTools 名单）。
+ * Extension Tool 的完整 descriptor/schema 由成功编译的 Live Editor 捕获到 static catalog，
+ * 执行前仍以当前 Live Editor registration 为准。
+ */
+import { BUILTIN_EXTENSION_MANIFESTS } from "../.generated-registry-data.js";
+const BUILTIN_EXTENSIONS = BUILTIN_EXTENSION_MANIFESTS.map((manifest) => ({
+    id: manifest.id,
+    title: `${manifest.name} Extension`,
+    description: manifest.description,
+    kind: "extension",
+    source: "built-in",
+    version: manifest.version,
+    status: "available",
+    providesTools: (manifest.contributions.tools ?? []).map((tool) => tool.name),
+    requiresUnityPackages: manifest.unityPackages.map((pkg) => pkg.packageId),
+    installMode: "auto",
+    installCommand: `extensions install ${manifest.id}`,
+    nextActions: [
+        `Run unitycli extensions install ${manifest.id} to install this extension.`,
+        "Run unitycli init to auto-detect and install extensions for your Unity project."
+    ]
+}));
+/** Return all built-in extension metadata entries. */
+export function builtinExtensionMetadata() {
+    return BUILTIN_EXTENSIONS;
+}
+/** Find a single built-in extension by its id. */
+export function findExtensionById(id) {
+    return BUILTIN_EXTENSIONS.find((e) => e.id === id);
+}
+/** Search extensions by keyword across id, title, description. */
+export function searchExtensions(keyword) {
+    const lower = keyword.toLowerCase();
+    return BUILTIN_EXTENSIONS.filter((e) => e.id.toLowerCase().includes(lower) ||
+        e.title.toLowerCase().includes(lower) ||
+        e.description.toLowerCase().includes(lower));
+}
+//# sourceMappingURL=index.js.map

package/dist/extensions/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/metadata/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAK7E,MAAM,kBAAkB,GAAwB,2BAA2B,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7F,EAAE,EAAE,QAAQ,CAAC,EAAE;IACf,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,YAAY;IACnC,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,QAAQ,CAAC,OAAO;IACzB,MAAM,EAAE,WAAW;IACnB,aAAa,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5E,qBAAqB,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC;IACzE,WAAW,EAAE,MAAM;IACnB,cAAc,EAAE,sBAAsB,QAAQ,CAAC,EAAE,EAAE;IACnD,WAAW,EAAE;QACX,mCAAmC,QAAQ,CAAC,EAAE,6BAA6B;QAC3E,iFAAiF;KAClF;CACF,CAAC,CAAC,CAAC;AAEJ,sDAAsD;AACtD,MAAM,UAAU,wBAAwB;IACtC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACrC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAClC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/extensions/metadata/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Extension metadata type for the UnityCLI.
+ *
+ * An Extension is an optional capability pack that provides additional
+ * Tools. Extensions depend on optional Unity packages
+ * (e.g. com.unity.probuilder) and are not part of the core CLI package.
+ *
+ * Defines the typed descriptor surface for extension metadata.
+ */
+export type ExtensionSource = "built-in" | "package";
+export type ExtensionStatus = "installed" | "available" | "unavailable";
+export type ExtensionInstallMode = "auto" | "manual";
+export interface ExtensionMetadata {
+    /** Extension identifier, e.g. 'probuilder'. Must be unique. */
+    id: string;
+    /** Short human-readable title, e.g. 'ProBuilder Extension'. */
+    title: string;
+    /** One-paragraph explanation of what the extension provides. */
+    description: string;
+    /** Discriminator: always 'extension' for ExtensionMetadata. */
+    kind: "extension";
+    /** Origin: 'built-in' (declared in core metadata) or 'package' (separate npm/Unity package). */
+    source: ExtensionSource;
+    /** Semantic version of the extension, e.g. '1.0.0'. */
+    version?: string;
+    /** Current install status. */
+    status: ExtensionStatus;
+    /** Tools provided by this extension (dotted names, e.g. ['probuilder.shape']). */
+    providesTools?: string[];
+    /** Unity packages required for this extension to work. */
+    requiresUnityPackages?: string[];
+    /** How the extension is installed: 'auto' (detected during init) or 'manual' (explicit install command). */
+    installMode: ExtensionInstallMode;
+    /** CLI command to install this extension, e.g. 'extensions install probuilder'. */
+    installCommand?: string;
+    /** Suggested next actions after listing/describing the extension. */
+    nextActions?: string[];
+}

package/dist/extensions/metadata/types.js

@@ -0,0 +1,11 @@
+/**
+ * Extension metadata type for the UnityCLI.
+ *
+ * An Extension is an optional capability pack that provides additional
+ * Tools. Extensions depend on optional Unity packages
+ * (e.g. com.unity.probuilder) and are not part of the core CLI package.
+ *
+ * Defines the typed descriptor surface for extension metadata.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/metadata/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/metadata/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/extensions/project-resolver.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Project-level resolver: reads installed Unity packages from a project's
+ * manifest.json and packages-lock.json, then resolves extension availability.
+ *
+ * This module bridges the package-manager module (which reads Unity manifests)
+ * with the extension registry (which declares package requirements).
+ */
+import { ExtensionRegistry } from "./registry.js";
+import type { ExtensionAvailabilityResult } from "./types.js";
+/**
+ * Read installed (resolved) Unity packages from a project's packages-lock.json.
+ *
+ * Only packages that appear in packages-lock.json are considered "installed" —
+ * this is the authoritative record of what Unity's package manager has actually
+ * resolved and made available. A package declared in manifest.json but absent
+ * from packages-lock.json has NOT been resolved and cannot be used; reporting it
+ * as installed would produce false-positive diagnostics.
+ *
+ * Returns a Map of package ID → resolved version string.
+ *
+ * @param projectPath - Root of the Unity project.
+ * @returns Map of installed package IDs to their resolved versions.
+ */
+export declare function readInstalledUnityPackages(projectPath: string): Promise<Map<string, string>>;
+/**
+ * Resolve extension availability for a specific Unity project.
+ *
+ * Reads the project's manifest/lock files and resolves all registered
+ * extensions against the installed packages.
+ *
+ * @param registry - The extension registry.
+ * @param projectPath - Root of the Unity project.
+ * @returns Availability results for all extensions.
+ */
+export declare function resolveExtensionAvailabilityForProject(registry: ExtensionRegistry, projectPath: string): Promise<ExtensionAvailabilityResult[]>;

package/dist/extensions/project-resolver.js

@@ -0,0 +1,61 @@
+/**
+ * Project-level resolver: reads installed Unity packages from a project's
+ * manifest.json and packages-lock.json, then resolves extension availability.
+ *
+ * This module bridges the package-manager module (which reads Unity manifests)
+ * with the extension registry (which declares package requirements).
+ */
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { stripBom } from "../util.js";
+/**
+ * Read installed (resolved) Unity packages from a project's packages-lock.json.
+ *
+ * Only packages that appear in packages-lock.json are considered "installed" —
+ * this is the authoritative record of what Unity's package manager has actually
+ * resolved and made available. A package declared in manifest.json but absent
+ * from packages-lock.json has NOT been resolved and cannot be used; reporting it
+ * as installed would produce false-positive diagnostics.
+ *
+ * Returns a Map of package ID → resolved version string.
+ *
+ * @param projectPath - Root of the Unity project.
+ * @returns Map of installed package IDs to their resolved versions.
+ */
+export async function readInstalledUnityPackages(projectPath) {
+    const packages = new Map();
+    // Only read packages-lock.json for RESOLVED (installed) packages.
+    // manifest.json declares intent but not resolution; a package listed in
+    // manifest but absent from lock has not been resolved by Unity.
+    const lockPath = join(resolve(projectPath), "Packages", "packages-lock.json");
+    try {
+        const lockContent = await readFile(lockPath, "utf8");
+        const lock = JSON.parse(stripBom(lockContent));
+        if (lock.dependencies) {
+            for (const [id, entry] of Object.entries(lock.dependencies)) {
+                if (entry.version) {
+                    packages.set(id, entry.version);
+                }
+            }
+        }
+    }
+    catch {
+        // packages-lock.json may not exist; return empty
+    }
+    return packages;
+}
+/**
+ * Resolve extension availability for a specific Unity project.
+ *
+ * Reads the project's manifest/lock files and resolves all registered
+ * extensions against the installed packages.
+ *
+ * @param registry - The extension registry.
+ * @param projectPath - Root of the Unity project.
+ * @returns Availability results for all extensions.
+ */
+export async function resolveExtensionAvailabilityForProject(registry, projectPath) {
+    const installedPackages = await readInstalledUnityPackages(projectPath);
+    return registry.resolveAllAvailability(installedPackages);
+}
+//# sourceMappingURL=project-resolver.js.map

package/dist/extensions/project-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-resolver.js","sourceRoot":"","sources":["../../src/extensions/project-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,kEAAkE;IAClE,wEAAwE;IACxE,gEAAgE;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAC9E,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA4D,CAAC;QAC1G,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC5D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,QAA2B,EAC3B,WAAmB;IAEnB,MAAM,iBAAiB,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;AAC5D,CAAC"}

package/dist/extensions/registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Extension registry: discovers available extensions, reads installation
+ * status, and resolves Unity package dependency mappings.
+ *
+ * The registry is the central point of truth for which extensions the CLI
+ * knows about and whether they are available in a given project.
+ */
+import type { ExtensionId, ExtensionManifest, ExtensionAvailabilityResult, RegistryExtension } from "./types.js";
+/**
+ * Extension registry — discovers and resolves CLI extensions.
+ *
+ * Extensions declare required Unity packages; the registry resolves
+ * availability by checking a project's manifest/lock files. The core
+ * package never imports optional Unity packages at compile time.
+ */
+export declare class ExtensionRegistry {
+    private readonly extensions;
+    /**
+     * Create a registry pre-loaded with built-in extension manifests.
+     *
+     * @param additionalManifests - Optional extra manifests to register
+     * alongside the built-in ones (for testing or future plugin loading).
+     */
+    constructor(additionalManifests?: ExtensionManifest[]);
+    /**
+     * Register an extension manifest.
+     *
+     * @throws {Error} If an extension with the same ID is already registered.
+     */
+    register(manifest: ExtensionManifest): void;
+    /**
+     * List all registered extension IDs.
+     */
+    extensionIds(): ExtensionId[];
+    /**
+     * List all registered extensions with their manifests.
+     */
+    listExtensions(): RegistryExtension[];
+    /**
+     * Look up a single extension by ID.
+     */
+    getExtension(id: ExtensionId): RegistryExtension | undefined;
+    /**
+     * Check whether an extension is registered.
+     */
+    hasExtension(id: ExtensionId): boolean;
+    /**
+     * Resolve the availability of an extension against a project's installed
+     * packages.
+     *
+     * @param extensionId - The extension to check.
+     * @param installedPackages - Map of package ID → installed version (from
+     *   the project's manifest.json / packages-lock.json). Pass an empty map
+     *   or omit to get "unknown" status.
+     */
+    resolveAvailability(extensionId: ExtensionId, installedPackages?: ReadonlyMap<string, string> | Readonly<Record<string, string>>): ExtensionAvailabilityResult;
+    /**
+     * Resolve availability for ALL registered extensions against a project.
+     */
+    resolveAllAvailability(installedPackages?: ReadonlyMap<string, string> | Readonly<Record<string, string>>): ExtensionAvailabilityResult[];
+    /**
+     * List extensions that are available in the given project.
+     */
+    availableExtensions(installedPackages?: ReadonlyMap<string, string> | Readonly<Record<string, string>>): ExtensionAvailabilityResult[];
+    /**
+     * List extensions that are unavailable in the given project.
+     */
+    unavailableExtensions(installedPackages?: ReadonlyMap<string, string> | Readonly<Record<string, string>>): ExtensionAvailabilityResult[];
+    /**
+     * Get the set of all Unity package IDs required by any registered extension.
+     */
+    allRequiredUnityPackageIds(): string[];
+}
+/**
+ * Resolve an extension's availability against a project's installed packages.
+ */
+export declare function resolveExtensionAvailability(manifest: ExtensionManifest, installedPackages?: ReadonlyMap<string, string> | Readonly<Record<string, string>>): ExtensionAvailabilityResult;
+/**
+ * Validate an extension manifest for required fields and constraints.
+ */
+export declare function validateManifest(manifest: ExtensionManifest): void;
+export declare class ExtensionRegistryError extends Error {
+    readonly code: "DUPLICATE_EXTENSION" | "UNKNOWN_EXTENSION" | "INVALID_MANIFEST";
+    readonly nextActions: string[];
+    constructor(code: "DUPLICATE_EXTENSION" | "UNKNOWN_EXTENSION" | "INVALID_MANIFEST", message: string, nextActions?: string[]);
+}

package/dist/extensions/registry.js

@@ -0,0 +1,262 @@
+/**
+ * Extension registry: discovers available extensions, reads installation
+ * status, and resolves Unity package dependency mappings.
+ *
+ * The registry is the central point of truth for which extensions the CLI
+ * knows about and whether they are available in a given project.
+ */
+import { BUILTIN_EXTENSION_MANIFESTS } from "./.generated-registry-data.js";
+/**
+ * Extension registry — discovers and resolves CLI extensions.
+ *
+ * Extensions declare required Unity packages; the registry resolves
+ * availability by checking a project's manifest/lock files. The core
+ * package never imports optional Unity packages at compile time.
+ */
+export class ExtensionRegistry {
+    extensions = new Map();
+    /**
+     * Create a registry pre-loaded with built-in extension manifests.
+     *
+     * @param additionalManifests - Optional extra manifests to register
+     * alongside the built-in ones (for testing or future plugin loading).
+     */
+    constructor(additionalManifests = []) {
+        const allManifests = [...BUILTIN_EXTENSION_MANIFESTS, ...additionalManifests];
+        for (const manifest of allManifests) {
+            this.register(manifest);
+        }
+    }
+    /**
+     * Register an extension manifest.
+     *
+     * @throws {Error} If an extension with the same ID is already registered.
+     */
+    register(manifest) {
+        validateManifest(manifest);
+        if (this.extensions.has(manifest.id)) {
+            throw new ExtensionRegistryError("DUPLICATE_EXTENSION", `Extension already registered: ${manifest.id}`, ["Each extension ID must be unique. Remove the duplicate or use a different ID."]);
+        }
+        this.extensions.set(manifest.id, {
+            manifest,
+            hasBuiltinBridgeDomain: false // Set externally after bridge registry is available
+        });
+    }
+    /**
+     * List all registered extension IDs.
+     */
+    extensionIds() {
+        return [...this.extensions.keys()].sort();
+    }
+    /**
+     * List all registered extensions with their manifests.
+     */
+    listExtensions() {
+        return [...this.extensions.values()].sort((a, b) => a.manifest.id.localeCompare(b.manifest.id));
+    }
+    /**
+     * Look up a single extension by ID.
+     */
+    getExtension(id) {
+        return this.extensions.get(id);
+    }
+    /**
+     * Check whether an extension is registered.
+     */
+    hasExtension(id) {
+        return this.extensions.has(id);
+    }
+    /**
+     * Resolve the availability of an extension against a project's installed
+     * packages.
+     *
+     * @param extensionId - The extension to check.
+     * @param installedPackages - Map of package ID → installed version (from
+     *   the project's manifest.json / packages-lock.json). Pass an empty map
+     *   or omit to get "unknown" status.
+     */
+    resolveAvailability(extensionId, installedPackages) {
+        const ext = this.extensions.get(extensionId);
+        if (!ext) {
+            throw new ExtensionRegistryError("UNKNOWN_EXTENSION", `Extension not found in registry: ${extensionId}`, [`Available extensions: ${this.extensionIds().join(", ")}`]);
+        }
+        return resolveExtensionAvailability(ext.manifest, installedPackages);
+    }
+    /**
+     * Resolve availability for ALL registered extensions against a project.
+     */
+    resolveAllAvailability(installedPackages) {
+        return this.extensionIds().map((id) => this.resolveAvailability(id, installedPackages));
+    }
+    /**
+     * List extensions that are available in the given project.
+     */
+    availableExtensions(installedPackages) {
+        return this.resolveAllAvailability(installedPackages)
+            .filter((r) => r.status === "available");
+    }
+    /**
+     * List extensions that are unavailable in the given project.
+     */
+    unavailableExtensions(installedPackages) {
+        return this.resolveAllAvailability(installedPackages)
+            .filter((r) => r.status === "unavailable");
+    }
+    /**
+     * Get the set of all Unity package IDs required by any registered extension.
+     */
+    allRequiredUnityPackageIds() {
+        const ids = new Set();
+        for (const ext of this.extensions.values()) {
+            for (const pkg of requiredUnityPackagesForManifest(ext.manifest)) {
+                ids.add(pkg.packageId);
+            }
+        }
+        return [...ids].sort();
+    }
+}
+// ── Availability resolution ─────────────────────────────────────────────────
+/**
+ * Resolve an extension's availability against a project's installed packages.
+ */
+export function resolveExtensionAvailability(manifest, installedPackages) {
+    const requiredPackages = requiredUnityPackagesForManifest(manifest);
+    // Only `undefined` (no project context) yields "unknown". An empty
+    // collection means "we checked the project, nothing is installed" → unavailable.
+    if (installedPackages === undefined) {
+        return {
+            extensionId: manifest.id,
+            status: "unknown",
+            packages: requiredPackages.map((pkg) => ({
+                packageId: pkg.packageId,
+                displayName: pkg.displayName,
+                installed: false,
+                version: undefined
+            })),
+            missingPackageIds: requiredPackages.map((pkg) => pkg.packageId),
+            nextActions: [
+                `Provide a project path or installed packages map to resolve availability for ${manifest.name}.`
+            ]
+        };
+    }
+    const getPackage = (id) => {
+        if (installedPackages instanceof Map) {
+            const version = installedPackages.get(id);
+            return { installed: version !== undefined, version };
+        }
+        const version = installedPackages[id];
+        return { installed: version !== undefined, version };
+    };
+    const packages = requiredPackages.map((pkg) => {
+        const resolved = getPackage(pkg.packageId);
+        return {
+            packageId: pkg.packageId,
+            displayName: pkg.displayName,
+            version: resolved.version,
+            installed: resolved.installed && (pkg.versionRange === undefined || resolved.version === pkg.versionRange)
+        };
+    });
+    const missingPackageIds = packages
+        .filter((p) => !p.installed)
+        .map((p) => p.packageId);
+    const allInstalled = missingPackageIds.length === 0;
+    const status = allInstalled ? "available" : "unavailable";
+    const nextActions = allInstalled
+        ? []
+        : buildNextActions(manifest, missingPackageIds);
+    return {
+        extensionId: manifest.id,
+        status,
+        packages,
+        missingPackageIds,
+        nextActions
+    };
+}
+function requiredUnityPackagesForManifest(manifest) {
+    const byId = new Map();
+    for (const pkg of manifest.unityPackages) {
+        byId.set(pkg.packageId, pkg);
+    }
+    for (const tool of manifest.contributions.tools ?? []) {
+        for (const packageId of tool.requiresPackages ?? []) {
+            if (!byId.has(packageId)) {
+                byId.set(packageId, { packageId, displayName: packageId });
+            }
+        }
+    }
+    return [...byId.values()];
+}
+/**
+ * Build nextActions for an unavailable extension.
+ */
+function buildNextActions(manifest, missingPackageIds) {
+    const actions = [];
+    const requirements = requiredUnityPackagesForManifest(manifest)
+        .filter((pkg) => missingPackageIds.includes(pkg.packageId))
+        .map((pkg) => pkg.versionRange ? `${pkg.packageId}@${pkg.versionRange}` : pkg.packageId);
+    actions.push(`Install the required Unity package(s) manually via Unity Package Manager, or run package.install with explicit package versions: ${requirements.join(", ")}.`);
+    actions.push(`Do not write \"latest\" into manifest.json; Unity requires a SemVer/package source such as \"<version>\", \"file:<path>\" or a Git URL.`);
+    actions.push(`After Unity resolves packages, run 'unitycli extensions install ${manifest.id} --project <path>'.`);
+    actions.push(`Run 'unitycli extensions doctor --project <path>' to diagnose all extension availability.`);
+    return actions;
+}
+// ── Validation ──────────────────────────────────────────────────────────────
+/**
+ * Validate an extension manifest for required fields and constraints.
+ */
+export function validateManifest(manifest) {
+    if (!manifest.id || typeof manifest.id !== "string") {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", "Extension manifest requires a non-empty 'id' field.", ["Use a kebab-case identifier, e.g. 'probuilder'."]);
+    }
+    if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(manifest.id)) {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension ID must be kebab-case (lowercase letters, digits, hyphens): ${manifest.id}`, ["Use a format like 'probuilder', 'vfx-graph', 'urp'."]);
+    }
+    if (!manifest.name || typeof manifest.name !== "string") {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' requires a non-empty 'name' field.`, ["Provide a human-readable name, e.g. 'ProBuilder'."]);
+    }
+    if (!manifest.description || typeof manifest.description !== "string") {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' requires a non-empty 'description' field.`, ["Provide a one-paragraph description."]);
+    }
+    if (!manifest.version || typeof manifest.version !== "string") {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' requires a non-empty 'version' field.`, ["Use semver format, e.g. '1.0.0'."]);
+    }
+    if (!Array.isArray(manifest.unityPackages)) {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' requires a 'unityPackages' array.`, ["List the Unity packages required by this extension."]);
+    }
+    for (const pkg of manifest.unityPackages) {
+        if (!pkg.packageId || typeof pkg.packageId !== "string") {
+            throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' has a unityPackages entry missing 'packageId'.`, ["Each unityPackages entry must have a packageId, e.g. 'com.unity.probuilder'."]);
+        }
+        if (!pkg.displayName || typeof pkg.displayName !== "string") {
+            throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' has a unityPackages entry missing 'displayName'.`, [`Each unityPackages entry must have a displayName, e.g. 'ProBuilder'.`]);
+        }
+        if (pkg.versionRange !== undefined && (typeof pkg.versionRange !== "string" || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(pkg.versionRange))) {
+            throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' has an invalid exact package version for '${pkg.packageId}'.`, ["Use an exact SemVer such as 5.2.4, or omit versionRange to accept any installed version."]);
+        }
+    }
+    if (!manifest.contributions || typeof manifest.contributions !== "object") {
+        throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' requires a 'contributions' object.`, ["Provide tool capability IDs, context keys, and/or C# implementation entries."]);
+    }
+    // Validate tool contributions
+    if (manifest.contributions.tools) {
+        if (!Array.isArray(manifest.contributions.tools)) {
+            throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' contributions.tools must be an array.`, []);
+        }
+        for (const tool of manifest.contributions.tools) {
+            if (!tool.name || typeof tool.name !== "string") {
+                throw new ExtensionRegistryError("INVALID_MANIFEST", `Extension '${manifest.id}' has an incomplete tool contribution: ${tool.name ?? "<missing name>"}.`, ["Each tool contribution must declare a stable tool name."]);
+            }
+        }
+    }
+}
+// ── Error type ──────────────────────────────────────────────────────────────
+export class ExtensionRegistryError extends Error {
+    code;
+    nextActions;
+    constructor(code, message, nextActions = []) {
+        super(message);
+        this.code = code;
+        this.nextActions = nextActions;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/extensions/registry.js.map

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

package/dist/extensions/tool-manifest.d.ts

@@ -0,0 +1,29 @@
+import type { ExtensionId, ExtensionManifest, ExtensionToolContribution } from "./types.js";
+export interface BuiltinExtensionToolContribution {
+    extensionId: ExtensionId;
+    extensionName: string;
+    manifest: ExtensionManifest;
+    contribution: ExtensionToolContribution;
+    name: string;
+    group: string;
+    requiresPackages: string[];
+}
+export interface BuiltinExtensionToolGroup {
+    extensionId: ExtensionId;
+    extensionName: string;
+    manifest: ExtensionManifest;
+    group: string;
+    toolCount: number;
+}
+/** 从 dotted tool name 推导 discovery group。 */
+export declare function groupFromToolName(name: string): string;
+/** 读取 extension tool 的真实包依赖；显式 requiresPackages 优先，否则回退到 extension-level 依赖。 */
+export declare function requiredPackagesForContribution(manifest: ExtensionManifest, contribution: ExtensionToolContribution): string[];
+/** 汇总所有 built-in extension manifests 贡献的 tool 名单。 */
+export declare function builtinExtensionToolContributions(): BuiltinExtensionToolContribution[];
+/** 查找某个 extension tool 的 manifest 贡献信息。 */
+export declare function findBuiltinExtensionToolContribution(name: string): BuiltinExtensionToolContribution | undefined;
+/** 汇总 extension 级 group 视图，供离线 group discovery 使用。 */
+export declare function builtinExtensionToolGroups(): BuiltinExtensionToolGroup[];
+/** 读取所有 extension group 名称集合。 */
+export declare function builtinExtensionGroupNames(): string[];