@structupath/pi-steel 0.1.0

package/skills/steel-takeoff/assets/bom-template.csv

@@ -0,0 +1 @@
+Mark,Qty,Size,Grade,Length_ft,Unit_Wt_plf,Total_Wt_lbs,Connections,Notes

package/skills/steel-takeoff/assets/material-grades.json

@@ -0,0 +1,153 @@
+[
+  {
+    "grade": "A992",
+    "description": "Standard specification for structural steel shapes",
+    "typical_use": "W-shapes (wide flange beams and columns)",
+    "Fy_ksi": 50,
+    "Fu_ksi": 65,
+    "Fy_Fu_ratio_max": 0.85,
+    "elongation_pct": 18,
+    "weldability": "Excellent — no preheat typically required",
+    "notes": "Default grade for all W-shapes. Replaced A36 as standard."
+  },
+  {
+    "grade": "A500 Gr. B",
+    "description": "Cold-formed welded/seamless structural tubing — round",
+    "typical_use": "HSS round shapes, round pipe columns",
+    "Fy_ksi": 42,
+    "Fu_ksi": 58,
+    "elongation_pct": 23,
+    "weldability": "Good — may need preheat for thick walls",
+    "notes": "Standard grade for round HSS. Check wall thickness for weld requirements."
+  },
+  {
+    "grade": "A500 Gr. C",
+    "description": "Cold-formed welded/seamless structural tubing — rectangular",
+    "typical_use": "HSS rectangular/square shapes, HSS columns and bracing",
+    "Fy_ksi": 50,
+    "Fu_ksi": 62,
+    "elongation_pct": 21,
+    "weldability": "Good — may need preheat for thick walls (≥1/2\")",
+    "notes": "Standard grade for rectangular/square HSS. Higher Fy than Gr. B."
+  },
+  {
+    "grade": "A36",
+    "description": "Carbon structural steel",
+    "typical_use": "Angles, channels, plates, miscellaneous shapes",
+    "Fy_ksi": 36,
+    "Fu_ksi": 58,
+    "elongation_pct": 20,
+    "weldability": "Excellent — easiest steel to weld",
+    "notes": "Legacy standard. Still used for angles, channels, and plates. Dual-certified with A992 for many W-shapes."
+  },
+  {
+    "grade": "A572 Gr. 50",
+    "description": "High-strength low-alloy structural steel",
+    "typical_use": "Plates, built-up sections, heavy columns",
+    "Fy_ksi": 50,
+    "Fu_ksi": 65,
+    "elongation_pct": 18,
+    "weldability": "Good — preheat may be required for thick plates",
+    "notes": "Used for plates and built-up members. Same Fy as A992."
+  },
+  {
+    "grade": "A572 Gr. 42",
+    "description": "High-strength low-alloy structural steel — Grade 42",
+    "typical_use": "Lighter plates, structural shapes",
+    "Fy_ksi": 42,
+    "Fu_ksi": 60,
+    "elongation_pct": 20,
+    "weldability": "Good",
+    "notes": "Less common than Gr. 50. Check availability."
+  },
+  {
+    "grade": "A913 Gr. 50",
+    "description": "HSLA quenched and self-tempered shapes",
+    "typical_use": "Jumbo W-shapes (Group 4 and 5), heavy columns",
+    "Fy_ksi": 50,
+    "Fu_ksi": 65,
+    "elongation_pct": 21,
+    "weldability": "Excellent — superior to A992 for thick sections, no preheat needed",
+    "notes": "Premium grade for heavy sections. Better CVN toughness. Typically 5-10% cost premium."
+  },
+  {
+    "grade": "A913 Gr. 65",
+    "description": "HSLA quenched and self-tempered shapes — Grade 65",
+    "typical_use": "Heavy columns, high-rise applications",
+    "Fy_ksi": 65,
+    "Fu_ksi": 80,
+    "elongation_pct": 17,
+    "weldability": "Good — follow AWS D1.1 for thick sections",
+    "notes": "High-strength grade for reducing column sizes. Verify availability and lead time."
+  },
+  {
+    "grade": "A514",
+    "description": "High-yield-strength quenched and tempered alloy steel plates",
+    "typical_use": "Base plates, heavy gusset plates, built-up columns",
+    "Fy_ksi": 100,
+    "Fu_ksi": 115,
+    "elongation_pct": 16,
+    "weldability": "Requires special procedures — preheat, low-hydrogen electrodes, controlled heat input",
+    "notes": "Very high strength but difficult to weld. Use only when specified by engineer."
+  },
+  {
+    "grade": "A588 / A242",
+    "description": "Weathering steel — atmospheric corrosion resistant",
+    "typical_use": "Exposed structural steel, bridges, exterior applications",
+    "Fy_ksi": 50,
+    "Fu_ksi": 70,
+    "elongation_pct": 18,
+    "weldability": "Good — use matching weathering filler metals",
+    "notes": "Forms protective patina, no painting required. Not suitable for submerged or constantly wet conditions. Also known as COR-TEN."
+  },
+  {
+    "grade": "A53 Gr. B",
+    "description": "Pipe — welded and seamless",
+    "typical_use": "Standard weight, extra-strong, and double extra-strong pipe",
+    "Fy_ksi": 35,
+    "Fu_ksi": 60,
+    "elongation_pct": 22,
+    "weldability": "Excellent",
+    "notes": "Standard pipe grade. Available in STD, XS (extra strong), and XXS (double extra strong) wall thicknesses."
+  },
+  {
+    "grade": "A325",
+    "description": "High-strength bolts for structural joints",
+    "typical_use": "Standard structural bolts — 3/4\", 7/8\", 1\" diameter",
+    "Fy_ksi": 92,
+    "Fu_ksi": 120,
+    "elongation_pct": 14,
+    "weldability": "N/A — bolts not welded",
+    "notes": "Most common structural bolt. Superseded by ASTM F3125 Gr. A325 but still commonly referenced. Available as bearing (N/X) or slip-critical (SC)."
+  },
+  {
+    "grade": "A490",
+    "description": "High-strength bolts — heat treated",
+    "typical_use": "Heavy connections, moment frames, high-load joints",
+    "Fy_ksi": 130,
+    "Fu_ksi": 150,
+    "elongation_pct": 14,
+    "weldability": "N/A — bolts not welded, never galvanized",
+    "notes": "Higher capacity than A325. Cannot be galvanized. Superseded by ASTM F3125 Gr. A490."
+  },
+  {
+    "grade": "F1852",
+    "description": "Twist-off type tension control bolt (TC bolt) — A325 equivalent",
+    "typical_use": "Field connections — easier installation verification than A325",
+    "Fy_ksi": 92,
+    "Fu_ksi": 120,
+    "elongation_pct": 14,
+    "weldability": "N/A",
+    "notes": "TC bolts have a splined end that shears off at proper pretension. Same capacity as A325. Commonly used for slip-critical connections."
+  },
+  {
+    "grade": "E70XX",
+    "description": "Weld electrode/filler metal — 70 ksi tensile",
+    "typical_use": "Fillet welds, CJP welds, PJP welds on A36/A992/A572 steel",
+    "Fy_ksi": 58,
+    "Fu_ksi": 70,
+    "elongation_pct": 22,
+    "weldability": "N/A — this IS the filler metal",
+    "notes": "Standard electrode classification. FEXX = 70 ksi. Matches A992 and lower steels. Common designations: E7018 (SMAW), ER70S-6 (GMAW), E71T-1 (FCAW)."
+  }
+]

