@uzukko/agentpm 0.1.0

package/src/commands/minutes.ts

@@ -0,0 +1,57 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerMinutesCommands(program: Command): void {
+  const minutes = program.command('minutes').description('Meeting minutes')
+
+  minutes
+    .command('get')
+    .description('Get meeting minutes')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--meeting-id <id>', 'Meeting ID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('minutes_get', {
+          spaceId: resolveSpaceId(opts),
+          meetingId: opts.meetingId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  minutes
+    .command('update')
+    .description('Update meeting minutes (overwrite)')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--meeting-id <id>', 'Meeting ID')
+    .requiredOption('--minutes-md <md>', 'Minutes content (Markdown)')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('minutes_update', {
+          spaceId: resolveSpaceId(opts),
+          meetingId: opts.meetingId,
+          minutesMd: opts.minutesMd,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  minutes
+    .command('append')
+    .description('Append to meeting minutes')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--meeting-id <id>', 'Meeting ID')
+    .requiredOption('--content <md>', 'Content to append (Markdown)')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('minutes_append', {
+          spaceId: resolveSpaceId(opts),
+          meetingId: opts.meetingId,
+          content: opts.content,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}

package/src/commands/review.ts

@@ -0,0 +1,89 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerReviewCommands(program: Command): void {
+  const review = program.command('review').description('Review management')
+
+  review
+    .command('list')
+    .description('List reviews')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--status <status>', 'Filter: open|approved|changes_requested')
+    .option('--limit <n>', 'Max results', '20')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('review_list', {
+          spaceId: resolveSpaceId(opts),
+          status: opts.status,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  review
+    .command('open')
+    .description('Open a review')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .requiredOption('--reviewer-ids <ids...>', 'Reviewer UUIDs (1+)')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('review_open', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+          reviewerIds: opts.reviewerIds,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  review
+    .command('approve')
+    .description('Approve a review')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('review_approve', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  review
+    .command('block')
+    .description('Block a review (request changes)')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .requiredOption('--reason <reason>', 'Block reason')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('review_block', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+          reason: opts.reason,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  review
+    .command('get')
+    .description('Get review details with approvals')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('review_get', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}

package/src/commands/scheduling.ts

@@ -0,0 +1,171 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerSchedulingCommands(program: Command): void {
+  const sched = program.command('scheduling').description('Scheduling management')
+
+  sched
+    .command('list')
+    .description('List scheduling proposals')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--status <status>', 'Filter: open|confirmed|cancelled|expired')
+    .option('--limit <n>', 'Max results', '50')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('list_scheduling_proposals', {
+          spaceId: resolveSpaceId(opts),
+          status: opts.status,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('create')
+    .description('Create a scheduling proposal (use --stdin for complex input)')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--stdin', 'Read JSON params from stdin')
+    .action(async (opts) => {
+      try {
+        let rawParams: Record<string, unknown>
+
+        if (opts.stdin) {
+          const chunks: Buffer[] = []
+          for await (const chunk of process.stdin) {
+            chunks.push(chunk as Buffer)
+          }
+          rawParams = JSON.parse(Buffer.concat(chunks).toString('utf-8'))
+          rawParams.spaceId ??= resolveSpaceId(opts)
+        } else {
+          console.error('Error: scheduling create requires --stdin with JSON input for slots/respondents.')
+          console.error('Example: echo \'{"title":"Meeting","slots":[...],"respondents":[...]}\' | agentpm scheduling create --stdin')
+          process.exit(1)
+        }
+
+        const result = await callTool('create_scheduling_proposal', rawParams)
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('respond')
+    .description('Respond to a scheduling proposal (use --stdin)')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--stdin', 'Read JSON params from stdin')
+    .requiredOption('--proposal-id <uuid>', 'Proposal UUID')
+    .action(async (opts) => {
+      try {
+        let rawParams: Record<string, unknown>
+
+        if (opts.stdin) {
+          const chunks: Buffer[] = []
+          for await (const chunk of process.stdin) {
+            chunks.push(chunk as Buffer)
+          }
+          rawParams = JSON.parse(Buffer.concat(chunks).toString('utf-8'))
+          rawParams.spaceId ??= resolveSpaceId(opts)
+          rawParams.proposalId ??= opts.proposalId
+        } else {
+          console.error('Error: scheduling respond requires --stdin with JSON responses.')
+          process.exit(1)
+        }
+
+        const result = await callTool('respond_to_proposal', rawParams)
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('confirm')
+    .description('Confirm a scheduling slot')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--proposal-id <uuid>', 'Proposal UUID')
+    .requiredOption('--slot-id <uuid>', 'Slot UUID to confirm')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('confirm_proposal_slot', {
+          spaceId: resolveSpaceId(opts),
+          proposalId: opts.proposalId,
+          slotId: opts.slotId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('cancel')
+    .description('Cancel or extend a proposal')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--proposal-id <uuid>', 'Proposal UUID')
+    .requiredOption('--action <action>', 'cancel|extend')
+    .option('--new-expires-at <datetime>', 'New expiry (ISO8601, required for extend)')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('cancel_scheduling_proposal', {
+          spaceId: resolveSpaceId(opts),
+          proposalId: opts.proposalId,
+          action: opts.action,
+          newExpiresAt: opts.newExpiresAt,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('responses')
+    .description('Get proposal response status')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--proposal-id <uuid>', 'Proposal UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('get_proposal_responses', {
+          spaceId: resolveSpaceId(opts),
+          proposalId: opts.proposalId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('suggest')
+    .description('Suggest available time slots from Google Calendar')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--user-ids <ids...>', 'User UUIDs to check')
+    .requiredOption('--start-date <date>', 'Start date (YYYY-MM-DD)')
+    .requiredOption('--end-date <date>', 'End date (YYYY-MM-DD)')
+    .option('--duration-minutes <n>', 'Duration in minutes', '60')
+    .option('--business-hour-start <n>', 'Business start hour', '9')
+    .option('--business-hour-end <n>', 'Business end hour', '18')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('suggest_available_slots', {
+          spaceId: resolveSpaceId(opts),
+          userIds: opts.userIds,
+          startDate: opts.startDate,
+          endDate: opts.endDate,
+          durationMinutes: parseInt(opts.durationMinutes),
+          businessHourStart: parseInt(opts.businessHourStart),
+          businessHourEnd: parseInt(opts.businessHourEnd),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  sched
+    .command('reminder')
+    .description('Send reminder to unresponded users')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--proposal-id <uuid>', 'Proposal UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('send_proposal_reminder', {
+          spaceId: resolveSpaceId(opts),
+          proposalId: opts.proposalId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}

package/src/commands/space.ts

@@ -0,0 +1,62 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerSpaceCommands(program: Command): void {
+  const space = program.command('space').description('Space/project management')
+
+  space
+    .command('list')
+    .description('List spaces')
+    .option('--type <type>', 'Filter: project|personal')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('space_list', { type: opts.type })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  space
+    .command('create')
+    .description('Create a space')
+    .requiredOption('--name <name>', 'Space name')
+    .option('--type <type>', 'project|personal', 'project')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('space_create', {
+          name: opts.name,
+          type: opts.type,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  space
+    .command('update')
+    .description('Update a space')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--name <name>', 'New name')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('space_update', {
+          spaceId: resolveSpaceId(opts),
+          name: opts.name,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  space
+    .command('get')
+    .description('Get space details')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('space_get', {
+          spaceId: resolveSpaceId(opts),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}

package/src/commands/task.ts

@@ -0,0 +1,179 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerTaskCommands(program: Command): void {
+  const task = program.command('task').description('Task management')
+
+  task
+    .command('list')
+    .description('List tasks')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--ball <side>', 'Filter: client|internal')
+    .option('--status <status>', 'Filter: backlog|todo|in_progress|in_review|done|considering')
+    .option('--type <type>', 'Filter: task|spec')
+    .option('--client-scope <scope>', 'Filter: deliverable|internal')
+    .option('--limit <n>', 'Max results', '50')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_list', {
+          spaceId: resolveSpaceId(opts),
+          ball: opts.ball,
+          status: opts.status,
+          type: opts.type,
+          clientScope: opts.clientScope,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('create')
+    .description('Create a task')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--title <title>', 'Task title')
+    .option('--description <desc>', 'Task description')
+    .option('--type <type>', 'task|spec', 'task')
+    .option('--ball <side>', 'client|internal', 'internal')
+    .option('--origin <origin>', 'client|internal', 'internal')
+    .option('--client-scope <scope>', 'deliverable|internal', 'deliverable')
+    .option('--client-owner-ids <ids...>', 'Client owner UUIDs')
+    .option('--internal-owner-ids <ids...>', 'Internal owner UUIDs')
+    .option('--due-date <date>', 'Due date (YYYY-MM-DD)')
+    .option('--assignee-id <uuid>', 'Assignee UUID')
+    .option('--milestone-id <uuid>', 'Milestone UUID')
+    .option('--spec-path <path>', 'Spec path (required for type=spec)')
+    .option('--decision-state <state>', 'considering|decided|implemented')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_create', {
+          spaceId: resolveSpaceId(opts),
+          title: opts.title,
+          description: opts.description,
+          type: opts.type,
+          ball: opts.ball,
+          origin: opts.origin,
+          clientScope: opts.clientScope,
+          clientOwnerIds: opts.clientOwnerIds || [],
+          internalOwnerIds: opts.internalOwnerIds || [],
+          dueDate: opts.dueDate,
+          assigneeId: opts.assigneeId,
+          milestoneId: opts.milestoneId,
+          specPath: opts.specPath,
+          decisionState: opts.decisionState,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('get')
+    .description('Get task details')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_get', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('update')
+    .description('Update a task')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .option('--title <title>', 'New title')
+    .option('--description <desc>', 'New description')
+    .option('--status <status>', 'New status')
+    .option('--due-date <date>', 'New due date')
+    .option('--assignee-id <uuid>', 'New assignee')
+    .option('--priority <n>', 'Priority (0-3)')
+    .option('--client-scope <scope>', 'deliverable|internal')
+    .option('--start-date <date>', 'Start date')
+    .option('--parent-task-id <uuid>', 'Parent task UUID')
+    .option('--actual-hours <n>', 'Actual hours')
+    .option('--milestone-id <uuid>', 'Milestone UUID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_update', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+          title: opts.title,
+          description: opts.description,
+          status: opts.status,
+          dueDate: opts.dueDate,
+          assigneeId: opts.assigneeId,
+          priority: opts.priority !== undefined ? parseInt(opts.priority) : undefined,
+          clientScope: opts.clientScope,
+          startDate: opts.startDate,
+          parentTaskId: opts.parentTaskId,
+          actualHours: opts.actualHours !== undefined ? parseFloat(opts.actualHours) : undefined,
+          milestoneId: opts.milestoneId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('delete')
+    .description('Delete a task (dry-run by default)')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--task-id <uuid>', 'Task UUID')
+    .option('--no-dry-run', 'Actually delete (requires --confirm-token)')
+    .option('--confirm-token <token>', 'Confirmation token from dry-run')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_delete', {
+          spaceId: resolveSpaceId(opts),
+          taskId: opts.taskId,
+          dryRun: opts.dryRun !== false,
+          confirmToken: opts.confirmToken,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('list-my')
+    .description('List my tasks across all spaces (scope=user API key required)')
+    .option('--ball <side>', 'Filter: client|internal')
+    .option('--status <status>', 'Filter by status')
+    .option('--client-scope <scope>', 'Filter: deliverable|internal')
+    .option('--limit <n>', 'Max results', '50')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_list_my', {
+          ball: opts.ball,
+          status: opts.status,
+          clientScope: opts.clientScope,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  task
+    .command('stale')
+    .description('Find stale tasks')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--stale-days <n>', 'Days threshold', '7')
+    .option('--ball <side>', 'Filter: client|internal')
+    .option('--limit <n>', 'Max results', '50')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('task_stale', {
+          spaceId: resolveSpaceId(opts),
+          staleDays: parseInt(opts.staleDays),
+          ball: opts.ball,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}

package/src/commands/wiki.ts

@@ -0,0 +1,110 @@
+import { Command } from 'commander'
+import { resolveSpaceId } from '../config.js'
+import { callTool } from '../api-client.js'
+import { output, outputError } from '../output.js'
+
+export function registerWikiCommands(program: Command): void {
+  const wiki = program.command('wiki').description('Wiki management')
+
+  wiki
+    .command('list')
+    .description('List wiki pages')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .option('--limit <n>', 'Max results', '50')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_list', {
+          spaceId: resolveSpaceId(opts),
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  wiki
+    .command('get')
+    .description('Get wiki page details')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--page-id <id>', 'Wiki page ID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_get', {
+          spaceId: resolveSpaceId(opts),
+          pageId: opts.pageId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  wiki
+    .command('create')
+    .description('Create a wiki page')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--title <title>', 'Page title')
+    .option('--body <body>', 'Page body (Markdown)')
+    .option('--tags <tags...>', 'Tags')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_create', {
+          spaceId: resolveSpaceId(opts),
+          title: opts.title,
+          body: opts.body,
+          tags: opts.tags,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  wiki
+    .command('update')
+    .description('Update a wiki page')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--page-id <id>', 'Wiki page ID')
+    .option('--title <title>', 'New title')
+    .option('--body <body>', 'New body (Markdown)')
+    .option('--tags <tags...>', 'New tags')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_update', {
+          spaceId: resolveSpaceId(opts),
+          pageId: opts.pageId,
+          title: opts.title,
+          body: opts.body,
+          tags: opts.tags,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  wiki
+    .command('delete')
+    .description('Delete a wiki page')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--page-id <id>', 'Wiki page ID')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_delete', {
+          spaceId: resolveSpaceId(opts),
+          pageId: opts.pageId,
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+
+  wiki
+    .command('versions')
+    .description('Get wiki page version history')
+    .option('-s, --space-id <uuid>', 'Space UUID')
+    .requiredOption('--page-id <id>', 'Wiki page ID')
+    .option('--limit <n>', 'Max results', '20')
+    .action(async (opts) => {
+      try {
+        const result = await callTool('wiki_versions', {
+          spaceId: resolveSpaceId(opts),
+          pageId: opts.pageId,
+          limit: parseInt(opts.limit),
+        })
+        output(result, program.opts().json)
+      } catch (e) { outputError(e, program.opts().json) }
+    })
+}