Skip to content

Commit 704ec2f

Browse files
BlueCollarSys-0628BlueCollarSys-0628
committed
docs(qa): sync Round 8 audit closure and Round 5 restore [skip release]
1 parent dc3585d commit 704ec2f

7 files changed

Lines changed: 220 additions & 23 deletions

‎_LLM_CONTROL_PACK/QA/Q&A_INDEX.md‎

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,23 @@
11
# Q&A Index
22

3-
Updated: 2026-07-04 (Round 8 — PDF→3D optional extrusion + Q&A audit closure)
3+
Updated: 2026-07-04 (Round 9 — PDF-to-3D implementation closure + final verification sweep)
44

55
---
66

7-
## Active session — Round 8 PDF→3D (2026-07-04)
7+
## Active session — Round 9 PDF-to-3D closure (2026-07-04)
88

99
| File | Role |
1010
|------|------|
11+
| **`QA-2026-07-04_final-verification-sweep.md`** | Final verification sweep: import_contract_ready gap closure, final test counts, current-vs-historical OPEN status |
12+
| **`QA-2026-07-04_round8-closure-addendum.md`** | Audit verification — gate table, BL WIP fix, Round 5 restore, STILL OPEN ranked list |
13+
| **`QA-2026-07-04_round9-pdf-3d-implementation-closure.md`** | Round 9 — implementation closure: SU/FC/BL v1 3D generation, LC honest 2D, app + Report Doctor consumption, verification |
1114
| **`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 |
1215
| **`QA-2026-07-04_round8-pdf-to-3d-answers.md`** | Round 8 — Reviewer X answers W1–W7 + prior OPEN cross-answers |
1316
| **`QA-2026-07-04_round8-resolution.md`** | Round 8 — Agreements R8-1…R8-9 + phased implementation plan |
1417
| **`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 |
1518
| **`QA-2026-07-04_feature-parity-matrix.md`** | Updated parity audit incl. `model_3d`, `parts_bootstrap` stub |
1619

17-
> **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.
20+
> **Round 9 PDF→3D status:** SU, FC, and BL ship default-off v1 closed-region 3D generation; LC reports honest 2D unsupported status; all hosts emit `extra.model_3d` and `extra.model_3d_intent`; Steel Logic and Report Doctor consume both. Remaining gates: T-01 visual signoff, semantic AISC/member modeling, large-PDF speed work.
1821
1922
---
2023

