@venturewild/workspace 0.1.0 → 0.1.2

package/server/src/inbox.mjs

@@ -1,81 +1,86 @@
-// Component System inbox surfacing.
-// When `.wild/inbox.md` exists or changes, emit notifications.
-// Drives the "I noticed you imported X — want me to walk integration?" cue in chat.
-
-import fs from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import chokidar from 'chokidar';
-import { EventEmitter } from 'node:events';
-
-export class InboxWatcher extends EventEmitter {
-  constructor(workspaceDir) {
-    super();
-    this.workspaceDir = workspaceDir;
-    this.inboxPath = path.join(workspaceDir, '.wild', 'inbox.md');
-    this.installedPath = path.join(workspaceDir, '.wild', 'installed.json');
-    this.watcher = null;
-  }
-
-  start() {
-    this.watcher = chokidar.watch(
-      [this.inboxPath, this.installedPath, path.join(this.workspaceDir, '.wild', 'imports')],
-      {
-        ignoreInitial: false,
-        persistent: true,
-        depth: 3,
-        awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 100 },
-      },
-    );
-    this.watcher.on('add', () => this._refresh('add'));
-    this.watcher.on('change', () => this._refresh('change'));
-    this.watcher.on('unlink', () => this._refresh('unlink'));
-    return this;
-  }
-
-  async _refresh(kind) {
-    const snapshot = await this.snapshot();
-    this.emit('change', { kind, snapshot });
-  }
-
-  async snapshot() {
-    const out = {
-      hasInbox: existsSync(this.inboxPath),
-      inboxContent: '',
-      installed: {},
-      imports: [],
-    };
-    if (out.hasInbox) {
-      try {
-        out.inboxContent = await fs.readFile(this.inboxPath, 'utf8');
-      } catch {
-        out.inboxContent = '';
-      }
-    }
-    if (existsSync(this.installedPath)) {
-      try {
-        const raw = await fs.readFile(this.installedPath, 'utf8');
-        out.installed = JSON.parse(raw);
-      } catch {
-        out.installed = {};
-      }
-    }
-    const importsDir = path.join(this.workspaceDir, '.wild', 'imports');
-    if (existsSync(importsDir)) {
-      try {
-        const entries = await fs.readdir(importsDir, { withFileTypes: true });
-        out.imports = entries
-          .filter((e) => e.isDirectory())
-          .map((e) => e.name);
-      } catch {
-        out.imports = [];
-      }
-    }
-    return out;
-  }
-
-  stop() {
-    if (this.watcher) this.watcher.close();
-    this.watcher = null;
-  }
-}
+// Component System inbox surfacing.
+// When `.wild/inbox.md` exists or changes, emit notifications.
+// Drives the "I noticed you imported X — want me to walk integration?" cue in chat.
+
+import fs from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import chokidar from 'chokidar';
+import { EventEmitter } from 'node:events';
+
+export class InboxWatcher extends EventEmitter {
+  constructor(workspaceDir) {
+    super();
+    this.workspaceDir = workspaceDir;
+    this.inboxPath = path.join(workspaceDir, '.wild', 'inbox.md');
+    this.installedPath = path.join(workspaceDir, '.wild', 'installed.json');
+    this.watcher = null;
+    // Resolves once the watcher's initial scan is done — see start().
+    this.ready = Promise.resolve();
+  }
+
+  start() {
+    this.watcher = chokidar.watch(
+      [this.inboxPath, this.installedPath, path.join(this.workspaceDir, '.wild', 'imports')],
+      {
+        ignoreInitial: false,
+        persistent: true,
+        depth: 3,
+        awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 100 },
+      },
+    );
+    this.watcher.on('add', () => this._refresh('add'));
+    this.watcher.on('change', () => this._refresh('change'));
+    this.watcher.on('unlink', () => this._refresh('unlink'));
+    // Resolves once chokidar's initial scan completes and it is actively
+    // watching — anything created after this point is reliably detected.
+    this.ready = new Promise((resolve) => this.watcher.once('ready', resolve));
+    return this;
+  }
+
+  async _refresh(kind) {
+    const snapshot = await this.snapshot();
+    this.emit('change', { kind, snapshot });
+  }
+
+  async snapshot() {
+    const out = {
+      hasInbox: existsSync(this.inboxPath),
+      inboxContent: '',
+      installed: {},
+      imports: [],
+    };
+    if (out.hasInbox) {
+      try {
+        out.inboxContent = await fs.readFile(this.inboxPath, 'utf8');
+      } catch {
+        out.inboxContent = '';
+      }
+    }
+    if (existsSync(this.installedPath)) {
+      try {
+        const raw = await fs.readFile(this.installedPath, 'utf8');
+        out.installed = JSON.parse(raw);
+      } catch {
+        out.installed = {};
+      }
+    }
+    const importsDir = path.join(this.workspaceDir, '.wild', 'imports');
+    if (existsSync(importsDir)) {
+      try {
+        const entries = await fs.readdir(importsDir, { withFileTypes: true });
+        out.imports = entries
+          .filter((e) => e.isDirectory())
+          .map((e) => e.name);
+      } catch {
+        out.imports = [];
+      }
+    }
+    return out;
+  }
+
+  stop() {
+    if (this.watcher) this.watcher.close();
+    this.watcher = null;
+  }
+}