Skip to content

docs: installed-build samCommit/runnerCommit hold the SAM_Deploy revision (S06) - #16

Merged
michaldengusiak merged 2 commits into
sow/2026-Q4from
docs/s06-installed-build-provenance
Oct 20, 2026
Merged

michaldengusiak merged 2 commits into
sow/2026-Q4from
docs/s06-installed-build-provenance

Conversation

@michaldengusiak

@michaldengusiak michaldengusiak commented Oct 20, 2026 •

Copy link
Copy Markdown

S06: revision fields in installer builds (docs only)

This is the documentation part of roadmap S06's accepted provenance limitation (owner decision, 2026-10-20). No new stamping is implemented.

docs/benchmark/SCHEMA.md now states that a producer run from a SAM_Deploy installer build, without overrides, writes the SAM_Deploy build revision into samCommit and runnerCommit. It does not write the SAM or producer repository revision there. The reason is that every assembly is stamped <year>.<quarter>.<run>.0+<SAM_Deploy revision>.

The new section also covers:

  • Recovering the repository revisions from the pinned gitlinks: git ls-tree <SAM_Deploy revision> SAM SAM_Tas SAM_OpenStudio.
  • Telling an installed build apart by its stamp, the InformationalVersion <year>.<quarter>.<run>.0+<revision>. SAM_UI's run manifest records it under provenance.application: the full stamp in entryAssembly.informationalVersion and each components[].informationalVersion, and the extracted SHA in sourceRevision. sourceRevisionOf is explanatory text only. Head cb84fd9 wrongly said the stamp was in sourceRevisionOf; ed7a878 corrects this. The values were checked against the committed genuine-installer manifests in SAM_Deploy#66.
  • Older records keep their meaning. Developer runs that set SAM_COMMIT (S05 and earlier) hold repository revisions, and no historical value is redefined.
  • Scope. No schema version, validator or producer change. A field naming the revision kind, or per-repository stamping, would be a separate change.

Evidence: SAM-BIM/SAM_Deploy#66. The installed S06 candidate 717533c reported samCommit = runnerCommit = 717533c. Its gitlinks give SAM df27563b, SAM_Tas e84aeff6 and SAM_OpenStudio 1f4bf60c.

Record: docs/benchmark/S06-INSTALLED-PROVENANCE-PR.md.

Head Content Hosted CI
cb84fd9 first version Build (Windows) ✅ SAM_Validation run 39398892361, spdx ✅
ed7a878 (current) stamp-location correction Build (Windows) ✅ run 39403186623, spdx ✅ run 39403186462

Do not merge before owner approval. SAM_Deploy's SAM_Validation gitlink stays at 68eded00, because this change ships no binary.

🤖 Generated with Claude Code

…sion (S06)

Owner-accepted S06 limitation: document that SAM_Deploy installer builds
report the SAM_Deploy build revision in both fields, how to recover the
repository revisions from its gitlinks, and that existing records keep
their meaning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…st (S06)

Review fix: provenance.application.sourceRevisionOf is explanatory text.
The full stamp is in entryAssembly.informationalVersion and
components[].informationalVersion; sourceRevision holds the extracted
SHA. Verified against the committed genuine-installer manifests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@michaldengusiak
michaldengusiak merged commit e9a83df into sow/2026-Q4 Oct 20, 2026
2 checks passed
@michaldengusiak
michaldengusiak deleted the docs/s06-installed-build-provenance branch October 20, 2026 10:36
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.

1 participant