open-wadah 1.1.0 → 1.2.1

package/README.md

@@ -27,8 +27,9 @@ wadah complete <task-id>
 | Command | Description |
 |--------|-------------|
 | **Auth** | `login`, `signup`, `logout`, `whoami` |
-| **Tasks** | `open`, `list`, `requested`, `add`, `complete`, `reopen`, `view`, `update`, `move`, `assign`, `comment`, `delete` |
-| **Board** | `boards`, `buckets`, `assignees`; `board create/delete`, `bucket create/update/delete`, `assignee create/update/delete` |
+| **Tasks** | `open`, `list`, `search`, `requested`, `add`, `complete`, `reopen`, `view`, `update`, `move`, `assign`, `comment`, `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` |
 | **Calendar** | `calendar` (list; `--assignee`, `--task`, `--from`, `--to`), `calendar add`, `calendar update <id>`, `calendar delete <id>` |
 | **Docs** | `docs` (list), `doc create [title]`, `doc show <id>`, `doc update <id>`, `doc delete <id>` |
@@ -56,10 +57,11 @@ source ~/.zshrc
 
 ## Agent / AI use
 
-- Set `TASK_MANAGER_TOKEN` (create a token in the app under **Agent access**).
-- Use `--json` for machine-readable output: `wadah open --json`, `wadah list --json`.
+- Set `TASK_MANAGER_TOKEN` (create a token: `wadah agent-token create "My Agent"`).
+- Use `--json` for machine-readable output: `wadah open --json`, `wadah list --json`, `wadah buckets --json`.
 - Natural language: `wadah do "add a task to fix the bug"` (requires `OPENAI_API_KEY`).
 - In Cursor/Claude/Kimi: see **WADAH_CLI.md** in the repo root for a short reference.
+- For autonomous 24/7 agents with GitHub Actions: see **AGENTS.md** in the repo root.
 
 ## Global flags
 

package/cli.js

@@ -181,8 +181,8 @@ function printTaskList(tasks, state) {
 }
 
 function handleError(err) {
-  const msg = err.message ?? 'Unexpected error'
-  const code = err.code ?? 'unknown_error'
+  const msg  = err.message ?? 'Unexpected error'
+  const code = err.code    ?? 'unknown_error'
   const authLike =
     code === 'auth_error' ||
     msg.toLowerCase().includes('missing token') ||
@@ -195,6 +195,17 @@ function handleError(err) {
     console.error(chalk.red('\n✗ Not authenticated.'))
     console.error(chalk.gray('  Humans:  wadah login'))
     console.error(chalk.gray('  Agents:  TASK_MANAGER_TOKEN=<token> wadah open\n'))
+  } else if (code === 'network_error') {
+    console.error(chalk.red('\n✗ Network error — could not reach the API.'))
+    console.error(chalk.gray(`  Check your connection or API URL: ${getApiBase()}`))
+    console.error(chalk.gray('  Run: wadah doctor\n'))
+  } else if (code === 'server_error') {
+    console.error(chalk.red('\n✗ Server error — something went wrong on the API side.'))
+    console.error(chalk.gray('  Try again in a moment. If it persists, check api.openwadah.com status.\n'))
+  } else if (code === 'api_error' && msg.toLowerCase().includes('not found')) {
+    console.error(chalk.red('\n✗ Not found.'))
+    console.error(chalk.gray('  The resource may not exist, or this endpoint may not be available for agent tokens.'))
+    console.error(chalk.gray('  Run: wadah doctor\n'))
   } else {
     console.error(chalk.red(`\n✗ ${msg}\n`))
   }
@@ -262,6 +273,13 @@ function isMachineOutput() {
   return runtimeJsonOutput || runtimeQuietOutput || !process.stdout.isTTY
 }
 
+// ── session state cache ───────────────────────────────────────────────────────
+let _cachedState = null
+async function getState() {
+  if (!_cachedState) _cachedState = await api('/api/state')
+  return _cachedState
+}
+
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }
@@ -684,7 +702,7 @@ program
   .option('--completed',              'Show completed tasks instead')
   .action(async (opts) => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       let tasks = state.tasks.filter((t) => !!t.completed === !!opts.completed)
 
       if (!opts.all && !opts.assignee) {
@@ -723,7 +741,7 @@ program
       if (opts.open && opts.completed) {
         return fail('Use either --open or --completed, not both.')
       }
-      const state = await api('/api/state')
+      const state = await getState()
       let tasks = state.tasks
       if (opts.open) tasks = tasks.filter((t) => !t.completed)
       if (opts.completed) tasks = tasks.filter((t) => !!t.completed)
@@ -748,6 +766,48 @@ program
     } catch (err) { handleError(err) }
   })
 
