Stamp gloop version + commit SHA into runs.jsonl and observe.jsonl entries
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
Problem
During the fishtank Big Fish experiment (2026-07-26), the driver's local gloop checkout was stale at 26a94a6 — one commit behind the merge of the observability feature (#47 / PR #48). The first three sessions of the experiment (design + two workers) therefore ran with no observe.jsonl instrumentation, and nothing in any artifact revealed this: runs.jsonl entries look identical regardless of which gloop built them. The gap was only caught by manually grepping the checkout for observe.jsonl after noticing the file was missing.
Proposal
Stamp the gloop version into every ledger entry:
- Add a
gloopfield to eachruns.jsonlandobserve.jsonlrecord: the package version plus the git SHA of the gloop checkout when available (e.g."gloop":"0.1.0+092223f"). - Print the same string in the startup banner.
This makes "which gloop produced this run" answerable from the ledger alone — the exact provenance question the experiment tripped over.
Acceptance
- Every new
runs.jsonl/observe.jsonlline carries the version+SHA field. - Version resolution degrades gracefully outside a git checkout (falls back to package version).
- Test covering ledger-entry shape.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Locate the code paths that write runs.jsonl and observe.jsonl, then inspect the startup-banner entry point and existing version handling. Add coverage for the ledger-entry shape and verify that every new line includes version and SHA when available, while falling back to the package version outside a git checkout.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- observability, tooling
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 67/100