@floless/app 0.53.0 → 0.54.1

package/dist/skills/floless-app-steel-model/SKILL.md

@@ -2,7 +2,7 @@
 name: floless-app-steel-model
 description: The front-door guide for turning a structural steel drawing SET into an editable model in floless.app — the "Steel Model" flow. This skill orchestrates the whole pipeline — set up a project folder, learn the set into plain-English knowledge files, provision the right AWARE agents (region-specific steel detailer plus any bake targets), confirm which sheets are plans / elevations / details, then hand off to the Steel Takeoff reader to read each plan into a steel.takeoff/v1 contract — with explicit confirm gates between stages. Use it when a user wants to model steel from a drawing SET or asks things like "model this steel job from the drawings", "take off this whole set", "start a steel takeoff project", "turn these structural drawings into a model", "I have a PDF set of framing plans", or "/floless-app-steel-model". It is re-runnable — resume at any stage. For a single already-isolated framing plan the Steel Takeoff reader (floless-app-steel-takeoff) can be used directly; this guide is for driving a real job end to end.
 metadata:
-  version: 0.1.0
+  version: 0.2.0
 ---
 
 # Steel Model — guide a steel drawing set into an editable model
@@ -26,13 +26,16 @@ the run path and no API key.
 what was found and get an OK before spending effort on the next stage. Resume at any stage on
 re-invoke ("we already set up the folder, provision the agents").
 
-> Companion skills (both ship with floless.app — invoke them, don't duplicate them):
+> Companion skills (all ship with floless.app — invoke them, don't duplicate them):
 > - **`reading-structural-drawings`** — the reading *discipline* (massing + coordinate frame FIRST,
 >   members LAST, cross-validate every view). Follow it whenever skimming or classifying the set
 >   (stages 2 and 5) — it stops the classic failures (two buildings read as one, a sloped roof read
 >   as flat, grids conflated across sheets).
 > - **`floless-app-steel-takeoff`** — reads one framing plan into the contract (the heavy vision
 >   pipeline, the filter pre-stage, the AISC/EN/BS lookup, the contract write + editor hand-off).
+> - **`steel-drawing-abbreviations`** — the default US/AISC abbreviations + shape-designation legend.
+>   The fallback for note/profile codes (TYP, TOS, UON, `(E)`/`(N)`, HSS, WT) when the set omits its
+>   own abbreviations sheet (stage 2).
 
 ---
 
@@ -66,7 +69,9 @@ the project folder (a few files, **not** a framework):
 
 Read the set with the terminal AI's own vision, following the **`reading-structural-drawings`**
 discipline while skimming (massing + coordinate frame first — it's what makes the sheet
-classification reliable).
+classification reliable). If the set has **no abbreviations/legend sheet** (a partial set is common),
+fall back to **`steel-drawing-abbreviations`** — the standard US/AISC abbreviations + shape legend —
+for note/profile codes (TYP, TOS, UON, `(E)`/`(N)`, HSS, WT). The project's own legend always overrides.
 
 **Gate:** show `set-index.md` (the sheet map) and confirm the classification looks right — the user
 knows their set better than any read.
@@ -133,12 +138,16 @@ the user at the editor:
   the contract's `connections[]` with `source:"company-rules"`; the user reviews/assigns them per
   member end in the editor's **Connections** panel (the per-end picker + confidence card).
 - **Point at the rest of the canvas:** the **filter** view (refine the kept linework), **Approve**
-  (bake the lock — the determinism gate), **3D** model, **IFC** / **Tekla** export, the **BOM**, the
-  **confidence report**, and the **callout bubbles** (click a section/elevation/detail mark on a
-  plan to jump to the referenced sheet).
+  (bake the lock — the determinism gate), **3D** model, **IFC** / **Tekla** export, the **BOM**
+  (exportable to **CSV / Excel**), the **confidence report**, and the **callout bubbles** (click a
+  section/elevation/detail mark on a plan to jump to the referenced sheet).
 
 **Done** when each framing plan has an approved, editor-reviewed contract and the user knows which
-on-canvas tool does what. The exports (3D/IFC/Tekla/BOM) are on-demand from the editor.
+on-canvas tool does what. The 3D/IFC/Tekla exports are on-demand from the editor; the **BOM is
+exported two ways** — on-demand via the editor's *Export BOM (CSV)/(Excel)* buttons, **and written
+to `~/.floless/exports/steel-model/steel-model-bom.{csv,xlsx}` automatically every time the workflow
+is Run** (two `file/write` export steps at the end of the chain). Tell the user they can **freeze**
+those export steps (right-click → Freeze) once the BOM is right, so a re-Run won't overwrite the files.
 
 ---
 

package/dist/skills/floless-app-steel-takeoff/SKILL.md

@@ -366,3 +366,8 @@ never committed). Clip title blocks from any embedded preview.
   sizes or grid positions the drawing does not show.
 - **Resolve the port** from the running floless.app the same way other floless-app skills do
   (check `~/.floless/port` or the active server port).
+- **Decode unfamiliar note/profile codes** with **`steel-drawing-abbreviations`** (the default
+  US/AISC abbreviations + shape legend) when the set lacks its own abbreviations sheet — for TYP
+  profiles, TOS/UON defaults, `(E)`/`(N)` scope, and shape designations. The project's own legend
+  always overrides; never expand a member *mark* (`MF`/`BF`/`D1`) from it — resolve those from the
+  schedules/elevations.

package/dist/skills/floless-app-workflows/SKILL.md

@@ -2,7 +2,7 @@
 name: floless-app-workflows
 description: This skill should be used when building, modifying, or reasoning about FloLess .flo workflows for floless.app — especially reusable apps that take inputs (e.g. a phase number) and run across different Tekla models, exec nodes that run Roslyn C# against the live model, the in-app HTML Viewer, the Code tab, or "Debug in VS". Covers the exec contract, the install→validate→compile→run loop, app inputs templating, and the server seams (aware-adapter, app-reader, index).
 metadata:
-  version: 0.1.0
+  version: 0.2.0
 ---
 
 # Building reusable .flo workflows in floless.app
@@ -270,6 +270,29 @@ floless.app play (designed, now unblocked): a "Bake into agent" affordance that
 `.flo` to add `exposes-as-agent` + `exposed-commands` mirroring the app's `inputs:`. Thin-UI: a
 manifest edit + recompile, no engine. See the design doc for the Stage-1 plan.
 
