Skip to content

πŸ› [v6] claude auth: re-bridge per-agent credentials a token refresh replaced, and resume login-paused agents after sign-in - #17253

Merged
hivecommons-hive[bot] merged 3 commits into
hivecommons:v6from
Danathar:fix/v6-claude-credential-bridge
Nov 8, 2026
Merged

hivecommons-hive[bot] merged 3 commits into
hivecommons:v6from
Danathar:fix/v6-claude-credential-bridge

Conversation

@Danathar

@Danathar Danathar commented Nov 8, 2026

Copy link
Copy Markdown
Contributor

Summary

Each claude agent reaches the fleet's one Claude login through a symlink, ~/.claude/.credentials.json -> /data/home/.claude/.credentials.json. Claude Code refreshes its token by writing a temp file and renaming it over that path, which replaces the symlink with a private 0600 file. From then on the agent runs on its own copy, and no dashboard sign-in can reach it. On hive-wild-mole (build 70a9203) seven agents were stuck like that through two sign-ins until the links were fixed by hand. This PR makes hive detect and repair the replaced link at launch, on every credential-watchdog cycle, and right after a sign-in. It keeps the newer usable token and never deletes one. A successful sign-in now also resumes the claude agents the login detector paused, and only those. The dashboard names the broken bridge, and the agent-card Claude button says it is the fleet-wide sign-in.

Refs #17031, #17039

What went wrong

What Doug found on hive-wild-mole at 14:54Z:

  • Seven agents had a regular file where the symlink should be: owner hive-<name>, mode 0600, written 06:44 to 07:08Z. That is the CLI's 8-hour token refresh. The token in those files was later revoked.
  • Two dashboard sign-ins (14:31Z and 14:50Z) wrote a valid shared credential, readable by every agent (0660, group 1000). They did not help. The seven agents kept answering every kick with Login expired Β· Please run /login or OAuth token revoked. They showed needs-login, were re-paused by the login detector or restart-looped every ~2.5 min, and nothing told the owner that signing in again could not help.
  • The agent-card "Login" button runs that same fleet-wide sign-in, so it could not help either.

Why, on the v6 tip (d59e55b):

  • bridgeHomeEntry (crux/agent/interactive_home.go:319-321) treats a regular file at a bridge name as deliberate local state and refuses to touch it. So launch never repaired the link.
  • The credential watchdog (crux/agent/credentials_watchdog.go:199-216) only probes the shared file and never looks at the per-agent links.
  • The sign-in (pkg/dashboard/claude_auth.go:172-189) writes the shared file and reloads the cached token. It never touches the agents' links and never resumes anyone.

Why the CLI replaces the link: I read the credential store in the Claude Code 2.1.311 bundle (the closest version on hand; the image pins 2.1.319). The plaintext store reads .credentials.json with a normal, symlink-following read. It writes through an atomic-write helper that creates a staging file, renames it over the path, then sets 0600. A rename replaces a symlink rather than following it. The temp file is created by the agent's own uid, which matches the hive-<name>, 0600 files Doug found.

Prevent or detect?