@@ -26,7 +29,7 @@ Updated: 2026-07-04 (Round 8 — PDF→3D optional extrusion + Q&A audit closure
2629
| **QA-2026-07-04_round8-sketchup-cli-images-app-pass/feature_matrix.md** | Cross-repo feature matrix regenerated after SketchUp CLI detection fix |
2730
| **QA-2026-07-04_round8-sketchup-cli-images-app-pass/feature_matrix.json** | Machine-readable feature matrix |
2831

29-
> **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.
32+
> **Round 8/9 status:** tracked importer/app matrix coverage is 100%; automated tests are green. Remaining gates are host-app visual signoff and large-PDF performance tuning.
3033
3134
---
3235

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
2026-07-04 17:40 UTC | WS-R9-FINAL | Final QA verification sweep | VERIFIED+SHIPPED | Found and closed final concrete contract gap: shared Python import_report now emits extra.import_contract_ready for FC/BL/LC; FreeCAD tests cover ready and not-ready cases; feature matrix, Round 9 closure, Q&A index, and all QA mirrors updated. Verification green: FC 124 passed/1 skipped, FC focused 21 passed, BL 61 passed, LC 62 passed, SU parity 1/2 assertions + CLI 20 assertions passed, pdfcadcore ALL IN SYNC, app flutter test 238 passed, website node/static checks passed, corpus schemas/vectors passed. Current non-code-closable or next-scope items: T-01 human visual signoff, semantic AISC/member modeler, large-PDF performance tuning, SU headless geometry limitation, Scale-by-Reference parity.
2+
2026-07-04 23:15 UTC | WS-R8-AUDIT | Full Q&A audit + gate sweep | SHIPPED | Cross-answer matrix Y for R3–R8; restored 7 Round 5 files to Desktop; BL v1.0.58 commits Phase 3 mesh extrude (was uncommitted WIP); all gates green locally; releases SU 3.7.80 / FC 4.0.59 / LC 1.0.53 / BL 1.0.57 origin (BL 1.0.58 push pending). OPEN: T-01 human, R7-9 CLI merge, parts_bootstrap rows, R8-A semantic members.
3+
2026-07-04 16:51 UTC | WS-R9-3D | PDF→3D implementation closure | SHIPPED | SU in-host + CLI now emit model_3d_intent; FC default-off Auto/Extrude creates Part solids from eligible closed regions; BL default-off operator creates mesh solids; LC honest 2D report; shared Python core now emits extra.import_contract_ready; Steel Logic parses model_3d/model_3d_intent; Report Doctor renders both. Verification green: SU full Ruby suite + smoke/corpus placement (29 OK / 1 warn-only heavy timeout), FC 124 passed/1 skipped plus 21 report/model focused tests after import_contract_ready, BL 61 passed, LC 62 passed, pdfcadcore ALL IN SYNC, app flutter test 238 passed, website node/static checks passed, corpus schemas/vectors passed. OPEN: T-01 visual, semantic AISC/member modeling, large-PDF performance tuning, SU CLI host-geometry limitation.
14
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.
25
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.
36
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).
@@ -8,3 +11,4 @@
811
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.
912

1013
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.
14+
2026-07-04 19:05 UTC | WS-R9-N | Anonymous Reviewer N | VERIFIED+SHIPPED | Sweep: Round 8/9 closure claims verified REAL against disk - suites FC 122 / LC 62 / BL 61 / SU cli 20 + placement 130 all green; END-TO-END probe: live LC pdf2dxf run emits extra.model_3d (honest 2D block) + model_3d_intent (correctly infeasible on fraction PDF) + report_meta. All 5 CIs green (SU v3.7.80 / FC / LC v1.0.53 / BL v1.0.57 / corpus). COMPLETED unclaimed R8-E: corpus profiles/aisc_v16_profiles.json + generator (40ca70f pushed) - 2,299 imperial shapes / 3,038 lookup keys, dual nomenclature (HSS6X6X1/4==HSS6X6X.250, PIPE3STD->Pipe3SCH40), imperial column block extracted (v16 CSV duplicates headers with metric twin at col 84 - DictReader trap documented), sanity gates: >=2000 profiles + 1017 shapes must resolve. R8-A (FC semantic members: Part.Face profile -> extrude by BOM length, named by mark) NOW UNBLOCKED - claim it. Remaining open: T-01 owner visual sign-off; R8-B v2 leader-association (corpus vector first); BL-2 batching.

‎_LLM_CONTROL_PACK/QA/QA-2026-07-04_feature-parity-matrix.md‎

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Feature Parity Matrix — Code-Level Audit (2026-07-04, R8 update)
1+
# Feature Parity Matrix — Code-Level Audit (2026-07-04, R9 update)
22

33
Evidence: grep + file reads on `C:\1PDF-Importer-*` repos.
44

