unity-open-mcp 0.1.0

package/dist/capabilities/list-rules.d.ts

@@ -0,0 +1,45 @@
+import type { RuleCapability, FixCapability, RuleIssueDescriptor } from "./rule-catalog.js";
+export type Severity = "Error" | "Warning";
+export interface ListRulesEntry {
+    id: string;
+    title: string;
+    description: string;
+    applicableAssetKinds: string[];
+    applicableExtensions?: string[];
+    implemented: boolean;
+    status: "implemented" | "planned";
+    /** Worst severity the rule can emit. `Warning` when the rule emits no errors. */
+    defaultSeverity: Severity;
+    /** Distinct fix IDs across all the rule's issue codes. */
+    availableFixIds: string[];
+    /** Issue codes the rule emits. Empty for planned rules. */
+    issues: RuleIssueDescriptor[];
+    /** Present only for planned rules. */
+    guidance?: string;
+}
+export interface ListRulesResult {
+    rules: ListRulesEntry[];
+    counts: {
+        implemented: number;
+        planned: number;
+        total: number;
+    };
+    filters?: {
+        assetKind?: string;
+        extension?: string;
+        implementedOnly?: boolean;
+    };
+}
+export interface ListRulesFilter {
+    /** Filter to rules that declare this asset kind (e.g. "prefab", "scene"). */
+    assetKind?: string;
+    /** Filter to rules that declare this extension (e.g. ".prefab"). */
+    extension?: string;
+    /** When true, omit planned/unimplemented rules. */
+    implementedOnly?: boolean;
+}
+export interface ListRulesDeps {
+    rules: RuleCapability[];
+    fixes: FixCapability[];
+}
+export declare function listRules(deps: ListRulesDeps, filter?: ListRulesFilter): ListRulesResult;

package/dist/capabilities/list-rules.js

@@ -0,0 +1,121 @@
+// Rule-listing builder for `unity_open_mcp_list_rules`.
+//
+// Distinct from `unity_open_mcp_capabilities` (kind: "rules") in two ways:
+//   1. The response is purpose-built for "what rule should I run on this
+//      asset?" — every rule carries a derived `defaultSeverity` (the worst
+//      severity it can emit) and a flat `availableFixIds` list, so an agent
+//      can scan the list in one pass without walking issue arrays.
+//   2. It supports an `asset_kind` / `extension` filter so the caller can ask
+//      "which rules apply to .prefab?" without post-processing the catalog.
+//
+// Pure transformation over the injected catalog — no runtime cross-file
+// imports, loads cleanly under `node --experimental-strip-types`.
+// Build a fix-id lookup keyed by issue code so each rule can flatten its
+// available fixes without scanning the fix catalog per issue.
+function buildFixIndex(fixes) {
+    const index = new Map();
+    for (const fix of fixes) {
+        if (!fix.implemented)
+            continue;
+        for (const code of fix.issueCodes) {
+            const list = index.get(code);
+            if (list) {
+                if (!list.includes(fix.id))
+                    list.push(fix.id);
+            }
+            else {
+                index.set(code, [fix.id]);
+            }
+        }
+    }
+    return index;
+}
+function deriveDefaultSeverity(issues) {
+    // "Default" severity is the level the gate treats as a failure by default.
+    // We surface the *worst* severity the rule can emit so agents reading the
+    // list understand the ceiling: a rule that ever emits Error will fail the
+    // gate under the default `error` threshold.
+    if (issues.some((i) => i.severity === "Error"))
+        return "Error";
+    if (issues.some((i) => i.severity === "Warning"))
+        return "Warning";
+    return "Warning";
+}
+function collectFixIds(rule, fixIndex) {
+    if (!rule.implemented)
+        return [];
+    const ids = new Set();
+    for (const issue of rule.issues) {
+        // Prefer the catalog's per-issue fixIds (source of truth) and fall back to
+        // the fix-index lookup so the two never disagree silently.
+        for (const id of issue.fixIds)
+            ids.add(id);
+        const fromIndex = fixIndex.get(issue.code);
+        if (fromIndex)
+            for (const id of fromIndex)
+                ids.add(id);
+    }
+    return [...ids];
+}
+function ruleMatches(rule, filter) {
+    if (filter.assetKind) {
+        const kinds = rule.applicableAssetKinds ?? [];
+        if (!kinds.includes(filter.assetKind))
+            return false;
+    }
+    if (filter.extension) {
+        const exts = rule.applicableExtensions ?? [];
+        const normalized = filter.extension.startsWith(".")
+            ? filter.extension.toLowerCase()
+            : `.${filter.extension.toLowerCase()}`;
+        if (!exts.map((e) => e.toLowerCase()).includes(normalized))
+            return false;
+    }
+    return true;
+}
+export function listRules(deps, filter = {}) {
+    const fixIndex = buildFixIndex(deps.fixes);
+    const entries = [];
+    for (const rule of deps.rules) {
+        if (filter.implementedOnly && !rule.implemented)
+            continue;
+        if (!ruleMatches(rule, filter))
+            continue;
+        entries.push({
+            id: rule.id,
+            title: rule.title,
+            description: rule.description,
+            applicableAssetKinds: rule.applicableAssetKinds,
+            applicableExtensions: rule.applicableExtensions,
+            implemented: rule.implemented,
+            status: rule.status,
+            defaultSeverity: deriveDefaultSeverity(rule.issues),
+            availableFixIds: collectFixIds(rule, fixIndex),
+            issues: rule.issues,
+            guidance: rule.guidance,
+        });
+    }
+    const implemented = entries.filter((e) => e.implemented).length;
+    const planned = entries.filter((e) => !e.implemented).length;
+    // Only surface the filter block when the caller actually passed one — keeps
+    // the default response compact.
+    const hasFilter = filter.assetKind !== undefined ||
+        filter.extension !== undefined ||
+        filter.implementedOnly === true;
+    return {
+        rules: entries,
+        counts: {
+            implemented,
+            planned,
+            total: entries.length,
+        },
+        filters: hasFilter
+            ? {
+                assetKind: filter.assetKind,
+                extension: filter.extension,
+                implementedOnly: filter.implementedOnly,
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=list-rules.js.map

package/dist/capabilities/list-rules.js.map

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

package/dist/capabilities/rule-catalog.d.ts

@@ -0,0 +1,44 @@
+export type CapabilityStatus = "implemented" | "planned";
+export interface RuleIssueDescriptor {
+    /** Issue code emitted by the rule (e.g. `missing_script`). */
+    code: string;
+    /** Default severity (`Error` | `Warning`). */
+    severity: "Error" | "Warning";
+    /** Fix IDs that can resolve this issue code, if any. */
+    fixIds: string[];
+    /** True when the issue is only emitted during a full project scan. */
+    fullScanOnly?: boolean;
+}
+export interface RuleCapability {
+    id: string;
+    title: string;
+    description: string;
+    /** Asset kinds the rule analyzes (e.g. `prefab`, `scene`). */
+    applicableAssetKinds: string[];
+    /** File extensions the rule applies to, when known. */
+    applicableExtensions?: string[];
+    implemented: boolean;
+    status: CapabilityStatus;
+    /** Issue codes this rule can emit. Empty for planned rules. */
+    issues: RuleIssueDescriptor[];
+    /** Guidance shown to the agent when the rule is not implemented. */
+    guidance?: string;
+}
+export interface FixCapability {
+    id: string;
+    implemented: boolean;
+    status: CapabilityStatus;
+    /** Rule IDs this fix can resolve issues for. */
+    rules: string[];
+    /** Issue codes this fix addresses. */
+    issueCodes: string[];
+    /** True when the fix is safe to auto-apply (no destructive side effects). */
+    safe: boolean;
+    /** Guidance shown to the agent when the fix is not implemented. */
+    guidance?: string;
+}
+export declare const RULE_CATALOG: RuleCapability[];
+export declare const FIX_CATALOG: FixCapability[];
+export declare function implementedRules(): RuleCapability[];
+export declare function plannedRules(): RuleCapability[];
+export declare function implementedFixes(): FixCapability[];

package/dist/capabilities/rule-catalog.js

@@ -0,0 +1,330 @@
+// Capability-discovery rule catalog.
+//
+// Static metadata for verify rules and fix providers. This is the documented
+// capability surface agents discover via `unity_open_mcp_capabilities`. The
+// catalog is versioned with the package: `implemented` flags reflect what
+// ships in the matching bridge/verify package release.
+//
+// Implemented-rule metadata mirrors the C# verify package
+// (packages/verify/Editor/Rules/*) issue mappers and the fix registry
+// (packages/verify/Editor/Fixes/FixProviderRegistry.cs). Planned rules mirror
+// the extension-heuristic stubs in the bridge gate adapter
+// (packages/bridge/Editor/Gate/VerifyGateAdapter.cs).
+// ---------------------------------------------------------------------------
+// Implemented rules — mirror packages/verify/Editor/Rules/*
+// ---------------------------------------------------------------------------
+const MISSING_REFERENCES_ISSUES = [
+    {
+        code: "missing_guid",
+        severity: "Error",
+        fixIds: ["relink_broken_guid"],
+    },
+    {
+        code: "missing_fileid",
+        severity: "Error",
+        fixIds: [],
+    },
+    {
+        code: "missing_local_fileid",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "empty_local_ref",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "missing_method",
+        severity: "Warning",
+        fixIds: [],
+        fullScanOnly: true,
+    },
+    {
+        code: "type_mismatch",
+        severity: "Warning",
+        fixIds: [],
+        fullScanOnly: true,
+    },
+    {
+        code: "missing_script",
+        severity: "Error",
+        fixIds: ["remove_missing_script"],
+    },
+    {
+        code: "duplicate_component",
+        severity: "Warning",
+        fixIds: [],
+        fullScanOnly: true,
+    },
+    {
+        code: "invalid_layer",
+        severity: "Warning",
+        fixIds: [],
+        fullScanOnly: true,
+    },
+];
+const SCENE_PREFAB_HEALTH_ISSUES = [
+    {
+        code: "broken_reference",
+        severity: "Error",
+        fixIds: [],
+    },
+    {
+        code: "high_risk_bootstrap",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "scene_object_count",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "component_hotspot",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "inactive_expensive",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "inactive_heavy",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "deep_nesting",
+        severity: "Warning",
+        fixIds: [],
+    },
+    {
+        code: "override_explosion",
+        severity: "Warning",
+        fixIds: [],
+    },
+];
+const DEPENDENCIES_ISSUES = [
+    {
+        code: "broken_dependency",
+        severity: "Error",
+        fixIds: ["relink_broken_guid"],
+    },
+    {
+        code: "dependency_cycle",
+        severity: "Warning",
+        fixIds: [],
+    },
+];
+// ---------------------------------------------------------------------------
+// Planned rules — mirror stubs in VerifyGateAdapter.SelectRuleIds
+// ---------------------------------------------------------------------------
+const PLANNED_RULES = [
+    {
+        id: "asmdef_audit",
+        title: "Assembly definition audit",
+        description: "Validates assembly definition references, naming, and dependency graph health.",
+        applicableAssetKinds: ["asmdef"],
+        applicableExtensions: [".cs", ".asmdef"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. C#/asmdef files currently pass through the gate without rule coverage. " +
+            "Track asset references manually or use find_references on GUID-based deps.",
+    },
+    {
+        id: "materials",
+        title: "Material health",
+        description: "Detects unreferenced materials, missing textures, and broken shader references.",
+        applicableAssetKinds: ["material"],
+        applicableExtensions: [".mat", ".shader", ".shadergraph"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Use find_references to check material usage and read_asset to inspect shader refs.",
+    },
+    {
+        id: "shader_analysis",
+        title: "Shader analysis",
+        description: "Inspects shader compile state, variant count, and keyword explosion risk.",
+        applicableAssetKinds: ["shader"],
+        applicableExtensions: [".mat", ".shader", ".shadergraph"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Use read_console to catch shader compile errors after a build.",
+    },
+    {
+        id: "textures",
+        title: "Texture analysis",
+        description: "Flags oversized textures, missing import settings, and uncompressed formats on mobile.",
+        applicableAssetKinds: ["texture"],
+        applicableExtensions: [".png", ".jpg", ".jpeg", ".tga"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Use read_asset on .meta files or inspect TextureImporter settings via execute_csharp.",
+    },
+    {
+        id: "sprite_2d_analysis",
+        title: "Sprite 2D analysis",
+        description: "Validates sprite atlas packing, multiple-sprite geometry, and 2D animation bone references.",
+        applicableAssetKinds: ["sprite"],
+        applicableExtensions: [".png", ".jpg", ".jpeg", ".tga"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Inspect sprite importers via read_asset or execute_csharp.",
+    },
+    {
+        id: "animation_analysis",
+        title: "Animation analysis",
+        description: "Detects missing animation curves, broken animator transitions, and unused clips.",
+        applicableAssetKinds: ["animation"],
+        applicableExtensions: [".controller", ".anim"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Use find_references to trace animator usage and read_asset to inspect clips.",
+    },
+    {
+        id: "audio_analysis",
+        title: "Audio analysis",
+        description: "Flags uncompressed audio, missing platform overrides, and load-type mismatches.",
+        applicableAssetKinds: ["audio"],
+        applicableExtensions: [".wav", ".mp3", ".ogg"],
+        implemented: false,
+        status: "planned",
+        issues: [],
+        guidance: "Not yet ported. Inspect AudioImporter settings via read_asset or execute_csharp.",
+    },
+];
+// ---------------------------------------------------------------------------
+// Full catalog
+// ---------------------------------------------------------------------------
+export const RULE_CATALOG = [
+    {
+        id: "missing_references",
+        title: "Missing references",
+        description: "Detects broken PPtr references (missing GUID/FileID), missing script GUIDs, " +
+            "UnityEvent target gaps, duplicate components, and invalid layers across prefabs, " +
+            "scenes, and ScriptableObject assets.",
+        applicableAssetKinds: ["prefab", "scene", "scriptable_object"],
+        applicableExtensions: [".prefab", ".unity", ".asset"],
+        implemented: true,
+        status: "implemented",
+        issues: MISSING_REFERENCES_ISSUES,
+    },
+    {
+        id: "scene_prefab_health",
+        title: "Scene and prefab health",
+        description: "Scene and prefab structural health: broken references, bootstrap density, object/component " +
+            "counts, inactive-object waste, prefab nesting depth, and override explosion.",
+        applicableAssetKinds: ["scene", "prefab"],
+        applicableExtensions: [".unity", ".prefab"],
+        implemented: true,
+        status: "implemented",
+        issues: SCENE_PREFAB_HEALTH_ISSUES,
+    },
+    {
+        id: "dependencies",
+        title: "Forward dependency graph",
+        description: "Forward-graph view of what each scoped asset depends on. Complements the reverse " +
+            "find_references lookup and the per-PPtr-field missing_references rule: catches " +
+            "asset-graph edges (PPtr, AssetReference, addressable) that do not resolve, plus " +
+            "forward dependency cycles scoped to paths_hint.",
+        applicableAssetKinds: ["prefab", "scene", "scriptable_object", "material", "animation"],
+        applicableExtensions: [".prefab", ".unity", ".asset", ".mat", ".controller", ".anim"],
+        implemented: true,
+        status: "implemented",
+        issues: DEPENDENCIES_ISSUES,
+    },
+    ...PLANNED_RULES,
+];
+// ---------------------------------------------------------------------------
+// Planned fixes — deferred from M12 T2.4 (no emitting rule yet)
+// ---------------------------------------------------------------------------
+//
+// These targets have no implemented rule today (orphan_meta / duplicate_guid
+// are not emitted by any rule; reassign_missing_* wait on the `materials` rule
+// which is deferred to M17). They are advertised as planned so agents get a
+// structured "not yet available" signal instead of trial-and-error.
+const PLANNED_FIXES = [
+    {
+        id: "remove_orphan_meta",
+        implemented: false,
+        status: "planned",
+        rules: [],
+        issueCodes: [],
+        safe: true,
+        guidance: "Not yet ported. No rule emits an orphan_meta issue today. " +
+            "Find .meta files whose asset was deleted manually via find_members or " +
+            "AssetDatabase and delete them with execute_csharp in the meantime.",
+    },
+    {
+        id: "fix_duplicate_guid",
+        implemented: false,
+        status: "planned",
+        rules: [],
+        issueCodes: [],
+        safe: false,
+        guidance: "Not yet ported. No rule emits a duplicate_guid issue today. " +
+            "Inspect .meta files manually (or via execute_csharp) and regenerate the " +
+            "duplicated GUID on the less-referenced asset, then update references.",
+    },
+    {
+        id: "reassign_missing_texture",
+        implemented: false,
+        status: "planned",
+        rules: ["materials"],
+        issueCodes: [],
+        safe: false,
+        guidance: "Not yet ported — depends on the `materials` rule (deferred to M17). " +
+            "Use read_asset on the .mat file and execute_csharp to reassign the " +
+            "_MainTex / texture properties in the meantime.",
+    },
+    {
+        id: "reassign_missing_shader",
+        implemented: false,
+        status: "planned",
+        rules: ["materials"],
+        issueCodes: [],
+        safe: false,
+        guidance: "Not yet ported — depends on the `materials` rule (deferred to M17). " +
+            "Use find_references to locate the intended shader and execute_csharp " +
+            "to reassign m_Shader on the material in the meantime.",
+    },
+];
+export const FIX_CATALOG = [
+    {
+        id: "remove_missing_script",
+        implemented: true,
+        status: "implemented",
+        rules: ["missing_references"],
+        issueCodes: ["missing_script"],
+        safe: true,
+    },
+    {
+        id: "relink_broken_guid",
+        implemented: true,
+        status: "implemented",
+        rules: ["missing_references", "dependencies"],
+        issueCodes: ["missing_guid", "broken_dependency"],
+        // Mutates references and a wrong choice silently rewires the asset graph;
+        // never auto-applied under enforce. Apply via apply_fix with target_guid.
+        safe: false,
+    },
+    ...PLANNED_FIXES,
+];
+export function implementedRules() {
+    return RULE_CATALOG.filter((r) => r.implemented);
+}
+export function plannedRules() {
+    return RULE_CATALOG.filter((r) => !r.implemented);
+}
+export function implementedFixes() {
+    return FIX_CATALOG.filter((f) => f.implemented);
+}
+//# sourceMappingURL=rule-catalog.js.map

package/dist/capabilities/rule-catalog.js.map

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

package/dist/capabilities/tool-groups.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Catalog entry for one tool group.
+ */
+export interface ToolGroup {
+    /** Stable lowercase group id (e.g. `"core"`, `"navigation"`). */
+    id: string;
+    /** Short human-readable description of what the group covers. */
+    description: string;
+    /**
+     * True when the group is enabled by default for every fresh session.
+     * Only `"core"` is default-on; everything else must be activated.
+     */
+    defaultEnabled: boolean;
+    /**
+     * Optional bridge compile define (`UNITY_OPEN_MCP_EXT_<DOMAIN>`). When
+     * present, capabilities reports `available: false (dependency missing)`
+     * for the group if the bridge did not compile the domain in. Omitted for
+     * groups that ship in every bridge build (core, gate-and-verify, etc.).
+     */
+    domainDefine?: string;
+    /**
+     * Optional Unity package name the group depends on. Surfaced in the
+     * capabilities `available: false` message so the agent knows what to
+     * install to make the group's tools compile in.
+     */
+    unityPackage?: string;
+}
+/**
+ * Ordered catalog. Order is preserved in manage_tools / capabilities output
+ * so consumers render a stable list.
+ */
+export declare const TOOL_GROUPS: ToolGroup[];
+/**
+ * Set of group ids enabled by default for every fresh session.
+ * Per the resolved decision (M18 execution-plan.md), this is `core` only.
+ */
+export declare const DEFAULT_ENABLED_GROUPS: ReadonlySet<string>;
+/** All known group ids (validates activate / deactivate input). */
+export declare const GROUP_IDS: ReadonlySet<string>;
+export declare function getGroup(id: string): ToolGroup | undefined;
+/**
+ * Resolve a tool name to its group id. Returns `null` for tools with no
+ * assignment (server meta-tools: capabilities, list_rules, generate_skill,
+ * manage_tools, pull_events, read_compile_errors). Null means "always
+ * visible" — manage_tools and ListTools never hide a null-group tool.
+ */
+export declare function groupFor(toolName: string): string | null;
+/**
+ * Inverse map: group id → sorted tool names. Used by manage_tools
+ * `list_groups` to enumerate every group with its tool roster. Tools with a
+ * null group are intentionally omitted (they are always-visible meta-tools).
+ */
+export declare function groupToTools(): Record<string, string[]>;