super-backlog 1.3.3 → 1.3.4

package/dist/commands/dashboard.js

@@ -8,6 +8,7 @@ import { startHubServer } from '../dashboard/hub.js';
 import { renderDashboard } from '../dashboard/render.js';
 import { DASHBOARD_PORT } from '../dashboard/server.js';
 import { atomicWrite } from '../lib/atomic.js';
+import { defaultBuildFingerprint } from '../lib/build-fingerprint.js';
 import { clearHubState, isPidAlive, newHubToken, readHubState, writeHubState } from '../lib/hub-state.js';
 import { projectSlug } from '../lib/slug.js';
 import { KIT_VERSION } from '../lib/version.js';
@@ -157,6 +158,8 @@ export async function runDashboard(cwd, args, deps = {}) {
     const isAlive = deps.isAlive ?? isPidAlive;
     const killPid = deps.killPid ?? ((p) => { process.kill(p); });
     const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const buildFingerprint = deps.buildFingerprint ?? defaultBuildFingerprint;
+    const myFingerprint = buildFingerprint();
     let slugResult;
     try {
         slugResult = projectSlug(cwd);
@@ -180,7 +183,14 @@ export async function runDashboard(cwd, args, deps = {}) {
                     : undefined;
                 const liveVersion = typeof statusJson?.version === 'string' ? statusJson.version : undefined;
                 const effectiveVersion = liveVersion ?? state.version;
-                if (effectiveVersion === KIT_VERSION) {
+                const liveFingerprint = typeof statusJson?.fingerprint === 'string' ? statusJson.fingerprint : undefined;
+                // Same version AND (proven identical build OR build cannot be
+                // assessed locally) -> attach. A missing live fingerprint from a
+                // same-version hub means it was started by an older CLI and cannot
+                // see the current build, so it is restarted exactly once.
+                const buildMatches = myFingerprint !== null && liveFingerprint === myFingerprint;
+                const buildUnassessable = myFingerprint === null;
+                if (effectiveVersion === KIT_VERSION && (buildMatches || buildUnassessable)) {
                     if (values['port'] !== undefined && port !== state.port) {
                         console.error(`error: a hub is already running on ${state.port}`);
                         return 1;
@@ -194,7 +204,12 @@ export async function runDashboard(cwd, args, deps = {}) {
                         noOpen,
                     });
                 }
-                console.error(`hub v${effectiveVersion ?? 'unknown'} does not match this CLI (v${KIT_VERSION}) — restarting it`);
+                if (effectiveVersion === KIT_VERSION) {
+                    console.error(`hub build changed (fingerprint mismatch, same version v${KIT_VERSION}) — restarting it`);
+                }
+                else {
+                    console.error(`hub v${effectiveVersion ?? 'unknown'} does not match this CLI (v${KIT_VERSION}) — restarting it`);
+                }
                 killPid(state.pid);
                 let dead = !isAlive(state.pid);
                 for (let attempt = 0; !dead && attempt < STOP_POLL_MAX_ATTEMPTS; attempt++) {
@@ -234,7 +249,7 @@ export async function runDashboard(cwd, args, deps = {}) {
         console.error(`error: dashboard serve failed (${err instanceof Error ? err.message : String(err)})`);
         return 1;
     }
-    writeHubState(home, { pid, port: hub.port, token, version: KIT_VERSION });
+    writeHubState(home, { pid, port: hub.port, token, version: KIT_VERSION, fingerprint: myFingerprint ?? undefined });
     const result = hub.register({ cwd, file: outPath, regenerate });
     if (!result.ok) {
         await hub.close();

package/dist/dashboard/hub.js

@@ -9,6 +9,7 @@ import { collectDashboardData } from './data.js';
 import { renderDashboard } from './render.js';
 import { createDebouncedReloader, createReloadBroker, DASHBOARD_PORT, recursiveWatchSupported, } from './server.js';
 import { atomicWrite } from '../lib/atomic.js';
+import { defaultBuildFingerprint } from '../lib/build-fingerprint.js';
 import { projectSlug, realpathKey } from '../lib/slug.js';
 import { KIT_VERSION } from '../lib/version.js';
 import { createModelApiHandler } from '../models/dashboard-api.js';
@@ -63,6 +64,7 @@ function generateDashboard(cwd, file) {
 export async function startHubServer(opts) {
     const projects = new Map();
     const token = opts.token;
+    const fingerprint = defaultBuildFingerprint();
     let port = 0;
     let watchWarned = false;
     function watchBacklog(cwd, reloader) {
@@ -166,7 +168,7 @@ export async function startHubServer(opts) {
                 sendText(res, 401, 'unauthorized');
                 return;
             }
-            sendJson(res, 200, { pid: process.pid, port, version: KIT_VERSION });
+            sendJson(res, 200, { pid: process.pid, port, version: KIT_VERSION, fingerprint: fingerprint ?? undefined });
             return;
         }
         if (pathname === '/api/hub/register' && method === 'POST') {

package/dist/lib/build-fingerprint.js

@@ -0,0 +1,50 @@
+// src/lib/build-fingerprint.ts
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+const require = createRequire(import.meta.url);
+function distRoot() {
+    // Resolves from src/lib (dev/tests) and dist/lib (runtime) alike: both sit
+    // two levels below the package root that owns dist/.
+    const pkgPath = require.resolve('../../package.json');
+    return join(dirname(pkgPath), 'dist');
+}
+function walk(dir, out) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            walk(full, out);
+        else
+            out.push(full);
+    }
+}
+/**
+ * Stable content hash over the built CLI. Two builds of the same source
+ * produce the same fingerprint; any changed or added file changes it.
+ * Returns null when the build directory is missing.
+ */
+export function computeBuildFingerprint(root = distRoot()) {
+    if (!existsSync(root))
+        return null;
+    const files = [];
+    walk(root, files);
+    if (files.length === 0)
+        return null;
+    files.sort();
+    const hash = createHash('sha256');
+    for (const file of files) {
+        hash.update(file.slice(root.length + 1).replaceAll('\\', '/'));
+        hash.update('\0');
+        hash.update(readFileSync(file));
+        hash.update('\0');
+    }
+    return hash.digest('hex').slice(0, 16);
+}
+let cachedDefault;
+/** Process-lifetime cached fingerprint of the running build. */
+export function defaultBuildFingerprint() {
+    if (cachedDefault === undefined)
+        cachedDefault = computeBuildFingerprint();
+    return cachedDefault;
+}

package/dist/lib/hub-state.js

@@ -16,8 +16,14 @@ export function readHubState(home) {
             typeof parsed.token !== 'string') {
             return null;
         }
-        const { pid, port, token, version } = parsed;
-        return typeof version === 'string' ? { pid, port, token, version } : { pid, port, token };
+        const { pid, port, token, version, fingerprint } = parsed;
+        return {
+            pid,
+            port,
+            token,
+            ...(typeof version === 'string' ? { version } : {}),
+            ...(typeof fingerprint === 'string' ? { fingerprint } : {}),
+        };
     }
     catch {
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-backlog",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "One command to equip any project with Backlog.md + Superpowers, plus a Project Dashboard.",
   "license": "MIT",
   "repository": {