claude-code-session-manager 0.111.0 → 0.113.0

package/src/main/lib/{macroAdminRoutes.cjs → feedback-remote/macroAdminRoutes.cjs}

@@ -19,7 +19,7 @@
 
 const { readBody, sendJson } = require('./localAdminHttp.cjs');
 const { resolveCwd } = require('./projectHomeAdminRoutes.cjs');
-const macroLibrary = require('./macroLibrary.cjs');
+const macroLibrary = require('../persona-macro/macroLibrary.cjs');
 
 function listHandler(onChanged, libOpts) {
   return async (_req, res, query) => {

package/src/main/lib/{projectHomeAdminRoutes.cjs → feedback-remote/projectHomeAdminRoutes.cjs}

@@ -23,10 +23,10 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { readBody, sendJson } = require('./localAdminHttp.cjs');
-const { resolveProjectContext } = require('./projectRootResolve.cjs');
-const { opsPath, OPS_ROOT_DIR } = require('./opsOwnership.cjs');
-const config = require('../config.cjs');
-const { schemas } = require('../ipcSchemas.cjs');
+const { resolveProjectContext } = require('../projectRootResolve.cjs');
+const { opsPath, OPS_ROOT_DIR } = require('../opsOwnership.cjs');
+const config = require('../../config.cjs');
+const { schemas } = require('../../ipcSchemas.cjs');
 
 const MAX_HTML_BYTES = 1024 * 1024;
 const MAX_DEMO_VIDEO_BYTES = 2 * 1024 * 1024;

package/src/main/lib/{relayClientAuth.cjs → feedback-remote/relayClientAuth.cjs}

@@ -8,8 +8,8 @@
 const fs = require('node:fs');
 const https = require('node:https');
 const path = require('node:path');
-const { claudeHome } = require('./schedulerPaths.cjs');
-const { writeJsonAtomicSync, readJsonOrSync } = require('./atomicFs.cjs');
+const { claudeHome } = require('../scheduler/schedulerPaths.cjs');
+const { writeJsonAtomicSync, readJsonOrSync } = require('../util/atomicFs.cjs');
 
 const RELAY_CLIENT_API_BASE = 'https://bilko.run/api/sm-relay';
 const REQUEST_TIMEOUT_MS = 15_000;

package/src/main/lib/{remoteClientSessions.cjs → feedback-remote/remoteClientSessions.cjs}

@@ -9,7 +9,7 @@
  * which preserves single-client behaviour.
  */
 
-const { makeState } = require('./e2eStateMachine.cjs')
+const { makeState } = require('../e2eStateMachine.cjs')
 
 const LEGACY_CLIENT_KEY = 'legacy'
 const MAX_KEY_LEN = 64

package/src/main/lib/{gitWorktree.cjs → git/gitWorktree.cjs}

@@ -16,7 +16,7 @@
  *
  * `<cwd>/session-manager-operations/` (PRDs, queue state, run logs, the
  * active-index.json Epic store) is resolved from a project's cwd by
- * lib/prdLocations.cjs, lib/queueStore.cjs, and every prompt-sessions IPC
+ * lib/prd/prdLocations.cjs, lib/scheduler/queueStore.cjs, and every prompt-sessions IPC
  * handler — all of them take `cwd` as an explicit parameter, never
  * `process.cwd()`. That means the ops root follows WHATEVER cwd value the
  * caller passes in. A prior incident (recorded in this project's memory as
@@ -53,8 +53,8 @@ const fsp = require('node:fs/promises');
 const path = require('node:path');
 const os = require('node:os');
 const crypto = require('node:crypto');
-const { OPS_ROOT_DIR } = require('./opsOwnership.cjs');
-const schedulerPaths = require('./schedulerPaths.cjs');
+const { OPS_ROOT_DIR } = require('../opsOwnership.cjs');
+const schedulerPaths = require('../scheduler/schedulerPaths.cjs');
 const sharedGitExec = require('./gitExec.cjs');
 
 // Per-kind configuration. Roots are kept OUTSIDE any project's own tree
@@ -148,7 +148,7 @@ function worktreeRootFor(kind) {
 function isWorktreeDisabled(kind, cwd) {
   if (process.env[configFor(kind).disableEnv] === '1') return true;
   if (kind === 'epic' && cwd) {
-    const { isEpicWorktreeDisabledForProject } = require('./epicWorktreeProjectConfig.cjs');
+    const { isEpicWorktreeDisabledForProject } = require('../epic/epicWorktreeProjectConfig.cjs');
     if (isEpicWorktreeDisabledForProject(cwd)) return true;
   }
   return false;
@@ -169,7 +169,7 @@ function getMaxConcurrentWorktrees(kind) {
   const raw = Number(process.env[cfg.maxEnv]);
   if (Number.isFinite(raw) && raw > 0) return Math.floor(raw);
   if (kind === 'job') {
-    const sessionSlots = require('./sessionSlots.cjs');
+    const sessionSlots = require('../scheduler/sessionSlots.cjs');
     return Math.max(cfg.defaultMax, sessionSlots.totalSlots());
   }
   return cfg.defaultMax;
@@ -1546,7 +1546,7 @@ async function salvageWorktreeDiff({ cwd, outFile }) {
     }
     const patch = await execGit(['diff', 'HEAD', '--binary'], { cwd, timeout: 30_000 });
     if (!patch || !patch.trim()) return { ok: false };
-    const { writeTextAtomic } = require('../config.cjs');
+    const { writeTextAtomic } = require('../../config.cjs');
     await writeTextAtomic(outFile, patch);
     return { ok: true, bytes: Buffer.byteLength(patch, 'utf8') };
   } catch {
@@ -1628,7 +1628,7 @@ async function salvageDirtyDelta({ cwd, paths, outFile }) {
       }
     }
     if (!patch.trim()) return { ok: false };
-    const { writeTextAtomic } = require('../config.cjs');
+    const { writeTextAtomic } = require('../../config.cjs');
     await writeTextAtomic(outFile, patch);
     return { ok: true, bytes: Buffer.byteLength(patch, 'utf8') };
   } catch {

package/src/main/lib/historyRollup.cjs

@@ -28,7 +28,7 @@
 const path = require('node:path');
 const config = require('../config.cjs');
 
-const { historyRollupPath } = require('./schedulerPaths.cjs');
+const { historyRollupPath } = require('./scheduler/schedulerPaths.cjs');
 const COMPACT_THRESHOLD_BYTES = 5 * 1024 * 1024;
 
 const TOTALS_MODEL_ID = '';

package/src/main/lib/importReferences.cjs

@@ -7,7 +7,7 @@
  */
 
 const fs = require('node:fs');
-const { walkImports } = require('./personaImportHealth.cjs');
+const { walkImports } = require('./persona-macro/personaImportHealth.cjs');
 
 // Maps walkImports' result shape to what the renderer panel needs per file:
 // resolved path, existence, size, a rough token estimate, and overall health.

package/src/main/lib/machineProfile.cjs

@@ -15,7 +15,7 @@
 const os = require('node:os');
 const crypto = require('node:crypto');
 const path = require('node:path');
-const claudeBin = require('./claudeBin.cjs');
+const claudeBin = require('./claude/claudeBin.cjs');
 const { isPackagedApp } = require('./appRuntime.cjs');
 
 function resolveElectronApp() {

package/src/main/lib/mcpToolCatalog.cjs

@@ -243,7 +243,11 @@ const MCP_TOOL_CATALOG = [
       + '`acceptanceCriteria`; put evidence, symptom and references in `body`. Name the file in THEIR repo '
       + 'that looks responsible if you know it. When one request is split into several proposals, send '
       + 'them ALL with one shared `series` {key, title, total} (plus each one\'s `index`) and summarise '
-      + 'the overall plan in each motivation.',
+      + 'the overall plan in each motivation. TWO MODES: (1) agent-initiated (your own idea) = PROPOSED, a '
+      + 'human in the receiving project must approve it; pass neither autoStart nor humanRequestQuote. '
+      + '(2) human-requested = the human in THIS conversation explicitly asked for the work in that other '
+      + 'project: pass `autoStart: true` plus `humanRequestQuote`, copied VERBATIM from their own message, '
+      + 'which must name the target project. An unverified request silently falls back to PROPOSED.',
     whenNotToUse: 'WHEN NOT TO USE IT: for work in the project you are ALREADY in, run /develop inside the Epic you '
       + 'are already in — this tool refuses toCwd === fromCwd outright.',
     exampleArgs: {
@@ -258,11 +262,13 @@ const MCP_TOOL_CATALOG = [
       series: { key: 'shared-admin-api-f', title: 'Shared admin API field F', index: 1, total: 2 },
       body: 'Symptom: X. Observed while doing Y in session-manager. Expected: Z. Suspected file: <path in their repo>.',
     },
-    notes: 'WHAT THIS DOES NOT DO: it does not start anything, queue a PRD, or spend a token. The session '
+    notes: 'WHAT THIS DOES NOT DO: it never writes code or queues a PRD itself. Agent-initiated, the session '
       + 'lands as `proposed` and runs only if a human in the RECEIVING project presses "Approve & start". '
+      + 'With a verified autoStart + humanRequestQuote the result status is `auto-approved` and the session '
+      + 'starts on its own; otherwise it stays proposed (check the note for the reason). '
       + 'There is no callback and no reply channel — do not wait for an answer, and do not tell the user '
       + 'the other project has "been fixed" or "is working on it". Report only that the proposal was '
-      + 'delivered.',
+      + 'delivered, or that the session was auto-approved and is starting.',
   },
   {
     name: 'project_home_write',

package/src/main/lib/openExternalApp.cjs

@@ -14,7 +14,7 @@ const { execFileSync, spawn } = require('node:child_process');
 const path = require('node:path');
 const fsp = require('node:fs/promises');
 const { shell } = require('electron');
-const { cleanChildEnv } = require('./cleanEnv.cjs');
+const { cleanChildEnv } = require('./process/cleanEnv.cjs');
 
 // IMAGE_RE — extensions opened in the OS default viewer, not a code editor.
 // Keep in sync with the comment in index.cjs open-file-in-editor handler.

package/src/main/lib/opsOwnership.cjs

@@ -24,9 +24,9 @@
  *
  * Enforcement points (every write path into the ops root calls assertOpsWrite):
  *   - config.cjs writeTextAtomic / writeBinaryAtomic / writeJson / writeJsonSync
- *   - lib/epicMint.cjs      (raw fs tmp+rename)
- *   - lib/queueStore.cjs    (raw fs tmp+rename)
- *   - lib/opsErrorLog.cjs   (raw fs append, JSONL error log)
+ *   - lib/epic/epicMint.cjs      (raw fs tmp+rename)
+ *   - lib/scheduler/queueStore.cjs    (raw fs tmp+rename)
+ *   - lib/telemetry/opsErrorLog.cjs   (raw fs append, JSONL error log)
  * Renderer callers declare their writer id through the IPC payload.
  */
 

package/src/main/lib/{agentPersonaSchema.cjs → persona-macro/agentPersonaSchema.cjs}

@@ -24,8 +24,8 @@
 
 const path = require('node:path');
 const { z } = require('zod');
-const { WorkTypeSchema, LEGACY_WORK_TYPES } = require('./workTypeLibrary.cjs');
-const { PERSONA_NAME_RE, ALL_PROJECTS } = require('../agentLibrary.cjs');
+const { WorkTypeSchema, LEGACY_WORK_TYPES } = require('../prd/workTypeLibrary.cjs');
+const { PERSONA_NAME_RE, ALL_PROJECTS } = require('../../agentLibrary.cjs');
 
 // Bounded free-text fields — generous for legitimate persona authoring while
 // still blocking a renderer from writing an effectively-unbounded frontmatter

package/src/main/lib/{macroLibrary.cjs → persona-macro/macroLibrary.cjs}

@@ -38,11 +38,11 @@ const fsp = require('node:fs/promises');
 const path = require('node:path');
 const crypto = require('node:crypto');
 const { z } = require('zod');
-const { writeJsonAtomic } = require('./atomicFs.cjs');
-const { EpicTagSchema } = require('./promptSessionSchema.cjs');
-const { WORK_TYPES } = require('./workTypeLibrary.cjs');
+const { writeJsonAtomic } = require('../util/atomicFs.cjs');
+const { EpicTagSchema } = require('../promptSessionSchema.cjs');
+const { WORK_TYPES } = require('../prd/workTypeLibrary.cjs');
 const { PERSONA_NAME_RE } = require('./personaMerge.cjs');
-const { schedulerHome } = require('./schedulerPaths.cjs');
+const { schedulerHome } = require('../scheduler/schedulerPaths.cjs');
 const { BUILTIN_MACROS } = require('./builtinMacros.cjs');
 
 const ALL_PROJECTS = '*';
@@ -306,7 +306,7 @@ function personasToMacros(personas, now) {
 /** Returns the migrated macros, or `null` on failure (caller must NOT write). */
 async function migrateFromPersonas(opts) {
   try {
-    const listPersonas = (opts && opts.listPersonas) || require('../agentLibrary.cjs').listPersonas;
+    const listPersonas = (opts && opts.listPersonas) || require('../../agentLibrary.cjs').listPersonas;
     const personas = await listPersonas();
     return personasToMacros(personas, new Date().toISOString());
   } catch (err) {

package/src/main/lib/{personaMerge.cjs → persona-macro/personaMerge.cjs}

@@ -33,9 +33,9 @@
  */
 
 const fs = require('node:fs');
-const { splitFrontmatter } = require('./prdFrontmatter.cjs');
-const { resolvePersonaPaths } = require('./epicMint.cjs');
-const configMgr = require('../config.cjs');
+const { splitFrontmatter } = require('../prd/prdFrontmatter.cjs');
+const { resolvePersonaPaths } = require('../epic/epicMint.cjs');
+const configMgr = require('../../config.cjs');
 
 /** Filename-safe persona name: lowercase, hyphenated, matches the `.md` files on disk. */
 const PERSONA_NAME_RE = /^[a-z][a-z0-9-]*$/;
@@ -47,7 +47,7 @@ function reportOverlayIssueOnce(cwd, agentType, overlayPath, message) {
   if (reportedIssues.has(key)) return;
   reportedIssues.add(key);
   try {
-    const { appendError } = require('./opsErrorLog.cjs');
+    const { appendError } = require('../telemetry/opsErrorLog.cjs');
     appendError({
       cwd,
       scope: 'personaMerge',

package/src/main/lib/{depSlugResolve.cjs → prd/depSlugResolve.cjs}

@@ -30,6 +30,21 @@ function resolveDepSlug(depSlug, candidateSlugs) {
   return candidateSlugs.filter((slug) => bareSlug(slug) === bare);
 }
 
+/**
+ * Is this dep ROW satisfied? `completed`, or a `skipped` row stamped
+ * `needsReviewAutoResolvedSkip` — the bounded needs_review auto-resolve's
+ * terminal decision (scheduler.cjs applyNeedsReviewAutoResolve), deliberately
+ * not a permanent block. Shared by schedulerBatch.findBlockingDep (dispatch)
+ * and runVerify.checkDeps (post-run): when they disagreed, the picker fired a
+ * dependent of an auto-skipped row and the verifier downgraded every finished
+ * run back to pending on "is skipped (need completed)" — an unbounded billed
+ * re-run loop (Bilko-Launch-Kit validator, ~20 runs, 2026-10-11).
+ */
+function isSatisfiedDepRow(row) {
+  return row?.status === 'completed'
+    || (row?.status === 'skipped' && row.needsReviewAutoResolvedSkip === true);
+}
+
 /**
  * Levenshtein edit distance. O(n*m) in the two strings' lengths — fine here
  * since it only ever runs over short slug strings (<= 60 chars, PRD_CREATE_SLUG_RE's
@@ -69,4 +84,4 @@ function findNearMatches(depSlug, candidateSlugs, limit = 3) {
     .map((entry) => entry.slug);
 }
 
-module.exports = { bareSlug, resolveDepSlug, findNearMatches };
+module.exports = { bareSlug, resolveDepSlug, findNearMatches, isSatisfiedDepRow };

package/src/main/lib/{prdAdminRoutes.cjs → prd/prdAdminRoutes.cjs}

@@ -25,13 +25,13 @@
  */
 'use strict';
 
-const { schemas } = require('../ipcSchemas.cjs');
-const { readBody, sendJson } = require('./localAdminHttp.cjs');
-const { appendAuditEvent } = require('./auditLog.cjs');
-const queueOps = require('../queueOps.cjs');
-const { MCP_TOOL_CATALOG, MCP_RECIPES } = require('./mcpToolCatalog.cjs');
-const { checkDelegationReadiness } = require('./delegationReadiness.cjs');
-const { resolveProjectContext } = require('./projectRootResolve.cjs');
+const { schemas } = require('../../ipcSchemas.cjs');
+const { readBody, sendJson } = require('../feedback-remote/localAdminHttp.cjs');
+const { appendAuditEvent } = require('../telemetry/auditLog.cjs');
+const queueOps = require('../../queueOps.cjs');
+const { MCP_TOOL_CATALOG, MCP_RECIPES } = require('../mcpToolCatalog.cjs');
+const { checkDelegationReadiness } = require('../epic/delegationReadiness.cjs');
+const { resolveProjectContext } = require('../projectRootResolve.cjs');
 
 function parseJsonBody(raw) {
   try {

package/src/main/lib/{prdAgentType.cjs → prd/prdAgentType.cjs}

@@ -13,8 +13,8 @@
  * "available personas" name list surfaced in the write-time rejection error.
  */
 
-const { personaFileExists, resolvePersonaPaths } = require('./epicMint.cjs');
-const { listPersonas } = require('../agentLibrary.cjs');
+const { personaFileExists, resolvePersonaPaths } = require('../epic/epicMint.cjs');
+const { listPersonas } = require('../../agentLibrary.cjs');
 
 /** PRD execution's documented default persona (dev-lead.md's own frontmatter role). */
 const DEFAULT_PRD_AGENT_TYPE = 'dev-lead';
@@ -41,7 +41,7 @@ function reportDanglingAgentTypeOnce(cwd, agentType, deps = {}) {
     // Required lazily, same rationale as agentModelResolve.cjs's
     // logDanglingPersonaOnce: pay for this leaf module only on the (rare)
     // miss path.
-    const { appendError } = require('./opsErrorLog.cjs');
+    const { appendError } = require('../telemetry/opsErrorLog.cjs');
     appendError({
       cwd,
       scope: 'prdAgentType',

package/src/main/lib/{prdCreate.cjs → prd/prdCreate.cjs}

@@ -18,22 +18,22 @@
 
 const fsp = require('node:fs/promises');
 const path = require('node:path');
-const { schemas, PRD_CREATE_SLUG_RE } = require('../ipcSchemas.cjs');
-const { kebabCase } = require('./kebabCase.cjs');
-const config = require('../config.cjs');
-const { expandHome } = require('./expandHome.cjs');
-const { readBody, sendJson } = require('./localAdminHttp.cjs');
-const { readActiveIndex } = require('./epicMint.cjs');
-const { appendAuditEvent } = require('./auditLog.cjs');
-const { resolveProjectContext } = require('./projectRootResolve.cjs');
-const { fixChainDepthOf, baseSlugOf } = require('./fixChainDepth.cjs');
+const { schemas, PRD_CREATE_SLUG_RE } = require('../../ipcSchemas.cjs');
+const { kebabCase } = require('../util/kebabCase.cjs');
+const config = require('../../config.cjs');
+const { expandHome } = require('../util/expandHome.cjs');
+const { readBody, sendJson } = require('../feedback-remote/localAdminHttp.cjs');
+const { readActiveIndex } = require('../epic/epicMint.cjs');
+const { appendAuditEvent } = require('../telemetry/auditLog.cjs');
+const { resolveProjectContext } = require('../projectRootResolve.cjs');
+const { fixChainDepthOf, baseSlugOf } = require('../scheduler/fixChainDepth.cjs');
 const { DEFAULT_PRD_AGENT_TYPE, assertAgentTypeWritable } = require('./prdAgentType.cjs');
 const { resolveDepSlug, findNearMatches } = require('./depSlugResolve.cjs');
-const { isFixPlanSlug } = require('./fixPlanSlug.cjs');
+const { isFixPlanSlug } = require('../scheduler/fixPlanSlug.cjs');
 const { isIncomplete, resolveChainTerminals, isValidPlanId, mintPlanId, resolveInheritedPlanId } = require('./prdDisposition.cjs');
 const { sizingWarnings } = require('./prdSizing.cjs');
 const { validateGate, validateFiles, renderFilesSection, renderGateSection } = require('./prdGateFiles.cjs');
-const { resolveGate, parseChain, isNoneGate } = require('./definitionOfDone.cjs');
+const { resolveGate, parseChain, isNoneGate } = require('../scheduler/definitionOfDone.cjs');
 
 // A caller-supplied slug that already starts with its own `NN-` (e.g.
 // "254-perf-x") used to silently become the double-prefixed row
@@ -55,7 +55,7 @@ const SLUG_HAS_NN_PREFIX_RE = /^(\d+)-/;
 const FIX_CHAIN_DEPTH_CAP = 1;
 
 const STANDARDS_PATH = path.join(
-  __dirname, '..', '..', '..',
+  __dirname, '..', '..', '..', '..',
   'plugins', 'session-manager-dev', 'skills', 'develop', 'standards.md',
 );
 

package/src/main/lib/{prdDeclaredPaths.cjs → prd/prdDeclaredPaths.cjs}

@@ -11,7 +11,7 @@
 
 const fs = require('node:fs');
 const { splitFrontmatter } = require('./prdFrontmatter.cjs');
-const { extractSection } = require('./definitionOfDone.cjs');
+const { extractSection } = require('../scheduler/definitionOfDone.cjs');
 
 // Backtick-quoted, extension-bearing relative paths, e.g. `src/main/scheduler.cjs`
 // or `src/main/scheduler.cjs:490` (trailing :line dropped). Requires at least

package/src/main/lib/{prdGateFiles.cjs → prd/prdGateFiles.cjs}

@@ -15,7 +15,7 @@
  * No I/O, no scheduler imports — pure string-in, string/array-out.
  */
 
-const { parseChain, explainChain, isNoneGate } = require('./definitionOfDone.cjs');
+const { parseChain, explainChain, isNoneGate } = require('../scheduler/definitionOfDone.cjs');
 
 const GATE_MIN_ENTRIES = 1;
 const GATE_MAX_ENTRIES = 10;

package/src/main/lib/{prdLocations.cjs → prd/prdLocations.cjs}

@@ -27,9 +27,9 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { activeProjectCwds, allProjectCwds } = require('./activeSessions.cjs');
+const { activeProjectCwds, allProjectCwds } = require('../activeSessions.cjs');
 
-const { opsPath, OPS_ROOT_DIR } = require('./opsOwnership.cjs');
+const { opsPath, OPS_ROOT_DIR } = require('../opsOwnership.cjs');
 
 // Segments UNDER the ops root; the ops root itself is resolved by
 // opsOwnership.opsPath (PRD 1082) — never joined onto a raw cwd here.

package/src/main/lib/{prdMigration.cjs → prd/prdMigration.cjs}

@@ -18,9 +18,9 @@ const fsp = require('node:fs/promises');
 const path = require('node:path');
 const { splitFrontmatter, parsePrdFile, serializePrdFile } = require('./prdFrontmatter.cjs');
 const { resolvePrdWriteDir, resolvePrdsDirs } = require('./prdLocations.cjs');
-const { projectQueuePath } = require('./queueStore.cjs');
-const { expandHome } = require('./expandHome.cjs');
-const atomicFs = require('./atomicFs.cjs');
+const { projectQueuePath } = require('../scheduler/queueStore.cjs');
+const { expandHome } = require('../util/expandHome.cjs');
+const atomicFs = require('../util/atomicFs.cjs');
 
 /**
  * Move every `.md` file in legacyPrdsDir whose frontmatter `cwd` resolves to

package/src/main/lib/prereqs.cjs

@@ -11,8 +11,8 @@ const fs = require('node:fs');
 const path = require('node:path');
 const { promisify } = require('node:util');
 const childProcess = require('node:child_process');
-const { pathWithUserBins } = require('./cleanEnv.cjs');
-const { resolveClaudeBin } = require('./claudeBin.cjs');
+const { pathWithUserBins } = require('./process/cleanEnv.cjs');
+const { resolveClaudeBin } = require('./claude/claudeBin.cjs');
 const { readCredentials } = require('./credentials.cjs');
 
 const PROBE_TIMEOUT_MS = 5000;

package/src/main/lib/{instanceLock.cjs → process/instanceLock.cjs}

@@ -28,9 +28,9 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { identity, isDifferentProcess } = require('./procIdentity.cjs');
-const { instanceLockPath } = require('./schedulerPaths.cjs');
-const { appendAuditEvent } = require('./auditLog.cjs');
-const { pidAlive: pidAliveCore } = require('./pidAlive.cjs');
+const { instanceLockPath } = require('../scheduler/schedulerPaths.cjs');
+const { appendAuditEvent } = require('../telemetry/auditLog.cjs');
+const { pidAlive } = require('./pidAlive.cjs');
 
 // Env override is for unit tests only (isolates the lock from the real
 // ~/.claude of the machine running the suite).
@@ -39,13 +39,6 @@ function lockPath() {
     || instanceLockPath();
 }
 
-// Thin alias over pidAlive.cjs's shared pidAlive() — kept as its own named
-// export (rather than inlining the require at every call site) so existing
-// imports of `pidAlive` from this module keep working unchanged.
-function pidAlive(pid) {
-  return pidAliveCore(pid);
-}
-
 function readLock() {
   try {
     const raw = fs.readFileSync(lockPath(), 'utf8');
@@ -121,4 +114,4 @@ function releaseSchedulerOwnership() {
   } catch { /* nothing to release */ }
 }
 
-module.exports = { acquireSchedulerOwnership, releaseSchedulerOwnership, pidAlive, lockPath };
+module.exports = { acquireSchedulerOwnership, releaseSchedulerOwnership, lockPath };

package/src/main/lib/{pidAlive.cjs → process/pidAlive.cjs}

@@ -6,7 +6,7 @@
  * Four independent copies of this exact check had drifted apart:
  * reaperHelpers.cjs's claudePidAlive (bug: caught EPERM and returned false,
  * never crediting a pid it couldn't signal but which demonstrably exists),
- * watchdogHelpers.cjs's isPidAlive, reservationExpiry.cjs's defaultPidAlive,
+ * watchdogHelpers.cjs's old pid check, reservationExpiry.cjs's old one,
  * and instanceLock.cjs's pidAlive (these three already treated EPERM as
  * alive, but each reimplemented the same three lines). This module is now
  * the one place the rule lives; the others re-export thin aliases so every

package/src/main/lib/{procName.cjs → process/procName.cjs}

@@ -27,7 +27,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
-const { procnamesRoot } = require('./schedulerPaths.cjs');
+const { procnamesRoot } = require('../scheduler/schedulerPaths.cjs');
 const MAX_ALIAS_LEN = 15; // Linux TASK_COMM_LEN (16) minus NUL
 const MAX_LABEL_LEN = 120;
 
@@ -37,7 +37,7 @@ function resolveBare(bin) {
   if (path.isAbsolute(bin)) return bin;
   try {
     // Lazy: openExternalApp requires 'electron', unavailable outside the app.
-    const { findCommand } = require('./openExternalApp.cjs');
+    const { findCommand } = require('../openExternalApp.cjs');
     const found = findCommand(bin);
     return found && path.isAbsolute(found) ? found : null;
   } catch { return null; }

package/src/main/lib/{timeoutShim.cjs → process/timeoutShim.cjs}

@@ -22,7 +22,7 @@
 const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
-const { writeTextAtomic, addAllowedRoot } = require('../config.cjs');
+const { writeTextAtomic, addAllowedRoot } = require('../../config.cjs');
 
 function shimDir(homeDir = os.homedir()) {
   return path.join(homeDir, '.claude', 'session-manager', 'bin');

package/src/main/lib/projectRootResolve.cjs

@@ -35,7 +35,7 @@
 
 const path = require('node:path');
 const { projectRootOf, allProjectCwds } = require('./activeSessions.cjs');
-const { readActiveIndex } = require('./epicMint.cjs');
+const { readActiveIndex } = require('./epic/epicMint.cjs');
 const { isEphemeralCwd } = require('./ephemeralCwd.cjs');
 
 /**

package/src/main/lib/promptSessionSchema.cjs

@@ -14,7 +14,7 @@
 'use strict';
 
 const { z } = require('zod');
-const { WorkTypeSchema, LEGACY_WORK_TYPES } = require('./workTypeLibrary.cjs');
+const { WorkTypeSchema, LEGACY_WORK_TYPES } = require('./prd/workTypeLibrary.cjs');
 
 // Mirrors EpicTag (src/renderer/lib/tagLibrary.ts:10) — the Epic-level
 // mission tag. Epic tag and PRD tag (ipcSchemas.cjs's scheduleRetagPrd `tag`

package/src/main/lib/{definitionOfDone.cjs → scheduler/definitionOfDone.cjs}

@@ -12,11 +12,11 @@ const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { spawn, spawnSync } = require('node:child_process');
-const { splitFrontmatter } = require('./prdFrontmatter.cjs');
-const { resolvePrdWriteDir } = require('./prdLocations.cjs');
+const { splitFrontmatter } = require('../prd/prdFrontmatter.cjs');
+const { resolvePrdWriteDir } = require('../prd/prdLocations.cjs');
 const schedulerPaths = require('./schedulerPaths.cjs');
-const atomicFs = require('./atomicFs.cjs');
-const { resolveSpawn } = require('./winSpawn.cjs');
+const atomicFs = require('../util/atomicFs.cjs');
+const { resolveSpawn } = require('../process/winSpawn.cjs');
 
 // Regex identifying meta/dod slugs that must NOT influence the batchKey.
 // This is the load-bearing loop-avoidance filter: when the gate job itself
@@ -648,12 +648,6 @@ function flagRiskySurfaces(jobs, { prdsDir, gitTimeoutMs = 10_000 } = {}) {
   return results;
 }
 
-// ─── Atomic write helper ───────────────────────────────────────────────────────
-// Delegates to atomicFs.cjs's tmp+rename recipe (pure-node, no Electron import).
-function _writeFileAtomic(absPath, text) {
-  atomicFs.writeTextAtomicSync(absPath, text);
-}
-
 const STATUS_EMOJI = { pass: '✅', fail: '❌', unverifiable: '⚠️' };
 
 /**
@@ -751,7 +745,7 @@ function writeReport(key, { acResults = [], riskFlags = [], runsDir } = {}) {
   ].join('\n');
 
   fs.mkdirSync(dir, { recursive: true });
-  _writeFileAtomic(reportPath, report);
+  atomicFs.writeTextAtomicSync(reportPath, report);
 
   return reportPath;
 }
@@ -882,7 +876,7 @@ function readWatermark(runsDir = schedulerPaths.runsDir()) {
  */
 function writeWatermark(lastFinishedAt, runsDir = schedulerPaths.runsDir()) {
   fs.mkdirSync(runsDir, { recursive: true });
-  _writeFileAtomic(
+  atomicFs.writeTextAtomicSync(
     path.join(runsDir, WATERMARK_FILENAME),
     JSON.stringify({ lastFinishedAt }, null, 2)
   );

package/src/main/lib/scheduler/finalizeReason.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+/**
+ * finalizeReason.cjs — the statusHistory reason for a job's running→terminal
+ * finalize transition. Pure; no I/O.
+ */
+
+/**
+ * @param {{
+ *   effectiveStatus: string,
+ *   verifyResult?: { verdict?: string, reason?: string } | null,
+ *   sigtermOverrideReason?: string | null,
+ *   exitCode?: number | null,
+ * }} input
+ * @returns {string}
+ */
+function finalizeReasonFor({ effectiveStatus, verifyResult, sigtermOverrideReason, exitCode }) {
+  if (sigtermOverrideReason) return sigtermOverrideReason;
+  if (effectiveStatus === 'completed' && verifyResult?.verdict === 'already_satisfied_on_main') {
+    return String(verifyResult.reason);
+  }
+  if (effectiveStatus === 'needs_review' && verifyResult?.verdict) {
+    return verifyResult.reason
+      ? `needs_review: ${verifyResult.verdict} — ${verifyResult.reason}`
+      : `needs_review: ${verifyResult.verdict}`;
+  }
+  return `run finished with exit ${exitCode}`;
+}
+
+module.exports = { finalizeReasonFor };

package/src/main/lib/{fixChainDepth.cjs → scheduler/fixChainDepth.cjs}

@@ -10,7 +10,7 @@
  * since segments are compared for exact equality after splitting on '-'.
  *
  * No filesystem access, no scheduler.cjs dependency — safe to require from
- * lib/prdCreate.cjs without pulling in the scheduler module graph.
+ * lib/prd/prdCreate.cjs without pulling in the scheduler module graph.
  */
 'use strict';
 

package/src/main/lib/scheduler/flatSweepThrottle.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+/** Retired flat `scheduler/prds/` sweep runs at most once per hour per process. */
+const FLAT_SWEEP_INTERVAL_MS = 60 * 60 * 1000;
+
+/**
+ * @param {number} nowMs
+ * @param {number | null} lastRunMs null = never ran this process (always run)
+ * @param {number} [intervalMs]
+ * @returns {boolean}
+ */
+function shouldRunFlatSweep(nowMs, lastRunMs, intervalMs = FLAT_SWEEP_INTERVAL_MS) {
+  if (lastRunMs === null || lastRunMs === undefined) return true;
+  return nowMs - lastRunMs >= intervalMs;
+}
+
+module.exports = { shouldRunFlatSweep, FLAT_SWEEP_INTERVAL_MS };