@@ -16,21 +16,23 @@ Evidence: grep + file reads on `C:\1PDF-Importer-*` repos.
1616
| `extra.performance_hint` | ✓ | ✓ | ✓ | ✓ | 50k entities / 1024 MB thresholds |
1717
| `performance.phases.total_ms` | ✓ | ✓ | ✓ | ✓ | |
1818
| `extra.actual_text_entity_types` | ✓ R6 | ✓ | ✓ | ✓ | shared builder |
19-
| `extra.model_3d` | ✓ R8 | ✓ report | ✓ honest 2D | ✓ report | SU extrude v3.7.80; LC `supported:false` |
20-
| `extra.model_3d_intent` | ✗ | partial | partial | partial | plate/member analysis module exists |
19+
| `extra.model_3d` | ✓ GUI+CLI report | ✓ Part solids | ✓ honest 2D | ✓ mesh solids | LC `supported:false`; SU headless CLI report-only |
20+
| `extra.model_3d_intent` | ✓ | ✓ | ✓ | ✓ | plate/member evidence scan; advisory eligibility gate |
2121
| `extra.source_provenance` | ✓ R7 | ✓ R6 | ✓ R6 | ✓ R6 | sidecar + summary |
2222
| `extra.parts_bootstrap` | ✗ | ✓ stub R8 | ✗ | ✗ | FC empty sidecar v4.0.59 |
23-
| `extra.import_contract_ready` | ✓ R7 | partial | partial | partial | SU stub |
23+
| `extra.import_contract_ready` | ✓ R7 | ✓ R9 | ✓ R9 | ✓ R9 | shared readiness aggregate; app/Report Doctor advisory |
2424

2525
---
2626

2727
## Optional 3D generation (R8)
2828

2929
| Capability | SU | FC | LC | BL |
3030
|------------|:--:|:--:|:--:|:--:|
31-
| Optional extrude UI | ✓ Advanced | OPEN P2 | N/A | OPEN P3 |
31+
| Optional extrude UI | ✓ Advanced | ✓ Workbench | N/A | ✓ Operator |
32+
| 3D solids generated | ✓ SketchUp pushpull | ✓ Part extrude | N/A | ✓ mesh prism |
3233
| Default off (additive) | ✓ | ✓ | ✓ | ✓ |
3334
| Honest unsupported report | N/A | N/A | ✓ | N/A |
35+
| `model_3d_intent` report | ✓ | ✓ | ✓ | ✓ |
3436
| Scale-by-Reference | ✗ | ✓ | ✗ | ✗ | FC-only; documented OPEN |
3537

3638
---
@@ -61,10 +63,11 @@ Evidence: grep + file reads on `C:\1PDF-Importer-*` repos.
6163
## Largest honesty gaps (not parity bugs)
6264

6365
1. **Visual fidelity** (color, lineweight, dimension spacing) — needs T-01 + golden rasters.
64-
2. **LibreCAD 3D** — architectural non-goal; report is honest.
65-
3. **FC/BL solid extrusion UI** — Phase 2/3 after SU proof.
66-
4. **SU CLI merge** — dual lane until contract parity (R7-9 OPEN).
66+
2. **Semantic steel solids** — exact AISC profile/member modeling by BOM mark/length remains the next advanced feature; current v1 is closed-region extrusion plus intent evidence.
67+
3. **LibreCAD 3D** — architectural non-goal; report is honest.
68+
4. **SU headless geometry** — CLI can analyze/report, but SketchUp host is required to create geometry.
69+
5. **SU CLI merge** — dual lane until contract parity (R7-9 OPEN).
6770

6871
---
6972

70-
*Audit snapshot — 2026-07-04 R8*
73+
*Audit snapshot — 2026-07-04 R9*

