TjT8UdZddlmZddlmZmZmZmZmZm Z dZ dZ dZ dZ e e e e fZded <d d d d Zded<dZded<GddeZeeefZeeefZeeefZ ddZed ddZdedd ddZ d dZ d!dZy)"u W20A2: FP geometry readback bridge — pure deterministic builder. Consumes a ``base_location_dossier`` (W20A) and emits: - ``readback`` — a ``GeometryReadback`` shape with marker cells. status ∈ {ok, synthetic_fixture, failed}. **W20A2 produces synthetic_fixture ONLY**; the ``ok`` status path is reserved for a future wave that wires a real VLM provider (see the provider-slot docstring below). - ``geometry`` — geometry candidates derived from the readback: per-marker cells, per-unit camera/look-at candidate cells, direction-vector records, view-cone records keyed on a generic lens enum, visible-unit / visible-opening superset maps, and wall/door invalidation diagnostics. W20 boundaries enforced in this module: - exact-ID only — every join uses marker number / fp_id exact equality. - no semantic reference policy, no camera pick. Code emits **candidate** sets and diagnostics; the consumer (W20B) makes the LLM-owned decisions. - no scenario-specific static literals (the only string keys here are generic enum / shape-kind strings). - no LLM / image / VLM / DB / ImageAsset imports. - the synthetic fixture path is intentionally a placeholder. It exists so downstream code (W20B planner contract, HTML overlay emitter, tests) can be exercised before the real VLM is wired. The geometry decisions made off synthetic cells must not be promoted to a production smoke without first being recomputed against a real VLM readback. Real VLM provider slot ====================== A ``call_vlm_grid_readback`` callable can be passed into ``compute_readback(...)`` to swap the synthetic_fixture path for a real provider. The callable signature is:: Callable[[BaseLocationDossier, fp_image_path], GeometryReadback] The W20A2 wave **does not** wire any real provider. ``compute_readback`` with ``vlm_provider=None`` (default) always returns the synthetic_fixture readback. A future wave behind explicit approval will wire a litellm vision call to populate the ``ok`` path; see ``backend/scripts/experiment_floor_plan_vlm_readback_slice.py`` (W17C) for the historical reference pattern. ) annotations)AnyCallableDictListOptionalTuplebase_structural_unit base_openingbase_persistent_fixturebase_persistent_furniturezTuple[str, ...] BASE_KINDSZ2)widenormal telephotozDict[str, int]VIEW_CONE_LENS_ENUM_MAP) rTuple[int, int]DEFAULT_GRID_SIZEceZdZdZy)GeometryReadbackErrorz7Fail-closed signal for the readback / geometry builder.N)__name__ __module__ __qualname____doc__g/Users/manta/Documents/Projects/TheRoad-I1/backend/app/modules/pipeline/floor_plan_geometry_readback.pyrrNsAr rc h|\}}g}tDcic]}|g}}|D],}|jd}||vs||j|.g} t} d} t d|j D} ||z} | | kDrt d| d|d|d| d tD]t}t||d D]^} | |z}| |z}| d z } ||k\r t d ||f| vr'| j||f| jt|d |||d`v|jd| |fScc}w)uSDeterministically spread base markers across the grid. Marker order is ``BASE_KINDS`` outer × ``number ascending`` inner. Each marker takes the next unused cell in column-major order. This is **not** a realistic floor-plan layout — it exists so geometry computation has something to operate on before a real VLM readback is wired up. Raises ``GeometryReadbackError`` when the grid cannot fit every base marker (``rows * cols < |markers|``). This is intentional: a silent overwrite would let synthetic geometry collide cells and mask bugs downstream. base_layer_decisionrc32K|]}t|ywN)len.0vs r! z'_spread_marker_cells..{s:)9AQ)9zsynthetic_fixture cannot fit z base markers in a xz grid (capacity )ct|dS)Nnumber)int)es r!z&_spread_marker_cells..s Qx[9Ir )keyuFsynthetic_fixture column overflow — guard should have prevented thisr/)r/rowcolkindzsynthetic_fixture: marker cells are deterministic placeholders, not real VLM observations. Geometry derived from this readback must not be promoted to a production smoke.) rgetappendsetsumvaluesrsortedaddr0)base_inventory grid_sizerowscols diagnosticskby_kindentrydecisionobservedusedcell_idxtotal_to_place grid_capacityr7rcs r!_spread_marker_cellsrO]s$JD$K?I/Jz!2zG/J9923 w  H  $ $U + %'HDH:)9::N4KM %#+N+;<64& 0q B  GDM/IJEtO$A 905q6T>!Q "%eHo"6  $ 3K8 6 [  e0Ks D/)r@c |jd}t|tr|std|d|jdxsg}|std|dt ||\}}|Dchc]}t |d}}|Dchc]}|d }}t ||z } t ||z } d |t||| | d |d Scc}wcc}w) zReturn a synthetic_fixture-status readback for the given dossier. The readback shape mirrors what a real VLM provider would return, so the geometry / HTML layer below treats both code paths uniformly. fp_idz)dossier.fp_id missing or non-string (got r-base_marker_inventoryzdossier fp_id=z has empty base_marker_inventory)r?r@r/synthetic_fixtureN)statusrQr@observed_markersmissing_markers extra_markers confidencerC)r8 isinstancestrrrOr0r=list) dossierr@rQbase_invrHrCr1 inv_numbers seen_numbersmissingextras r!"compute_synthetic_readback_fixturerbs KK E eS !#7y B  {{239rH #UI%E F  1Hk .66X3q{#XK6)12AAhKL2[</0G <+- .E&)_$""   72s -C C N) fp_image_pathr@ vlm_providerc| t||S||||}t|ts"tdt |j d|j ddk7rtd|j dd|j d |j d k7r/td |j d d |j d |S) aReturn a readback for the dossier's fp_id. When ``vlm_provider`` is ``None`` (W20A2 default), the synthetic_fixture path is used and ``fp_image_path`` is ignored. When a provider callable is passed, it is invoked as ``vlm_provider(dossier=..., fp_image_path=..., grid_size=...)`` and its return value must be a readback dict with ``status='ok'``, matching the GeometryReadback shape. Any non-conforming return raises ``GeometryReadbackError``. )r\r@)r\rcr@z vlm_provider returned non-dict (r-rTokzvlm_provider returned status=z1; only 'ok' is accepted on the real-provider pathrQzvlm_provider fp_id mismatch: z != dossier )rbrYdictrtyperr8)r\rcr@rdouts r!compute_readbackrjs(1y   # C c4 #.tCy/A/A.B! D   wwxD #+CGGH,=+@A9 :   www7;;w//#+CGGG,<+?@{{7+. 0   Jr c0|\}}t}i}g}|jdxsgD]i}|jd}|jd} |jd} |jd} t|trt|trt d|d||vrt d|d |j |t| trt| tst d |d | d | dd | cxkr|krnn d | cxkr|ksnt d |d| d| d|d|d |j| | f} | |jd |d| d| d| d n||| | f<| tvsKt d |d| dtt|S)aValidate readback cell shape and return cell-collision diagnostics. W20E6-A: distinct marker numbers may share a single 10x10 coarse cell. The hard fail on duplicate ``(row, col)`` has been lowered to a returned diagnostic so the geometry layer can soft-degrade instead of dropping the whole readback. All other invariants stay fail-closed: - duplicate marker NUMBER -> raise - non-int row/col -> raise - out-of-grid cell -> raise - unknown kind -> raise Returns a list of per-pair collision messages (empty when no collisions). The caller folds these into the geometry diagnostics. rUr/r5r6r7z(observed_marker.number must be int (got r-zobserved_marker.number=z duplicated in readbackzobserved_marker #z row/col must be int (got row=z, col=rz cell (,z) out of grid (r,z shares 10x10 cell (z) with marker #z6 (W20E6-A: surfaced as diagnostic, not a hard failure)z kind=z not in ) r:r8rYr0boolrr>r9rr[) readbackr@rArBr_ cell_ownercell_collision_diagnosticsrFnumrMrNr7priors r!_validate_readback_cellsrss&JD$L-/J,.017R7ii! IIe  IIe yy #s#z#t'<':3'C  , ')#.EF  !S!As);'#C5)5qe1. Q  !q-4-'#C5s!A3764&# 1v&   & - -#C5(rfrSzreadback.status=z not in {ok, synthetic_fixture}rQzreadback.fp_id=z != dossier fp_id=r@c3JK|]}t|txr|dkDyw)rN)rYr0r's r!r*z.compute_geometry_candidates..cs'!.2 1c$q1u$ds!#zreadback.grid_size invalid: rr4)rnr@rUr5r6r/r7czjDcic]\}}||k(r |t|c}}Scc}}wr%)itemsr[)r7ncell marker_cells marker_kindss r!_by_kindz-compute_geometry_candidates.._by_kindusK(--/ /4A$& tDzM/   s7c32K|]}t|ywr%)r[)r(rNs r!r*z.compute_geometry_candidates..s3*AQ*r+) camera_unit camera_cell look_at_unit look_at_celldxdy length_l1rrrrrr)rrrrrr lens_enumfov_degzxreadback does not encode wall segment polylines; wall/door line-of-sight invalidation cannot be performed at this layer.zopening-to-unit adjacency cannot be derived from cell positions alone; consumer must treat visible_units_candidates and visible_openings_candidates as supersets, not committed sets.rSzkgeometry candidates computed from a synthetic_fixture readback; placeholder cells, not production geometry.zKzero base_structural_unit cells in readback; geometry candidates are empty.zfewer than two base_structural_unit cells in readback; direction-vector candidates are empty and view-cone records were skipped (a cone needs a direction).readback_statusr{unit_marker_cellsopening_marker_cellsfixture_marker_cellsfurniture_marker_cellscamera_cell_candidates_per_unit look_at_cell_candidates_per_unitdirection_vector_recordsview_cone_recordsvisible_units_candidatesvisible_openings_candidates"wall_door_invalidation_diagnosticsrprC)r7rZreturnzDict[int, List[int]])r8rtuplerr&allr0rsBASE_STRUCTURAL_UNIT BASE_OPENINGBASE_PERSISTENT_FIXTUREBASE_PERSISTENT_FURNITUREr=r[r:r<r>r9absrrxextendrZ))r\rngridr@rprFr} unit_cells opening_cells fixture_cellsfurniture_cells units_sortedopenings_sortedur_look_at_cell_setsourcerzshared_look_at_cellsrNrrcam_ucam_celltgt_utgt_cellrrrdvlensfovrrwall_door_diagnosticsrCrycellsr)r{r|s) @@r!compute_geometry_candidatesrFs"||H%@@#x||H589( )  ||G G 44#hll7367[[), .  k*?.? @D 4yA~S!.2!$*8<< +D*G H  #&d1g,DG !=I,DY-*,L#%L,-).uuU|(D U8_%(-f U8_%. ./J\*M45M89O*%L]+O +7C*6QDA   ,$C!U  D  ! !%+ . -33*3-=ID$)$(N!$R3r7!2  "8/1&0668ID#  $ $#%m#4#'=(9#:$&~$6$(N);$<T(T(!%"  9'*"6!E <6tO$$, 9  H L( K1200 D   $  $ ? " !" T)_"  8H-"  \5G5G5IJ5ITQQa5IJ "  *:J:J:LM:L$!Qc!fd1go:LM "  (5(;(;(=! (=1CFDGO(=! "  (5(;(;(=! (=1CFDGO(=! "  !(7(=(=(?# (?1CFDGO(?# "  *;AAC, C5 Fe,eT!We, ,C, " & +<BBD- D5 Fe,eT!We, ,D- '" . #$ -.C?" @ %d+E&FA" B {C" "eC. 3Dn769LKM! ! # -, -- % ( sW* W4!W/3W4 W?# W:.W:2W?>XX X X ;X 2X" *X- X(X- 1X9 X4X9 =Y 4Y /W4:W?(X- 4X9 )r?zList[Dict[str, Any]]r@rrz%Tuple[List[ReadbackEntry], List[str]])r\Dict[str, Any]r@rrGeometryReadback) r\rrcz Optional[str]r@rrdz)Optional[Callable[..., GeometryReadback]]rr)rnrr@rrz List[str])r\rrnrrGeometryCandidates)r __future__rtypingrrrrrr rrrrr__annotations__rr ExceptionrrZ ReadbackEntryrrrOrbrjrsrrr r!rs|/`#== . 37  O + &.?-BIB S#X S>#s(^G!(G!G!+ G!Z"3) )) )^$(!2 + +!+ +  ++f=&!=&.==&=&@U UU Ur