feat(fc): parts_bootstrap stub and model_3d report field (v4.0.59)

Add pdfcadcore parts_bootstrap sidecar stub, build_model_3d_extra in import_report, and Round 8 Q&A mirror updates.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: BlueCollarSys-0628

PDFVectorImporter/compare_feature_matrix.py

@@ -43,7 +43,7 @@ class Feature:
     Feature("lineweight_modes", "Lineweight handling modes", r"\b(lineweight_mode|lineweight)\b", {"SU", "FC", "BL", "LC"}),
     Feature("doc_profiling", "Document profiling/classification", r"\b(document_profiler|profile_page|primary_type)\b", {"SU", "FC", "BL", "LC"}),
     Feature("scale_reference", "Scale by reference tooling", r"\b(Scale by Reference|scale tool|reference_real_mm|PDFScaleTool)\b", {"SU", "FC", "BL", "LC"}),
-    Feature("cli_surface", "CLI surface", r"\b(argparse|cli\.py|pdf2dxf\.py)\b", {"SU", "FC", "BL", "LC"}),
+    Feature("cli_surface", "CLI surface", r"\b(argparse|OptionParser|cli\.(?:py|rb)|pdf2dxf\.py)\b", {"SU", "FC", "BL", "LC"}),
     Feature("gui_surface", "GUI surface", r"\b(HtmlDialog|QDialog|bpy\.types\.Operator|--gui|Tkinter)\b", {"SU", "FC", "BL", "LC"}),
     Feature("batch_import", "Batch import workflows", r"\b(Batch Import|batch import|BatchImportCommand)\b", {"SU", "FC", "BL", "LC"}),
     Feature("qa_automation", "Automated QA harness", r"\b(run_pdf_vector_importer_tests|qa_config|pytest|smoke_test|qa_smoke)\b", {"SU", "FC", "BL", "LC"}),

PDFVectorImporter/package.xml

@@ -2,7 +2,7 @@
 <package format="1" xmlns="https://wiki.freecad.org/Package_Metadata">
   <name>PDFVectorImporter</name>
   <description>Import PDF vector drawings as editable FreeCAD geometry with arc reconstruction, text, scaling, and steel feature detection.</description>
-  <version>4.0.58</version>
+  <version>4.0.59</version>
   <date>2026-06-26</date>
   <maintainer email="support@bluecollar-systems.com">BlueCollar Systems</maintainer>
   <!-- AI Contributors: Claude & Claude Code (Anthropic), ChatGPT & Codex (OpenAI),

PDFVectorImporter/pdfcadcore/import_report.py

@@ -401,6 +401,29 @@ def _pdf_audit_extras(pdf_path: str) -> Dict[str, Any]:
     return merged
 
 
+def build_model_3d_extra(
+    host_app: str,
+    *,
+    enabled: bool = False,
+    stats: Optional[Dict[str, Any]] = None,
+) -> Dict[str, Any]:
+    """Honest model_3d block for import_report.extra (R8-1)."""
+
+    if stats:
+        return dict(stats)
+    host = str(host_app or "").lower()
+    if host == "librecad":
+        return {
+            "supported": False,
+            "enabled": False,
+            "reason": "2D host — PDF import produces planar DXF only",
+        }
+    return {
+        "supported": host in ("freecad", "blender", "sketchup"),
+        "enabled": bool(enabled),
+    }
+
+
 def enrich_import_report_extras(report: "ImportReport") -> None:
     """Attach scale cross-check, performance hint, and refresh human_summary."""
 
@@ -416,6 +439,9 @@ def enrich_import_report_extras(report: "ImportReport") -> None:
     )
     if hint:
         report.extra["performance_hint"] = hint
+    if "model_3d" not in report.extra:
+        host = str((report.host or {}).get("app") or "")
+        report.extra["model_3d"] = build_model_3d_extra(host)
     report.extra["human_summary"] = build_human_summary(report)
 
 