package/skills/steel-takeoff/references/aisc-shapes-guide.md

@@ -0,0 +1,96 @@
+# AISC Shapes Guide — 16th Edition
+
+## Shape Families
+
+### W-Shapes (Wide Flange)
+- **Designation**: WdXw (e.g., W14X30 = 14" nominal depth, 30 plf)
+- **Grade**: A992 (Fy=50 ksi) — default for all W-shapes
+- **Range**: W4X13 to W44X335 (standard) up to W14X730 (jumbo column)
+- **Use**: Beams, columns, girders — the workhorse of structural steel
+- **Key Properties**: d, bf, tf, tw, A, Ix, Sx, Iy, Sy, Zx, Zy, ry
+
+**Common Beam Sizes**: W8, W10, W12, W14, W16, W18, W21, W24, W27, W30, W33, W36
+**Common Column Sizes**: W10, W12, W14 (wide flange series with bf ≈ d)
+
+### S-Shapes (American Standard)
+- **Designation**: SdXw (e.g., S12X35)
+- **Grade**: A36 (Fy=36 ksi)
+- **Note**: Rarely specified in new construction. Replaced by W-shapes.
+
+### HP-Shapes (Bearing Piles)
+- **Designation**: HPdXw (e.g., HP14X73)
+- **Grade**: A572 Gr. 50 or A36
+- **Use**: Driven piles, foundation support
+- **Key Feature**: Approximately equal flange width and depth (bf ≈ d)
+
+### C-Shapes (American Standard Channels)
+- **Designation**: CdXw (e.g., C10X20)
+- **Grade**: A36 (Fy=36 ksi)
+- **Use**: Struts, framing, edge members, stair stringers
+- **Key Properties**: Shear center is NOT at the centroid — beware of lateral-torsional effects
+
+### MC-Shapes (Miscellaneous Channels)
+- **Designation**: MCdXw (e.g., MC8X22.8)
+- **Grade**: A36
+- **Use**: Similar to C-shapes but non-standard proportions
+
+### L-Shapes (Angles)
+- **Designation**: LaxbXt (e.g., L4X4X3/8)
+  - Equal leg: L4X4X3/8 (4" x 4" x 3/8" thick)
+  - Unequal leg: L6X4X1/2 (6" x 4" x 1/2" thick)
+- **Grade**: A36 (Fy=36 ksi)
+- **Use**: Bracing, struts, lintels, clip angles, connections
+- **Key Feature**: Properties about geometric axes AND principal axes differ
+
+### WT-Shapes (Structural Tees)
+- **Designation**: WTdXw (e.g., WT7X15)
+- **Grade**: A992 (same as parent W-shape)
+- **Note**: Cut from W-shapes — WT7X15 is half of W14X30
+
+### HSS — Rectangular / Square
+- **Designation**: HSSaxbXt (e.g., HSS8X6X1/2 = 8" x 6" x 1/2" wall)
+- **Grade**: A500 Gr. C (Fy=50 ksi) for rectangular/square
+- **Use**: Columns, bracing, truss members, exposed applications
+- **Key Feature**: Excellent for compression (no weak axis). Clean appearance.
+- **Wall thickness**: Nominal vs. design — design thickness = 0.93 × nominal
+
+### HSS — Round
+- **Designation**: HSSd.dXt (e.g., HSS6.625X0.280)
+- **Grade**: A500 Gr. C (Fy=42 ksi for round)
+- **Use**: Columns, bracing, handrails, pipe bollards
+- **Note**: Round HSS Fy is LOWER than rectangular HSS
+
+### Pipe
+- **Designation**: PIPEdXtype (e.g., PIPE6STD, PIPE6XS, PIPE6XXS)
+  - STD = Standard wall
+  - XS = Extra Strong
+  - XXS = Double Extra Strong
+- **Grade**: A53 Gr. B (Fy=35 ksi)
+- **Use**: Columns, bollards, handrails, process structures
+
+## Property Definitions
+
+| Symbol | Property | Units | What It Means |
+|--------|----------|-------|---------------|
+| d | Depth | in | Overall depth of section |
+| bf | Flange width | in | Width of flange (W, C shapes) |
+| tf | Flange thickness | in | Thickness of flange |
+| tw | Web thickness | in | Thickness of web |
+| A | Area | in² | Cross-sectional area — used for axial capacity |
+| Ix | Moment of inertia (x) | in⁴ | Stiffness about strong axis — controls deflection |
+| Sx | Section modulus (x) | in³ | Bending capacity about strong axis |
+| Iy | Moment of inertia (y) | in⁴ | Stiffness about weak axis |
+| Sy | Section modulus (y) | in³ | Bending capacity about weak axis |
+| Zx | Plastic section modulus (x) | in³ | Full plastic bending capacity (strong axis) |
+| Zy | Plastic section modulus (y) | in³ | Full plastic bending capacity (weak axis) |
+| rx | Radius of gyration (x) | in | Column buckling parameter (strong axis) |
+| ry | Radius of gyration (y) | in | Column buckling parameter (weak axis) — controls column capacity |
+| J | Torsional constant | in⁴ | Resistance to twisting |
+| Cw | Warping constant | in⁶ | Warping resistance |
+
+## Selection Tips for Takeoff
+
+1. **Beams**: Higher Ix = less deflection. Sx controls bending strength. Deeper beams are more efficient but check clearances.
+2. **Columns**: ry controls capacity (weak axis buckles first). W14 column series (W14X48 to W14X730) have bf ≈ d for balanced buckling.
+3. **Bracing**: HSS members are excellent — high r values in both directions. Angles are cheaper but less efficient.
+4. **Weight**: Always verify unit weight from database. Never estimate — the difference between W14X30 (30 plf) and W14X34 (34 plf) is 13% more steel.

package/skills/steel-takeoff/references/connection-types.md

@@ -0,0 +1,124 @@
+# Steel Connection Types — Reference for Takeoff
+
+## Simple (Shear) Connections
+
+### Single Plate (Shear Tab)
+- **Use**: Most common beam-to-beam and beam-to-column
+- **Hardware**: 1 plate shop-welded to support, field-bolted to beam web
+- **Typical bolts**: (3) to (5) 3/4" A325-N
+- **Est. weight**: 8-15 lbs per connection
+- **Takeoff note**: Count plates, bolts, and erection bolts
+
+### Double Angle (Clip Angle)
+- **Use**: Beam-to-girder, beam-to-column
+- **Hardware**: 2 angles, either shop-bolted or shop-welded to support
+- **Typical bolts**: (3) to (6) 3/4" A325-N per side
+- **Est. weight**: 10-25 lbs per connection
+- **Takeoff note**: Count pairs of angles
+
+### Single Angle
+- **Use**: Light beams, infill framing
+- **Hardware**: 1 angle, bolted or welded
+- **Typical bolts**: (2) to (3) 3/4" A325-N
+- **Est. weight**: 4-10 lbs per connection
+
+### Seated Connection (Unstiffened/Stiffened)
+- **Use**: When web connection is impractical
+- **Hardware**: Seat angle or bracket below beam, top clip angle
+- **Est. weight**: 15-35 lbs per connection
+
+## Moment Connections
+
+### Directly Welded Flange
+- **Use**: Moment frames (pre-Northridge NOT recommended)
+- **Hardware**: CJP welds at flanges, shear tab at web
+- **Est. weight**: 25-50 lbs per connection (plates + welding material)
+- **Takeoff note**: Flag for special inspection requirements
+
+### Bolted Flange Plate (BFP)
+- **Use**: Moment frames per AISC 358
+- **Hardware**: Top and bottom flange plates, bolted to beam flanges
+- **Typical bolts**: (6) to (12) 7/8" or 1" A325 or A490
+- **Est. weight**: 40-80 lbs per connection
+- **Takeoff note**: Plates are shop-welded to column, field-bolted to beam
+
+### Extended End Plate
+- **Use**: Moment frames, rigid connections
+- **Hardware**: End plate welded to beam, bolted to column flange
+- **Typical bolts**: (4) to (8) 1" A490
+- **Est. weight**: 30-60 lbs per connection
+
+### Reduced Beam Section (RBS / "Dogbone")
+- **Use**: Special moment frames (SMF) in seismic zones
+- **Hardware**: Trimmed beam flanges + moment connection
+- **Est. weight**: 30-50 lbs per connection + flange trimming labor
+- **Takeoff note**: Requires CJP weld special inspection
+
+## Bracing Connections
+
+### Gusset Plate
+- **Use**: Brace-to-beam/column intersection
+- **Hardware**: Steel plate, bolted or welded to brace and frame
+- **Size range**: 1/4" to 1" thick, varies widely by load
+- **Est. weight**: 20-150 lbs per connection (highly variable)
+- **Takeoff note**: Gusset plate weight can be significant — get sizes from details
+
+### Brace Clip
+- **Use**: Light bracing, kicker bracing
+- **Hardware**: Small plate or angle, bolted/welded
+- **Est. weight**: 5-15 lbs per connection
+
+## Base Plates
+
+### Standard Base Plate
+- **Use**: Column to foundation connection
+- **Hardware**: Base plate + anchor bolts + leveling nuts + grout
+- **Typical**: 4 anchor bolts for gravity columns, 4-8 for moment frames
+- **Plate thickness**: 3/4" to 2" typically
+- **Est. weight**: 25-200 lbs per base plate (varies with column load)
+- **Takeoff note**: Include anchor bolts in steel or concrete scope (verify)
+
+### Moment Base Plate
+- **Use**: Fixed-base columns, cantilevered columns
+- **Hardware**: Heavy base plate + 4-8 anchor bolts + stiffeners
+- **Est. weight**: 75-400 lbs per base plate
+- **Takeoff note**: Much heavier than standard — get plate sizes from details
+
+## Connection Hardware Weight Rules of Thumb
+
+| Building Type | Connection % of Member Weight |
+|---|---|
+| Simple warehouse / single-story | 8-10% |
+| Standard commercial (2-5 stories) | 10-12% |
+| Moment frame / complex framing | 12-18% |
+| Heavy industrial / power plant | 15-20% |
+| Seismic (SMF/SCBF) | 15-22% |
+
+## Bolt Weight Reference
+
+| Bolt Diameter | Weight per Bolt (incl. nut + washer) |
+|---|---|
+| 1/2" A307 | 0.10 lb |
+| 5/8" A325 | 0.20 lb |
+| 3/4" A325 | 0.34 lb |
+| 7/8" A325 | 0.56 lb |
+| 1" A325 | 0.80 lb |
+| 1-1/8" A325 | 1.15 lb |
+| 1-1/4" A325 | 1.50 lb |
+
+## Shear Stud Weight Reference
+
+| Stud Size | Weight Each |
+|---|---|
+| 3/4" x 3" | 0.14 lb |
+| 3/4" x 4-1/2" | 0.20 lb |
+| 7/8" x 3-1/2" | 0.22 lb |
+
+## Anchor Bolt Weight Reference
+
+| Bolt Size | Weight per Foot (rod) | Typical Length | Weight Each (w/ nut+washer) |
+|---|---|---|---|
+| 3/4" F1554 | 1.50 lb/ft | 18"-24" | 3-4 lb |
+| 1" F1554 | 2.67 lb/ft | 24"-36" | 7-10 lb |
+| 1-1/4" F1554 | 4.17 lb/ft | 30"-48" | 12-20 lb |
+| 1-1/2" F1554 | 6.01 lb/ft | 36"-60" | 20-35 lb |

package/skills/steel-takeoff/references/takeoff-procedures.md

@@ -0,0 +1,163 @@
+# Steel Takeoff Procedures — Detailed Guide
+
+## Overview
+
+A steel takeoff quantifies every piece of structural steel on a project to determine total tonnage for bidding. Accuracy directly impacts profit margin — a 5% error on a 200-ton job is 10 tons ($32,000+ at current rates).
+
+## Takeoff Order (recommended)
+
+1. **Columns** — Start at foundations, work up
+2. **Girders** — Primary spanning members (grid-to-grid)
+3. **Beams** — Secondary members (between girders)
+4. **Bracing** — Vertical and horizontal
+5. **Joists & Joist Girders** — If in scope (often separate trade)
+6. **Miscellaneous Steel** — Lintels, embeds, loose angles, stair framing
+7. **Connections** — Percentage allowance based on complexity
+
+## Step-by-Step Procedure
+
+### 1. Gather Documents
+- Structural plans (S sheets)
+- Structural details (SD sheets)
+- General notes and specifications
+- Architectural drawings (for clearances, finishes)
+- Addenda and bulletins
+- Geotechnical report (for pile/foundation type)
+
+### 2. Read General Notes FIRST
+General notes override everything. Look for:
+- Steel grade specifications (may differ from standard)
+- Coating/painting requirements
+- Fireproofing requirements (affects schedule, not weight)
+- Special inspection requirements (affects cost)
+- Fabrication standards (AISC certification level)
+- Erection procedures or sequences
+- Design loads (helps verify member sizes)
+
+### 3. Mark Up the Drawings
+Use colored pencils/markers on prints (or layers in PDF):
+- **Red** — Columns
+- **Blue** — Beams/Girders
+- **Green** — Bracing
+- **Orange** — Misc steel
+- **Yellow highlight** — Items already counted
+
+### 4. Column Takeoff
+
+For each column mark:
+```
+Mark | Qty | Size | Grade | Length (TOS to TOS) | Splice? | Base Plate
+C1   | 8   | W14X48 | A992 | 14'-6" (FTG to 2nd) | No | 18"x18"x1"
+C1a  | 8   | W14X48 | A992 | 14'-0" (2nd to Roof) | Yes | N/A
+```
+
+**Length rules:**
+- Foundation to first floor: Top of base plate to TOS
+- Floor to floor: TOS to TOS (top of steel)
+- Top column: TOS to TOS at roof
+
+**Watch for:**
+- Column splices (add splice plate weight)
+- Cap plates at top
+- Stepped columns (different sizes at different levels)
+- Cantilevered columns (verify fixed vs. pinned base)
+
+### 5. Beam/Girder Takeoff
+
+```
+Mark | Qty | Size | Grade | Length | Camber | Studs | Connections
+B1   | 12  | W16X26 | A992 | 28'-6" | None | (24) 3/4"x4-1/2" | 2x shear tab
+G1   | 6   | W24X76 | A992 | 36'-0" | 3/4" | (56) 3/4"x4-1/2" | 2x moment
+```
+
+**Length determination:**
+- Grid line to grid line MINUS column setbacks
+- Add for overhang/cantilever past column face
+- If not dimensioned, scale from drawings (note as "SCALED")
+
+**Watch for:**
+- Camber requirements (affects fabrication cost)
+- Composite design (shear studs — count them)
+- Coped beams (note "COPE TOP" or "COPE BOT")
+- Moment vs. shear connections (different hardware)
+- Typical bays — count ALL typical bays, don't assume
+
+### 6. Bracing Takeoff
+
+```
+Mark | Qty | Size | Grade | Length | Connection
+BR1  | 8   | HSS6X6X3/8 | A500C | 18'-9" (diag) | Gusset both ends
+BR2  | 4   | L4X4X3/8 | A36 | 12'-4" (diag) | Clip angle
+```
+
+**Length:** Use diagonal length, not horizontal projection:
+```
+Diagonal = √(horizontal² + vertical²)
+Example: 24'-0" horizontal, 14'-0" vertical
+Diagonal = √(24² + 14²) = √(576 + 196) = √772 = 27.78' → 27'-9"
+```
+
+### 7. Miscellaneous Steel
+
+These items are easy to miss but add up:
+- **Lintels** — Over CMU openings (angles, typically L4X4, L5X3-1/2)
+- **Embed plates** — In concrete for attachments
+- **Loose angles** — Shelf angles, relief angles, ledger angles
+- **Kicker angles** — Diagonal braces for masonry/curtain wall support
+- **Sag rods** — Between purlins
+- **Stair framing** — Stringers (C10, C12), landing beams, toe plates
+- **Handrail posts** — Pipe or HSS posts
+- **Safety cable anchors** — Roof perimeter life safety
+
+### 8. Verify Completeness
+
+Checklist:
+- [ ] All grid intersections have a column
+- [ ] Every bay has beams spanning both directions
+- [ ] Bracing is shown at required locations (check all elevations)
+- [ ] Stair/elevator framing accounted for
+- [ ] Opening framing (headers, trimmers) included
+- [ ] Roof framing matches roof plan
+- [ ] Mezzanine/platform framing included
+- [ ] Equipment support steel included
+- [ ] Canopy/awning framing included
+
+## Common Takeoff Errors
+
+| Error | Impact | How to Avoid |
+|---|---|---|
+| Missed symmetry | Under by 50% | Check "SIM OPP HAND" notes |
+| Wrong bay count | Under/over 10-20% | Count every bay, mark on plan |
+| Forgot elevation change | Wrong lengths | Cross-ref plans with sections |
+| Didn't count connections | Under 10-15% | Always add connection allowance |
+| Scaled instead of calculated | ±5-10% error | Calculate from grid dimensions |
+| Missed addendum | Variable | Always read ALL addenda |
+| Wrong grade assumed | Cost impact | Read general notes for grade specs |
+| Forgot misc steel | Under 3-8% | Use the misc steel checklist above |
+
+## Output Format
+
+Final takeoff should be organized by:
+
+### Level 1: By Drawing Sheet
+```
+Sheet S-101: Foundation Plan
+  C1 - 8ea W14X48 @ 14'-6" = 5,568 lbs
+  ...
+Sheet subtotal: XX,XXX lbs
+```
+
+### Level 2: By Category
+```
+Columns:    XX,XXX lbs (XX.X tons)
+Beams:      XX,XXX lbs (XX.X tons)
+Girders:    XX,XXX lbs (XX.X tons)
+Bracing:    XX,XXX lbs (XX.X tons)
+Misc:       XX,XXX lbs (XX.X tons)
+Connection: XX,XXX lbs (XX.X tons) — X% allowance
+```
+
+### Level 3: Grand Total
+```
+TOTAL: XXX,XXX lbs = XX.X tons
+```

package/skills/steel-takeoff/scripts/calculate-weight.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════════════
+# Steel Weight Calculator
+# Usage: ./scripts/calculate-weight.sh path/to/bom.csv [connection_pct] [misc_pct]
+#
+# BOM CSV format:
+#   Mark,Qty,Size,Grade,Length_ft,Unit_Wt_plf,Total_Wt_lbs,Connections,Notes
+#
+# Optional arguments:
+#   connection_pct  - Connection allowance percentage (default: 12)
+#   misc_pct        - Misc steel allowance percentage (default: 5)
+#
+# Output: Line-by-line breakdown + totals with cost estimate
+# ═══════════════════════════════════════════════════════════════════
+set -euo pipefail
+
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <bom.csv> [connection_pct] [misc_pct]"
+    echo ""
+    echo "  bom.csv         CSV file with columns: Mark,Qty,Size,Grade,Length_ft,Unit_Wt_plf,..."
+    echo "  connection_pct  Connection hardware allowance (default: 12%)"
+    echo "  misc_pct        Misc steel allowance (default: 5%)"
+    echo ""
+    echo "Example:"
+    echo "  $0 takeoff.csv 15 5"
+    exit 1
+fi
+
+BOM_FILE="$1"
+CONN_PCT="${2:-12}"
+MISC_PCT="${3:-5}"
+
+if [ ! -f "$BOM_FILE" ]; then
+    echo "ERROR: File not found: $BOM_FILE"
+    exit 1
+fi
+
+python3 - "$BOM_FILE" "$CONN_PCT" "$MISC_PCT" <<'PYTHON'
+import csv
+import sys
+import os
+
+bom_file = sys.argv[1]
+conn_pct = float(sys.argv[2]) / 100.0
+misc_pct = float(sys.argv[3]) / 100.0
+
+print(f"\n{'='*78}")
+print(f"  STEEL TAKEOFF — WEIGHT CALCULATION")
+print(f"  File: {os.path.basename(bom_file)}")
+print(f"{'='*78}\n")
+
+# Header
+print(f"  {'Mark':<8} {'Qty':>4} x {'Size':<14} x {'Length':>9} @ {'Wt/ft':>8} = {'Total':>12}  {'Grade':<8}")
+print(f"  {'-'*8} {'-'*4}   {'-'*14}   {'-'*9}   {'-'*8}   {'-'*12}  {'-'*8}")
+
+total_lbs = 0
+total_pieces = 0
+categories = {}
+grade_totals = {}
+line_count = 0
+
+with open(bom_file) as f:
+    reader = csv.DictReader(f)
+    for row in reader:
+        mark = row.get("Mark", "").strip()
+        if not mark or mark.startswith("#"):
+            continue
+
+        qty = int(row.get("Qty", 0))
+        size = row.get("Size", "?").strip()
+        grade = row.get("Grade", "A992").strip()
+        length_str = row.get("Length_ft", "0").strip()
+        unit_wt_str = row.get("Unit_Wt_plf", "0").strip()
+
+        # Parse length — support both decimal (28.5) and feet-inches (28'-6")
+        if "'" in length_str:
+            parts = length_str.replace('"', '').split("'")
+            feet = float(parts[0].replace('-', '').strip())
+            inches = float(parts[1].replace('-', '').strip()) if len(parts) > 1 and parts[1].strip() else 0
+            length = feet + inches / 12.0
+        else:
+            length = float(length_str) if length_str else 0
+
+        unit_wt = float(unit_wt_str) if unit_wt_str else 0
+
+        line_wt = qty * length * unit_wt
+        total_lbs += line_wt
+        total_pieces += qty
+        line_count += 1
+
+        # Categorize by prefix
+        if size.startswith("W"):
+            cat = "W-Shapes"
+        elif size.startswith("HSS"):
+            cat = "HSS"
+        elif size.startswith("L"):
+            cat = "Angles"
+        elif size.startswith("C") or size.startswith("MC"):
+            cat = "Channels"
+        elif size.startswith("PIPE"):
+            cat = "Pipe"
+        elif size.startswith("PL") or size.startswith("PLATE"):
+            cat = "Plates"
+        else:
+            cat = "Other"
+
+        categories[cat] = categories.get(cat, 0) + line_wt
+        grade_totals[grade] = grade_totals.get(grade, 0) + line_wt
+
+        print(f"  {mark:<8} {qty:>4} x {size:<14} x {length:>7.1f} ft @ {unit_wt:>6.1f} plf = {line_wt:>10,.0f} lb  {grade:<8}")
+
+# Connection & misc allowances
+conn_wt = total_lbs * conn_pct
+misc_wt = total_lbs * misc_pct
+grand_total = total_lbs + conn_wt + misc_wt
+
+print(f"\n  {'='*78}")
+print(f"\n  CATEGORY BREAKDOWN:")
+for cat in sorted(categories.keys()):
+    wt = categories[cat]
+    pct = (wt / total_lbs * 100) if total_lbs > 0 else 0
+    print(f"    {cat:<20} {wt:>12,.0f} lb  ({pct:>5.1f}%)")
+
+print(f"\n  GRADE BREAKDOWN:")
+for grade in sorted(grade_totals.keys()):
+    wt = grade_totals[grade]
+    pct = (wt / total_lbs * 100) if total_lbs > 0 else 0
+    print(f"    {grade:<20} {wt:>12,.0f} lb  ({pct:>5.1f}%)")
+
+print(f"\n  {'─'*60}")
+print(f"  {'Members:':<30} {line_count:>8} marks")
+print(f"  {'Total Pieces:':<30} {total_pieces:>8} pcs")
+print(f"  {'Member Weight:':<30} {total_lbs:>12,.0f} lb  ({total_lbs/2000:>8,.1f} tons)")
+print(f"  {'Connection Allow ({:.0f}%):':<30} {conn_wt:>12,.0f} lb  ({conn_wt/2000:>8,.1f} tons)".format(conn_pct*100))
+print(f"  {'Misc Steel Allow ({:.0f}%):':<30} {misc_wt:>12,.0f} lb  ({misc_wt/2000:>8,.1f} tons)".format(misc_pct*100))
+print(f"  {'─'*60}")
+print(f"  {'GRAND TOTAL:':<30} {grand_total:>12,.0f} lb  ({grand_total/2000:>8,.1f} tons)")
+print(f"  {'─'*60}")
+
+# Cost estimates at various $/ton rates
+print(f"\n  COST ESTIMATES:")
+tons = grand_total / 2000
+for rate in [2800, 3200, 3600, 4000]:
+    cost = tons * rate
+    print(f"    @ ${rate:,}/ton:  ${cost:>14,.0f}")
+
+print(f"\n{'='*78}\n")
+PYTHON