@maestro-js/agent-skills 1.0.0-alpha.2 → 1.0.0-alpha.21

package/skills/maestro-examples/references/setlist/packages/services/src/project/project-use-cases.ts

@@ -0,0 +1,183 @@
+import z from 'zod'
+import { Db } from '@maestro-js/db'
+import { Log } from '@maestro-js/log'
+import { CustomErrors } from '@maestro-js/custom-errors'
+import { ProjectSchemas, UserSchemas } from '@setlist/schemas'
+import { projectDbProvider } from './project-db-provider.ts'
+import { taskDbProvider } from '../task/task-db-provider.ts'
+import { generateKeyBetween } from '@setlist/schemas'
+
+const log = Log.channel('project')
+
+const Profile = UserSchemas.userModel.pick({ id: true })
+
+export const ProjectNotFoundError = CustomErrors.create({
+  name: 'ProjectNotFoundError',
+  message: 'Project not found',
+  httpStatusCode: 'notFound' as const
+})
+
+export const ProjectNotOwnedError = CustomErrors.create({
+  name: 'ProjectNotOwnedError',
+  message: 'Project does not belong to the authenticated user',
+  httpStatusCode: 'forbidden' as const
+})
+
+async function computeNextPosition(areaId: number | null, userId: number): Promise<string> {
+  if (areaId) {
+    const areaProjects = await projectDbProvider.listByAreaId(areaId)
+    const lastProject = areaProjects.at(-1)
+    return generateKeyBetween(lastProject?.position ?? null, null)
+  }
+  const allProjects = await projectDbProvider.listByUserId(userId)
+  const topLevelProjects = allProjects.filter((p) => p.areaId === null)
+  const lastProject = topLevelProjects.at(-1)
+  return generateKeyBetween(lastProject?.position ?? null, null)
+}
+
+export const ViewProjectTasks = z
+  .function({
+    input: [z.object({ id: z.number() }), Profile]
+  })
+  .implement(async ({ id }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    const tasks = await taskDbProvider.listByProjectId(id)
+
+    return { project, tasks }
+  })
+
+export const CreateProject = z
+  .function({
+    input: [ProjectSchemas.createProjectForm, Profile]
+  })
+  .implement(async ({ title, areaId, notes, scheduledDate }, profile) => {
+    const position = await computeNextPosition(areaId, profile.id)
+
+    const projectId = await projectDbProvider.create({
+      userId: profile.id,
+      areaId,
+      title,
+      notes,
+      scheduledDate,
+      position
+    })
+
+    log.info('Project created', { action: 'project.create', userId: profile.id, projectId })
+
+    return { projectId }
+  })
+
+export const EditProject = z
+  .function({
+    input: [ProjectSchemas.editProjectForm.extend({ id: z.number() }), Profile]
+  })
+  .implement(async ({ id, title, areaId, notes, scheduledDate }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    await projectDbProvider.update(id, {
+      title,
+      notes: notes !== undefined ? notes : project.notes,
+      scheduledDate: scheduledDate !== undefined ? scheduledDate : project.scheduledDate,
+      areaId: areaId !== undefined ? areaId : project.areaId
+    })
+
+    log.info('Project edited', { action: 'project.edit', userId: profile.id, projectId: id })
+  })
+
+export const DeleteProject = z
+  .function({
+    input: [z.object({ id: z.number() }), Profile]
+  })
+  .implement(async ({ id }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    await Db.transaction(async () => {
+      await projectDbProvider.softDelete(id)
+      await taskDbProvider.softDeleteByProjectId(id)
+    })
+
+    log.info('Project deleted', { action: 'project.delete', userId: profile.id, projectId: id })
+  })
+
+export const MoveProject = z
+  .function({
+    input: [z.object({ id: z.number(), areaId: z.number().nullable() }), Profile]
+  })
+  .implement(async ({ id, areaId }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    const position = await computeNextPosition(areaId, profile.id)
+
+    await Db.transaction(async () => {
+      await projectDbProvider.update(id, {
+        title: project.title,
+        notes: project.notes,
+        scheduledDate: project.scheduledDate,
+        areaId
+      })
+      await projectDbProvider.updatePosition(id, position)
+    })
+
+    log.info('Project moved', { action: 'project.move', userId: profile.id, projectId: id, areaId })
+  })
+
+export const CompleteProject = z
+  .function({
+    input: [z.object({ id: z.number() }), Profile]
+  })
+  .implement(async ({ id }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    await projectDbProvider.complete(id)
+
+    log.info('Project completed', { action: 'project.complete', userId: profile.id, projectId: id })
+  })
+
+export const UncompleteProject = z
+  .function({
+    input: [z.object({ id: z.number() }), Profile]
+  })
+  .implement(async ({ id }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    await projectDbProvider.uncomplete(id)
+
+    log.info('Project uncompleted', { action: 'project.uncomplete', userId: profile.id, projectId: id })
+  })
+
+export const ReorderProject = z
+  .function({
+    input: [z.object({ id: z.number(), beforeKey: z.string().nullable(), afterKey: z.string().nullable() }), Profile]
+  })
+  .implement(async ({ id, beforeKey, afterKey }, profile) => {
+    const project = await projectDbProvider.getById(id)
+    if (!project) throw new ProjectNotFoundError()
+    if (project.userId !== profile.id) throw new ProjectNotOwnedError()
+
+    const position = generateKeyBetween(beforeKey, afterKey)
+    await projectDbProvider.updatePosition(id, position)
+
+    log.info('Project reordered', { action: 'project.reorder', userId: profile.id, projectId: id })
+  })
+
+export const ListProjects = z
+  .function({
+    input: [z.object({}), Profile]
+  })
+  .implement(async (_data, profile) => {
+    const projects = await projectDbProvider.listByUserId(profile.id)
+    return projects.filter((p) => p.completedDate === null)
+  })