‎_LLM_CONTROL_PACK/QA/QA-2026-07-04_final-verification-sweep.md‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
# Final verification sweep (2026-07-04)
2+
3+
## Current result
4+
5+
The importer closure is verified through the current Round 9 documents, feature-parity matrix, and worker log. A final QA sweep found one concrete non-historical gap: the Python hosts were still marked partial for `extra.import_contract_ready`. That is now implemented in the shared Python report core and mirrored to FreeCAD, Blender, and LibreCAD.
6+
7+
## Concrete work completed in this sweep
8+
9+
| Item | Status |
10+
|---|---|
11+
| Python `extra.import_contract_ready` | Closed. FreeCAD/Blender/LibreCAD emit the shared readiness aggregate. |
12+
| FreeCAD readiness tests | Added ready and not-ready coverage. |
13+
| Feature parity matrix | Updated from partial to complete for Python hosts. |
14+
| Round 9 closure | Updated with shared Python core and final test counts. |
15+
| QA mirrors | Refreshed into all importer/app/website/corpus `_LLM_CONTROL_PACK/QA` folders. |
16+
17+
## Verification run
18+
19+
| Gate | Result |
20+
|---|---|
21+
| FreeCAD full pytest | 124 passed, 1 skipped, 1 warning. |
22+
| FreeCAD report/model focused pytest | 21 passed. |
23+
| Blender full pytest | 61 passed, 1 pytest cache warning, 10 subtests passed. |
24+
| LibreCAD full pytest | 62 passed, 1 pytest cache warning, 11 subtests passed. |
25+
| SketchUp report parity floor | 1 run, 2 assertions, pass. |
26+
| SketchUp CLI focused test | 20 assertions, pass. |
27+
| Shared pdfcadcore sync | `ALL IN SYNC`. |
28+
| Steel Logic app | `flutter test`: 238 passed. |
29+
| Website | `node --check report-doctor.js`; static metadata validation passed. |
30+
| Corpus contracts | 4 schemas valid. |
31+
| Corpus conformance vectors | 8 vectors; Python pass; SketchUp pass. |
32+
| Diff hygiene | `git diff --check` clean in touched repos; only line-ending/cache warnings. |
33+
34+
## Remaining items that are not code-closable in this sweep
35+
36+
| Item | Why still open |
37+
|---|---|
38+
| T-01 visual signoff | Requires human in-host viewport screenshots/inspection for alignment, lineweight, and color on real host installs. |
39+
| Semantic AISC/member modeler | Advanced feature beyond v1 closed-region extrusion; now unblocked by the AISC profile corpus but still needs its own design and corpus vectors. |
40+
| Large-PDF performance tuning | Still a performance backlog item. Next work should target batching/merge strategies, page-range UX, and host object creation costs without dropping geometry. |
41+
| SketchUp headless geometry | CLI can analyze/report, but actual SketchUp geometry creation requires SketchUp runtime. |
42+
| Scale-by-Reference parity | Still FC-only; non-blocking for Round 9 PDF-to-3D closure. |
43+
44+
## Historical QA note
45+
46+
Older Round 6/7/8 documents still contain `OPEN` rows because they are historical records. Treat the worker log top entry, Round 9 closure, and this final sweep as the current authoritative status unless a future QA document explicitly reopens an item.
47+

