mirror of
https://github.com/cloudstack-llc/mlx-knife.git
synced 2026-07-18 20:54:26 -04:00
f5fe1dd061
Features: - Enhanced error handling & logging (ADR-004): Unified error envelope, structured logging with JSON support, request correlation - Legacy format detection (Issue #37): Runtime compatibility check for weight file formats Bug Fixes: - Issue #37: Models with legacy weight formats now correctly detected as runtime-incompatible - CLI regression fix: mlxk2 without arguments shows help instead of JSON error Test Status: 295/295 passed, 14 skipped
Architecture Decision Records (ADRs)
Overview
This directory contains Architecture Decision Records (ADRs) that document significant architectural and design decisions for the MLX-Knife project.
Active ADRs
| ADR | Title | Status | Date |
|---|---|---|---|
| ADR-001 | JSON API Strategy & 2.0 Migration Path | Accepted | 2025-08-28 |
| ADR-002 | Edge Cases from 1.x Test Suite | Accepted | 2025-08-28 |
| ADR-003 | Server and Run Functionality Port from 1.x to 2.0 | Accepted | 2025-09-10 |
| ADR-004 | Enhanced Error Handling & Logging | Accepted | 2025-10-19 |
| ADR-005 | Clone Implementation Beta3 | Superseded by ADR-007 | 2025-09-18 |
| ADR-006 | Clone Implementation Revised | Superseded by ADR-007 | 2025-09-18 |
| ADR-007 | Clone Implementation Fixed Strategy | Accepted | 2025-09-18 |
ADR Format
Each ADR follows this structure:
- Status: Proposed / Accepted / Rejected / Superseded
- Context: Why this decision is needed
- Decision: What we decided to do
- Consequences: What happens as a result