open-wadah 1.2.2 → 1.2.3

package/README.md

@@ -27,7 +27,7 @@ wadah complete <task-id>
 | Command | Description |
 |--------|-------------|
 | **Auth** | `login`, `signup`, `logout`, `whoami` |
-| **Tasks** | `open`, `list`, `search`, `requested`, `add`, `complete`, `reopen`, `view`, `update`, `move`, `assign`, `comment`, `delete` |
+| **Tasks** | `open`, `list`, `search`, `requested`, `add`, `complete`, `reopen`, `view`, `update`, `move`, `assign`, `comment`, `subtask list/add/toggle/delete`, `delete` |
 | **Relationships** | `add --blocks <id>`, `add --blocked-by <id>`, `update --blocks <id>` |
 | **Board** | `boards --json`, `buckets --json`, `assignees --json`; `board create/delete`, `bucket create/update/delete`, `assignee create/update/delete` |
 | **Files** | `folders`, `files`, `folder create` / `mkdir`, `upload` |
@@ -39,6 +39,15 @@ wadah complete <task-id>
 
 Run `wadah --help` for full list and options.
 
+Subtask examples:
+
+```bash
+wadah subtask add <task-id> "Write tests"
+wadah subtask list <task-id>
+wadah subtask toggle <task-id> <subtask-id>
+wadah subtask delete <task-id> <subtask-id>
+```
+
 ## Shell completion
 
 **Bash:**

package/cli.js

@@ -279,6 +279,23 @@ function findBucket(buckets, query) {
   return buckets.find((b) => b.id === query || b.title.toLowerCase().includes(q)) ?? null
 }
 