+## Write a file on Run (the `file` agent) — VERIFIED, AWARE 0.81.0+
+
+A node can **land an artifact on disk as part of the run** with the `_core/file` agent (steel-model's
+`csv-export` / `xlsx-export` nodes do exactly this). Key facts (all verified):
+
+- **`file` is a builtin** (`transport: builtin {}`) — handled in-process, **no host binary**, like
+  `html-report` / `viewer-3d`. But its **manifest must be installed** (`aware agent install file`):
+  absent, the run fails with an opaque IO error; present, `aware app run` dispatches it. floless
+  ensures it before Run for any app that `requires: file@1.0.x` (see `ensureSteelExportReady`, index.ts).
+- **Verbs:** `write` lands `bytes` at `path` (`encoding: text | base64`); `write-csv` takes
+  `{ path, columns, rows }` → RFC-4180. For a **binary** artifact (`.xlsx`, image, zip) **floless
+  generates the bytes in TS and the node base64-lands them** — AWARE has no xlsx serializer, so the
+  binary stays host-side (we reuse `bomToXlsx` and write `encoding: base64`).
+- **`file/write*` are `mode: write`** (a generic arbitrary-path writer mutates external state), so an
+  **un-frozen** export node MUST carry a `safety:` block — `safety: { snapshot: false }` is enough. A
+  **frozen** node skips the safety preflight AND skips dispatch (it replays its pinned output, no
+  write) — that is the "freeze the export so Run won't regenerate it" affordance.
+- **Path:** the producer owns `path`. A **bare relative path resolves to the run process's cwd**
+  (it'll litter the server dir), so floless bakes an **absolute** `~/.floless/exports/<appId>/…` path
+  into the node — on Approve via `bakeDownstream` → `bakeBomExportNodes` (path + real bytes), and as a
+  safety net before Run via `ensureSteelExportReady` (path only; idempotent, recompiles once). The
+  committed template carries a bare filename + a small example payload so the step is valid out of the box.
+
 ## How the UI surfaces map to AWARE state
 
 - **Code tab** shows the node's real source: `node.config.code` (the exec C#), not lockfile

package/dist/skills/reading-structural-drawings/SKILL.md

@@ -46,7 +46,9 @@ one with a curved roof — both obvious in the elevations, invisible in the plan
 Read the **cover / drawing index** and **general notes** first. Build a sheet list classified by
 type (index, notes, foundation plan, framing plans per level, frame elevations, sections, details,
 **schedules**). Confirm the set is complete + current revision. Grab the legend, datum, material
-defaults, and the **abbreviations** (FC/MF/BF/(E)/(N)/matchline symbols). Trust PyMuPDF page_count over
+defaults, and the **abbreviations** (FC/MF/BF/(E)/(N)/matchline symbols). If the set ships **no
+abbreviations/legend sheet** (or only partial sheets), fall back to the **`steel-drawing-abbreviations`**
+default US/AISC legend for the standard codes. Trust PyMuPDF page_count over
 any external count.
 
 ### Pass 1 — MASSING (how many buildings, what shape) — from elevations/sections, not plans
@@ -114,6 +116,9 @@ Only then build the scene / overlay / IFC. If unsure, present the **massing + gr
   skill is the *reading discipline*; that one is the *reader*. The **`floless-app-steel-model`** guide
   (the front-door orchestrator) wraps the whole flow and references this discipline at the
   classify-and-verify gates rather than re-deriving it.
+- **`steel-drawing-abbreviations`** — the default US/AISC abbreviations + shape-designation legend.
+  Consult it in Pass 0 when the set omits its own legend sheet, and whenever a note code (TYP, TOS,
+  UON, `(E)`/`(N)`) or profile designation needs decoding.
 - There is no off-the-shelf OSS tool that does the whole drawing→model job — floorplan vectorisers
   (e.g. CubiCasa5k) are residential-trained and won't read steel framing — which is why the order +
   validation discipline above, not a single tool, is the method.

package/dist/skills/steel-drawing-abbreviations/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: steel-drawing-abbreviations
+description: Default legend of standard US (AISC, imperial) structural-steel drawing abbreviations, note conventions, and shape designations — the fallback meaning when a drawing set omits or only partially supplies its own abbreviations/legend sheet. This skill should be used while reading a structural steel drawing whenever an abbreviation, note code, or profile designation needs expanding (TYP, TOS, UON, EQ, (E)/(N), SIM, HSS, WT, and so on), or when the steel reader (floless-app-steel-takeoff / floless-app-steel-model) meets a note or label whose meaning is not defined on the supplied sheets. The project's own legend always overrides these defaults.
+metadata:
+  version: "0.1.0"
+---
+
+# Steel drawing abbreviations — default legend
+
+## What this is
+
+A reusable **fallback legend** of the standard abbreviations, note conventions, and steel-shape
+designations that appear on the General Notes / legend sheet (usually `S-001` / `S-100`) of most
+**US (AISC, imperial)** structural sets. These are an industry convention — largely identical from
+project to project — so they fill the gap when a set does not ship its own abbreviations sheet, or
+when only some sheets are provided.
+
+The full glossary lives in **`references/standard-us-abbreviations.md`** (abbreviations A–Z, the
+structural-steel shape table, the high-value note conventions for takeoff, and a marks-vs-abbreviations
+warning). Keep this SKILL.md lean; load the reference when an actual lookup is needed.
+
+## When to consult it
+
+- A structural plan, section, or **General Note** uses an abbreviation or code that is not spelled
+  out on the supplied sheets, and its meaning is needed to read geometry or metadata correctly
+  (e.g. a "T.O.S. = 16'-6" UON" note, a "TYP" profile, an `(E)` member).
+- The **steel reader** (`floless-app-steel-takeoff`) or the **guide** (`floless-app-steel-model`) is
+  learning a set and the user did **not** provide the abbreviations/legend sheet — use this as the
+  default while still reading the rest of the set.
+- A profile designation needs decoding (what `HSS6X6X3/8`, `WT`, `C`, `MC`, `PIPE-XX` mean and which
+  ones carry their weight in the name vs. need an AISC table).
+
+## How to use it
+
+1. **Read the project legend first.** If the set HAS an abbreviations sheet or a note that defines the
+   code, use *that* — this file is only the fallback. The project's own definition always wins.
+2. **Look up the code** in `references/standard-us-abbreviations.md` (grep the abbreviation, e.g.
+   `grep -i 'TOS' references/standard-us-abbreviations.md`).
+3. **Respect context over the table.** Several codes are context-dependent (`WT` = WEIGHT or a tee
+   shape; `PT` = POST-TENSIONED / PRESSURE-TREATED / POINT). Choose the structurally sensible meaning;
+   if it is genuinely ambiguous, flag it as an RFI rather than guess.
+4. **Do not expand marks.** `MF` / `BF` / `D1` / `C1` / `B12` are project member/frame marks resolved
+   from the frame elevations and schedules — never from this glossary (see the reference's
+   "Marks vs abbreviations" section).
+5. **Mind the region.** This is the US/AISC legend. For EU (EN) or UK (BS) sets, defer to the project
+   legend and the region-specific detailer agent (`steel-detailer-eu` / `steel-detailer-uk`); the
+   shape designations especially differ.
+
+## Companion skills
+
+- **`reading-structural-drawings`** — the reading discipline; its Pass 0 (inventory & legend) consults
+  this default legend when the set's own abbreviations sheet is missing.
+- **`floless-app-steel-takeoff`** — the reader; uses this while reading notes/labels into the
+  `steel.takeoff/v1` contract (TYP profiles, TOS defaults, connection-type words, `(E)`/`(N)` scope).
+- **`floless-app-steel-model`** — the front-door guide; references this at the "learn the set" stage so
+  a partial set without a legend sheet still reads correctly.
+- **`steel-detailer-us` / `-eu` / `-uk`** (AWARE agents) — own the section *tables and weights*; this
+  skill only decodes the *labels and notes*.

package/dist/skills/steel-drawing-abbreviations/references/standard-us-abbreviations.md

@@ -0,0 +1,296 @@
+# Standard US structural-steel drawing abbreviations & symbols (default legend)
+
+These are the **de-facto standard abbreviations** that appear on the General Notes / legend sheet
+(usually `S-001` / `S-100`) of most **US (AISC, imperial)** structural sets. They are an industry
+convention, not any one firm's property, so they serve as a **fallback default** when a drawing set
+does not include its own abbreviations/legend sheet (or only ships partial sheets).
+
+**Rules of use (read before applying any expansion):**
+- **The project's own legend ALWAYS wins.** If the set has an abbreviations sheet or a plan/general
+  note that defines a code, use *that* meaning — never override it with this list.
+- **Context can override.** The same code means different things by context (e.g. `WT` = WEIGHT or a
+  structural-tee shape; `PT` = POST-TENSIONED or PRESSURE-TREATED or POINT). Pick the meaning that
+  fits the structural context; if genuinely ambiguous, flag it (RFI) rather than guess.
+- **Region differs.** This is the US/AISC set. EU (EN) and UK (BS) sets use different shape
+  designations and some different abbreviations — defer those to the project legend and the
+  region-specific detailer agent (`steel-detailer-eu` / `steel-detailer-uk`).
+- **Marks are NOT abbreviations.** Member/frame *marks* like `MF`, `BF`, `D1`, `C1`, `B12` are
+  project-specific labels resolved from the frame elevations / schedules — not from this glossary.
+  See "Marks vs abbreviations" below.
+
+---
+
+## Abbreviations (A–Z)
+
+| Abbr | Meaning |
+|------|---------|
+| `AB` | ANCHOR BOLT |
+| `ACI` | AMERICAN CONCRETE INSTITUTE |
+| `ADD'L` | ADDITIONAL |
+| `ADJ` | ADJACENT / ADJUSTABLE |
+| `AESS` | ARCHITECTURALLY EXPOSED STRUCTURAL STEEL |
+| `AGGR` | AGGREGATE |
+| `AISC` | AMERICAN INSTITUTE OF STEEL CONSTRUCTION |
+| `AITC` | AMERICAN INSTITUTE OF TIMBER CONSTRUCTION |
+| `ALT` | ALTERNATE |
+| `ALUM` | ALUMINUM |
+| `ANCH` | ANCHOR |
+| `ANSI` | AMERICAN NATIONAL STANDARDS INSTITUTE |
+| `APA` | AMERICAN PLYWOOD ASSOCIATION |
+| `APPROX` | APPROXIMATE |
+| `ARCH` | ARCHITECTURAL / ARCHITECT |
+| `ASD` | ALLOWABLE STRENGTH DESIGN |
+| `ASTM` | AMERICAN SOCIETY FOR TESTING AND MATERIALS |
+| `AWPA` | AMERICAN WOOD PRESERVERS ASSOCIATION |
+| `AWS` | AMERICAN WELDING SOCIETY |
+| `AVG` | AVERAGE |
+| `@` | AT |
+| `&` | AND |
+| `BLDG` | BUILDING |
+| `BLK` | BLOCK |
+| `BLKG` | BLOCKING |
+| `BM` | BEAM |
+| `BN` | BOUNDARY NAIL |
+| `BNDRY` | BOUNDARY |
+| `BOT` (or `B`) | BOTTOM |
+| `BRC` | BRACE |
+| `BRG` | BEARING |
+| `BT` | BENT |
+| `BTWN` | BETWEEN |
+| `CANT` | CANTILEVER |
+| `CAM` (or `C`) | CAMBER |
+| `CG` | CENTER OF GRAVITY |
+| `CIP` | CAST-IN-PLACE |
+| `CJ` | CONSTRUCTION JOINT; CONTROL JOINT |
+| `CJP` | COMPLETE JOINT PENETRATION (WELD) |
+| `CL` (or `℄`) | CENTER LINE |
+| `CLR` | CLEAR |
+| `CMU` | CONCRETE MASONRY UNIT |
+| `COL` | COLUMN |
+| `COMP` | COMPRESSION / COMPOSITE |
+| `CONC` | CONCRETE |
+| `CONN` | CONNECTION |
+| `CONST` / `CONSTR` | CONSTRUCTION |
+| `CONT` | CONTINUOUS / CONTINUE |
+| `CTR` | CENTER |
+| `CTSK` | COUNTERSUNK |
+| `CU FT` | CUBIC FOOT |
+| `d` | PENNY (nail size, e.g. `16d`) |
+| `DBL` | DOUBLE |
+| `DEPT` | DEPARTMENT |
+| `DET` | DETAIL |
+| `DIA` (or `Ø`) | DIAMETER |
+| `DIAG` | DIAGONAL |
+| `DIAPH` | DIAPHRAGM |
+| `DIM` | DIMENSION |
+| `DN` | DOWN |
+| `DO` | DITTO |
+| `DWG` | DRAWING |
+| `DWL` | DOWEL |
+| `EA` | EACH |
+| `EF` | EACH FACE |
+| `EJ` | EXPANSION JOINT |
+| `EL` / `ELEV` | ELEVATION |
+| `ELEC` | ELECTRICAL |
+| `EMBED` | EMBEDMENT |
+| `EN` | EDGE NAIL |
+| `EQ` | EQUAL / EQUALLY (SPACED) |
+| `EQUIP` | EQUIPMENT |
+| `ES` | EACH SIDE |
+| `EW` | EACH WAY |
+| `EXP` | EXPANSION |
+| `EXT` | EXTERIOR |
+| `(E)` | EXISTING (often out of new-work scope) |
+| `FDN` | FOUNDATION |
+| `FF` | FAR FACE |
+| `FIN` | FINISH(ED) |
+| `FLR` | FLOOR |
+| `FN` | FIELD NAIL |
+| `FOC` | FACE OF CONCRETE |
+| `FOS` | FACE OF STUD / FACE OF SLAB |
+| `FOW` | FACE OF WALL |
+| `FP` | FIRE PROOFING |
+| `FRMG` | FRAMING |
+| `FS` | FAR SIDE / FULL SIZE |
+| `FT` | FOOT / FEET |
+| `FTG` | FOOTING |
+| `GA` | GAUGE |
+| `GALV` | GALVANIZED |
+| `GB` | GRADE BEAM |
+| `GLB` | GLUE-LAMINATED BEAM |
+| `GR` | GRADE |
+| `GRTG` | GRATING |
+| `HDR` | HEADER |
+| `HGR` | HANGER |
+| `HGT` / `HT` | HEIGHT |
+| `HK` | HOOK |
+| `HORIZ` (or `H`) | HORIZONTAL |
+| `HP` | HIGH POINT |
+| `HS` | HIGH STRENGTH |
+| `HSS` | HOLLOW STRUCTURAL SECTION |
+| `ID` | INSIDE DIAMETER |
+| `IF` | INSIDE FACE |
+| `IN` | INCH |
+| `INCL` | INCLUDE / INCLUDED |
+| `INFO` | INFORMATION |
+| `INSP` | INSPECTION |
+| `INT` | INTERIOR |
+| `JST` | JOIST |
+| `JT` | JOINT |
+| `K` | KIPS (1000 lb) |
+| `KSI` | KIPS PER SQUARE INCH |
+| `LAB` | LABORATORY |
+| `LB(S)` (or `#`) | POUNDS |
+| `LH` | LEFT HAND |
+| `LLH` | LONG LEG HORIZONTAL |
+| `LLV` | LONG LEG VERTICAL |
+| `LP` | LOW POINT |
+| `LT WT` | LIGHTWEIGHT |
+| `MAS` | MASONRY |
+| `MATL` | MATERIAL |
+| `MAX` | MAXIMUM |
+| `MB` | MACHINE BOLT |
+| `MECH` | MECHANICAL |
+| `MFR` | MANUFACTURER |
+| `MIN` | MINIMUM |
+| `MISC` | MISCELLANEOUS |
+| `N` | NORTH |
+| `(N)` | NEW |
+| `NF` | NEAR FACE |
+| `NIC` | NOT IN CONTRACT |
+| `NOM` | NOMINAL |
+| `NO` (or `#`) | NUMBER |
+| `NS` | NEAR SIDE |
+| `NTS` | NOT TO SCALE |
+| `OC` | ON CENTER |
+| `OD` | OUTSIDE DIAMETER |
+| `OF` | OUTSIDE FACE |
+| `OH` | OPPOSITE HAND |
+| `OPNG` | OPENING |
+| `OPP` | OPPOSITE |
+| `OSB` | ORIENTED STRAND BOARD |
+| `PARA` (or `∥`) | PARALLEL |
+| `PERP` (or `⊥`) | PERPENDICULAR |
+| `PJP` | PARTIAL JOINT PENETRATION (WELD) |
+| `PL` | PLATE |
+| `PLF` | POUNDS PER LINEAR FOOT |
+| `PLYWD` | PLYWOOD |
+| `PNL` | PANEL |
+| `PSF` | POUNDS PER SQUARE FOOT |
+| `PSI` | POUNDS PER SQUARE INCH |
+| `PT` | POST-TENSIONED / PRESSURE-TREATED / POINT |
+| `R` / `RAD` | RADIUS |
+| `RD` | ROOF DRAIN |
+| `REF` | REFERENCE |
+| `REINF` | REINFORCING / REINFORCEMENT |
+| `REQ'D` | REQUIRED |
+| `RET` | RETAINING |
+| `RM` | ROOM |
+| `RO` | ROUGH OPENING |
+| `SCHED` | SCHEDULE |
+| `SECT` | SECTION |
+| `SF` | SQUARE FEET |
+| `SHT` | SHEET |
+| `SHTHG` | SHEATHING |
+| `SIM` | SIMILAR |
+| `SLBB` | SHORT LEGS BACK-TO-BACK |
+| `SOG` | SLAB ON GRADE |
+| `SPCG` | SPACING |
+| `SPECS` | SPECIFICATIONS |
+| `SQ` | SQUARE |
+| `SS` | SELECT STRUCTURAL / STAINLESS STEEL |
+| `SSL` | SHORT SLOTTED HOLES |
+| `STAGG` | STAGGERED |
+| `STD` | STANDARD |
+| `STIFF` | STIFFENER |
+| `STIRR` | STIRRUP |
+| `STL` | STEEL |
+| `STRUCT` | STRUCTURAL |
+| `SYM` | SYMMETRICAL |
+| `T&B` | TOP AND BOTTOM |
+| `T&G` | TONGUE AND GROOVE |
+| `TB` | TIE BEAM |
+| `TEMP` | TEMPORARY / TEMPERATURE |
+| `THK` | THICK / THICKNESS |
+| `THR` | THREADED |
+| `THRU` | THROUGH |
+| `TN` | TOE NAIL |
+| `TOC` | TOP OF CONCRETE / TOP OF CURB |
+| `TOF` | TOP OF FOOTING |
+| `TOS` | TOP OF STEEL / TOP OF SLAB |
+| `TOW` | TOP OF WALL |
+| `TYP` | TYPICAL |
+| `UON` / `UNO` | UNLESS OTHERWISE NOTED |
+| `VERT` (or `V`) | VERTICAL |
+| `VIF` | VERIFY IN FIELD |
+| `W` | WEST |
+| `W/` | WITH |
+| `WD` | WOOD |
+| `WP` | WORK POINT (also WATERPROOF) |
+| `WT` | WEIGHT (also a structural-tee shape — see below) |
+| `WWF` | WELDED WIRE FABRIC |
+
+---
+
+## Structural steel shape designations
+
+How a profile label decodes (the label sits on/near the member centerline, usually mid-span):
+
+| Designation | Shape |
+|-------------|-------|
+| `W` | Wide-flange (W-shape) — e.g. `W16X26` |
+| `M` | Miscellaneous I-shape |
+| `S` | American Standard (S-shape / "I-beam") |
+| `HP` | Bearing pile (HP-shape) |
+| `C` | American Standard Channel |
+| `MC` | Miscellaneous Channel |
+| `L` | Angle (equal/unequal leg) — e.g. `L4X4X1/4` |
+| `WT` / `MT` / `ST` | Structural Tee (cut from W / M / S) |
+| `HSS` | Hollow Structural Section (rectangular/square/round) — e.g. `HSS6X6X3/8` |
+| `PIPE` | Standard pipe; `PIPE-X` extra-strong; `PIPE-XX` double-extra-strong |
+| `TS` | Tube Steel (older designation for HSS) |
+| `PL` | Plate — e.g. `PL1/2X8` |
+
+**Reading the size numbers:**
+- **W/M/S/HP/C/MC and WT/MT/ST:** the trailing number after the `X` IS the weight in **lb/ft (plf)** —
+  no table needed. `W16X26` = nominal depth **16"** × **26 lb/ft**; `WT6X25` (a tee cut from a W) =
+  **25 lb/ft**; `C12X20.7` = **20.7 lb/ft**. (Tees inherit weight-based naming from their parent
+  W/M/S shape.)
+- **HSS / PIPE / L / PL:** the numbers are **dimensions**, not the weight (e.g. `HSS6X6X3/8` =
+  6"×6"×3/8" wall, `L4X4X1/4` = 4"×4"×1/4" leg) — look the weight up in an AISC shapes table
+  (or via the `steel-detailer-us` agent).
+
+---
+
+## Note conventions most useful to a takeoff
+
+When reading the General Notes and plan notes, these drive member geometry/metadata directly:
+
+- **`TYP`** — a value/detail shown once applies to all like conditions. A "TYP" profile or spacing in
+  the notes is the **default** for unlabeled members of that kind.
+- **`TOS` / `TOC` / `TOF` / `BOS`** — top/bottom-of-steel/concrete/footing elevations. A plan default
+  TOS ("ALL STEEL T.O.S. = 16'-6" UON") sets every member's elevation unless a local callout overrides.
+- **`UON` / `UNO`** — the stated value holds everywhere *unless* a local note says otherwise. Treat a
+  "TYP … UON" note as the fallback and watch for the exceptions.
+- **`EQ`** — equally-spaced members between two references (no explicit dimension).
+- **`SIM`** — a detail is repeated similarly elsewhere (mirror/rotate as needed).
+- **`(N)` / `(E)`** — new vs existing. `(E)` members are frequently **out of the new-steel takeoff**;
+  confirm against line weight/scope before counting them.
+- **Connection-type words in notes** — `MOMENT`, `DRAG`, `SHEAR`, `BRACED`, `PINNED`, `FIXED` name the
+  connection type at member ends; feed them into the member-end connection note + the connection
+  library (type → design detail# → platform component).
+
+---
+
+## Marks vs abbreviations (do not confuse)
+
+A *mark* identifies a specific member or frame and is defined **by the project's schedules/elevations**,
+not by this glossary:
+
+- `MF` / `BF` — Moment Frame / Braced Frame member marks (resolved from the Frame Elevation sheets;
+  the AISC size comes from the moment-frame schedule, not from "MF").
+- `D1`, `D2`, `BR1` — brace/diagonal marks.
+- `C1`, `B12`, `G3` — column/beam/girder marks keyed to a schedule.
+
+Never expand a mark using this abbreviation list. Resolve it from the frame elevations / column &
+beam schedules, and if unresolved, leave it as an RFI.

package/dist/templates/steel-model.flo

@@ -1,5 +1,5 @@
 app:           steel-model
-version:       0.2.0
+version:       0.3.0
 display-name:  Steel Model
 publisher:     floless
 module:        steel-detailer
@@ -14,6 +14,10 @@ exposes-as-agent: false
 # Workflow changelog (FloLess-published). Newest first; the app shows entries newer than the
 # installed version when offering an update. Plain-English — it surfaces to the user.
 changelog:
+  - version: 0.3.0
+    summary: Export your bill of materials as CSV and Excel on Run
+    changes:
+      - "Added: two export steps at the end that write your bill of materials to a .csv and a real .xlsx file when you Run the workflow — the same figures as the BOM table and the Export buttons, saved to your exports folder automatically. Freeze a step once it's right and Run won't overwrite the file."
   - version: 0.2.0
     summary: Filter your drawing down to the steel first
     changes:
@@ -34,6 +38,7 @@ inputs:
 requires:
   - html-report@0.2.x
   - viewer-3d@0.1.x
+  - file@1.0.x
 layout: linear
 nodes:
   # ── node 1: filter — isolate the steel linework (FIRST stage) ─────────────────
@@ -145,7 +150,45 @@ nodes:
               - { id: m1, profile: W10X33,      role: beam,   wp: [[0,0],[6000,0]] }
               - { id: m2, profile: HSS6X6X3/8,  role: column, wp: [[0,0],[0,4500]] }
 
+  # ── node 5: csv-export — write the bill of materials to a CSV file ────────────
+  # Saves the bill of materials to a .csv file on disk every time you Run the
+  # workflow — the same figures and the same file you'd get from the "Export BOM
+  # (CSV)" button, but produced by the run so it lands automatically. When you
+  # Approve a takeoff, FloLess fills in the finished CSV and points this at your
+  # ~/.floless/exports folder; until then it ships a small sample so the step works
+  # out of the box. Freeze this node once you're happy and Run won't rewrite the file.
+  # (Uses the generic `file/write` verb with the CSV text FloLess generates — so the
+  # exported file is byte-for-byte the one the Export button produces, formula-injection
+  # guard and all — rather than re-serialising the rows in the runtime.)
+  - id: csv-export
+    agent: file
+    command: write
+    safety: { snapshot: false }   # writing a file is a write-mode act; an un-frozen run needs a safety block (a frozen node skips the check)
+    config:
+      path: steel-model-bom.csv   # baked to <home>/.floless/exports/steel-model/steel-model-bom.csv on Approve
+      encoding: text
+      bytes: "Profile,Qty,Length (ft),lb/ft,Weight (lb)\r\nW10X33,4,96,49.1,4714\r\nHSS6X6X3/8,6,54,27.48,1484\r\nTOTAL,10,150,,6198\r\n"
+
+  # ── node 6: xlsx-export — write the bill of materials to an Excel file ────────
+  # Saves the bill of materials to a real .xlsx Excel file every time you Run the
+  # workflow — the same figures as the BOM table and the "Export BOM (Excel)" button.
+  # Excel files are binary, so FloLess builds the spreadsheet and hands its bytes to
+  # this step to land on disk (base64-encoded). When you Approve a takeoff, FloLess
+  # fills in the real workbook and points this at your ~/.floless/exports folder; until
+  # then it ships a small sample so the step works out of the box. Freeze this node once
+  # you're happy and Run won't rewrite the file.
+  - id: xlsx-export
+    agent: file
+    command: write
+    safety: { snapshot: false }   # writing a file is a write-mode act; an un-frozen run needs a safety block (a frozen node skips the check)
+    config:
+      path: steel-model-bom.xlsx  # baked to <home>/.floless/exports/steel-model/steel-model-bom.xlsx on Approve
+      encoding: base64
+      bytes: "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"
+
 connections:
   - { from: filter, to: read }
   - { from: read, to: view }
   - { from: view, to: bom }
+  - { from: bom, to: csv-export }
+  - { from: csv-export, to: xlsx-export }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.53.0",
+  "version": "0.54.1",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {