@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/unreal_mcp/tests/unit/plugin/handler_routing_contracts.test.ts

@@ -1,120 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-import { describe, expect, it } from 'vitest';
-
-const pluginSource = (...parts: string[]): string =>
-  readFileSync(
-    resolve(
-      process.cwd(),
-      'plugins/McpAutomationBridge/Source/McpAutomationBridge/Private',
-      ...parts,
-    ),
-    'utf8',
-  );
-
-describe('plugin handler routing contracts', () => {
-  it('preserves the material authoring unknown-action response', () => {
-    const source = pluginSource(
-      'Domains',
-      'MaterialAuthoring',
-      'McpAutomationBridge_MaterialAuthoringHandlers.cpp',
-    );
-
-    expect(source).toContain('TEXT("Unknown subAction: %s")');
-    expect(source).toContain('TEXT("INVALID_SUBACTION")');
-  });
-
-  it('leaves unmatched GAS actions to the parent dispatcher', () => {
-    const leaf = pluginSource(
-      'Domains',
-      'GAS',
-      'McpAutomationBridge_GASHandlersAbilityGrantExecution.cpp',
-    );
-    const dispatcher = pluginSource(
-      'Domains',
-      'GAS',
-      'McpAutomationBridge_GASHandlers.cpp',
-    );
-
-    expect(leaf).not.toContain('TEXT("Unknown GAS subAction: %s")');
-    expect(leaf).toMatch(/return false;\s*}\s*}\s*#endif\s*$/);
-    expect(dispatcher).toContain('TEXT("Unknown GAS subAction: %s")');
-    expect(dispatcher).toContain('TEXT("UNKNOWN_SUBACTION")');
-  });
-
-  it('preserves interaction destruction response contracts after the split', () => {
-    const source = pluginSource(
-      'Domains',
-      'Interaction',
-      'McpAutomationBridge_InteractionHandlersDestruction.cpp',
-    );
-
-    expect(source).toContain('TEXT("Destructible mesh setup configured")');
-    expect(source).toContain('TEXT("setup_destructible_mesh is editor-only")');
-    expect(source).toContain('TEXT("Destruction levels configured")');
-    expect(source).toContain('TEXT("configure_destruction_levels is editor-only")');
-    expect(source).toContain('TEXT("Destruction effects configured")');
-    expect(source).toContain('TEXT("configure_destruction_effects is editor-only")');
-    expect(source).toContain('TEXT("Destruction damage configured")');
-    expect(source).toContain('TEXT("configure_destruction_damage is editor-only")');
-    expect(source).toContain('TEXT("Destruction component added")');
-    expect(source).toContain('TEXT("add_destruction_component is editor-only")');
-  });
-
-  it('preserves trigger configuration response contracts after the split', () => {
-    const source = pluginSource(
-      'Domains',
-      'Interaction',
-      'McpAutomationBridge_InteractionHandlersTriggers.cpp',
-    );
-
-    expect(source).toContain('TEXT("Trigger events configured")');
-    expect(source).toContain('TEXT("configure_trigger_events is editor-only")');
-    expect(source).toContain('TEXT("Trigger filter configured")');
-    expect(source).toContain('TEXT("configure_trigger_filter is editor-only")');
-    expect(source).toContain('TEXT("Trigger response configured")');
-    expect(source).toContain('TEXT("configure_trigger_response is editor-only")');
-    expect(source).toContain('TEXT("eventsAdded")');
-    expect(source).toContain('TEXT("variablesAdded")');
-    expect(source).toContain('TEXT("eventCount")');
-  });
-
-  it('preserves the landscape grass mesh alias and missing-mesh error', () => {
-    const source = pluginSource(
-      'Domains',
-      'Landscape',
-      'McpAutomationBridge_LandscapeGrassType.cpp',
-    );
-
-    expect(source).toContain('TryGetStringField(TEXT("meshPath"), MeshPath)');
-    expect(source).toContain('TryGetStringField(TEXT("staticMesh"), MeshPath)');
-    expect(source).toContain('TEXT("meshPath or staticMesh required")');
-    expect(source).toContain('TEXT("INVALID_ARGUMENT")');
-  });
-
-  it('preserves manage_effect Niagara authoring delegation', () => {
-    const source = pluginSource(
-      'Domains',
-      'Effect',
-      'McpAutomationBridge_EffectHandlers.cpp',
-    );
-    const normalization = source.indexOf(
-      'McpEffectHandlers::NormalizeNativeSubAction',
-    );
-    const authoringRoute = source.indexOf(
-      'McpEffectHandlers::IsNiagaraAuthoringSubAction',
-    );
-    const legacyContext = source.indexOf(
-      'McpEffectHandlers::FEffectActionContext Context',
-    );
-
-    expect(normalization).toBeGreaterThanOrEqual(0);
-    expect(authoringRoute).toBeGreaterThan(normalization);
-    expect(legacyContext).toBeGreaterThan(authoringRoute);
-    expect(source).toContain(
-      'HandleManageNiagaraAuthoringAction(\n' +
-        '            RequestId, TEXT("manage_niagara_authoring"), LocalPayload, RequestingSocket)',
-    );
-  });
-});