+function findSubtask(subtasks, query) {
+  const raw = String(query ?? '').trim()
+  if (!raw) return null
+  const q = raw.toLowerCase()
+  const byId = subtasks.filter((s) => s.id === raw || s.id.startsWith(raw))
+  if (byId.length === 1) return byId[0]
+  if (byId.length > 1) {
+    throw new CliError('validation_error', `Ambiguous subtask id prefix: ${raw}`)
+  }
+  const byTitle = subtasks.filter((s) => String(s.title ?? '').toLowerCase() === q)
+  if (byTitle.length === 1) return byTitle[0]
+  if (byTitle.length > 1) {
+    throw new CliError('validation_error', `Multiple subtasks have title: ${raw}`)
+  }
+  return null
+}
+
 function parseCompletedFlag(value) {
   if (typeof value !== 'string') return null
   const v = value.trim().toLowerCase()
@@ -410,6 +427,8 @@ Available commands and their args (use these exact command names):
 - repo add: args = [github url or owner/repo]. Link a GitHub repository to your workspace.
 - repo list (or repos): args = []. List linked GitHub repositories.
 - repo remove: args = [repo id]. Unlink a repository.
+- pr link: args = [task id, pr url]. Attach a PR URL to a task.
+- pr open: args = [task id]. Open the linked PR URL for a task.
 
 If the request is unclear or not a valid CLI action, return {"command": "", "args": []}. Output only the JSON object.`
 
@@ -1280,6 +1299,87 @@ program
     } catch (err) { handleError(err) }
   })
 
+const subtaskCmd = program.command('subtask').description('Manage task subtasks')
+
+subtaskCmd
+  .command('list <taskId>')
+  .description('List subtasks on a task')
+  .action(async (taskId) => {
+    try {
+      const task = await api(`/api/tasks/${taskId}`)
+      const subtasks = task.subtasks ?? []
+      if (isMachineOutput()) {
+        console.log(JSON.stringify({ taskId, subtasks }, null, runtimeJsonOutput ? 2 : 0))
+        return
+      }
+      console.log()
+      if (subtasks.length === 0) {
+        console.log(chalk.gray('  No subtasks.\n'))
+        return
+      }
+      console.log(chalk.bold(task.title))
+      subtasks.forEach((s) => {
+        const status = s.completed ? chalk.green('✓') : '○'
+        console.log(`  ${status}  ${s.title}  ${chalk.gray(s.id.slice(0, 8))}`)
+      })
+      console.log()
+    } catch (err) { handleError(err) }
+  })
+
+subtaskCmd
+  .command('add <taskId> <title>')
+  .description('Add a subtask to a task')
+  .action(async (taskId, title) => {
+    try {
+      const trimmedTitle = String(title ?? '').trim()
+      if (!trimmedTitle) return fail('Subtask title is required')
+      const task = await api(`/api/tasks/${taskId}`)
+      const nextSubtask = { id: randomUUID(), title: trimmedTitle, completed: false }
+      await api(`/api/tasks/${taskId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ subtasks: [...(task.subtasks ?? []), nextSubtask] }),
+      })
+      console.log(chalk.green('\n✓ Subtask added') + `  ${chalk.bold(nextSubtask.title)} ${chalk.gray(`(${nextSubtask.id.slice(0, 8)})`)}\n`)
+    } catch (err) { handleError(err) }
+  })
+
+subtaskCmd
+  .command('toggle <taskId> <subtaskId>')
+  .description('Toggle subtask completion')
+  .action(async (taskId, subtaskId) => {
+    try {
+      const task = await api(`/api/tasks/${taskId}`)
+      const subtasks = task.subtasks ?? []
+      const target = findSubtask(subtasks, subtaskId)
+      if (!target) return fail(`Subtask not found: ${subtaskId}`)
+      const nextSubtasks = subtasks.map((s) => s.id === target.id ? { ...s, completed: !s.completed } : s)
+      await api(`/api/tasks/${taskId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ subtasks: nextSubtasks }),
+      })
+      const marker = !target.completed ? chalk.green('✓') : '○'
+      console.log(chalk.green('\n✓ Subtask updated') + `  ${marker} ${chalk.bold(target.title)}\n`)
+    } catch (err) { handleError(err) }
+  })
+
+subtaskCmd
+  .command('delete <taskId> <subtaskId>')
+  .description('Delete a subtask from a task')
+  .action(async (taskId, subtaskId) => {
+    try {
+      const task = await api(`/api/tasks/${taskId}`)
+      const subtasks = task.subtasks ?? []
+      const target = findSubtask(subtasks, subtaskId)
+      if (!target) return fail(`Subtask not found: ${subtaskId}`)
+      const nextSubtasks = subtasks.filter((s) => s.id !== target.id)
+      await api(`/api/tasks/${taskId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ subtasks: nextSubtasks }),
+      })
+      console.log(chalk.green('\n✓ Subtask deleted') + `  ${chalk.bold(target.title)}\n`)
+    } catch (err) { handleError(err) }
+  })
+
 // ── tm boards ─────────────────────────────────────────────────────────────────
 
 program
@@ -1382,6 +1482,29 @@ boardCmd
     } catch (err) { handleError(err) }
   })
 
+boardCmd
+  .command('rename <id> <name>')
+  .description('Rename a board')
+  .action(async (id, name) => {
+    try {
+      const payload = JSON.stringify({ name: String(name).trim() })
+      let board
+      try {
+        board = await api(`/api/boards/${id}`, { method: 'PATCH', body: payload })
+      } catch (err) {
+        // Backward compatibility: some deployments only support PUT for board rename.
+        const notFound = err instanceof CliError && err.code === 'api_error' && String(err.message).toLowerCase().includes('not found')
+        if (!notFound) throw err
+        board = await api(`/api/boards/${id}`, { method: 'PUT', body: payload })
+      }
+      if (isMachineOutput()) {
+        console.log(JSON.stringify(board, null, runtimeJsonOutput ? 2 : 0))
+      } else {
+        console.log(chalk.green('\n✓ Board renamed') + `  ${chalk.bold(board.name)}  ${chalk.gray(board.id?.slice(0, 8))}\n`)
+      }
+    } catch (err) { handleError(err) }
+  })
+
 boardCmd
   .command('delete <id>')
   .description('Delete a board (cannot delete the last one)')
@@ -1630,6 +1753,79 @@ repoCmd
     } catch (err) { handleError(err) }
   })
 