+// ── tm search ─────────────────────────────────────────────────────────────────
+
+program
+  .command('search <query>')
+  .description('Search tasks by title, notes or tags')
+  .option('--board <name>',    'Limit search to a specific board')
+  .option('--assignee <name>', 'Limit search to a specific assignee')
+  .option('--open',            'Only open tasks (default)')
+  .option('--all',             'Include completed tasks')
+  .action(async (query, opts) => {
+    try {
+      const state = await getState()
+      const q = query.toLowerCase()
+      let tasks = state.tasks
+
+      if (!opts.all) tasks = tasks.filter((t) => !t.completed)
+      if (opts.board) {
+        const b = findBoard(state.boards, opts.board)
+        if (!b) return fail(`Board not found: ${opts.board}`)
+        tasks = tasks.filter((t) => t.boardId === b.id)
+      }
+      if (opts.assignee) {
+        const a = findAssignee(state.assignees, opts.assignee)
+        if (!a) return fail(`Assignee not found: ${opts.assignee}`)
+        tasks = tasks.filter((t) => t.assigneeId === a.id)
+      }
+
+      tasks = tasks.filter((t) =>
+        t.title.toLowerCase().includes(q) ||
+        (t.notes  ?? '').toLowerCase().includes(q) ||
+        (t.description ?? '').toLowerCase().includes(q) ||
+        (t.tags ?? []).some((tag) => tag.toLowerCase().includes(q))
+      )
+
+      if (!isMachineOutput() && tasks.length === 0) {
+        console.log(chalk.gray(`\n  No tasks matching "${query}".\n`))
+        return
+      }
+      printTaskList(tasks, state)
+    } catch (err) { handleError(err) }
+  })
+
 // ── tm requested ──────────────────────────────────────────────────────────────
 
 program
@@ -755,7 +815,7 @@ program
   .description('List open tasks you requested (assigned to others / agents)')
   .action(async () => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       const myId  = await resolveMyAssigneeId(state)
       const tasks = state.tasks.filter((t) => t.requestedById === myId && !t.completed)
       printTaskList(tasks, state)
@@ -774,9 +834,11 @@ program
   .option('--repo <owner/repo>','GitHub repo')
   .option('--url <url>',        'Issue / PR URL')
   .option('--notes <text>',     'Notes')
+  .option('--blocks <id>',      'This task blocks another task (provide task id)')
+  .option('--blocked-by <id>',  'This task is blocked by another task (provide task id)')
   .action(async (title, opts) => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       const myId  = await resolveMyAssigneeId(state)
 
       let assigneeId    = myId
@@ -789,14 +851,19 @@ program
         requestedById = myId
       }
 
-      const bucket = opts.bucket
-        ? state.buckets.find((b) => b.title.toLowerCase().includes(opts.bucket.toLowerCase()))
-        : state.buckets[0]
-
       const board = opts.board
         ? state.boards.find((b) => b.name.toLowerCase().includes(opts.board.toLowerCase()))
         : state.boards.find((b) => b.id === state.currentBoardId) ?? state.boards[0]
 
+      if (!board && opts.board) return fail(`Board not found: ${opts.board}`)
+      if (!board) console.warn(chalk.yellow(`  ⚠ No board specified — defaulting to "${state.boards[0]?.name}". Set a default with: wadah config --default-board "<name>"`))
+
+      const boardBuckets = board ? state.buckets.filter((b) => b.boardId === board.id) : state.buckets
+      const bucket = opts.bucket
+        ? boardBuckets.find((b) => b.title.toLowerCase().includes(opts.bucket.toLowerCase()))
+          ?? state.buckets.find((b) => b.title.toLowerCase().includes(opts.bucket.toLowerCase()))
+        : boardBuckets[0] ?? state.buckets[0]
+
       const task = await api('/api/tasks', {
         method: 'POST',
         body:   JSON.stringify({
@@ -809,9 +876,27 @@ program
           repo:         opts.repo   ?? null,
           contextUrl:   opts.url    ?? null,
           notes:        opts.notes  ?? '',
+          tags: [
+            ...(opts.blocks    ? [`blocks:${opts.blocks.slice(0, 8)}`]    : []),
+            ...(opts.blockedBy ? [`blocked-by:${opts.blockedBy.slice(0, 8)}`] : []),
+          ],
         }),
       })
 
+      // If this task blocks another, tag the other task back
+      if (opts.blocks) {
+        try {
+          const other = await api(`/api/tasks/${opts.blocks}`)
+          const existingTags = other.tags ?? []
+          if (!existingTags.some((t) => t.startsWith('blocked-by:'))) {
+            await api(`/api/tasks/${opts.blocks}`, {
+              method: 'PATCH',
+              body: JSON.stringify({ tags: [...existingTags, `blocked-by:${task.id.slice(0, 8)}`] }),
+            })
+          }
+        } catch {}
+      }
+
       const assigneeName = state.assignees.find((a) => a.id === task.assigneeId)?.name ?? 'Unassigned'
       console.log(chalk.green('\n✓ Created') + `  ${chalk.bold(task.title)}`)
       console.log(chalk.gray(`  ID: ${task.id}  ·  Assigned to: ${assigneeName}\n`))
@@ -856,7 +941,7 @@ program
   .requiredOption('--to <name>', 'Assignee name')
   .action(async (id, opts) => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       const a     = findAssignee(state.assignees, opts.to)
       if (!a) return fail(`Assignee not found: ${opts.to}`)
 
@@ -874,14 +959,18 @@ program
   .description('Move a task to another column')
   .action(async (id, bucketQuery) => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       const bucket = findBucket(state.buckets, bucketQuery)
       if (!bucket) return fail(`Bucket not found: ${bucketQuery}`)
+      const patch = { bucketId: bucket.id }
+      if (bucket.boardId) patch.boardId = bucket.boardId
       const task = await api(`/api/tasks/${id}`, {
         method: 'PATCH',
-        body:   JSON.stringify({ bucketId: bucket.id }),
+        body:   JSON.stringify(patch),
       })
-      console.log(chalk.green('\n✓ Moved') + `  ${chalk.bold(task.title)} → ${bucket.title}\n`)
+      const boardName = state.boards.find((b) => b.id === bucket.boardId)?.name
+      const dest = boardName ? `${boardName} / ${bucket.title}` : bucket.title
+      console.log(chalk.green('\n✓ Moved') + `  ${chalk.bold(task.title)} → ${dest}\n`)
     } catch (err) { handleError(err) }
   })
 
