claude-code-session-manager 0.111.0 → 0.113.0

package/src/main/agentsIpc.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+/**
+ * agentsIpc.cjs — registers the `agents:*` IPC handlers (Agent Library CRUD + persona/model/effort
+ * resolvers). Moved verbatim out of index.cjs; handler bodies and zod wrappers are unchanged.
+ */
+
+const { schemas, validated } = require('./ipcSchemas.cjs');
+const agentLibrary = require('./agentLibrary.cjs');
+const agentModelResolve = require('./lib/claude/agentModelResolve.cjs');
+const agentEffortResolve = require('./lib/claude/agentEffortResolve.cjs');
+const { resolveEffectiveModelInfo } = require('./lib/claude/effectiveModelInfo.cjs');
+const { sendIfAlive } = require('./lib/sendToRenderer.cjs');
+
+/**
+ * @param {{ ipcMain: any, getWindow: () => any }} opts
+ */
+function registerAgentsHandlers({ ipcMain, getWindow }) {
+  // Agent Library nav page (Home face only): global `~/.claude/agents/*.md`
+  // personas plus, per currently-open project tab, whether that project
+  // overlays the same agent name at `<cwd>/.claude/agents/<name>.md`. Read-only.
+  ipcMain.handle('agents:list-personas', () => agentLibrary.listPersonas());
+  // Agent Library CRUD — global personas only (`~/.claude/agents/*.md`); a
+  // project's local overlay can only be removed here (removeOverride), never
+  // created, since Agent Library is a Home-face, machine-wide surface with no
+  // per-tab cwd context of its own. Each mutation broadcasts `agents:changed`
+  // so Agent Library and Tag Library — two independently-mounted dockview
+  // panels, each with its own component-local `listPersonas()` snapshot —
+  // both refresh off the one file on disk instead of one panel going stale
+  // after the other edits the agent<->tag relationship.
+  function broadcastAgentsChanged() {
+    sendIfAlive(getWindow(), 'agents:changed', {});
+  }
+  ipcMain.handle('agents:save-persona', validated(schemas.agentsSavePersona, async (payload) => {
+    const result = await agentLibrary.savePersona(payload);
+    broadcastAgentsChanged();
+    return result;
+  }));
+  ipcMain.handle('agents:delete-persona', async (_e, payload) => {
+    const result = await agentLibrary.deletePersona(payload);
+    broadcastAgentsChanged();
+    return result;
+  });
+  ipcMain.handle('agents:remove-override', async (_e, payload) => {
+    const result = await agentLibrary.removeOverride(payload);
+    broadcastAgentsChanged();
+    return result;
+  });
+  // New Epic AIM composer (epicIntake.ts's `agentBody`/`agentPath`): unlike
+  // list-personas above (global dir only), this honors the project-overlay-
+  // then-global precedence so an Epic's opening prompt carries the persona
+  // body that actually applies to its cwd. Read-only.
+  ipcMain.handle('agents:get-persona-body', validated(schemas.agentsGetPersonaBody, (payload) =>
+    agentLibrary.getPersonaBody(payload)));
+
+  // "What will this Epic's launch actually use for --model?" — the SAME
+  // resolver chatRunner.cjs's Chat-view launch calls in-process
+  // (agentModelResolve.cjs's resolveEpicModel), reached here so Terminal's
+  // launch (EpicTerminalPane.tsx, a renderer module with no fs access) agrees
+  // with Chat by calling the identical function rather than a second one that
+  // is merely supposed to. Never throws (resolveEpicModel's own contract).
+  ipcMain.handle('agents:resolve-epic-model', validated(schemas.agentsResolveEpicModel, (payload) =>
+    agentModelResolve.resolveEpicModel(payload)));
+  // Effort twin of the above (agentEffortResolve.cjs): Terminal appends
+  // `--effort <level>` only when `effort` is non-null. Never throws.
+  ipcMain.handle('agents:resolve-epic-effort', validated(schemas.agentsResolveEpicEffort, (payload) =>
+    agentEffortResolve.resolveEpicEffort(payload)));
+
+  // "What will this Epic actually run as?" (PRD: effective-model-resolver) —
+  // persona alias + evidence-based concrete model id + provenance, for a given
+  // (cwd, agentType). Read-only observer; never affects what a launch resolves.
+  ipcMain.handle('agents:resolve-model-info', validated(schemas.agentsResolveModelInfo, (payload) =>
+    resolveEffectiveModelInfo(payload)));
+}
+
+module.exports = { registerAgentsHandlers };

package/src/main/build-info.json

