v1.3.4: Tab Fixed, Popup Pending

Release Notes: v1.3.4 (Hotfix)

Date: 2026-11-06 | Previous: v1.3.3 | Commits: 4 | Tests: 687

Tab now works — permanently

What was broken (a 3-iteration saga)

• v1.3.2: Tab could hang indefinitely on commands like sudo mkinitcpio -P. Ctrl+C to escape left a $(starship prompt ...) fragment in the buffer.
• v1.3.3: attempted async fix broke the popup entirely (TUI needs TTY, got pipe).
• v1.3.4 (this release): confirmed root cause — the ghost-popup binary does not respond to Ctrl+C. It hangs until killed externally. Any shell-side fix fails.

Pragmatic resolution

• Ghost popup disabled by default via _GHOST_POPUP_ENABLED=0.
• Tab uses fzf-tab completion — reliable, fast, never hangs.
• No more $(starship prompt ...) fragments — starship is pre-rendered once per prompt.
• No subprocess spawn on Tab — <1ms response.

What still works

• 54% faster boot (defer micro-decomposition, v1.3.3)
• fzf-tab completion on Tab
• expand-or-complete as final fallback
• All 687 tests passing
• Full doctor health (33/33)

What's temporarily off

• Ghost popup on Tab. Requires binary fix (SPEC-026 M04a). Will return.
• To test (WILL hang): export _GHOST_POPUP_ENABLED=1

Upgrade

ziro update && exec zsh

Users on v1.3.3: update immediately — popup was completely broken there.
Users on v1.3.2 or earlier: update straight to v1.3.4. Skip v1.3.3.

Rollback

v1.3.4 itself is the pragmatic rollback target (Tab works, popup pending).
Older versions had either hang (v1.3.2) or dead popup (v1.3.3).

v1.3.3: Defer Performance + Tab Stability

Release Notes: v1.3.3

Date: 2026-11-06 | Previous: v1.3.2 | Commits: 9 | Tests: 671 → 683

Highlights

Shell opens 54% faster

• Interactive prompt: 31.4 ms → 14.4 ms
• Pure boot: 22.1 ms → 10.3 ms
• What changed: the defer engine (1,050 lines inline) became a 17-line queue shim + 5 lazy modules. DAG, timeout, state, telemetry — each wakes up only when needed.
• You feel it every time you open a terminal.

Tab no longer freezes on Ctrl+C

• Bug: pressing Tab on commands like sudo mkinitcpio -P could hang the shell indefinitely. Ctrl+C to escape would leave a $(starship prompt ...) fragment scattered across the buffer.
• Fix: two root causes eliminated.
  • Starship now renders once per prompt (in precmd), not on every keystroke via $().
  • Ghost popup spawns asynchronously via ZLE fd handler — shell returns immediately, no blocking.
• Your feature stays: ghost popup still opens as primary on Tab. fzf-tab still works as fallback.
• Won't regress: 9 new automated tests (5 static + 4 pty-based interactive) reproduce the exact bug and must pass forever.

SPEC-027: plugin development contract

• Full contract for plugin authors: capability decomposition, 7 load strategies (eager, deferred, on-demand, service, etc.), shim/service rules, anti-patterns, 5 mandatory tests.
• docs/PLUGIN-DEV.md (402 lines) — user-facing guide, no internal jargon.

Commits

#	Commit	Purpose
1	248425d	Generator on-demand + bench + tty fixes
2	c84c421	SPEC-027 plugin dev contract + user guide
3	3039602	Extract defer queue shim from boot
4	157c89b	Split defer loader into lazy modules
5	53333ad	Wire lazy modules into build + doctor
6	918cac8	Verify boot performance improvement
7	3d4dbfb	ADL-044 record
8	d99f491	Tab-hang permanent fix via zle -F async
9	(this release)	Version bump to v1.3.3

Breaking Changes

None. Config, plugins, and workflow unchanged.

Upgrade

ziro update && exec zsh

Rollback

git reset --hard v1.3.2

v1.3.2

Full Changelog: v1.3.1...v1.3.2

v1.3.1

Release Notes: v1.3.1

Date: 2026-11-03 | Previous: v1.3.0 | Commits: 1 | Tests: 670 → 670

