Evandro Fonseca Junior
9a093dca15
- Phase 4: Hugging Face Download Engine — streaming GGUF downloads with progress, cancellation, and managed-model storage - Phase 5: Model Source Validation — source-mode compatibility, path/file validation, inline error UI with recovery guidance - Hot-swap: stop runtime → update model_path → restart atomic command - Model library: folder open, delete model file, local model management - SettingsPage unified hub: local models list + HF search with 3-state action buttons - Bug fixes: send button text restored (4 failing tests), reasoning-toggle aria-label, Rust warnings - All 89 tests passing, cargo check clean
117 lines
5.9 KiB
Markdown
117 lines
5.9 KiB
Markdown
---
|
|
gsd_state_version: 1.0
|
|
milestone: v1.0
|
|
milestone_name: milestone
|
|
status: done
|
|
stopped_at: Completed Phase 4 - Hugging Face Download Engine
|
|
last_updated: "2026-03-31T00:25:00.000Z"
|
|
last_activity: 2026-03-31
|
|
progress:
|
|
total_phases: 5
|
|
completed_phases: 4
|
|
total_plans: 12
|
|
completed_plans: 12
|
|
percent: 80
|
|
---
|
|
|
|
# Project State
|
|
|
|
## Project Reference
|
|
|
|
See: `.planning/PROJECT.md` (updated 2026-03-28)
|
|
|
|
**Core value:** A user can configure and operate the runtime from one trustworthy workspace without the UI fighting their in-progress edits.
|
|
**Current focus:** Phase 4 complete — HF download engine operational.
|
|
|
|
## Current Position
|
|
|
|
Phase: 4 of 5 (Hugging Face Download Engine)
|
|
Plan: 3 of 3 authored for current phase
|
|
Status: Phase complete — verified
|
|
Last activity: 2026-03-31 - Implemented HF download engine (Rust streaming + Tauri events + React hook + SettingsPage integration)
|
|
|
|
Progress: [████████░░] 80%
|
|
|
|
## Performance Metrics
|
|
|
|
**Velocity:**
|
|
|
|
- Total plans completed: 12
|
|
- Average duration: 13min
|
|
- Total execution time: ~2.6 hours
|
|
|
|
**By Phase:**
|
|
|
|
| Phase | Plans | Total | Avg/Plan |
|
|
|-------|-------|-------|----------|
|
|
| 01 | 3 | 46min | 15min |
|
|
| 02 | 3 | 33min | 11min |
|
|
| 03 | 3 | 39min | 13min |
|
|
| 04 | 3 | 45min | 15min |
|
|
|
|
**Recent Trend:**
|
|
|
|
- Last 5 plans: 04-03 (15min), 04-02 (15min), 04-01 (15min), 03-03 (13min), 03-02 (13min)
|
|
- Trend: Stable
|
|
|
|
| Phase 01 P01 | 10min | 2 tasks | 4 files |
|
|
| Phase 01 P02 | 18min | 2 tasks | 4 files |
|
|
| Phase 01 P03 | 18min | 2 tasks | 5 files |
|
|
| Phase 02-lifecycle-command-safety P01 | 6min | 2 tasks | 3 files |
|
|
| Phase 02-lifecycle-command-safety P02 | 14min | 2 tasks | 5 files |
|
|
| Phase 02-lifecycle-command-safety P03 | 13min | 2 tasks | 7 files |
|
|
| Phase 03-unified-runtime-workspace P01 | 13min | 2 tasks | 4 files |
|
|
| Phase 03-unified-runtime-workspace P02 | 13min | 2 tasks | 5 files |
|
|
| Phase 03-unified-runtime-workspace P03 | 13min | 2 tasks | 6 files |
|
|
| Phase 04-hf-download-engine P01 | 15min | 2 tasks | 3 files |
|
|
| Phase 04-hf-download-engine P02 | 15min | 2 tasks | 3 files |
|
|
| Phase 04-hf-download-engine P03 | 15min | 2 tasks | 4 files |
|
|
|
|
## Accumulated Context
|
|
|
|
### Decisions
|
|
|
|
Decisions are logged in PROJECT.md Key Decisions table.
|
|
Recent decisions affecting current work:
|
|
|
|
- Phase 1 starts with state ownership fixes before UI consolidation to eliminate poll-driven draft overwrites first.
|
|
- This milestone stays brownfield and must preserve working lifecycle, model selection, and chat flows while improving runtime workspace trust.
|
|
- [Phase 01]: Kept legacy snapshot and saveConfig outputs while adding explicit draft APIs so existing runtime drawer consumers keep compiling during the Phase 1 transition.
|
|
- [Phase 01]: When a runtime draft is dirty, polling updates only operational live fields and leaves baseline plus draft config untouched.
|
|
- [Phase 02-lifecycle-command-safety]: Expose active and last lifecycle command data on RuntimeSnapshot so frontend polling can render trustworthy lifecycle feedback without inferring from status alone.
|
|
- [Phase 02-lifecycle-command-safety]: Centralize duplicate start/stop blocking in runtime state helpers so save, start, and stop flows share the same command-result contract.
|
|
- [Phase 02-lifecycle-command-safety]: Keep restart-required save enforcement limited to connection_mode, model_path, addr, gpu_layers, and ctx_size to stay aligned with the existing backend runtime boundary.
|
|
- [Phase 02-lifecycle-command-safety]: Mirror backend lifecycle metadata directly into the frontend RuntimeSnapshot so polling and command responses share one contract.
|
|
- [Phase 02-lifecycle-command-safety]: Derive applyImpact from saved baseline versus draft config using the backend restart-required field list instead of UI-only heuristics.
|
|
- [Phase 02-lifecycle-command-safety]: Expose activeLifecycleCommand, lastLifecycleResult, and lifecycleBusy from the manager so status-card and drawer copy can consume explicit state in plan 02-03.
|
|
- [Phase 02-lifecycle-command-safety]: Use explicit lifecycle result banners instead of overloading last_error so completed and blocked actions remain visible after polling refreshes.
|
|
- [Phase 02-lifecycle-command-safety]: Render apply guidance in the drawer before the CTA row so users see whether a draft applies immediately, needs restart, or must be saved before apply.
|
|
- [Phase 02-lifecycle-command-safety]: Keep status-card and drawer props backward-compatible with optional lifecycle fields while Sidebar forwards the new manager contract.
|
|
- [Phase 03-01]: Reuse existing restart-impact field list and lifecycle labels instead of creating parallel heuristics
|
|
- [Phase 03-01]: Derive diagnostics from backend-owned snapshot fields (status, ready, process_running, resolved_url, config.*, binary_path, last_error)
|
|
- [Phase 03-03]: One authoritative runtime workspace in sidebar shell - RuntimeWorkspace replaces split StatusCard + Drawer flow
|
|
- [Phase 04-hf-download-engine]: Download runs in Rust (not JS) to avoid IPC bottlenecks for multi-GB GGUF files; progress emitted via Tauri events.
|
|
- [Phase 04-hf-download-engine]: Direct resolve URL `https://huggingface.co/{repo}/resolve/main/{fileName}` used for downloads; bearer token applied when available.
|
|
- [Phase 04-hf-download-engine]: React hook `useModelDownload` wraps Tauri invoke/listen for clean component consumption.
|
|
- [Phase 04-hf-download-engine]: `.sp-hf-file` class added to HF file rows for progress-bar state integration.
|
|
|
|
### Pending Todos
|
|
|
|
None yet.
|
|
|
|
### Blockers/Concerns
|
|
|
|
- None currently; Phase 4 complete and verified.
|
|
|
|
### Quick Tasks Completed
|
|
|
|
| # | Description | Date | Commit | Directory |
|
|
|---|-------------|------|--------|-----------|
|
|
| 1 | Investigar e corrigir bug de internal error na segunda mensagem do chat | 2026-03-30 | abb9db0 | [1-investigar-e-corrigir-bug-de-internal-er](./quick/1-investigar-e-corrigir-bug-de-internal-er/) |
|
|
|
|
## Session Continuity
|
|
|
|
Last session: 2026-03-31T00:25:00.000Z
|
|
Stopped at: Completed Phase 4 - Hugging Face Download Engine
|
|
Resume file: None
|