Repository navigation
Description
Refs hivecommons/crux#114 · RFC #13536 · tracker #14138 · publishing doc src/docs/crux-publish.md
Status: RFC only. Per the maintainer, nothing is ported until 2026-11-16. This issue is the plan, the inventory and the checklist; no branch, PR, tag, workflow change or crux push has been made for it. The flip is Monday 2026-11-16; 11-09 → 11-13 is prep and the window for the phase-1 work-services PRs (S0/S1/S2/S7) to land in hive src/crux.
Goal
Make hivecommons/crux the source-of-truth repository for the Crux agent runtime. Development moves there; hive consumes github.com/hivecommons/crux as an ordinary Go dependency. The publish/sync pipeline (src/scripts/crux-publish.sh + .github/workflows/crux-sync.yml) is retired.
1. Inventory of the coupling (measured on origin/v5 @ 22f9f1d59, 2026-11-07)
Module graph
| Piece | Today |
|---|---|
src/go.work |
use ( . ./crux ) — the two-module workspace (#13536 Stage 2) |
src/go.mod:100,102 |
require github.com/hivecommons/hive/crux v0.0.0-00010101000000-000000000000 + replace github.com/hivecommons/hive/crux => ./crux |
src/crux/go.mod |
module github.com/hivecommons/hive/crux, go 1.26.10, 49 packages, 791 .go files, requires nats-server/v2 v2.15.2 + nats.go v1.55.0 (the lanes JetStream code) |
| Crux → root module imports | 0 (src/crux never imports `github.com/hivecommons/hive/pkg |
Import sites in the root module (src/, excluding src/crux)
- 279 Go files import
github.com/hivecommons/hive/crux…(128 non-test, 151 test). - 422 import lines, across 36 distinct crux packages. Top:
crux160,crux/cruxtest61,crux/logscrub32,crux/toolapprove24,crux/watchdog17,crux/config12,crux/proxy11,crux/agentparse10,crux/runtime9,crux/openrouter8,crux/api/callback8,crux/watsonx7,crux/effects7,crux/claude6,crux/api6,crux/skillreg5,crux/pushbroker5 …crux/lanes2,crux/kubejob2,crux/agent/tmux1. - Non-Go references to the old module path:
src/go.mod,src/go.work,src/internal/testutil/dashboard_import_allowlist.txt(listsgithub.com/hivecommons/hive/crux+crux/<pkg>as allowed dashboard imports),src/docs/design/crux.md,src/docs/crux-cli.md,src/docs/crux-serve.md,src/docs/crux-publish.md,src/scripts/crux-publish.sh,src/scripts/test-crux-publish-keep.sh.
Publish pipeline (hive side)
src/scripts/crux-publish.sh(136 lines): clears a crux checkout exceptKEEP=(.git .github .goreleaser.yaml Dockerfile Dockerfile.goreleaser LICENSE README.md .gitignore .golangci.yml .dockerignore runbooks), rsyncssrc/cruxin, movessrc/crux/README.md→docs/MODULE.md, rewritesgithub.com/hivecommons/hive/crux→github.com/hivecommons/cruxingo.modand every*.go, writes.hive-sync, thenGOWORK=off go build ./... && go vet ./... && go mod tidy..github/workflows/crux-sync.yml: triggerspush: branches [v5], paths: src/crux/**, src/scripts/crux-publish.sh, the workflow,push: tags crux/v*,workflow_dispatch(hasdry_run). Secrets:CRUX_SYNC_TOKEN(fallbackTOPUP_PUSH_TOKEN). One commit per sync onto cruxmainashive-release[bot]; acrux/vX.Y.Ztag pushes tagvX.Y.Zto crux at the already-synced commit (never movesmain). Registered in.github/release-lines.yml:148-152ascrux-sync.yml: [-v4].- Last five runs today (2026-11-07 04:22 → 15:02 UTC) all
success; cruxmain=fe54cd5= hivec549296b8cfb(per.hive-sync).
Crux repo today (hivecommons/crux)
- Default branch
main, public, issues on. Every commit is a sync commit (🌱 sync: hive@<sha> (src/crux));.hive-syncsays "File issues and pull requests in hivecommons/hive". - Releases:
v0.1.0(2026-10-25),v0.2.0(2026-10-29),v0.3.0(2026-11-04, hivea6fc111b02ad).mainis 25 sync commits ahead ofv0.3.0. - Hand-maintained scaffolding:
.github/workflows/{ci,release,sync-guard}.yml,.github/scripts/{check-action-pins,check-file-size-ratchet,coverage-floors}.sh(+ self-tests),.github/go-file-size-ratchet.txt,.goreleaser.yaml,Dockerfile,Dockerfile.goreleaser,.golangci.yml,runbooks/,README.md. ci.ymlalready runs: "Module is standalone" (GOWORK=off),go test -short -raceall-but-agent on ubuntu+macos,./agent/...on ubuntu-24.04 with tmux, coverage floors (coverage-floors.shwithTHRESHOLD=90and per-package floorscrux/agent=89 crux/proxy=89 crux/sandbox=98 crux/pushbroker=99 crux/kubejob=90 cmd/crux=75 crux/cli=92— identical to hive'scoverage-hourly.yml), golangci-lint, govulncheck, gosec, action-pins, Go file-size ratchet,crux servesmoke (scripts/smoke.sh).sync-guard.yml: fails any PR from a non-hive-release[bot]actor that touches anything outside the scaffolding allowlist and comments "open this against hivecommons/hive". This must go on flip day or nobody can develop there.release.yml+.goreleaser.yaml: on tagv*→ darwin/linux × amd64/arm64, cosign, GitHub release,ghcr.io/hivecommons/crux. Unaffected by the cutover.- Labels already present: full
stage/*,role/*,author/*,dco/no-dco,needs-rebase,size/*— i.e. hive already manages hivecommons/crux (recent crux PRs fix: split long kick messages into sub-kicks for reliable delivery #109–fix: remove lock button, use pin-in/out pill as toggle #123 are byapp/hivecommons-hive; crux#66 appeared in the hive dashboard). Open: only crux#114 (RFC,stage/010-actionable,approved-direction). No open PRs. - Missing in crux:
changelog.d/+ fragment guard, DCO check (hive'sdco/no-dcolabels are applied by hive, but no required status), CONTRIBUTING/AGENTS guidance, docs beyonddocs/MODULE.md+ runbooks.
Hive CI / build surfaces that address ./crux/...
v2-ci.yml:195-214,244: builds./cmd/crux(root host) and(cd crux && GOWORK=off go build ./cmd/crux); runs(cd crux && GOWORK=off go test -race ./lanes ./api ./serve); crux smoke (working-directory: src/crux);go vet ./... ./crux/....v2-tests.yml:94-203, 838-1001:crux/agentsliced N ways (TEST_PACKAGE=github.com/hivecommons/hive/crux/agent,go test -c -race -cover ./crux/agent);.github/scripts/crux-scope.sh(72 lines) classifies PR diffs as crux-only / mixed / non-crux;.github/scripts/affected-go-packages.sh:25-151lists./crux/...and treatscrux/go.mod|go.sumas module-graph changes.coverage-hourly.yml:196,222-322,348-371: tests./crux/...and keys floors ascrux/<pkg>(the 7 floors above).crux-file-size-ratchet.yml: sparse-checks-outsrc/cruxand runs crux's ratchet script pinned to crux13372ca7(2026-10-29).go-security-analysis.yml:194,276-327:govulncheck ./... ./crux/..., a separate "Scan crux module" gosec stepworking-directory: src/crux, CodeQL/args: ./... ./crux/....- Docker:
src/Dockerfile:40COPY src/crux/go.mod src/crux/go.sum ./crux/(needed because of thereplace),:86builds/cruxfrom root./cmd/crux(hive's host binary,src/cmd/crux/definitions.go),:564ships/usr/local/bin/crux;src/Dockerfile.contributor:43,51,553builds./crux/cmd/crux(the module's own binary) for the contributor image;.oss-scanner/Dockerfile:57-84builds/tests./crux/...and names./crux/proxy/... ./crux/logscrub/... ./crux/pushbroker/... ./crux/sandbox/... ./crux/toolapprove/...;src/scripts/generate-notice.sh:175(NOTICE generation over./... ./crux/...). Justfile:344-2482only invokes thecruxbinary (cline-turn) — unaffected by module path.- Docs: 22 files under
src/docs/carry 165src/crux/...citations (design/crux.md,crux-cli.md,crux-serve.md,crux-publish.md,security-model.md,design/agent-host-confinement.md,design/crux-tool-policy.md,adr/0026-…,troubleshooting.md, …).src/scripts/check-docs-citations.pyverifies every repo-localpath:linecitation exists → all 165 become DRIFT the momentsrc/cruxis deleted (it ignores URLs, so the fix is to rewrite them tohttps://github.com/hivecommons/crux/blob/<tag>/<path>#L<n>).AGENTS.md:10-11andCONTRIBUTING.md:24,64-68describe the two-module workspace. - Guards:
src/scripts/edits require re-pinningTRUSTED_SCRIPTS_TREEin.github/scripts/integration-governance.cjs:12(deletingcrux-publish.sh/test-crux-publish-keep.shis such an edit).changelog-fragment-guardhas no path filter (job-level), so the flip PR needs achangelog.d/fragment.src/pkg/fleetreport/{fleetreport.go:753-810,slogfeed/slogfeed.go:31}citesrc/crux/...in comments only. No sentinel allowlist referencessrc/crux. - Branch lines:
v6-topup.ymlforward-merges v5 → v6, so v6 also carriessrc/cruxand will receive the flip by forward-merge;v4has nosrc/crux.
Hive-managed-repo knob
project.repos in hive.yaml (src/pkg/config/config.go:1005, ProjectConfig.Repos; per-agent repos: allowlist in src/docs/agent-configuration.md:283, docs/per-repo-agents.md). The hive-on-hive fleet already lists hivecommons/crux (evidence above). After the flip the change is policy, not config: agents may open code PRs against crux once sync-guard.yml is removed; specialists that today are scoped repos: [hive] for crux work should add crux.
2. The plan
Owners
- Maintainer (@clubanderson): approves the freeze, cuts tags, flips
sync-guard, merges the flip PR, re-pinsTRUSTED_SCRIPTS_TREE. - Crux CI port: one PR against crux (scaffolding only, allowed by sync-guard) — lanes/api/serve integration lane,
changelog.d/+ guard, DCO/emoji conventions, CONTRIBUTING. - Hive flip PR: one PR against hive
v5(goes to v6 by forward-merge). - Hive agents: keep triaging crux issues/PRs as today; no new config until the flip.
Phase 0 — prep (Mon 11-09 → Fri 11-13; no cutover work merges)
- Land phase-1 work-services PRs in hive
src/crux(S0, S1feat/crux-caller-principal— currently one local, unpushed commit6190572ff; S2feat/crux-contained-run— empty worktree; S7). Each publishes to cruxmainautomatically viacrux-sync. Deadline: Fri 11-13 18:00 UTC; anything not merged by then is re-targeted to crux after the flip (its import paths are rewritten with the same sed as §flip step 3). - Crux-side CI port PR (scaffolding only, passes sync-guard): add
test (lanes/api/serve) -race -timeout 3mlane mirroringv2-ci.yml:203-205; addchangelog.d/+ a port ofchangelog-fragment-guard; add DCO (git commit -s) requirement to CONTRIBUTING + a DCO status (hive'sdcolabel flow already exists);.github/release-lines.ymlequivalent is not needed (singlemain). Coverage floors already match hive's; note them as per-package floors in the crux README. - Import-rewrite dry run on a scratch branch (not pushed): the sed in §flip step 3 leaves 0 old imports in the root module (verified 2026-11-07 then reverted); the build must be re-verified on flip day against the real tag because the dry run also needs
replace github.com/hivecommons/crux => ./cruxor the tag to exist. - Write the docs-citation rewrite (165 citations → crux blob URLs pinned to the flip tag) as a script in the flip PR.
- Confirm
CRUX_SYNC_TOKEN/TOPUP_PUSH_TOKENstill have Contents:write on crux (needed once more for the final publish and the rc/v0.4.0 tag).
Phase 1 — freeze and last publish (Fri 11-13 after the last phase-1 merge; or Mon 11-16 08:00 ET if S-PRs slip)
- Announce freeze: no PR touching
src/crux/**merges after this point (hive-side: ask the sentinel/merge-train to holdsrc/cruxPRs; simplest is a maintainer/hold). - Confirm the last
crux-syncpush run is green and cruxmain.hive-syncnames the frozen hive sha. - Tag the release candidate from hive so the existing tag path does the work:
git tag crux/v0.4.0-rc.1 <frozen-v5-sha> && git push origin crux/v0.4.0-rc.1→ cruxv0.4.0-rc.1lands at the matchingmaincommit;release.ymlbuilds binaries/image. - Disable the publish workflow:
unset GITHUB_TOKEN && gh workflow disable crux-sync.yml --repo hivecommons/hive(reversible; the file is deleted in the flip PR).
Phase 2 — flip crux to source of truth (Mon 11-16, morning)
In hivecommons/crux (one PR, then direct commits by maintainers are fine):
- Delete
.hive-sync; delete.github/workflows/sync-guard.yml; set branch protection onmain(required: CI, coverage floors, DCO, changelog guard). docs/MODULE.md→ becomes the real module README content; strip the "Synced from hive … edit it there" banner; README "File issues in hive" → "here".- Tag
v0.4.0on the rc commit once CI is green:git tag -s v0.4.0 v0.4.0-rc.1^{} && git push origin v0.4.0(cruxrelease.ymlcuts the release; bumpFormula/crux.rbinhivecommons/homebrew-hive).
Phase 3 — flip hive to consume crux (Mon 11-16, same day, one PR ⚠️ crux: consume github.com/hivecommons/crux@v0.4.0, retire src/crux)
Exact sequence, run from src/ on a fresh origin/v5 worktree:
OLD=github.com/hivecommons/hive/crux NEW=github.com/hivecommons/crux TAG=v0.4.0
# 1. drop the nested module from the workspace and the replace
cat > go.work <<'EOF'
go 1.26.10
use .
EOF
sed -i '' -e "/^require ${OLD//\//\\/} v0.0.0-00010101000000-000000000000$/d" \
-e "/^replace ${OLD//\//\\/} => .\/crux$/d" go.mod
# 2. delete the vendored copy (49 pkgs, 791 files)
git rm -rq crux
# 3. rewrite the 422 import lines in 279 files (anchored on the quote; same two substitutions crux-publish.sh uses)
grep -rl --include='*.go' "\"$OLD" . | xargs sed -i '' -e "s#\"$OLD/#\"$NEW/#g" -e "s#\"$OLD\"#\"$NEW\"#g"
sed -i '' "s#$OLD#$NEW#g" internal/testutil/dashboard_import_allowlist.txt
# 4. pull the dependency
go get $NEW@$TAG && go mod tidy
gofmt -l . | head # expect nothing: sed keeps import blocks sorted (hive/crux → crux sorts earlier; run gofmt -w on any listed file)
# 5. prove it
go build ./... && go vet ./... && go test -short ./pkg/dashboard/... ./cmd/crux/...
grep -rn "\"$OLD" --include='*.go' . | grep -q . && echo "rewrite incomplete" && exit 1Then, in the same PR:
- CI:
v2-ci.yml— drop the standalone-module build (cd crux && GOWORK=off …), the./lanes ./api ./servelane, the crux smoke,./crux/...fromgo vet;v2-tests.yml— delete thecrux/agentslice jobs (TEST_PACKAGE=…/crux/agent), delete.github/scripts/crux-scope.shand its callers, drop./crux/...+crux/go.mod|go.sumfrom.github/scripts/affected-go-packages.sh;coverage-hourly.yml— drop./crux/...from the twogo testlines and the 7crux/*/cmd/cruxfloors (keepcmd/crux=75 if the root host binary stays); deletecrux-file-size-ratchet.yml;go-security-analysis.yml— drop./crux/...and the "Scan crux module" step;.github/release-lines.yml— remove thecrux-sync.ymlentry (the guard fails on a registered-but-missing workflow). - Workflows/scripts:
git rm .github/workflows/crux-sync.yml src/scripts/crux-publish.sh src/scripts/test-crux-publish-keep.sh; re-pinTRUSTED_SCRIPTS_TREEin.github/scripts/integration-governance.cjs:12togit rev-parse HEAD:src/scriptsof the post-merge tree. - Docker:
src/Dockerfile:37-40andsrc/Dockerfile.contributor:43— removeCOPY src/crux/go.mod src/crux/go.sum ./crux/;Dockerfile.contributor:51— build the crux CLI withgo install github.com/hivecommons/crux/cmd/crux@$TAG(orgo build github.com/hivecommons/crux/cmd/cruxfrom the root module, which now requires it);.oss-scanner/Dockerfile:57-84— drop./crux/...and the five./crux/<pkg>/...entries (the scanner can only see first-party source);src/scripts/generate-notice.sh:175— drop./crux/.... - Docs: rewrite the 165 citations in 22
src/docsfiles tohttps://github.com/hivecommons/crux/blob/$TAG/<path>#L<n>and runsrc/scripts/check-docs-citations.py; rewritesrc/docs/crux-publish.mdinto a short "Crux lives at hivecommons/crux; how hive bumps it" page; updateAGENTS.md:10,CONTRIBUTING.md:24,64-68,src/docs/design/crux.mdheader; addchangelog.d/changed-<n>-crux-cutover.md. - Expect the v5 → v6 forward-merge (
v6-topup.yml) to carry the flip; if v6 has diverged insrc/crux, resolve by taking v5's deletion.
Phase 4 — process after the flip
- Branch model: crux
mainonly, tagsvX.Y.Z(semver,v0.4.xfor fixes); hive staysv5and bumps withgo get github.com/hivecommons/crux@vX.Y.ZPRs (acrux-pin-bumpworkflow modelled oncli-pin-bumpis a follow-up, not part of the flip). - Triage: hive agents already see crux via
project.repos; after sync-guard is gone, PRs may be authored there. Carry over: emoji-prefixed titles,git commit -s(DCO),changelog.d/fragments,Refs #ncitations. Crux issues no longer need mirroring into hive; crux#114 stays the work-services tracker in crux. - Releases: unchanged (
release.yml, goreleaser, cosign, ghcr, homebrew formula bump inhivecommons/homebrew-hive).
Phase 5 — rollback (if the flip PR cannot go green on 11-16)
- Do not merge the hive flip PR;
gh workflow enable crux-sync.yml --repo hivecommons/hiverestores publishing (nothing in hive was deleted until the flip PR merges). - Re-add
sync-guard.ymlin crux fromfe54cd5(git checkout fe54cd5 -- .github/workflows/sync-guard.yml) and restore.hive-syncwith the next sync run (workflow_dispatch). v0.4.0-rc.1/v0.4.0remain valid tags of the frozen tree either way.- If the flip merged and must be undone:
git revertthe flip commit onv5(it is one commit;src/cruxcomes back at the frozen sha), re-pinTRUSTED_SCRIPTS_TREE, re-enable the workflow.
3. Day-by-day checklist
- Mon 11-09 — Confirm this RFC; confirm
CRUX_SYNC_TOKENscope; open crux scaffolding PR (CI lanes,changelog.d/+guard, DCO/CONTRIBUTING). - Tue 11-10 — Merge crux scaffolding PR; S1 (
feat/crux-caller-principal) pushed + PR in hive; S0 PR in hive. - Wed 11-11 — S2 (
feat/crux-contained-run) PR in hive; local scratch dry run of §Phase 3 steps 1–5 against cruxmainvia a temporaryreplace(not pushed); draft the citation-rewrite script and the flip PR description. - Thu 11-12 — S7 PR in hive; verify each S-PR's sync run went green on crux
main. - Fri 11-13 — Freeze after the last S-PR merges (deadline 18:00 UTC); tag
crux/v0.4.0-rc.1from hive; confirm cruxv0.4.0-rc.1release built;gh workflow disable crux-sync.yml. - Sat/Sun — nothing (if an S-PR slipped, the freeze moves to Mon 08:00 ET and the rc is tagged then).
- Mon 11-16 (flip) — crux: delete
.hive-sync+sync-guard.yml, protectmain, tagv0.4.0; hive: open the flip PR with the §Phase 3 sequence, CI/Docker/docs/guards edits,TRUSTED_SCRIPTS_TREEre-pin, changelog fragment; merge when green; watchv6-topup; bump homebrew formula; update crux#114 that development now happens in crux. - Tue 11-17 — follow-ups:
crux-pin-bumpworkflow, per-agentrepos:additions, deletecrux/v*tags? (no — keep; they are history), close this issue.
4. Risks (top first)
- In-flight phase-1 PRs (S0/S1/S2/S7) vs the freeze. S1 exists only as one unpushed local commit, S2 has no commits yet, S0/S7 have no branches. Anything not merged into hive
src/cruxby Fri 11-13 must be re-targeted at crux with its imports rewritten (same sed, applied to the PR branch) — and reviewed again under crux's CI. Mitigation: hard deadline + the Monday-morning freeze fallback. - Scale of the hive flip PR: 279 files / 422 import lines + ~10 CI/Docker/script files + 22 doc files (165 citations) +
TRUSTED_SCRIPTS_TREE+release-lines.ymlin a single PR that must passchangelog-fragment-guard, the citations guard, the governance guard and the full test matrix (which itself is being edited). A missed./crux/...in any.github/scripts/*.shmakesaffected-go-packages.shfall back to "full" or fail. Mitigation: the Wed 11-11 scratch dry run and the grep-guard in step 5. - Version skew during the transition: between the rc tag and the flip, crux
mainmust not move (sync disabled, sync-guard still on), otherwisev0.4.0≠ the tree hive was last tested against. After the flip, hive pins a tag while cruxmainadvances — every crux change hive needs now requires a crux release + a hive bump PR (slower than today's in-tree edit). ThelanesNATS code (nats-server/v2 v2.15.2, deflaked 3× this week) is the most likely source of "fix needed in both places" churn. replacedirectives: none should survive the flip; a lingeringreplace github.com/hivecommons/crux => ./cruxwould silently build against a deleted directory in Docker (GOWORK=off). Guard:grep -c '^replace' go.mod= 0 in the flip PR.- Docker/image build:
src/Dockerfile:86builds hive's host./cmd/crux(stays);Dockerfile.contributor:51builds the module binary — switching it to the dependency changes the binary shipped at/usr/local/bin/cruxin the contributor image to exactlyv0.4.0. Justfilecline-turncallers are unaffected. - v6 forward-merge: the flip lands on v6 via
v6-topup.yml; a concurrentsrc/cruxchange on v6 would conflict with the deletion. - Crux CI covers less than hive's matrix in one respect: hive slices
crux/agentN-ways and runs the dedicatedlanes/api/serverace lane; crux runs./agent/...in one ubuntu-24.04 job. Port the lane in Phase 0; accept a longer single agent job or slice it later. - Sync-guard removal timing: deleting it before the rc tag lets a stray PR change the tree under the tag; deleting it after the flip blocks developers. Order in Phase 2 is deliberate.
Activity
hivecommons-hive commentedon Nov 7, 2026
🔓 Claim by @Danathar released (lease revoked).
Claim history
Karibhou(contributor on hive hosted-available-oke-11-placeholder-r05x)Karibhou(contributor; lease revoked)scanner(agent on hive hosted-available-oke-11-placeholder-r05x)Danathar(contributor on hive hosted-available-oke-11-placeholder-r05x)Danathar(contributor; lease revoked)Karibhou commentedon Nov 7, 2026
Checked on 2026-11-07. There is nothing in hivecommons/hive that can ship yet for this RFC.
go get github.com/hivecommons/crux@v0.4.0. hivecommons/crux has nov0.4.0orv0.4.0-rc.1tag yet; its only tags arev0.3.0,v0.2.0andv0.1.0. That tag only exists after the Phase 1 freeze and rc tag (11-13) and the Phase 2 crux flip (11-16). Until then the import rewrite can't build without areplaceto./crux, and the RFC says thatreplacemust not survive the flip.upstream/v5@7a9293564still hassrc/crux/go.modand the two-modulesrc/go.work, so the inventory in the RFC still applies.I'm marking this blocked until crux
v0.4.0is tagged and the 11-16 window opens. After that, the §Phase 3 sequence can be run as one PR againstv5.— hive: backend=omp model=anthropic/claude-opus-5-5
🐝 Hive Agent:
contributor| SHA:unknownhivecommons-hive commentedon Nov 7, 2026
Hive status — updated in place; edits do not notify. Full history is in the Activity Monitor.
Unblocked: the
blockedlabel was applied by the hive without a blocked-on marker, so nothing could lift it. This issue is actionable again.scanner (2026-11-11 00:41 UTC): ## Wed 11-11 prep (hive): dry-run counts, citation-rewrite script draft, flip PR description draft
This covers the part of the Wed 11-11 checklist item that the hive can do. Nothing was pushed. No branch, PR, tag or workflow change was made. All work happened in a throwaway local clone of
v5@978540d39, which was reset withgit checkout -- .and then deleted.I did not run a build, vet, test, tidy or lint. The dry run used only
sedandgrep. As the RFC requires, build re-verification is deferred to flip day (§Phase 3 steps 4–5 against the realv0.4.0tag). That is also why steps 1, 2 and 4 (go.work/go.mod edits,git rm crux,go get) were not exercised here.1. Dry-run counts (§flip step 3 import sed, root module =
src/minussrc/crux)978540d39)"github.com/hivecommons/hive/crux…src/internal/testutil/dashboard_import_ratchet_test.go:18-19, a comment only, stale wording to fix in the flip PR)dashboardCruxImportPrefixindashboard_import_ratchet_test.go:21to"github.com/hivecommons/crux". That change is intended because it has to match the rewrittendashboard_import_allowlist.txt(11 lines). Calling it out because reviewers will see a non-import line in the diff..gofiles and 11 lines in the allowlist.Non-Go files outside
src/cruxthat still namegithub.com/hivecommons/hive/cruxafter the sed. The flip PR must edit or delete each one:src/go.mod(100, 102) ·src/go.work(comment line 6) ·src/scripts/crux-publish.sh·src/scripts/test-crux-publish-keep.sh·.github/scripts/crux-scope.sh·.github/workflows/crux-sync.yml·.github/workflows/v2-tests.yml·.github/workflows/integration-candidate.yml·.github/workflows/integration-technical-v2-tests.yml·src/docs/crux-cli.md·src/docs/crux-publish.md·src/docs/crux-serve.md·src/docs/design/crux.md·src/docs/knowledge/go-workspace-two-modules.md·CONTRIBUTING.md·docs/development.md·CHANGELOG.md(history, leave as-is).Surfaces added since the 11-07 inventory that address
./crux,src/cruxorcrux/go.sum:.github/workflows/integration-candidate.yml(working-directory: src/crux,go vet ./... ./crux/...,TEST_PACKAGE=…/crux/agent)integration-technical-v2-ci.ymlintegration-technical-v2-tests.ymlintegration-technical-go-security-analysis.ymlprice-table-refresh.yml:71(src/crux/go.sum).github/CODEOWNERS:24(src/crux/proxy/**)Also,
.github/release-lines.yml:164is nowcrux-sync.yml: [-v4, -v6].Docs citations into
src/crux/. I usedcheck-docs-citations.py's ownCITATION_REand path resolver (imported only; I did not run the checker). There are 142 citations in 10 files today, down from the RFC's 165 in 22:src/crux/…and 1 is the src-relativecrux/logscrub/redaction.go:55insecurity.md.design/agent-turn-model.md99,design/agent-host-confinement.md15,design/copilot-cost-capture.md11,design/cli-memory-drain.md6,design/github-mention-triggers.md5,design/agent-turn-handoff.md2, and 1 each indesign/README.md,scale-envelope.md,security.md,skills.md.There are also 241 path-only
src/crux/…mentions with no line number. The citations guard does not check these, but they become dead paths after the deletion. They are mostly indesign/crux.md,crux-cli.mdandcrux-serve.md, which the flip PR rewrites anyway.2. Citation-rewrite script draft
I ran the draft below on the scratch clone; it only edits text. Result: 142 citations rewritten in the 10 files (136 lines). A second run rewrote 0 citations and exited 0, so it is idempotent. Nothing that the guard's regex would match was left behind.
The new link text,
crux/PATH#LN, has no:LINE, socheck-docs-citations.pyignores it the same way it ignores URLs. Example:src/crux/agent/manager_tmux.go:178-186becomes[crux/agent/manager_tmux.go#L178-L186](https://github.com/hivecommons/crux/blob/v0.4.0/agent/manager_tmux.go#L178-L186).src/scripts/crux-citation-rewrite.sh (draft, 51 lines)
Two things to note if this script is added under
src/scripts/:TRUSTED_SCRIPTS_TREEre-pin.3. Flip PR description draft
Title:⚠️ crux: consume github.com/hivecommons/crux v0.4.0 as a dependency; retire src/crux and the publish pipeline
Still maintainer-only before 11-16: freeze,
crux/v0.4.0-rc.1tag,gh workflow disable crux-sync.yml, sync-guard removal andv0.4.0tag in crux, and theTRUSTED_SCRIPTS_TREEre-pin. This issue stays open; per the checklist it closes on 11-17.— hive: agent=scanner
6 remaining items
🌱 ci: port hive's lanes/api/serve race lane and add a DCO check (#127)
hivecommons-hive commentedon Nov 8, 2026
Phase 0 status (2026-11-08): the crux-side CI port is done — hivecommons/crux#127 merged, adding the
lanes/api/serve -racelane mirroringv2-ci.ymland a DCO check.changelog.d/+ fragment guard and CONTRIBUTING are deliberately left for the flip PR because those paths are sync-owned (outsidecrux-publish.sh's KEEP list) and would be wiped by the next sync.Everything else in Phase 0–3 is either maintainer-only (RFC confirmation,
CRUX_SYNC_TOKENscope, freeze, rc tag, workflow disable, branch protection) or gated to 2026-11-16 per the body, so no hive PR is opened for this issue before then. The S-series work-services PRs land in hivesrc/cruxindependently (S3 is #17234).🐝 Hive Agent:
scanner| Instance:hosted-available-oke-11-placeholder-r05x| SHA:unknown— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88
hivecommons-hive commentedon Nov 12, 2026
Thu 11-12 checklist (hive-side verification only; no branch, PR, tag or workflow change made):
crux-sync.ymlruns onv5(latest hive@efb2a0bab, 07:03 UTC today) all concludedsuccess; cruxmainHEAD ise28a1e892=🌱 sync: hive@efb2a0bab5b6, interleaved with the hand-maintained scaffolding commit48f9cefcf(crux#149, base-image digest pins).mainCI green: all 14 check-runs on HEAD pass, including the portedlanes/api/serve integration (-race)lane from crux#127, coverage floors, file-size ratchet, gosec/govulncheck, goreleaser snapshot and bothcrux servesmokes.main. No S0/S1/S2/S7 PR references this issue yet (timeline cross-refs checked); those are maintainer-owned per the body (S1 is a local unpushed commit), so the 11-13 18:00 UTC freeze deadline is the only hive-visible gate. Nothing for the hive to open before 11-16.🐝 Hive Agent:
scanner| Instance:hosted-available-oke-11-placeholder-r05x| SHA:cf67d1ee6— hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88
hivecommons-hive commentedon Nov 14, 2026
@Danathar you now hold this issue (contributor on hive hosted-available-oke-11-placeholder-r05x); the claim ledger comment above tracks it. Reply
/unclaimto release.Danathar commentedon Nov 14, 2026
Checked on Sat 2026-11-14 at 19:00 UTC. The §Phase 3 flip PR can't be opened yet: the Phase 1 freeze and tag haven't happened, and the existing
v0.4.0tag doesn't matchv5.v0.4.0is stale. It points at crux6064a8e75=🌱 sync: hive@90c102c0a38d, from 2026-11-08 (hive tagcrux/v0.4.0→90c102c0a). Since then, 62 hive commits touchingsrc/cruxhave landed onv5, including ✨ Keystore: OpenBao Transit provider (opt-in) #18225, ✨ Keystore: encrypt spoke secrets at rest behind a provider interface #18222, ✨ sessions: open in a persistent per-hive spek workspace #18195, 🔒 Sessions: per-session uid isolation, bound terminal attach, ownership #18191 and 🔒 fix(inference): refuse proxy-UID callers that claim a UID-isolated agent's key #18133. cruxmainis 71 commits ahead ofv0.4.0. Running §Phase 3 as written (go get github.com/hivecommons/crux@v0.4.0+git rm -r src/crux) would silently revert all of that work in hive.crux/v0.4.0-rc.1tag in hive or crux.crux-sync.ymlis stillactiveand published three times today, most recently hive@cc998ed38→ cruxmain53aca5cd1at 18:09 UTC.sync-guard.ymlis still present in crux.upstream/v5@f662ef141still hassrc/cruxand the two-module workspace, so the RFC's inventory still applies.What a maintainer needs to decide or do before the flip PR (all maintainer-only per the RFC's Owners section):
src/cruxonv5.crux/v0.4.1-rc.1→v0.4.1, orv0.5.0). Re-usingv0.4.0isn't possible: it already exists at an older tree.crux-sync.yml.sync-guard.ymland.hive-sync, then tag the release.After that, the Phase 3 sequence plus the 11-11 prep (citation-rewrite script, PR description draft) can be run as one PR against
v5, withTAGset to whichever tag was chosen.— hive: backend=claude model=claude-opus-5-5
🐝 Hive Agent:
contributor| SHA:c98a5bb80hivecommons-hive commentedon Nov 14, 2026
What to reply
/hive approve: go with the recommendation/hive decision <your instructions>: go ahead, following your instructions/hive help: show these againIf what this issue waited on has been done (a merged fix, or an action taken outside this repository), a maintainer can reply
/fixedto close it as completed; Hive clears its park labels.Only a maintainer with write access can un-park; everything else is ignored. Full command reference: https://github.com/hivecommons/hive/blob/v5/src/docs/maintainer-commands.md.
clubanderson commentedon Nov 17, 2026
Status on 2026-11-17: the cut-over did not happen on 2026-11-16, and this is waiting on the owner, not on the hive.
What the repositories show today
v5still hassrc/crux, the two-modulesrc/go.workand thereplaceto./crux.crux-sync.ymlis still publishing: hivecommons/cruxmainreceived six sync commits today, the last at 15:52 UTC.sync-guard.ymland.hive-sync, so nobody can develop there yet.v0.4.0tag is from 2026-11-08 and is far behindv5; using it for the flip would silently revert the work merged since.src/cruxis busy: three pull requests touching it merged tov5today.What is decided here: the 2026-11-16 date is void, and the plan itself is unchanged. Nothing was ported, so nothing needs undoing. The hive does not open the flip pull request until the freeze and a fresh tag exist; that order is what protects the merged work.
What still needs the owner. The flip starts with four maintainer-only steps that cannot be taken back quietly: freeze
src/cruxonv5, cut a new tag from the frozen commit (v0.4.1orv0.5.0, sincev0.4.0is taken), disablecrux-sync.yml, and removesync-guard.ymland.hive-syncin hivecommons/crux. The choice is when:src/cruxby Friday 2026-11-20 18:00 UTC, tag from the frozen commit, and the hive opens the flip pull request againstv5on Monday using the prepared rewrite script and description. Consequence: Sessions and Betty changes that touchsrc/cruxmust land before Friday or wait and be opened in hivecommons/crux after the flip.v0.4.0tag and the growing import count (279 files on 11-07, 289 on 11-11) carry on, and the flip gets a little larger each week.Recommendation: option 1. The preparation is done and current, crux CI already mirrors the hive's, and one week is enough to land what is in flight.
To answer: reply
/hive decision flip on 2026-11-23(or another date), or/hive decision defer. Until then this stays parked and the hive opens nothing for it.