[Amantux]

Using the emulator as the reference, upgrade the element coordinate to the real documented shape — verified against the emulator end-to-end.

Now grounded in the real spec, not a guess: fetched the actual Quantum Web Services manual (6-68185-01 Rev D) via docs/reference/quantum/fetch.sh and read the contract. The element coordinate is an object {frame,rack,section,column,row,type} (Figure 23), not the reduced "frame,bay,slot" string the emulator returned.

• _slot_coordinate builds a full ScalarCoordinate (section = bay/module, row = slot, type = 2 storage); ElementResource.coordinate is the object form.
• test_aml_diagnostics asserts the full object + section/row uniqueness (was the old string prefix).
• docs/reference/i3-contract-notes.md records the certified values (coordinate shape + the real moveClass bit field 0/2/4/8/16/32, with 3 deprecated) with citations — never the copyrighted text.
• pyproject: ignore A002 (FastAPI path params like id ARE the wire contract; per docs/tech-debt.md).

Honesty: the STRUCTURE is doc-faithful; the field VALUES are the emulator's geometry (manual is Rev D 2019; appliance is 341G) — labeled as such, not appliance-certified. 88 elements-consumer tests green (diagnostics, library-spec-parity, scalar_http client).

Next: apply the real moveClass values (8=unload, bit field) with the same emulator-as-reference approach.

https://claude.ai/code/session_012K5Zjc2bggcyJtFbz2D4Pw

[Copilot]

Pull request overview

This PR updates the Quantum AML emulator’s /aml/physicalLibrary/elements response to return a full physical coordinate object (matching the documented Web Services “Figure 23” shape) instead of the legacy reduced "frame,bay,slot" string, and updates integration tests + compatibility notes to reflect the wire change.

Changes:

• Changed slot element coordinate from a reduced string to a full {frame,rack,section,column,row,type} object derived from ScalarCoordinate.
• Updated AML diagnostics integration test to validate the object shape and enforce uniqueness by (section, row).
• Documented the certified coordinate shape and moveClass bit-field notes (without vendor text), and updated a compatibility capture’s fidelity notes accordingly.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
openblade/api/routes_aml_library.py	Switches ElementResource.coordinate to an object form and updates _slot_coordinate() to emit a full ScalarCoordinate dict.
tests/integration/test_aml_diagnostics.py	Updates assertions to validate the coordinate object shape and uniqueness semantics.
docs/reference/i3-contract-notes.md	Adds a non-copyrighted contract-notes doc capturing certified coordinate structure and moveClass bit-field guidance.
compatibility/scalar-i3-341g/aml/elements-list-authed.json	Updates fidelity notes to reflect the new coordinate object wire shape.
pyproject.toml	Adds global Ruff ignore for A002 with rationale tied to preserving wire-contract parameter names.