Skip to content

v0.8.0

Latest

Choose a tag to compare

@Kubonsang Kubonsang released this 10 Jul 04:46
d6c4e54

Structural scene mutation: unity-ctx can now move, reparent, and delete existing scene objects — the first mutations that edit scene topology — plus a breaking exit-code contract fix.

New commands

  • scene reposition — rewrite a Transform's m_LocalPosition in place (Transform/RectTransform only; only the three axis numbers change, every other byte survives).
  • scene reparent (v2 ops[] patch) — move a Transform under a new parent: m_Father + both parents' m_Children updated atomically. Cycle-creating moves are refused at plan time (WOULD_CREATE_CYCLE).
  • scene delete (v2 ops[] patch, --cascade) — remove a GameObject + components (+ subtree), unlinking the parent's m_Children or the scene's SceneRoots. Orphaning, prefab-instance content, and surviving in-file references all block.

Cross-file safety

New per-mutation reverse-reference scanner (internal/xref): walks Assets/ + Packages/, sniffs Unity text YAML by header, and recovers inline PPtrs in every serialization form via a brace-aware raw scan — anything it cannot fully account for is reported as indeterminate, never silently passed. Reparent surfaces inbound references as WARN; delete hard-blocks on them (--write requires --project).

⚠️ Breaking: BLOCKED now exits 3 (was 0)

A safety refusal is no longer distinguishable-only-by-prefix: BLOCKED (file untouched) exits 3, with an EnforceBlockedExit backstop at the CLI boundary. Automated callers branching on exit codes: treat 0 = OK/WARN/UNKNOWN/NEED_PREFAB_GUID, 1 = ERROR, 2 = usage, 3 = BLOCKED.

Engineering

  • Safety kernel bumped to unity-fileid-graph v0.9.2 (transform symmetry gap closed in v0.9.1, transform cycle detection in v0.9.2).
  • index snapshots now stamp the real build version in generated_by.
  • Docs synced end-to-end (README en/ko, COMMANDS, AGENT-USAGE, agent skill); full analysis in docs/PROJECT-ANALYSIS-2026-07.md.

Slices S1–S5, PRs #34#40, hardened by adversarial multi-lens reviews and verified against a real Unity project corpus.

Install: go install github.com/Kubonsang/unity-ctx/cmd/unity-ctx@v0.8.0

🤖 Generated with Claude Code