Highlights

Complete Release History Manifests

• Added comprehensive, end-user-oriented release manifests covering every version from v1.2.1 through v1.3.1.
• Each manifest explains what changed, why it matters, breaking changes, and upgrade/rollback instructions without internal technical jargon.

Comprehensive CHANGELOG & Architecture Journey

• Rewrote the top-level changelog to provide a complete historical overview of feature additions, security enhancements, and performance optimizations.
• Added a full narrative documentation file (docs/JOURNEY.md) tracing the evolutionary journey of the shell runtime from v1.2.0 to v1.3.1.

Zero Code Changes

• Pure documentation and release governance release. All 670 test cases and runtime behaviors remain completely unchanged.

Commits

#	Commit	Purpose
1	(this release)	Comprehensive release manifests, changelog overhaul, and journey documentation

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git reset --hard v1.3.0

Notes

• This release introduces automated release manifest requirements into the project engineering workflow to ensure every future release is accompanied by clean, user-facing documentation.

v1.3.0

Release Notes: v1.3.0

Date: 2026-11-03 | Previous: v1.2.10 | Commits: 1 | Tests: 623 → 670

Highlights

Ghost v2.0.1 Integration

• Fully integrated Ghost v2.0.1 with automated multi-architecture companion binary provisioning (linux-x86_64, linux-aarch64, darwin-x86_64, darwin-arm64) verified by SHA256 checksums.
• Modularized autosuggestion into a deferred inline suggestion line and an on-demand Rust Focus Mode popup triggered via the Tab key.
• Diagnostics (ziro doctor) directly observe companion binary version and health status.

AI-Safe System Management Layer (ziro mcp)

• Implemented a standard JSON-RPC 2.0 Model Context Protocol (MCP) server providing 16 tools across 5 domain areas:
  1. System inventory (ziro.system.*): OS, packages, developer binaries, and secret-redacted environment variables.
  2. Directory awareness (ziro.dir.*): Git repository state, file type distributions, and cleanup safety evaluation.
  3. Command safety (ziro.cmd.*): Static danger scoring (0-10) and two-step deliberative execution.
  4. Ghost companion proxy (ghost.*): Suggestion queries, health diagnostics, and runtime telemetry.
  5. Native shell tools (ziro.*): Analyze active plugins, run diagnostics, and inspect metrics.
• Default Safe-Mode strictly prevents mutating command execution without an explicit --allow-execute flag.
• Two-step confirmation enforces a 60-second time-limited, single-use token before any shell command can execute.
• Every execution attempt is immutably logged to a private audit trail file (~/.cache/ziro/mcp/audit.jsonl, mode 0600).

Commits

#	Commit	Purpose
1	ed9dc03 release(v1.3.0): ghost v2.0.1 integration + AI-safe MCP layer	Integrate Ghost v2.0.1 and deliver AI-safe MCP system management

Breaking Changes

• ziro ghost preview is deprecated with a warning redirecting to ziro update and will be removed in version 1.4.0.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.3.0

v1.2.10

Release Notes: v1.2.10

Date: 2026-11-03 | Previous: v1.2.9 | Commits: 1 | Tests: 618 → 623

Highlights

External Tools Observability

• Added real-time metrics and health aggregation for external shell companion tools.
• New ziro stats command displays aggregated event counts, latency, and error metrics across installed tools.
• New ziro health command inspects live diagnostic readiness and self-test reports.
• Extended ziro doctor with an automated external tools health audit check.

Standardized Telemetry Protocol

• Any current or future tool that outputs NDJSON metrics to its local cache path is automatically discovered and monitored without code changes.

Commits

#	Commit	Purpose
1	c69ec95 release(v1.2.10): external tools observability (read-only aggregator)	Introduce ziro stats, ziro health, and automated doctor checks

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.2.10

v1.2.9

Release Notes: v1.2.9

Date: 2026-11-02 | Previous: v1.2.8 | Commits: 2 | Tests: 600 → 618

Highlights

Remote Clipboard over SSH (OSC 52)

• Added native OSC 52 terminal clipboard escape sequences.
• Copy text on remote servers inside SSH sessions (echo "hello" | clipcopy) and paste immediately into your local computer's clipboard without requiring X11 forwarding.
• 4-tier fallback chain: Native desktop GUI → macOS pbcopy → OSC 52 escape sequences → local secure file buffer.

Headless Server Safety

• System file openers gracefully adapt on headless servers: text files view inside your default terminal pager, while binaries and web URLs return clean error notices rather than hanging headless sessions.
• Added terminal capability detection in ziro doctor with per-terminal configuration guidance.

Commits

#	Commit	Purpose
1	82e207e release(v1.2.9): headless refinements + OSC 52 clipboard	Introduce OSC 52 remote clipboard and headless file opener fallbacks
2	6d5856f fix(tests): cross-platform test guards for macOS clipboard and term env	Stabilize cross-platform clipboard assertions in test suites

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.2.9

v1.2.8

Release Notes: v1.2.8

Date: 2026-11-02 | Previous: v1.2.7 | Commits: 2 | Tests: 585 → 600

Highlights

Root Shell Hardening

• Implemented four layers of security protection specifically when operating inside root shells (UID 0):
  1. Disabled arbitrary execution capabilities in fuzzy finder widgets.
  2. Isolated clipboard buffer files to user-restricted runtime directories instead of public temporary paths.
  3. Disabled automatic SSH agent forwarding by default in administrative sessions.
  4. Provided a locked-down prompt profile free from unvetted custom command modules.
• Standard non-root user sessions remain completely unaffected.

Commits

#	Commit	Purpose
1	aa4eb52 release(v1.2.8): root profile hardening M1-M4	Implement 4-tier security defense for root terminal sessions
2	45ddf97 fix(tests): isolate clipboard fallback and hermetic test runner paths	Ensure hermetic test isolation for clipboard security suites

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.2.8

v1.2.7

Release Notes: v1.2.7

Date: 2026-11-02 | Previous: v1.2.6 | Commits: 6 | Tests: 570 → 585

Highlights

Reliable Multi-Platform Continuous Integration

• Re-architected continuous integration into clean unit and integration test stages.
• Guarantees full test coverage across Linux and macOS environments on Python versions 3.11, 3.12, and 3.13.
• Stabilized tool proxy fallbacks when system utilities such as directory jumping or clipboard handlers are missing.

Environment Hermeticity

• Isolated user configuration directories during automated test runs to prevent test flakes and environment pollution.

Commits

#	Commit	Purpose
1	eae9af7 ci: split tests into unit/integration, add CI env setup	Restructure test workflow into isolated unit and integration jobs
2	e3a1d2f ci: install zsh/cyclopts in unit matrix and stabilize integration job environment	Ensure runtime dependencies are provisioned across runners
3	e006494 ci: add runtime dependencies and clean env vars in runner	Clean runner environment and provision tool dependencies
4	c16c2ca ci: fix runner environment alignment, XDG env cleanup, and path hardcoding	Normalize path resolutions across operating systems
5	1b1c225 ci: ensure zoxide proxy fallback guarantees z function definition	Stabilize directory navigation function stub fallbacks
6	25a226e release: v1.2.7	Tag comprehensive CI reliability release

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.2.7

v1.2.6

Release Notes: v1.2.6

Date: 2026-11-01 | Previous: v1.2.5 | Commits: 2 | Tests: 555 → 570

Highlights

Zero Input Lag Autosuggestions

• Relocated history cache filtering from the interactive typing critical path to background command execution hooks.
• Reduces typing latency down to under 2ms, providing a completely fluid, lag-free terminal typing experience.

2x Faster Test Execution

• Optimized test runner environment setup, cutting test suite runtime from over 190 seconds down to under 99 seconds.
• Enables faster feedback during development and packaging.

Commits

#	Commit	Purpose
1	686221d perf(ghost): zero-lag input architecture with per-command execution filter	Eliminate keystroke lag by moving cache filtering to precmd
2	1adee83 release(v1.2.6): zero-lag history + test suite optimization + CI rewrite	Deliver optimized test execution and multi-platform CI baseline

Breaking Changes

None.

Upgrade

ziro update && exec zsh

Rollback

git revert v1.2.6