Method stop

src/mcp/engine.ts:265–300

* Close everything. Used on graceful daemon shutdown (SIGTERM/idle timeout) * and on direct-mode stop. Idempotent.

()

   * and on direct-mode stop. Idempotent.
   */
  stop(): Promise<void> {
    if (this.stopPromise) return this.stopPromise;
    this.closed = true;
    if (!this.cg && !this.initPromise && this.explicitProjects.size === 0 && this.writerLockRoot) {
      releaseWriterLock(this.writerLockRoot);
      this.writerLockRoot = null;
    }

    // Detach + terminate the worker pool first so no tool call routes to a
    // worker mid-teardown; outstanding pool calls resolve with graceful guidance.
    // Stopping waits for the workers to end — the pool's, and any
    // `codegraph_status` change count still measuring: the daemon exits right
    // after, and exiting while a worker is still starting up can crash the
    // process.
    this.toolHandler.setQueryPool(null);
    const poolDown = this.queryPool ? this.queryPool.destroy() : Promise.resolve();
    this.queryPool = null;
    const measurementsDown = endFreshnessMeasurements();
    const drained = this.toolHandler.closeAll();
    this.stopPromise = Promise.all([drained, poolDown, measurementsDown]).then(async () => {
      if (this.initPromise) await this.initPromise;
      if (this.defaultLease) {
        await this.defaultLease.release();
        this.defaultLease = null;
        this.writerLockRoot = null;
      } else if (this.cg) {
        this.cg.unwatch();
        while (this.cg.isIndexing()) await new Promise((resolve) => setTimeout(resolve, 25));
        this.cg.close();
      }
      this.cg = null;
      if (this.writerLockRoot) releaseWriterLock(this.writerLockRoot);
      this.writerLockRoot = null;
    });
    return this.stopPromise;
  }

  private releaseExplicitProject(cg: CodeGraph): void | Promise<void> {
    const lease = this.explicitProjects.get(cg);