@doist/comms-cli 0.0.1 → 1.1.0

package/dist/commands/groups/create.js

@@ -0,0 +1,27 @@
+import { createGroup, getCurrentWorkspaceId } from '../../lib/api.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveUserRefs, resolveWorkspaceRef } from '../../lib/refs.js';
+import { validateNonEmptyName } from '../../lib/validation.js';
+export async function createGroupCommand(name, options) {
+    validateNonEmptyName(name, 'Group');
+    const workspaceId = options.workspace
+        ? (await resolveWorkspaceRef(options.workspace)).id
+        : await getCurrentWorkspaceId();
+    const userIds = options.users ? await resolveUserRefs(options.users, workspaceId) : undefined;
+    if (options.dryRun) {
+        printDryRun('create group', {
+            Workspace: String(workspaceId),
+            Name: name,
+            Users: userIds && userIds.length > 0 ? userIds.join(', ') : undefined,
+        });
+        return;
+    }
+    const group = await createGroup({ workspaceId, name, userIds });
+    if (options.json) {
+        console.log(formatJson(group, 'group', options.full));
+        return;
+    }
+    const memberSuffix = userIds && userIds.length > 0 ? ` with ${userIds.length} member(s)` : '';
+    console.log(`Group "${group.name}" (id:${group.id}) created${memberSuffix}.`);
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/groups/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/groups/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAO9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,OAA2B;IAC9E,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS;QACjC,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QACnD,CAAC,CAAC,MAAM,qBAAqB,EAAE,CAAA;IAEnC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE7F,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,cAAc,EAAE;YACxB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;YAC9B,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAE/D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACrD,OAAM;IACV,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7F,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,YAAY,YAAY,GAAG,CAAC,CAAA;AACjF,CAAC"}

package/dist/commands/groups/delete.d.ts

@@ -0,0 +1,7 @@
+import type { MutationOptions } from '../../lib/options.js';
+type DeleteGroupOptions = MutationOptions & {
+    yes?: boolean;
+};
+export declare function deleteGroupCommand(ref: string, options: DeleteGroupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/groups/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAI3D,KAAK,kBAAkB,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAE7D,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChG"}

package/dist/commands/groups/delete.js

@@ -0,0 +1,30 @@
+import { deleteGroup, getCurrentWorkspaceId } from '../../lib/api.js';
+import { CliError } from '../../lib/errors.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveGroupRef } from '../../lib/refs.js';
+export async function deleteGroupCommand(ref, options) {
+    const workspaceId = await getCurrentWorkspaceId();
+    const group = await resolveGroupRef(ref, workspaceId);
+    if (options.dryRun) {
+        printDryRun('delete group', {
+            Group: `${group.name} (id:${group.id})`,
+            Members: `${group.userIds.length}`,
+        });
+        return;
+    }
+    if (!options.yes) {
+        if (options.json) {
+            throw new CliError('MISSING_YES_FLAG', '--yes is required to execute deletion in --json mode.');
+        }
+        console.log(`Would delete: ${group.name} (id:${group.id}, ${group.userIds.length} members)`);
+        console.log('Use --yes to confirm.');
+        return;
+    }
+    await deleteGroup(group.id, workspaceId);
+    if (options.json) {
+        console.log(formatJson({ id: group.id, deleted: true }));
+        return;
+    }
+    console.log(`Group "${group.name}" (id:${group.id}) deleted.`);
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/groups/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/groups/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAInD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,OAA2B;IAC7E,MAAM,WAAW,GAAG,MAAM,qBAAqB,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAErD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,cAAc,EAAE;YACxB,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,GAAG;YACvC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;SACrC,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CACd,kBAAkB,EAClB,uDAAuD,CAC1D,CAAA;QACL,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,WAAW,CAAC,CAAA;QAC5F,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;QACpC,OAAM;IACV,CAAC;IAED,MAAM,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;IAExC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACxD,OAAM;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,YAAY,CAAC,CAAA;AAClE,CAAC"}

package/dist/commands/groups/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerGroupsCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/groups/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsH5D"}

package/dist/commands/groups/index.js

@@ -0,0 +1,98 @@
+import { createGroupCommand } from './create.js';
+import { deleteGroupCommand } from './delete.js';
+import { listGroups } from './list.js';
+import { addUsersCommand, removeUsersCommand } from './members.js';
+import { renameGroup } from './rename.js';
+import { viewGroup } from './view.js';
+export function registerGroupsCommand(program) {
+    const groups = program.command('groups').description('Group operations');
+    groups
+        .command('list [workspace-ref]', { isDefault: true })
+        .description('List groups in a workspace')
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--search <text>', 'Filter by name')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups
+  tdc groups list --search front
+  tdc groups --workspace 123 --json`)
+        .action(listGroups);
+    groups
+        .command('view <group-ref>')
+        .description('Show a group with its members')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups view 12345
+  tdc groups view "Frontend"
+  tdc groups view id:12345 --json`)
+        .action(viewGroup);
+    groups
+        .command('create <name>')
+        .description('Create a new group')
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--users <refs>', 'Comma-separated user references to add (id:N, email, or name)')
+        .option('--dry-run', 'Show what would be created without creating')
+        .option('--json', 'Output created group as JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups create "Frontend"
+  tdc groups create "Backend" --users alice@doist.com,bob@doist.com
+  tdc groups create "Design" --users id:123,id:456 --json`)
+        .action(createGroupCommand);
+    groups
+        .command('rename <group-ref> <new-name>')
+        .description('Rename a group')
+        .option('--dry-run', 'Show what would be renamed without renaming')
+        .option('--json', 'Output updated group as JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups rename 12345 "Frontend Team"
+  tdc groups rename "Frontend" "Frontend Team" --json`)
+        .action(renameGroup);
+    groups
+        .command('delete <group-ref>')
+        .description('Permanently delete a group')
+        .option('--yes', 'Confirm deletion')
+        .option('--dry-run', 'Show what would happen without executing')
+        .option('--json', 'Output result as JSON')
+        .addHelpText('after', `
+Examples:
+  tdc groups delete 12345 --yes
+  tdc groups delete "Frontend" --dry-run`)
+        .action(deleteGroupCommand);
+    groups
+        .command('add-user <group-ref> [user-refs...]')
+        .description('Add one or more users to a group')
+        .option('--dry-run', 'Show what would change without changing')
+        .option('--json', 'Output result as JSON')
+        .option('--full', 'Include the full updated group in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups add-user 12345 alice@doist.com bob@doist.com
+  tdc groups add-user "Frontend" id:123,id:456
+  tdc groups add-user 12345 alice bob carol --json
+
+User references can be passed as space-separated args, comma-separated within a
+single arg, or any mix of the two.`)
+        .action(addUsersCommand);
+    groups
+        .command('remove-user <group-ref> [user-refs...]')
+        .description('Remove one or more users from a group')
+        .option('--dry-run', 'Show what would change without changing')
+        .option('--json', 'Output result as JSON')
+        .option('--full', 'Include the full updated group in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc groups remove-user 12345 alice@doist.com
+  tdc groups remove-user "Frontend" id:123,id:456`)
+        .action(removeUsersCommand);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/groups/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/groups/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/groups/list.d.ts

@@ -0,0 +1,7 @@
+import type { ViewOptions } from '../../lib/options.js';
+export type ListGroupsOptions = ViewOptions & {
+    workspace?: string;
+    search?: string;
+};
+export declare function listGroups(workspaceRef: string | undefined, options: ListGroupsOptions): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/groups/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErF,wBAAsB,UAAU,CAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/commands/groups/list.js

@@ -0,0 +1,42 @@
+import { getCurrentWorkspaceId, getWorkspaceGroups } from '../../lib/api.js';
+import { CliError } from '../../lib/errors.js';
+import { colors, formatJson, formatNdjson, pluralize, printEmpty } from '../../lib/output.js';
+import { resolveWorkspaceRef } from '../../lib/refs.js';
+export async function listGroups(workspaceRef, options) {
+    if (workspaceRef && options.workspace) {
+        throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+    }
+    let workspaceId;
+    const ref = workspaceRef || options.workspace;
+    if (ref) {
+        const workspace = await resolveWorkspaceRef(ref);
+        workspaceId = workspace.id;
+    }
+    else {
+        workspaceId = await getCurrentWorkspaceId();
+    }
+    let groups = await getWorkspaceGroups(workspaceId);
+    if (options.search) {
+        const query = options.search.toLowerCase();
+        groups = groups.filter((g) => g.name.toLowerCase().includes(query));
+    }
+    if (groups.length === 0) {
+        printEmpty({ options, type: 'group', message: 'No groups found.' });
+        return;
+    }
+    if (options.json) {
+        console.log(formatJson(groups, 'group', options.full));
+        return;
+    }
+    if (options.ndjson) {
+        console.log(formatNdjson(groups, 'group', options.full));
+        return;
+    }
+    for (const g of groups) {
+        const id = colors.timestamp(`id:${g.id}`);
+        const name = colors.channel(g.name);
+        const members = colors.timestamp(`(${g.userIds.length} ${pluralize(g.userIds.length, 'member')})`);
+        console.log(`${id}  ${name}  ${members}`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/groups/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/groups/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAIvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC5B,YAAgC,EAChC,OAA0B;IAE1B,IAAI,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,QAAQ,CACd,qBAAqB,EACrB,gEAAgE,CACnE,CAAA;IACL,CAAC;IAED,IAAI,WAAmB,CAAA;IACvB,MAAM,GAAG,GAAG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAA;IAE7C,IAAI,GAAG,EAAE,CAAC;QACN,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAA;QAChD,WAAW,GAAG,SAAS,CAAC,EAAE,CAAA;IAC9B,CAAC;SAAM,CAAC;QACJ,WAAW,GAAG,MAAM,qBAAqB,EAAE,CAAA;IAC/C,CAAC;IAED,IAAI,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAElD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAA;QACnE,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACtD,OAAM;IACV,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;QACxD,OAAM;IACV,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAC5B,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CACnE,CAAA;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;IAC7C,CAAC;AACL,CAAC"}

package/dist/commands/groups/members.d.ts

@@ -0,0 +1,4 @@
+import type { MutationOptions } from '../../lib/options.js';
+export declare function addUsersCommand(groupRef: string, userRefs: string[], options: MutationOptions): Promise<void>;
+export declare function removeUsersCommand(groupRef: string, userRefs: string[], options: MutationOptions): Promise<void>;
+//# sourceMappingURL=members.d.ts.map

package/dist/commands/groups/members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/members.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AA0G3D,wBAAsB,eAAe,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/commands/groups/members.js

@@ -0,0 +1,90 @@
+import { addUsersToGroup, getCurrentWorkspaceId, getGroup, removeUsersFromGroup, } from '../../lib/api.js';
+import { CliError } from '../../lib/errors.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveGroupRef, resolveUserRefs } from '../../lib/refs.js';
+function joinUserRefs(userRefs) {
+    if (userRefs.length === 0) {
+        throw new CliError('MISSING_USERS', 'Provide at least one user reference (id:N, email, or name).');
+    }
+    return userRefs.join(',');
+}
+function dedupe(ids) {
+    return [...new Set(ids)];
+}
+async function mutateGroupMembership(groupRef, userRefs, action, options) {
+    const workspaceId = await getCurrentWorkspaceId();
+    const [group, resolvedIds] = await Promise.all([
+        resolveGroupRef(groupRef, workspaceId),
+        resolveUserRefs(joinUserRefs(userRefs), workspaceId),
+    ]);
+    const userIds = dedupe(resolvedIds);
+    const currentMembers = new Set(group.userIds);
+    const actionableIds = action === 'add'
+        ? userIds.filter((id) => !currentMembers.has(id))
+        : userIds.filter((id) => currentMembers.has(id));
+    const skippedIds = action === 'add'
+        ? userIds.filter((id) => currentMembers.has(id))
+        : userIds.filter((id) => !currentMembers.has(id));
+    const actionLabel = action === 'add' ? 'add users to' : 'remove users from';
+    const skippedLabel = action === 'add' ? 'Already members' : 'Not members';
+    if (options.dryRun) {
+        printDryRun(`${actionLabel} group`, {
+            Group: `${group.name} (id:${group.id})`,
+            [`Users to ${action}`]: actionableIds.length > 0 ? actionableIds.join(', ') : '(none)',
+            [skippedLabel]: skippedIds.length > 0 ? skippedIds.join(', ') : undefined,
+        });
+        return;
+    }
+    if (actionableIds.length > 0) {
+        if (action === 'add') {
+            await addUsersToGroup(group.id, workspaceId, actionableIds);
+        }
+        else {
+            await removeUsersFromGroup(group.id, workspaceId, actionableIds);
+        }
+    }
+    // Compute the new member count locally instead of refetching
+    const newMemberCount = action === 'add'
+        ? group.userIds.length + actionableIds.length
+        : group.userIds.length - actionableIds.length;
+    if (options.json) {
+        if (options.full) {
+            // For --full we need the actual updated group from the API
+            const updated = await getGroup(group.id, workspaceId);
+            console.log(formatJson(updated, 'group', true));
+        }
+        else {
+            const result = { id: group.id, memberCount: newMemberCount };
+            if (action === 'add') {
+                result.added = actionableIds;
+                result.alreadyMembers = skippedIds;
+            }
+            else {
+                result.removed = actionableIds;
+                result.notMembers = skippedIds;
+            }
+            console.log(formatJson(result));
+        }
+        return;
+    }
+    const pastVerb = action === 'add' ? 'Added' : 'Removed';
+    const noneMsg = action === 'add'
+        ? `No new members added to "${group.name}" (already in group).`
+        : `No members removed from "${group.name}" (none of the users were in group).`;
+    if (actionableIds.length === 0) {
+        console.log(noneMsg);
+    }
+    else {
+        console.log(`${pastVerb} ${actionableIds.length} user(s) ${action === 'add' ? 'to' : 'from'} "${group.name}" (now ${newMemberCount} members).`);
+    }
+    if (skippedIds.length > 0) {
+        console.log(`${skippedLabel}: ${skippedIds.join(', ')}`);
+    }
+}
+export async function addUsersCommand(groupRef, userRefs, options) {
+    return mutateGroupMembership(groupRef, userRefs, 'add', options);
+}
+export async function removeUsersCommand(groupRef, userRefs, options) {
+    return mutateGroupMembership(groupRef, userRefs, 'remove', options);
+}
+//# sourceMappingURL=members.js.map

package/dist/commands/groups/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/commands/groups/members.ts"],"names":[],"mappings":"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"}

package/dist/commands/groups/rename.d.ts

@@ -0,0 +1,3 @@
+import type { MutationOptions } from '../../lib/options.js';
+export declare function renameGroup(ref: string, newName: string, options: MutationOptions): Promise<void>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/commands/groups/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/rename.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAK3D,wBAAsB,WAAW,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/commands/groups/rename.js

@@ -0,0 +1,28 @@
+import { getCurrentWorkspaceId, updateGroup } from '../../lib/api.js';
+import { formatJson, printDryRun } from '../../lib/output.js';
+import { resolveGroupRef } from '../../lib/refs.js';
+import { validateNonEmptyName } from '../../lib/validation.js';
+export async function renameGroup(ref, newName, options) {
+    validateNonEmptyName(newName, 'Group');
+    const workspaceId = await getCurrentWorkspaceId();
+    const group = await resolveGroupRef(ref, workspaceId);
+    if (options.dryRun) {
+        printDryRun('rename group', {
+            Group: `${group.name} (id:${group.id})`,
+            'New name': newName,
+        });
+        return;
+    }
+    const updated = await updateGroup({ id: group.id, workspaceId, name: newName });
+    if (options.json) {
+        if (options.full) {
+            console.log(formatJson(updated, 'group', true));
+        }
+        else {
+            console.log(formatJson({ id: updated.id, name: updated.name }));
+        }
+        return;
+    }
+    console.log(`Group ${group.id} renamed to "${updated.name}".`);
+}
+//# sourceMappingURL=rename.js.map

package/dist/commands/groups/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/commands/groups/rename.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAE9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,GAAW,EACX,OAAe,EACf,OAAwB;IAExB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAEtC,MAAM,WAAW,GAAG,MAAM,qBAAqB,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAErD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,cAAc,EAAE;YACxB,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,GAAG;YACvC,UAAU,EAAE,OAAO;SACtB,CAAC,CAAA;QACF,OAAM;IACV,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;IAE/E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;QACnD,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACnE,CAAC;QACD,OAAM;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,gBAAgB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAA;AAClE,CAAC"}

package/dist/commands/groups/view.d.ts

@@ -0,0 +1,7 @@
+import type { ViewOptions } from '../../lib/options.js';
+type GroupViewOptions = ViewOptions & {
+    full?: boolean;
+};
+export declare function viewGroup(ref: string, options: GroupViewOptions): Promise<void>;
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/commands/groups/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/commands/groups/view.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIvD,KAAK,gBAAgB,GAAG,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAExD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrF"}

package/dist/commands/groups/view.js

@@ -0,0 +1,52 @@
+import { getCommsClient, getCurrentWorkspaceId } from '../../lib/api.js';
+import { colors, formatJson, formatNdjson, pluralize } from '../../lib/output.js';
+import { resolveGroupRef } from '../../lib/refs.js';
+export async function viewGroup(ref, options) {
+    const workspaceId = await getCurrentWorkspaceId();
+    const group = await resolveGroupRef(ref, workspaceId);
+    const client = await getCommsClient();
+    // Per-member fetch avoids loading the whole workspace directory for a small group.
+    const members = await Promise.all(group.userIds.map(async (id) => {
+        try {
+            const user = await client.workspaceUsers.getUserById({
+                workspaceId,
+                userId: id,
+            });
+            return { id, name: user.fullName, email: user.email ?? null };
+        }
+        catch {
+            return { id, name: null, email: null };
+        }
+    }));
+    if (options.json) {
+        if (options.full) {
+            console.log(formatJson({ ...group, members }));
+        }
+        else {
+            console.log(formatJson({
+                id: group.id,
+                name: group.name,
+                workspaceId: group.workspaceId,
+                members,
+            }));
+        }
+        return;
+    }
+    if (options.ndjson) {
+        console.log(formatNdjson([{ ...group, members }]));
+        return;
+    }
+    console.log(colors.channel(group.name));
+    console.log(colors.timestamp(`id:${group.id}`));
+    console.log('');
+    console.log(`${members.length} ${pluralize(members.length, 'member')}`);
+    if (members.length === 0)
+        return;
+    for (const m of members) {
+        const name = m.name ?? `user:${m.id}`;
+        const email = m.email ? colors.timestamp(`<${m.email}>`) : '';
+        const id = colors.timestamp(`id:${m.id}`);
+        console.log(`  ${id}  ${colors.author(name)} ${email}`.trimEnd());
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/groups/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/commands/groups/view.ts"],"names":[],"mappings":"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"}

package/dist/commands/inbox.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerInboxCommand(program: Command): void;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/commands/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../src/commands/inbox.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AA6J3C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkC3D"}

package/dist/commands/inbox.js

@@ -0,0 +1,147 @@
+import chalk from 'chalk';
+import { Option } from 'commander';
+import { getCommsClient, getCurrentWorkspaceId } from '../lib/api.js';
+import { withCaseInsensitiveChoices } from '../lib/completion.js';
+import { formatRelativeDate } from '../lib/dates.js';
+import { CliError } from '../lib/errors.js';
+import { includePrivateChannels, isAccessible } from '../lib/global-args.js';
+import { colors, formatJson, formatNdjson, printEmpty } from '../lib/output.js';
+import { getPublicChannelIds } from '../lib/public-channels.js';
+import { resolveWorkspaceRef } from '../lib/refs.js';
+import { fetchUnreadThreadIds } from '../lib/threads.js';
+async function showInbox(workspaceRef, options) {
+    if (workspaceRef && options.workspace) {
+        throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+    }
+    let workspaceId;
+    const ref = workspaceRef || options.workspace;
+    if (ref) {
+        const workspace = await resolveWorkspaceRef(ref);
+        workspaceId = workspace.id;
+    }
+    else {
+        workspaceId = await getCurrentWorkspaceId();
+    }
+    const client = await getCommsClient();
+    const limit = options.limit ? parseInt(options.limit, 10) : 50;
+    const [threads, unreadThreadIds] = await Promise.all([
+        client.inbox.getInbox({
+            workspaceId,
+            newerThan: options.since ? new Date(options.since) : undefined,
+            olderThan: options.until ? new Date(options.until) : undefined,
+            limit,
+            archiveFilter: options.archiveFilter ?? 'active',
+        }),
+        fetchUnreadThreadIds(client, workspaceId),
+    ]);
+    let inboxThreads = threads.map((t) => ({
+        ...t,
+        isUnread: unreadThreadIds.has(t.id),
+    }));
+    if (options.unread) {
+        inboxThreads = inboxThreads.filter((t) => t.isUnread);
+    }
+    if (inboxThreads.length === 0) {
+        printEmpty({ options, type: 'thread', message: 'No threads in inbox.' });
+        return;
+    }
+    const channelIds = [...new Set(inboxThreads.map((t) => t.channelId))];
+    const channelEntries = await Promise.all(channelIds.map(async (id) => [id, await client.channels.getChannel(id)]));
+    const channelMap = new Map(channelEntries.map(([id, ch]) => [id, ch.name]));
+    if (!includePrivateChannels()) {
+        const publicIds = await getPublicChannelIds(workspaceId);
+        inboxThreads = inboxThreads.filter((t) => publicIds.has(t.channelId));
+        if (inboxThreads.length === 0) {
+            printEmpty({ options, type: 'thread', message: 'No threads in public channels.' });
+            return;
+        }
+    }
+    if (options.channel) {
+        const filter = options.channel.toLowerCase();
+        const matchingChannelIds = new Set([...channelMap.entries()]
+            .filter(([, name]) => name.toLowerCase().includes(filter))
+            .map(([id]) => id));
+        inboxThreads = inboxThreads.filter((t) => matchingChannelIds.has(t.channelId));
+        if (inboxThreads.length === 0) {
+            printEmpty({
+                options,
+                type: 'thread',
+                message: `No threads in channels matching "${options.channel}".`,
+            });
+            return;
+        }
+    }
+    // Group by channel, unreads first within each channel, then sort by date (newest first)
+    const groupedByChannel = new Map();
+    for (const thread of inboxThreads) {
+        const group = groupedByChannel.get(thread.channelId) || [];
+        group.push(thread);
+        groupedByChannel.set(thread.channelId, group);
+    }
+    const sortByDate = (a, b) => new Date(b.posted).getTime() - new Date(a.posted).getTime();
+    const sortedChannelGroups = [];
+    for (const [, threads] of groupedByChannel) {
+        const unreads = threads.filter((t) => t.isUnread).sort(sortByDate);
+        const reads = threads.filter((t) => !t.isUnread).sort(sortByDate);
+        sortedChannelGroups.push(...unreads, ...reads);
+    }
+    if (options.json) {
+        const output = sortedChannelGroups.map((t) => ({
+            ...t,
+            channelName: channelMap.get(t.channelId),
+        }));
+        console.log(formatJson(output, 'thread', options.full));
+        return;
+    }
+    if (options.ndjson) {
+        const output = sortedChannelGroups.map((t) => ({
+            ...t,
+            channelName: channelMap.get(t.channelId),
+        }));
+        console.log(formatNdjson(output, 'thread', options.full));
+        return;
+    }
+    let currentChannelId = null;
+    for (const thread of sortedChannelGroups) {
+        if (thread.channelId !== currentChannelId) {
+            const channelName = channelMap.get(thread.channelId) || `ch:${thread.channelId}`;
+            if (currentChannelId !== null)
+                console.log('');
+            console.log(chalk.bold.blue(`[${channelName}]`));
+            console.log('');
+            currentChannelId = thread.channelId;
+        }
+        const title = thread.isUnread ? chalk.bold(thread.title) : thread.title;
+        const time = colors.timestamp(formatRelativeDate(thread.posted));
+        const unreadBadge = thread.isUnread ? chalk.blue(isAccessible() ? ' (unread)' : ' *') : '';
+        console.log(`  ${title}${unreadBadge}`);
+        console.log(`    ${time}  ${colors.timestamp(`id:${thread.id}`)}`);
+        console.log(`    ${colors.url(thread.url)}`);
+        console.log('');
+    }
+}
+export function registerInboxCommand(program) {
+    program
+        .command('inbox [workspace-ref]')
+        .description('Show inbox threads')
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--channel <filter>', 'Filter by channel name (fuzzy match)')
+        .option('--unread', 'Only show unread threads')
+        .addOption(withCaseInsensitiveChoices(new Option('--archive-filter <filter>', 'Show active, archived, or all inbox threads (default: active)'), ['active', 'archived', 'all']))
+        .option('--since <date>', 'Filter by date (ISO format)')
+        .option('--until <date>', 'Filter by date')
+        .option('--limit <n>', 'Max items (default: 50)')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output')
+        .addHelpText('after', `
+Examples:
+  tdc inbox
+  tdc inbox --unread
+  tdc inbox --archive-filter all
+  tdc inbox --archive-filter archived
+  tdc inbox --channel engineering --since 2025-01-01
+  tdc inbox --limit 10 --json`)
+        .action(showInbox);
+}
+//# sourceMappingURL=inbox.js.map