Compare commits

...
11 Commits
Author SHA1 Message Date
hanzo-dev 5e0e4f906c hanzo-inc resolves to the KMS org it actually seals to
Hanzo CI/CD / cicd (push) Successful in 2m15s
CI/CD / gate (push) Successful in 2m15s
The owner -> KMS-org relation knew hanzoai, luxfi and zooai. hanzo-inc — pay
and the other company surfaces — fell through to the default branch and
became the literal owner, which is not a KMS org.

That was survivable by accident: the read takes its org from the TOKEN, so
the flat route still returned the right secret. What was wrong was the
fallback URL and, more expensively, every error message this step can print
— they named org=hanzo-inc, which sends whoever reads them looking for a
missing tenant rather than a missing credential.

One line, in the one place the comment above it already says this relation
belongs.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-05 14:40:56 -07:00
hanzo-dev f098b39ecd a documented example is not an expression to evaluate
Hanzo CI/CD / cicd (push) Successful in 46s
CI/CD / gate (push) Successful in 47s
`v1` has failed at load, on every caller in the fleet, since 0e1a56b. Not a
test failure — a startup failure: zero jobs, zero seconds, and GitHub showing
the file's PATH where its name should be, because it never got far enough to
read `name:`.

The `tests:` input's description quotes what a caller writes, and quoted it
literally:

    `tests: ${{ github.ref_type != 'tag' }}`

Prose or not, that is an expression, and it sits under `on.workflow_call.inputs`
where NO context exists. GitHub validates the whole file before it schedules
anything, refuses `github` there, and drops the run — so every repo importing
`hanzoai/ci@v1` stopped running CI entirely while reporting only a red X with
nothing inside it to read.

The irony is exact: 0e1a56b is titled "the test step has never run, and the gate
that would have said so never ran either." It made that true of every gate at
once.

Say it without the sigil. Same meaning to a reader, nothing to evaluate.
Confirmed with actionlint: clean at 23862e5c (before the break), the same error
at v1, v1.0.34 and v2, clean here.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-05 14:28:04 -07:00
hanzo-dev 674fabdcba split the server, do not strip a scheme you assumed
Hanzo CI/CD / cicd (push) Successful in 1m0s
CI/CD / gate (push) Successful in 1m0s
v1.0.33 built the forge substitution with `${SERVER#https://}`. GITHUB_SERVER_URL
on this fleet's runners is `http://hanzo-git.hanzo.svc` — the forge's in-cluster
address, plain http — so the strip matched nothing, passed the whole URL through,
and produced `https://http://hanzo-git.hanzo.svc/hanzoai/`. git then went looking
for a host called `http`:

  fatal: unable to access 'https://http://hanzo-git.hanzo.svc/hanzoai/authz/':
  Could not resolve host: http

Take the scheme and the host as the two values they are, and compare the HOST
against github.com so the guard cannot be fooled by a spelling either. Checked
against http/https, in-cluster and public, with and without a trailing slash
before pushing this time.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-05 06:34:42 -07:00
hanzo-dev 3f65c9e24f the test gate reaches our modules at the address they live at
Hanzo CI/CD / cicd (push) Successful in 1m43s
CI/CD / gate (push) Successful in 1m44s
The gate's first real execution died in `go vet`, before one test ran, on
`github.com/hanzoai/dashscopego v0.6.0` — an indirect dependency of
hanzoai/cloud that git.hanzo.ai serves and github.com answers `Repository not
found` for.

A module path is a NAME, not an address. This step authenticated to github.com
and only github.com, so on a forge runner it dialled the mirror instead of the
canonical host. Its own caller already knew better: cloud's `containment` and
`reach` jobs each make exactly this substitution, carrying a comment about the
nine consecutive releases that one sibling module's drifted GitHub ACL once
blocked. The gate that runs the tests reached the modules through a different
door, so the law was written twice and applied where it was not needed.

go.sum is what makes it safe rather than merely convenient: the forge serves the
same objects, so the fetched zip hashes to the h1: line already committed, and a
forge serving different bytes fails the build loudly instead of shipping them.

Owner-scoped and host-derived — `${{ github.repository_owner }}` against
GITHUB_SERVER_URL — so it is the same statement for any org on any forge, and a
no-op on github.com or without FORGE_TOKEN. Longest prefix wins in git, so every
other module still resolves from github.com exactly as before.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-05 06:31:02 -07:00
zeekayandhanzo-dev 8e43277aab sitedeploy self-provisions its project — first run no longer fails
Hanzo CI/CD / cicd (push) Successful in 1m10s
CI/CD / gate (push) Successful in 1m11s
Every never-before-deployed site died at the enqueue: POST /v1/projects/<slug>/deploy
404s when the project does not exist yet, so committing a workflow was never
enough — someone had to POST /v1/projects out of band first, holding a token most
sites' authors don't have. sitedeploy now creates the project itself before the
enqueue: idempotent (200/201 first run, 409 forever after), repo linked because
the git-source enqueue requires it, analytics on by default. A committed workflow
is now sufficient to stand a new site up. The plan/test seam sits above this, so
the 17 offline tests are untouched — verified green.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-04 18:54:01 -07:00
zeekayandClaude Fable 5 d3823df85a sitedeploy: one implementation of the Sites-plane publish
Hanzo CI/CD / cicd (push) Successful in 41s
CI/CD / gate (push) Successful in 42s
Every static surface on the estate was about to carry its own transcription of
enqueue → upload → complete: hanzo.ai, hanzo.app, hips, computer, and each one
after them. bin/imgver exists because that already happened once with image tags
— written eleven times, right ten times, and `sha-<short>` shipped for months.
This is that rule applied to the other half of the fleet.

The contract, once:

  POST /v1/projects/<slug>/deploy       -> 202 {id, bucket, prefix, upload}
  POST <upload.url> per object          -> the bytes, straight to S3
  POST .../deployments/<id>/complete    -> {status, files, bytes, keys}

The bytes never pass through the API: a real export is 128 MB against a 16 MiB
BodyLimit, so an artifact POST is refused by fasthttp before any handler runs and
fails as an opaque 400 that reads like a malformed payload rather than a size cap.

ONE credential. The 202 carries a presigned POST grant that is prefix-scoped
(S3 itself enforces starts-with $key), 30-minute, and size-bounded — so CI holds
no bucket key. Do not reintroduce SITES_S3_*: that was one long-lived key for a
bucket whose only tenant separation is the key prefix, so every repo holding it
could overwrite every org's site. Deletion moved server-side with it: `keys` is
the manifest cloud reconciles the prefix against, which is where
`aws s3 sync --delete` went, and both it and this script fail CLOSED on an empty
manifest rather than deleting a live site because a pipeline produced no lines.

Four defects found by running it end-to-end against hanzo.ai's real export
(8402 files, 105 MB, 54s) rather than by reading it:

  · the grant's `fields` already carries `key` — the starts-with PLACEHOLDER,
    not a destination. Forwarding it verbatim beside the real key posts `key`
    twice and S3 answers 400 for every object: 8402 files, 8402 failures.
  · `mapfile` is bash 4+; macOS ships 3.2, where it is `command not found`, the
    field array stays EMPTY, and the upload is rejected for a malformed
    X-Amz-Credential — an error pointing at the credential rather than at the
    array that was never built.
  · `[.\-_]` is how Go spells the fingerprint class; transcribed into `[[ =~ ]]`
    the backslash is literal inside a bracket expression, so it reads as the
    range \…_ and the shell rejects it. The `if` then merely evaluates false and
    every content-hashed asset silently loses `immutable`.
  · `stat -f%z || stat -c%s` cannot work: on GNU the first arm fails INSIDE a
    pipeline, awk still exits 0, the `||` never fires, and the byte count reports
    0. `wc -c` is the spelling both agree on.

Content-Type is sent per object because the policy carries no condition for it,
so what CI sends is what the object stores and what the edge serves — send
nothing and a browser downloads every page instead of rendering it. Cache-Control
mirrors cloud's apps/sites.CacheControlFor; sitedeploy_test.sh pins those exact
strings so the two cannot drift apart quietly.

Tests run offline: SITEDEPLOY_PLAN=1 stops before the first network call and
prints the manifest, so all 17 cases need no token, no bucket and no cluster.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-04 18:36:01 -07:00
zeekay b6b52b4a81 the gate runs before the image exists, not after it shipped
Hanzo CI/CD / cicd (push) Successful in 2m33s
CI/CD / gate (push) Successful in 2m32s
`Build & push images` sat above `test:`, guarded only by mode != delegate. So a
commit whose gates FAILED still published an image. Measured, not theorised:
hanzoai/base f9ec7067 pushed sha-f9ec706-amd64 on a run whose Test step then
went red, and hanzoai/id and hanzoai/base both show Build ahead of Test in every
run this week.

Deploy and Publish site already skip on a red gate, so nothing auto-shipped
those bytes. That is the reassuring half and also the trap: the TAG existed. A
tag in a registry is something a human pins by hand at 2am, and its existence
reads as a claim the commit passed. It did not. An artifact should not be
producible from a commit that failed its own gates — that is the same "green
that means nothing" this file spent the day removing, one step lower down.

Order is now toolchains -> Test -> Build -> Deploy. Nothing in Build depends on
the toolchains it now follows, and Deploy still follows Build, so the single
behavioural change is that a red gate produces no image at all.

Costs one thing worth naming: a repo with a broken Dockerfile and a slow suite
now waits for the suite before learning the build is broken. That is the right
trade — a late failure is cheaper than a false artifact.
2026-08-04 18:21:44 -07:00
zeekay 331e05625f push to registry.hanzo.ai by its own name, with a credential from KMS
Hanzo CI/CD / cicd (push) Successful in 2m34s
CI/CD / gate (push) Successful in 2m35s
THE 401 WAS NOT A WRONG REGISTRY. registry.hanzo.ai and oci.hanzo.ai answer the
SAME catalog behind the SAME token realm (iam.hanzo.ai/v1/iam/registry/token) —
measured, both hosts, byte-identical repository lists. They are one store with
two branded names, exactly as ~/work/CLAUDE.md describes.

What broke is narrower and stupider: docker keys credentials by HOSTNAME. This
workflow logged in to oci.hanzo.ai and pushed to whatever hanzo.yml named, so
the moment a repo repointed at the canonical registry.hanzo.ai the daemon had no
credential for that host and the push 401'd — against a registry it was already
authenticated to under its other name. So: log in to the canonical name.

CREDENTIAL FROM KMS, which is the rule and was the actual blocker. The step had
two sources, and for most repos neither fires: REGISTRY_USER/PASSWORD as GitHub
secrets (unset), else a kubeconfig read of the `registry-credentials` secret —
and the CI kubeconfig identity cannot read it (`ci-deploy-bot` grants
apps/deployments and replicasets, no secrets at all, and is bound to a service
account left over from the retired ARC). Measured consequence: the mirror step
logs "registry-credentials not readable from this kubeconfig" and MIRROR_OK is
never set, so registry.hanzo.ai holds cloud, commerce, iam, git — and NONE of
app, chat, gui, ui, design, sites, superbase, base. Those names answer
NAME_UNKNOWN. The names are now fetched from KMS beside S3_ADMIN_ACCESS_KEY,
which already works this way; the kubeconfig read stays as the fallback.

ONE NAMESPACE MAPPING, STATED ONCE. The GHCR org and the registry org are not
the same word, and the old line assumed they were —
`mrepo="oci.hanzo.ai/${repo#*/}"` mirrored ghcr.io/hanzoai/x to .../hanzoai/x.
The mapping is hanzoai->hanzo, zooai->zoo, everything else to itself:

  ghcr.io/hanzoai/chat      -> registry.hanzo.ai/hanzo/chat
  ghcr.io/zooai/app         -> registry.hanzo.ai/zoo/app
  ghcr.io/bootnode/node     -> registry.hanzo.ai/bootnode/node
  ghcr.io/lux-private/gpu   -> registry.hanzo.ai/lux-private/gpu

It lives in the push path itself so the table and the path cannot disagree —
two copies of a name mapping is how a pin and a push end up naming different
images. The ~30 repositories already mirrored under the old `hanzoai/` prefix
are left where they are; nothing pins registry.hanzo.ai yet (universe pins
ghcr.io), so they are orphaned mirror copies, not live references.

COREPACK_NPM_REGISTRY on the job. corepack fetches the pnpm/yarn tarball ITSELF
from registry.npmjs.org and does not read .npmrc to do it, so all 317 repos that
pin `packageManager` reach npmjs on every install however carefully their
registry is configured — the dependencies came from our mirror and the tool
fetching them did not. Set here for BYO runners; the git-runner fleet gets the
same value from its own config so jobs that never import this reusable are
covered too.
2026-08-04 17:57:07 -07:00
zeekay 44186bea06 conflictmarkers: the whole shape, not the first line of it
Hanzo CI/CD / cicd (push) Successful in 49s
CI/CD / gate (push) Successful in 48s
Shipped an hour ago matching a start marker alone, and hanzoai/app went red on
code that is perfectly fine. Its builder tests carry, as literal fixture data:

  <<<<<<< START_TITLE index.html >>>>>>> END_TITLE

Seven '<' and a space at column 1 — and not a merge conflict. Both markers sit
on ONE line, which is a shape git never writes.

So the gate now requires the whole conflict, in order, each part on its own
line: a start marker that does NOT also carry an end marker, a bare seven-equals
divider, and a separate end line. app's fixture fails the very first of those
and passes; a real conflict satisfies all three.

Proven against four cases before pushing, not after:

  base 42b97c9c types.d.ts  RED   23807 <<<<<<< HEAD / 23849 ======= /
                                  23850 >>>>>>> upstream/master
  app  format-pages.test.ts GREEN the fixture above
  synthetic git-shaped      RED   the exact bytes git writes on a conflict
  hanzoai/ci itself         GREEN including this file, which spells the
                                  markers out in prose, and a .rst heading
                                  underlined with seven equals signs

The divider is still only ever matched as part of that conjunction and never on
its own, because seven bare equals at column 1 is also how reStructuredText and
Setext Markdown underline a heading.

The lesson is the one this gate exists to teach, turned on itself: a check that
fires on a fragment of a pattern is not a cheap approximation of one that fires
on the pattern, it is a different check with a different, larger false-positive
surface — and the repo it fails first is the one that did nothing wrong.
2026-08-04 17:26:43 -07:00
zeekay 0e1a56bd3c the test step has never run, and the gate that would have said so never ran either
CI/CD / gate (push) Successful in 55s
Hanzo CI/CD / cicd (push) Successful in 55s
git.hanzo.ai resolves every `type: boolean` workflow_call input to false. Not
just an omitted one falling back to its default -- an explicitly passed `true`
resolves to false too. Measured in isolation (z/inputprobe runs 27365, 27382):

  type: boolean, default: true, caller omits it   -> inputs.tests = false
  type: boolean, caller passes with: {tests: true} -> inputs.tests = false
  type: string,  default: 'true', caller omits it  -> inputs.tests = true
  type: string,  default: '["hanzo-build-linux-amd64"]' -> resolves in full

So `if: inputs.mode != 'delegate' && inputs.tests` has been false on every run
this pipeline has ever served, and the `test:` block was parsed and skipped. On
2026-08-04 the last two cicd.yml runs of hanzoai/cloud, commerce, console,
gateway, hanzo.ai and this repo were all completed/success with
`Test (per hanzo.yml)` = skipped. Every test gate in the fleet was declared,
read, and never once executed -- a green over zero tests, which is the exact
failure the step's own assertion exists to refuse when a SUITE is empty, one
level up where nothing was watching.

tests: becomes a string compared against 'false'. A string sidesteps the forge
bug (proven above) and means the same thing on both planes, and comparing
against 'false' rather than testing truthiness keeps hanzoai/cloud's existing
`tests: ${{ github.ref_type != 'tag' }}` working untouched -- that expression
renders the strings "true"/"false".

The second half is what the first half was hiding. build-yml-is-one-file is a
`test:` gate, so it never ran either, and the two published copies had drifted
26 lines: .hanzo/workflows/build.yml -- the ONLY copy git.hanzo.ai executes --
was missing the Structural invariants step entirely. ignoretracked and modsize
have therefore never run on the plane that runs. The copies are one file again,
regenerated rather than hand-edited a second time, since hand-editing twice is
how the drift got in.

conflictmarkers joins that step, because it is the same defect class: `git add`
accepts a file still carrying git's own markers, and from then on they are
ordinary committed content -- status clean, diff empty, both sides of the merge
shipping. It hides in generated and vendored files that are large and
unreviewed, and no compiler objects: a .d.ts nothing imports is never parsed,
and in YAML, JSON and Markdown the markers are valid content. hanzoai/base has
carried `<<<<<<< HEAD` / `>>>>>>> upstream/master` at lines 23807 and 23850 of a
committed .d.ts. Proven red against that file and against a synthetic merge,
green on a clean tree, and it does not flag itself or a reStructuredText
underline -- the bare `=======` divider is deliberately not matched, because
seven equals signs at column 1 is also how RST and Setext underline a heading.
2026-08-04 17:05:54 -07:00
hanzo-dev 23862e5c44 two structural refusals: the repo must agree with itself
Hanzo CI/CD / cicd (push) Successful in 1m31s
CI/CD / gate (push) Successful in 1m32s
A day of production archaeology kept finding one defect class wearing
different clothes: a declaration and the reality it describes disagreeing,
with nothing in the pipeline holding an opinion about it. The framework
already refuses this shape in three places — zip refuses middleware that
wraps nothing, zipdoc refuses an op whose address it cannot resolve, Go
refuses a module past its zip ceiling. This lands the same principle for
two disagreements nothing was catching:

bin/ignoretracked — content the repo's OWN .gitignore matches but the index
still tracks. An ignore rule does not untrack what is already tracked, so
the bulk ships in every release while `git status` stays clean. The causal
story from the real outage is in the script header: the rule was removed at
12:22, 855 files landed at 12:51 inside the unguarded window, the rule came
back at 16:48. Every step was reasonable; the combined state shipped 361 MB
of orphaned cargo output in every release for 6 days.

bin/modsize — every Go module tree in the repo measured against Go's hard
500 MiB module-zip ceiling, nested modules separately. Past it, the module
is not merely large: `go get` fails in every consumer at every version that
carries it. cloud crossed at v1.801.416 and was unfetchable for nine
consecutive releases, which is why production sat pinned five releases back.

Wired as one early step in the reusable workflow, before anything builds or
pushes. Both FAIL the run — a warning nobody reads is the same silence one
level up.

Proof, not assertion: both RED against cloud@v1.801.424 (ignoretracked:
361.1 MB tracked-yet-ignored; modsize: 528.8 MiB, past the ceiling, nested
apps/platform/design measured separately at 0.2 MiB) and GREEN against the
repaired v1.801.440, hanzoai/iam, and this repo.

Scripts authored by the structural-guards lane; proofs re-run and wiring
added before landing. Callers pin @v1 — this activates when that tag moves.

Co-authored-by: Hanzo Dev <dev@hanzo.ai>
2026-08-04 16:13:28 -07:00
8 changed files with 1520 additions and 451 deletions
+60
View File
@@ -0,0 +1,60 @@
name: sitedeploy
description: Publish a built static export to the Hanzo PaaS Sites plane.
# For every repo whose deploy is "a static export goes live" — hanzo.ai, hanzo.app,
# hips, computer and the ones after them. Those were each about to carry their own
# copy of enqueue → upload → complete, which is how one contract becomes N
# transcriptions that drift (see the imgver action next door for the same story
# told about image tags).
#
# - uses: hanzoai/ci/.github/actions/sitedeploy@v1
# with: { slug: hanzo-ai, dir: out }
# env: { HANZO_DEPLOY_TOKEN: '${{ secrets.HANZO_DEPLOY_TOKEN }}' }
#
# A SITE IS NOT AN APP. This publishes files and stops: no image, no CR, no
# replicas, no registry. Building a container so a Go binary can serve /public is
# the shape the Sites plane exists to retire.
#
# ONE credential. The 202 hands back a prefix-scoped, 30-minute presigned POST
# grant, so CI never holds a bucket key — do NOT add SITES_S3_* here; that is the
# standing shared-bucket credential the grant replaced.
inputs:
slug:
description: The project slug on the Sites plane (POST /v1/projects/<slug>/deploy)
required: true
dir:
description: The built export directory
required: true
api:
description: Cloud API base
required: false
default: https://api.hanzo.ai
jobs:
description: Parallel uploads
required: false
default: '24'
runs:
using: composite
steps:
- name: Fetch sitedeploy
shell: bash
# The action ref is the script ref: an action pinned to @v1 runs v1's
# sitedeploy. Both forges, because this repo is served from each.
run: |
set -euo pipefail
ref="${GITHUB_ACTION_REF:-v1}"
for url in https://git.hanzo.ai/hanzoai/ci https://github.com/hanzoai/ci; do
git clone -q --depth 1 --branch "$ref" "$url" "$RUNNER_TEMP/sitedeploy-ci" 2>/dev/null && break
done
[ -x "$RUNNER_TEMP/sitedeploy-ci/bin/sitedeploy" ] \
|| { echo "::error::could not fetch hanzoai/ci@$ref (bin/sitedeploy)"; exit 1; }
- name: Deploy
shell: bash
env:
HANZO_API: ${{ inputs.api }}
SITEDEPLOY_JOBS: ${{ inputs.jobs }}
SITEDEPLOY_COMMIT: ${{ github.sha }}
SITEDEPLOY_BRANCH: ${{ github.ref_name }}
run: |
set -euo pipefail
bash "$RUNNER_TEMP/sitedeploy-ci/bin/sitedeploy" '${{ inputs.slug }}' '${{ inputs.dir }}'
+392 -217
View File
@@ -42,15 +42,41 @@ on:
tests:
description: >-
Run the `test:` block. Default true, and a caller should leave it that
way. false asserts that THIS EXACT COMMIT was already gated before this
way. 'false' asserts that THIS EXACT COMMIT was already gated before this
run — it does not mean "ship untested". The one shape that holds today
is hanzoai/cloud's release: clients/platform/release.go mints the v* tag
only after that SHA passed the gate on main AND built AND smoked, so the
tag build would re-test a commit already proven, at the cost of a
3108-package link storm. Passing false there runs the gate once instead
3108-package link storm. Passing 'false' there runs the gate once instead
of twice; passing it anywhere else runs it zero times.
type: boolean
default: true
STRING, NOT BOOLEAN, AND THAT IS LOAD-BEARING. git.hanzo.ai resolves
EVERY `type: boolean` workflow_call input to false — not just an omitted
one carrying a default, but an explicitly passed `true` as well. Measured
in isolation (z/inputprobe, runs 27365 and 27382): with `type: boolean,
default: true` and a caller that omits it, `inputs.tests` printed
`false`; a caller passing `with: {tests: true}` printed `false` too;
inverting the polarity to a `skip_tests` boolean printed `false` when
`true` was passed. String inputs in the SAME probe resolved correctly —
`mode` printed `buildx` and `runner` printed its full JSON array from
their declared defaults.
So for as long as this input was a boolean, `if: ... && inputs.tests` was
false on EVERY run, and the step below never executed. That is not a
hypothetical: on 2026-08-04 the last two `cicd.yml` runs of hanzoai/cloud,
commerce, console, gateway, hanzo.ai AND hanzoai/ci itself all reported
completed/success with `Test (per hanzo.yml)` = skipped. Every `test:`
block in the fleet was declared, was read, and had never once run — a
green over zero tests, which the step below exists specifically to refuse
when a SUITE is empty, and which had swallowed the whole gate.
A string sidesteps it on both planes with identical meaning, and the
comparison is against 'false' rather than a truthiness test so that the
expression callers already write — hanzoai/cloud's
`tests:` set from `github.ref_type != 'tag'`, which renders the strings
"true"/"false" — keeps working unchanged.
type: string
default: 'true'
submodules:
description: >-
Passed straight to actions/checkout. Default '' is checkout's own
@@ -78,6 +104,14 @@ permissions:
jobs:
cicd:
runs-on: ${{ fromJson(inputs.runner) }}
env:
# corepack fetches the pnpm/yarn TARBALL ITSELF from registry.npmjs.org,
# and it does not read .npmrc to do it — so 317 repos that pin
# `packageManager` reach out to npmjs on every install no matter how
# carefully their registry is configured. This is the one variable that
# closes that hole; without it "installs go through our registry" is true
# of the dependencies and false of the package manager fetching them.
COREPACK_NPM_REGISTRY: https://pkg.hanzo.ai
steps:
- uses: actions/checkout@v4
with:
@@ -120,6 +154,43 @@ jobs:
|| { echo "::error::could not fetch hanzoai/ci@${ref} (bin/imgver) from any host"; exit 1; }
echo "CI_HOME=$RUNNER_TEMP/ci" >> "$GITHUB_ENV"
- name: Structural invariants (the repo agrees with itself)
# Two cheap refusals, run before anything is built or pushed, for a
# defect class no later stage can see: a declaration and the reality it
# describes disagreeing in silence.
#
# ignoretracked — content the repo's OWN .gitignore matches but the
# index still tracks. An ignore rule does not untrack what is
# already tracked, so the bulk ships in every release while
# `git status` stays clean. hanzoai/cloud carried 361 MB this way
# for 6 days — past Go's 500 MiB module-zip ceiling, making nine
# consecutive releases unfetchable by every consumer.
# modsize — each Go module tree measured against that same ceiling,
# nested modules separately. Past it, `go get` fails everywhere
# with 'module source tree too large'; near it, this is the only
# warning anyone gets before the first consumer breaks.
# conflictmarkers — a merge that was committed unresolved. `git add`
# accepts a file that still carries git's own markers, and from then
# on they are ordinary content: status clean, diff empty, both sides
# of the merge shipping. It hides in generated and vendored files,
# which are large, rarely opened and effectively unreviewed —
# hanzoai/base carried `<<<<<<< HEAD` / `>>>>>>> upstream/master` at
# lines 23807 and 23850 of a committed .d.ts. No compiler catches it
# there: a .d.ts nothing imports is never parsed, and in YAML, JSON,
# Markdown and every config format we ship the markers are silently
# VALID content.
#
# Both proven RED against cloud@v1.801.424 (the real outage) and GREEN
# against the repaired tree before landing here. They read the checkout
# only — no network, subsecond on a healthy repo — and they FAIL the
# run rather than annotate it, because a warning nobody reads is the
# same silence one level up.
run: |
set -euo pipefail
"$RUNNER_TEMP/ci/bin/ignoretracked" .
"$RUNNER_TEMP/ci/bin/modsize" .
"$RUNNER_TEMP/ci/bin/conflictmarkers" .
- name: Provision parse toolchain (jq + PyYAML)
# This reusable parses the caller's hanzo.yml with python3 + PyYAML and
# slices JSON with jq. A minimal runner image
@@ -304,6 +375,15 @@ jobs:
if [ -z "$ORG" ]; then
case "${{ github.repository_owner }}" in
hanzoai) ORG=hanzo ;;
# hanzo-inc is the same TENANT as hanzoai — pay, commerce and the
# rest of the company surfaces bill and seal to KMS org `hanzo`.
# Without this line ORG fell through to the literal owner,
# "hanzo-inc", which is not a KMS org. That still LOOKED fine,
# because the read below takes its org from the TOKEN, not the URL
# — so the only things that were wrong were the fallback URL and
# every error message, which named an org that does not exist and
# sent the reader looking for a tenant instead of a credential.
hanzo-inc) ORG=hanzo ;;
luxfi) ORG=lux ;;
zooai) ORG=zoo ;;
*) ORG="${{ github.repository_owner }}" ;;
@@ -364,6 +444,18 @@ jobs:
# ask KMS twice.
SITE_DECL="$(yq -r '.site | type' hanzo.yml 2>/dev/null || echo '!!null')"
if [ -n "$(yq -r '.bucket // ""' hanzo.yml 2>/dev/null || true)" ] || [ "$SITE_DECL" = '!!map' ]; then
# The registry credential comes from KMS like every other secret —
# the ONLY things that live in GitHub are KMS_CLIENT_ID/SECRET.
# Named here so a repo with no kubeconfig (most of them) can still
# reach registry.hanzo.ai; the kubeconfig read below stays as the
# fallback for repos provisioned before these names existed.
for k in REGISTRY_USER REGISTRY_PASSWORD; do
v=$(get "$k")
if [ -n "$v" ]; then
[ "$k" = REGISTRY_PASSWORD ] && echo "::add-mask::$v"
echo "$k=$v" >> "$GITHUB_ENV"
fi
done
for k in S3_ADMIN_ACCESS_KEY S3_ADMIN_SECRET_KEY; do
v=$(get "$k")
if [ -n "$v" ]; then echo "::add-mask::$v"; echo "$k=$v" >> "$GITHUB_ENV"; fi
@@ -458,14 +550,20 @@ jobs:
echo "::notice::KMS GHCR token login failed — keeping the earlier login"
fi
- name: Native registry credential (oci.hanzo.ai)
- name: Native registry credential (registry.hanzo.ai)
if: inputs.mode != 'delegate'
env:
KUBECONFIG: ${{ steps.kms.outputs.kubeconfig }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
# KMS first (exported to GITHUB_ENV by the step above), GitHub secret
# second. `env:` here cannot see GITHUB_ENV from THIS step's own env
# block, so the KMS values are read out of the environment in `run:`.
GH_REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
GH_REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
run: |
set -uo pipefail
# REGISTRY_USER/PASSWORD may already be in the environment from KMS.
REGISTRY_USER="${REGISTRY_USER:-${GH_REGISTRY_USER:-}}"
REGISTRY_PASSWORD="${REGISTRY_PASSWORD:-${GH_REGISTRY_PASSWORD:-}}"
# Direct credential first (repo/org secret — works on private repos,
# where the Free plan hides org secrets... including these; private
# repos set them at REPO level). KMS-kubeconfig read is the fallback.
@@ -474,14 +572,14 @@ jobs:
# cred) must never fail the run — the image still pushes to GHCR, the
# primary. Without this guard, bash -e aborts the step and SKIPS the
# build entirely (a registry hiccup takes the whole lane red).
if echo "$REGISTRY_PASSWORD" | docker login oci.hanzo.ai -u "$REGISTRY_USER" --password-stdin; then
if echo "$REGISTRY_PASSWORD" | docker login registry.hanzo.ai -u "$REGISTRY_USER" --password-stdin; then
echo "MIRROR_OK=1" >> "$GITHUB_ENV"
else
echo "::notice::registry.hanzo.ai login failed — mirror skipped (GHCR-only push)"
fi
exit 0
fi
[ -z "${KUBECONFIG:-}" ] && { echo "::warning::no registry credential and no kubeconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0; }
[ -z "${KUBECONFIG:-}" ] && { echo "::warning::no registry credential and no kubeconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0; }
# Bare runners ship no kubectl — same static provision the deploy
# step uses.
command -v kubectl >/dev/null 2>&1 || {
@@ -492,218 +590,18 @@ jobs:
}
CFG=$(kubectl -n hanzo get secret registry-credentials -o jsonpath='{.data.\.dockerconfigjson}' 2>/dev/null | base64 -d || true)
if [ -z "$CFG" ]; then
echo "::warning::registry-credentials not readable from this kubeconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0
echo "::warning::registry-credentials not readable from this kubeconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0
fi
USERPASS=$(echo "$CFG" | jq -r '.auths["registry.hanzo.ai"].auth // empty' | base64 -d)
[ -z "$USERPASS" ] && { echo "::warning::no registry auth in dockerconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0; }
[ -z "$USERPASS" ] && { echo "::warning::no registry auth in dockerconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0; }
echo "::add-mask::${USERPASS#*:}"
# Best-effort: login failure → skip mirror, never fail the run (see above).
if echo "${USERPASS#*:}" | docker login oci.hanzo.ai -u "${USERPASS%%:*}" --password-stdin; then
if echo "${USERPASS#*:}" | docker login registry.hanzo.ai -u "${USERPASS%%:*}" --password-stdin; then
echo "MIRROR_OK=1" >> "$GITHUB_ENV"
else
echo "::notice::registry.hanzo.ai login failed — mirror skipped (GHCR-only push)"
fi
- name: Build & push images (per hanzo.yml)
if: inputs.mode != 'delegate'
env:
GH_PAT: ${{ secrets.GH_PAT }}
run: |
set -euo pipefail
# Test-only callers (hanzo.yml without `images:` — e.g. a repo whose
# image lane lives in its own release.yml, or a pure library) skip the
# build step entirely instead of exploding on a null .images.
if [ "$(yq -r '.images // [] | length' hanzo.yml 2>/dev/null || echo 0)" = "0" ]; then
echo "::notice::no images: in hanzo.yml — test-only caller, skipping build"; exit 0
fi
# Build-time private cross-org Go module read (the buildx `gh_token`
# secret): prefer the KMS-fetched GIT_TOKEN, else fall back to the org
# GH_PAT — the SAME BuildKit gh_token cloud's release.yml uses (proven
# working). Keeps image builds green when the KMS deploy-cred fetch is
# unavailable (a repo with a private cross-org dep like hanzoai/cloud
# otherwise fails `go mod tidy` with git exit 128 in the buildx stage).
# No-op for public-only builds when both are empty. Exported so the
# `--secret id=gh_token,env=GIT_TOKEN` below reads it from the env.
export GIT_TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
SHORT=$(echo "${{ github.sha }}" | cut -c1-7)
IS_TAG=$([ "${{ github.ref_type }}" = "tag" ] && echo 1 || echo 0)
REL="${{ github.ref_name }}" # the git tag, verbatim: v1.26.19
VER="${REL#v}" # v-stripped alias: 1.26.19
yq -o=json -I=0 '.images' hanzo.yml | jq -c '.[]' | while read -r img; do
name=$(echo "$img"|jq -r .name); ctx=$(echo "$img"|jq -r .context)
df=$(echo "$img"|jq -r '.dockerfile // (.context+"/Dockerfile")'); repo=$(echo "$img"|jq -r .repo)
# tag-suffix is OPTIONAL (most repos ship a single variant). When set
# (e.g. "ce"/"ee") it qualifies every tag; when absent the tags are
# clean (no trailing dash). Build + deploy must agree on this shape.
sfx=$(echo "$img"|jq -r '."tag-suffix" // ""')
# platforms is OPT-IN per image in hanzo.yml (default: amd64 only, so
# every existing repo's tag shape "-amd64" is UNCHANGED). Set e.g.
# platforms: [linux/amd64, linux/arm64]
# to emit a multi-arch MANIFEST LIST — one digest serving both arches.
# DOKS has no arm64 nodes, so arm64 builds via buildx QEMU emulation
# (binfmt set up below); pure-Go (CGO_ENABLED=0) Dockerfiles that honor
# $TARGETARCH cross-compile natively (fast, no emulation). For true
# native-speed arm64, register a bare-metal arm64 host (spark/GB10) as
# the hanzo-build-linux-arm64 self-hosted runner (values-build-arm64.yaml).
plats=$(echo "$img"|jq -r '(.platforms // ["linux/amd64"]) | join(",")')
# ---- Refuse a Go builder older than the module it compiles -------
# The official golang images set GOTOOLCHAIN=local, so a go.mod
# requiring a newer Go than the base image does not degrade — it
# dies mid-build with "go.mod requires go >= X (running Y;
# GOTOOLCHAIN=local)". hanzoai/visor v1.108.16 is the shipped
# instance, and it is invisible before the image build: every local
# `go build` succeeds because a dev box runs GOTOOLCHAIN=auto and
# just downloads what the module asks for. So the break is
# introduced by editing go.mod — a file with nothing to do with
# Docker — and found by a red release build.
#
# It is not one repo's problem either: a sweep of every Dockerfile
# across the orgs found 54 below their own go.mod in 23 repos, and
# only 7 of 223 Go builder stages set GOTOOLCHAIN=auto. Fixing those
# fixes today; this line is what makes the 55th impossible.
#
# Checked here, before any build work, so the run fails in seconds
# rather than after binfmt, a version derivation and a layer cache.
"$CI_HOME/bin/gover" "$df" "$ctx"
# ---- The semver this build publishes ----------------------------
# A branch build used to publish sha-<short7> and nothing else, so an
# image only earned a version when a human remembered to cut a git
# tag. That is the whole reason 14 of the fleet's 117 pins named a
# commit instead of a release: not drift, just the only tag CI ever
# offered them. Every build now publishes a version too, and the
# sha- tag stays beside it for forensics.
#
# The number is DERIVED, never typed, by bin/imgver — the ONE
# implementation, shared with the hand-rolled
# .hanzo/workflows/deploy.yml that 11 repos carry instead of importing
# this workflow (see .github/actions/imgver). Written twice it would be
# right twice and then wrong once, which is exactly how `sha-<short>`
# became the only tag those repos ever published. Read that script for
# the rule; it is monotonic against the repo's manifest AND the
# registry, so one tag can never cover two digests.
ver=""
if [ "$IS_TAG" = 1 ]; then
# Release build: the git tag IS the version. Identity in, identity
# out — deriving here would publish a number nobody asked for.
:
else
# An explicit `version:` on the image entry wins over the repo-wide
# one; both are optional, and imgver falls back to the manifest.
iv=$(echo "$img"|jq -r '.version // ""')
[ -z "$iv" ] && iv=$(yq -r '.version // ""' hanzo.yml)
ver=$(IMGVER_VERSION="$iv" "$CI_HOME/bin/imgver" "$repo" "$ctx")
fi
if [ "$plats" = "linux/amd64" ]; then
# single-arch: keep the exact legacy tag shape (-amd64) deploys expect.
TAGS="-t $repo:sha-${SHORT}-amd64${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
else
# multi-arch: one arch-neutral manifest-list tag (no -amd64 suffix).
docker run --privileged --rm tonistiigi/binfmt --install arm64 >/dev/null 2>&1 || true
TAGS="-t $repo:sha-${SHORT}${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
fi
# Release (tag) build. The git tag IS the release name, so publish it
# VERBATIM (v1.26.19) — that is the shape a universe CR pins, and
# stripping the v is why releases were finished by hand-`crane copy`ing
# sha-<sha7> onto the semver a human typed. Identity in, identity out.
# The v-stripped alias stays for CRs already pinned that way (world
# 2.4.51), and is skipped when a repo tags without a v. The old
# `<ver>-amd64` alias is deleted: no CR in the fleet pinned it.
if [ "$IS_TAG" = 1 ]; then
TAGS="$TAGS -t $repo:${REL}${sfx:+-$sfx}"
[ "$REL" != "$VER" ] && TAGS="$TAGS -t $repo:${VER}${sfx:+-$sfx}"
else
# The tag universe is meant to PIN. It goes on every build, not
# only the ones somebody remembered to tag by hand.
TAGS="$TAGS -t $repo:${ver}${sfx:+-$sfx}"
fi
echo "::group::build $name → $repo (${sfx}) [$plats]"
# --build-arg assembly: static hanzo.yml `args` (a fixed value, e.g. a
# pinned base image tag) + `build_secrets` (KMS values the KMS step
# exported into the env above). Empty when a repo declares neither, so
# the buildx line is unchanged for every existing repo.
BUILD_ARGS=""
while IFS= read -r kv; do [ -n "$kv" ] && BUILD_ARGS="$BUILD_ARGS --build-arg $kv"; done \
< <(echo "$img" | jq -r '(.args // {}) | to_entries[] | "\(.key)=\(.value)"')
for bs in $(echo "$img" | jq -r '(.build_secrets // [])[]'); do
v=$(printenv "$bs" 2>/dev/null || true)
# Defense in depth: the KMS step above already refuses to continue
# with an unresolved build_secret, so reaching here empty means the
# two steps disagree. Stop rather than bake a blank credential.
[ -z "$v" ] && { echo "::error::build_secret $bs is unset at build time — refusing to bake an empty value"; exit 1; }
BUILD_ARGS="$BUILD_ARGS --build-arg $bs=$v"
done
# PROVENANCE: which commit are these bytes. Passed BOTH ways on
# purpose. The --label sets it from outside for any Dockerfile; the
# --build-arg feeds `ARG REVISION` for the Dockerfiles that stamp the
# label themselves (hanzoai/cloud declares `ARG REVISION=unknown`,
# and `unknown` is exactly what every image built without this said).
#
# An unlabelled image cannot be traced to source, and that stops being
# cosmetic the moment two builders race for one tag: with one image
# labelled and the other reading `unknown`, "which of these is the
# release" had no answer short of diffing layers — while the wrong one
# was already pinned. A version is a receipt only if the image can
# name its own commit, so every image this fleet publishes now can.
#
# A Dockerfile with no `ARG REVISION` ignores the build-arg (buildkit
# warns, never fails), so this is a no-op for every repo that has not
# asked for it.
PROV="--build-arg REVISION=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.revision=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.version=${ver:-$REL}"
PROV="$PROV --label org.opencontainers.image.source=https://github.com/$GITHUB_REPOSITORY"
# GIT_TOKEN (from KMS, via GITHUB_ENV) is passed as the `gh_token`
# BuildKit secret so Dockerfiles can clone private Go modules; omitted
# cleanly when absent (public-only builds unaffected).
docker buildx build --platform "$plats" $BUILD_ARGS $PROV ${GIT_TOKEN:+--secret id=gh_token,env=GIT_TOKEN} --push $TAGS -f "$df" "$ctx"
# The semver is the tag the fleet PINS, so prove it exists before the
# run goes green — buildx can exit 0 while the manifest is not yet
# resolvable, and a pin onto a phantom tag is an ImagePullBackOff.
# The digest is printed with it because universe pins repo:tag@digest
# and the kubelet honours the DIGEST: publishing both here is what
# lets the two move together instead of being looked up separately
# and drifting apart.
pin="$repo:${ver:-$REL}${sfx:+-$sfx}"
for i in 1 2 3 4 5 6; do
dig=$(docker buildx imagetools inspect "$pin" --format '{{.Manifest.Digest}}' 2>/dev/null || true)
[ -n "$dig" ] && break
sleep 5
done
[ -n "$dig" ] || { echo "::error::$pin not resolvable after push"; exit 1; }
echo "| \`$pin\` | \`$dig\` |" >> "$RUNNER_TEMP/pins.md"
# Dual-host: mirror the exact tag set to registry.hanzo.ai (server-
# side manifest copy — no rebuild). ghcr.io/<org>/<name> →
# oci.hanzo.ai/<org>/<name>; public consumers keep ghcr, the fleet
# is migrating to pull from ours. A skip here is now a WARNING, not
# a notice: an image that never reaches our registry is the reason
# a deploy still depends on GitHub, and that should be visible in
# the run, not buried.
if [ "${MIRROR_OK:-}" = "1" ]; then
# crane, not buildx imagetools: the IAM token realm doesn't answer
# buildx's multi-scope token request (spec gap, tracked).
command -v crane >/dev/null 2>&1 || {
mkdir -p "$HOME/.local/bin"
curl -fsSL https://github.com/google/go-containerregistry/releases/download/v0.20.2/go-containerregistry_Linux_x86_64.tar.gz \
| tar -xz -C "$HOME/.local/bin" crane
export PATH="$HOME/.local/bin:$PATH"
}
mrepo="oci.hanzo.ai/${repo#*/}"
echo "$TAGS" | tr ' ' '\n' | grep -v '^-t$' | grep -v '^$' | while read -r ref; do
crane copy "$ref" "${mrepo}:${ref##*:}" \
|| echo "::warning::$ref did not reach oci.hanzo.ai (ghcr push unaffected)"
done
fi
echo "::endgroup::"
done
# The pins this run earned, ready to paste into universe. Tag and
# digest are printed TOGETHER because they are one fact: the failure
# this prevents is a new tag landing beside an old digest, which
# reports the new version on the pod and serves the old bytes.
if [ -s "$RUNNER_TEMP/pins.md" ]; then
{ echo "### Pins"; echo; echo "| image | digest |"; echo "|---|---|";
cat "$RUNNER_TEMP/pins.md"; } >> "$GITHUB_STEP_SUMMARY"
fi
- name: Provision Go toolchain (go test gates on bare runners)
# hanzo.yml `test:` gates (e.g. `go vet ./...`, `go test ...`) run
# DIRECTLY on the runner, NOT inside a build container — but the stock
@@ -950,16 +848,72 @@ jobs:
# unset) — so `go vet` dies with `could not read Username for github.com`.
# Reuse the SAME token here for the runner's git (GIT_TOKEN, set by the
# KMS step above; GH_PAT fallback). No-op when neither is present.
#
# AND OUR OWN MODULES RESOLVE FROM OUR OWN FORGE. A module path is a NAME,
# not an address: `github.com/<owner>/x` is what the package is called, and
# which host git dials for it is a separate decision. On a forge runner
# that decision is the forge — the forge is where the code canonically
# lives, and github.com is fed by a mirror that trails it, sometimes by
# hours and sometimes not at all.
#
# Measured, on the first run in which this step's gate had ever actually
# executed: hanzoai/cloud's go.mod carries `github.com/hanzoai/dashscopego
# v0.6.0` as an indirect dependency. git.hanzo.ai serves it; github.com
# answers `Repository not found`. So `go vet` died before a single test
# ran, on a module that was never missing. Its own caller already knew the
# answer — cloud's `containment` and `reach` jobs each make this exact
# substitution, with a comment about the nine consecutive releases an
# ACL drift on ONE sibling module once blocked — but the gate that runs
# its tests reached the modules through a different door.
#
# go.sum is what makes this safe rather than merely convenient: the forge
# serves the same objects, so the fetched zip hashes to the h1: line
# already committed. A forge serving different bytes fails the build
# loudly instead of shipping them.
#
# Longest prefix wins in git, so the owner-scoped forge rule outranks the
# bare github.com rule beneath it and every OTHER module still resolves
# from github.com. Both rules are optional and independent: no FORGE_TOKEN
# (or a github.com-hosted run, where the server IS github.com) leaves the
# old behaviour exactly as it was.
#
# SPLIT THE SERVER, do not strip a scheme you assumed. GITHUB_SERVER_URL
# on this fleet's runners is `http://hanzo-git.hanzo.svc` — the forge's
# in-cluster address, plain http — and a `${SERVER#https://}` that only
# knows the https spelling passes it through whole, producing
# `https://http://hanzo-git.hanzo.svc/...` and a git that resolves the host
# `http`. Take the scheme and the host as the two values they are, and
# compare the HOST against github.com so the guard cannot be fooled by a
# spelling either.
if: inputs.mode != 'delegate' && hashFiles('go.mod') != ''
env:
GH_PAT: ${{ secrets.GH_PAT }}
FORGE_TOKEN: ${{ secrets.FORGE_TOKEN }}
OWNER: ${{ github.repository_owner }}
run: |
set -uo pipefail
TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
if [ -z "$TOKEN" ]; then echo "no git token — public modules only"; exit 0; fi
CFG="$RUNNER_TEMP/gitconfig-go-test"; : > "$CFG"
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."https://x-access-token:${TOKEN}@github.com/".insteadOf "https://github.com/"
SERVER="${GITHUB_SERVER_URL:-https://github.com}"
SCHEME="${SERVER%%://*}"; HOST="${SERVER#*://}"; HOST="${HOST%/}"
wrote=0
if [ -n "${FORGE_TOKEN:-}" ] && [ "$HOST" != "github.com" ]; then
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."${SCHEME}://x:${FORGE_TOKEN}@${HOST}/${OWNER}/".insteadOf \
"https://github.com/${OWNER}/"
echo "${OWNER}/* modules resolve from ${SCHEME}://${HOST}"
wrote=1
fi
TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
if [ -n "$TOKEN" ]; then
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."https://x-access-token:${TOKEN}@github.com/".insteadOf "https://github.com/"
echo "github.com modules authenticated"
wrote=1
fi
[ "$wrote" = 1 ] || { echo "no git credential — public modules only"; exit 0; }
{ echo "GIT_CONFIG_GLOBAL=$CFG"; echo "GIT_CONFIG_NOSYSTEM=1"; } >> "$GITHUB_ENV"
echo "runner git authenticated for private Go modules"
@@ -982,7 +936,7 @@ jobs:
# it ran nothing AND nothing shows as having run. A gate that is not a test
# gate — vet, lint, a build, a codegen-freshness check — says neither and is
# untouched. To silence it legitimately, make the gate run a test.
if: inputs.mode != 'delegate' && inputs.tests
if: inputs.mode != 'delegate' && inputs.tests != 'false'
run: |
set -euo pipefail
NOTHING='\[no test files\]|\[no tests to run\]|no tests ran|collected 0 items|No tests found|no test specified|running 0 tests|Tests:[[:space:]]+0 total|(^|[^0-9])0 (passing|passed)'
@@ -1011,6 +965,227 @@ jobs:
fi
done
- name: Build & push images (per hanzo.yml)
# AFTER the gate, deliberately. This step used to run before `test:`,
# so a repo whose gates FAILED still published an image: hanzoai/base
# f9ec7067 pushed sha-f9ec706-amd64 on a run whose tests then went red.
# Deploy and Publish site were skipped, so nothing shipped it — but the
# tag existed, and a tag that exists is something a human pins by hand.
# An artifact is a claim that the commit passed; it should not be
# possible to produce one from a commit that did not.
#
# Nothing here needs the toolchains above it, and Deploy still follows
# this step, so the only thing the move changes is that a red gate now
# produces no image at all.
if: inputs.mode != 'delegate'
env:
GH_PAT: ${{ secrets.GH_PAT }}
run: |
set -euo pipefail
# Test-only callers (hanzo.yml without `images:` — e.g. a repo whose
# image lane lives in its own release.yml, or a pure library) skip the
# build step entirely instead of exploding on a null .images.
if [ "$(yq -r '.images // [] | length' hanzo.yml 2>/dev/null || echo 0)" = "0" ]; then
echo "::notice::no images: in hanzo.yml — test-only caller, skipping build"; exit 0
fi
# Build-time private cross-org Go module read (the buildx `gh_token`
# secret): prefer the KMS-fetched GIT_TOKEN, else fall back to the org
# GH_PAT — the SAME BuildKit gh_token cloud's release.yml uses (proven
# working). Keeps image builds green when the KMS deploy-cred fetch is
# unavailable (a repo with a private cross-org dep like hanzoai/cloud
# otherwise fails `go mod tidy` with git exit 128 in the buildx stage).
# No-op for public-only builds when both are empty. Exported so the
# `--secret id=gh_token,env=GIT_TOKEN` below reads it from the env.
export GIT_TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
SHORT=$(echo "${{ github.sha }}" | cut -c1-7)
IS_TAG=$([ "${{ github.ref_type }}" = "tag" ] && echo 1 || echo 0)
REL="${{ github.ref_name }}" # the git tag, verbatim: v1.26.19
VER="${REL#v}" # v-stripped alias: 1.26.19
yq -o=json -I=0 '.images' hanzo.yml | jq -c '.[]' | while read -r img; do
name=$(echo "$img"|jq -r .name); ctx=$(echo "$img"|jq -r .context)
df=$(echo "$img"|jq -r '.dockerfile // (.context+"/Dockerfile")'); repo=$(echo "$img"|jq -r .repo)
# tag-suffix is OPTIONAL (most repos ship a single variant). When set
# (e.g. "ce"/"ee") it qualifies every tag; when absent the tags are
# clean (no trailing dash). Build + deploy must agree on this shape.
sfx=$(echo "$img"|jq -r '."tag-suffix" // ""')
# platforms is OPT-IN per image in hanzo.yml (default: amd64 only, so
# every existing repo's tag shape "-amd64" is UNCHANGED). Set e.g.
# platforms: [linux/amd64, linux/arm64]
# to emit a multi-arch MANIFEST LIST — one digest serving both arches.
# DOKS has no arm64 nodes, so arm64 builds via buildx QEMU emulation
# (binfmt set up below); pure-Go (CGO_ENABLED=0) Dockerfiles that honor
# $TARGETARCH cross-compile natively (fast, no emulation). For true
# native-speed arm64, register a bare-metal arm64 host (spark/GB10) as
# the hanzo-build-linux-arm64 self-hosted runner (values-build-arm64.yaml).
plats=$(echo "$img"|jq -r '(.platforms // ["linux/amd64"]) | join(",")')
# ---- Refuse a Go builder older than the module it compiles -------
# The official golang images set GOTOOLCHAIN=local, so a go.mod
# requiring a newer Go than the base image does not degrade — it
# dies mid-build with "go.mod requires go >= X (running Y;
# GOTOOLCHAIN=local)". hanzoai/visor v1.108.16 is the shipped
# instance, and it is invisible before the image build: every local
# `go build` succeeds because a dev box runs GOTOOLCHAIN=auto and
# just downloads what the module asks for. So the break is
# introduced by editing go.mod — a file with nothing to do with
# Docker — and found by a red release build.
#
# It is not one repo's problem either: a sweep of every Dockerfile
# across the orgs found 54 below their own go.mod in 23 repos, and
# only 7 of 223 Go builder stages set GOTOOLCHAIN=auto. Fixing those
# fixes today; this line is what makes the 55th impossible.
#
# Checked here, before any build work, so the run fails in seconds
# rather than after binfmt, a version derivation and a layer cache.
"$CI_HOME/bin/gover" "$df" "$ctx"
# ---- The semver this build publishes ----------------------------
# A branch build used to publish sha-<short7> and nothing else, so an
# image only earned a version when a human remembered to cut a git
# tag. That is the whole reason 14 of the fleet's 117 pins named a
# commit instead of a release: not drift, just the only tag CI ever
# offered them. Every build now publishes a version too, and the
# sha- tag stays beside it for forensics.
#
# The number is DERIVED, never typed, by bin/imgver — the ONE
# implementation, shared with the hand-rolled
# .hanzo/workflows/deploy.yml that 11 repos carry instead of importing
# this workflow (see .github/actions/imgver). Written twice it would be
# right twice and then wrong once, which is exactly how `sha-<short>`
# became the only tag those repos ever published. Read that script for
# the rule; it is monotonic against the repo's manifest AND the
# registry, so one tag can never cover two digests.
ver=""
if [ "$IS_TAG" = 1 ]; then
# Release build: the git tag IS the version. Identity in, identity
# out — deriving here would publish a number nobody asked for.
:
else
# An explicit `version:` on the image entry wins over the repo-wide
# one; both are optional, and imgver falls back to the manifest.
iv=$(echo "$img"|jq -r '.version // ""')
[ -z "$iv" ] && iv=$(yq -r '.version // ""' hanzo.yml)
ver=$(IMGVER_VERSION="$iv" "$CI_HOME/bin/imgver" "$repo" "$ctx")
fi
if [ "$plats" = "linux/amd64" ]; then
# single-arch: keep the exact legacy tag shape (-amd64) deploys expect.
TAGS="-t $repo:sha-${SHORT}-amd64${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
else
# multi-arch: one arch-neutral manifest-list tag (no -amd64 suffix).
docker run --privileged --rm tonistiigi/binfmt --install arm64 >/dev/null 2>&1 || true
TAGS="-t $repo:sha-${SHORT}${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
fi
# Release (tag) build. The git tag IS the release name, so publish it
# VERBATIM (v1.26.19) — that is the shape a universe CR pins, and
# stripping the v is why releases were finished by hand-`crane copy`ing
# sha-<sha7> onto the semver a human typed. Identity in, identity out.
# The v-stripped alias stays for CRs already pinned that way (world
# 2.4.51), and is skipped when a repo tags without a v. The old
# `<ver>-amd64` alias is deleted: no CR in the fleet pinned it.
if [ "$IS_TAG" = 1 ]; then
TAGS="$TAGS -t $repo:${REL}${sfx:+-$sfx}"
[ "$REL" != "$VER" ] && TAGS="$TAGS -t $repo:${VER}${sfx:+-$sfx}"
else
# The tag universe is meant to PIN. It goes on every build, not
# only the ones somebody remembered to tag by hand.
TAGS="$TAGS -t $repo:${ver}${sfx:+-$sfx}"
fi
echo "::group::build $name → $repo (${sfx}) [$plats]"
# --build-arg assembly: static hanzo.yml `args` (a fixed value, e.g. a
# pinned base image tag) + `build_secrets` (KMS values the KMS step
# exported into the env above). Empty when a repo declares neither, so
# the buildx line is unchanged for every existing repo.
BUILD_ARGS=""
while IFS= read -r kv; do [ -n "$kv" ] && BUILD_ARGS="$BUILD_ARGS --build-arg $kv"; done \
< <(echo "$img" | jq -r '(.args // {}) | to_entries[] | "\(.key)=\(.value)"')
for bs in $(echo "$img" | jq -r '(.build_secrets // [])[]'); do
v=$(printenv "$bs" 2>/dev/null || true)
# Defense in depth: the KMS step above already refuses to continue
# with an unresolved build_secret, so reaching here empty means the
# two steps disagree. Stop rather than bake a blank credential.
[ -z "$v" ] && { echo "::error::build_secret $bs is unset at build time — refusing to bake an empty value"; exit 1; }
BUILD_ARGS="$BUILD_ARGS --build-arg $bs=$v"
done
# PROVENANCE: which commit are these bytes. Passed BOTH ways on
# purpose. The --label sets it from outside for any Dockerfile; the
# --build-arg feeds `ARG REVISION` for the Dockerfiles that stamp the
# label themselves (hanzoai/cloud declares `ARG REVISION=unknown`,
# and `unknown` is exactly what every image built without this said).
#
# An unlabelled image cannot be traced to source, and that stops being
# cosmetic the moment two builders race for one tag: with one image
# labelled and the other reading `unknown`, "which of these is the
# release" had no answer short of diffing layers — while the wrong one
# was already pinned. A version is a receipt only if the image can
# name its own commit, so every image this fleet publishes now can.
#
# A Dockerfile with no `ARG REVISION` ignores the build-arg (buildkit
# warns, never fails), so this is a no-op for every repo that has not
# asked for it.
PROV="--build-arg REVISION=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.revision=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.version=${ver:-$REL}"
PROV="$PROV --label org.opencontainers.image.source=https://github.com/$GITHUB_REPOSITORY"
# GIT_TOKEN (from KMS, via GITHUB_ENV) is passed as the `gh_token`
# BuildKit secret so Dockerfiles can clone private Go modules; omitted
# cleanly when absent (public-only builds unaffected).
docker buildx build --platform "$plats" $BUILD_ARGS $PROV ${GIT_TOKEN:+--secret id=gh_token,env=GIT_TOKEN} --push $TAGS -f "$df" "$ctx"
# The semver is the tag the fleet PINS, so prove it exists before the
# run goes green — buildx can exit 0 while the manifest is not yet
# resolvable, and a pin onto a phantom tag is an ImagePullBackOff.
# The digest is printed with it because universe pins repo:tag@digest
# and the kubelet honours the DIGEST: publishing both here is what
# lets the two move together instead of being looked up separately
# and drifting apart.
pin="$repo:${ver:-$REL}${sfx:+-$sfx}"
for i in 1 2 3 4 5 6; do
dig=$(docker buildx imagetools inspect "$pin" --format '{{.Manifest.Digest}}' 2>/dev/null || true)
[ -n "$dig" ] && break
sleep 5
done
[ -n "$dig" ] || { echo "::error::$pin not resolvable after push"; exit 1; }
echo "| \`$pin\` | \`$dig\` |" >> "$RUNNER_TEMP/pins.md"
# Dual-host: mirror the exact tag set to registry.hanzo.ai (server-
# side manifest copy — no rebuild). ghcr.io/<org>/<name> →
# registry.hanzo.ai/<org>/<name>; public consumers keep ghcr, the fleet
# is migrating to pull from ours. A skip here is now a WARNING, not
# a notice: an image that never reaches our registry is the reason
# a deploy still depends on GitHub, and that should be visible in
# the run, not buried.
if [ "${MIRROR_OK:-}" = "1" ]; then
# crane, not buildx imagetools: the IAM token realm doesn't answer
# buildx's multi-scope token request (spec gap, tracked).
command -v crane >/dev/null 2>&1 || {
mkdir -p "$HOME/.local/bin"
curl -fsSL https://github.com/google/go-containerregistry/releases/download/v0.20.2/go-containerregistry_Linux_x86_64.tar.gz \
| tar -xz -C "$HOME/.local/bin" crane
export PATH="$HOME/.local/bin:$PATH"
}
# ONE mapping, stated once. The GHCR org and the registry org are
# not the same word — ghcr.io/hanzoai/x mirrors to
# registry.hanzo.ai/hanzo/x — and a second copy of this table is
# how a push path and a pin drift into naming different images.
rorg="${repo#*/}"; rname="${rorg#*/}"; rorg="${rorg%%/*}"
case "$rorg" in
hanzoai) rorg=hanzo ;;
zooai) rorg=zoo ;;
*) ;; # bootnode, lux-private, ... map to themselves
esac
mrepo="registry.hanzo.ai/$rorg/$rname"
echo "$TAGS" | tr ' ' '\n' | grep -v '^-t$' | grep -v '^$' | while read -r ref; do
crane copy "$ref" "${mrepo}:${ref##*:}" \
|| echo "::warning::$ref did not reach registry.hanzo.ai (ghcr push unaffected)"
done
fi
echo "::endgroup::"
done
# The pins this run earned, ready to paste into universe. Tag and
# digest are printed TOGETHER because they are one fact: the failure
# this prevents is a new tag landing beside an old digest, which
# reports the new version on the pod and serves the old bytes.
if [ -s "$RUNNER_TEMP/pins.md" ]; then
{ echo "### Pins"; echo; echo "| image | digest |"; echo "|---|---|";
cat "$RUNNER_TEMP/pins.md"; } >> "$GITHUB_STEP_SUMMARY"
fi
- name: Client — commit the projection and cut the patch
# LAST, and after `test:` on purpose: this pushes a tag, the tag starts a
# publish, and a published client is the one artifact in this workflow
+397 -234
View File
@@ -42,15 +42,41 @@ on:
tests:
description: >-
Run the `test:` block. Default true, and a caller should leave it that
way. false asserts that THIS EXACT COMMIT was already gated before this
way. 'false' asserts that THIS EXACT COMMIT was already gated before this
run — it does not mean "ship untested". The one shape that holds today
is hanzoai/cloud's release: clients/platform/release.go mints the v* tag
only after that SHA passed the gate on main AND built AND smoked, so the
tag build would re-test a commit already proven, at the cost of a
3108-package link storm. Passing false there runs the gate once instead
3108-package link storm. Passing 'false' there runs the gate once instead
of twice; passing it anywhere else runs it zero times.
type: boolean
default: true
STRING, NOT BOOLEAN, AND THAT IS LOAD-BEARING. git.hanzo.ai resolves
EVERY `type: boolean` workflow_call input to false — not just an omitted
one carrying a default, but an explicitly passed `true` as well. Measured
in isolation (z/inputprobe, runs 27365 and 27382): with `type: boolean,
default: true` and a caller that omits it, `inputs.tests` printed
`false`; a caller passing `with: {tests: true}` printed `false` too;
inverting the polarity to a `skip_tests` boolean printed `false` when
`true` was passed. String inputs in the SAME probe resolved correctly —
`mode` printed `buildx` and `runner` printed its full JSON array from
their declared defaults.
So for as long as this input was a boolean, `if: ... && inputs.tests` was
false on EVERY run, and the step below never executed. That is not a
hypothetical: on 2026-08-04 the last two `cicd.yml` runs of hanzoai/cloud,
commerce, console, gateway, hanzo.ai AND hanzoai/ci itself all reported
completed/success with `Test (per hanzo.yml)` = skipped. Every `test:`
block in the fleet was declared, was read, and had never once run — a
green over zero tests, which the step below exists specifically to refuse
when a SUITE is empty, and which had swallowed the whole gate.
A string sidesteps it on both planes with identical meaning, and the
comparison is against 'false' rather than a truthiness test so that the
expression callers already write — hanzoai/cloud's
`tests:` set from `github.ref_type != 'tag'`, which renders the strings
"true"/"false" — keeps working unchanged.
type: string
default: 'true'
submodules:
description: >-
Passed straight to actions/checkout. Default '' is checkout's own
@@ -78,6 +104,14 @@ permissions:
jobs:
cicd:
runs-on: ${{ fromJson(inputs.runner) }}
env:
# corepack fetches the pnpm/yarn TARBALL ITSELF from registry.npmjs.org,
# and it does not read .npmrc to do it — so 317 repos that pin
# `packageManager` reach out to npmjs on every install no matter how
# carefully their registry is configured. This is the one variable that
# closes that hole; without it "installs go through our registry" is true
# of the dependencies and false of the package manager fetching them.
COREPACK_NPM_REGISTRY: https://pkg.hanzo.ai
steps:
- uses: actions/checkout@v4
with:
@@ -120,6 +154,43 @@ jobs:
|| { echo "::error::could not fetch hanzoai/ci@${ref} (bin/imgver) from any host"; exit 1; }
echo "CI_HOME=$RUNNER_TEMP/ci" >> "$GITHUB_ENV"
- name: Structural invariants (the repo agrees with itself)
# Two cheap refusals, run before anything is built or pushed, for a
# defect class no later stage can see: a declaration and the reality it
# describes disagreeing in silence.
#
# ignoretracked — content the repo's OWN .gitignore matches but the
# index still tracks. An ignore rule does not untrack what is
# already tracked, so the bulk ships in every release while
# `git status` stays clean. hanzoai/cloud carried 361 MB this way
# for 6 days — past Go's 500 MiB module-zip ceiling, making nine
# consecutive releases unfetchable by every consumer.
# modsize — each Go module tree measured against that same ceiling,
# nested modules separately. Past it, `go get` fails everywhere
# with 'module source tree too large'; near it, this is the only
# warning anyone gets before the first consumer breaks.
# conflictmarkers — a merge that was committed unresolved. `git add`
# accepts a file that still carries git's own markers, and from then
# on they are ordinary content: status clean, diff empty, both sides
# of the merge shipping. It hides in generated and vendored files,
# which are large, rarely opened and effectively unreviewed —
# hanzoai/base carried `<<<<<<< HEAD` / `>>>>>>> upstream/master` at
# lines 23807 and 23850 of a committed .d.ts. No compiler catches it
# there: a .d.ts nothing imports is never parsed, and in YAML, JSON,
# Markdown and every config format we ship the markers are silently
# VALID content.
#
# Both proven RED against cloud@v1.801.424 (the real outage) and GREEN
# against the repaired tree before landing here. They read the checkout
# only — no network, subsecond on a healthy repo — and they FAIL the
# run rather than annotate it, because a warning nobody reads is the
# same silence one level up.
run: |
set -euo pipefail
"$RUNNER_TEMP/ci/bin/ignoretracked" .
"$RUNNER_TEMP/ci/bin/modsize" .
"$RUNNER_TEMP/ci/bin/conflictmarkers" .
- name: Provision parse toolchain (jq + PyYAML)
# This reusable parses the caller's hanzo.yml with python3 + PyYAML and
# slices JSON with jq. A minimal runner image
@@ -304,6 +375,15 @@ jobs:
if [ -z "$ORG" ]; then
case "${{ github.repository_owner }}" in
hanzoai) ORG=hanzo ;;
# hanzo-inc is the same TENANT as hanzoai — pay, commerce and the
# rest of the company surfaces bill and seal to KMS org `hanzo`.
# Without this line ORG fell through to the literal owner,
# "hanzo-inc", which is not a KMS org. That still LOOKED fine,
# because the read below takes its org from the TOKEN, not the URL
# — so the only things that were wrong were the fallback URL and
# every error message, which named an org that does not exist and
# sent the reader looking for a tenant instead of a credential.
hanzo-inc) ORG=hanzo ;;
luxfi) ORG=lux ;;
zooai) ORG=zoo ;;
*) ORG="${{ github.repository_owner }}" ;;
@@ -336,23 +416,11 @@ jobs:
fi
echo "::warning::KMS login failed (org=$ORG client=$KMS_CLIENT_ID) — cross-org private deps & deploy unavailable"; exit 0
fi
# KMS is embedded in hanzoai/cloud now (HIP-0106, cloud/apps/kms), and its
# contract differs from the standalone service in two ways that BOTH fail
# silently — you get an empty string, which every caller below already
# treats as "not in KMS":
#
# url /v1/kms/secrets/<path>/<name> — the org comes from the TOKEN,
# not the url. The old /v1/kms/orgs/<org>/... form 404s, and -sf
# turns that into empty output.
# body {"name","env","value"} — flat. `.secret.value` selects nothing.
#
# Reading the OLD host is worse than reading nothing: the two instances
# hold DIFFERENT values under the same name, and the standalone copy of
# deploy/EVENT_INGEST_KEY is stale — cloud rejects it at ingest with 403,
# so a build that "found" a key still ships one that cannot write.
#
# Try the embedded shape first and fall back to the standalone one, so a
# repo still pointed at the old host keeps working while the fleet moves.
# Embedded KMS (HIP-0106): org from the token, flat {"value"}. The old
# /v1/kms/orgs/<org>/... + .secret.value pair 404s and `curl -sf` turns
# that into "" — which every caller reads as "not in KMS". The standalone
# host also holds a STALE key cloud 403s, so reading it ships a dead one.
# Embedded first, standalone as fallback.
get() {
v=$(curl -sf "$KMS_ENDPOINT/v1/kms/secrets/$PATHQ/$1?env=$ENV" -H "Authorization: Bearer $TOKEN" | jq -r '.value // empty')
if [ -z "$v" ]; then
@@ -376,6 +444,18 @@ jobs:
# ask KMS twice.
SITE_DECL="$(yq -r '.site | type' hanzo.yml 2>/dev/null || echo '!!null')"
if [ -n "$(yq -r '.bucket // ""' hanzo.yml 2>/dev/null || true)" ] || [ "$SITE_DECL" = '!!map' ]; then
# The registry credential comes from KMS like every other secret —
# the ONLY things that live in GitHub are KMS_CLIENT_ID/SECRET.
# Named here so a repo with no kubeconfig (most of them) can still
# reach registry.hanzo.ai; the kubeconfig read below stays as the
# fallback for repos provisioned before these names existed.
for k in REGISTRY_USER REGISTRY_PASSWORD; do
v=$(get "$k")
if [ -n "$v" ]; then
[ "$k" = REGISTRY_PASSWORD ] && echo "::add-mask::$v"
echo "$k=$v" >> "$GITHUB_ENV"
fi
done
for k in S3_ADMIN_ACCESS_KEY S3_ADMIN_SECRET_KEY; do
v=$(get "$k")
if [ -n "$v" ]; then echo "::add-mask::$v"; echo "$k=$v" >> "$GITHUB_ENV"; fi
@@ -470,14 +550,20 @@ jobs:
echo "::notice::KMS GHCR token login failed — keeping the earlier login"
fi
- name: Native registry credential (oci.hanzo.ai)
- name: Native registry credential (registry.hanzo.ai)
if: inputs.mode != 'delegate'
env:
KUBECONFIG: ${{ steps.kms.outputs.kubeconfig }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
# KMS first (exported to GITHUB_ENV by the step above), GitHub secret
# second. `env:` here cannot see GITHUB_ENV from THIS step's own env
# block, so the KMS values are read out of the environment in `run:`.
GH_REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
GH_REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
run: |
set -uo pipefail
# REGISTRY_USER/PASSWORD may already be in the environment from KMS.
REGISTRY_USER="${REGISTRY_USER:-${GH_REGISTRY_USER:-}}"
REGISTRY_PASSWORD="${REGISTRY_PASSWORD:-${GH_REGISTRY_PASSWORD:-}}"
# Direct credential first (repo/org secret — works on private repos,
# where the Free plan hides org secrets... including these; private
# repos set them at REPO level). KMS-kubeconfig read is the fallback.
@@ -486,14 +572,14 @@ jobs:
# cred) must never fail the run — the image still pushes to GHCR, the
# primary. Without this guard, bash -e aborts the step and SKIPS the
# build entirely (a registry hiccup takes the whole lane red).
if echo "$REGISTRY_PASSWORD" | docker login oci.hanzo.ai -u "$REGISTRY_USER" --password-stdin; then
if echo "$REGISTRY_PASSWORD" | docker login registry.hanzo.ai -u "$REGISTRY_USER" --password-stdin; then
echo "MIRROR_OK=1" >> "$GITHUB_ENV"
else
echo "::notice::registry.hanzo.ai login failed — mirror skipped (GHCR-only push)"
fi
exit 0
fi
[ -z "${KUBECONFIG:-}" ] && { echo "::warning::no registry credential and no kubeconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0; }
[ -z "${KUBECONFIG:-}" ] && { echo "::warning::no registry credential and no kubeconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0; }
# Bare runners ship no kubectl — same static provision the deploy
# step uses.
command -v kubectl >/dev/null 2>&1 || {
@@ -504,218 +590,18 @@ jobs:
}
CFG=$(kubectl -n hanzo get secret registry-credentials -o jsonpath='{.data.\.dockerconfigjson}' 2>/dev/null | base64 -d || true)
if [ -z "$CFG" ]; then
echo "::warning::registry-credentials not readable from this kubeconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0
echo "::warning::registry-credentials not readable from this kubeconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0
fi
USERPASS=$(echo "$CFG" | jq -r '.auths["registry.hanzo.ai"].auth // empty' | base64 -d)
[ -z "$USERPASS" ] && { echo "::warning::no registry auth in dockerconfig — image will NOT reach oci.hanzo.ai (ghcr only)"; exit 0; }
[ -z "$USERPASS" ] && { echo "::warning::no registry auth in dockerconfig — image will NOT reach registry.hanzo.ai (ghcr only)"; exit 0; }
echo "::add-mask::${USERPASS#*:}"
# Best-effort: login failure → skip mirror, never fail the run (see above).
if echo "${USERPASS#*:}" | docker login oci.hanzo.ai -u "${USERPASS%%:*}" --password-stdin; then
if echo "${USERPASS#*:}" | docker login registry.hanzo.ai -u "${USERPASS%%:*}" --password-stdin; then
echo "MIRROR_OK=1" >> "$GITHUB_ENV"
else
echo "::notice::registry.hanzo.ai login failed — mirror skipped (GHCR-only push)"
fi
- name: Build & push images (per hanzo.yml)
if: inputs.mode != 'delegate'
env:
GH_PAT: ${{ secrets.GH_PAT }}
run: |
set -euo pipefail
# Test-only callers (hanzo.yml without `images:` — e.g. a repo whose
# image lane lives in its own release.yml, or a pure library) skip the
# build step entirely instead of exploding on a null .images.
if [ "$(yq -r '.images // [] | length' hanzo.yml 2>/dev/null || echo 0)" = "0" ]; then
echo "::notice::no images: in hanzo.yml — test-only caller, skipping build"; exit 0
fi
# Build-time private cross-org Go module read (the buildx `gh_token`
# secret): prefer the KMS-fetched GIT_TOKEN, else fall back to the org
# GH_PAT — the SAME BuildKit gh_token cloud's release.yml uses (proven
# working). Keeps image builds green when the KMS deploy-cred fetch is
# unavailable (a repo with a private cross-org dep like hanzoai/cloud
# otherwise fails `go mod tidy` with git exit 128 in the buildx stage).
# No-op for public-only builds when both are empty. Exported so the
# `--secret id=gh_token,env=GIT_TOKEN` below reads it from the env.
export GIT_TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
SHORT=$(echo "${{ github.sha }}" | cut -c1-7)
IS_TAG=$([ "${{ github.ref_type }}" = "tag" ] && echo 1 || echo 0)
REL="${{ github.ref_name }}" # the git tag, verbatim: v1.26.19
VER="${REL#v}" # v-stripped alias: 1.26.19
yq -o=json -I=0 '.images' hanzo.yml | jq -c '.[]' | while read -r img; do
name=$(echo "$img"|jq -r .name); ctx=$(echo "$img"|jq -r .context)
df=$(echo "$img"|jq -r '.dockerfile // (.context+"/Dockerfile")'); repo=$(echo "$img"|jq -r .repo)
# tag-suffix is OPTIONAL (most repos ship a single variant). When set
# (e.g. "ce"/"ee") it qualifies every tag; when absent the tags are
# clean (no trailing dash). Build + deploy must agree on this shape.
sfx=$(echo "$img"|jq -r '."tag-suffix" // ""')
# platforms is OPT-IN per image in hanzo.yml (default: amd64 only, so
# every existing repo's tag shape "-amd64" is UNCHANGED). Set e.g.
# platforms: [linux/amd64, linux/arm64]
# to emit a multi-arch MANIFEST LIST — one digest serving both arches.
# DOKS has no arm64 nodes, so arm64 builds via buildx QEMU emulation
# (binfmt set up below); pure-Go (CGO_ENABLED=0) Dockerfiles that honor
# $TARGETARCH cross-compile natively (fast, no emulation). For true
# native-speed arm64, register a bare-metal arm64 host (spark/GB10) as
# the hanzo-build-linux-arm64 self-hosted runner (values-build-arm64.yaml).
plats=$(echo "$img"|jq -r '(.platforms // ["linux/amd64"]) | join(",")')
# ---- Refuse a Go builder older than the module it compiles -------
# The official golang images set GOTOOLCHAIN=local, so a go.mod
# requiring a newer Go than the base image does not degrade — it
# dies mid-build with "go.mod requires go >= X (running Y;
# GOTOOLCHAIN=local)". hanzoai/visor v1.108.16 is the shipped
# instance, and it is invisible before the image build: every local
# `go build` succeeds because a dev box runs GOTOOLCHAIN=auto and
# just downloads what the module asks for. So the break is
# introduced by editing go.mod — a file with nothing to do with
# Docker — and found by a red release build.
#
# It is not one repo's problem either: a sweep of every Dockerfile
# across the orgs found 54 below their own go.mod in 23 repos, and
# only 7 of 223 Go builder stages set GOTOOLCHAIN=auto. Fixing those
# fixes today; this line is what makes the 55th impossible.
#
# Checked here, before any build work, so the run fails in seconds
# rather than after binfmt, a version derivation and a layer cache.
"$CI_HOME/bin/gover" "$df" "$ctx"
# ---- The semver this build publishes ----------------------------
# A branch build used to publish sha-<short7> and nothing else, so an
# image only earned a version when a human remembered to cut a git
# tag. That is the whole reason 14 of the fleet's 117 pins named a
# commit instead of a release: not drift, just the only tag CI ever
# offered them. Every build now publishes a version too, and the
# sha- tag stays beside it for forensics.
#
# The number is DERIVED, never typed, by bin/imgver — the ONE
# implementation, shared with the hand-rolled
# .hanzo/workflows/deploy.yml that 11 repos carry instead of importing
# this workflow (see .github/actions/imgver). Written twice it would be
# right twice and then wrong once, which is exactly how `sha-<short>`
# became the only tag those repos ever published. Read that script for
# the rule; it is monotonic against the repo's manifest AND the
# registry, so one tag can never cover two digests.
ver=""
if [ "$IS_TAG" = 1 ]; then
# Release build: the git tag IS the version. Identity in, identity
# out — deriving here would publish a number nobody asked for.
:
else
# An explicit `version:` on the image entry wins over the repo-wide
# one; both are optional, and imgver falls back to the manifest.
iv=$(echo "$img"|jq -r '.version // ""')
[ -z "$iv" ] && iv=$(yq -r '.version // ""' hanzo.yml)
ver=$(IMGVER_VERSION="$iv" "$CI_HOME/bin/imgver" "$repo" "$ctx")
fi
if [ "$plats" = "linux/amd64" ]; then
# single-arch: keep the exact legacy tag shape (-amd64) deploys expect.
TAGS="-t $repo:sha-${SHORT}-amd64${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
else
# multi-arch: one arch-neutral manifest-list tag (no -amd64 suffix).
docker run --privileged --rm tonistiigi/binfmt --install arm64 >/dev/null 2>&1 || true
TAGS="-t $repo:sha-${SHORT}${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
fi
# Release (tag) build. The git tag IS the release name, so publish it
# VERBATIM (v1.26.19) — that is the shape a universe CR pins, and
# stripping the v is why releases were finished by hand-`crane copy`ing
# sha-<sha7> onto the semver a human typed. Identity in, identity out.
# The v-stripped alias stays for CRs already pinned that way (world
# 2.4.51), and is skipped when a repo tags without a v. The old
# `<ver>-amd64` alias is deleted: no CR in the fleet pinned it.
if [ "$IS_TAG" = 1 ]; then
TAGS="$TAGS -t $repo:${REL}${sfx:+-$sfx}"
[ "$REL" != "$VER" ] && TAGS="$TAGS -t $repo:${VER}${sfx:+-$sfx}"
else
# The tag universe is meant to PIN. It goes on every build, not
# only the ones somebody remembered to tag by hand.
TAGS="$TAGS -t $repo:${ver}${sfx:+-$sfx}"
fi
echo "::group::build $name → $repo (${sfx}) [$plats]"
# --build-arg assembly: static hanzo.yml `args` (a fixed value, e.g. a
# pinned base image tag) + `build_secrets` (KMS values the KMS step
# exported into the env above). Empty when a repo declares neither, so
# the buildx line is unchanged for every existing repo.
BUILD_ARGS=""
while IFS= read -r kv; do [ -n "$kv" ] && BUILD_ARGS="$BUILD_ARGS --build-arg $kv"; done \
< <(echo "$img" | jq -r '(.args // {}) | to_entries[] | "\(.key)=\(.value)"')
for bs in $(echo "$img" | jq -r '(.build_secrets // [])[]'); do
v=$(printenv "$bs" 2>/dev/null || true)
# Defense in depth: the KMS step above already refuses to continue
# with an unresolved build_secret, so reaching here empty means the
# two steps disagree. Stop rather than bake a blank credential.
[ -z "$v" ] && { echo "::error::build_secret $bs is unset at build time — refusing to bake an empty value"; exit 1; }
BUILD_ARGS="$BUILD_ARGS --build-arg $bs=$v"
done
# PROVENANCE: which commit are these bytes. Passed BOTH ways on
# purpose. The --label sets it from outside for any Dockerfile; the
# --build-arg feeds `ARG REVISION` for the Dockerfiles that stamp the
# label themselves (hanzoai/cloud declares `ARG REVISION=unknown`,
# and `unknown` is exactly what every image built without this said).
#
# An unlabelled image cannot be traced to source, and that stops being
# cosmetic the moment two builders race for one tag: with one image
# labelled and the other reading `unknown`, "which of these is the
# release" had no answer short of diffing layers — while the wrong one
# was already pinned. A version is a receipt only if the image can
# name its own commit, so every image this fleet publishes now can.
#
# A Dockerfile with no `ARG REVISION` ignores the build-arg (buildkit
# warns, never fails), so this is a no-op for every repo that has not
# asked for it.
PROV="--build-arg REVISION=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.revision=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.version=${ver:-$REL}"
PROV="$PROV --label org.opencontainers.image.source=https://github.com/$GITHUB_REPOSITORY"
# GIT_TOKEN (from KMS, via GITHUB_ENV) is passed as the `gh_token`
# BuildKit secret so Dockerfiles can clone private Go modules; omitted
# cleanly when absent (public-only builds unaffected).
docker buildx build --platform "$plats" $BUILD_ARGS $PROV ${GIT_TOKEN:+--secret id=gh_token,env=GIT_TOKEN} --push $TAGS -f "$df" "$ctx"
# The semver is the tag the fleet PINS, so prove it exists before the
# run goes green — buildx can exit 0 while the manifest is not yet
# resolvable, and a pin onto a phantom tag is an ImagePullBackOff.
# The digest is printed with it because universe pins repo:tag@digest
# and the kubelet honours the DIGEST: publishing both here is what
# lets the two move together instead of being looked up separately
# and drifting apart.
pin="$repo:${ver:-$REL}${sfx:+-$sfx}"
for i in 1 2 3 4 5 6; do
dig=$(docker buildx imagetools inspect "$pin" --format '{{.Manifest.Digest}}' 2>/dev/null || true)
[ -n "$dig" ] && break
sleep 5
done
[ -n "$dig" ] || { echo "::error::$pin not resolvable after push"; exit 1; }
echo "| \`$pin\` | \`$dig\` |" >> "$RUNNER_TEMP/pins.md"
# Dual-host: mirror the exact tag set to registry.hanzo.ai (server-
# side manifest copy — no rebuild). ghcr.io/<org>/<name> →
# oci.hanzo.ai/<org>/<name>; public consumers keep ghcr, the fleet
# is migrating to pull from ours. A skip here is now a WARNING, not
# a notice: an image that never reaches our registry is the reason
# a deploy still depends on GitHub, and that should be visible in
# the run, not buried.
if [ "${MIRROR_OK:-}" = "1" ]; then
# crane, not buildx imagetools: the IAM token realm doesn't answer
# buildx's multi-scope token request (spec gap, tracked).
command -v crane >/dev/null 2>&1 || {
mkdir -p "$HOME/.local/bin"
curl -fsSL https://github.com/google/go-containerregistry/releases/download/v0.20.2/go-containerregistry_Linux_x86_64.tar.gz \
| tar -xz -C "$HOME/.local/bin" crane
export PATH="$HOME/.local/bin:$PATH"
}
mrepo="oci.hanzo.ai/${repo#*/}"
echo "$TAGS" | tr ' ' '\n' | grep -v '^-t$' | grep -v '^$' | while read -r ref; do
crane copy "$ref" "${mrepo}:${ref##*:}" \
|| echo "::warning::$ref did not reach oci.hanzo.ai (ghcr push unaffected)"
done
fi
echo "::endgroup::"
done
# The pins this run earned, ready to paste into universe. Tag and
# digest are printed TOGETHER because they are one fact: the failure
# this prevents is a new tag landing beside an old digest, which
# reports the new version on the pod and serves the old bytes.
if [ -s "$RUNNER_TEMP/pins.md" ]; then
{ echo "### Pins"; echo; echo "| image | digest |"; echo "|---|---|";
cat "$RUNNER_TEMP/pins.md"; } >> "$GITHUB_STEP_SUMMARY"
fi
- name: Provision Go toolchain (go test gates on bare runners)
# hanzo.yml `test:` gates (e.g. `go vet ./...`, `go test ...`) run
# DIRECTLY on the runner, NOT inside a build container — but the stock
@@ -962,16 +848,72 @@ jobs:
# unset) — so `go vet` dies with `could not read Username for github.com`.
# Reuse the SAME token here for the runner's git (GIT_TOKEN, set by the
# KMS step above; GH_PAT fallback). No-op when neither is present.
#
# AND OUR OWN MODULES RESOLVE FROM OUR OWN FORGE. A module path is a NAME,
# not an address: `github.com/<owner>/x` is what the package is called, and
# which host git dials for it is a separate decision. On a forge runner
# that decision is the forge — the forge is where the code canonically
# lives, and github.com is fed by a mirror that trails it, sometimes by
# hours and sometimes not at all.
#
# Measured, on the first run in which this step's gate had ever actually
# executed: hanzoai/cloud's go.mod carries `github.com/hanzoai/dashscopego
# v0.6.0` as an indirect dependency. git.hanzo.ai serves it; github.com
# answers `Repository not found`. So `go vet` died before a single test
# ran, on a module that was never missing. Its own caller already knew the
# answer — cloud's `containment` and `reach` jobs each make this exact
# substitution, with a comment about the nine consecutive releases an
# ACL drift on ONE sibling module once blocked — but the gate that runs
# its tests reached the modules through a different door.
#
# go.sum is what makes this safe rather than merely convenient: the forge
# serves the same objects, so the fetched zip hashes to the h1: line
# already committed. A forge serving different bytes fails the build
# loudly instead of shipping them.
#
# Longest prefix wins in git, so the owner-scoped forge rule outranks the
# bare github.com rule beneath it and every OTHER module still resolves
# from github.com. Both rules are optional and independent: no FORGE_TOKEN
# (or a github.com-hosted run, where the server IS github.com) leaves the
# old behaviour exactly as it was.
#
# SPLIT THE SERVER, do not strip a scheme you assumed. GITHUB_SERVER_URL
# on this fleet's runners is `http://hanzo-git.hanzo.svc` — the forge's
# in-cluster address, plain http — and a `${SERVER#https://}` that only
# knows the https spelling passes it through whole, producing
# `https://http://hanzo-git.hanzo.svc/...` and a git that resolves the host
# `http`. Take the scheme and the host as the two values they are, and
# compare the HOST against github.com so the guard cannot be fooled by a
# spelling either.
if: inputs.mode != 'delegate' && hashFiles('go.mod') != ''
env:
GH_PAT: ${{ secrets.GH_PAT }}
FORGE_TOKEN: ${{ secrets.FORGE_TOKEN }}
OWNER: ${{ github.repository_owner }}
run: |
set -uo pipefail
TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
if [ -z "$TOKEN" ]; then echo "no git token — public modules only"; exit 0; fi
CFG="$RUNNER_TEMP/gitconfig-go-test"; : > "$CFG"
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."https://x-access-token:${TOKEN}@github.com/".insteadOf "https://github.com/"
SERVER="${GITHUB_SERVER_URL:-https://github.com}"
SCHEME="${SERVER%%://*}"; HOST="${SERVER#*://}"; HOST="${HOST%/}"
wrote=0
if [ -n "${FORGE_TOKEN:-}" ] && [ "$HOST" != "github.com" ]; then
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."${SCHEME}://x:${FORGE_TOKEN}@${HOST}/${OWNER}/".insteadOf \
"https://github.com/${OWNER}/"
echo "${OWNER}/* modules resolve from ${SCHEME}://${HOST}"
wrote=1
fi
TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
if [ -n "$TOKEN" ]; then
GIT_CONFIG_GLOBAL="$CFG" git config --global \
url."https://x-access-token:${TOKEN}@github.com/".insteadOf "https://github.com/"
echo "github.com modules authenticated"
wrote=1
fi
[ "$wrote" = 1 ] || { echo "no git credential — public modules only"; exit 0; }
{ echo "GIT_CONFIG_GLOBAL=$CFG"; echo "GIT_CONFIG_NOSYSTEM=1"; } >> "$GITHUB_ENV"
echo "runner git authenticated for private Go modules"
@@ -994,7 +936,7 @@ jobs:
# it ran nothing AND nothing shows as having run. A gate that is not a test
# gate — vet, lint, a build, a codegen-freshness check — says neither and is
# untouched. To silence it legitimately, make the gate run a test.
if: inputs.mode != 'delegate' && inputs.tests
if: inputs.mode != 'delegate' && inputs.tests != 'false'
run: |
set -euo pipefail
NOTHING='\[no test files\]|\[no tests to run\]|no tests ran|collected 0 items|No tests found|no test specified|running 0 tests|Tests:[[:space:]]+0 total|(^|[^0-9])0 (passing|passed)'
@@ -1023,6 +965,227 @@ jobs:
fi
done
- name: Build & push images (per hanzo.yml)
# AFTER the gate, deliberately. This step used to run before `test:`,
# so a repo whose gates FAILED still published an image: hanzoai/base
# f9ec7067 pushed sha-f9ec706-amd64 on a run whose tests then went red.
# Deploy and Publish site were skipped, so nothing shipped it — but the
# tag existed, and a tag that exists is something a human pins by hand.
# An artifact is a claim that the commit passed; it should not be
# possible to produce one from a commit that did not.
#
# Nothing here needs the toolchains above it, and Deploy still follows
# this step, so the only thing the move changes is that a red gate now
# produces no image at all.
if: inputs.mode != 'delegate'
env:
GH_PAT: ${{ secrets.GH_PAT }}
run: |
set -euo pipefail
# Test-only callers (hanzo.yml without `images:` — e.g. a repo whose
# image lane lives in its own release.yml, or a pure library) skip the
# build step entirely instead of exploding on a null .images.
if [ "$(yq -r '.images // [] | length' hanzo.yml 2>/dev/null || echo 0)" = "0" ]; then
echo "::notice::no images: in hanzo.yml — test-only caller, skipping build"; exit 0
fi
# Build-time private cross-org Go module read (the buildx `gh_token`
# secret): prefer the KMS-fetched GIT_TOKEN, else fall back to the org
# GH_PAT — the SAME BuildKit gh_token cloud's release.yml uses (proven
# working). Keeps image builds green when the KMS deploy-cred fetch is
# unavailable (a repo with a private cross-org dep like hanzoai/cloud
# otherwise fails `go mod tidy` with git exit 128 in the buildx stage).
# No-op for public-only builds when both are empty. Exported so the
# `--secret id=gh_token,env=GIT_TOKEN` below reads it from the env.
export GIT_TOKEN="${GIT_TOKEN:-${GH_PAT:-}}"
SHORT=$(echo "${{ github.sha }}" | cut -c1-7)
IS_TAG=$([ "${{ github.ref_type }}" = "tag" ] && echo 1 || echo 0)
REL="${{ github.ref_name }}" # the git tag, verbatim: v1.26.19
VER="${REL#v}" # v-stripped alias: 1.26.19
yq -o=json -I=0 '.images' hanzo.yml | jq -c '.[]' | while read -r img; do
name=$(echo "$img"|jq -r .name); ctx=$(echo "$img"|jq -r .context)
df=$(echo "$img"|jq -r '.dockerfile // (.context+"/Dockerfile")'); repo=$(echo "$img"|jq -r .repo)
# tag-suffix is OPTIONAL (most repos ship a single variant). When set
# (e.g. "ce"/"ee") it qualifies every tag; when absent the tags are
# clean (no trailing dash). Build + deploy must agree on this shape.
sfx=$(echo "$img"|jq -r '."tag-suffix" // ""')
# platforms is OPT-IN per image in hanzo.yml (default: amd64 only, so
# every existing repo's tag shape "-amd64" is UNCHANGED). Set e.g.
# platforms: [linux/amd64, linux/arm64]
# to emit a multi-arch MANIFEST LIST — one digest serving both arches.
# DOKS has no arm64 nodes, so arm64 builds via buildx QEMU emulation
# (binfmt set up below); pure-Go (CGO_ENABLED=0) Dockerfiles that honor
# $TARGETARCH cross-compile natively (fast, no emulation). For true
# native-speed arm64, register a bare-metal arm64 host (spark/GB10) as
# the hanzo-build-linux-arm64 self-hosted runner (values-build-arm64.yaml).
plats=$(echo "$img"|jq -r '(.platforms // ["linux/amd64"]) | join(",")')
# ---- Refuse a Go builder older than the module it compiles -------
# The official golang images set GOTOOLCHAIN=local, so a go.mod
# requiring a newer Go than the base image does not degrade — it
# dies mid-build with "go.mod requires go >= X (running Y;
# GOTOOLCHAIN=local)". hanzoai/visor v1.108.16 is the shipped
# instance, and it is invisible before the image build: every local
# `go build` succeeds because a dev box runs GOTOOLCHAIN=auto and
# just downloads what the module asks for. So the break is
# introduced by editing go.mod — a file with nothing to do with
# Docker — and found by a red release build.
#
# It is not one repo's problem either: a sweep of every Dockerfile
# across the orgs found 54 below their own go.mod in 23 repos, and
# only 7 of 223 Go builder stages set GOTOOLCHAIN=auto. Fixing those
# fixes today; this line is what makes the 55th impossible.
#
# Checked here, before any build work, so the run fails in seconds
# rather than after binfmt, a version derivation and a layer cache.
"$CI_HOME/bin/gover" "$df" "$ctx"
# ---- The semver this build publishes ----------------------------
# A branch build used to publish sha-<short7> and nothing else, so an
# image only earned a version when a human remembered to cut a git
# tag. That is the whole reason 14 of the fleet's 117 pins named a
# commit instead of a release: not drift, just the only tag CI ever
# offered them. Every build now publishes a version too, and the
# sha- tag stays beside it for forensics.
#
# The number is DERIVED, never typed, by bin/imgver — the ONE
# implementation, shared with the hand-rolled
# .hanzo/workflows/deploy.yml that 11 repos carry instead of importing
# this workflow (see .github/actions/imgver). Written twice it would be
# right twice and then wrong once, which is exactly how `sha-<short>`
# became the only tag those repos ever published. Read that script for
# the rule; it is monotonic against the repo's manifest AND the
# registry, so one tag can never cover two digests.
ver=""
if [ "$IS_TAG" = 1 ]; then
# Release build: the git tag IS the version. Identity in, identity
# out — deriving here would publish a number nobody asked for.
:
else
# An explicit `version:` on the image entry wins over the repo-wide
# one; both are optional, and imgver falls back to the manifest.
iv=$(echo "$img"|jq -r '.version // ""')
[ -z "$iv" ] && iv=$(yq -r '.version // ""' hanzo.yml)
ver=$(IMGVER_VERSION="$iv" "$CI_HOME/bin/imgver" "$repo" "$ctx")
fi
if [ "$plats" = "linux/amd64" ]; then
# single-arch: keep the exact legacy tag shape (-amd64) deploys expect.
TAGS="-t $repo:sha-${SHORT}-amd64${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
else
# multi-arch: one arch-neutral manifest-list tag (no -amd64 suffix).
docker run --privileged --rm tonistiigi/binfmt --install arm64 >/dev/null 2>&1 || true
TAGS="-t $repo:sha-${SHORT}${sfx:+-$sfx} -t $repo:${sfx:+$sfx-}latest"
fi
# Release (tag) build. The git tag IS the release name, so publish it
# VERBATIM (v1.26.19) — that is the shape a universe CR pins, and
# stripping the v is why releases were finished by hand-`crane copy`ing
# sha-<sha7> onto the semver a human typed. Identity in, identity out.
# The v-stripped alias stays for CRs already pinned that way (world
# 2.4.51), and is skipped when a repo tags without a v. The old
# `<ver>-amd64` alias is deleted: no CR in the fleet pinned it.
if [ "$IS_TAG" = 1 ]; then
TAGS="$TAGS -t $repo:${REL}${sfx:+-$sfx}"
[ "$REL" != "$VER" ] && TAGS="$TAGS -t $repo:${VER}${sfx:+-$sfx}"
else
# The tag universe is meant to PIN. It goes on every build, not
# only the ones somebody remembered to tag by hand.
TAGS="$TAGS -t $repo:${ver}${sfx:+-$sfx}"
fi
echo "::group::build $name → $repo (${sfx}) [$plats]"
# --build-arg assembly: static hanzo.yml `args` (a fixed value, e.g. a
# pinned base image tag) + `build_secrets` (KMS values the KMS step
# exported into the env above). Empty when a repo declares neither, so
# the buildx line is unchanged for every existing repo.
BUILD_ARGS=""
while IFS= read -r kv; do [ -n "$kv" ] && BUILD_ARGS="$BUILD_ARGS --build-arg $kv"; done \
< <(echo "$img" | jq -r '(.args // {}) | to_entries[] | "\(.key)=\(.value)"')
for bs in $(echo "$img" | jq -r '(.build_secrets // [])[]'); do
v=$(printenv "$bs" 2>/dev/null || true)
# Defense in depth: the KMS step above already refuses to continue
# with an unresolved build_secret, so reaching here empty means the
# two steps disagree. Stop rather than bake a blank credential.
[ -z "$v" ] && { echo "::error::build_secret $bs is unset at build time — refusing to bake an empty value"; exit 1; }
BUILD_ARGS="$BUILD_ARGS --build-arg $bs=$v"
done
# PROVENANCE: which commit are these bytes. Passed BOTH ways on
# purpose. The --label sets it from outside for any Dockerfile; the
# --build-arg feeds `ARG REVISION` for the Dockerfiles that stamp the
# label themselves (hanzoai/cloud declares `ARG REVISION=unknown`,
# and `unknown` is exactly what every image built without this said).
#
# An unlabelled image cannot be traced to source, and that stops being
# cosmetic the moment two builders race for one tag: with one image
# labelled and the other reading `unknown`, "which of these is the
# release" had no answer short of diffing layers — while the wrong one
# was already pinned. A version is a receipt only if the image can
# name its own commit, so every image this fleet publishes now can.
#
# A Dockerfile with no `ARG REVISION` ignores the build-arg (buildkit
# warns, never fails), so this is a no-op for every repo that has not
# asked for it.
PROV="--build-arg REVISION=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.revision=$GITHUB_SHA"
PROV="$PROV --label org.opencontainers.image.version=${ver:-$REL}"
PROV="$PROV --label org.opencontainers.image.source=https://github.com/$GITHUB_REPOSITORY"
# GIT_TOKEN (from KMS, via GITHUB_ENV) is passed as the `gh_token`
# BuildKit secret so Dockerfiles can clone private Go modules; omitted
# cleanly when absent (public-only builds unaffected).
docker buildx build --platform "$plats" $BUILD_ARGS $PROV ${GIT_TOKEN:+--secret id=gh_token,env=GIT_TOKEN} --push $TAGS -f "$df" "$ctx"
# The semver is the tag the fleet PINS, so prove it exists before the
# run goes green — buildx can exit 0 while the manifest is not yet
# resolvable, and a pin onto a phantom tag is an ImagePullBackOff.
# The digest is printed with it because universe pins repo:tag@digest
# and the kubelet honours the DIGEST: publishing both here is what
# lets the two move together instead of being looked up separately
# and drifting apart.
pin="$repo:${ver:-$REL}${sfx:+-$sfx}"
for i in 1 2 3 4 5 6; do
dig=$(docker buildx imagetools inspect "$pin" --format '{{.Manifest.Digest}}' 2>/dev/null || true)
[ -n "$dig" ] && break
sleep 5
done
[ -n "$dig" ] || { echo "::error::$pin not resolvable after push"; exit 1; }
echo "| \`$pin\` | \`$dig\` |" >> "$RUNNER_TEMP/pins.md"
# Dual-host: mirror the exact tag set to registry.hanzo.ai (server-
# side manifest copy — no rebuild). ghcr.io/<org>/<name> →
# registry.hanzo.ai/<org>/<name>; public consumers keep ghcr, the fleet
# is migrating to pull from ours. A skip here is now a WARNING, not
# a notice: an image that never reaches our registry is the reason
# a deploy still depends on GitHub, and that should be visible in
# the run, not buried.
if [ "${MIRROR_OK:-}" = "1" ]; then
# crane, not buildx imagetools: the IAM token realm doesn't answer
# buildx's multi-scope token request (spec gap, tracked).
command -v crane >/dev/null 2>&1 || {
mkdir -p "$HOME/.local/bin"
curl -fsSL https://github.com/google/go-containerregistry/releases/download/v0.20.2/go-containerregistry_Linux_x86_64.tar.gz \
| tar -xz -C "$HOME/.local/bin" crane
export PATH="$HOME/.local/bin:$PATH"
}
# ONE mapping, stated once. The GHCR org and the registry org are
# not the same word — ghcr.io/hanzoai/x mirrors to
# registry.hanzo.ai/hanzo/x — and a second copy of this table is
# how a push path and a pin drift into naming different images.
rorg="${repo#*/}"; rname="${rorg#*/}"; rorg="${rorg%%/*}"
case "$rorg" in
hanzoai) rorg=hanzo ;;
zooai) rorg=zoo ;;
*) ;; # bootnode, lux-private, ... map to themselves
esac
mrepo="registry.hanzo.ai/$rorg/$rname"
echo "$TAGS" | tr ' ' '\n' | grep -v '^-t$' | grep -v '^$' | while read -r ref; do
crane copy "$ref" "${mrepo}:${ref##*:}" \
|| echo "::warning::$ref did not reach registry.hanzo.ai (ghcr push unaffected)"
done
fi
echo "::endgroup::"
done
# The pins this run earned, ready to paste into universe. Tag and
# digest are printed TOGETHER because they are one fact: the failure
# this prevents is a new tag landing beside an old digest, which
# reports the new version on the pod and serves the old bytes.
if [ -s "$RUNNER_TEMP/pins.md" ]; then
{ echo "### Pins"; echo; echo "| image | digest |"; echo "|---|---|";
cat "$RUNNER_TEMP/pins.md"; } >> "$GITHUB_STEP_SUMMARY"
fi
- name: Client — commit the projection and cut the patch
# LAST, and after `test:` on purpose: this pushes a tag, the tag starts a
# publish, and a published client is the one artifact in this workflow
+112
View File
@@ -0,0 +1,112 @@
#!/usr/bin/env bash
# conflictmarkers — refuse a repo that has committed an unresolved merge.
# One implementation, every caller.
#
# conflictmarkers [dir]
#
# WHAT THIS CATCHES
#
# `git merge` writes its disagreement INTO the file and stops. Resolving means
# editing those lines out; nothing forces you to. `git add` on a file that still
# contains them is accepted without complaint, and from that moment the markers
# are ordinary committed content — `git status` is clean, `git diff` is empty,
# and the conflict is now a permanent feature of the branch.
#
# It survives because of WHERE it lands. The file is usually generated or
# vendored — large, rarely opened, excluded from review by its own size. Nobody
# reads line 23,807 of a .d.ts. hanzoai/base carried exactly this on main:
#
# plugins/jsvm/internal/types/generated/types.d.ts:23807 <<<<<<< HEAD
# plugins/jsvm/internal/types/generated/types.d.ts:23850 >>>>>>> upstream/master
#
# from an upstream merge nobody finished, sitting in the shipped package.
#
# The compilers are no help, which is the whole problem. In TypeScript the
# markers are a syntax error — but a .d.ts nothing imports is never parsed, so
# there is no error to see. In Go they are a parse error only in a file the
# build reaches. In YAML, JSON, Markdown, SQL, HTML and every config format we
# ship, they are silently VALID content: a marker in a values file is a key
# nobody notices, and a marker in a Markdown doc renders as text.
#
# So the defect class is "both sides of a merge shipped, and nothing in the
# pipeline had an opinion". That is the same shape as its two siblings in this
# step — a declaration and reality disagreeing, with no reader positioned to
# notice — which is why it belongs here rather than in any one repo's gate.
#
# WHAT IT LOOKS FOR, AND WHY NOT MORE
#
# Only the two LABELLED markers git actually writes:
#
# ^<<<<<<< <label> the start marker, seven '<' then a space
# ^======= the divider, seven bare equals
# ^>>>>>>> <label> the end marker, seven '>' then a space
#
# ALL THREE, IN THAT ORDER, EACH ON ITS OWN LINE. Not any one of them — the
# whole shape. That is not belt-and-braces, it is the difference between a gate
# and a nuisance, and it was measured the expensive way: matching the start
# marker ALONE failed hanzoai/app, whose builder tests carry
#
# <<<<<<< START_TITLE index.html >>>>>>> END_TITLE
#
# as literal fixture data. That line opens with seven '<' and a space and is
# not a merge conflict — both markers sit on ONE line, which is a thing git
# never writes. A start marker that also carries an end marker is therefore
# excluded outright, and a file must show the divider and a separate end line
# before this refuses it.
#
# The divider is only ever matched as part of that conjunction, never alone:
# seven bare equals signs at column 1 is also how reStructuredText and Setext
# Markdown underline a heading, and failing every doc in the estate is how a
# gate gets switched off.
#
# Exactly seven, anchored at column 1: `<<<<<<<<` (eight — a heredoc, a C++
# stream) does not match, and neither does an indented mention inside a comment
# explaining conflict markers, which is what lets this file describe them
# without flagging itself.
#
# Tracked files only, via `git grep`, so a stray marker in an untracked scratch
# file or in node_modules cannot fail a build. `-I` skips binaries.
set -euo pipefail
cd "${1:-.}"
git rev-parse --is-inside-work-tree >/dev/null 2>&1 || {
echo "conflictmarkers: not a git work tree ($(pwd)) — skipping"; exit 0; }
# Built from variables rather than written literally, so this script is not its
# own first finding when it scans the repo that carries it.
L=$(printf '<%.0s' $(seq 7))
E=$(printf '=%.0s' $(seq 7))
R=$(printf '>%.0s' $(seq 7))
# Candidate files: those carrying a start marker that is NOT also an end marker
# on the same line. `-l` for names only; the line numbers come later, per file.
cands=$(git grep -I -l -E "^${L} " -- . || true)
bad=""
for f in $cands; do
grep -qE "^${L} " -- "$f" 2>/dev/null || continue
# The same-line form (app's fixture) is not a conflict. Require at least one
# start line that does not also carry an end marker.
grep -E "^${L} " -- "$f" 2>/dev/null | grep -qv -- "$R" || continue
# And require the rest of the shape: a bare divider and a separate end line.
grep -qE "^${E}$" -- "$f" 2>/dev/null || continue
grep -E "^${R} " -- "$f" 2>/dev/null | grep -qv -- "$L" || continue
bad="$bad $f"
done
if [ -n "$bad" ]; then
echo "::error::committed merge-conflict markers — an unresolved merge is in the tree"
for f in $bad; do
grep -nE "^(${L} |${E}$|${R} )" -- "$f" | while IFS= read -r line; do
echo " $f:$line"
done
echo "::error file=${f}::committed conflict marker"
done
echo
echo "Resolve the merge and commit the result. If the file is GENERATED, do not"
echo "hand-edit it — re-run its generator and commit that."
exit 1
fi
echo "OK: no committed conflict markers ($(git ls-files | wc -l) tracked files)"
+118
View File
@@ -0,0 +1,118 @@
#!/usr/bin/env bash
# ignoretracked — refuse a repo that ships bulk content its own .gitignore
# claims to be ignoring. One implementation, every caller.
#
# ignoretracked [dir]
#
# WHAT THIS CATCHES
#
# An ignore rule does not untrack what is already tracked. `.gitignore` is
# consulted when git decides whether to ADD an untracked path; a path already
# in the index is never reconsidered. So this arrangement is stable and silent:
#
# .gitignore says native/flags/target/
# the index says 855 files under native/flags/target/
# git status says nothing
#
# hanzoai/cloud lived there for 6 days and 16 hours. 362 MB of orphaned cargo
# output — three near-identical 37.8 MB staticlibs and a pile of .rlib — went
# into every release, took the module past Go's 500 MiB ceiling (see
# bin/modsize) and made it UNFETCHABLE for nine consecutive releases. The
# `git archive` of that commit is 202 MB against 12.5 MB today: 16x.
#
# The causal story is worth knowing because it is not carelessness, it is a
# race nobody could see. The ignore rule was REMOVED at 12:22 (the Rust
# staticlib was being dropped for a Go evaluator), the 855 files were added at
# 12:51 inside that 4.5-hour window when nothing was ignoring them, and the
# rule was RE-ADDED at 16:48. Every individual step was reasonable. The state
# they combined into is the defect, and no tool in the pipeline had an opinion
# about it.
#
# WHY THIS GATES ON BYTES AND NOT ON PRESENCE
#
# The obvious gate — "any tracked path matched by .gitignore fails" — is
# correct in principle and unshippable in fact. Measured across all 845 git
# repos in the three orgs: 155 of them (18%) carry at least one tracked file
# their .gitignore matches, and hanzoai/cloud's own origin/main is one of them
# (a bare, unanchored `tools` pattern on .gitignore:62 catches 27 legitimately
# tracked Go source files under apps/tools/). `CLAUDE.md` alone is ignored-and-
# tracked in 40 repos and is the ONLY hit in 29 of them. Turning that on as a
# hard fail breaks a fifth of the estate on day one, and a gate that fails what
# ought to pass is a gate that gets switched off — after which we are worse off
# than before it existed.
#
# So the gate is on the quantity that actually caused the outage. The byte
# distribution separates cleanly, which is why this threshold can be a refusal
# rather than a warning:
#
# worst legitimate repo in the estate 61.5 MB (hanzo/docs, vendored)
# ... next 48.8 MB, 45.8, 45.2, 43.8, 39.8
# repos over 100 MB ZERO
# the defect this gate exists for 362.0 MB
#
# Default ceiling 100 MB: green on all 845 repos today with 62% headroom over
# the worst honest case, and red on the real defect by 3.6x. Nothing to
# baseline, no allowlist, no per-repo exemptions — the tail is REPORTED (so the
# hygiene problem stays visible and shrinkable) and only the bulk is REFUSED.
#
# As repos are cleaned up, lower IGNORETRACKED_MAX_MB. It is a ratchet, and the
# end state is 0 — at which point this becomes the pure presence gate that was
# right all along. Do not start there.
#
# WHY core.excludesFile IS PINNED OFF
#
# `--exclude-standard` reads THREE sources: the repo's committed .gitignore
# files, .git/info/exclude, and the user's global core.excludesFile. The last
# is per-machine, so the same commit gets different verdicts on a laptop and a
# runner — on this workstation a global bare `tags` pattern matched 1,271
# Elixir source files in lux/explorer-v1 that CI would never flag. A gate whose
# answer depends on whose machine asked is not a gate. Only committed
# .gitignore is in scope, so the global file is pinned to /dev/null.
# (.git/info/exclude is per-clone and is the stock all-comments template on a
# fresh CI checkout; it cannot be overridden by -c, and is left alone.)
#
# EXIT: 0 clean or under the ceiling (findings still reported), 1 over it.
set -uo pipefail
MAX_MB=${IGNORETRACKED_MAX_MB:-100}
root=${1:-.}
cd "$root" 2>/dev/null || { echo "ignoretracked: no such directory: $root" >&2; exit 1; }
git rev-parse --git-dir >/dev/null 2>&1 || exit 0 # not a repo: nothing to check
tmp=$(mktemp -d); trap 'rm -rf "$tmp"' EXIT
# -s gives "<mode> <sha> <stage>\t<path>", which carries the blob id — so the
# size comes from cat-file and needs no working-tree stat (correct on a bare or
# sparse checkout, and unaffected by anything a build has written).
git -c core.excludesFile=/dev/null ls-files -s --cached --ignored --exclude-standard \
> "$tmp/ls" 2>/dev/null || exit 0
[ -s "$tmp/ls" ] || { echo "ignoretracked: OK — nothing tracked that .gitignore ignores"; exit 0; }
files=$(wc -l < "$tmp/ls")
bytes=$(awk '{print $2}' "$tmp/ls" \
| git cat-file --batch-check='%(objectsize)' --buffer 2>/dev/null \
| awk '/^[0-9]+$/{s+=$1} END{print s+0}')
mb=$(awk -v b="${bytes:-0}" 'BEGIN{printf "%.1f", b/1048576}')
# WHICH .gitignore LINE is doing this. Plain `check-ignore` prints nothing for a
# tracked path (it answers "would git ignore this if it were untracked", and a
# tracked path short-circuits) — --no-index is what makes it answer for the
# files we actually have. The output names source:line:pattern, so the report
# points at the line to edit instead of at 855 paths to read.
cut -f2- "$tmp/ls" | git -c core.excludesFile=/dev/null check-ignore --no-index -v --stdin \
> "$tmp/why" 2>/dev/null || true
echo "ignoretracked: ${files} tracked file(s), ${mb} MB, matched by this repo's own .gitignore"
if [ -s "$tmp/why" ]; then
echo " by rule (top 10):"
awk -F'\t' '{n[$1]++} END{for (k in n) printf "%8d %s\n", n[k], k}' "$tmp/why" \
| sort -rn | head -10
fi
limit=$(( MAX_MB * 1048576 ))
if [ "${bytes:-0}" -ge "$limit" ]; then
echo "::error::${mb} MB of tracked content is matched by this repo's own .gitignore — over the ${MAX_MB} MB ceiling. An ignore rule does not untrack what is already tracked, so this ships in every release and every module zip while \`git status\` stays clean. Fix: \`git rm -r --cached <path>\` and commit (the working tree is untouched). If the content is meant to be tracked, un-ignore it instead — negate the rule with \`!<path>\` — so the two stop disagreeing."
exit 1
fi
echo "ignoretracked: OK — ${mb} MB is under the ${MAX_MB} MB ceiling (reported, not blocking)"
exit 0
Executable
+123
View File
@@ -0,0 +1,123 @@
#!/usr/bin/env bash
# modsize — refuse a Go module that is approaching the size at which Go can no
# longer fetch it. One implementation, every caller.
#
# modsize [dir] # default: every module in the repo, from the root
#
# WHAT THIS CATCHES
#
# Go's module ceiling is not a soft limit and not a warning. From
# golang.org/x/mod/zip (and, identically, cmd/go/internal/modfetch/codehost):
#
# MaxZipFile = 500 << 20 // 524288000 bytes, 500 MiB
#
# and it is enforced THREE ways on the same number — the zip file itself, the
# total uncompressed size of the files inside it, and (in CheckDir) the running
# sum of the source tree's file sizes:
#
# "module source tree too large (max size is 524288000 bytes)"
# "total uncompressed size of module contents too large (...)"
#
# hanzoai/cloud crossed it and became UNFETCHABLE for nine consecutive
# releases. Nothing said so. The module publishes fine — the ceiling is
# enforced on the CONSUMER, at `go get`, so the failure surfaces in someone
# else's repo, at a version they did not choose, long after the release that
# caused it. There is no signal at the publishing end at all, which is why nine
# releases went out before anybody knew.
#
# WHY THIS SUMS RAW BYTES AND WHY THAT IS EXACT, NOT AN APPROXIMATION
#
# It would be reasonable to assume the limit is on the compressed zip and that
# summing uncompressed bytes over-counts. It does not: zip.CheckDir accumulates
# `info.Size()` — the raw, uncompressed size of each regular file — and fails
# when that running total exceeds MaxZipFile. So the sum of file sizes IS one
# of the three quantities Go bounds, and a git blob's size is exactly that
# file's uncompressed size. This gate therefore measures the same number Go
# measures, not a proxy for it.
#
# WHAT IT EXCLUDES, AND WHY EACH EXCLUSION IS REQUIRED FOR CORRECTNESS
#
# • Nested modules. A subdirectory with its own go.mod is a DIFFERENT module
# and its bytes are not in the parent's zip. Counting them would fail a
# repo that is nowhere near the limit — hanzoai/s3 is this shape (it builds
# s3-rdma-sidecar/ and telemetry/server/ from their own go.mod files), and
# a gate that fails a repo that would have worked is a gate people learn to
# skip. Each nested module is instead checked on its own terms.
# • Symlinks and gitlinks (submodules). zip.CheckDir skips both — symlinks
# explicitly (golang.org/issue/27093), submodules because they are not
# files. Counting a gitlink's 20-byte entry would be harmless; counting a
# symlink's target as content would not.
#
# It reads tracked content only (git ls-tree), because that is what a module
# zip is built from: the proxy serves what the VCS has at that tag, not what a
# working tree happens to contain.
#
# THE THRESHOLD IS BELOW THE CEILING ON PURPOSE
#
# Failing AT 500 MiB would be useless — at that point the module is already
# unfetchable and the only question left is how many releases shipped broken.
# The gate refuses at MODSIZE_MAX_PCT (default 80%, ~419 MiB), which is the
# "warn well before" — spelled as a refusal, because a warning about a cliff
# nobody is watching is the same defect one level up. 105 MiB of headroom is
# several releases' worth of honest growth, so this fires with room to fix it
# calmly and never fires the release it would have broken.
#
# EXIT: 0 clean, 1 when a module is at or past the threshold.
set -uo pipefail
# 500 << 20, from golang.org/x/mod/zip. Not a guess and not rounded: the
# constant is quoted so a reader can check it against the source.
CEILING=$((500 << 20))
PCT=${MODSIZE_MAX_PCT:-80}
REF=${MODSIZE_REF:-HEAD}
root=${1:-.}
cd "$root" 2>/dev/null || { echo "modsize: no such directory: $root" >&2; exit 1; }
git rev-parse --git-dir >/dev/null 2>&1 || exit 0 # not a repo: nothing to measure
# Every go.mod in the tree, at REF. The root module is "go.mod"; anything else
# is a nested module and marks a prefix the parent must not count.
mods=$(git ls-tree -r --name-only "$REF" 2>/dev/null | grep -E '(^|/)go\.mod$' | sort) || exit 0
[ -z "$mods" ] && exit 0
# path<TAB>size for every regular tracked file. Mode 100644/100755 only:
# 120000 is a symlink and 160000 a gitlink, both of which zip.CheckDir omits.
# `git ls-tree -l` separates the path with a TAB, so split on that rather than
# on whitespace: a path with spaces in it must survive intact.
sizes=$(git ls-tree -r -l "$REF" 2>/dev/null \
| sed -n 's/^\([0-9]\{6\}\) blob \([0-9a-f]*\) *\([0-9-]*\)\t\(.*\)$/\1\t\3\t\4/p' \
| awk -F'\t' '$1=="100644"||$1=="100755"{print $3 "\t" $2}')
human() { awk -v b="$1" 'BEGIN{ printf "%.1f MiB", b/1048576 }'; }
rc=0
for gm in $mods; do
if [ "$gm" = "go.mod" ]; then mdir=""; else mdir="${gm%/go.mod}/"; fi
# The prefixes this module must NOT count: every OTHER module nested under it.
nested=$(printf '%s\n' "$mods" | while read -r o; do
[ "$o" = "$gm" ] && continue
od="${o%go.mod}"
case "$od" in "$mdir"?*) printf '%s\n' "$od";; esac
done)
total=$(printf '%s\n' "$sizes" | awk -F'\t' -v m="$mdir" -v nl="$nested" '
BEGIN{ n=split(nl, arr, "\n") }
{
p=$1
if (m != "" && index(p, m) != 1) next # not in this module
for (i=1; i<=n; i++) if (arr[i] != "" && index(p, arr[i]) == 1) next # nested module
s += $2
}
END{ print s+0 }')
limit=$(( CEILING * PCT / 100 ))
name=${mdir:-./}
if [ "$total" -ge "$CEILING" ]; then
echo "::error file=${gm}::module ${name} is $(human "$total") of tracked content — PAST Go's $(human $CEILING) module ceiling. It is already unfetchable: \`go get\` fails with 'module source tree too large (max size is ${CEILING} bytes)' in every consumer, at every version that carries it. Find the bulk with: git ls-tree -r -l ${REF} | sort -k4 -n | tail -20"
rc=1
elif [ "$total" -ge "$limit" ]; then
echo "::error file=${gm}::module ${name} is $(human "$total") of tracked content — ${PCT}% of Go's $(human $CEILING) ceiling, $(human $((CEILING-total))) of headroom left. Past the ceiling the module stops being fetchable AT THE CONSUMER, so the break shows up in someone else's build and not in this one. Find the bulk with: git ls-tree -r -l ${REF} | sort -k4 -n | tail -20"
rc=1
else
echo "modsize: OK — ${name} $(human "$total") ($(( total * 100 / CEILING ))% of $(human $CEILING))"
fi
done
exit $rc
Executable
+238
View File
@@ -0,0 +1,238 @@
#!/usr/bin/env bash
# sitedeploy — publish a built static export to the Hanzo PaaS Sites plane.
# One implementation, every static site.
#
# sitedeploy <slug> <dir> # e.g. sitedeploy hanzo-ai out
#
# WHY THIS IS A SCRIPT AND NOT INLINE SHELL: the same forty lines of enqueue →
# upload → complete were about to be pasted into hanzo.ai, hanzo.app, hips,
# computer and every static surface after them. Written N times it is right N-1
# times and then wrong once — which is exactly how `sha-<short>` became the only
# tag eleven repos ever published (see bin/imgver). The plane's contract lives
# here, once.
#
# THE THREE STEPS, and why the bytes never pass through the API:
#
# POST /v1/projects/<slug>/deploy -> 202 {id, bucket, prefix, upload}
# POST <upload.url> per file -> the bytes, straight to S3
# POST /v1/projects/<slug>/deployments/<id>/complete
#
# A real export is large — hanzo.ai is 128 MB across 8403 files — and cloud's
# BodyLimit is 16 MiB, so an artifact POST is refused by fasthttp BEFORE any
# handler runs, and it fails as an opaque 400 "Error when parsing request" that
# reads like a malformed payload rather than a size cap. The git source is the
# documented route for exactly this shape.
#
# NO STANDING S3 CREDENTIAL. The 202 carries `upload`: a presigned POST policy
# that is prefix-scoped (starts-with $key "<org>/<slug>/", enforced by S3 itself),
# short-lived (30 min) and size-bounded. That replaced handing every repo the
# bucket's own long-lived access key — one key for a bucket whose only tenant
# separation is the key prefix, so every repo holding it could overwrite EVERY
# org's site (cloud apps/projects/grant.go). Do not reintroduce SITES_S3_* here.
# HANZO_DEPLOY_TOKEN is the ONE credential this needs.
#
# DELETION IS THE SERVER'S. The grant authorizes writes only, so CI cannot remove
# a file; `keys` in the completion is the manifest cloud reconciles the prefix
# against, and it deletes what the build no longer produces. That is where
# `aws s3 sync --delete` went. It fails CLOSED on an empty manifest, and so does
# this script — a build that enumerated nothing has failed, and honouring it
# literally would delete the live site.
#
# ENV: HANZO_DEPLOY_TOKEN (required) the org-scoped `sk-` key; mint at POST /v1/keys
# HANZO_API (https://api.hanzo.ai)
# SITEDEPLOY_JOBS (24) parallel uploads
# SITEDEPLOY_COMMIT / SITEDEPLOY_BRANCH recorded on the deployment
# SITEDEPLOY_PLAN=1 print the manifest and exit; no network. The test seam.
set -euo pipefail
slug="${1:?usage: sitedeploy <slug> <dir>}"
dir="${2:?usage: sitedeploy <slug> <dir>}"
api="${HANZO_API:-https://api.hanzo.ai}"
jobs="${SITEDEPLOY_JOBS:-24}"
[ -d "$dir" ] || { echo "::error::$dir is not a directory — the build produced no export"; exit 1; }
# ---- content type -----------------------------------------------------------
# The presigned POST carries no Content-Type condition, so whatever CI sends is
# what the object stores — and what it stores is what the edge serves. Send
# nothing and every page is application/octet-stream, which a browser DOWNLOADS
# instead of rendering: a green deploy that serves an unusable site.
ctype() {
case "${1##*.}" in
html|htm) echo 'text/html; charset=utf-8' ;;
css) echo 'text/css; charset=utf-8' ;;
js|mjs) echo 'text/javascript; charset=utf-8' ;;
json) echo 'application/json; charset=utf-8' ;;
xml) echo 'application/xml; charset=utf-8' ;;
txt) echo 'text/plain; charset=utf-8' ;;
svg) echo 'image/svg+xml' ;;
png) echo 'image/png' ;;
jpg|jpeg) echo 'image/jpeg' ;;
gif) echo 'image/gif' ;;
webp) echo 'image/webp' ;;
avif) echo 'image/avif' ;;
ico) echo 'image/x-icon' ;;
woff) echo 'font/woff' ;;
woff2) echo 'font/woff2' ;;
ttf) echo 'font/ttf' ;;
otf) echo 'font/otf' ;;
wasm) echo 'application/wasm' ;;
pdf) echo 'application/pdf' ;;
webmanifest) echo 'application/manifest+json' ;;
map) echo 'application/json' ;;
*) echo 'application/octet-stream' ;;
esac
}
# ---- cache control ----------------------------------------------------------
# Mirrors cloud's apps/sites.CacheControlFor so a site cached the same whichever
# route its bytes took. bin/sitedeploy_test.sh pins these strings; if the server
# changes its policy the test is what catches the drift.
#
# A fingerprinted asset (Vite/Next/webpack emit app.4f3a9c21.js) is immutable: a
# new build changes the hash, so the old URL can be cached forever.
#
# The class is written `[._-]` with the dash LAST and the pattern held in a
# variable. Go's regexp spells the same set `[.\-_]`, and transcribing that
# literally into `[[ =~ ]]` is a silent defect twice over: a backslash is literal
# inside a POSIX bracket expression, so `\-_` reads as the RANGE \…_ and the shell
# rejects it as "invalid character range" — and because the `if` merely evaluates
# false, every fingerprinted asset quietly fell back to max-age=3600 instead of
# immutable. An unquoted inline pattern also has its own quoting hazards; the
# variable form is the one that is read as a regex rather than a glob.
fingerprint_re='[._-][0-9a-fA-F]{8,}\.[a-z0-9]+$'
cachectl() {
local k="$1" base="${1##*/}"
case "${k##*.}" in
html|htm) echo 'public, max-age=60, s-maxage=86400' ;;
js|mjs|css|woff|woff2|png|jpg|jpeg|gif|svg|webp|avif|ico|ttf|otf|wasm|data|pck|unityweb|mem)
if [[ "$base" =~ $fingerprint_re ]]; then
echo 'public, max-age=31536000, immutable'
else
echo 'public, max-age=3600'
fi ;;
*) echo 'public, max-age=3600' ;;
esac
}
# ---- the manifest -----------------------------------------------------------
# Paths RELATIVE to the export root, which is exactly what the completion's
# `keys` must carry (cloud reconciles `keep[rel]` against them).
#
# CNAME does not travel. It is a GitHub Pages artifact that means nothing to S3
# and would ship a stale hostname claim into the bucket.
manifest=$(cd "$dir" && find . -type f ! -name CNAME | sed 's|^\./||' | LC_ALL=C sort)
count=$(printf '%s' "$manifest" | grep -c . || true)
[ "$count" -gt 0 ] || { echo "::error::$dir contains no files — refusing to deploy an empty manifest"; exit 1; }
if [ -n "${SITEDEPLOY_PLAN:-}" ]; then
printf 'slug=%s dir=%s files=%s\n' "$slug" "$dir" "$count"
while IFS= read -r k; do [ -n "$k" ] && printf '%s\t%s\t%s\n' "$k" "$(ctype "$k")" "$(cachectl "$k")"; done <<< "$manifest"
exit 0
fi
: "${HANZO_DEPLOY_TOKEN:?HANZO_DEPLOY_TOKEN is unset. It is the ONE credential this needs; set it on the forge (git.hanzo.ai), which is what reads .hanzo/workflows — not on GitHub. Mint: POST /v1/keys {\"type\":\"secret\"}}"
# ---- 0. ensure the project exists (self-provision) --------------------------
# A brand-new slug has no project, and the enqueue below 404s on a missing one —
# which is why every never-before-deployed site failed its first run. Create it
# idempotently here instead: 200/201 the first time, 409 every time after, both
# success. So a new site needs no out-of-band `POST /v1/projects`; committing the
# workflow is enough. The repo is linked because the git-source enqueue requires
# a linked project (deployGit rejects an unlinked one); SITEDEPLOY_REPO overrides
# the origin for a forge checkout whose remote is not the canonical repo.
repo="${SITEDEPLOY_REPO:-$(git remote get-url origin 2>/dev/null || true)}"
pcode=$(curl -sS -o /tmp/sd-proj.json -w '%{http_code}' \
-X POST "$api/v1/projects" \
-H "Authorization: Bearer $HANZO_DEPLOY_TOKEN" -H 'Content-Type: application/json' \
-d "$(jq -nc --arg s "$slug" --arg u "$repo" --arg b "${SITEDEPLOY_BRANCH:-main}" \
'{slug:$s, name:$s} + (if $u=="" then {} else {repo:{url:$u, branch:$b}} end)')")
case "$pcode" in
200|201|409) : ;; # created now, or already there — either is the state we need
*) echo "::error::ensure project $slug returned HTTP $pcode"; head -c 400 /tmp/sd-proj.json; echo; exit 1 ;;
esac
# ---- 1. enqueue -------------------------------------------------------------
# 202 Accepted is the success code: the deployment is queued, not live. bucket
# and prefix come FROM cloud (sitePrefix(org, slug) is server-side) — never guess
# them, or the upload lands where nothing is served the moment an org or slug
# changes.
code=$(curl -sS -o /tmp/sd-enq.json -w '%{http_code}' \
-X POST "$api/v1/projects/$slug/deploy" \
-H "Authorization: Bearer $HANZO_DEPLOY_TOKEN" -H 'Content-Type: application/json' \
-d "{\"source\":\"git\",\"commit\":\"${SITEDEPLOY_COMMIT:-}\",\"branch\":\"${SITEDEPLOY_BRANCH:-main}\"}")
if [ "$code" != "202" ]; then
echo "::error::enqueue $api/v1/projects/$slug/deploy returned HTTP $code"; head -c 600 /tmp/sd-enq.json; echo; exit 1
fi
dep=$(jq -r '.id' /tmp/sd-enq.json)
prefix=$(jq -r '.prefix' /tmp/sd-enq.json)
upload_url=$(jq -r '.upload.url // empty' /tmp/sd-enq.json)
if [ -z "$upload_url" ]; then
echo "::error::the 202 carried no upload grant, so there is no way to write the bytes."
echo " cloud mints one only when presigning is configured (S3_ADMIN_* on the cloud deployment)."
exit 1
fi
jq -c '{id,version,status,bucket,prefix}' /tmp/sd-enq.json
# A build that dies after this point would leave the deployment "queued" and the
# project stuck "building" forever. Report the failure so cloud records an honest
# terminal state instead of a lie by omission.
fail() {
curl -sS -X POST "$api/v1/projects/$slug/deployments/$dep/complete" \
-H "Authorization: Bearer $HANZO_DEPLOY_TOKEN" -H 'Content-Type: application/json' \
-d '{"status":"error","message":"CI upload failed"}' >/dev/null 2>&1 || true
echo "::error::marked deployment $dep as error"
}
trap 'fail' ERR
# ---- 2. the bytes -----------------------------------------------------------
# `file` goes LAST: S3 ignores every field after the file part, so a grant field
# trailing the body is silently dropped and the signature check fails.
#
# `key` is DROPPED from the grant's fields and re-sent per object. The grant
# carries key="<org>/<slug>/" — the starts-with PLACEHOLDER, not a destination —
# and forwarding it verbatim alongside the real key posts `key` twice, which S3
# answers 400 for every object. That is the whole of the first end-to-end run:
# 8403 files, 8403 400s. Everything else in the map (bucket, policy, x-amz-*) is
# covered by the signature and must travel untouched.
jq -r '.upload.fields | to_entries[] | select(.key != "key") | "-F\n\(.key)=\(.value)"' /tmp/sd-enq.json > /tmp/sd-fields
put() {
local rel="$1" args=() line
# A read loop, NOT `mapfile`: mapfile is bash 4+, and macOS ships bash 3.2, so
# on a dev box it fails as `command not found`, the array stays EMPTY, and every
# upload goes out with no policy or signature at all. S3 then rejects it for a
# malformed X-Amz-Credential — an error that points at the credential rather
# than at the array that never got built.
while IFS= read -r line; do args+=("$line"); done < /tmp/sd-fields
curl -sS --fail-with-body -o /dev/null \
-X POST "$UP_URL" \
-F "key=$PREFIX/$rel" "${args[@]}" \
-F "Content-Type=$(ctype "$rel")" -F "Cache-Control=$(cachectl "$rel")" \
-F "file=@$DIR/$rel" \
|| { echo "::error::upload failed: $rel"; return 1; }
}
export -f put ctype cachectl
export UP_URL="$upload_url" PREFIX="$prefix" DIR="$dir" fingerprint_re
echo "uploading $count files to s3://$(jq -r .bucket /tmp/sd-enq.json)/$prefix ($jobs parallel)"
printf '%s\n' "$manifest" | grep . | xargs -P "$jobs" -I{} bash -c 'put "$@"' _ {}
# ---- 3. flip it live --------------------------------------------------------
# `wc -c`, not `stat`: the size flag is spelled -f%z on BSD and -c%s on GNU, and a
# `stat -f%z || stat -c%s` fallback does not work — on Linux the first arm fails
# INSIDE the pipeline, awk still exits 0, and the `||` never fires, so the byte
# count silently reports 0. wc is the one spelling both agree on.
bytes=$(cd "$dir" && find . -type f ! -name CNAME -exec wc -c {} + | awk '$2!="total"{s+=$1} END{print s+0}')
jq -n --arg c "${SITEDEPLOY_COMMIT:-}" --argjson f "$count" --argjson b "${bytes:-0}" \
--args '{status:"live",commit:$c,files:$f,bytes:$b,keys:$ARGS.positional}' \
$(printf '%s\n' "$manifest" | grep .) > /tmp/sd-done.json
code=$(curl -sS -o /tmp/sd-resp.json -w '%{http_code}' \
-X POST "$api/v1/projects/$slug/deployments/$dep/complete" \
-H "Authorization: Bearer $HANZO_DEPLOY_TOKEN" -H 'Content-Type: application/json' \
--data-binary @/tmp/sd-done.json)
trap - ERR
if [ "$code" != "200" ]; then
echo "::error::complete returned HTTP $code"; head -c 600 /tmp/sd-resp.json; echo; fail; exit 1
fi
jq -c '{status,liveUrl,version,files,bytes}' /tmp/sd-resp.json
+80
View File
@@ -0,0 +1,80 @@
#!/usr/bin/env bash
# Tests for bin/sitedeploy. Runs OFFLINE: SITEDEPLOY_PLAN=1 stops the script
# before the first network call and prints the manifest it would upload, so every
# case here is deterministic and needs no token, no bucket and no cluster.
# Run: bash bin/sitedeploy_test.sh
set -uo pipefail
cd "$(dirname "$0")/.."
SD="$PWD/bin/sitedeploy"
tmp=$(mktemp -d); trap 'rm -rf "$tmp"' EXIT
fail=0
plan() { SITEDEPLOY_PLAN=1 bash "$SD" a-slug "$1" 2>&1; }
t() { # t <name> <got> <want>
if [ "$2" = "$3" ]; then printf 'ok %-56s -> %s\n' "$1" "$2"
else printf 'FAIL %-56s -> %s (want %s)\n' "$1" "$2" "$3"; fail=1; fi
}
# field <dir> <key> <col> — the ctype (2) or cachectl (3) column for one key
field() { plan "$1" | awk -F'\t' -v k="$2" -v c="$3" '$1==k{print $c}'; }
site="$tmp/site"; mkdir -p "$site/assets" "$site/nested/deep"
echo '<h1>hi</h1>' > "$site/index.html"
echo 'body{}' > "$site/assets/app.4f3a9c21.css"
echo 'x' > "$site/assets/plain.css"
echo 'y' > "$site/assets/chunk-AB12CD34.js"
echo '{}' > "$site/data.json"
echo 'z' > "$site/nested/deep/page.html"
echo 'hanzo.ai' > "$site/CNAME"
# --- the manifest ------------------------------------------------------------
# Keys are RELATIVE to the export root: cloud reconciles keep[rel] against them,
# so a leading ./ or an absolute path would match nothing and the completion
# would prune the entire live site.
t "keys are relative, no leading ./" "$(plan "$site" | awk -F'\t' 'NR>1&&$1~/^\.?\//{print "ABS"}' | head -1)" ""
t "nested paths keep their subdirs" "$(plan "$site" | awk -F'\t' '$1=="nested/deep/page.html"{print "yes"}')" "yes"
# CNAME is a GitHub Pages artifact: it means nothing to S3 and would ship a stale
# hostname claim into the bucket.
t "CNAME does not travel" "$(plan "$site" | awk -F'\t' '$1=="CNAME"{print "leaked"}')" ""
t "file count excludes CNAME" "$(plan "$site" | head -1 | grep -o 'files=[0-9]*')" "files=6"
# --- content type ------------------------------------------------------------
# The presigned POST carries no Content-Type condition, so what CI sends is what
# the object stores and what the edge serves. Send nothing and a browser
# DOWNLOADS every page instead of rendering it.
t "html" "$(field "$site" index.html 2)" "text/html; charset=utf-8"
t "css" "$(field "$site" assets/plain.css 2)" "text/css; charset=utf-8"
t "js" "$(field "$site" assets/chunk-AB12CD34.js 2)" "text/javascript; charset=utf-8"
t "json" "$(field "$site" data.json 2)" "application/json; charset=utf-8"
# --- cache control: mirrors cloud apps/sites.CacheControlFor -----------------
# These strings are the SERVER's policy, pinned here so the two cannot drift
# apart silently. If cloud changes CacheControlFor, this is what goes red.
t "html is short-lived, long at the edge" "$(field "$site" index.html 3)" "public, max-age=60, s-maxage=86400"
t "unfingerprinted asset is an hour" "$(field "$site" assets/plain.css 3)" "public, max-age=3600"
# The regression this pins: Go spells the class [.\-_], and transcribing that
# into [[ =~ ]] makes the shell reject it as an invalid character range. The `if`
# then merely evaluates false, so every hashed asset silently lost `immutable`.
t "fingerprinted .hash. is immutable" "$(field "$site" assets/app.4f3a9c21.css 3)" "public, max-age=31536000, immutable"
t "fingerprinted -HASH- is immutable" "$(field "$site" assets/chunk-AB12CD34.js 3)" "public, max-age=31536000, immutable"
# --- fail closed -------------------------------------------------------------
# reconcilePrefix deletes whatever the manifest omits, so an empty manifest is a
# request to delete the live site. A build that enumerated nothing has failed.
empty="$tmp/empty"; mkdir -p "$empty"
plan "$empty" >/dev/null 2>&1
t "empty export is refused" "$?" "1"
only_cname="$tmp/onlycname"; mkdir -p "$only_cname"; echo x > "$only_cname/CNAME"
plan "$only_cname" >/dev/null 2>&1
t "a dir holding only CNAME is empty too" "$?" "1"
plan "$tmp/does-not-exist" >/dev/null 2>&1
t "missing export dir is refused" "$?" "1"
# --- the credential ----------------------------------------------------------
# Not in PLAN mode (that is the offline seam), but a real run must refuse to
# start rather than enqueue a deployment it cannot complete.
out=$(HANZO_DEPLOY_TOKEN= bash "$SD" a-slug "$site" 2>&1); rc=$?
t "no token: exits non-zero" "$rc" "1"
t "no token: says which secret" "$(printf '%s' "$out" | grep -c HANZO_DEPLOY_TOKEN)" "1"
[ $fail -eq 0 ] && echo "PASS" || echo "FAIL"
exit $fail