Skip to content

Capability presentation: SAM as a platform, Part F/Part O flagship example (E01–E04, owner-approved; Q3 release gate met) - #3

Merged
michaldengusiak merged 11 commits into
mainfrom
docs/capability-presentation-p0
Oct 6, 2026
Merged

michaldengusiak merged 11 commits into
mainfrom
docs/capability-presentation-p0

Conversation

@SAM-BIM-AI

@SAM-BIM-AI SAM-BIM-AI commented Sep 10, 2026 •

Copy link
Copy Markdown
Contributor

Status: release gate satisfied — awaiting owner's final merge approval

This PR was held until the 2026-Q3 release was published. That gate is now met:

Gate State
2026-Q3 release published v20261006.1, published 2026-10-06, installer SAM_Install_v20261006.1.exe
Release source SAM_Deploy sow/2026-Q3 = 1bee804fa0d5a8c4e3b867705dbc579dbecc25a1
Owner review of E01–E04 Approved 2026-09-17 (comment on this PR)
Claims re-checked against the published release Done 2026-10-06 (below)
Checks All six Actions checks pass on head 628d89c

Not merged. Merge is the owner's decision. Target stays main, the GitHub Pages source for sambim.xyz.

What this PR does

Presents SAM as an open-source computational-engineering platform around a shared analytical model, with Part F → Part O as one flagship example. Section order: Platform → Capabilities → Workflow → Evidence → Research. Real evidence screenshots E01–E04 (provenance in assets/evidence/README.md); E04 is captioned as a TM59 fail (6 of 8 rooms). The compliance caveat ("A TM59 pass … not a Part O compliance certificate") is kept. Visual system: white ground, SAM blue accent, IBM Plex, no animation; page weight about 289 KiB.

Release-gate claim review (628d89c)

Re-checked against the v20261006.1 release notes and SAM_Deploy RELEASE_VALIDATION.md at the release commit.

Public claim Finding Action
"Progress record" link to SAM/blob/sow/2026-Q3/PROJECT_PROGRESS.md Dead (404). PROJECT_PROGRESS.md is internal and exists on no public Q3 or master branch Removed. Card now says only what is public: the core SAM regression suite runs in CI; links to the Test workflow
"Regression suites run at each merged milestone" (model, desktop-app, HVAC-systems, simulation) Only SAM core has a test workflow. SAM_UI, SAM_Systems and SAM_Tas have build CI only; no public record for the rest Narrowed to the core suite
"Installers checked on real Rhino 8/9 and Revit 2025–2027 hosts against a documented acceptance matrix" Too strong for the published installer. The release notes record CI build and payload verification plus manual smoke acceptance (Rhino, Grasshopper, Revit SAM add-in, Rhino.Inside.Revit) and say the H2–H11 matrix was not re-run. The matrix record shows Revit 2025 (H8) and the dedicated Revit 2027 energy path (H10) as owner-skipped for the Q3 candidate Replaced with what the release notes state, including that the matrix was not re-run; link now goes to the release notes
HOLD / evidence-slot wording Obsolete. Seven EVIDENCE/ARCHITECTURE/VIDEO SLOT HTML comments in index.html; matching PENDING rows and drop-in procedure in the evidence manifest and README Removed
Release version, installer, "Get SAM" / "Latest release" links releases/latest resolves to v20261006.1 (not a prerelease) No change
Rhino 8/9 and Revit 2025–2027 as supported hosts The installer pipeline builds Rhino 8/9 package payloads and Revit 2025/2026/2027 payloads Kept as supported-host statements; not presented as acceptance evidence
Part F / Part O / TM59 capabilities Present in the pinned release sources; technical-record links resolve No change
Other links, branding, URLs All 24 external hrefs return 200 (LinkedIn, ResearchGate, gnu.org excluded as before); sambim.xyz branding unchanged No change

Screenshots E01–E04 were captured on 2026-09-16 from a Release build of the sow/2026-Q3 tips, not from the published installer. The page says "2026-Q3 release line", which is accurate; it does not claim they are captures of v20261006.1.

Files changed in the release-gate commit

