lazy backend boot and rename workspace to project

Backend isolate now boots in two phases: resolve toolchain on spawn
(binary availability only), initialize services on project.open. The
dispatcher stays empty until a project activates — IPC requests before
that return "No project active".

Scheduler ticker only runs while a project is open. Fires an immediate
first cycle on ProjectOpened so sidebar panels refresh without waiting
for the next interval. Stops on ProjectClosed.

Renamed workspace → project throughout backend messages
(project.validate, project.open, project.ready), callbacks
(onProjectOpen, onValidateProject), and methods
(openProject, validateProject, resolveProject).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jeroen Schweitzer
2026-04-26 14:16:46 +02:00
co-authored by Claude Opus 4.6
parent a89910dc36
commit 5515d88407
9 changed files with 367 additions and 204 deletions
+71 -22
View File
@@ -1,8 +1,8 @@
/// Manages the backend isolate lifecycle.
///
/// Call [spawn] to start the backend, which resolves the toolchain and
/// boots all daemon services in a separate isolate. Returns when the
/// backend is ready to accept requests.
/// Two-phase boot:
/// 1. [spawn] — starts the isolate, resolves toolchain (binary checks only).
/// 2. [openWorkspace] — initializes services for a specific project root.
library;
import 'dart:async';
@@ -16,36 +16,44 @@ class Backend {
Backend._({
required this.client,
required this.toolchain,
required SendPort backendRequestPort,
required Isolate isolate,
required ReceivePort receivePort,
}) : _isolate = isolate,
}) : _backendRequestPort = backendRequestPort,
_isolate = isolate,
_receivePort = receivePort;
final IsolateClient client;
final Toolchain toolchain;
final SendPort _backendRequestPort;
final Isolate _isolate;
final ReceivePort _receivePort;
/// Spawn the backend isolate and wait for it to be ready.
Completer<void>? _projectCompleter;
final Map<String, Completer<String?>> _validateCompleters = {};
int _validateId = 0;
/// Spawn the backend isolate. Returns when the toolchain is resolved.
/// No services are active yet — call [openWorkspace] to activate.
static Future<Backend> spawn({
required String workspaceRoot,
required IsolateClient Function(SendPort backendPort) clientFactory,
String? hintRoot,
}) async {
final receivePort = ReceivePort();
final completer = Completer<Backend>();
late final IsolateClient client;
late final Isolate isolate;
late final SendPort backendRequestPort;
late final Backend backend;
receivePort.listen((message) {
if (message is Map<String, Object?>) {
final type = message['type'] as String?;
if (type == 'ready') {
// Backend is booted — extract its request port and toolchain state.
final requestPort = message['requestPort'] as SendPort;
client = clientFactory(requestPort);
backendRequestPort = message['requestPort'] as SendPort;
client = clientFactory(backendRequestPort);
// Apply toolchain state from the backend.
final tcData = message['toolchain'] as Map<String, Object?>;
final toolchain = Toolchain();
toolchain.applyResolved(ResolvedPaths(
@@ -57,14 +65,33 @@ class Backend {
gitEnv: (tcData['gitEnv'] as Map?)?.cast<String, String>(),
));
if (!completer.isCompleted) {
completer.complete(Backend._(
client: client,
toolchain: toolchain,
isolate: isolate,
receivePort: receivePort,
));
}
backend = Backend._(
client: client,
toolchain: toolchain,
backendRequestPort: backendRequestPort,
isolate: isolate,
receivePort: receivePort,
);
if (!completer.isCompleted) completer.complete(backend);
} else if (type == 'project.validated') {
final id = message['id'] as String;
final root = message['root'] as String?;
final c = backend._validateCompleters.remove(id);
if (c != null && !c.isCompleted) c.complete(root);
} else if (type == 'project.ready') {
// Update toolchain with project-specific paths.
final tcData = message['toolchain'] as Map<String, Object?>;
backend.toolchain.applyResolved(ResolvedPaths(
git: tcData['git'] as String?,
pql: tcData['pql'] as String?,
tmux: tcData['tmux'] as String?,
ptyc: tcData['ptyc'] as String?,
shell: tcData['shell'] as String?,
gitEnv: (tcData['gitEnv'] as Map?)?.cast<String, String>(),
));
backend._projectCompleter?.complete();
backend._projectCompleter = null;
} else {
// Response or event — forward to the client.
client.handleMessage(message);
@@ -74,15 +101,37 @@ class Backend {
isolate = await Isolate.spawn(
backendEntry,
BackendBootMessage(
frontendPort: receivePort.sendPort,
workspaceRoot: workspaceRoot,
),
BackendBootMessage(frontendPort: receivePort.sendPort, hintRoot: hintRoot),
);
return completer.future;
}
/// Validate a path as a git repo. Returns the repo root or null.
/// Runs git rev-parse in the backend isolate (no main-thread I/O).
Future<String?> validateProject(String path) {
final id = '${_validateId++}';
final c = Completer<String?>();
_validateCompleters[id] = c;
_backendRequestPort.send({
'type': 'project.validate',
'path': path,
'id': id,
});
return c.future;
}
/// Activate a project. The backend (re)initializes all services
/// for the given root directory. Returns when services are ready.
Future<void> openProject(String path) {
_projectCompleter = Completer<void>();
_backendRequestPort.send({
'type': 'project.open',
'path': path,
});
return _projectCompleter!.future;
}
/// Shut down the backend isolate.
void dispose() {
_isolate.kill(priority: Isolate.beforeNextEvent);