# TASK-122-02-01: `macro_attach_part_to_surface`

**Parent:** [TASK-122-02](./TASK-122-02_Creature_Correction_Macro_Tool_Wave.md)  
**Status:** ✅ Done  
**Priority:** 🔴 High

**Completion Summary:** Added `macro_attach_part_to_surface` as a bounded surface-attachment macro on the scene MCP surface. The first slice reuses the deterministic bbox/contact logic from the relative-layout stack, but narrows the UX to one explicit surface axis, one side, one shared tangential alignment mode, optional gap, and one deterministic transform with contact-oriented verification hints.

## Objective

Add a bounded macro for seating one part onto another object's surface/body with predictable orientation and contact behavior.

## Repository Touchpoints

- `server/domain/tools/`
- `server/application/tool_handlers/`
- `blender_addon/application/handlers/`
- `blender_addon/__init__.py`
- `server/adapters/mcp/areas/`
- `server/adapters/mcp/dispatcher.py`
- `server/infrastructure/di.py`
- `server/router/infrastructure/tools_metadata/`
- `tests/unit/`
- `tests/e2e/`
- `_docs/_MCP_SERVER/README.md`
- `_docs/_ADDON/README.md`

## Acceptance Criteria

- the macro can seat one part onto a target surface/body using bounded orientation/contact parameters
- the macro returns a structured report with deterministic follow-up recommendations instead of requiring raw atomic-tool chaining

## Docs To Update

- `_docs/_MCP_SERVER/README.md`
- `_docs/_ADDON/README.md`
- `_docs/AVAILABLE_TOOLS_SUMMARY.md`
- `_docs/_ROUTER/README.md` when router-aware metadata or guided usage changes

## Tests To Add/Update

- `tests/unit/` for contract and handler coverage
- `tests/e2e/` when geometry, alignment, contact, or cleanup behavior changes in Blender

## Changelog Impact

- add a `_docs/_CHANGELOG/*.md` entry when this leaf changes macro behavior, contracts, metadata, or public docs

## Status / Board Update

- this leaf is closed; the parent macro wave is now in progress and the board-level `TASK-122` umbrella remains in progress
