Method write

src/node/utils/sessionFile.ts:68–90

* Write JSON file to workspace session directory with file locking. * Creates session directory if it doesn't exist. * * If options.shouldWrite returns false, the write is skipped (and the session * directory is not created).

(
    workspaceId: string,
    data: T,
    options?: SessionFileWriteOptions
  )

   * directory is not created).
   */
  async write(
    workspaceId: string,
    data: T,
    options?: SessionFileWriteOptions
  ): Promise<Result<void>> {
    return this.fileLocks.withLock(workspaceId, async () => {
      try {
        if (options?.shouldWrite && !options.shouldWrite()) {
          return Ok(undefined);
        }

        const sessionDir = this.config.getSessionDir(workspaceId);
        await fs.mkdir(sessionDir, { recursive: true });
        const filePath = this.getFilePath(workspaceId);
        // Atomic write prevents corruption if app crashes mid-write
        await writeFileAtomic(filePath, JSON.stringify(data, null, 2));
        return Ok(undefined);
      } catch (error) {
        const message = getErrorMessage(error);
        return Err(`Failed to write ${this.fileName}: ${message}`);
      }
    });
  }

  /**
   * Delete JSON file from workspace session directory with file locking.