Release 1.0.0

[v1.0.0] - 2026-08-24

🚀 Official 1.0.0 Milestone Release

• Production-Ready macOS App Cloning:
  • ATBClone reaches version 1.0.0, establishing a complete, mature, and zero-compromise application cloning ecosystem for macOS (Apple Silicon & Intel).
  • Offers seamless dual-engine architectures: zero-disk-overhead Soft Clones (CLI-wrapper & bundle virtualization) and completely isolated Hard Clones (Mach-O binary manipulation, deep signing, container virtualization).

🧬 Deep CEF (Chromium Embedded Framework) Patching & WeCom Support

• Hybrid Framework Multi-Instance Engine:
  • Implemented scoped Chromium Embedded Framework (CEF) binary patching specifically designed for complex enterprise hybrid applications such as WeCom (企业微信).
  • Resolved GpuDataManager FATAL crashes across helper subprocesses and sanitized nested helper bundle identifiers (.helper.atbclone.X).
  • Integrated symlink whitelists and disabled internal sandbox collisions to guarantee reliable multi-instance execution.

🛡️ Full-Bundle Recursive Re-Signing & Entitlements Sanitization

• Nested Binary & Framework Security:
  • HardCloneEngine now performs thorough recursive re-signing across all nested binaries, embedded Frameworks, Helper apps, XPC services, and dynamic libraries (.dylib).
  • Preserves JIT and hardened runtime entitlements while generating clean temporary entitlements outside bundle structures to prevent code signature verification pollution.
• Framework ProcessSingleton Binary Patching:
  • Introduced patch_framework_singleton recipe field to dynamically patch framework-level process singleton locks directly in Mach-O binary structures without unstable dynamic library interposing.

📋 Enhanced Detail Views & Native Clipboard Integration

• Diagnostic Export:
  • Re-architected CloneDetailWindow using multiline Cocoa text views and direct NSPasteboard integration for selectable text and instantaneous markdown diagnostic summary exporting.

🧪 Comprehensive Quality Assurance

• Full Test Coverage:
  • Automated test suite expanded to 441 unit, engine, recipe, prober, and GUI integration tests with 100% pass rate.

Release 0.9.9

[v0.9.9] - 2026-08-24

📋 Selectable Text & "Copy All Details" in Clone Details Window

• Interactive Information Extraction:
  • Enabled Cocoa native text selectable mode across all labels in CloneDetailWindow so users can highlight and copy any individual path, bundle ID, or argument directly.
  • Added a dedicated "Copy All Details" button in the footer to copy a complete markdown-formatted diagnostic report of the clone to the clipboard with visual feedback.

🎨 macOS Native UI Design & Token Refinements

• Theme & Component Optimization:
  • Polished color palette tokens in Theme for light and dark modes (BG_APP, BG_CARD, BG_HOVER, BORDER, TEXT_PRIMARY, TEXT_MUTED, ACCENT).
  • Improved card containers, rounded borders, and consistent widget spacing across CloneListView, RecipeListView, ProbeView, DoctorView, SettingsView, and dialog windows.

📖 Comprehensive Multilingual User Manual (docs/guide/)

• Complete End-to-End User Documentation:
  • Published comprehensive user manuals in English (docs/guide/en/) and Simplified Chinese (docs/guide/zh-cn/).
  • Covers Chapter 1 (Basic Operations & Lifecycle), Chapter 2 (Advanced Custom Recipes), Chapter 3 (Under the Hood & Framework Architecture), and Chapter 4 (FAQ, Troubleshooting, & Diagnostics).

🧪 Test Suite & Quality Assurance

• Extended Test Coverage:
  • Automated test suite expanded to 431 tests with 100% pass rate.

Release 0.9.8

[v0.9.8] - 2026-08-24

🔒 Sandbox Entitlements Extraction & Hard Clone Stability

• Source App Entitlements Preservation:
  • Enhanced HardCloneEngine to extract and preserve original entitlements directly from source Mach-O binaries via codesign -d --entitlements :-.
  • Added robust validation to guard against generating empty or corrupt entitlements during ad-hoc and Developer ID re-signing.
• Built-in Recipes Sandbox Container Isolation:
  • Refined built-in recipe configurations by enforcing strip_sandbox: false across hard-clone applications (including WeChat, QQ, WeWork, WPS Office, LINE, Skype, and CapCut).
  • Ensures complete sandbox container isolation (~/Library/Containers/<new_bundle_id>) to prevent credential leakage and cross-instance interference.

📚 Documentation & Schema Modernization

• Multilingual Documentation Updates:
  • Synchronized English (README.md) and Simplified Chinese (README_zh.md) documentation with current schema standards, including app_type, strip_sandbox, runtime architecture classifications, and CLI/GUI workflows.

🧪 Test Suite & Quality Assurance