@@ -899,6 +988,8 @@ program
   .option('--board <name>',           'Set board')
   .option('--bucket <name>',          'Set bucket')
   .option('--completed <true|false>', 'Set completion state')
+  .option('--blocks <id>',            'Mark this task as blocking another task')
+  .option('--blocked-by <id>',        'Mark this task as blocked by another task')
   .action(async (id, opts) => {
     try {
       const patch = {}
@@ -923,7 +1014,8 @@ program
       if (opts.clearDue) patch.dueDate = null
 
       const needsStateLookup = !!(opts.assignee || opts.board || opts.bucket)
-      const state = needsStateLookup ? await api('/api/state') : null
+      const state = needsStateLookup ? await getState() : null
+
 
       if (opts.assignee) {
         const a = findAssignee(state.assignees, opts.assignee)
@@ -936,12 +1028,32 @@ program
         patch.boardId = b.id
       }
       if (opts.bucket) {
-        const b = findBucket(state.buckets, opts.bucket)
+        const targetBoardId = patch.boardId ?? null
+        const scopedBuckets = targetBoardId
+          ? state.buckets.filter((b) => b.boardId === targetBoardId)
+          : state.buckets
+        const b = scopedBuckets.find((b) => b.id === opts.bucket || b.title.toLowerCase().includes(opts.bucket.toLowerCase()))
+          ?? state.buckets.find((b) => b.id === opts.bucket || b.title.toLowerCase().includes(opts.bucket.toLowerCase()))
         if (!b) return fail(`Bucket not found: ${opts.bucket}`)
         patch.bucketId = b.id
+        if (!patch.boardId && b.boardId) patch.boardId = b.boardId
       }
       if (opts.completed !== undefined) patch.completed = parsedCompleted
 
+      // Handle relationship tags (blocks / blocked-by)
+      if (opts.blocks || opts.blockedBy) {
+        const currentTask = await api(`/api/tasks/${id}`)
+        const currentTags = currentTask.tags ?? []
+        const newTags = [...currentTags]
+        if (opts.blocks && !newTags.some((t) => t.startsWith('blocks:'))) {
+          newTags.push(`blocks:${opts.blocks.slice(0, 8)}`)
+        }
+        if (opts.blockedBy && !newTags.some((t) => t.startsWith('blocked-by:'))) {
+          newTags.push(`blocked-by:${opts.blockedBy.slice(0, 8)}`)
+        }
+        patch.tags = newTags
+      }
+
       if (Object.keys(patch).length === 0) {
         return fail('Nothing to update. Run wadah update --help')
       }
@@ -989,7 +1101,17 @@ program
       if (task.dueDate) console.log(chalk.gray(`  Due:       ${formatDate(task.dueDate)}`))
       if (task.repo) console.log(chalk.gray(`  Repo:      ${task.repo}`))
       if (task.contextUrl) console.log(chalk.gray(`  Link:      ${task.contextUrl}`))
-      if (task.tags?.length) console.log(chalk.gray(`  Tags:      #${task.tags.join('  #')}`))
+      if (task.tags?.length) {
+        const relTags = task.tags.filter((t) => t.startsWith('blocks:') || t.startsWith('blocked-by:'))
+        const plainTags = task.tags.filter((t) => !t.startsWith('blocks:') && !t.startsWith('blocked-by:'))
+        if (plainTags.length) console.log(chalk.gray(`  Tags:      #${plainTags.join('  #')}`))
+        if (relTags.length) {
+          const blocking   = relTags.filter((t) => t.startsWith('blocks:')).map((t) => t.replace('blocks:', ''))
+          const blockedBy  = relTags.filter((t) => t.startsWith('blocked-by:')).map((t) => t.replace('blocked-by:', ''))
+          if (blocking.length)  console.log(chalk.red(`  Blocks:    ${blocking.join(', ')}`))
+          if (blockedBy.length) console.log(chalk.yellow(`  Blocked by: ${blockedBy.join(', ')}`))
+        }
+      }
       if (task.description) { console.log(); console.log(`  ${task.description}`) }
       if (task.notes) { console.log(chalk.gray('\n  Notes:')); console.log(`  ${task.notes}`) }
       if (task.subtasks?.length) {
@@ -1032,7 +1154,17 @@ program
   .description('List all boards')
   .action(async () => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
+      if (isMachineOutput()) {
+        const result = state.boards.map((b) => ({
+          id:        b.id,
+          name:      b.name,
+          openCount: state.tasks.filter((t) => t.boardId === b.id && !t.completed).length,
+          doneCount: state.tasks.filter((t) => t.boardId === b.id &&  t.completed).length,
+        }))
+        console.log(JSON.stringify(result, null, runtimeJsonOutput ? 2 : 0))
+        return
+      }
       console.log()
       state.boards.forEach((b) => {
         const open = state.tasks.filter((t) => t.boardId === b.id && !t.completed).length
@@ -1048,8 +1180,20 @@ program
   .description('List all columns (buckets)')
   .action(async () => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       const boardMap = Object.fromEntries(state.boards.map((b) => [b.id, b.name]))
+      if (isMachineOutput()) {
+        const result = state.buckets.map((b) => ({
+          id:        b.id,
+          title:     b.title,
+          boardId:   b.boardId,
+          boardName: boardMap[b.boardId] ?? '—',
+          openCount: state.tasks.filter((t) => t.bucketId === b.id && !t.completed).length,
+          doneCount: state.tasks.filter((t) => t.bucketId === b.id &&  t.completed).length,
+        }))
+        console.log(JSON.stringify(result, null, runtimeJsonOutput ? 2 : 0))
+        return
+      }
       console.log()
       state.buckets.forEach((b) => {
         const open = state.tasks.filter((t) => t.bucketId === b.id && !t.completed).length
@@ -1065,7 +1209,18 @@ program
   .description('List all assignees')
   .action(async () => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
+      if (isMachineOutput()) {
+        const result = state.assignees.map((a) => ({
+          id:        a.id,
+          name:      a.name,
+          type:      a.type ?? 'human',
+          openCount: state.tasks.filter((t) => t.assigneeId === a.id && !t.completed).length,
+          doneCount: state.tasks.filter((t) => t.assigneeId === a.id &&  t.completed).length,
+        }))
+        console.log(JSON.stringify(result, null, runtimeJsonOutput ? 2 : 0))
+        return
+      }
       console.log()
       state.assignees.forEach((a) => {
         const open = state.tasks.filter((t) => t.assigneeId === a.id && !t.completed).length
@@ -1225,7 +1380,7 @@ program
   .action(async function () {
     const opts = this.opts()
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       let files = state.files ?? []
       if (opts.folder) files = files.filter((f) => (f.folderId || f.folder_id) === opts.folder)
       if (isMachineOutput()) {
@@ -1578,7 +1733,7 @@ program
   .description('Print full workspace state as JSON')
   .action(async () => {
     try {
-      const state = await api('/api/state')
+      const state = await getState()
       console.log(JSON.stringify(state, null, 2))
     } catch (err) { handleError(err) }
   })
@@ -1739,7 +1894,7 @@ const CLI_COMMANDS = [
   'add', 'agent-token', 'agent-tokens', 'assign', 'assignee', 'assignees', 'board', 'boards',
   'bucket', 'buckets', 'calendar', 'comment', 'complete', 'config', 'delete', 'doc', 'docs',
   'do', 'doctor', 'files', 'folder', 'folders', 'invite', 'list', 'login', 'members', 'mkdir',
-  'move', 'open', 'reopen', 'requested', 'signup', 'state', 'update', 'upload', 'view', 'whoami',
+  'move', 'open', 'reopen', 'requested', 'search', 'signup', 'state', 'update', 'upload', 'view', 'whoami',
 ]
 
 program

package/package.json

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