> ## Documentation Index > Fetch the complete documentation index at: https://arclux-os.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # platform > File map scaffold platform layer: runtime, kernel, services, dll # Platform Layer — File Map Reference untuk scaffold platform layer (lihat decisions.md: "Platform layer scaffold added"). Semua file di bawah masih stub kosong — pakai tabel ini buat inget apa yang harus diisi tiap file pas mulai kerja. Prinsip: layer ini CONSUME core ARCLUX yang udah ada (engine/graph/ impact/parser), gak duplikasi. Lihat ARCHITECTURE\_MAP.md. ## packages/runtime/ | File | Tanggung jawab | | ----------------- | ------------------------------------------ | | RuntimeManager.ts | Entry point ngatur runtime keseluruhan | | ProcessManager.ts | Spawn/kill/track proses | | ProcessSpec.ts | Definisi shape config satu proses | | ProcessState.ts | State proses (running/stopped/crashed dll) | | ProcessOutput.ts | Capture stdout/stderr proses | ## packages/services/ | File | Tanggung jawab | | -------------------- | ------------------------------------------- | | ServiceManager.ts | Start/stop/restart service | | ServiceDefinition.ts | Shape config satu service | | ServiceState.ts | State service saat ini | | ServiceDependency.ts | Relasi antar-service (A butuh B nyala dulu) | ## packages/scheduler/ | File | Tanggung jawab | | --------------- | ---------------------------------------- | | JobScheduler.ts | Jadwalin & jalanin job | | Job.ts | Shape satu job | | JobQueue.ts | Antrian job | | JobState.ts | Status job (pending/running/done/failed) | ## packages/environment/ | File | Tanggung jawab | | ----------------------- | ----------------------------------- | | EnvironmentManager.ts | Kelola environment aktif | | EnvironmentDetector.ts | Deteksi environment (Termux/CI/dll) | | EnvironmentProfile.ts | Shape config satu environment | | EnvironmentVariables.ts | Kelola env vars | ## packages/workspace/ | File | Tanggung jawab | | -------------------- | -------------------------------------------------- | | WorkspaceManager.ts | Entry point workspace (project+env+service+proses) | | WorkspaceState.ts | State keseluruhan workspace | | WorkspaceSession.ts | Sesi kerja aktif di workspace | | WorkspaceSnapshot.ts | Snapshot state workspace buat restore | ## packages/terminal/ | File | Tanggung jawab | | ------------------- | ----------------------------- | | TerminalManager.ts | Kelola sesi terminal | | CommandExecutor.ts | Eksekusi command | | CommandSession.ts | Shape satu sesi command | | ShellEnvironment.ts | Env buat shell yang dijalanin | ## packages/storage/ | File | Tanggung jawab | | ------------------ | ----------------------------------------------------- | | SnapshotManager.ts | Simpan/restore snapshot state | | CacheManager.ts | Cache layer platform (BEDA dari packages/cache/ core) | | ArtifactStore.ts | Simpan artifact hasil build/analisis | | RecoveryManager.ts | Recovery dari crash/state korup | ## packages/networking/ | File | Tanggung jawab | | -------------------- | ----------------------------------------- | | PortManager.ts | Alokasi & track port yang dipakai service | | ServiceEndpoint.ts | Shape endpoint satu service | | NetworkRegistry.ts | Registry semua endpoint aktif | | ConnectionManager.ts | Kelola koneksi antar-service | ## packages/security/ | File | Tanggung jawab | | -------------------- | ------------------------------- | | PermissionManager.ts | Cek permission aksi | | PolicyEngine.ts | Evaluasi policy/rule akses | | Capability.ts | Shape satu capability/izin | | Sandbox.ts | Isolasi eksekusi proses/command | ## packages/system/ | File | Tanggung jawab | | --------------------- | ----------------------------------------------------------------------------- | | SystemManager.ts | State terpusat: workspace+proc+service+env+repo+index+diagnostics+jobs+health | | SystemState.ts | Shape state sistem | | ConfigurationStore.ts | Simpan config sistem | | HealthMonitor.ts | Pantau kesehatan komponen | ## packages/diagnostics/ | File | Tanggung jawab | | ------------------- | ----------------------------------------------------------- | | DiagnosticEngine.ts | Hub: error → ErrorLocation → graph → impact → FixSuggestion | | ErrorLocation.ts | Shape lokasi error (file:line) | | ErrorContext.ts | Konteks sekitar error | | FixSuggestion.ts | Saran perbaikan | | DiagnosticEvent.ts | Event diagnostic buat notifikasi | ## packages/editor/ | File | Tanggung jawab | | ------------------ | ---------------------------------------------------------- | | CodeNavigator.ts | Navigasi ke file/line relevan | | ImpactNavigator.ts | Navigasi ke daftar affected files (pakai packages/impact/) | | SymbolProvider.ts | Sumber info symbol buat editor | | LineContext.ts | Konteks baris kode tertentu | | EditContext.ts | Konteks sesi editing developer | ## packages/language/ | File | Tanggung jawab | | ------------------- | --------------------------------------------------------------------- | | LanguageService.ts | Entry point language intelligence, konsumsi packages/parser/ yang ada | | SymbolEngine.ts | Symbol → type/declaration/imports/consumers | | SyntaxEngine.ts | Analisis syntax (pakai parser existing) | | CompletionEngine.ts | Auto-complete | | FormattingEngine.ts | Format kode | | DiffEngine.ts | Semantic diff (text→symbol→AST→dependency→impact→architectural) | ## packages/orchestration/ | File | Tanggung jawab | | ----------------------- | ------------------------------------------------------------ | | PlatformOrchestrator.ts | Lem utama: watcher→index→graph→impact→diagnostics→runtime→UI | | EventRouter.ts | Routing event antar-modul platform | | TaskOrchestrator.ts | Koordinasi multi-step task | | RecoveryOrchestrator.ts | Koordinasi recovery pas ada failure | ## apps/cli/commands/ (baru) | File | Tanggung jawab | | ------------ | -------------------------------------------------------- | | run.ts | Jalanin service/proses | | ps.ts | List proses aktif | | service.ts | CRUD/control service | | logs.ts | Tail/lihat logs | | proc.ts | Detail satu proses | | workspace.ts | Kelola workspace | | env.ts | Kelola environment | | diagnose.ts | Trigger diagnostic engine | | open.ts | Buka file/impact/dependency dari CLI | | edit.ts | Trigger editor context | | recover.ts | Trigger recovery manager | | health.ts | Tampilkan status kesehatan via HealthMonitor | | package.ts | Install/remove/list platform package via package-manager | ## apps/web/app/api/ (baru) | File | Tanggung jawab | | ---------------------- | ----------------------------- | | runtime/route.ts | API runtime state | | processes/route.ts | API list/control proses | | services/route.ts | API list/control service | | diagnostics/route.ts | API diagnostic engine | | notifications/route.ts | API notification stream | | editor/route.ts | API editor context/navigation | ## packages/kernel/ | File | Tanggung jawab | | ------------------------------- | ------------------------------------------------------------------------ | | Kernel.ts | Core process kernel: nyatuin process table, signal bus, service registry | | ProcessTable.ts | Tabel in-memory proses yang lagi jalan | | SignalBus.ts | Pub/sub sinyal antar-subsistem level kernel | | ServiceRegistry.ts | Registry nama service ke instance yang jalan | | introspection/ProcSnapshot.ts | Snapshot process table di satu titik waktu | | introspection/formatProcTree.ts | Format ProcSnapshot jadi tree yang bisa dibaca | ## packages/semantic-diff/ | File | Tanggung jawab | | ----------------- | ------------------------------------------------------------------------- | | SemanticDiff.ts | Pipeline utama: text → symbol → AST → dependency → impact → architectural | | SymbolDiff.ts | Diff symbol (rename/type-changed/removed) antar-versi | | AstDiff.ts | Diff AST node antar-versi file | | DependencyDiff.ts | Diff dependency edge yang kena dampak (pakai packages/diff + graph) | | DiffRenderer.ts | Render hasil semantic diff jadi output yang bisa dibaca | ## packages/notifications/ | File | Tanggung jawab | | ---------------------- | ---------------------------------------------------------- | | NotificationManager.ts | Dispatch notifikasi ke channel yang terdaftar | | Notification.ts | Shape satu notifikasi (title, body, severity) | | NotificationChannel.ts | Interface channel pengiriman notifikasi (editor, CLI, web) | ## packages/package-manager/ | File | Tanggung jawab | | ------------------ | -------------------------------------------------------- | | PackageManager.ts | Install/remove/list platform package | | PackageManifest.ts | Shape manifest satu platform package (nama, versi, deps) | | PackageResolver.ts | Resolve dependency graph & version constraint | | PackageState.ts | Track state install/pending/failed platform package | ## Blueprint Integration — Alur Editor Diagram asli (lihat decisions.md): Developer ketik → Editor → incremental analysis → Error/Symbol/Dependency → Diagnostics → Impact Engine → Affected Files → Notification → developer diarahkan ke file+line. | Tahap | File platform (baru) | Konsumsi dari (existing) | | ---------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- | | Editor menangkap keystroke | packages/editor/EditContext.ts, CodeNavigator.ts | — | | Incremental analysis | packages/language/LanguageService.ts | packages/engine/analyzeFile.ts (existing) | | Error detection | packages/diagnostics/DiagnosticEngine.ts | packages/detectors/\* (existing) | | Symbol resolution | packages/language/SymbolEngine.ts | packages/engine/analyzeModule.ts (existing) | | Dependency resolution | packages/language/SyntaxEngine.ts | packages/engine/analyzeDependency.ts (existing) | | Diagnostics aggregation | packages/diagnostics/DiagnosticEngine.ts, ErrorLocation.ts | — | | Impact engine | packages/editor/ImpactNavigator.ts | packages/engine/analyzeImpact.ts (existing) | | Affected files/lines/symbols | packages/diagnostics/FixSuggestion.ts | packages/impact/\* (existing, cek map-packages-impact.mdx) | | Notification | packages/notifications/NotificationManager.ts | — | | Navigasi ke file+line | packages/editor/CodeNavigator.ts | — | ## Blueprint Integration — Semantic Diff Pipeline Diagram asli: Text Diff → Symbol Diff → AST Diff → Dependency Diff → Impact Diff → Architectural Diff. | Tahap | File platform (baru) | Konsumsi dari (existing) | | ------------------ | ---------------------------------------------------- | ---------------------------------------------------------- | | Text Diff | packages/semantic-diff/SemanticDiff.ts (entry) | packages/diff/gitDiff.ts (existing) | | Symbol Diff | packages/semantic-diff/SymbolDiff.ts | packages/engine/analyzeModule.ts (existing) | | AST Diff | packages/semantic-diff/AstDiff.ts | packages/parser/\* (existing, cek map-packages-parser.mdx) | | Dependency Diff | packages/semantic-diff/DependencyDiff.ts | packages/diff/architecturalDiff.ts (existing) | | Impact Diff | packages/semantic-diff/DependencyDiff.ts (lanjutan) | packages/engine/analyzeImpact.ts (existing) | | Architectural Diff | packages/semantic-diff/SemanticDiff.ts (final stage) | packages/diff/architecturalDiff.ts (existing) | | Render output | packages/semantic-diff/DiffRenderer.ts | — | **Catatan penting:** semantic-diff TIDAK bikin parser/graph engine kedua. Semua tahap di atas WAJIB memanggil fungsi existing di packages/engine dan packages/diff, bukan reimplementasi. Kalau nemu diri lu nulis AST walking baru di sini, itu tanda salah arah — harusnya panggil packages/parser yang udah ada. ## Blueprint Integration — Arsitektur Besar ARCLUX ENGINE (existing, JANGAN diduplikasi) packages/engine, graph, impact, detectors, diff, search, rules, watcher ↓ dikonsumsi oleh PLATFORM LAYER (baru, layer ini) packages/runtime, kernel, services, scheduler, environment, workspace, terminal, storage, networking, security, system, package-manager, notifications ↓ dikonsumsi oleh DEVELOPER LAYER (baru, interface) packages/editor, language, semantic-diff, diagnostics * apps/cli/commands/\* (baru) * apps/web/app/api/\* (baru) Arah dependency SATU ARAH: Developer Layer → Platform Layer → ARCLUX Engine. Platform Layer tidak boleh reimplement logic yang udah ada di Engine. Engine tidak boleh depend balik ke Platform Layer (supaya engine tetap bisa dipakai standalone via CLI existing tanpa perlu platform layer nyala). ## File existing yang perlu di-edit (bukan file baru, tapi kena sentuh) | File existing | Perubahan yang dibutuhkan | | ------------------- | ------------------------------------------------------------------------------------------------------------------- | | apps/cli/index.ts | Daftarin command baru: run, ps, service, logs, proc, workspace, env, diagnose, open, edit, recover, health, package | | apps/web/lib/api.ts | Cek apakah perlu shared client/middleware buat API routes baru (runtime, processes, services, dst) |