package/mcps/unreal_mcp/tests/unit/plugin/level_lighting_contracts.test.ts

@@ -1,125 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-import { describe, expect, it } from 'vitest';
-
-const pluginSource = (...parts: string[]): string =>
-  readFileSync(
-    resolve(
-      process.cwd(),
-      'plugins/McpAutomationBridge/Source/McpAutomationBridge/Private',
-      ...parts,
-    ),
-    'utf8',
-  );
-
-describe('level and lighting build contracts', () => {
-  it('uses typed lighting build APIs and reports their result', () => {
-    const source = pluginSource(
-      'Domains',
-      'Lighting',
-      'McpAutomationBridge_LightingHandlersBuild.cpp',
-    );
-    const compatibilitySource = pluginSource(
-      'Domains',
-      'Lighting',
-      'McpAutomationBridge_LightingBuildCompatibility.cpp',
-    );
-
-    expect(source).toContain('Payload.IsValid()');
-    expect(source).toContain(
-      'ENGINE_MAJOR_VERSION == 5 && ENGINE_MINOR_VERSION >= 3',
-    );
-    expect(source).toContain('BuildLightMaps(QualityEnum, bBuildReflectionCaptures)');
-    expect(source).toContain('RunLegacyLightingBuild(*World, QualityEnum)');
-    expect(compatibilitySource).toContain(
-      'FEditorBuildUtils::EditorBuild(',
-    );
-    expect(source).toContain('TEXT("UNSUPPORTED_BUILD_OPTION")');
-    expect(source).not.toContain('TEXT("BuildLighting %s")');
-    expect(source).not.toContain('GEditor->Exec(');
-  });
-
-  it('preserves persisted full-build settings around legacy engine builds', () => {
-    const source = pluginSource(
-      'Domains',
-      'Lighting',
-      'McpAutomationBridge_LightingBuildCompatibility.cpp',
-    );
-
-    for (const key of [
-      'OnlyBuildSelected',
-      'OnlyBuildCurrentLevel',
-      'OnlyBuildSelectedLevels',
-      'OnlyBuildVisibility',
-    ]) {
-      expect(source).toContain(`TEXT("${key}")`);
-    }
-    expect(source).toContain('GConfig->GetBool(');
-    expect(source).toContain('GConfig->SetBool(');
-    expect(source).toContain('GConfig->RemoveKey(');
-    expect(source).toContain('RestoreBoolSetting');
-  });
-
-  it('restores level lighting scenario mutation and enumeration', () => {
-    const source = pluginSource(
-      'Domains',
-      'Level',
-      'World',
-      'McpAutomationBridge_LevelHandlersLighting.cpp',
-    );
-
-    expect(source).toContain(
-      'TargetLevel->SetLightingScenario(bIsLightingScenario);',
-    );
-    expect(source).toContain('Level->bIsLightingScenario');
-    expect(source).toContain('TEXT("scenarios")');
-    expect(source).not.toContain('SendUnsupportedLevelAction');
-    expect(source).not.toContain('TEXT("NOT_IMPLEMENTED")');
-  });
-
-  it('checks the level navigation and full-build results', () => {
-    const source = pluginSource(
-      'Domains',
-      'Level',
-      'World',
-      'McpAutomationBridge_LevelHandlersLighting.cpp',
-    );
-
-    expect(source).toContain(
-      'FEditorBuildUtils::EditorBuild(World, FBuildOptions::BuildAIPaths)',
-    );
-    expect(source).toContain(
-      'FEditorBuildUtils::EditorBuild(World, FBuildOptions::BuildAll)',
-    );
-    expect(source).toContain('TEXT("BUILD_FAILED")');
-    expect(source).not.toContain('GEditor->Exec(World, TEXT("Build"))');
-    expect(source).not.toContain('NavSys->Build()');
-  });
-
-  it('advertises rendering method values in the native build_environment schema', () => {
-    const source = pluginSource(
-      'MCP',
-      'Tools',
-      'World',
-      'McpBuildEnvironmentSchemaFields.h',
-    );
-
-    for (const value of ['Filmic', 'CinematicDOF', 'Manual']) {
-      expect(source).toContain(`TEXT("${value}")`);
-    }
-  });
-
-  it('does not report scene-capture resolution changes without a render target', () => {
-    const source = pluginSource(
-      'Domains',
-      'Render',
-      'McpAutomationBridge_RenderSceneCapture.cpp',
-    );
-
-    expect(source).toContain('RENDER_TARGET_NOT_ASSIGNED');
-    expect(source).toContain('Capture2D->TextureTarget->ResizeTarget(Resolution, Resolution);');
-    expect(source).toContain('Result->SetNumberField(TEXT("resolution")');
-  });
-
-});

