@staff0rd/assist 0.320.0 → 0.322.0

package/README.md

@@ -247,7 +247,7 @@ The first backlog command in a repository that still has a local `.assist/backlo
 - `assist complexity <pattern>` - Analyze a file (all metrics if single match, maintainability if multiple)
 - `assist complexity cyclomatic [pattern]` - Calculate cyclomatic complexity per function
 - `assist complexity halstead [pattern]` - Calculate Halstead metrics per function
-- `assist complexity maintainability [pattern]` - Calculate maintainability index per file (`--ignore <glob>`, repeatable, excludes extra files on top of `complexity.ignore`)
+- `assist complexity maintainability [pattern]` - Calculate maintainability index per file (`--ignore <glob>`, repeatable, excludes extra files on top of `complexity.ignore`). A file can declare its own threshold with a `// assist-maintainability-override: N` comment in its first ~10 lines (integer 0-100); that value replaces the global `--threshold` for that file only and the output annotates it with `(override: N)`
 - `assist complexity sloc [pattern]` - Count source lines of code per file
 - `assist transcript configure` - Configure transcript directories
 - `assist transcript format` - Convert VTT files to formatted markdown transcripts

package/claude/CLAUDE.md

@@ -8,7 +8,7 @@ When renaming TypeScript files or symbols, use the refactor commands instead of
 - `assist refactor rename symbol <file> <oldName> <newName>` — rename a variable, function, class, or type across the project
 - `assist refactor extract <file> <functionName> <destination>` — extract a function and its private dependencies to a new file
   All default to dry-run; add `--apply` to execute.
-  When using extract, name the destination file after the exported function (e.g. `updateWorkerCapacity.ts` for `updateWorkerCapacity`) to satisfy `useFilenamingConvention` lint rules.
+  When using extract, name the destination file after the exported function (e.g. `updateWorkerCapacity.ts` for `updateWorkerCapacity`) to satisfy the `oxlint-rules/filenameConvention.ts` lint rule.
 
 Do not modify `claude/settings.json` without asking the user first. Only read-only commands should be added to the allow list — write operations (add, remove, set, delete) must require confirmation.
 

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.320.0",
+  version: "0.322.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -1556,19 +1556,19 @@ function moveCaseInsensitive(absSource, absDest) {
   fs9.renameSync(absSource, tmp);
   fs9.renameSync(tmp, absDest);
 }
