@namzu/sdk 0.1.1 → 0.1.3

package/src/store/task/disk.ts

@@ -1,333 +1,337 @@
 import { mkdir, readFile, readdir, rename, unlink, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
-import type { TaskId, RunId, TenantId } from '../../types/ids/index.js'
+import type { RunId, TaskId, TenantId } from '../../types/ids/index.js'
 import type {
-  Task,
-  TaskStatus,
-  TaskStore,
-  TaskEvent,
-  TaskEventListener,
-  CreateTaskParams,
-  UpdateTaskParams,
+	CreateTaskParams,
+	Task,
+	TaskEvent,
+	TaskEventListener,
+	TaskStatus,
+	TaskStore,
+	UpdateTaskParams,
 } from '../../types/task/index.js'
 import { generateTaskId } from '../../utils/id.js'
-import { getRootLogger, type Logger } from '../../utils/logger.js'
+import { type Logger, getRootLogger } from '../../utils/logger.js'
 
 export interface DiskTaskStoreConfig {
-  baseDir: string
+	baseDir: string
 
-  defaultRunId: RunId
+	defaultRunId: RunId
 
-  tenantId?: TenantId
+	tenantId?: TenantId
 
-  logger?: Logger
+	logger?: Logger
 }
 
 const STATUS_ORDER: Record<TaskStatus, number> = {
-  pending: 0,
-  in_progress: 1,
-  completed: 2,
+	pending: 0,
+	in_progress: 1,
+	completed: 2,
 }
 
 function isForwardTransition(from: TaskStatus, to: TaskStatus): boolean {
-  return STATUS_ORDER[to] > STATUS_ORDER[from]
+	return STATUS_ORDER[to] > STATUS_ORDER[from]
 }
 
 export class DiskTaskStore implements TaskStore {
-  private baseDir: string
-  private defaultRunId: RunId
-  private tenantId?: TenantId
-  private log: Logger
-  private listeners: TaskEventListener[] = []
-
-  private locks = new Map<TaskId, Promise<void>>()
-
-  constructor(config: DiskTaskStoreConfig) {
-    this.baseDir = config.baseDir
-    this.defaultRunId = config.defaultRunId
-    this.tenantId = config.tenantId
-    this.log = (config.logger ?? getRootLogger()).child({ component: 'DiskTaskStore' })
-  }
-
-  private taskDir(runId: RunId): string {
-    if (this.tenantId) {
-      return join(this.baseDir, 'tenants', this.tenantId, 'tasks', runId)
-    }
-    return join(this.baseDir, 'tasks', runId)
-  }
-
-  private taskPath(runId: RunId, taskId: TaskId): string {
-    return join(this.taskDir(runId), `${taskId}.json`)
-  }
-
-  private async withLock<T>(taskId: TaskId, fn: () => Promise<T>): Promise<T> {
-    const existing = this.locks.get(taskId)
-    if (existing) {
-      await existing.catch(() => undefined)
-    }
-
-    let resolve: () => void
-    const lock = new Promise<void>((r) => { resolve = r })
-    this.locks.set(taskId, lock)
-
-    try {
-      return await fn()
-    } finally {
-      resolve!()
-      if (this.locks.get(taskId) === lock) {
-        this.locks.delete(taskId)
-      }
-    }
-  }
-
-  on(listener: TaskEventListener): () => void {
-    this.listeners.push(listener)
-    return () => {
-      this.listeners = this.listeners.filter((l) => l !== listener)
-    }
-  }
-
-  private emit(event: TaskEvent): void {
-    for (const listener of this.listeners) {
-      try {
-        listener(event)
-      } catch {
-      }
-    }
-  }
-
-  async create(params: CreateTaskParams): Promise<Task> {
-    const taskId = generateTaskId()
-    const runId = params.runId ?? this.defaultRunId
-
-    const task: Task = {
-      id: taskId,
-      runId,
-      tenantId: params.tenantId ?? this.tenantId,
-      subject: params.subject,
-      description: params.description,
-      activeForm: params.activeForm,
-      status: 'pending',
-      owner: params.owner,
-      blocks: [],
-      blockedBy: params.blockedBy ? [...params.blockedBy] : [],
-      metadata: params.metadata ? { ...params.metadata } : undefined,
-      createdAt: Date.now(),
-    }
-
-    const dir = this.taskDir(runId)
-    await mkdir(dir, { recursive: true })
-    await atomicWriteJson(this.taskPath(runId, taskId), task)
-
-    if (params.blockedBy) {
-      for (const blockerId of params.blockedBy) {
-        await this.withLock(blockerId, async () => {
-          const blocker = await this.readTask(runId, blockerId)
-          if (blocker && !blocker.blocks.includes(taskId)) {
-            blocker.blocks.push(taskId)
-            await atomicWriteJson(this.taskPath(runId, blockerId), blocker)
-          }
-        })
-      }
-    }
-
-    this.log.info('Task created', { taskId, subject: params.subject, runId })
-    this.emit({ type: 'task.created', taskId, task, timestamp: Date.now() })
-    return task
-  }
-
-  async get(id: TaskId): Promise<Task | undefined> {
-    return this.findTask(id)
-  }
-
-  async update(id: TaskId, updates: UpdateTaskParams): Promise<Task | undefined> {
-    const found = await this.findTask(id)
-    if (!found) return undefined
-
-    return this.withLock(id, async () => {
-      const task = await this.readTask(found.runId, id)
-      if (!task) return undefined
-
-      const previousStatus = task.status
-
-      if (updates.subject !== undefined) task.subject = updates.subject
-      if (updates.description !== undefined) task.description = updates.description
-      if (updates.activeForm !== undefined) task.activeForm = updates.activeForm
-      if (updates.owner !== undefined) task.owner = updates.owner
-      if (updates.metadata !== undefined) {
-        task.metadata = task.metadata
-          ? { ...task.metadata, ...updates.metadata }
-          : { ...updates.metadata }
-      }
-
-      if (updates.status !== undefined && updates.status !== previousStatus
-          && isForwardTransition(previousStatus, updates.status)) {
-        task.status = updates.status
-        if (updates.status === 'in_progress' && !task.startedAt) {
-          task.startedAt = Date.now()
-        }
-        if (updates.status === 'completed') {
-          task.completedAt = Date.now()
-        }
-      }
-
-      await atomicWriteJson(this.taskPath(task.runId, id), task)
-      this.emit({ type: 'task.updated', taskId: id, task, previousStatus, timestamp: Date.now() })
-      return task
-    })
-  }
-
-  async delete(id: TaskId): Promise<boolean> {
-    const found = await this.findTask(id)
-    if (!found) return false
-
-    return this.withLock(id, async () => {
-      const task = await this.readTask(found.runId, id)
-      if (!task) return false
-
-      for (const blockerId of task.blockedBy) {
-        await this.withLock(blockerId, async () => {
-          const blocker = await this.readTask(task.runId, blockerId)
-          if (blocker) {
-            blocker.blocks = blocker.blocks.filter((bid) => bid !== id)
-            await atomicWriteJson(this.taskPath(task.runId, blockerId), blocker)
-          }
-        })
-      }
-      for (const blockedId of task.blocks) {
-        await this.withLock(blockedId, async () => {
-          const blocked = await this.readTask(task.runId, blockedId)
-          if (blocked) {
-            blocked.blockedBy = blocked.blockedBy.filter((bid) => bid !== id)
-            await atomicWriteJson(this.taskPath(task.runId, blockedId), blocked)
-          }
-        })
-      }
-
-      await unlink(this.taskPath(task.runId, id)).catch(() => undefined)
-      this.log.info('Task deleted', { taskId: id })
-      this.emit({ type: 'task.deleted', taskId: id, task, timestamp: Date.now() })
-      return true
-    })
-  }
-
-  async list(filter?: { status?: TaskStatus; owner?: string; runId?: RunId }): Promise<Task[]> {
-    const runId = filter?.runId ?? this.defaultRunId
-    const dir = this.taskDir(runId)
-
-    let files: string[]
-    try {
-      files = await readdir(dir)
-    } catch {
-      return []
-    }
-
-    const tasks: Task[] = []
-    for (const file of files) {
-      if (!file.endsWith('.json')) continue
-      try {
-        const raw = await readFile(join(dir, file), 'utf-8')
-        const task = JSON.parse(raw) as Task
-        tasks.push(task)
-      } catch {
-        this.log.warn('Failed to read task file', { file })
-      }
-    }
-
-    let results = tasks
-    if (filter?.status) {
-      results = results.filter((t) => t.status === filter.status)
-    }
-    if (filter?.owner) {
-      results = results.filter((t) => t.owner === filter.owner)
-    }
-
-    return results.sort((a, b) => a.createdAt - b.createdAt)
-  }
-
-  async claim(id: TaskId, owner: string): Promise<Task | undefined> {
-    const found = await this.findTask(id)
-    if (!found) return undefined
-
-    return this.withLock(id, async () => {
-      const task = await this.readTask(found.runId, id)
-      if (!task) return undefined
-      if (task.status !== 'pending') return undefined
-      if (task.owner !== undefined) return undefined
-
-      task.owner = owner
-      task.status = 'in_progress'
-      task.startedAt = Date.now()
-
-      await atomicWriteJson(this.taskPath(task.runId, id), task)
-      this.emit({ type: 'task.claimed', taskId: id, task, timestamp: Date.now() })
-      return task
-    })
-  }
-
-  async block(blockerId: TaskId, blockedId: TaskId): Promise<void> {
-    const blockerFound = await this.findTask(blockerId)
-    const blockedFound = await this.findTask(blockedId)
-    if (!blockerFound || !blockedFound) return
-
-    await this.withLock(blockerId, async () => {
-      const blocker = await this.readTask(blockerFound.runId, blockerId)
-      if (blocker && !blocker.blocks.includes(blockedId)) {
-        blocker.blocks.push(blockedId)
-        await atomicWriteJson(this.taskPath(blocker.runId, blockerId), blocker)
-      }
-    })
-
-    await this.withLock(blockedId, async () => {
-      const blocked = await this.readTask(blockedFound.runId, blockedId)
-      if (blocked && !blocked.blockedBy.includes(blockerId)) {
-        blocked.blockedBy.push(blockerId)
-        await atomicWriteJson(this.taskPath(blocked.runId, blockedId), blocked)
-      }
-    })
-  }
-
-  async reset(): Promise<void> {
-    const dir = this.taskDir(this.defaultRunId)
-    let files: string[]
-    try {
-      files = await readdir(dir)
-    } catch {
-      return
-    }
-    for (const file of files) {
-      if (file.endsWith('.json')) {
-        await unlink(join(dir, file)).catch(() => undefined)
-      }
-    }
-  }
-
-  private async readTask(runId: RunId, taskId: TaskId): Promise<Task | null> {
-    try {
-      const raw = await readFile(this.taskPath(runId, taskId), 'utf-8')
-      return JSON.parse(raw) as Task
-    } catch {
-      return null
-    }
-  }
-
-  private async findTask(id: TaskId): Promise<Task | undefined> {
-    const task = await this.readTask(this.defaultRunId, id)
-    return task ?? undefined
-  }
+	private baseDir: string
+	private defaultRunId: RunId
+	private tenantId?: TenantId
+	private log: Logger
+	private listeners: TaskEventListener[] = []
+
+	private locks = new Map<TaskId, Promise<void>>()
+
+	constructor(config: DiskTaskStoreConfig) {
+		this.baseDir = config.baseDir
+		this.defaultRunId = config.defaultRunId
+		this.tenantId = config.tenantId
+		this.log = (config.logger ?? getRootLogger()).child({ component: 'DiskTaskStore' })
+	}
+
+	private taskDir(runId: RunId): string {
+		if (this.tenantId) {
+			return join(this.baseDir, 'tenants', this.tenantId, 'tasks', runId)
+		}
+		return join(this.baseDir, 'tasks', runId)
+	}
+
+	private taskPath(runId: RunId, taskId: TaskId): string {
+		return join(this.taskDir(runId), `${taskId}.json`)
+	}
+
+	private async withLock<T>(taskId: TaskId, fn: () => Promise<T>): Promise<T> {
+		const existing = this.locks.get(taskId)
+		if (existing) {
+			await existing.catch(() => undefined)
+		}
+
+		let resolve!: () => void
+		const lock = new Promise<void>((r) => {
+			resolve = r
+		})
+		this.locks.set(taskId, lock)
+
+		try {
+			return await fn()
+		} finally {
+			resolve?.()
+			if (this.locks.get(taskId) === lock) {
+				this.locks.delete(taskId)
+			}
+		}
+	}
+
+	on(listener: TaskEventListener): () => void {
+		this.listeners.push(listener)
+		return () => {
+			this.listeners = this.listeners.filter((l) => l !== listener)
+		}
+	}
+
+	private emit(event: TaskEvent): void {
+		for (const listener of this.listeners) {
+			try {
+				listener(event)
+			} catch {}
+		}
+	}
+
+	async create(params: CreateTaskParams): Promise<Task> {
+		const taskId = generateTaskId()
+		const runId = params.runId ?? this.defaultRunId
+
+		const task: Task = {
+			id: taskId,
+			runId,
+			tenantId: params.tenantId ?? this.tenantId,
+			subject: params.subject,
+			description: params.description,
+			activeForm: params.activeForm,
+			status: 'pending',
+			owner: params.owner,
+			blocks: [],
+			blockedBy: params.blockedBy ? [...params.blockedBy] : [],
+			metadata: params.metadata ? { ...params.metadata } : undefined,
+			createdAt: Date.now(),
+		}
+
+		const dir = this.taskDir(runId)
+		await mkdir(dir, { recursive: true })
+		await atomicWriteJson(this.taskPath(runId, taskId), task)
+
+		if (params.blockedBy) {
+			for (const blockerId of params.blockedBy) {
+				await this.withLock(blockerId, async () => {
+					const blocker = await this.readTask(runId, blockerId)
+					if (blocker && !blocker.blocks.includes(taskId)) {
+						blocker.blocks.push(taskId)
+						await atomicWriteJson(this.taskPath(runId, blockerId), blocker)
+					}
+				})
+			}
+		}
+
+		this.log.info('Task created', { taskId, subject: params.subject, runId })
+		this.emit({ type: 'task.created', taskId, task, timestamp: Date.now() })
+		return task
+	}
+
+	async get(id: TaskId): Promise<Task | undefined> {
+		return this.findTask(id)
+	}
+
+	async update(id: TaskId, updates: UpdateTaskParams): Promise<Task | undefined> {
+		const found = await this.findTask(id)
+		if (!found) return undefined
+
+		return this.withLock(id, async () => {
+			const task = await this.readTask(found.runId, id)
+			if (!task) return undefined
+
+			const previousStatus = task.status
+
+			if (updates.subject !== undefined) task.subject = updates.subject
+			if (updates.description !== undefined) task.description = updates.description
+			if (updates.activeForm !== undefined) task.activeForm = updates.activeForm
+			if (updates.owner !== undefined) task.owner = updates.owner
+			if (updates.metadata !== undefined) {
+				task.metadata = task.metadata
+					? { ...task.metadata, ...updates.metadata }
+					: { ...updates.metadata }
+			}
+
+			if (
+				updates.status !== undefined &&
+				updates.status !== previousStatus &&
+				isForwardTransition(previousStatus, updates.status)
+			) {
+				task.status = updates.status
+				if (updates.status === 'in_progress' && !task.startedAt) {
+					task.startedAt = Date.now()
+				}
+				if (updates.status === 'completed') {
+					task.completedAt = Date.now()
+				}
+			}
+
+			await atomicWriteJson(this.taskPath(task.runId, id), task)
+			this.emit({ type: 'task.updated', taskId: id, task, previousStatus, timestamp: Date.now() })
+			return task
+		})
+	}
+
+	async delete(id: TaskId): Promise<boolean> {
+		const found = await this.findTask(id)
+		if (!found) return false
+
+		return this.withLock(id, async () => {
+			const task = await this.readTask(found.runId, id)
+			if (!task) return false
+
+			for (const blockerId of task.blockedBy) {
+				await this.withLock(blockerId, async () => {
+					const blocker = await this.readTask(task.runId, blockerId)
+					if (blocker) {
+						blocker.blocks = blocker.blocks.filter((bid) => bid !== id)
+						await atomicWriteJson(this.taskPath(task.runId, blockerId), blocker)
+					}
+				})
+			}
+			for (const blockedId of task.blocks) {
+				await this.withLock(blockedId, async () => {
+					const blocked = await this.readTask(task.runId, blockedId)
+					if (blocked) {
+						blocked.blockedBy = blocked.blockedBy.filter((bid) => bid !== id)
+						await atomicWriteJson(this.taskPath(task.runId, blockedId), blocked)
+					}
+				})
+			}
+
+			await unlink(this.taskPath(task.runId, id)).catch(() => undefined)
+			this.log.info('Task deleted', { taskId: id })
+			this.emit({ type: 'task.deleted', taskId: id, task, timestamp: Date.now() })
+			return true
+		})
+	}
+
+	async list(filter?: { status?: TaskStatus; owner?: string; runId?: RunId }): Promise<Task[]> {
+		const runId = filter?.runId ?? this.defaultRunId
+		const dir = this.taskDir(runId)
+
+		let files: string[]
+		try {
+			files = await readdir(dir)
+		} catch {
+			return []
+		}
+
+		const tasks: Task[] = []
+		for (const file of files) {
+			if (!file.endsWith('.json')) continue
+			try {
+				const raw = await readFile(join(dir, file), 'utf-8')
+				const task = JSON.parse(raw) as Task
+				tasks.push(task)
+			} catch {
+				this.log.warn('Failed to read task file', { file })
+			}
+		}
+
+		let results = tasks
+		if (filter?.status) {
+			results = results.filter((t) => t.status === filter.status)
+		}
+		if (filter?.owner) {
+			results = results.filter((t) => t.owner === filter.owner)
+		}
+
+		return results.sort((a, b) => a.createdAt - b.createdAt)
+	}
+
+	async claim(id: TaskId, owner: string): Promise<Task | undefined> {
+		const found = await this.findTask(id)
+		if (!found) return undefined
+
+		return this.withLock(id, async () => {
+			const task = await this.readTask(found.runId, id)
+			if (!task) return undefined
+			if (task.status !== 'pending') return undefined
+			if (task.owner !== undefined) return undefined
+
+			task.owner = owner
+			task.status = 'in_progress'
+			task.startedAt = Date.now()
+
+			await atomicWriteJson(this.taskPath(task.runId, id), task)
+			this.emit({ type: 'task.claimed', taskId: id, task, timestamp: Date.now() })
+			return task
+		})
+	}
+
+	async block(blockerId: TaskId, blockedId: TaskId): Promise<void> {
+		const blockerFound = await this.findTask(blockerId)
+		const blockedFound = await this.findTask(blockedId)
+		if (!blockerFound || !blockedFound) return
+
+		await this.withLock(blockerId, async () => {
+			const blocker = await this.readTask(blockerFound.runId, blockerId)
+			if (blocker && !blocker.blocks.includes(blockedId)) {
+				blocker.blocks.push(blockedId)
+				await atomicWriteJson(this.taskPath(blocker.runId, blockerId), blocker)
+			}
+		})
+
+		await this.withLock(blockedId, async () => {
+			const blocked = await this.readTask(blockedFound.runId, blockedId)
+			if (blocked && !blocked.blockedBy.includes(blockerId)) {
+				blocked.blockedBy.push(blockerId)
+				await atomicWriteJson(this.taskPath(blocked.runId, blockedId), blocked)
+			}
+		})
+	}
+
+	async reset(): Promise<void> {
+		const dir = this.taskDir(this.defaultRunId)
+		let files: string[]
+		try {
+			files = await readdir(dir)
+		} catch {
+			return
+		}
+		for (const file of files) {
+			if (file.endsWith('.json')) {
+				await unlink(join(dir, file)).catch(() => undefined)
+			}
+		}
+	}
+
+	private async readTask(runId: RunId, taskId: TaskId): Promise<Task | null> {
+		try {
+			const raw = await readFile(this.taskPath(runId, taskId), 'utf-8')
+			return JSON.parse(raw) as Task
+		} catch {
+			return null
+		}
+	}
+
+	private async findTask(id: TaskId): Promise<Task | undefined> {
+		const task = await this.readTask(this.defaultRunId, id)
+		return task ?? undefined
+	}
 }
 
 async function atomicWriteFile(filePath: string, content: string): Promise<void> {
-  const tempPath = `${filePath}.tmp`
-  try {
-    await writeFile(tempPath, content, 'utf-8')
-    await rename(tempPath, filePath)
-  } catch (err) {
-    await unlink(tempPath).catch(() => undefined)
-    throw err
-  }
+	const tempPath = `${filePath}.tmp`
+	try {
+		await writeFile(tempPath, content, 'utf-8')
+		await rename(tempPath, filePath)
+	} catch (err) {
+		await unlink(tempPath).catch(() => undefined)
+		throw err
+	}
 }
 
 async function atomicWriteJson(filePath: string, value: unknown): Promise<void> {
-  await atomicWriteFile(filePath, JSON.stringify(value, null, 2))
+	await atomicWriteFile(filePath, JSON.stringify(value, null, 2))
 }