crewly 1.20.359 → 1.20.360

package/dist/backend/backend/src/index.d.ts

@@ -71,6 +71,16 @@ export declare class CrewlyServer {
     private readonly deferredIdleSettle;
     /** Owner promises past due and never nudged at boot; their agents are restored and reminded once */
     private openCommitmentsAtBoot;
+    /**
+     * The boot restore is over: the queue drained, or there was nothing to
+     * restore. The boot maintenance passes wait for this (crewly#1353).
+     */
+    private bootRestoreDone;
+    /** When this backend booted (the memory hold on boot retries is time-boxed from here) */
+    private readonly bootAt;
+    /** Agents the boot restore handed to the retry because memory was tight (crewly#1353) */
+    private heldBackAtBoot;
+    private heldBackNoticeScheduled;
     private healthMonitoringInterval;
     private backgroundWatchdog;
     constructor(config?: Partial<StartupConfig>);
@@ -164,6 +174,32 @@ export declare class CrewlyServer {
      * @param sessionName - The agent whose restore was deferred
      */
     private retryRestoreWhileOwed;
+    /**
+     * Why a boot launch outside the restore queue must wait this round
+     * (crewly#1353): memory is tight (within the first hour), the restore queue
+     * is still launching, or another boot launch began less than the launch
+     * spacing ago. Null = go.
+     *
+     * @returns Reason to hold, or null
+     */
+    private bootLaunchHold;
+    /**
+     * Gate for the boot maintenance passes (crewly#1353): resolves when the
+     * boot restore is over and memory is calm, or after the wait cap with
+     * `reduced: true`.
+     *
+     * @returns A gate function for the service constructors
+     */
+    private bootQuietGate;
+    /**
+     * The boot restore handed an agent to the retry because memory was tight.
+     * Once, when the first one is held back, schedule the one-line owner note
+     * that is sent only if some of them are still down after
+     * OWNER_NOTE_AFTER_MS (crewly#1353).
+     *
+     * @param sessionName - The agent held back
+     */
+    private noteHeldBackAtBoot;
     /**
      * Check for and handle pending self-improvement from hot-reload.
      * This runs at startup to validate or rollback any changes made
@@ -450,6 +486,7 @@ export declare class CrewlyServer {
      *
      * @param sessionName - The agent to start
      * @param firstPauseMs - Pause before the first attempt (default: the retry's own)
+     * @param opts - `boot`: a boot launch, held while memory is tight and paced with the restore queue (crewly#1353)
      */
     private retryStartWhileQueued;
     /**

package/dist/backend/backend/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../backend/src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../backend/src/index.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/index.js

@@ -194,6 +194,7 @@ import { WorkItemWorktreeService } from './services/worktree/workitem-worktree.s
 import { WorkItemWorktreeSubscriber, createTerminalNotifier } from './services/worktree/workitem-worktree.subscriber.js';
 import { ResourceModeService, RESOURCE_MODE_CONSTANTS } from './services/agent/resource-mode.service.js';
 import { getRestoreQueue, RESTORE_TIER } from './services/agent/restore-queue.js';
+import { bootLaunchHoldReason, getBootLaunchPacer, readBootPressureSnapshot, scheduleHeldBackNotice, waitForBootQuiet, } from './services/agent/boot-pressure.js';
 import { sessionsToRestore } from './services/agent/restore-filter.js';
 import { ProjectMemoryService } from './services/memory/project-memory.service.js';
 import { TaskHistorySubscriber } from './services/memory/task-history.subscriber.js';
@@ -369,6 +370,16 @@ export class CrewlyServer {
     });
     /** Owner promises past due and never nudged at boot; their agents are restored and reminded once */
     openCommitmentsAtBoot = [];
+    /**
+     * The boot restore is over: the queue drained, or there was nothing to
+     * restore. The boot maintenance passes wait for this (crewly#1353).
+     */
+    bootRestoreDone = false;
+    /** When this backend booted (the memory hold on boot retries is time-boxed from here) */
+    bootAt = Date.now();
+    /** Agents the boot restore handed to the retry because memory was tight (crewly#1353) */
+    heldBackAtBoot = new Set();
+    heldBackNoticeScheduled = false;
     healthMonitoringInterval = null;
     backgroundWatchdog = null;
     constructor(config) {
@@ -1045,7 +1056,7 @@ export class CrewlyServer {
             // digest page compiled from the log. No LLM. Non-fatal.
             try {
                 const { WikiMaintenanceService } = await import('./services/wiki/wiki-maintenance.service.js');
-                const maintenance = new WikiMaintenanceService();
+                const maintenance = new WikiMaintenanceService({ bootGate: this.bootQuietGate() });
                 WikiMaintenanceService.setInstance(maintenance);
                 maintenance.start();
             }
@@ -1078,6 +1089,7 @@ export class CrewlyServer {
                         }
                         return agents;
                     },
+                    bootGate: this.bootQuietGate(),
                 });
                 AgentMemoryRefreshService.setInstance(refresh);
                 refresh.start();
@@ -1122,6 +1134,7 @@ export class CrewlyServer {
                         if (settled && change.before.status !== change.ticket.status && change.ticket.workItemId)
                             listener(change.ticket.workItemId);
                     }),