-function applyMoves(project, moves, cwd, emit2) {
+function applyMoves(project, moves, cwd, emit4) {
   for (const { sourcePath, destPath } of moves) {
     const start3 = performance.now();
     const absSource = path15.resolve(sourcePath);
     const absDest = path15.resolve(destPath);
     for (const r of renameExports(project, absSource, absDest)) {
-      emit2(`  Renamed export ${r} in ${sourcePath}`);
+      emit4(`  Renamed export ${r} in ${sourcePath}`);
     }
     const sourceFile = project.getSourceFile(absSource);
     if (sourceFile) sourceFile.move(absDest);
     const ms = (performance.now() - start3).toFixed(0);
     const rel = `${path15.relative(cwd, absSource)} \u2192 ${path15.relative(cwd, absDest)}`;
-    emit2(`  Renamed ${rel} (${ms}ms)`);
+    emit4(`  Renamed ${rel} (${ms}ms)`);
   }
   project.saveSync();
   for (const { sourcePath, destPath } of moves) {
@@ -6728,6 +6728,44 @@ function installRestartMenu(options2 = {}) {
   return cleanup;
 }
 
+// src/commands/sessions/web/streamDaemonLogs.ts
+import { createInterface as createInterface3 } from "readline";
+var RECONNECT_MS = 3e3;
+function streamDaemonLogs() {
+  void connect2();
+}
+async function connect2() {
+  try {
+    await ensureDaemonRunning("web log stream");
+    const socket = await connectToDaemon();
+    wire(socket);
+    socket.write(`${JSON.stringify({ type: "subscribe-logs" })}
+`);
+  } catch {
+    scheduleReconnect();
+  }
+}
+function wire(socket) {
+  const lines = createInterface3({ input: socket });
+  lines.on("error", () => {
+  });
+  lines.on("line", emit);
+  socket.on("error", () => {
+  });
+  socket.on("close", scheduleReconnect);
+}
+function emit(line) {
+  try {
+    const data = JSON.parse(line);
+    if (data.type === "log" && typeof data.line === "string")
+      console.log(data.line);
+  } catch {
+  }
+}
+function scheduleReconnect() {
+  setTimeout(() => void connect2(), RECONNECT_MS).unref();
+}
+
 // src/commands/sessions/web/index.ts
 async function web(options2) {
   const port = Number.parseInt(options2.port, 10);
@@ -6754,6 +6792,7 @@ async function web(options2) {
     }
   });
   installRestartMenu();
+  streamDaemonLogs();
   void ensureDaemonRunning("web server start").catch((error) => {
     console.error(
       chalk55.yellow(
@@ -9692,7 +9731,7 @@ import chalk95 from "chalk";
 function formatResultLine(entry, failing) {
   const { file, avgMaintainability, minMaintainability, override } = entry;
   const name = failing ? chalk95.red(file) : chalk95.white(file);
-  const suffix = failing && override !== void 0 ? chalk95.magenta(` (override threshold ${override})`) : "";
+  const suffix = override !== void 0 ? chalk95.magenta(` (override: ${override})`) : "";
   return `${name} \u2192 avg: ${chalk95.cyan(avgMaintainability.toFixed(1))}, min: ${chalk95.yellow(minMaintainability.toFixed(1))}${suffix}`;
 }
 
@@ -9703,7 +9742,7 @@ function printMaintainabilityFailure(failingCount, threshold) {
   console.error(
     chalk96.red(
       `
-Fail: ${failingCount} file(s) below threshold${thresholdLabel} (files marked "override threshold" were judged against their own marker). Maintainability index (0\u2013100) is derived from Halstead volume, cyclomatic complexity, and lines of code.
+Fail: ${failingCount} file(s) below threshold${thresholdLabel} (files marked "(override: N)" were judged against their own marker). Maintainability index (0\u2013100) is derived from Halstead volume, cyclomatic complexity, and lines of code.
 
 \u26A0\uFE0F  ${chalk96.bold("Diagnose and fix one file at a time")} \u2014 do not investigate or fix multiple files in parallel.
 
@@ -9730,6 +9769,11 @@ Analyzed ${results.length} files`));
   } else {
     for (const entry of failing) console.log(formatResultLine(entry, true));
   }
+  const passingOverrides = results.filter(
+    (r) => r.override !== void 0 && !failing.includes(r)
+  );
+  for (const entry of passingOverrides)
+    console.log(formatResultLine(entry, false));
   console.log(chalk97.dim(`
 Analyzed ${results.length} files`));
   if (failing.length > 0) {
@@ -11664,7 +11708,7 @@ function advisory(count6) {
   const noun = count6 === 1 ? "handover" : "handovers";
   return `${count6} unrecalled ${noun} for this repo. Run /recall to load.`;
 }
-function emit(message) {
+function emit2(message) {
   const json = JSON.stringify({
     hookSpecificOutput: { hookEventName: "SessionStart" },
     systemMessage: message
@@ -11681,7 +11725,7 @@ async function load2(options2 = {}) {
   await migrateDiskHandovers(orm, origin, cwd);
   const count6 = await countPendingHandovers(orm, origin);
   if (count6 === 0) return null;
-  return emit(advisory(count6));
+  return emit2(advisory(count6));
 }
 
 // src/commands/handover/listPendingHandovers.ts
@@ -12396,25 +12440,25 @@ function isVisibleText(t) {
   return /[a-zA-Z]{3,}/.test(t);
 }
 var isHashtag = (t) => /^#[A-Za-z0-9_]+$/.test(t);
-function collectRscText(v, resolve17, sink, seen) {
+function collectRscText(v, resolve17, sink2, seen) {
   if (v == null) return;
   if (typeof v === "string") {
     if (isRscRef(v)) {
       if (!seen.has(v)) {
         seen.add(v);
-        collectRscText(resolve17(v), resolve17, sink, seen);
+        collectRscText(resolve17(v), resolve17, sink2, seen);
       }
-    } else if (isHashtag(v)) sink.hashtags.push(v);
-    else if (isVisibleText(v)) sink.text.push(v);
+    } else if (isHashtag(v)) sink2.hashtags.push(v);
+    else if (isVisibleText(v)) sink2.text.push(v);
     return;
   }
   if (Array.isArray(v)) {
-    for (const x of v) collectRscText(x, resolve17, sink, seen);
+    for (const x of v) collectRscText(x, resolve17, sink2, seen);
     return;
   }
   if (typeof v === "object") {
     for (const val of Object.values(v)) {
-      collectRscText(val, resolve17, sink, seen);
+      collectRscText(val, resolve17, sink2, seen);
     }
   }
 }
@@ -12453,9 +12497,9 @@ function buildMentionMap(rows, resolve17) {
     if (!url || o.children == null) return;
     const slug = slugFromProfileUrl(url);
     if (!slug || map.has(slug)) return;
-    const sink = { text: [], hashtags: [] };
-    collectRscText(o.children, resolve17, sink, /* @__PURE__ */ new Set());
-    const name = sink.text.join(" ").replace(/\s+/g, " ").trim();
+    const sink2 = { text: [], hashtags: [] };
+    collectRscText(o.children, resolve17, sink2, /* @__PURE__ */ new Set());
+    const name = sink2.text.join(" ").replace(/\s+/g, " ").trim();
     map.set(slug, name ? { slug, name, url } : { slug, url });
   });
   return map;
@@ -12556,8 +12600,8 @@ function walkPostRow(v, resolve17, raw) {
     if (a) raw.related.push(a[0]);
   }
   if (isCommentary(o)) {
-    const sink = { text: raw.text, hashtags: raw.hashtags };
-    collectRscText(o.children, resolve17, sink, /* @__PURE__ */ new Set());
+    const sink2 = { text: raw.text, hashtags: raw.hashtags };
+    collectRscText(o.children, resolve17, sink2, /* @__PURE__ */ new Set());
   }
   for (const val of Object.values(o)) walkPostRow(val, resolve17, raw);
 }
@@ -19980,7 +20024,7 @@ function listDaemonPids() {
 }
 
 // src/commands/sessions/daemon/queryDaemon.ts
-import { createInterface as createInterface4 } from "readline";
+import { createInterface as createInterface5 } from "readline";
 var STATUS_TIMEOUT_MS = 5e3;
 function queryDaemon(socket) {
   socket.write(`${JSON.stringify({ type: "ping" })}
@@ -19989,7 +20033,7 @@ function queryDaemon(socket) {
     const result = { sessions: [] };
     const pending = /* @__PURE__ */ new Set(["sessions", "pong"]);
     const timer = setTimeout(() => resolve17(result), STATUS_TIMEOUT_MS);
-    const lines = createInterface4({ input: socket });
+    const lines = createInterface5({ input: socket });
     lines.on("error", () => {
     });
     lines.on("line", (line) => {
@@ -20069,10 +20113,35 @@ function reportStrays(pids) {
 }
 
 // src/commands/sessions/daemon/drainDaemon.ts
-import { createInterface as createInterface5 } from "readline";
+import { createInterface as createInterface6 } from "readline";
 
 // src/commands/sessions/daemon/loadPersistedSessions.ts
 import { z as z5 } from "zod";
+
+// src/commands/sessions/daemon/daemonLog.ts
+var RING_CAPACITY = 1e3;
+var ring = [];
+var sink;
+function daemonLog(message) {
+  emit3(`${(/* @__PURE__ */ new Date()).toISOString()} [${process.pid}] ${message}`);
+}
+function relayDaemonLog(line) {
+  emit3(`[windows] ${line}`);
+}
+function emit3(line) {
+  console.log(line);
+  ring.push(line);
+  if (ring.length > RING_CAPACITY) ring.shift();
+  sink?.(line);
+}
+function setDaemonLogSink(next3) {
+  sink = next3;
+}
+function recentDaemonLogLines() {
+  return [...ring];
+}
+
+// src/commands/sessions/daemon/loadPersistedSessions.ts
 var SESSIONS_FILE = "sessions.json";
 var persistedSessionSchema = z5.object({
   name: z5.string(),
@@ -20098,8 +20167,19 @@ function savePersistedSessions(sessions) {
   saveJson(SESSIONS_FILE, sessions);
 }
 function persistLiveSessions(sessions) {
-  savePersistedSessions(
-    [...sessions.values()].filter((s) => s.pty && s.status !== "done").map(toPersistedSession)
+  const live = [...sessions.values()].filter(
+    (s) => s.pty && s.status !== "done"
+  );
+  savePersistedSessions(live.map(toPersistedSession));
+  logPersist(live);
+}
+var lastPersistSignature = "";
+function logPersist(live) {
+  const signature = live.map((s) => `${s.id}:${s.status}`).join(",");
+  if (signature === lastPersistSignature) return;
+  lastPersistSignature = signature;
+  daemonLog(
+    live.length > 0 ? `persisted ${live.length} session(s): ${live.map((s) => s.name).join(", ")}` : "persisted 0 sessions (sessions.json cleared)"
   );
 }
 function toPersistedSession(session) {
@@ -20140,7 +20220,7 @@ function requestDrain(socket) {
 `);
   return new Promise((resolve17) => {
     const timer = setTimeout(() => resolve17(0), DRAIN_TIMEOUT_MS);
-    const lines = createInterface5({ input: socket });
+    const lines = createInterface6({ input: socket });
     lines.on("error", () => {
     });
     lines.on("line", (line) => {
@@ -20173,11 +20253,6 @@ function createAutoExit(exit, graceMs = DEFAULT_GRACE_MS) {
   };
 }
 
-// src/commands/sessions/daemon/daemonLog.ts
-function daemonLog(message) {
-  console.log(`${(/* @__PURE__ */ new Date()).toISOString()} [${process.pid}] ${message}`);
-}
-
 // src/commands/sessions/daemon/loadActiveSelection.ts
 import { z as z6 } from "zod";
 var ACTIVE_FILE = "active.json";
@@ -20306,6 +20381,8 @@ var ClientHub = class extends Set {
     this.persistPeak = persistPeak;
   }
   latestLimits;
+  // why: log delivery is opt-in so browser tabs aren't spammed; only connections that ask via subscribe-logs receive daemonLog lines.
+  logSubscribers = /* @__PURE__ */ new Set();
   updateLimits(rateLimits) {
     this.latestLimits = rateLimits;
     broadcast(this, { type: "limits", rateLimits });
@@ -20316,6 +20393,21 @@ var ClientHub = class extends Set {
       sendTo(client, { type: "limits", rateLimits: this.latestLimits });
     }
   }
+  subscribeLogs(client) {
+    for (const line of recentDaemonLogLines()) {
+      sendTo(client, { type: "log", line });
+    }
+    this.logSubscribers.add(client);
+  }
+  unsubscribeLogs(client) {
+    this.logSubscribers.delete(client);
+  }
+  // why: bound so it can be handed to setDaemonLogSink as a bare reference.
+  emitLog = (line) => {
+    for (const client of this.logSubscribers) {
+      sendTo(client, { type: "log", line });
+    }
+  };
 };
 
 // src/commands/sessions/daemon/spawnPty.ts
@@ -20384,6 +20476,29 @@ function createAssistSession(id2, assistArgs, cwd) {
   };
 }
 
+// src/commands/sessions/daemon/dismissSession.ts
+function dismissSession(sessions, id2) {
+  const s = sessions.get(id2);
+  if (!s) return false;
+  if (s.status !== "done") s.pty?.kill();
+  s.activityWatcher?.close();
+  removeActivity(s.id);
+  if (s.activity?.itemId != null) releaseLock(s.activity.itemId);
+  sessions.delete(id2);
+  daemonLog(`session ${id2} dismissed (${s.name})`);
+  return true;
+}
+function drainSessions(sessions, onDrained) {
+  const names = [...sessions.values()].map((s) => s.name);
+  const ids = [...sessions.keys()];
+  for (const id2 of ids) dismissSession(sessions, id2);
+  onDrained();
+  daemonLog(
+    ids.length > 0 ? `drained ${ids.length} session(s): ${names.join(", ")}` : "drained 0 sessions"
+  );
+  return ids.length;
+}
+
 // src/commands/sessions/daemon/createSession.ts
 import { randomUUID as randomUUID4 } from "crypto";
 
@@ -20458,6 +20573,13 @@ function greetClient(client, sessions, windowsProxy) {
   void windowsProxy.discover();
 }
 
+// src/commands/sessions/daemon/logSpawnedSession.ts
+function logSpawnedSession(session) {
+  daemonLog(
+    `session ${session.id} spawned: ${session.name} [${session.commandType}] ${session.cwd ?? ""}`
+  );
+}
+
 // src/commands/sessions/daemon/setStatus.ts
 function setStatus2(session, newStatus) {
   const now = Date.now();
@@ -20821,6 +20943,7 @@ function retrySession(session, clients, onStatusChange) {
   session.pty = respawn();
   broadcast(clients, { type: "clear", sessionId: session.id });
   wirePtyEvents(session, clients, onStatusChange);
+  daemonLog(`session ${session.id} retried: ${session.name}`);
   return true;
 }
 function respawnThunk(session) {
@@ -20850,6 +20973,7 @@ function reuseSessionForRun(session, itemId, clients, onStatusChange) {
 
 // src/commands/sessions/daemon/shutdownSessions.ts
 function shutdownSessions(sessions) {
+  daemonLog(`shutting down: killing ${sessions.size} session(s)`);
   for (const session of sessions.values()) {
     if (session.status !== "done") session.pty?.kill();
   }
@@ -20890,10 +21014,10 @@ async function isWindowsDaemonRunning() {
 import { spawn as spawn10 } from "child_process";
 
 // src/commands/sessions/daemon/logChildStream.ts
-import { createInterface as createInterface6 } from "readline";
+import { createInterface as createInterface7 } from "readline";
 function logChildStream(stream, label2) {
   if (!stream) return;
-  const lines = createInterface6({ input: stream });
+  const lines = createInterface7({ input: stream });
   lines.on("line", (line) => daemonLog(`[${label2}] ${line}`));
   lines.on("error", () => {
   });
@@ -21049,6 +21173,10 @@ var inbound = {
   created: handleCreated,
   sessions: handleSessions,
   output: handleOutput,
+  // why: relay the Windows daemon's own log lines into this daemon's stream (ring + subscribers) so assist.log shows both daemons; not state.broadcast — browsers must not receive log spam.
+  log: (_state, msg) => {
+    if (typeof msg.line === "string") relayDaemonLog(msg.line);
+  },
   clear: relayWithSessionId,
   error: (state, msg) => {
     daemonLog(`windows daemon: inbound error: ${msg.message}`);
@@ -21165,7 +21293,7 @@ function isWindowsIo(data) {
 }
 
 // src/commands/sessions/daemon/WindowsConnection.ts
-import { createInterface as createInterface7 } from "readline";
+import { createInterface as createInterface8 } from "readline";
 
 // src/commands/sessions/daemon/LaunchCircuitBreaker.ts
 var MAX_FAILURES = 3;
@@ -21242,10 +21370,11 @@ var WindowsConnection = class {
     this.socket = socket;
     this.wire(socket);
     this.write(buildHello());
+    this.write({ type: "subscribe-logs" });
     return socket;
   }
   wire(socket) {
-    const lines = createInterface7({ input: socket });
+    const lines = createInterface8({ input: socket });
     lines.on("error", () => {
     });
     lines.on("line", (line) => this.deps.onLine(line));
@@ -21332,14 +21461,14 @@ var WindowsProxy = class {
   state;
   conn;
   healer;
-  constructor(clients, onSessionsChanged, connect3 = defaultConnect, heal = healWindowsDaemon) {
+  constructor(clients, onSessionsChanged, connect4 = defaultConnect, heal = healWindowsDaemon) {
     this.state = createState(
       (msg) => broadcast(clients, msg),
       onSessionsChanged,
       (version2) => void this.healer.onMismatch(version2)
     );
     this.conn = new WindowsConnection({
-      connect: connect3,
+      connect: connect4,
       onLine: (line) => handleInbound(this.state, line),
       onClose: () => this.handleClose()
     });
@@ -21400,6 +21529,7 @@ function setAutoRun(sessions, id2, enabled) {
   const s = sessions.get(id2);
   if (!s) return false;
   s.autoRun = enabled;
+  daemonLog(`session ${id2} autorun ${enabled ? "on" : "off"}`);
   return true;
 }
 function setAutoAdvance(sessions, id2, enabled) {
@@ -21411,24 +21541,9 @@ function setAutoAdvance(sessions, id2, enabled) {
     if (enabled) clearPause(itemId);
     else requestPause(itemId);
   }
+  daemonLog(`session ${id2} autoadvance ${enabled ? "on" : "off"}`);
   return true;
 }
-function dismissSession(sessions, id2) {
-  const s = sessions.get(id2);
-  if (!s) return false;
-  if (s.status !== "done") s.pty?.kill();
-  s.activityWatcher?.close();
-  removeActivity(s.id);
-  if (s.activity?.itemId != null) releaseLock(s.activity.itemId);
-  sessions.delete(id2);
-  return true;
-}
-function drainSessions(sessions, onDrained) {
-  const ids = [...sessions.keys()];
-  for (const id2 of ids) dismissSession(sessions, id2);
-  onDrained();
-  return ids.length;
-}
 
 // src/commands/sessions/daemon/SessionManager.ts
 var SessionManager = class {
@@ -21450,6 +21565,7 @@ var SessionManager = class {
   }
   removeClient(client) {
     this.clients.delete(client);
+    this.clients.unsubscribeLogs(client);
     this.onIdleChange?.(this.isIdle());
   }
   isIdle = () => this.sessions.size === 0 && this.clients.size === 0;
@@ -21464,6 +21580,7 @@ var SessionManager = class {
   add(session) {
     this.wire(session);
     watchActivity(session, this.notify);
+    logSpawnedSession(session);
     return session.id;
   }
   spawnWith = (create) => this.add(create(sessionLimits.nextId(this.sessions.size, this.idCounter)));
@@ -21529,7 +21646,7 @@ import { unlinkSync as unlinkSync19 } from "fs";
 import * as net3 from "net";
 
 // src/commands/sessions/daemon/handleConnection.ts
-import { createInterface as createInterface8 } from "readline";
+import { createInterface as createInterface9 } from "readline";
 
 // src/commands/sessions/shared/discoverSessions.ts
 import * as fs31 from "fs";
@@ -21838,6 +21955,7 @@ function routed(local) {
 }
 var messageHandlers = {
   ping: (client) => sendTo(client, { type: "pong", pid: process.pid }),
+  "subscribe-logs": (client, m) => m.clients.subscribeLogs(client),
   hello: (client) => sendTo(client, buildHello()),
   create: creator(
     true,
@@ -21906,7 +22024,7 @@ function handleConnection(socket, manager) {
   };
   manager.addClient(client);
   manager.clients.greet(client);
-  const lines = createInterface8({ input: socket });
+  const lines = createInterface9({ input: socket });
   lines.on("error", () => {
   });
   lines.on("line", (line) => {
@@ -22042,7 +22160,9 @@ async function runDaemon() {
     daemonLog("no sessions and no connected server; exiting");
     process.exit(0);
   });
-  startDaemonServer(new SessionManager(checkAutoExit), checkAutoExit);
+  const manager = new SessionManager(checkAutoExit);
+  setDaemonLogSink(manager.clients.emitLog);
+  startDaemonServer(manager, checkAutoExit);
 }
 
 // src/commands/sessions/daemon/registerDaemon.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.320.0",
+	"version": "0.322.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {