bulk-maintenance

Safe Bulk Maintenance

Use unreal.WorkflowService.run_bulk_maintenance(plan_json, apply, batch_size, stop_on_error) for an explicit target list. It is dry-run-first, path-scoped, bounded to 100 targets per GC batch, returns one result per target, rolls back a failed apply operation, and writes a resumable report under Saved/VibeUE/Bulk.

Rules:

1. Discover candidates, but pass the final explicit targets array yourself. Never turn a search result directly into deletion.
2. Call once with apply=False, inspect every would-change/refusal, then repeat the exact plan with apply=True and the same resume_id.
3. Set path_scope so a malformed target cannot escape the intended content folder.
4. Use a small batch_size (10–25) for Blueprint work. Each apply target gets a named transaction; compile/save failure is reported as failure and rolled back.
5. Wrap an unattended task in start_run / finish_run; attach the bulk report and verification.

1. Blueprint interface migration

Discover implementers/referencers with GameIQ when available, compile the candidates before the change, and migrate in two reviewed phases:

import json, unreal
plan = {
  "resume_id": "combat-interface-v2",
  "operation": "interface_add",
  "path_scope": "/Game/Combat",
  "interface": "/Game/Combat/Interfaces/BPI_CombatV2",
  "targets": ["/Game/Combat/BP_Rifle", "/Game/Combat/BP_Sword"]
}
print(unreal.WorkflowService.run_bulk_maintenance(json.dumps(plan), False, 10, True))
# Review, then use True. Remove the old interface only after compile/readback proves v2 is present.

interface_add and interface_remove compile each Blueprint and save only verified successes.

2. Blueprint metadata hygiene

Descriptions are caller-provided intent; the service never invents text. Existing authored metadata is preserved unless that specific target says "overwrite": true.

{"resume_id":"combat-metadata-1","operation":"variable_metadata","path_scope":"/Game/Combat","targets":[
  {"asset":"/Game/Combat/BP_Rifle","variable":"Ammo","category":"Weapon|Ammo","description":"Rounds remaining in the current magazine."},
  {"asset":"/Game/Combat/BP_Sword","variable":"Damage","category":"Weapon|Damage","description":"Base damage before modifiers."}
]}