package/skills/maestro-examples/references/setlist/packages/services/src/task/index.ts

@@ -0,0 +1,39 @@
+import {
+  ViewTask,
+  CreateTask,
+  EditTask,
+  DeleteTask,
+  MoveTask,
+  CompleteTask,
+  UncompleteTask,
+  ReorderTask,
+  GetSidebarCounts,
+  ListTasksForInbox,
+  ListTasksForToday,
+  ListTasksForUpcoming,
+  ListCompleted,
+  ListTasksByProjectId,
+  TaskNotFoundError,
+  TaskNotOwnedError
+} from './task-use-cases.ts'
+
+export const TaskService = {
+  ViewTask,
+  CreateTask,
+  EditTask,
+  DeleteTask,
+  MoveTask,
+  CompleteTask,
+  UncompleteTask,
+  ReorderTask,
+  GetSidebarCounts,
+  ListTasksForInbox,
+  ListTasksForToday,
+  ListTasksForUpcoming,
+  ListCompleted,
+  ListTasksByProjectId,
+  errors: {
+    TaskNotFoundError,
+    TaskNotOwnedError
+  }
+}

package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.test.ts

@@ -0,0 +1,53 @@
+import { test } from 'beartest-js'
+import { expect } from 'expect'
+import { H } from '../testing/index.ts'
+import { taskDbProvider } from './task-db-provider.ts'
+
+const user = H.UserSeed({ id: 1 })
+const pipe = H.SeedPipe(user)
+
+test.beforeEach(async () => { await pipe.setup() })
+test.afterEach(async () => { await pipe.teardown() })
+
+test('create and getById', async () => {
+  const id = await taskDbProvider.create({
+    userId: 1,
+    projectId: null,
+    areaId: null,
+    title: 'Buy milk',
+    notes: null,
+    scheduledDate: null,
+    listPosition: 'a0',
+    scheduledPosition: null
+  })
+  const task = await taskDbProvider.getById(id)
+  expect(task).not.toBeNull()
+  expect(task!.title).toBe('Buy milk')
+  expect(task!.userId).toBe(1)
+  expect(task!.completedDate).toBeNull()
+})
+
+test('update and listInbox', async () => {
+  await taskDbProvider.create({
+    userId: 1,
+    projectId: null,
+    areaId: null,
+    title: 'Original',
+    notes: null,
+    scheduledDate: null,
+    listPosition: 'a0',
+    scheduledPosition: null
+  })
+  const inbox = await taskDbProvider.listInbox(1)
+  expect(inbox).toHaveLength(1)
+
+  await taskDbProvider.update(inbox[0]!.id, {
+    title: 'Updated',
+    notes: 'some notes',
+    scheduledDate: null,
+    scheduledPosition: null
+  })
+  const updated = await taskDbProvider.getById(inbox[0]!.id)
+  expect(updated!.title).toBe('Updated')
+  expect(updated!.notes).toBe('some notes')
+})