+const prCmd = program.command('pr').description('Attach and open pull requests on tasks')
+
+prCmd
+  .command('link <taskId> <prUrl>')
+  .description('Attach a PR URL to a task')
+  .option('--comment', 'Add a task comment with the PR link')
+  .action(async function (taskId, prUrl) {
+    const opts = this.opts()
+    try {
+      let parsed
+      try {
+        parsed = new URL(String(prUrl).trim())
+      } catch {
+        return fail('Provide a valid PR URL (e.g. https://github.com/owner/repo/pull/123)')
+      }
+      if (!['http:', 'https:'].includes(parsed.protocol)) {
+        return fail('PR URL must start with http:// or https://')
+      }
+      const normalizedUrl = parsed.toString()
+
+      const task = await api(`/api/tasks/${taskId}`)
+      await api(`/api/tasks/${taskId}`, {
+        method: 'PATCH',
+        body: JSON.stringify({ contextUrl: normalizedUrl }),
+      })
+      if (opts.comment) {
+        const comment = {
+          id: randomUUID(),
+          text: `Linked PR: ${normalizedUrl}`,
+          createdAt: Date.now(),
+        }
+        await api(`/api/tasks/${taskId}`, {
+          method: 'PATCH',
+          body: JSON.stringify({ comments: [...(task.comments ?? []), comment] }),
+        })
+      }
+
+      if (isMachineOutput()) {
+        console.log(JSON.stringify({ taskId, prUrl: normalizedUrl, linked: true, commented: Boolean(opts.comment) }, null, runtimeJsonOutput ? 2 : 0))
+      } else {
+        console.log(chalk.green('\n✓ PR linked') + `  ${chalk.bold(task.title)}`)
+        console.log(chalk.gray(`  ${normalizedUrl}${opts.comment ? '  ·  comment added' : ''}\n`))
+      }
+    } catch (err) { handleError(err) }
+  })
+
+prCmd
+  .command('open <taskId>')
+  .description('Open the linked PR URL for a task')
+  .option('--no-browser', "Don't auto-open browser; print URL only")
+  .action(async function (taskId) {
+    const opts = this.opts()
+    try {
+      const task = await api(`/api/tasks/${taskId}`)
+      const url = task?.contextUrl ? String(task.contextUrl).trim() : ''
+      if (!url) return fail('This task has no linked PR URL. Use: wadah pr link <task-id> <pr-url>')
+
+      if (isMachineOutput()) {
+        console.log(JSON.stringify({ taskId, prUrl: url }, null, runtimeJsonOutput ? 2 : 0))
+        return
+      }
+
+      console.log(chalk.gray(`\nPR: ${url}`))
+      if (opts.browser) {
+        const opened = await openBrowser(url)
+        if (opened) console.log(chalk.green('✓ Opened in browser\n'))
+        else console.log(chalk.yellow('Could not open browser automatically. Open the URL manually.\n'))
+      } else {
+        console.log()
+      }
+    } catch (err) { handleError(err) }
+  })
+
 // ── agent tokens ──────────────────────────────────────────────────────────────
 
 program
@@ -2255,7 +2451,7 @@ const CLI_COMMANDS = [
   'add', 'agent-token', 'agent-tokens', 'assign', 'assignee', 'assignees', 'board', 'board-view', 'boards',
   'bucket', 'buckets', 'calendar', 'comment', 'complete', 'config', 'delete', 'doc', 'docs',
   'do', 'doctor', 'files', 'folder', 'folders', 'invite', 'list', 'login', 'members', 'mkdir',
-  'forget', 'memory', 'memory-export', 'memory-log', 'move', 'open', 'repo', 'repos', 'reopen', 'remember', 'requested', 'search', 'setup-agent', 'signup', 'state', 'update', 'upload', 'view', 'whoami',
+  'forget', 'memory', 'memory-export', 'memory-log', 'move', 'open', 'pr', 'repo', 'repos', 'reopen', 'remember', 'requested', 'search', 'setup-agent', 'signup', 'state', 'update', 'upload', 'view', 'whoami',
 ]
 
 // ── wadah setup-agent ─────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-wadah",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Open Wadah CLI — shared task board for humans and agents",
   "type": "module",
   "bin": {