Diagnostics

error[ARA1302]: `@models/statue.glb#as_statue` does not resolve: no asset has that ID or path
  --> levels/main.scene · e_8vha · MeshRenderer.model

warning[ARA1303]: stale path `props/crate.prefab` in `@props/crate.prefab#pf_crate001`; `pf_crate001` now lives at `prefabs/crate.prefab`
  --> levels/main.scene · e_p66p · prefab
  = fix: Write `@prefabs/crate.prefab#pf_crate001`

ara why ARA1302

ARA1302 Unresolved reference: Neither the reference's path nor its ID is in the project's asset index. Not on the bus now; its usual causes:
1. [low] The asset was deleted, moved without a usable ID, or never added to the project. (ARA1302)
2. [low] Both halves are mistyped, or the target's document header or import sidecar is invalid and was not indexed. (ARA1302)
checked: on the bus n/a (no occurrences now)

Fixes in general:
- Restore the asset and its valid document header or import sidecar, then run `ara check`.
- Choose the intended reference from the diagnostic's suggestions; `ara check --fix <file>` applies it only when there is exactly one fix, otherwise use `property.set` or correct the file explicitly.
Docs: ara://docs/errors/ARA1302 (ara_docs ARA1302)

ara check                       # every document in the project
ara check levels/main.scene     # just these files
ara check --fix                 # apply unambiguous fixes, then check again

ara logs

3 errors · 0 warnings · 0 info (3 occurrences)
error ARA1204 Record not found
  no entity matches `name:Lantern` in this document
  --> call #0 · commands[0].args.entity
error ARA1610 Agent change needs a reason
  agent changes need a `why`: one sentence on the reason, shown to the human who reviews them
  --> why
  fix: Add a `why`
error ARA1609 Entity selector is ambiguous
  `name:Crate` matches 2 entities; use one of their IDs, or name a parent too (`name:Parent/Child`)
  --> call #0 · commands[0].args.entity
  fix: Use `e_8d41` (Crate)
cursor 3 · explain: ara why ARA1204

ara logs --since 3

no new diagnostics since #3 (cursor 3)

ara why name:Box not visible

why is `Box` (e_a2ww) in levels/main.scene not visible: 3 causes, 2 certain
1. [high] `Box` (e_a2ww)'s `Transform.scale` is 0 on x (ARA3303)
   evidence: e_a2ww Transform.scale = [0, 1, 1]
   fix: Give the scale its size back: property.set {"entity":"e_a2ww","path":"Transform.scale","value":[1,1,1]}
2. [high] `MeshRenderer.mesh` names no mesh (ARA3305)
   then: set `MeshRenderer.mesh` to a mesh asset (`ara_query` the meshes folder)
3. [medium] `levels/main.scene` has no enabled camera, so nothing in it is drawn in game (the editor viewport has its own) (ARA3310)
   then: add an entity with a `Camera` component (`entity.create`), or enable the existing one
checked: enabled ok, renderer ok (MeshRenderer), transform FAIL (world position [0, 0, -4]), mesh FAIL (none), material n/a (default), camera FAIL (none enabled), streaming n/a (no reports), passes ? (needs the running renderer)
run a fix: ara_apply {cmd, args}, or `ara do <cmd> --args '<args>'`

ara do property.set --args '{"entity":"e_a2ww","path":"Transform.scale","value":[1,1,1]}' --why "Give the box its size back"

ARA1609 Entity selector is ambiguous: A name selector matches multiple resolved entities in the selected document. 1 occurrences now:
1. [high] `name:Crate` matches 2 entities; use one of their IDs, or name a parent too (`name:Parent/Child`) (ARA1609)
   evidence: at call #0 · commands[0].args.entity
   fix: Use `e_8d41` (Crate) — set commands[0].args.entity = "e_8d41"
   fix: Use `e_p66p` (Crate) — set commands[0].args.entity = "e_p66p"
checked: on the bus FAIL (1 records, 1 occurrences)