@shepai/cli 1.92.0 → 1.92.1

package/dist/packages/core/src/application/ports/output/agents/agent-registry.interface.d.ts

@@ -80,7 +80,7 @@ export interface IAgentRegistry {
      * @param name - The unique agent name (e.g., 'analyze-repository')
      * @returns The agent definition, or undefined if not registered
      */
-    get(name: string): AgentDefinitionWithFactory | undefined;
+    get(name: string): Promise<AgentDefinitionWithFactory | undefined>;
     /**
      * List all registered agent definitions.
      *

package/dist/packages/core/src/application/ports/output/agents/agent-registry.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-registry.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-registry.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,4EAA4E;IAE5E,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;IAE1D;;;;OAIG;IACH,IAAI,IAAI,0BAA0B,EAAE,CAAC;CACtC"}
+{"version":3,"file":"agent-registry.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/application/ports/output/agents/agent-registry.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,4EAA4E;IAE5E,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAEvD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;IAEnE;;;;OAIG;IACH,IAAI,IAAI,0BAA0B,EAAE,CAAC;CACtC"}

package/dist/packages/core/src/application/use-cases/agents/run-agent.use-case.js

@@ -45,7 +45,7 @@ let RunAgentUseCase = class RunAgentUseCase {
      * @throws Error if the agent name is not registered
      */
     async execute(input) {
-        const definition = this.agentRegistry.get(input.agentName);
+        const definition = await this.agentRegistry.get(input.agentName);
         if (!definition) {
             const available = this.agentRegistry.list().map((a) => a.name);
             throw new Error(`Unknown agent: "${input.agentName}". Available agents: ${available.join(', ') || 'none'}`);
@@ -60,7 +60,7 @@ let RunAgentUseCase = class RunAgentUseCase {
      * @throws Error if the agent name is not registered
      */
     async *executeStream(input) {
-        const definition = this.agentRegistry.get(input.agentName);
+        const definition = await this.agentRegistry.get(input.agentName);
         if (!definition) {
             const available = this.agentRegistry.list().map((a) => a.name);
             throw new Error(`Unknown agent: "${input.agentName}". Available agents: ${available.join(', ') || 'none'}`);

package/dist/packages/core/src/infrastructure/di/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAmHrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CAqRrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../../../../packages/core/src/infrastructure/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgHrC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,SAAS,CAAC,CAsSrE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/packages/core/src/infrastructure/di/container.js

@@ -19,7 +19,6 @@ import { AgentValidatorService } from '../services/agents/common/agent-validator
 import { promisify } from 'node:util';
 import { execFile } from 'node:child_process';
 import { VersionService } from '../services/version.service.js';
-import { WebServerService } from '../services/web-server.service.js';
 import { WorktreeService } from '../services/git/worktree.service.js';
 import { ToolInstallerServiceImpl } from '../services/tool-installer/tool-installer.service.js';
 import { GitPrService } from '../services/git/git-pr.service.js';
@@ -40,7 +39,6 @@ import { SpecInitializerService } from '../services/spec/spec-initializer.servic
 import { DesktopNotifier } from '../services/notifications/desktop-notifier.js';
 import { NotificationService } from '../services/notifications/notification.service.js';
 import { getNotificationBus } from '../services/notifications/notification-bus.js';
-import { createCheckpointer } from '../services/agents/common/checkpointer.js';
 import { spawn } from 'node:child_process';
 // Use cases
 import { InitializeSettingsUseCase } from '../../application/use-cases/settings/initialize-settings.use-case.js';
@@ -131,8 +129,28 @@ export async function initializeContainer() {
     // Register services (singletons via @injectable + token)
     container.registerSingleton('IAgentValidator', AgentValidatorService);
     container.registerSingleton('IVersionService', VersionService);
+    // IWebServerService is registered as a lazy proxy to avoid importing `next`
+    // (~80ms) for non-web commands. The actual service is loaded on first method call.
     container.register('IWebServerService', {
-        useFactory: () => new WebServerService(),
+        useFactory: () => {
+            let instance = null;
+            const getInstance = async () => {
+                if (!instance) {
+                    const { WebServerService } = await import('../services/web-server.service.js');
+                    instance = new WebServerService();
+                }
+                return instance;
+            };
+            return new Proxy({}, {
+                get: (_target, prop) => {
+                    return async (...args) => {
+                        const svc = await getInstance();
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        return svc[prop](...args);
+                    };
+                },
+            });
+        },
     });
     container.registerSingleton('IWorktreeService', WorktreeService);
     container.registerSingleton('IToolInstallerService', ToolInstallerServiceImpl);
@@ -189,16 +207,14 @@ export async function initializeContainer() {
     container.register('IAgentRegistry', {
         useFactory: () => new AgentRegistryService(),
     });
-    container.register('Checkpointer', {
-        useFactory: () => createCheckpointer(':memory:'),
-    });
     container.register('IAgentRunner', {
         useFactory: (c) => {
             const registry = c.resolve('IAgentRegistry');
             const executorProvider = c.resolve('IAgentExecutorProvider');
-            const checkpointer = c.resolve('Checkpointer');
             const runRepository = c.resolve('IAgentRunRepository');
-            return new AgentRunnerService(registry, executorProvider, checkpointer, runRepository);
+            // Checkpointer is lazy-loaded to avoid ~240ms startup cost from
+            // @langchain/langgraph-checkpoint-sqlite on every CLI invocation.
+            return new AgentRunnerService(registry, executorProvider, runRepository);
         },
     });
     container.register('IFeatureAgentProcessService', {

package/dist/packages/core/src/infrastructure/services/agents/common/agent-registry.service.d.ts

@@ -10,9 +10,11 @@
 import type { IAgentRegistry, AgentDefinitionWithFactory } from '../../../../application/ports/output/agents/agent-registry.interface.js';
 export declare class AgentRegistryService implements IAgentRegistry {
     private readonly agents;
+    private readonly lazyAgents;
     constructor();
+    private resolveLazy;
     register(definition: AgentDefinitionWithFactory): void;
-    get(name: string): AgentDefinitionWithFactory | undefined;
+    get(name: string): Promise<AgentDefinitionWithFactory | undefined>;
     list(): AgentDefinitionWithFactory[];
 }
 //# sourceMappingURL=agent-registry.service.d.ts.map

package/dist/packages/core/src/infrastructure/services/agents/common/agent-registry.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-registry.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC3B,MAAM,+DAA+D,CAAC;AAIvE,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;;IAiBxE,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI;IAItD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAIzD,IAAI,IAAI,0BAA0B,EAAE;CAGrC"}
+{"version":3,"file":"agent-registry.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC3B,MAAM,+DAA+D,CAAC;AAevE,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiD;IACxE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;;YAqB1C,WAAW;IAczB,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI;IAIhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC;IAMxE,IAAI,IAAI,0BAA0B,EAAE;CAiBrC"}

package/dist/packages/core/src/infrastructure/services/agents/common/agent-registry.service.js

@@ -7,30 +7,62 @@
  *
  * Pre-registers built-in agents (analyze-repository) at construction time.
  */
-import { createAnalyzeRepositoryGraph } from '../analyze-repo/analyze-repository-graph.js';
-import { createFeatureAgentGraph } from '../feature-agent/feature-agent-graph.js';
 export class AgentRegistryService {
     agents = new Map();
+    lazyAgents = [];
     constructor() {
-        // Register built-in agents
-        this.register({
+        // Register built-in agents as lazy definitions to avoid importing
+        // @langchain/langgraph (~300ms) at CLI startup.
+        this.lazyAgents.push({
             name: 'analyze-repository',
             description: 'Analyze repository structure, dependencies, and architecture',
-            graphFactory: createAnalyzeRepositoryGraph,
-        });
-        this.register({
+            importFn: () => import('../analyze-repo/analyze-repository-graph.js'),
+            factoryExport: 'createAnalyzeRepositoryGraph',
+        }, {
             name: 'feature-agent',
             description: 'Autonomous SDLC agent: analyze → requirements → research → plan → implement',
-            graphFactory: createFeatureAgentGraph,
+            importFn: () => import('../feature-agent/feature-agent-graph.js'),
+            factoryExport: 'createFeatureAgentGraph',
         });
     }
+    async resolveLazy(name) {
+        const lazy = this.lazyAgents.find((a) => a.name === name);
+        if (!lazy)
+            return undefined;
+        const mod = await lazy.importFn();
+        const definition = {
+            name: lazy.name,
+            description: lazy.description,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            graphFactory: mod[lazy.factoryExport],
+        };
+        this.agents.set(name, definition);
+        return definition;
+    }
     register(definition) {
         this.agents.set(definition.name, definition);
     }
-    get(name) {
-        return this.agents.get(name);
+    async get(name) {
+        const eager = this.agents.get(name);
+        if (eager)
+            return eager;
+        return this.resolveLazy(name);
     }
     list() {
-        return Array.from(this.agents.values());
+        // Returns eagerly-registered + cached placeholder metadata for lazy agents.
+        const all = new Map(this.agents);
+        for (const lazy of this.lazyAgents) {
+            if (!all.has(lazy.name)) {
+                lazy.placeholder ??= {
+                    name: lazy.name,
+                    description: lazy.description,
+                    graphFactory: () => {
+                        throw new Error(`Agent '${lazy.name}' must be resolved via get() before use`);
+                    },
+                };
+                all.set(lazy.name, lazy.placeholder);
+            }
+        }
+        return Array.from(all.values());
     }
 }

package/dist/packages/core/src/infrastructure/services/agents/common/agent-runner.service.d.ts

@@ -6,7 +6,6 @@
  * creating executors, compiling LangGraph workflows, and tracking runs
  * in the repository.
  */
-import type { BaseCheckpointSaver } from '@langchain/langgraph';
 import type { IAgentRunner, AgentRunOptions } from '../../../../application/ports/output/agents/agent-runner.interface.js';
 import type { IAgentRegistry } from '../../../../application/ports/output/agents/agent-registry.interface.js';
 import type { IAgentExecutorProvider } from '../../../../application/ports/output/agents/agent-executor-provider.interface.js';
@@ -15,9 +14,8 @@ import type { AgentRun, AgentRunEvent } from '../../../../domain/generated/outpu
 export declare class AgentRunnerService implements IAgentRunner {
     private readonly registry;
     private readonly executorProvider;
-    private readonly checkpointer;
     private readonly runRepository;
-    constructor(registry: IAgentRegistry, executorProvider: IAgentExecutorProvider, checkpointer: BaseCheckpointSaver, runRepository: IAgentRunRepository);
+    constructor(registry: IAgentRegistry, executorProvider: IAgentExecutorProvider, runRepository: IAgentRunRepository);
     runAgent(agentName: string, prompt: string, options?: AgentRunOptions): Promise<AgentRun>;
     runAgentStream(agentName: string, prompt: string, options?: AgentRunOptions): AsyncIterable<AgentRunEvent>;
     private setupRun;

package/dist/packages/core/src/infrastructure/services/agents/common/agent-runner.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-runner.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wEAAwE,CAAC;AACrH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAE/G,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAM5E,qBAAa,kBAAmB,YAAW,YAAY;IAEnD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,QAAQ,EAAE,cAAc,EACxB,gBAAgB,EAAE,sBAAsB,EACxC,YAAY,EAAE,mBAAmB,EACjC,aAAa,EAAE,mBAAmB;IAG/C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmBxF,cAAc,CACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,aAAa,CAAC,aAAa,CAAC;YAwCjB,QAAQ;YAwCR,aAAa;YAUb,UAAU;CAQzB"}
+{"version":3,"file":"agent-runner.service.d.ts","sourceRoot":"","sources":["../../../../../../../../packages/core/src/infrastructure/services/agents/common/agent-runner.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+DAA+D,CAAC;AACpG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wEAAwE,CAAC;AACrH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qEAAqE,CAAC;AAE/G,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAoB5E,qBAAa,kBAAmB,YAAW,YAAY;IAEnD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,QAAQ,EAAE,cAAc,EACxB,gBAAgB,EAAE,sBAAsB,EACxC,aAAa,EAAE,mBAAmB;IAG/C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoBxF,cAAc,CACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,aAAa,CAAC,aAAa,CAAC;YAyCjB,QAAQ;YAwCR,aAAa;YAUb,UAAU;CAQzB"}

package/dist/packages/core/src/infrastructure/services/agents/common/agent-runner.service.js

@@ -11,21 +11,33 @@ import { AgentRunStatus } from '../../../../domain/generated/output.js';
 import { getSettings } from '../../../services/settings.service.js';
 import { EventChannel } from '../streaming/event-channel.js';
 import { StreamingExecutorProxy } from '../streaming/streaming-executor-proxy.js';
+/**
+ * Lazy-loads the checkpointer to avoid ~240ms startup cost from
+ * @langchain/langgraph-checkpoint-sqlite on every CLI invocation.
+ * The import only happens when an agent is actually run.
+ */
+let _checkpointer = null;
+async function getCheckpointer() {
+    if (!_checkpointer) {
+        const { createCheckpointer } = await import('./checkpointer.js');
+        _checkpointer = createCheckpointer(':memory:');
+    }
+    return _checkpointer;
+}
 export class AgentRunnerService {
     registry;
     executorProvider;
-    checkpointer;
     runRepository;
-    constructor(registry, executorProvider, checkpointer, runRepository) {
+    constructor(registry, executorProvider, runRepository) {
         this.registry = registry;
         this.executorProvider = executorProvider;
-        this.checkpointer = checkpointer;
         this.runRepository = runRepository;
     }
     async runAgent(agentName, prompt, options) {
         const { definition, executor, runId, threadId } = await this.setupRun(agentName, prompt);
         try {
-            const compiledGraph = definition.graphFactory(executor, this.checkpointer);
+            const checkpointer = await getCheckpointer();
+            const compiledGraph = definition.graphFactory(executor, checkpointer);
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const result = await compiledGraph.invoke({ repositoryPath: options?.repositoryPath ?? process.cwd() }, { configurable: { thread_id: threadId } });
             await this.markCompleted(runId, result);
@@ -42,7 +54,8 @@ export class AgentRunnerService {
         const channel = new EventChannel();
         const proxy = new StreamingExecutorProxy(executor, channel);
         // Compile graph with proxy (graph doesn't know about streaming)
-        const compiledGraph = definition.graphFactory(proxy, this.checkpointer);
+        const checkpointer = await getCheckpointer();
+        const compiledGraph = definition.graphFactory(proxy, checkpointer);
         // Start graph invocation in background
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const graphPromise = compiledGraph
@@ -67,7 +80,7 @@ export class AgentRunnerService {
         await graphPromise;
     }
     async setupRun(agentName, prompt) {
-        const definition = this.registry.get(agentName);
+        const definition = await this.registry.get(agentName);
         if (!definition) {
             throw new Error(`Agent '${agentName}' not found. Available: ${this.registry
                 .list()

package/dist/src/presentation/cli/index.js

@@ -55,7 +55,6 @@ import { initializeContainer, container } from '../../../packages/core/src/infra
 import { InitializeSettingsUseCase } from '../../../packages/core/src/application/use-cases/settings/initialize-settings.use-case.js';
 import { initializeSettings } from '../../../packages/core/src/infrastructure/services/settings.service.js';
 import { CheckOnboardingStatusUseCase } from '../../../packages/core/src/application/use-cases/settings/check-onboarding-status.use-case.js';
-import { onboardingWizard } from '../tui/wizards/onboarding/onboarding.wizard.js';
 /**
  * Bootstrap function - initializes all dependencies before CLI starts.
  * Performs async initialization (database, settings) before parsing commands.
@@ -90,6 +89,8 @@ async function bootstrap() {
             const onboardingCheck = new CheckOnboardingStatusUseCase();
             const { isComplete } = await onboardingCheck.execute();
             if (!isComplete) {
+                // Lazy-import to avoid ~460ms startup cost when onboarding is already complete
+                const { onboardingWizard } = await import('../tui/wizards/onboarding/onboarding.wizard.js');
                 await onboardingWizard();
             }
         }