Skip to content

v4.7.0 — Installer + hooks robustness batch

Choose a tag to compare

@alexherrero alexherrero released this 29 May 18:09
· 265 commits to main since this release

MINOR. Bundles the eight installer/hooks-hardening commits accumulated since v4.6.1, surfaced and closed during a crickets dogfood /doctor audit. The marquee change is orphan-symlink reaping on user-scope source-mode installs (a feat:, hence the minor bump); the rest are robustness fixes — cross-install-scope memory-skill path resolution (the V4.7 silent-broken memory-recall shape), Windows path-normalization for the reaper, user-scope telemetry.sh seeding, and a fix so the installer stops symlinking loose canonical specs under harness/skills/ as inert skills. Ships alongside the companion crickets v2.1.2.

Added

  • Orphan-symlink reaping on user-scope source-mode install (8c5af42) — install.sh reaps dangling symlinks under <prefix>/{agents,commands,skills,hooks,scripts}/ pointing into a source clone whose target was deleted. Narrow safety rules: symlinks only, into known clones only, only when the target is absent.

Changed

  • Installer stops symlinking loose .md specs under harness/skills/ (3f0f56c) — loose <name>.md siblings (doctor.md, migrate-to-diataxis.md) were symlinked as inert "single-file skills"; Claude Code loads skills as <name>/SKILL.md, so they only littered installs with duplicate spec symlinks. Maps dir bundles only now.
  • memory-recall hook resolves recall.py across install scopes (a79f9f6) — pre-fix it hardcoded a project-scope path and assumed MEMORY_VAULT_PATH in the hook env; on user-scope installs the hook exited 0 emitting nothing despite always-load entries.
  • _reap_orphan_symlinks path normalization for Windows (b2a922d) — naive str.startswith silently no-op'd on Windows (extended-path prefix asymmetry); added _normalize_path_str / _path_under.
  • telemetry.sh seeded at user scope (f8a356d) — install.sh seeds <prefix>/scripts/telemetry.sh; stale doctor Task-9 stub dropped.

Internal

  • Regression + cross-platform tests (73ae161, 7023340, 3f0f56c): neutral Windows path fixtures, a "tests-are-sacred" rule-5 clarification, and HarnessSkillsMappingTests.
  • .checksums.txt regenerated (b086207) — lib-parity sync to crickets.

Cross-references

  • crickets v2.1.2 — companion release (gitignores .harness/).
  • agentm v4.6.1 — prior release; v4.7.0 continues its user-scope-install hardening.