@memoarchitect/tools 0.12.0 → 0.13.0

package/packages/tools/lib/server/dashboard-store.d.ts

@@ -0,0 +1,28 @@
+import type { DashboardDTO, DashboardScope } from '@memoarchitect/tools';
+export declare const DASHBOARD_SCOPES: readonly DashboardScope[];
+/** The ignore rule for user dashboards, as written into `.gitignore`. */
+export declare const USER_DASHBOARDS_IGNORE = "dashboards/user/";
+/** Directory holding one scope's dashboard files. */
+export declare function dashboardDir(projectRoot: string, scope: DashboardScope): string;
+/**
+ * Make sure the project's `.gitignore` keeps user dashboards out of git.
+ *
+ * Appends one line, never rewrites the file. Already covered is judged by an
+ * exact line match on the common spellings; anything cleverer is the user's
+ * own rule to keep.
+ */
+export declare function ensureUserDashboardsIgnored(projectRoot: string): void;
+/** Frontmatter `title`, else the first `#` heading, else the id. */
+export declare function dashboardTitle(content: string, id: string): string;
+/** Every dashboard in both scopes, shared first, each sorted by title. */
+export declare function loadDashboards(projectRoot: string): DashboardDTO[];
+export declare function saveDashboard(projectRoot: string, scope: DashboardScope, id: string, content: string): string;
+export declare function deleteDashboard(projectRoot: string, scope: DashboardScope, id: string): boolean;
+/**
+ * Move a dashboard between scopes.
+ *
+ * Refuses to overwrite: sharing a user page onto a shared one of the same id
+ * would destroy the team's copy, and that must be a deliberate delete first.
+ */
+export declare function moveDashboard(projectRoot: string, id: string, from: DashboardScope, to: DashboardScope): string;
+//# sourceMappingURL=dashboard-store.d.ts.map

package/packages/tools/lib/server/dashboard-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-store.d.ts","sourceRoot":"","sources":["../../src/server/dashboard-store.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAAuB,CAAC;AAE9E,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AA8BzD,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAI/E;AAwBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAOrE;AAaD,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CA4BlE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ7G;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAO/F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,MAAM,CAY/G"}

package/packages/tools/lib/server/dashboard-store.js

@@ -0,0 +1,199 @@
+// ─── Dashboard Store ─────────────────────────────────────────────────────────
+//
+// File-backed persistence for custom dashboards. A dashboard is one markdown
+// file and nothing else — no index, no settings entry — so a dashboard exists
+// because its file exists, and a `git pull` or a hand edit is a complete way
+// to add one.
+//
+//   shared   <projectRoot>/dashboards/<id>.md        committed with the project
+//   user     <projectRoot>/dashboards/user/<id>.md   one person's, never committed
+//
+// The user folder is visible on purpose — a hidden directory is somewhere people
+// lose work. It is kept out of git by a `dashboards/user/` line in the project's
+// own `.gitignore`, which the store adds the first time it writes a user
+// dashboard, and `dashboards/README.md` says what the two folders are for.
+//
+// Dashboards are presentation, not model: they sit outside the SysML include
+// roots and outside viewpoint packages, and only reference views by id.
+//
+// Design: plans/memo-custom-dashboards.md.
+// ─────────────────────────────────────────────────────────────────────────────
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { relative, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export const DASHBOARD_SCOPES = ['shared', 'user'];
+/** The ignore rule for user dashboards, as written into `.gitignore`. */
+export const USER_DASHBOARDS_IGNORE = 'dashboards/user/';
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+const ID_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+/** Files in a dashboard folder that document it rather than being a dashboard. */
+const NOT_DASHBOARDS = new Set(['readme.md']);
+const README = `# Dashboards
+
+Markdown pages with live diagrams, opened in MEMO Architect under **Dashboards**.
+
+| Folder | Who sees it | In git? |
+| --- | --- | --- |
+| \`dashboards/\` | everyone on the project | committed |
+| \`dashboards/user/\` | only you, on this machine | ignored — listed in \`.gitignore\` |
+
+Each \`.md\` file is one dashboard; its file name is its id. Every viewpoint
+also has a generated dashboard until a file named
+\`viewpoint-<viewpoint id>.md\` replaces it.
+
+Embed a live, read-only diagram with a directive on its own line:
+
+    {{diagram:<view id or name>}}
+    {{diagram:<view id or name> height=640}}
+
+A file in \`dashboards/user/\` with the same name as one in \`dashboards/\`
+replaces it for you only. **Share** in the app moves a user dashboard up into
+\`dashboards/\`.
+`;
+/** Directory holding one scope's dashboard files. */
+export function dashboardDir(projectRoot, scope) {
+    return scope === 'shared'
+        ? resolve(projectRoot, 'dashboards')
+        : resolve(projectRoot, 'dashboards', 'user');
+}
+function assertScope(scope) {
+    if (scope !== 'shared' && scope !== 'user') {
+        throw new Error(`Unknown dashboard scope "${String(scope)}" — expected "shared" or "user".`);
+    }
+}
+/**
+ * Refuse, rather than rewrite, an id that is not a plain filename stem.
+ *
+ * Silently sanitizing would let two different ids land on one file, and a
+ * dashboard saved under an id the user did not type is one they cannot find.
+ */
+function assertId(id) {
+    if (typeof id !== 'string' || !ID_RE.test(id) || NOT_DASHBOARDS.has(`${id.toLowerCase()}.md`)) {
+        throw new Error(`Invalid dashboard id "${String(id)}" — use letters, digits, ".", "_" or "-", starting with a letter or digit.`);
+    }
+}
+function filePath(projectRoot, scope, id) {
+    return resolve(dashboardDir(projectRoot, scope), `${id}.md`);
+}
+/**
+ * Make sure the project's `.gitignore` keeps user dashboards out of git.
+ *
+ * Appends one line, never rewrites the file. Already covered is judged by an
+ * exact line match on the common spellings; anything cleverer is the user's
+ * own rule to keep.
+ */
+export function ensureUserDashboardsIgnored(projectRoot) {
+    const path = resolve(projectRoot, '.gitignore');
+    const existing = existsSync(path) ? readFileSync(path, 'utf8') : '';
+    const spellings = new Set([USER_DASHBOARDS_IGNORE, 'dashboards/user', '/dashboards/user/', '/dashboards/user']);
+    if (existing.split(/\r?\n/).some(line => spellings.has(line.trim())))
+        return;
+    const lead = existing === '' || existing.endsWith('\n') ? '' : '\n';
+    writeFileSync(path, `${existing}${lead}\n# MEMO Architect: personal dashboards\n${USER_DASHBOARDS_IGNORE}\n`, 'utf8');
+}
+function ensureDir(projectRoot, scope) {
+    const shared = dashboardDir(projectRoot, 'shared');
+    if (!existsSync(shared))
+        mkdirSync(shared, { recursive: true });
+    const readme = resolve(shared, 'README.md');
+    if (!existsSync(readme))
+        writeFileSync(readme, README, 'utf8');
+    const dir = dashboardDir(projectRoot, scope);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    if (scope === 'user')
+        ensureUserDashboardsIgnored(projectRoot);
+    return dir;
+}
+/** Frontmatter `title`, else the first `#` heading, else the id. */
+export function dashboardTitle(content, id) {
+    const m = content.match(FRONTMATTER_RE);
+    if (m) {
+        try {
+            const meta = parseYaml(m[1]);
+            if (meta && typeof meta.title === 'string' && meta.title.trim())
+                return meta.title.trim();
+        }
+        catch { /* malformed frontmatter falls through to the heading */ }
+    }
+    const body = m ? content.slice(m[0].length) : content;
+    const heading = body.match(/^#\s+(.+)$/m);
+    return heading ? heading[1].trim() : id;
+}
+/** Every dashboard in both scopes, shared first, each sorted by title. */
+export function loadDashboards(projectRoot) {
+    const out = [];
+    for (const scope of DASHBOARD_SCOPES) {
+        const dir = dashboardDir(projectRoot, scope);
+        if (!existsSync(dir))
+            continue;
+        const inScope = [];
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isFile() || !entry.name.endsWith('.md'))
+                continue;
+            if (NOT_DASHBOARDS.has(entry.name.toLowerCase()))
+                continue;
+            const id = entry.name.slice(0, -3);
+            if (!ID_RE.test(id))
+                continue;
+            const full = resolve(dir, entry.name);
+            try {
+                const content = readFileSync(full, 'utf8');
+                inScope.push({
+                    id,
+                    scope,
+                    title: dashboardTitle(content, id),
+                    content,
+                    path: relative(projectRoot, full),
+                    updatedAt: statSync(full).mtimeMs,
+                });
+            }
+            catch { /* an unreadable file is skipped, not fatal */ }
+        }
+        inScope.sort((a, b) => a.title.localeCompare(b.title) || a.id.localeCompare(b.id));
+        out.push(...inScope);
+    }
+    return out;
+}
+export function saveDashboard(projectRoot, scope, id, content) {
+    assertScope(scope);
+    assertId(id);
+    if (typeof content !== 'string')
+        throw new Error('Dashboard content must be a string.');
+    ensureDir(projectRoot, scope);
+    const path = filePath(projectRoot, scope, id);
+    writeFileSync(path, content, 'utf8');
+    return relative(projectRoot, path);
+}
+export function deleteDashboard(projectRoot, scope, id) {
+    assertScope(scope);
+    assertId(id);
+    const path = filePath(projectRoot, scope, id);
+    if (!existsSync(path))
+        return false;
+    unlinkSync(path);
+    return true;
+}
+/**
+ * Move a dashboard between scopes.
+ *
+ * Refuses to overwrite: sharing a user page onto a shared one of the same id
+ * would destroy the team's copy, and that must be a deliberate delete first.
+ */
+export function moveDashboard(projectRoot, id, from, to) {
+    assertScope(from);
+    assertScope(to);
+    assertId(id);
+    if (from === to)
+        return relative(projectRoot, filePath(projectRoot, from, id));
+    const source = filePath(projectRoot, from, id);
+    if (!existsSync(source))
+        throw new Error(`No ${from} dashboard "${id}".`);
+    const target = filePath(projectRoot, to, id);
+    if (existsSync(target))
+        throw new Error(`A ${to} dashboard "${id}" already exists — delete or rename it first.`);
+    ensureDir(projectRoot, to);
+    renameSync(source, target);
+    return relative(projectRoot, target);
+}
+//# sourceMappingURL=dashboard-store.js.map