@@ -804,6 +830,7 @@ def build_import_report(
     "build_pdf_interactive_note",
     "build_performance_hint",
     "build_scale_crosscheck",
+    "build_model_3d_extra",
     "enrich_import_report_extras",
     "build_import_report",
 ]

PDFVectorImporter/pdfcadcore/parts_bootstrap.py

@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+"""Minimal parts bootstrap sidecar builder (bcs.parts_bootstrap/1.0) — stub emitter."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+SCHEMA = "bcs.parts_bootstrap/1.0"
+
+
+def _sha256_file(path: str) -> str:
+    digest = hashlib.sha256()
+    with open(path, "rb") as handle:
+        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def build_parts_bootstrap_stub(
+    pdf_path: str,
+    *,
+    page_count: int = 0,
+    rows: Optional[List[Dict[str, Any]]] = None,
+) -> Dict[str, Any]:
+    """Return a valid sidecar payload; BOM row extraction is deferred."""
+
+    payload: Dict[str, Any] = {
+        "schema": SCHEMA,
+        "rows": list(rows or []),
+        "source_pdf": {
+            "file": str(Path(pdf_path).name),
+            "pages": int(page_count or 0),
+        },
+        "note": "stub emitter — automated piece-mark extraction deferred",
+    }
+    if pdf_path and Path(pdf_path).is_file():
+        payload["source_pdf"]["sha256"] = _sha256_file(pdf_path)
+    return payload
+
+
+def write_parts_bootstrap_sidecar(
+    output_path: str,
+    pdf_path: str,
+    *,
+    page_count: int = 0,
+    rows: Optional[List[Dict[str, Any]]] = None,
+) -> str:
+    path = Path(output_path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+    manifest = build_parts_bootstrap_stub(
+        pdf_path,
+        page_count=page_count,
+        rows=rows,
+    )
+    path.write_text(json.dumps(manifest, indent=2) + "\n", encoding="utf-8")
+    return str(path)
+
+
+__all__ = [
+    "SCHEMA",
+    "build_parts_bootstrap_stub",
+    "write_parts_bootstrap_sidecar",
+]

PDFVectorImporter/src/PDFImporterCore.py

@@ -448,6 +448,11 @@ class ImportOptions:
     #   raster  — render full page as image, skip vectors
     #   hybrid  — raster background + vector geometry on top
     import_mode: str = "auto"
+    # Optional 3D model generation.  "auto" only runs when text evidence
+    # indicates an honest third dimension; "extrude" forces closed-shape
+    # extrusion with page-background guards.
+    model3d_mode: str = "off"              # "off" | "auto" | "extrude"
+    model3d_depth_mm: float = 3.175        # default 1/8 in plate thickness
     max_bezier_segments: int = 128
     # Arc reconstruction
     detect_arcs: bool = True
@@ -679,6 +684,22 @@ def write_import_report(
             "object_count": len(provenance_objects),
         }
 
+    from pdfcadcore.parts_bootstrap import write_parts_bootstrap_sidecar
+
+    bootstrap_path = str(Path(output_path).with_name("parts_bootstrap.json"))
+    write_parts_bootstrap_sidecar(
+        bootstrap_path,
+        pdf_path,
+        page_count=int(total_pages or pages_imported or 0) or None,
+    )
+    extra_ref = report.extra
+    extra_ref["parts_bootstrap"] = {
+        "schema": "bcs.parts_bootstrap/1.0",
+        "sidecar_path": Path(bootstrap_path).name,
+        "row_count": 0,
+        "note": "stub emitter — BOM extraction deferred",
+    }
+
     report.write_json(output_path)
     return output_path
 
@@ -916,6 +937,88 @@ def _make_shape_obj(edges: List, closed: bool, make_face: bool, fc_doc=None):
         return None
 
 
+def _normalize_model3d_mode(raw) -> str:
+    mode = str(raw or "off").strip().lower().replace("-", "_").replace(" ", "_")
+    if mode in {"yes", "true", "on", "auto_if_evidence"}:
+        return "auto"
+    if mode in {"closed", "closed_shapes", "extrude_closed_shapes", "force"}:
+        return "extrude"
+    if mode in {"auto", "extrude"}:
+        return mode
+    return "off"
+
+
+def _model3d_depth_units(opts: ImportOptions) -> float:
+    try:
+        depth = float(getattr(opts, "model3d_depth_mm", 3.175) or 3.175)
+    except (TypeError, ValueError):
+        depth = 3.175
+    return max(0.0, depth)
+
+
+def _model3d_should_extrude(
+    opts: ImportOptions,
+    *,
+    is_closed: bool,
+    fill,
+    face_area: float,
+    page_area: float,
+) -> bool:
+    mode = _normalize_model3d_mode(getattr(opts, "model3d_mode", "off"))
+    if mode == "off" or not is_closed:
+        return False
+    if _model3d_depth_units(opts) <= 0.0:
+        return False
+    if face_area <= 1e-6:
+        return False
+    # Skip full-page paper/background fills and border frames.
+    if page_area > 1e-6 and face_area / page_area >= 0.80:
+        return False
+    if mode == "auto":
+        if not bool(getattr(opts, "_model3d_intent_feasible", False)):
+            return False
+        # Auto is deliberately conservative: only extrude filled closed
+        # regions when the drawing text supplies third-dimension evidence.
+        return fill is not None
+    return True
+
+
+def _make_model3d_obj(edges: List, fc_doc=None):
+    if not edges:
+        return None
+    doc = fc_doc or FreeCAD.ActiveDocument
+    try:
+        wire = Part.Wire(edges)
+        if not wire.isClosed() and wire.Vertexes:
+            p0 = wire.Vertexes[0].Point
+            pN = wire.Vertexes[-1].Point
+            if _len2d(_v(p0.x, p0.y), _v(pN.x, pN.y)) > ZERO_TOL:
+                closer = Part.LineSegment(pN, p0).toShape()
+                wire = Part.Wire(edges + [closer])
+        if not wire.isClosed():
+            return None
+        face = Part.Face(wire)
+        if face.Area <= 1e-6:
+            return None
+        obj = doc.addObject("Part::Feature", "PDF_3D_Solid")
+        obj.Shape = face
+        return obj
+    except (RuntimeError, ValueError, TypeError, AttributeError):
+        return None
+
+
+def _extrude_model3d_obj(obj, opts: ImportOptions) -> bool:
+    if obj is None:
+        return False
+    try:
+        depth = _model3d_depth_units(opts)
+        obj.Shape = obj.Shape.extrude(Vector(0, 0, depth))
+        return True
+    except (RuntimeError, ValueError, TypeError, AttributeError) as e:
+        _warn(f"3D extrusion failed: {e}")
+        return False
+
+
 def _apply_style(obj, stroke_rgb, fill_rgb, width, dashes, opts: ImportOptions):
     """Set source stroke/fill color, line width, and dash style on a ViewObject."""
     try:
@@ -2510,6 +2613,7 @@ def _import_pdf_page_inner(pdf_doc, pdf_path, page_num, opts, fc_doc):
         _fc_mb_w, _fc_mb_h = float(page.rect.width), float(page.rect.height)
     page_h = _fc_mb_w if _fc_rot in (90, 270) else _fc_mb_h
     scale = (MM_PER_PT if opts.scale_to_mm else 1.0) * opts.user_scale
+    page_area_units = max(abs(_fc_mb_w * scale * page_h * scale), 1e-9)
 
     # Top-level group
     top_group = None
@@ -3183,6 +3287,23 @@ def flush_sub(close_flag: bool, _wires=wires_edges):
                     _apply_style(obj, stroke_rgb, fill_rgb, width, dashes, opts)
                     parent.addObject(obj)
                     obj_count += 1
+                    try:
+                        face_area = float(getattr(obj.Shape, "Area", 0.0) or 0.0)
+                    except (AttributeError, TypeError, ValueError):
+                        face_area = 0.0
+                    if _model3d_should_extrude(
+                        opts,
+                        is_closed=is_closed,
+                        fill=fill,
+                        face_area=abs(face_area),
+                        page_area=page_area_units,
+                    ):
+                        solid = _make_model3d_obj(edges, fc_doc=fc_doc)
+                        if solid is not None and _extrude_model3d_obj(solid, opts):
+                            _apply_style(solid, stroke_rgb, fill_rgb, width, dashes, opts)
+                            parent.addObject(solid)
+                            obj_count += 1
+                            opts._model3d_solids = int(getattr(opts, "_model3d_solids", 0) or 0) + 1
 
     # ── Flush remaining batched shapes ──
     if _batch_size:
@@ -3836,6 +3957,7 @@ def import_pdf(pdf_path: str, opts: Optional[ImportOptions] = None):
     _unit_scale = (MM_PER_PT if opts.scale_to_mm else 1.0) * opts.user_scale
     page_height_scaled = 792 * _unit_scale  # default: US Letter height in points
     page_heights_scaled: Dict[int, float] = {}
+    model3d_text_evidence: List[str] = []
     t_phase = time.perf_counter()
     try:
         from pdfcadcore.fitz_loader import PdfOpenError, safe_open
@@ -3849,10 +3971,29 @@ def import_pdf(pdf_path: str, opts: Optional[ImportOptions] = None):
             for p in pages:
                 if 1 <= p <= total_pages:
                     try:
-                        page_heights_scaled[p] = pdoc.load_page(p - 1).rect.height * _unit_scale
+                        _page_for_meta = pdoc.load_page(p - 1)
+                        page_heights_scaled[p] = _page_for_meta.rect.height * _unit_scale
+                        try:
+                            model3d_text_evidence.append(_page_for_meta.get_text("text") or "")
+                        except (RuntimeError, ValueError, AttributeError):
+                            pass
                     except (ValueError, RuntimeError):
                         pass
         opts.phase_timings_ms["open_pdf_ms"] = (time.perf_counter() - t_phase) * 1000.0
+        try:
+            from pdfcadcore.model3d_intent import analyze_model3d_intent
+
+            intent = analyze_model3d_intent(model3d_text_evidence, host_supports_3d=True)
+            opts._model3d_intent = intent.to_dict()
+            opts._model3d_intent_feasible = bool(intent.feasible)
+        except (ImportError, RuntimeError, TypeError, ValueError, AttributeError):
+            opts._model3d_intent = {
+                "feasible": False,
+                "plates": [],
+                "members": [],
+                "skipped_reason": "3D intent analysis unavailable",
+            }
+            opts._model3d_intent_feasible = False
     except PdfOpenError as e:
         _err(str(e))
         return

_LLM_CONTROL_PACK/QA/Q&A_INDEX.md

@@ -1,6 +1,32 @@
 # Q&A Index
 
-Updated: 2026-07-04 (Round 7 - SU v3.7.79 + Steel Logic v1.0.10; Reviewer O/P/Q)
+Updated: 2026-07-04 (Round 8 — PDF→3D optional extrusion + Q&A audit closure)
+
+---
+
+## Active session — Round 8 PDF→3D (2026-07-04)
+
+| File | Role |
+|------|------|
+| **`QA-2026-07-04_round8-pdf-to-3d-questions.md`** | Round 8 — Reviewer W: host scope, 3D semantics, eligibility, UI, report contract, Z-order research |
+| **`QA-2026-07-04_round8-pdf-to-3d-answers.md`** | Round 8 — Reviewer X answers W1–W7 + prior OPEN cross-answers |
+| **`QA-2026-07-04_round8-resolution.md`** | Round 8 — Agreements R8-1…R8-9 + phased implementation plan |
+| **`QA-2026-07-04_round8-sketchup-cli-images-app-pass/QA-2026-07-04_round8-sketchup-cli-images-app-pass.md`** | Round 8 earlier pass — CLI/images/app QA closure |
+| **`QA-2026-07-04_feature-parity-matrix.md`** | Updated parity audit incl. `model_3d`, `parts_bootstrap` stub |
+
+> **Round 8 PDF→3D status:** SU v3.7.80 ships optional extrude + `extra.model_3d`; LC honest 2D note; FC `parts_bootstrap` stub v4.0.59. FC/BL solid extrusion UI deferred Phase 2/3.
+
+---
+
+## Active session — Round 8 CLI/App pass (2026-07-04)
+
+| File | Role |
+|------|------|
+| **QA-2026-07-04_round8-sketchup-cli-images-app-pass/QA-2026-07-04_round8-sketchup-cli-images-app-pass.md** | Round 8 - implementation/QA closure: SketchUp direct CLI launch fix, embedded-image extraction verification, app import-report ingestion bridge, localization audit cleanup, website/corpus smoke QA |
+| **QA-2026-07-04_round8-sketchup-cli-images-app-pass/feature_matrix.md** | Cross-repo feature matrix regenerated after SketchUp CLI detection fix |
+| **QA-2026-07-04_round8-sketchup-cli-images-app-pass/feature_matrix.json** | Machine-readable feature matrix |
+
+> **Round 8 status:** tracked importer/app matrix coverage is 100%; automated tests are green. Remaining gates are host-app visual signoff and future Report Doctor UI integration.
 
 ---
 
@@ -12,9 +38,10 @@ Updated: 2026-07-04 (Round 7 - SU v3.7.79 + Steel Logic v1.0.10; Reviewer O/P/Q)
 | **QA-2026-07-04_round7-reviewer-p-answers.md** | Round 7 - Reviewer P answers to O-1..O-7 + prior OPEN cross-table |
 | **QA-2026-07-04_round7-reviewer-q-answers.md** | Round 7 - Reviewer Q cross-answers to O-1..O-7 (corpus T1-12, field test, Report Doctor) |
 | **QA-2026-07-04_round7-reviewer-n-questions.md** | Round 7 - Reviewer N questions (parallel lane) |
+| **QA-2026-07-04_round7-reviewer-r-answers.md** | Round 7 - Reviewer R cross-answers to N16-N19 + prior OPEN |
 | **QA-2026-07-04_round7-resolution.md** | Round 7 - Agreements R7-1..R7-11 + cross-answer matrix |
 
-> **Round 7 cross-answer matrix complete (O questions; P + Q answers).** R7-10 embedded-image corpus anchor **T1-12 SHIPPED**.
+> **Round 7 cross-answer matrix complete (O questions; P + Q + R answers).** R7-10 embedded-image corpus anchor **T1-12 SHIPPED**.
 
 ---
 

_LLM_CONTROL_PACK/QA/QA-2026-06-24_worker-status-log.md

@@ -1,3 +1,4 @@
+2026-07-04 22:30 UTC | WS-R8-3D | Round 8 PDF→3D + Q&A audit | SHIPPED | SU v3.7.80 optional Extrude to 3D + extra.model_3d; LC v1.0.53 honest 2D model_3d; FC v4.0.59 parts_bootstrap stub + build_model_3d_extra pdfcadcore; Round 8 W/X/R8 resolution; Reviewer R cross-answers to N16–N19; gates green. OPEN: T-01 human, R7-9 CLI merge, FC/BL extrude UI Phase 2/3.
 2026-07-04 18:00 UTC | WS-R6-P1b | Round 6 follow-up (ffb2f575) | SHIPPED | R6-8 source_provenance wired all hosts: LC v1.0.52 + BL v1.0.56 sidecar + extra.summary from text spans; SU v3.7.78 extra.source_provenance summary only (native label/3D text). OPEN T-01 only.
 2026-07-03 18:35 UTC | WS-T01-N | Anonymous Reviewer N | FIELD EVIDENCE | Owner T-01 screenshots (SU Make 2017, 1017 - Rev 0): BOM QUAN column digits render 90deg rotated; MARK/DESCRIPTION correct. PyMuPDF ground truth (extract probe, BOM page): ALL QUAN digits dir=(1.0,0.0) HORIZONTAL at x=1947-1955, rows y=135-334 (265pt span below QUAN header at y=69). Root cause: geometry_builder.rb prepare_bom_table_context 160pt window < 265pt table -> lower rows lose bom_table_row? -> label_angle_pdf line ~1196 tall-bbox fallback returns 90. NOTE to the session mid-fix (320pt window + failing test "BOM quantity 3 should stay horizontal (got 90.0)"): 320pt covers this sheet; also genuinely-rotated items on same page that MUST stay rotated: digits/marks at dir=(0,-1) e.g. w1023 at (1153.7,998.4), digit 2 at (1103.0,578.6), and two diagonal digits dir~(0.756,-0.655)=40.9deg at (1123.9,761.5)/(859.6,1155.2) - good negative-test fixtures. extract_page on this page: 1.1s/431 items (core extraction is not the big-PDF bottleneck; host entity creation is).
 2026-07-03 19:15 UTC | WS-T01-N | Anonymous Reviewer N | FIELD EVIDENCE | Owner T-01 round 2 (BL 5.1.2 + FC 1.1.1, 1017 + USGS Alvord topo): 4 defects filed in QA-2026-07-03_T01-field-report-BL-FC.md. BL-1 fat lineweights ROOT CAUSE: importer.py:161 scales paper-space line_width by geometry factor then bl_geometry_builder.py:177 bevel_depth - fix: paper-space mode default (cli --lineweight-mode exists, GUI ignores). BL-2 slow large files: per-batch curve objects flood depsgraph - merge per page+color+width. FC-1 dense dimension cluster spacing (313 16 class) - needs corpus vector first. FC-2 fill color lost ROOT CAUSE: only LineColor ever set (PDFImporterCore.py:878,3435), ShapeColor never assigned - green fills render default grey. Suggested claim order FC-2, BL-1, FC-1, BL-2. All need in-host before/after per rule 6.
@@ -6,3 +7,4 @@
 2026-07-04 15:00 UTC | WS-R6-S | Reviewer S + T | SHIPPED | Round 6 importer contract slice: actual_text_entity_types SU Ruby + Import Health; report_meta.build_stamp pdfcadcore+SU; cli_error_copy LC/BL; BL GUI redraw fix; FC CI corpus schema step. Versions SU 3.7.77, FC 4.0.57, LC 1.0.50, BL 1.0.54. Q&A: round6 S/T/resolution + feature-parity-matrix. OPEN: R4-1 vectors, T-01 visual retest, source_provenance, KettleTag app slice.
 2026-07-04 16:00 UTC | WS-R7-CLOSE | Round 7 gap sweep | SHIPPED | SU v3.7.79 + Steel Logic v1.0.10 on origin; Reviewer Q cross-answers (O-1..O-7); R7-10 T1-12 embedded_images_regression.pdf; SU CI fix ruby22 endless range in image_extractor. OPEN: T-01 visual, CLI merge P1, KettleTag loop.
 
+2026-07-04 18:20 UTC | WS-R8-N | Anonymous Reviewer N | VERIFIED+SHIPPED | QA sweep: Round 7 matrix complete + R7-1..R7-7 claims spot-verified REAL (T1-12 exists; SU embedded_image_extractor_test 3/12 green; app 237/237 incl scanner/deep-links; all 4 importer CIs green). OWNER FEATURE Round 8 opened (3D model generation): slice 1 SHIPPED - pdfcadcore/model3d_intent.py detects plate callouts (PL thickness) + rolled shapes (W/L/C/HSS/PIPE/WT + BOM lengths) w/ honest skipped_reason + 2D-host message; 7 tests vs real 1017 rows; FC 93f46c2 / LC 3614134 / BL 34dd1b6 pushed, suites 117/60/58 green ALL IN SYNC. Design doc QA-2026-07-04_round8-3d-model-generation.md: R8-A..R8-F host contracts (FC members first), AISC profile source decision R8-E blocks R8-A (propose corpus aisc_profiles.json from Steel Logic v16 CSV), corpus anchor R8-F spec, DONE criteria incl owner T-01 sign-off. Claim rows in answer docs.