crewly 1.9.0 → 1.11.0

package/dist/backend/backend/src/controllers/wiki/wiki.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/wiki/wiki.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AA4BjC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CA6BzC"}
+{"version":3,"file":"wiki.routes.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/wiki/wiki.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAkCjC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAqCzC"}

package/dist/backend/backend/src/controllers/wiki/wiki.routes.js

@@ -4,7 +4,7 @@
  * @module controllers/wiki/wiki.routes
  */
 import { Router } from 'express';
-import { ingest, queryVault, queueAdd, queueList, queueClaim, queueClaimNext, queueProcess, queueSkip, queueStats, bookkeep, bookkeepTriggerNow, listVaults, getVaultTree, getPage, searchVault, getBacklinks, lintVault, getRecent, reflectTriggerNow, migrateScan, migrateApply, migrateOssSops, cleanupScan, cleanupApply, } from './wiki.controller.js';
+import { ingest, queryVault, queueAdd, queueList, queueClaim, queueClaimNext, queueProcess, queueSkip, queueStats, bookkeep, bookkeepTriggerNow, listVaults, getVaultTree, getPage, searchVault, searchAllVaults, listSopCatalog, installSop, uninstallSop, writeOverlayPage, deleteOverlayPage, getBacklinks, lintVault, getRecent, reflectTriggerNow, migrateScan, migrateApply, migrateOssSops, cleanupScan, cleanupApply, } from './wiki.controller.js';
 /**
  * Creates the wiki router.
  *
@@ -41,6 +41,14 @@ export function createWikiRouter() {
     router.get('/tree', getVaultTree);
     router.get('/page', getPage);
     router.get('/search', searchVault);
+    router.get('/search-all', searchAllVaults);
+    // SOP catalog (marketplace): browse config/sops + install/uninstall per team.
+    router.get('/sop-catalog', listSopCatalog);
+    router.post('/sop-catalog/install', installSop);
+    router.post('/sop-catalog/uninstall', uninstallSop);
+    // Owner-authored overlay pages (team norms + custom SOPs).
+    router.post('/overlay-page', writeOverlayPage);
+    router.delete('/overlay-page', deleteOverlayPage);
     router.get('/backlinks', getBacklinks);
     router.get('/recent', getRecent);
     router.post('/migrate/scan', migrateScan);

package/dist/backend/backend/src/controllers/wiki/wiki.routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"wiki.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/wiki/wiki.routes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,MAAM,EACN,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,QAAQ,EACR,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClC,yEAAyE;IACzE,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,kBAAkB,CAAC,CAAC;IACzD,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAChC,yCAAyC;IACzC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"wiki.routes.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/wiki/wiki.routes.ts"],"names":[],"mappings":"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"}

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":";AAwCA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAuIjD,qBAAa,YAAY;IACxB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAqE;IAEnF,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,uBAAuB,CAA2B;IAC1D,OAAO,CAAC,sBAAsB,CAA0B;IACxD,OAAO,CAAC,4BAA4B,CAAgC;IACpE,OAAO,CAAC,uBAAuB,CAA2B;IAC1D,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,wBAAwB,CAA4B;IAC5D,OAAO,CAAC,eAAe,CAAmB;IAC1C,qEAAqE;IACrE,OAAO,CAAC,qBAAqB,CAAsC;IACnE,kGAAkG;IAClG,OAAO,CAAC,sBAAsB,CAAuC;IAGrE,OAAO,CAAC,+BAA+B,CAAgD;IACvF,+FAA+F;IAC/F,OAAO,CAAC,oBAAoB,CAAqC;IACjE,8HAA8H;IAC9H,OAAO,CAAC,0BAA0B,CAA2C;IAC7E,OAAO,CAAC,6BAA6B,CAA8C;IACnF,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,2BAA2B,CAA+B;IAClE,OAAO,CAAC,0BAA0B,CAA8B;IAChE,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,kBAAkB,CAA0C;IAKpE,OAAO,CAAC,aAAa,CAAuE;IAC5F,OAAO,CAAC,gBAAgB,CAET;IAGf,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,wBAAwB,CAA+B;gBAEnD,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IA2D3C,OAAO,CAAC,kBAAkB;IA6qB1B,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,eAAe;IA6HvB,OAAO,CAAC,kBAAkB;IAwBpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkrC5B;;;OAGG;YACW,2BAA2B;IA8BzC;;;OAGG;YACW,8BAA8B;IAsB5C;;;OAGG;YACW,gCAAgC;IAsB9C;;;OAGG;YACW,8BAA8B;IAsB5C;;;;OAIG;YACW,8BAA8B;IA2F5C;;;;;OAKG;YACW,iCAAiC;IAyJ/C;;;;OAIG;YACW,2BAA2B;YA0B3B,qBAAqB;YAsBrB,eAAe;YA4Ef,kBAAkB;IAgBhC,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,sBAAsB;IAqD9B,OAAO,CAAC,qBAAqB;IAsC7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA0D1B;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IAqH7B,OAAO,CAAC,cAAc;IAchB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiT/B,SAAS,IAAI,aAAa;CAG1B;AAeD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../backend/src/index.ts"],"names":[],"mappings":";AAwCA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAuIjD,qBAAa,YAAY;IACxB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAqE;IAEnF,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,uBAAuB,CAA2B;IAC1D,OAAO,CAAC,sBAAsB,CAA0B;IACxD,OAAO,CAAC,4BAA4B,CAAgC;IACpE,OAAO,CAAC,uBAAuB,CAA2B;IAC1D,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,wBAAwB,CAA4B;IAC5D,OAAO,CAAC,eAAe,CAAmB;IAC1C,qEAAqE;IACrE,OAAO,CAAC,qBAAqB,CAAsC;IACnE,kGAAkG;IAClG,OAAO,CAAC,sBAAsB,CAAuC;IAGrE,OAAO,CAAC,+BAA+B,CAAgD;IACvF,+FAA+F;IAC/F,OAAO,CAAC,oBAAoB,CAAqC;IACjE,8HAA8H;IAC9H,OAAO,CAAC,0BAA0B,CAA2C;IAC7E,OAAO,CAAC,6BAA6B,CAA8C;IACnF,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,2BAA2B,CAA+B;IAClE,OAAO,CAAC,0BAA0B,CAA8B;IAChE,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,kBAAkB,CAA0C;IAKpE,OAAO,CAAC,aAAa,CAAuE;IAC5F,OAAO,CAAC,gBAAgB,CAET;IAGf,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,wBAAwB,CAA+B;gBAEnD,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IA2D3C,OAAO,CAAC,kBAAkB;IA6qB1B,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,eAAe;IA6HvB,OAAO,CAAC,kBAAkB;IAwBpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2pC5B;;;OAGG;YACW,2BAA2B;IA8BzC;;;OAGG;YACW,8BAA8B;IAsB5C;;;OAGG;YACW,gCAAgC;IAsB9C;;;OAGG;YACW,8BAA8B;IAsB5C;;;;OAIG;YACW,8BAA8B;IA+H5C;;;;;OAKG;YACW,iCAAiC;IAyJ/C;;;;OAIG;YACW,2BAA2B;YA0B3B,qBAAqB;YAsBrB,eAAe;YA4Ef,kBAAkB;IAgBhC,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,sBAAsB;IAqD9B,OAAO,CAAC,qBAAqB;IAsC7B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA0D1B;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IAqH7B,OAAO,CAAC,cAAc;IAchB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiT/B,SAAS,IAAI,aAAa;CAG1B;AAeD,eAAe,YAAY,CAAC"}

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

@@ -20,12 +20,12 @@ import { createApiRoutes } from './routes/api.routes.js';
 import { TerminalGateway, setTerminalGateway } from './websocket/terminal.gateway.js';
 import { initializeChatGateway } from './websocket/chat.gateway.js';
 import { LoggerService } from './services/core/logger.service.js';
+import { retryWithBackoff } from './services/core/retry.util.js';
 import { CREWLY_CONSTANTS, ORCHESTRATOR_SESSION_NAME, ORCHESTRATOR_ROLE, ORCHESTRATOR_WINDOW_NAME, MESSAGE_QUEUE_CONSTANTS, RUNTIME_TYPES, AUDITOR_CONSTANTS, AUDITOR_SCHEDULER_CONSTANTS, } from './constants.js';
 import { getSettingsService } from './services/settings/index.js';
 import { MemoryService } from './services/memory/memory.service.js';
 import { getImprovementStartupService } from './services/orchestrator/improvement-startup.service.js';
 import { initializeSlackIfConfigured, shutdownSlack } from './services/slack/index.js';
-import { resolveTeamByIdOrSlug, slugifyTeamName } from './services/workflow/team-identifier-resolver.js';
 import { initializeWhatsAppIfConfigured, shutdownWhatsApp } from './services/whatsapp/index.js';
 import { initializeGoogleChatIfConfigured } from './services/messaging/google-chat-initializer.js';
 import { initializeTelegramIfConfigured, shutdownTelegram } from './services/telegram/index.js';
@@ -1283,6 +1283,14 @@ export class CrewlyServer {
                     // needs the list of session names for a given channel
                     // to fan-out a user message to every huddle member.
                     huddleMembersFor: (channelId) => chatService.queryHuddleMembersForDispatch(channelId),
+                    // Activate-on-send: messaging an offline agent wakes it, then
+                    // the dispatcher retries delivery. User-initiated, so it uses
+                    // the wake-gate-free activation path.
+                    activateAgent: async (agentSession) => {
+                        const { activateAgentBySession } = await import('./controllers/team/team.controller.js');
+                        const res = await activateAgentBySession(this.apiController, agentSession);
+                        return res.success;
+                    },
                 });
                 this.chatV2Gateway = chatGateway;
                 this.chatV2Dispatcher = chatDispatcher;
@@ -1552,82 +1560,49 @@ export class CrewlyServer {
                     error: err instanceof Error ? err.message : String(err),
                 });
             }
-            // #286: Start cron task service with agent status/start callbacks
+            // #286/#678: Cron fires ENQUEUE a WorkItem into the task pool instead
+            // of writing straight to the agent's terminal. The pool's wake-mesh
+            // (WorkItemDispatchSubscriber push + AgentAutoClaim pull + reconciler
+            // self-heal) then assigns + delivers it — so a cron firing for an
+            // OFFLINE agent becomes a durable queued item that gets woken, instead
+            // of being silently dropped (#678). No agent-status/auto-start callbacks
+            // are wired: the cron now ALWAYS enqueues regardless of liveness, and
+            // the pool owns online/offline delivery + recovery.
             try {
                 const cronTaskService = CronTaskService.getInstance();
-                const storageRef = this.storageService;
-                const registrationRef = this.apiController.agentRegistrationService;
+                const { TaskPoolService } = await import('./services/task-pool/task-pool.service.js');
+                const { createWorkItem } = await import('./types/v2/work-item.types.js');
                 cronTaskService.setExecutionCallback(async (task) => {
-                    this.logger.info('Executing cron task', { id: task.id, target: task.targetAgent });
-                    await registrationRef.sendMessageToAgent(task.targetAgent, `[CRON_TASK:${task.id}] ${task.taskDescription}`);
-                });
-                // Issue #307: cron tasks created with `targetTeamId` set to a
-                // name slug (e.g. "stock-ops-team") instead of the UUID would
-                // silently 404 on every fire — `teams.find(t => t.id === teamId)`
-                // returned undefined and both callbacks returned `false` with
-                // no log surface. `resolveTeamByIdOrSlug` (imported statically
-                // at the top of the file) tries UUID first, then falls back
-                // to a slug match against `name`. Misses now surface a distinct
-                // warn-log with the available slugs so the cause is visible
-                // instead of hiding behind the generic "agent offline" warn
-                // from cron-task.service.
-                cronTaskService.setAgentStatusCallback(async (sessionName, teamId) => {
-                    // Handle orchestrator separately — it's not in regular teams
-                    if (sessionName === CREWLY_CONSTANTS.SESSIONS.ORCHESTRATOR_NAME || teamId === 'orchestrator') {
-                        const orchStatus = await storageRef.getOrchestratorStatus();
-                        return orchStatus?.agentStatus === 'active' || orchStatus?.agentStatus === 'started';
-                    }
-                    const teams = await storageRef.getTeams();
-                    const team = resolveTeamByIdOrSlug(teams, teamId);
-                    if (!team) {
-                        this.logger.warn('CronTask: targetTeamId resolves to no team', {
-                            sessionName,
-                            targetTeamId: teamId,
-                            availableSlugs: teams.slice(0, 10).map((t) => slugifyTeamName(t.name)),
-                            hint: 'Set targetTeamId to either the team UUID or one of availableSlugs (lowercase, spaces→-)',
-                        });
-                        return false;
-                    }
-                    const member = team.members.find((m) => m.sessionName === sessionName);
-                    if (!member)
-                        return false;
-                    // #286 Root Cause C: treat both 'active' and 'started' as online
-                    return member.agentStatus === 'active' || member.agentStatus === 'started';
-                });
-                cronTaskService.setAgentStartCallback(async (sessionName, teamId) => {
-                    try {
-                        const teams = await storageRef.getTeams();
-                        const team = resolveTeamByIdOrSlug(teams, teamId);
-                        if (!team) {
-                            this.logger.warn('CronTask auto-start: targetTeamId resolves to no team', {
-                                sessionName,
-                                targetTeamId: teamId,
-                                availableSlugs: teams.slice(0, 10).map((t) => slugifyTeamName(t.name)),
-                                hint: 'Set targetTeamId to either the team UUID or one of availableSlugs (lowercase, spaces→-)',
-                            });
-                            return false;
-                        }
-                        const member = team.members.find((m) => m.sessionName === sessionName);
-                        if (!member)
-                            return false;
-                        await registrationRef.createAgentSession({
-                            sessionName: member.sessionName,
-                            role: member.role,
-                            // Use the resolved team's UUID — not the user-supplied identifier
-                            // — so downstream agent-registration always sees the canonical id.
-                            teamId: team.id,
-                            memberId: member.id,
-                        });
-                        return true;
-                    }
-                    catch {
-                        return false;
-                    }
+                    // Deterministic id per fire slot: re-evaluating the same due slot
+                    // is a no-op (addToPool dedups by id), but each scheduled
+                    // occurrence is a fresh WorkItem. `task.nextRunAt` is still the
+                    // firing slot here — the service advances it AFTER this returns.
+                    const slot = task.nextRunAt ?? new Date().toISOString();
+                    const workItem = createWorkItem({
+                        id: `cron-${task.id}-${slot}`,
+                        type: 'cron_run',
+                        owner: 'orchestrator',
+                        target: task.targetAgent,
+                        title: `Cron: ${task.taskDescription.slice(0, 80)}`,
+                        description: task.taskDescription,
+                        metadata: {
+                            source: 'cron',
+                            cronTaskId: task.id,
+                            targetTeamId: task.targetTeamId,
+                            firedSlot: slot,
+                        },
+                    });
+                    await TaskPoolService.getInstance().addToPool(workItem);
+                    this.logger.info('Cron task enqueued as WorkItem', {
+                        id: task.id,
+                        workItemId: workItem.id,
+                        target: task.targetAgent,
+                    });
                 });
                 // Self-heal stale nextRunAt values from pre-timezone-fix versions
                 await cronTaskService.recalculateAllNextRunTimes();
                 cronTaskService.start();
-                this.logger.info('CronTaskService started');
+                this.logger.info('CronTaskService started (cron fires → task pool WorkItems)');
             }
             catch (cronErr) {
                 this.logger.warn('CronTaskService initialization failed (non-critical)', {
@@ -2265,18 +2240,50 @@ export class CrewlyServer {
                     }
                 }
             }
-            // Create orchestrator agent session
-            const result = await this.apiController.agentRegistrationService.createAgentSession({
+            // Create orchestrator agent session, with bounded retry + backoff.
+            //
+            // #686: a single `createAgentSession` failure here used to be a
+            // one-shot WARN + return — the orchestrator then stayed inactive
+            // with NO retry and NO health signal, leaving the system in a
+            // silent "假死" state (inbound messages queue forever, /health still
+            // reports healthy). Transient failures are common at boot (e.g. a
+            // momentary PTY spawn-slot exhaustion like #611, or a downstream
+            // dependency still warming up after a process restart), so we retry
+            // with a linear backoff before giving up. The reconciler's
+            // hybrid-wake is the longer-term self-heal (it now restarts the orc
+            // via /orchestrator/setup, #679), but boot-time retry avoids leaving
+            // the orc dead until the next inbound message arrives.
+            const MAX_AUTOSTART_ATTEMPTS = 5;
+            const AUTOSTART_BACKOFF_MS = 3_000;
+            const result = await retryWithBackoff(() => this.apiController.agentRegistrationService.createAgentSession({
                 sessionName: ORCHESTRATOR_SESSION_NAME,
                 role: ORCHESTRATOR_ROLE,
                 projectPath: this.config.crewlyHome,
                 windowName: ORCHESTRATOR_WINDOW_NAME,
                 runtimeType,
                 forceRecreate: true,
+            }), {
+                maxAttempts: MAX_AUTOSTART_ATTEMPTS,
+                backoffMs: AUTOSTART_BACKOFF_MS,
+                isSuccess: r => r.success,
+                onRetry: ({ attempt, maxAttempts, retryInMs, result: r }) => {
+                    this.logger.warn('Auto-start orchestrator failed to create session — retrying', {
+                        error: r.error,
+                        attempt,
+                        maxAttempts,
+                        retryInMs,
+                    });
+                },
             });
             if (!result.success) {
-                this.logger.warn('Auto-start orchestrator failed to create session', {
+                // Exhausted all retries. Log loudly at ERROR (not WARN) so the
+                // failure is greppable in pm2/console output and not mistaken for
+                // a benign skip. The orchestrator stays inactive; recovery now
+                // falls to the reconciler's hybrid-wake on the next queued
+                // inbound WorkItem (#679 routing fix).
+                this.logger.error('Auto-start orchestrator FAILED after all retries — orchestrator is INACTIVE', {
                     error: result.error,
+                    attempts: MAX_AUTOSTART_ATTEMPTS,
                 });
                 return;
             }