Class VcsCoordinator

Orchestrates VCS across all VCS-enabled watch roots.

Index

Constructors

Methods

findManagerForPath getAllManagers getManager getRoots onFileChange onInitialScanComplete start stop

Constructors

constructor

new VcsCoordinator(config: JeevesWatcherConfig, logger: Logger): VcsCoordinator
Parameters
- config: JeevesWatcherConfig
- logger: Logger
Returns VcsCoordinator
- Defined in packages/service/src/vcs/VcsCoordinator.ts:34

Methods

findManagerForPath

findManagerForPath(normalizedPath: string): VcsManager | undefined
Find the VcsManager that owns the given normalized file path. Uses longest-prefix-match against resolved watch roots.
Parameters
- normalizedPath: string
  Normalized absolute path (forward slashes).
Returns VcsManager | undefined
The matching VcsManager, or undefined.
- Defined in packages/service/src/vcs/VcsCoordinator.ts:204

getAllManagers

getAllManagers(): ReadonlyMap<string, VcsManager>
Get all managers as [root, manager] pairs.

Returns ReadonlyMap<string, VcsManager>
- Defined in packages/service/src/vcs/VcsCoordinator.ts:193

getManager

getManager(root: string): VcsManager | undefined
Get the VcsManager for a specific root path.
Parameters
- root: string
Returns VcsManager | undefined
- Defined in packages/service/src/vcs/VcsCoordinator.ts:186

getRoots

getRoots(): readonly string[]
Get the sorted root paths (longest-first).

Returns readonly string[]
- Defined in packages/service/src/vcs/VcsCoordinator.ts:179

onFileChange

onFileChange(filePath: string, event: "add" | "change" | "unlink"): void
Route a file event to the correct root's VcsManager.
Parameters
- filePath: string
  Absolute path of the changed file.
- event: "add" | "change" | "unlink"
  The event type: add, change, or unlink.
Returns void
- Defined in packages/service/src/vcs/VcsCoordinator.ts:128

onInitialScanComplete

onInitialScanComplete(): Promise<void>
Signal that the initial filesystem scan is complete.

Flushes each manager's throttle buffer before ending baseline mode, ensuring any files still pending in the VCS throttle are committed with a "baseline:" prefix rather than "watcher:". AI generation is not enabled until all managers have completed their flush.

Returns Promise<void>
- Defined in packages/service/src/vcs/VcsCoordinator.ts:148

start

start(): Promise<void>
Start all VcsManager instances. Runs startup orphan detection/recovery for each root.

Returns Promise<void>
- Defined in packages/service/src/vcs/VcsCoordinator.ts:110

stop

stop(): Promise<void>
Flush all managers and clean up.

Returns Promise<void>
- Defined in packages/service/src/vcs/VcsCoordinator.ts:167