Detect and repair. Claude Code has no supported way to keep the link:

  • CLAUDE_CONFIG_DIR is the documented option, and it moves the whole config directory: settings, transcripts and auto-memory. Pointing it at the shared directory would undo πŸ› agents: Claude/Gemini/Bob persistent memory is shared across every agent on a hiveΒ #17031.
  • The docs give no separate option for the credentials file alone. The 2.1.311 bundle reads an undocumented CLAUDE_SECURESTORAGE_CONFIG_DIR, but I did not use it, because an undocumented variable can change in any CLI release.
  • A bind mount cannot be renamed over (EBUSY, so the CLI's write would fail), and it needs mount privileges the pod does not have.

The repair runs at every launch, on every watchdog cycle (default 5 minutes), and after a sign-in. A refresh during a run is caught within one cycle.

What changes

  • Re-bridge (crux/agent/claude_credential_bridge.go). When a regular file has replaced the link, hive:
    1. moves the file aside to .credentials.json.stale-<UTC time>, keeping its owner and 0600 mode;
    2. keeps whichever credential is newer and usable in the shared file. "Usable" is claude.TokensUsable, the existing HasUsableToken rule: a live access token, or a refresh grant that has not expired. "Newer" means a later expiresAt. When the agent's copy wins, the old shared file is saved beside it, and the new one is written 0660 with the old file's owner and group. A tie, or an unusable agent copy, leaves the shared file alone. This is how one agent's fresh refresh becomes the fleet's login instead of stranding the others;
    3. restores the symlink, and records a claude_credential_rebridged audit entry (trigger, which credential was kept, the moved-aside path; never token material).
  • Watchdog: each tick re-bridges before it probes, when any agent uses claude.
  • Sign-in: Manager.ReloadClaudeToken re-bridges when the shared credential is usable afterwards. A logout leaves nothing usable, so nothing is moved. The dashboard then resumes the claude agents whose pause trigger is login-detector. Pauses are told apart by PausedTrigger, which every pause records (Manager.PauseByCause), and the login detector always pauses with login-detector (pkg/loginscan/loginscan.go:334). Operator (dashboard-api), fleet-breaker, hook, relay and all other pauses stay. A copilot agent's login pause stays too. Each resume is audited as resume with trigger=claude-sign-in under the signing-in user, and claude_auth_complete lists the resumed agents.
  • Dashboard: the status payload has a new credentialBridgeBroken field. The card shows credential bridge broken (private stale file) in the badge tooltip, the detail state label and a hint row, instead of a generic needs-login. The Claude button now reads Sign in Claude for all agents, with a tooltip explaining the fleet-wide effect. The sign-in modal says the same. index.html was regenerated from static-src.

Files

  • src/crux/agent/claude_credential_bridge.go (new): detection, repair, the newer-and-usable rule, test seams for chown and the clock.
  • src/crux/agent/interactive_home.go, credentials_watchdog.go, manager_tokens.go: the three triggers.
  • src/crux/claude/oauth.go: TokensUsable, which HasUsableToken now calls.
  • src/crux/process.go, crux/agent/manager_pane_signals.go, pkg/dashboard/server.go, status_builder.go: the CredentialBridgeBroken status field.
  • src/crux/audit.go, crux/agent/audit.go, pkg/dashboard/audit.go: the claude_credential_rebridged action.
  • src/pkg/dashboard/claude_auth.go, claude_auth_resume.go (new): resume after sign-in.
  • src/pkg/dashboard/static-src/js/{agent-cards,agent-detail,gh-auth}.js, static/index.html: the card, detail and modal wording.
  • Docs: agent-configuration.md, agent-watchdog.md, troubleshooting.md, dashboard-sections/workflow-and-agents.md. The api-reference server.go line citations were re-pointed with check-api-reference-citations.sh --fix.
  • changelog.d/fixed-claude-credential-bridge.md.

Tests

All tokens are fake JSON written into t.TempDir(). Ownership goes through an injected chown hook, so no test needs root or real uids.

These fail on the v6 tip with assertion failures (run on 49880cd; #17246, which landed since, adds plan stamping to the sign-in but changes neither the links nor any pause), and pass here:

  • TestSetupInteractiveHome_RebridgesCredentialReplacedByRefresh_KeepsNewerShared: the hive-wild-mole state; the shared file is kept and the private one moved aside (0600). Also checks the audit entry and that it holds no token material.
  • TestSetupInteractiveHome_RebridgePromotesNewerUsablePrivateCredential: a newer usable private token is promoted (0660), and the old shared file is preserved.
  • TestSetupInteractiveHome_RebridgeNeverPromotesUnusablePrivateCredential
  • TestCredentialWatchdog_RebridgesWithinOneCycle: a 20ms watchdog repairs the link on its first tick.
  • TestReloadClaudeToken_RebridgesAfterSignIn
  • TestClaudeSignIn_ResumesOnlyLoginDetectorPausedClaudeAgents: only the claude login-detector pauses are resumed, after the reload. Operator, fleet-breaker, hook and relay pauses, and a copilot login pause, stay paused.
  • TestAgentCard_NamesBrokenCredentialBridge: the regenerated index.html names the broken bridge and the fleet-wide sign-in.

These use new identifiers, so on the tip they fail to compile:

  • TestRepairClaudeCredentialBridge_PromotionKeepsSharedOwner
  • TestRepairClaudeCredentialBridge_StaleNamesNeverCollide
  • TestAgentSnapshot_ReportsCredentialBridgeBroken
  • TestPreferAgentClaudeCredential
  • TestBuildAgents_CredentialBridgeBroken

TestReloadClaudeToken_LogoutDoesNotRebridge is a guard and passes on both.

Full runs: go test ./crux/... ./pkg/dashboard/... ./cmd/hive/ ./pkg/writeback/ ./pkg/agentaudit/, all pass except TestContributorTokenConcurrentAuthenticationNeverFails in pkg/dashboard, which fails the same way on the v6 tip and is unrelated. Also go vet, dashboard-gen-check, the docs citation and link checks, and the api-reference citation check.

Not in this PR

πŸ€– Generated with Claude Code

https://claude.ai/code/session_01BQYnPGFJx81c8JXR3o1sg1

…eplaced, and resume login-paused agents after sign-in

Claude Code refreshes its OAuth token by writing a temp file and renaming
it over ~/.claude/.credentials.json, which replaces each agent's symlink to
the shared /data/home/.claude/.credentials.json with a private 0600 copy.
bridgeHomeEntry refused to touch a real file, the credential watchdog only
probed the shared file, and the dashboard sign-in never reached the agents,
so an agent whose private token was revoked stayed on "Please run /login"
through any number of sign-ins.

- Re-bridge at launch, on every credential-watchdog tick and after a
  sign-in: move the private file aside (.credentials.json.stale-<UTC>),
  keep the newer usable token in the shared file (claude.TokensUsable +
  later expiresAt; the replaced shared file is preserved), restore the
  symlink, audit claude_credential_rebridged.
- A successful dashboard Claude sign-in resumes the claude agents whose
  pause trigger is login-detector, and only those.
- Status carries credentialBridgeBroken; the card names
  "credential bridge broken (private stale file)" and the Claude button
  reads "Sign in Claude for all agents".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BQYnPGFJx81c8JXR3o1sg1
Signed-off-by: Danathar <Danathar@users.noreply.github.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Nov 8, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign danathar for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Nov 8, 2026
The crux file-size ratchet caps crux/agent/manager_tokens.go at 975 lines.
The new ReloadClaudeToken doc comment pushed it to 981. The comment now
says the same in four lines. No code change.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BQYnPGFJx81c8JXR3o1sg1
Signed-off-by: Danathar <Danathar@users.noreply.github.com>
@github-actions

github-actions Bot commented Nov 8, 2026

Copy link
Copy Markdown
Contributor

Open PR overlap check

Base branch: v6

Conflicts are checked with every PR merged onto the current tip of v6, so a PR that only needs a rebase is not reported as conflicting with its siblings.

No conflicting open PRs or same-file overlaps were found.

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Intent-alignment review at 61aafae. The diff implements what the body claims: re-bridge at launch (src/crux/agent/interactive_home.go:440-446), each watchdog tick (credentials_watchdog.go:217-222), and after sign-in gated on a usable shared token (manager_tokens.go:28-34); the newer-and-usable rule (claude_credential_bridge.go:143-151); and resume restricted to Paused && PausedTrigger == "login-detector" with backend claude (claude_auth_resume.go:34-43), matching the detector's trigger at pkg/loginscan/loginscan.go:334. No lock inversion: m.audit uses an atomic sink (crux/agent/audit.go:69-75), and no caller of ReloadClaudeToken holds m.mu.

One advisory (non-blocking):

Promotion can go unaudited. In repairClaudeCredentialBridge (claude_credential_bridge.go:186-191) a failed os.Symlink returns rep, err, but rebridgeClaudeCredential (:279-287) treats any non-nil error as "repair failed" and returns before the audit row β€” even though the private file has already been moved aside and, when kept == "agent", the shared credential has already been replaced. That contradicts the body's "records a claude_credential_rebridged audit entry" for exactly the case where the fleet's shared token changed. Suggest auditing when rep != nil regardless of the symlink error:

 	rep, err := m.repairClaudeCredentialBridge(agentName, link, target)
-	if err != nil {
+	if err != nil && rep == nil {
 		m.logger.Warn("claude credential bridge: repair failed",
 			"agent", agentName, "link", link, "trigger", trigger, "error", err)
 		return nil
 	}
 	if rep == nil {
 		return nil
 	}
+	if err != nil {
+		m.logger.Warn("claude credential bridge: files moved but symlink not restored; next cycle retries",
+			"agent", agentName, "trigger", trigger, "error", err)
+	}

β€” hive: agent=ci-maintainer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive

hivecommons-hive Bot commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

Hive status β€” updated in place; edits do not notify. Full history is in the Activity Monitor.

Review findings from adjudicator (folded here because this head already carries its hive review):

Correctness review (head 61aafae) β€” no blocker. The lock discipline holds (claudeBridgeMu is never held across m.mu; m.audit is an atomic-pointer sink so the launch-path call under m.mu is safe), the newer-and-usable rule matches the incident shape, and the tests cover the three triggers and the resume filter. Two advisory notes:

  1. A repair that moved/promoted files is not audited when the symlink restore fails. In repairClaudeCredentialBridge (src/crux/agent/claude_credential_bridge.go:171-176) the EEXIST path returns rep, err after the private file was already moved aside and possibly promoted into the shared file. rebridgeClaudeCredential (:291-299) checks err != nil first and returns without logging rep or writing claude_credential_rebridged, so a shared-credential replacement can happen with only a generic "repair failed" line and no stale paths recorded. Suggest recording the partial repair:
 	rep, err := m.repairClaudeCredentialBridge(agentName, link, target)
-	if err != nil {
+	if err != nil && rep == nil {
 		m.logger.Warn("claude credential bridge: repair failed",
 			"agent", agentName, "link", link, "trigger", trigger, "error", err)
 		return nil
 	}
+	if err != nil {
+		// Files were moved (and the shared file possibly replaced) but the
+		// link was not restored; record what happened so the stale paths are
+		// findable. The next cycle restores the link.
+		m.logger.Warn("claude credential bridge: files moved but symlink not restored",
+			"agent", agentName, "trigger", trigger, "kept", rep.kept,
+			"stale_agent_file", rep.staleAgentPath, "stale_shared_file", rep.staleSharedPath, "error", err)
+	}
 	if rep == nil {
 		return nil
 	}

(and either audit in that branch too, or add "link_restored", err == nil to the existing audit fields.)

  1. snapshot() now does an os.Lstat per claude agent (src/crux/agent/manager_pane_signals.go:115) while AllStatuses holds m.mu; previously snapshot did no filesystem I/O. Fine on local disk, but if /data/home is ever a network volume this puts a syscall stall inside the manager lock on every status poll. Not blocking; flagging in case you'd rather cache it from the watchdog tick.

Review findings from adjudicator-2 (folded here because this head already carries its hive review):

Security review (head 61aafae). One in-scope issue with a concrete fix; the rest is advisory.

1. promoteClaudeCredential writes, chmods and chowns through a non-exclusive temp path in a group-writable directory β€” attacker-triggerable from any agent uid (medium)

src/crux/agent/claude_credential_bridge.go:236-251:

tmp := target + ".tmp-rebridge"
_ = os.Remove(tmp)
if err := os.WriteFile(tmp, data, claudeSharedCredentialMode); err != nil { ... }   // O_CREATE|O_TRUNC, follows symlinks
if err := os.Chmod(tmp, claudeSharedCredentialMode); err != nil { ... }              // follows symlinks
_ = chownClaudeCredential(tmp, uid, gid)                                             // os.Chown, follows symlinks

Preconditions, all present in the per-UID deployment this PR targets:

  • The shared dir /data/home/.claude is drwxrwsr-x group 1000 and every agent uid is in group 1000 (the PR body itself notes the shared file is 0660, group 1000), so any agent can create /data/home/.claude/.credentials.json.tmp-rebridge as a symlink.
  • Hive runs privileged in that mode (it os.Chowns agent homes, interactive_home.go:593, :715).
  • The attacker controls the trigger: preferAgentClaudeCredential (:134-142) is decided by expiresAt in the agent's own 0600 file, so an agent that writes a JSON file with a live accessToken and a far-future expiresAt at its link path gets promoted on the next watchdog tick (≀5 min, credentials_watchdog.go:221) or on launch (interactive_home.go:445).

Chain: the agent loops re-creating .credentials.json.tmp-rebridge -> /some/root-owned/file between the Remove and WriteFile; hive (root) truncates that file, writes attacker-chosen bytes into it, chmod 0660s it and chowns it to the shared credential's owner:group (1001:1000) β€” at which point the agent can write it directly. Rename(tmp, target) then moves the symlink onto the shared credential path. The existing claude.WriteCredentials (crux/claude/oauth.go:358-359) has the same non-exclusive .tmp write, but it is owner-triggered and does not chmod/chown; this path is agent-triggered and does both. preserveClaudeCredential (:272) already uses O_EXCL β€” the promote path should too, and should apply mode/owner on the fd rather than the path:

-	tmp := target + ".tmp-rebridge"
-	_ = os.Remove(tmp)
-	if err := os.WriteFile(tmp, data, claudeSharedCredentialMode); err != nil {
-		return staleShared, err
-	}
-	// WriteFile honours the umask; assert the mode explicitly.
-	if err := os.Chmod(tmp, claudeSharedCredentialMode); err != nil {
-		_ = os.Remove(tmp)
-		return staleShared, err
-	}
-	if uid >= 0 || gid >= 0 {
-		// Best-effort: an unprivileged hive cannot chown, and the file it
-		// wrote is already group-readable by mode.
-		_ = chownClaudeCredential(tmp, uid, gid)
-	}
-	if err := os.Rename(tmp, target); err != nil {
+	f, err := os.CreateTemp(filepath.Dir(target), filepath.Base(target)+".tmp-rebridge-*")
+	if err != nil {
+		return staleShared, err
+	}
+	tmp := f.Name()
+	cleanup := func() { _ = f.Close(); _ = os.Remove(tmp) }
+	if _, err := f.Write(data); err != nil {
+		cleanup()
+		return staleShared, err
+	}
+	// Operate on the fd, never the path: the directory is group-writable.
+	if err := f.Chmod(claudeSharedCredentialMode); err != nil {
+		cleanup()
+		return staleShared, err
+	}
+	if uid >= 0 || gid >= 0 {
+		// Best-effort: an unprivileged hive cannot chown.
+		_ = f.Chown(uid, gid)
+	}
+	if err := f.Close(); err != nil {
+		_ = os.Remove(tmp)
+		return staleShared, err
+	}
+	if err := os.Rename(tmp, target); err != nil {

(chownClaudeCredential test seam would become an *os.File-based seam, or the test can assert on the resulting file's owner.)

Advisory (not blocking)

  • Promotion trusts agent-written expiresAt (claude_credential_bridge.go:141). Because agents already have group write on the shared file, this is not a new privilege, but it is a new sanctioned, audited path by which one agent's file becomes the fleet login and overrides a dashboard sign-in within one cycle, recorded as outcome=success. Worth a sentence in agent-watchdog.md so an operator reading a kept=agent audit row knows it is agent-sourced content.
  • Resume-after-sign-in is behind requireOwnerRole (pkg/dashboard/claude_auth.go), only touches PausedTrigger == "login-detector" claude agents, and audits per agent β€” no authz widening found.
  • Audit/log detail carries paths only, no token material (:307-320) β€” verified.

Review findings from reviewer (folded here because this head already carries its hive review):

Conclusion: this looks correct to me. I read the new bridge code against the v6 tree (not just the diff) and the mechanism, locking and integration points hold up. Nothing blocking; one non-blocking suggestion at the end.

What I verified in the tree

  • Root cause as stated: bridgeHomeEntry (src/crux/agent/interactive_home.go:320) refuses to clobber a regular file at a bridge name, so launch never repaired a replaced link; the credential watchdog loop (credentials_watchdog.go:199-216) only probes the shared file. The new rebridgeClaudeCredential call in setupPerAgentCLIHome runs before bridgeHomeEntry, so the symlink is restored on the same launch.
  • Lock ordering: setupInteractiveHome is reached from launchInTmux (manager_tmux.go:354) with m.mu held. The repair takes only claudeBridgeMu, and m.audit is lock-free (audit.go:55-63, atomic pointer, explicitly for this reason), so no re-entrant m.mu. RepairClaudeCredentialBridges snapshots under RLock and releases before repairing; ReloadClaudeToken now unlocks before calling it. backendInUse takes RLock and returns before the repair. No inversion.
  • Paths agree: claude.CredentialsPath (claude/oauth.go:35) and sharedAgentHome + .claude/.credentials.json (interactive_home.go:16,148-149) resolve to the same file in production, so the HasUsableToken(sharedClaudeBridgeTarget()) gate in ReloadClaudeToken judges the file the sign-in just wrote.
  • Resume filter: "login-detector" is the exact trigger pkg/loginscan/loginscan.go:334 pauses with (and manager.go:1128 already keys on it); Manager.Resume(ctx, name, trigger, reason) matches manager_pause.go:138. Operator/breaker/hook pauses are untouched.
  • Stale names (.credentials.json.stale-<ts>) fall outside sharedCredentialBases (permissions_watcher.go:117-125), so the permissions watcher won't open the archived private copies to the group.
  • Race handling: move-aside first, then judge, then Symlink; an EEXIST from a refresh landing in the window is returned and picked up next cycle. The promotion-failure path restores the private file. Reasonable.
  • PR body matches the diff; no scope beyond the stated fix. Changelog fragment present; docs updated alongside.

Non-blocking suggestion

troubleshooting.md documents that moved-aside files are never pruned. At one refresh per ~8h per agent that is up to ~3 credential-bearing 0600 files/day/agent accumulating in each $HOME/.claude (and 0600 archives beside the shared file on every promotion). Not a defect β€” the choice is documented and nothing is deleted β€” but a follow-up that prunes .stale-* files older than N days (or caps them at the last K) would keep token material from piling up indefinitely. Fine as a separate PR.

CI was still running when I read this; I did not wait on it.

Review findings from reviewer-2 (folded here because this head already carries its hive review):

Conclusion: the detect-and-repair mechanism is correct as far as I can trace it, and the diagnosis of why the symlink gets replaced matches the tree. One design point needs an explicit owner decision because it changes a trust boundary; it is not a bug in the implementation.

Verified (read at 8bed2b8)

  • interactive_home.go:437-445: the re-bridge runs before bridgeHomeEntry, which at :318-320 still refuses to clobber a regular file β€” so without this hook the launch path really never repaired the link.
  • claude_credential_bridge.go:150-199: move-aside first, judge the snapshot, promote or keep, then os.Symlink. Failure of the promotion restores the private file (:167-173); EEXIST on the symlink is tolerated and left for the next cycle. Nothing is ever unlinked. m.audit (agent/audit.go:63-75) takes no m.mu, so calling it from the launch path (which holds m.mu) is safe; RepairClaudeCredentialBridges snapshots under RLock and repairs after release (:329-345).
  • manager_tokens.go:28-35: m.mu is now released before the repair, which is required since the repair re-acquires RLock.
  • claude_auth_resume.go:25-53: resumes only Paused && PausedTrigger == "login-detector" with effective backend claude; operator/fleet-breaker/hook pauses are untouched. Matches loginscan.go's trigger.
  • oauth.go:438-449: HasUsableToken is a pure refactor onto TokensUsable; behaviour unchanged.
  • Promotion when there is no shared file at all leaves the new file owned by the hive process (uid/gid stay -1, :206-212). claude.WriteCredentials (oauth.go:359-362) has the same behaviour, so this is pre-existing parity, not a regression.

The decision point β€” trust boundary (security, medium)
setupPerAgentCLIHome chowns ~/.claude to the agent's uid (interactive_home.go:430), so the agent β€” a process that runs untrusted tool output under "per-agent OS users for UID isolation" (docs/architecture.md:118) β€” fully controls the bytes at the replaced link. Before this PR the shared /data/home/.claude/.credentials.json was written only by the dashboard sign-in (operator). After it, preferAgentClaudeCredential (:137-145) promotes any agent-written JSON that parses as OAuthTokens, has a non-empty accessToken, and carries a later expiresAt than the shared file β€” none of which is verified against Anthropic. Consequences a maintainer should weigh:

  • an agent (or a prompt-injected tool run inside it) can replace the fleet's login with an arbitrary token, redirecting every agent's Claude traffic to an account of its choosing, or break the fleet by writing a far-future unusable token that TokensUsable accepts;
  • it can repeat this every watchdog tick (default 5 min, credentials_watchdog.go:217-222), and each promotion writes another .stale-* copy of the shared file into /data/home/.claude (preserveClaudeCredential, :233-262); the PR body says these are never pruned.

I understand why promotion exists: a CLI refresh rotates the grant, so keeping the old shared file would strand the rest of the fleet on a revoked refresh token. The question is whether that convenience is worth letting the lowest-privilege component author the fleet credential. Options I can see, for the owners to pick: accept as-is and document it as a known trust assumption; promote only when the shared credential is unusable (recovers the strand case, removes the "newer wins" overwrite of a live login); or validate the private token (e.g. a cheap authenticated call) before promotion.

Scope note: 32 files, size/XXL, bundling the repair, the resume-after-sign-in, dashboard status/UI wording, and docs. It is coherent, but a reviewer wanting to land the repair without the dashboard resume cannot. CI is still pending at the time of writing; I have not waited on it.

I have not approved or closed anything.

Evidence bundle `#172538bed2b8` sha256:2c502786330c474528de517c469f6ea33c31a5384ea0e278242496c9a1a8c55b β€” download from the dashboard or `hivectl review evidence #17253`.

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Needs a decision, not a merge:

  • the reviewer swarm returned requires_human @8bed2b8
  • the review found: the reviewer marked this change high-risk
  • reviewer question: @clubanderson @hanthor should decide whether the repair's "promote the agent's private copy into the shared credential when it is newer and usable" rule (src/crux/agent/claude_credential_bridge.go:137-145, 162-176) is acceptable, given that it lets a file fully controlled by a single agent uid become the fleet-wide Claude login.
  • the automerge lane will not merge this unattended

Head: verdict requires_human @8bed2b8, 63/64 checks green, 1 pending, DCO yes, soak 0s of 10m0s.

How to release it:

  • After reading the verdict, a trusted merger can submit a GitHub Approve review for the current head and the lane clears the hold on its next pass; /hive approve replies on a PR are acknowledged but not consumed.

Clear the cause and the hive re-evaluates on its next pass; the stage moves to stage/090-ready-for-human-merge, stage/095-pre-merge-soak or the merge queue on its own. Approval does not bypass CI, hold labels or other merge gates.

@hivecommons-hive
hivecommons-hive Bot merged commit a794e75 into hivecommons:v6 Nov 8, 2026
71 of 72 checks passed
@hivecommons-hive

Copy link
Copy Markdown
Contributor

merged by Hive trusted-author auto-merge: author @Danathar holds role owner and GitHub permission maintain on repo; CI green at 8bed2b8.

hivecommons-hive Bot added a commit that referenced this pull request Nov 10, 2026
… shared login file (#17590)

An agent whose whole ~/.claude is still the legacy directory symlink to
/data/home/.claude (paused or stopped since before the per-agent split,
so no launch retired it) has a credential path that IS the shared login.
The credential watchdog walks every managed agent, so the repair saw the
shared file as a "private copy": it renamed it to .stale-<UTC> every
cycle and, when the shared file held no token, linked .credentials.json
to itself, logging every Claude agent out.

The repair now resolves the link's directory before moving anything and
refuses when the link path is, or resolves to, its target; the caller
skips that layout with one warning per agent. The dashboard's
credential-bridge-broken signal applies the same rule. The launch path
already retires the directory link before it runs the repair (#17039),
so no new migration is added. Also pins that a sign-in's
WriteCredentials replaces a self-referencing or dangling symlink.

Refs #17253


Claude-Session: https://claude.ai/code/session_01BQYnPGFJx81c8JXR3o1sg1

Signed-off-by: Danathar <Danathar@users.noreply.github.com>
Co-authored-by: Danathar <Danathar@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>
clubanderson added a commit that referenced this pull request Nov 11, 2026
…t non-regular files

Shared logins and CLI configs written by the hive (.claude/.credentials.json,
.copilot/config.json, the durable Copilot token) now go through a new
crux/sharedfile package: a randomly named temporary beside the target, mode
and owner set and verified on the open descriptor, rename, directory fsync,
and the write is refused unless the target is absent or a regular file in a
regular directory the server owns. Credential promotion writes a canonical
re-encoding of the parsed token block and checks the moved-aside source is the
same regular file before and after.

Parity with the v6 fail-safe behaviour: an unreadable private credential is
left in place except on a dashboard sign-in with a usable shared login, the
refusal is logged once per file version, WriteCredentials refuses a credential
without an access token, and ReadTokens treats malformed JSON as nothing
usable.

entrypoint.sh: the shared dot-dirs get the sticky bit (not under
HIVE_SHARED_AGENT_HOME=1); the single-file repairs act only on a regular file
in a regular directory and WARN once otherwise; the remaining root chmod/chown
sites under agent-writable directories gained the same checks. The Go
permissions watcher keeps setgid/sticky when widening a directory's group
bits. Shell tests drive the shipped guard functions with non-regular entries.

Refs #17039, #17253, #17678, #17748

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
clubanderson added a commit that referenced this pull request Nov 11, 2026
…without sharing memory (#17767)

* πŸ› claude auth: share refreshed logins across per-agent .claude homes without sharing memory

Since the per-agent CLI homes landed, each per-UID agent has a real
~/.claude directory with only .credentials.json symlinked to the shared
login at /data/home/.claude/.credentials.json. Claude Code refreshes its
token by writing a temp file in ~/.claude and renaming it over
.credentials.json, then chmod 0600. The rename replaces the symlink with
a private, agent-owned file. bridgeHomeEntry refuses to clobber a regular
file, so nothing ever re-links it; the refreshed access token and the
rotated refresh grant stay in that agent's private file, the shared
credential ages out, and the rest of the fleet logs out every ~8h
(Discord report by Danathar, 2026-11-11).

Andy's direction: keep per-agent memory isolated, make an exception for
the login only. So no opt-in whole-directory sharing. Instead the hive
repairs the bridge in-process:

- repairClaudeCredentialBridge: when the agent's credential path is a
  regular file, read it (directly, or as its owner through the existing
  su-exec seam when the server cannot open an agent's 0600 file β€” the
  per-UID case), move it aside as .credentials.json.stale-<ts>, promote
  it into the shared login only if it is complete, usable and expires
  later than the shared token (a failed refresh's empty-token file never
  wins; ties keep shared), preserving the previous shared file, then
  restore the symlink. Legacy whole-directory ~/.claude symlinks and
  unreadable private files are left untouched, with a once-per-version
  log.
- Triggered at agent launch (setupPerAgentCLIHome), every 5s from the
  credential watchdog (HIVE_CLAUDE_CREDENTIAL_BRIDGE_INTERVAL) so a
  refresh is fleet-visible before siblings try the rotated grant, and
  right after a dashboard sign-in (ReloadClaudeToken).
- Audited as claude_credential_rebridged (no token material).
- claude.ReadTokens/ParseTokens/TokensUsable split out of LoadTokens so
  "cannot open" is distinguishable from "no token".

Tests reproduce the CLI's tmp+rename+chmod and show the shared file did
not update before the fix and does after; cover newer-shared, failed
refresh, su-exec owner read, unreadable fail-safe, legacy layout, stale
name collisions, watchdog cycle and sign-in trigger.

Refs #17039, #17253,
#17678, #17752, #17753

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 keep manager_tokens.go at its file-size ratchet baseline

Move the sign-in re-bridge body into claude_credential_bridge.go and
defer it from ReloadClaudeToken (LIFO: after the Unlock).

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› harden shared-home permission guard and credential promotion against non-regular files

Shared logins and CLI configs written by the hive (.claude/.credentials.json,
.copilot/config.json, the durable Copilot token) now go through a new
crux/sharedfile package: a randomly named temporary beside the target, mode
and owner set and verified on the open descriptor, rename, directory fsync,
and the write is refused unless the target is absent or a regular file in a
regular directory the server owns. Credential promotion writes a canonical
re-encoding of the parsed token block and checks the moved-aside source is the
same regular file before and after.

Parity with the v6 fail-safe behaviour: an unreadable private credential is
left in place except on a dashboard sign-in with a usable shared login, the
refusal is logged once per file version, WriteCredentials refuses a credential
without an access token, and ReadTokens treats malformed JSON as nothing
usable.

entrypoint.sh: the shared dot-dirs get the sticky bit (not under
HIVE_SHARED_AGENT_HOME=1); the single-file repairs act only on a regular file
in a regular directory and WARN once otherwise; the remaining root chmod/chown
sites under agent-writable directories gained the same checks. The Go
permissions watcher keeps setgid/sticky when widening a directory's group
bits. Shell tests drive the shipped guard functions with non-regular entries.

Refs #17039, #17253, #17678, #17748

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 wait for the watchdog re-bridge with testutil.Eventually instead of a polling sleep

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
clubanderson added a commit that referenced this pull request Nov 12, 2026
…omes and harden shared-home permission handling (#17807)

Top-up of #17767 (v5 squash 0cf675d) onto v6, merged into the
credential bridge v6 already carries from #17253/#17590:

- keeps v6's dashboard surface (credentialBridgeBroken, resume after
  sign-in) and the legacy-dir-link rules;
- brings the sharedfile-based promotion, owner read through su-exec,
  newest-expiresAt rule, 5s bridge cadence
  (HIVE_CLAUDE_CREDENTIAL_BRIDGE_INTERVAL), and the fail-safe handling
  of an unreadable private file (left in place except on sign-in);
- hardens the shared-home permission guard and credential promotion
  against non-regular files (entrypoint guard, sticky shared dot-dirs,
  crux/sharedfile writer for the Claude login and Copilot config);
- a dashboard sign-in still recovers a shared credential path that is a
  dangling or self-referencing link (#17590), by unlinking it first.

Supersedes #17678 and #17748.

(cherry picked from commit 0cf675d)

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
clubanderson added a commit that referenced this pull request Nov 12, 2026
* πŸ› agents: Copilot CLI ET_EXEC binary fails with ENOEXEC on kernel 6.12 β€” exec via ld.so + startup preflight (#17737)

Fixes #17729. Refs #17642.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.221.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.221.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* fix: warn once per agent about user identity in agent gitconfig (#17742)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: name ENOEXEC instead of dumping binary stderr in model discovery error (#17756)

* πŸ› fix: name ENOEXEC instead of dumping binary stderr in model discovery error

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: import unicode/utf8 and keep ANSI-coloured stderr out of the ENOEXEC check

cli_models.go used utf8.ValidString without importing unicode/utf8, so the
dashboard package failed to build. isBinaryStderr also treated ESC (0x1b) as
a binary control byte, so coloured stderr would have been mislabelled as an
ENOEXEC dump; ESC is now allowed alongside the whitespace controls, with a
regression test.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ✨ crux: Substrate as the 4th sandbox runtime (opt-in, preflight-gated) (#17741)

* ✨ crux: Substrate as the 4th sandbox runtime (opt-in, preflight-gated)

Add Agent Substrate (CNCF Sandbox) as sandbox.runtime: substrate behind
the existing sandbox.Launcher seam, mirroring the OpenShell runtime
(ADR-0026 phase 2).

- crux/sandbox/substrate*.go: SubstrateLauncher (ActorTemplate + Actor
  per kick, atenet-egress policy derived from the proxy host set +
  allow_hosts, workspace push/run/pull through an in-actor bridge over
  the atenet-router mTLS CONNECT tunnel, snapshot_on_idle suspends
  instead of deleting), real gRPC client constructed lazily, Control
  API preflight registered into crux/config.
- crux/sandbox/substrateapi: trimmed, wire-compatible proto subset of
  ate.control.v1 generated in-repo (no go.ate.dev/substrate import:
  it requires Go 1.27 and is very large). Zero new Go modules.
- crux/sandbox/substratebridge: the HTTP bridge served inside the actor.
- crux/config/agent_config_substrate.go: sandbox.substrate.* leaves with
  per-agent merge; pkg/config gate warnings (digest-pinned image).
- Settings parity allowlist entries for the new leaves (#17699).

Fixes #17697
Part of #17695

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* changelog: fragment for #17741

Generated by changelog-fragment-guard from the PR title (#5675).
Edit the wording freely, or replace this file with the no-changelog
label if the change is not user-visible.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* 🌱 changelog: make the substrate fragment an entry bullet

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 changelog: drop the auto-generated duplicate fragment

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 substrateapi: drop a never-true nil comparison flagged by staticcheck

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* πŸ“– docs: ADR-0026 phase 2 β€” Agent Substrate runtime operator and deploy notes (#17745)

* πŸ“– docs: ADR-0026 phase 2 β€” Agent Substrate runtime operator and deploy notes

Amend ADR-0026 with the Substrate implementation notes (contract mapping,
deviations from the reference model, cluster prerequisites and which hive
clusters qualify, when to choose it over OpenShell); add the operator
section to sandbox-isolation.md, the integrations table row, deploy/README
pointer and a new deploy/substrate.md with install and verification steps.

Part of #17695

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* changelog: fragment for #17745

Generated by changelog-fragment-guard from the PR title (#5675).
Edit the wording freely, or replace this file with the no-changelog
label if the change is not user-visible.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* 🌱 changelog: make the substrate docs fragment an entry bullet

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 changelog: drop the auto-generated duplicate fragment

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ“– docs: fix the ADR-0002 link in the Substrate section

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Signed-off-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* πŸ”– release: v5.221.1

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.221.1 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* fix: stop read-only lanes retrying hive:unauthorized label removal (#17743)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* fix: reconcile and expire effect-ledger ops stuck in Unknown (#17746)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: guard nil config in stageEngineOptions before reading WorkflowsDir (#17765)

stageEngineOptions dereferenced cfg.Data.WorkflowsDir as an argument before any nil check. Because stageEngine is a package-level sync.Once, the panic only fired when a nil-config caller was first in the process, making it order-dependent. Build the workflow store only when cfg != nil.

Closes #17736

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› Skip archived repositories during GFI curation (#17739)

* Fix GFI curation for archived repositories

Hive-Run: hivecommons/hive#17734
Hive-Plan: archived-repository GFI recovery
Hive-Spec: good-first-issue#archived-repositories
Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

* fix: correct changelog fragment category

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

---------

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.222.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.222.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› marketplace: resume CNCF catalogue seeding across hub restarts and let spokes trigger refresh (#17773)

* πŸ› marketplace: resume CNCF catalogue seeding across hub restarts and let spokes trigger refresh

Root cause of the one-entry catalogue on hive.hivecommons.dev: GitHub
tarballs lead with a pax_global_header entry, which Go's tar reader
surfaces as a header. ExtractTarGz counted it as a second top-level name,
returned dest instead of the wrapped "<owner>-<repo>-<sha>/" directory,
and ingest.ReadTree then saw every path with the wrapper prefix β€” no
GitHub Actions workflow matched. Only tektoncd/pipeline got through, via
the content-based Tekton sniff. Skip pax headers when extracting.

Seeding is now resumable: at startup the hub ingests every corpus repo
that is due (no record, record older than 24h or in an older format,
error older than 1h) instead of only when the catalogue is empty, so a
restart mid-seed continues and a flapping hub does not re-crawl fresh
repos. Records carry a format version; bumping it (format 2 for the
tarball fix) re-ingests everything on the next boot. The last run summary
is persisted so status.lastRefresh survives restarts; status gains
pendingRepos/lastRefreshErrors and ?verbose=1 (spoke or admin) lists the
failing repos with their errors.

POST /api/marketplace/refresh accepts the same credentials as publish
(hub admin session or spoke heartbeat bearer + X-Hive-ID); spokes are
rate-limited (one full run/hour, 10 ?repo= runs/min β†’ 429 + Retry-After),
admins are not. The spoke proxy passes 429/409 through with the hub's
message. The crawl sleeps on 403/429 Retry-After (secondary limits) and
logs progress every 25 repos.

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› marketplace: update refresh tooltip in static-src and regenerate index.html

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: bound consecutive stale-snapshot drops in the status builder (#17744)

* fix: bound consecutive stale-snapshot drops in the status builder

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ“– docs: update staleDropStarvationThreshold comment for bounded publish

The constant's doc comment still described the pre-PR contract (drop
logged at Warn). It now marks the point where the build is published
anyway to bound staleness.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ“– docs: resync api-reference citations after server.go route shift

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Signed-off-by: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› fix: log Prow ok-to-test rejection at WARN only when first noted (#17754)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* ✨ crux: Substrate preflight prover (operator, CRDs, gVisor RuntimeClass, feature gates) (#17766)

* ✨ crux: Substrate preflight prover (operator, CRDs, gVisor RuntimeClass, feature gates)

Extends the sandbox.runtime: substrate preflight with the cluster facts
behind a failing kick: operator CRDs and workloads, ready WorkerPools and
their sandbox classes, gVisor (SandboxConfig or runsc RuntimeClass) and
KVM availability, node kernels, the certificates.k8s.io APIs behind the
PodCertificateRequest and ClusterTrustBundle feature gates, and an mTLS
CONNECT probe of atenet-router. Skipped outside a cluster; one warning
when RBAC is missing, with a manifest that grants it.

Fixes #17698

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* fix(crux/sandbox): egress policy atespace + in-place workspace clear found by #17697 kick

The first real kick through Substrate v1.0.0 (kind, gVisor) surfaced two
defects in the launcher path: CreateActorEgressPolicy was rejected with
'egress_policy.metadata.atespace: Required value', and the bridge's PUT
/workspace failed with EBUSY because os.RemoveAll targeted the durableDir
mount point itself. Set the atespace on the singleton policy and clear the
workspace directory's contents in place.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* test(crux/sandbox): run the kube/router preflight halves only in a Pod wired for Substrate

CI runs in Pods, so /var/run/secrets/kubernetes.io/serviceaccount/token
exists there and the kube/router halves of the prover ran during the
Control-API-only tests (crux/sandbox and crux/agent). The prover now
requires both the Kubernetes token and hive's projected Substrate token
(opts.token_file, /var/run/secrets/ate/token by default) before probing the
cluster; the Kubernetes token path is a package variable the sandbox test
package pins to a nonexistent file, with a helper that flips both markers on
for the tests covering the in-cluster branches.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: openshell sandbox names and driver_config fit gateway 0.1.8 limits (#17780)

Prototype on LKE (#17643) hit four gateway rejections before a kick ran:
sandbox names over MAX_ROUTABLE_NAME_LEN (19), the reserved 'workspace'
volume name, default-denied pod labels/annotations, and the missing Agent
Sandbox prerequisite. Names are now hk-<slug>-<base36 unix> (fnv tag when
the slug does not fit), the claim mounts as hive-workspace, and the deploy
doc records the operator settings the measurements depended on
(allowed_pod_labels, workspaceStorageClass, sandboxUid, auth modes) plus
the landlock-in-LSM preflight lesson and the measured numbers.

Refs #17643, #17642

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.222.1

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.222.1 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› marketplace: stream repository tarballs and keep only pipeline files (#17793)

The marketplace fetcher extracted each default-branch tarball to disk via
complexity.ExtractTarGz under a 256 MiB whole-tree cap, so large monorepos
(kubernetes/kubernetes, kserve/kserve, meshery/meshery, shipwright-io/build,
spidernet-io/spiderpool) failed with "archive exceeds size cap" and never
reached the catalogue. ingest.ReadTarball now streams the archive and keeps
only the paths ReadTree would select (shared selectTreeFile), 1 MiB per
file and 32 MiB in total, discarding everything else without buffering;
the complexity cap is untouched for its own callers.

GET /api/marketplace/status now includes failing:[{repo,error,checkedAt}]
without ?verbose=1 (repo names and fetch errors carry no secrets), so an
operator with a plain PAT can see why repos fail. Four corpus entries that
GitHub now redirects are updated to their current names.

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: redact proxy userinfo in upstreamproxy URL errors (#17731)

* πŸ› fix: redact proxy userinfo in upstreamproxy URL errors

parseProxyURL formatted the raw proxy URL into its rejection errors, and
configureUpstreamProxy logs that error, so a malformed URL carrying the
proxy's Basic credential put the password in the hive JSON log on every
boot. logscrub's basic-auth category covers Authorization headers only,
not URL userinfo, so nothing downstream masked it. Use url.Redacted() on
the parsed form, strip the userinfo segment when url.Parse itself fails,
and drop the *url.Error wrapper whose message repeats the full URL.

Fixes #17730

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* chore: re-key merge request after transient lint-pending refusal

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* ✨ benchmarks: per-PR estimated cost in /api/benchmarks/export (#17791)

Records now carry cost.basis (tokens_x_pricing | unknown), cost.usd_est,
token share, launches and price_table_date, attributed from the spoke's
launch-cost collector: the swarm's PR ref for reviewer records, the
governor's issue ref of an issue the PR closed for author records (both
ref spellings). Vendored benchmarks schema refreshed; converter and
dashboard lookup tests; docs cost section.

Fixes #17790
Refs #17694

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.223.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.223.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ marketplace: seed curated models and ship the CNCF TechDocs assessment workflow (#17798)

Curated marketplace tier gets a source of truth in the binary:
pkg/hub/marketplace/curated/*.yaml is embedded, strictly decoded, checked
for the curated invariants (provenance curated, a version, nothing left
inferred), compiled through bundle.Export and published at tier curated
on hub startup and at the start of every refresh run when that
name@version is absent. Bad files are logged and skipped, never fatal;
edits without a version bump are refused as conflicts, so a new version
is a new file. Seeded keys are reported in lastRefresh.curated.

The first curated model is cncf-techdocs-assessment@curated-2026.11.1:
Nate W.'s AI-assisted TechDocs assessment process (spec at
nate-double-u/cncf-techdocs@882be6f, intake template @ad91530), scoped to
cncf/techdocs. Issues travel requested β†’ accepted β†’ draft-open (β†’
escalated) β†’ closed/declined; deliverable PRs travel drafting β†’ in-review
β†’ stakeholder-review β†’ awaiting-merge β†’ merged with checks-failing and
discarded branches. Every gate (/accept, /decline, /verify, /ready,
/confirm, /approve, /discard, /abort) is released by a human role; the
drafter and verifier agents stop at gates. Checks are the repo's
format/link/spell-check workflows plus the manual provenance block. The
rules evaluator is exercised over hand-written Facts for each step.

cncf/techdocs is not a landscape project, so the corpus package gains an
operator-added extra.json merged into Repos(); the ingested-unreviewed
version now sits next to the curated one.

Docs: marketplace section of docs/design/workflow-models.md (curated
seeding, where a model goes, how versions work) and
docs/workflows/techdocs-assessment.md for the TechDocs team.

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: classify repeated agent-lifecycle log lines instead of filing unclassified selfreports (#17757)

* πŸ› fix: classify repeated agent-lifecycle log lines instead of filing unclassified selfreports

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* test: expect agent_lifecycle_repeated class for non-held kick failures

TestPostRestartKickHoldLogsWithoutFleetReport asserted the generic
unclassified class; 'failed to send kick' is now classified as
agent_lifecycle_repeated. Held kicks still produce no observation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› fix(marketplace): refuse and downgrade model-provenance curated claims from non-admin bundles (#17764)

* πŸ› fix(marketplace): refuse and downgrade model-provenance curated claims from non-admin bundles

The hub checked only the envelope Tier when deciding whether a publisher may
assert curated/built-in; the model's own spec.meta.provenance is hash-covered
and stored verbatim. Spoke import preferred the model's provenance over the
envelope tier, so a registered spoke could publish a bundle every importer
badged as curated. The hub now refuses such bundles from non-admins (it
cannot rewrite the hash-covered model) and importers honour a vouched model
provenance only when the envelope asserts the same tier.

Fixes #17763

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* fix(marketplace): express importedProvenance as an if so the mutation gate sees its coverage

Go's cover tool does not instrument the case expressions of a tagless
switch, only the case bodies, so gremlins reported the three conditionals
on the switch as NOT COVERED even though TestImportedProvenance exercises
every branch. Fold the switch into a single if with identical semantics;
if conditions sit inside the preceding coverage block and are attributed
correctly.

No behaviour change: empty provenance still takes the envelope tier, and a
curated/built-in claim the envelope does not assert still falls back to it.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› fix: hub digest reads a stale stage-tracker body instead of blocking on a rebuild (#17785)

* πŸ› fix: let the hub activity digest read a stale stage-tracker body instead of blocking on a rebuild

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* πŸ§ͺ test: wait for the hub digest rebuild with testutil.Eventually instead of a sleep loop

TestSleepRatchet failed on CI (196 time.Sleep calls in tests, baseline 195):
the new stale-read test polled stageTrackerBuild with a hand-rolled
time.Sleep loop. Use testutil.Eventually, which is the helper the ratchet
points to.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› fix: log issue-claims GitHub side-effect retries below WARN (#17786)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: detect orphaned queued workflow runs in automerge held-run resolution (#17787)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* ✨ dashboard: surface agent_sandbox.substrate and per-agent sandbox.substrate settings (#17788)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› claude auth: share refreshed logins across per-agent .claude homes without sharing memory (#17767)

* πŸ› claude auth: share refreshed logins across per-agent .claude homes without sharing memory

Since the per-agent CLI homes landed, each per-UID agent has a real
~/.claude directory with only .credentials.json symlinked to the shared
login at /data/home/.claude/.credentials.json. Claude Code refreshes its
token by writing a temp file in ~/.claude and renaming it over
.credentials.json, then chmod 0600. The rename replaces the symlink with
a private, agent-owned file. bridgeHomeEntry refuses to clobber a regular
file, so nothing ever re-links it; the refreshed access token and the
rotated refresh grant stay in that agent's private file, the shared
credential ages out, and the rest of the fleet logs out every ~8h
(Discord report by Danathar, 2026-11-11).

Andy's direction: keep per-agent memory isolated, make an exception for
the login only. So no opt-in whole-directory sharing. Instead the hive
repairs the bridge in-process:

- repairClaudeCredentialBridge: when the agent's credential path is a
  regular file, read it (directly, or as its owner through the existing
  su-exec seam when the server cannot open an agent's 0600 file β€” the
  per-UID case), move it aside as .credentials.json.stale-<ts>, promote
  it into the shared login only if it is complete, usable and expires
  later than the shared token (a failed refresh's empty-token file never
  wins; ties keep shared), preserving the previous shared file, then
  restore the symlink. Legacy whole-directory ~/.claude symlinks and
  unreadable private files are left untouched, with a once-per-version
  log.
- Triggered at agent launch (setupPerAgentCLIHome), every 5s from the
  credential watchdog (HIVE_CLAUDE_CREDENTIAL_BRIDGE_INTERVAL) so a
  refresh is fleet-visible before siblings try the rotated grant, and
  right after a dashboard sign-in (ReloadClaudeToken).
- Audited as claude_credential_rebridged (no token material).
- claude.ReadTokens/ParseTokens/TokensUsable split out of LoadTokens so
  "cannot open" is distinguishable from "no token".

Tests reproduce the CLI's tmp+rename+chmod and show the shared file did
not update before the fix and does after; cover newer-shared, failed
refresh, su-exec owner read, unreadable fail-safe, legacy layout, stale
name collisions, watchdog cycle and sign-in trigger.

Refs hivecommons/hive#17039, hivecommons/hive#17253,
hivecommons/hive#17678, hivecommons/hive#17752, hivecommons/hive#17753

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 keep manager_tokens.go at its file-size ratchet baseline

Move the sign-in re-bridge body into claude_credential_bridge.go and
defer it from ReloadClaudeToken (LIFO: after the Unlock).

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› harden shared-home permission guard and credential promotion against non-regular files

Shared logins and CLI configs written by the hive (.claude/.credentials.json,
.copilot/config.json, the durable Copilot token) now go through a new
crux/sharedfile package: a randomly named temporary beside the target, mode
and owner set and verified on the open descriptor, rename, directory fsync,
and the write is refused unless the target is absent or a regular file in a
regular directory the server owns. Credential promotion writes a canonical
re-encoding of the parsed token block and checks the moved-aside source is the
same regular file before and after.

Parity with the v6 fail-safe behaviour: an unreadable private credential is
left in place except on a dashboard sign-in with a usable shared login, the
refusal is logged once per file version, WriteCredentials refuses a credential
without an access token, and ReadTokens treats malformed JSON as nothing
usable.

entrypoint.sh: the shared dot-dirs get the sticky bit (not under
HIVE_SHARED_AGENT_HOME=1); the single-file repairs act only on a regular file
in a regular directory and WARN once otherwise; the remaining root chmod/chown
sites under agent-writable directories gained the same checks. The Go
permissions watcher keeps setgid/sticky when widening a directory's group
bits. Shell tests drive the shipped guard functions with non-regular entries.

Refs hivecommons/hive#17039, hivecommons/hive#17253, hivecommons/hive#17678, hivecommons/hive#17748

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 wait for the watchdog re-bridge with testutil.Eventually instead of a polling sleep

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.224.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.224.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ hub: per-cluster host_aliases for hosted hives (#17805)

* ✨ hub: per-cluster host_aliases for hosted hives

Adds ClusterConfig.host_aliases ([{ip, hostnames[]}]) to /data/saas/clusters.json,
validated at load (IP parses, hostnames non-empty, lowercased; invalid blocks are
dropped with a warning, never the cluster). Rendered as Pod hostAliases in the
hosted-hive Deployment template next to the upstream_proxy env injection, and a
throttled, rate-limited reconcile sweep (3 patches / 15 min) converges existing
hives while preserving unrelated hand-applied aliases.

Needed for GHE hosts reachable only through a TLS reverse proxy on a fixed IP
(no CONNECT proxy), where upstream_proxy cannot apply.

Fixes #17801

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ“– api-reference: resync hub-server.go citations after host_aliases field

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: count PR author's own sign-off after a hive rebase; no decision gate on DCO asks (#17795)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* ✨ dashboard: render Substrate preflight warnings on the agent card (#17796)

* ✨ feat: render Substrate preflight warnings on the agent card

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› test: seed proc.Config so sandbox-warnings status test matches the builder's input

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: dedupe repeated undelivered review kick warning (#17755)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› fix: cache app_keys_held key fingerprints so heartbeat collect stays in budget (#17806)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.225.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.225.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› fix(marketplace): restrict spoke-triggered ?repo= refresh to tracked repositories (#17800)

* πŸ› fix(marketplace): restrict spoke-triggered ?repo= refresh to tracked repositories

A registered spoke could pass any owner/name to POST /api/marketplace/refresh
and the hub would fetch it with its own GitHub identity and publish the
ingested model under the hub's name. Non-admin callers must now name a corpus
or HIVE_HUB_MARKETPLACE_EXTRA_REPOS entry; admins are unchanged.

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* 🌱 chore: refresh head to re-report required checks

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.226.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.226.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ”’ substratebridge: refuse tar entries that write through symlinks on Unpack (#17813)

* πŸ”’ substrate: unpack pulled workspaces through os.Root so tar symlinks cannot escape

Fixes #17769

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* chore: re-trigger required checks after base moved

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* ✨ dashboard: show substrate kicks and stream bridge output in the terminal pane (#17809)

* ✨ dashboard: show substrate kicks and stream bridge output in the terminal pane

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› substratebridge: create the workspace dir before the streaming run test

newBridgeServer intentionally leaves the workspace path uncreated so the
PUT/GET workspace tests can exercise the missing-directory paths, but
TestHandlerStreamsRunOutput ran a command in it and failed with
chdir: no such file or directory before any frame was streamed.

Hive-Fix-Attempt: 1/6
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› substrate kicks: stream only transitions after the viewer connected; cover new sandbox paths

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› Mark hive's in-cluster k8s API dials so the egress redirect never MITMs them (#17818)

* πŸ› Mark hive's in-cluster k8s API dials so the egress redirect never MITMs them

On nodes without the xt_owner netfilter module (IBM Cloud IKS/ROKS) the
HIVE_PROXY chain has only the packet-mark self-exemption, so every :443
dial the hive makes for itself must carry SO_MARK. The proxy's upstream
dials did; the spoke's own Kubernetes API clients (self-upgrade, startup
probe, node metrics, ingress probes, kubejob) did not, so they were
REDIRECTed into the MITM proxy, hit the private-range forward guard and
got EOF β€” every wec2 hive failed self-upgrade with
'reading startup probe before upgrade … EOF'.

Move the SO_MARK dialer into a new crux/egressmark package (crux/proxy
imports crux/agent which imports kubejob, so kubejob cannot import
proxy) and use it for all five in-cluster API transports.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 Allow crux/egressmark in the dashboard import ratchet

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 Add crux/egressmark tests for the coverage gate

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› hub: stop flagging off-cadence and scheduled agents as idle-with-work (#17825)

classifyInactiveAgent ignored AgentSummary.ExpectedActive, so an agent with
no cadence in the governor's current mode (e.g. redteam while quiet) was
alerted as idle whenever the hive had queued work. Spokes also reported
KickIntervalSec=0 for times/cron cadences, dropping the hub to the 45m rule
between slots. Skip the idle rule when the spoke says the agent is not
expected active, and report the gap from the last fired slot to the next
as the kick interval for scheduled cadences.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: use unique temp files when persisting hive and reach state (#17740)

* fix: use unique temp files when persisting hive and reach state

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* 🌱 chore: re-run PR verifier after cancelled concurrent run

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* 🌱 chore: refresh head to clear a Copilot PR Automation run stuck in queued

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› hub heartbeat: back off and classify a permanent 403 rejection (#17823)

* πŸ› hub heartbeat: back off and classify a permanent 403 rejection instead of retrying every tick

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* 🌱 fleetreport: add threshold case for hub_heartbeat_rejected_unprovisioned

TestEveryRuntimeClassTriggerAndNonTriggerThresholds requires every class in
Classes to have a trigger/non-trigger case; the new class was missing one.

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.227.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.227.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ knowledge: Plaud voice notes as a knowledge source (#17821)

* ✨ knowledge: Plaud voice notes as a knowledge source

Add a plaud knowledge connector that reads Plaud Note recordings (Plaud
summary + transcript) through the free official Plaud MCP server over
stdio, with a minimal JSON-RPC MCP client, Connect/Disconnect sign-in on
the Knowledge Integrations card, docs and tests.

Fixes #17820

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 knowledge/plaud: port dashboard edits to static-src, document auth routes in openapi.json, drop unused field

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› hive: do not gate the dashboard bind on the advisory-issue ensure (#17829)

* πŸ› hive: do not gate the dashboard bind on the advisory-issue ensure

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* πŸ› hive: add missing time import in boot_github_deps_test

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ”– release: v5.227.1

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.227.1 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› substrate: garbage-collect older suspended kick actors when snapshot_on_idle is on (#17830)

* πŸ› substrate: garbage-collect older suspended kick actors when snapshot_on_idle is on

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› substrate: scope superseded-actor GC to the atespace it was created in and log via slog

Review follow-up for #17830:
- lastSuspended records {Name, Atespace}; the delete uses the stored
  atespace and is skipped (with a warning) when the agent's atespace
  changed between kicks, instead of targeting a name never created there.
- Replace stdlib log.Printf with an injected *slog.Logger on
  SubstrateOptions (slog.Default() fallback), wired from the agent
  manager, with agent/actor/atespace/error attrs.
- Document the one-snapshot-per-agent retention rule in
  sandbox-isolation.md, ADR 0026 and the dashboard snapshot_on_idle help.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ› hub: converge startupProbe and init image onto existing hosted deployments (#17831)

* πŸ› hub: converge startupProbe and init image onto existing hosted deployments

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* docs: resync hub-server api-reference citations after server.go field insertion

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* πŸ”– release: v5.228.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› hub: negatively cache rejected bearer tokens; stop re-probing exhausted user quota (#17837)

validateGitHubToken re-hit GET /user with the caller's own token on every
request once the token was rejected or rate-limited, charging the owner's
exhausted core bucket and prolonging the 401 outage. Remember 401/403/429
for 60 s (or until X-RateLimit-Reset, capped at 15 min), record the probe in
REST accounting under the pass-through caller agent:hub-bearer-validate, and
route hub release-notes contents reads through the shared ETag/accounting
transport. Document the fleet-wide operator steps for getting personal
tokens out of cluster secrets (ARC runner scale set -> GitHub App auth).

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› crux serve: count auth-rejected requests in crux.serve.auth.rejections (#17839)

instrument sits inside authenticate, so requests refused with a 401 never reached crux.serve.requests or crux.serve.request.duration. Wrapping authenticate with instrument would label them with the unmatched route, so a separate counter, crux.serve.auth.rejections, is incremented in each 401 branch of authenticate. Its only attribute is a fixed-enum reason (missing_or_invalid_token, project_forbidden, no_token_configured); never a token, path or remote address.

Closes hivecommons/crux#146

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.228.1

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.1 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* fix(hub): bound bearer token validation cache (#17846)

Sweep expired entries at capacity and skip new entries when all slots remain occupied. Apply the same limit to accepted and rejected tokens.

Hive-Run: hivecommons/hive#17844
Hive-Plan: issue-17844-cap-and-expired-sweep
Hive-Spec: issue-17844#recommendation

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>

* πŸ”– release: v5.228.2

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.2 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ”’ knowledge: start the Plaud MCP server with an allowlisted env, not the hive process env (#17845)

stdioMCPDialer passed os.Environ() to a third-party MCP server fetched at
run time (npx -y @plaud-ai/mcp@latest), so every hub-injected credential
the hive process carries β€” DASHBOARD_AUTH_TOKEN (server-verified owner on
the dashboard API), HIVE_TERMINAL_KEY, HIVE_HEARTBEAT_KEY, HIVE_HUB_SECRET,
HIVE_UPSTREAM_PROXY_URL (proxy Basic credential), GitHub/Linear/provider
keys β€” reached code the hive does not control. crux/agent strips the same
set from agent panes (#17657); the MCP dialer bypassed that.

The child now gets an allowlist: PATH, HOME, locale, TMPDIR, TERM, the
proxy and CA-bundle variables Node needs to reach the registry through the
egress proxy, NODE_*/npm_config_*/NPM_CONFIG_* and PLAUD_*. Any name that
contains TOKEN, SECRET, PASSWORD or CREDENTIAL is dropped even when it
matches a prefix.

Fixes #17843

Signed-off-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: sec-check <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.228.3

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.3 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ”– release: v5.228.4

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.4 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* 🌱 images: bump omp 18.18.0 -> 18.19.0 (#17850)

Automated pin bump (#8419). Digests recomputed from the downloaded
release artifacts by src/scripts/cli-pin-bump.sh:

  VERSION=18.19.0
  SHA256_AMD64=b44fda2ae5c9cce2bbe124d1672cba532a136d9e1eef68599b16efcd3bc5c626
  SHA256_ARM64=61826bf89c2c0512417fee05fa2f486e60ee11b23ea95a17257a6c49edb6b8d5

Signed-off-by: hive-release[bot] <hive-release@hive.kubestellar.io>
Signed-off-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: hive-release[bot] <hive-release@hive.kubestellar.io>

* πŸ› army: stop attributing adopted PRs to a remote agent's rework queue and show why a fix is not dispatched (#17853)

The contribute fleet card listed every stage-store record by author in 072
or 074 as the relay's pending rework, so merged/closed PRs still carrying
stage/074-adopted-by-hive (the store prunes them only after 14 days) and
PRs the hive had taken over piled up as '33 PRs awaiting rework'. Only open,
not-adopted, not-dispatched PRs count now: the forge cache decides open vs
merged/closed when it knows the PR, otherwise a record the stage lane has
not re-observed for an hour is treated as gone. A queued fix whose PR is
gone leaves the fix queue instead of being handed to the relay.

The idle-with-queue stall: a fix dispatched to a socket that dropped stays
booked in flight with nobody holding it, so capacity 1 is busy forever and
the relay gets neither the fix nor new work (task_unavailable
fix_pr_in_flight, which the card hid behind 'idle Β· N awaiting rework').
The relay's next ready now releases such orphans (no attempt counted) and a
task_complete for the dispatch on a reconnected socket settles it. The card
prints the dispatcher's actual reason (pending_rework_blocked) instead of
'not yet dispatched', and links at most three PRs inline with the rest
behind a show-N-more disclosure.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: detect missing GitHub App repository coverage (#17733)

* fix: detect missing GitHub App repository coverage

Hive-Run: hivecommons/hive#17696
Hive-Plan: repository access and advisory recovery
Hive-Spec: issue-17696#expected
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

* fix: add App repository coverage changelog

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

* fix: bound boot coverage and probe large installations

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

* docs: clarify GitHub App coverage polling

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>

---------

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.228.5

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.5 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ knowledge: Wispr Flow dictation history as a knowledge source (#17855)

* ✨ knowledge: Wispr Flow dictation history as a knowledge source

Adds knowledge.connectors[].type: wisprflow. Reads the desktop app's local
flow.sqlite read-only through the sqlite3 CLI (text columns only, never the
audio/screenshot BLOBs) or a folder of exported .json/.ndjson/.csv/.md
files, and emits one fact per finalised dictation (or per day) with the
dictation time, source app and URL. Incremental by timestamp with a 2h
overlap; min_words and apps filters; tags.

Dashboard: Knowledge -> Integrations card (path, status, last sync, count),
Add-source entry pointing out that new dictations need no connector at all
(dictate into + New Fact). Docs section next to Plaud's; changelog fragment.

Fixes #17854

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› knowledge: wisprflow tests run without the sqlite3 CLI

Sync tests now use a fake sqlite3 runner fed from testdata/wisprflow/history.json
so the SQLite path is exercised (and counted for coverage) on runners without
the CLI; the real-CLI test skips when sqlite3 is absent. TestWisprValidate
passes an explicit path so it no longer depends on a macOS default location.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix(agent): replace unopenable pluk session log so the supervisor can create it (#17889)

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ”– release: v5.228.6

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.6 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ workflows: owner toggle for model-based stage derivation from the dashboard (#17886)

* ✨ workflows: owner toggle for model-based stage derivation from the dashboard

workflow.enabled gates rules-based stage derivation and bound-model label
provisioning, but could only be set by editing hive.yaml, which hosted
hives cannot do. Add PUT /api/workflows/enabled {enabled} (owner-gated,
persists hive.yaml, audited workflow_enabled / workflow_disabled) and a
"Derive stages from bound models" switch in Settings β†’ Workflows β†’ Library
that confirms before turning on. The stage engine and the tracker already
read cfg.Workflow.Enabled live and the reloader mutates the same *Config
in place, so no reload hook is needed. Turning on also provisions every
bound repository's model labels at once through the sweep's memoised
ensureStageLabels path (new automerge.Engine.EnsureStageLabels, wired as
Dependencies.WorkflowProvisionLabels); failures come back as warnings and
the next sweep retries. The Repos binding row says "columns only β€” turn
on derivation in Workflows" when a binding exists while the flag is off.

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* chore: move changelog fragment to root changelog.d/

Refs hivecommons/hive#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.229.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.229.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* fix: classify plain HTTP proxy forwarding failures (#17864)

Hive-Run: hivecommons/hive#17859
Hive-Plan: classify repeated proxy forward failures
Hive-Spec: fleet-report#runtime-classes

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* ✨ Inbox: voice recorders as first-class input sources (Plaud β†’ spek RFC / dibs / knowledge) (#17885)

* ✨ Inbox: voice recorders as first-class input sources

Add a source-agnostic Inbox (sidebar β†’ Intelligence) that lists recordings
synced by voice knowledge connectors (plaud now, wisprflow next), keyed by
(source, item_id), and routes each one inside the hive to a spektacular RFC
with child issues (spektacular voice --publish, or a spoke-agent fallback),
a dibs draft idea, or Knowledge only β€” single, bulk, or by auto-routing
rules applied after every sync.

- pkg/inbox: Item/RouteState model, JSON store, fact-backed source,
  rules, spek_rfc + dibs destinations, service with sweep.
- config: inbox.{sources,rules,spek,dibs} + validation.
- dashboard: GET /api/inbox, POST /api/inbox/{route,dismiss},
  GET|POST /api/inbox/settings, Inbox section + modals, sidebar badge.
- Plaud: POST /api/knowledge/connectors/{name}/auth/complete paste
  fallback for hosted hives (Plaud OAuth only redirects to localhost:8199);
  the Integrations card now shows connection state + Open Inbox only.
- docs: inbox-voice-sources.md, knowledge-connectors.md, api-reference,
  dashboard-sections, openapi.json.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* ✨ Inbox: default spek_rfc agent fallback to first enabled agent

When the hive image has no spektacular binary and inbox.spek.agent is
unset, hand the RFC job to the alphabetically first enabled, unpaused
agent so candidate hives can file RFCs without extra config.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 Inbox: allowlist pkg/inbox dashboard import; sidebar order test includes inbox-section

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 Inbox: cover service/store/source edge cases and inbox config validation

Raises pkg/inbox to 92% and pkg/config back over the 90% coverage floor.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.230.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.230.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› PR comments: overlap/mutation only on a finding, thank first-time contributors only, no self-/lgtm relay on Prow PRs (#17870)

* πŸ› PR comments: post overlap/mutation reports only on a finding, thank first-time contributors only, no self-/lgtm relay on Prow PRs

Fixes #17863.

- .github/scripts/pr-overlap.sh: create the <!-- hive-pr-overlap --> comment
  only when a sibling PR conflicts or shares a file; a later clean run edits
  the existing comment to a one-line Resolved note; never post for a PR that
  never had a finding. The step summary keeps the full report.
- src/scripts/mutation-report.sh post: same for <!-- hive-mutation --> on a
  pass verdict; the report is appended to the step summary first.
- src/scripts/feedback-gate.sh (+ test): decides whether the merge thank-you
  is posted β€” skips bot/App authors, scanner/* and hive/* branches, hive-origin
  bodies and returning contributors; FEEDBACK_* env knobs. Wired by the
  feedback.yml change in the next commit.
- pkg/github: a dashboard approval on a Prow-managed, hive-authored PR relays
  /approve only (LGTMSkipped); Prow rejects a self-/lgtm every time and no
  hive lane reads the relayed /lgtm.
- docs: notifications.md (new section + Prow config location), glossary,
  running-at-level-6; changelog fragment.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› workflows: gate the Feedback Wanted thank-you on src/scripts/feedback-gate.sh

Refs #17863. Workflow-only commit: adds a gate job (self-test + decision)
before the hivecommons/infra reusable-feedback call, which runs only when
the gate outputs post=true.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 governance: re-pin TRUSTED_SCRIPTS_TREE for the feedback-gate and mutation-report scripts

Refs #17863. src/scripts gained feedback-gate.sh / test-feedback-gate.sh and
mutation-report.sh changed, so the pinned tree moves to 1f1eb9048.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› fix: atomic runtime config save + fresh legacy fallback (#17862) (#17867)

* πŸ› fix: atomic runtime config save + fresh legacy fallback (#17862)

Config.Save wrote /etc/hive/hive.yaml and /data/hive.yaml.runtime in place
with O_TRUNC. A liveness SIGKILL between truncate and write left a 0-byte
runtime file; the entrypoint's -s check then fell back to /data/hive.yaml.bak,
frozen at the Aug 2026 rename on every hive, and vllmd-03 booted level 3
instead of 6.

- writeFileAtomic: temp file in the target's dir, fsync, rename onto the
  EvalSymlinks-resolved target so the #17468 link survives; falls back to
  the old in-place write when rename is refused (single-file bind mounts).
- Both Save writes use it; runtime stays 0600, source keeps its mode.
- entrypoint: hive_refresh_legacy_fallback copies a YAML-valid runtime
  config over hive.yaml.bak on clean boots (tmp+mv), only when the new name
  is the boot source; hive_runtime_config_read WARNs loudly on fallback and
  flags a fallback older than the damaged runtime file.
- Tests: writer unit tests incl. symlink + no-partial-read race; shell
  suite covers WARN, refresh, parse guard, legacy-boot no-op.

Fixes #17862

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* test(config): cover atomic writer failure paths for coverage floor

Adds tests for missing target dir, ENOTDIR resolve error, dangling
symlink, rename+fallback double failure (no temp leak), in-place
fallback, syncDir tolerance and sourceConfigMode, lifting pkg/config
back over its 90% coverage floor.

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ”– release: v5.231.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.231.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ› fix: wait for marketplace refresh completion in auth test (#17868)

Wait for a new refresh result rather than interpreting an idle refresher as proof that the newly accepted asynchronous run has finished.

Hive-Run: hivecommons/hive#17865

Hive-Plan: marketplace-refresh-flake

Hive-Spec: marketplace-refresh-flake#async-completion

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>

* πŸ”– release: v5.231.1

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.231.1 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* πŸ“– docs: Inbox voice sources page + quickstart link (#17899)

* πŸ“– docs: add Inbox voice sources page and quickstart links

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* πŸ“– docs: use .row utility for Inbox quickstart link group

TestStyleRatchet counts inline style= attributes in static/index.html;
the new link group pushed it over the 1403 baseline. The existing .row
utility (flex, gap var(--sp-4)) renders the same.

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ“– docs: link #17882 from the changelog fragment

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* ✨ dashboard: Settings β†’ Inbox section (default repo, dibs URL, rules) (#17901)

* ✨ dashboard: Settings β†’ Inbox section for default repo, dibs URL and rules

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

#17885 landed inbox.* config, validation, parity allowlist and /api/inbox/settings but no Settings tab section. Add Settings β†’ Inbox reusing the Inbox drawer form and endpoint. Part of #17883.

* πŸ› dashboard: scope the Inbox settings form to its active root

The Inbox settings form renders twice β€” in the Inbox page modal and inline under Settings β†’ Inbox β€” and both can be mounted at once: the settings tab stays in the DOM and the closed modal keeps its last body. inboxReadRules collected .inbox-rule rows from every #inbox-settings-rules, the repo/dibs inputs were read via getElementById (first in document) and the inline sniff kept the modal open on save, so saving from the modal after visiting Settings β†’ Inbox posted the inline form's values and left the dialog up.

Wrap the form in .inbox-settings-form[data-inbox-form=inline|modal], replace the duplicated ids with data-inbox-field attributes, and resolve one active root per operation (the modal while open, otherwise the inline section). Read, render, save and the close-modal decision all go through that root.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

---------

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* πŸ”– release: v5.232.0

Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.232.0 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>

* ✨ inbox: Plaud source onto the Source interface (#17900)

* ✨ inbox: read Plaud recordings directly through the Source interface

The Inbox only saw recordings through the facts the Plaud connector writes. Add a PlaudSource that lists/fetches straight from the connector (item id stays attr_plaud_file_id), preferred while Plaud is signed in with the fact-backed source as fallback.

Refs #17877, part of #17875.

Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@users.noreply.github.com>

* πŸ› inbox: cache the direct Plaud listing off the poll path and keep fact fields

PreferDirect.List spawned the Plaud MCP process on every Items/Find/Sweep call, so each dashboard poll paid for a process spawn plus list_files pagination and a slow spawn past the handler timeout silently flipped the UI back to facts. The direct listing is now cached for a TTL and refreshed by a single background goroutine with its own timeout; List serves the cache (or just facts while nothing is cached) and never blocks on Plaud. A failed refresh clears the cache and is not retried before the TTL.

Direct items also dropped FactSlug/FactPath/Layer/Excerpt, hiding the Fact button and excerpt for recordings that do have facts. The fact listing is now merged by id onto the direct items, and facts Plaud no longer lists stay visible.

Refs #17877.

Hive-Fix-Attempt: 1/6
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com>

* πŸ› inbox: wait on the Plaud refresh with testutil.Eventually, not a sleep loop

The sleep ratchet (TestSleepRatchet) rejects any new fixed …
hivecommons-hive Bot pushed a commit that referenced this pull request Nov 13, 2026
…without sharing memory (#17767)

* πŸ› claude auth: share refreshed logins across per-agent .claude homes without sharing memory

Since the per-agent CLI homes landed, each per-UID agent has a real
~/.claude directory with only .credentials.json symlinked to the shared
login at /data/home/.claude/.credentials.json. Claude Code refreshes its
token by writing a temp file in ~/.claude and renaming it over
.credentials.json, then chmod 0600. The rename replaces the symlink with
a private, agent-owned file. bridgeHomeEntry refuses to clobber a regular
file, so nothing ever re-links it; the refreshed access token and the
rotated refresh grant stay in that agent's private file, the shared
credential ages out, and the rest of the fleet logs out every ~8h
(Discord report by Danathar, 2026-11-11).

Andy's direction: keep per-agent memory isolated, make an exception for
the login only. So no opt-in whole-directory sharing. Instead the hive
repairs the bridge in-process:

- repairClaudeCredentialBridge: when the agent's credential path is a
  regular file, read it (directly, or as its owner through the existing
  su-exec seam when the server cannot open an agent's 0600 file β€” the
  per-UID case), move it aside as .credentials.json.stale-<ts>, promote
  it into the shared login only if it is complete, usable and expires
  later than the shared token (a failed refresh's empty-token file never
  wins; ties keep shared), preserving the previous shared file, then
  restore the symlink. Legacy whole-directory ~/.claude symlinks and
  unreadable private files are left untouched, with a once-per-version
  log.
- Triggered at agent launch (setupPerAgentCLIHome), every 5s from the
  credential watchdog (HIVE_CLAUDE_CREDENTIAL_BRIDGE_INTERVAL) so a
  refresh is fleet-visible before siblings try the rotated grant, and
  right after a dashboard sign-in (ReloadClaudeToken).
- Audited as claude_credential_rebridged (no token material).
- claude.ReadTokens/ParseTokens/TokensUsable split out of LoadTokens so
  "cannot open" is distinguishable from "no token".

Tests reproduce the CLI's tmp+rename+chmod and show the shared file did
not update before the fix and does after; cover newer-shared, failed
refresh, su-exec owner read, unreadable fail-safe, legacy layout, stale
name collisions, watchdog cycle and sign-in trigger.

Refs #17039, #17253,
#17678, #17752, #17753

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 keep manager_tokens.go at its file-size ratchet baseline

Move the sign-in re-bridge body into claude_credential_bridge.go and
defer it from ReloadClaudeToken (LIFO: after the Unlock).

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* πŸ› harden shared-home permission guard and credential promotion against non-regular files

Shared logins and CLI configs written by the hive (.claude/.credentials.json,
.copilot/config.json, the durable Copilot token) now go through a new
crux/sharedfile package: a randomly named temporary beside the target, mode
and owner set and verified on the open descriptor, rename, directory fsync,
and the write is refused unless the target is absent or a regular file in a
regular directory the server owns. Credential promotion writes a canonical
re-encoding of the parsed token block and checks the moved-aside source is the
same regular file before and after.

Parity with the v6 fail-safe behaviour: an unreadable private credential is
left in place except on a dashboard sign-in with a usable shared login, the
refusal is logged once per file version, WriteCredentials refuses a credential
without an access token, and ReadTokens treats malformed JSON as nothing
usable.

entrypoint.sh: the shared dot-dirs get the sticky bit (not under
HIVE_SHARED_AGENT_HOME=1); the single-file repairs act only on a regular file
in a regular directory and WARN once otherwise; the remaining root chmod/chown
sites under agent-writable directories gained the same checks. The Go
permissions watcher keeps setgid/sticky when widening a directory's group
bits. Shell tests drive the shipped guard functions with non-regular entries.

Refs #17039, #17253, #17678, #17748

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* 🌱 wait for the watchdog re-bridge with testutil.Eventually instead of a polling sleep

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates the PR's author has signed the DCO. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant