vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

fix(#2012): gc-safe docs claude.md via /etc indirection + option clobber note

Browse source
This commit is contained in:
damocles 2026-06-27 21:10:39 +02:00 • committed by mara
commit e6bc621f59
1 changed files with 24 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

30
nix/templates/harness-base.nix
View file

@ -235,8 +235,9 @@ in
auto-loads the file every session, so the docs are discoverable auto-loads the file every session, so the docs are discoverable
without any per-agent prompt injection. The docs themselves are without any per-agent prompt injection. The docs themselves are
always present at `$HIVE_ASSETS_DIR/docs/`; this option only controls always present at `$HIVE_ASSETS_DIR/docs/`; this option only controls
the auto-loaded pointer. Default-on for the root/manager agent (see the auto-loaded pointer. When enabled the managed symlink clobbers any
`manager.nix`), off elsewhere; any agent can flip it from its existing `~/.claude/CLAUDE.md`. Default-on for the root/manager agent
(see `manager.nix`), off elsewhere; any agent can flip it from its
`agent.nix`. `agent.nix`.
''; '';
@ -1042,12 +1043,19 @@ in
chown -hR "$userName:$userName" "$configDir" 2>/dev/null || true chown -hR "$userName:$userName" "$configDir" 2>/dev/null || true
done done
${lib.optionalString config.hyperhive.docs.enable '' ${lib.optionalString config.hyperhive.docs.enable ''
# hyperhive.docs.enable: point this agent at the hyperhive docs # hyperhive.docs.enable: point this agent at the hyperhive docs via
# via a managed `~/.claude/CLAUDE.md` (claude auto-loads it every # a managed `~/.claude/CLAUDE.md` (claude auto-loads it every
# session). Symlink → always reflects the current flake; the # session). The link lives in the bind-mounted (persistent) home, so
# it must NOT target a bare `/nix/store` path — that path is only
# GC-rooted by the current generation, and a content change (new
# hash) plus `nix-collect-garbage` would leave the persistent link
# dangling. Instead it targets the STABLE `/etc/hyperhive/claude/
# CLAUDE.md` path, which the `environment.etc` entry below
# regenerates declaratively every rebuild (and which holds the
# docs store-path reference that keeps the content GC-rooted). The
# chown -h below sets the link's ownership. # chown -h below sets the link's ownership.
mkdir -p "$homeDir/.claude" mkdir -p "$homeDir/.claude"
ln -sfn ${docsClaudeMd} "$homeDir/.claude/CLAUDE.md" ln -sfn /etc/hyperhive/claude/CLAUDE.md "$homeDir/.claude/CLAUDE.md"
''} ''}
if [ -d "$homeDir/.claude" ]; then if [ -d "$homeDir/.claude" ]; then
chown -hR "$userName:$userName" "$homeDir/.claude" 2>/dev/null || true chown -hR "$userName:$userName" "$homeDir/.claude" 2>/dev/null || true
@ -1089,6 +1097,16 @@ in
environment.etc."hyperhive/extra-mcp.json".text = builtins.toJSON config.hyperhive.extraMcpServers; environment.etc."hyperhive/extra-mcp.json".text = builtins.toJSON config.hyperhive.extraMcpServers;
# hyperhive.docs.enable: the managed `~/.claude/CLAUDE.md` content,
# placed declaratively in /etc so it's regenerated every rebuild and
# GC-rooted by the system closure. The activation script above symlinks
# the agent's (bind-mounted, persistent) `~/.claude/CLAUDE.md` at this
# stable path rather than at the bare `${docsClaudeMd}` store path, so
# the persistent link can never dangle after a content change + GC.
environment.etc."hyperhive/claude/CLAUDE.md" = lib.mkIf config.hyperhive.docs.enable {
source = docsClaudeMd;
};
# Operator-set per-agent icon (hyperhive.icon). When configured, the # Operator-set per-agent icon (hyperhive.icon). When configured, the
# SVG lands at /etc/hyperhive/icon.svg; the harness serves it at # SVG lands at /etc/hyperhive/icon.svg; the harness serves it at
# GET /icon, falling back to the bundled hyperhive logo when absent. # GET /icon, falling back to the bundled hyperhive logo when absent.