@staff0rd/assist 0.320.0 → 0.321.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.321.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -9692,7 +9692,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 +9703,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 +9730,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) {
@@ -20073,6 +20078,13 @@ import { createInterface as createInterface5 } from "readline";
 
 // src/commands/sessions/daemon/loadPersistedSessions.ts
 import { z as z5 } from "zod";
+
+// src/commands/sessions/daemon/daemonLog.ts
+function daemonLog(message) {
+  console.log(`${(/* @__PURE__ */ new Date()).toISOString()} [${process.pid}] ${message}`);
+}
+
+// src/commands/sessions/daemon/loadPersistedSessions.ts
 var SESSIONS_FILE = "sessions.json";
 var persistedSessionSchema = z5.object({
   name: z5.string(),
@@ -20098,8 +20110,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) {
@@ -20173,11 +20196,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";
@@ -20384,6 +20402,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 +20499,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 +20869,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 +20899,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();
   }
@@ -21400,6 +21450,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 +21462,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 {
@@ -21464,6 +21500,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)));

package/package.json

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