package/packages/tools/lib/server/dashboard-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-store.js","sourceRoot":"","sources":["../../src/server/dashboard-store.ts"],"names":[],"mappings":"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"}

package/packages/tools/lib/server/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/server/dev-server.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,aAAa,EAM6B,sBAAsB,EAChE,sBAAsB,EAEzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA2B9D,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,kEAAkE;IAClE,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,SAAS;IACtB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACjF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACxC,mEAAmE;IACnE,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;QAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,uEAAuE;IACvE,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACrD;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACrE,KAAK,IAAI,IAAI,CAAC;CACjB;AAaD,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO3D;AAqED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtG;AAiCD,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2lEnF"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/server/dev-server.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,aAAa,EAM6B,sBAAsB,EAChE,sBAAsB,EAEzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA6B9D,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,kEAAkE;IAClE,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,SAAS;IACtB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACjF;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IACxC,mEAAmE;IACnE,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG;QAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,uEAAuE;IACvE,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACrD;;;;;;;OAOG;IACH,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IACrE,KAAK,IAAI,IAAI,CAAC;CACjB;AAaD,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAO3D;AAqED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtG;AAiCD,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqoEnF"}

package/packages/tools/lib/server/dev-server.js

@@ -23,6 +23,8 @@ import { loadViewLayouts, saveViewLayout } from './view-layout-store.js';
 import { updateViewExpose, writeViewDeclaration } from './view-writer.js';
 import { usageKeyword } from '../model/semantic.js';
 import { loadDhfDocs, saveDhfDoc, deleteDhfDoc, loadDhfSettings, saveDhfSettings, listRepoTemplates, readRepoTemplate, saveRepoTemplate, } from './dhf-doc-store.js';
+import { loadDashboards, saveDashboard, deleteDashboard, moveDashboard } from './dashboard-store.js';
+import { createDashboardWatcher } from './file-watcher.js';
 const MODEL_MUTATION_MESSAGES = new Set([
     'element:update', 'element:create', 'element:delete', 'element:remap-kinds', 'element:move-package',
     'package:create', 'package:rename', 'package:delete', 'package:move',
@@ -384,6 +386,21 @@ export async function createDevServer(options) {
     const { WebSocketServer } = await import('ws');
     const wss = new WebSocketServer({ server });
     const clients = new Set();
+    const broadcastDashboards = () => {
+        let message;
+        try {
+            message = JSON.stringify({ type: 'dashboards', payload: { dashboards: loadDashboards(options.projectRoot) } });
+        }
+        catch (e) {
+            console.error('[Dashboards] reload failed:', e);
+            return;
+        }
+        for (const client of clients) {
+            if (client.readyState === 1)
+                client.send(message);
+        }
+    };
+    const dashboardWatcher = createDashboardWatcher(options.projectRoot, broadcastDashboards);
     // Every view is DECLARED in SysML — see `view-writer.ts`. The sidecar at
     // .memo/user-diagrams.json used to be merged in here as a second class of
     // view, which is how a view could exist for Architect and for nothing else:
@@ -1117,6 +1134,13 @@ export async function createDevServer(options) {
         if (Object.keys(layouts).length > 0) {
             ws.send(JSON.stringify({ type: 'diagram:layout', payload: { layouts } }));
         }
+        // Send custom dashboards on connect
+        try {
+            ws.send(JSON.stringify({ type: 'dashboards', payload: { dashboards: loadDashboards(options.projectRoot) } }));
+        }
+        catch (e) {
+            console.error('[Dashboards] initial load failed:', e);
+        }
         // Send persisted DHF documents and settings on connect
         try {
             const docs = loadDhfDocs(options.projectRoot);
@@ -2115,6 +2139,30 @@ Return ONLY a JSON array of strings. Each string is a concise, actionable sugges
                         ws.send(JSON.stringify({ type: 'llm:suggest:result', payload: { requestId, error: e?.message ?? String(e) } }));
                     }
                 }
+                else if (msg.type === 'dashboard:save' || msg.type === 'dashboard:delete' || msg.type === 'dashboard:move') {
+                    // Dashboards are presentation, not model source: they are
+                    // deliberately absent from MODEL_MUTATION_MESSAGES, so a
+                    // typo in the SysML never stops a user writing notes.
+                    const p = msg.payload ?? {};
+                    try {
+                        if (msg.type === 'dashboard:save') {
+                            saveDashboard(options.projectRoot, p.dashboard?.scope, p.dashboard?.id, p.dashboard?.content);
+                        }
+                        else if (msg.type === 'dashboard:delete') {
+                            deleteDashboard(options.projectRoot, p.scope, p.id);
+                        }
+                        else {
+                            moveDashboard(options.projectRoot, p.id, p.from, p.to);
+                        }
+                        ws.send(JSON.stringify({ type: 'dashboard:result', payload: { requestId: p.requestId, ok: true } }));
+                        // Answer at once rather than waiting on the watcher's
+                        // debounce, so the writer sees its own save immediately.
+                        broadcastDashboards();
+                    }
+                    catch (e) {
+                        ws.send(JSON.stringify({ type: 'dashboard:result', payload: { requestId: p.requestId, ok: false, error: e?.message ?? String(e) } }));
+                    }
+                }
                 else if (msg.type === 'dhf:docs:load') {
                     const docs = loadDhfDocs(options.projectRoot);
                     ws.send(JSON.stringify({ type: 'dhf:docs', payload: { docs } }));
@@ -2295,6 +2343,7 @@ Return ONLY a JSON array of strings. Each string is a concise, actionable sugges
             }
         },
         close() {
+            dashboardWatcher.close();
             wss.close();
             viteServer?.close();
             server.close();