package/skills/maestro-examples/references/setlist/packages/services/src/task/task-db-provider.ts

@@ -0,0 +1,219 @@
+import { Db } from '@maestro-js/db'
+import { TaskSchemas } from '@setlist/schemas'
+import { instantFns, type Iso } from 'iso-fns'
+
+type Task = TaskSchemas.taskModel
+
+async function create(
+  data: Pick<
+    Task,
+    'userId' | 'projectId' | 'areaId' | 'title' | 'notes' | 'scheduledDate' | 'listPosition' | 'scheduledPosition'
+  > & { id?: number }
+): Promise<number> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  const result = await Db.insert(
+    'INSERT INTO tasks (id, userId, projectId, areaId, title, notes, scheduledDate, listPosition, scheduledPosition, createdDate, lastModifiedDate) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+    [
+      data.id,
+      data.userId,
+      data.projectId,
+      data.areaId,
+      data.title,
+      data.notes,
+      data.scheduledDate,
+      data.listPosition,
+      data.scheduledPosition,
+      now,
+      now
+    ]
+  )
+  return result.insertId
+}
+
+async function getById(id: number): Promise<Task | null> {
+  const rows = await Db.select('SELECT * FROM tasks WHERE id = ?', [id])
+  const row = rows[0]
+  if (!row) return null
+  return TaskSchemas.taskModel.parse(row)
+}
+
+async function update(
+  id: number,
+  data: Pick<Task, 'title' | 'notes' | 'scheduledDate' | 'scheduledPosition'>
+): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update(
+    'UPDATE tasks SET title = ?, notes = ?, scheduledDate = ?, scheduledPosition = ?, lastModifiedDate = ? WHERE id = ?',
+    [data.title, data.notes, data.scheduledDate, data.scheduledPosition, now, id]
+  )
+}
+
+async function softDelete(id: number): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update('UPDATE tasks SET deletedDate = ?, lastModifiedDate = ? WHERE id = ?', [now, now, id])
+}
+
+async function softDeleteByProjectId(projectId: number): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update('UPDATE tasks SET deletedDate = ?, lastModifiedDate = ? WHERE projectId = ? AND deletedDate IS NULL', [
+    now,
+    now,
+    projectId
+  ])
+}
+
+async function seedCreate(data: Task): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.insert(
+    'INSERT INTO tasks (id, userId, projectId, areaId, title, notes, scheduledDate, listPosition, scheduledPosition, completedDate, deletedDate, createdDate, lastModifiedDate) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+    [
+      data.id,
+      data.userId,
+      data.projectId,
+      data.areaId,
+      data.title,
+      data.notes,
+      data.scheduledDate,
+      data.listPosition,
+      data.scheduledPosition,
+      data.completedDate ? instantFns.formatISO9075(data.completedDate) : null,
+      data.deletedDate ? instantFns.formatISO9075(data.deletedDate) : null,
+      now,
+      now
+    ]
+  )
+}
+
+async function hardDelete(id: number): Promise<void> {
+  await Db.delete('DELETE FROM tasks WHERE id = ?', [id])
+}
+
+async function complete(id: number): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update('UPDATE tasks SET completedDate = ?, lastModifiedDate = ? WHERE id = ?', [now, now, id])
+}
+
+async function completeByProjectId(projectId: number): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update(
+    'UPDATE tasks SET completedDate = ?, lastModifiedDate = ? WHERE projectId = ? AND completedDate IS NULL AND deletedDate IS NULL',
+    [now, now, projectId]
+  )
+}
+
+async function uncomplete(id: number): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update('UPDATE tasks SET completedDate = NULL, lastModifiedDate = ? WHERE id = ?', [now, id])
+}
+
+async function updatePosition(id: number, listPosition: string, scheduledPosition?: string): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  if (scheduledPosition !== undefined) {
+    await Db.update('UPDATE tasks SET listPosition = ?, scheduledPosition = ?, lastModifiedDate = ? WHERE id = ?', [
+      listPosition,
+      scheduledPosition,
+      now,
+      id
+    ])
+  } else {
+    await Db.update('UPDATE tasks SET listPosition = ?, lastModifiedDate = ? WHERE id = ?', [listPosition, now, id])
+  }
+}
+
+async function updateContainer(id: number, data: Pick<Task, 'projectId' | 'areaId' | 'listPosition'>): Promise<void> {
+  const now = instantFns.formatISO9075(instantFns.now())
+  await Db.update('UPDATE tasks SET projectId = ?, areaId = ?, listPosition = ?, lastModifiedDate = ? WHERE id = ?', [
+    data.projectId,
+    data.areaId,
+    data.listPosition,
+    now,
+    id
+  ])
+}
+
+async function listInbox(userId: number): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE userId = ? AND projectId IS NULL AND areaId IS NULL AND scheduledDate IS NULL AND completedDate IS NULL AND deletedDate IS NULL ORDER BY listPosition COLLATE utf8mb4_bin ASC',
+    [userId]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function listToday(userId: number, today: Iso.Date): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE userId = ? AND scheduledDate <= ? AND completedDate IS NULL AND deletedDate IS NULL ORDER BY scheduledPosition COLLATE utf8mb4_bin ASC',
+    [userId, today]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function listUpcoming(userId: number, after: Iso.Date): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE userId = ? AND scheduledDate > ? AND completedDate IS NULL AND deletedDate IS NULL ORDER BY scheduledDate ASC, scheduledPosition COLLATE utf8mb4_bin ASC',
+    [userId, after]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function listCompleted(userId: number): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE userId = ? AND completedDate IS NOT NULL AND deletedDate IS NULL ORDER BY completedDate DESC',
+    [userId]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function listByProjectId(projectId: number): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE projectId = ? AND completedDate IS NULL AND deletedDate IS NULL ORDER BY listPosition COLLATE utf8mb4_bin ASC',
+    [projectId]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function listByAreaId(areaId: number): Promise<Task[]> {
+  const rows = await Db.select(
+    'SELECT * FROM tasks WHERE areaId = ? AND projectId IS NULL AND completedDate IS NULL AND deletedDate IS NULL ORDER BY listPosition COLLATE utf8mb4_bin ASC',
+    [areaId]
+  )
+  return rows.map((row) => TaskSchemas.taskModel.parse(row))
+}
+
+async function countInbox(userId: number): Promise<number> {
+  const rows = await Db.select(
+    'SELECT COUNT(*) AS cnt FROM tasks WHERE userId = ? AND projectId IS NULL AND areaId IS NULL AND scheduledDate IS NULL AND completedDate IS NULL AND deletedDate IS NULL',
+    [userId]
+  )
+  return (rows[0] as { cnt: number }).cnt
+}
+
+async function countToday(userId: number, today: Iso.Date): Promise<number> {
+  const rows = await Db.select(
+    'SELECT COUNT(*) AS cnt FROM tasks WHERE userId = ? AND scheduledDate <= ? AND completedDate IS NULL AND deletedDate IS NULL',
+    [userId, today]
+  )
+  return (rows[0] as { cnt: number }).cnt
+}
+
+export const taskDbProvider = {
+  create,
+  getById,
+  update,
+  softDelete,
+  softDeleteByProjectId,
+  complete,
+  completeByProjectId,
+  uncomplete,
+  updatePosition,
+  updateContainer,
+  listInbox,
+  listToday,
+  listUpcoming,
+  listCompleted,
+  listByProjectId,
+  listByAreaId,
+  countInbox,
+  countToday,
+  seedCreate,
+  hardDelete
+}