@@ -1,8 +1,8 @@
 {
-  "version": "0.111.0",
-  "gitSha": "ca0cbc30d2ee72698993f0f07f878a932843c758",
-  "gitShortSha": "ca0cbc30",
+  "version": "0.113.0",
+  "gitSha": "07baa2cc0601e109b6591f57bfb2ced8f34884dd",
+  "gitShortSha": "07baa2cc",
   "gitBranch": "HEAD",
-  "builtAt": "2026-10-11T04:47:08.011Z",
+  "builtAt": "2026-10-12T19:15:00.757Z",
   "dirty": false
 }

package/src/main/chatRunner.cjs

@@ -44,20 +44,20 @@
 
 const { spawn } = require('node:child_process');
 const { ipcMain } = require('electron');
-const { resolveClaudeBin, claudeSpawnTarget } = require('./lib/claudeBin.cjs');
-const { cleanChildEnv, pathWithUserBins } = require('./lib/cleanEnv.cjs');
+const { resolveClaudeBin, claudeSpawnTarget } = require('./lib/claude/claudeBin.cjs');
+const { cleanChildEnv, pathWithUserBins } = require('./lib/process/cleanEnv.cjs');
 const { recordExchange } = require('./exchanges.cjs');
 const { classifyToolUse } = require('./lib/toolUseClassify.cjs');
-const { extractJson } = require('./lib/extractJson.cjs');
+const { extractJson } = require('./lib/util/extractJson.cjs');
 const { classifyPromptTicket } = require('./lib/classifyPromptTicket.cjs');
-const sessionSlots = require('./lib/sessionSlots.cjs');
-const opsErrorLog = require('./lib/opsErrorLog.cjs');
-const { killTree, detachedSpawnOpts } = require('./lib/killTree.cjs');
-const agentModelResolve = require('./lib/agentModelResolve.cjs');
-const { resolveEpicEffort, effortArgs } = require('./lib/agentEffortResolve.cjs');
-const { planEpicSpawn } = require('./lib/epicSpawnPlan.cjs');
+const sessionSlots = require('./lib/scheduler/sessionSlots.cjs');
+const opsErrorLog = require('./lib/telemetry/opsErrorLog.cjs');
+const { killTree, detachedSpawnOpts } = require('./lib/process/killTree.cjs');
+const agentModelResolve = require('./lib/claude/agentModelResolve.cjs');
+const { resolveEpicEffort, effortArgs } = require('./lib/claude/agentEffortResolve.cjs');
+const { planEpicSpawn } = require('./lib/epic/epicSpawnPlan.cjs');
 const logs = require('./logs.cjs');
-const { createHeadTailBuffer } = require('./lib/headTailBuffer.cjs');
+const { createHeadTailBuffer } = require('./lib/util/headTailBuffer.cjs');
 
 // Caps on per-run stream buffers (a run can last hours).
 const STDERR_TAIL_MAX = 64 * 1024;
