chore: linting and e2e tests

Author: saberzero1

eslint.config.mts

@@ -28,6 +28,7 @@ export default defineConfig(
 			globals: {
 				...globals.browser,
 				Buffer: "readonly",
+				__DEV__: "readonly",
 			},
 			parserOptions: {
 				projectService: {
@@ -85,15 +86,24 @@ export default defineConfig(
 						"Dataview",
 						"Excalidraw",
 						"Fantasy Statblocks",
+						"github.com",
 						"GitHub",
 						"GitHub Pages",
 						"GitHub Pro",
 						"GitLab",
 						"Gitea",
+						"https:",
 						"IndexedDB",
 						"Obsidian",
+						"Publication Center",
 						"Quartz",
+						"Quartz Hub",
 						"Quartz Syncer",
+						"Settings → Core plugins",
+						"Web Viewer",
+						"quartz.git",
+						"v4",
+						"v5",
 					],
 				},
 			],

src/cli/handlers/markHandler.ts

@@ -51,7 +51,7 @@ export function createMarkHandler(_plugin: QuartzSyncer): CliHandler {
 					normalizeFuzzy(file.basename).includes(normalizedQuery),
 				);
 		} else if (isGlob) {
-			const unsupported = /[?{}\[\]!]/.test(pathArg);
+			const unsupported = /[?{}[\]!]/.test(pathArg);
 			if (unsupported) {
 				return {
 					success: false,

src/main.ts

@@ -33,6 +33,7 @@ import { StatusBar, type StatusBarState } from "src/views/StatusBar";
 import { OperabilityFacadeImpl } from "src/operability/OperabilityFacade";
 import { EventBuffer } from "src/operability/EventBuffer";
 import { PublicationCenterManager } from "src/operability/PublicationCenterManager";
+import { QuartzHubManager } from "src/operability/QuartzHubManager";
 
 /**
  * QuartzSyncer plugin settings.
@@ -181,6 +182,7 @@ export default class QuartzSyncer extends Plugin {
 	private operabilityFacade: OperabilityFacadeImpl | null = null;
 	private eventSink: EventBuffer | null = null;
 	private publicationCenterManager: PublicationCenterManager | null = null;
+	private quartzHubManager: QuartzHubManager | null = null;
 	processRunner: ProcessRunner | null = null;
 	binaryDetector: BinaryDetector | null = null;
 	gitRunner: GitRunner | null = null;
@@ -220,7 +222,7 @@ export default class QuartzSyncer extends Plugin {
 
 		this.addCommands();
 		this.cliHandlers = registerCliHandlers(this);
-		this.addRibbonIcon("leaf", "Quartz Syncer publication center", () => {
+		this.addRibbonIcon("leaf", "Quartz Syncer Publication Center", () => {
 			this.publicationCenterManager?.open() ??
 				new PublicationCenter(this.app, this).open();
 		});
@@ -295,6 +297,10 @@ export default class QuartzSyncer extends Plugin {
 			this.quartzRunner = new QuartzRunner(this.processRunner);
 		}
 
+		if (Platform.isDesktopApp) {
+			this.quartzHubManager = new QuartzHubManager(this.app, this);
+		}
+
 		if (Platform.isDesktopApp && this.settings.autoPublishInterval > 0) {
 			this.backgroundEngine.startAutoPublish(
 				this.settings.autoPublishInterval,
@@ -320,6 +326,7 @@ export default class QuartzSyncer extends Plugin {
 		this.operabilityFacade = null;
 		this.eventSink = null;
 		this.publicationCenterManager = null;
+		this.quartzHubManager = null;
 		this.publisher?.stopPeriodicFetch();
 		this.backgroundEngine?.stopAutoPublish();
 		this.backgroundEngine?.stop();
@@ -627,6 +634,10 @@ export default class QuartzSyncer extends Plugin {
 		return this.publicationCenterManager;
 	}
 
+	getQuartzHubManager(): QuartzHubManager | null {
+		return this.quartzHubManager;
+	}
+
 	getEngineStatus(): {
 		running: boolean;
 		pending: number;
@@ -642,7 +653,7 @@ export default class QuartzSyncer extends Plugin {
 	private addCommands(): void {
 		this.addCommand({
 			id: "open-publish-modal",
-			name: "Open publication center",
+			name: "Open Publication Center",
 			callback: () => {
 				this.publicationCenterManager?.open() ??
 					new PublicationCenter(this.app, this).open();
@@ -657,6 +668,13 @@ export default class QuartzSyncer extends Plugin {
 					new OnboardingWizard(this.app, this).open();
 				},
 			});
+			this.addCommand({
+				id: "open-hub",
+				name: "Open Quartz Hub",
+				callback: () => {
+					this.quartzHubManager?.open();
+				},
+			});
 		}
 
 		this.addCommand({

src/operability/ActionRegistry.ts

@@ -14,6 +14,7 @@ import { LocalFileSource } from "src/quartz/LocalFileSource";
 import { QuartzVersionDetector } from "src/quartz/QuartzVersionDetector";
 import { getValueByPath, setValueByPath } from "src/cli/handlers/cliUtils";
 import type { PublicationCenterManager } from "src/operability/PublicationCenterManager";
+import type { QuartzHubManager } from "src/operability/QuartzHubManager";
 
 type PublishStatusSummary = {
 	unpublished: number;
@@ -42,6 +43,7 @@ export class ActionRegistry {
 		private getPublicationService: () => PublicationService | null,
 		private getOnboardingService: () => OnboardingService | null,
 		private getPublicationCenterManager: () => PublicationCenterManager | null,
+		private getQuartzHubManager: () => QuartzHubManager | null,
 	) {}
 
 	getPublishStatusSummary(): PublishStatusSummary | null {
@@ -103,6 +105,22 @@ export class ActionRegistry {
 				return this.selectAllPublicationPaths();
 			case "pub.deselectAll":
 				return this.deselectAllPublicationPaths();
+			case "hub.open":
+				return this.openQuartzHub();
+			case "hub.close":
+				return this.closeQuartzHub();
+			case "hub.setup.link":
+				return this.withLock(() =>
+					this.linkLocalRepo(action.params.path),
+				);
+			case "hub.setup.clone":
+				return this.withLock(() =>
+					this.cloneAndLinkRepo(
+						action.params.url,
+						action.params.dest,
+						action.params.confirm,
+					),
+				);
 			case "onboarding.start":
 			case "onboarding.setToken":
 			case "onboarding.createRepo":
@@ -248,7 +266,7 @@ export class ActionRegistry {
 	private openPublicationCenter(): ActionResult {
 		const manager = this.getPublicationCenterManager();
 		if (!manager) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
 		}
 		manager.open();
 		return { success: true };
@@ -257,16 +275,111 @@ export class ActionRegistry {
 	private closePublicationCenter(): ActionResult {
 		const manager = this.getPublicationCenterManager();
 		if (!manager) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
+		}
+		manager.close();
+		return { success: true };
+	}
+
+	private openQuartzHub(): ActionResult {
+		const manager = this.getQuartzHubManager();
+		if (!manager) {
+			return { success: false, error: "Quartz Hub unavailable" };
+		}
+		manager.open();
+		return { success: true };
+	}
+
+	private closeQuartzHub(): ActionResult {
+		const manager = this.getQuartzHubManager();
+		if (!manager) {
+			return { success: false, error: "Quartz Hub unavailable" };
 		}
 		manager.close();
 		return { success: true };
 	}
 
+	private async linkLocalRepo(path: string): Promise<ActionResult> {
+		if (!path) {
+			return { success: false, error: "Path is required" };
+		}
+
+		const trimmed = path.trim();
+		const { QuartzHubService } =
+			await import("src/services/QuartzHubService");
+		const service = new QuartzHubService(this.plugin);
+		const validation = service.validateRepoPath(trimmed);
+
+		if (!validation.ok) {
+			return { success: false, error: validation.message };
+		}
+
+		this.plugin.settings.quartzRepoPath = trimmed;
+		this.plugin.settings.enableSystemCommands = true;
+		await this.plugin.saveSettings();
+
+		return { success: true, data: { path: trimmed } };
+	}
+
+	private async cloneAndLinkRepo(
+		url: string,
+		dest: string,
+		confirm: true | undefined,
+	): Promise<ActionResult> {
+		if (!confirm) {
+			return { success: false, error: "Confirmation required" };
+		}
+
+		if (!url || !dest) {
+			return {
+				success: false,
+				error: "URL and destination path are required",
+			};
+		}
+
+		const gitRunner = this.plugin.gitRunner;
+		const npmRunner = this.plugin.npmRunner;
+
+		if (!gitRunner) {
+			return { success: false, error: "Git runner unavailable" };
+		}
+
+		if (!npmRunner) {
+			return { success: false, error: "Npm runner unavailable" };
+		}
+
+		const parentDir = dest.substring(0, dest.lastIndexOf("/")) || "/";
+		const dirName = dest.substring(dest.lastIndexOf("/") + 1);
+
+		const cloneResult = await gitRunner.clone(url, dirName, {
+			cwd: parentDir,
+		});
+		if (!cloneResult.ok) {
+			return {
+				success: false,
+				error: `Clone failed: ${cloneResult.error}`,
+			};
+		}
+
+		const installResult = await npmRunner.install({ cwd: dest });
+		if (!installResult.ok) {
+			return {
+				success: false,
+				error: `npm install failed: ${installResult.error}`,
+			};
+		}
+
+		this.plugin.settings.quartzRepoPath = dest;
+		this.plugin.settings.enableSystemCommands = true;
+		await this.plugin.saveSettings();
+
+		return { success: true, data: { path: dest } };
+	}
+
 	private selectPublicationPaths(paths: string[]): ActionResult {
 		const controller = this.getPublicationCenterController();
 		if (!controller) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
 		}
 		controller.setSelected(paths);
 		return { success: true };
@@ -275,7 +388,7 @@ export class ActionRegistry {
 	private deselectPublicationPaths(paths: string[]): ActionResult {
 		const controller = this.getPublicationCenterController();
 		if (!controller) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
 		}
 		const remaining = new Set(controller.getSelected());
 		for (const path of paths) {
@@ -288,7 +401,7 @@ export class ActionRegistry {
 	private selectAllPublicationPaths(): ActionResult {
 		const controller = this.getPublicationCenterController();
 		if (!controller) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
 		}
 		controller.selectAll();
 		return { success: true };
@@ -297,7 +410,7 @@ export class ActionRegistry {
 	private deselectAllPublicationPaths(): ActionResult {
 		const controller = this.getPublicationCenterController();
 		if (!controller) {
-			return { success: false, error: "Publication center unavailable" };
+			return { success: false, error: "Publication Center unavailable" };
 		}
 		controller.deselectAll();
 		return { success: true };

src/operability/Assertions.ts

@@ -395,7 +395,7 @@ function parseExpectedCounts(
 	const expected: Partial<Record<CountKey, number>> = {};
 
 	for (const key of COUNT_KEYS) {
-		const value = (candidate as Record<string, unknown>)[key];
+		const value = candidate[key];
 		if (typeof value === "number") {
 			expected[key] = value;
 		}

src/operability/DomContract.ts

@@ -18,7 +18,18 @@ export type QSDomRole =
 	| "settings-test-btn"
 	| "settings-test-result"
 	| "notice"
-	| "diff-view";
+	| "diff-view"
+	| "hub"
+	| "hub-tab"
+	| "hub-status"
+	| "hub-action"
+	| "hub-path"
+	| "hub-serve-status"
+	| "hub-setup-link"
+	| "hub-setup-link-path"
+	| "hub-setup-clone"
+	| "hub-setup-clone-url"
+	| "hub-setup-clone-dest";
 
 /**
  * Generates stable DOM attributes for the operability DOM contract.

src/operability/OperabilityFacade.ts

@@ -33,6 +33,7 @@ export class OperabilityFacadeImpl implements IOperabilityFacade {
 			() => this.getPublicationService(),
 			() => this.getOnboardingService(),
 			() => plugin.getPublicationCenterManager(),
+			() => plugin.getQuartzHubManager(),
 		);
 
 		this.eventBuffer.emit("plugin.loaded", {
@@ -83,7 +84,9 @@ export class OperabilityFacadeImpl implements IOperabilityFacade {
 		while (Date.now() < deadline) {
 			const result = this.assert(condition, params);
 			if (result.pass) return result;
-			await new Promise((resolve) => setTimeout(resolve, interval));
+			await new Promise((resolve) =>
+				window.setTimeout(resolve, interval),
+			);
 		}
 
 		return {