mirror of
https://github.com/cloudstack-llc/mlx-knife.git
synced 2026-07-19 14:43:36 -04:00
The BROKE Team
d603cde9d5
✅ FOUNDATION COMPLETE: Working `python -m mlxk2.cli list` command Architecture: - Clean-room implementation (145 lines total) - JSON-first design for broke-cluster automation - Modular structure: core/operations/output separation Deliverables: - mlxk2/core/cache.py: Cache path management (35 lines) - mlxk2/operations/list.py: Model discovery with JSON output (41 lines) - mlxk2/cli.py: CLI entry point with error handling (69 lines) - docs/: Complete ADR and implementation plan documentation Success Metrics Achieved: ✅ 12 models detected and JSON-formatted ✅ Consistent schema: status/command/data/error ✅ broke-cluster ready: `jq -r '.data.models[].name'` ✅ 4x faster than planned (1 hour vs 4 hour target) Next: Session 2 - health, pull, rm operations
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 | Proposed | 2025-08-26 |
| ADR-002 | Edge Cases from 1.x Test Suite | Proposed | 2025-08-26 |
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
Related Documents
- 2.0 Implementation Plan
- GitHub Issue #8 - JSON API Feature Request
- Refactoring Analysis - Why we chose clean-room over refactoring