fix: repair broken IPC wiring and cut the cost of repository polling

Three handlers referenced a dependency they were never given, which made them
throw a ReferenceError as soon as they ran:

- deployment:preflight for Gitea Actions profiles (`preflight` was passed to
  registerOperationsIpc but not to registerDeploymentIpc)
- Unraid write-access repair (`safeRelativeRemoteFile` was missing from
  createUnraidAccessMethods)
- a dead reference of the same name in unraid-state-methods

no-undef and no-unused-vars were disabled for every file, which is why none of
these were caught. Both are now enabled for src/main and src/shared, where the
dependency graph is explicit. The renderer keeps them off because its functions
are deliberately cross-script globals.

Performance:

- git.status() spawned three processes (rev-parse, status, remote get-url) per
  call. A directory holding its own .git is by definition the work tree root, so
  rev-parse is unnecessary, and the remote URL is cached against the mtime of
  .git/config, including the failure for a repository without that remote.
- git status runs with --no-optional-locks so a read no longer rewrites the
  index. That stops it fighting a concurrent Git command for the index lock, and
  is what makes filesystem watching viable at all.
- One commit issued four `git status` reads; callers that already hold the
  status now pass it on, leaving two.
- The repository monitor is event driven. A watched repository is read on
  filesystem activity, with a 30s safety net for watchers that stop delivering
  and a 1s floor so a busy tree cannot drive a read per event. Repositories that
  cannot be watched keep using the interval. Idle cost for one repository over
  35s: 24 git processes before, 3 after.
- Resolving one repository by name no longer refreshes the whole workspace.
- Concurrent configuration saves share a single write of the latest state.
- Repository discovery follows directory junctions again. The filter that
  skipped them made the realpath cycle guard dead code, and hid any project
  folder reached through a junction.

Renderer:

- render() replaced the whole shell on every poll, discarding focus, caret and
  scroll position while the user was typing. Those are preserved now, and an
  unchanged render leaves the DOM alone entirely.
- The four sections that enhanceRenderedUi() injected after render moved into
  the views, so the rendered markup is the single source of truth.
- The monitor no longer keeps a repository paused forever when it is unlinked
  mid-mutation, scheduleAutoRefresh honours its delay argument, the demo bridges
  no longer block startup, and #app is no longer an aria-live region announcing
  the entire UI on every render.

IPC channel plumbing moved to src/main/ipc/channel.cjs, replacing a module-level
mutable diagnostics singleton with an argument.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
NuklearRabbit
2026-08-23 14:31:58 +02:00
co-authored by Claude Opus 5
parent cf1da8a2fa
commit 9260d35957
21 changed files with 858 additions and 147 deletions
+71
View File
@@ -80,6 +80,24 @@ test('repository discovery is bounded, skips generated trees and ignores inacces
assert.ok(all.includes(found[0]));
});
test('a repository reached through a directory junction is discovered once', async (context) => {
const root = await mkdtemp(path.join(os.tmpdir(), 'forgeflow-junction-'));
context.after(() => import('node:fs/promises').then(({ rm }) => rm(root, { recursive: true, force: true })));
const elsewhere = path.join(root, 'elsewhere', 'service');
await mkdir(path.join(elsewhere, '.git'), { recursive: true });
await mkdir(path.join(root, 'workspace'), { recursive: true });
try {
await symlink(elsewhere, path.join(root, 'workspace', 'linked-service'), 'junction');
} catch {
context.skip('this platform does not allow creating directory links');
return;
}
const { realpath } = await import('node:fs/promises');
const found = await service().discoverInRoot(path.join(root, 'workspace'), 3);
assert.deepEqual(found, [await realpath(elsewhere)]);
});
test('local descriptors preserve Git failures and watch paths are defensive copies', async () => {
const instance = new RepositoryService({ data: {} }, {
status: async (localPath) => {
@@ -133,6 +151,59 @@ test('refresh links explicit and remote-matched repositories and retains unmatch
assert.equal(diagnostics[0][0], 'repositories.refresh.completed');
});
test('resolving one repository reads only that repository, not the whole workspace', async () => {
const scanned = [];
const store = {
data: {
gitea: { baseUrl: 'https://gitea.example' },
workspaceRoots: ['root'],
repositoryMappings: { 'jens/portfolio': 'C:/explicit' },
preferences: { preferredCloneProtocol: 'https' },
favorites: []
},
getToken: () => 'token',
getDeploymentProfiles: () => [{ id: 'prod', branch: 'main' }],
getDeploymentState: () => ({ liveSha: null, healthy: null })
};
const instance = new RepositoryService(store, {
status: async (localPath) => {
scanned.push(localPath);
return { ...status(), root: localPath, remoteUrl: remote.clone_url };
}
}, { listRepositories: async () => [remote, { ...remote, id: 2, full_name: 'Jens/Other', name: 'Other' }] });
instance.discoverAll = async () => ['C:/explicit', 'C:/other', 'C:/third'];
await instance.refresh();
const duringRefresh = scanned.length;
assert.equal(duringRefresh, 3);
scanned.length = 0;
const resolved = await instance.resolveByFullName(remote.full_name);
assert.equal(resolved.fullName, remote.full_name);
assert.equal(resolved.localPath, 'C:/explicit');
assert.equal(resolved.deploymentProfiles[0].id, 'prod');
assert.deepEqual(scanned, ['C:/explicit']);
assert.equal(await instance.resolveByFullName(''), null);
});
test('resolving an unknown repository still falls back to a full refresh', async () => {
const store = {
data: { gitea: { baseUrl: 'https://gitea.example' }, workspaceRoots: [], repositoryMappings: {}, preferences: { preferredCloneProtocol: 'https' }, favorites: [] },
getToken: () => 'token',
getDeploymentProfiles: () => [],
getDeploymentState: () => null
};
const instance = new RepositoryService(store, {
status: async (localPath) => ({ ...status(), root: localPath, remoteUrl: '' })
}, { listRepositories: async () => [remote] });
instance.discoverAll = async () => ['C:/loose-checkout'];
const local = await instance.resolveByFullName('loose-checkout');
assert.equal(local.linkState, 'unmatched-local');
assert.equal(await instance.resolveByFullName('Jens/Missing'), null);
});
test('refresh remains local-only without configured Gitea credentials', async () => {
const store = {
data: { gitea: { baseUrl: '' }, workspaceRoots: [], repositoryMappings: {}, preferences: { preferredCloneProtocol: 'ssh' }, favorites: [] },