• Robust Verification:
  • Verified all 428 unit, core engine, and GUI integration tests pass with 100% success rate.

Release 0.9.7

[v0.9.7] - 2026-08-24

🔍 Intelligent Application Architecture Detection & Language Adaptation

• app_type Architecture Recognition:
  • Introduced app_type field (electron, chromium, qt, flutter, native_cocoa, java, unknown) to the Recipe model.
  • Automatically recognizes application runtime frameworks via AppProber.detect_app_type by inspecting bundle frameworks, dylibs, and JVM structures.
  • Standardized all 34 built-in recipes with explicit app_type and strip_sandbox configurations.
• Framework-Adaptive Language Injection:
  • Dynamically injects locale flags customized per runtime framework (--lang= for Chromium/Electron, -AppleLanguages for Native Cocoa, -user.language for Java).

🧬 Mach-O Binary Argument Probing & Validation

• Intelligent Data Directory Probing:
  • Implemented BinaryArgumentProber to scan Mach-O executable string tables, automatically extracting supported user data directory CLI flags (--user-data-dir, --profile-directory, --datadir, etc.) for unknown applications.
• Launch Argument Validation:
  • Added LaunchArgumentValidator to prune unsupported or conflicting CLI flags during clone creation, preventing application crashes.

📋 Clone Injected Parameters Inspection & Copy

• CloneInspector & Details View Enhancement:
  • Implemented CloneInspector to parse and extract runtime injected environment variables, proxy settings, language overrides, and launch flags from clone bundles.
  • Added an "Injected Parameters" card in CloneDetailWindow with a one-click copy button and visual feedback.

⚙️ Recipe Editor Window Advanced Customization

• GUI Recipe Editing (RecipeEditWindow):
  • Added advanced configuration fields including application framework type selection, launch arguments editor, proxy settings, environment variables, and symlink whitelists.

🧪 Test Suite Expansion

• Comprehensive Coverage:
  • Expanded automated test suite to 428 unit and GUI integration tests.

Release 0.9.6

[v0.9.6] - 2026-08-24

🖱️ Native Cocoa Table Header Sorting

• Interactive Column Sorting in Lists:
  • Implemented native Cocoa NSTableViewHeaderView click-to-sort patch supporting column sorting across CloneListView and RecipeListView.
  • Supports bidirectional sorting (ascending / descending) with visual sort indicators on table headers and toolbar sort controls synchronization.
  • Automatically preserves active item selection across sort operations.

📦 Multi-Selection & Batch Operations

• Batch Clones Management (CloneListView):
  • Added multi-row selection support (multiple_select=True) with dynamic toolbar button state management.
  • Supports batch clone updates and batch removals with purge data confirmation dialogs.
• Batch Recipe Deletion with Smart Protection (RecipeListView):
  • Multi-selection deletion for custom recipes.
  • Scenario-based confirmation dialogs: protects builtin read-only recipes, alerts users when mixing custom and builtin recipes, and accurately reports batch deletion progress.
  • Integrated busy state locking to prevent concurrent operations during batch executions.

🛠️ Xcode Command Line Tools Diagnostic & Doctor View Enhancement

• Startup Diagnostic Checks:
  • Added automated environment checks for Xcode Command Line Tools readiness (xcode-select -p, codesign, lipo, otool, install_name_tool).
  • Provides clear diagnostic guidance and installation commands in the Doctor View when tools are missing.

ℹ️ Standard macOS About Dialog Metadata

• Cocoa About Dialog Fix:
  • Properly mapped version numbers, app name, and copyright metadata in the standard macOS "About ATBClone" dialog.

🧪 Test Suite Expansion

• Comprehensive Coverage:
  • Expanded automated test suite to 369 unit and GUI integration tests.

Release 0.9.5

[v0.9.5] - 2026-08-23

📝 Auto-Wrapping WrappingLabel Component & Text Formatting

• Multiline Text Wrapping Support:
  • Implemented the WrappingLabel component to solve macOS Cocoa Toga single-line text constraint limitations.
  • Automatically calculates dynamic intrinsic height based on the container width (cellSizeForBounds_) while leaving width unconstrained, completely preventing long pathnames and text from expanding windows horizontally.
• Prober & Detail View Formatting:
  • Applied WrappingLabel across ProbeView (Prober analysis reports, compatibility evaluations, sandbox status), CloneDetailWindow (launch arguments, bundle id, data directories), and WizardWindow (strategy descriptions and advice).

🧪 Test Hermeticity & State Isolation

• Dynamic Configuration & Test Isolation:
  • Enhanced StateManager and RecipeLoader to dynamically evaluate configuration paths at runtime rather than module import time.
  • Ensured unit tests remain strictly hermetic and isolated from local user state and custom recipe files.
• Testing:
  • Expanded automated test suite to 347 unit and GUI integration tests.

Release 0.9.4

[v0.9.4] - 2026-08-23

📁 Visible Default Data Directory Migration (~/ATBClone)

• Intuitive User Data Management:
  • Migrated the default ATBClone root directory from hidden ~/.atbclone to user-accessible ~/ATBClone (including ~/ATBClone/Data/, ~/ATBClone/clones.yaml, and logs).
  • Makes managing, backing up, and inspecting clone storage and configurations straightforward via macOS Finder and Terminal.

🏷️ Exact Application Display Name Enforcement & Localization Override

• Consistent Bundle Naming:
  • Enhanced both SoftCloneEngine and HardCloneEngine to clean up localized strings (InfoPlist.strings) and remove LSHasLocalizedDisplayName within cloned app bundles.
  • Ensures Finder, Dock, Spotlight, and Activity Monitor strictly display the custom clone display name instead of falling back to system-localized default titles.

🔄 Instant LaunchServices Registration

• Automated Cache Refresh:
  • Automatically registers newly generated or updated clones with macOS LaunchServices (lsregister -f), immediately reflecting icon and metadata updates across Finder, Dock, and Spotlight without requiring system reboots.

📦 Test Suite & Documentation

• Updated References:
  • Reflected new ~/ATBClone default path across CLI documentation, GUI settings, and all 341 unit and integration tests.

Release 0.9.3

[v0.9.3] - 2026-08-21

🛡️ Enhanced App Inspection & Wizard Validation for iOS Wrapper Apps

• Interactive Wizard Pre-check & Error Dialog:
  • Upgraded AppInspector.inspect_app to detect iOS-on-Mac (Designed for iPad/iPhone) wrapper applications directly during file selection or drag-and-drop.
  • In the GUI Creation Wizard (WizardWindow), selecting an unsupported iOS wrapper application now immediately triggers a localized warning dialog and resets the input, preventing invalid workflows upfront.

🍏 Clean macOS Exit & Cocoa Memory Target Teardown

• Crash Prevention on Application Termination:
  • Enhanced TrayService.disable() and ATBCloneApp.exit_app() to safely unbind Cocoa status item targets and selectors, eliminating dangling Objective-C pointers during shutdown.
  • Implemented clean Cocoa event loop termination (NSApp.terminate_ / os._exit(0)), completely resolving crash-on-exit / segmentation fault issues when quitting via the Menu Bar tray or Cmd+Q.

📦 Test Suite Expansion

• Comprehensive Testing:
  • Expanded test coverage to 341 automated unit and GUI integration tests.

Release 0.9.2

[v0.9.2] - 2026-08-21

🍏 Dynamic macOS Dock Icon Hiding & System Tray Polishing

• Automatic Dock Icon Management:
  • Implemented dynamic macOS Dock icon visibility management via AppKit activation policies (NSApplicationActivationPolicy).
  • When minimizing or closing the window to the system tray (minimize_to_tray enabled), the Dock icon is automatically hidden from the macOS Dock (NSApplicationActivationPolicyAccessory).
  • When restoring the window from the menu bar tray, the Dock icon seamlessly reappears (NSApplicationActivationPolicyRegular) with instant focus.
• Dock Reopen Handler:
  • Added native AppDelegate patch for applicationShouldHandleReopen:hasVisibleWindows: to smoothly restore and focus the main window when clicking the application in macOS Finder or Dock.

📦 Asset Footprint Optimization & Testing

• Optimized Image Resources:
  • Compressed and optimized application icon assets (logo.icns and logo.png), reducing bundle overhead.
• Testing:

Release 0.9.1

[v0.9.1] - 2026-08-21

🛡️ iOS-on-Mac Wrapper Application Detection & Safe Rejection

• Graceful Unsupported Architecture Handling:
  • Enhanced AppProber, SoftCloneEngine, and HardCloneEngine to accurately identify iOS/iPadOS wrapper applications designed for Apple Silicon (apps containing Wrapper/ or UIDeviceFamily with LSRequiresIPhoneOS=True).
  • Gracefully rejects cloning iOS-on-Mac wrapper applications with clear, localized error prompts (error_ios_wrapper_unsupported) across CLI (atbclone clone, atbclone wizard) and GUI Creation Wizard, preventing corrupted bundle generation and launch failures.

🎨 Automated Icon Resource Pipeline in Packaging Scripts

• Dynamic .icns Generation:
  • Added automated .icns compilation via sips and iconutil in scripts/build_gui.sh during macOS DMG and app bundle generation.
  • Enhanced asset inclusion and integrity verification in packaging workflows.

🌐 Multi-Language Localization

• Localized Error Diagnostics:
  • Added localized prompt messages for unsupported iOS wrapper apps across all 9 supported languages.
• Testing:
  • Expanded test suite to 336 automated unit and GUI integration tests.