‎_LLM_CONTROL_PACK/QA/QA-2026-07-04_round8-closure-addendum.md‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# Round 8 closure addendum — audit verification (2026-07-04)
2+
3+
**Session:** Full Q&A audit (R3–R8), release verification, gate sweep, BL WIP resolution.
4+
5+
---
6+
7+
## Q&A audit
8+
9+
| Round | Cross-answer matrix | Gap fixed this session |
10+
|-------|---------------------|-------------------------|
11+
| R3 | **Y** — J/K complete; N supplement for J5–J6 | None |
12+
| R4 | **Y** — N questions; O + N cross-answers | None (archived) |
13+
| R5 | **Y** — N/P/Q/R complete | **Restored 7 Round 5 files** to authoritative Desktop folder (were only in repo mirrors) |
14+
| R6 | **Y** — S questions; T + S cross-answers | None |
15+
| R7 | **Y** — O questions; P + Q + R cross-answers | None (R added for N16–N19) |
16+
| R8 | **Y** — W questions; X cross-answers | None |
17+
18+
---
19+
20+
## Release verification (origin)
21+
22+
| Repo | Expected | Actual latest |
23+
|------|----------|---------------|
24+
| PDF-Importer-SketchUp | v3.7.80 | **v3.7.80** ✓ |
25+
| PDF-Importer-FreeCAD | v4.0.59 | **v4.0.59** ✓ |
26+
| PDF-Importer-LibreCAD | v1.0.53 | **v1.0.53** ✓ |
27+
| PDF-Importer-Blender | v1.0.57 | **v1.0.57** (v1.0.58 pending push — see below) |
28+
| Steel-Shapes | — | v1.0.11 |
29+
30+
---
31+
32+
## Gate sweep (local, 2026-07-04)
33+
34+
| Gate | Result |
35+
|------|--------|
36+
| SU check_su2017_ruby_compat | **PASS** |
37+
| SU ruby22_compat_test | **PASS** (3/3) |
38+
| SU smoke_test | **PASS** (57 checks) |
39+
| SU extrude_3d / model_3d_extruder / embedded_image / qa_report | **PASS** |
40+
| SU su_batch_cli (1017 Rev 0) | **PASS** (1/1) |
41+
| FC pytest | **PASS** (122, 1 skipped) |
42+
| FC pdfcadcore_sync + py_compile | **PASS** |
43+
| LC pytest + sync + preflight | **PASS** (62) |
44+
| LC pdf2dxf smoke | **PASS** (3093 entities, 0.47s) |
45+
| BL pytest + sync | **PASS** (61) — with committed + WIP model3d |
46+
| App flutter analyze | **PASS** |
47+
| App flutter test | **PASS** (238) |
48+
| Corpus validate_contract_schemas | **PASS** (4 schemas) |
49+
| Corpus conformance vectors | **PASS** (python + sketchup) |
50+
| Website validate_static_metadata | **PASS** (8 labels) |
51+
52+
---
53+
54+
## Work completed this session
55+
56+
| Task | Verdict | Version / SHA |
57+
|------|---------|---------------|
58+
| FC Phase 2 (Extrude to 3D UI) | **Already shipped** v4.0.59 | `dc3585d` |
59+
| BL Phase 3 (mesh extrude) | **Committed** — was WIP on disk despite v1.0.57 tag | **v1.0.58** (pending push) |
60+
| SU CLI merge R7-9 | **Still OPEN** — dual-lane intentional; not a small flag unify | — |
61+
| parts_bootstrap BOM rows | **Still OPEN** — stub only; extraction deferred | FC v4.0.59 |
62+
| Q&A Round 5 Desktop restore | **Fixed** | 7 files copied |
63+
| Q&A mirror sync | **Updated** | 6 repos |
64+
65+
---
66+
67+
## STILL OPEN (ranked)
68+
69+
1. **T-01 human visual signoff** — alignment, lineweight, color, BOM QUAN rotation (owner screenshots required).
70+
2. **Semantic AISC/member modeling (R8-A)** — corpus `aisc_v16_profiles.json` exists; FC Part profile extrude by mark+BOM length not yet implemented.
71+
3. **SU CLI merge (R7-9 / R8-9)** — `su_pdf_cli.rb` vs `su_batch_cli.rb` + in-ext `cli.rb`; contract test bar before deleting legacy lane.
72+
4. **parts_bootstrap row extraction (R5-2)** — stub sidecar shipped; BOM `tables[]` → rows still OPEN.
73+
5. **Large-PDF performance** — batching/merge strategies; no silent geometry drops.
74+
6. **KettleTag full loop (R5-1…R5-7)** — app multi-sprint; deferred per owner directive.
75+
7. **Scale-by-Reference parity** — FC-only; SU/LC/BL OPEN P2.
76+
8. **PE binary signing (R3-8)** — OPEN P1.
77+
78+
---
79+
80+
## Ready for advanced features?
81+
82+
**Yes for app planning and semantic steel modeling (R8-A); no for claiming 100% shop-floor visual accuracy until T-01 owner sign-off.**
83+
84+
*Addendum — 2026-07-04 audit session*

0 commit comments

Comments
 (0)