Synchronization Subsystem (`src/sync`)

Synchronization Subsystem (

src/sync

)

This directory is the core state synchronization layer, responsible for observing the VS Code environment and broadcasting state changes to the backend server (via the

../comms

system).

All sync modules are activated by

src/sync/index.ts

and triggered primarily by

requestSync

events.

Core Components

File	Purpose	Data Broadcasted	Key Features
`env.ts`	Environment	`sid` , `machineId` , `sessionId` , `workspaceDir` , clipboard content.	Provides essential metadata about the VS Code instance and context.
`window.ts`	Window State	Tab group structure, active/dirty tabs, visible text editors, window state.	Captures the UI layout and editing activity.
`workspace.ts`	Workspace	Workspace name, trust status, folders, open text documents.	Captures the project-level context.
`terminals.ts`	Terminal Activity	Command line, current working directory, output, exit code for each execution.	Tracks terminal commands using VS Code Shell Integration. Also handles opening a Dagger-based terminal via the `session.term.open` event.

Legacy/Unused Components

fs.ts
: Contains a
```
VegContentProvider
```
implementation similar to
```
src/services/filesystemProvider.ts
```
. It is NOT currently imported or activated by
```
index.ts
```
. It appears to be an older or alternative implementation of the virtual filesystem logic.

Terminal Tracking Details (

terminals.ts

)

The terminal synchronization is robust, capturing full execution history.

class Exec {
	start: vscode.TerminalShellExecutionStartEvent | null = null
	output: string = ""
	end: vscode.TerminalShellExecutionEndEvent | null = null
}

class Terminal {
	termIndex: number = 0;
	terminal: vscode.Terminal | null = null;
	history: Exec[] = [];	
}

class TerminalPayload {
	id: number = -1;
	name?: string;
	history?: HistoryPayload[];
}

class HistoryPayload {
	cmd?: any;
	cwd?: string;
	out?: string;
	exit?: number;
}

It listens to:

```
onDidStartTerminalShellExecution
```
```
onDidEndTerminalShellExecution
```
```
read()
```
from the execution stream to capture output.

Environment Synchronization (

env.ts

)

Broadcasts information about the environment.

async function broadcastEnv(context: vscode.ExtensionContext) {
	const wsF = vscode.workspace.workspaceFolders
	var wDir: string | undefined
	if (wsF && wsF.length > 0) {
		wDir = wsF[0].uri.path	
	}
	const sid = context.workspaceState.get("sid")

	const msg = {
		type: "env.info.resp",
		payload: {
			sid,
			machineId: vscode.env.machineId,
			vscodeSid: vscode.env.sessionId,
			remoteName: vscode.env.remoteName,
			user: "verdverm",
		  workspaceDir: wDir,
			clipboard: await vscode.env.clipboard.readText(),
		}
	}
	extensionEmitter.fire(msg);
	sendMessage(msg)
}

Core Components

File	Purpose	Data Broadcasted	Key Features
`env.ts`	Environment	`sid` , `machineId` , `sessionId` , `workspaceDir` , clipboard content.	Provides essential metadata about the VS Code instance and context.
`window.ts`	Window State	Tab group structure, active/dirty tabs, visible text editors, window state.	Captures the UI layout and editing activity.
`workspace.ts`	Workspace	Workspace name, trust status, folders, open text documents.	Captures the project-level context.
`terminals.ts`	Terminal Activity	Command line, current working directory, output, exit code for each execution.	Tracks terminal commands using VS Code Shell Integration. Also handles opening a Dagger-based terminal via the `session.term.open` event.

Terminal Tracking Details (

terminals.ts

)

The terminal synchronization is robust, capturing full execution history.

class Exec {
	start: vscode.TerminalShellExecutionStartEvent | null = null
	output: string = ""
	end: vscode.TerminalShellExecutionEndEvent | null = null
}

class Terminal {
	termIndex: number = 0;
	terminal: vscode.Terminal | null = null;
	history: Exec[] = [];	
}

class TerminalPayload {
	id: number = -1;
	name?: string;
	history?: HistoryPayload[];
}

class HistoryPayload {
	cmd?: any;
	cwd?: string;
	out?: string;
	exit?: number;
}

It listens to:

onDidStartTerminalShellExecution

onDidEndTerminalShellExecution

read()

from the execution stream to capture output.

Environment Synchronization (

env.ts

)

Broadcasts information about the environment.

async function broadcastEnv(context: vscode.ExtensionContext) {
	const wsF = vscode.workspace.workspaceFolders
	var wDir: string | undefined
	if (wsF && wsF.length > 0) {
		wDir = wsF[0].uri.path	
	}
	const sid = context.workspaceState.get("sid")

	const msg = {
		type: "env.info.resp",
		payload: {
			sid,
			machineId: vscode.env.machineId,
			vscodeSid: vscode.env.sessionId,
			remoteName: vscode.env.remoteName,
			user: "verdverm",
		  workspaceDir: wDir,
			clipboard: await vscode.env.clipboard.readText(),
		}
	}
	extensionEmitter.fire(msg);
	sendMessage(msg)
}

Synchronization Subsystem (`src/sync`)

Synchronization Subsystem (
`src/sync`
)

Core Components

Legacy/Unused Components

Terminal Tracking Details (
`terminals.ts`
)

Environment Synchronization (
`env.ts`
)

Related Skills

Nano Banana Pro

Markdown Converter

1password

Synchronization Subsystem (
`src/sync`
)

Core Components

Legacy/Unused Components

Terminal Tracking Details (
`terminals.ts`
)

Environment Synchronization (
`env.ts`
)