Skip to content

Sprint 1 RC#5

Merged
sooperD00 merged 12 commits into
mainfrom
wip/handoff
May 6, 2026
Merged

Sprint 1 RC#5
sooperD00 merged 12 commits into
mainfrom
wip/handoff

Conversation

@sooperD00
Copy link
Copy Markdown
Owner

Pre-tag verification — do not merge until v1.0.0 is tagged.

sooperD00 added 12 commits May 4, 2026 16:23
Four items surfaced during today's deploy testing that don't block the
v1 tag but want to be findable next time:

- §Housekeeping: script-mode discipline. New scripts/*.sh need
  chmod +x committed as mode 100755. Today's chart-behavior.sh
  permission-denied burned debug time on a fresh Mac checkout.
- §Housekeeping: Python upgrade coordination. .python-version, the
  Dockerfile's builder FROM, and distroless's bundled Python must
  agree. The ARG pattern centralizes the *string* but not the
  underlying coupling.
- §Sprint 3 Housekeeping: image-tag SHA discipline. Today's :dev
  tag mutation required helm uninstall + make deploy-local because
  helm saw an unchanged manifest. ArgoCD reconciliation +
  content-addressed image refs fix this naturally.
- §Sprint 3 Housekeeping: wire make smoke-test into post-deploy
  verification. Script already exits non-zero on failure; it's
  gate-ready when CI grows a deployed cluster (ArgoCD post-sync,
  kind-in-CI).

Plus a chart README callout (§MUST override): the empty-string
defaults aren't placeholders to fill in, they're the schema's
rejection trigger. Tooling that runs against bare defaults must
pass placeholders; scripts/check-chart-behavior.sh is the canonical
pattern.
Both halves of ADR-0011's contract enforcement now run in CI:

- chart-schema (uv, jsonschema): validates values.schema.json is
  well-formed and exercises known-good / known-bad inputs through the
  schema validator.
- chart-behavior (helm): runs helm lint + 3× helm template (1 known-
  good, 2 known-bad) to verify helm itself rejects const-pinned and
  required-field violations at template/install time.

Closes both [SPRINT-1-CLEANUP] markers in the Makefile that were
waiting for the corresponding ci.yml steps.

azure/setup-helm pinned by SHA per ADR-0012 (v5.0.0). Dependabot
tracks it automatically via the existing github-actions
package-ecosystem config (counter bumped 4 → 5 in the comment).

Chart enforcement now matches the local make deploy-local gate: any
chart change that breaks the schema or its enforcement fails CI
before landing on main.
CI's setup-uv step had no version: input, defaulting to whatever the
action shipped with at run time. Dockerfiles pinned at :0.5 (stale —
local install is 0.11.8). Picked one floor — 0.11 — and applied it
to all four sites: both workflow files (reusable + GridStream caller's
chart-schema job) and both Dockerfiles (prod + dev).

Convention documented in CONTRIBUTING.md 'Tool version pinning':
major.minor floor allows automatic patch updates while keeping
breaking bumps explicit. Same string resolves the same way in GHA
version: inputs and Docker :tag references — drift between the two
is the failure mode this prevents.

Closes the CI/local drift gap that would otherwise produce subtle
'works on my machine' diffs as uv evolves.
GHA's expression parser scans the entire workflow file for ${{ ... }}
syntax and validates it regardless of whether the expression is meant
as documentation or evaluation. The image-name input description used
':${{ github.sha }}' to illustrate what the build step concatenates,
but inside workflow_call.inputs the github context isn't available, so
the expression failed parsing and invalidated the whole file.

Replaced with ':<commit-sha>' placeholder. The actual github.sha
reference in the build step is unchanged (step-level context is fine).
GHA flagged Node 20 deprecation on today's CI run: forced switch to
Node 24 on June 2, 2026; full removal Sept 16. Several SHA-pinned
actions (checkout, setup-uv, docker/*) are still on Node 20. Existing
weekly Dependabot cadence already watches them, so this is a tickler
for sprint-review visibility, not new work.
@sooperD00 sooperD00 marked this pull request as ready for review May 6, 2026 21:23
@sooperD00 sooperD00 merged commit a4c8f65 into main May 6, 2026
4 checks passed
@sooperD00 sooperD00 deleted the wip/handoff branch May 6, 2026 21:26
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