diff --git a/AGENTS.md b/AGENTS.md index 9db6421..c7a4160 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,8 +24,7 @@ hostkeeper/ (root — bersih untuk V2) ├── mobile/ ← (BELUM DIBUAT) V2 mobile wrapper ├── template/ ← Referensi UI React (Lumina System) │ └── src/components/ 7 React screens (Dashboard, Terminal, SFTP, Snippets, Keychain, Settings, Brief) -├── docs/ -│ └── v2/ ← Dokumentasi perencanaan V2 (10 file, 6,310 baris) +├── docs/ ← Dokumentasi perencanaan V2 (10 file, 6,310 baris) └── AGENTS.md ← file ini (checkpoint AI) Git branches: @@ -50,7 +49,7 @@ Git branches: ## 3. V2 Status — Pre-Development ### ✅ Sudah Selesai -- 10 dokumen perencanaan di `docs/v2/`: +- 10 dokumen perencanaan di `docs/`: - `ARCHITECTURE.md` — GoFiber v2 + React + Electron + mobile WebView - `API.md` — REST + WebSocket spec (1,303 baris) - `DATA_MODELS.md` — Host, Group, Snippet, Key, PortForward, Workspace, Config @@ -138,12 +137,12 @@ Step 9: Setup Electron: npm install electron electron-builder --save-dev | Untuk | Lihat di | |-------|----------| -| Arsitektur lengkap | `docs/v2/ARCHITECTURE.md` | -| API spec | `docs/v2/API.md` | -| Data models | `docs/v2/DATA_MODELS.md` | -| UI component tree | `docs/v2/UI_COMPONENTS.md` | -| Sprint plan detail | `docs/v2/SPRINT_PLAN.md` | -| Template analysis + bugs | `docs/v2/TEMPLATE_ANALYSIS.md` | +| Arsitektur lengkap | `docs/ARCHITECTURE.md` | +| API spec | `docs/API.md` | +| Data models | `docs/DATA_MODELS.md` | +| UI component tree | `docs/UI_COMPONENTS.md` | +| Sprint plan detail | `docs/SPRINT_PLAN.md` | +| Template analysis + bugs | `docs/TEMPLATE_ANALYSIS.md` | | Template source code | `template/src/components/` | | Template AGENTS.md | `template/AGENTS.md` (desain system) | | V1 shared packages | `v1/pkg/ssh/`, `v1/pkg/crypto/`, `v1/pkg/storage/`, `v1/pkg/config/`, `v1/pkg/knownhosts/` | diff --git a/CHANGELOG.md b/CHANGELOG.md index 22394f7..4c2bc45 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,15 +3,15 @@ ## [Unreleased] — V2 Planning Complete (2026-06-29) ### Added (V2 Planning Documents) -- `docs/v2/PROGRESS.md` — Status tracker for V2 development -- `docs/v2/ARCHITECTURE.md` — System architecture (GoFiber + React + Electron) -- `docs/v2/API.md` — REST API + WebSocket specification -- `docs/v2/DATA_MODELS.md` — Extended data models (Groups, PortForward, Workspace) -- `docs/v2/UI_COMPONENTS.md` — React component tree + state management -- `docs/v2/UI_TERMIUS_REFERENCE.md` — Termius visual reference -- `docs/v2/SPRINT_PLAN.md` — Sprint-by-sprint task breakdown -- `docs/v2/BUILD_SYSTEM.md` — Cross-platform build pipeline -- `docs/v2/PERFORMANCE.md` — Performance & stability guide +- `docs/PROGRESS.md` — Status tracker for V2 development +- `docs/ARCHITECTURE.md` — System architecture (GoFiber + React + Electron) +- `docs/API.md` — REST API + WebSocket specification +- `docs/DATA_MODELS.md` — Extended data models (Groups, PortForward, Workspace) +- `docs/UI_COMPONENTS.md` — React component tree + state management +- `docs/UI_TERMIUS_REFERENCE.md` — Termius visual reference +- `docs/SPRINT_PLAN.md` — Sprint-by-sprint task breakdown +- `docs/BUILD_SYSTEM.md` — Cross-platform build pipeline +- `docs/PERFORMANCE.md` — Performance & stability guide ### Architecture Decision - Backend: GoFiber v2 (fasthttp-based) replacing chi/net/http diff --git a/README.md b/README.md index 459d4b2..041a958 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,7 @@ V2 adalah rewrite dengan arsitektur baru: - **Desktop**: Electron wrapper di `app/electron/` - **Mobile**: WebView shell di `mobile/` -Lihat [docs/v2/](docs/v2/) untuk dokumentasi perencanaan. +Lihat [docs/](docs/) untuk dokumentasi perencanaan. ## Struktur Repository @@ -32,8 +32,7 @@ hostkeeper/ ├── app/ ← V2 backend + frontend + electron ├── mobile/ ← V2 mobile wrapper ├── template/ ← Referensi UI React (Lumina System) -└── docs/ - └── v2/ ← Dokumentasi perencanaan V2 +└── docs/ ← Dokumentasi perencanaan V2 ``` ## License diff --git a/docs/v2/API.md b/docs/API.md similarity index 100% rename from docs/v2/API.md rename to docs/API.md diff --git a/docs/v2/ARCHITECTURE.md b/docs/ARCHITECTURE.md similarity index 92% rename from docs/v2/ARCHITECTURE.md rename to docs/ARCHITECTURE.md index d85d9dd..6d2c3d5 100644 --- a/docs/v2/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -189,31 +189,34 @@ hostkeeper/ │ ├── build-electron.sh # Electron package │ └── build-mobile.sh # Mobile build │ -├── docs/ # Documentation -│ ├── v2/ # V2 planning docs -│ │ ├── PROGRESS.md # Status tracker (read this first) -│ │ ├── ARCHITECTURE.md # This file -│ │ ├── API.md # REST API + WebSocket spec -│ │ ├── DATA_MODELS.md # Extended data models -│ │ ├── UI_COMPONENTS.md # React component tree -│ │ ├── UI_TERMIUS_REFERENCE.md # Termius visual reference -│ │ ├── SPRINT_PLAN.md # Sprint-by-sprint task breakdown -│ │ ├── BUILD_SYSTEM.md # Build pipeline -│ │ └── PERFORMANCE.md # Performance & stability -│ ├── v1/ # V1 docs (FROZEN, reference only) -│ │ ├── ARCHITECTURE.md -│ │ ├── TEST_PLAN.md -│ │ ├── INSTALLATION.md -│ │ └── USAGE.md -│ └── plans/ # V1 design docs (FROZEN) +├── docs/ # Documentation (V2 planning) +│ ├── PROGRESS.md # Status tracker (read this first) +│ ├── ARCHITECTURE.md # This file +│ ├── API.md # REST API + WebSocket spec +│ ├── DATA_MODELS.md # Extended data models +│ ├── UI_COMPONENTS.md # React component tree +│ ├── UI_TERMIUS_REFERENCE.md # Termius visual reference +│ ├── SPRINT_PLAN.md # Sprint-by-sprint task breakdown +│ ├── BUILD_SYSTEM.md # Build pipeline +│ ├── PERFORMANCE.md # Performance & stability +│ └── TIMELINE.md # Project timeline │ -├── go.mod # V1 Go module -├── go.sum -├── Makefile -├── build.sh ├── CHANGELOG.md -├── PROJECT_STATE.md # V1 project state -└── README.md +├── README.md +├── AGENTS.md # AI session checkpoint +├── v1/ # V1 CLI/TUI (FROZEN) +│ ├── cmd/hostkeeper/ +│ ├── internal/ +│ ├── pkg/ +│ ├── test/ +│ ├── docs/ # V1 docs +│ ├── go.mod +│ └── Makefile +├── template/ # React UI template (Lumina System) +└── app/ # V2 app (scaffolding not started) + ├── backend/ + ├── frontend/ + └── electron/ ``` --- diff --git a/docs/v2/BUILD_SYSTEM.md b/docs/BUILD_SYSTEM.md similarity index 100% rename from docs/v2/BUILD_SYSTEM.md rename to docs/BUILD_SYSTEM.md diff --git a/docs/v2/DATA_MODELS.md b/docs/DATA_MODELS.md similarity index 100% rename from docs/v2/DATA_MODELS.md rename to docs/DATA_MODELS.md diff --git a/docs/v2/PERFORMANCE.md b/docs/PERFORMANCE.md similarity index 100% rename from docs/v2/PERFORMANCE.md rename to docs/PERFORMANCE.md diff --git a/docs/v2/PROGRESS.md b/docs/PROGRESS.md similarity index 93% rename from docs/v2/PROGRESS.md rename to docs/PROGRESS.md index 51bbad3..7f8205c 100644 --- a/docs/v2/PROGRESS.md +++ b/docs/PROGRESS.md @@ -290,15 +290,15 @@ Hostkeeper V2 is a Termius-like cross-platform SSH/SFTP management GUI applicati ### For a new AI agent: -1. **Read this file** (`docs/v2/PROGRESS.md`) — find the first `[ ]` item +1. **Read this file** (`docs/PROGRESS.md`) — find the first `[ ]` item 2. **Read the relevant spec doc** — for the current task: - - REST API endpoints -> `docs/v2/API.md` - - UI components -> `docs/v2/UI_COMPONENTS.md` - - Data models -> `docs/v2/DATA_MODELS.md` - - Visual reference -> `docs/v2/UI_TERMIUS_REFERENCE.md` - - Performance notes -> `docs/v2/PERFORMANCE.md` - - Build pipeline -> `docs/v2/BUILD_SYSTEM.md` -3. **Read `docs/v2/ARCHITECTURE.md`** — understand the system + - REST API endpoints -> `docs/API.md` + - UI components -> `docs/UI_COMPONENTS.md` + - Data models -> `docs/DATA_MODELS.md` + - Visual reference -> `docs/UI_TERMIUS_REFERENCE.md` + - Performance notes -> `docs/PERFORMANCE.md` + - Build pipeline -> `docs/BUILD_SYSTEM.md` +3. **Read `docs/ARCHITECTURE.md`** — understand the system 4. **Implement** in `app/backend/` (Go) or `app/frontend/` (React) 5. **Test** — run `go test ./app/backend/...` and `npm test` in `app/frontend/` 6. **Update this file** — mark `[x]` the completed task, update "Last Session Notes" @@ -316,15 +316,15 @@ Hostkeeper V2 is a Termius-like cross-platform SSH/SFTP management GUI applicati | Document | When to read | |----------|-------------| -| `docs/v2/PROGRESS.md` | Always (first) — know where to continue | -| `docs/v2/ARCHITECTURE.md` | Understanding the system | -| `docs/v2/API.md` | Implementing REST endpoints or WebSocket handlers | -| `docs/v2/DATA_MODELS.md` | Creating/modifying Go structs or JSON schemas | -| `docs/v2/UI_COMPONENTS.md` | Building React components | -| `docs/v2/UI_TERMIUS_REFERENCE.md` | Designing UI layout, colors, typography | -| `docs/v2/SPRINT_PLAN.md` | Detailed file-by-file task instructions | -| `docs/v2/BUILD_SYSTEM.md` | Setting up build pipeline | -| `docs/v2/PERFORMANCE.md` | Tuning for speed and stability | +| `docs/PROGRESS.md` | Always (first) — know where to continue | +| `docs/ARCHITECTURE.md` | Understanding the system | +| `docs/API.md` | Implementing REST endpoints or WebSocket handlers | +| `docs/DATA_MODELS.md` | Creating/modifying Go structs or JSON schemas | +| `docs/UI_COMPONENTS.md` | Building React components | +| `docs/UI_TERMIUS_REFERENCE.md` | Designing UI layout, colors, typography | +| `docs/SPRINT_PLAN.md` | Detailed file-by-file task instructions | +| `docs/BUILD_SYSTEM.md` | Setting up build pipeline | +| `docs/PERFORMANCE.md` | Tuning for speed and stability | --- diff --git a/docs/v2/SPRINT_PLAN.md b/docs/SPRINT_PLAN.md similarity index 100% rename from docs/v2/SPRINT_PLAN.md rename to docs/SPRINT_PLAN.md diff --git a/docs/v2/TIMELINE.md b/docs/TIMELINE.md similarity index 99% rename from docs/v2/TIMELINE.md rename to docs/TIMELINE.md index 4a93cdc..ef2e047 100644 --- a/docs/v2/TIMELINE.md +++ b/docs/TIMELINE.md @@ -298,7 +298,7 @@ Thu 7: [Release] v2.0.0 ← M6 **How to update this timeline**: 1. At the end of each day, mark `[x]` for completed tasks 2. If a task takes longer, adjust subsequent dates -3. Update `docs/v2/PROGRESS.md` with actual completion dates +3. Update `docs/PROGRESS.md` with actual completion dates ```markdown ### Week 1 Progress diff --git a/docs/v2/UI_COMPONENTS.md b/docs/UI_COMPONENTS.md similarity index 100% rename from docs/v2/UI_COMPONENTS.md rename to docs/UI_COMPONENTS.md diff --git a/docs/v2/UI_TERMIUS_REFERENCE.md b/docs/UI_TERMIUS_REFERENCE.md similarity index 100% rename from docs/v2/UI_TERMIUS_REFERENCE.md rename to docs/UI_TERMIUS_REFERENCE.md