# ============================================================================ # knowledge/catalogue.yaml -- DISTRIBUTION CARVE-OUT, not the real file # ============================================================================ # Written by tools/make_dist.py's build_catalogue_carveout(), which reads # the owner's real knowledge/catalogue.yaml and re-emits ONLY the branches # below -- parsed and re-dumped from the real file, never hand-typed, so # this cannot drift out of step with what the real file actually publishes. # The real file itself never leaves the private checkout. See # knowledge/README.md and CONTRIBUTING.md for the full accounting. # # SHIPPED, AND WHY EACH PIECE IS SAFE TO: # # face_designations trade abbreviations (N.F., F.F., T.I.F., ...) # printed on shop tickets everywhere. The real file's # own header already calls this branch public -- # identifies no client, job, or plant. # orientation.up_end a fact about precast assemblies IN GENERAL (which # Revit axis is "up" once an assembly's origin is # correctly configured), not one plant's naming # convention -- the owner's own ruling for keeping it # in the public layer rather than a plant file. # catalogue.rebar ASTM A706 / A615 grade tables -- a published # national standard, not a manufacturer's rating. # catalogue.safety_factors both null, by design -- see the note inline. # checklist.master the shop-ticket QC checklist's SKELETON: row ids, # names, grades, and which check function answers # each one. This tool's own built-in configuration, # not knowledge about any job -- identifies nobody. # # NOT SHIPPED: # # catalogue.inserts real lifting-insert capacities (ALP catalog, # 02/2024), cited to a page and a date. EMPTY here. # catalogue.slotted_inserts real JVI slotted-insert capacities. Omitted # entirely (nothing in this distribution's # tests needs its structure present at all). # connectors.products real sandwich-wall tie capacities. EMPTY here. # # A handful of tests read those omitted tables directly and assert the # owner's real published numbers. They are excluded from this # distribution's test run, by name, with that reason -- see # tools/make_dist.py's append_test_exclusions() and CONTRIBUTING.md. # ============================================================================ face_designations: frames: view: means: Relative to the viewing direction of the drawing. It flips when the view flips, so resolving one of these tokens requires knowing which way the elevation looks at the piece. sides: - near - far - both form: means: Relative to the casting bed -- how the piece lies while it is poured. Absolute for the piece; a flipped view does not change it. sides: - top - bottom - side - both vocabularies: near_far: frame: view measured_from: the direction the elevation looks at the piece tokens: - token: N.F. means: near face side: near - token: F.F. means: far face side: far - token: E.L. means: each layer side: both in_form: frame: form measured_from: the casting bed the piece is poured on tokens: - token: T.I.F. means: top in form side: top - token: B.I.F. means: bottom in form side: bottom - token: S.I.F. means: side in form side: side orientation: up_end: source: assembly_origin also_called: TOT stated_by: Will stated_on: '2026-08-30' means: Which end of a precast piece is up once it is erected is a property of the assembly's origin, which is placed with the assembly and carries an up end. It is not derived from where the piece happens to sit in the model, and it is not a producer's convention. origin_up: BasisY origin_up_as_stated: '"assembly origin 里面有一个朝上的头" -- the assembly origin itself carries an up end.' origin_up_verified: true origin_up_verified_by: the bridge holder, against 282 assemblies origin_up_verified_on: '2026-08-30' also_seen_as: horizontal_panels: stated_by: Will stated_on: '2026-08-30' status: confirmed against 282 assemblies -- see origin_up above green: axis: BasisY means: the erected up direction purple: axis: BasisZ means: top-in-form red: axis: BasisX means: the long direction note: The API exposes no colour at all; this three-arrow mapping is a reading of the owner's words (green / purple / red), and it is CONFIRMED because the measurement behind origin_up above -- BasisY exactly global (0,0,1) on 281 of 282 assemblies, BasisZ the smallest extent on 25 of 26 sampled, BasisX the longest on 23 of 26 -- is the same measurement that stands the colours up. vertical_wall_panels: stated_by: Will stated_on: '2026-09-01' status: ONE of three arrows confirmed. Do not treat this frame as complete and do not borrow purple or red from horizontal_panels above -- the owner's own words are that the arrows are different between the two frames to begin with, so nothing here may be assumed from there. green: axis: BasisY means: world up (world Z+) when the panel is correctly configured confirmed: true stated_as: '"vertical wall panel里面，世界的上方应该是绿色箭头" -- in a vertical wall panel, world up should be the green arrow.' purple: axis: null means: null confirmed: false open_question: Not yet stated. A vertical wall panel's casting orientation (top-in-form) is not necessarily on the same axis as a horizontal panel's -- do not infer BasisZ here. Asked of the owner 2026-09-01; record the answer here, cited and dated, the day it arrives. red: axis: null means: null confirmed: false open_question: Not yet stated. Do not infer BasisX (the horizontal frame's "long direction") here -- on a vertical wall panel BasisY already carries a different meaning (world up) from the horizontal frame's (erected up when stood on end), so nothing about red follows from the horizontal row either. Asked of the owner 2026-09-01; record the answer here, cited and dated, the day it arrives. applies_to: horizontal_panels up_tolerance: 0.99 near_square_ratio: 1.25 declines_because: A piece whose origin does not agree with its geometry, a vertical panel whose frame nobody has explained yet, and a near-square piece that could be either are three different reasons to have no answer. All three are answers; none of them is a default. wp401_2026_09_01: 'WP401 is NOT an instance of applies_to declining -- it never reaches that third check. Its measured basis_up is (0, 1, 0), so up_end_from_origin()''s FIRST refusal (the up basis must actually be world up, within up_tolerance) fires before up_axis or applies_to are ever read; the report''s fallback-to-global-elevation notice on WP401 is that first refusal, not the third. Under the green-arrow rule above (vertical_wall_panels), a correctly configured vertical wall panel''s BasisY IS world up -- so WP401''s (0, 1, 0) is a real defect on that assembly''s origin (TOT), not merely an unconfirmed frame; the report''s red line follows from this fact, not from applies_to. Consequence for the code, worked out and not acted on: widening applies_to to admit vertical_wall_panels would NOT change WP401''s verdict -- refusal #1 still fires first on it regardless. It WOULD change any piece whose origin genuinely has BasisY at world up AND whose up_axis is not ''width'': such a piece currently declines at refusal #3 (fallback to global elevation, disclosed) and would start being read off the origin instead (the ruled mechanism, undisclosed because it is no longer a fallback). No such piece has been surveyed. That survey, and the decision whether to widen applies_to on the strength of it, is the owner''s, not made here.' origin_point_meaning: null origin_point_unverified_because: Nobody has measured where Transform.Origin sits relative to the piece, and nobody has asked whether the owner's "up end" means the point or the direction. Until one of those happens the point is not read at all. catalogue: safety_factors: tension_fos: null shear_fos: null unknown_because: There is no trade-wide safety factor on a lifting insert to publish here. A factor belongs to the part that was tested, so it is written inside each `inserts:` entry against the page that publishes it. The 2.67 that used to sit here had no source and the manufacturer's own page gives 4:1 in shear for the parts it covers; see the block above. A part with no entry of its own is NOT judged on an ultimate rating -- it is named as unjudged, because inheriting one manufacturer's factor is exactly the failure this null exists to prevent. inserts: {} rebar: stock_length_ft: 40.0 astm_grades: A706: grades_ksi: - 60 - 80 default_fy_ksi: 60 default_declared_by: Will default_declared_on: '2026-08-30' note: Grade 60 is the default, not the definition -- A706 Grade 80 exists. A615: grades_ksi: - 60 - 80 - 100 default_fy_ksi: null note: the designation alone does not give a grade -- ask, do not assume. connectors: what_it_is: The part that crosses the insulation of a sandwich (insulated) wall panel and ties the two concrete wythes together. Declared by the owner 2026-08-31. products: {} checklist: master: - id: '1.1' name: Sheet name equals the piece mark grade: A owner_codes: - SHEET-NAME not_run_reason: null checks: check_sheet_name - id: '1.2' name: Sheet design-number reduces to the piece design grade: A owner_codes: - DSN-MATCH - DSN-SUFFIX - DSN-PREFIX not_run_reason: null checks: null - id: '1.3' name: Exactly one ticket set per piece grade: A owner_codes: - TICKET-SET not_run_reason: null checks: check_ticket_set - id: '1.4' name: Every placed view name refers to this design grade: B owner_codes: - VIEW-DSN not_run_reason: null checks: check_view_name_design - id: '1.5' name: Printed call-outs do not overlap each other grade: C owner_codes: - CALLOUT-OVERLAP not_run_reason: null checks: check_callout_overlap - id: '2.1' name: Printed length/width/depth vs modelled grade: B owner_codes: - SIZE-LENGTH - SIZE-WIDTH - SIZE-MAX- - SIZE-MIN- not_run_reason: null checks: null - id: '2.2' name: Weight three ways agree, and which one is odd is named grade: A owner_codes: - WGT- not_run_reason: null checks: check_weight_three_way - id: '2.3' name: Unit weight ticket vs design summary grade: A owner_codes: - PCF-NOTE - PCF-MODEL not_run_reason: null checks: null - id: '2.4' name: Cast extras (a ledge is its own family) counted in the weight grade: A owner_codes: - CAST-EXTRA not_run_reason: null checks: check_cast_extras - id: '3.1' name: f'c ticket vs summary grade: A owner_codes: - FC not_run_reason: null checks: null - id: '3.2' name: f'ci ticket vs summary grade: A owner_codes: - FCI not_run_reason: null checks: null - id: '3.3' name: f'ci/f'c release ratio in band grade: B owner_codes: - FCI-RATIO not_run_reason: null checks: check_release_ratio - id: '4.1' name: Printed strand count vs modelled grade: B owner_codes: - STR-QTY not_run_reason: null checks: null - id: '4.2' name: Strand diameter & grade vs design grade: A owner_codes: - STR-DIA - STR-DIA-EXTRA not_run_reason: null checks: null - id: '4.3' name: Jacking force on ticket vs design grade: A owner_codes: - JACK-FORCE not_run_reason: null checks: check_jacking_force - id: '4.4' name: Strand positions vs design chain from stated rail grade: B owner_codes: - STRAND-POS not_run_reason: null checks: check_strand_layout - id: '4.5' name: Debonded strands called out where the design debonds grade: C owner_codes: - STRAND-CALLOUT not_run_reason: null checks: check_debond_callout - id: '4.6' name: Row count & spacing plausible grade: A owner_codes: - STRAND-SPACING - STRAND-ROWS - STRAND-GRID - BED-WIDTH - BED-OFFSET not_run_reason: null checks: check_strand_layout - id: '4.7' name: Strand debonded wherever the concrete runs short grade: B owner_codes: - STRAND-DEBOND not_run_reason: null checks: check_strand_debond - id: '4.8' name: BOM strand row agrees with the section print and the model grade: A owner_codes: - BOM-STRAND not_run_reason: null checks: check_bom_strand_count - id: '5.1' name: BED PLAN callout embed exists in model grade: A owner_codes: - BOM-MEMBERS - DETAIL-CALLOUT not_run_reason: null checks: - check_bom_members - check_detail_callouts - id: '5.2' name: Embed in model appears on ticket grade: A owner_codes: - BED-REVERSE not_run_reason: null checks: check_bed_plan_reverse - id: '5.3' name: Face designations consistent with model side grade: C owner_codes: null not_run_reason: 'grade C: a person reads the face designations against the model side -- by design no check computes this row, so it is a prompt to look and never a verdict' checks: null - id: '5.4' name: Mesh / WWF designation vs design grade: A owner_codes: - WWF not_run_reason: null checks: check_wwf_designation - id: '5.5' name: Bar marks legible on the drawing grade: D owner_codes: null not_run_reason: 'grade D: a person reads the drawing; code only guarantees the question was asked' checks: null - id: '5.6' name: Bar marks unique, and model and print name the same bars grade: B owner_codes: - BARMARK-UNIQUE not_run_reason: null checks: check_bar_mark_uniqueness - id: '5.7' name: No bar longer than the stock it is cut from grade: B owner_codes: - BAR-LENGTH not_run_reason: null checks: check_bar_stock_length - id: '5.8' name: Connectors present on an insulated panel grade: B owner_codes: - CONNECTOR-EXIST not_run_reason: null checks: check_connectors_exist - id: '5.9' name: Enough connectors for what the design calls for grade: B owner_codes: - CONNECTOR-COUNT not_run_reason: null checks: check_connectors_sufficient - id: '5.10' name: Connector edge distances grade: B owner_codes: - CONNECTOR-EDGE not_run_reason: null checks: check_connector_edge_distance - id: '5.11' name: Every lifter's solid zone is a member of the assembly grade: B owner_codes: - SOLID-ZONE-ASM - SOLID-ZONE-ABSENT not_run_reason: null checks: check_solid_zone_members - id: '5.12' name: Solid zones appear on the ticket's insulation layout grade: B owner_codes: - SOLID-ZONE-TICKET not_run_reason: null checks: check_solid_zone_on_ticket - id: '5.13' name: Solid zone hatch matches the legend swatch grade: B owner_codes: - SOLID-ZONE-HATCH not_run_reason: null checks: check_solid_zone_hatch - id: '5.14' name: Insulation recess regions present where the design calls for them grade: C owner_codes: - RECESS-PRESENT not_run_reason: null checks: check_recess_regions - id: '5.15' name: Recess region hatch matches the legend swatch grade: B owner_codes: - RECESS-HATCH not_run_reason: null checks: check_recess_hatch - id: '6.1' name: Insert capacity vs load grade: A owner_codes: - LIFT-CAPACITY not_run_reason: null checks: check_lifter_capacity - id: '6.2' name: Insert edge distances grade: A owner_codes: - LIFT-EDGE not_run_reason: null checks: check_lifter_edge_distance - id: '6.3' name: Current handling result exists & passes grade: A owner_codes: - HANDLE- not_run_reason: null checks: check_handling_result - id: '6.4' name: Dunnage not under an opening grade: A owner_codes: - DUN-OPENING not_run_reason: null checks: check_dunnage_openings - id: '6.5' name: DUNNAGE / ERECTION / PICKING notes say something grade: B owner_codes: - NOTE-CONTENT not_run_reason: null checks: check_note_views - id: '6.6' name: Odd part count carries the BED PLAN note it requires grade: B owner_codes: - PARITY-NOTE not_run_reason: null checks: check_parity_note - id: '6.7' name: Minimum spacing between lifting anchors grade: A owner_codes: - LIFT-SPACING not_run_reason: null checks: check_lifter_anchor_spacing - id: '6.8' name: Printed picking stations match the modelled picking inserts grade: B owner_codes: - PICK-STATIONS - PICK-UNREADABLE not_run_reason: null checks: check_picking_match - id: '6.9' name: Lifting-point count vs panel length (MC) grade: A owner_codes: - LIFT-POINTS - LIFT-POINTS-UNREAD not_run_reason: null checks: check_lifting_points - id: '6.10' name: Lifting-point position vs PCI recommendation (MC) grade: A owner_codes: - LIFT-POS - LIFT-POS-UNREAD not_run_reason: null checks: check_lift_positions - id: '6.11' name: Dunnage-point count vs stripping-point count (MC) grade: A owner_codes: - DUN-STRIP - DUN-STRIP-UNREAD not_run_reason: null checks: check_dunnage_stripping_match - id: '7.1' name: Interference check grade: B owner_codes: - CLASH - CLASH-UNREADABLE not_run_reason: null checks: check_member_interference - id: '8.1' name: No unresolved design-summary lines grade: C owner_codes: - SPEC-UNRESOLVED not_run_reason: null checks: check_spec_unresolved - id: '8.2' name: No invisible characters in ticket text grade: A owner_codes: - INVISIBLE not_run_reason: null checks: check_invisible