← ClaudeAtlas

stack-not-at-head-remediationlisted

Remediate a HEALTHCHECK fail on stack-not-at-head — upgrade uv packages, re-index, pin embedding canary, run post-upgrade integration, update docs, commit, snapshot. Triggers whenever /health reports stack-not-at-head.
williamblair333/Uncle-J-s-Refinery · ★ 3 · AI & Automation · score 74
Install: claude install-skill williamblair333/Uncle-J-s-Refinery
# Stack-Not-At-Head Remediation ## When to use Invoke this skill when `/health` (or any health-check run) returns: HEALTHCHECK: fail (1) -- stack-not-at-head The healthcheck output includes exact fix commands. Run the commands it prints — but on **this** repo there is one repo-specific side effect that makes the bare `uv sync` non-trivial (see the caution under step 1). Don't re-litigate *which* packages to upgrade; do handle the pysqlite3 regression and MCP restart that follow. ## Key insight (from session 2026-05-20) > "Fair. These aren't risky or ambiguous — the healthcheck gave exact fix commands and the gaps are clear. I should have just run them." When healthcheck provides an exact fix command, execute it — the *package selection* is decided. The one thing that IS repo-specific and must be handled, not skipped, is the post-sync pysqlite3 re-patch + MCP-server restart below. ## Steps ### 1. Run the upgrade command from healthcheck output Upgrade only the packages the healthcheck names (often just `jcodemunch-mcp`). mempalace is decommissioned — do NOT add `--upgrade-package mempalace`. Typical command: cd /opt/proj/Uncle-J-s-Refinery && uv lock --upgrade-package jcodemunch-mcp --upgrade-package jdatamunch-mcp --upgrade-package jdocmunch-mcp && uv sync --inexact (Use the exact command the healthcheck printed — it may differ by session.) > ⚠ **Repo-specific landmine — do not skip.** `uv sync` reverts the pysqlite3 SQLite source > build (3.51.3) back to the 3.5