index.html, README.md, assets/evidence/README.md (4 insertions, 12 deletions in index.html; manifest and README tidied to match).

Checks (head 628d89c)

HTML validity, lychee, pa11y (WCAG2AA), cspell, Lighthouse budget and responsive screenshots: all pass. Local render at 1280 and 375 px: no horizontal overflow, no broken images. git diff --check clean.

Still open for the owner

  • Final merge approval.
  • The installer is unsigned (per release notes); the page does not mention it.
  • sitemap.xml lastmod is still 2026-07-20.

🤖 Generated with Claude Code

…t F -> Part O/TM59 workflow

- Restructure to Hero / Evidence / Flagship workflow / Platform / Engineering depth / Research-People-Contact
- Evidence section links only to public repository records (test freeze, H1-H12 acceptance, TM59 cross-check, Part F traceability)
- Four-step Part F -> Part O -> Tas -> TM59 workflow with E01-E04 slots; four-authority airflow separation explained
- Text platform architecture (D1 slot reserved); Grasshopper presented as host/adapter
- assets/evidence/ manifest for E01-E09, V1, D1 drop-in; placeholders never reference missing files
- Remove TM52/Part L and unvalidated claims; label OpenStudio/OCCT as in development
…n 3 as in progress

Evidence cards:
- Testing: drop the stale 2,114 / 771 / 90 / 91 counts (they were the
  Part O Iterations 1a-2B freeze of 2026-09-08, not a Q3 freeze, and have
  since moved); describe the suites and link the per-milestone record.
- Release acceptance: H1-H12 was run once, on the 2026-Q3 hardening
  candidate; say that instead of "every release candidate passes".
- Engine cross-check: scope the TM59-vs-Tas agreement to the one recorded
  validation flat and point at the record's open defects.
- Part F: scope to ADF Vol. 1 new dwellings with MVHR and the record's own
  calculated / geometry / manual / out-of-scope vocabulary.
- Installer: the Part F / Part O workflow is not in installers published
  before the 2026-Q3 release (latest public release v20260627.2 predates it).

Engineering depth:
- "Shipped" (released) -> "Validated" (merged on the 2026-Q3 release line
  with recorded evidence); add "In progress".
- Part O 1a-2B: frozen 2026-09-08; Iteration 2 acoustic/bypass/boost not
  implemented; open natural-ventilation items in the validation record.
- New Part O Iteration 3 card (SAM#111): foundation frozen and licensed-
  accepted, selected-product cooling module integrated, real-project run
  completes end to end and fails TM59; certified HR/fan data, the EDSL
  active-HR question and native Systems resultant temperature open.
- Psychrometrics: no reference-data validation suite exists in the repos;
  state the PsychroLib / IAPWS-IF97 basis instead.
- HVAC systems: drop unverified "automated scenario generation".
- SAM_OCCT: closed-shell creation/repair, matching its README.

Evidence manifest: replace "Nothing from the unfinished Part O Iteration 3
route" with evidence-backed capture rules; all E01-E09 / V1 / D1 remain
PENDING (searched 2026-09-16, no approved captures).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@SAM-BIM-AI SAM-BIM-AI changed the title DO NOT MERGE — P0 capability presentation (evidence screenshots pending human review) HOLD — P0 capability presentation (evidence E01–E04 pending; publish with 2026-Q3 release) Sep 16, 2026
@SAM-BIM-AI SAM-BIM-AI changed the title HOLD — P0 capability presentation (evidence E01–E04 pending; publish with 2026-Q3 release) DO NOT MERGE — HOLD: P0 capability presentation (E01–E04 pending; publish with 2026-Q3 release) Sep 16, 2026
SAM-BIM-AI and others added 5 commits September 16, 2026 22:27
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Presentation only. The approved six-section structure is unchanged.

- Editorial/technical visual system: white ground, dark type, SAM blue as
  the single accent, hairline structure instead of boxed bands, IBM Plex
  Sans/Mono, no gradients or motion beyond hover/focus.
- Hero leads with a full-width E01 screenshot. Flagship workflow becomes
  four numbered steps, each with a legible, full-width real screen.
- Four airflows shown as separate quantities with their authority,
  divided by "not equal" marks rather than arrows.
- Evidence, platform, engineering-depth, research and people sections
  restyled and tightened (about 15% less visible text). Caveats kept.
- The defensive "converter with engineering aspirations" line is gone.
- E01-E04 captured from a Release build of the sow/2026-Q3 tips, with a
  licensed Tas run of Part O Iteration 2 + 2B on the three-dwelling
  acceptance model. TM59 FAILs and is shown and captioned as a fail.
  Crop only; provenance is in assets/evidence/README.md.
- 32/64/180 px logo derivatives replace the 1 MB PNG for nav/favicon.
- Mobile menu and desktop nav fixed for current Chromium <details>.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Eager loading dropped Lighthouse performance from 90 to 83 (simulated
mobile LCP 3.8 s). Keep lazy loading; full-page CI screenshots will show
E03/E04 frames empty because that capture never scrolls.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@SAM-BIM-AI SAM-BIM-AI changed the title DO NOT MERGE — HOLD: P0 capability presentation (E01–E04 pending; publish with 2026-Q3 release) DO NOT MERGE — HOLD: capability presentation (E01–E04 captured, owner review; publish with 2026-Q3 release) Sep 16, 2026
Editorial review against the live site, the pre-closeout PR #3 and the
current records. The visual system and E01-E04 are unchanged.

- Hero defines SAM as an open-source computational-engineering platform
  around a shared analytical model; TM59 no longer defines it.
- Platform section moves up: the analytical model at the centre of
  hosts/exchange, engineering & systems, simulation adapters and results,
  with six "what makes it different" principles beside it.
- New capability map (six families: analytical modelling, BIM & geometry,
  building performance, HVAC & systems, simulation, automation), each
  linking its public repositories. Restores the breadth of the live site.
- Part F -> Part O framed as "one example of SAM in practice", with the
  model -> requirement -> design -> equipment -> simulation -> result chain.
- Four airflows presented as a general engineering principle.
- Removed programme detail from public copy: the Iteration 3 validated/open
  block, evidence gates, EDSL question, resultant-temperature bridge,
  tracker links, iteration numbering and status legend.
- Iteration 3 reconciled with the SAM#111 closeout at capability level:
  explicit Tas ventilation systems with selected-product cooling.
- Evidence cards shortened to one statement plus record link.
- Evidence manifest: slot locations and Iteration 3 rule updated.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@michaldengusiak

Copy link
Copy Markdown
Contributor

Owner review E01–E04: APPROVED.

I reviewed the website presentation and the E01–E04 evidence in context. The page looks strong and accurately represents SAM and the workflow. I am happy with the screenshots, captions and overall presentation for publication.

Keep this PR on HOLD until the 2026-Q3 release/installer is published. Future website improvements can be handled separately after release.

- Remove the dead internal PROJECT_PROGRESS.md link; the testing card now
  states only what is public (SAM core regression suite runs in CI) and
  links to that workflow.
- Release acceptance card: replace "real Rhino 8/9 and Revit 2025-2027
  hosts against a documented acceptance matrix" with what the v20261006.1
  release notes record (CI build + payload verification, manual smoke test
  in Rhino, Grasshopper, Revit add-in, Rhino.Inside.Revit; extended matrix
  not re-run). Link now points at the release notes.
- Remove unused EVIDENCE/ARCHITECTURE/VIDEO SLOT comments from index.html
  and the matching PENDING rows / drop-in procedure from the evidence
  manifest and README.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@michaldengusiak michaldengusiak changed the title DO NOT MERGE — HOLD: capability presentation (E01–E04 captured, owner review; publish with 2026-Q3 release) Capability presentation: SAM as a platform, Part F/Part O flagship example (E01–E04, owner-approved; Q3 release gate met) Oct 6, 2026
@michaldengusiak
michaldengusiak merged commit e50787c into main Oct 6, 2026
6 checks passed
@michaldengusiak
michaldengusiak deleted the docs/capability-presentation-p0 branch October 6, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants