@bbigbang/cli 0.1.0

package/dist/commands/taskCommands.js

@@ -0,0 +1,195 @@
+import { AGENT_COMMAND_ERROR_CODES, AgentCommandError, MUTATION_HINTS, appendCommonBody, createRuntime, formatTaskHeld, isHeldResponse, normalizeAgentTaskStatus, normalizeTaskListStatus, normalizeTaskScope, parseJsonStringOrThrow, parsePositiveInteger, parsePositiveIntegerList, parseRequiredPositiveInteger, readOptionalStdin, repeatOption, requireString, responseError, summarizeClaimResults, summarizeTaskHistory, summarizeTaskList, summarizeTaskLookup, withHint, writeOutput } from '../cliSupport.js';
+export function registerTaskCommands(program, options) {
+    const task = program.command('task').description('Task operations');
+    task.command('create')
+        .description('Create tasks from stdin JSON or flags')
+        .option('--channel <target>', 'Channel or DM target')
+        .option('--title <title>', 'Task title; repeatable', repeatOption)
+        .option('--description <text>', 'Task description when using --title')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const stdin = (await readOptionalStdin(runtime.io.stdin)) ?? '';
+        const body = stdin
+            ? parseJsonStringOrThrow(stdin, 'task create JSON payload')
+            : (() => {
+                const titles = opts.title ?? [];
+                if (titles.length === 0) {
+                    throw new AgentCommandError(AGENT_COMMAND_ERROR_CODES.INVALID_ARG, '--title is required when no task create JSON payload is piped on stdin.');
+                }
+                return {
+                    channel: requireString(opts.channel, '--channel'),
+                    tasks: titles.map((title) => ({
+                        title,
+                        description: requireString(opts.description, '--description'),
+                    })),
+                };
+            })();
+        const response = await runtime.client.request('POST', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks`, appendCommonBody(runtime, body));
+        if (!response.ok)
+            throw responseError(response, 'create tasks failed');
+        const data = response.data;
+        writeOutput(runtime, withHint(`Created ${data?.tasks?.length ?? 0} task(s).`, MUTATION_HINTS.taskCreate), response.data);
+    });
+    task.command('list')
+        .description('List tasks for a channel or DM target')
+        .requiredOption('--channel <target>', 'Channel or canonical DM target')
+        .option('--status <status>', 'Filter: all, todo, in_progress, in_review, done', 'all')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const channel = requireString(opts.channel, '--channel');
+        const status = normalizeTaskListStatus(opts.status);
+        const params = new URLSearchParams();
+        params.set('channel', channel);
+        if (status !== 'all')
+            params.set('status', status);
+        const response = await runtime.client.request('GET', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks?${params.toString()}`);
+        if (!response.ok)
+            throw responseError(response, 'list tasks failed');
+        writeOutput(runtime, summarizeTaskList(response.data, 'No tasks found.'), response.data);
+    });
+    task.command('my')
+        .description('List tasks visible to the current agent')
+        .option('--status <status>', 'Filter: all, todo, in_progress, in_review, done', 'all')
+        .option('--scope <scope>', 'Scope: all, dm, channel', 'all')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const status = normalizeTaskListStatus(opts.status);
+        const scope = normalizeTaskScope(opts.scope);
+        const params = new URLSearchParams();
+        params.set('status', status);
+        params.set('scope', scope);
+        const response = await runtime.client.request('GET', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/my-tasks?${params.toString()}`);
+        if (!response.ok)
+            throw responseError(response, 'list my tasks failed');
+        writeOutput(runtime, summarizeTaskList(response.data, 'No visible tasks found.'), response.data);
+    });
+    task.command('status')
+        .description('Read one task by agent task ref')
+        .requiredOption('--task-ref <ref>', 'Agent task ref, e.g. task_ab12cd34ef56')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const params = new URLSearchParams();
+        params.set('task_ref', requireString(opts.taskRef, '--task-ref'));
+        const response = await runtime.client.request('GET', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/by-ref?${params.toString()}`);
+        if (!response.ok)
+            throw responseError(response, 'task status failed');
+        writeOutput(runtime, summarizeTaskLookup(response.data), response.data);
+    });
+    task.command('history')
+        .description('Read task history events by agent task ref')
+        .requiredOption('--task-ref <ref>', 'Agent task ref, e.g. task_ab12cd34ef56')
+        .option('--limit <n>', 'Maximum events')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const params = new URLSearchParams();
+        params.set('task_ref', requireString(opts.taskRef, '--task-ref'));
+        const limit = parsePositiveInteger('limit', opts.limit);
+        if (limit !== undefined)
+            params.set('limit', String(Math.min(limit, 200)));
+        const response = await runtime.client.request('GET', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/history?${params.toString()}`);
+        if (!response.ok)
+            throw responseError(response, 'task history failed');
+        writeOutput(runtime, summarizeTaskHistory(response.data), response.data);
+    });
+    task.command('claim')
+        .description('Claim existing tasks or promote messages into claimed tasks')
+        .requiredOption('--channel <target>', 'Channel or DM target')
+        .option('--task-number <n>', 'Task number to claim; repeatable', repeatOption)
+        .option('--message-id <id>', 'Message id/prefix to promote and claim; repeatable', repeatOption)
+        .option('--title <title>', 'Optional title override when claiming by message id')
+        .option('--description <text>', 'Required brief when claiming by message id')
+        .option('--collaborator-name <name>', 'Collaborator agent name; repeatable', repeatOption)
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const taskNumbers = parsePositiveIntegerList('task-number', opts.taskNumber);
+        const messageIds = Array.isArray(opts.messageId)
+            ? opts.messageId.map((value) => value.trim()).filter(Boolean)
+            : undefined;
+        if ((!taskNumbers || taskNumbers.length === 0) && (!messageIds || messageIds.length === 0)) {
+            throw new AgentCommandError(AGENT_COMMAND_ERROR_CODES.INVALID_ARG, 'Provide at least one --task-number or --message-id.');
+        }
+        if (messageIds?.length && !String(opts.description ?? '').trim()) {
+            throw new AgentCommandError(AGENT_COMMAND_ERROR_CODES.INVALID_ARG, '--description is required when claiming by --message-id.');
+        }
+        const collaborators = Array.isArray(opts.collaboratorName)
+            ? opts.collaboratorName.map((value) => value.trim()).filter(Boolean)
+            : undefined;
+        const response = await runtime.client.request('POST', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/claim`, appendCommonBody(runtime, {
+            channel: requireString(opts.channel, '--channel'),
+            ...(taskNumbers?.length ? { task_numbers: taskNumbers } : {}),
+            ...(messageIds?.length ? { message_ids: messageIds } : {}),
+            ...(opts.title ? { title: String(opts.title) } : {}),
+            ...(opts.description ? { description: String(opts.description) } : {}),
+            ...(collaborators?.length ? { collaborator_names: collaborators } : {}),
+        }));
+        if (!response.ok)
+            throw responseError(response, 'claim tasks failed');
+        writeOutput(runtime, withHint(summarizeClaimResults(response.data), MUTATION_HINTS.taskClaim), response.data);
+    });
+    task.command('unclaim')
+        .description('Release the current agent claim on a task')
+        .requiredOption('--channel <target>', 'Channel or DM target')
+        .requiredOption('--number <n>', 'Task number to unclaim')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const taskNumber = parseRequiredPositiveInteger('number', opts.number);
+        const response = await runtime.client.request('POST', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/unclaim`, appendCommonBody(runtime, {
+            channel: requireString(opts.channel, '--channel'),
+            task_number: taskNumber,
+        }));
+        if (!response.ok)
+            throw responseError(response, 'unclaim task failed');
+        writeOutput(runtime, `Task #${taskNumber} unclaimed.`, response.data);
+    });
+    task.command('update')
+        .description('Update task status')
+        .requiredOption('--channel <target>', 'Channel target')
+        .requiredOption('--number <n>', 'Task number')
+        .requiredOption('--status <status>', 'New status')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const channel = requireString(opts.channel, '--channel');
+        const taskNumber = parseRequiredPositiveInteger('number', opts.number);
+        const status = normalizeAgentTaskStatus(opts.status);
+        const response = await runtime.client.request('POST', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/update-status`, appendCommonBody(runtime, {
+            channel,
+            task_number: taskNumber,
+            status,
+        }));
+        if (!response.ok) {
+            if (isHeldResponse(response.data)) {
+                writeOutput(runtime, formatTaskHeld('update', channel, response.data), response.data);
+                return;
+            }
+            throw responseError(response, 'update task status failed');
+        }
+        writeOutput(runtime, `Task #${taskNumber} moved to ${status}.`, response.data);
+    });
+    task.command('update-details')
+        .description('Update a task title and brief')
+        .requiredOption('--channel <target>', 'Channel or DM target')
+        .requiredOption('--number <n>', 'Task number')
+        .requiredOption('--title <title>', 'New task title')
+        .requiredOption('--description <text>', 'New task brief')
+        .action(async (opts) => {
+        const runtime = createRuntime(program, options);
+        const channel = requireString(opts.channel, '--channel');
+        const taskNumber = parseRequiredPositiveInteger('number', opts.number);
+        const title = requireString(opts.title, '--title');
+        const description = requireString(opts.description, '--description');
+        const response = await runtime.client.request('POST', `/api/internal/agent/${encodeURIComponent(runtime.context.agentId)}/tasks/update-details`, appendCommonBody(runtime, {
+            channel,
+            task_number: taskNumber,
+            title,
+            description,
+        }));
+        if (!response.ok) {
+            if (isHeldResponse(response.data)) {
+                writeOutput(runtime, formatTaskHeld('update', channel, response.data), response.data);
+                return;
+            }
+            throw responseError(response, 'update task details failed');
+        }
+        writeOutput(runtime, `Task #${taskNumber} details updated.`, response.data);
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runBigbangCli } from './program.js';
+try {
+    await runBigbangCli(process.argv);
+}
+catch {
+    process.exitCode = 1;
+}