Port unmerged fixes to new main

[willsupernormal]

Summary

Ports functional fixes from 3 old branches that referenced dead plugins/alive/ paths. Rebasing wasn't viable (86-file monorepo restructure = too many conflicts), so these are fresh commits re-applying the functional changes to plugins/walnut/ paths.

Depends on: PR #23 (rename sweep) — merge that first, then rebase this on top.

Source branches

• will/skill-routing-improvements — skill description + CLAUDE.md routing fixes
• will/world-skill-index-and-post-save-hook — world skill reads injected index, post-write hook auto-regenerates index
• will/statusline-and-stash-fixes — statusline absolute path, stash saves:0 gate, archive enforcer rewrite, context-watch thresholds

What changed (9 commits, 14 files)

Commit 1: Archive Enforcer (CRITICAL)

File: walnut-archive-enforcer.sh

• Replaced broken macOS BSD sed with python3 shlex for path extraction (\b and \s silently fail on BSD sed)
• Changed from hard deny to rename-to-"(Marked for Deletion)" + open Finder — lets the user review and manually delete if intended
• Multi-target support — processes ALL targets in a command, not just the first
• Handles: quoted paths, spaces in filenames, flags, chained commands (&&, ;, |)

Commit 2: Context Watch (CRITICAL)

File: walnut-context-watch.sh

• New primary job: context % re-injection at 20/40/60/80% thresholds
  • Reads context % from .walnut/.context_pct (written by statusline on every render)
  • Fires highest unfired threshold, marks all lower ones (prevents double-firing)
  • ≤40%: condensed refresh (core behaviours only)
  • 60%+: full refresh (re-reads .walnut/key.md + .walnut/_index.yaml)
• Active squirrel stash cross-pollination — shows other sessions' unsaved stash items
  • Filters by: different session, ended: null, saves: 0 (genuinely unsaved)
• Self-save false alert fix: checks both full UUID and 8-char prefix against now.md squirrel field

Commit 3: Session New — Statusline Injection (HIGH)

File: walnut-session-new.sh

• Injects statusLine into .claude/settings.json with absolute path
• Self-heal: corrects stale relative paths on every session start
• Covers: fresh install (no settings.json), missing statusLine key, wrong path, malformed JSON

Commit 4: Session Resume + Compact — Stash Gate (HIGH)

Files: walnut-session-resume.sh, walnut-session-compact.sh

• Added saves: 0 gate on stash extraction — entries with saves > 0 have already routed their stash
• Prevents false "previous session had stash" messages on resume/compact
• Resume also gets the same statusline self-heal block as session-new

Commit 5: Statusline (HIGH)

File: walnut-statusline.sh

• Null cost crash guard: d.get('cost') or {} instead of d.get('cost', {}) — handles JSON null
• Writes context % to .walnut/.context_pct for context-watch threshold injection

Commit 6: Squirrels Rule (HIGH)

File: rules/squirrels.md

• Instinct rename plugin: contextsystem → alive-context #10: Load on First Walnut Mention — auto-invoke walnut:load when a walnut is mentioned by name (not just explicit "load X")
• Instinct revert plugin folder to alive/ — name must match folder #11: Trust the Context Window — never suggest ending a session based on context pressure. Compaction is automatic and handled by the threshold injection system.
• Made model-agnostic — removed "You have up to 1M tokens" claim. The system is portable across models.
• Save guard: removed "context is compacting" as a save trigger (now handled by threshold injection)
• Unsigned entry recovery: requires saves: 0 to match the hook implementations

Commit 7: World Skill + Post-Write Hook + Create Skill (HIGH + MEDIUM)

Files: world/SKILL.md, walnut-post-write.sh, create/SKILL.md

• World skill reads <WORLD_INDEX> from session context first (zero file reads) — fallback chain: injected index → .walnut/_index.yaml → generate-index.py → manual scan
• Post-write hook: detects _core/now.md writes (only written by save), regenerates world index in background with 5-minute debounce
• Create skill: Step 10 — update .walnut/key.md Connections when creating a new walnut

Commit 8: Skill Descriptions + CLAUDE.md (MEDIUM + LOW)

Files: load/SKILL.md, history/SKILL.md, CLAUDE.md, hooks.json

• Load skill: broadened description to match natural walnut mentions ("what's happening with berties")
• History skill: added "revive" to description for heavy revive routing
• CLAUDE.md: added /walnut:capsule to skill list (Twelve → Thirteen Skills), fixed numbering (9 → 8)
• hooks.json: description count 13 → 14

Commit 9: Review fixes (LOW)

Files: walnut-post-write.sh, world/setup.md

• Post-write hook: cross-platform stat guard (GNU/BSD sniff) matching context-watch pattern — prevents debounce failure on Linux
• Setup.md: "No ALIVE folders exist" → "No .walnut/ folder exists" to match runtime behaviour

Review approach

The capsule at 04_Ventures/alive-os/_core/_capsules/branch-port-review/companion.md has full review instructions, but the quick version:

cd ~/Desktop/alive-plugin

# See just the port changes (beyond the rename sweep)
git diff will/rename-sweep-clean...will/port-unmerged-fixes

# Commit log for port branch
git log --oneline will/port-unmerged-fixes --not will/rename-sweep-clean

Verification

• TypeScript build: exit 0
• deploy.sh dry-run: exit 0
• 13/13 hook scripts present
• 14/14 skills with valid SKILL.md
• No stale plugins/alive path references
• No 1M token model-specific claims in rules/skills
• saves:0 gate consistent across resume, compact, and context-watch
• Cross-platform stat guard consistent across context-watch and post-write

Known gap (pre-existing, not introduced by this PR)

walnut-session-resume.sh doesn't inject the world key or <WORLD_INDEX> — session-new does. This means the world skill's "read injected index first" strategy falls through to file reads on resumed sessions. Not blocking for this PR but worth addressing separately.

Test plan

• Deploy to local cache + marketplace via ./deploy.sh
• Fresh session: verify statusline injection creates/updates settings.json
• Resume session: verify stash gate — saved sessions don't show stale stash
• Archive enforcer: try rm on a World file — should rename to "(Marked for Deletion)" and open Finder
• Context watch: let context grow past 20% — verify threshold injection fires
• World skill: verify it reads <WORLD_INDEX> from context (no file reads on first call)

🐿️ Generated with Claude Code