Add per-entry homebrew salvage and an item-level load floor

.githooks/pre-push

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# pre-push guard (reminder, not an auto-fold): refuse to push a commit that still
+# carries docs/branch-changelog.md onto integration / develop / main. Mirrors
+# .github/workflows/changelog-guard.yml so a forgotten fold is caught locally
+# instead of on CI. The fold itself stays a deliberate manual step:
+#   scripts/fold-branch-changelog.sh "<release>"    (then commit, then push)
+#
+# Activate once per clone:  scripts/setup-hooks.sh   (or: git config core.hooksPath .githooks)
+
+status=0
+zero="0000000000000000000000000000000000000000"
+
+# Current in-progress release = the first "## [Name]" in CHANGELOG.md, so the
+# suggested fold command is copy-pasteable. Falls back to a placeholder.
+release="$(grep -m1 -oE '^## \[[^]]+\]' CHANGELOG.md 2>/dev/null | sed -E 's/^## \[(.+)\]$/\1/')"
+release="${release:-<release>}"
+
+while read -r _local_ref local_sha remote_ref _remote_sha; do
+  [ "$local_sha" = "$zero" ] && continue                    # branch deletion — skip
+  case "$remote_ref" in
+    refs/heads/integration|refs/heads/develop|refs/heads/main)
+      if git cat-file -e "${local_sha}:docs/branch-changelog.md" 2>/dev/null; then
+        target="${remote_ref#refs/heads/}"
+        echo "" >&2
+        echo "  pre-push blocked: docs/branch-changelog.md is still un-folded on the commit" >&2
+        echo "  bound for '${target}'. Fold it into CHANGELOG.md, then commit and re-push:" >&2
+        echo "" >&2
+        echo "      scripts/fold-branch-changelog.sh \"${release}\"" >&2
+        echo "" >&2
+        echo "  (Decide whether this branch earned a '## Highlights' before folding —" >&2
+        echo "   see docs/branch-changelog.template.md. To bypass once: git push --no-verify.)" >&2
+        echo "" >&2
+        status=1
+      fi
+      ;;
+  esac
+done
+
+exit $status

.github/PULL_REQUEST_TEMPLATE.md

@@ -7,4 +7,5 @@
   - [ ] I have commented my code, particularly in hard-to-understand areas
   - [ ] I have made corresponding changes to the documentation if necessary
   - [ ] There is no commented out code in this PR.
-  - [ ] My changes generate no new warnings (check the console)
+  - [ ] My changes generate no new warnings (check the console)
+  - [ ] `docs/branch-changelog.md` is updated in the house style (`docs/branch-changelog.template.md`), and I decided whether this branch earns a `## Highlights`.

.github/workflows/changelog-guard.yml

@@ -0,0 +1,32 @@
+# Guard: a branch changelog must be FOLDED into CHANGELOG.md (and removed) before
+# landing on integration or develop. See docs/CONTRIBUTING.md.
+#
+# Runs on push (the post-merge backstop): if a merge landed on integration/develop
+# without folding its docs/branch-changelog.md, this goes red — run
+# scripts/fold-branch-changelog.sh, commit, and push again. Not run on
+# pull_request, since the branch changelog legitimately lives on the feature branch
+# until it is folded at merge time.
+
+name: Changelog guard
+
+on:
+  push:
+    branches: [integration, develop, main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  branch-changelog-folded:
+    name: Branch changelog folded
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: A branch changelog must be folded before landing here
+        run: |
+          if [ -f docs/branch-changelog.md ]; then
+            echo "::error file=docs/branch-changelog.md::An un-folded branch changelog is present on $GITHUB_REF_NAME. Fold it into CHANGELOG.md and remove it before landing — run: scripts/fold-branch-changelog.sh \"<release>\""
+            exit 1
+          fi
+          echo "OK — no un-folded branch changelog on $GITHUB_REF_NAME."

.gitignore

@@ -103,3 +103,18 @@ cljsjs/
 
 # Design handoff reference material (preserved on agents/develop, not committed to code branches)
 design_handoff_character_menus
+
+# Generated clojure-CLI cljs build artifact (regenerated from project.clj; lein/figwheel-main is canonical)
+/deps.edn
+
+# Deploy-injected static vendor assets (font-awesome, etc.). index.clj references
+# /assets/... at runtime, but these binaries are provided at deploy time and are
+# not part of the source tree. A local copy may exist to render the screenshot
+# harness faithfully; never commit the vendored fonts/CSS.
+/resources/public/assets/
+/package-lock.json
+
+# Perf-investigation scratch: throwaway probe scripts and the multi-megabyte .orcbrew
+# packs generated by dev/scale_orcbrew_pack.clj. The harnesses worth keeping live in
+# test/browser/; the packs are regenerable and must not be committed.
+/dev-scratch/