@ravefox/space 0.2.1 → 0.4.0

package/src/commands/login.js

@@ -1,194 +0,0 @@
-/**
- * commonly login [--instance <url>] [--key <name>]
- *
- * Authenticates and stores the token in ~/.commonly/config.json.
- * Supports multiple named instances.
- */
-
-import { createInterface } from 'readline';
-import { hostname } from 'os';
-import { createClient, login as apiLogin } from '../lib/api.js';
-import { DEFAULT_URL, resolveInstance, saveInstance } from '../lib/config.js';
-import {
-  DeviceLoginCancelledError,
-  DeviceLoginDeniedError,
-  DeviceLoginExpiredError,
-  waitForDeviceAuthorization,
-} from '../lib/device-login.js';
-import { CLI } from '../lib/cli-hint.js';
-
-const prompt = (rl, question) => new Promise((resolve) => rl.question(question, resolve));
-
-const promptSecret = (question) => new Promise((resolve) => {
-  process.stdout.write(question);
-  const { stdin } = process;
-  stdin.setRawMode?.(true);
-  stdin.resume();
-  stdin.setEncoding('utf8');
-
-  let password = '';
-  const onData = (ch) => {
-    if (ch === '\n' || ch === '\r' || ch === '\u0003') {
-      stdin.setRawMode?.(false);
-      stdin.pause();
-      stdin.removeListener('data', onData);
-      process.stdout.write('\n');
-      resolve(password);
-    } else if (ch === '\u007f') {
-      password = password.slice(0, -1);
-    } else {
-      password += ch;
-    }
-  };
-  stdin.on('data', onData);
-});
-
-/**
- * Resolve the login target before making the request or writing config.
- *
- * `--instance` accepts either a URL or a saved profile key. The API client
- * resolves keys internally, but persisting the raw argument would write a key
- * (for example, "default") into the URL field and break every later command.
- */
-export const resolveLoginTarget = ({ instanceArg, keyArg }) => {
-  // A missing --instance means "the active profile", just like the other
-  // config helpers. Resolve it before choosing the key so a login without
-  // flags refreshes that profile instead of silently forking `default`.
-  const resolved = resolveInstance(instanceArg);
-  const isUrl = /^https?:\/\//i.test(instanceArg || '');
-  const instanceUrl = (resolved?.url || (isUrl ? instanceArg : DEFAULT_URL)).replace(/\/$/, '');
-  const isLocal = instanceUrl.includes('localhost') || instanceUrl.includes('127.0.0.1');
-  const isKey = instanceArg && !isUrl;
-  // A URL may resolve back to an existing named profile too. Prefer that key
-  // regardless of input shape, or a URL login can fork a second profile onto
-  // the same endpoint and leave the original token stale.
-  const configKey = keyArg || resolved?.key || (isKey ? instanceArg : (isLocal ? 'local' : 'default'));
-
-  return { instanceUrl, configKey };
-};
-
-export const registerLogin = (program) => {
-  program
-    .command('login')
-    .description('Authenticate to a Space instance')
-    .option('--instance <url-or-key>', 'Instance URL or saved profile key (default: active profile; production on first run)')
-    .option('--key <name>', 'Config key to save as (default: active profile key; otherwise derived from the instance)')
-    .option('--password', 'Use the legacy email/password prompt instead of device authorization')
-    .addHelpText('after', `
-Examples:
-  $ ${CLI} login                                                   # active profile (production on first run)
-  $ ${CLI} login --instance https://api.commonly.me --key dev  # named profile
-  $ ${CLI} login --instance http://localhost:5000                  # saved as "local"
-
-Tokens are stored in ~/.commonly/config.json. Other commands take
---instance <url-or-key> to target the right profile.
-`)
-    .action(async (opts) => {
-      const { instanceUrl, configKey } = resolveLoginTarget({
-        instanceArg: opts.instance,
-        keyArg: opts.key,
-      });
-
-      try {
-        if (!opts.password) {
-          const client = createClient({ instance: instanceUrl, token: null });
-          const started = await client.post('/api/auth/device/start', {
-            clientName: 'commonly-cli',
-            clientVersion: program.version(),
-            hostname: hostname(),
-          });
-          const minutes = Math.ceil(started.expiresIn / 60);
-          console.log(`Logging in to ${instanceUrl} as a new device.\n`);
-          console.log(`  Open   ${started.verifyUrl}`);
-          console.log(`  Code   ${started.userCode}`);
-          console.log(`\nWaiting for approval… (expires in ${minutes}:00)  press o to open the browser, q to cancel`);
-          const data = await waitForDeviceAuthorization({
-            client,
-            deviceCode: started.deviceCode,
-            userCode: started.userCode,
-            verifyUrl: started.verifyUrl,
-            interval: started.interval,
-            expiresIn: started.expiresIn,
-            onStatus: (message) => console.log(message),
-          });
-
-          saveInstance({
-            key: configKey,
-            url: instanceUrl,
-            token: data.token,
-            userId: data.userId,
-            username: data.username,
-            tokenType: 'device',
-          });
-          const devicesUrl = new URL('/settings/devices', started.verifyUrl).toString();
-          console.log(`\n✓ Authorized as @${data.username} on ${configKey} (${instanceUrl})`);
-          console.log(`  Token saved to ~/.commonly/config.json · manage devices at ${devicesUrl}`);
-          return;
-        }
-
-        console.log(`Logging in to ${instanceUrl}`);
-        const rl = createInterface({ input: process.stdin, output: process.stdout });
-        const email = await prompt(rl, 'Email: ');
-        rl.close();
-        const password = await promptSecret('Password: ');
-        const data = await apiLogin(instanceUrl, email.trim(), password);
-        const token = data.token;
-        const userId = data.user?._id || data.user?.id;
-        const username = data.user?.username;
-
-        saveInstance({ key: configKey, url: instanceUrl, token, userId, username, tokenType: 'jwt' });
-
-        console.log(`\nLogged in as ${username} (${configKey})`);
-        console.log(`Token saved to ~/.commonly/config.json`);
-      } catch (err) {
-        const message = err instanceof DeviceLoginExpiredError
-          ? `Code expired after 10 minutes. Run ${CLI} login --instance ${configKey} for a new code.`
-          : err instanceof DeviceLoginCancelledError || err instanceof DeviceLoginDeniedError
-            ? err.message
-            : `Login failed: ${err.message}`;
-        console.error(message);
-        process.exit(1);
-      }
-    });
-};
-
-export const registerWhoami = (program) => {
-  program
-    .command('whoami')
-    .description('Show current auth state')
-    .option('--instance <url>', 'Target instance')
-    .action(async () => {
-      const { listInstances } = await import('../lib/config.js');
-      const instances = listInstances();
-
-      if (instances.length === 0) {
-        console.log(`Not logged in. Run: ${CLI} login`);
-        return;
-      }
-
-      instances.forEach(({ key, url, username, active, token, tokenType }) => {
-        const marker = active ? '→' : ' ';
-        console.log(`${marker} ${key}  ${username || '?'}@${url}  (${formatTokenStatus(token, tokenType, Date.now(), key)})`);
-      });
-    });
-};
-
-const decodeJwtExpiry = (token) => {
-  if (typeof token !== 'string' || token.split('.').length !== 3) return null;
-  try {
-    const payload = JSON.parse(Buffer.from(token.split('.')[1], 'base64url').toString('utf8'));
-    return typeof payload.exp === 'number' ? payload.exp * 1000 : null;
-  } catch {
-    return null;
-  }
-};
-
-export const formatTokenStatus = (token, tokenType, now = Date.now(), instanceKey = 'default') => {
-  if (tokenType === 'device' || String(token || '').startsWith('cm_')) return 'device token · no expiry';
-  const expiresAt = decodeJwtExpiry(token);
-  if (!expiresAt) return 'session token · expiry unknown';
-  const diff = expiresAt - now;
-  if (diff <= 0) return `expired — ${CLI} login --instance ${instanceKey}`;
-  const hours = Math.max(1, Math.ceil(diff / (60 * 60 * 1000)));
-  return `expires in ${hours}h`;
-};

package/src/commands/mcp.js

@@ -1,56 +0,0 @@
-/**
- * commonly mcp config — print an MCP server config for a locally attached agent (TASK-666).
- * The MCP server only accepts a cm_agent_* runtime token, so the config points
- * COMMONLY_TOKEN_FILE at a 0600 copy of that token and never prints the token.
- */
-import { listLocalAgents, loadAgentToken } from './agent.js';
-import { validMcpTokenName, writeMcpTokenCopy } from '../lib/mcp-token.js';
-import { CLI } from '../lib/cli-hint.js';
-
-const NO_AGENT_HINT = `Attach one first: ${CLI} agent attach <adapter> --pod <podId> --name <name>`;
-
-export const buildMcpConfig = ({ agent } = {}) => {
-  let name = agent;
-  if (!name) {
-    const local = listLocalAgents();
-    if (local.length === 0) throw new Error(`No local agent has a runtime token on this computer. ${NO_AGENT_HINT}`);
-    if (local.length > 1) {
-      throw new Error(`More than one local agent (${local.map((a) => a.name).join(', ')}). Pick one with --agent <name>.`);
-    }
-    name = local[0].name;
-  }
-  if (!validMcpTokenName(name)) throw new Error(`Invalid agent name '${name}'`);
-  const record = loadAgentToken(name);
-  const token = String(record?.runtimeToken || '').trim();
-  if (!token) throw new Error(`No runtime token saved for agent '${name}'. ${NO_AGENT_HINT}`);
-  if (!token.startsWith('cm_agent_')) throw new Error(`The saved token for '${name}' is not a cm_agent_* runtime token. Re-attach it: ${CLI} agent attach`);
-  if (!record.instanceUrl) throw new Error(`Agent '${name}' has no saved instance URL. Re-attach it.`);
-
-  const tokenPath = writeMcpTokenCopy(name, token);
-
-  return {
-    mcpServers: {
-      commonly: {
-        command: 'npx',
-        args: ['-y', '@commonlyai/mcp@latest'],
-        env: { COMMONLY_API_URL: record.instanceUrl, COMMONLY_TOKEN_FILE: tokenPath },
-      },
-    },
-  };
-};
-
-export const registerMcp = (program) => {
-  const mcp = program.command('mcp').description('Connect an MCP client (Claude Code, Codex, Cursor) to Space');
-  mcp
-    .command('config')
-    .description('Print an MCP server config for a locally attached agent; the token stays in a 0600 file')
-    .option('--agent <name>', 'Local agent to use (default: the only one)')
-    .action((opts) => {
-      try {
-        console.log(JSON.stringify(buildMcpConfig({ agent: opts.agent }), null, 2));
-      } catch (error) {
-        console.error(error.message);
-        process.exitCode = 1;
-      }
-    });
-};

package/src/commands/pod.js

@@ -1,120 +0,0 @@
-/**
- * commonly pod <subcommand>
- *
- * list   — list pods you're a member of
- * send   — post a message to a pod
- * tail   — watch a pod's messages live
- */
-
-import { createClient } from '../lib/api.js';
-import { getToken, resolveInstanceUrl } from '../lib/config.js';
-import { createTailPoller } from '../lib/pod-tail.js';
-import { CLI } from '../lib/cli-hint.js';
-
-export const registerPod = (program) => {
-  const pod = program.command('pod').description('Manage pods');
-
-  pod.addHelpText('after', `
-Examples:
-  $ ${CLI} pod list
-  $ ${CLI} pod send <podId> "hello from the CLI"
-  $ ${CLI} pod tail <podId>
-
-Each command accepts --instance <url-or-key> to target a non-default
-Space instance (see: ${CLI} login --help).
-`);
-
-  // ── list ──────────────────────────────────────────────────────────────────
-  pod
-    .command('list')
-    .description('List pods you are a member of')
-    .option('--instance <url>', 'Target Space instance')
-    .action(async (opts) => {
-      const token = getToken(opts.instance);
-      if (!token) { console.error(`Not logged in. Run: ${CLI} login`); process.exit(1); }
-
-      const client = createClient({ instance: resolveInstanceUrl(opts.instance), token });
-
-      try {
-        const data = await client.get('/api/pods');
-        const pods = Array.isArray(data) ? data : data.pods || [];
-
-        if (pods.length === 0) { console.log('No pods found.'); return; }
-
-        const col = (s, w) => String(s ?? '').padEnd(w).slice(0, w);
-        console.log(`${col('NAME', 24)} ${col('TYPE', 12)} ${col('MEMBERS', 8)} ID`);
-        console.log('─'.repeat(70));
-        pods.forEach((p) => {
-          console.log(`${col(p.name, 24)} ${col(p.type || 'chat', 12)} ${col(p.memberCount ?? p.members?.length ?? '?', 8)} ${p._id}`);
-        });
-      } catch (err) {
-        console.error(`Failed: ${err.message}`);
-        process.exit(1);
-      }
-    });
-
-  // ── send ──────────────────────────────────────────────────────────────────
-  pod
-    .command('send <podId> <message>')
-    .description('Post a message to a pod')
-    .option('--payload <json>', 'UI card JSON envelope; the message remains the required text fallback')
-    .option('--instance <url>', 'Target Space instance')
-    .action(async (podId, message, opts) => {
-      const token = getToken(opts.instance);
-      if (!token) { console.error(`Not logged in. Run: ${CLI} login`); process.exit(1); }
-
-      const client = createClient({ instance: resolveInstanceUrl(opts.instance), token });
-
-      try {
-        const body = { content: message };
-        if (opts.payload !== undefined) {
-          body.payload = JSON.parse(opts.payload);
-          body.messageType = 'card';
-        }
-        // UI cards use the validated agent endpoint only. A validation or
-        // authorization refusal must never retry through the human writer.
-        const result = await client.post(`/api/agents/runtime/pods/${podId}/messages`, body)
-          .catch((error) => {
-            if (opts.payload !== undefined) throw error;
-            return client.post(`/api/messages/${podId}`, body);
-          });
-
-        console.log(`Sent (${result._id || result.id || 'ok'})`);
-      } catch (err) {
-        console.error(`Failed: ${err.message}`);
-        process.exit(1);
-      }
-    });
-
-  // ── tail ──────────────────────────────────────────────────────────────────
-  pod
-    .command('tail <podId>')
-    .description('Watch pod messages live')
-    .option('--filter <type>', 'Filter by sender type: agents, humans, all', 'all')
-    .option('--instance <url>', 'Target Space instance')
-    .action(async (podId, opts) => {
-      const token = getToken(opts.instance);
-      if (!token) { console.error(`Not logged in. Run: ${CLI} login`); process.exit(1); }
-
-      const client = createClient({ instance: resolveInstanceUrl(opts.instance), token });
-
-      console.log(`Watching pod ${podId}... (Ctrl+C to stop)\n`);
-
-      const pollNew = createTailPoller({
-        fetchPage: (limit) => client.get(`/api/messages/${podId}`, { limit }),
-        filter: opts.filter,
-        print: (line) => console.log(line),
-      });
-      const poll = async () => {
-        try {
-          await pollNew();
-        } catch (err) {
-          console.error(`[poll error] ${err.message}`);
-        }
-      };
-
-      await poll();
-      const interval = setInterval(poll, 3000);
-      process.on('SIGINT', () => { clearInterval(interval); process.exit(0); });
-    });
-};

package/src/commands/task.js

@@ -1,279 +0,0 @@
-/**
- * commonly task <subcommand>
- *
- * list   — the pod's board, optionally narrowed by status, or to rows this identity holds
- * create — a new row; --notes is a second request, because create does not take notes
- * claim  — take the lease on a row
- * update — change a row's fields, and/or append a history note
- * close  — mark a row done, as its creator or its holder
- *
- * Identity and base URL come from ../lib/task.js. Every subcommand goes through
- * connect() below, so none can grow its own fallback to the saved login. Flags are
- * checked before the first request, so a refusal costs no network round trip.
- */
-
-import { TOKEN_FILE_ENV } from '../lib/inbox.js';
-import {
-  TASK_PRIORITIES,
-  TASK_STATUSES,
-  TASK_TOKEN_ENV,
-  TaskRefusal,
-  UPDATE_STATUSES,
-  checkPriority,
-  checkStatusFilter,
-  checkTaskId,
-  checkUpdateStatus,
-  createTaskClient,
-  describeFailure,
-  formatTaskLine,
-  requireText,
-  resolveTaskBaseUrl,
-  resolveTaskToken,
-  taskPath,
-} from '../lib/task.js';
-import { CLI } from '../lib/cli-hint.js';
-
-export const TASK_TOKEN_HELP = `Agent token file (or ${TOKEN_FILE_ENV}, or ${TASK_TOKEN_ENV})`;
-
-const connect = (opts, env, fetchImpl) => createTaskClient({
-  baseUrl: resolveTaskBaseUrl(opts, env),
-  token: resolveTaskToken(opts, env),
-  fetchImpl,
-});
-
-const podOf = (opts) => requireText(opts.pod, '--pod');
-
-const report = (err, error) => {
-  error(err instanceof TaskRefusal ? `refusing: ${err.message}` : describeFailure(err));
-  return 1;
-};
-
-// A row goes out as JSON for agents, and as the line a person scans otherwise.
-const emitRow = (opts, log, task) => {
-  log(opts.json ? JSON.stringify(task, null, 2) : formatTaskLine(task));
-};
-
-export const runTaskList = async (opts = {}, deps = {}) => {
-  const {
-    env = process.env, fetchImpl = fetch, log = console.log, error = console.error,
-  } = deps;
-  try {
-    const pod = podOf(opts);
-    const status = opts.status === undefined ? undefined : checkStatusFilter(opts.status);
-    const { tasks } = await connect(opts, env, fetchImpl).get(taskPath(pod), { status });
-    // The server marks each row claimedByMe for this identity, so --mine needs no second request.
-    const rows = opts.mine ? tasks.filter((task) => task.claimedByMe) : tasks;
-    if (opts.json) {
-      log(JSON.stringify(rows, null, 2));
-    } else if (rows.length === 0) {
-      log('(no tasks match)');
-    } else {
-      for (const task of rows) log(formatTaskLine(task));
-    }
-    return 0;
-  } catch (err) {
-    return report(err, error);
-  }
-};
-
-export const runTaskCreate = async (opts = {}, deps = {}) => {
-  const {
-    env = process.env, fetchImpl = fetch, log = console.log, error = console.error,
-  } = deps;
-  try {
-    const pod = podOf(opts);
-    const body = { title: requireText(opts.title, '--title') };
-    if (opts.priority !== undefined) body.priority = checkPriority(opts.priority);
-    if (opts.assignee !== undefined) body.assignee = requireText(opts.assignee, '--assignee');
-    if (opts.dep !== undefined) body.dep = checkTaskId(opts.dep);
-    const notes = opts.notes === undefined ? undefined : requireText(opts.notes, '--notes');
-    const client = connect(opts, env, fetchImpl);
-    const { task } = await client.post(taskPath(pod), body);
-    if (notes === undefined) {
-      emitRow(opts, log, task);
-      return 0;
-    }
-    // The row exists once the create returns. If the notes fail, say so, so nobody
-    // retries the create and makes a twin.
-    try {
-      const { task: noted } = await client.patch(taskPath(pod, task.taskId), { notes });
-      emitRow(opts, log, noted);
-      return 0;
-    } catch (err) {
-      error(`Created ${task.taskId}, but --notes did not save. ${describeFailure(err)}`);
-      return 1;
-    }
-  } catch (err) {
-    return report(err, error);
-  }
-};
-
-export const runTaskClaim = async (taskArg, opts = {}, deps = {}) => {
-  const {
-    env = process.env, fetchImpl = fetch, log = console.log, error = console.error,
-  } = deps;
-  try {
-    const pod = podOf(opts);
-    const taskId = checkTaskId(taskArg);
-    const body = opts.continueAnyway ? { continueAnyway: true } : {};
-    const { task } = await connect(opts, env, fetchImpl).post(`${taskPath(pod, taskId)}/claim`, body);
-    emitRow(opts, log, task);
-    return 0;
-  } catch (err) {
-    return report(err, error);
-  }
-};
-
-export const runTaskUpdate = async (taskArg, opts = {}, deps = {}) => {
-  const {
-    env = process.env, fetchImpl = fetch, log = console.log, error = console.error,
-  } = deps;
-  try {
-    const pod = podOf(opts);
-    const taskId = checkTaskId(taskArg);
-    const fields = {};
-    if (opts.status !== undefined) fields.status = checkUpdateStatus(opts.status);
-    // An empty value unassigns. The server stores that as null, not as '', so the row
-    // reads as unassigned to the router.
-    if (opts.assignee !== undefined) fields.assignee = String(opts.assignee).trim();
-    if (opts.title !== undefined) fields.title = requireText(opts.title, '--title');
-    if (opts.priority !== undefined) fields.priority = checkPriority(opts.priority);
-    // "none" clears the dependency. Sending '' would store a dependency that names nothing.
-    if (opts.dep !== undefined) fields.dep = opts.dep === 'none' ? null : checkTaskId(opts.dep);
-    const note = opts.note === undefined ? undefined : requireText(opts.note, '--note');
-    if (Object.keys(fields).length === 0 && note === undefined) {
-      throw new TaskRefusal('nothing to change. Pass --status, --assignee, --title, --priority, --dep or --note.');
-    }
-    const client = connect(opts, env, fetchImpl);
-    const path = taskPath(pod, taskId);
-    let task = null;
-    if (Object.keys(fields).length > 0) ({ task } = await client.patch(path, fields));
-    if (note !== undefined) {
-      try {
-        const body = opts.continueAnyway ? { text: note, continueAnyway: true } : { text: note };
-        ({ task } = await client.post(`${path}/updates`, body));
-      } catch (err) {
-        // With no field change before it, a failed note is the whole failure.
-        if (task === null) throw err;
-        error(`Updated ${taskId}, but --note did not post. ${describeFailure(err)}`);
-        return 1;
-      }
-    }
-    emitRow(opts, log, task);
-    return 0;
-  } catch (err) {
-    return report(err, error);
-  }
-};
-
-export const runTaskClose = async (taskArg, opts = {}, deps = {}) => {
-  const {
-    env = process.env, fetchImpl = fetch, log = console.log, error = console.error,
-  } = deps;
-  try {
-    const pod = podOf(opts);
-    const taskId = checkTaskId(taskArg);
-    const prUrl = opts.pr === undefined ? undefined : requireText(opts.pr, '--pr');
-    // No notes key here. /complete replaces the row's notes whenever one is sent.
-    const body = prUrl === undefined ? {} : { prUrl };
-    const { task } = await connect(opts, env, fetchImpl).post(`${taskPath(pod, taskId)}/complete`, body);
-    emitRow(opts, log, task);
-    return 0;
-  } catch (err) {
-    return report(err, error);
-  }
-};
-
-export const registerTask = (program) => {
-  const task = program
-    .command('task')
-    .description('Read and write the task board as an agent (list, create, claim, update, close)');
-
-  task.addHelpText('after', `
-The board is read and written as the identity in a token file, and nowhere else:
-
-  $ ${CLI} task list --pod <podId> --token-file <path>
-  $ COMMONLY_AGENT_TOKEN=<token> ${CLI} task claim TASK-123 --pod <podId>
-
-The identity is --token-file, then COMMONLY_TOKEN_FILE, then COMMONLY_AGENT_TOKEN.
-The saved login and COMMONLY_TOKEN are never read: a write made under an
-operator's login lands on the row under that operator's name.
-
-Each verb does what it says. \`claim\` takes the lease. \`close\` stamps the
-completion time and the PR. \`update --status\` sets only pending or blocked, so it
-cannot claim or close a row. \`update --note\` appends a history line. The row's
-notes are set by \`create --notes\` and are not editable here.
-
-A claim or a note can refuse with unseen messages in the pod. Read them and retry,
-or pass --continue-anyway to go ahead without reading them.
-
-Examples:
-  $ ${CLI} task list --pod <podId> --status pending,claimed
-  $ ${CLI} task list --pod <podId> --mine --json
-  $ ${CLI} task create --pod <podId> --title "Fix the board" --priority P1 --notes "Repro in staging"
-  $ ${CLI} task claim TASK-123 --pod <podId>
-  $ ${CLI} task update TASK-123 --pod <podId> --note "PR is up"
-  $ ${CLI} task close TASK-123 --pod <podId> --pr https://github.com/Team-Space/commonly/pull/<n>
-`);
-
-  task
-    .command('list')
-    .description("List a pod's task board")
-    .requiredOption('--pod <podId>', 'Pod whose board to read')
-    .option('--status <list>', `Only these statuses, comma-separated (${TASK_STATUSES.join('|')})`)
-    .option('--mine', 'Only rows this identity holds a claim on')
-    .option('--token-file <path>', TASK_TOKEN_HELP)
-    .option('--instance <url>', 'Target Space instance')
-    .option('--json', 'Emit the rows as JSON')
-    .action(async (opts) => { process.exit(await runTaskList(opts)); });
-
-  task
-    .command('create')
-    .description('Create a row, then set its --notes (create does not take notes)')
-    .requiredOption('--pod <podId>', 'Pod to create the row in')
-    .requiredOption('--title <text>', 'Row title')
-    .option('--notes <text>', 'Notes to set once the row exists')
-    .option('--priority <P>', `${TASK_PRIORITIES.join('|')} (default P2)`)
-    .option('--assignee <name>', 'Assign the row at creation')
-    .option('--dep <TASK-n>', 'Row this one waits on')
-    .option('--token-file <path>', TASK_TOKEN_HELP)
-    .option('--instance <url>', 'Target Space instance')
-    .option('--json', 'Emit the row as JSON')
-    .action(async (opts) => { process.exit(await runTaskCreate(opts)); });
-
-  task
-    .command('claim <taskId>')
-    .description('Take the lease on a row (TASK-n)')
-    .requiredOption('--pod <podId>', 'Pod the row is in')
-    .option('--continue-anyway', 'Claim even with unseen messages in the pod')
-    .option('--token-file <path>', TASK_TOKEN_HELP)
-    .option('--instance <url>', 'Target Space instance')
-    .option('--json', 'Emit the row as JSON')
-    .action(async (taskId, opts) => { process.exit(await runTaskClaim(taskId, opts)); });
-
-  task
-    .command('update <taskId>')
-    .description("Change a row's fields, and/or append a history note")
-    .requiredOption('--pod <podId>', 'Pod the row is in')
-    .option('--status <status>', `${UPDATE_STATUSES.join('|')} (claim and close have their own commands)`)
-    .option('--assignee <name>', 'Reassign the row; an empty value unassigns it')
-    .option('--title <text>', 'New title')
-    .option('--priority <P>', TASK_PRIORITIES.join('|'))
-    .option('--dep <TASK-n>', 'Row this one waits on; "none" clears it')
-    .option('--note <text>', 'Append a history note')
-    .option('--continue-anyway', 'Post the note even with unseen messages in the pod')
-    .option('--token-file <path>', TASK_TOKEN_HELP)
-    .option('--instance <url>', 'Target Space instance')
-    .option('--json', 'Emit the row as JSON')
-    .action(async (taskId, opts) => { process.exit(await runTaskUpdate(taskId, opts)); });
-
-  task
-    .command('close <taskId>')
-    .description('Mark a row done, as its creator or its holder')
-    .requiredOption('--pod <podId>', 'Pod the row is in')
-    .option('--pr <url>', 'Pull request that delivered the row')
-    .option('--token-file <path>', TASK_TOKEN_HELP)
-    .option('--instance <url>', 'Target Space instance')
-    .option('--json', 'Emit the row as JSON')
-    .action(async (taskId, opts) => { process.exit(await runTaskClose(taskId, opts)); });
-};