docs(mcp): document plan↔world coordinate convention (#356)

Adds a Coordinate conventions section to packages/mcp/README.md and a 71-node MCP demo scene that exercises every claim it makes. Closes #337.

Covers: right-handed scene with X/Z ground plane and Y up; metres for lengths and radians for rotations as Euler [x, y, z]; the [x, z] → (x, y, z) plan-to-world mapping with no sign flip in the stored contract; level/building-local framing (world only under identity transform); rotation-not-reflection caveat for the 2-D plan panel and the iso-default top-down azimuth offset; a worked 30° rotated slab example; and the wall-local-metres trap for door/window/place_item coordinates.

Companion: examples/coordinate-conventions-demo.{json,md} with a reference compass at the origin and Demos A/B/C/D illustrating axis-aligned baseline, the rotated example, and the page-intent vs world-result L pair.

Co-authored-by: Marcel Gruber <marcel@grubertech.com>

This commit is contained in:

Marcel Gruber

2026-06-03 13:41:52 -04:00

committed by

GitHub

co-authored by

Marcel Gruber

parent 2694bcf555

commit c986ced14d

4 changed files with 2263 additions and 0 deletions

									
										packages/mcp/package.json
									
		+1
		
												View File
												
				@@ -42,6 +42,7 @@

				  },

				  "files": [

				    "dist",

				    "examples",

				    "README.md",

				    "CHANGELOG.md"

				  ],