@@ -424,7 +424,7 @@ function pump() {
     if (idx === -1) break;
     // The chat lane cap is a POLICY bound; actual capacity comes from the
     // Session-Manager-wide slot pool shared with the scheduler
-    // (lib/sessionSlots.cjs). No slot → everyone keeps waiting; the next
+    // (lib/scheduler/sessionSlots.cjs). No slot → everyone keeps waiting; the next
     // settle() in either subsystem re-pumps.
     const slotToken = sessionSlots.acquire(`chat:${waiting[idx].tabId}`);
     if (!slotToken) break;
@@ -982,7 +982,7 @@ function requestExternalNewSession(payload) {
  * job; this only owns route logic + body parsing).
  */
 function registerAdminRoute(adminHttp) {
-  const { readBody, sendJson } = require('./lib/localAdminHttp.cjs');
+  const { readBody, sendJson } = require('./lib/feedback-remote/localAdminHttp.cjs');
   const { schemas } = require('./ipcSchemas.cjs');
 
   adminHttp.registerRoute('POST', '/admin/chat/send-prompt', async (req, res) => {
@@ -1008,10 +1008,26 @@ function registerAdminRoute(adminHttp) {
 
 // ─── IPC handler registration ─────────────────────────────────────────────
 
+/**
+ * Record a chat prompt into the human prompt ledger, only when the renderer
+ * explicitly declared origin === 'human'. Absent/other origins are not-human
+ * (fail-closed). Never throws.
+ * @param {{ sessionId: string, prompt: string, origin?: string }} args
+ */
+function noteChatRunOrigin({ sessionId, prompt, origin }) {
+  try {
+    if (origin !== 'human') return;
+    require('./lib/feedback-remote/humanPromptLedger.cjs').recordHumanPrompt(sessionId, prompt);
+  } catch {
+    /* never throws */
+  }
+}
+
 function registerChatHandlers() {
   const { schemas, validated } = require('./ipcSchemas.cjs');
 
-  ipcMain.handle('chat:run', validated(schemas.chatRun, async ({ tabId, sessionId, prompt, cwd, resume, promptId }) => {
+  ipcMain.handle('chat:run', validated(schemas.chatRun, async ({ tabId, sessionId, prompt, cwd, resume, promptId, origin }) => {
+    noteChatRunOrigin({ sessionId, prompt, origin });
     // Report what actually happened instead of an unconditional { ok: true }.
     // A user send is always accepted now (queued behind the tab's live run if
     // one holds it), but the renderer gets the truth either way rather than a
@@ -1042,6 +1058,7 @@ module.exports = {
   __liveSessionCount: () => liveSessions.size,
   attachWindow,
   registerChatHandlers,
+  noteChatRunOrigin,
   parseStopSignal,
   splitStopSignal,
   parseContextUsageMarkdown,

package/src/main/config.cjs

@@ -23,9 +23,9 @@ const { assertOpsWrite, opsPath, OWNERS } = require('./lib/opsOwnership.cjs');
 const chokidar = require('chokidar');
 const logs = require('./logs.cjs');
 const { sendIfAlive } = require('./lib/sendToRenderer.cjs');
-const { expandHome } = require('./lib/expandHome.cjs');
+const { expandHome } = require('./lib/util/expandHome.cjs');
 const { listReferencedFiles } = require('./lib/importReferences.cjs');
-const atomicFs = require('./lib/atomicFs.cjs');
+const atomicFs = require('./lib/util/atomicFs.cjs');
 
 /** Map<watchKey, {watcher, refCount}> — one chokidar watcher per path (+ depth, see watchKeyOf). */
 const watchers = new Map();
@@ -392,8 +392,21 @@ function watchKeyOf(key, depth) {
  */
 function watch(paths, senderId, opts) {
   const depth = opts?.depth;
+  const watched = [];
+  const rejected = [];
   for (const rawPath of paths) {
-    validatePath(expandHome(rawPath)); // security check — throws if out of bounds
+    try {
+      validatePath(expandHome(rawPath)); // security check — throws if out of bounds
+    } catch (err) {
+      // Per-path: one bad path must not abort the rest of the batch.
+      rejected.push(rawPath);
+      if (!warnedRejectedPaths.has(rawPath)) {
+        warnedRejectedPaths.add(rawPath);
+        logs.writeLine({ level: 'warn', scope: 'config', message: 'config:watch path reject', meta: { path: rawPath, error: err?.message } });
+      }
+      continue;
+    }
+    watched.push(rawPath);
     const key = normalizePathKey(rawPath);
     const mapKey = watchKeyOf(key, depth);
     if (senderId != null) {
@@ -430,8 +443,12 @@ function watch(paths, senderId, opts) {
     });
     watchers.set(mapKey, { watcher: w, refCount: 1 });
   }
+  return { watched, rejected };
 }
 
+// Distinct rejected watch paths already warned about (once per process).
+const warnedRejectedPaths = new Set();
+
 function unwatch(paths, senderId, opts) {
   for (const rawPath of paths) {
     const key = watchKeyOf(normalizePathKey(rawPath), opts?.depth);

package/src/main/crashDiagnostics.cjs

@@ -26,8 +26,8 @@
 const { app, powerSaveBlocker, powerMonitor, crashReporter } = require('electron');
 const fs = require('node:fs');
 const path = require('node:path');
-const { reportCrash } = require('./lib/crashTelemetry.cjs');
-const { createLoopDelayMonitor, stallVerdict } = require('./lib/loopDelay.cjs');
+const { reportCrash } = require('./lib/telemetry/crashTelemetry.cjs');
+const { createLoopDelayMonitor, stallVerdict } = require('./lib/util/loopDelay.cjs');
 
 let logs = null;
 let getPowerBlockerId = () => -1;

package/src/main/docEdit.cjs

@@ -17,12 +17,12 @@
 const { ipcMain } = require('electron');
 const { spawn } = require('node:child_process');
 const crypto = require('node:crypto');
-const { resolveClaudeBin, claudeSpawnTarget } = require('./lib/claudeBin.cjs');
-const { headlessPermissionArgs, ensureCliCapsProbed } = require('./lib/claudeCliCaps.cjs');
-const { withProcRole } = require('./lib/cleanEnv.cjs');
-const { extractJson } = require('./lib/extractJson.cjs');
+const { resolveClaudeBin, claudeSpawnTarget } = require('./lib/claude/claudeBin.cjs');
+const { headlessPermissionArgs, ensureCliCapsProbed } = require('./lib/claude/claudeCliCaps.cjs');
+const { withProcRole } = require('./lib/process/cleanEnv.cjs');
+const { extractJson } = require('./lib/util/extractJson.cjs');
 const { assertInsideHome } = require('./lib/insideHome.cjs');
-const { expandHome } = require('./lib/expandHome.cjs');
+const { expandHome } = require('./lib/util/expandHome.cjs');
 const chatRunner = require('./chatRunner.cjs');
 
 // System prompt sets the role server-side so the selection is treated as

package/src/main/files.cjs

@@ -21,8 +21,8 @@ const os = require('node:os');
 
 const { z } = require('zod');
 const { assertInsideHome } = require('./lib/insideHome.cjs');
-const { expandHome } = require('./lib/expandHome.cjs');
-const atomicFs = require('./lib/atomicFs.cjs');
+const { expandHome } = require('./lib/util/expandHome.cjs');
+const atomicFs = require('./lib/util/atomicFs.cjs');
 const { schemas } = require('./ipcSchemas.cjs');
 
 /**

package/src/main/git.cjs

@@ -23,7 +23,7 @@ const { spawn } = require('node:child_process');
 const path = require('node:path');
 const { schemas } = require('./ipcSchemas.cjs');
 const { validatePath } = require('./config.cjs');
-const { LRUCache } = require('./lib/lruCache.cjs');
+const { LRUCache } = require('./lib/util/lruCache.cjs');
 
 const GIT_TIMEOUT_MS = 5_000;
 const CACHE_TTL_MS = 5_000;

package/src/main/health.cjs

@@ -1,7 +1,7 @@
 /**
  * health.cjs — health check for session-manager Electron app.
  * Verifies: app startup, IPC responsiveness, scheduler health, watchers active.
- * Exported as check() for /local-project-health skill.
+ * Exported as check(); run via `npm run health`.
  */
 
 const fs = require('node:fs');
@@ -9,23 +9,25 @@ const fsp = require('node:fs/promises');
 const path = require('node:path');
 const os = require('node:os');
 const { execFileSync } = require('node:child_process');
-const { POLL_INTERVAL_MS, loadGateThreshold } = require('./lib/schedulerConfig.cjs');
+const { POLL_INTERVAL_MS, loadGateThreshold } = require('./lib/scheduler/schedulerConfig.cjs');
 const { opsPath } = require('./lib/opsOwnership.cjs');
-const { effectivePaused } = require('./lib/upgradeDrain.cjs');
-const { checkPersonaImports } = require('./lib/personaImportHealth.cjs');
-const { checkDelegationReadiness } = require('./lib/delegationReadiness.cjs');
-const { resolvePrdsDirs } = require('./lib/prdLocations.cjs');
-const { migratePrds } = require('./lib/prdMigration.cjs');
-const queueStore = require('./lib/queueStore.cjs');
-const schedulerPaths = require('./lib/schedulerPaths.cjs');
-const { evaluateDispatchLiveness } = require('./lib/watchdogHelpers.cjs');
-const { computeStallSummary, computeDepHistorySatisfaction, FAILURE_STREAK_ESCALATION_MS, classifyQueueStarvation, launchBlockedSlugs, STARVE_ESCALATION_MS, REVERIFY_INTERVAL_MS } = require('./scheduler.cjs');
-const { findStarvedProjects, findUnresolvableDepRoots, DEFAULT_PROJECT_CWD, DEP_HISTORY_FAIL_OPEN } = require('./lib/schedulerBatch.cjs');
-const { auditLogPath, readTail } = require('./lib/auditLog.cjs');
+const { effectivePaused } = require('./lib/scheduler/upgradeDrain.cjs');
+const { checkPersonaImports } = require('./lib/persona-macro/personaImportHealth.cjs');
+const { checkDelegationReadiness } = require('./lib/epic/delegationReadiness.cjs');
+const { resolvePrdsDirs } = require('./lib/prd/prdLocations.cjs');
+const { migratePrds } = require('./lib/prd/prdMigration.cjs');
+const queueStore = require('./lib/scheduler/queueStore.cjs');
+const schedulerPaths = require('./lib/scheduler/schedulerPaths.cjs');
+const { evaluateDispatchLiveness } = require('./lib/scheduler/watchdogHelpers.cjs');
+const { computeStallSummary, computeDepHistorySatisfaction, FAILURE_STREAK_ESCALATION_MS } = require('./scheduler/budget.cjs');
+const { classifyQueueStarvation, launchBlockedSlugs, STARVE_ESCALATION_MS } = require('./scheduler/starvation.cjs');
+const { REVERIFY_INTERVAL_MS } = require('./scheduler/reviewLadder.cjs');
+const { findStarvedProjects, findUnresolvableDepRoots, DEFAULT_PROJECT_CWD, DEP_HISTORY_FAIL_OPEN } = require('./lib/scheduler/schedulerBatch.cjs');
+const { auditLogPath, readTail } = require('./lib/telemetry/auditLog.cjs');
 const { resolveBuildIdentity } = require('./lib/buildIdentity.cjs');
-const { computeReport, isRetentionEnabled, liveKeysFromJobs } = require('./lib/runLogRetention.cjs');
+const { computeReport, isRetentionEnabled, liveKeysFromJobs } = require('./lib/scheduler/runLogRetention.cjs');
 const { allProjectCwds } = require('./lib/activeSessions.cjs');
-const { scanEpicTranscripts } = require('./lib/epicTranscriptDiagnostic.cjs');
+const { scanEpicTranscripts } = require('./lib/epic/epicTranscriptDiagnostic.cjs');
 
 const MAX_LOG_AGE_MS = 5 * 60_000; // 5 min — warn if no logs this old
 const PROJECT_ROOT = path.resolve(__dirname, '../..');
@@ -106,7 +108,7 @@ function evaluateTickLiveness(queueState, heartbeat, now, runningCount) {
   // sessionSlots pool is the only limit. Read it lazily so this stays a pure
   // function of its args when a caller supplies slotCap explicitly.
   const concurrencyCap = queueState.slotCap
-    ?? (() => { try { return require('./lib/sessionSlots.cjs').totalSlots(); } catch { return Infinity; } })();
+    ?? (() => { try { return require('./lib/scheduler/sessionSlots.cjs').totalSlots(); } catch { return Infinity; } })();
 
   if (pending.length === 0) return { stalled: false, reason: 'no-pending-jobs' };
   if (effectivePaused(queueState)) return { stalled: false, reason: queueState.paused ? 'paused' : 'draining' };
@@ -641,7 +643,7 @@ function evaluateBuildFreshness({ running = null, installedOnDisk = null, repoHe
  * names the cause and the fix (`claude login`).
  *
  * NON-CRITICAL by design: reported in components.credentials + issues so
- * /local-project-health shows it, but it does not flip status.ok — health must
+ * `npm run health` shows it, but it does not flip status.ok — health must
  * not hard-fail a repo checkout just because THIS machine's token lapsed, and
  * an expired token is an operator action (re-login), not a code defect. Maps:
  *   kind 'auth'   → not ok, actionable `claude login` message (the real block)
@@ -897,7 +899,7 @@ async function check(opts = {}) {
       path: queuePath,
       jobs: Object.keys(queueState.jobs || {}).length,
       running: runningCount,
-      // Deliberate restart drain (lib/upgradeDrain.cjs) — reported so it is never read as a stall.
+      // Deliberate restart drain (lib/scheduler/upgradeDrain.cjs) — reported so it is never read as a stall.
       drain: queueState.drain?.active ? { since: queueState.drain.since ?? null, requestedAt: queueState.drain.requestedAt ?? null } : null,
       failed: failedCount,
       needsReview: needsReviewCount,

package/src/main/heapSnapshot.cjs

@@ -24,7 +24,7 @@
 
 const path = require('node:path');
 const fsp = require('node:fs/promises');
-const { heapSnapshotDir } = require('./lib/schedulerPaths.cjs');
+const { heapSnapshotDir } = require('./lib/scheduler/schedulerPaths.cjs');
 
 const CHANNEL = 'diagnostics:heap-snapshot';
 const DEFAULT_TIMEOUT_MS = 3 * 60 * 1000; // 3 min — snapshots can be multi-hundred-MB

package/src/main/historyAggregator.cjs

@@ -50,8 +50,8 @@ function resolvePricingKey(modelId) {
 }
 
 // ── LRU cache ─────────────────────────────────────────────────────────────────
-// Shared implementation: lib/lruCache.cjs (re-exported below for existing callers).
-const { LRUCache } = require('./lib/lruCache.cjs');
+// Shared implementation: lib/util/lruCache.cjs (re-exported below for existing callers).
+const { LRUCache } = require('./lib/util/lruCache.cjs');
 
 // ── history:updated broadcast ─────────────────────────────────────────────────
 // Open History pages re-fetch on this event. Throttled leading+trailing so a