package/mcps/unreal_mcp/tests/unit/plugin/plugin_manifest_contracts.test.ts

@@ -1,154 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-import { describe, expect, it } from 'vitest';
-import { z } from 'zod';
-
-const pluginDependencySchema = z.object({
-  Name: z.string(),
-  Enabled: z.boolean(),
-  Optional: z.boolean().optional(),
-});
-
-const pluginManifestSchema = z.object({
-  FileVersion: z.number(),
-  Version: z.number(),
-  VersionName: z.string(),
-  EngineVersion: z.string().optional(),
-  Installed: z.boolean().optional(),
-  CanContainContent: z.boolean(),
-  Plugins: z.array(pluginDependencySchema),
-});
-
-const readPluginManifest = (): z.infer<typeof pluginManifestSchema> =>
-  pluginManifestSchema.parse(
-    JSON.parse(
-      readFileSync(
-        resolve(
-          process.cwd(),
-          'plugins/McpAutomationBridge/McpAutomationBridge.uplugin',
-        ),
-        'utf8',
-      ),
-    ),
-  );
-
-describe('plugin manifest contracts', () => {
-  it('keeps the source descriptor portable across supported engine versions', () => {
-    // Given
-    const manifest = readPluginManifest();
-
-    // When
-    const sourceDistributionFields = {
-      EngineVersion: manifest.EngineVersion,
-      Installed: manifest.Installed,
-    };
-
-    // Then
-    expect(sourceDistributionFields).toEqual({
-      EngineVersion: undefined,
-      Installed: undefined,
-    });
-  });
-
-  it('preserves the plugin release version', () => {
-    // Given
-    const manifest = readPluginManifest();
-
-    // When
-    const version = {
-      FileVersion: manifest.FileVersion,
-      Version: manifest.Version,
-      VersionName: manifest.VersionName,
-    };
-
-    // Then
-    expect(version).toEqual({
-      FileVersion: 3,
-      Version: 530,
-      VersionName: '0.5.30',
-    });
-  });
-
-  it('keeps required engine integrations enabled and nonoptional', () => {
-    // Given
-    const manifest = readPluginManifest();
-    const requiredDependencies = [
-      'PythonScriptPlugin',
-      'EditorScriptingUtilities',
-      'Niagara',
-      'GameplayAbilities',
-      'SmartObjects',
-    ] as const;
-
-    // When
-    const dependencyContracts = requiredDependencies.map((name) =>
-      manifest.Plugins.find((dependency) => dependency.Name === name),
-    );
-
-    // Then
-    for (const [index, dependency] of dependencyContracts.entries()) {
-      expect(dependency).toEqual({
-        Name: requiredDependencies[index],
-        Enabled: true,
-      });
-    }
-  });
-
-  it('keeps supported optional integrations enabled when available', () => {
-    // Given
-    const manifest = readPluginManifest();
-    const optionalDependencies = [
-      'LevelSequenceEditor',
-      'NiagaraEditor',
-      'BehaviorTreeEditor',
-      'EnvironmentQueryEditor',
-      'ControlRig',
-      'RigVM',
-      'IKRig',
-      'ChaosVehiclesPlugin',
-      'AnimationData',
-      'ProceduralMeshComponent',
-      'Interchange',
-      'InterchangeOpenUSD',
-      'DataValidation',
-      'EnhancedInput',
-      'GeometryScripting',
-      'GeometryProcessing',
-      'ChaosCloth',
-      'StructUtils',
-      'Metasound',
-      'StateTree',
-      'MassGameplay',
-      'OnlineSubsystem',
-      'OnlineSubsystemUtils',
-      'Synthesis',
-      'PCG',
-    ] as const;
-
-    // When
-    const dependencyContracts = optionalDependencies.map((name) =>
-      manifest.Plugins.find((dependency) => dependency.Name === name),
-    );
-
-    // Then
-    for (const [index, dependency] of dependencyContracts.entries()) {
-      expect(dependency).toEqual({
-        Name: optionalDependencies[index],
-        Enabled: true,
-        Optional: true,
-      });
-    }
-  });
-
-  it('retains a code-only descriptor for the packaging placeholder', () => {
-    // Given
-    const manifest = readPluginManifest();
-
-    // When
-    const canContainContent = manifest.CanContainContent;
-
-    // Then
-    expect(canContainContent).toBe(false);
-  });
-});

package/mcps/unreal_mcp/tests/unit/plugin/plugin_packaging_contracts.test.ts

@@ -1,124 +0,0 @@
-/// <reference types="node" />
-
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-import { describe, expect, it } from 'vitest';
-
-const pluginRoot = resolve(
-  process.cwd(),
-  'plugins/McpAutomationBridge',
-);
-const repoRoot = resolve(process.cwd());
-
-const readFilterRules = (): readonly string[] =>
-  readFileSync(resolve(pluginRoot, 'Config/FilterPlugin.ini'), 'utf8')
-    .split(/\r?\n/u)
-    .map((line) => line.trim())
-    .filter(
-      (line) =>
-        line.length > 0 &&
-        !line.startsWith(';') &&
-        line !== '[FilterPlugin]',
-    );
-
-describe('plugin packaging contracts', () => {
-  it('packages the public plugin documentation and license', () => {
-    // Given
-    const rules = readFilterRules();
-
-    // When
-    const documentationRules = ['/README.md', '/CHANGELOG.md', '/LICENSE'];
-
-    // Then
-    expect(rules).toEqual(expect.arrayContaining(documentationRules));
-  });
-
-  it('excludes source-scoped agent instructions with FileFilter syntax', () => {
-    // Given
-    const rules = readFilterRules();
-
-    // When
-    const sourceAgentRule = rules.find((rule) => rule.includes('AGENTS.md'));
-
-    // Then
-    expect(sourceAgentRule).toBe('-/Source/.../AGENTS.md');
-  });
-
-  it('retains an empty Content directory in packaged submissions', () => {
-    // Given
-    const rules = readFilterRules();
-    const placeholder = resolve(pluginRoot, 'Content/.keep');
-
-    // When
-    const contentRule = rules.find((rule) => rule === '/Content/...');
-
-    // Then
-    expect(contentRule).toBe('/Content/...');
-    expect(existsSync(placeholder)).toBe(true);
-  });
-
-  it('builds versioned packages from a staged descriptor with PCG enabled', () => {
-    const shellScript = readFileSync(
-      resolve(repoRoot, 'scripts/package-plugin.sh'),
-      'utf8',
-    );
-    const batchScript = readFileSync(
-      resolve(repoRoot, 'scripts/package-plugin.bat'),
-      'utf8',
-    );
-
-    expect(shellScript).toContain('SOURCE_PLUGIN_FILE=');
-    expect(shellScript).toContain("dependency.pop('Optional', None)");
-    expect(shellScript).toContain('-Plugin="$SOURCE_PLUGIN_FILE"');
-    expect(batchScript).toContain('SOURCE_PLUGIN_FILE=');
-    expect(batchScript).toContain("Properties.Remove('Optional')");
-    expect(batchScript).toContain('-Plugin="%SOURCE_PLUGIN_FILE%"');
-  });
-
-  it('excludes platform debug symbols from distribution archives', () => {
-    const shellScript = readFileSync(
-      resolve(repoRoot, 'scripts/package-plugin.sh'),
-      'utf8',
-    );
-    const batchScript = readFileSync(
-      resolve(repoRoot, 'scripts/package-plugin.bat'),
-      'utf8',
-    );
-
-    for (const extension of ['.pdb', '.debug', '.sym']) {
-      expect(shellScript).toContain(`-x "*${extension}"`);
-      expect(batchScript).toContain(`'${extension}'`);
-    }
-    expect(shellScript).toContain('-iname "*.dSYM"');
-    expect(shellScript).toContain('-x "*.dSYM/*"');
-    expect(shellScript).toContain("part.endswith('.dsym')");
-    expect(batchScript).toContain("-Filter '*.dSYM'");
-    expect(batchScript).toContain(".Contains('.dsym/')");
-    expect(shellScript).toContain('rm -f "$ZIP_PATH"');
-    expect(shellScript).toContain('find "$OUTPUT_PLUGIN_DIR" -type f');
-    expect(shellScript).toContain('zipfile.ZipFile(archive_path)');
-    expect(shellScript).toContain(
-      'name.lower().endswith(forbidden_extensions)',
-    );
-    expect(batchScript).toContain(
-      '[System.IO.Compression.ZipFile]::OpenRead($args[0])',
-    );
-    expect(batchScript).toContain('Archive verification failed.');
-  });
-
-  it('links PCG only when the project or staged descriptor enables it', () => {
-    const buildRules = readFileSync(
-      resolve(
-        pluginRoot,
-        'Source/McpAutomationBridge/McpAutomationBridge.Build.cs',
-      ),
-      'utf8',
-    );
-
-    expect(buildRules).toContain('ProjectDescriptor.FromFile(Target.ProjectFile)');
-    expect(buildRules).toContain('PluginDescriptor.FromFile');
-    expect(buildRules).toContain('Reference.bEnabled && !Reference.bOptional');
-    expect(buildRules).toContain('&& AddOptionalDynamicModule(Target, EngineDir, "PCG", "PCG")');
-  });
-});