@specship/specship-win32-arm64 0.12.1 → 0.13.0

package/lib/dist/server/server.js

@@ -33,6 +33,9 @@ import { registerReflectRoutes } from './routes/reflect.js';
 import { registerMaintainabilityRoutes } from './routes/maintainability.js';
 import { registerDomainRoutes } from './routes/domain.js';
 import { registerChatRoutes } from './routes/chat.js';
+import { registerMcpRoutes } from './routes/mcp.js';
+import { registerConfigRoutes } from './routes/config.js';
+import { readServerConfig } from './server-config.js';
 /**
  * Lazy-import the specship core. Two delivery shapes are supported:
  *
@@ -43,11 +46,37 @@ import { registerChatRoutes } from './routes/chat.js';
  *      resolution finding `@specship/specship` (it won't, the
  *      bundle stages a single package by name `@specship/specship`).
  *
- *   2. **Workspace / dev** — `packages/server/dist/server.js` imports via
- *      the workspace `file:../..` dep. Falls through to the named import.
+ *   2. **Workspace / dev** — `server/dist/server.js` imports via
+ *      the workspace `file:..` dep. Falls through to the named import.
  *
  * The function caches the resolved module so the lookup only runs once.
  */
+/**
+ * Locate the built desktop SPA (REQ-DESKTOP-017.A1) when the caller didn't
+ * pass an explicit `webDir`. Two delivery shapes, probed relative to this
+ * file so cwd never matters:
+ *
+ *   1. **Bundled** — `build-server-bundle.mjs` copies `ui/dist/**` to the
+ *      root `dist/ui/`, which the platform tarball ships as
+ *      `<bundle>/lib/dist/ui/` next to `dist/server/` (this file).
+ *   2. **Workspace / dev** — `server/{src,dist}/server.*` →
+ *      repo root → `ui/dist/` (present only after `cd ui && npm run build`).
+ *
+ * Returns null when neither exists — the server then simply has no SPA
+ * mount, same as `webDir: null`.
+ */
+export function resolveDefaultWebDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.resolve(here, '..', 'ui'), // bundled: dist/server → dist/ui
+        path.resolve(here, '..', '..', 'ui', 'dist'), // workspace: server/dist → <root>/ui/dist
+    ];
+    for (const dir of candidates) {
+        if (existsSync(path.join(dir, 'index.html')))
+            return dir;
+    }
+    return null;
+}
 let cachedSpecShip = null;
 async function loadSpecShip() {
     if (cachedSpecShip)
@@ -110,59 +139,102 @@ export async function createServer(options) {
     // provided one or explicitly opted out. Hooks into the primary project's
     // SQLite handle — when there's no primary, analytics endpoints will return
     // 409 until one is set (typically the next server restart with -p).
+    //
+    // The persisted runtime config (~/.specship/server-config.json) gates the
+    // start too: the Settings ingest toggle must survive a restart
+    // (REQ-DESKTOP-028.A2). CLI `--no-ingest` still wins over everything.
     let watcher = options.watcher ?? null;
     let ownedWatcher = false;
-    if (!watcher && options.ingest !== false && primaryCg) {
+    let ingestEnabled = watcher != null
+        || (options.ingest !== false && readServerConfig().ingestEnabled !== false);
+    const startIngestWatcher = () => {
+        if (watcher)
+            return true;
+        if (!primaryCg)
+            return false;
         const cgAny = primaryCg;
         const dbHandle = cgAny.db?.getDb ? cgAny.db.getDb() : cgAny.queries?.db;
-        if (dbHandle) {
-            // Build a sync resolveGraph: for the primary project path return the
-            // already-open SpecShip instance (which satisfies GraphLike).
-            // Sessions from other project paths resolve to null — they'll be left
-            // as 'unresolved' and retried on the next boot when that project is primary.
-            // The stored project_path is the lossy-decoded slug (every '-' → '/'), so
-            // an exact compare against the real primaryPath never matched and savings
-            // stayed 0. primaryProjectMatcher accepts both the real path and its
-            // mangled stored form. Sessions from OTHER projects still resolve to null
-            // (left 'unresolved', retried when that project is primary).
-            const primaryPath = options.projectRoot ?? null;
-            const isPrimary = primaryPath ? primaryProjectMatcher(primaryPath) : () => false;
-            const resolveGraph = (projectPath) => primaryPath && isPrimary(projectPath) ? primaryCg : null;
-            watcher = startWatcher(dbHandle, { verbose, resolveGraph });
-            ownedWatcher = true;
+        if (!dbHandle)
+            return false;
+        // Build a sync resolveGraph: for the primary project path return the
+        // already-open SpecShip instance (which satisfies GraphLike).
+        // Sessions from other project paths resolve to null — they'll be left
+        // as 'unresolved' and retried on the next boot when that project is primary.
+        // The stored project_path is the lossy-decoded slug (every '-' → '/'), so
+        // an exact compare against the real primaryPath never matched and savings
+        // stayed 0. primaryProjectMatcher accepts both the real path and its
+        // mangled stored form. Sessions from OTHER projects still resolve to null
+        // (left 'unresolved', retried when that project is primary).
+        const primaryPath = options.projectRoot ?? null;
+        const isPrimary = primaryPath ? primaryProjectMatcher(primaryPath) : () => false;
+        const resolveGraph = (projectPath) => primaryPath && isPrimary(projectPath) ? primaryCg : null;
+        watcher = startWatcher(dbHandle, { verbose, resolveGraph });
+        ownedWatcher = true;
+        if (verbose)
+            console.error('[specship-server] JSONL ingest watcher started');
+        // Backfill displaced_files / resolution for pre-upgrade rows (is_specship=1,
+        // resolution IS NULL). Idempotent — safe to run on every boot. Non-fatal:
+        // a failure here must never abort server startup.
+        try {
+            backfillDisplaced(dbHandle, resolveGraph);
             if (verbose)
-                console.error('[specship-server] JSONL ingest watcher started');
-            // Backfill displaced_files / resolution for pre-upgrade rows (is_specship=1,
-            // resolution IS NULL). Idempotent — safe to run on every boot. Non-fatal:
-            // a failure here must never abort server startup.
-            try {
-                backfillDisplaced(dbHandle, resolveGraph);
-                if (verbose)
-                    console.error('[specship-server] specship-impact backfill complete');
-            }
-            catch (err) {
-                console.error('[specship-server] specship-impact backfill failed (non-fatal):', err instanceof Error ? err.message : String(err));
-            }
-            // Re-cost prompts ingested while their model family was unpriced,
-            // e.g. fable sessions stuck at $0 (REQ-DASHINT-001.A2). Idempotent.
-            try {
-                const recosted = recostUnpricedPrompts(dbHandle);
-                if (verbose && recosted > 0)
-                    console.error(`[specship-server] re-costed ${recosted} unpriced prompts`);
-            }
-            catch (err) {
-                console.error('[specship-server] pricing backfill failed (non-fatal):', err instanceof Error ? err.message : String(err));
-            }
+                console.error('[specship-server] specship-impact backfill complete');
+        }
+        catch (err) {
+            console.error('[specship-server] specship-impact backfill failed (non-fatal):', err instanceof Error ? err.message : String(err));
+        }
+        // Re-cost prompts ingested while their model family was unpriced,
+        // e.g. fable sessions stuck at $0 (REQ-DASHINT-001.A2). Idempotent.
+        try {
+            const recosted = recostUnpricedPrompts(dbHandle);
+            if (verbose && recosted > 0)
+                console.error(`[specship-server] re-costed ${recosted} unpriced prompts`);
+        }
+        catch (err) {
+            console.error('[specship-server] pricing backfill failed (non-fatal):', err instanceof Error ? err.message : String(err));
+        }
+        return true;
+    };
+    if (!watcher && ingestEnabled) {
+        if (primaryCg) {
+            startIngestWatcher();
+        }
+        else if (verbose) {
+            console.error('[specship-server] no primary project — analytics will be empty until one is set');
         }
-    }
-    else if (!primaryCg && options.ingest !== false && verbose) {
-        console.error('[specship-server] no primary project — analytics will be empty until one is set');
     }
     // Decorate the Fastify instance so route handlers can access shared state
     // without globals or DI containers.
     app.decorate('projects', registry);
     app.decorate('primaryCg', primaryCg);
     app.decorate('watcher', watcher);
+    // Runtime ingest control for GET/PUT /api/config (REQ-DESKTOP-028.A2).
+    // `enabled` is the configured intent (round-trips even when no primary
+    // project can host a watcher yet); `active` is whether one is running.
+    // start/stop keep `app.watcher` in sync so /api/refresh always sees the
+    // live handle.
+    app.decorate('ingestControl', {
+        enabled: () => ingestEnabled,
+        active: () => watcher != null,
+        start: () => {
+            ingestEnabled = true;
+            const started = startIngestWatcher();
+            app.watcher = watcher;
+            return started;
+        },
+        stop: () => {
+            ingestEnabled = false;
+            if (watcher) {
+                try {
+                    watcher.stop();
+                }
+                catch { /* ignore */ }
+            }
+            watcher = null;
+            ownedWatcher = false;
+            app.watcher = null;
+        },
+    });
     // activeCg(req): resolve `?project=<slug>` → SpecShip instance, with the
     // primary as fallback. Returns null when nothing is selectable; route
     // handlers respond 409 in that case.
@@ -193,19 +265,17 @@ export async function createServer(options) {
     await registerMaintainabilityRoutes(app);
     await registerDomainRoutes(app);
     await registerChatRoutes(app);
-    // SSR dashboard (DASH-LEAN-DOC / REQ-DASHLEAN-004): explicit page routes
-    // rendered in-process from the /api handlers above (via app.inject), plus the
-    // dashboard's static assets. Registered AFTER /api and BEFORE the SPA
-    // fallback so the explicit page routes win.
-    if (options.ssr) {
-        const { registerSsrRoutes } = await import('./ssr/routes.js');
-        await registerSsrRoutes(app);
-    }
-    // Optional: serve the built Angular UI from `webDir` and fall back to
-    // index.html for client-side routes. Must register AFTER the /api/*
-    // routes so they take precedence over the SPA wildcard.
-    if (options.webDir) {
-        const indexPath = path.join(options.webDir, 'index.html');
+    await registerMcpRoutes(app);
+    await registerConfigRoutes(app);
+    // Serve the built desktop SPA (the `ui/` module) from `webDir` and fall back
+    // to index.html for client-side routes. This is the dashboard's only surface
+    // (REQ-DESKTOP-033 — the server-rendered dashboard retired). Must register
+    // AFTER the /api/* routes so they take precedence over the SPA wildcard. When
+    // the caller passed no webDir at all, auto-detect the SPA shipped next to the
+    // server build; `null` explicitly opts out (headless / API only).
+    const webDir = options.webDir === undefined ? resolveDefaultWebDir() : options.webDir;
+    if (webDir) {
+        const indexPath = path.join(webDir, 'index.html');
         let indexBuffer = null;
         try {
             indexBuffer = await fs.readFile(indexPath);
@@ -217,7 +287,7 @@ export async function createServer(options) {
         }
         if (indexBuffer) {
             const cachedIndex = indexBuffer;
-            const serveStatic = makeStaticHandler(options.webDir);
+            const serveStatic = makeStaticHandler(webDir);
             // A single 404 handler does both jobs:
             //   1. Try the requested URL as a real file under webDir → serve it
             //      with the right content-type. Covers the SPA's chunk-*.js,
@@ -250,7 +320,7 @@ export async function createServer(options) {
                 reply.code(200).type('text/html').send(cachedIndex);
             });
             if (verbose)
-                console.error(`[specship-server] serving SPA from ${options.webDir}`);
+                console.error(`[specship-server] serving SPA from ${webDir}`);
         }
     }
     await app.listen({ host, port });