imap-agent-cli 0.2.0

Existing managed imap skills now synchronize automatically to the running CLI's newer version. Synchronization only checks ~/.agents/skills/imap/SKILL.md. It does not install missing skills, query package indexes, refresh uv, or update the CLI.

Changes

• Store ownership, the exact CLI version, and a normalized SHA-256 content hash in SKILL.md YAML metadata.
• Preserve modified or unverifiable skills with valid versions. Never overwrite unmanaged skills or downgrade newer versions.
• Add read-only skill status with JSON and plain output.
• Add uvx imap-agent-cli skill install --force to replace altered managed content explicitly.
• Preserve the install-skill and remove-skill aliases, custom-directory support, and removal-time --force.
• Replace skill files atomically and keep unrelated files during removal.

Compatibility

Local source and editable builds skip automatic synchronization. Custom skill locations require explicit updates. Legacy managed skills migrate once as version 0. Missing or malformed managed versions receive a fresh replacement without a hash check. The installed skill continues to instruct agents to use uvx.

Updates affect future skill loading. Running agent sessions may retain instructions they have already loaded.

Validation

Validated with the full unit suite, an isolated installed-wheel smoke test covering wheel, local source, editable, and uv tool execution, and source and wheel package builds. Live mailbox tests were not run.