Skip to content

📋 ZSHAND Changelog

All notable changes to the ZSHAND framework are documented here. Format follows Keep a Changelog.

[2026-02-06] — Documentation Suite

Added

  • docs/ARCHITECTURE.md — Framework structure and boot sequence
  • docs/CONTRIBUTING.md — Contribution workflow and quality gate
  • docs/TESTING.md — Test writing and running guide
  • docs/PERFORMANCE.md — Profiling, benchmarking, and optimization
  • docs/STYLE_GUIDE.md — Code style conventions
  • docs/USER_CONFIG.md — End-user configuration guide
  • docs/WIDGETS.md — Widget development guide
  • docs/INSTALLERS.md — Installer development guide
  • docs/HOOKS.md — Hook system guide
  • docs/FUNCTIONS.md — User-facing functions reference
  • docs/CORE.md — Core modules reference
  • docs/SHARED_FUNCTIONS.md — Shared utilities reference
  • docs/STARTUP.md — Startup scripts reference
  • docs/PRIVATE_FUNCTIONS.md — Internal functions reference
  • docs/CHANGELOG.md — Consolidated changelog (this file)
  • docs/README.md — Documentation index

Changed

  • docs/TROUBLESHOOTING.md — Enhanced with MkDocs frontmatter, emojis, and new sections (safe mode, slow startup, missing deps, telemetry)
  • docs/AUTO_FULL_MODE.md — Merged from 3 files (AUTO_FULL_MODE.md, AUTO_FULL_IMPLEMENTATION.md, AUTO_FULL_OPTIMIZATION.md) into one user-facing doc

Removed

  • docs/AUTO_FULL_IMPLEMENTATION.md — Merged into AUTO_FULL_MODE.md
  • docs/AUTO_FULL_OPTIMIZATION.md — Merged into AUTO_FULL_MODE.md

Moved

  • docs/memory.md → docs/archive/memory.md (personal system log, not framework docs)

[2026-02-03] — Auto-Full Bundle Mode

Added

  • Auto-Full Mode (ZSHAND_AUTO_FULL=1) — Automatically compiles and loads full bundle on first run. 700ms → 40ms startup (94% reduction). Set in ~/.zshenv.
  • Fast Path Optimization — Skips build function loading when bundle exists. Additional 10–20% speedup on cached runs.
  • Automatic zshrc.zwc Compilation — Entry point compiled to bytecode during zr/zprime. ~2–5ms saved per startup.
  • zprime --both — Compile framework + full bundle in one command.
  • zrecompile — Selective recompilation (user/framework/both).
  • zfresh — Fresh rebuild with cache cleanup + restart.
  • 6 new auto-full tests — Function existence, logic, mode interactions, docs.

Fixed

  • P10k theme loading — P10k loads after bundle (not inside it), fixing theme breakage in bundle mode.
  • zshrc.zwc staleness — zfresh now deletes both bundle cache and zshrc.zwc.

Testing

  • Build tests: 43/43 passing (100%)

[2026-02-02] — Full Bundle Override System

Added

  • Full bundle compilation (compile_full_bundle.zsh) — Single bundle containing framework + user config with override semantics.
  • Override system — User files with same basename replace framework files.
  • zfull / zmono — Manual bundle compilation commands.
  • Early environment loading — env.zsh and secrets.zsh loaded before bundle.
  • Path injection — Compile-time PATH injection from path.txt.

[2026-01-29] — Profile Bundle Report

Added

  • Profile bundle report (build/profile_bundle_report.zsh) — Comprehensive startup performance dashboard with grading, bar charts, and bottleneck detection.
  • Profile exceptions (config/profile-exceptions.conf) — Suppress warnings for inherently slow files.
  • zprofile — Profile current shell session.

[2026-01-25] — Core Framework

Added

  • Initial framework release with modular architecture
  • Core modules (02–90) with numeric load ordering
  • Shared functions and startup scripts
  • Widget system with 20+ ZLE widgets
  • Hook system with critical/lazy classification
  • Build system with per-directory .zwc compilation
  • Test infrastructure with per-suite runners
  • zprime / zr rebuild system
  • zcheck integrity auditing
  • Telemetry (zrun, zfail, zsearch, zpulse)
  • Safe mode with auto-detection
  • XDG Base Directory compliance
  • User override system (rc.d/, init.d/, post.d/)