+                    bootGate: this.bootQuietGate(),
                 });
                 WorkRecordService.setInstance(records);
                 records.start();
@@ -4333,10 +4346,11 @@ export class CrewlyServer {
                     return r.success;
                 });
                 // Finished work cleans up after itself: a WorkItem / ticket reaching
-                // done or verified schedules one debounced janitor pass (safe rules
-                // unchanged — only landed, clean, unattended worktrees go).
-                this.eventBusService.onInProcess(['task:done', 'task:verified'], () => {
-                    WorktreeJanitorService.getInstance().requestTidy();
+                // a terminal state schedules one debounced janitor pass (safe rules
+                // unchanged — only landed, clean, unattended worktrees go) and notes
+                // the item's worktree as finished (its node_modules go after 1 day).
+                this.eventBusService.onInProcess(['task:done', 'task:verified', 'task:cancelled', 'task:failed'], (event) => {
+                    WorktreeJanitorService.getInstance().requestTidy(event.workItemId);
                 });
                 if (WorktreeJanitorService.getInstance().start()) {
                     this.logger.info('WorktreeJanitorService scheduled');
@@ -4829,12 +4843,14 @@ export class CrewlyServer {
             const settings = await settingsService.getSettings();
             if (!settings.general.autoResumeOnRestart) {
                 this.logger.info('Auto-resume on restart is disabled, skipping agent session restore');
+                this.bootRestoreDone = true;
                 return;
             }
             const persistence = getSessionStatePersistence();
             const state = await persistence.loadState();
             if (!state || state.sessions.length === 0) {
                 this.logger.debug('No persisted agent sessions to restore');
+                this.bootRestoreDone = true;
                 return;
             }
             // Filter out orchestrator sessions (already auto-started separately)
@@ -4871,6 +4887,8 @@ export class CrewlyServer {
             // Why each target other than a WorkItem is owed something; the reason
             // is logged in the restore plan for agents that were idle at shutdown.
             const owedReason = new Map();
+            // Agents an owner thread waits on: launched even while memory is tight (crewly#1353).
+            const ownerThreadWaits = new Set();
             const noteOwed = (names, reason) => {
                 const out = [];
                 for (const name of names) {
@@ -4900,7 +4918,8 @@ export class CrewlyServer {
                     // card they asked (2026-10-08: Atlas waited on a browser
                     // approval in the owner's thread and was skipped as "no
                     // work in hand").
-                    ...noteOwed(await this.ownerThreadSessionsAtBoot(), 'owner thread waits on it'),
+                    ...noteOwed(await this.ownerThreadSessionsAtBoot().then((names) => { for (const n of names)
+                        ownerThreadWaits.add(n); return names; }), 'owner thread waits on it'),
                 ]);
             }
             catch (poolErr) {
@@ -4945,6 +4964,7 @@ export class CrewlyServer {
             const agentSessions = [...selection.sessions, ...idleAtShutdown];
             if (agentSessions.length === 0) {
                 this.logger.info('No persisted agent sessions to restore (all idle, no pending WorkItems)');
+                this.bootRestoreDone = true;
                 return;
             }
             this.logger.info('Auto-restoring agent sessions from persisted state', {
@@ -4997,6 +5017,13 @@ export class CrewlyServer {
                         return { success: result.success };
                     },
                     onReady: () => this.sendRecoveryFor(session.name),
+                    // Memory is tight and nobody waits on it: the retry brings it back
+                    // when the machine eases (held by bootLaunchHold), never dropped.
+                    onDeferred: () => {
+                        this.noteHeldBackAtBoot(session.name);
+                        this.retryRestoreWhileOwed(session.name);
+                    },
+                    essential: ownerTimes.length > 0 || session.role === ORCHESTRATOR_ROLE || ownerThreadWaits.has(session.name),
                 };
                 // An agent that was idle at shutdown says in the plan what it is owed.
                 const idle = wasIdle.has(session.name) ? ` (${owedReason.get(session.name) ?? 'work in hand'}; was idle at shutdown)` : '';
@@ -5018,9 +5045,13 @@ export class CrewlyServer {
             })
                 .catch((error) => {
                 this.logger.error('Restore queue failed', { error: error instanceof Error ? error.message : String(error) });
+            })
+                .finally(() => {
+                this.bootRestoreDone = true;
             });
         }
         catch (error) {
+            this.bootRestoreDone = true;
             this.logger.error('Failed to auto-restore agent sessions', {
                 error: error instanceof Error ? error.message : String(error),
             });
@@ -5082,8 +5113,12 @@ export class CrewlyServer {
             const { scheduleDeferredStartRetry } = await import('./services/messaging/deferred-start-retry.js');
             const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
             await scheduleDeferredStartRetry(sessionName, {
-                activate: (n) => activateAgentBySession(this.apiController, n),
+                activate: (n) => {
+                    getBootLaunchPacer().note();
+                    return activateAgentBySession(this.apiController, n);
+                },
                 hasPending: (n) => !isOwnerStopped(n),
+                hold: () => this.bootLaunchHold(),
             });
         })().catch((err) => {
             this.logger.warn('Could not retry a deferred boot restore', {
@@ -5092,6 +5127,57 @@ export class CrewlyServer {
             });
         });
     }
+    /**
+     * Why a boot launch outside the restore queue must wait this round
+     * (crewly#1353): memory is tight (within the first hour), the restore queue
+     * is still launching, or another boot launch began less than the launch
+     * spacing ago. Null = go.
+     *
+     * @returns Reason to hold, or null
+     */
+    bootLaunchHold() {
+        return bootLaunchHoldReason({
+            snapshot: readBootPressureSnapshot,
+            restoreRunning: () => getRestoreQueue().stats().running,
+            pacer: getBootLaunchPacer(),
+            bootAt: this.bootAt,
+        });
+    }
+    /**
+     * Gate for the boot maintenance passes (crewly#1353): resolves when the
+     * boot restore is over and memory is calm, or after the wait cap with
+     * `reduced: true`.
+     *
+     * @returns A gate function for the service constructors
+     */
+    bootQuietGate() {
+        return () => waitForBootQuiet({ restoreDone: () => this.bootRestoreDone });
+    }
+    /**
+     * The boot restore handed an agent to the retry because memory was tight.
+     * Once, when the first one is held back, schedule the one-line owner note
+     * that is sent only if some of them are still down after
+     * OWNER_NOTE_AFTER_MS (crewly#1353).
+     *
+     * @param sessionName - The agent held back
+     */
+    noteHeldBackAtBoot(sessionName) {
+        this.heldBackAtBoot.add(sessionName);
+        if (this.heldBackNoticeScheduled)
+            return;
+        this.heldBackNoticeScheduled = true;
+        void scheduleHeldBackNotice({
+            stillHeld: async () => {
+                const out = [];
+                for (const name of this.heldBackAtBoot) {
+                    if (!(await this.apiController.agentRegistrationService.isSessionLiveOrLaunching(name)))
+                        out.push(name);
+                }
+                return out;
+            },
+            notify: (line) => slackOwnerAlertNotifier({ title: 'Agents waiting on memory', message: line, urgent: false }),
+        });
+    }
     /**
      * Check for and handle pending self-improvement from hot-reload.
      * This runs at startup to validate or rollback any changes made
@@ -7025,14 +7111,21 @@ export class CrewlyServer {
      *
      * @param sessionName - The agent to start
      * @param firstPauseMs - Pause before the first attempt (default: the retry's own)
+     * @param opts - `boot`: a boot launch, held while memory is tight and paced with the restore queue (crewly#1353)
      */
-    retryStartWhileQueued(sessionName, firstPauseMs) {
+    retryStartWhileQueued(sessionName, firstPauseMs, opts = {}) {
         void (async () => {
             const { scheduleDeferredStartRetry } = await import('./services/messaging/deferred-start-retry.js');
             const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
             await scheduleDeferredStartRetry(sessionName, {
-                activate: (n) => activateAgentBySession(this.apiController, n),
+                activate: (n) => {
+                    if (opts.boot)
+                        getBootLaunchPacer().note();
+                    return activateAgentBySession(this.apiController, n);
+                },
                 hasPending: (n) => SubAgentMessageQueue.getInstance().hasPending(n),
+                // Boot launches outside the restore queue keep its spacing and its memory gate (crewly#1353).
+                ...(opts.boot ? { hold: () => this.bootLaunchHold() } : {}),
                 ...(firstPauseMs !== undefined ? { firstPauseMs } : {}),
             });
         })().catch((err) => {
@@ -7065,7 +7158,7 @@ export class CrewlyServer {
             return;
         this.logger.info('Starting agents that were down with messages queued for them', { sessions });
         for (const name of sessions)
-            this.retryStartWhileQueued(name, SUB_AGENT_QUEUE_CONSTANTS.BOOT_QUEUED_WAKE_DELAY_MS);
+            this.retryStartWhileQueued(name, SUB_AGENT_QUEUE_CONSTANTS.BOOT_QUEUED_WAKE_DELAY_MS, { boot: true });
     }
     /**
      * Write a system note into the orchestrator's own chat (the conversation