claude-multi 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,111 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.0] - 2026-05-30
+
+### Changed
+- **Removed pinned Claude Code binary**: claude-multi no longer installs its own copy of `@anthropic-ai/claude-code` into `~/.claude-multi/bin/`. All instance wrappers now resolve to the user's globally installed `claude` binary via `which claude`/`where claude`. This means instances auto-update together with the global `claude` binary.
+- `getClaudePath()` in `wrapper.ts` simplified to two priorities: `CLAUDE_MULTI_CLAUDE_PATH` env override, then global PATH. The pinned binary check was removed.
+- `doctor fix` no longer installs a pinned Claude binary. It verifies `claude` is available in PATH and regenerates stale wrappers.
+- Health check for wrapper binary paths now compares against the resolved global `claude` path instead of `PINNED_CLAUDE_BIN`. Also gained a Windows `.cmd` regex pattern.
+- `fixWrapperVersions()` in `health.ts` rewritten to use `tryGetClaudePath()` instead of `PINNED_CLAUDE_BIN`.
+- Instance migration (v0.6.2) updated to use `tryGetClaudePath()` instead of the deleted `tryGetGlobalClaudePath()`. Added `console.warn` when claude binary is not found during wrapper regeneration.
+- `TUNABLE_ENV_VARS` local duplicate removed from `migration.ts` v0.6.3. Now imports the canonical set from `constants/env.ts` (was missing `CLAUDE_CODE_AUTO_COMPACT_WINDOW` and `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`).
+- PATH membership check in the `add` command uses `path.dirname()` and `path.delimiter` instead of Unix-specific `lastIndexOf('/')` and `split(':')`.
+- `where claude` output split fixed to handle Windows `\r\n` line endings.
+- Version warning banner and `isThirdPartyApiBroken` check removed from the TUI (the affected versions are ancient).
+
+### Removed
+- `PINNED_BIN_DIR` and `PINNED_CLAUDE_BIN` constants from `paths.ts`.
+- `COMPATIBLE_CLAUDE_VERSION`, `isThirdPartyApiBroken()`, `getPinnedBinaryVersion()`, `installPinnedClaude()` from `version.ts`.
+- `getGlobalClaudePath()` and `tryGetGlobalClaudePath()` from `wrapper.ts` (became identical to `getClaudePath()` and `tryGetClaudePath()` after pinning removal).
+- `ccVersion` state, `installFailed` doctor result, and version warning banner from `App.tsx`.
+
+### Fixed
+- v0.6.3 migration `TUNABLE_ENV_VARS` local duplicate was missing two entries (`CLAUDE_CODE_AUTO_COMPACT_WINDOW`, `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`), causing auto-compaction settings to be overwritten with template defaults during migration.
+- Health check and `doctor fix` were fighting the v0.6.2 migration: migration set wrappers to global path, doctor overwrote them back to pinned binary. Both now use the same global path resolution.
+- `where claude` output on Windows was split on `\n` only, missing `\r\n` carriage returns.
+- `add` command PATH check was Unix-only (`lastIndexOf('/')` and `split(':')`).
+- Health check had no regex for Windows `.cmd` wrapper format.
+
+### Blog
+- Blog post: [v0.7.0: No More Pinned Claude Binary](https://claude-multi.hmziq.xyz/blog/v070-no-more-pinned-claude/)
+
+## [0.6.5] - 2026-05-30
+
+### Added
+- **Instance details actions**: The instance details screen now has action buttons. Press Enter on any instance to access: Update settings template, Update alias wrapper, and Override alias to standard. Each action shows a live mismatch indicator (✓ up to date, ⚠ mismatch detected, ✗ wrapper missing).
+- `syncProviderTemplateForInstance()` in `config.ts` — on-demand provider template sync for a single instance. Re-applies the latest template env vars while preserving API keys and user-customized tunable vars.
+- `detectTemplateMismatch()` and `detectWrapperMismatch()` in `instance-diagnostics.ts` — compare an instance's current settings/wrapper against the expected provider template.
+- `TUNABLE_ENV_VARS` shared constant in `constants/env.ts` — single source of truth for env vars that are preserved during template sync and excluded from staleness checks.
+
+### Changed
+- **Health screen rewrite**: Replaced static `IssueCard` list with a Select-based issue picker. Issues can now be selected, viewed in detail, and dismissed. Press Enter to view an issue, `d` to dismiss, `D` to dismiss all.
+- **Post-migration stale state fixed**: After running `doctor fix`, the health check warning no longer persists. The config is now reloaded before health checks re-run.
+- **Migration lock staleness**: Added a 30-minute staleness check to the migration lock file. Prevents stale locks from blocking migrations after crashes or PID reuse.
+- **Atomic health status writes**: `saveHealthStatus()` now uses write-to-temp + rename to prevent file corruption on crash or concurrent access.
+- **Doctor fix guard**: `handleDoctorFix` is now guarded against double-invocation from rapid keypresses.
+- Removed pre-existing TypeScript type errors in `migration.ts` v0.6.3 migration body (narrow `Record` type inference on `newEnv`).
+
+### Blog
+- Blog post: [v0.6.5: Action Buttons, Health Screen Fix, Hardened Migrations](https://claude-multi.hmziq.xyz/blog/v065-instance-actions-health-fix/)
+
+## [0.6.4] - 2026-05-29
+
+### Added
+- Instance migration (0.6.3) syncs provider template env vars to existing instances. Detects the provider from `ANTHROPIC_BASE_URL` in `settings.json` and re-applies the latest template (model names, thinking tokens, output limits). Preserves API keys and user-added env vars.
+- `detectProvider()` and `getProviderByBaseUrl()` in `templates.ts` match a base URL to a provider template name.
+- `providerTemplate` field on the `Instance` type. New instances store it; migration backfills it for existing instances.
+
+### Blog
+- Blog post: [v0.6.4: Existing Instances Now Auto-Sync Provider Template Updates](https://claude-multi.hmziq.xyz/blog/v064-provider-template-sync/)
+
+## [0.6.3] - 2026-05-29
+
+### Changed
+- Instance migrations regenerate wrappers pointing to the globally installed `claude` binary (via `which claude`), not the pinned binary at `~/.claude-multi/bin`. Wrappers that already match the expected content are left untouched.
+- `runMigration` and `createBackup` are synchronous now (had no `await` expressions).
+- MiMo (pay-per-token and Token Plan) models bumped to `mimo-v2.5-pro[1m]` and `mimo-v2.5[1m]` (1M context window variants).
+- Kimi opus model changed from `kimi-k2.6` to `kimi-k2.5`.
+- Provider templates now include explicit thinking and output token limits:
+  - MiniMax: 32K thinking, 64K output
+  - DeepSeek: 32K thinking, 128K output
+  - MiMo (both plans): 128K output
+  - Kimi: 16K thinking, 64K output
+  - Qwen and Qwen Coding Plan: 16K thinking, 64K output
+
+### Added
+- `getGlobalClaudePath()` and `tryGetGlobalClaudePath()` in `wrapper.ts` resolve the claude binary from the env override or PATH, skipping the pinned binary.
+- Instance migration tests: fast-path skip on current-version instances, mixed instances (some current, some old), `.claude.json` updates when the wrapper file is missing, and a verification that regenerated wrappers contain the global claude path.
+
+### Fixed
+- Health test compared `fixWrapperVersions` output against `generateWrapperScript()` (resolves via env override) instead of `buildWrapperScript(inst, PINNED_CLAUDE_BIN)` (what the function actually uses). Would break if `CLAUDE_MULTI_CLAUDE_PATH` was set.
+
+### Blog
+- Blog post: [v0.6.3: Drop the Pinned Binary, Update Every Provider Template](https://claude-multi.hmziq.xyz/blog/v063-migration-and-provider-updates/)
+
+### Added
+- Instances track the claude-multi version they were created with (`createdWithVersion`). New instances get the current version. Instances created before this field existed get `0.5` and show "before version tracking" in the UI.
+- `doctor` and the TUI health screen report when instance migrations are pending or when an instance is running an older version.
+- `doctor fix` shows which instances need migration and asks for confirmation before running.
+- Version column added to `list`, `info`, and the Ink TUI instance cards and detail screens.
+
+### Changed
+- `instanceMigrationVersion` in config now stores the actual package version rather than a separate numbering scheme.
+- The legacy sentinel (`"0.5"`) is defined once as `LEGACY_INSTANCE_VERSION` and imported everywhere, instead of being hardcoded in multiple files.
+- Wrapper script template exists in a single place (`buildWrapperScript` in `wrapper.ts`). Migration and health check both delegate to it instead of duplicating the template string.
+- Instance migration only rewrites wrappers when the file content actually differs (version check + content diff), instead of unconditionally regenerating every wrapper.
+- `fixWrapperVersions` uses the canonical template targeting the pinned binary explicitly, with a content-diff check to avoid unnecessary writes.
+
+### Fixed
+- Removed broken `compareVersions` references from `version.test.ts`.
+- `resolveClaudePath()` in `migration.ts` used `await` in a non-async function (TypeScript error). Removed — replaced by `generateWrapperScriptSafe` from `wrapper.ts`.
+- Unused imports (`COMPATIBLE_CLAUDE_VERSION`, `installPinnedClaude`, `getPinnedBinaryVersion`, `isThirdPartyApiBroken`, `PINNED_CLAUDE_BIN`) removed from `migration.ts`.
+- `config.ts` `loadConfig` backfill loop now handles `noUncheckedIndexedAccess` correctly (pre-existing TypeScript error).
+- `createBackup` changed from async to sync (had no `await` expressions — pre-existing lint warning).
+- Array `.sort()` / `.reverse()` calls in `migration.ts` and `config.ts` changed to `.toSorted()` / `.toReversed()` (pre-existing lint warnings).
+- Duplicate `existsSync` import in `test/wrapper.test.ts` merged into single import.
+
 ## [0.6.1] - 2026-05-29
 
 ### Changed
@@ -326,6 +431,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Support for custom config and binary paths
 - Command-line interface built with Commander.js
 
+[0.6.4]: https://github.com/hmziqrs/claude-multi/compare/v0.6.3...v0.6.4
+[0.6.3]: https://github.com/hmziqrs/claude-multi/compare/v0.6.2...v0.6.3
 [0.5.5]: https://github.com/hmziqrs/claude-multi/compare/v0.5.1...v0.5.5
 [0.5.1]: https://github.com/hmziqrs/claude-multi/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/hmziqrs/claude-multi/compare/v0.4.4...v0.5.0